@planu/cli 0.63.7 → 0.64.0

package/dist/engine/design-to-spec/ac-generator.js

@@ -0,0 +1,185 @@
+// engine/design-to-spec/ac-generator.ts — Generate acceptance criteria from parsed design (SPEC-159)
+// ---------------------------------------------------------------------------
+// A11y AC templates (WCAG 2.1 AA)
+// ---------------------------------------------------------------------------
+const A11Y_TEMPLATES = [
+    'All interactive elements are keyboard accessible (Tab, Enter, Space)',
+    'All images have descriptive alt text or are marked as decorative (alt="")',
+    'Color contrast ratio meets WCAG 2.1 AA (≥ 4.5:1 for normal text, ≥ 3:1 for large text)',
+    'Form fields have associated labels (visible or via aria-label)',
+    'Error messages are programmatically associated with their fields (aria-describedby)',
+    'Page has a logical heading hierarchy (h1 → h2 → h3)',
+    'Focus is visible and never lost during interactions',
+    'Screen reader announces dynamic content updates (aria-live regions)',
+];
+const A11Y_BY_COMPONENT_TYPE = {
+    button: [
+        'Button has accessible name (label text or aria-label)',
+        'Disabled buttons communicate state to screen readers (aria-disabled)',
+    ],
+    input: [
+        'Input field has a visible label or aria-label',
+        'Required fields are marked with aria-required="true"',
+        'Validation errors are announced to screen readers',
+    ],
+    modal: [
+        'Modal traps focus when open; returns focus to trigger on close',
+        'Modal has role="dialog" and aria-modal="true"',
+        'Pressing Escape closes the modal',
+    ],
+    nav: [
+        'Navigation has a landmark role (role="navigation" or <nav>)',
+        'Current page/item is indicated via aria-current',
+    ],
+    list: [
+        'List uses semantic <ul>/<ol>/<li> or appropriate ARIA list roles',
+        'Empty state is announced to screen readers',
+    ],
+    form: [
+        'Form has a clear submit mechanism accessible via keyboard',
+        'All required fields are indicated (asterisk + aria-required)',
+    ],
+    image: ['Informative images have descriptive alt text', 'Decorative images use alt=""'],
+    card: ['Card interactive area has an accessible name describing its action'],
+    text: [],
+    container: [],
+    other: [],
+};
+// ---------------------------------------------------------------------------
+// AC generators per screen/component
+// ---------------------------------------------------------------------------
+/** Generate ACs for a specific component */
+function generateComponentAcs(component, screenName) {
+    const acs = [];
+    const ctx = `${screenName} > ${component.name}`;
+    // Visibility AC
+    acs.push(`${ctx} is visible and rendered correctly on first load`);
+    // Interaction state ACs
+    for (const state of component.interactionStates) {
+        if (state.name !== 'default') {
+            acs.push(`${ctx} shows ${state.name} state when ${state.trigger.toLowerCase()}`);
+        }
+    }
+    // Type-specific ACs
+    switch (component.type) {
+        case 'form':
+            acs.push(`${ctx} validates all required fields before submission`);
+            acs.push(`${ctx} shows inline error messages for invalid fields`);
+            acs.push(`${ctx} shows success feedback after successful submission`);
+            break;
+        case 'button':
+            acs.push(`${ctx} is disabled and non-interactive when loading is in progress`);
+            break;
+        case 'input':
+            acs.push(`${ctx} accepts valid input and rejects invalid input with a clear error message`);
+            break;
+        case 'list':
+            acs.push(`${ctx} shows an empty state message when there are no items`);
+            acs.push(`${ctx} shows a loading skeleton while data is being fetched`);
+            break;
+        case 'modal':
+            acs.push(`${ctx} opens when its trigger is activated`);
+            acs.push(`${ctx} closes when the user clicks outside or presses Escape`);
+            break;
+        case 'nav':
+        case 'card':
+        case 'text':
+        case 'image':
+        case 'container':
+        case 'other':
+            break;
+    }
+    return acs;
+}
+/** Generate ACs for data bindings on a screen */
+function generateDataBindingAcs(screenName, dataSource) {
+    return [
+        `${screenName}: Data from "${dataSource}" loads successfully within 2 seconds`,
+        `${screenName}: A loading indicator is shown while "${dataSource}" data is being fetched`,
+        `${screenName}: An error state is shown if "${dataSource}" data fails to load`,
+        `${screenName}: Stale data is refreshed when the user returns to the screen`,
+    ];
+}
+/** Generate platform-specific ACs */
+function generatePlatformAcs(screenName, platform) {
+    const acs = [];
+    switch (platform) {
+        case 'web':
+            acs.push(`${screenName}: Layout adapts correctly at mobile (< 768px), tablet (768–1023px), and desktop (≥ 1024px) breakpoints`);
+            acs.push(`${screenName}: Page title is set correctly for SEO and screen reader context`);
+            break;
+        case 'mobile':
+            acs.push(`${screenName}: Touch targets are at least 44 × 44 pt (iOS) / 48 × 48 dp (Android)`);
+            acs.push(`${screenName}: Screen works correctly in both portrait and landscape orientations`);
+            break;
+        case 'desktop':
+            acs.push(`${screenName}: Keyboard shortcuts are discoverable and functional`);
+            acs.push(`${screenName}: Layout uses available horizontal space efficiently`);
+            break;
+    }
+    return acs;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Generates acceptance criteria for a single screen.
+ * Returns ACs grouped by theme: visibility, interactions, data, a11y, platform.
+ */
+export function generateAcsForScreen(screen, platform, includeA11y) {
+    const acs = [];
+    // Screen-level ACs
+    acs.push(`${screen.name} renders without layout errors on first load`);
+    acs.push(`${screen.name} is accessible via its defined route: ${screen.route ?? '(route TBD)'}`);
+    // Component-level ACs
+    for (const component of screen.components) {
+        acs.push(...generateComponentAcs(component, screen.name));
+    }
+    // Data binding ACs
+    for (const binding of screen.dataBindings) {
+        acs.push(...generateDataBindingAcs(screen.name, binding.dataSource));
+    }
+    // Platform ACs
+    acs.push(...generatePlatformAcs(screen.name, platform));
+    // A11y ACs
+    if (includeA11y) {
+        acs.push(...A11Y_TEMPLATES.map((t) => `${screen.name}: ${t}`));
+        for (const component of screen.components) {
+            const typeAcs = A11Y_BY_COMPONENT_TYPE[component.type];
+            acs.push(...typeAcs.map((t) => `${screen.name} > ${component.name}: ${t}`));
+        }
+    }
+    return acs;
+}
+/**
+ * Generates all acceptance criteria for a set of screens.
+ * Returns a deduplicated flat array of AC strings.
+ */
+export function generateAllAcs(screens, platform, includeA11y) {
+    const seen = new Set();
+    const result = [];
+    for (const screen of screens) {
+        const screenAcs = generateAcsForScreen(screen, platform, includeA11y);
+        for (const ac of screenAcs) {
+            if (!seen.has(ac)) {
+                seen.add(ac);
+                result.push(ac);
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Returns a11y requirements for a component type.
+ * Used by ui-contract-builder to annotate component entries.
+ */
+export function getA11yRequirementsForComponent(componentType) {
+    return A11Y_BY_COMPONENT_TYPE[componentType];
+}
+/**
+ * Returns global a11y requirements that apply to every screen.
+ */
+export function getGlobalA11yRequirements() {
+    return [...A11Y_TEMPLATES];
+}
+//# sourceMappingURL=ac-generator.js.map

package/dist/engine/design-to-spec/ac-generator.js.map

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

package/dist/engine/design-to-spec/index.d.ts

@@ -0,0 +1,11 @@
+export { parseDesignDescription } from './parser.js';
+export { generateAcsForScreen, generateAllAcs, getA11yRequirementsForComponent, getGlobalA11yRequirements, } from './ac-generator.js';
+export { buildUiContract, buildComponentTreeSummary } from './ui-contract-builder.js';
+export { buildSpecMarkdown, assembleResult } from './spec-builder.js';
+import type { DesignToSpecArgs, DesignToSpecResult } from '../../types/index.js';
+/**
+ * Main entry point: generates a structured spec from a design description.
+ * Orchestrates parser → AC generator → UI contract builder → spec assembler.
+ */
+export declare function generateSpecFromDesign(args: DesignToSpecArgs): DesignToSpecResult;
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/design-to-spec/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/design-to-spec/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAkB,MAAM,sBAAsB,CAAC;AAIjG;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG,kBAAkB,CAOjF"}

package/dist/engine/design-to-spec/index.js

@@ -0,0 +1,19 @@
+// engine/design-to-spec/index.ts — Barrel export for design-to-spec engine (SPEC-159)
+export { parseDesignDescription } from './parser.js';
+export { generateAcsForScreen, generateAllAcs, getA11yRequirementsForComponent, getGlobalA11yRequirements, } from './ac-generator.js';
+export { buildUiContract, buildComponentTreeSummary } from './ui-contract-builder.js';
+export { buildSpecMarkdown, assembleResult } from './spec-builder.js';
+import { parseDesignDescription } from './parser.js';
+import { assembleResult } from './spec-builder.js';
+/**
+ * Main entry point: generates a structured spec from a design description.
+ * Orchestrates parser → AC generator → UI contract builder → spec assembler.
+ */
+export function generateSpecFromDesign(args) {
+    const platform = args.platform ?? 'web';
+    const includeA11y = args.includeA11y ?? true;
+    const screenNames = args.screens ?? [];
+    const parsedDesign = parseDesignDescription(args.designDescription, screenNames, platform);
+    return assembleResult(parsedDesign, args.projectId, platform, includeA11y);
+}
+//# sourceMappingURL=index.js.map

package/dist/engine/design-to-spec/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/design-to-spec/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAsB;IAC3D,MAAM,QAAQ,GAAmB,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC;IACxD,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC;IAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IAEvC,MAAM,YAAY,GAAG,sBAAsB,CAAC,IAAI,CAAC,iBAAiB,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC3F,OAAO,cAAc,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC7E,CAAC"}

package/dist/engine/design-to-spec/parser.d.ts

@@ -0,0 +1,7 @@
+import type { ParsedDesign, DesignPlatform } from '../../types/index.js';
+/**
+ * Parses a design description string into a structured ParsedDesign representation.
+ * Extracts screens, components, breakpoints, and design tokens without any I/O.
+ */
+export declare function parseDesignDescription(description: string, screenNames: string[], platform: DesignPlatform): ParsedDesign;
+//# sourceMappingURL=parser.d.ts.map

package/dist/engine/design-to-spec/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/engine/design-to-spec/parser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EAQZ,cAAc,EACf,MAAM,sBAAsB,CAAC;AAwT9B;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EAAE,EACrB,QAAQ,EAAE,cAAc,GACvB,YAAY,CAmBd"}

package/dist/engine/design-to-spec/parser.js

@@ -0,0 +1,290 @@
+// engine/design-to-spec/parser.ts — Parse design description into structured screens/components (SPEC-159)
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const WEB_BREAKPOINTS = [
+    { name: 'mobile', minWidth: 0, maxWidth: 767, description: 'Mobile devices (portrait)' },
+    { name: 'tablet', minWidth: 768, maxWidth: 1023, description: 'Tablet devices' },
+    { name: 'desktop', minWidth: 1024, description: 'Desktop and larger screens' },
+];
+const MOBILE_BREAKPOINTS = [
+    { name: 'small', minWidth: 320, maxWidth: 374, description: 'Small mobile (320–374px)' },
+    { name: 'medium', minWidth: 375, maxWidth: 413, description: 'Standard mobile (375–413px)' },
+    { name: 'large', minWidth: 414, description: 'Large mobile (414px+)' },
+];
+const DESKTOP_BREAKPOINTS = [
+    { name: 'standard', minWidth: 1024, maxWidth: 1439, description: 'Standard desktop' },
+    { name: 'wide', minWidth: 1440, description: 'Wide / large desktop' },
+];
+const COMPONENT_KEYWORDS = {
+    form: ['form', 'input', 'submit', 'field', 'label', 'signup', 'login', 'register', 'checkout'],
+    button: ['button', 'btn', 'cta', 'action', 'click', 'tap', 'link'],
+    input: ['input', 'textbox', 'textarea', 'search', 'field', 'entry'],
+    list: ['list', 'table', 'grid', 'feed', 'items', 'rows', 'columns'],
+    modal: ['modal', 'dialog', 'popup', 'overlay', 'drawer', 'sheet'],
+    nav: ['nav', 'navigation', 'menu', 'sidebar', 'header', 'footer', 'tab', 'breadcrumb'],
+    card: ['card', 'tile', 'panel', 'widget', 'item', 'product'],
+    text: ['text', 'paragraph', 'heading', 'title', 'label', 'copy', 'content'],
+    image: ['image', 'img', 'photo', 'icon', 'avatar', 'thumbnail', 'banner'],
+    container: ['container', 'section', 'wrapper', 'layout', 'page', 'screen', 'view'],
+    other: [],
+};
+const INTERACTION_PATTERNS = [
+    { trigger: /hover/i, name: 'hover', visualChange: 'Highlight or shadow change on hover' },
+    { trigger: /click|tap/i, name: 'active', visualChange: 'Pressed state visual feedback' },
+    { trigger: /focus/i, name: 'focus', visualChange: 'Focus ring visible around element' },
+    { trigger: /disabled/i, name: 'disabled', visualChange: 'Reduced opacity, cursor: not-allowed' },
+    {
+        trigger: /loading|spinner/i,
+        name: 'loading',
+        visualChange: 'Loading spinner or skeleton shown',
+    },
+    { trigger: /error|invalid/i, name: 'error', visualChange: 'Red border, error message displayed' },
+    { trigger: /success|complete/i, name: 'success', visualChange: 'Success indicator shown' },
+];
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Infer component type from a name/description string */
+function inferComponentType(text) {
+    const lower = text.toLowerCase();
+    for (const [type, keywords] of Object.entries(COMPONENT_KEYWORDS)) {
+        if (type === 'other') {
+            continue;
+        }
+        if (keywords.some((kw) => lower.includes(kw))) {
+            return type;
+        }
+    }
+    return 'other';
+}
+/** Extract interaction states from a block of text */
+function extractInteractionStates(text) {
+    const states = [];
+    for (const pattern of INTERACTION_PATTERNS) {
+        if (pattern.trigger.test(text)) {
+            states.push({
+                name: pattern.name,
+                trigger: `User ${pattern.name}s the element`,
+                visualChange: pattern.visualChange,
+            });
+        }
+    }
+    // Always include default state
+    if (states.length === 0) {
+        states.push({ name: 'default', trigger: 'Element rendered', visualChange: 'Normal display' });
+    }
+    return states;
+}
+/** Build a minimal prop from a keyword */
+function buildProp(name, type, required, description) {
+    return { name, type, required, description };
+}
+/** Generate basic props based on component type */
+function generatePropsForType(componentType) {
+    switch (componentType) {
+        case 'button':
+            return [
+                buildProp('label', 'string', true, 'Button text label'),
+                buildProp('onClick', '() => void', true, 'Click handler'),
+                buildProp('disabled', 'boolean', false, 'Disables the button when true'),
+                buildProp('variant', "'primary' | 'secondary' | 'ghost'", false, 'Visual variant'),
+            ];
+        case 'input':
+            return [
+                buildProp('value', 'string', true, 'Current input value'),
+                buildProp('onChange', '(v: string) => void', true, 'Change handler'),
+                buildProp('placeholder', 'string', false, 'Placeholder text'),
+                buildProp('error', 'string', false, 'Error message to display'),
+            ];
+        case 'list':
+            return [
+                buildProp('items', 'unknown[]', true, 'Array of items to render'),
+                buildProp('loading', 'boolean', false, 'Shows loading state when true'),
+                buildProp('emptyMessage', 'string', false, 'Message when list is empty'),
+            ];
+        case 'modal':
+            return [
+                buildProp('isOpen', 'boolean', true, 'Controls modal visibility'),
+                buildProp('onClose', '() => void', true, 'Close handler'),
+                buildProp('title', 'string', false, 'Modal title'),
+            ];
+        case 'card':
+            return [
+                buildProp('title', 'string', true, 'Card title'),
+                buildProp('description', 'string', false, 'Card description text'),
+                buildProp('onClick', '() => void', false, 'Card click handler'),
+            ];
+        case 'container':
+        case 'form':
+        case 'nav':
+        case 'text':
+        case 'image':
+        case 'other':
+            // 'node' is a framework-agnostic placeholder — actual type depends on the project's UI framework
+            // (e.g. React.ReactNode, Vue's VNode, Angular's TemplateRef, plain HTMLElement, etc.)
+            return [buildProp('children', 'node', false, 'Child content')];
+    }
+}
+/** Slugify a name to a valid ID */
+function toId(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/(^-|-$)/g, '');
+}
+// ---------------------------------------------------------------------------
+// Screen extraction
+// ---------------------------------------------------------------------------
+/** Split description text into screen blocks by common screen delimiters */
+function splitIntoScreenBlocks(description, screenNames) {
+    if (screenNames.length > 0) {
+        // Use provided screen names as anchors
+        const blocks = [];
+        let remaining = description;
+        for (const name of screenNames) {
+            const idx = remaining.toLowerCase().indexOf(name.toLowerCase());
+            if (idx !== -1) {
+                const before = remaining.slice(0, idx).trim();
+                if (before) {
+                    blocks.push(before);
+                }
+                remaining = remaining.slice(idx);
+            }
+        }
+        if (remaining.trim()) {
+            blocks.push(remaining.trim());
+        }
+        return blocks.length > 1 ? blocks : [description];
+    }
+    // Auto-split on "Screen:", "Page:", "View:", or numbered sections
+    const screenPattern = /(?=(?:screen|page|view|section)\s*[:–-]?\s*\w)/gi;
+    const parts = description.split(screenPattern).filter(Boolean);
+    return parts.length > 1 ? parts : [description];
+}
+/** Extract component descriptions from a text block */
+function extractComponentsFromText(text) {
+    const components = [];
+    // Match bullet-style component descriptions
+    const bulletPattern = /[-•*]\s+(.+?)(?=\n[-•*]|\n\n|$)/gs;
+    let match;
+    let index = 0;
+    while ((match = bulletPattern.exec(text)) !== null) {
+        const raw = (match[1] ?? '').trim();
+        const type = inferComponentType(raw);
+        const id = `comp-${toId(raw.slice(0, 20))}-${index}`;
+        components.push({
+            id,
+            name: raw.slice(0, 50),
+            type,
+            description: raw,
+            props: generatePropsForType(type),
+            interactionStates: extractInteractionStates(raw),
+            a11yRequirements: [],
+            children: [],
+        });
+        index++;
+    }
+    // If no bullets found, treat whole block as single component
+    if (components.length === 0 && text.trim().length > 0) {
+        const type = inferComponentType(text);
+        components.push({
+            id: `comp-main-${index}`,
+            name: 'Main Content',
+            type,
+            description: text.slice(0, 200),
+            props: generatePropsForType(type),
+            interactionStates: extractInteractionStates(text),
+            a11yRequirements: [],
+            children: [],
+        });
+    }
+    return components;
+}
+/** Extract data bindings from text (looks for "bound to", "fetches", "loads", "displays") */
+function extractDataBindings(text, components) {
+    const bindings = [];
+    const bindingPattern = /(?:bound to|fetches|loads|displays|shows)\s+([\w\s]+?)(?:\.|,|from|via|$)/gi;
+    let match;
+    while ((match = bindingPattern.exec(text)) !== null) {
+        const dataSource = (match[1] ?? '').trim();
+        if (!dataSource) {
+            continue;
+        }
+        // Try to match the binding to the component whose description mentions the data source keyword;
+        // fall back to the first component if no specific match is found.
+        const keyword = dataSource.toLowerCase();
+        const targetComp = components.find((c) => c.description.toLowerCase().includes(keyword)) ?? components[0];
+        if (targetComp) {
+            bindings.push({
+                componentId: targetComp.id,
+                dataSource,
+                fieldMapping: `${toId(dataSource)} → ${targetComp.name}`,
+                loadingState: 'Loading indicator shown while fetching',
+                errorState: 'Error message displayed on fetch failure',
+            });
+        }
+    }
+    return bindings;
+}
+/** Parse a single screen block into a DesignScreen */
+function parseScreenBlock(block, index, screenNames, platform) {
+    const nameMatch = /^(?:screen|page|view|section)?\s*[:–-]?\s*([^\n.]+)/i.exec(block);
+    const screenName = screenNames[index] ?? nameMatch?.[1]?.trim() ?? `Screen ${index + 1}`;
+    const id = `screen-${toId(screenName)}-${index}`;
+    const breakpoints = platform === 'web'
+        ? WEB_BREAKPOINTS
+        : platform === 'mobile'
+            ? MOBILE_BREAKPOINTS
+            : DESKTOP_BREAKPOINTS;
+    const components = extractComponentsFromText(block);
+    const dataBindings = extractDataBindings(block, components);
+    return {
+        id,
+        name: screenName,
+        description: block.slice(0, 300).trim(),
+        components,
+        breakpoints,
+        acceptanceCriteria: [],
+        a11yRequirements: [],
+        dataBindings,
+    };
+}
+/** Extract design tokens from description (colors, fonts, spacing hints) */
+function extractDesignTokens(description) {
+    const tokens = [];
+    const colorPattern = /#[0-9a-fA-F]{3,6}|rgb\([^)]+\)|hsl\([^)]+\)/g;
+    let match;
+    let idx = 0;
+    while ((match = colorPattern.exec(description)) !== null) {
+        tokens.push({
+            name: `color-${idx++}`,
+            category: 'color',
+            value: match[0],
+        });
+    }
+    return tokens;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Parses a design description string into a structured ParsedDesign representation.
+ * Extracts screens, components, breakpoints, and design tokens without any I/O.
+ */
+export function parseDesignDescription(description, screenNames, platform) {
+    const trimmed = description.trim();
+    const titleMatch = /^([^\n.!?]{5,80})/.exec(trimmed);
+    const title = titleMatch?.[1]?.trim() ?? 'Untitled Design';
+    const blocks = splitIntoScreenBlocks(trimmed, screenNames);
+    const screens = blocks.map((block, i) => parseScreenBlock(block, i, screenNames, platform));
+    const tokens = extractDesignTokens(trimmed);
+    return {
+        title,
+        platform,
+        screens,
+        globalComponents: [],
+        designTokens: tokens,
+    };
+}
+//# sourceMappingURL=parser.js.map

package/dist/engine/design-to-spec/parser.js.map

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

package/dist/engine/design-to-spec/spec-builder.d.ts

@@ -0,0 +1,12 @@
+import type { ParsedDesign, DesignToSpecResult, DesignPlatform } from '../../types/index.js';
+/**
+ * Assembles a complete spec.md markdown string from a ParsedDesign.
+ * Includes: YAML frontmatter, description, UI contract, ACs per screen, a11y section.
+ */
+export declare function buildSpecMarkdown(design: ParsedDesign, projectId: string, platform: DesignPlatform, includeA11y: boolean): string;
+/**
+ * Assembles the full DesignToSpecResult from parsed design and config options.
+ * Pre-computes shared values once to avoid redundant calls inside buildSpecMarkdown.
+ */
+export declare function assembleResult(design: ParsedDesign, projectId: string, platform: DesignPlatform, includeA11y: boolean): DesignToSpecResult;
+//# sourceMappingURL=spec-builder.d.ts.map

package/dist/engine/design-to-spec/spec-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-builder.d.ts","sourceRoot":"","sources":["../../../src/engine/design-to-spec/spec-builder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,cAAc,EAGf,MAAM,sBAAsB,CAAC;AAiG9B;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,OAAO,GACnB,MAAM,CAaR;AAqDD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,OAAO,GACnB,kBAAkB,CA0BpB"}