@valkyrianlabs/payload-markdown-docs 0.1.0-canary.0

package/dist/sync/aiExportManifest.d.ts

@@ -0,0 +1,58 @@
+import type { DocsValidationIssue } from './validate.js';
+export declare const AI_MARKDOWN_EXPORT_MANIFEST_FILENAMES: readonly ["index.ai.yml", "index.ai.yaml"];
+export type DocsAiExportHeadingMode = 'normalize' | 'preserve';
+export type DocsAiExportOrphans = 'append' | 'ignore';
+export type DocsAiExportManifest = {
+    canonical?: string;
+    description?: string;
+    exclude: string[];
+    headingMode: DocsAiExportHeadingMode;
+    order: string[];
+    orphans: DocsAiExportOrphans;
+    output?: string;
+    preamble?: string;
+    sourcePath: string;
+    title?: string;
+    version: 1;
+};
+export type DocsAiExportManifestInput = {
+    canonical?: unknown;
+    description?: unknown;
+    exclude?: unknown;
+    headingMode?: unknown;
+    order?: unknown;
+    orphans?: unknown;
+    output?: unknown;
+    preamble?: unknown;
+    sourcePath?: unknown;
+    title?: unknown;
+    version?: unknown;
+};
+export type DocsAiExportManifestValidationOptions = {
+    knownDocsPaths?: Iterable<string>;
+    sourcePath?: string;
+};
+export type DocsAiExportManifestValidationResult = {
+    issues: DocsValidationIssue[];
+    manifest: DocsAiExportManifest;
+    ok: true;
+    warnings: DocsValidationIssue[];
+} | {
+    issues: DocsValidationIssue[];
+    ok: false;
+    warnings: DocsValidationIssue[];
+};
+export declare const isAiMarkdownExportManifestPath: (sourcePath: string) => boolean;
+export declare const parseDocsAiExportManifestYaml: ({ content, sourcePath, }: {
+    content: string;
+    sourcePath: string;
+}) => DocsAiExportManifestValidationResult;
+export declare const validateDocsAiExportManifest: (manifest: unknown, options?: DocsAiExportManifestValidationOptions) => DocsAiExportManifestValidationResult;
+export declare const matchesAiExportExcludePattern: ({ pattern, sourcePath, }: {
+    pattern: string;
+    sourcePath: string;
+}) => boolean;
+export declare const isExcludedFromAiExport: ({ exclude, sourcePath, }: {
+    exclude: string[];
+    sourcePath: string;
+}) => boolean;

package/dist/sync/aiExportManifest.js

