@refrakt-md/runes 0.30.1 → 0.32.0

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAA+B,MAAM,uBAAuB,CAAC;AAEtF,OAAO,KAAK,EAAE,mBAAmB,EAAmB,cAAc,EAAkB,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAS7I,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAgC9D;gFACgF;AAChF,eAAO,MAAM,UAAU,EAAE,WAmjBxB,CAAC;AAEF,sGAAsG;AACtG,eAAO,MAAM,UAAU,aAAa,CAAC;AAIrC,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,EAAE,CAAC;CACzB;AA0vCD,UAAU,YAAY;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAsKD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CACnC,UAAU,EAAE,OAAO,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE;IACT,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChI,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACnC;;;uBAGmB;IACnB,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACrC,EACD,GAAG,EAAE,eAAe;AACpB;;yEAEyE;AACzE,cAAc,CAAC,EAAE,OAAO,EAAE,GACxB,OAAO,CAqBT;AAED,2DAA2D;AAC3D,MAAM,WAAW,wBAAwB;IACxC;;8DAE0D;IAC1D,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACrC;;kFAE8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;6CACyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;2EAIuE;IACvE,WAAW,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC;;;yEAGiE;QACjE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB;2CACmC;QACnC,YAAY,CAAC,EAAE,YAAY,CAAC;KAC5B,CAAC;CACF;AAuBD,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,wBAA6B,GAAG,mBAAmB,CAgUhG;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,EAAE,mBAA+C,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAA+B,MAAM,uBAAuB,CAAC;AAEtF,OAAO,KAAK,EAAE,mBAAmB,EAAmB,cAAc,EAAkB,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAS7I,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAwD9D;gFACgF;AAChF,eAAO,MAAM,UAAU,EAAE,WAmlBxB,CAAC;AAEF,sGAAsG;AACtG,eAAO,MAAM,UAAU,aAAa,CAAC;AAIrC,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,EAAE,CAAC;CACzB;AA0vCD,UAAU,YAAY;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAsKD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CACnC,UAAU,EAAE,OAAO,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE;IACT,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChI,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACnC;;;uBAGmB;IACnB,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACrC,EACD,GAAG,EAAE,eAAe;AACpB;;yEAEyE;AACzE,cAAc,CAAC,EAAE,OAAO,EAAE,GACxB,OAAO,CAqBT;AAED,2DAA2D;AAC3D,MAAM,WAAW,wBAAwB;IACxC;;8DAE0D;IAC1D,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACrC;;kFAE8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;6CACyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;2EAIuE;IACvE,WAAW,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC;;;yEAGiE;QACjE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB;2CACmC;QACnC,YAAY,CAAC,EAAE,YAAY,CAAC;KAC5B,CAAC;CACF;AAuBD,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,wBAA6B,GAAG,mBAAmB,CAgUhG;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,EAAE,mBAA+C,CAAC"}

package/dist/config.js

@@ -17,6 +17,29 @@ import { resolveCollections } from './collection-resolve.js';
 import { resolveRelationships } from './relationships-resolve.js';
 import { resolveAggregates } from './aggregate-resolve.js';
 import { resolveDataBindings } from './data-resolve.js';
