@refrakt-md/lumina 0.4.0

package/contracts/structures.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "description": "HTML structure contracts for the Lumina theme identity. Documents what HTML structure the CSS expects for each rune.",
+  "runes": {}
+}

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+import type { ThemeConfig } from '@refrakt-md/transform';
+/** Lumina theme configuration — drives the identity transform */
+export declare const luminaConfig: ThemeConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,iEAAiE;AACjE,eAAO,MAAM,YAAY,EAAE,WAgP1B,CAAC"}

package/dist/config.js

@@ -0,0 +1,238 @@
+/** Lumina theme configuration — drives the identity transform */
+export const luminaConfig = {
+    prefix: 'rf',
+    tokenPrefix: '--rf',
+    icons: {
+        hint: {
+            note: '<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><line x1="12" y1="16" x2="12" y2="12"/><line x1="12" y1="8" x2="12.01" y2="8"/></svg>',
+            warning: '<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z"/><line x1="12" y1="9" x2="12" y2="13"/><line x1="12" y1="17" x2="12.01" y2="17"/></svg>',
+            caution: '<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><line x1="15" y1="9" x2="9" y2="15"/><line x1="9" y1="9" x2="15" y2="15"/></svg>',
+            check: '<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M22 11.08V12a10 10 0 1 1-5.93-9.14"/><polyline points="22 4 12 14.01 9 11.01"/></svg>',
+        },
+    },
+    runes: {
+        // ─── Simple runes (block name only, engine adds BEM classes) ───
+        Accordion: { block: 'accordion' },
+        AccordionItem: { block: 'accordion-item', autoLabel: { name: 'header' } },
+        Details: { block: 'details', autoLabel: { summary: 'summary' } },
+        Grid: { block: 'grid' },
+        CodeGroup: {
+            block: 'codegroup',
+            structure: {
+                topbar: {
+                    tag: 'div', before: true,
+                    children: [
+                        { tag: 'span', ref: 'dot' },
+                        { tag: 'span', ref: 'dot' },
+                        { tag: 'span', ref: 'dot' },
+                    ],
+                },
+            },
+        },
+        PageSection: { block: 'page-section' },
+        TableOfContents: { block: 'toc' },
+        Embed: { block: 'embed' },
+        Breadcrumb: { block: 'breadcrumb' },
+        BreadcrumbItem: { block: 'breadcrumb-item' },
+        Testimonial: { block: 'testimonial' },
+        Timeline: { block: 'timeline' },
+        TimelineEntry: { block: 'timeline-entry' },
+        Changelog: { block: 'changelog' },
+        ChangelogRelease: { block: 'changelog-release' },
+        Event: {
+            block: 'event',
+            contentWrapper: { tag: 'div', ref: 'content' },
+            modifiers: {
+                date: { source: 'meta' },
+                endDate: { source: 'meta' },
+                location: { source: 'meta' },
+                url: { source: 'meta' },
+            },
+            structure: {
+                details: {
+                    tag: 'div', before: true,
+                    children: [
+                        {
+                            tag: 'div', ref: 'detail', condition: 'date',
+                            children: [
+                                { tag: 'span', ref: 'label', children: ['Date'] },
+                                { tag: 'span', ref: 'value', metaText: 'date' },
+                                { tag: 'span', ref: 'end-date', metaText: 'endDate', textPrefix: ' — ', condition: 'endDate' },
+                            ],
+                        },
+                        {
+                            tag: 'div', ref: 'detail', condition: 'location',
+                            children: [
+                                { tag: 'span', ref: 'label', children: ['Location'] },
+                                { tag: 'span', ref: 'value', metaText: 'location' },
+                            ],
+                        },
+                        {
+                            tag: 'a', ref: 'register', condition: 'url',
+                            attrs: { href: { fromModifier: 'url' } },
+                            children: ['Register'],
+                        },
+                    ],
+                },
+            },
+        },
+        Organization: { block: 'organization' },
+        Cast: { block: 'cast' },
+        CastMember: { block: 'cast-member' },
+        Recipe: {
+            block: 'recipe',
+            contentWrapper: { tag: 'div', ref: 'content' },
+            modifiers: {
+                prepTime: { source: 'meta' },
+                cookTime: { source: 'meta' },
+                servings: { source: 'meta' },
+                difficulty: { source: 'meta', default: 'medium' },
+            },
+            structure: {
+                meta: {
+                    tag: 'div', before: true,
+                    conditionAny: ['prepTime', 'cookTime', 'servings', 'difficulty'],
+                    children: [
+                        { tag: 'span', ref: 'meta-item', metaText: 'prepTime', transform: 'duration', textPrefix: 'Prep: ', condition: 'prepTime' },
+                        { tag: 'span', ref: 'meta-item', metaText: 'cookTime', transform: 'duration', textPrefix: 'Cook: ', condition: 'cookTime' },
+                        { tag: 'span', ref: 'meta-item', metaText: 'servings', textPrefix: 'Serves: ', condition: 'servings' },
+                        { tag: 'span', ref: 'badge', metaText: 'difficulty', condition: 'difficulty' },
+                    ],
+                },
+            },
+        },
+        RecipeIngredient: { block: 'recipe-ingredient' },
+        Pricing: { block: 'pricing' },
+        Tier: { block: 'tier' },
+        FeaturedTier: { block: 'featured-tier' },
+        Feature: { block: 'feature', contextModifiers: { 'Hero': 'in-hero', 'Grid': 'in-grid' } },
+        FeatureDefinition: { block: 'feature-definition' },
+        Steps: { block: 'steps' },
+        Step: { block: 'step' },
+        Nav: { block: 'nav' },
+        NavGroup: { block: 'nav-group' },
+        NavItem: { block: 'nav-item' },
+        Api: {
+            block: 'api',
+            contentWrapper: { tag: 'div', ref: 'body' },
+            modifiers: {
+                method: { source: 'meta', default: 'GET' },
+                path: { source: 'meta' },
+                auth: { source: 'meta' },
+            },
+            structure: {
+                header: {
+                    tag: 'div', before: true,
+                    children: [
+                        { tag: 'span', ref: 'method', metaText: 'method' },
+                        { tag: 'code', ref: 'path', metaText: 'path' },
+                        { tag: 'span', ref: 'auth', metaText: 'auth', condition: 'auth' },
+                    ],
+                },
+            },
+        },
+        Diff: {
+            block: 'diff',
+            modifiers: { mode: { source: 'meta', default: 'unified' } },
+        },
+        Chart: { block: 'chart' },
+        MusicPlaylist: { block: 'music-playlist' },
+        MusicRecording: { block: 'music-recording' },
+        // ─── Runes with modifier meta tags ───
+        Hint: {
+            block: 'hint',
+            modifiers: { hintType: { source: 'meta', default: 'note' } },
+            contextModifiers: { 'Hero': 'in-hero', 'Feature': 'in-feature' },
+            structure: {
+                header: {
+                    tag: 'div', before: true,
+                    children: [
+                        { tag: 'span', ref: 'icon', icon: { group: 'hint', variant: 'hintType' } },
+                        { tag: 'span', ref: 'title', metaText: 'hintType' },
+                    ],
+                },
+            },
+        },
+        Hero: {
+            block: 'hero',
+            modifiers: { align: { source: 'meta', default: 'center' } },
+            contextModifiers: { 'Feature': 'in-feature' },
+        },
+        CallToAction: { block: 'cta', contextModifiers: { 'Hero': 'in-hero', 'Pricing': 'in-pricing' } },
+        Figure: {
+            block: 'figure',
+            modifiers: {
+                size: { source: 'meta', default: 'default' },
+                align: { source: 'meta', default: 'center' },
+            },
+        },
+        Sidenote: {
+            block: 'sidenote',
+            modifiers: { style: { source: 'meta', default: 'sidenote' } },
+        },
+        Compare: {
+            block: 'compare',
+            modifiers: { layout: { source: 'meta', default: 'side-by-side' } },
+        },
+        Conversation: { block: 'conversation' },
+        ConversationMessage: {
+            block: 'conversation-message',
+            modifiers: { alignment: { source: 'meta', default: 'left' } },
+        },
+        Annotate: {
+            block: 'annotate',
+            modifiers: { style: { source: 'meta', default: 'margin' } },
+        },
+        AnnotateNote: { block: 'annotate-note' },
+        Storyboard: {
+            block: 'storyboard',
+            modifiers: { style: { source: 'meta', default: 'clean' } },
+        },
+        StoryboardPanel: { block: 'storyboard-panel' },
+        Bento: { block: 'bento' },
+        BentoCell: {
+            block: 'bento-cell',
+            modifiers: { size: { source: 'meta', default: 'medium' } },
+        },
+        Comparison: { block: 'comparison' },
+        ComparisonColumn: { block: 'comparison-column' },
+        ComparisonRow: {
+            block: 'comparison-row',
+            modifiers: { rowType: { source: 'meta', default: 'text' } },
+        },
+        HowTo: {
+            block: 'howto',
+            contentWrapper: { tag: 'div', ref: 'content' },
+            modifiers: {
+                estimatedTime: { source: 'meta' },
+                difficulty: { source: 'meta', default: 'medium' },
+            },
+            structure: {
+                meta: {
+                    tag: 'div', before: true,
+                    conditionAny: ['estimatedTime', 'difficulty'],
+                    children: [
+                        { tag: 'span', ref: 'meta-item', metaText: 'estimatedTime', transform: 'duration', textPrefix: 'Estimated time: ', condition: 'estimatedTime' },
+                        { tag: 'span', ref: 'meta-item', metaText: 'difficulty', textPrefix: 'Difficulty: ', condition: 'difficulty' },
+                    ],
+                },
+            },
+        },
+        // ─── Interactive runes (still get BEM classes, components add behavior) ───
+        TabGroup: { block: 'tabs' },
+        Tab: { block: 'tab' },
+        DataTable: { block: 'datatable' },
+        Form: {
+            block: 'form',
+            modifiers: { style: { source: 'meta', default: 'stacked' } },
+        },
+        FormField: {
+            block: 'form-field',
+            modifiers: { fieldType: { source: 'meta', default: 'text' } },
+        },
+        Reveal: { block: 'reveal' },
+        RevealStep: { block: 'reveal-step' },
+        Diagram: { block: 'diagram' },
+    },
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/lib/engine.d.ts

@@ -0,0 +1,13 @@
+import type { ThemeConfig, RendererNode } from './types.js';
+/**
+ * Create an identity transform function from a theme configuration.
+ *
+ * The returned function walks the serialized tag tree and enhances it:
+ * - Adds BEM classes based on the rune config
+ * - Reads and consumes meta tags for variant info
+ * - Auto-labels children by tag name (e.g., summary → data-name="header")
+ * - Injects structural elements (headers, icons, titles) from config
+ * - Recurses into children for nested runes
+ */
+export declare function createTransform(config: ThemeConfig): (tree: RendererNode) => RendererNode;
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/lib/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAA6C,YAAY,EAAE,MAAM,YAAY,CAAC;AAkBvG;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,UAGjB,YAAY,KAAG,YAAY,CAgB5D"}

package/dist/lib/engine.js

@@ -0,0 +1,218 @@
+import { isTag, makeTag, readMeta } from './helpers.js';
+/** Pure text transforms for metaText values */
+const transforms = {
+    duration(iso) {
+        const m = iso.match(/PT(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?/);
+        if (!m)
+            return iso;
+        const parts = [];
+        if (m[1])
+            parts.push(`${m[1]}h`);
+        if (m[2])
+            parts.push(`${m[2]}m`);
+        if (m[3])
+            parts.push(`${m[3]}s`);
+        return parts.join(' ') || iso;
+    },
+    uppercase: (s) => s.toUpperCase(),
+    capitalize: (s) => s.charAt(0).toUpperCase() + s.slice(1),
+};
+/**
+ * Create an identity transform function from a theme configuration.
+ *
+ * The returned function walks the serialized tag tree and enhances it:
+ * - Adds BEM classes based on the rune config
+ * - Reads and consumes meta tags for variant info
+ * - Auto-labels children by tag name (e.g., summary → data-name="header")
+ * - Injects structural elements (headers, icons, titles) from config
+ * - Recurses into children for nested runes
+ */
+export function createTransform(config) {
+    const { prefix, runes, icons = {} } = config;
+    function identityTransform(tree) {
+        if (tree === null || tree === undefined)
+            return tree;
+        if (typeof tree === 'string' || typeof tree === 'number')
+            return tree;
+        if (Array.isArray(tree))
+            return tree.map(identityTransform);
+        if (!isTag(tree))
+            return tree;
+        const typeof_ = tree.attributes?.typeof;
+        if (typeof_ && typeof_ in runes) {
+            return transformRune(tree, runes[typeof_], prefix, icons, identityTransform);
+        }
+        // Recurse into children even for non-rune tags
+        return { ...tree, children: tree.children.map(identityTransform) };
+    }
+    return identityTransform;
+}
+/** Apply BEM classes and structural enhancements to a rune tag */
+function transformRune(tag, config, prefix, icons, recurse) {
+    const block = `${prefix}-${config.block}`;
+    // 1. Read modifiers from meta tags, collecting resolved values
+    const modifierClasses = [];
+    const modifierValues = {};
+    if (config.modifiers) {
+        for (const [name, mod] of Object.entries(config.modifiers)) {
+            const value = mod.source === 'meta'
+                ? readMeta(tag, name, mod.default)
+                : tag.attributes[name] ?? mod.default;
+            if (value) {
+                modifierValues[name] = value;
+                modifierClasses.push(`${block}--${value}`);
+            }
+        }
+    }
+    // 2. Store modifier values as data attributes (so components can read them even after meta removal)
+    const modDataAttrs = {};
+    for (const [name, value] of Object.entries(modifierValues)) {
+        const kebab = name.replace(/([A-Z])/g, '-$1').toLowerCase();
+        modDataAttrs[`data-${kebab}`] = value;
+    }
+    // 3. Build the class string
+    const existingClass = tag.attributes.class || '';
+    const bemClass = [block, ...modifierClasses, existingClass].filter(Boolean).join(' ');
+    // 4. Auto-label children by tag name or property attribute
+    let children = tag.children;
+    if (config.autoLabel) {
+        children = children.map(child => {
+            if (!isTag(child))
+                return child;
+            const label = config.autoLabel[child.name] ?? config.autoLabel[child.attributes?.property];
+            if (label && !child.attributes['data-name']) {
+                return { ...child, attributes: { ...child.attributes, 'data-name': label } };
+            }
+            return child;
+        });
+    }
+    // 5. Inject structural elements from config
+    if (config.structure) {
+        const prepend = [];
+        const append = [];
+        for (const [name, entry] of Object.entries(config.structure)) {
+            const element = buildStructureElement(entry, name, modifierValues, icons);
+            if (!element)
+                continue;
+            if (entry.before) {
+                prepend.push(element);
+            }
+            else {
+                append.push(element);
+            }
+        }
+        if (config.contentWrapper) {
+            const wrapped = makeTag(config.contentWrapper.tag, { 'data-name': config.contentWrapper.ref }, children);
+            children = [...prepend, wrapped, ...append];
+        }
+        else if (prepend.length || append.length) {
+            children = [...prepend, ...children, ...append];
+        }
+    }
+    else if (config.contentWrapper) {
+        const wrapped = makeTag(config.contentWrapper.tag, { 'data-name': config.contentWrapper.ref }, children);
+        children = [wrapped];
+    }
+    // 6. Apply BEM element classes to data-name children (recursively for structural elements)
+    const enhancedChildren = children.map(child => {
+        if (!isTag(child))
+            return recurse(child);
+        return applyBemClasses(child, block, recurse);
+    });
+    // 7. Remove consumed meta tags
+    const filteredChildren = enhancedChildren.filter(child => {
+        if (!isTag(child))
+            return true;
+        const c = child;
+        if (c.name !== 'meta' || !c.attributes.property)
+            return true;
+        return !config.modifiers || !(c.attributes.property in config.modifiers);
+    });
+    return {
+        ...tag,
+        attributes: {
+            ...tag.attributes,
+            ...modDataAttrs,
+            class: bemClass,
+            ...(config.rootAttributes || {}),
+        },
+        children: filteredChildren,
+    };
+}
+/** Recursively apply BEM element classes to data-name elements within a rune's children */
+function applyBemClasses(child, block, recurse) {
+    const dataName = child.attributes['data-name'];
+    if (dataName) {
+        const elementClass = `${block}__${dataName}`;
+        const childExistingClass = child.attributes.class || '';
+        // Recursively apply BEM to nested data-name children (e.g., icon/title inside header)
+        const nestedChildren = child.children.map(c => {
+            if (!isTag(c))
+                return c;
+            return applyBemClasses(c, block, recurse);
+        });
+        return recurse({
+            ...child,
+            attributes: {
+                ...child.attributes,
+                class: [elementClass, childExistingClass].filter(Boolean).join(' '),
+            },
+            children: nestedChildren,
+        });
+    }
+    return recurse(child);
+}
+/** Build a structural element from a StructureEntry config. Returns null if condition is not met. */
+function buildStructureElement(entry, name, modifierValues, icons) {
+    // Conditional injection
+    if (entry.condition && !modifierValues[entry.condition])
+        return null;
+    if (entry.conditionAny && !entry.conditionAny.some(k => modifierValues[k]))
+        return null;
+    const dataName = entry.ref ?? name;
+    // Resolve extra attributes
+    const extraAttrs = {};
+    if (entry.attrs) {
+        for (const [key, val] of Object.entries(entry.attrs)) {
+            if (typeof val === 'string') {
+                extraAttrs[key] = val;
+            }
+            else {
+                extraAttrs[key] = modifierValues[val.fromModifier] ?? '';
+            }
+        }
+    }
+    const baseAttrs = { 'data-name': dataName, ...extraAttrs };
+    // Icon entry: create empty element, CSS displays icon via mask-image
+    if (entry.icon) {
+        return makeTag(entry.tag, baseAttrs, []);
+    }
+    // Meta text injection: use resolved modifier value as text content
+    if (entry.metaText) {
+        let text = modifierValues[entry.metaText] ?? '';
+        if (entry.transform && transforms[entry.transform]) {
+            text = transforms[entry.transform](text);
+        }
+        if (entry.textPrefix)
+            text = entry.textPrefix + text;
+        if (entry.textSuffix)
+            text = text + entry.textSuffix;
+        return makeTag(entry.tag, baseAttrs, [text]);
+    }
+    // Process children recursively
+    const elementChildren = [];
+    if (entry.children) {
+        for (const child of entry.children) {
+            if (typeof child === 'string') {
+                elementChildren.push(child);
+            }
+            else {
+                const built = buildStructureElement(child, child.ref ?? '', modifierValues, icons);
+                if (built)
+                    elementChildren.push(built);
+            }
+        }
+    }
+    return makeTag(entry.tag, baseAttrs, elementChildren);
+}
+//# sourceMappingURL=engine.js.map

package/dist/lib/engine.js.map

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

package/dist/lib/helpers.d.ts

@@ -0,0 +1,14 @@
+import type { SerializedTag, RendererNode } from './types.js';
+/** Type guard: is this node a serialized tag? */
+export declare function isTag(node: RendererNode): node is SerializedTag;
+/** Create a serialized tag node */
+export declare function makeTag(name: string, attributes?: Record<string, any>, children?: RendererNode[]): SerializedTag;
+/** Find a meta tag child by its property attribute */
+export declare function findMeta(tag: SerializedTag, property: string): SerializedTag | undefined;
+/** Find a child tag by its data-name attribute */
+export declare function findByDataName(tag: SerializedTag, name: string): SerializedTag | undefined;
+/** Get all children that are NOT meta tags */
+export declare function nonMetaChildren(tag: SerializedTag): RendererNode[];
+/** Read a meta tag's content value, with optional default */
+export declare function readMeta(tag: SerializedTag, property: string, defaultValue?: string): string | undefined;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/lib/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9D,iDAAiD;AACjD,wBAAgB,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,IAAI,aAAa,CAE/D;AAED,mCAAmC;AACnC,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAAE,QAAQ,GAAE,YAAY,EAAO,GAAG,aAAa,CAExH;AAED,sDAAsD;AACtD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAIxF;AAED,kDAAkD;AAClD,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAI1F;AAED,8CAA8C;AAC9C,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,EAAE,CAElE;AAED,6DAA6D;AAC7D,wBAAgB,QAAQ,CAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGxG"}

package/dist/lib/helpers.js

@@ -0,0 +1,26 @@
+/** Type guard: is this node a serialized tag? */
+export function isTag(node) {
+    return typeof node === 'object' && node !== null && !Array.isArray(node) && node.$$mdtype === 'Tag';
+}
+/** Create a serialized tag node */
+export function makeTag(name, attributes = {}, children = []) {
+    return { $$mdtype: 'Tag', name, attributes, children };
+}
+/** Find a meta tag child by its property attribute */
+export function findMeta(tag, property) {
+    return tag.children.find((c) => isTag(c) && c.name === 'meta' && c.attributes.property === property);
+}
+/** Find a child tag by its data-name attribute */
+export function findByDataName(tag, name) {
+    return tag.children.find((c) => isTag(c) && c.attributes['data-name'] === name);
+}
+/** Get all children that are NOT meta tags */
+export function nonMetaChildren(tag) {
+    return tag.children.filter(c => !(isTag(c) && c.name === 'meta'));
+}
+/** Read a meta tag's content value, with optional default */
+export function readMeta(tag, property, defaultValue) {
+    const meta = findMeta(tag, property);
+    return meta?.attributes.content ?? defaultValue;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/lib/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/lib/helpers.ts"],"names":[],"mappings":"AAEA,iDAAiD;AACjD,MAAM,UAAU,KAAK,CAAC,IAAkB;IACvC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAK,IAAY,CAAC,QAAQ,KAAK,KAAK,CAAC;AAC9G,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,aAAkC,EAAE,EAAE,WAA2B,EAAE;IACxG,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AACxD,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,QAAQ,CAAC,GAAkB,EAAE,QAAgB;IAC5D,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,CACvB,CAAC,CAAC,EAAsB,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,KAAK,QAAQ,CAC9F,CAAC;AACH,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,cAAc,CAAC,GAAkB,EAAE,IAAY;IAC9D,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,CACvB,CAAC,CAAC,EAAsB,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CACzE,CAAC;AACH,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,eAAe,CAAC,GAAkB;IACjD,OAAO,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,QAAQ,CAAC,GAAkB,EAAE,QAAgB,EAAE,YAAqB;IACnF,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACrC,OAAO,IAAI,EAAE,UAAU,CAAC,OAAO,IAAI,YAAY,CAAC;AACjD,CAAC"}

package/dist/lib/types.d.ts

@@ -0,0 +1,74 @@
+/** A serialized Markdoc Tag (plain object, not a class instance) */
+export interface SerializedTag {
+    $$mdtype: 'Tag';
+    name: string;
+    attributes: Record<string, any>;
+    children: RendererNode[];
+}
+export type RendererNode = SerializedTag | string | number | null | undefined | RendererNode[];
+/** Configuration for a single rune's identity transform */
+export interface RuneConfig {
+    /** BEM block name (without prefix). E.g., 'hint' → .rf-hint */
+    block: string;
+    /** Modifier sources — maps modifier name to where to read it from */
+    modifiers?: Record<string, {
+        /** Where to read the modifier value */
+        source: 'meta' | 'attribute';
+        /** Default value if not found */
+        default?: string;
+    }>;
+    /** Structural overrides — additional elements to inject (keyed by data-name) */
+    structure?: Record<string, StructureEntry>;
+    /** Auto-label children by tag name → data-name. E.g., { summary: 'header' } */
+    autoLabel?: Record<string, string>;
+    /** Extra attributes to add to the root element */
+    rootAttributes?: Record<string, string>;
+    /** Wrap content children (non-structural) in this element */
+    contentWrapper?: {
+        tag: string;
+        ref: string;
+    };
+}
+export interface StructureEntry {
+    /** HTML tag name */
+    tag: string;
+    /** Sets data-name on the element (overrides the structure key) */
+    ref?: string;
+    /** Child structure entries or content directives */
+    children?: (string | StructureEntry)[];
+    /** Insert before existing children */
+    before?: boolean;
+    /** Inject an SVG icon from config.icons[group][resolvedVariantValue] */
+    icon?: {
+        group: string;
+        variant: string;
+    };
+    /** Inject text from a resolved modifier value */
+    metaText?: string;
+    /** Only inject if the named modifier has a truthy resolved value */
+    condition?: string;
+    /** Only inject if ANY of the named modifiers has a truthy value */
+    conditionAny?: string[];
+    /** Extra attributes. String values are literal; objects reference modifiers */
+    attrs?: Record<string, string | {
+        fromModifier: string;
+    }>;
+    /** Transform applied to metaText value before injection */
+    transform?: 'duration' | 'uppercase' | 'capitalize';
+    /** Static text prepended to metaText value */
+    textPrefix?: string;
+    /** Static text appended to metaText value */
+    textSuffix?: string;
+}
+/** Top-level theme configuration */
+export interface ThemeConfig {
+    /** BEM prefix. E.g., 'rf' → .rf-hint */
+    prefix: string;
+    /** CSS custom property prefix. E.g., '--rf' → --rf-color-text */
+    tokenPrefix: string;
+    /** Icon SVGs organized by rune and variant */
+    icons: Record<string, Record<string, string>>;
+    /** Per-rune transform configuration */
+    runes: Record<string, RuneConfig>;
+}
+//# sourceMappingURL=types.d.ts.map