@stephen-netu/design-system 0.1.0 → 0.2.1

package/{src → dist}/fabric/navigation/ActivityRail.svelte

@@ -46,7 +46,15 @@
     ondropstreamcard?: (item: RailItem, data: { content: string; contentType: string; source: string }) => void;
   }
 
-  const props: Props = $props();
+  let {
+    appItems,
+    viewItems,
+    panelItems,
+    activeAppId,
+    onitemclick,
+    onopenhelp,
+    ondropstreamcard,
+  }: Props = $props();
 
   const ICON_MAP: Record<string, IconComponent> = {
     'layout-grid': LayoutGrid,
@@ -94,7 +102,7 @@
   function handleDrop(item: RailItem, e: DragEvent) {
     e.preventDefault();
     dropTargetId = null;
-    if (!props.ondropstreamcard || item.type !== 'app') return;
+    if (!ondropstreamcard || item.type !== 'app') return;
 
     try {
       const data = e.dataTransfer?.getData('application/json');
@@ -102,7 +110,7 @@
       const payload = JSON.parse(data);
       if (payload.type !== 'stream-card') return;
 
-      props.ondropstreamcard(
+      ondropstreamcard(
         item,
         { content: payload.content, contentType: payload.contentType, source: payload.source }
       );
@@ -113,11 +121,11 @@
 </script>
 
 <nav class="activity-rail" aria-label="Activity navigation">
-  <div class="rail-brand">⬡</div>
+  <div class="rail-brand scanlines">⬡</div>
 
   <!-- App buttons -->
   <div class="rail-section rail-apps">
-    {#each props.appItems as item (item.id)}
+    {#each appItems as item (item.id)}
       {@const Icon = getIcon(item.iconName)}
       <button
         class="rail-btn"
@@ -126,7 +134,7 @@
         class:disabled={item.disabled}
         title={item.title ?? item.label}
         aria-label={item.label}
-        onclick={() => props.onitemclick(item)}
+        onclick={() => onitemclick(item)}
         ondragover={(e) => handleDragOver(item, e)}
         ondragleave={handleDragLeave}
         ondrop={(e) => handleDrop(item, e)}
@@ -140,7 +148,7 @@
 
   <!-- View buttons -->
   <div class="rail-section">
-    {#each props.viewItems as item (item.id)}
+    {#each viewItems as item (item.id)}
       {@const Icon = getIcon(item.iconName)}
       <button
         class="rail-btn"
@@ -148,7 +156,7 @@
         class:disabled={item.disabled}
         title={item.label}
         aria-label={item.label}
-        onclick={() => props.onitemclick(item)}
+        onclick={() => onitemclick(item)}
       >
         <Icon size={18} />
       </button>
@@ -157,7 +165,7 @@
 
   <!-- Panel toggles -->
   <div class="rail-section rail-panels">
-    {#each props.panelItems as item (item.id)}
+    {#each panelItems as item (item.id)}
       {@const Icon = getIcon(item.iconName)}
       <button
         class="rail-btn"
@@ -165,7 +173,7 @@
         class:disabled={item.disabled}
         title={item.label}
         aria-label={item.label}
-        onclick={() => props.onitemclick(item)}
+        onclick={() => onitemclick(item)}
       >
         <Icon size={18} />
       </button>
@@ -178,7 +186,7 @@
     class="rail-btn"
     title="Keyboard shortcuts (?)"
     aria-label="Keyboard shortcuts"
-    onclick={() => props.onopenhelp?.()}
+    onclick={() => onopenhelp?.()}
   >
     <HelpCircle size={18} />
   </button>
@@ -191,10 +199,10 @@
     align-items: center;
     width: 48px;
     height: 100%;
-    background: var(--color-bg-canvas, #1a1a1a);
-    border-right: 1px solid var(--border-subtle, rgba(255,255,255,0.06));
+    background: var(--color-bg-canvas);
+    border-right: 2px solid var(--border-default);
     padding: 4px 0;
-    gap: 2px;
+    gap: var(--space-05);
   }
 
   .rail-brand {
@@ -202,7 +210,7 @@
     align-items: center;
     justify-content: center;
     height: 36px;
-    color: var(--color-accent, #b87333);
+    color: var(--color-accent);
     font-size: 16px;
     flex-shrink: 0;
     margin-bottom: 4px;
@@ -212,19 +220,19 @@
     display: flex;
     flex-direction: column;
     align-items: center;
-    gap: 2px;
+    gap: var(--space-05);
     width: 100%;
   }
 
   .rail-divider {
     width: 24px;
-    height: 1px;
-    background: var(--border-subtle, rgba(255,255,255,0.08));
+    height: 2px;
+    background: var(--border-subtle);
     margin: 4px 0;
   }
 
   .rail-panels {
-    border-top: 1px solid var(--border-subtle, rgba(255,255,255,0.06));
+    border-top: 2px solid var(--border-subtle);
     padding-top: 4px;
     margin-top: 4px;
   }
@@ -237,35 +245,40 @@
     width: 36px;
     height: 36px;
     background: transparent;
-    border: none;
-    color: var(--color-text-tertiary, #706858);
+    border: 2px solid var(--border-subtle);
+    border-radius: 0; /* Military sharp edges */
+    color: var(--color-text-tertiary);
     cursor: pointer;
-    border-radius: var(--radius-lg, 0.5rem);
     display: flex;
     align-items: center;
     justify-content: center;
-    transition: background 120ms, color 120ms, box-shadow 120ms;
+    transition: background var(--transition-fast), color var(--transition-fast), border-color var(--transition-fast);
     flex-shrink: 0;
+    padding: 0;
   }
 
   .rail-btn:hover {
-    background: rgba(255,255,255,0.05);
-    color: var(--color-text-secondary, #a09880);
+    background: var(--color-bg-panel);
+    color: var(--color-text-secondary);
+    border-color: var(--border-hover);
   }
 
   .rail-btn.active {
-    background: var(--color-accent-subtle, rgba(184, 115, 51, 0.15));
-    color: var(--color-accent, #b87333);
+    background: var(--color-accent-subtle);
+    color: var(--color-accent);
+    border-color: var(--color-accent);
   }
 
   .rail-btn.drag-over {
-    background: rgba(184, 115, 51, 0.25);
-    box-shadow: 0 0 8px rgba(184, 115, 51, 0.4);
-    color: var(--color-accent, #b87333);
+    background: var(--color-accent-subtle);
+    box-shadow: var(--shadow-accent-glow);
+    border-color: var(--color-accent);
+    color: var(--color-accent);
   }
 
   .rail-btn.disabled {
     opacity: 0.3;
     pointer-events: none;
+    border-color: var(--border-subtle);
   }
-</style>
+</style>

package/dist/fabric/navigation/ActivityRail.svelte.d.ts

@@ -0,0 +1,34 @@
+export type RailItemType = 'app' | 'view' | 'panel';
+export interface RailItem {
+    id: string;
+    type: RailItemType;
+    label: string;
+    iconName: string;
+    active?: boolean;
+    disabled?: boolean;
+    title?: string;
+}
+interface Props {
+    /** App-level items (top section) */
+    appItems: RailItem[];
+    /** View-level items (middle section) */
+    viewItems: RailItem[];
+    /** Panel toggle items (bottom section) */
+    panelItems: RailItem[];
+    /** Currently active app ID */
+    activeAppId?: string;
+    /** Callback when item is clicked */
+    onitemclick: (item: RailItem) => void;
+    /** Callback for help button */
+    onopenhelp?: () => void;
+    /** Enable drag-drop for stream cards (app items only) */
+    ondropstreamcard?: (item: RailItem, data: {
+        content: string;
+        contentType: string;
+        source: string;
+    }) => void;
+}
+declare const ActivityRail: import("svelte").Component<Props, {}, "">;
+type ActivityRail = ReturnType<typeof ActivityRail>;
+export default ActivityRail;
+//# sourceMappingURL=ActivityRail.svelte.d.ts.map

package/dist/fabric/navigation/ActivityRail.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityRail.svelte.d.ts","sourceRoot":"","sources":["../../../src/fabric/navigation/ActivityRail.svelte.ts"],"names":[],"mappings":"AAsBE,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,KAAK;IACb,oCAAoC;IACpC,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,wCAAwC;IACxC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,0CAA0C;IAC1C,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,WAAW,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACtC,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC7G;AA+HH,QAAA,MAAM,YAAY,2CAAwC,CAAC;AAC3D,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AACpD,eAAe,YAAY,CAAC"}

package/dist/fabric/navigation/ActivityRail.test.js

@@ -0,0 +1,82 @@
+import { afterEach, describe, it, expect, vi } from 'vitest';
+import { cleanup, render, fireEvent } from '@testing-library/svelte';
+import ActivityRail from './ActivityRail.svelte';
+const baseProps = {
+    appItems: [],
+    viewItems: [],
+    panelItems: [],
+    onitemclick: vi.fn(),
+};
+describe('ActivityRail', () => {
+    afterEach(() => cleanup());
+    it('renders nav element with activity-rail class', () => {
+        const { container } = render(ActivityRail, { props: baseProps });
+        expect(container.querySelector('nav.activity-rail')).toBeTruthy();
+    });
+    it('renders app items and view items as buttons', () => {
+        const props = {
+            ...baseProps,
+            appItems: [
+                { id: 'app1', type: 'app', label: 'Ryu', iconName: 'gauge' },
+                { id: 'app2', type: 'app', label: 'Agora', iconName: 'message-circle' },
+            ],
+            viewItems: [
+                { id: 'view1', type: 'view', label: 'Inbox', iconName: 'inbox' },
+            ],
+        };
+        const { container } = render(ActivityRail, { props });
+        const buttons = container.querySelectorAll('.rail-btn');
+        expect(buttons.length).toBe(4); // 2 app + 1 view + 1 help button
+    });
+    it('applies active class to items with active=true', () => {
+        const props = {
+            ...baseProps,
+            appItems: [
+                { id: 'app1', type: 'app', label: 'Ryu', iconName: 'gauge', active: true },
+                { id: 'app2', type: 'app', label: 'Agora', iconName: 'message-circle', active: false },
+            ],
+        };
+        const { container } = render(ActivityRail, { props });
+        const buttons = container.querySelectorAll('.rail-btn');
+        expect(buttons[0].classList.contains('active')).toBe(true);
+        expect(buttons[1].classList.contains('active')).toBe(false);
+    });
+    it('calls onitemclick with the correct item when a button is clicked', async () => {
+        const onitemclick = vi.fn();
+        const appItem = { id: 'app1', type: 'app', label: 'Ryu', iconName: 'gauge' };
+        const props = {
+            ...baseProps,
+            appItems: [appItem],
+            onitemclick,
+        };
+        const { container } = render(ActivityRail, { props });
+        const btn = container.querySelector('.rail-btn');
+        await fireEvent.click(btn);
+        expect(onitemclick).toHaveBeenCalledTimes(1);
+        expect(onitemclick).toHaveBeenCalledWith(appItem);
+    });
+    it('renders panel items in the panel section', () => {
+        const props = {
+            ...baseProps,
+            panelItems: [
+                { id: 'p1', type: 'panel', label: 'Help', iconName: 'help-circle' },
+            ],
+        };
+        const { container } = render(ActivityRail, { props });
+        const panelSection = container.querySelector('.rail-panels');
+        expect(panelSection).toBeTruthy();
+        expect(panelSection.querySelectorAll('.rail-btn').length).toBe(1);
+    });
+    it('renders the brand glyph', () => {
+        const { container } = render(ActivityRail, { props: baseProps });
+        expect(container.querySelector('.rail-brand')).toBeTruthy();
+    });
+    it('calls onopenhelp when the help button is clicked', async () => {
+        const onopenhelp = vi.fn();
+        const { container } = render(ActivityRail, { props: { ...baseProps, onopenhelp } });
+        const helpBtn = container.querySelector('button[title="Keyboard shortcuts (?)"]');
+        expect(helpBtn).toBeTruthy();
+        await fireEvent.click(helpBtn);
+        expect(onopenhelp).toHaveBeenCalledTimes(1);
+    });
+});

package/{src/fabric/navigation/index.ts → dist/fabric/navigation/index.d.ts}

@@ -1,11 +1,11 @@
 /**
  * Fabric Navigation Components
- * 
+ *
  * Navigation patterns for app switching and view selection.
- * 
+ *
  * @package @kos/design-system/fabric/navigation
  * @adr 2026-04-12-leap-substrate-refactor-001
  */
-
 export { default as ActivityRail } from './ActivityRail.svelte';
 export type { RailItem, RailItemType } from './ActivityRail.svelte';
+//# sourceMappingURL=index.d.ts.map

package/dist/fabric/navigation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fabric/navigation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/fabric/navigation/index.js

@@ -0,0 +1,9 @@
+/**
+ * Fabric Navigation Components
+ *
+ * Navigation patterns for app switching and view selection.
+ *
+ * @package @kos/design-system/fabric/navigation
+ * @adr 2026-04-12-leap-substrate-refactor-001
+ */
+export { default as ActivityRail } from './ActivityRail.svelte';

package/dist/g0-generative/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * g0-generative — OpenUI Generative UI Layer
+ *
+ * Streaming-first DSL parser and renderer for LLM-generated UI.
+ * Implements OpenUI Lang specification for progressive UI rendering.
+ *
+ * ADR: 2026-05-04-openui-generative-ui-integration
+ *
+ * @package @kos/design-system/g0-generative
+ */
+export { default as OpenUIRenderer } from './renderer/OpenUIRenderer.svelte';
+export { parseOpenUILang, type ParseResult } from './parser/parseOpenUILang';
+export { ComponentLibrary, defineComponent } from './library/ComponentLibrary';
+export { generateSystemPrompt } from './prompt-gen/generateSystemPrompt';
+export { StreamingAdapter, type StreamChunk, type StreamingState } from './streaming/StreamingAdapter';
+export type { OpenUIAST, OpenUIElement, OpenUIIdentifier } from './parser/types';
+export type { ComponentSchema, ComponentRegistry } from './library/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/g0-generative/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/g0-generative/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGvG,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACjF,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/g0-generative/index.js

@@ -0,0 +1,15 @@
+/**
+ * g0-generative — OpenUI Generative UI Layer
+ *
+ * Streaming-first DSL parser and renderer for LLM-generated UI.
+ * Implements OpenUI Lang specification for progressive UI rendering.
+ *
+ * ADR: 2026-05-04-openui-generative-ui-integration
+ *
+ * @package @kos/design-system/g0-generative
+ */
+export { default as OpenUIRenderer } from './renderer/OpenUIRenderer.svelte';
+export { parseOpenUILang } from './parser/parseOpenUILang';
+export { ComponentLibrary, defineComponent } from './library/ComponentLibrary';
+export { generateSystemPrompt } from './prompt-gen/generateSystemPrompt';
+export { StreamingAdapter } from './streaming/StreamingAdapter';

package/dist/g0-generative/library/ComponentLibrary.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Component Library
+ *
+ * Registry of components available for LLM generation.
+ * Provides Zod-like schema definition and system prompt generation.
+ */
+import type { ComponentSchema, LibraryConfig, PropSchema } from './types';
+export declare class ComponentLibrary {
+    private registry;
+    private config;
+    constructor(config: LibraryConfig);
+    getComponent(name: string): ComponentSchema | undefined;
+    hasComponent(name: string): boolean;
+    listComponents(): string[];
+    /**
+     * Generate system prompt for LLM
+     * Describes available components and OpenUI Lang syntax
+     */
+    generatePrompt(): string;
+    private describeComponent;
+    private describePropType;
+    private exampleValue;
+    /**
+     * Validate that an OpenUI Lang element matches its schema
+     */
+    validateElement(name: string, args: unknown[]): string[];
+    private validateType;
+}
+/**
+ * Helper to create component schema
+ */
+export declare function defineComponent(name: string, description: string, props: Record<string, PropSchema>, options?: {
+    children?: boolean;
+    svelteComponent?: string;
+}): ComponentSchema;
+//# sourceMappingURL=ComponentLibrary.d.ts.map

package/dist/g0-generative/library/ComponentLibrary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentLibrary.d.ts","sourceRoot":"","sources":["../../../src/g0-generative/library/ComponentLibrary.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAqB,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE7F,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,aAAa;IAOjC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIvD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAInC,cAAc,IAAI,MAAM,EAAE;IAI1B;;;OAGG;IACH,cAAc,IAAI,MAAM;IAoCxB,OAAO,CAAC,iBAAiB;IA8BzB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,YAAY;IAiBpB;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE;IA4BxD,OAAO,CAAC,YAAY;CAYrB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EACjC,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7D,eAAe,CAiBjB"}

package/dist/g0-generative/library/ComponentLibrary.js

@@ -0,0 +1,172 @@
+/**
+ * Component Library
+ *
+ * Registry of components available for LLM generation.
+ * Provides Zod-like schema definition and system prompt generation.
+ */
+export class ComponentLibrary {
+    registry = new Map();
+    config;
+    constructor(config) {
+        this.config = config;
+        for (const component of config.components) {
+            this.registry.set(component.name, component);
+        }
+    }
+    getComponent(name) {
+        return this.registry.get(name);
+    }
+    hasComponent(name) {
+        return this.registry.has(name);
+    }
+    listComponents() {
+        return Array.from(this.registry.keys()).sort();
+    }
+    /**
+     * Generate system prompt for LLM
+     * Describes available components and OpenUI Lang syntax
+     */
+    generatePrompt() {
+        const lines = [
+            `# ${this.config.name}`,
+            '',
+            this.config.description,
+            '',
+            '## OpenUI Lang Syntax',
+            '',
+            'Generate UI using this compact, line-oriented syntax:',
+            '',
+            '```',
+            'identifier = ComponentName([arg1, arg2, ...])',
+            '```',
+            '',
+            'Rules:',
+            '1. First assignment MUST be to `root`',
+            '2. One statement per line',
+            '3. Arguments are positional, matching the component\'s propOrder',
+            '4. Component references are bare identifiers (no quotes)',
+            '5. Strings are in "double quotes"',
+            '6. Numbers are bare (e.g., 42, 3.14)',
+            '7. Booleans are `true` or `false`',
+            '8. Arrays are [ref1, ref2, ref3]',
+            '',
+            '## Available Components',
+            '',
+        ];
+        for (const component of this.config.components) {
+            lines.push(this.describeComponent(component));
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    describeComponent(schema) {
+        const lines = [
+            `### ${schema.name}`,
+            '',
+            schema.description,
+            '',
+        ];
+        if (schema.propOrder.length > 0) {
+            lines.push('Props (in order):');
+            for (const propName of schema.propOrder) {
+                const prop = schema.props[propName];
+                lines.push(`  ${propName}: ${this.describePropType(prop)}${prop.optional ? ' (optional)' : ''}`);
+                if (prop.description) {
+                    lines.push(`    ${prop.description}`);
+                }
+            }
+            lines.push('');
+        }
+        if (schema.children) {
+            lines.push('Can contain child components.');
+            lines.push('');
+        }
+        lines.push(`Example: ${schema.name}([${schema.propOrder.map(p => this.exampleValue(schema.props[p])).join(', ')}])`);
+        return lines.join('\n');
+    }
+    describePropType(prop) {
+        switch (prop.type) {
+            case 'string': return 'string';
+            case 'number': return 'number';
+            case 'boolean': return 'boolean';
+            case 'array': return `array<${prop.itemType || 'unknown'}>`;
+            case 'enum': return `enum(${prop.values?.join('|') || ''})`;
+            case 'identifier': return 'component reference';
+            case 'union': return `union(${prop.variants?.map(v => v.type).join('|') || ''})`;
+            default: return prop.type;
+        }
+    }
+    exampleValue(prop) {
+        if (prop.default !== undefined) {
+            return JSON.stringify(prop.default);
+        }
+        switch (prop.type) {
+            case 'string': return '"example"';
+            case 'number': return '42';
+            case 'boolean': return 'true';
+            case 'array': return '[a, b, c]';
+            case 'enum': return `"${prop.values?.[0] || 'value'}"`;
+            case 'identifier': return 'childRef';
+            case 'union': return this.exampleValue(prop.variants?.[0] || { type: 'string' });
+            default: return 'null';
+        }
+    }
+    /**
+     * Validate that an OpenUI Lang element matches its schema
+     */
+    validateElement(name, args) {
+        const schema = this.registry.get(name);
+        if (!schema) {
+            return [`Unknown component: ${name}`];
+        }
+        const errors = [];
+        const requiredProps = schema.propOrder.filter(p => !schema.props[p].optional);
+        // Check required args
+        if (args.length < requiredProps.length) {
+            errors.push(`Missing required arguments for ${name}: expected ${requiredProps.length}, got ${args.length}`);
+        }
+        // Validate types
+        for (let i = 0; i < Math.min(args.length, schema.propOrder.length); i++) {
+            const propName = schema.propOrder[i];
+            const prop = schema.props[propName];
+            const value = args[i];
+            if (!this.validateType(value, prop)) {
+                errors.push(`Invalid type for ${name}.${propName}: expected ${prop.type}, got ${typeof value}`);
+            }
+        }
+        return errors;
+    }
+    validateType(value, prop) {
+        switch (prop.type) {
+            case 'string': return typeof value === 'string';
+            case 'number': return typeof value === 'number';
+            case 'boolean': return typeof value === 'boolean';
+            case 'array': return Array.isArray(value);
+            case 'enum': return typeof value === 'string' && (prop.values?.includes(value) ?? false);
+            case 'identifier': return typeof value === 'string';
+            case 'union': return prop.variants?.some(v => this.validateType(value, v)) ?? true;
+            default: return true;
+        }
+    }
+}
+/**
+ * Helper to create component schema
+ */
+export function defineComponent(name, description, props, options = {}) {
+    // Determine prop order: required first, then optional
+    const propOrder = Object.entries(props)
+        .sort(([, a], [, b]) => {
+        if (a.optional === b.optional)
+            return 0;
+        return a.optional ? 1 : -1;
+    })
+        .map(([name]) => name);
+    return {
+        name,
+        description,
+        props,
+        propOrder,
+        children: options.children,
+        svelteComponent: options.svelteComponent,
+    };
+}

package/dist/g0-generative/library/types.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Component Library Types
+ *
+ * Zod-inspired component schemas for type-safe generative UI.
+ */
+export type PropType = 'string' | 'number' | 'boolean' | 'array' | 'enum' | 'identifier' | 'union';
+export interface PropSchema {
+    type: PropType;
+    optional?: boolean;
+    default?: unknown;
+    values?: string[];
+    itemType?: PropType;
+    variants?: PropSchema[];
+    description?: string;
+}
+export interface ComponentSchema {
+    name: string;
+    description: string;
+    props: Record<string, PropSchema>;
+    propOrder: string[];
+    children?: boolean;
+    svelteComponent?: string;
+}
+export type ComponentRegistry = Map<string, ComponentSchema>;
+export interface LibraryConfig {
+    name: string;
+    description: string;
+    components: ComponentSchema[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/g0-generative/library/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/g0-generative/library/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC;AAEnG,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IAExB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAElC,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,eAAe,EAAE,CAAC;CAC/B"}

package/dist/g0-generative/library/types.js

@@ -0,0 +1,6 @@
+/**
+ * Component Library Types
+ *
+ * Zod-inspired component schemas for type-safe generative UI.
+ */
+export {};

package/dist/g0-generative/parser/parseOpenUILang.d.ts

@@ -0,0 +1,17 @@
+/**
+ * OpenUI Lang Parser
+ *
+ * Streaming-compatible, line-by-line parser.
+ * Sovereignty-compliant: uses insertion-ordered Map (deterministic iteration), no SystemTime/rand.
+ *
+ * Syntax:
+ *   identifier = ComponentName([arg1, arg2, ...])
+ *   identifier = [ref1, ref2]  // shorthand for Lists
+ *
+ * Forward references allowed — unresolved identifiers become placeholders.
+ */
+import type { OpenUIAST, ParseResult } from './types';
+export type { ParseResult } from './types';
+export declare function parseOpenUILang(input: string): ParseResult;
+export declare function parsePartial(input: string, existingAST?: OpenUIAST): ParseResult;
+//# sourceMappingURL=parseOpenUILang.d.ts.map

package/dist/g0-generative/parser/parseOpenUILang.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseOpenUILang.d.ts","sourceRoot":"","sources":["../../../src/g0-generative/parser/parseOpenUILang.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAA4D,WAAW,EAAoB,MAAM,SAAS,CAAC;AAElI,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AA4R3C,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAwC1D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,SAAS,GAAG,WAAW,CA+BhF"}