Function getCustomId

scripts/write-heading-ids.ts:91–102

Parse a single line of text in a .md file. * @returns new content in 3 parts if custom id is needed, null otherwise.

(line: string)

 * @returns new content in 3 parts if custom id is needed, null otherwise.
 */
function getCustomId(line: string): [hash: string, headerContent: string, customId: string] | null {
  const m = line.trim().match(headerTest);
  if (!m) {
    return null;
  }
  const m1 = m.groups!.headerContent.match(apiTest);
  if (!m1) {
    return null;
  }
  const customId = m1.groups!.code.toLowerCase();
  return [m[1], m[2], `{#${customId}}`];
}

/** Process a md file. Rewrites the file content if custom ids are needed. */
async function processFile(path: string): Promise<void> {