Function scanForDocDirective

scripts/docs_sync/main.ts:13–57

(file: string, lines: string[])

}

async function scanForDocDirective(file: string, lines: string[]) {
  const output: string[] = [];
  let row = 0;
  let write = false;
  while (row < lines.length) {
    const line = lines[row++];
    output.push(line);
    const match = /^(\s*)\/\/ <docs markdown="(.*)#(.*)">/.exec(line);
    if (match) {
      const prefix = match[1];
      console.log('line', line, JSON.stringify(prefix));
      const ref = match[2];
      const section = match[3];
      let bookRef = ref.replace(/\/\/hackmd.io\//, '//hackmd.io/@qwik-docs/BkxpSz80Y/%2F');
      if (bookRef.indexOf('hackmd.io') !== -1) {
        bookRef += '%3Fboth';
      }
      output.push(prefix + `// !!DO NOT EDIT THIS COMMENT DIRECTLY!!!`);
      output.push(prefix + `// (edit ${bookRef}#${section} instead)`);
      output.push(prefix + '/**');
      (await resolveComment(dirname(file), ref, section)).forEach((longLine) =>
        breakLongLine(longLine).forEach((line) =>
          output.push(prefix + ' *' + (line ? ' ' + line : ''))
        )
      );
      output.push(prefix + ' */');
      while (row < lines.length) {
        const line2 = lines[row++];
        if (!isComment(line2)) {
          throw new Error(
            'Missing end `</doc>` tag. Got: ' + line2 + '\n' + file + '[' + row + ']'
          );
        }
        if (line2.indexOf('// </docs>') != -1) {
          output.push(line2);
          break;
        }
      }
      write = true;
    }
  }
  if (write) {
    await writeFileLines(file, output);
  }
}

function isComment(line: string): boolean {
  line = line.trim();