@x12i/made-easy 0.0.0-stage → 0.1.0

package/dist/render/brief.d.ts

@@ -0,0 +1,77 @@
+import { type GuideModel } from '../model.js';
+export interface BriefDocument {
+    schemaVersion: string;
+    guideId: string;
+    jobId: string;
+    title: string;
+    revision: string;
+    referenceRevision: string;
+    outcome: string;
+    inputs: {
+        id: string;
+        label: string;
+        required: boolean;
+        placeholder: string;
+        example: string;
+        description?: string;
+    }[];
+    authority: {
+        reads: string[];
+        changes: string[];
+    };
+    limits: string[];
+    pauseRules: {
+        id: string;
+        trigger: string;
+        owner: string;
+        mayContinue: string;
+        resumeWhen: string;
+    }[];
+    acceptanceChecks: {
+        id: string;
+        observable: string;
+        evidenceSource: string;
+        passCondition: string;
+        onMissing: string;
+        onContradictory: string;
+    }[];
+    reportBack: {
+        id: string;
+        label: string;
+        description?: string;
+    }[];
+    operatorReference: {
+        revision: string;
+        entries: {
+            id: string;
+            title: string;
+            path: string;
+            digest: string;
+        }[];
+    };
+    /** The blank template: inputs carry their placeholder text. */
+    template: {
+        inputs: {
+            id: string;
+            label: string;
+            value: string;
+        }[];
+    };
+    /** The worked brief: inputs carry their worked example values. */
+    worked: {
+        inputs: {
+            id: string;
+            label: string;
+            value: string;
+        }[];
+    };
+    /** Review checklist items, one per acceptance check. */
+    checklist: {
+        id: string;
+        text: string;
+        passCondition: string;
+    }[];
+}
+/** One source of truth for the brief, shared by the ebook, brief.md and brief.json. */
+export declare function buildBriefDocument(model: GuideModel): BriefDocument;
+//# sourceMappingURL=brief.d.ts.map

package/dist/render/brief.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief.d.ts","sourceRoot":"","sources":["../../src/render/brief.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvH,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAClD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtG,gBAAgB,EAAE;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,CAAC;KACzB,EAAE,CAAC;IACJ,UAAU,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClE,iBAAiB,EAAE;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KACxE,CAAC;IACF,+DAA+D;IAC/D,QAAQ,EAAE;QAAE,MAAM,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAC;IACrE,kEAAkE;IAClE,MAAM,EAAE;QAAE,MAAM,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAC;IACnE,wDAAwD;IACxD,SAAS,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAClE;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,CAyDnE"}

package/dist/render/brief.js

@@ -0,0 +1,62 @@
+import { SCHEMA_VERSION } from '../contracts/index.js';
+import { entriesOf, guideTitle } from '../model.js';
+/** One source of truth for the brief, shared by the ebook, brief.md and brief.json. */
+export function buildBriefDocument(model) {
+    const guide = model.guide;
+    const brief = model.brief ?? { schemaVersion: SCHEMA_VERSION };
+    const checks = new Map((model.checks?.checks ?? []).map((c) => [c.id, c]));
+    const operator = new Map(entriesOf(model, 'operator').map((e) => [e.id, e]));
+    const inputs = (brief.inputs ?? []).map((i) => ({
+        id: i.id,
+        label: i.label ?? i.id,
+        required: i.required !== false,
+        placeholder: i.placeholder ?? `{{${i.id}}}`,
+        example: i.example ?? '',
+        description: i.description,
+    }));
+    return {
+        schemaVersion: SCHEMA_VERSION,
+        guideId: guide.guideId,
+        jobId: guide.jobId,
+        title: guideTitle(guide),
+        revision: model.revision,
+        referenceRevision: model.referenceRevision,
+        outcome: brief.outcome ?? '',
+        inputs,
+        authority: { reads: brief.authority?.reads ?? [], changes: brief.authority?.changes ?? [] },
+        limits: brief.limits ?? [],
+        pauseRules: (brief.pauseRules ?? []).map((p) => ({
+            id: p.id,
+            trigger: p.trigger ?? '',
+            owner: p.owner ?? '',
+            mayContinue: p.mayContinue ?? '',
+            resumeWhen: p.resumeWhen ?? '',
+        })),
+        acceptanceChecks: (brief.acceptanceChecks ?? []).map((id) => {
+            const c = checks.get(id);
+            return {
+                id,
+                observable: c?.observable ?? '',
+                evidenceSource: c?.evidenceSource ?? '',
+                passCondition: c?.passCondition ?? '',
+                onMissing: c?.onMissing ?? '',
+                onContradictory: c?.onContradictory ?? '',
+            };
+        }),
+        reportBack: (brief.reportBack ?? []).map((r) => ({ id: r.id, label: r.label ?? r.id, description: r.description })),
+        operatorReference: {
+            revision: model.referenceRevision,
+            entries: (brief.operatorReference?.entries ?? [])
+                .map((p) => operator.get(p.id))
+                .filter((e) => Boolean(e))
+                .map((e) => ({ id: e.id, title: e.title, path: e.path, digest: e.digest })),
+        },
+        template: { inputs: inputs.map((i) => ({ id: i.id, label: i.label, value: i.placeholder })) },
+        worked: { inputs: inputs.map((i) => ({ id: i.id, label: i.label, value: i.example })) },
+        checklist: (brief.acceptanceChecks ?? []).map((id) => {
+            const c = checks.get(id);
+            return { id, text: c?.observable ?? id, passCondition: c?.passCondition ?? '' };
+        }),
+    };
+}
+//# sourceMappingURL=brief.js.map