+// SPEC-125 Phase 2 — the join tables (`sections`, `mediaSlots`, `frameTarget`)
+// are declared in the tag modules that own them and referenced here. Config
+// points at rune identity; it does not define it (ADR-028). The engine's read
+// path is unchanged — it still reads `config.sections` and friends.
+import { accordionItemSections, accordionSections } from './tags/accordion.js';
+import { annotateSections } from './tags/annotate.js';
+import { blogSections } from './tags/blog.js';
+import { budgetSections } from './tags/budget.js';
+import { cardSections } from './tags/card.js';
+import { codeGroupSections } from './tags/codegroup.js';
+import { dataTableSections } from './tags/datatable.js';
+import { drawerSections } from './tags/drawer.js';
+import { figureFrameTarget, figureSections } from './tags/figure.js';
+import { formSections } from './tags/form.js';
+import { hintSections } from './tags/hint.js';
+import { mediaTextMediaSlots, mediaTextSections } from './tags/mediatext.js';
+import { pullQuoteSections } from './tags/pullquote.js';
+import { revealSections } from './tags/reveal.js';
+import { sectionSections } from './tags/section.js';
+import { showcaseFrameTarget, showcaseSections } from './tags/showcase.js';
+import { sidenoteSections } from './tags/sidenote.js';
+import { textBlockSections } from './tags/textblock.js';
+import { tabGroupSections } from './tags/tabs.js';
 /** Read text content from a property span child */
 function readPropText(node, prop) {
     for (const c of node.children) {
@@ -42,8 +65,21 @@ export const coreConfig = {
     icons: {},
     runes: {
         // ─── Simple runes (block name only, engine adds BEM classes) ───
-        Accordion: { block: 'accordion', defaultDensity: 'full', sections: { preamble: 'preamble', headline: 'title', blurb: 'description' }, autoLabel: pageSectionAutoLabel, editHints: { headline: 'inline', eyebrow: 'inline', blurb: 'inline' } },
-        AccordionItem: { block: 'accordion-item', parent: 'Accordion', requiresParent: 'Accordion', rootAttributes: { 'data-state': 'closed' }, autoLabel: { name: 'header' }, editHints: { header: 'inline', body: 'none' } },
+        Accordion: { block: 'accordion', defaultDensity: 'full', sections: accordionSections, autoLabel: pageSectionAutoLabel, editHints: { headline: 'inline', eyebrow: 'inline', blurb: 'inline' } },
+        // SPEC-125 Phase 1 — the answer panel is the item's `body` role, so
+        // `reading` / `dropcap` land on it. The header decision is recorded in
+        // `sectionRoleExceptions` so it travels with the rune.
+        AccordionItem: {
+            block: 'accordion-item', parent: 'Accordion', requiresParent: 'Accordion',
+            rootAttributes: { 'data-state': 'closed' },
+            autoLabel: { name: 'header' },
+            sections: accordionItemSections,
+            provides: ['prose'],
+            sectionRoleExceptions: {
+                header: 'The `header` slot is the <summary> disclosure control, not a page-section header. `header` would inherit the chrome-row rhythm (a 3rem margin under every summary); `title` would tighten every summary\'s line-height while leaving `prominence` inert anyway, since `.rf-accordion-item__header` pins the control\'s font size on purpose. The parent Accordion already holds `title`.',
+            },
+            editHints: { header: 'inline', body: 'none' },
+        },
         Details: { block: 'details', defaultElevation: 'flush', autoLabel: { summary: 'summary' }, editHints: { summary: 'inline', body: 'none' } },
         Grid: {
             block: 'grid',
@@ -86,7 +122,7 @@ export const coreConfig = {
                 topbar: { fields: ['title'], layout: 'bar' },
             },
             layout: { root: ['topbar'] },
-            sections: { topbar: 'header' },
+            sections: codeGroupSections,
             // Opt in to the highlight transform's `theme.code.colorScheme` cascade
             // (topbar + tab chrome flip with the inner code). Static flag → declared
             // via rootAttributes rather than a postTransform. The `data-code-host`
@@ -115,12 +151,20 @@ export const coreConfig = {
          * substitutes the entity content wrapped in `<section
          * class="rf-expand" data-rune="expand">`. Engine config provides the
          * block name for CSS tree-shaking. */
-        Expand: { block: 'expand' },
+        /* SPEC-125 Phase 3 — `expand` offers no universal attributes, and unlike its
+         * five siblings that is **not** principled: it is a block-level disclosure,
+         * so `tint`, `bg`, `width`, `elevation` and the rest would all mean
+         * something on it. It reads as legacy — a hand-written schema that predates
+         * the universal set. Recorded as `none` rather than quietly inheriting the
+         * gap; giving it the block axes means migrating it to
+         * `createContentModelSchema`, which WORK-534 scopes out. */
+        Expand: { block: 'expand', universalAttributes: 'none' },
         /* Badge emits a complete `<span class="rf-badge" data-rune="badge">`
          * directly from its schema and needs no engine post-processing, but
          * still needs an entry in the theme config so `computeUsedCssBlocks`
          * includes `badge.css` in CSS tree-shaking when a badge is rendered. */
-        Badge: { block: 'badge' },
+        /* SPEC-125 Phase 3 — an inline span; the block axes have nothing to act on. */
+        Badge: { block: 'badge', universalAttributes: 'inline' },
         /* SPEC-079 composable rune handles — render the same DOM as the
          * engine's `split` / `definition-list` layout primitives. CSS comes
          * from the universal `[data-zone-layout=…]` selectors; per-rune
@@ -164,7 +208,8 @@ export const coreConfig = {
                 height: { source: 'meta', noBemClass: true },
                 aspect: { source: 'meta', noBemClass: true },
             },
-            sections: { media: 'media' },
+            sections: cardSections,
+            provides: ['prose'],
             // SPEC-081/091: the transform emits flat slots; `layout` builds the
             // skeleton — media beside a `content` wrapper grouping eyebrow/body/
             // footer. A base `layout` is the prerequisite for the cover variant
@@ -213,7 +258,8 @@ export const coreConfig = {
         Blog: {
             block: 'blog',
             defaultDensity: 'full',
-            sections: { preamble: 'preamble', headline: 'title', blurb: 'description', content: 'body' },
+            sections: blogSections,
+            provides: ['prose'],
             contentWrapper: { tag: 'div', ref: 'content' },
             modifiers: {
                 layout: { source: 'meta', default: 'list' },
@@ -229,7 +275,7 @@ export const coreConfig = {
             block: 'budget',
             defaultDensity: 'full',
             defaultElevation: 'flat',
-            sections: { preamble: 'preamble', headline: 'title', footer: 'footer' },
+            sections: budgetSections,
             editHints: { headline: 'inline' },
             modifiers: {
                 currency: { source: 'meta', default: 'USD' },
@@ -273,7 +319,7 @@ export const coreConfig = {
             defaultElevation: 'sunken',
             modifiers: { hintType: { source: 'meta', default: 'note' } },
             contextModifiers: { 'hero': 'in-hero', 'feature': 'in-feature' },
-            sections: { header: 'header' },
+            sections: hintSections,
             // SPEC-035 Zone 6 — the hintType value doubles as the visible title
             // (CSS capitalizes it). Declaring it as an enum lets `core.hint.<value>`
             // localize the title; the raw value stays the English fallback.
@@ -297,7 +343,8 @@ export const coreConfig = {
                 size: { source: 'meta', default: 'md' },
                 shortcut: { source: 'meta', noBemClass: true },
             },
-            sections: { header: 'header', body: 'body', footer: 'footer' },
+            sections: drawerSections,
+            provides: ['prose'],
             editHints: { title: 'inline', body: 'none', close: 'none', footer: 'none' },
         },
         Figure: {
@@ -306,12 +353,12 @@ export const coreConfig = {
             defaultElevation: 'flat',
             // SPEC-086 — a figure *is* a frame around its image, so `frame` chrome
             // targets the figure's own root (its body is the media).
-            frameTarget: 'self',
+            frameTarget: figureFrameTarget,
             modifiers: {
                 size: { source: 'meta', default: 'default' },
                 align: { source: 'meta', default: 'center' },
             },
-            sections: { caption: 'description' },
+            sections: figureSections,
             editHints: { caption: 'inline' },
         },
         Gallery: {
@@ -335,7 +382,8 @@ export const coreConfig = {
             defaultElevation: 'flush',
             defaultReading: 'fine',
             modifiers: { variant: { source: 'meta', default: 'sidenote' } },
-            sections: { body: 'body' },
+            sections: sidenoteSections,
+            provides: ['prose'],
             editHints: { body: 'inline' },
         },
         Compare: {
@@ -356,7 +404,8 @@ export const coreConfig = {
             defaultDensity: 'full',
             defaultElevation: 'flush',
             modifiers: { variant: { source: 'meta', default: 'margin' } },
-            sections: { body: 'body' },
+            sections: annotateSections,
+            provides: ['prose'],
             editHints: { body: 'none', notes: 'none' },
         },
         AnnotateNote: { block: 'annotate-note', parent: 'Annotate', editHints: { body: 'inline' } },
@@ -445,7 +494,8 @@ export const coreConfig = {
                 align: { source: 'meta', default: 'center' },
                 variant: { source: 'meta', default: 'default' },
             },
-            sections: { body: 'body' },
+            sections: pullQuoteSections,
+            provides: ['prose'],
             editHints: { body: 'inline' },
         },
         TextBlock: {
@@ -458,7 +508,8 @@ export const coreConfig = {
                 lead: { source: 'meta' },
                 align: { source: 'meta', default: 'left' },
             },
-            sections: { body: 'body' },
+            sections: textBlockSections,
+            provides: ['prose'],
             editHints: { body: 'none' },
         },
         MediaText: {
@@ -469,27 +520,28 @@ export const coreConfig = {
                 ratio: { source: 'meta', default: '1:1' },
                 wrap: { source: 'meta' },
             },
-            sections: { body: 'body', media: 'media' },
-            mediaSlots: { media: 'cover' },
+            sections: mediaTextSections,
+            provides: ['prose'],
+            mediaSlots: mediaTextMediaSlots,
             editHints: { media: 'image', body: 'none' },
         },
         Showcase: {
             block: 'showcase',
             defaultDensity: 'compact',
             childDensity: 'compact',
-            sections: { viewport: 'body' },
+            sections: showcaseSections,
             // SPEC-086 — showcase is the degenerate `frameTarget: 'self'` case: its
             // body *is* the media, so `frame` chrome lands on its own root. Its old
             // shadow/bleed/aspect/offset/place attributes are deprecated aliases for
             // `frame-*` facets (mapped + warned in showcase.ts); breakout (a
             // displaced guest spilling past a clipping ancestor) is its distinct
             // value, retained via the host-owned-clip CSS.
-            frameTarget: 'self',
+            frameTarget: showcaseFrameTarget,
             contextModifiers: { 'bento-cell': 'in-bento-cell' },
             editHints: { viewport: 'none' },
         },
         // ─── Interactive runes (still get BEM classes, components add behavior) ───
-        TabGroup: { block: 'tabs', interactive: true, defaultDensity: 'full', sections: { preamble: 'preamble', headline: 'title', blurb: 'description' }, autoLabel: pageSectionAutoLabel, editHints: { headline: 'inline', eyebrow: 'inline', blurb: 'inline' } },
+        TabGroup: { block: 'tabs', interactive: true, defaultDensity: 'full', sections: tabGroupSections, autoLabel: pageSectionAutoLabel, editHints: { headline: 'inline', eyebrow: 'inline', blurb: 'inline' } },
         Tab: { block: 'tab', parent: 'TabGroup', requiresParent: 'TabGroup', rootAttributes: { 'data-state': 'inactive' }, editHints: { name: 'inline' } },
         TabPanel: { block: 'tab-panel', parent: 'TabGroup', requiresParent: 'TabGroup', rootAttributes: { 'data-state': 'inactive' } },
         DataTable: {
@@ -497,7 +549,7 @@ export const coreConfig = {
             interactive: true,
             defaultDensity: 'compact',
             defaultElevation: 'sunken',
-            sections: { table: 'body' },
+            sections: dataTableSections,
             modifiers: {
                 searchable: { source: 'meta', default: 'false' },
                 sortable: { source: 'meta' },
@@ -511,7 +563,7 @@ export const coreConfig = {
             interactive: true,
             defaultDensity: 'full',
             defaultElevation: 'flat',
-            sections: { body: 'body' },
+            sections: formSections,
             modifiers: {
                 variant: { source: 'meta', default: 'stacked' },
                 action: { source: 'meta' },
@@ -536,7 +588,7 @@ export const coreConfig = {
             modifiers: {
                 mode: { source: 'meta', default: 'click' },
             },
-            sections: { preamble: 'preamble', headline: 'title', blurb: 'description' },
+            sections: revealSections,
             autoLabel: pageSectionAutoLabel,
             editHints: { headline: 'inline', eyebrow: 'inline', blurb: 'inline', steps: 'none' },
         },
@@ -546,7 +598,7 @@ export const coreConfig = {
             modifiers: {
                 align: { source: 'meta', default: 'start' },
             },
-            sections: { preamble: 'preamble', headline: 'title', blurb: 'description' },
+            sections: sectionSections,
             autoLabel: pageSectionAutoLabel,
             editHints: { headline: 'inline', eyebrow: 'inline', blurb: 'inline', body: 'none' },
         },
@@ -578,8 +630,11 @@ export const coreConfig = {
                 language: { source: 'meta', default: 'mermaid', noBemClass: true },
             },
         },
-        Tint: { block: 'tint', parent: '*' },
-        Bg: { block: 'bg', parent: '*' },
+        /* SPEC-125 Phase 3 — configurator runes: they *supply* an axis value to the
+         * parent rather than carrying one. A `{% tint %}` with its own `tint=` is
+         * circular. */
+        Tint: { block: 'tint', parent: '*', universalAttributes: 'configurator' },
+        Bg: { block: 'bg', parent: '*', universalAttributes: 'configurator' },
         Region: { block: 'region', parent: 'Layout' },
         Sandbox: {
             block: 'sandbox',