@refrakt-md/runes 0.37.0 → 0.39.0

package/dist/lib/preprocess.d.ts

@@ -0,0 +1,63 @@
+import type { Node, Schema } from '@markdoc/markdoc';
+import type { PreprocessContext, PreprocessPage } from '@refrakt-md/types';
+/**
+ * Per-rune preprocessing (SPEC-141).
+ *
+ * A rune that resolves itself before the transform — `include`, `snippet`,
+ * `data` — declares a `preprocess` hook on its schema, beside `transform`.
+ * One walk ({@link preprocessTree}) visits the page AST and dispatches to the
+ * hook of whichever tag it meets. The ordering between preprocessors is not
+ * stated anywhere: it is tree order.
+ *
+ * That is a valid order because the producer/consumer graph is acyclic by
+ * construction. `include` pastes a file's AST and `data` clones its row
+ * template **at their own node**, so anything they produce is below that point
+ * and the walk meets it next. Nothing runs the other way: `snippet` resolves to
+ * a `fence`, whose content is raw text that is never re-parsed as Markdoc.
+ */
+/** The context a rune's `preprocess` hook receives. */
+export interface RunePreprocessContext extends PreprocessContext {
+    /**
+     * The nodes enclosing the one being preprocessed, outermost first — the
+     * page's `document` node is always the first entry, and the direct parent
+     * is the last (SPEC-141 D4). A replacement is not an ancestor of what it
+     * contains: by the time the walk descends into it, the tag is gone.
+     */
+    readonly ancestors: readonly Node[];
+}
+/**
+ * A rune's preprocess hook (SPEC-141 D1).
+ *
+ * Receives the rune's own tag node — not the tree. Returning a node replaces
+ * the tag with it; returning an array splices those nodes in its place (an
+ * empty array removes the tag); returning nothing leaves it alone. The walk
+ * then continues into whatever is now at that position, so the hook never has
+ * to resolve the tags its own output contains.
+ */
+export type RunePreprocess = (node: Node, page: PreprocessPage, ctx: RunePreprocessContext) => Node | Node[] | void;
+/**
+ * Schema → its rune's preprocess hook. Recorded by `createContentModelSchema`
+ * and kept off the Markdoc schema object, the same shape as
+ * `schemaRuneStructures`: Markdoc never reads it, and only {@link preprocessTree}
+ * does.
+ */
+export declare const schemaPreprocessors: WeakMap<Schema, RunePreprocess>;
+/**
+ * Resolve every preprocessing rune in a page AST, in tree order.
+ *
+ * `schemas` is the page's tag table — the same `tags` the transform will use,
+ * core and plugin runes merged — and any of them that declares a `preprocess`
+ * hook takes part. Mutates `ast` in place; returns it when anything changed,
+ * and nothing otherwise, matching the `PluginPipelineHooks.preprocess` contract.
+ *
+ * **The walk descends into a replacement** (SPEC-141 D3). After a hook
+ * replaces its tag, the walk revisits the same position, so a producer's
+ * output is resolved where it lands: a `{% snippet %}` in a `{% data %}` row
+ * template is reached after the row is bound (BUG-027), and a subquery `data`
+ * per outer row. Termination needs no depth limit: `include` leaves no
+ * `include` tags behind (it expands nested ones itself, under its cycle
+ * stack), `data`'s output consumes one level of the authored body per pass,
+ * and `snippet`'s fence contains no tags at all.
+ */
+export declare function preprocessTree(ast: Node, page: PreprocessPage, ctx: PreprocessContext, schemas: Record<string, unknown>): Node | void;
+//# sourceMappingURL=preprocess.d.ts.map

package/dist/lib/preprocess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preprocess.d.ts","sourceRoot":"","sources":["../../src/lib/preprocess.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE3E;;;;;;;;;;;;;;GAcG;AAEH,uDAAuD;AACvD,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC/D;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,IAAI,EAAE,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,CAC5B,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,qBAAqB,KACtB,IAAI,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;AAE1B;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,iCAAwC,CAAC;AAEzE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAC7B,GAAG,EAAE,IAAI,EACT,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,GAAG,IAAI,CA4Cb"}

package/dist/lib/preprocess.js

