@pie-element/cli 0.1.1 → 0.1.2-next.0

package/dist/lib/docs/generator.js

@@ -0,0 +1,450 @@
+import { existsSync } from 'node:fs';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import { loadPointerValue } from './source-extractor.js';
+const isRecord = (value) => !!value && typeof value === 'object' && !Array.isArray(value);
+const inferType = (value) => {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return 'array';
+    switch (typeof value) {
+        case 'string':
+        case 'number':
+        case 'boolean':
+            return typeof value;
+        case 'object':
+            return 'object';
+        default:
+            return 'unknown';
+    }
+};
+const flattenProperties = (value, basePath = '') => {
+    if (isRecord(value)) {
+        const keys = Object.keys(value).sort();
+        if (keys.length === 0 && basePath) {
+            return [{ path: basePath, type: 'object', required: false, defaultValue: {} }];
+        }
+        const flattened = [];
+        for (const key of keys) {
+            const childPath = basePath ? `${basePath}.${key}` : key;
+            flattened.push(...flattenProperties(value[key], childPath));
+        }
+        return flattened;
+    }
+    if (Array.isArray(value)) {
+        return [
+            {
+                path: basePath,
+                type: 'array',
+                required: false,
+                defaultValue: value,
+            },
+        ];
+    }
+    return [
+        {
+            path: basePath,
+            type: inferType(value),
+            required: false,
+            defaultValue: value,
+        },
+    ];
+};
+const escapeHtml = (value) => value
+    .replaceAll('&', '&')
+    .replaceAll('<', '&lt;')
+    .replaceAll('>', '&gt;')
+    .replaceAll('"', '&quot;')
+    .replaceAll("'", '&#39;')
+    .replaceAll('{', '&#123;')
+    .replaceAll('}', '&#125;');
+const formatInline = (value) => {
+    if (typeof value === 'string')
+        return value;
+    return JSON.stringify(value);
+};
+const formatValue = (value) => {
+    if (typeof value === 'string') {
+        return `<code>${escapeHtml(value)}</code>`;
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return `<code>${String(value)}</code>`;
+    }
+    if (value === null) {
+        return '<code>null</code>';
+    }
+    return `<code>${escapeHtml(JSON.stringify(value))}</code>`;
+};
+const readSummary = async (packageDir, fallback) => {
+    const readmePath = join(packageDir, 'README.md');
+    if (existsSync(readmePath)) {
+        const readme = await readFile(readmePath, 'utf-8');
+        const paragraph = readme
+            .split('\n')
+            .map((line) => line.trim())
+            .filter((line) => line.length > 0 && !line.startsWith('#'))
+            .find((line) => line.length > 20);
+        if (paragraph) {
+            return paragraph;
+        }
+    }
+    return fallback || 'No summary provided.';
+};
+// Replace ISO-8601 timestamps with a fixed valid value so a post-normalization
+// JSON.parse still succeeds (the old `<normalized-timestamp>` placeholder was
+// not valid JSON, which forced a purely textual comparison).
+const normalizeTimestamps = (content) => content.replace(/\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z/g, '0000-01-01T00:00:00.000Z');
+// Compare generated content to the checked-in artifact.
+// - For JSON files, parse both sides and compare by structural equality so
+//   whitespace/formatting differences (e.g. after a biome format pass) do not
+//   register as drift. HTML files fall back to text comparison with timestamps
+//   normalized away.
+const normalizeForCheck = (path, content) => {
+    const withoutTimestamps = normalizeTimestamps(content);
+    if (path.endsWith('.json')) {
+        try {
+            return JSON.stringify(JSON.parse(withoutTimestamps));
+        }
+        catch {
+            return withoutTimestamps;
+        }
+    }
+    return withoutTimestamps;
+};
+const loadValueWithFallback = async (packageDir, pointer, kind) => {
+    const fallbackPointers = kind === 'pie'
+        ? [
+            pointer,
+            { file: 'src/controller/defaults.ts', path: 'model' },
+            { file: 'src/controller/defaults.ts' },
+        ]
+        : [
+            pointer,
+            { file: 'src/author/defaultConfiguration.ts', path: 'configuration' },
+            { file: 'src/author/defaults.ts', path: 'configuration' },
+            { file: 'src/controller/defaults.ts', path: 'configuration' },
+            { file: 'src/controller/defaults.ts' },
+        ];
+    let lastError;
+    for (const candidate of fallbackPointers) {
+        if (!existsSync(join(packageDir, candidate.file))) {
+            continue;
+        }
+        try {
+            const value = await loadPointerValue(packageDir, candidate);
+            return {
+                value,
+                sourceLabel: candidate.file + (candidate.path ? `#${candidate.path}` : ''),
+            };
+        }
+        catch (error) {
+            lastError = error;
+        }
+    }
+    if (kind === 'config') {
+        return { value: {}, sourceLabel: pointer.file + (pointer.path ? `#${pointer.path}` : '') };
+    }
+    throw lastError || new Error(`Unable to load ${kind} defaults from ${pointer.file}`);
+};
+const applyMetadata = (properties, metadata) => {
+    if (!metadata || Object.keys(metadata).length === 0) {
+        return properties;
+    }
+    const byPath = new Map(properties.map((p) => [p.path, { ...p }]));
+    for (const [path, meta] of Object.entries(metadata)) {
+        const current = byPath.get(path) || {
+            path,
+            type: meta.type || 'unknown',
+            required: meta.required ?? false,
+        };
+        const merged = {
+            ...current,
+            ...(meta.type ? { type: meta.type } : {}),
+            ...(meta.required !== undefined ? { required: meta.required } : {}),
+            ...(meta.title ? { title: meta.title } : {}),
+            ...(meta.description ? { description: meta.description } : {}),
+            ...(meta.notes ? { notes: meta.notes } : {}),
+            ...(meta.enum ? { enum: [...meta.enum] } : {}),
+            ...(meta.minimum !== undefined ? { minimum: meta.minimum } : {}),
+            ...(meta.maximum !== undefined ? { maximum: meta.maximum } : {}),
+            ...(meta.minLength !== undefined ? { minLength: meta.minLength } : {}),
+            ...(meta.maxLength !== undefined ? { maxLength: meta.maxLength } : {}),
+            ...(meta.pattern ? { pattern: meta.pattern } : {}),
+            ...(meta.itemType ? { itemType: meta.itemType } : {}),
+            ...(meta.examples ? { examples: [...meta.examples] } : {}),
+        };
+        byPath.set(path, merged);
+    }
+    return Array.from(byPath.values()).sort((a, b) => a.path.localeCompare(b.path));
+};
+const propertyFingerprint = (properties) => JSON.stringify(properties.map((p) => ({
+    path: p.path,
+    type: p.type,
+    required: p.required,
+    defaultValue: p.defaultValue,
+})));
+const renderPropertyHtml = (prop) => {
+    const rows = [];
+    rows.push(`<li><strong>Type:</strong> <code>${escapeHtml(prop.type)}</code></li>`);
+    rows.push(`<li><strong>Required:</strong> <code>${String(prop.required)}</code></li>`);
+    if (prop.itemType) {
+        rows.push(`<li><strong>Item Type:</strong> <code>${escapeHtml(prop.itemType)}</code></li>`);
+    }
+    if (prop.description) {
+        rows.push(`<li><strong>Description:</strong> ${escapeHtml(prop.description)}</li>`);
+    }
+    if (prop.enum && prop.enum.length > 0) {
+        rows.push(`<li><strong>Allowed values:</strong> ${prop.enum
+            .map((v) => `<code>${escapeHtml(formatInline(v))}</code>`)
+            .join(', ')}</li>`);
+    }
+    const constraints = [];
+    if (prop.minimum !== undefined)
+        constraints.push(`<code>minimum: ${prop.minimum}</code>`);
+    if (prop.maximum !== undefined)
+        constraints.push(`<code>maximum: ${prop.maximum}</code>`);
+    if (prop.minLength !== undefined)
+        constraints.push(`<code>minLength: ${prop.minLength}</code>`);
+    if (prop.maxLength !== undefined)
+        constraints.push(`<code>maxLength: ${prop.maxLength}</code>`);
+    if (prop.pattern)
+        constraints.push(`<code>pattern: ${escapeHtml(prop.pattern)}</code>`);
+    if (constraints.length) {
+        rows.push(`<li><strong>Constraints:</strong> ${constraints.join(', ')}</li>`);
+    }
+    rows.push(`<li><strong>Default:</strong> ${prop.defaultValue !== undefined ? formatValue(prop.defaultValue) : '<em>none</em>'}</li>`);
+    if (prop.examples && prop.examples.length > 0) {
+        rows.push(`<li><strong>Examples:</strong> ${prop.examples
+            .map((v) => `<code>${escapeHtml(formatInline(v))}</code>`)
+            .join(', ')}</li>`);
+    }
+    if (prop.notes) {
+        rows.push(`<li><strong>Notes:</strong> ${escapeHtml(prop.notes)}</li>`);
+    }
+    return `
+  <section class="doc-property">
+    <h3><code>${escapeHtml(prop.path)}</code></h3>
+    <ul>
+      ${rows.join('\n      ')}
+    </ul>
+  </section>`;
+};
+const renderPropertiesSectionHtml = (title, source, properties) => {
+    if (properties.length === 0) {
+        return `
+    <section class="doc-section">
+      <h2>${escapeHtml(title)}</h2>
+      <p><strong>Source:</strong> <code>${escapeHtml(source)}</code></p>
+      <p>No properties found.</p>
+    </section>`;
+    }
+    return `
+  <section class="doc-section">
+    <h2>${escapeHtml(title)}</h2>
+    <p><strong>Source:</strong> <code>${escapeHtml(source)}</code></p>
+    ${properties.map((prop) => renderPropertyHtml(prop)).join('\n')}
+  </section>`;
+};
+const wrapHtmlPage = (title, body) => `
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>${escapeHtml(title)}</title>
+    <style>
+      :root { color-scheme: light dark; font-family: Inter, system-ui, sans-serif; }
+      body { margin: 0; padding: 1.5rem; line-height: 1.55; }
+      h1,h2,h3 { line-height: 1.25; }
+      h1 { margin-top: 0; }
+      code { font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; }
+      .doc-section { margin-bottom: 2rem; }
+      .doc-property { margin: 0 0 1.25rem 0; padding-bottom: 0.5rem; border-bottom: 1px solid rgba(128,128,128,.25); }
+      ul { padding-left: 1.25rem; }
+      .meta-list li { margin-bottom: .25rem; }
+    </style>
+  </head>
+  <body>
+    ${body}
+  </body>
+</html>
+`;
+const renderElementIndexHtml = (opts) => wrapHtmlPage(`${opts.contract.elementName} docs`, `
+    <h1>${escapeHtml(opts.contract.elementName)} docs</h1>
+    <section class="doc-section">
+      <h2>Overview</h2>
+      <p>${escapeHtml(opts.summary)}</p>
+    </section>
+    <section class="doc-section">
+      <h2>Element Metadata</h2>
+      <ul class="meta-list">
+        <li><strong>Element:</strong> <code>${escapeHtml(opts.contract.elementName)}</code></li>
+        <li><strong>Package:</strong> <code>${escapeHtml(opts.contract.packageName)}</code></li>
+        <li><strong>Framework:</strong> <code>${escapeHtml(opts.contract.framework)}</code></li>
+        <li><strong>Generated:</strong> <code>${escapeHtml(opts.generatedAt)}</code></li>
+      </ul>
+    </section>
+    <section class="doc-section">
+      <h2>Supported Modes</h2>
+      <ul class="meta-list">
+        ${(opts.contract.supportedModes || []).map((mode) => `<li>${escapeHtml(mode)}</li>`).join('')}
+      </ul>
+    </section>
+    <section class="doc-section">
+      <h2>Views</h2>
+      <ul class="meta-list">
+        ${opts.emittedViews
+    .map((view) => `<li><a href="./${encodeURIComponent(view)}.html">${escapeHtml(view)}</a></li>`)
+    .join('')}
+      </ul>
+    </section>
+  `);
+const renderViewHtml = (opts) => wrapHtmlPage(`${opts.contract.elementName} ${opts.view} docs`, `
+    <h1>${escapeHtml(opts.contract.elementName)} / ${escapeHtml(opts.view)}</h1>
+    ${renderPropertiesSectionHtml('Model Defaults', opts.pieSource, opts.pieProperties)}
+    ${renderPropertiesSectionHtml('Authoring/Configuration Defaults', opts.configSource, opts.configProperties)}
+  `);
+const chooseViewDocs = (resolvedViews) => {
+    const map = new Map(resolvedViews.map((v) => [v.view, v]));
+    const chosen = [];
+    const delivery = map.get('delivery');
+    const author = map.get('author');
+    const print = map.get('print');
+    if (delivery) {
+        chosen.push(delivery);
+    }
+    if (author) {
+        chosen.push(author);
+    }
+    if (print) {
+        const deliveryFingerprint = delivery
+            ? `${propertyFingerprint(delivery.pieProperties)}|${propertyFingerprint(delivery.configProperties)}`
+            : '';
+        const printFingerprint = `${propertyFingerprint(print.pieProperties)}|${propertyFingerprint(print.configProperties)}`;
+        const sourceDiffFromDelivery = delivery
+            ? print.pieSource !== delivery.pieSource || print.configSource !== delivery.configSource
+            : true;
+        const sourceDiffFromAuthor = author
+            ? print.pieSource !== author.pieSource || print.configSource !== author.configSource
+            : true;
+        const materiallyDifferent = !delivery || printFingerprint !== deliveryFingerprint;
+        if (materiallyDifferent || sourceDiffFromDelivery || sourceDiffFromAuthor) {
+            chosen.push(print);
+        }
+    }
+    const extras = resolvedViews
+        .filter((v) => !['delivery', 'author', 'print'].includes(v.view))
+        .sort((a, b) => a.view.localeCompare(b.view));
+    for (const extra of extras) {
+        chosen.push(extra);
+    }
+    return chosen;
+};
+export const generateDocsForContract = async (packageDir, contract, options) => {
+    const generatedAt = new Date().toISOString();
+    const summary = await readSummary(packageDir, contract.summary);
+    const filesWritten = [];
+    const filesChecked = [];
+    const driftFiles = [];
+    const sourcesUsed = new Set();
+    const outputs = {
+        contract,
+        packageDir,
+        generatedAt,
+        views: [],
+        sourcesUsed: [],
+    };
+    const resolvedViews = [];
+    for (const view of contract.views) {
+        const pieResolved = await loadValueWithFallback(packageDir, view.pie, 'pie');
+        const configResolved = await loadValueWithFallback(packageDir, view.config, 'config');
+        const pieProperties = applyMetadata(flattenProperties(pieResolved.value).sort((a, b) => a.path.localeCompare(b.path)), view.metadata?.pie);
+        const configProperties = applyMetadata(flattenProperties(configResolved.value).sort((a, b) => a.path.localeCompare(b.path)), view.metadata?.config);
+        resolvedViews.push({
+            view: view.view,
+            pieProperties,
+            configProperties,
+            pieSource: pieResolved.sourceLabel,
+            configSource: configResolved.sourceLabel,
+        });
+    }
+    const emittedViews = chooseViewDocs(resolvedViews);
+    const elementOutputDir = join(options.outputDir, contract.elementName);
+    const elementIndexPath = join(elementOutputDir, 'index.html');
+    const elementIndexContent = renderElementIndexHtml({
+        contract,
+        summary,
+        generatedAt,
+        emittedViews: emittedViews.map((v) => v.view),
+    });
+    const manifest = {
+        elementName: contract.elementName,
+        packageName: contract.packageName,
+        framework: contract.framework,
+        generatedAt,
+        summary,
+        supportedModes: contract.supportedModes || [],
+        views: emittedViews.map((view) => ({
+            id: view.view,
+            file: `${view.view}.html`,
+            pieSource: view.pieSource,
+            configSource: view.configSource,
+            hasModelDefaults: view.pieProperties.length > 0,
+            hasConfigDefaults: view.configProperties.length > 0,
+        })),
+    };
+    const candidates = [
+        { path: elementIndexPath, content: elementIndexContent },
+        {
+            path: join(elementOutputDir, 'manifest.json'),
+            content: `${JSON.stringify(manifest, null, 2)}\n`,
+        },
+        ...emittedViews.map((view) => ({
+            path: join(elementOutputDir, `${view.view}.html`),
+            content: renderViewHtml({
+                contract,
+                view: view.view,
+                pieSource: view.pieSource,
+                configSource: view.configSource,
+                pieProperties: view.pieProperties,
+                configProperties: view.configProperties,
+            }),
+        })),
+    ];
+    for (const candidate of candidates) {
+        filesChecked.push(candidate.path);
+        if (options.check) {
+            const existing = existsSync(candidate.path) ? await readFile(candidate.path, 'utf-8') : null;
+            if (existing === null ||
+                normalizeForCheck(candidate.path, existing) !==
+                    normalizeForCheck(candidate.path, candidate.content)) {
+                driftFiles.push(candidate.path);
+            }
+            continue;
+        }
+        if (!options.dryRun) {
+            await mkdir(elementOutputDir, { recursive: true });
+            await writeFile(candidate.path, candidate.content, 'utf-8');
+        }
+        filesWritten.push(candidate.path);
+    }
+    for (const view of emittedViews) {
+        sourcesUsed.add(view.pieSource);
+        sourcesUsed.add(view.configSource);
+        outputs.views.push({
+            view: view.view,
+            pieProperties: view.pieProperties,
+            configProperties: view.configProperties,
+        });
+    }
+    outputs.sourcesUsed = Array.from(sourcesUsed).sort();
+    return {
+        filesWritten,
+        filesChecked,
+        driftFiles,
+        outputs: [outputs],
+    };
+};
+export const toRelativePaths = (rootDir, paths) => paths.map((p) => relative(rootDir, p)).sort();
+//# sourceMappingURL=generator.js.map

