@x12i/made-easy 0.0.0-stage → 0.1.0

package/dist/markdown-doc.js

@@ -0,0 +1,187 @@
+import { BlockEnvelopeSchema, REF_KINDS } from './contracts/index.js';
+import { normalizeText, slugify } from './util.js';
+import { parseYaml, pointerFromPath } from './yamlfile.js';
+const OPEN_FENCE = /^( {0,3})(`{3,}|~{3,})[ \t]*([^`]*)$/;
+const HEADING = /^(#{1,6})[ \t]+(.*?)(?:[ \t]+\{#([A-Za-z0-9][A-Za-z0-9_-]*)\})?[ \t]*$/;
+export const REF_PATTERN = new RegExp(`\\[\\[(${REF_KINDS.join('|')}):([a-z0-9][a-z0-9_-]*)(#[A-Za-z0-9_-]+)?\\]\\]`, 'g');
+export const PLACEHOLDER_PATTERN = /\[\[TODO:[^\]]*\]\]/g;
+/** Split a markdown file into prose and `made-easy` structured blocks, collecting headings. */
+export function parseMarkdownDoc(path, rawText) {
+    const text = normalizeText(rawText).replace(/\n$/, '');
+    const lines = text.split('\n');
+    const nodes = [];
+    const headings = [];
+    const diagnostics = [];
+    const usedAnchors = new Set();
+    let buffer = [];
+    let bufferStart = 1;
+    const flush = (endLine) => {
+        if (buffer.some((l) => l.trim() !== '')) {
+            nodes.push({ kind: 'markdown', source: buffer.join('\n'), line: bufferStart, endLine });
+        }
+        buffer = [];
+    };
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        const open = OPEN_FENCE.exec(line);
+        if (open) {
+            const fence = open[2];
+            const info = (open[3] ?? '').trim();
+            // find closing fence
+            let j = i + 1;
+            while (j < lines.length) {
+                const l = lines[j].trimEnd();
+                const m = /^ {0,3}(`{3,}|~{3,})$/.exec(l);
+                if (m && m[1][0] === fence[0] && m[1].length >= fence.length)
+                    break;
+                j++;
+            }
+            const closed = j < lines.length;
+            if (/^made-easy(\s|$)/.test(info)) {
+                flush(i);
+                const bodyLines = lines.slice(i + 1, closed ? j : lines.length);
+                if (!closed) {
+                    diagnostics.push({
+                        code: 'BLOCK_PARSE_ERROR',
+                        severity: 'error',
+                        path,
+                        line: i + 1,
+                        message: 'The structured block is not closed with a matching fence.',
+                    });
+                }
+                const parsed = parseYaml(path, bodyLines.join('\n'), i + 1);
+                diagnostics.push(...parsed.diagnostics);
+                if (!parsed.diagnostics.length) {
+                    const env = BlockEnvelopeSchema.safeParse(parsed.data);
+                    if (env.success) {
+                        nodes.push({
+                            kind: 'block',
+                            id: env.data.id,
+                            type: env.data.type,
+                            props: (env.data.props ?? {}),
+                            line: i + 1,
+                            endLine: closed ? j + 1 : lines.length,
+                            lineOf: parsed.lineOf,
+                        });
+                    }
+                    else {
+                        for (const issue of env.error.issues) {
+                            if (issue.code === 'unrecognized_keys') {
+                                for (const k of issue.keys) {
+                                    diagnostics.push({
+                                        code: 'BLOCK_PARSE_ERROR',
+                                        severity: 'error',
+                                        path,
+                                        line: parsed.lineOf(pointerFromPath([k])),
+                                        message: `Unknown block field "${k}". Blocks have id, type and props.`,
+                                    });
+                                }
+                                continue;
+                            }
+                            diagnostics.push({
+                                code: 'BLOCK_PARSE_ERROR',
+                                severity: 'error',
+                                path,
+                                line: parsed.lineOf(pointerFromPath(issue.path)),
+                                message: `${issue.path.join('.') || 'block'}: ${issue.message}`,
+                            });
+                        }
+                    }
+                }
+                bufferStart = (closed ? j : lines.length) + 2;
+                i = closed ? j + 1 : lines.length;
+                continue;
+            }
+            // Ordinary code fence: keep as prose, never scan inside.
+            if (!buffer.length)
+                bufferStart = i + 1;
+            const end = closed ? j : lines.length - 1;
+            for (let k = i; k <= end; k++)
+                buffer.push(lines[k]);
+            i = end + 1;
+            continue;
+        }
+        const h = HEADING.exec(line);
+        if (h) {
+            const level = h[1].length;
+            const textRaw = h[2].replace(/[ \t]+#+[ \t]*$/, '').trim();
+            const explicit = h[3];
+            let anchor = explicit ?? slugify(textRaw.replace(/[`*_]/g, ''));
+            if (!explicit) {
+                let n = 2;
+                const base = anchor;
+                while (usedAnchors.has(anchor))
+                    anchor = `${base}-${n++}`;
+            }
+            usedAnchors.add(anchor);
+            headings.push({ level, text: textRaw, anchor, explicit: Boolean(explicit), line: i + 1 });
+        }
+        if (!buffer.length)
+            bufferStart = i + 1;
+        buffer.push(line);
+        i++;
+    }
+    flush(lines.length);
+    return { nodes, headings, diagnostics };
+}
+/** Strip inline code spans so references and placeholders inside them are ignored. */
+function maskInlineCode(line) {
+    return line.replace(/(`+)([^`]|[^`][\s\S]*?[^`])\1(?!`)/g, (m) => ' '.repeat(m.length));
+}
+/** Iterate prose lines of a markdown node, skipping fenced code. */
+export function* proseLines(node) {
+    const lines = node.source.split('\n');
+    let fence;
+    for (let k = 0; k < lines.length; k++) {
+        const l = lines[k];
+        const m = /^ {0,3}(`{3,}|~{3,})/.exec(l);
+        if (m) {
+            if (!fence)
+                fence = m[1][0].repeat(m[1].length);
+            else if (m[1][0] === fence[0] && m[1].length >= fence.length && l.trim() === m[1])
+                fence = undefined;
+            continue;
+        }
+        if (fence)
+            continue;
+        yield { text: maskInlineCode(l), line: node.line + k };
+    }
+}
+export function extractInlineRefs(node) {
+    const out = [];
+    for (const { text, line } of proseLines(node)) {
+        for (const m of text.matchAll(REF_PATTERN)) {
+            out.push({
+                kind: m[1],
+                id: m[2],
+                anchor: m[3]?.slice(1),
+                line,
+                raw: m[0],
+            });
+        }
+    }
+    return out;
+}
+/** Bundle paths of Markdown images (`![alt](assets/x.png)`), normalised the way the renderer looks them up. */
+export function extractImagePaths(node) {
+    const out = [];
+    for (const { text } of proseLines(node)) {
+        for (const m of text.matchAll(/!\[[^\]]*\]\(\s*<?([^)\s>]+)/g))
+            out.push(m[1].replace(/^\.\//, ''));
+    }
+    return out;
+}
+export function extractPlaceholders(node) {
+    const out = [];
+    for (const { text, line } of proseLines(node)) {
+        for (const m of text.matchAll(PLACEHOLDER_PATTERN))
+            out.push({ line, text: m[0] });
+    }
+    return out;
+}
+/** Prose text without fenced code, markup noise or placeholders, for word counting. */
+export function proseText(node) {
+    return [...proseLines(node)].map((l) => l.text).join('\n');
+}
+//# sourceMappingURL=markdown-doc.js.map

package/dist/markdown-doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-doc.js","sourceRoot":"","sources":["../src/markdown-doc.ts"],"names":[],"mappings":"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"}

package/dist/model.d.ts

@@ -0,0 +1,54 @@
+import { type Asset, type Brief, type ChecksFile, type Diagnostic, type GuideManifest, type ResolvedRecipe, type SourcesFile, type Track, type VerificationFile, type AssetsFile } from './contracts/index.js';
+import { type DocNode, type Heading } from './markdown-doc.js';
+import { BundleFiles, type BundleLimits, type BundleSource } from './source.js';
+import { canonicalJson } from './util.js';
+import { type LineLookup } from './yamlfile.js';
+export interface ModelEntry {
+    track: Track;
+    id: string;
+    role: string;
+    path: string;
+    title: string;
+    /** Title taken from the first level-1 heading, when present. */
+    hasChapterHeading: boolean;
+    headings: Heading[];
+    nodes: DocNode[];
+    words: number;
+    digest: string;
+    /** Pointer index of this entry in guide.yaml, for diagnostics. */
+    pointer: string;
+}
+export interface GuideModel {
+    files: BundleFiles;
+    label: string;
+    guide?: GuideManifest;
+    brief?: Brief;
+    checks?: ChecksFile;
+    sources?: SourcesFile;
+    assets?: AssetsFile;
+    verification?: VerificationFile;
+    recipe?: ResolvedRecipe;
+    lines: Record<string, LineLookup>;
+    entries: ModelEntry[];
+    revision: string;
+    referenceRevision: string;
+    /** Diagnostics from reading and parsing (schemas, YAML, blocks, paths). */
+    diagnostics: Diagnostic[];
+}
+export declare function fileDigest(path: string, bytes: Uint8Array): string;
+export declare function computeRevision(files: BundleFiles): string;
+export declare function computeReferenceRevision(entries: ModelEntry[], brief: Brief | undefined): string;
+/** Read a bundle from any source into one parsed model. Never throws for bad content. */
+export declare function readGuide(input: BundleSource | BundleFiles, limits?: BundleLimits): Promise<GuideModel>;
+export declare function entriesOf(model: GuideModel, track: Track): ModelEntry[];
+export declare function guideTitle(guide: GuideManifest): string;
+export declare function blocksOf(entry: ModelEntry): Extract<DocNode, {
+    kind: 'block';
+}>[];
+export declare function allBlocks(model: GuideModel): {
+    entry: ModelEntry;
+    block: import("./markdown-doc.js").BlockNode;
+}[];
+export declare function assetById(model: GuideModel, id: string): Asset | undefined;
+export { canonicalJson };
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AACA,OAAO,EAcL,KAAK,KAAK,EACV,KAAK,KAAK,EACV,KAAK,UAAU,EACf,KAAK,UAAU,EAEf,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,KAAK,EACV,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAEhB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAoB,KAAK,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EACL,WAAW,EAIX,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAA0C,MAAM,WAAW,CAAC;AAClF,OAAO,EAAwC,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAGtF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAID,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAIlE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAG1D;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAUhG;AAyCD,yFAAyF;AACzF,wBAAsB,SAAS,CAC7B,KAAK,EAAE,YAAY,GAAG,WAAW,EACjC,MAAM,GAAE,YAA6B,GACpC,OAAO,CAAC,UAAU,CAAC,CA6CrB;AA8HD,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,UAAU,EAAE,CAEvE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAEvD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,EAAE,CAEjF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU;;;IAE1C;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAE1E;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/model.js

@@ -0,0 +1,244 @@
+import { AssetsSchema, BLOCK_DEFINITIONS, BriefSchema, BUNDLE_FILES, ChecksSchema, EXTRA_ROLES, GuideSchema, HUMAN_ROLES, OPERATOR_ROLES, SourcesSchema, VerificationSchema, getGuideRecipe, isBlockType, MadeEasyError, } from './contracts/index.js';
+import { parseMarkdownDoc } from './markdown-doc.js';
+import { BundleFiles, DEFAULT_LIMITS, checkBundlePath, loadBundleFiles, } from './source.js';
+import { canonicalJson, normalizeText, sha256Digest, wordCount } from './util.js';
+import { parseYamlWithSchema, pointerFromPath } from './yamlfile.js';
+import { proseText } from './markdown-doc.js';
+const TEXT_EXT = /\.(md|markdown|ya?ml|json|txt|csv|css|html?|svg|js|mjs|cjs|ts|tsx|jsx|sh|ps1|toml)$/i;
+export function fileDigest(path, bytes) {
+    return TEXT_EXT.test(path)
+        ? sha256Digest(normalizeText(new TextDecoder().decode(bytes)))
+        : sha256Digest(bytes);
+}
+export function computeRevision(files) {
+    const lines = files.entries().map(([p, b]) => `${p}\u0000${fileDigest(p, b)}`);
+    return sha256Digest(lines.join('\n'));
+}
+export function computeReferenceRevision(entries, brief) {
+    const pins = brief?.operatorReference?.entries ?? [];
+    const byId = new Map(entries.filter((e) => e.track === 'operator').map((e) => [e.id, e]));
+    const lines = pins
+        .map((p) => {
+        const e = byId.get(p.id);
+        return e ? `${p.id}:${e.digest}` : undefined;
+    })
+        .filter(Boolean);
+    return sha256Digest(lines.join('\n'));
+}
+function mergeLines(model, path, lineOf) {
+    model.lines[path] = lineOf;
+}
+function readYamlFile(model, path, schema, required) {
+    const text = model.files.text(path);
+    if (text === undefined) {
+        if (required) {
+            model.diagnostics.push({
+                code: 'BUNDLE_FILE_MISSING',
+                severity: 'error',
+                path,
+                message: `${path} is required but missing.`,
+            });
+        }
+        return undefined;
+    }
+    const parsed = parseYamlWithSchema(path, text, schema);
+    mergeLines(model, path, parsed.lineOf);
+    model.diagnostics.push(...parsed.diagnostics);
+    return parsed.value;
+}
+function titleFor(entry, nodes, headings, recipe) {
+    const h1 = headings.find((h) => h.level === 1);
+    if (entry.title)
+        return { title: entry.title, chapter: Boolean(h1) };
+    if (h1)
+        return { title: h1.text.replace(/[`*_]/g, ''), chapter: true };
+    const role = recipe?.roleDetails.find((r) => r.role === entry.role)?.title ??
+        recipe?.operatorRoles.find((r) => r.role === entry.role)?.title;
+    void nodes;
+    return { title: role ?? entry.id, chapter: false };
+}
+/** Read a bundle from any source into one parsed model. Never throws for bad content. */
+export async function readGuide(input, limits = DEFAULT_LIMITS) {
+    let files;
+    const diagnostics = [];
+    if (input instanceof BundleFiles)
+        files = input;
+    else {
+        const loaded = await loadBundleFiles(input, limits);
+        files = loaded.files;
+        diagnostics.push(...loaded.diagnostics);
+    }
+    const model = {
+        files,
+        label: files.label,
+        lines: {},
+        entries: [],
+        revision: computeRevision(files),
+        referenceRevision: '',
+        diagnostics,
+    };
+    model.guide = readYamlFile(model, BUNDLE_FILES.guide, GuideSchema, true);
+    model.brief = readYamlFile(model, BUNDLE_FILES.brief, BriefSchema, true);
+    model.checks = readYamlFile(model, BUNDLE_FILES.checks, ChecksSchema, true);
+    model.sources = readYamlFile(model, BUNDLE_FILES.sources, SourcesSchema, true);
+    model.assets = readYamlFile(model, BUNDLE_FILES.assets, AssetsSchema, true);
+    model.verification = readYamlFile(model, BUNDLE_FILES.verification, VerificationSchema, false);
+    if (model.guide) {
+        try {
+            model.recipe = getGuideRecipe(model.guide.recipe.id, model.guide.recipe.version);
+        }
+        catch (e) {
+            if (e instanceof MadeEasyError) {
+                model.diagnostics.push({
+                    code: e.code,
+                    severity: 'error',
+                    path: BUNDLE_FILES.guide,
+                    line: model.lines[BUNDLE_FILES.guide]?.(e.code === 'RECIPE_UNKNOWN' ? '/recipe/id' : '/recipe/version'),
+                    pointer: e.code === 'RECIPE_UNKNOWN' ? '/recipe/id' : '/recipe/version',
+                    message: e.message,
+                });
+            }
+            else
+                throw e;
+        }
+        readEntries(model, model.guide);
+    }
+    model.referenceRevision = computeReferenceRevision(model.entries, model.brief);
+    return model;
+}
+function readEntries(model, guide) {
+    const seenIds = new Map();
+    const seenPaths = new Map();
+    const seenBlocks = new Map();
+    for (const track of ['human', 'operator']) {
+        const roles = track === 'human' ? [...HUMAN_ROLES, ...EXTRA_ROLES] : [...OPERATOR_ROLES, ...EXTRA_ROLES];
+        guide.tracks[track].forEach((entry, index) => {
+            const pointer = pointerFromPath(['tracks', track, index]);
+            const line = model.lines[BUNDLE_FILES.guide]?.(pointer);
+            const diag = (code, message, sub = '') => model.diagnostics.push({
+                code,
+                severity: 'error',
+                path: BUNDLE_FILES.guide,
+                line: model.lines[BUNDLE_FILES.guide]?.(pointer + sub) ?? line,
+                pointer: pointer + sub,
+                message,
+            });
+            if (!roles.includes(entry.role)) {
+                diag('SCHEMA_INVALID', `Unknown ${track} role "${entry.role}". Allowed: ${roles.join(', ')}.`, '/role');
+            }
+            if (seenIds.has(entry.id)) {
+                diag('ID_DUPLICATE', `Entry id "${entry.id}" is already used by ${seenIds.get(entry.id)}.`, '/id');
+            }
+            seenIds.set(entry.id, `${track} entry ${index + 1}`);
+            const check = checkBundlePath(entry.path);
+            if (!check.ok) {
+                diag('BUNDLE_PATH_UNSAFE', `Entry path "${entry.path}" is unsafe: ${check.reason}.`, '/path');
+                return;
+            }
+            if (!check.path.startsWith(`${track}/`) || !check.path.endsWith('.md')) {
+                diag('SCHEMA_INVALID', `Entry path "${entry.path}" must be a Markdown file under ${track}/.`, '/path');
+                return;
+            }
+            if (seenPaths.has(check.path)) {
+                diag('ID_DUPLICATE', `Entry path "${entry.path}" is used by more than one entry.`, '/path');
+            }
+            seenPaths.set(check.path, entry.id);
+            const text = model.files.text(check.path);
+            if (text === undefined) {
+                diag('BUNDLE_FILE_MISSING', `Entry file ${check.path} does not exist.`, '/path');
+                return;
+            }
+            const parsed = parseMarkdownDoc(check.path, text);
+            model.diagnostics.push(...parsed.diagnostics);
+            // Block registry validation.
+            for (const node of parsed.nodes) {
+                if (node.kind !== 'block')
+                    continue;
+                if (seenBlocks.has(node.id)) {
+                    model.diagnostics.push({
+                        code: 'ID_DUPLICATE',
+                        severity: 'error',
+                        path: check.path,
+                        line: node.line,
+                        blockId: node.id,
+                        message: `Block id "${node.id}" is already used in ${seenBlocks.get(node.id)}.`,
+                    });
+                }
+                seenBlocks.set(node.id, check.path);
+                if (!isBlockType(node.type)) {
+                    model.diagnostics.push({
+                        code: 'BLOCK_UNKNOWN_TYPE',
+                        severity: 'error',
+                        path: check.path,
+                        line: node.line,
+                        blockId: node.id,
+                        message: `Unknown block type "${node.type}".`,
+                    });
+                    continue;
+                }
+                const result = BLOCK_DEFINITIONS[node.type].schema.safeParse(node.props);
+                if (!result.success) {
+                    for (const issue of result.error.issues) {
+                        if (issue.code === 'unrecognized_keys') {
+                            for (const k of issue.keys) {
+                                const ptr = pointerFromPath(['props', ...issue.path, k]);
+                                model.diagnostics.push({
+                                    code: 'BLOCK_PROPS_INVALID',
+                                    severity: 'error',
+                                    path: check.path,
+                                    line: node.lineOf(ptr),
+                                    blockId: node.id,
+                                    pointer: ptr,
+                                    message: `${node.type}: unknown prop "${[...issue.path, k].join('.')}".`,
+                                });
+                            }
+                            continue;
+                        }
+                        const ptr = pointerFromPath(['props', ...issue.path]);
+                        model.diagnostics.push({
+                            code: 'BLOCK_PROPS_INVALID',
+                            severity: 'error',
+                            path: check.path,
+                            line: node.lineOf(ptr),
+                            blockId: node.id,
+                            pointer: ptr,
+                            message: `${node.type}: ${issue.path.join('.') || 'props'}: ${issue.message}`,
+                        });
+                    }
+                }
+            }
+            const { title, chapter } = titleFor(entry, parsed.nodes, parsed.headings, model.recipe);
+            const words = parsed.nodes.reduce((n, node) => n + (node.kind === 'markdown' ? wordCount(proseText(node)) : 0), 0);
+            model.entries.push({
+                track,
+                id: entry.id,
+                role: entry.role,
+                path: check.path,
+                title,
+                hasChapterHeading: chapter,
+                headings: parsed.headings,
+                nodes: parsed.nodes,
+                words,
+                digest: sha256Digest(normalizeText(text)),
+                pointer,
+            });
+        });
+    }
+}
+export function entriesOf(model, track) {
+    return model.entries.filter((e) => e.track === track);
+}
+export function guideTitle(guide) {
+    return `${guide.subject.name} Made Easy`;
+}
+export function blocksOf(entry) {
+    return entry.nodes.filter((n) => n.kind === 'block');
+}
+export function allBlocks(model) {
+    return model.entries.flatMap((e) => blocksOf(e).map((b) => ({ entry: e, block: b })));
+}
+export function assetById(model, id) {
+    return model.assets?.assets?.find((a) => a.id === id);
+}
+export { canonicalJson };
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"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"}

package/dist/normalize.d.ts

@@ -0,0 +1,63 @@
+import type { Brief, ChecksFile, GuideManifest, SourcesFile, Track } from './contracts/index.js';
+import { type GuideModel } from './model.js';
+export interface NormalizedBlock {
+    kind: 'block';
+    id: string;
+    type: string;
+    props: Record<string, unknown>;
+}
+export interface NormalizedMarkdown {
+    kind: 'markdown';
+    source: string;
+}
+export interface NormalizedEntry {
+    id: string;
+    role: string;
+    title: string;
+    path: string;
+    digest: string;
+    headings: {
+        level: number;
+        text: string;
+        anchor: string;
+        explicit: boolean;
+    }[];
+    nodes: (NormalizedBlock | NormalizedMarkdown)[];
+}
+/** The single normalized guide from which every output is rendered. JSON-serializable. */
+export interface NormalizedGuide {
+    schemaVersion: string;
+    guideId: string;
+    jobId: string;
+    locale: string;
+    title: string;
+    subject: GuideManifest['subject'];
+    recipe: GuideManifest['recipe'];
+    theme: GuideManifest['theme'];
+    revision: string;
+    referenceRevision: string;
+    brief: Brief | undefined;
+    checks: ChecksFile | undefined;
+    sources: SourcesFile | undefined;
+    assets: {
+        id: string;
+        path: string;
+        mediaType: string;
+        digest: string;
+        alt?: string;
+        decorative?: boolean;
+        visibility: string;
+    }[];
+    tracks: Record<Track, NormalizedEntry[]>;
+    /** Decisions, pauses and checks, used to prove parity across presets and adapters. */
+    facts: {
+        decisions: string[];
+        decisionOptions: string[];
+        pauses: string[];
+        checks: string[];
+        results: string[];
+        examples: string[];
+    };
+}
+export declare function toNormalizedGuide(model: GuideModel): NormalizedGuide;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AACjG,OAAO,EAAyB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAGpE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AACD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAC/E,KAAK,EAAE,CAAC,eAAe,GAAG,kBAAkB,CAAC,EAAE,CAAC;CACjD;AAED,0FAA0F;AAC1F,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,OAAO,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClI,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;IACzC,sFAAsF;IACtF,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,CAqDpE"}

package/dist/normalize.js

@@ -0,0 +1,54 @@
+import { allBlocks, guideTitle } from './model.js';
+import { entriesOf } from './model.js';
+export function toNormalizedGuide(model) {
+    const guide = model.guide;
+    const entry = (track) => entriesOf(model, track).map((e) => ({
+        id: e.id,
+        role: e.role,
+        title: e.title,
+        path: e.path,
+        digest: e.digest,
+        headings: e.headings.map((h) => ({ level: h.level, text: h.text, anchor: h.anchor, explicit: h.explicit })),
+        nodes: e.nodes.map((n) => n.kind === 'markdown'
+            ? { kind: 'markdown', source: n.source }
+            : { kind: 'block', id: n.id, type: n.type, props: n.props }),
+    }));
+    const blocks = allBlocks(model).map((b) => b.block);
+    const decisions = blocks.filter((b) => b.type === 'decision');
+    return {
+        schemaVersion: guide.schemaVersion,
+        guideId: guide.guideId,
+        jobId: guide.jobId,
+        locale: guide.locale,
+        title: guideTitle(guide),
+        subject: guide.subject,
+        recipe: guide.recipe,
+        theme: guide.theme,
+        revision: model.revision,
+        referenceRevision: model.referenceRevision,
+        brief: model.brief,
+        checks: model.checks,
+        sources: model.sources,
+        assets: (model.assets?.assets ?? []).map((a) => ({
+            id: a.id,
+            path: a.path,
+            mediaType: a.mediaType,
+            digest: a.digest,
+            alt: a.alt,
+            decorative: a.decorative,
+            visibility: a.visibility ?? 'private',
+        })),
+        tracks: { human: entry('human'), operator: entry('operator') },
+        facts: {
+            decisions: decisions.map((b) => b.id).sort(),
+            decisionOptions: decisions
+                .flatMap((b) => (b.props.options ?? []).map((o) => `${b.id}/${o.id}`))
+                .sort(),
+            pauses: (model.brief?.pauseRules ?? []).map((p) => p.id).sort(),
+            checks: (model.brief?.acceptanceChecks ?? []).slice().sort(),
+            results: (model.checks?.results ?? []).map((r) => r.id).sort(),
+            examples: blocks.filter((b) => b.type === 'example').map((b) => b.id).sort(),
+        },
+    };
+}
+//# sourceMappingURL=normalize.js.map