@@ -0,0 +1,71 @@
+/**
+ * Schema → its rune's preprocess hook. Recorded by `createContentModelSchema`
+ * and kept off the Markdoc schema object, the same shape as
+ * `schemaRuneStructures`: Markdoc never reads it, and only {@link preprocessTree}
+ * does.
+ */
+export const schemaPreprocessors = new WeakMap();
+/**
+ * Resolve every preprocessing rune in a page AST, in tree order.
+ *
+ * `schemas` is the page's tag table — the same `tags` the transform will use,
+ * core and plugin runes merged — and any of them that declares a `preprocess`
+ * hook takes part. Mutates `ast` in place; returns it when anything changed,
+ * and nothing otherwise, matching the `PluginPipelineHooks.preprocess` contract.
+ *
+ * **The walk descends into a replacement** (SPEC-141 D3). After a hook
+ * replaces its tag, the walk revisits the same position, so a producer's
+ * output is resolved where it lands: a `{% snippet %}` in a `{% data %}` row
+ * template is reached after the row is bound (BUG-027), and a subquery `data`
+ * per outer row. Termination needs no depth limit: `include` leaves no
+ * `include` tags behind (it expands nested ones itself, under its cycle
+ * stack), `data`'s output consumes one level of the authored body per pass,
+ * and `snippet`'s fence contains no tags at all.
+ */
+export function preprocessTree(ast, page, ctx, schemas) {
+    const hooks = new Map();
+    for (const [name, schema] of Object.entries(schemas)) {
+        if (!schema || typeof schema !== 'object')
+            continue;
+        const hook = schemaPreprocessors.get(schema);
+        if (hook)
+            hooks.set(name, hook);
+    }
+    if (hooks.size === 0)
+        return;
+    let mutated = false;
+    const ancestors = [];
+    const walk = (parent) => {
+        const children = parent.children;
+        if (!children || children.length === 0)
+            return;
+        ancestors.push(parent);
+        for (let i = 0; i < children.length; i++) {
+            const child = children[i];
+            const hook = child.type === 'tag' && child.tag ? hooks.get(child.tag) : undefined;
+            if (hook) {
+                // A prototype link rather than a spread, so a context whose
+                // diagnostics are methods on a class keeps them.
+                const hookCtx = Object.create(ctx, {
+                    ancestors: { value: [...ancestors], enumerable: true },
+                });
+                const result = hook(child, page, hookCtx);
+                // Returning the node itself is "leave it alone" too — treating it as
+                // a replacement would revisit it forever.
+                if (result !== undefined && result !== child) {
+                    const replacement = Array.isArray(result) ? result : [result];
+                    children.splice(i, 1, ...replacement);
+                    mutated = true;
+                    // Revisit this position: the walk descends into the replacement.
+                    i--;
+                    continue;
+                }
+            }
+            walk(child);
+        }
+        ancestors.pop();
+    };
+    walk(ast);
+    return mutated ? ast : undefined;
+}
+//# sourceMappingURL=preprocess.js.map

package/dist/lib/preprocess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preprocess.js","sourceRoot":"","sources":["../../src/lib/preprocess.ts"],"names":[],"mappings":"AA6CA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,OAAO,EAA0B,CAAC;AAEzE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc,CAC7B,GAAS,EACT,IAAoB,EACpB,GAAsB,EACtB,OAAgC;IAEhC,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,SAAS;QACpD,MAAM,IAAI,GAAG,mBAAmB,CAAC,GAAG,CAAC,MAAgB,CAAC,CAAC;QACvD,IAAI,IAAI;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO;IAE7B,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,SAAS,GAAW,EAAE,CAAC;IAE7B,MAAM,IAAI,GAAG,CAAC,MAAY,EAAQ,EAAE;QACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC/C,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAClF,IAAI,IAAI,EAAE,CAAC;gBACV,4DAA4D;gBAC5D,iDAAiD;gBACjD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE;oBAClC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE;iBACtD,CAA0B,CAAC;gBAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC1C,qEAAqE;gBACrE,0CAA0C;gBAC1C,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;oBAC9C,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;oBAC9D,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC;oBACtC,OAAO,GAAG,IAAI,CAAC;oBACf,iEAAiE;oBACjE,CAAC,EAAE,CAAC;oBACJ,SAAS;gBACV,CAAC;YACF,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,CAAC;QACb,CAAC;QACD,SAAS,CAAC,GAAG,EAAE,CAAC;IACjB,CAAC,CAAC;IAEF,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AAClC,CAAC"}

