@refrakt-md/runes 0.43.0 → 0.44.0

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,9 +105,10 @@ 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 {
@@ -92,6 +121,19 @@ export interface CompiledComposition {
      * 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);
@@ -125,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;
@@ -149,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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"}

package/dist/lib/composition.js

@@ -68,6 +68,8 @@ import { SchemaSideTable } from './schema-side-table.js';
 import { declareSlotMarkers, declareSlotMarkersOnNodes } from './slot-markers.js';
 import { registersSources } from './registers.js';
 import { parse } from '../parse.js';
+import { universalAttributeDefinition } from './universal-attribute-defs.js';
+import { moveAttributes, resolvePlacements } from './composition-placement.js';
 const { Ast, Tag: MarkdocTag } = Markdoc;
 /** Compositions by schema — the same pattern as `schemaTables`: tooling has only
  *  the schema to read from. */
@@ -212,6 +214,8 @@ function slotFields(model, fail) {
             refs,
             ...(listItems ? { listItems } : {}),
             ...(ambiguousList ? { ambiguousList } : {}),
+            ...(f.fills ? { fills: f.fills } : {}),
+            ...(f.itemModel ? { itemFields: f.itemModel.fields.map((i) => i.name) } : {}),
         });
     };
     if (s.type === 'sequence') {
@@ -259,47 +263,56 @@ function slotValues(model, resolved) {
 // Template parsing and the construction-time checks
 // ---------------------------------------------------------------------------
 /**
- * `{% 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 function normaliseEach(body) {
-    return body.replace(/\{%-?\s*slot\b([^%]*?)(-?%\})/g, (whole, inner, close) => {
-        let out = '';
-        let quote = null;
-        let i = 0;
-        while (i < inner.length) {
-            const ch = inner[i];
-            if (quote) {
-                if (ch === '\\') {
-                    out += inner.slice(i, i + 2);
-                    i += 2;
-                    continue;
-                }
-                if (ch === quote)
-                    quote = null;
-                out += ch;
-                i++;
-                continue;
-            }
-            if (ch === '"' || ch === "'") {
-                quote = ch;
-                out += ch;
-                i++;
+    return body.replace(/\{%-?\s*([a-z][\w-]*)\b([^%]*?)(-?%\})/g, (whole, tag, inner, close) => {
+        const bare = tag === 'slot' ? ['each', 'chrome'] : ['chrome'];
+        const out = bareToTrue(inner, bare);
+        return out === inner ? whole : whole.replace(inner + close, out + close);
+    });
+}
+/** Rewrite each bare word in `words` to `word=true`, outside quoted values. */
+function bareToTrue(inner, words) {
+    let out = '';
+    let quote = null;
+    let i = 0;
+    while (i < inner.length) {
+        const ch = inner[i];
+        if (quote) {
+            if (ch === '\\') {
+                out += inner.slice(i, i + 2);
+                i += 2;
                 continue;
             }
+            if (ch === quote)
+                quote = null;
+            out += ch;
+            i++;
+            continue;
+        }
+        if (ch === '"' || ch === "'") {
+            quote = ch;
+            out += ch;
+            i++;
+            continue;
+        }
+        if (i === 0 || /\s/.test(inner[i - 1])) {
             const rest = inner.slice(i);
-            const m = /^each(?![\w=-])/.exec(rest);
-            if (m && (i === 0 || /\s/.test(inner[i - 1]))) {
-                out += 'each=true';
-                i += m[0].length;
+            const word = words.find((w) => new RegExp(`^${w}(?![\\w=-])`).test(rest));
+            if (word) {
+                out += `${word}=true`;
+                i += word.length;
                 continue;
             }
-            out += ch;
-            i++;
         }
-        return whole.replace(inner + close, out + close);
-    });
+        out += ch;
+        i++;
+    }
+    return out;
 }
 /** Variables a template node reads, by path, in attribute or content position. */
 function variablePaths(value, out = []) {
@@ -370,6 +383,8 @@ export function compileComposition(template, options) {
     const placedSlots = new Map();
     const slotOrder = [];
     const placements = [];
+    /** Every rune the template places, for the paint carrier and role owners. */
+    const templateRunes = [];
     const checkVariables = (n, scope) => {
         for (const path of variablePaths(n.attributes)) {
             const [root, name] = path;
@@ -438,6 +453,7 @@ export function compileComposition(template, options) {
                 fail('composition-cycle', `it places \`{% ${n.tag} %}\`, which is the rune itself — a composition cycle.`);
             }
             placements.push({ rune: n.tag, ...(scope.parentRune ? { parent: scope.parentRune } : {}) });
+            templateRunes.push({ node: n, top: !scope.parentRune, inEach: !!scope.each });
             const children = outlineOf(n.children, { ...scope, parentRune: n.tag });
             return [{ rune: n.tag, ...(children.length > 0 ? { children } : {}) }];
         }
@@ -476,6 +492,11 @@ export function compileComposition(template, options) {
         if (!field) {
             fail('slot-unknown-field', `slot \`${name}\` names no field of the content model (fields: ${[...fields.keys()].join(', ') || 'none'}) (D26).`);
         }
+        if (field?.fills) {
+            fail('fill-placed', `slot \`${name}\` places field \`${name}\`, which fills ${Object.keys(field.fills)
+                .map((a) => `\`${a}\``)
+                .join(', ')}. A filling field is placed into the rune's values, which the template places through a meta block or \`$attrs\`; a slot as well would render it twice. Remove the slot (SPEC-182 D5).`);
+        }
         if (placedSlots.has(name)) {
             fail('slot-placed-twice', `slot \`${name}\` is placed twice. A slot is placed exactly once; two positions are two declared fields, or a theme's concern (D26).`);
         }
@@ -538,8 +559,63 @@ export function compileComposition(template, options) {
         return { metablock: name };
     }
     const outline = outlineOf(ast.children, {});
-    // D11 — a field no slot places parses and then silently does not render.
-    const unplaced = [...fields.keys()].filter((f) => !placedSlots.has(f));
+    // D14, D31, D33 — the paint carrier and every axis's target.
+    const plan = resolvePlacements(rune, templateRunes, (code, msg, at) => {
+        current = at ?? current;
+        return fail(code, msg);
+    });
+    current = undefined;
+    // D34 — each default lands where the author's attribute would. One that
+    // lands nowhere is a definition error, not a silent no-op.
+    const defaultsByNode = new Map();
+    const defaultInfo = {};
+    for (const [name, value] of Object.entries(template.defaults ?? {})) {
+        const target = name === 'density'
+            ? plan.carrier
+                ? { placement: 'carrier', node: plan.carrier, rune: plan.carrier.tag }
+                : { placement: 'carrier', dropped: `\`${rune}\` places no rune to carry it` }
+            : plan.axes[plan.axisOf[name]];
+        if (!target)
+            continue;
+        if (target.placement === 'root') {
+            defaultInfo[name] = { value, placement: 'root' };
+            continue;
+        }
+        if (!('node' in target)) {
+            const why = 'dropped' in target ? target.dropped : target.unavailable;
+            throw new CompositionError('defaults-invalid', `Rune "${rune}": \`defaults.${name}\` lands nowhere: ${why} (D34).`);
+        }
+        const into = defaultsByNode.get(target.node) ?? {};
+        into[name] = value;
+        defaultsByNode.set(target.node, into);
+        const literal = target.node.attributes[name];
+        defaultInfo[name] = {
+            value,
+            placement: target.placement,
+            rune: target.rune,
+            ...(literal !== undefined && typeof literal !== 'object' ? { literal: String(literal) } : {}),
+        };
+    }
+    // SPEC-182 D2 — `fills` names declared attributes and item-model fields.
+    for (const [name, field] of fields) {
+        if (!field.fills)
+            continue;
+        if (!field.itemFields) {
+            fail('fills-invalid', `field \`${name}\` declares \`fills\` but no \`itemModel\`: there is nothing to fill from. Give it an item model that reads the values (SPEC-182 D1).`);
+        }
+        for (const [attr, ref] of Object.entries(field.fills)) {
+            if (!declared.has(attr)) {
+                fail('fills-invalid', `field \`${name}\` fills \`${attr}\`, which the rune does not declare (declared: ${[...declared].join(', ') || 'none'}). Declare it under \`attributes\` (SPEC-182 D2).`);
+            }
+            const source = typeof ref === 'string' && ref.startsWith('$') ? ref.slice(1) : undefined;
+            if (!source || !field.itemFields.includes(source)) {
+                fail('fills-invalid', `field \`${name}\` fills \`${attr}\` from \`${ref}\`, which names no field of its item model (fields: ${field.itemFields.join(', ')}). Write it as \`$<field>\` (SPEC-182 D2).`);
+            }
+        }
+    }
+    // D11 — a field no slot places parses and then silently does not render. A
+    // filling field is placed into the rune's values (SPEC-182 D5).
+    const unplaced = [...fields.keys()].filter((f) => !placedSlots.has(f) && !fields.get(f).fills);
     if (unplaced.length > 0) {
         fail('field-unplaced', `content-model field${unplaced.length > 1 ? 's' : ''} ${unplaced.map((f) => `\`${f}\``).join(', ')} ${unplaced.length > 1 ? 'are' : 'is'} placed by no slot, so authored content would be dropped. Place ${unplaced.length > 1 ? 'each' : 'it'} with \`{% slot name="…" /%}\` (D11).`);
     }
@@ -548,11 +624,22 @@ export function compileComposition(template, options) {
         options.schema?.fallback?.type ??
         Object.values(options.schema?.rows ?? {}).find((r) => r.type)?.type;
     const nodeSources = registersNodeSources(options.registers, fields, declared);
+    const axes = {};
+    for (const [axis, target] of Object.entries(plan.axes)) {
+        axes[axis] = {
+            placement: target.placement,
+            ...('rune' in target ? { rune: target.rune } : {}),
+            ...('dropped' in target ? { dropped: target.dropped } : {}),
+            ...('unavailable' in target ? { unavailable: target.unavailable } : {}),
+        };
+    }
     const info = {
         rune,
         slots: slotOrder,
         placements,
         outline,
+        axes,
+        ...(Object.keys(defaultInfo).length > 0 ? { defaults: defaultInfo } : {}),
         ...(schemaType ? { schemaType } : {}),
     };
     const attributeNames = [...declared];
@@ -565,6 +652,8 @@ export function compileComposition(template, options) {
             resolved: slotValues(structural, resolved),
             attrs: bound,
             fields,
+            moves: moveAttributes(plan, attrs).moves,
+            defaults: defaultsByNode,
         };
         const placed = expand(ast.children, ctx);
         // Top-level template nodes are the composed rune's own (D10). A slot
@@ -575,7 +664,11 @@ export function compileComposition(template, options) {
         }
         return placed;
     };
-    const transform = (resolved, attrs, config) => {
+    const transform = (resolved, attrs, config, node) => {
+        // SPEC-182 D2 — values a paragraph fills become the rune's own, before
+        // anything reads them. `attrs` is the caller's object, filled in place, so
+        // the schema table applied after this transform reads them too.
+        Object.assign(attrs, filledAttributes(resolved, node?.attributes ?? {}));
         const placed = place(resolved, attrs);
         const children = Markdoc.transform(placed, templateConfig(config));
         // The field bag holds every attribute the author set (or that defaulted):
@@ -597,7 +690,61 @@ export function compileComposition(template, options) {
         copyRegisteredNodes(root, nodeSources);
         return root;
     };
-    return { transform, info, place };
+    /** SPEC-182 D2, D4 — what the filling fields supply, for the attributes the
+     *  author did not write. The author's attribute always wins. */
+    const filledAttributes = (resolved, written) => {
+        const out = {};
+        const values = slotValues(structural, resolved);
+        for (const [name, field] of fields) {
+            if (!field.fills)
+                continue;
+            const record = values[`${name}Data`];
+            if (!record)
+                continue;
+            for (const [attr, ref] of Object.entries(field.fills)) {
+                if (written[attr] !== undefined)
+                    continue;
+                const value = record[ref.slice(1)];
+                if (value !== undefined && value !== '')
+                    out[attr] = value;
+            }
+        }
+        return out;
+    };
+    /** SPEC-182 D4 — attributes the author wrote that a paragraph would also have
+     *  filled: the paragraph is consumed and does not render. */
+    const overriddenFills = (resolved, written) => {
+        const out = [];
+        const values = slotValues(structural, resolved);
+        for (const [name, field] of fields) {
+            if (!field.fills || !values[`${name}Data`])
+                continue;
+            for (const attr of Object.keys(field.fills)) {
+                if (written[attr] !== undefined)
+                    out.push({ attribute: attr, field: name });
+            }
+        }
+        return out;
+    };
+    const rootAttributes = (attrs) => {
+        const { moved } = moveAttributes(plan, attrs);
+        if (moved.size === 0)
+            return attrs;
+        const out = {};
+        for (const [name, value] of Object.entries(attrs))
+            if (!moved.has(name))
+                out[name] = value;
+        return out;
+    };
+    return {
+        transform,
+        info,
+        place,
+        placements: plan,
+        rootAttributes,
+        overriddenFills,
+        templateNodes: ast.children,
+    };
 }
 function asNodes(value) {
     if (Array.isArray(value))
@@ -667,6 +814,19 @@ function substituteNode(node, ctx) {
         }
         attributes[key] = resolved;
     }
+    if (node.type === 'tag') {
+        // D31 — the marker is the template's, consumed here: it reaches neither
+        // the placed rune's attributes nor the HTML.
+        delete attributes.chrome;
+        // D34.3 — author > template literal > definition default.
+        for (const [name, value] of Object.entries(ctx.defaults?.get(node) ?? {})) {
+            if (attributes[name] === undefined)
+                attributes[name] = value;
+        }
+        const moved = ctx.moves?.get(node);
+        if (moved)
+            Object.assign(attributes, moved);
+    }
     return cloneNode(node, attributes, expand(node.children, ctx));
 }
 /** The items a list field resolved to, each with its `$each` binding and content. */
@@ -862,6 +1022,7 @@ const DEFINITION_KEYS = new Set([
     'metaFields',
     'blocks',
     'provides',
+    'defaults',
 ]);
 /** Keys that would give a composed rune styles of its own (D2). */
 const STYLE_KEYS = new Set(['css', 'style', 'styles', 'stylesheet', 'block', 'class']);
@@ -974,6 +1135,7 @@ export function parseCompositionDefinition(rune, source) {
         (!Array.isArray(fm.provides) || !fm.provides.every((p) => typeof p === 'string'))) {
         fail('invalid-value', '`provides` must be a list of names.', ['provides']);
     }
+    const defaults = parseDefaults(fm.defaults, (code, msg, at) => fail(code, msg, ['defaults', ...(at ?? [])]));
     return {
         rune,
         tag,
@@ -986,12 +1148,46 @@ export function parseCompositionDefinition(rune, source) {
         ...(fm.metaFields ? { metaFields: fm.metaFields } : {}),
         ...(fm.blocks ? { blocks: fm.blocks } : {}),
         ...(fm.provides ? { provides: fm.provides } : {}),
+        ...(defaults ? { defaults } : {}),
         template: match[2],
         // `---`, the frontmatter's lines, `---`: the body starts on the next.
         templateLine: frontmatter.split(/\r?\n/).length + 3,
         frontmatter,
     };
 }
+/** D34.6 — `density` has no author-facing attribute, so its scale is stated here. */
+const DENSITY_VALUES = ['full', 'compact', 'minimal'];
+/**
+ * D34 — `defaults`: universal axes only, each with a value the axis accepts.
+ * A rune's own attribute takes its default where it is declared.
+ */
+function parseDefaults(raw, fail) {
+    if (raw === undefined)
+        return undefined;
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        fail('defaults-invalid', '`defaults` must be a mapping of universal attributes to values.');
+    }
+    const out = {};
+    for (const [key, value] of Object.entries(raw)) {
+        if (value === null || typeof value === 'object') {
+            fail('defaults-invalid', `\`defaults.${key}\` must be a single value.`, [key]);
+        }
+        const text = String(value);
+        const accepted = key === 'density'
+            ? DENSITY_VALUES
+            : universalAttributeDefinition(key) === undefined
+                ? undefined
+                : universalAttributeDefinition(key).matches;
+        if (key !== 'density' && universalAttributeDefinition(key) === undefined) {
+            fail('defaults-invalid', `\`defaults\` takes universal attributes only, and \`${key}\` is not one. A rune's own attribute takes its default where it is declared, under \`attributes\` (D34).`, [key]);
+        }
+        if (Array.isArray(accepted) && !accepted.includes(text)) {
+            fail('defaults-invalid', `\`defaults.${key}\` is \`${text}\`, which \`${key}\` does not accept (${accepted.join(', ')}).`, [key]);
+        }
+        out[key] = text;
+    }
+    return out;
+}
 function parseAttributes(raw, sectionFail) {
     const fail = (code, msg) => sectionFail(code, msg);
     if (raw === undefined)
@@ -1042,6 +1238,7 @@ const FIELD_KEYS = new Set([
     'itemModel',
     'emitTag',
     'emitAttributes',
+    'fills',
 ]);
 /** A field list as YAML writes it: a mapping keyed by name, or a list with `name`. */
 function parseFields(raw, where, fail) {
@@ -1306,6 +1503,13 @@ function parseDelimitedModel(c, fail) {
  * 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 function composedRuneConfig(def) {
     const read = new Set();
@@ -1317,22 +1521,39 @@ export function composedRuneConfig(def) {
                 read.add(ref);
         }
     }
+    const forwarded = forwardedAttributes(def.template);
     const modifiers = {};
     for (const [name, attr] of Object.entries(def.attributes)) {
-        if (!attr.matches && !read.has(name))
+        if (!read.has(name) && (!attr.matches || forwarded.has(name)))
             continue;
         modifiers[name] = {
             source: 'meta',
             ...(attr.default !== undefined ? { default: String(attr.default) } : {}),
         };
     }
+    // D34 — a root-placed axis's default is the generated config's, since a
+    // template never writes on the root.
+    const d = def.defaults ?? {};
     return {
+        composed: true,
+        ...(d.width ? { defaultWidth: d.width } : {}),
+        ...(d.spacing ? { defaultSpacing: d.spacing } : {}),
+        ...(d.inset ? { defaultInset: d.inset } : {}),
         ...(Object.keys(modifiers).length > 0 ? { modifiers } : {}),
         ...(def.metaFields ? { metaFields: def.metaFields } : {}),
         ...(def.blocks ? { blocks: def.blocks } : {}),
         ...(def.provides ? { provides: def.provides } : {}),
     };
 }
+/** The attributes a template passes to a placed rune as an attribute value:
+ *  `name=$attrs.x` or `name=$attrs["x"]`. */
+function forwardedAttributes(template) {
+    const out = new Set();
+    for (const m of template.matchAll(/[\w-]+\s*=\s*\$attrs(?:\.([\w-]+)|\[\s*["']([^"']+)["']\s*\])/g)) {
+        out.add(m[1] ?? m[2]);
+    }
+    return out;
+}
 /** The schema types a rune can emit at its root — its table's, and its `seoType`. */
 function emittedTypes(entry, table) {
     return [