package/dist/render/brief.js.map

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

package/dist/render/context.d.ts

@@ -0,0 +1,43 @@
+import type { Asset, Check, Claim, PauseRule, RefKind, Source, Track, WorkedResult } from '../contracts/index.js';
+import type { GuideModel, ModelEntry } from '../model.js';
+export type Page = 'human' | 'operator';
+export interface RenderContext {
+    model: GuideModel;
+    /** Page being rendered; links to the other page are relative to it. */
+    page: Page;
+    /** Standalone documents (PDF) cannot link to sibling files. */
+    standalone: boolean;
+    audience: 'private' | 'public';
+    draft: boolean;
+    checks: Map<string, Check>;
+    results: Map<string, WorkedResult>;
+    sources: Map<string, Source>;
+    claims: Map<string, Claim>;
+    assets: Map<string, Asset>;
+    assetByPath: Map<string, Asset>;
+    pauses: Map<string, PauseRule>;
+    entries: Map<string, ModelEntry>;
+    blockEntry: Map<string, ModelEntry>;
+    /** Resolve an asset ID to a file reference (relative path or data URI). */
+    assetSrc: (asset: Asset) => string | undefined;
+}
+export declare function makeContext(model: GuideModel, opts: {
+    page: Page;
+    standalone?: boolean;
+    audience?: 'private' | 'public';
+    draft?: boolean;
+    assetSrc?: (asset: Asset) => string | undefined;
+}): RenderContext;
+export declare function pageOfTrack(track: Track): Page;
+/** href to a rendered location; undefined when it cannot be linked (standalone PDF cross-page). */
+export declare function hrefTo(ctx: RenderContext, targetPage: Page, fragment: string): string | undefined;
+export interface ResolvedRef {
+    href?: string;
+    label: string;
+    title?: string;
+}
+/** Resolve `kind:id#anchor` into a link target and human label. */
+export declare function resolveRef(ctx: RenderContext, kind: RefKind, id: string, anchor?: string): ResolvedRef | undefined;
+export declare function titleOf(model: GuideModel): string;
+export declare function shortRef(digest: string): string;
+//# sourceMappingURL=context.d.ts.map

package/dist/render/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/render/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAClH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAK1D,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,UAAU,CAAC;AAExC,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,uEAAuE;IACvE,IAAI,EAAE,IAAI,CAAC;IACX,+DAA+D;IAC/D,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACnC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAChC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACjC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACpC,2EAA2E;IAC3E,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,GAAG,SAAS,CAAC;CAChD;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE;IACJ,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,GAAG,SAAS,CAAC;CACjD,GACA,aAAa,CAsBf;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAE9C;AAED,mGAAmG;AACnG,wBAAgB,MAAM,CAAC,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIjG;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CA0ClH;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEjD;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/render/context.js

