@refrakt-md/runes 0.32.0 → 0.34.0

package/dist/index.js

@@ -1,11 +1,12 @@
-import { heading, paragraph, fence, list, item, em, strong, text, link, hardbreak, image, table, td } from './nodes.js';
+import { heading, paragraph, fence, list, item, em, strong, text, link, hardbreak, image, table, td, } from './nodes.js';
 export { Page } from './documents/page.js';
 import { DocPage } from './documents/doc.js';
-import { error } from './tags/error.js';
 import { grid } from './tags/grid.js';
 import { codegroup } from './tags/codegroup.js';
 import { snippet } from './tags/snippet.js';
 import { data } from './tags/data.js';
+import { include } from './tags/include.js';
+import { code } from './tags/code.js';
 import { hint } from './tags/hint.js';
 import { tab, tabs } from './tags/tabs.js';
 import { nav } from './tags/nav.js';
@@ -61,18 +62,24 @@ import Markdoc from '@markdoc/markdoc';
 import { defineRune, runeTagMap } from './rune.js';
 export * from './interfaces.js';
 export { Rune, defineRune, runeTagMap } from './rune.js';
+/** Custom Markdoc attribute types. Exported since SPEC-132, which is the first
+ *  release in which their `validate()` runs in a build at all — `transform()`
+ *  never invoked it, only `Markdoc.validate()` does. `plugins/media` carries its
+ *  own copies of these classes, which is what an unexported utility tends to
+ *  produce. */
+export { SeparatedString, CommaSeparatedList, SpaceSeparatedList, SpaceSeparatedNumberList, } from './attributes.js';
 export { RenderableNodeCursor } from './lib/renderable.js';
-export { createContentModelSchema, createComponentRenderable, asNodes, schemaContentModels, schemaRuneStructures, declareUniversalPosture, sanitizeSandboxContent } from './lib/index.js';
+export { createContentModelSchema, createComponentRenderable, asNodes, schemaContentModels, schemaRuneStructures, declareUniversalPosture, sanitizeSandboxContent, } from './lib/index.js';
 // SPEC-125 Phase 3 — the declared rule for universal-attribute availability
-export { resolveUniversalAttributes, AXIS_ATTRIBUTES, POSTURE_REASONS } from './universal-attributes.js';
+export { resolveUniversalAttributes, AXIS_ATTRIBUTES, POSTURE_REASONS, } from './universal-attributes.js';
 export { describeSchemaUniversals, UNRECORDED_REASON } from './schema-universals.js';
-export { resolve, resolveSequence, resolveDelimited, resolveContentModel, resolveListItems, evaluateCondition, matchesType } from './lib/resolver.js';
+export { resolve, resolveSequence, resolveDelimited, resolveContentModel, resolveListItems, evaluateCondition, matchesType, } from './lib/resolver.js';
 export { registerImageScheme, resolveImageScheme, hasImageScheme } from './lib/image-schemes.js';
 export { resolveIcon, splitIconName } from './lib/icon-resolve.js';
-export { placeholderSvg, PLACEHOLDER_SHAPES, DEFAULT_PLACEHOLDER_SHAPE } from './lib/placeholder.js';
+export { placeholderSvg, PLACEHOLDER_SHAPES, DEFAULT_PLACEHOLDER_SHAPE, } from './lib/placeholder.js';
 export { FIXTURE_ROLES, splitFixture, parseFixtureFilename, validateFixtureFrontmatter, parseFixture, } from './fixtures.js';
-export { parseFieldMatch, matchesFieldMatch, matchesFilterExpr, resolveEntityField } from './field-match.js';
-export { DEFERRED_BODY_ATTR, captureDeferredBodies, readDeferredBody, transformDeferredTemplate } from './deferred-body.js';
+export { parseFieldMatch, matchesFieldMatch, matchesFilterExpr, resolveEntityField, } from './field-match.js';
+export { DEFERRED_BODY_ATTR, captureDeferredBodies, readDeferredBody, transformDeferredTemplate, } from './deferred-body.js';
 export { resolveCollections } from './collection-resolve.js';
 export { resolveRelationships } from './relationships-resolve.js';
 export { resolveAggregates } from './aggregate-resolve.js';