package/dist/lib/docs/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../src/lib/docs/generator.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync } from 'node:fs';\nimport { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { join, relative } from 'node:path';\nimport { loadPointerValue } from './source-extractor.js';\nimport type {\n  PieDocsContract,\n  PieDocsElementOutput,\n  PieDocsPropertyMetadata,\n  PieDocsProperty,\n  PieDocsProperty as PieDocsPropertyContract,\n} from './types.js';\nimport type { PieDocsSourcePointer } from './types.js';\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  !!value && typeof value === 'object' && !Array.isArray(value);\n\nconst inferType = (value: unknown): string => {\n  if (value === null) return 'null';\n  if (Array.isArray(value)) return 'array';\n  switch (typeof value) {\n    case 'string':\n    case 'number':\n    case 'boolean':\n      return typeof value;\n    case 'object':\n      return 'object';\n    default:\n      return 'unknown';\n  }\n};\n\nconst flattenProperties = (value: unknown, basePath = ''): PieDocsProperty[] => {\n  if (isRecord(value)) {\n    const keys = Object.keys(value).sort();\n    if (keys.length === 0 && basePath) {\n      return [{ path: basePath, type: 'object', required: false, defaultValue: {} }];\n    }\n    const flattened: PieDocsProperty[] = [];\n    for (const key of keys) {\n      const childPath = basePath ? `${basePath}.${key}` : key;\n      flattened.push(...flattenProperties(value[key], childPath));\n    }\n    return flattened;\n  }\n\n  if (Array.isArray(value)) {\n    return [\n      {\n        path: basePath,\n        type: 'array',\n        required: false,\n        defaultValue: value,\n      },\n    ];\n  }\n\n  return [\n    {\n      path: basePath,\n      type: inferType(value),\n      required: false,\n      defaultValue: value,\n    },\n  ];\n};\n\nconst escapeHtml = (value: string): string =>\n  value\n    .replaceAll('&', '&amp;')\n    .replaceAll('<', '&lt;')\n    .replaceAll('>', '&gt;')\n    .replaceAll('\"', '&quot;')\n    .replaceAll(\"'\", '&#39;')\n    .replaceAll('{', '&#123;')\n    .replaceAll('}', '&#125;');\n\nconst formatInline = (value: unknown): string => {\n  if (typeof value === 'string') return value;\n  return JSON.stringify(value);\n};\n\nconst formatValue = (value: unknown): string => {\n  if (typeof value === 'string') {\n    return `<code>${escapeHtml(value)}</code>`;\n  }\n  if (typeof value === 'number' || typeof value === 'boolean') {\n    return `<code>${String(value)}</code>`;\n  }\n  if (value === null) {\n    return '<code>null</code>';\n  }\n  return `<code>${escapeHtml(JSON.stringify(value))}</code>`;\n};\n\nconst readSummary = async (packageDir: string, fallback?: string): Promise<string> => {\n  const readmePath = join(packageDir, 'README.md');\n  if (existsSync(readmePath)) {\n    const readme = await readFile(readmePath, 'utf-8');\n    const paragraph = readme\n      .split('\\n')\n      .map((line) => line.trim())\n      .filter((line) => line.length > 0 && !line.startsWith('#'))\n      .find((line) => line.length > 20);\n    if (paragraph) {\n      return paragraph;\n    }\n  }\n  return fallback || 'No summary provided.';\n};\n\nexport interface GenerateDocsOptions {\n  outputDir: string;\n  dryRun: boolean;\n  check: boolean;\n}\n\nexport interface GenerateDocsResult {\n  filesWritten: string[];\n  filesChecked: string[];\n  driftFiles: string[];\n  outputs: PieDocsElementOutput[];\n}\n\n// Replace ISO-8601 timestamps with a fixed valid value so a post-normalization\n// JSON.parse still succeeds (the old `<normalized-timestamp>` placeholder was\n// not valid JSON, which forced a purely textual comparison).\nconst normalizeTimestamps = (content: string): string =>\n  content.replace(/\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z/g, '0000-01-01T00:00:00.000Z');\n\n// Compare generated content to the checked-in artifact.\n// - For JSON files, parse both sides and compare by structural equality so\n//   whitespace/formatting differences (e.g. after a biome format pass) do not\n//   register as drift. HTML files fall back to text comparison with timestamps\n//   normalized away.\nconst normalizeForCheck = (path: string, content: string): string => {\n  const withoutTimestamps = normalizeTimestamps(content);\n  if (path.endsWith('.json')) {\n    try {\n      return JSON.stringify(JSON.parse(withoutTimestamps));\n    } catch {\n      return withoutTimestamps;\n    }\n  }\n  return withoutTimestamps;\n};\n\nconst loadValueWithFallback = async (\n  packageDir: string,\n  pointer: PieDocsSourcePointer,\n  kind: 'pie' | 'config'\n): Promise<{ value: unknown; sourceLabel: string }> => {\n  const fallbackPointers: PieDocsSourcePointer[] =\n    kind === 'pie'\n      ? [\n          pointer,\n          { file: 'src/controller/defaults.ts', path: 'model' },\n          { file: 'src/controller/defaults.ts' },\n        ]\n      : [\n          pointer,\n          { file: 'src/author/defaultConfiguration.ts', path: 'configuration' },\n          { file: 'src/author/defaults.ts', path: 'configuration' },\n          { file: 'src/controller/defaults.ts', path: 'configuration' },\n          { file: 'src/controller/defaults.ts' },\n        ];\n\n  let lastError: Error | undefined;\n  for (const candidate of fallbackPointers) {\n    if (!existsSync(join(packageDir, candidate.file))) {\n      continue;\n    }\n    try {\n      const value = await loadPointerValue(packageDir, candidate);\n      return {\n        value,\n        sourceLabel: candidate.file + (candidate.path ? `#${candidate.path}` : ''),\n      };\n    } catch (error) {\n      lastError = error as Error;\n    }\n  }\n\n  if (kind === 'config') {\n    return { value: {}, sourceLabel: pointer.file + (pointer.path ? `#${pointer.path}` : '') };\n  }\n\n  throw lastError || new Error(`Unable to load ${kind} defaults from ${pointer.file}`);\n};\n\ninterface ResolvedViewDocs {\n  view: string;\n  pieProperties: PieDocsPropertyContract[];\n  configProperties: PieDocsPropertyContract[];\n  pieSource: string;\n  configSource: string;\n}\n\nconst applyMetadata = (\n  properties: PieDocsPropertyContract[],\n  metadata?: Record<string, PieDocsPropertyMetadata>\n): PieDocsPropertyContract[] => {\n  if (!metadata || Object.keys(metadata).length === 0) {\n    return properties;\n  }\n\n  const byPath = new Map<string, PieDocsPropertyContract>(\n    properties.map((p) => [p.path, { ...p }])\n  );\n\n  for (const [path, meta] of Object.entries(metadata)) {\n    const current = byPath.get(path) || {\n      path,\n      type: meta.type || 'unknown',\n      required: meta.required ?? false,\n    };\n    const merged: PieDocsPropertyContract = {\n      ...current,\n      ...(meta.type ? { type: meta.type } : {}),\n      ...(meta.required !== undefined ? { required: meta.required } : {}),\n      ...(meta.title ? { title: meta.title } : {}),\n      ...(meta.description ? { description: meta.description } : {}),\n      ...(meta.notes ? { notes: meta.notes } : {}),\n      ...(meta.enum ? { enum: [...meta.enum] } : {}),\n      ...(meta.minimum !== undefined ? { minimum: meta.minimum } : {}),\n      ...(meta.maximum !== undefined ? { maximum: meta.maximum } : {}),\n      ...(meta.minLength !== undefined ? { minLength: meta.minLength } : {}),\n      ...(meta.maxLength !== undefined ? { maxLength: meta.maxLength } : {}),\n      ...(meta.pattern ? { pattern: meta.pattern } : {}),\n      ...(meta.itemType ? { itemType: meta.itemType } : {}),\n      ...(meta.examples ? { examples: [...meta.examples] } : {}),\n    };\n    byPath.set(path, merged);\n  }\n\n  return Array.from(byPath.values()).sort((a, b) => a.path.localeCompare(b.path));\n};\n\nconst propertyFingerprint = (properties: PieDocsPropertyContract[]): string =>\n  JSON.stringify(\n    properties.map((p) => ({\n      path: p.path,\n      type: p.type,\n      required: p.required,\n      defaultValue: p.defaultValue,\n    }))\n  );\n\nconst renderPropertyHtml = (prop: PieDocsPropertyContract): string => {\n  const rows: string[] = [];\n  rows.push(`<li><strong>Type:</strong> <code>${escapeHtml(prop.type)}</code></li>`);\n  rows.push(`<li><strong>Required:</strong> <code>${String(prop.required)}</code></li>`);\n  if (prop.itemType) {\n    rows.push(`<li><strong>Item Type:</strong> <code>${escapeHtml(prop.itemType)}</code></li>`);\n  }\n  if (prop.description) {\n    rows.push(`<li><strong>Description:</strong> ${escapeHtml(prop.description)}</li>`);\n  }\n  if (prop.enum && prop.enum.length > 0) {\n    rows.push(\n      `<li><strong>Allowed values:</strong> ${prop.enum\n        .map((v) => `<code>${escapeHtml(formatInline(v))}</code>`)\n        .join(', ')}</li>`\n    );\n  }\n  const constraints: string[] = [];\n  if (prop.minimum !== undefined) constraints.push(`<code>minimum: ${prop.minimum}</code>`);\n  if (prop.maximum !== undefined) constraints.push(`<code>maximum: ${prop.maximum}</code>`);\n  if (prop.minLength !== undefined) constraints.push(`<code>minLength: ${prop.minLength}</code>`);\n  if (prop.maxLength !== undefined) constraints.push(`<code>maxLength: ${prop.maxLength}</code>`);\n  if (prop.pattern) constraints.push(`<code>pattern: ${escapeHtml(prop.pattern)}</code>`);\n  if (constraints.length) {\n    rows.push(`<li><strong>Constraints:</strong> ${constraints.join(', ')}</li>`);\n  }\n  rows.push(\n    `<li><strong>Default:</strong> ${\n      prop.defaultValue !== undefined ? formatValue(prop.defaultValue) : '<em>none</em>'\n    }</li>`\n  );\n  if (prop.examples && prop.examples.length > 0) {\n    rows.push(\n      `<li><strong>Examples:</strong> ${prop.examples\n        .map((v) => `<code>${escapeHtml(formatInline(v))}</code>`)\n        .join(', ')}</li>`\n    );\n  }\n  if (prop.notes) {\n    rows.push(`<li><strong>Notes:</strong> ${escapeHtml(prop.notes)}</li>`);\n  }\n\n  return `\n  <section class=\"doc-property\">\n    <h3><code>${escapeHtml(prop.path)}</code></h3>\n    <ul>\n      ${rows.join('\\n      ')}\n    </ul>\n  </section>`;\n};\n\nconst renderPropertiesSectionHtml = (\n  title: string,\n  source: string,\n  properties: PieDocsPropertyContract[]\n): string => {\n  if (properties.length === 0) {\n    return `\n    <section class=\"doc-section\">\n      <h2>${escapeHtml(title)}</h2>\n      <p><strong>Source:</strong> <code>${escapeHtml(source)}</code></p>\n      <p>No properties found.</p>\n    </section>`;\n  }\n\n  return `\n  <section class=\"doc-section\">\n    <h2>${escapeHtml(title)}</h2>\n    <p><strong>Source:</strong> <code>${escapeHtml(source)}</code></p>\n    ${properties.map((prop) => renderPropertyHtml(prop)).join('\\n')}\n  </section>`;\n};\n\nconst wrapHtmlPage = (title: string, body: string): string => `\n<!doctype html>\n<html lang=\"en\">\n  <head>\n    <meta charset=\"utf-8\" />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n    <title>${escapeHtml(title)}</title>\n    <style>\n      :root { color-scheme: light dark; font-family: Inter, system-ui, sans-serif; }\n      body { margin: 0; padding: 1.5rem; line-height: 1.55; }\n      h1,h2,h3 { line-height: 1.25; }\n      h1 { margin-top: 0; }\n      code { font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; }\n      .doc-section { margin-bottom: 2rem; }\n      .doc-property { margin: 0 0 1.25rem 0; padding-bottom: 0.5rem; border-bottom: 1px solid rgba(128,128,128,.25); }\n      ul { padding-left: 1.25rem; }\n      .meta-list li { margin-bottom: .25rem; }\n    </style>\n  </head>\n  <body>\n    ${body}\n  </body>\n</html>\n`;\n\nconst renderElementIndexHtml = (opts: {\n  contract: PieDocsContract;\n  summary: string;\n  generatedAt: string;\n  emittedViews: string[];\n}): string =>\n  wrapHtmlPage(\n    `${opts.contract.elementName} docs`,\n    `\n    <h1>${escapeHtml(opts.contract.elementName)} docs</h1>\n    <section class=\"doc-section\">\n      <h2>Overview</h2>\n      <p>${escapeHtml(opts.summary)}</p>\n    </section>\n    <section class=\"doc-section\">\n      <h2>Element Metadata</h2>\n      <ul class=\"meta-list\">\n        <li><strong>Element:</strong> <code>${escapeHtml(opts.contract.elementName)}</code></li>\n        <li><strong>Package:</strong> <code>${escapeHtml(opts.contract.packageName)}</code></li>\n        <li><strong>Framework:</strong> <code>${escapeHtml(opts.contract.framework)}</code></li>\n        <li><strong>Generated:</strong> <code>${escapeHtml(opts.generatedAt)}</code></li>\n      </ul>\n    </section>\n    <section class=\"doc-section\">\n      <h2>Supported Modes</h2>\n      <ul class=\"meta-list\">\n        ${(opts.contract.supportedModes || []).map((mode) => `<li>${escapeHtml(mode)}</li>`).join('')}\n      </ul>\n    </section>\n    <section class=\"doc-section\">\n      <h2>Views</h2>\n      <ul class=\"meta-list\">\n        ${opts.emittedViews\n          .map(\n            (view) =>\n              `<li><a href=\"./${encodeURIComponent(view)}.html\">${escapeHtml(view)}</a></li>`\n          )\n          .join('')}\n      </ul>\n    </section>\n  `\n  );\n\nconst renderViewHtml = (opts: {\n  contract: PieDocsContract;\n  view: string;\n  pieSource: string;\n  configSource: string;\n  pieProperties: PieDocsPropertyContract[];\n  configProperties: PieDocsPropertyContract[];\n}): string =>\n  wrapHtmlPage(\n    `${opts.contract.elementName} ${opts.view} docs`,\n    `\n    <h1>${escapeHtml(opts.contract.elementName)} / ${escapeHtml(opts.view)}</h1>\n    ${renderPropertiesSectionHtml('Model Defaults', opts.pieSource, opts.pieProperties)}\n    ${renderPropertiesSectionHtml(\n      'Authoring/Configuration Defaults',\n      opts.configSource,\n      opts.configProperties\n    )}\n  `\n  );\n\nconst chooseViewDocs = (resolvedViews: ResolvedViewDocs[]): ResolvedViewDocs[] => {\n  const map = new Map(resolvedViews.map((v) => [v.view, v]));\n  const chosen: ResolvedViewDocs[] = [];\n\n  const delivery = map.get('delivery');\n  const author = map.get('author');\n  const print = map.get('print');\n\n  if (delivery) {\n    chosen.push(delivery);\n  }\n  if (author) {\n    chosen.push(author);\n  }\n\n  if (print) {\n    const deliveryFingerprint = delivery\n      ? `${propertyFingerprint(delivery.pieProperties)}|${propertyFingerprint(delivery.configProperties)}`\n      : '';\n    const printFingerprint = `${propertyFingerprint(print.pieProperties)}|${propertyFingerprint(print.configProperties)}`;\n    const sourceDiffFromDelivery = delivery\n      ? print.pieSource !== delivery.pieSource || print.configSource !== delivery.configSource\n      : true;\n    const sourceDiffFromAuthor = author\n      ? print.pieSource !== author.pieSource || print.configSource !== author.configSource\n      : true;\n    const materiallyDifferent = !delivery || printFingerprint !== deliveryFingerprint;\n    if (materiallyDifferent || sourceDiffFromDelivery || sourceDiffFromAuthor) {\n      chosen.push(print);\n    }\n  }\n\n  const extras = resolvedViews\n    .filter((v) => !['delivery', 'author', 'print'].includes(v.view))\n    .sort((a, b) => a.view.localeCompare(b.view));\n  for (const extra of extras) {\n    chosen.push(extra);\n  }\n\n  return chosen;\n};\n\nexport const generateDocsForContract = async (\n  packageDir: string,\n  contract: PieDocsContract,\n  options: GenerateDocsOptions\n): Promise<GenerateDocsResult> => {\n  const generatedAt = new Date().toISOString();\n  const summary = await readSummary(packageDir, contract.summary);\n  const filesWritten: string[] = [];\n  const filesChecked: string[] = [];\n  const driftFiles: string[] = [];\n  const sourcesUsed = new Set<string>();\n\n  const outputs: PieDocsElementOutput = {\n    contract,\n    packageDir,\n    generatedAt,\n    views: [],\n    sourcesUsed: [],\n  };\n\n  const resolvedViews: ResolvedViewDocs[] = [];\n  for (const view of contract.views) {\n    const pieResolved = await loadValueWithFallback(packageDir, view.pie, 'pie');\n    const configResolved = await loadValueWithFallback(packageDir, view.config, 'config');\n    const pieProperties = applyMetadata(\n      flattenProperties(pieResolved.value).sort((a, b) => a.path.localeCompare(b.path)),\n      view.metadata?.pie\n    );\n    const configProperties = applyMetadata(\n      flattenProperties(configResolved.value).sort((a, b) => a.path.localeCompare(b.path)),\n      view.metadata?.config\n    );\n\n    resolvedViews.push({\n      view: view.view,\n      pieProperties,\n      configProperties,\n      pieSource: pieResolved.sourceLabel,\n      configSource: configResolved.sourceLabel,\n    });\n  }\n\n  const emittedViews = chooseViewDocs(resolvedViews);\n  const elementOutputDir = join(options.outputDir, contract.elementName);\n  const elementIndexPath = join(elementOutputDir, 'index.html');\n  const elementIndexContent = renderElementIndexHtml({\n    contract,\n    summary,\n    generatedAt,\n    emittedViews: emittedViews.map((v) => v.view),\n  });\n\n  const manifest = {\n    elementName: contract.elementName,\n    packageName: contract.packageName,\n    framework: contract.framework,\n    generatedAt,\n    summary,\n    supportedModes: contract.supportedModes || [],\n    views: emittedViews.map((view) => ({\n      id: view.view,\n      file: `${view.view}.html`,\n      pieSource: view.pieSource,\n      configSource: view.configSource,\n      hasModelDefaults: view.pieProperties.length > 0,\n      hasConfigDefaults: view.configProperties.length > 0,\n    })),\n  };\n\n  const candidates: Array<{ path: string; content: string }> = [\n    { path: elementIndexPath, content: elementIndexContent },\n    {\n      path: join(elementOutputDir, 'manifest.json'),\n      content: `${JSON.stringify(manifest, null, 2)}\\n`,\n    },\n    ...emittedViews.map((view) => ({\n      path: join(elementOutputDir, `${view.view}.html`),\n      content: renderViewHtml({\n        contract,\n        view: view.view,\n        pieSource: view.pieSource,\n        configSource: view.configSource,\n        pieProperties: view.pieProperties,\n        configProperties: view.configProperties,\n      }),\n    })),\n  ];\n\n  for (const candidate of candidates) {\n    filesChecked.push(candidate.path);\n    if (options.check) {\n      const existing = existsSync(candidate.path) ? await readFile(candidate.path, 'utf-8') : null;\n      if (\n        existing === null ||\n        normalizeForCheck(candidate.path, existing) !==\n          normalizeForCheck(candidate.path, candidate.content)\n      ) {\n        driftFiles.push(candidate.path);\n      }\n      continue;\n    }\n\n    if (!options.dryRun) {\n      await mkdir(elementOutputDir, { recursive: true });\n      await writeFile(candidate.path, candidate.content, 'utf-8');\n    }\n    filesWritten.push(candidate.path);\n  }\n\n  for (const view of emittedViews) {\n    sourcesUsed.add(view.pieSource);\n    sourcesUsed.add(view.configSource);\n    outputs.views.push({\n      view: view.view,\n      pieProperties: view.pieProperties,\n      configProperties: view.configProperties,\n    });\n  }\n\n  outputs.sourcesUsed = Array.from(sourcesUsed).sort();\n\n  return {\n    filesWritten,\n    filesChecked,\n    driftFiles,\n    outputs: [outputs],\n  };\n};\n\nexport const toRelativePaths = (rootDir: string, paths: string[]): string[] =>\n  paths.map((p) => relative(rootDir, p)).sort();\n"]}

package/dist/lib/docs/source-extractor.d.ts

@@ -0,0 +1,2 @@
+import type { PieDocsSourcePointer } from './types.js';
+export declare const loadPointerValue: (packageDir: string, pointer: PieDocsSourcePointer) => Promise<unknown>;