@@ -0,0 +1,88 @@
+import { allBlocks } from '../model.js';
+import { guideTitle } from '../model.js';
+import { shortRevision } from '../util.js';
+export function makeContext(model, opts) {
+    const assets = new Map((model.assets?.assets ?? []).map((a) => [a.id, a]));
+    const page = opts.page;
+    return {
+        model,
+        page,
+        standalone: opts.standalone ?? false,
+        audience: opts.audience ?? 'private',
+        draft: opts.draft ?? false,
+        checks: new Map((model.checks?.checks ?? []).map((c) => [c.id, c])),
+        results: new Map((model.checks?.results ?? []).map((r) => [r.id, r])),
+        sources: new Map((model.sources?.sources ?? []).map((s) => [s.id, s])),
+        claims: new Map((model.sources?.claims ?? []).map((c) => [c.id, c])),
+        assets,
+        assetByPath: new Map((model.assets?.assets ?? []).map((a) => [a.path, a])),
+        pauses: new Map((model.brief?.pauseRules ?? []).map((p) => [p.id, p])),
+        entries: new Map(model.entries.map((e) => [e.id, e])),
+        blockEntry: new Map(allBlocks(model).map(({ entry, block }) => [block.id, entry])),
+        assetSrc: opts.assetSrc ??
+            ((a) => (page === 'operator' ? `../${a.path}` : a.path)),
+    };
+}
+export function pageOfTrack(track) {
+    return track;
+}
+/** href to a rendered location; undefined when it cannot be linked (standalone PDF cross-page). */
+export function hrefTo(ctx, targetPage, fragment) {
+    if (targetPage === ctx.page)
+        return `#${fragment}`;
+    if (ctx.standalone)
+        return undefined;
+    return ctx.page === 'human' ? `operator/index.html#${fragment}` : `../index.html#${fragment}`;
+}
+/** Resolve `kind:id#anchor` into a link target and human label. */
+export function resolveRef(ctx, kind, id, anchor) {
+    switch (kind) {
+        case 'check': {
+            const c = ctx.checks.get(id);
+            return c ? { href: hrefTo(ctx, 'human', `check-${id}`), label: `Check: ${id}`, title: c.observable } : undefined;
+        }
+        case 'claim': {
+            const c = ctx.claims.get(id);
+            return c ? { href: hrefTo(ctx, 'human', `claim-${id}`), label: `Claim: ${id}`, title: c.text } : undefined;
+        }
+        case 'source': {
+            const s = ctx.sources.get(id);
+            return s ? { href: hrefTo(ctx, 'human', `source-${id}`), label: s.title, title: `${s.title} (${s.version})` } : undefined;
+        }
+        case 'result': {
+            const r = ctx.results.get(id);
+            return r ? { href: hrefTo(ctx, 'human', `result-${id}`), label: r.label ?? `Result: ${id}` } : undefined;
+        }
+        case 'pause': {
+            const p = ctx.pauses.get(id);
+            return p ? { href: hrefTo(ctx, 'human', `pause-${id}`), label: `Pause: ${id}`, title: p.trigger } : undefined;
+        }
+        case 'entry': {
+            const e = ctx.entries.get(id);
+            if (!e)
+                return undefined;
+            const frag = anchor ? `${e.id}--${anchor}` : `e-${e.id}`;
+            return { href: hrefTo(ctx, e.track, frag), label: anchor ? (e.headings.find((h) => h.anchor === anchor)?.text ?? e.title) : e.title };
+        }
+        case 'asset': {
+            const a = ctx.assets.get(id);
+            const src = a ? ctx.assetSrc(a) : undefined;
+            return a ? { href: src, label: a.alt ?? a.id } : undefined;
+        }
+        case 'block': {
+            const e = ctx.blockEntry.get(id);
+            return e ? { href: hrefTo(ctx, e.track, `b-${id}`), label: `Block: ${id}` } : undefined;
+        }
+        case 'input': {
+            const i = (ctx.model.brief?.inputs ?? []).find((x) => x.id === id);
+            return i ? { href: hrefTo(ctx, 'human', `input-${id}`), label: i.label ?? id } : undefined;
+        }
+    }
+}
+export function titleOf(model) {
+    return model.guide ? guideTitle(model.guide) : 'Made Easy';
+}
+export function shortRef(digest) {
+    return shortRevision(digest, 12);
+}
+//# sourceMappingURL=context.js.map

