@planu/cli 0.15.2

package/dist/tools/define-ui-contract-games.js

@@ -0,0 +1,183 @@
+// tools/define-ui-contract-games.ts — Game UI contract generation (SPEC-014a)
+// Generates UI contracts for game projects: HUD elements, menus, inventory, minimap.
+const GAME_FW_SET = new Set(['unity', 'godot', 'unreal', 'bevy', 'phaser', 'pygame']);
+/**
+ * Returns true if the project is a game based on framework or category.
+ */
+export function isGameProject(knowledge) {
+    if (knowledge.projectCategory === 'game') {
+        return true;
+    }
+    return knowledge.framework !== null && GAME_FW_SET.has(knowledge.framework);
+}
+/**
+ * Generate a game UI contract with HUD, menus, inventory, and dialog components.
+ */
+export function generateGameUIContract(screens, knowledge) {
+    const engine = knowledge.framework ?? 'unknown';
+    const engineTitle = engine.charAt(0).toUpperCase() + engine.slice(1);
+    const components = buildGameComponents(screens, engine);
+    const lines = [
+        `## Game UI Contract — ${engineTitle}`,
+        '',
+        '### HUD (Heads-Up Display)',
+        ...buildHUDSection(engine),
+        '',
+        '### Menus',
+        ...buildMenusSection(screens),
+        '',
+        '### Inventory & Items',
+        ...buildInventorySection(),
+        '',
+        '### Dialog & Notification System',
+        ...buildDialogSection(),
+        '',
+        '### Component Tree',
+        '```json',
+        JSON.stringify(components, null, 2),
+        '```',
+    ];
+    return lines.join('\n');
+}
+function buildHUDSection(engine) {
+    const isBrowser = engine === 'phaser';
+    const prefix = isBrowser ? 'DOM/Canvas' : 'Scene';
+    return [
+        `- **HealthBar** (${prefix}): current/max HP, animated fill, color thresholds`,
+        `- **MiniMap** (${prefix}): player position, enemies, objectives overlay`,
+        `- **ScoreDisplay** (${prefix}): points counter, combo multiplier, high score`,
+        `- **AbilityBar** (${prefix}): cooldown timers, active/inactive states, hotkeys`,
+        `- **ResourceCounters** (${prefix}): ammo/mana/stamina with icon + value`,
+    ];
+}
+function buildMenusSection(screens) {
+    const menuScreens = screens.filter((s) => s.toLowerCase().includes('menu') || s.toLowerCase().includes('pause'));
+    const lines = [
+        '- **MainMenu**: Play, Continue, Settings, Credits, Quit buttons',
+        '- **PauseMenu**: Resume, Settings, Save, Main Menu — overlay on gameplay',
+        '- **SettingsMenu**: Audio (master/music/sfx), Graphics (quality/resolution), Controls',
+        '- **GameOverScreen**: Score, Best Score, Retry, Main Menu',
+        '- **VictoryScreen**: Score breakdown, stars/grade, Next Level, Replay',
+    ];
+    for (const screen of menuScreens) {
+        const normalized = screen.toLowerCase().replace(/[-_\s]/g, '');
+        if (normalized !== 'mainmenu' && normalized !== 'pausemenu') {
+            lines.push(`- **${screen}**: custom screen from spec`);
+        }
+    }
+    return lines;
+}
+function buildInventorySection() {
+    return [
+        '- **InventoryGrid**: NxM slot grid, item stacking, drag-and-drop',
+        '- **ItemSlot**: icon, quantity badge, durability bar, rarity color border',
+        '- **ItemTooltip**: name, description, stats comparison, use/equip button',
+        '- **EquipmentSlots**: character paper-doll with named equipment slots',
+        '- **Hotbar**: 1-9 quick access slots with keyboard bindings',
+    ];
+}
+function buildDialogSection() {
+    return [
+        '- **DialogBox**: NPC portrait, speaker name, dialog text with typewriter effect',
+        '- **ChoiceDialog**: dialog text + up to 4 selectable response options',
+        '- **NotificationToast**: achievement/item obtained banners (auto-dismiss 3s)',
+        '- **ConfirmationModal**: destructive action confirmation (delete save, quit)',
+    ];
+}
+function buildGameComponents(screens, engine) {
+    const hudChildren = [
+        {
+            name: 'HealthBar',
+            type: 'client',
+            justification: 'Reactive HUD element that updates on player health changes',
+            props: [
+                { name: 'current', type: 'number', required: true, description: 'Current HP value' },
+                { name: 'max', type: 'number', required: true, description: 'Maximum HP value' },
+            ],
+            children: [],
+        },
+        {
+            name: 'ScoreDisplay',
+            type: 'client',
+            justification: 'Animated score counter that reacts to score events',
+            props: [
+                { name: 'score', type: 'number', required: true, description: 'Current score' },
+                {
+                    name: 'animated',
+                    type: 'boolean',
+                    required: false,
+                    description: 'Enable count-up animation',
+                },
+            ],
+            children: [],
+        },
+        {
+            name: 'MiniMap',
+            type: 'client',
+            justification: 'Renders live map overlay with player and entity positions',
+            props: [
+                {
+                    name: 'size',
+                    type: 'number',
+                    required: false,
+                    description: 'Minimap display size in px',
+                },
+            ],
+            children: [],
+        },
+    ];
+    const menuChildren = screens.map((s) => ({
+        name: s,
+        type: 'client',
+        justification: 'Game screen rendered as interactive client component',
+        props: [],
+        children: [],
+    }));
+    return [
+        {
+            name: 'GameCanvas',
+            type: 'client',
+            justification: `Root ${engine} game canvas — all rendering is client-side`,
+            props: [
+                { name: 'engine', type: 'string', required: true, description: 'Game engine identifier' },
+                {
+                    name: 'fullscreen',
+                    type: 'boolean',
+                    required: false,
+                    description: 'Launch in fullscreen mode',
+                },
+            ],
+            children: [
+                {
+                    name: 'HUDLayer',
+                    type: 'client',
+                    justification: 'Overlay layer rendered above the game world at fixed z-index',
+                    props: [
+                        {
+                            name: 'zIndex',
+                            type: 'number',
+                            required: false,
+                            description: 'CSS/canvas layer order',
+                        },
+                    ],
+                    children: hudChildren,
+                },
+                {
+                    name: 'MenuLayer',
+                    type: 'client',
+                    justification: 'Overlay layer for all game menus, above HUD',
+                    props: [
+                        {
+                            name: 'zIndex',
+                            type: 'number',
+                            required: false,
+                            description: 'CSS/canvas layer order',
+                        },
+                    ],
+                    children: menuChildren,
+                },
+            ],
+        },
+    ];
+}
+//# sourceMappingURL=define-ui-contract-games.js.map