@@ -0,0 +1,430 @@
+import { normalizeRoutePath } from '../routing/index.js';
+import { normalizeDocsPath } from './paths.js';
+export const AI_MARKDOWN_EXPORT_MANIFEST_FILENAMES = [
+    'index.ai.yml',
+    'index.ai.yaml'
+];
+const createIssue = ({ message, path })=>({
+        code: 'invalid_ai_export_manifest',
+        message,
+        path
+    });
+export const isAiMarkdownExportManifestPath = (sourcePath)=>{
+    const normalized = sourcePath.split('\\').join('/').replace(/^\.?\//, '');
+    return AI_MARKDOWN_EXPORT_MANIFEST_FILENAMES.includes(normalized);
+};
+const trimComment = (value)=>{
+    const commentIndex = value.search(/\s+#/);
+    return commentIndex === -1 ? value : value.slice(0, commentIndex).trimEnd();
+};
+const unquote = (value)=>{
+    const trimmed = trimComment(value.trim());
+    if (trimmed.startsWith('"') && trimmed.endsWith('"') || trimmed.startsWith("'") && trimmed.endsWith("'")) {
+        return trimmed.slice(1, -1);
+    }
+    return trimmed;
+};
+const parseScalar = (value)=>{
+    const cleaned = unquote(value);
+    if (/^-?\d+$/.test(cleaned)) {
+        return Number(cleaned);
+    }
+    return cleaned;
+};
+const parseInlineArray = (value)=>{
+    const cleaned = trimComment(value.trim());
+    if (!cleaned.startsWith('[') || !cleaned.endsWith(']')) {
+        return undefined;
+    }
+    const body = cleaned.slice(1, -1).trim();
+    if (!body) {
+        return [];
+    }
+    return body.split(',').map((item)=>unquote(item));
+};
+const getTopLevelKeyLine = (line)=>{
+    if (/^\s/.test(line)) {
+        return undefined;
+    }
+    const trimmed = line.trimEnd();
+    const separatorIndex = trimmed.indexOf(':');
+    if (separatorIndex <= 0) {
+        return undefined;
+    }
+    const key = trimmed.slice(0, separatorIndex);
+    if (!/^[a-z][a-z0-9]*$/i.test(key)) {
+        return undefined;
+    }
+    return {
+        key,
+        value: trimmed.slice(separatorIndex + 1).trimStart()
+    };
+};
+const stripCommonIndent = (lines)=>{
+    const indents = lines.filter((line)=>line.trim() !== '').map((line)=>line.match(/^ */)?.[0].length ?? 0);
+    const commonIndent = indents.length > 0 ? Math.min(...indents) : 0;
+    return lines.map((line)=>line.slice(commonIndent));
+};
+const stripOuterBlankLines = (lines)=>{
+    const stripped = [
+        ...lines
+    ];
+    while(stripped[0]?.trim() === ''){
+        stripped.shift();
+    }
+    while(stripped.at(-1)?.trim() === ''){
+        stripped.pop();
+    }
+    return stripped;
+};
+const foldBlockLines = (lines)=>{
+    const paragraphs = [];
+    let current = [];
+    for (const line of lines){
+        if (line.trim() === '') {
+            if (current.length > 0) {
+                paragraphs.push(current.join(' '));
+                current = [];
+            }
+            paragraphs.push('');
+            continue;
+        }
+        current.push(line.trim());
+    }
+    if (current.length > 0) {
+        paragraphs.push(current.join(' '));
+    }
+    return paragraphs.join('\n').trim();
+};
+const collectBlock = ({ lines, startIndex, style })=>{
+    const blockLines = [];
+    let index = startIndex;
+    while(index < lines.length){
+        const line = lines[index] ?? '';
+        if (getTopLevelKeyLine(line)) {
+            break;
+        }
+        blockLines.push(line);
+        index += 1;
+    }
+    const stripped = stripOuterBlankLines(stripCommonIndent(blockLines));
+    return {
+        nextIndex: index,
+        value: style === '|' ? stripped.join('\n').trimEnd() : foldBlockLines(stripped)
+    };
+};
+const collectList = ({ lines, startIndex })=>{
+    const values = [];
+    let index = startIndex;
+    let sawList = false;
+    while(index < lines.length){
+        const line = lines[index] ?? '';
+        if (line.trim() === '') {
+            index += 1;
+            continue;
+        }
+        if (getTopLevelKeyLine(line)) {
+            break;
+        }
+        const trimmed = line.trimStart();
+        const marker = trimmed[0];
+        if (marker !== '-' && marker !== '*' || trimmed[1] !== ' ') {
+            break;
+        }
+        sawList = true;
+        values.push(unquote(trimmed.slice(2)));
+        index += 1;
+    }
+    return {
+        nextIndex: sawList ? index : startIndex,
+        values: sawList ? values : undefined
+    };
+};
+export const parseDocsAiExportManifestYaml = ({ content, sourcePath })=>{
+    const parsed = {
+        sourcePath
+    };
+    const lines = content.replace(/\r\n?/g, '\n').split('\n');
+    let index = 0;
+    while(index < lines.length){
+        const line = lines[index] ?? '';
+        if (line.trim() === '' || line.trimStart().startsWith('#')) {
+            index += 1;
+            continue;
+        }
+        const keyLine = getTopLevelKeyLine(line);
+        if (!keyLine) {
+            return {
+                issues: [
+                    createIssue({
+                        message: `Could not parse AI export manifest line: ${line.trim()}`,
+                        path: sourcePath
+                    })
+                ],
+                ok: false,
+                warnings: []
+            };
+        }
+        const rawValue = keyLine.value.trim();
+        if (rawValue === '|' || rawValue === '>') {
+            const block = collectBlock({
+                lines,
+                startIndex: index + 1,
+                style: rawValue
+            });
+            parsed[keyLine.key] = block.value;
+            index = block.nextIndex;
+            continue;
+        }
+        const inlineArray = parseInlineArray(rawValue);
+        if (inlineArray) {
+            parsed[keyLine.key] = inlineArray;
+            index += 1;
+            continue;
+        }
+        if (rawValue === '') {
+            const list = collectList({
+                lines,
+                startIndex: index + 1
+            });
+            if (list.values) {
+                parsed[keyLine.key] = list.values;
+                index = list.nextIndex;
+                continue;
+            }
+        }
+        parsed[keyLine.key] = parseScalar(rawValue);
+        index += 1;
+    }
+    return validateDocsAiExportManifest(parsed, {
+        sourcePath
+    });
+};
+const getOptionalString = ({ issues, key, manifest, path })=>{
+    const value = manifest[key];
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value === 'string') {
+        return value.trim() === '' ? undefined : value;
+    }
+    issues.push(createIssue({
+        message: `AI export manifest field "${key}" must be a string.`,
+        path
+    }));
+    return undefined;
+};
+const getStringArray = ({ issues, key, manifest, path })=>{
+    const value = manifest[key];
+    if (value === undefined) {
+        return [];
+    }
+    if (Array.isArray(value) && value.every((item)=>typeof item === 'string')) {
+        return value;
+    }
+    issues.push(createIssue({
+        message: `AI export manifest field "${key}" must be a list of strings.`,
+        path
+    }));
+    return [];
+};
+const normalizeManifestDocsPath = ({ issues, path, sourcePath })=>{
+    const trimmed = path.trim().replace(/\\/g, '/').replace(/^\.\//, '');
+    const normalized = normalizeDocsPath(trimmed);
+    if (!normalized.ok) {
+        issues.push(createIssue({
+            message: `AI export manifest order path "${path}" is invalid: ${normalized.message}`,
+            path: sourcePath
+        }));
+        return undefined;
+    }
+    return normalized.path;
+};
+const normalizeExcludePattern = ({ issues, pattern, sourcePath })=>{
+    const trimmed = pattern.trim().replace(/\\/g, '/').replace(/^\.\//, '');
+    if (!trimmed || trimmed.includes('..') || trimmed.startsWith('/')) {
+        issues.push(createIssue({
+            message: `AI export manifest exclude pattern "${pattern}" is invalid.`,
+            path: sourcePath
+        }));
+        return undefined;
+    }
+    return trimmed;
+};
+const normalizeRouteLikePath = (value)=>{
+    if (!value) {
+        return undefined;
+    }
+    if (/^[a-z][a-z0-9+.-]*:\/\//i.test(value)) {
+        return value;
+    }
+    return normalizeRoutePath(value);
+};
+export const validateDocsAiExportManifest = (manifest, options = {})=>{
+    const issues = [];
+    const warnings = [];
+    const sourcePath = options.sourcePath ?? (typeof manifest?.sourcePath === 'string' ? String(manifest.sourcePath) : AI_MARKDOWN_EXPORT_MANIFEST_FILENAMES[0]);
+    if (typeof manifest !== 'object' || manifest === null || Array.isArray(manifest)) {
+        return {
+            issues: [
+                createIssue({
+                    message: 'AI export manifest must be an object.',
+                    path: sourcePath
+                })
+            ],
+            ok: false,
+            warnings
+        };
+    }
+    const input = manifest;
+    if (input.version !== 1) {
+        issues.push(createIssue({
+            message: 'AI export manifest version must be 1.',
+            path: sourcePath
+        }));
+    }
+    const orphans = input.orphans === undefined ? 'append' : input.orphans === 'append' || input.orphans === 'ignore' ? input.orphans : undefined;
+    if (!orphans) {
+        issues.push(createIssue({
+            message: 'AI export manifest orphans must be "append" or "ignore".',
+            path: sourcePath
+        }));
+    }
+    const headingMode = input.headingMode === undefined ? 'normalize' : input.headingMode === 'normalize' || input.headingMode === 'preserve' ? input.headingMode : undefined;
+    if (!headingMode) {
+        issues.push(createIssue({
+            message: 'AI export manifest headingMode must be "normalize" or "preserve".',
+            path: sourcePath
+        }));
+    }
+    const order = getStringArray({
+        issues,
+        key: 'order',
+        manifest: input,
+        path: sourcePath
+    }).map((item)=>normalizeManifestDocsPath({
+            issues,
+            path: item,
+            sourcePath
+        })).filter((item)=>item !== undefined);
+    const exclude = getStringArray({
+        issues,
+        key: 'exclude',
+        manifest: input,
+        path: sourcePath
+    }).map((item)=>normalizeExcludePattern({
+            issues,
+            pattern: item,
+            sourcePath
+        })).filter((item)=>item !== undefined);
+    const knownDocsPaths = options.knownDocsPaths ? new Set(options.knownDocsPaths) : undefined;
+    if (knownDocsPaths) {
+        for (const orderedPath of order){
+            if (!knownDocsPaths.has(orderedPath)) {
+                warnings.push({
+                    code: 'missing_ai_export_order_path',
+                    message: `AI export manifest order path "${orderedPath}" does not exist in the docs files.`,
+                    path: sourcePath
+                });
+            }
+        }
+    }
+    const title = getOptionalString({
+        issues,
+        key: 'title',
+        manifest: input,
+        path: sourcePath
+    });
+    const canonical = normalizeRouteLikePath(getOptionalString({
+        issues,
+        key: 'canonical',
+        manifest: input,
+        path: sourcePath
+    }));
+    const output = normalizeRouteLikePath(getOptionalString({
+        issues,
+        key: 'output',
+        manifest: input,
+        path: sourcePath
+    }));
+    const description = getOptionalString({
+        issues,
+        key: 'description',
+        manifest: input,
+        path: sourcePath
+    });
+    const preamble = getOptionalString({
+        issues,
+        key: 'preamble',
+        manifest: input,
+        path: sourcePath
+    });
+    if (issues.length > 0 || !orphans || !headingMode) {
+        return {
+            issues,
+            ok: false,
+            warnings
+        };
+    }
+    return {
+        issues,
+        manifest: {
+            ...canonical ? {
+                canonical
+            } : {},
+            ...description ? {
+                description
+            } : {},
+            exclude,
+            headingMode,
+            order,
+            orphans,
+            ...output ? {
+                output
+            } : {},
+            ...preamble ? {
+                preamble
+            } : {},
+            sourcePath,
+            ...title ? {
+                title
+            } : {},
+            version: 1
+        },
+        ok: true,
+        warnings
+    };
+};
+const escapeRegex = (value)=>value.replace(/[|\\{}()[\]^$+?.]/g, '\\$&');
+const globPatternToRegex = (pattern)=>{
+    let regex = '^';
+    for(let index = 0; index < pattern.length; index += 1){
+        const char = pattern[index];
+        const next = pattern[index + 1];
+        if (char === '*' && next === '*') {
+            regex += '.*';
+            index += 1;
+            continue;
+        }
+        if (char === '*') {
+            regex += '[^/]*';
+            continue;
+        }
+        regex += escapeRegex(char ?? '');
+    }
+    return new RegExp(`${regex}$`);
+};
+export const matchesAiExportExcludePattern = ({ pattern, sourcePath })=>{
+    const normalizedPattern = pattern.replace(/^\.\//, '');
+    const normalizedSourcePath = sourcePath.replace(/^\.\//, '');
+    if (!normalizedPattern.includes('*')) {
+        return normalizedPattern === normalizedSourcePath;
+    }
+    return globPatternToRegex(normalizedPattern).test(normalizedSourcePath);
+};
+export const isExcludedFromAiExport = ({ exclude, sourcePath })=>isAiMarkdownExportManifestPath(sourcePath) || exclude.some((pattern)=>matchesAiExportExcludePattern({
+            pattern,
+            sourcePath
+        }));
+
+//# sourceMappingURL=aiExportManifest.js.map

package/dist/sync/aiExportManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sync/aiExportManifest.ts"],"sourcesContent":["import type { DocsValidationIssue } from './validate.js'\n\nimport { normalizeRoutePath } from '../routing/index.js'\nimport { normalizeDocsPath } from './paths.js'\n\nexport const AI_MARKDOWN_EXPORT_MANIFEST_FILENAMES = [\n  'index.ai.yml',\n  'index.ai.yaml',\n] as const\n\nexport type DocsAiExportHeadingMode = 'normalize' | 'preserve'\n\nexport type DocsAiExportOrphans = 'append' | 'ignore'\n\nexport type DocsAiExportManifest = {\n  canonical?: string\n  description?: string\n  exclude: string[]\n  headingMode: DocsAiExportHeadingMode\n  order: string[]\n  orphans: DocsAiExportOrphans\n  output?: string\n  preamble?: string\n  sourcePath: string\n  title?: string\n  version: 1\n}\n\nexport type DocsAiExportManifestInput = {\n  canonical?: unknown\n  description?: unknown\n  exclude?: unknown\n  headingMode?: unknown\n  order?: unknown\n  orphans?: unknown\n  output?: unknown\n  preamble?: unknown\n  sourcePath?: unknown\n  title?: unknown\n  version?: unknown\n}\n\nexport type DocsAiExportManifestValidationOptions = {\n  knownDocsPaths?: Iterable<string>\n  sourcePath?: string\n}\n\nexport type DocsAiExportManifestValidationResult =\n  | {\n      issues: DocsValidationIssue[]\n      manifest: DocsAiExportManifest\n      ok: true\n      warnings: DocsValidationIssue[]\n    }\n  | {\n      issues: DocsValidationIssue[]\n      ok: false\n      warnings: DocsValidationIssue[]\n    }\n\nconst createIssue = ({\n  message,\n  path,\n}: {\n  message: string\n  path?: string\n}): DocsValidationIssue => ({\n  code: 'invalid_ai_export_manifest',\n  message,\n  path,\n})\n\nexport const isAiMarkdownExportManifestPath = (sourcePath: string): boolean => {\n  const normalized = sourcePath.split('\\\\').join('/').replace(/^\\.?\\//, '')\n\n  return AI_MARKDOWN_EXPORT_MANIFEST_FILENAMES.includes(\n    normalized as (typeof AI_MARKDOWN_EXPORT_MANIFEST_FILENAMES)[number],\n  )\n}\n\nconst trimComment = (value: string): string => {\n  const commentIndex = value.search(/\\s+#/)\n\n  return commentIndex === -1 ? value : value.slice(0, commentIndex).trimEnd()\n}\n\nconst unquote = (value: string): string => {\n  const trimmed = trimComment(value.trim())\n\n  if (\n    (trimmed.startsWith('\"') && trimmed.endsWith('\"')) ||\n    (trimmed.startsWith(\"'\") && trimmed.endsWith(\"'\"))\n  ) {\n    return trimmed.slice(1, -1)\n  }\n\n  return trimmed\n}\n\nconst parseScalar = (value: string): unknown => {\n  const cleaned = unquote(value)\n\n  if (/^-?\\d+$/.test(cleaned)) {\n    return Number(cleaned)\n  }\n\n  return cleaned\n}\n\nconst parseInlineArray = (value: string): string[] | undefined => {\n  const cleaned = trimComment(value.trim())\n\n  if (!cleaned.startsWith('[') || !cleaned.endsWith(']')) {\n    return undefined\n  }\n\n  const body = cleaned.slice(1, -1).trim()\n\n  if (!body) {\n    return []\n  }\n\n  return body.split(',').map((item) => unquote(item))\n}\n\nconst getTopLevelKeyLine = (\n  line: string,\n): { key: string; value: string } | undefined => {\n  if (/^\\s/.test(line)) {\n    return undefined\n  }\n\n  const trimmed = line.trimEnd()\n  const separatorIndex = trimmed.indexOf(':')\n\n  if (separatorIndex <= 0) {\n    return undefined\n  }\n\n  const key = trimmed.slice(0, separatorIndex)\n\n  if (!/^[a-z][a-z0-9]*$/i.test(key)) {\n    return undefined\n  }\n\n  return {\n    key,\n    value: trimmed.slice(separatorIndex + 1).trimStart(),\n  }\n}\n\nconst stripCommonIndent = (lines: string[]): string[] => {\n  const indents = lines\n    .filter((line) => line.trim() !== '')\n    .map((line) => line.match(/^ */)?.[0].length ?? 0)\n  const commonIndent = indents.length > 0 ? Math.min(...indents) : 0\n\n  return lines.map((line) => line.slice(commonIndent))\n}\n\nconst stripOuterBlankLines = (lines: string[]): string[] => {\n  const stripped = [...lines]\n\n  while (stripped[0]?.trim() === '') {\n    stripped.shift()\n  }\n\n  while (stripped.at(-1)?.trim() === '') {\n    stripped.pop()\n  }\n\n  return stripped\n}\n\nconst foldBlockLines = (lines: string[]): string => {\n  const paragraphs: string[] = []\n  let current: string[] = []\n\n  for (const line of lines) {\n    if (line.trim() === '') {\n      if (current.length > 0) {\n        paragraphs.push(current.join(' '))\n        current = []\n      }\n      paragraphs.push('')\n      continue\n    }\n\n    current.push(line.trim())\n  }\n\n  if (current.length > 0) {\n    paragraphs.push(current.join(' '))\n  }\n\n  return paragraphs.join('\\n').trim()\n}\n\nconst collectBlock = ({\n  lines,\n  startIndex,\n  style,\n}: {\n  lines: string[]\n  startIndex: number\n  style: '>' | '|'\n}): {\n  nextIndex: number\n  value: string\n} => {\n  const blockLines: string[] = []\n  let index = startIndex\n\n  while (index < lines.length) {\n    const line = lines[index] ?? ''\n\n    if (getTopLevelKeyLine(line)) {\n      break\n    }\n\n    blockLines.push(line)\n    index += 1\n  }\n\n  const stripped = stripOuterBlankLines(stripCommonIndent(blockLines))\n\n  return {\n    nextIndex: index,\n    value: style === '|' ? stripped.join('\\n').trimEnd() : foldBlockLines(stripped),\n  }\n}\n\nconst collectList = ({\n  lines,\n  startIndex,\n}: {\n  lines: string[]\n  startIndex: number\n}): {\n  nextIndex: number\n  values?: string[]\n} => {\n  const values: string[] = []\n  let index = startIndex\n  let sawList = false\n\n  while (index < lines.length) {\n    const line = lines[index] ?? ''\n\n    if (line.trim() === '') {\n      index += 1\n      continue\n    }\n\n    if (getTopLevelKeyLine(line)) {\n      break\n    }\n\n    const trimmed = line.trimStart()\n    const marker = trimmed[0]\n\n    if ((marker !== '-' && marker !== '*') || trimmed[1] !== ' ') {\n      break\n    }\n\n    sawList = true\n    values.push(unquote(trimmed.slice(2)))\n    index += 1\n  }\n\n  return {\n    nextIndex: sawList ? index : startIndex,\n    values: sawList ? values : undefined,\n  }\n}\n\nexport const parseDocsAiExportManifestYaml = ({\n  content,\n  sourcePath,\n}: {\n  content: string\n  sourcePath: string\n}): DocsAiExportManifestValidationResult => {\n  const parsed: Record<string, unknown> = {\n    sourcePath,\n  }\n  const lines = content.replace(/\\r\\n?/g, '\\n').split('\\n')\n  let index = 0\n\n  while (index < lines.length) {\n    const line = lines[index] ?? ''\n\n    if (line.trim() === '' || line.trimStart().startsWith('#')) {\n      index += 1\n      continue\n    }\n\n    const keyLine = getTopLevelKeyLine(line)\n\n    if (!keyLine) {\n      return {\n        issues: [\n          createIssue({\n            message: `Could not parse AI export manifest line: ${line.trim()}`,\n            path: sourcePath,\n          }),\n        ],\n        ok: false,\n        warnings: [],\n      }\n    }\n\n    const rawValue = keyLine.value.trim()\n\n    if (rawValue === '|' || rawValue === '>') {\n      const block = collectBlock({\n        lines,\n        startIndex: index + 1,\n        style: rawValue,\n      })\n\n      parsed[keyLine.key] = block.value\n      index = block.nextIndex\n      continue\n    }\n\n    const inlineArray = parseInlineArray(rawValue)\n\n    if (inlineArray) {\n      parsed[keyLine.key] = inlineArray\n      index += 1\n      continue\n    }\n\n    if (rawValue === '') {\n      const list = collectList({\n        lines,\n        startIndex: index + 1,\n      })\n\n      if (list.values) {\n        parsed[keyLine.key] = list.values\n        index = list.nextIndex\n        continue\n      }\n    }\n\n    parsed[keyLine.key] = parseScalar(rawValue)\n    index += 1\n  }\n\n  return validateDocsAiExportManifest(parsed, {\n    sourcePath,\n  })\n}\n\nconst getOptionalString = ({\n  issues,\n  key,\n  manifest,\n  path,\n}: {\n  issues: DocsValidationIssue[]\n  key: keyof DocsAiExportManifestInput\n  manifest: DocsAiExportManifestInput\n  path?: string\n}): string | undefined => {\n  const value = manifest[key]\n\n  if (value === undefined) {\n    return undefined\n  }\n\n  if (typeof value === 'string') {\n    return value.trim() === '' ? undefined : value\n  }\n\n  issues.push(\n    createIssue({\n      message: `AI export manifest field \"${key}\" must be a string.`,\n      path,\n    }),\n  )\n\n  return undefined\n}\n\nconst getStringArray = ({\n  issues,\n  key,\n  manifest,\n  path,\n}: {\n  issues: DocsValidationIssue[]\n  key: 'exclude' | 'order'\n  manifest: DocsAiExportManifestInput\n  path?: string\n}): string[] => {\n  const value = manifest[key]\n\n  if (value === undefined) {\n    return []\n  }\n\n  if (Array.isArray(value) && value.every((item) => typeof item === 'string')) {\n    return value\n  }\n\n  issues.push(\n    createIssue({\n      message: `AI export manifest field \"${key}\" must be a list of strings.`,\n      path,\n    }),\n  )\n\n  return []\n}\n\nconst normalizeManifestDocsPath = ({\n  issues,\n  path,\n  sourcePath,\n}: {\n  issues: DocsValidationIssue[]\n  path: string\n  sourcePath?: string\n}): string | undefined => {\n  const trimmed = path.trim().replace(/\\\\/g, '/').replace(/^\\.\\//, '')\n  const normalized = normalizeDocsPath(trimmed)\n\n  if (!normalized.ok) {\n    issues.push(\n      createIssue({\n        message: `AI export manifest order path \"${path}\" is invalid: ${normalized.message}`,\n        path: sourcePath,\n      }),\n    )\n    return undefined\n  }\n\n  return normalized.path\n}\n\nconst normalizeExcludePattern = ({\n  issues,\n  pattern,\n  sourcePath,\n}: {\n  issues: DocsValidationIssue[]\n  pattern: string\n  sourcePath?: string\n}): string | undefined => {\n  const trimmed = pattern.trim().replace(/\\\\/g, '/').replace(/^\\.\\//, '')\n\n  if (!trimmed || trimmed.includes('..') || trimmed.startsWith('/')) {\n    issues.push(\n      createIssue({\n        message: `AI export manifest exclude pattern \"${pattern}\" is invalid.`,\n        path: sourcePath,\n      }),\n    )\n    return undefined\n  }\n\n  return trimmed\n}\n\nconst normalizeRouteLikePath = (value: string | undefined): string | undefined => {\n  if (!value) {\n    return undefined\n  }\n\n  if (/^[a-z][a-z0-9+.-]*:\\/\\//i.test(value)) {\n    return value\n  }\n\n  return normalizeRoutePath(value)\n}\n\nexport const validateDocsAiExportManifest = (\n  manifest: unknown,\n  options: DocsAiExportManifestValidationOptions = {},\n): DocsAiExportManifestValidationResult => {\n  const issues: DocsValidationIssue[] = []\n  const warnings: DocsValidationIssue[] = []\n  const sourcePath =\n    options.sourcePath ??\n    (typeof (manifest as DocsAiExportManifestInput | undefined)?.sourcePath === 'string'\n      ? String((manifest as DocsAiExportManifestInput).sourcePath)\n      : AI_MARKDOWN_EXPORT_MANIFEST_FILENAMES[0])\n\n  if (typeof manifest !== 'object' || manifest === null || Array.isArray(manifest)) {\n    return {\n      issues: [\n        createIssue({\n          message: 'AI export manifest must be an object.',\n          path: sourcePath,\n        }),\n      ],\n      ok: false,\n      warnings,\n    }\n  }\n\n  const input = manifest as DocsAiExportManifestInput\n\n  if (input.version !== 1) {\n    issues.push(\n      createIssue({\n        message: 'AI export manifest version must be 1.',\n        path: sourcePath,\n      }),\n    )\n  }\n\n  const orphans =\n    input.orphans === undefined\n      ? 'append'\n      : input.orphans === 'append' || input.orphans === 'ignore'\n        ? input.orphans\n        : undefined\n\n  if (!orphans) {\n    issues.push(\n      createIssue({\n        message: 'AI export manifest orphans must be \"append\" or \"ignore\".',\n        path: sourcePath,\n      }),\n    )\n  }\n\n  const headingMode =\n    input.headingMode === undefined\n      ? 'normalize'\n      : input.headingMode === 'normalize' || input.headingMode === 'preserve'\n        ? input.headingMode\n        : undefined\n\n  if (!headingMode) {\n    issues.push(\n      createIssue({\n        message:\n          'AI export manifest headingMode must be \"normalize\" or \"preserve\".',\n        path: sourcePath,\n      }),\n    )\n  }\n\n  const order = getStringArray({\n    issues,\n    key: 'order',\n    manifest: input,\n    path: sourcePath,\n  })\n    .map((item) =>\n      normalizeManifestDocsPath({\n        issues,\n        path: item,\n        sourcePath,\n      }),\n    )\n    .filter((item): item is string => item !== undefined)\n  const exclude = getStringArray({\n    issues,\n    key: 'exclude',\n    manifest: input,\n    path: sourcePath,\n  })\n    .map((item) =>\n      normalizeExcludePattern({\n        issues,\n        pattern: item,\n        sourcePath,\n      }),\n    )\n    .filter((item): item is string => item !== undefined)\n  const knownDocsPaths = options.knownDocsPaths\n    ? new Set(options.knownDocsPaths)\n    : undefined\n\n  if (knownDocsPaths) {\n    for (const orderedPath of order) {\n      if (!knownDocsPaths.has(orderedPath)) {\n        warnings.push({\n          code: 'missing_ai_export_order_path',\n          message: `AI export manifest order path \"${orderedPath}\" does not exist in the docs files.`,\n          path: sourcePath,\n        })\n      }\n    }\n  }\n\n  const title = getOptionalString({\n    issues,\n    key: 'title',\n    manifest: input,\n    path: sourcePath,\n  })\n  const canonical = normalizeRouteLikePath(\n    getOptionalString({\n      issues,\n      key: 'canonical',\n      manifest: input,\n      path: sourcePath,\n    }),\n  )\n  const output = normalizeRouteLikePath(\n    getOptionalString({\n      issues,\n      key: 'output',\n      manifest: input,\n      path: sourcePath,\n    }),\n  )\n  const description = getOptionalString({\n    issues,\n    key: 'description',\n    manifest: input,\n    path: sourcePath,\n  })\n  const preamble = getOptionalString({\n    issues,\n    key: 'preamble',\n    manifest: input,\n    path: sourcePath,\n  })\n\n  if (issues.length > 0 || !orphans || !headingMode) {\n    return {\n      issues,\n      ok: false,\n      warnings,\n    }\n  }\n\n  return {\n    issues,\n    manifest: {\n      ...(canonical ? { canonical } : {}),\n      ...(description ? { description } : {}),\n      exclude,\n      headingMode,\n      order,\n      orphans,\n      ...(output ? { output } : {}),\n      ...(preamble ? { preamble } : {}),\n      sourcePath,\n      ...(title ? { title } : {}),\n      version: 1,\n    },\n    ok: true,\n    warnings,\n  }\n}\n\nconst escapeRegex = (value: string): string =>\n  value.replace(/[|\\\\{}()[\\]^$+?.]/g, '\\\\$&')\n\nconst globPatternToRegex = (pattern: string): RegExp => {\n  let regex = '^'\n\n  for (let index = 0; index < pattern.length; index += 1) {\n    const char = pattern[index]\n    const next = pattern[index + 1]\n\n    if (char === '*' && next === '*') {\n      regex += '.*'\n      index += 1\n      continue\n    }\n\n    if (char === '*') {\n      regex += '[^/]*'\n      continue\n    }\n\n    regex += escapeRegex(char ?? '')\n  }\n\n  return new RegExp(`${regex}$`)\n}\n\nexport const matchesAiExportExcludePattern = ({\n  pattern,\n  sourcePath,\n}: {\n  pattern: string\n  sourcePath: string\n}): boolean => {\n  const normalizedPattern = pattern.replace(/^\\.\\//, '')\n  const normalizedSourcePath = sourcePath.replace(/^\\.\\//, '')\n\n  if (!normalizedPattern.includes('*')) {\n    return normalizedPattern === normalizedSourcePath\n  }\n\n  return globPatternToRegex(normalizedPattern).test(normalizedSourcePath)\n}\n\nexport const isExcludedFromAiExport = ({\n  exclude,\n  sourcePath,\n}: {\n  exclude: string[]\n  sourcePath: string\n}): boolean =>\n  isAiMarkdownExportManifestPath(sourcePath) ||\n  exclude.some((pattern) =>\n    matchesAiExportExcludePattern({\n      pattern,\n      sourcePath,\n    }),\n  )\n"],"names":["normalizeRoutePath","normalizeDocsPath","AI_MARKDOWN_EXPORT_MANIFEST_FILENAMES","createIssue","message","path","code","isAiMarkdownExportManifestPath","sourcePath","normalized","split","join","replace","includes","trimComment","value","commentIndex","search","slice","trimEnd","unquote","trimmed","trim","startsWith","endsWith","parseScalar","cleaned","test","Number","parseInlineArray","undefined","body","map","item","getTopLevelKeyLine","line","separatorIndex","indexOf","key","trimStart","stripCommonIndent","lines","indents","filter","match","length","commonIndent","Math","min","stripOuterBlankLines","stripped","shift","at","pop","foldBlockLines","paragraphs","current","push","collectBlock","startIndex","style","blockLines","index","nextIndex","collectList","values","sawList","marker","parseDocsAiExportManifestYaml","content","parsed","keyLine","issues","ok","warnings","rawValue","block","inlineArray","list","validateDocsAiExportManifest","getOptionalString","manifest","getStringArray","Array","isArray","every","normalizeManifestDocsPath","normalizeExcludePattern","pattern","normalizeRouteLikePath","options","String","input","version","orphans","headingMode","order","exclude","knownDocsPaths","Set","orderedPath","has","title","canonical","output","description","preamble","escapeRegex","globPatternToRegex","regex","char","next","RegExp","matchesAiExportExcludePattern","normalizedPattern","normalizedSourcePath","isExcludedFromAiExport","some"],"mappings":"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"}

package/dist/sync/frontmatter.d.ts

@@ -0,0 +1,28 @@
+import type { DocsValidationIssue } from './validate.js';
+export type DocsFrontmatter = {
+    description?: string;
+    draft?: boolean;
+    navTitle?: string;
+    order?: number;
+    redirectFrom?: string[];
+    slug?: string;
+    status?: 'draft' | 'published';
+    tags?: string[];
+    title?: string;
+};
+export type ParseDocsFrontmatterResult = {
+    content: string;
+    frontmatter: DocsFrontmatter;
+    issues: DocsValidationIssue[];
+    warnings: DocsValidationIssue[];
+};
+export declare const parseDocsFrontmatter: (markdown: string, options?: {
+    path?: string;
+}) => ParseDocsFrontmatterResult;
+export declare const inferTitleFromMarkdown: (content: string) => string | undefined;
+export declare const titleFromSourcePath: (sourcePath: string) => string;
+export declare const resolveDocsTitle: ({ content, frontmatter, sourcePath, }: {
+    content: string;
+    frontmatter: DocsFrontmatter;
+    sourcePath: string;
+}) => string;