@refrakt-md/runes 0.42.0 → 0.44.0

package/dist/lib/composition-placement.js

@@ -0,0 +1,180 @@
+import { UNIVERSAL_AXIS_FACETS } from '@refrakt-md/transform';
+import { AXIS_ATTRIBUTES } from '../universal-attributes.js';
+// ---------------------------------------------------------------------------
+// The runes a template may place, by name
+// ---------------------------------------------------------------------------
+/**
+ * Runes a composition can place, by tag name. A composition decides at
+ * construction which placed rune owns a role, and only the placed rune's schema
+ * says what it accepts. Core runes register when the package entry loads; a
+ * plugin's own runes register before its compositions are built, and each
+ * composed rune registers once built, so a later composition can place it.
+ */
+const placeable = new Map();
+export function registerPlaceableSchema(name, schema) {
+    if (schema)
+        placeable.set(name, schema);
+}
+export function placeableSchema(name) {
+    return placeable.get(name);
+}
+const ROLE_NAMES = {
+    header: 'a page-section header',
+    'prose-body': 'a prose body',
+    media: 'a media zone or frame target',
+};
+/** Whether a placed rune takes an axis: its schema declares the axis's first
+ *  attribute. Schema narrowing (SPEC-125) put it there only where the axis
+ *  applies, and a composed rune's own narrowing follows its placements, so the
+ *  same question looks through a nested composition. */
+function takes(rune, axis) {
+    const names = AXIS_ATTRIBUTES[axis];
+    if (!names || names.length === 0)
+        return true;
+    const schema = placeable.get(rune);
+    return schema?.attributes?.[names[0]] !== undefined;
+}
+/**
+ * Nominate the carrier (D31) and place every axis (D33). Throws, through
+ * `fail`, on a marker that cannot stand and on several top-level runes with no
+ * marker.
+ */
+export function resolvePlacements(rune, runes, fail) {
+    for (const r of runes) {
+        const schema = placeable.get(r.node.tag);
+        if (schema?.attributes?.chrome !== undefined) {
+            fail('chrome-collision', `it places \`{% ${r.node.tag} %}\`, which declares an attribute named \`chrome\`. In a template \`chrome\` nominates the paint carrier (D31), so the two cannot be told apart. Rename the rune's attribute.`, r.node);
+        }
+    }
+    const marked = runes.filter((r) => r.node.attributes.chrome !== undefined);
+    for (const r of marked) {
+        if (r.node.attributes.chrome !== true) {
+            fail('chrome-invalid', `\`chrome\` on \`{% ${r.node.tag} %}\` takes no value; write it bare, as \`{% ${r.node.tag} chrome %}\` (D31).`, r.node);
+        }
+        if (r.inEach) {
+            fail('chrome-invalid', `\`{% ${r.node.tag} chrome %}\` is inside an \`each\` slot, so it would be placed once per item. The carrier is one region; mark a rune outside the slot (D31).`, r.node);
+        }
+    }
+    if (marked.length > 1) {
+        fail('chrome-marked-twice', `\`chrome\` marks ${marked.map((r) => `\`{% ${r.node.tag} %}\``).join(' and ')}. A rune has exactly one paint carrier; mark one of them (D31).`, marked[1].node);
+    }
+    let carrier = marked[0]?.node;
+    if (!carrier) {
+        const top = runes.filter((r) => r.top);
+        // A rune repeated per item is several regions, however it is written.
+        const several = top.length > 1 || top.some((r) => r.inEach);
+        if (several) {
+            const names = [...new Set(top.map((r) => `\`{% ${r.node.tag} %}\``))].join(', ');
+            fail('chrome-ambiguous', `it places several runes at its top level (${names}) and marks none as the paint carrier, so \`elevation\`, \`tint\` and the rest would have nowhere to land. Wrap them in one \`{% section %}\`, which then carries them, or mark one with \`chrome\` (D14, D31).`, top[1]?.node ?? top[0].node);
+        }
+        carrier = top[0]?.node;
+    }
+    const carrierRune = carrier?.tag;
+    const axes = {};
+    const axisOf = {};
+    for (const facet of UNIVERSAL_AXIS_FACETS) {
+        for (const name of AXIS_ATTRIBUTES[facet.axis] ?? [])
+            axisOf[name] = facet.axis;
+        const placement = facet.placement;
+        if (placement === 'root') {
+            axes[facet.axis] = { placement };
+            continue;
+        }
+        if (placement === 'carrier') {
+            if (!carrier) {
+                axes[facet.axis] = {
+                    placement,
+                    dropped: `\`${rune}\` places no rune to carry it`,
+                };
+            }
+            else if (takes(carrierRune, facet.axis)) {
+                axes[facet.axis] = { placement, node: carrier, rune: carrierRune };
+            }
+            else {
+                axes[facet.axis] = {
+                    placement,
+                    unavailable: `its paint carrier \`${carrierRune}\` does not take \`${facet.axis}\``,
+                };
+            }
+            continue;
+        }
+        // A role owner: the carrier when it owns the role, else the single rune
+        // the template places itself that does (D33.2).
+        if (carrier && takes(carrierRune, facet.axis)) {
+            axes[facet.axis] = { placement, node: carrier, rune: carrierRune };
+            continue;
+        }
+        const owners = runes.filter((r) => !r.inEach && takes(r.node.tag, facet.axis));
+        if (owners.length === 1) {
+            axes[facet.axis] = { placement, node: owners[0].node, rune: owners[0].node.tag };
+        }
+        else if (owners.length === 0) {
+            axes[facet.axis] = {
+                placement,
+                unavailable: `no rune \`${rune}\` places owns ${ROLE_NAMES[placement]}`,
+            };
+        }
+        else {
+            axes[facet.axis] = {
+                placement,
+                unavailable: `several runes \`${rune}\` places own ${ROLE_NAMES[placement]} (${owners.map((o) => `\`${o.node.tag}\``).join(', ')}) and none is its paint carrier`,
+            };
+        }
+    }
+    return { carrier, axes, axisOf };
+}
+/** The universal attributes this composition offers, and why it offers none of
+ *  an axis's — the composed half of SPEC-125's narrowing. Root-placed axes, and
+ *  axes no placed rune takes, are left to the ordinary structural gates on the
+ *  composed rune itself: a composition that places no rune and declares
+ *  `provides: [prose]` keeps `reading` on its own root, as before. */
+export function placementAvailability(placements) {
+    const offered = new Set();
+    const withheld = new Map();
+    for (const [axis, target] of Object.entries(placements.axes)) {
+        if (target.placement === 'root')
+            continue;
+        if ('unavailable' in target) {
+            withheld.set(axis, target.unavailable);
+            continue;
+        }
+        for (const name of AXIS_ATTRIBUTES[axis] ?? [])
+            offered.add(name);
+    }
+    return { offered, withheld };
+}
+/**
+ * Split one instance's attributes: the universal ones that move to a placed
+ * rune, by target node, and those dropped for want of a carrier. What is left
+ * stays on the root. The author's value replaces a literal the template wrote on
+ * the target (D34.4).
+ */
+export function moveAttributes(placements, attrs) {
+    const moves = new Map();
+    const moved = new Set();
+    const dropped = [];
+    for (const [name, value] of Object.entries(attrs)) {
+        if (value === undefined || value === null)
+            continue;
+        const axis = placements.axisOf[name];
+        if (!axis)
+            continue;
+        const target = placements.axes[axis];
+        if (!target || target.placement === 'root')
+            continue;
+        if ('node' in target) {
+            moved.add(name);
+            const into = moves.get(target.node) ?? {};
+            into[name] = value;
+            moves.set(target.node, into);
+        }
+        else if ('dropped' in target) {
+            moved.add(name);
+            dropped.push(name);
+        }
+        // An axis no placed rune takes stays on the root, where it is offered only
+        // when the composed rune meets the axis's gate itself.
+    }
+    return { moves, moved, dropped };
+}
+//# sourceMappingURL=composition-placement.js.map

package/dist/lib/composition-placement.js.map

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

package/dist/lib/composition.d.ts

@@ -4,6 +4,7 @@ import type { RuneConfig } from '@refrakt-md/transform';
 import type { SchemaTable } from './schema-table.js';
 import { SchemaSideTable } from './schema-side-table.js';
 import type { RegistersDeclaration } from './registers.js';
+import type { AxisTarget, CompositionPlacements } from './composition-placement.js';
 /**
  * A composition template, as `createContentModelSchema` receives it — the third
  * of D5's three mutually exclusive emit paths, beside `transform` and `emits`.
@@ -19,6 +20,8 @@ export interface CompositionTemplate {
     body: string;
     /** The `blocks` the rune declares — what `{% metablock %}` may name (D7). */
     blocks?: readonly string[];
+    /** D34 — the definition's defaults for universal axes, by attribute. */
+    defaults?: Readonly<Record<string, string>>;
 }
 /** One node of a composition's expansion, as the contract records it (D6). */
 export interface CompositionOutlineNode {
@@ -56,6 +59,31 @@ export interface CompositionInfo {
     config?: RuneConfig;
     /** The config key the engine finds it under. */
     typeName?: string;
+    /** Where each universal axis lands (D33): its placement, the rune it lands
+     *  on, or why it is not offered. For `inspect`, `contracts` and `reference`. */
+    axes: Record<string, AxisPlacementInfo>;
+    /** D34 — the definition's defaults, each with where it lands and any literal
+     *  the template writes there, which wins over it. */
+    defaults?: Record<string, CompositionDefaultInfo>;
+}
+/** One `defaults` entry, as tooling reads it (D34). */
+export interface CompositionDefaultInfo {
+    value: string;
+    placement: AxisTarget['placement'];
+    /** The placed rune it lands on; absent for a root-placed axis. */
+    rune?: string;
+    /** A literal the template writes on that rune, which the default yields to. */
+    literal?: string;
+}
+/** One axis's placement on a composed rune, as tooling reads it. */
+export interface AxisPlacementInfo {
+    placement: AxisTarget['placement'];
+    /** The placed rune it lands on. */
+    rune?: string;
+    /** Offered, but dropped with a warning: there is no carrier (D24). */
+    dropped?: string;
+    /** Not offered, and why (D33.3). */
+    unavailable?: string;
 }
 /** Compositions by schema — the same pattern as `schemaTables`: tooling has only
  *  the schema to read from. */
@@ -77,15 +105,35 @@ export declare function frontmatterKeyLine(frontmatter: string, path: readonly s
  *  that becomes a property of the outer entity, not a peer of it (D9). */
 export declare const SUBORDINATE_SCHEMA_TYPES: ReadonlySet<string>;
 /**
- * `{% slot name="x" each %}` is the spec's spelling, and Markdoc's tag grammar
- * has no bare boolean attribute. Rewrite it to `each=true` inside slot tags
- * only, outside quoted values, before parsing.
+ * `{% slot name="x" each %}` and `{% section chrome %}` are the spec's
+ * spellings (D26, D31), and Markdoc's tag grammar has no bare boolean
+ * attribute. Rewrite `each` inside slot tags, and `chrome` inside any tag, to
+ * `=true`, outside quoted values, before parsing.
  */
 export declare function normaliseEach(body: string): string;
 export interface CompiledComposition {
     /** The transform `createContentModelSchema` calls where it would call `transform`. */
     transform: (resolved: ResolvedContent, attrs: Record<string, any>, config: Config, node: Node) => RenderableTreeNodes;
     info: CompositionInfo;
+    /**
+     * The template expanded for one instance: what `transform` hands Markdoc,
+     * before it is transformed. Validation reads it to see which slot each
+     * placed node came from (ADR-046 decision 3).
+     */
+    place: (resolved: ResolvedContent, attrs: Record<string, any>) => Node[];
+    /** Where the universal attributes land (D14, D31, D33). */
+    placements: CompositionPlacements;
+    /** One instance's attributes less the universal ones that moved off the root
+     *  (or were dropped for want of a carrier). What the root keeps. */
+    rootAttributes: (attrs: Record<string, any>) => Record<string, any>;
+    /** The parsed template, as construction checked it. */
+    templateNodes: readonly Node[];
+    /** SPEC-182 D4 — the filled attributes the author also wrote, for the
+     *  `fill-overridden` warning. */
+    overriddenFills: (resolved: ResolvedContent, written: Record<string, unknown>) => Array<{
+        attribute: string;
+        field: string;
+    }>;
 }
 export interface CompileCompositionOptions {
     contentModel: ContentModel | ((attrs: Record<string, any>) => ContentModel);
@@ -119,6 +167,8 @@ export interface CompositionDefinition {
     metaFields?: Record<string, unknown>;
     blocks?: Record<string, unknown>;
     provides?: string[];
+    /** D34 — defaults for universal axes, by attribute name. */
+    defaults?: Record<string, string>;
     template: string;
     /** 1-based line of the source on which the template body starts. */
     templateLine: number;
@@ -143,6 +193,13 @@ export declare function parseCompositionDefinition(rune: string, source: string)
  * resolves a field against the rune's modifier values, exactly as it does for a
  * tree-owning rune — which must declare the same attributes as modifiers for
  * its own blocks to fill.
+ *
+ * An enum attribute the template only forwards to a placed rune
+ * (`{% section media-position=$attrs["media-position"] %}`) is that rune's
+ * input, not a modifier of the composition: as a `data-*` on the empty root it
+ * would match the dimension rules meant for the rune it is forwarded to — a
+ * `data-media-position="cover"` root is laid out as a cover well. It stays in
+ * the field bag, which the schema row and registration read.
  */
 export declare function composedRuneConfig(def: CompositionDefinition): RuneConfig;
 /** One rune as the catalog-wide checks see it. */

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

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