package/dist/tools/define-ui-contract-games.js.map

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

package/dist/tools/define-ui-contract-mobile.d.ts

@@ -0,0 +1,5 @@
+import type { ProjectKnowledge } from '../types/index.js';
+export declare const MOBILE_FRAMEWORKS: Set<string>;
+export declare function isMobileFramework(framework: string | null): boolean;
+export declare function generateMobileUIContract(screens: string[], knowledge: Pick<ProjectKnowledge, 'framework'>): string;
+//# sourceMappingURL=define-ui-contract-mobile.d.ts.map

package/dist/tools/define-ui-contract-mobile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-ui-contract-mobile.d.ts","sourceRoot":"","sources":["../../src/tools/define-ui-contract-mobile.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,eAAO,MAAM,iBAAiB,aAS5B,CAAC;AAEH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAEnE;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,GAC7C,MAAM,CAOR"}

package/dist/tools/define-ui-contract-mobile.js

@@ -0,0 +1,115 @@
+// tools/define-ui-contract-mobile.ts — Mobile UI contract generation (SPEC-013)
+// Contains mobile-specific contract generation for SwiftUI, UIKit, Jetpack Compose,
+// Android XML Views, Flutter, and React Native.
+export const MOBILE_FRAMEWORKS = new Set([
+    'swiftui',
+    'uikit',
+    'jetpack-compose',
+    'compose',
+    'android-views',
+    'xml-views',
+    'flutter',
+    'react-native',
+]);
+export function isMobileFramework(framework) {
+    return MOBILE_FRAMEWORKS.has((framework ?? '').toLowerCase());
+}
+export function generateMobileUIContract(screens, knowledge) {
+    const fw = (knowledge.framework ?? '').toLowerCase();
+    const blocks = screens.map((screen) => {
+        const name = toPascalCase(screen);
+        return generateMobileScreenContract(name, fw);
+    });
+    return blocks.join('\n\n---\n\n');
+}
+function generateMobileScreenContract(name, fw) {
+    if (fw === 'swiftui') {
+        return (`## UI Contract — SwiftUI\n\n` +
+            `### View: ${name}View\n\n` +
+            `**Protocol:** \`View\`\n` +
+            `**State Management:**\n` +
+            `- \`@State\` — local ephemeral state\n` +
+            `- \`@ObservedObject\` / \`@StateObject\` — ViewModel observation\n` +
+            `- \`@EnvironmentObject\` — shared app-wide state\n` +
+            `- \`@Binding\` — two-way parent→child binding\n\n` +
+            `**Signature:**\n` +
+            `\`\`\`swift\n` +
+            `struct ${name}View: View {\n` +
+            `    @StateObject private var viewModel = ${name}ViewModel()\n` +
+            `    var body: some View { ... }\n` +
+            `}\n` +
+            `\`\`\`\n\n` +
+            `**Data Flow:** ViewModel → @Published → View (re-renders on change)\n` +
+            `**Environment Values:** colorScheme, sizeCategory, dismiss, navigationPath`);
+    }
+    if (fw === 'uikit') {
+        return (`## UI Contract — UIKit\n\n` +
+            `### ViewController: ${name}ViewController\n\n` +
+            `**Subclass:** \`UIViewController\`\n` +
+            `**Lifecycle:** viewDidLoad → viewWillAppear → viewDidAppear\n` +
+            `**Configuration:** \`setupUI()\`, \`bindViewModel()\`\n` +
+            `**IBOutlets:** \`@IBOutlet weak var titleLabel: UILabel!\`\n` +
+            `**IBActions:** \`@IBAction func primaryButtonTapped(_ sender: UIButton)\`\n` +
+            `**Data Flow:** ViewModel → closures/delegates → UIViewController`);
+    }
+    if (fw === 'jetpack-compose' || fw === 'compose') {
+        return (`## UI Contract — Jetpack Compose\n\n` +
+            `### Composable: ${name}Screen\n\n` +
+            `**Type:** Stateful Composable\n` +
+            `**Signature:**\n` +
+            `\`\`\`kotlin\n` +
+            `@Composable\n` +
+            `fun ${name}Screen(\n` +
+            `    viewModel: ${name}ViewModel = hiltViewModel(),\n` +
+            `    onNavigateBack: () -> Unit\n` +
+            `) {\n` +
+            `    val uiState by viewModel.uiState.collectAsStateWithLifecycle()\n` +
+            `    ${name}Content(uiState = uiState, onAction = viewModel::onAction)\n` +
+            `}\n` +
+            `\`\`\`\n\n` +
+            `**State Hoisting:** Stateless \`${name}Content\` composable receives state + lambdas\n` +
+            `**Events:** Sealed \`${name}Action\` class for user interactions\n` +
+            `**Side Effects:** \`LaunchedEffect\`, \`DisposableEffect\` for lifecycle-aware operations`);
+    }
+    if (fw === 'android-views' || fw === 'xml-views') {
+        return (`## UI Contract — Android XML Views\n\n` +
+            `### Fragment: ${name}Fragment\n\n` +
+            `**Binding:** \`Fragment${name}Binding\` (ViewBinding)\n` +
+            `**ViewModel:** \`${name}ViewModel\` via \`by viewModels()\`\n` +
+            `**Observers:**\n` +
+            `\`\`\`kotlin\n` +
+            `viewModel.uiState.observe(viewLifecycleOwner) { state -> render(state) }\n` +
+            `\`\`\`\n` +
+            `**Navigation:** NavController with SafeArgs`);
+    }
+    if (fw === 'flutter') {
+        return (`## UI Contract — Flutter\n\n` +
+            `### Widget: ${name}Screen\n\n` +
+            `**Type:** StatefulWidget or ConsumerWidget (Riverpod)\n` +
+            `**State:** \`${name}Controller\` via StateNotifier / Cubit\n` +
+            `**Navigation:** \`GoRouter\` named route\n` +
+            `**Data Flow:** Provider/Riverpod → Widget rebuild on state change`);
+    }
+    if (fw === 'react-native') {
+        return (`## UI Contract — React Native\n\n` +
+            `### Screen: ${name}Screen\n\n` +
+            `**Navigation:** React Navigation — Stack / Tab / Drawer\n` +
+            `**State:** Zustand / Redux Toolkit / Context\n` +
+            `**Signature:**\n` +
+            `\`\`\`tsx\n` +
+            `export function ${name}Screen(): React.JSX.Element {\n` +
+            `  const { data, isLoading } = use${name}();\n` +
+            `  return <${name}View data={data} isLoading={isLoading} />;\n` +
+            `}\n` +
+            `\`\`\`\n` +
+            `**Data Flow:** Custom hook → state → presentational component`);
+    }
+    return `## UI Contract — Mobile (${fw})\n\n### Screen: ${name}Screen\n\nNo specific contract template available for framework: ${fw}`;
+}
+function toPascalCase(str) {
+    return str
+        .split(/[-_\s]+/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join('');
+}
+//# sourceMappingURL=define-ui-contract-mobile.js.map

package/dist/tools/define-ui-contract-mobile.js.map

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

package/dist/tools/define-ui-contract-web/component-tree.d.ts

@@ -0,0 +1,4 @@
+import type { ComponentNode, ProjectKnowledge } from '../../types/index.js';
+export declare function toPascalCase(str: string): string;
+export declare function generateComponentTree(screenNames: string[], specContent: string, knowledge: ProjectKnowledge): ComponentNode[];
+//# sourceMappingURL=component-tree.d.ts.map

package/dist/tools/define-ui-contract-web/component-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-tree.d.ts","sourceRoot":"","sources":["../../../src/tools/define-ui-contract-web/component-tree.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAkB,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE5F,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKhD;AAID,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EAAE,EACrB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,GAC1B,aAAa,EAAE,CAsBjB"}

package/dist/tools/define-ui-contract-web/component-tree.js

@@ -0,0 +1,240 @@
+// tools/define-ui-contract-web/component-tree.ts — Component tree generation for web frontends
+export function toPascalCase(str) {
+    return str
+        .split(/[-_\s]+/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join('');
+}
+// -- Component tree generation ------------------------------------------------
+export function generateComponentTree(screenNames, specContent, knowledge) {
+    const framework = knowledge.framework ?? 'react';
+    const isReact = framework.toLowerCase().includes('react') || framework.toLowerCase().includes('next');
+    return screenNames.map((screenName) => {
+        const children = generateScreenComponents(screenName, specContent, isReact);
+        return {
+            name: `${toPascalCase(screenName)}Page`,
+            type: isReact ? 'server' : 'client',
+            justification: isReact
+                ? 'Page-level component can be server-rendered for SEO and initial load'
+                : 'Vue/Svelte pages are client-rendered by default',
+            props: [],
+            children,
+            stateManagement: children.some((c) => c.type === 'client')
+                ? 'local + context'
+                : 'server state',
+            dataSource: 'server-side fetch',
+        };
+    });
+}
+function generateScreenComponents(screenName, specContent, _isReact) {
+    const components = [];
+    const lower = specContent.toLowerCase();
+    components.push({
+        name: `${toPascalCase(screenName)}Header`,
+        type: 'server',
+        justification: 'Static header can be server-rendered',
+        props: [
+            { name: 'title', type: 'string', required: true, description: 'Page title' },
+            {
+                name: 'breadcrumbs',
+                type: 'BreadcrumbItem[]',
+                required: false,
+                description: 'Navigation breadcrumbs',
+            },
+        ],
+        children: [],
+    });
+    if (lower.includes('form') ||
+        lower.includes('input') ||
+        lower.includes('submit') ||
+        lower.includes('create') ||
+        lower.includes('edit') ||
+        lower.includes('update')) {
+        components.push(generateFormComponent(screenName, specContent));
+    }
+    if (lower.includes('list') ||
+        lower.includes('table') ||
+        lower.includes('grid') ||
+        lower.includes('display') ||
+        lower.includes('show') ||
+        lower.includes('browse')) {
+        components.push(generateListComponent(screenName));
+    }
+    if (lower.includes('detail') ||
+        lower.includes('view') ||
+        lower.includes('profile') ||
+        lower.includes('info') ||
+        lower.includes('summary')) {
+        components.push(generateDetailComponent(screenName));
+    }
+    if (lower.includes('action') ||
+        lower.includes('button') ||
+        lower.includes('save') ||
+        lower.includes('delete') ||
+        lower.includes('confirm')) {
+        components.push({
+            name: `${toPascalCase(screenName)}Actions`,
+            type: 'client',
+            justification: 'Action buttons require client interactivity',
+            props: [
+                {
+                    name: 'onAction',
+                    type: '(action: string) => void',
+                    required: true,
+                    description: 'Action handler callback',
+                },
+                {
+                    name: 'isLoading',
+                    type: 'boolean',
+                    required: false,
+                    description: 'Disable actions while loading',
+                },
+            ],
+            children: [],
+            stateManagement: 'local',
+        });
+    }
+    if (components.length === 1) {
+        components.push({
+            name: `${toPascalCase(screenName)}Content`,
+            type: 'client',
+            justification: 'Main content area with interactive elements',
+            props: [{ name: 'data', type: 'unknown', required: true, description: 'Content data' }],
+            children: [],
+            stateManagement: 'local',
+        });
+    }
+    return components;
+}
+function generateFormComponent(screenName, specContent) {
+    const fields = extractFormFields(specContent);
+    const props = [
+        {
+            name: 'initialValues',
+            type: 'Partial<FormValues>',
+            required: false,
+            description: 'Pre-filled values for edit mode',
+        },
+        {
+            name: 'onSubmit',
+            type: '(values: FormValues) => Promise<void>',
+            required: true,
+            description: 'Submit handler',
+        },
+        { name: 'isLoading', type: 'boolean', required: false, description: 'Submit loading state' },
+        {
+            name: 'errors',
+            type: 'Record<string, string>',
+            required: false,
+            description: 'Field validation errors',
+        },
+    ];
+    return {
+        name: `${toPascalCase(screenName)}Form`,
+        type: 'client',
+        justification: 'Forms require client-side state management and validation',
+        props,
+        children: fields.map((field) => ({
+            name: `${toPascalCase(field)}Field`,
+            type: 'client',
+            justification: 'Form field with validation',
+            props: [
+                { name: 'value', type: 'string', required: true, description: `Current ${field} value` },
+                {
+                    name: 'onChange',
+                    type: '(value: string) => void',
+                    required: true,
+                    description: 'Change handler',
+                },
+                {
+                    name: 'error',
+                    type: 'string | undefined',
+                    required: false,
+                    description: 'Validation error',
+                },
+            ],
+            children: [],
+        })),
+        stateManagement: 'form-library or local state',
+        dataSource: 'user input',
+    };
+}
+function generateListComponent(screenName) {
+    return {
+        name: `${toPascalCase(screenName)}List`,
+        type: 'client',
+        justification: 'Lists require client-side sorting, filtering, and pagination',
+        props: [
+            { name: 'items', type: 'Item[]', required: true, description: 'Array of items to display' },
+            {
+                name: 'onItemClick',
+                type: '(id: string) => void',
+                required: false,
+                description: 'Item click handler',
+            },
+            { name: 'sortBy', type: 'string', required: false, description: 'Current sort field' },
+            { name: 'filterQuery', type: 'string', required: false, description: 'Filter search query' },
+            { name: 'isLoading', type: 'boolean', required: false, description: 'Loading state' },
+            {
+                name: 'emptyMessage',
+                type: 'string',
+                required: false,
+                description: 'Message when no items',
+            },
+        ],
+        children: [
+            {
+                name: `${toPascalCase(screenName)}ListItem`,
+                type: 'client',
+                justification: 'Individual list items with click handlers',
+                props: [
+                    { name: 'item', type: 'Item', required: true, description: 'Item data' },
+                    { name: 'onClick', type: '() => void', required: false, description: 'Click handler' },
+                ],
+                children: [],
+            },
+        ],
+        stateManagement: 'local (sort/filter state)',
+        dataSource: 'API fetch',
+    };
+}
+function generateDetailComponent(screenName) {
+    return {
+        name: `${toPascalCase(screenName)}Detail`,
+        type: 'server',
+        justification: 'Detail views can be server-rendered for faster initial load',
+        props: [{ name: 'id', type: 'string', required: true, description: 'Entity ID to display' }],
+        children: [
+            {
+                name: `${toPascalCase(screenName)}DetailContent`,
+                type: 'server',
+                justification: 'Static display of entity details',
+                props: [{ name: 'data', type: 'EntityDetail', required: true, description: 'Entity data' }],
+                children: [],
+            },
+        ],
+        dataSource: 'server-side fetch by ID',
+    };
+}
+function extractFormFields(content) {
+    const fields = [];
+    const patterns = [
+        /(?:field|input|enter|provide)\s+(?:the\s+)?["']?(\w+)["']?/gi,
+        /(\w+)\s+(?:field|input|box|area|selector)/gi,
+    ];
+    const seen = new Set();
+    for (const pattern of patterns) {
+        const matches = content.matchAll(pattern);
+        for (const match of matches) {
+            if (match[1] && match[1].length > 2 && !seen.has(match[1].toLowerCase())) {
+                seen.add(match[1].toLowerCase());
+                fields.push(match[1].toLowerCase());
+            }
+        }
+    }
+    if (fields.length === 0) {
+        fields.push('name', 'description');
+    }
+    return fields.slice(0, 8);
+}
+//# sourceMappingURL=component-tree.js.map

package/dist/tools/define-ui-contract-web/component-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-tree.js","sourceRoot":"","sources":["../../../src/tools/define-ui-contract-web/component-tree.ts"],"names":[],"mappings":"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"}

package/dist/tools/define-ui-contract-web/index.d.ts

@@ -0,0 +1,3 @@
+export { generateComponentTree, toPascalCase } from './component-tree.js';
+export { generateDataFlow, generateLoadingStates, generateErrorStates } from './states.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/define-ui-contract-web/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/define-ui-contract-web/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/tools/define-ui-contract-web/index.js

@@ -0,0 +1,4 @@
+// tools/define-ui-contract-web/index.ts — barrel re-exports for define-ui-contract-web sub-modules
+export { generateComponentTree, toPascalCase } from './component-tree.js';
+export { generateDataFlow, generateLoadingStates, generateErrorStates } from './states.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/define-ui-contract-web/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/define-ui-contract-web/index.ts"],"names":[],"mappings":"AAAA,mGAAmG;AAEnG,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/tools/define-ui-contract-web/states.d.ts

@@ -0,0 +1,5 @@
+import type { ComponentNode, UIDataFlow, LoadingState, ErrorState, ProjectKnowledge } from '../../types/index.js';
+export declare function generateDataFlow(componentTree: ComponentNode[], knowledge: ProjectKnowledge): UIDataFlow[];
+export declare function generateLoadingStates(componentTree: ComponentNode[]): LoadingState[];
+export declare function generateErrorStates(componentTree: ComponentNode[]): ErrorState[];
+//# sourceMappingURL=states.d.ts.map

package/dist/tools/define-ui-contract-web/states.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"states.d.ts","sourceRoot":"","sources":["../../../src/tools/define-ui-contract-web/states.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,YAAY,EACZ,UAAU,EACV,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAI9B,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,aAAa,EAAE,EAC9B,SAAS,EAAE,gBAAgB,GAC1B,UAAU,EAAE,CA0Cd;AAID,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,aAAa,EAAE,GAAG,YAAY,EAAE,CAsCpF;AAID,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,aAAa,EAAE,GAAG,UAAU,EAAE,CAmDhF"}