package/dist/lib/registers.d.ts

@@ -0,0 +1,132 @@
+import Markdoc from '@markdoc/markdoc';
+/**
+ * Declarative entity and edge registration — SPEC-144 / WORK-611.
+ *
+ * A rune says *what it registers* — which named source holds the id, which
+ * sources to carry into the data bag, which two hold an edge's endpoints — and
+ * one core participant (`createRegistersHooks`) does the registering in the
+ * existing Phase 2 / Phase 3 slots. Plugins keep `PluginPipelineHooks` for
+ * everything else; this is a generic participant beside them.
+ *
+ * The vocabulary is closed (ADR-036, SPEC-144 D1): every value is a string, a
+ * boolean, or a list or record of those. No expression form, no predicate, no
+ * function. A domain that needs more writes a plugin hook — the plan plugin is
+ * the standing example (D5).
+ *
+ * **Where a value comes from** (D3, decided in WORK-611). A source is a bare
+ * name, resolved the way the hand-written helpers always did: a `refs` entry —
+ * a node carrying `data-name=<source>` inside the rune, read as its text — and
+ * otherwise the rune's `data-rune-fields` bag. `createComponentRenderable`
+ * rejects a rune whose properties and refs share a name (ADR-008), so the two
+ * namespaces are disjoint and a bare name cannot mean two things. A name that
+ * resolves to neither is a typo, and `validate` reports it with file and line
+ * (`registers-source-unresolved`), the same audit a schema-table source gets.
+ */
+/** One data-bag entry: `'role'` carries source `role` as key `role`;
+ *  `{ name: 'title' }` carries source `title` as key `name`. */
+export type RegistersDataEntry = string | Readonly<Record<string, string>>;
+/** The data bag: an ordered field list, or one source holding a JSON object
+ *  that *is* the bag. Key order follows the declaration. */
+export type RegistersData = readonly RegistersDataEntry[] | {
+    readonly json: string;
+};
+export interface RegistersEntity {
+    /** Registry type. Defaults to the rune name. */
+    type?: string;
+    /** The source holding the entity's id. A rune instance whose id is empty
+     *  registers nothing and warns. */
+    idFrom: string;
+    /** `'site'` (default) or `'page'` — see `EntityRegistration.scope`. */
+    scope?: 'site' | 'page';
+    /** What to carry in the entity's data bag. Nothing is added implicitly. */
+    data?: RegistersData;
+    /** Alternative names, split from a data-bag key. The name index the
+     *  participant builds in Phase 3 adds each alias after the ids, and an alias
+     *  already present keeps its first owner. */
+    aliases?: {
+        readonly from: string;
+        readonly separator?: string;
+    };
+}
+export interface RegistersEdge {
+    /** Registry type of the edge's own entry. Defaults to the rune name. */
+    type?: string;
+    /** Source holding the source entity's id (or alias). */
+    from: string;
+    /** Source holding the target entity's id (or alias). */
+    to: string;
+    /** The relationship-graph edge kind: a literal, or `{ field }` naming a key
+     *  of the edge's data bag. An empty field value falls back to the type. */
+    kind: string | {
+        readonly field: string;
+    };
+    /** Contribute the reverse edge too: a literal, or `{ field }` naming a data
+     *  key whose value is `'true'`. Default `false`. */
+    bidirectional?: boolean | {
+        readonly field: string;
+    };
+    /** Further sources for the edge entry's data bag. */
+    data?: readonly RegistersDataEntry[];
+}
+/** A rune's `registers` block: exactly one of `entity` or `edge`. */
+export interface RegistersDeclaration {
+    entity?: RegistersEntity;
+    edge?: RegistersEdge;
+}
+/** The name index a declaring plugin's aggregate slot receives in Phase 3. */
+export interface RegistersIndex {
+    /** Every declared entity by id and by alias. Ids are set in type
+     *  declaration order, then registry order, so a later id replaces an earlier
+     *  one; an alias never replaces anything already present. */
+    entityByName: Map<string, import('@refrakt-md/types').EntityRegistration>;
+}
+/** Declarations recorded by `createContentModelSchema`, keyed by schema — the
+ *  same pattern as `schemaTables`, for the same reason: tooling has only the
+ *  schema to read from. */
+export declare const schemaRegisters: WeakMap<Markdoc.Schema, RegistersDeclaration>;
+/** The `registers` block a rune declares, if it declares one. */
+export declare function registersFor(schema: unknown): RegistersDeclaration | undefined;
+/**
+ * Check a declaration against the closed vocabulary, throwing on the first
+ * violation. Runs at schema construction, so a malformed block fails the
+ * import that defines it rather than a build that happens to use it.
+ */
+export declare function validateRegistersDeclaration(decl: unknown, where?: string): void;
+declare function dataEntries(data: readonly RegistersDataEntry[], where?: string): Array<{
+    key: string;
+    source: string;
+}>;
+/** Every source a declaration reads from the rune's output, with the role it
+ *  plays — what the validate-time audit and `inspect` check. */
+export declare function registersSources(decl: RegistersDeclaration): Array<{
+    source: string;
+    role: string;
+}>;
+type AnyTag = {
+    name?: string;
+    attributes?: Record<string, unknown>;
+    children?: unknown[];
+};
+/** Read one source off a rune's tag: a ref's text, else its field-bag value,
+ *  else `''`. The D3 rule — see the module comment. */
+export declare function readRegistersSource(tag: AnyTag, source: string): string;
+/**
+ * Sources a declaration names that the rune does not provide — WORK-611.
+ *
+ * The same rule `auditSchemaSources` applies to a schema table: a source
+ * resolves if a node in the rune's output carries the name, if the field bag
+ * has it, or if it is one of the rune's declared attributes (an optional
+ * attribute left unset emits nothing, which is "this input did not exercise
+ * it", not a typo). What is left resolves to nothing, ever.
+ *
+ * `tree` is the rune's `Markdoc.transform` output, before the identity
+ * transform consumes the bag.
+ */
+export declare function auditRegistersSources(decl: RegistersDeclaration, tree: unknown, declaredAttributes?: readonly string[]): Array<{
+    source: string;
+    role: string;
+}>;
+/** One line per declaration, for `inspect` and the reference. */
+export declare function describeRegisters(decl: RegistersDeclaration, rune: string): string[];
+export { dataEntries as registersDataEntries };
+//# sourceMappingURL=registers.d.ts.map