@@ -86,8 +93,8 @@ export { hoistPreviewDrawers, registerHoistBuilder, getHoistBuilder, pathToSlug,
 export { Ordering, buildOrdering, sortEntities, groupEntities, groupBy, entityUrl, entityTitle, fieldValue, titleLink, projectItem, renderItemTemplate, } from './collection-helpers.js';
 export { COLLECTION_SENTINEL } from './tags/collection.js';
 export { functions, currency, date, number, join, concat, humanize } from './functions.js';
-export { linkItem, pageSectionProperties, buildLayoutMetas, splitMediaBodyFooter, extractMediaImage, unwrapParagraphImages, isMediaNode, isSchemeMediaNode, name as nameHelper, description as descriptionHelper, SplitablePageSectionModel, SplitLayoutModel, splitLayoutAttributes } from './tags/common.js';
-export { extractHeadings, firstH1, headingsToList } from './util.js';
+export { linkItem, pageSectionProperties, buildLayoutMetas, splitMediaBodyFooter, extractMediaImage, unwrapParagraphImages, isMediaNode, isSchemeMediaNode, name as nameHelper, description as descriptionHelper, SplitablePageSectionModel, SplitLayoutModel, splitLayoutAttributes, } from './tags/common.js';
+export { extractHeadings, firstH1, headingsToList, headingSlug, headingText, renderableText, } from './util.js';
 export { LANG_MAP, FALLBACK_LANG, inferLanguage } from './lang-map.js';
 export { extractSeo, collectJsonLd, textContent } from './seo.js';
 export { serialize, serializeTree } from './serialize.js';
@@ -95,9 +102,9 @@ export { RUNE_EXAMPLES, RUNE_FIXTURE_META } from './examples.js';
 export { describeRune, renderContentModel, serializeContentModel, stripContentModel, hydrateRuneInfo, hydrateAllRuneInfos, hydrateRuneByName, serializeRune, groupReferenceInfos, renderReferenceMarkdown, EXCLUDED_RUNES, HIDDEN_ATTRIBUTES, } from './reference.js';
 export { registerAttributePreset, lookupAttributePreset, schemaBasePresets, UNIVERSAL_ATTRIBUTE_NAMES, } from './attribute-presets.js';
 export { LAYOUT, CANONICAL_LAYOUTS, layoutMatches } from './layout-vocabulary.js';
-export { READING_REGISTERS, DEFAULT_READING, READING_CAPABILITIES, resolveReading, coerceRegister } from '@refrakt-md/transform';
-export { loadPlugin, mergePlugins, applyAliases, loadLocalRunes, discoverPluginFixtures, discoverPluginFixtureManifest, assertFileRootNamespaceAllowed } from './plugins.js';
-export { coreConfig, baseConfig, corePipelineHooks, createCorePipelineHooks, resolveCoreSentinels } from './config.js';
+export { READING_REGISTERS, DEFAULT_READING, READING_CAPABILITIES, resolveReading, coerceRegister, } from '@refrakt-md/transform';
+export { loadPlugin, mergePlugins, applyAliases, loadLocalRunes, discoverPluginFixtures, discoverPluginFixtureManifest, assertFileRootNamespaceAllowed, } from './plugins.js';
+export { coreConfig, baseConfig, corePipelineHooks, createCorePipelineHooks, resolveCoreSentinels, } from './config.js';
 // SPEC-035 — first-party core translation bundles (generated from i18n/*.json).
 export { coreTranslations } from './translations.generated.js';
 export { BREADCRUMB_AUTO_SENTINEL } from './tags/breadcrumb.js';
@@ -118,7 +125,14 @@ export const runes = {
         description: 'Navigation structure with page slug references and optional grouping',
         typeName: 'Nav',
         category: 'Site',
-        snippet: ['{% nav %}', '## ${1:Section}', '', '- ${2:page-slug}', '- ${3:another-page}', '{% /nav %}'],
+        snippet: [
+            '{% nav %}',
+            '## ${1:Section}',
+            '',
+            '- ${2:page-slug}',
+            '- ${3:another-page}',
+            '{% /nav %}',
+        ],
     }),
     region: defineRune({
         name: 'region',
@@ -131,7 +145,13 @@ export const runes = {
         schema: layout,
         description: 'Layout definition containing named regions',
         category: 'Site',
-        snippet: ['{% layout %}', '{% region name="${1:header}" %}', '$0', '{% /region %}', '{% /layout %}'],
+        snippet: [
+            '{% layout %}',
+            '{% region name="${1:header}" %}',
+            '$0',
+            '{% /region %}',
+            '{% /layout %}',
+        ],
     }),
     codegroup: defineRune({
         name: 'codegroup',
@@ -139,14 +159,17 @@ export const runes = {
         description: 'Tabbed code block with language tabs',
         typeName: 'CodeGroup',
         category: 'Code & Data',
-        snippet: ['{% codegroup %}', '```${1:js}', '$0', '```', '', '```${2:ts}', '', '```', '{% /codegroup %}'],
-    }),
-    error: defineRune({
-        name: 'error',
-        schema: error,
-        description: 'Error reporting table',
-        typeName: 'Error',
-        category: 'Semantic',
+        snippet: [
+            '{% codegroup %}',
+            '```${1:js}',
+            '$0',
+            '```',
+            '',
+            '```${2:ts}',
+            '',
+            '```',
+            '{% /codegroup %}',
+        ],
     }),
     grid: defineRune({
         name: 'grid',
@@ -155,7 +178,15 @@ export const runes = {
         description: 'Grid layout container with configurable columns and rows',
         typeName: 'Grid',
         category: 'Layout',
-        snippet: ['{% grid columns=${1:2} %}', '${2:First column content}', '', '---', '', '${3:Second column content}', '{% /grid %}'],
+        snippet: [
+            '{% grid columns=${1:2} %}',
+            '${2:First column content}',
+            '',
+            '---',
+            '',
+            '${3:Second column content}',
+            '{% /grid %}',
+        ],
     }),
     hint: defineRune({
         name: 'hint',
@@ -178,7 +209,17 @@ export const runes = {
         description: 'Tabbed interface with tab panels',
         typeName: 'TabGroup',
         category: 'Layout',
-        snippet: ['{% tabs %}', '## ${1:Tab One}', '', '${2:Content for tab one.}', '', '## ${3:Tab Two}', '', '${4:Content for tab two.}', '{% /tabs %}'],
+        snippet: [
+            '{% tabs %}',
+            '## ${1:Tab One}',
+            '',
+            '${2:Content for tab one.}',
+            '',
+            '## ${3:Tab Two}',
+            '',
+            '${4:Content for tab two.}',
+            '{% /tabs %}',
+        ],
     }),
     details: defineRune({
         name: 'details',
@@ -194,25 +235,43 @@ export const runes = {
         description: 'Modal side panel addressed by id. Triggered by xrefs anywhere on the page; falls back to in-flow rendering without JS.',
         typeName: 'Drawer',
         category: 'Layout',
-        snippet: ['{% drawer id="${1:auth-explainer}" title="${2:Auth system}" %}', '$0', '{% /drawer %}'],
+        snippet: [
+            '{% drawer id="${1:auth-explainer}" title="${2:Auth system}" %}',
+            '$0',
+            '{% /drawer %}',
+        ],
     }),
     figure: defineRune({
         name: 'figure',
         schema: figure,
         description: 'Enhanced image with caption, attribution, and sizing',
         seoType: 'ImageObject',
-        typeName: 'Figure', schemaOrgType: 'ImageObject',
+        typeName: 'Figure',
+        schemaOrgType: 'ImageObject',
         category: 'Content',
-        snippet: ['{% figure size="${1|medium,small,large,full|}" %}', '![${2:Alt text}](${3:/path/to/image.png})', '', '${4:Caption text}', '{% /figure %}'],
+        snippet: [
+            '{% figure size="${1|medium,small,large,full|}" %}',
+            '![${2:Alt text}](${3:/path/to/image.png})',
+            '',
+            '${4:Caption text}',
+            '{% /figure %}',
+        ],
     }),
     gallery: defineRune({
         name: 'gallery',
         schema: gallery,
         description: 'Multi-image container with grid, carousel, or masonry layout and optional lightbox',
         seoType: 'ImageGallery',
-        typeName: 'Gallery', schemaOrgType: 'ImageGallery',
+        typeName: 'Gallery',
+        schemaOrgType: 'ImageGallery',
         category: 'Content',
-        snippet: ['{% gallery layout="${1|grid,carousel,masonry|}" %}', '![${2:Alt text}](${3:/path/to/image1.png})', '', '![${4:Alt text}](${5:/path/to/image2.png})', '{% /gallery %}'],
+        snippet: [
+            '{% gallery layout="${1|grid,carousel,masonry|}" %}',
+            '![${2:Alt text}](${3:/path/to/image1.png})',
+            '',
+            '![${4:Alt text}](${5:/path/to/image2.png})',
+            '{% /gallery %}',
+        ],
     }),
     accordion: defineRune({
         name: 'accordion',
@@ -220,15 +279,27 @@ export const runes = {
         schema: accordion,
         description: 'Collapsible accordion sections where headings become toggleable headers',
         seoType: 'FAQPage',
-        typeName: 'Accordion', schemaOrgType: 'FAQPage',
+        typeName: 'Accordion',
+        schemaOrgType: 'FAQPage',
         category: 'Layout',
-        snippet: ['{% accordion %}', '## ${1:First Question}', '', '${2:Answer to the first question.}', '', '## ${3:Second Question}', '', '${4:Answer to the second question.}', '{% /accordion %}'],
+        snippet: [
+            '{% accordion %}',
+            '## ${1:First Question}',
+            '',
+            '${2:Answer to the first question.}',
+            '',
+            '## ${3:Second Question}',
+            '',
+            '${4:Answer to the second question.}',
+            '{% /accordion %}',
+        ],
     }),
     'accordion-item': defineRune({
         name: 'accordion-item',
         schema: accordionItem,
         description: 'Individual accordion section',
-        typeName: 'AccordionItem', schemaOrgType: 'Question',
+        typeName: 'AccordionItem',
+        schemaOrgType: 'Question',
     }),
     toc: defineRune({
         name: 'toc',
@@ -244,7 +315,8 @@ export const runes = {
         schema: embed,
         description: 'Embedded content from external services (YouTube, Twitter, CodePen, Spotify)',
         seoType: 'VideoObject',
-        typeName: 'Embed', schemaOrgType: 'VideoObject',
+        typeName: 'Embed',
+        schemaOrgType: 'VideoObject',
         category: 'Content',
         snippet: ['{% embed url="${1:https://}" /%}'],
     }),
@@ -253,7 +325,8 @@ export const runes = {
         schema: breadcrumb,
         description: 'Navigation breadcrumb trail showing page hierarchy',
         seoType: 'BreadcrumbList',
-        typeName: 'Breadcrumb', schemaOrgType: 'BreadcrumbList',
+        typeName: 'Breadcrumb',
+        schemaOrgType: 'BreadcrumbList',
         category: 'Site',
         snippet: ['{% breadcrumb /%}'],
     }),
@@ -270,9 +343,17 @@ export const runes = {
         schema: budget,
         description: 'Structured cost breakdown with categories, line items, and auto-calculated totals',
         seoType: 'ItemList',
-        typeName: 'Budget', schemaOrgType: 'ItemList',
+        typeName: 'Budget',
+        schemaOrgType: 'ItemList',
         category: 'Semantic',
-        snippet: ['{% budget %}', '## ${1:Category}', '', '- ${2:Item description}: \\$${3:100}', '- ${4:Another item}: \\$${5:200}', '{% /budget %}'],
+        snippet: [
+            '{% budget %}',
+            '## ${1:Category}',
+            '',
+            '- ${2:Item description}: \\$${3:100}',
+            '- ${4:Another item}: \\$${5:200}',
+            '{% /budget %}',
+        ],
     }),
     'budget-category': defineRune({
         name: 'budget-category',
@@ -292,7 +373,17 @@ export const runes = {
         description: 'Side-by-side code comparison with labeled panels',
         typeName: 'Compare',
         category: 'Code & Data',
-        snippet: ['{% compare %}', '```${1:js}', '${2:// Before}', '```', '', '```${3:js}', '${4:// After}', '```', '{% /compare %}'],
+        snippet: [
+            '{% compare %}',
+            '```${1:js}',
+            '${2:// Before}',
+            '```',
+            '',
+            '```${3:js}',
+            '${4:// After}',
+            '```',
+            '{% /compare %}',
+        ],
     }),
     datatable: defineRune({
         name: 'datatable',
@@ -300,9 +391,16 @@ export const runes = {
         schema: datatable,
         description: 'Interactive data table with sorting, filtering, and pagination from a Markdown table',
         seoType: 'Dataset',
-        typeName: 'DataTable', schemaOrgType: 'Dataset',
+        typeName: 'DataTable',
+        schemaOrgType: 'Dataset',
         category: 'Code & Data',
-        snippet: ['{% datatable %}', '| ${1:Column A} | ${2:Column B} | ${3:Column C} |', '|---|---|---|', '| ${4:Data} | ${5:Data} | ${6:Data} |', '{% /datatable %}'],
+        snippet: [
+            '{% datatable %}',
+            '| ${1:Column A} | ${2:Column B} | ${3:Column C} |',
+            '|---|---|---|',
+            '| ${4:Data} | ${5:Data} | ${6:Data} |',
+            '{% /datatable %}',
+        ],
     }),
     diff: defineRune({
         name: 'diff',
@@ -310,7 +408,17 @@ export const runes = {
         description: 'Side-by-side or unified diff view between two code blocks',
         typeName: 'Diff',
         category: 'Code & Data',
-        snippet: ['{% diff %}', '```${1:js}', '${2:// Before}', '```', '', '```${3:js}', '${4:// After}', '```', '{% /diff %}'],
+        snippet: [
+            '{% diff %}',
+            '```${1:js}',
+            '${2:// Before}',
+            '```',
+            '',
+            '```${3:js}',
+            '${4:// After}',
+            '```',
+            '{% /diff %}',
+        ],
     }),
     snippet: defineRune({
         name: 'snippet',
@@ -328,13 +436,36 @@ export const runes = {
         category: 'Code & Data',
         snippet: ['{% data src="${1:data/revenue.csv}" /%}'],
     }),
+    code: defineRune({
+        name: 'code',
+        schema: code,
+        description: 'Inline code span for dynamic content. Backticks are literal by definition, so a variable inside them never resolves; this renders the same `<code>` and does (WORK-551).',
+        typeName: 'Code',
+        category: 'Code & Data',
+        snippet: ['{% code %}${1:value}{% /code %}'],
+    }),
+    include: defineRune({
+        name: 'include',
+        schema: include,
+        description: "Paste a partial's AST into the page before the preprocess phase, so `data` and `snippet` inside it resolve — the case `{% partial %}` cannot serve. Reads the same `_partials/` and file roots (SPEC-129).",
+        typeName: 'Include',
+        category: 'Code & Data',
+        snippet: ['{% include file="${1:shared-block.md}" /%}'],
+    }),
     chart: defineRune({
         name: 'chart',
         schema: chart,
         description: 'Chart visualization from a Markdown table. First column becomes axis labels, header row becomes series names.',
         typeName: 'Chart',
         category: 'Code & Data',
-        snippet: ['{% chart type="${1|bar,line,pie,area|}" %}', '| ${2:Label} | ${3:Series A} | ${4:Series B} |', '|---|---|---|', '| ${5:Item 1} | ${6:10} | ${7:20} |', '| ${8:Item 2} | ${9:30} | ${10:15} |', '{% /chart %}'],
+        snippet: [
+            '{% chart type="${1|bar,line,pie,area|}" %}',
+            '| ${2:Label} | ${3:Series A} | ${4:Series B} |',
+            '|---|---|---|',
+            '| ${5:Item 1} | ${6:10} | ${7:20} |',
+            '| ${8:Item 2} | ${9:30} | ${10:15} |',
+            '{% /chart %}',
+        ],
     }),
     diagram: defineRune({
         name: 'diagram',
@@ -342,7 +473,13 @@ export const runes = {
         description: 'Diagram rendering from Mermaid, PlantUML, or ASCII art code blocks',
         typeName: 'Diagram',
         category: 'Code & Data',
-        snippet: ['{% diagram language="${1|mermaid,plantuml,ascii|}" %}', '```${1:mermaid}', '$0', '```', '{% /diagram %}'],
+        snippet: [
+            '{% diagram language="${1|mermaid,plantuml,ascii|}" %}',
+            '```${1:mermaid}',
+            '$0',
+            '```',
+            '{% /diagram %}',
+        ],
     }),
     sidenote: defineRune({
         name: 'sidenote',
@@ -360,7 +497,13 @@ export const runes = {
         description: 'Chat/dialogue display where blockquotes become alternating speaker messages',
         typeName: 'Conversation',
         category: 'Semantic',
-        snippet: ['{% conversation %}', '> **${1:Alice}**: ${2:Hello!}', '', '> **${3:Bob}**: ${4:Hi there!}', '{% /conversation %}'],
+        snippet: [
+            '{% conversation %}',
+            '> **${1:Alice}**: ${2:Hello!}',
+            '',
+            '> **${3:Bob}**: ${4:Hi there!}',
+            '{% /conversation %}',
+        ],
     }),
     'conversation-message': defineRune({
         name: 'conversation-message',
@@ -374,7 +517,17 @@ export const runes = {
         description: 'Progressive disclosure where headings become reveal steps shown one at a time',
         typeName: 'Reveal',
         category: 'Layout',
-        snippet: ['{% reveal %}', '## ${1:Step One}', '', '${2:Content revealed first.}', '', '## ${3:Step Two}', '', '${4:Content revealed next.}', '{% /reveal %}'],
+        snippet: [
+            '{% reveal %}',
+            '## ${1:Step One}',
+            '',
+            '${2:Content revealed first.}',
+            '',
+            '## ${3:Step Two}',
+            '',
+            '${4:Content revealed next.}',
+            '{% /reveal %}',
+        ],
     }),
     'reveal-step': defineRune({
         name: 'reveal-step',
@@ -388,7 +541,17 @@ export const runes = {
         description: 'A generic page section: an eyebrow/headline/blurb header above arbitrary body content',
         typeName: 'Section',
         category: 'Layout',
-        snippet: ['{% section %}', 'Eyebrow', '', '## ${1:Section title}', '', '${2:A short supporting blurb.}', '', '${3:Body content — a bento, cards, anything.}', '{% /section %}'],
+        snippet: [
+            '{% section %}',
+            'Eyebrow',
+            '',
+            '## ${1:Section title}',
+            '',
+            '${2:A short supporting blurb.}',
+            '',
+            '${3:Body content — a bento, cards, anything.}',
+            '{% /section %}',
+        ],
     }),
     juxtapose: defineRune({
         name: 'juxtapose',
@@ -403,7 +566,17 @@ export const runes = {
         description: 'Content with margin annotations. Nested note tags appear as margin notes alongside the main text.',
         typeName: 'Annotate',
         category: 'Layout',
-        snippet: ['{% annotate %}', '${1:Main content here.}', '', '{% note %}', '${2:Margin note content.}', '{% /note %}', '', '${3:More main content.}', '{% /annotate %}'],
+        snippet: [
+            '{% annotate %}',
+            '${1:Main content here.}',
+            '',
+            '{% note %}',
+            '${2:Margin note content.}',
+            '{% /note %}',
+            '',
+            '${3:More main content.}',
+            '{% /annotate %}',
+        ],
     }),
     note: defineRune({
         name: 'note',
@@ -418,7 +591,15 @@ export const runes = {
         description: 'Accessible HTML form from Markdown. Lists become input fields with smart type inference, blockquotes followed by lists become select/radio/checkbox groups.',
         typeName: 'Form',
         category: 'Content',
-        snippet: ['{% form action="${1:/api/contact}" %}', '- Name', '- Email', '- Message', '', '**${2:Submit}**', '{% /form %}'],
+        snippet: [
+            '{% form action="${1:/api/contact}" %}',
+            '- Name',
+            '- Email',
+            '- Message',
+            '',
+            '**${2:Submit}**',
+            '{% /form %}',
+        ],
     }),
     'form-field': defineRune({
         name: 'form-field',
@@ -432,7 +613,11 @@ export const runes = {
         description: 'Isolated HTML/CSS/JS rendering in an iframe with optional framework loading',
         typeName: 'Sandbox',
         category: 'Code & Data',
-        snippet: ['{% sandbox framework="${1|,tailwind,bootstrap,bulma,pico|}" %}', '$0', '{% /sandbox %}'],
+        snippet: [
+            '{% sandbox framework="${1|,tailwind,bootstrap,bulma,pico|}" %}',
+            '$0',
+            '{% /sandbox %}',
+        ],
     }),
     pullquote: defineRune({
         name: 'pullquote',
@@ -441,7 +626,11 @@ export const runes = {
         description: 'Decorative pull quote for magazine-style emphasis with float and block modes',
         typeName: 'PullQuote',
         category: 'Content',
-        snippet: ['{% pullquote variant="${1|default,accent,editorial|}" %}', '> ${2:Quote text to emphasize.}', '{% /pullquote %}'],
+        snippet: [
+            '{% pullquote variant="${1|default,accent,editorial|}" %}',
+            '> ${2:Quote text to emphasize.}',
+            '{% /pullquote %}',
+        ],
     }),
     textblock: defineRune({
         name: 'textblock',
@@ -450,7 +639,11 @@ export const runes = {
         description: 'Text formatting block with drop caps, multi-column layout, lead paragraphs, and alignment control',
         typeName: 'TextBlock',
         category: 'Content',
-        snippet: ['{% textblock dropcap %}', '${1:Formatted text content with drop cap styling.}', '{% /textblock %}'],
+        snippet: [
+            '{% textblock dropcap %}',
+            '${1:Formatted text content with drop cap styling.}',
+            '{% /textblock %}',
+        ],
     }),
     mediatext: defineRune({
         name: 'mediatext',
@@ -459,7 +652,13 @@ export const runes = {
         description: 'Image and text side by side with configurable ratio and optional text wrapping',
         typeName: 'MediaText',
         category: 'Layout',
-        snippet: ['{% mediatext align="${1|left,right|}" ratio="${2|1:1,1:2,2:1|}" %}', '![${3:Alt text}](${4:/path/to/image.png})', '', '${5:Text content displayed alongside the image.}', '{% /mediatext %}'],
+        snippet: [
+            '{% mediatext align="${1|left,right|}" ratio="${2|1:1,1:2,2:1|}" %}',
+            '![${3:Alt text}](${4:/path/to/image.png})',
+            '',
+            '${5:Text content displayed alongside the image.}',
+            '{% /mediatext %}',
+        ],
     }),
     icon: defineRune({
         name: 'icon',
@@ -473,7 +672,13 @@ export const runes = {
         schema: tint,
         description: 'Section-level colour override via CSS custom properties. Declared as first child of a block rune.',
         typeName: 'Tint',
-        snippet: ['{% tint %}', '- background: ${1:#1a1a2e}', '- primary: ${2:#e94560}', '- accent: ${3:#0f3460}', '{% /tint %}'],
+        snippet: [
+            '{% tint %}',
+            '- background: ${1:#1a1a2e}',
+            '- primary: ${2:#e94560}',
+            '- accent: ${3:#0f3460}',
+            '{% /tint %}',
+        ],
     }),
     showcase: defineRune({
         name: 'showcase',
@@ -495,7 +700,8 @@ export const runes = {
         schema: blog,
         description: 'Blog post listing with filtering, sorting, and multiple layouts. Displays pages from a content folder as a navigable blog index.',
         seoType: 'Blog',
-        typeName: 'Blog', schemaOrgType: 'Blog',
+        typeName: 'Blog',
+        schemaOrgType: 'Blog',
         category: 'Semantic',
     }),
     xref: defineRune({
@@ -507,7 +713,7 @@ export const runes = {
     expand: defineRune({
         name: 'expand',
         schema: expand,
-        description: 'Substitute a registered entity\'s source content inline. Reads the entity\'s sourceFile via the plan plugin (or any plugin that registers extractable entities) and inlines it. Symmetric with `xref`: same lookup chain, different output (content rather than a link).',
+        description: "Substitute a registered entity's source content inline. Reads the entity's sourceFile via the plan plugin (or any plugin that registers extractable entities) and inlines it. Symmetric with `xref`: same lookup chain, different output (content rather than a link).",
         typeName: 'Expand',
         category: 'Content',
         snippet: ['{% expand "${1:SPEC-001}" /%}'],
@@ -518,7 +724,11 @@ export const runes = {
         description: 'Inline pill that flags a piece of content (status, category, recency, tag). Visual variant from the universal metadata-system dimensions (sentiment, rank, type).',
         typeName: 'Badge',
         category: 'Content',
-        snippet: ['{% badge sentiment="${1|positive,negative,caution,neutral|}" %}', '${2:Label}', '{% /badge %}'],
+        snippet: [
+            '{% badge sentiment="${1|positive,negative,caution,neutral|}" %}',
+            '${2:Label}',
+            '{% /badge %}',
+        ],
     }),
     bar: defineRune({
         name: 'bar',
@@ -535,7 +745,12 @@ export const runes = {
         description: 'Block-level wrapper that renders the SPEC-079 definition-list layout primitive over a markdown list. Each `- **Term:** value` item becomes a <dt>/<dd> pair. Inline runes compose naturally inside <dd>.',
         typeName: 'Deflist',
         category: 'Content',
-        snippet: ['{% deflist %}', '- **${1:Term}:** ${2:Value}', '- **${3:Term}:** ${4:Value}', '{% /deflist %}'],
+        snippet: [
+            '{% deflist %}',
+            '- **${1:Term}:** ${2:Value}',
+            '- **${3:Term}:** ${4:Value}',
+            '{% /deflist %}',
+        ],
     }),
     collection: defineRune({
         name: 'collection',
@@ -567,7 +782,9 @@ export const runes = {
         description: 'Path-based inline reference to a project file — third member of the Registry family beside `xref` (id → link) and `expand` (id → inlined content). Resolves to a deep-link `<a>` pointing at `{repoUrl}/blob/{repoBranch}/{path}#L{start}-L{end}` on GitHub. With `preview="drawer"`, hoists a drawer containing the file\'s snippet and a "View source on GitHub →" footer link, leaving an inline link at the call site that opens it.',
         typeName: 'FileRef',
         category: 'Content',
-        snippet: ['{% file-ref path="${1:packages/types/src/token-contract.ts}" lines="${2:42-58}" label="${3:ThemeTokensConfig}" /%}'],
+        snippet: [
+            '{% file-ref path="${1:packages/types/src/token-contract.ts}" lines="${2:42-58}" label="${3:ThemeTokensConfig}" /%}',
+        ],
     }),
     progress: defineRune({
         name: 'progress',
@@ -583,7 +800,12 @@ export const runes = {
         description: 'A generic, self-contained content card. The body splits on `---` into [media] / body / [footer]: the media zone holds any content (image, codegroup, sandbox, …) and lays out beside the body on wide screens / as a full-bleed header on mobile; the footer is a muted meta row. Optional `href` makes the whole card a link. Knows nothing about the registry — usable standalone or inside a collection body template.',
         typeName: 'Card',
         category: 'Content',
-        snippet: ['{% card href="${1:/posts/slug/}" %}', '### ${2:Title}', '${3:A short summary.}', '{% /card %}'],
+        snippet: [
+            '{% card href="${1:/posts/slug/}" %}',
+            '### ${2:Title}',
+            '${3:A short summary.}',
+            '{% /card %}',
+        ],
     }),
 };
 /** Markdoc-compatible tags map derived from runes + Markdoc built-in tags.
@@ -597,6 +819,23 @@ export const tags = {
     ...runeTagMap(runes),
     link,
     ...Markdoc.tags,
+    // Markdoc's `if` / `else` declare `primary: { type: Object }`, which is a
+    // statement about *expression syntax*: `{% if $var %}` and
+    // `{% if equals(a, b) %}` both pass an AST node, and an AST node is an
+    // object. It stops being true in this pipeline, because preprocess hooks
+    // substitute variables for their values before the page is validated —
+    // `bindRow` turns `{% if $row.required %}` into `{% if true %}`, and a
+    // boolean is not an Object.
+    //
+    // SPEC-132's validation pass reported that 3,302 times across `site/`
+    // (WORK-557), every one a false positive. The type check cannot catch a
+    // real authoring error here: pre-substitution every legal form is already
+    // an object, and post-substitution every value is legal. So the constraint
+    // is dropped rather than the findings filtered — the root cause, not the
+    // symptom. `render: false` is preserved; it is what keeps the condition out
+    // of the rendered output.
+    if: { ...Markdoc.tags.if, attributes: { primary: { render: false } } },
+    else: { ...Markdoc.tags.else, attributes: { primary: { render: false } } },
 };
 export const nodes = {
     heading,