Function copyDefinition

gulpfile.mjs:263–340

(dir, module)

};

const copyDefinition = async (dir, module) => {
  const labelBlocks = await getLabelBlocks();
  const {version} = JSON.parse(readFileSync('./package.json', UTF8));
  const siteRoot = version.includes('beta')
    ? 'https://beta.tinybase.org'
    : 'https://tinybase.org';
  // Add easier-to-read with-schemas blocks
  const codeBlocks = new Map();
  [
    ...(
      await promises.readFile(`src/@types/${module}/index.d.ts`, UTF8)
    ).matchAll(TYPES_DOC_CODE_BLOCKS),
  ].forEach(([_, label, code]) => {
    const prefix = code.match(/^\n\s*/m)?.[0];
    if (prefix) {
      codeBlocks.set(
        label,
        code
          .replace(/export type \S+ =\s/, '')
          .replace(/export function /, '')
          .replaceAll(prefix, prefix + ' * '),
      );
    }
  });
  const absolutizeDocMedia = (block) =>
    block.replace(/\]\((?:\s*\*\s*)?\/shots\//g, `](${siteRoot}/shots/`);

  const fileRewrite = (block, addOverrideSnippet) =>
    absolutizeDocMedia(
      block.replace(TYPES_DOC_CODE_BLOCKS, (_, label, code) => {
        if (labelBlocks.has(label)) {
          const codeOverride = codeBlocks.get(label);
          let block = labelBlocks.get(label);
          if (
            addOverrideSnippet &&
            codeBlocks.has(label) &&
            code.includes('<') &&
            code.includes('Schema') &&
            !codeOverride.endsWith('{')
          ) {
            const prefix = block.match(/^\s+\*$/m)?.[0];
            if (prefix) {
              const line = '\n' + prefix;
              block = block.replace(
                /^\s+\*$/m,
                `${prefix}${line}` +
                  ' This has schema-based typing.' +
                  ' The following is a simplified representation:' +
                  `${line}${line} \`\`\`ts override` +
                  codeOverride.trimEnd() +
                  `${line} \`\`\`${line}`,
              );
            }
            code = code.replace(/^\s*?\/\/\/.*?\n/gm, '');
          }
          return block + code;
        }
        throw `Missing docs label ${label} in ${module}`;