package/dist/lib/registers.d.ts.map

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

package/dist/lib/registers.js

@@ -0,0 +1,328 @@
+import Markdoc from '@markdoc/markdoc';
+import { readField } from '@refrakt-md/transform';
+/** Declarations recorded by `createContentModelSchema`, keyed by schema — the
+ *  same pattern as `schemaTables`, for the same reason: tooling has only the
+ *  schema to read from. */
+export const schemaRegisters = new WeakMap();
+/** The `registers` block a rune declares, if it declares one. */
+export function registersFor(schema) {
+    return schema && typeof schema === 'object' ? schemaRegisters.get(schema) : undefined;
+}
+// ---------------------------------------------------------------------------
+// The closed vocabulary, checked at construction
+// ---------------------------------------------------------------------------
+const ENTITY_KEYS = new Set(['type', 'idFrom', 'scope', 'data', 'aliases']);
+const EDGE_KEYS = new Set(['type', 'from', 'to', 'kind', 'bidirectional', 'data']);
+/**
+ * Check a declaration against the closed vocabulary, throwing on the first
+ * violation. Runs at schema construction, so a malformed block fails the
+ * import that defines it rather than a build that happens to use it.
+ */
+export function validateRegistersDeclaration(decl, where = 'registers') {
+    assertInert(decl, where);
+    const fail = (msg) => {
+        throw new Error(`${where}: ${msg}`);
+    };
+    if (!isRecord(decl))
+        fail('must be an object');
+    const d = decl;
+    const keys = Object.keys(d);
+    if (keys.some((k) => k !== 'entity' && k !== 'edge')) {
+        fail(`unknown key "${keys.find((k) => k !== 'entity' && k !== 'edge')}"; use "entity" or "edge"`);
+    }
+    if ((d.entity === undefined) === (d.edge === undefined)) {
+        fail('declare exactly one of "entity" or "edge"');
+    }
+    if (d.entity !== undefined) {
+        const e = d.entity;
+        if (!isRecord(e))
+            fail('entity must be an object');
+        checkKeys(e, ENTITY_KEYS, `${where}.entity`);
+        optionalName(e.type, `${where}.entity.type`);
+        requireName(e.idFrom, `${where}.entity.idFrom`);
+        if (e.scope !== undefined && e.scope !== 'site' && e.scope !== 'page') {
+            fail(`entity.scope must be "site" or "page"`);
+        }
+        const dataKeys = checkData(e.data, `${where}.entity.data`, true);
+        if (e.aliases !== undefined) {
+            const a = e.aliases;
+            if (!isRecord(a))
+                fail('entity.aliases must be an object');
+            checkKeys(a, new Set(['from', 'separator']), `${where}.entity.aliases`);
+            requireName(a.from, `${where}.entity.aliases.from`);
+            if (a.separator !== undefined && (typeof a.separator !== 'string' || a.separator === '')) {
+                fail('entity.aliases.separator must be a non-empty string');
+            }
+            // Aliases are expanded in Phase 3 from the registered entry, so the
+            // value has to be in the bag.
+            if (dataKeys !== 'json' && !dataKeys.includes(a.from)) {
+                fail(`entity.aliases.from "${a.from}" must name a key of entity.data`);
+            }
+        }
+    }
+    if (d.edge !== undefined) {
+        const e = d.edge;
+        if (!isRecord(e))
+            fail('edge must be an object');
+        checkKeys(e, EDGE_KEYS, `${where}.edge`);
+        optionalName(e.type, `${where}.edge.type`);
+        requireName(e.from, `${where}.edge.from`);
+        requireName(e.to, `${where}.edge.to`);
+        const dataKeys = checkData(e.data, `${where}.edge.data`, false);
+        const bagKeys = ['from', 'to', ...dataKeys, 'name'];
+        for (const field of ['kind', 'bidirectional']) {
+            const v = e[field];
+            if (v === undefined && field === 'bidirectional')
+                continue;
+            if (field === 'kind' && typeof v === 'string') {
+                if (v === '')
+                    fail('edge.kind must not be empty');
+                continue;
+            }
+            if (field === 'bidirectional' && typeof v === 'boolean')
+                continue;
+            if (!isRecord(v))
+                fail(`edge.${field} must be a literal or { field }`);
+            checkKeys(v, new Set(['field']), `${where}.edge.${field}`);
+            const name = v.field;
+            requireName(name, `${where}.edge.${field}.field`);
+            if (!bagKeys.includes(name)) {
+                fail(`edge.${field}.field "${name}" must name a key of the edge's data bag`);
+            }
+        }
+    }
+}
+function isRecord(v) {
+    return !!v && typeof v === 'object' && !Array.isArray(v);
+}
+function checkKeys(rec, allowed, where) {
+    for (const k of Object.keys(rec)) {
+        if (!allowed.has(k)) {
+            throw new Error(`${where}: unknown key "${k}" (allowed: ${[...allowed].join(', ')})`);
+        }
+    }
+}
+function requireName(v, where) {
+    if (typeof v !== 'string' || v === '')
+        throw new Error(`${where} must be a non-empty string`);
+}
+function optionalName(v, where) {
+    if (v !== undefined)
+        requireName(v, where);
+}
+/** Validate a `data` declaration and return the bag keys it produces, or
+ *  `'json'` for the JSON form (whose keys are not known until build time). */
+function checkData(data, where, allowJson) {
+    if (data === undefined)
+        return [];
+    if (isRecord(data)) {
+        if (!allowJson)
+            throw new Error(`${where} must be a list`);
+        checkKeys(data, new Set(['json']), where);
+        requireName(data.json, `${where}.json`);
+        return 'json';
+    }
+    if (!Array.isArray(data))
+        throw new Error(`${where} must be a list or { json }`);
+    const keys = [];
+    for (const entry of dataEntries(data, where)) {
+        if (keys.includes(entry.key))
+            throw new Error(`${where}: key "${entry.key}" appears twice`);
+        keys.push(entry.key);
+    }
+    return keys;
+}
+function dataEntries(data, where = 'data') {
+    return data.map((entry) => {
+        if (typeof entry === 'string') {
+            requireName(entry, where);
+            return { key: entry, source: entry };
+        }
+        const pairs = isRecord(entry) ? Object.entries(entry) : [];
+        if (pairs.length !== 1) {
+            throw new Error(`${where}: an entry is a source name or a single { key: source } pair`);
+        }
+        const [key, source] = pairs[0];
+        requireName(key, where);
+        requireName(source, `${where}.${key}`);
+        return { key, source: source };
+    });
+}
+/** No functions, no class instances, nothing `JSON` would drop or reshape:
+ *  the declaration must round-trip through `JSON.parse(JSON.stringify(…))`. */
+function assertInert(v, where) {
+    if (v === null || typeof v === 'string' || typeof v === 'boolean')
+        return;
+    if (Array.isArray(v)) {
+        for (const [i, x] of v.entries())
+            assertInert(x, `${where}[${i}]`);
+        return;
+    }
+    if (typeof v === 'object' && Object.getPrototypeOf(v) === Object.prototype) {
+        for (const [k, x] of Object.entries(v)) {
+            if (x === undefined)
+                throw new Error(`${where}.${k}: undefined is not a value; omit the key`);
+            assertInert(x, `${where}.${k}`);
+        }
+        return;
+    }
+    throw new Error(`${where}: a registers declaration holds only strings, booleans, lists and plain objects ` +
+        `(found ${typeof v === 'function' ? 'a function' : typeof v}) — ADR-036`);
+}
+// ---------------------------------------------------------------------------
+// Sources
+// ---------------------------------------------------------------------------
+/** Every source a declaration reads from the rune's output, with the role it
+ *  plays — what the validate-time audit and `inspect` check. */
+export function registersSources(decl) {
+    const out = [];
+    if (decl.entity) {
+        out.push({ source: decl.entity.idFrom, role: 'idFrom' });
+        const data = decl.entity.data;
+        if (data && !Array.isArray(data)) {
+            out.push({ source: data.json, role: 'data (json)' });
+        }
+        else if (data) {
+            for (const { key, source } of dataEntries(data)) {
+                out.push({ source, role: `data.${key}` });
+            }
+        }
+    }
+    if (decl.edge) {
+        out.push({ source: decl.edge.from, role: 'from' });
+        out.push({ source: decl.edge.to, role: 'to' });
+        for (const { key, source } of dataEntries(decl.edge.data ?? [])) {
+            out.push({ source, role: `data.${key}` });
+        }
+    }
+    return out;
+}
+function isTag(n) {
+    return (!!n &&
+        typeof n === 'object' &&
+        (Markdoc.Tag.isTag(n) || n.$$mdtype === 'Tag'));
+}
+/** The first node inside this rune carrying `data-name=<name>`. Bounded at
+ *  nested runes: a name is unique per rune, and a `character-section` inside a
+ *  `character` names its own heading `name` too (see `findAllByName`). */
+function findRef(root, name) {
+    for (const c of root.children ?? []) {
+        if (!isTag(c))
+            continue;
+        if (c.attributes?.['data-rune'] !== undefined)
+            continue;
+        if (c.attributes?.['data-name'] === name)
+            return c;
+        const hit = findRef(c, name);
+        if (hit)
+            return hit;
+    }
+    return undefined;
+}
+function text(node) {
+    if (typeof node === 'string')
+        return node;
+    if (!isTag(node))
+        return '';
+    return (node.children ?? []).map(text).join('');
+}
+/** Read one source off a rune's tag: a ref's text, else its field-bag value,
+ *  else `''`. The D3 rule — see the module comment. */
+export function readRegistersSource(tag, source) {
+    const ref = findRef(tag, source);
+    if (ref)
+        return text(ref).trim();
+    return readField(tag, source) ?? '';
+}
+/**
+ * Sources a declaration names that the rune does not provide — WORK-611.
+ *
+ * The same rule `auditSchemaSources` applies to a schema table: a source
+ * resolves if a node in the rune's output carries the name, if the field bag
+ * has it, or if it is one of the rune's declared attributes (an optional
+ * attribute left unset emits nothing, which is "this input did not exercise
+ * it", not a typo). What is left resolves to nothing, ever.
+ *
+ * `tree` is the rune's `Markdoc.transform` output, before the identity
+ * transform consumes the bag.
+ */
+export function auditRegistersSources(decl, tree, declaredAttributes = []) {
+    const root = findRuneRoot(tree);
+    const bag = root ? parseBag(root) : {};
+    const declared = new Set();
+    for (const a of declaredAttributes) {
+        declared.add(a);
+        declared.add(kebab(a));
+    }
+    return registersSources(decl).filter(({ source }) => !(declared.has(source) ||
+        declared.has(kebab(source)) ||
+        Object.hasOwn(bag, source) ||
+        (root && findRef(root, source))));
+}
+function findRuneRoot(node) {
+    if (Array.isArray(node)) {
+        for (const c of node) {
+            const hit = findRuneRoot(c);
+            if (hit)
+                return hit;
+        }
+        return undefined;
+    }
+    if (!isTag(node))
+        return undefined;
+    if (node.attributes?.['data-rune'] !== undefined)
+        return node;
+    return findRuneRoot(node.children ?? []);
+}
+function parseBag(tag) {
+    const raw = tag.attributes?.['data-rune-fields'];
+    if (typeof raw !== 'string')
+        return {};
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+const kebab = (s) => s.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();
+/** One line per declaration, for `inspect` and the reference. */
+export function describeRegisters(decl, rune) {
+    const lines = [];
+    const dataLine = (data) => {
+        if (!data)
+            return '(none)';
+        if (!Array.isArray(data))
+            return `the JSON object in "${data.json}"`;
+        return dataEntries(data)
+            .map(({ key, source }) => (key === source ? key : `${key} <- ${source}`))
+            .join(', ');
+    };
+    if (decl.entity) {
+        const e = decl.entity;
+        lines.push(`entity  ${e.type ?? rune}  (scope: ${e.scope ?? 'site'})`);
+        lines.push(`  id      <- ${e.idFrom}`);
+        lines.push(`  data    ${dataLine(e.data)}`);
+        if (e.aliases) {
+            lines.push(`  aliases <- ${e.aliases.from}, split on "${e.aliases.separator ?? ','}"`);
+        }
+    }
+    if (decl.edge) {
+        const e = decl.edge;
+        const kind = typeof e.kind === 'string' ? e.kind : `data.${e.kind.field}`;
+        const bidi = e.bidirectional === undefined
+            ? 'no'
+            : typeof e.bidirectional === 'boolean'
+                ? String(e.bidirectional)
+                : `data.${e.bidirectional.field}`;
+        lines.push(`edge    ${e.type ?? rune}  (id: from→to)`);
+        lines.push(`  from    <- ${e.from}`);
+        lines.push(`  to      <- ${e.to}`);
+        lines.push(`  kind    ${kind}`);
+        lines.push(`  both    ${bidi}`);
+        lines.push(`  data    from, to, ${e.data?.length ? `${dataLine(e.data)}, ` : ''}name`);
+    }
+    return lines;
+}
+export { dataEntries as registersDataEntries };
+//# sourceMappingURL=registers.js.map

package/dist/lib/registers.js.map

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

package/dist/lib/resolver.d.ts

@@ -5,7 +5,7 @@
  * content model, producing named fields without per-rune imperative code.
  */
 import type { Node } from '@markdoc/markdoc';
-import type { ContentModel, ContentFieldDefinition, DelimitedModel, SectionsModel, ContentModelCondition, ItemModel, ResolvedContent } from '@refrakt-md/types';
+import type { ContentModel, ContentFieldDefinition, DelimitedModel, SectionsModel, ContentModelCondition, ItemModel, ResolvedContent, StructuralContentModel } from '@refrakt-md/types';
 export interface ResolveResult {
     /** Resolved content fields. */
     content: ResolvedContent;
@@ -76,5 +76,13 @@ export declare function resolve(children: Node[], model: ContentModel, attribute
  * Full resolution entry point: extracts special tags (tint, bg), then
  * resolves the content model.
  */
+/**
+ * The structural model `resolveContentModel` would resolve these children
+ * against: a conditional model's matching branch (followed through nested
+ * conditionals), or the model itself. Evaluated over the same filtered children,
+ * so a `tint` / `bg` child cannot tip a `hasChild` condition here when it does
+ * not there.
+ */
+export declare function selectStructuralModel(children: Node[], model: ContentModel, attributes?: Record<string, unknown>): StructuralContentModel;
 export declare function resolveContentModel(children: Node[], model: ContentModel, attributes?: Record<string, unknown>, locale?: string): ResolveResult;
 //# sourceMappingURL=resolver.d.ts.map