@refrakt-md/cli 0.4.0 → 0.5.1

package/dist/lib/css-audit.js

@@ -0,0 +1,99 @@
+import postcss from 'postcss';
+const RF_CLASS_RE = /\.rf-[\w-]+/g;
+const DATA_ATTR_RE = /\[data-[\w-]+(?:="[^"]*")?\]/g;
+/** Parse a CSS file and extract all .rf-* class selectors and [data-*] attribute selectors */
+export function parseCssFile(content, filePath) {
+    const matches = [];
+    const fileName = filePath.split('/').pop() ?? filePath;
+    const root = postcss.parse(content, { from: filePath });
+    root.walkRules((rule) => {
+        const line = rule.source?.start?.line ?? 0;
+        // Extract .rf-* class selectors
+        for (const m of rule.selector.matchAll(RF_CLASS_RE)) {
+            matches.push({ selector: m[0], file: fileName, line });
+        }
+        // Extract [data-*] attribute selectors
+        for (const m of rule.selector.matchAll(DATA_ATTR_RE)) {
+            matches.push({ selector: m[0], file: fileName, line });
+        }
+    });
+    return matches;
+}
+/** Match generated selectors against CSS selectors and produce an audit result */
+export function auditSelectors(rune, generated, cssMatches) {
+    // Build a lookup: selector → first CSS match
+    const cssLookup = new Map();
+    for (const match of cssMatches) {
+        if (!cssLookup.has(match.selector)) {
+            cssLookup.set(match.selector, { file: match.file, line: match.line });
+        }
+    }
+    const selectors = {};
+    let styled = 0;
+    for (const sel of generated) {
+        const match = cssLookup.get(sel);
+        if (match) {
+            selectors[sel] = { styled: true, file: match.file, line: match.line };
+            styled++;
+        }
+        else {
+            selectors[sel] = { styled: false };
+        }
+    }
+    const total = generated.length;
+    const status = styled === 0 ? 'not-started' : styled === total ? 'complete' : 'partial';
+    return { rune, total, styled, status, selectors };
+}
+/** Collect all possible selectors for a rune by running all modifier variants */
+export function collectAllSelectors(runeName, block, prefix, schemaVariants, contextModifiers, staticModifiers, runVariant) {
+    const allSelectors = new Set();
+    // If the rune has variant modifiers, run each combination
+    const variantKeys = Object.keys(schemaVariants);
+    if (variantKeys.length > 0) {
+        // Run each variant value for the first attribute with variants
+        // (most runes have a single modifier attribute)
+        for (const [attr, values] of Object.entries(schemaVariants)) {
+            for (const value of values) {
+                const selectors = runVariant({ [attr]: value });
+                for (const s of selectors)
+                    allSelectors.add(s);
+            }
+        }
+    }
+    else {
+        // No variants — run with empty flags
+        const selectors = runVariant({});
+        for (const s of selectors)
+            allSelectors.add(s);
+    }
+    // Add synthetic context modifier selectors
+    if (contextModifiers) {
+        for (const suffix of Object.values(contextModifiers)) {
+            allSelectors.add(`.${prefix}-${block}--${suffix}`);
+        }
+    }
+    // Add synthetic static modifier selectors
+    if (staticModifiers) {
+        for (const suffix of staticModifiers) {
+            allSelectors.add(`.${prefix}-${block}--${suffix}`);
+        }
+    }
+    return [...allSelectors].sort(selectorSort);
+}
+function selectorSort(a, b) {
+    const typeA = selectorType(a);
+    const typeB = selectorType(b);
+    if (typeA !== typeB)
+        return typeA - typeB;
+    return a.localeCompare(b);
+}
+function selectorType(s) {
+    if (s.startsWith('['))
+        return 3;
+    if (s.includes('__'))
+        return 2;
+    if (s.includes('--'))
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=css-audit.js.map

package/dist/lib/css-audit.js.map

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

package/dist/lib/css-resolve.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Resolve the CSS directory for rune styles.
+ *
+ * Discovery order:
+ * 1. Explicit --css flag
+ * 2. Resolve @refrakt-md/lumina package → styles/runes/
+ * 3. Monorepo fallback: packages/lumina/styles/runes/
+ */
+export declare function resolveCssDir(explicitDir?: string): string | null;
+/** Read a single CSS file for a BEM block name (e.g., "hint" → hint.css) */
+export declare function readCssForBlock(cssDir: string, block: string): {
+    content: string;
+    path: string;
+} | null;
+/** Read all CSS files from the directory */
+export declare function readAllCss(cssDir: string): Array<{
+    content: string;
+    path: string;
+}>;
+//# sourceMappingURL=css-resolve.d.ts.map

package/dist/lib/css-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-resolve.d.ts","sourceRoot":"","sources":["../../src/lib/css-resolve.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA6BjE;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAIvG;AAED,4CAA4C;AAC5C,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CASnF"}

package/dist/lib/css-resolve.js

@@ -0,0 +1,57 @@
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join, resolve, dirname } from 'node:path';
+import { createRequire } from 'node:module';
+/**
+ * Resolve the CSS directory for rune styles.
+ *
+ * Discovery order:
+ * 1. Explicit --css flag
+ * 2. Resolve @refrakt-md/lumina package → styles/runes/
+ * 3. Monorepo fallback: packages/lumina/styles/runes/
+ */
+export function resolveCssDir(explicitDir) {
+    if (explicitDir) {
+        const abs = resolve(explicitDir);
+        if (!existsSync(abs)) {
+            throw new Error(`CSS directory not found: ${abs}`);
+        }
+        return abs;
+    }
+    // Try resolving from @refrakt-md/lumina package
+    try {
+        const require = createRequire(import.meta.url);
+        const luminaPkg = require.resolve('@refrakt-md/lumina/package.json');
+        const luminaDir = dirname(luminaPkg);
+        const runesDir = join(luminaDir, 'styles', 'runes');
+        if (existsSync(runesDir)) {
+            return runesDir;
+        }
+    }
+    catch {
+        // Package not found, try monorepo fallback
+    }
+    // Monorepo fallback
+    const monoRepo = resolve('packages/lumina/styles/runes');
+    if (existsSync(monoRepo)) {
+        return monoRepo;
+    }
+    return null;
+}
+/** Read a single CSS file for a BEM block name (e.g., "hint" → hint.css) */
+export function readCssForBlock(cssDir, block) {
+    const filePath = join(cssDir, `${block}.css`);
+    if (!existsSync(filePath))
+        return null;
+    return { content: readFileSync(filePath, 'utf-8'), path: filePath };
+}
+/** Read all CSS files from the directory */
+export function readAllCss(cssDir) {
+    const files = readdirSync(cssDir)
+        .filter(f => f.endsWith('.css'))
+        .sort();
+    return files.map(f => {
+        const filePath = join(cssDir, f);
+        return { content: readFileSync(filePath, 'utf-8'), path: filePath };
+    });
+}
+//# sourceMappingURL=css-resolve.js.map

package/dist/lib/css-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-resolve.js","sourceRoot":"","sources":["../../src/lib/css-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,WAAoB;IACjD,IAAI,WAAW,EAAE,CAAC;QACjB,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QACjC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,GAAG,CAAC;IACZ,CAAC;IAED,gDAAgD;IAChD,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC;QACrE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,QAAQ,CAAC;QACjB,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,2CAA2C;IAC5C,CAAC;IAED,oBAAoB;IACpB,MAAM,QAAQ,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;IACzD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,KAAa;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,MAAM,CAAC,CAAC;IAC9C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AACrE,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,UAAU,CAAC,MAAc;IACxC,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC;SAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;SAC/B,IAAI,EAAE,CAAC;IAET,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACjC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACrE,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/fixtures.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Built-in Markdoc fixture strings for the inspect command.
+ *
+ * Each fixture exercises the rune's full structure with realistic content.
+ * The key is the primary rune tag name (as used in Markdoc).
+ */
+export declare const fixtures: Record<string, string>;
+/** Get a fixture for a rune, with optional attribute overrides applied to the source */
+export declare function getFixture(runeName: string, attrOverrides?: Record<string, string>): string;
+//# sourceMappingURL=fixtures.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/lib/fixtures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmV3C,CAAC;AAEF,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAc3F"}

package/dist/lib/fixtures.js

@@ -0,0 +1,356 @@
+/**
+ * Built-in Markdoc fixture strings for the inspect command.
+ *
+ * Each fixture exercises the rune's full structure with realistic content.
+ * The key is the primary rune tag name (as used in Markdoc).
+ */
+export const fixtures = {
+    hint: `{% hint type="note" %}
+The identity transform runs after the rune schema transform and before rendering. It applies BEM classes, injects structural elements, and resolves design tokens.
+{% /hint %}`,
+    accordion: `{% accordion %}
+## Getting Started
+Follow these steps to set up your development environment and build your first theme.
+
+## Configuration
+Theme configuration is defined in a TypeScript file that exports a ThemeConfig object.
+
+## Deployment
+Once your theme is ready, publish it to npm and register it in the theme marketplace.
+{% /accordion %}`,
+    details: `{% details %}
+## Implementation Notes
+This section contains additional technical details about how the transform pipeline processes rune content. The identity transform reads meta tags, applies BEM classes, and injects structural elements before the content reaches the renderer.
+{% /details %}`,
+    api: `{% api method="GET" path="/api/users/:id" auth="Bearer" %}
+Retrieve a single user by their unique identifier.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| id | string | The user's unique ID |
+
+\`\`\`json
+{
+  "id": "usr_123",
+  "name": "Alice",
+  "email": "alice@example.com"
+}
+\`\`\`
+{% /api %}`,
+    recipe: `{% recipe prepTime="PT15M" cookTime="PT30M" servings="4" difficulty="medium" %}
+# Classic Margherita Pizza
+
+- 500g bread flour
+- 7g dried yeast
+- 1 tsp salt
+- 300ml warm water
+- San Marzano tomatoes
+- Fresh mozzarella
+- Fresh basil leaves
+
+1. Mix flour, yeast, and salt in a large bowl
+2. Add warm water and knead for 10 minutes until smooth
+3. Let the dough rise for 1 hour at room temperature
+4. Shape into rounds and add toppings
+5. Bake at 250°C for 8-10 minutes
+
+> For the best crust, preheat your oven with a pizza stone for at least 30 minutes before baking.
+{% /recipe %}`,
+    symbol: `{% symbol kind="function" lang="typescript" since="1.2.0" %}
+# createTransform
+
+\`\`\`typescript
+function createTransform(config: ThemeConfig): (tree: RendererNode) => RendererNode
+\`\`\`
+
+- config — The theme configuration object defining BEM mappings and structural rules
+- Returns a pure transform function that enhances serialized tag trees
+
+> Returns a function that walks the serialized tag tree and applies BEM classes, reads meta tags, injects structural elements, and recurses into children.
+{% /symbol %}`,
+    event: `{% event date="2026-03-15" endDate="2026-03-17" location="Stockholm, Sweden" url="https://example.com/register" %}
+# Nordic Developer Summit
+
+A three-day conference bringing together developers, designers, and product engineers from across the Nordics.
+
+- Keynote: The Future of Web Components
+- Workshop: Building Design Systems at Scale
+- Panel: Open Source in Enterprise
+{% /event %}`,
+    howto: `{% howto estimatedTime="PT45M" difficulty="easy" %}
+# Set Up a Refrakt Theme
+
+- Node.js 20+
+- A code editor
+- Basic CSS knowledge
+
+1. Create a new directory for your theme
+2. Run \`npm init\` and add the theme-base dependency
+3. Create your \`theme.config.ts\` extending baseConfig
+4. Write CSS targeting the BEM selectors from \`refrakt inspect\`
+5. Test with \`refrakt inspect --serve\`
+{% /howto %}`,
+    hero: `{% hero align="center" %}
+# Build Beautiful Documentation
+From Markdown to pixel-perfect pages in minutes.
+
+- [Get Started](/docs)
+- [View on GitHub](https://github.com)
+{% /hero %}`,
+    feature: `{% feature %}
+# Why Refrakt
+
+Runes reinterpret standard Markdown — same syntax, richer meaning.
+
+- **Fast** — Static generation, zero runtime JavaScript
+- **Flexible** — 43+ runes, infinite combinations
+- **Themeable** — Full control over every element
+{% /feature %}`,
+    grid: `{% grid %}
+First column content with enough text to demonstrate layout behavior.
+
+---
+
+Second column content showing how grid cells are separated by horizontal rules.
+
+---
+
+Third column content completing the three-column grid layout example.
+{% /grid %}`,
+    figure: `{% figure size="large" align="center" %}
+![Mountain landscape](/images/mountain.jpg)
+
+A panoramic view of the Norwegian fjords at sunset, captured from the summit of Trolltunga.
+{% /figure %}`,
+    steps: `{% steps %}
+# Install dependencies
+Run \`npm install @refrakt-md/cli\` to add the CLI to your project.
+
+# Create content
+Write your first Markdown file using rune tags for rich components.
+
+# Build and preview
+Run \`npm run dev\` to start the development server and see your content rendered.
+{% /steps %}`,
+    tabs: `{% tabs %}
+# JavaScript
+\`\`\`js
+const greeting = "Hello, world!";
+console.log(greeting);
+\`\`\`
+
+# TypeScript
+\`\`\`ts
+const greeting: string = "Hello, world!";
+console.log(greeting);
+\`\`\`
+
+# Python
+\`\`\`python
+greeting = "Hello, world!"
+print(greeting)
+\`\`\`
+{% /tabs %}`,
+    pricing: `{% pricing %}
+# Choose Your Plan
+Select the plan that best fits your needs.
+
+{% tier name="Starter" price="Free" %}
+- Up to 3 projects
+- Community support
+- Basic themes
+{% /tier %}
+
+{% tier name="Pro" price="$29/mo" featured="true" %}
+- Unlimited projects
+- Priority support
+- All themes
+- Custom domains
+{% /tier %}
+
+{% tier name="Enterprise" price="Custom" %}
+- Everything in Pro
+- SSO & SAML
+- Dedicated support
+- SLA guarantee
+{% /tier %}
+{% /pricing %}`,
+    changelog: `{% changelog %}
+## 1.2.0 — 2026-02-15
+- **Added** Inspect command for theme developers
+- **Added** Selector extraction from transformed trees
+- **Fixed** BEM class ordering for nested runes
+
+## 1.1.0 — 2026-01-20
+- **Added** Context-aware modifiers
+- **Changed** Improved meta tag consumption logic
+{% /changelog %}`,
+    testimonial: `{% testimonial %}
+> Refrakt transformed how we write documentation. The rune system means our content authors write Markdown while our designers have full control over the output.
+
+**Sarah Chen** — Head of Developer Experience at Acme Corp
+
+![](/avatars/sarah.jpg)
+{% /testimonial %}`,
+    timeline: `{% timeline %}
+## 2024 — Project Inception
+Initial prototype exploring Markdoc extensions for component-rich content.
+
+## 2025 — Open Source Launch
+First public release with 20 runes and the Lumina theme.
+
+## 2026 — Theme Ecosystem
+Launch of the theme marketplace and inspect tooling for developers.
+{% /timeline %}`,
+    conversation: `{% conversation %}
+> **Alice** — Have you tried the new inspect command?
+
+> **Bob** — Yes! It shows exactly what HTML the identity transform produces. No more guessing which selectors to target.
+
+> **Alice** — The variant expansion is my favorite part. You can see every modifier value at once.
+{% /conversation %}`,
+    comparison: `{% comparison %}
+# React
+- **Learning Curve** — Moderate
+- **Bundle Size** — ~40kb
+- **Reactivity** — Virtual DOM
+- ~~Server Components~~ — Experimental
+
+# Svelte
+- **Learning Curve** — Easy
+- **Bundle Size** — ~5kb
+- **Reactivity** — Compile-time
+- **Server Components** — Native
+{% /comparison %}`,
+    storyboard: `{% storyboard style="clean" columns="3" %}
+![Panel 1](/images/panel1.jpg)
+The hero surveys the landscape from atop the hill.
+
+![Panel 2](/images/panel2.jpg)
+A distant rumble echoes across the valley.
+
+![Panel 3](/images/panel3.jpg)
+The journey begins.
+{% /storyboard %}`,
+    sidenote: `{% sidenote style="sidenote" %}
+This is a margin note that appears alongside the main content, providing additional context without interrupting the reading flow.
+{% /sidenote %}`,
+    diff: `{% diff mode="unified" %}
+\`\`\`ts
+const config = {
+  prefix: 'rf',
+  runes: {}
+};
+\`\`\`
+
+\`\`\`ts
+const config = {
+  prefix: 'rf',
+  tokenPrefix: '--rf',
+  icons: {},
+  runes: {}
+};
+\`\`\`
+{% /diff %}`,
+    datatable: `{% datatable %}
+| Name | Role | Department | Status |
+|------|------|------------|--------|
+| Alice | Engineer | Platform | Active |
+| Bob | Designer | Product | Active |
+| Carol | Manager | Engineering | On Leave |
+{% /datatable %}`,
+    form: `{% form method="POST" style="stacked" %}
+- Name
+- Email
+- Message (textarea)
+
+> How did you hear about us?
+- Search engine
+- Social media
+- Friend referral
+- Other
+
+**Submit**
+{% /form %}`,
+    cast: `{% cast %}
+- **Alice Chen** — Lead Engineer
+- **Bob Martinez** — Product Designer
+- **Carol Kim** — Engineering Manager
+{% /cast %}`,
+    bento: `{% bento %}
+# Main Feature
+The primary showcase area with plenty of room for a detailed description.
+
+## Secondary Feature
+A supporting feature with moderate space.
+
+## Another Feature
+More supporting content.
+
+### Small Detail
+A compact cell.
+
+### Small Detail
+Another compact cell.
+{% /bento %}`,
+    palette: `{% palette title="Brand Colors" %}
+- Primary: #2563EB
+- Secondary: #7C3AED
+- Accent: #F59E0B
+- Success: #10B981
+- Error: #EF4444
+{% /palette %}`,
+    typography: `{% typography title="Type Scale" %}
+- Display: Inter (400, 600, 700)
+- Body: Inter (400, 500)
+- Mono: JetBrains Mono (400, 500)
+{% /typography %}`,
+    spacing: `{% spacing title="Spacing Scale" %}
+# Spacing
+- xs: 4px
+- sm: 8px
+- md: 16px
+- lg: 24px
+- xl: 32px
+- 2xl: 48px
+{% /spacing %}`,
+};
+/** Get a fixture for a rune, with optional attribute overrides applied to the source */
+export function getFixture(runeName, attrOverrides) {
+    // Look up by primary name or try as-is
+    const source = fixtures[runeName];
+    if (!source) {
+        // Generate a minimal fixture for unknown runes
+        return `{% ${runeName} %}\nSample content for the ${runeName} rune.\n{% /${runeName} %}`;
+    }
+    if (!attrOverrides || Object.keys(attrOverrides).length === 0) {
+        return source;
+    }
+    // Apply attribute overrides by modifying the opening tag
+    return applyOverrides(source, runeName, attrOverrides);
+}
+/** Replace or add attributes in the opening tag of a fixture */
+function applyOverrides(source, tagName, overrides) {
+    // Match the opening tag: {% tagName ... %}
+    const openTagPattern = new RegExp(`(\\{%\\s*${escapeRegex(tagName)})([^%]*?)(%\\})`);
+    const match = source.match(openTagPattern);
+    if (!match)
+        return source;
+    let attrString = match[2];
+    for (const [key, value] of Object.entries(overrides)) {
+        // Try to replace existing attribute
+        const attrPattern = new RegExp(`${escapeRegex(key)}="[^"]*"`);
+        if (attrPattern.test(attrString)) {
+            attrString = attrString.replace(attrPattern, `${key}="${value}"`);
+        }
+        else {
+            // Add new attribute
+            attrString = attrString.trimEnd() + ` ${key}="${value}" `;
+        }
+    }
+    return source.replace(openTagPattern, `${match[1]}${attrString}${match[3]}`);
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=fixtures.js.map

package/dist/lib/fixtures.js.map

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

package/dist/lib/format.d.ts

@@ -0,0 +1,35 @@
+import type { RuneConfig, ThemeConfig } from '@refrakt-md/transform';
+import type { AuditResult } from './css-audit.js';
+/** Format the "Config Applied" section showing what the identity transform does */
+export declare function formatConfig(runeTypeof: string, config: ThemeConfig): string;
+/** Format the selector list with visual grouping */
+export declare function formatSelectors(selectors: string[]): string;
+/** Format a section heading */
+export declare function heading(text: string): string;
+/** Format the input Markdoc source (indented) */
+export declare function formatInput(source: string): string;
+/** Format the HTML output (indented, already pretty-printed) */
+export declare function formatHtml(html: string): string;
+/** Format the rune list for --list mode */
+export declare function formatRuneList(runes: Array<{
+    name: string;
+    aliases: string[];
+    description: string;
+    variants: Record<string, string[]>;
+}>): string;
+/** Build JSON output matching the spec format */
+export declare function buildJsonOutput(opts: {
+    rune: string;
+    theme: string;
+    input: string;
+    config: RuneConfig | undefined;
+    html: string;
+    selectors: string[];
+}): object;
+/** Format a single-rune audit result */
+export declare function formatAuditResult(result: AuditResult, theme: string): string;
+/** Format the full-theme audit summary */
+export declare function formatAuditSummary(results: AuditResult[], theme: string): string;
+/** Build JSON output for an audit */
+export declare function buildAuditJson(results: AuditResult[], theme: string): object;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/lib/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAUlD,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CA2E5E;AAED,oDAAoD;AACpD,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAO3D;AAED,+BAA+B;AAC/B,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,iDAAiD;AACjD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,2CAA2C;AAC3C,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAAE,CAAC,GAAG,MAAM,CAqBjJ;AAED,iDAAiD;AACjD,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;CACpB,GAAG,MAAM,CAkBT;AAED,wCAAwC;AACxC,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA0B5E;AAED,0CAA0C;AAC1C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAiChF;AAED,qCAAqC;AACrC,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAgB5E"}