@aperant/framework 0.6.2 → 0.6.3

package/dist/__tests__/create-docs-cli.test.js

@@ -1,259 +0,0 @@
-/**
- * create-docs-cli.test.ts — C49 deliverable 10d.
- *
- * Spawns the real apt-tools CLI in a tmp project with a minimal PROJECT.md,
- * personas.json, and a 2-area features registry. Asserts:
- *
- *   - subcommand routing (plan / render-nav / read / run) works after the
- *     dispatcher is wired,
- *   - `render-nav` materializes docs/product/README.md with the tier-grouped
- *     TOC populated from the planted personas,
- *   - `run` reports `status: needs-scan` when the features registry is absent,
- *   - `run` reports the next-steps list when personas are missing.
- */
-import { spawnSync } from 'node:child_process';
-import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { afterEach, beforeEach, describe, expect, it } from 'vitest';
-const __dirname = fileURLToPath(new URL('.', import.meta.url));
-const FRAMEWORK_ROOT = resolve(__dirname, '..', '..');
-const CLI = join(FRAMEWORK_ROOT, 'bin', 'apt-tools.mjs');
-function runCli(args) {
-    const res = spawnSync(process.execPath, [CLI, ...args], {
-        encoding: 'utf-8',
-        stdio: ['ignore', 'pipe', 'pipe'],
-    });
-    let json = null;
-    try {
-        json = JSON.parse(res.stdout);
-    }
-    catch {
-        const lines = res.stdout.split('\n');
-        for (let i = lines.length - 1; i >= 0; i--) {
-            const trimmed = lines[i].trim();
-            if (trimmed.startsWith('{')) {
-                try {
-                    json = JSON.parse(lines.slice(i).join('\n'));
-                    break;
-                }
-                catch {
-                    /* keep scanning */
-                }
-            }
-        }
-    }
-    return { status: res.status, stdout: res.stdout, stderr: res.stderr, json };
-}
-let root;
-beforeEach(() => {
-    root = mkdtempSync(join(tmpdir(), 'apt-c49-create-docs-cli-'));
-});
-afterEach(() => {
-    try {
-        rmSync(root, { recursive: true, force: true });
-    }
-    catch {
-        /* best-effort */
-    }
-});
-function plantPersonas(personas) {
-    mkdirSync(join(root, '.aperant'), { recursive: true });
-    const envelope = {
-        schema_version: 1,
-        team_id: 'framework-local',
-        project_id: 'local:test',
-        canonical_source: 'local',
-        personas: personas.map((p, i) => ({
-            id: p.name.toLowerCase(),
-            team_id: 'framework-local',
-            project_id: 'local:test',
-            ui_json: JSON.stringify({ name: p.name, tier: p.tier, archetype: `${p.name}-role` }),
-            origin: 'local-discovery',
-            source_fingerprint: `fw:${p.name.toLowerCase()}:${i}`,
-            canonical_source: 'local',
-            local_modified_at: Date.now(),
-            created_at: Date.now(),
-            updated_at: Date.now(),
-        })),
-    };
-    writeFileSync(join(root, '.aperant', 'personas.json'), JSON.stringify(envelope, null, 2), 'utf-8');
-}
-function plantFeaturesRegistry() {
-    const featuresDir = join(root, '.aperant', 'features');
-    mkdirSync(featuresDir, { recursive: true });
-    writeFileSync(join(featuresDir, 'REGISTRY.md'), '# Feature Registry\n\nLast scanned: 2026-04-22 (fixture)\n', 'utf-8');
-    writeFileSync(join(featuresDir, 'terminals.json'), JSON.stringify({
-        area: 'terminals',
-        route: '/terminal',
-        features: [
-            {
-                id: 'terminals-spawn',
-                name: 'Spawn Terminal',
-                wired: true,
-                sub_features: [
-                    { id: 'terminals-spawn-cli', name: 'CLI flag', wired: true },
-                    { id: 'terminals-spawn-button', name: 'Button', wired: true },
-                ],
-            },
-            {
-                id: 'terminals-legacy',
-                name: 'Legacy Terminal',
-                wired: 'stubbed',
-                sub_features: [{ id: 'terminals-legacy-open', name: 'Open legacy', wired: 'stubbed' }],
-            },
-        ],
-    }), 'utf-8');
-    writeFileSync(join(featuresDir, 'analytics.json'), JSON.stringify({
-        area: 'analytics',
-        route: '/analytics',
-        features: [
-            {
-                id: 'analytics-mock',
-                name: 'Mock Widget',
-                wired: false,
-                sub_features: [{ id: 'analytics-mock-a', name: 'Mock A', wired: false }],
-            },
-        ],
-    }), 'utf-8');
-}
-function plantProductContext() {
-    mkdirSync(join(root, '.aperant'), { recursive: true });
-    writeFileSync(join(root, '.aperant', 'product-context.json'), JSON.stringify({
-        productName: 'Aperant',
-        productDescription: 'An agentic IDE',
-        targetAudience: 'AI-native founders',
-        features: [],
-    }), 'utf-8');
-}
-describe('apt-tools create-docs — end-to-end CLI', () => {
-    it('plan → emits status: needs-scan when the features registry is missing', () => {
-        const res = runCli(['create-docs', 'plan', root]);
-        expect(res.status).toBe(0);
-        expect(res.json?.command).toBe('create-docs-plan');
-        expect(res.json?.status).toBe('needs-scan');
-        expect(res.json?.registry_status).toBe('missing');
-    });
-    it('plan → emits status: ok with a populated tree when features + personas exist', () => {
-        plantFeaturesRegistry();
-        plantPersonas([
-            { name: 'Maya', tier: 'primary' },
-            { name: 'Alex', tier: 'secondary' },
-            { name: 'Jordan', tier: 'tertiary' },
-        ]);
-        plantProductContext();
-        const res = runCli(['create-docs', 'plan', root]);
-        expect(res.status).toBe(0);
-        expect(res.json?.status).toBe('ok');
-        expect(res.json?.personas_count).toBe(3);
-        expect(res.json?.product_name).toBe('Aperant');
-        // TST-004: assert specific plan shape, not just defined (C49 StructurePlan).
-        const plan = res.json?.plan;
-        expect(plan).toBeDefined();
-        // totals surface
-        expect(typeof plan.totals.areas).toBe('number');
-        expect(plan.totals.features_documented).toBe(1); // terminals-spawn wired
-        expect(plan.totals.stubs_included).toBe(1); // terminals-legacy stubbed
-        expect(plan.totals.features_omitted_unwired).toBe(1); // analytics-mock
-        // personas surface — id and tier on each entry
-        expect(plan.personas.map((p) => p.id)).toEqual(['maya', 'alex', 'jordan']);
-        expect(plan.personas[0].tier).toBe('primary');
-        // areas surface — at least one area with a features list containing paths
-        expect(Array.isArray(plan.areas)).toBe(true);
-        expect(plan.areas.length).toBeGreaterThan(0);
-        const firstArea = plan.areas[0];
-        expect(typeof firstArea.area).toBe('string');
-        expect(Array.isArray(firstArea.features)).toBe(true);
-        if (firstArea.features.length > 0) {
-            expect(typeof firstArea.features[0].shared_path).toBe('string');
-        }
-    });
-    it('render-nav --print → emits rendered markdown without writing', () => {
-        plantFeaturesRegistry();
-        plantPersonas([{ name: 'Maya', tier: 'primary' }]);
-        plantProductContext();
-        const res = runCli(['create-docs', 'render-nav', root, '--print']);
-        expect(res.status).toBe(0);
-        expect(res.json?.command).toBe('create-docs-render-nav');
-        expect(res.json?.written).toBe(false);
-        const content = res.json?.content;
-        expect(content).toMatch(/# Aperant — Product Documentation/);
-        expect(content).toMatch(/## Coverage/);
-        expect(content).toMatch(/### Primary personas/);
-        expect(content).toMatch(/\[Maya\]\(maya\/README\.md\)/);
-        expect(existsSync(join(root, 'docs', 'product', 'README.md'))).toBe(false);
-    });
-    it('render-nav → materializes docs/product/README.md atomically', () => {
-        plantFeaturesRegistry();
-        plantPersonas([
-            { name: 'Maya', tier: 'primary' },
-            { name: 'Alex', tier: 'secondary' },
-        ]);
-        plantProductContext();
-        const res = runCli(['create-docs', 'render-nav', root]);
-        expect(res.status).toBe(0);
-        expect(res.json?.written).toBe(true);
-        const readmePath = join(root, 'docs', 'product', 'README.md');
-        expect(existsSync(readmePath)).toBe(true);
-        const body = readFileSync(readmePath, 'utf-8');
-        expect(body).toMatch(/# Aperant — Product Documentation/);
-        expect(body).toMatch(/### Primary personas/);
-        expect(body).toMatch(/\[Spawn Terminal\]\(maya\/terminals\/terminals-spawn\.md\)/);
-    });
-    it('read → reports output_dir_exists: false before anything is written', () => {
-        const res = runCli(['create-docs', 'read', root]);
-        expect(res.status).toBe(0);
-        expect(res.json?.output_dir_exists).toBe(false);
-        expect(res.json?.files).toEqual([]);
-    });
-    it('read → enumerates existing markdown after render-nav writes the index', () => {
-        plantFeaturesRegistry();
-        plantPersonas([{ name: 'Maya', tier: 'primary' }]);
-        plantProductContext();
-        runCli(['create-docs', 'render-nav', root]);
-        const res = runCli(['create-docs', 'read', root]);
-        expect(res.status).toBe(0);
-        expect(res.json?.output_dir_exists).toBe(true);
-        const files = res.json?.files;
-        expect(files.length).toBeGreaterThan(0);
-        expect(files.some((f) => f.relative === 'README.md')).toBe(true);
-    });
-    it('run → emits next_steps suggesting /apt:scan when registry is missing', () => {
-        const res = runCli(['create-docs', 'run', root]);
-        expect(res.status).toBe(0);
-        expect(res.json?.command).toBe('create-docs-run');
-        expect(res.json?.status).toBe('needs-scan');
-        const steps = res.json?.next_steps;
-        expect(steps.join('\n')).toMatch(/features registry is missing/);
-    });
-    it('run → emits next_steps suggesting /apt:personas when personas are absent', () => {
-        plantFeaturesRegistry();
-        const res = runCli(['create-docs', 'run', root]);
-        expect(res.status).toBe(0);
-        expect(res.json?.status).toBe('ok');
-        const steps = res.json?.next_steps;
-        expect(steps.join('\n')).toMatch(/no personas configured/);
-    });
-    it('run → emits the agent-invocation next steps when both features + personas are present', () => {
-        plantFeaturesRegistry();
-        plantPersonas([{ name: 'Maya', tier: 'primary' }]);
-        plantProductContext();
-        const res = runCli(['create-docs', 'run', root]);
-        expect(res.status).toBe(0);
-        const steps = res.json?.next_steps;
-        expect(steps.join('\n')).toMatch(/apt-docs-author/);
-        expect(steps.join('\n')).toMatch(/render-nav/);
-    });
-    it('--output-dir override routes to a custom subdirectory', () => {
-        plantFeaturesRegistry();
-        plantPersonas([{ name: 'Maya', tier: 'primary' }]);
-        plantProductContext();
-        const res = runCli(['create-docs', 'render-nav', root, '--output-dir', 'website/docs']);
-        expect(res.status).toBe(0);
-        expect(res.json?.written).toBe(true);
-        expect(existsSync(join(root, 'website', 'docs', 'README.md'))).toBe(true);
-        expect(existsSync(join(root, 'docs', 'product', 'README.md'))).toBe(false);
-    });
-});
-//# sourceMappingURL=create-docs-cli.test.js.map

package/dist/__tests__/create-docs-cli.test.js.map

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

package/dist/__tests__/create-docs-frontmatter.test.d.ts

@@ -1,18 +0,0 @@
-/**
- * create-docs-frontmatter.test.ts — C49 deliverable 10e.
- *
- * apt:create-docs is the second shipping skill with a custom intent
- * (`intent: x-document`), following apt:personas (`x-personas`, C48).
- * This file is the executable contract for that second dogfood:
- *
- *   - the shipping SKILL.md validates against the Zod frontmatter schema;
- *   - every fat-frontmatter key is populated;
- *   - `apt-tools check` (via runCheck) accepts the whole skill set — the
- *     CLI-level assertion that a second x-* intent doesn't regress the
- *     router-0.3.0 extension path.
- *
- * If the skill ever drops `intent: x-document` during a template migration,
- * this file fails loud and the next router release is blocked.
- */
-export {};
-//# sourceMappingURL=create-docs-frontmatter.test.d.ts.map

package/dist/__tests__/create-docs-frontmatter.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"create-docs-frontmatter.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/create-docs-frontmatter.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/__tests__/create-docs-frontmatter.test.js

@@ -1,106 +0,0 @@
-/**
- * create-docs-frontmatter.test.ts — C49 deliverable 10e.
- *
- * apt:create-docs is the second shipping skill with a custom intent
- * (`intent: x-document`), following apt:personas (`x-personas`, C48).
- * This file is the executable contract for that second dogfood:
- *
- *   - the shipping SKILL.md validates against the Zod frontmatter schema;
- *   - every fat-frontmatter key is populated;
- *   - `apt-tools check` (via runCheck) accepts the whole skill set — the
- *     CLI-level assertion that a second x-* intent doesn't regress the
- *     router-0.3.0 extension path.
- *
- * If the skill ever drops `intent: x-document` during a template migration,
- * this file fails loud and the next router release is blocked.
- */
-import { readFileSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { describe, expect, it } from 'vitest';
-import { parse as parseYaml } from 'yaml';
-import { runCheck } from '../cli/commands/check.mjs';
-import { CORE_INTENTS, CUSTOM_INTENT_REGEX, SkillFrontmatterSchema, } from '../cli/skill-author/contract.mjs';
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const SKILL_PATH = resolve(__dirname, '..', '..', 'skills', 'apt-create-docs', 'SKILL.md');
-const SKILLS_ROOT = resolve(__dirname, '..', '..', 'skills');
-const FRONTMATTER_RE = /^---\n([\s\S]*?)\n---\n/;
-function extractFrontmatter(text) {
-    const m = text.match(FRONTMATTER_RE);
-    if (!m)
-        return null;
-    const parsed = parseYaml(m[1]);
-    if (parsed !== null && typeof parsed === 'object')
-        return parsed;
-    return null;
-}
-describe('apt-create-docs SKILL.md — x-document custom intent dogfood', () => {
-    it('SKILL.md exists and parses frontmatter', () => {
-        const raw = readFileSync(SKILL_PATH, 'utf-8');
-        const fm = extractFrontmatter(raw);
-        expect(fm).not.toBeNull();
-    });
-    it('declares intent: x-document (not a core intent)', () => {
-        const raw = readFileSync(SKILL_PATH, 'utf-8');
-        const fm = extractFrontmatter(raw);
-        expect(fm.intent).toBe('x-document');
-        // Must NOT be in core — defeats the dogfood point otherwise.
-        expect(CORE_INTENTS.includes(fm.intent)).toBe(false);
-        // Must match the custom-intent regex.
-        expect(CUSTOM_INTENT_REGEX.test(fm.intent)).toBe(true);
-    });
-    it('has the fat-frontmatter shape expected by the 0.3.0 router', () => {
-        const raw = readFileSync(SKILL_PATH, 'utf-8');
-        const fm = extractFrontmatter(raw);
-        for (const key of [
-            'name',
-            'description',
-            'stage',
-            'intent',
-            'when_to_use',
-            'user_invocable',
-            'internal',
-            'spawns_agent',
-            'agent_name',
-            'allowed-tools',
-            'argument-hint',
-            'gates',
-            'default_execution_mode',
-            'execution_modes',
-        ]) {
-            expect(fm[key], `missing frontmatter key: ${key}`).toBeDefined();
-        }
-    });
-    it('validates cleanly against SkillFrontmatterSchema (Zod)', () => {
-        const raw = readFileSync(SKILL_PATH, 'utf-8');
-        const fm = extractFrontmatter(raw);
-        const res = SkillFrontmatterSchema.safeParse(fm);
-        if (!res.success) {
-            const issues = res.error.issues
-                .map((i) => `  ${i.path.join('.') || '(root)'}: ${i.message}`)
-                .join('\n');
-            throw new Error(`apt-create-docs SKILL.md failed schema validation:\n${issues}`);
-        }
-    });
-    it('spawns the apt-docs-author agent (D-09 per-feature atomic commit pattern)', () => {
-        const raw = readFileSync(SKILL_PATH, 'utf-8');
-        const fm = extractFrontmatter(raw);
-        expect(fm.spawns_agent).toBe(true);
-        expect(fm.agent_name).toBe('apt-docs-author');
-    });
-    it('is user_invocable and not internal', () => {
-        const raw = readFileSync(SKILL_PATH, 'utf-8');
-        const fm = extractFrontmatter(raw);
-        expect(fm.user_invocable).toBe(true);
-        expect(fm.internal).toBe(false);
-    });
-    it('apt-tools check accepts the whole skill set (x-document does not regress the router)', () => {
-        const result = runCheck({ skillsRoot: SKILLS_ROOT });
-        if (result.status !== 'ok') {
-            const errors = result.errors.map((e) => `  ${e.file} ${e.field}: ${e.message}`).join('\n');
-            throw new Error(`apt-tools check failed — x-document introduced a regression:\n${errors}`);
-        }
-        expect(result.status).toBe('ok');
-    });
-});
-//# sourceMappingURL=create-docs-frontmatter.test.js.map

package/dist/__tests__/create-docs-frontmatter.test.js.map

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

package/dist/__tests__/cycle.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=cycle.test.d.ts.map

package/dist/__tests__/cycle.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cycle.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/cycle.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/cycle.test.js

@@ -1,64 +0,0 @@
-/**
- * AC #12, #13 — detectCycle + collectBlockedBy cover Pre-mortem #5.
- */
-import { describe, expect, it } from 'vitest';
-import { collectBlockedBy, detectCycle } from '../helpers/cycle';
-describe('detectCycle', () => {
-    it('returns null for an acyclic DAG', () => {
-        const g = new Map([
-            ['a', ['b']],
-            ['b', ['c']],
-            ['c', []],
-        ]);
-        expect(detectCycle(g, { from: 'a', to: 'c' })).toBeNull();
-    });
-    it('detects a 3-node cycle introduced by a new edge', () => {
-        // Existing: a->b, b->c. Adding c->a closes the cycle.
-        const g = new Map([
-            ['a', ['b']],
-            ['b', ['c']],
-            ['c', []],
-        ]);
-        const cycle = detectCycle(g, { from: 'c', to: 'a' });
-        expect(cycle).not.toBeNull();
-        // Path should start at `to` and end at `from`.
-        expect(cycle?.[0]).toBe('a');
-        expect(cycle?.[cycle.length - 1]).toBe('c');
-    });
-    it('detects a trivial self-cycle', () => {
-        const g = new Map([['a', []]]);
-        const cycle = detectCycle(g, { from: 'a', to: 'a' });
-        expect(cycle).not.toBeNull();
-    });
-    it('ignores unrelated subgraphs', () => {
-        const g = new Map([
-            ['a', ['b']],
-            ['b', []],
-            ['c', ['d']],
-            ['d', []],
-        ]);
-        expect(detectCycle(g, { from: 'a', to: 'c' })).toBeNull();
-    });
-});
-describe('collectBlockedBy', () => {
-    it('returns the transitive set of tasks blocked by target', () => {
-        // Graph: a depends_on target, b depends_on a, c depends_on b, d unrelated.
-        const g = new Map([
-            ['target', []],
-            ['a', ['target']],
-            ['b', ['a']],
-            ['c', ['b']],
-            ['d', []],
-        ]);
-        const blocked = collectBlockedBy(g, 'target').sort();
-        expect(blocked).toEqual(['a', 'b', 'c']);
-    });
-    it('returns an empty array when nothing depends on target', () => {
-        const g = new Map([
-            ['target', []],
-            ['a', []],
-        ]);
-        expect(collectBlockedBy(g, 'target')).toEqual([]);
-    });
-});
-//# sourceMappingURL=cycle.test.js.map

package/dist/__tests__/cycle.test.js.map

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

package/dist/__tests__/design-extract.test.d.ts

@@ -1,19 +0,0 @@
-/**
- * C27 — design token extractors (unit tests).
- *
- * Covers:
- *   (a) hex / rgb / hsl color extraction + case normalization + dedup
- *   (b) Tailwind palette class stripping (utility prefix removed)
- *   (c) CSS custom property detection (only names, not values)
- *   (d) px / rem / em raw length extraction (identifier boundary check)
- *   (e) Tailwind spacing regex rejects identifier-embedded `wt-001` collisions
- *       and leading-zero multi-digit numbers
- *   (f) font-family splitting + quote stripping; Tailwind text-* size
- *       extraction; line-height capture
- *   (g) border-radius + rounded-* extraction; bare `rounded` becomes
- *       `default`
- *   (h) shadow utility extraction excludes color variants like
- *       `shadow-slate-500`
- */
-export {};
-//# sourceMappingURL=design-extract.test.d.ts.map

package/dist/__tests__/design-extract.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"design-extract.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/design-extract.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/__tests__/design-extract.test.js

@@ -1,119 +0,0 @@
-/**
- * C27 — design token extractors (unit tests).
- *
- * Covers:
- *   (a) hex / rgb / hsl color extraction + case normalization + dedup
- *   (b) Tailwind palette class stripping (utility prefix removed)
- *   (c) CSS custom property detection (only names, not values)
- *   (d) px / rem / em raw length extraction (identifier boundary check)
- *   (e) Tailwind spacing regex rejects identifier-embedded `wt-001` collisions
- *       and leading-zero multi-digit numbers
- *   (f) font-family splitting + quote stripping; Tailwind text-* size
- *       extraction; line-height capture
- *   (g) border-radius + rounded-* extraction; bare `rounded` becomes
- *       `default`
- *   (h) shadow utility extraction excludes color variants like
- *       `shadow-slate-500`
- */
-import { describe, expect, it } from 'vitest';
-import { extractColors, extractRadii, extractShadows, extractSpacing, extractTypography, } from '../cli/design/extract.mjs';
-describe('C27 — extractColors', () => {
-    it('hex: 3 / 6 / 8 digit, lowercased + deduped', () => {
-        const r = extractColors('color: #FFF; background: #0F172A; a: #abcdef12; b: #abcdef12;');
-        expect(r.hex).toEqual(['#0f172a', '#abcdef12', '#fff']);
-    });
-    it('rejects intermediate out-of-bounds hex lengths (5, 7 digits)', () => {
-        // The regex allows 3, 4, 6, 8 digits. A 5-digit hex (#abcde) does
-        // match the 3- or 4-digit alternative as a prefix — `#abcd` matches
-        // but the trailing `e` is followed by a word-boundary requirement
-        // that fails. We verify the 5-digit form yields no hex hits.
-        const r = extractColors('value: #abcde ; another: #1234567 ;');
-        expect(r.hex).toEqual([]);
-    });
-    it('routes rgb vs hsl into separate buckets; whitespace is collapsed', () => {
-        const r = extractColors('a: rgb( 0 , 0 , 0 ); b: rgba(0,0,0,0.5); c: hsl(200deg 50% 40%);');
-        // Whitespace inside parens is normalized to single spaces but not removed.
-        expect(r.rgb).toContain('rgb( 0 , 0 , 0 )');
-        expect(r.rgb).toContain('rgba(0,0,0,0.5)');
-        expect(r.hsl).toContain('hsl(200deg 50% 40%)');
-    });
-    it('tailwind palette strips utility prefix; keeps color-shade fragment', () => {
-        const r = extractColors('className="bg-slate-900 text-blue-500 border-red-200"');
-        expect(r.tailwind).toEqual(['blue-500', 'red-200', 'slate-900']);
-    });
-    it('tailwind palette accepts neutral aliases (white / black / transparent)', () => {
-        const r = extractColors('className="bg-white text-black border-transparent"');
-        expect(r.tailwind).toEqual(['black', 'transparent', 'white']);
-    });
-    it('CSS color vars: names only, sorted', () => {
-        const r = extractColors('--color-primary: red; --color-muted-foreground: rgb(200,200,200);');
-        expect(r.css_vars).toEqual(['--color-muted-foreground', '--color-primary']);
-    });
-});
-describe('C27 — extractSpacing', () => {
-    it('captures px / rem / em raw lengths', () => {
-        const r = extractSpacing('padding: 16px; margin: 1rem; gap: 0.5em;');
-        expect(r.raw).toEqual(['0.5em', '1rem', '16px']);
-    });
-    it('ignores identifier-embedded lengths (foo16px)', () => {
-        const r = extractSpacing('const foo16px = 1; const a16px = 2; --real: 8px;');
-        expect(r.raw).toEqual(['8px']);
-    });
-    it('tailwind spacing: numeric scale, sorted numerically', () => {
-        const r = extractSpacing('className="p-4 m-2 gap-8 px-16 py-0.5"');
-        expect(r.tailwind_scale).toEqual(['0.5', '2', '4', '8', '16']);
-    });
-    it('rejects identifier-embedded class-like tokens (wt-001, pr-001)', () => {
-        const r = extractSpacing('id: "wt-001", id: "pr-001", id: "m-001"');
-        expect(r.tailwind_scale).toEqual([]);
-    });
-    it('drops full / screen sentinels from the scale', () => {
-        const r = extractSpacing('className="w-full h-screen p-4"');
-        expect(r.tailwind_scale).toEqual(['4']);
-    });
-    it('captures px / auto Tailwind values', () => {
-        const r = extractSpacing('className="p-px m-auto"');
-        expect([...r.tailwind_scale].sort()).toEqual(['auto', 'px']);
-    });
-});
-describe('C27 — extractTypography', () => {
-    it('splits font-family declarations on comma and strips quotes', () => {
-        const r = extractTypography("font-family: 'Inter', -apple-system, 'JetBrains Mono', monospace;");
-        expect(r.font_families).toEqual(['-apple-system', 'Inter', 'JetBrains Mono', 'monospace']);
-    });
-    it('captures Tailwind text sizes; excludes colors / alignment', () => {
-        const r = extractTypography('className="text-lg text-sm text-red-500 text-left"');
-        expect(r.tailwind_sizes).toEqual(['sm', 'lg']);
-    });
-    it('captures font-size + line-height declarations', () => {
-        const r = extractTypography('font-size: 14px; line-height: 1.5;');
-        expect(r.font_sizes_raw).toEqual(['14px']);
-        expect(r.line_heights).toEqual(['1.5']);
-    });
-});
-describe('C27 — extractRadii', () => {
-    it('captures border-radius values', () => {
-        const r = extractRadii('border-radius: 4px; border-radius: 0.5rem;');
-        expect(r.raw).toEqual(['0.5rem', '4px']);
-    });
-    it('captures rounded-* Tailwind; bare rounded becomes default', () => {
-        const r = extractRadii('className="rounded-md rounded rounded-full rounded-lg"');
-        expect(r.tailwind).toEqual(['default', 'md', 'lg', 'full']);
-    });
-});
-describe('C27 — extractShadows', () => {
-    it('captures box-shadow values', () => {
-        const r = extractShadows('box-shadow: 0 1px 2px rgba(0,0,0,0.1);');
-        expect(r.raw).toEqual(['0 1px 2px rgba(0,0,0,0.1)']);
-    });
-    it('captures shadow-<size> variants; color-shadow variants collapse to default', () => {
-        // `shadow-slate-500` is a color utility; the regex only enumerates
-        // size tokens (sm, md, lg, xl, 2xl, inner, none), so the leading
-        // bare `shadow` of the utility becomes a `default` entry and the
-        // `-slate-500` tail is discarded. This keeps the shadows bucket
-        // free of palette colors.
-        const r = extractShadows('className="shadow-sm shadow-lg shadow-slate-500 shadow"');
-        expect(r.tailwind).toEqual(['sm', 'default', 'lg']);
-    });
-});
-//# sourceMappingURL=design-extract.test.js.map