package/dist/render/context.js.map

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

package/dist/render/html.d.ts

@@ -0,0 +1,19 @@
+import type { Asset } from '../contracts/index.js';
+import { type GuideModel } from '../model.js';
+import { resolveRef, type Page } from './context.js';
+export declare const GENERATOR = "@x12i/made-easy";
+export interface PageOptions {
+    model: GuideModel;
+    page: Page;
+    version: string;
+    /** Standalone documents (PDF) inline assets and omit sibling links. */
+    standalone?: boolean;
+    audience?: 'private' | 'public';
+    draft?: boolean;
+    assetSrc?: (asset: Asset) => string | undefined;
+    /** Short text such as "N errors, M warnings" shown in the draft banner. */
+    draftNote?: string;
+}
+export declare function renderPage(opts: PageOptions): string;
+export { resolveRef };
+//# sourceMappingURL=html.d.ts.map

package/dist/render/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/render/html.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAS,MAAM,uBAAuB,CAAC;AAG1D,OAAO,EAAyB,KAAK,UAAU,EAAmB,MAAM,aAAa,CAAC;AAItF,OAAO,EAAe,UAAU,EAAE,KAAK,IAAI,EAAsB,MAAM,cAAc,CAAC;AAGtF,eAAO,MAAM,SAAS,oBAAoB,CAAC;AAE3C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,GAAG,SAAS,CAAC;IAChD,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA8GD,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAqEpD;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/render/html.js

@@ -0,0 +1,178 @@
+import { computeUsage } from '../analysis.js';
+import { entriesOf, guideTitle } from '../model.js';
+import { BOOK_THEME_CSS } from '../theme/book.js';
+import { escapeHtml as esc } from '../util.js';
+import { renderBlockHtml } from './blocks.js';
+import { makeContext, resolveRef } from './context.js';
+import { renderInline, renderProse } from './prose.js';
+export const GENERATOR = '@x12i/made-easy';
+const CSP = "default-src 'none'; img-src 'self' data: file:; style-src 'unsafe-inline'; font-src 'self' data:; base-uri 'none'; form-action 'none'";
+function short(digest) {
+    return digest.replace(/^sha256:/, '').slice(0, 12);
+}
+function renderEntry(entry, ctx, kind) {
+    const body = entry.nodes
+        .map((node) => {
+        if (node.kind === 'block')
+            return renderBlockHtml(node, entry, ctx);
+        const ids = entry.headings
+            .filter((h) => h.line >= node.line && h.line <= node.endLine)
+            .map((h) => `${entry.id}--${h.anchor}`);
+        return renderProse(node.source, ctx, { headingIds: ids, levelShift: 1 });
+    })
+        .join('\n');
+    return `<article class="chapter ${kind}" id="e-${esc(entry.id)}" aria-label="${esc(entry.title)}" data-role="${esc(entry.role)}">
+<header><p class="chapter-no"></p>${entry.hasChapterHeading ? '' : `<h2>${esc(entry.title)}</h2>`}</header>
+${body}
+<p class="back-to-top"><a href="#top">Back to contents</a></p>
+</article>`;
+}
+function renderChecksAppendix(ctx) {
+    const m = ctx.model;
+    const evidenceFor = (id) => (m.sources?.checkEvidence ?? []).find((c) => c.check === id)?.evidence ?? [];
+    const items = (m.checks?.checks ?? [])
+        .map((c) => {
+        const ev = evidenceFor(c.id)
+            .map((e) => {
+            const s = ctx.sources.get(e.source);
+            return `<li><a href="#source-${esc(e.source)}">${esc(s?.title ?? e.source)}</a>${s ? ` <span class="sub">${esc(s.version)}</span>` : ''}${e.locator ? ` \u2014 ${esc(e.locator)}` : ''}</li>`;
+        })
+            .join('');
+        const accepted = (m.brief?.acceptanceChecks ?? []).includes(c.id);
+        return `<section class="check" id="check-${esc(c.id)}"><h3>${esc(c.id)}${accepted ? ' <span class="tag">acceptance check</span>' : ''}</h3>
+<dl class="facts"><div class="fact"><dt>Observable</dt><dd>${renderInline(c.observable, ctx)}</dd></div><div class="fact"><dt>Evidence source</dt><dd>${renderInline(c.evidenceSource, ctx)}</dd></div><div class="fact"><dt>Pass condition</dt><dd>${renderInline(c.passCondition, ctx)}</dd></div><div class="fact"><dt>If evidence is missing</dt><dd>${renderInline(c.onMissing, ctx)}</dd></div><div class="fact"><dt>If evidence contradicts</dt><dd>${renderInline(c.onContradictory, ctx)}</dd></div></dl>
+${ev ? `<p class="sub">Evidence</p><ul>${ev}</ul>` : ''}</section>`;
+    })
+        .join('\n');
+    return `<article class="chapter appendix" id="e-appendix-checks" aria-label="Acceptance checks"><header><p class="chapter-no"></p><h2>Acceptance checks</h2></header>
+<p>Every worked result in this guide is recorded against these checks.</p>${items}<p class="back-to-top"><a href="#top">Back to contents</a></p></article>`;
+}
+function renderEvidenceAppendix(ctx) {
+    const m = ctx.model;
+    const usage = computeUsage(m);
+    const claims = (m.sources?.claims ?? [])
+        .map((c) => {
+        const ev = (c.evidence ?? [])
+            .map((e) => {
+            const s = ctx.sources.get(e.source);
+            return `<li><a href="#source-${esc(e.source)}">${esc(s?.title ?? e.source)}</a>${s ? ` <span class="sub">${esc(s.version)}</span>` : ''}${e.locator ? ` \u2014 ${esc(e.locator)}` : ''}</li>`;
+        })
+            .join('');
+        const status = c.status ?? 'supported';
+        return `<section class="claim" id="claim-${esc(c.id)}"><p><strong>${esc(c.id)}</strong> <span class="tag status-${status}">${status}</span></p><p>${renderInline(c.text, ctx)}</p>${ev ? `<ul>${ev}</ul>` : ''}</section>`;
+    })
+        .join('\n');
+    const sources = (m.sources?.sources ?? [])
+        .filter((s) => usage.sources.has(s.id) && (ctx.audience === 'private' || (s.visibility ?? 'private') === 'public'))
+        .map((s) => `<section class="source" id="source-${esc(s.id)}"><p><strong>${esc(s.title)}</strong> ${s.synthetic ? '<span class="tag">synthetic evidence</span>' : ''}</p>
+<p class="sub">Version ${esc(s.version)} \u00B7 ${esc(s.kind ?? 'source')} \u00B7 ${esc(s.visibility ?? 'private')}</p><p>${esc(s.locator)}</p>${s.note ? `<p>${renderInline(s.note, ctx)}</p>` : ''}</section>`)
+        .join('\n');
+    return `<article class="chapter appendix" id="e-appendix-evidence" aria-label="Evidence and sources"><header><p class="chapter-no"></p><h2>Evidence and sources</h2></header>
+${claims ? `<h3>Claims</h3>${claims}` : ''}${sources ? `<h3>Sources</h3>${sources}` : ''}<p class="back-to-top"><a href="#top">Back to contents</a></p></article>`;
+}
+function renderReferenceAppendix(ctx) {
+    const m = ctx.model;
+    const pinned = new Map((m.brief?.operatorReference?.entries ?? []).map((p) => [p.id, p]));
+    const rows = entriesOf(m, 'operator')
+        .map((e) => {
+        const pin = pinned.get(e.id);
+        const state = !pin ? 'not pinned' : !pin.digest ? 'pin has no digest' : pin.digest === e.digest ? 'pinned, current' : 'pinned, STALE';
+        return `<tr><th scope="row"><a href="#e-${esc(e.id)}">${esc(e.title)}</a></th><td><code>${esc(e.path)}</code></td><td><code>${esc(short(e.digest))}</code></td><td>${state}</td></tr>`;
+    })
+        .join('');
+    const briefBlock = { kind: 'block', id: 'reference-brief', type: 'brief', props: { view: 'both' }, line: 0, endLine: 0, lineOf: () => undefined };
+    return `<article class="chapter appendix" id="e-appendix-revision" aria-label="Reference revision"><header><p class="chapter-no"></p><h2>Reference revision</h2></header>
+<p>Operator-reference revision <code>${esc(short(m.referenceRevision))}</code>. The human guide links to this exact revision.</p>
+<div class="table-wrap" role="region" tabindex="0" aria-label="Pinned entries"><table><thead><tr><th scope="col">Entry</th><th scope="col">File</th><th scope="col">Digest</th><th scope="col">Pin</th></tr></thead><tbody>${rows}</tbody></table></div>
+<p class="back-to-top"><a href="#top">Back to contents</a></p></article>
+<article class="chapter appendix" id="e-appendix-brief" aria-label="The brief"><header><p class="chapter-no"></p><h2>The brief</h2></header>${renderBlockHtml(briefBlock, { track: 'operator' }, ctx)}<p class="back-to-top"><a href="#top">Back to contents</a></p></article>`;
+}
+function renderToc(ctx, entries, generated) {
+    const items = entries
+        .map((e) => {
+        const subs = e.headings.filter((h) => h.level === 2);
+        return `<li><a href="#e-${esc(e.id)}">${esc(e.title)}</a>${subs.length ? `<ol class="toc-sub">${subs.map((h) => `<li><a href="#${esc(e.id)}--${esc(h.anchor)}">${esc(h.text.replace(/[`*_]/g, ''))}</a></li>`).join('')}</ol>` : ''}</li>`;
+    })
+        .join('');
+    const gen = generated.map((g) => `<li><a href="#e-${esc(g.id)}">${esc(g.title)}</a></li>`).join('');
+    const other = ctx.standalone
+        ? ''
+        : ctx.page === 'human'
+            ? `<li class="toc-other"><a href="operator/index.html">Operator reference</a></li>`
+            : `<li class="toc-other"><a href="../index.html">Human guide</a></li>`;
+    const files = ctx.standalone
+        ? ''
+        : `<li class="toc-other"><a href="${ctx.page === 'human' ? '' : '../'}brief.md">brief.md</a> \u00B7 <a href="${ctx.page === 'human' ? '' : '../'}brief.json">brief.json</a></li>`;
+    return `<nav class="toc" aria-label="Contents"><p class="toc-title">Contents</p><ol>${items}${gen}${other}${files}</ol></nav>`;
+}
+export function renderPage(opts) {
+    const { model, page } = opts;
+    const guide = model.guide;
+    const ctx = makeContext(model, {
+        page,
+        standalone: opts.standalone,
+        audience: opts.audience,
+        draft: opts.draft,
+        assetSrc: opts.assetSrc,
+    });
+    const track = page;
+    const entries = entriesOf(model, track);
+    const authored = entries.map((e) => renderEntry(e, ctx, e.role === 'appendix' ? 'appendix' : 'chapter'));
+    const generated = page === 'human'
+        ? [
+            { id: 'appendix-checks', title: 'Acceptance checks', html: renderChecksAppendix(ctx) },
+            { id: 'appendix-evidence', title: 'Evidence and sources', html: renderEvidenceAppendix(ctx) },
+        ]
+        : [{ id: 'appendix-revision', title: 'Reference revision and brief', html: renderReferenceAppendix(ctx) }];
+    const title = guideTitle(guide);
+    const docTitle = page === 'human' ? title : `${title} \u2014 Operator reference`;
+    const draftBanner = opts.draft
+        ? `<div class="draft-banner" role="note">DRAFT \u2014 not for publication.${opts.draftNote ? ` ${esc(opts.draftNote)}` : ''}</div><div class="draft-watermark" aria-hidden="true">DRAFT</div>`
+        : '';
+    const synthetic = (model.sources?.sources ?? []).some((s) => s.synthetic);
+    const profileTitle = model.recipe ? `${model.recipe.title} \u00B7 ${model.recipe.id}` : guide.recipe.id;
+    return `<!doctype html>
+<html lang="${esc(guide.locale)}" data-theme="${esc(guide.theme.id)}@${esc(guide.theme.version)}">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta http-equiv="Content-Security-Policy" content="${CSP}">
+<meta name="generator" content="${GENERATOR} ${esc(opts.version)}">
+<meta name="made-easy:revision" content="${esc(model.revision)}">
+<meta name="made-easy:reference-revision" content="${esc(model.referenceRevision)}">
+<title>${esc(docTitle)}</title>
+<style>${BOOK_THEME_CSS}</style>
+</head>
+<body class="me-doc track-${page}${opts.draft ? ' is-draft' : ''}" id="top">
+<a class="skip-link" href="#main">Skip to content</a>
+${draftBanner}
+<header class="cover"><div class="cover-inner">
+<p class="kicker">Made Easy \u00B7 ${page === 'human' ? 'Human guide' : 'Operator reference'}</p>
+<h1>${esc(page === 'human' ? title : `${title}`)}</h1>
+${guide.subject.subtitle ? `<p class="subtitle">${esc(guide.subject.subtitle)}</p>` : ''}
+<dl class="cover-meta">
+<dt>Subject</dt><dd>${esc(guide.subject.type)} \u00B7 ${esc(guide.subject.name)}</dd>
+<dt>Scope</dt><dd>${esc(guide.subject.scope)}</dd>
+<dt>Job</dt><dd><code>${esc(guide.jobId)}</code></dd>
+<dt>Recipe</dt><dd>${esc(profileTitle)} (v${esc(guide.recipe.version)})</dd>
+<dt>Revision</dt><dd><code>${esc(short(model.revision))}</code></dd>
+<dt>Operator reference</dt><dd><code>${esc(short(model.referenceRevision))}</code></dd>
+<dt>Guide</dt><dd><code>${esc(guide.guideId)}</code></dd>
+</dl></div></header>
+<div class="layout">
+${renderToc(ctx, entries, generated)}
+<main id="main" tabindex="-1">
+${authored.join('\n')}
+${generated.map((g) => g.html).join('\n')}
+</main>
+</div>
+<footer class="colophon" role="contentinfo">
+<p><strong>${esc(title)}</strong> \u00B7 revision <code>${esc(short(model.revision))}</code> \u00B7 operator reference <code>${esc(short(model.referenceRevision))}</code> \u00B7 guide <code>${esc(guide.guideId)}</code></p>
+<p>Recipe ${esc(guide.recipe.id)}@${esc(guide.recipe.version)} \u00B7 theme ${esc(guide.theme.id)}@${esc(guide.theme.version)} \u00B7 built with ${GENERATOR} ${esc(opts.version)}.${synthetic ? ' This guide cites synthetic evidence, labelled where it appears.' : ''}${opts.draft ? ' Draft output is private and not for publication.' : ''}</p>
+</footer>
+</body>
+</html>
+`;
+}
+export { resolveRef };
+//# sourceMappingURL=html.js.map

package/dist/render/html.js.map

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

package/dist/render/markdown-out.d.ts

@@ -0,0 +1,11 @@
+import { type GuideModel, type ModelEntry } from '../model.js';
+import { type BriefDocument } from './brief.js';
+import { type RenderContext } from './context.js';
+export declare function renderEntryMarkdown(entry: ModelEntry, ctx: RenderContext, shift: number): string;
+/** A whole track as plain Markdown with pinned revision metadata (operator/reference.md for the operator track). */
+export declare function renderTrackMarkdown(model: GuideModel, track: 'human' | 'operator'): string;
+export declare function renderReferenceMarkdown(model: GuideModel): string;
+/** brief.md: printable worked brief, blank template and review checklist. */
+export declare function renderBriefMarkdown(doc: BriefDocument): string;
+export declare function renderBriefJson(model: GuideModel): string;
+//# sourceMappingURL=markdown-out.d.ts.map

package/dist/render/markdown-out.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-out.d.ts","sourceRoot":"","sources":["../../src/render/markdown-out.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtF,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AA6B/D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAOhG;AAED,oHAAoH;AACpH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAmB1F;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEjE;AAUD,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAiD9D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEzD"}