@stephen-netu/design-system 0.2.2 → 0.5.1

package/dist/g0-generative/components/Text.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Text.svelte.d.ts","sourceRoot":"","sources":["../../../src/g0-generative/components/Text.svelte.ts"],"names":[],"mappings":"AAGE,MAAM,WAAW,KAAK;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAeH,QAAA,MAAM,IAAI,2CAAwC,CAAC;AACnD,KAAK,IAAI,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;AACpC,eAAe,IAAI,CAAC"}

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

@@ -9,6 +9,7 @@
  * @package @kos/design-system/g0-generative
  */
 export { default as OpenUIRenderer } from './renderer/OpenUIRenderer.svelte';
+export { default as Text } from './components/Text.svelte';
 export { parseOpenUILang, type ParseResult } from './parser/parseOpenUILang';
 export { ComponentLibrary, defineComponent } from './library/ComponentLibrary';
 export { generateSystemPrompt } from './prompt-gen/generateSystemPrompt';

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

@@ -1 +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"}
+{"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,OAAO,IAAI,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAC3D,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

@@ -9,6 +9,7 @@
  * @package @kos/design-system/g0-generative
  */
 export { default as OpenUIRenderer } from './renderer/OpenUIRenderer.svelte';
+export { default as Text } from './components/Text.svelte';
 export { parseOpenUILang } from './parser/parseOpenUILang';
 export { ComponentLibrary, defineComponent } from './library/ComponentLibrary';
 export { generateSystemPrompt } from './prompt-gen/generateSystemPrompt';

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

@@ -8,10 +8,14 @@ import type { ComponentSchema, LibraryConfig, PropSchema } from './types';
 export declare class ComponentLibrary {
     private registry;
     private config;
+    private components;
     constructor(config: LibraryConfig);
     getComponent(name: string): ComponentSchema | undefined;
     hasComponent(name: string): boolean;
     listComponents(): string[];
+    registerComponent(name: string, component: import('svelte').Component<Record<string, unknown>>): void;
+    getRegisteredComponent(name: string): import('svelte').Component<Record<string, unknown>> | undefined;
+    getRegisteredComponents(): Map<string, import('svelte').Component<Record<string, unknown>>>;
     /**
      * Generate system prompt for LLM
      * Describes available components and OpenUI Lang syntax

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

@@ -1 +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"}
+{"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;IAC9B,OAAO,CAAC,UAAU,CAA+E;gBAErF,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,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI;IAIrG,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS;IAIrG,uBAAuB,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAI3F;;;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

@@ -7,6 +7,7 @@
 export class ComponentLibrary {
     registry = new Map();
     config;
+    components = new Map();
     constructor(config) {
         this.config = config;
         for (const component of config.components) {
@@ -22,6 +23,15 @@ export class ComponentLibrary {
     listComponents() {
         return Array.from(this.registry.keys()).sort();
     }
+    registerComponent(name, component) {
+        this.components.set(name, component);
+    }
+    getRegisteredComponent(name) {
+        return this.components.get(name);
+    }
+    getRegisteredComponents() {
+        return new Map(this.components);
+    }
     /**
      * Generate system prompt for LLM
      * Describes available components and OpenUI Lang syntax

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

@@ -0,0 +1,135 @@
+import { describe, it, expect } from 'vitest';
+import { ComponentLibrary, defineComponent } from '../library/ComponentLibrary';
+const MockButton = {};
+const MockText = {};
+const MockCard = {};
+describe('ComponentLibrary', () => {
+    const lib = new ComponentLibrary({
+        name: 'Test Library',
+        description: 'A test component library',
+        components: [
+            defineComponent('Card', 'A card container', {
+                title: { type: 'string', optional: true },
+            }, { children: true }),
+            defineComponent('Button', 'A button', {
+                label: { type: 'string' },
+                variant: { type: 'string', optional: true, default: 'primary' },
+            }),
+            defineComponent('Text', 'Display text', {
+                content: { type: 'string' },
+                size: { type: 'string', optional: true },
+            }),
+        ],
+    });
+    describe('registerComponent', () => {
+        it('registers a Svelte component', () => {
+            lib.registerComponent('Card', MockCard);
+            expect(lib.getRegisteredComponent('Card')).toBe(MockCard);
+        });
+        it('registers multiple components', () => {
+            const freshLib = new ComponentLibrary({
+                name: 'Fresh',
+                description: 'Fresh lib',
+                components: [
+                    defineComponent('Card', 'A card', {}, { children: true }),
+                    defineComponent('Button', 'A button', { label: { type: 'string' } }),
+                    defineComponent('Text', 'Text', { content: { type: 'string' } }),
+                ],
+            });
+            freshLib.registerComponent('Card', MockCard);
+            freshLib.registerComponent('Button', MockButton);
+            freshLib.registerComponent('Text', MockText);
+            expect(freshLib.getRegisteredComponent('Card')).toBe(MockCard);
+            expect(freshLib.getRegisteredComponent('Button')).toBe(MockButton);
+            expect(freshLib.getRegisteredComponent('Text')).toBe(MockText);
+        });
+        it('returns undefined for unregistered component', () => {
+            expect(lib.getRegisteredComponent('Unknown')).toBeUndefined();
+        });
+        it('overwrites previous registration for same name', () => {
+            const freshLib = new ComponentLibrary({
+                name: 'Fresh',
+                description: 'Fresh lib',
+                components: [defineComponent('Card', 'A card', {}, { children: true })],
+            });
+            freshLib.registerComponent('Card', MockCard);
+            freshLib.registerComponent('Card', MockButton);
+            expect(freshLib.getRegisteredComponent('Card')).toBe(MockButton);
+        });
+    });
+    describe('getRegisteredComponents', () => {
+        it('returns empty map when no components registered', () => {
+            const emptyLib = new ComponentLibrary({
+                name: 'Empty',
+                description: 'No components',
+                components: [],
+            });
+            expect(emptyLib.getRegisteredComponents().size).toBe(0);
+        });
+        it('returns populated map when components are registered', () => {
+            const freshLib = new ComponentLibrary({
+                name: 'Fresh',
+                description: 'Fresh lib',
+                components: [
+                    defineComponent('Card', 'A card', {}, { children: true }),
+                    defineComponent('Button', 'A button', { label: { type: 'string' } }),
+                ],
+            });
+            freshLib.registerComponent('Card', MockCard);
+            freshLib.registerComponent('Button', MockButton);
+            const components = freshLib.getRegisteredComponents();
+            expect(components.size).toBe(2);
+            expect(components.get('Card')).toBe(MockCard);
+            expect(components.get('Button')).toBe(MockButton);
+        });
+        it('returns a copy (not the internal map)', () => {
+            lib.registerComponent('Card', MockCard);
+            const map1 = lib.getRegisteredComponents();
+            const map2 = lib.getRegisteredComponents();
+            expect(map1).not.toBe(map2);
+            expect(map1.get('Card')).toBe(map2.get('Card'));
+        });
+    });
+    describe('hasComponent', () => {
+        it('returns true for defined components', () => {
+            expect(lib.hasComponent('Card')).toBe(true);
+            expect(lib.hasComponent('Button')).toBe(true);
+        });
+        it('returns false for unknown components', () => {
+            expect(lib.hasComponent('Unknown')).toBe(false);
+        });
+    });
+    describe('getComponent', () => {
+        it('returns schema for defined component', () => {
+            const schema = lib.getComponent('Card');
+            expect(schema).toBeDefined();
+            expect(schema?.name).toBe('Card');
+        });
+        it('returns undefined for unknown component', () => {
+            expect(lib.getComponent('Unknown')).toBeUndefined();
+        });
+    });
+    describe('defineComponent', () => {
+        it('creates a schema with correct name and description', () => {
+            const schema = defineComponent('Foo', 'A foo', {});
+            expect(schema.name).toBe('Foo');
+            expect(schema.description).toBe('A foo');
+        });
+        it('orders required props before optional', () => {
+            const schema = defineComponent('Bar', 'A bar', {
+                requiredProp: { type: 'string' },
+                optionalProp: { type: 'string', optional: true },
+            });
+            expect(schema.propOrder[0]).toBe('requiredProp');
+            expect(schema.propOrder[1]).toBe('optionalProp');
+        });
+        it('sets children flag', () => {
+            const schema = defineComponent('Container', 'A container', {}, { children: true });
+            expect(schema.children).toBe(true);
+        });
+        it('sets svelteComponent in schema', () => {
+            const schema = defineComponent('Widget', 'A widget', {}, { svelteComponent: 'Widget.svelte' });
+            expect(schema.svelteComponent).toBe('Widget.svelte');
+        });
+    });
+});

package/dist/g0-generative/renderer/OpenUIRenderer.svelte

@@ -24,11 +24,7 @@
   const componentRegistry = $derived(buildRegistry(library));
 
   function buildRegistry(library: ComponentLibrary): Map<string, import('svelte').Component<Record<string, unknown>>> {
-    // TODO: Implement component registration from library schemas
-    // This requires mapping ComponentLibrary schemas to actual Svelte imports
-    // Example: if (library.hasComponent('Card')) registry.set('Card', CardComponent);
-    // For now, return empty - consumers must register components manually
-    return new Map();
+    return library.getRegisteredComponents();
   }
 
   function isResolved(node: OpenUINode): boolean {
@@ -43,22 +39,18 @@
     component: import('svelte').Component<Record<string, unknown>> | null;
     props: Record<string, unknown>;
     children: string[];
-    grandchildren: string[];
   } {
     const Component = getComponent(element.component);
     const schema = library.getComponent(element.component);
-    
+
     const componentProps: Record<string, unknown> = {};
     const children: string[] = [];
-    const grandchildren: string[] = [];
 
     if (schema) {
-      // Map positional args to named props
       for (let i = 0; i < element.args.length; i++) {
         const propName = schema.propOrder[i];
         if (propName) {
           const value = element.args[i];
-          // If this is an identifier array, treat as children
           if (Array.isArray(value) && value.every(v => typeof v === 'string')) {
             children.push(...value);
           } else {
@@ -67,7 +59,6 @@
         }
       }
     } else {
-      // No schema - treat all array args as children
       for (const arg of element.args) {
         if (Array.isArray(arg) && arg.every(v => typeof v === 'string')) {
           children.push(...arg);
@@ -75,19 +66,7 @@
       }
     }
 
-    // Extract grandchildren from children (nested structure)
-    for (const childId of children) {
-      const childNode = ast?.nodes.get(childId);
-      if (childNode?.type === 'element') {
-        for (const arg of childNode.args) {
-          if (Array.isArray(arg) && arg.every(v => typeof v === 'string')) {
-            grandchildren.push(...arg);
-          }
-        }
-      }
-    }
-
-    return { component: Component, props: componentProps, children, grandchildren };
+    return { component: Component, props: componentProps, children };
   }
 </script>
 
@@ -107,25 +86,11 @@
       {@const { component: RootComponent, props: rootProps, children } = renderElement(rootNode)}
       {#if RootComponent}
         <RootComponent {...rootProps}>
-          {#each children as childId}
-            {@const childNode = ast!.nodes.get(childId)}
-            {#if childNode}
-              <!-- Recursive child rendering via snippet -->
-              {@render renderChild(childId, childNode)}
-            {/if}
-          {/each}
+          {@render renderChildren(children)}
         </RootComponent>
       {:else}
         <!-- Unregistered component - render children inline -->
-        {#each children as childId}
-          {@const childNode = ast!.nodes.get(childId)}
-          {#if childNode?.type === 'element'}
-            {@const { component: ChildComponent, props: childProps } = renderElement(childNode)}
-            {#if ChildComponent}
-              <ChildComponent {...childProps} />
-            {/if}
-          {/if}
-        {/each}
+        {@render renderChildren(children)}
       {/if}
     {/if}
   {/if}
@@ -135,30 +100,25 @@
       <div class="openui-loading">Loading...</div>
     </div>
   {:else if childNode.type === 'element'}
-    {@const { component: ChildComponent, props: childProps, grandchildren } = renderElement(childNode)}
+    {@const { component: ChildComponent, props: childProps, children } = renderElement(childNode)}
     {#if ChildComponent}
       <ChildComponent {...childProps}>
-        {#each grandchildren as grandchildId}
-          {@const grandchildNode = ast!.nodes.get(grandchildId)}
-          {#if grandchildNode}
-            {@render renderChild(grandchildId, grandchildNode)}
-          {/if}
-        {/each}
+        {@render renderChildren(children)}
       </ChildComponent>
     {:else}
       <!-- Unregistered component - render children inline -->
-      {#each grandchildren as grandchildId}
-        {@const grandchildNode = ast!.nodes.get(grandchildId)}
-        {#if grandchildNode?.type === 'element'}
-          {@const { component: GC, props: gp } = renderElement(grandchildNode)}
-          {#if GC}
-            <GC {...gp} />
-          {/if}
-        {/if}
-      {/each}
+      {@render renderChildren(children)}
     {/if}
   {/if}
 {/snippet}
+{#snippet renderChildren(childIds: string[])}
+  {#each childIds as childId}
+    {@const childNode = ast!.nodes.get(childId)}
+    {#if childNode}
+      {@render renderChild(childId, childNode)}
+    {/if}
+  {/each}
+{/snippet}
 
 {:else}
   <!-- No AST yet -->

package/dist/g0-generative/renderer/OpenUIRenderer.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OpenUIRenderer.svelte.d.ts","sourceRoot":"","sources":["../../../src/g0-generative/renderer/OpenUIRenderer.svelte.ts"],"names":[],"mappings":"AAGA;;;;;;;KAOK;AACL,OAAO,KAAK,EAAE,SAAS,EAAgD,MAAM,iBAAiB,CAAC;AAC/F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAIlE,UAAU,KAAK;IACb,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,QAAQ,EAAE,OAAO,CAAC;CACrC;AAmKH,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}
+{"version":3,"file":"OpenUIRenderer.svelte.d.ts","sourceRoot":"","sources":["../../../src/g0-generative/renderer/OpenUIRenderer.svelte.ts"],"names":[],"mappings":"AAGA;;;;;;;KAOK;AACL,OAAO,KAAK,EAAE,SAAS,EAAgD,MAAM,iBAAiB,CAAC;AAC/F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAIlE,UAAU,KAAK;IACb,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,QAAQ,EAAE,OAAO,CAAC;CACrC;AA2HH,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/g0-generative/renderer/OpenUIRenderer.test.js

@@ -0,0 +1,143 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { cleanup, render } from '@testing-library/svelte';
+import { ComponentLibrary, defineComponent } from '../library/ComponentLibrary';
+import OpenUIRenderer from './OpenUIRenderer.svelte';
+import Card from '../../u0-primitives/card/Card.svelte';
+import Button from '../../u0-primitives/button/Button.svelte';
+import Text from '../components/Text.svelte';
+function createAST(rootId, nodes) {
+    return { root: rootId, nodes, errors: [] };
+}
+describe('OpenUIRenderer', () => {
+    afterEach(() => cleanup());
+    const lib = new ComponentLibrary({
+        name: 'Test Library',
+        description: 'Test',
+        components: [
+            defineComponent('Card', 'A card', {
+                class: { type: 'string', optional: true },
+            }, { children: true }),
+            defineComponent('Button', 'A button', {
+                label: { type: 'string' },
+                class: { type: 'string', optional: true },
+            }),
+            defineComponent('Text', 'Text', {
+                content: { type: 'string' },
+                size: { type: 'enum', values: ['sm', 'md', 'lg', 'xl'], optional: true },
+                class: { type: 'string', optional: true },
+            }),
+        ],
+    });
+    it('renders empty state when ast is null', () => {
+        const { container } = render(OpenUIRenderer, {
+            props: { ast: null, library: lib },
+        });
+        expect(container.querySelector('.openui-empty')).not.toBeNull();
+    });
+    it('renders skeleton for placeholder root', () => {
+        const nodes = new Map([
+            ['root', { type: 'placeholder', identifier: 'root', referencedBy: [], line: 1 }],
+        ]);
+        const ast = createAST('root', nodes);
+        const { container } = render(OpenUIRenderer, {
+            props: { ast, library: lib },
+        });
+        expect(container.querySelector('.openui-skeleton')).not.toBeNull();
+    });
+    it('renders element root with registered component', () => {
+        lib.registerComponent('Card', Card);
+        const nodes = new Map([
+            ['root', { type: 'element', identifier: 'root', component: 'Card', args: [], line: 1 }],
+        ]);
+        const ast = createAST('root', nodes);
+        const { container } = render(OpenUIRenderer, {
+            props: { ast, library: lib },
+        });
+        expect(container.querySelector('.ds-card')).not.toBeNull();
+        expect(container.querySelector('.openui-empty')).toBeNull();
+        expect(container.querySelector('.openui-skeleton')).toBeNull();
+    });
+    it('renders unregistered component children inline', () => {
+        const nodes = new Map([
+            ['root', { type: 'element', identifier: 'root', component: 'Unknown', args: [], line: 1 }],
+        ]);
+        const ast = createAST('root', nodes);
+        const { container } = render(OpenUIRenderer, {
+            props: { ast, library: lib },
+        });
+        expect(container.querySelector('.openui-empty')).toBeNull();
+    });
+    it('passes props to registered components', () => {
+        lib.registerComponent('Button', Button);
+        const nodes = new Map([
+            ['root', { type: 'element', identifier: 'root', component: 'Button', args: ['Click me'], line: 1 }],
+        ]);
+        const ast = createAST('root', nodes);
+        const { container } = render(OpenUIRenderer, {
+            props: { ast, library: lib },
+        });
+        const button = container.querySelector('.ds-button');
+        expect(button).not.toBeNull();
+        expect(button?.getAttribute('type')).toBe('button');
+    });
+    it('renders Text from OpenUI DSL', () => {
+        lib.registerComponent('Text', Text);
+        const nodes = new Map([
+            ['root', { type: 'element', identifier: 'root', component: 'Text', args: ['Hello OpenUI'], line: 1 }],
+        ]);
+        const ast = createAST('root', nodes);
+        const { container } = render(OpenUIRenderer, {
+            props: { ast, library: lib },
+        });
+        expect(container.querySelector('.openui-text')?.textContent).toBe('Hello OpenUI');
+    });
+    it('renders nested children through registered components', () => {
+        lib.registerComponent('Card', Card);
+        lib.registerComponent('Text', Text);
+        const nodes = new Map([
+            ['root', { type: 'element', identifier: 'root', component: 'Card', args: [['child1']], line: 1 }],
+            ['child1', { type: 'element', identifier: 'child1', component: 'Text', args: ['Nested text'], line: 2 }],
+        ]);
+        const ast = createAST('root', nodes);
+        const { container } = render(OpenUIRenderer, {
+            props: { ast, library: lib },
+        });
+        expect(container.querySelectorAll('.ds-card').length).toBe(1);
+        expect(container.querySelector('.openui-text')?.textContent).toBe('Nested text');
+    });
+    it('renders fallback snippet when provided and ast is null', () => {
+        const fallback = () => '<div class="custom-fallback">Loading</div>';
+        const { container } = render(OpenUIRenderer, {
+            props: {
+                ast: null,
+                library: lib,
+                fallback,
+            },
+        });
+        expect(container.querySelector('.openui-empty')).not.toBeNull();
+    });
+    it('handles streaming state', () => {
+        const nodes = new Map([
+            ['root', { type: 'placeholder', identifier: 'root', referencedBy: [], line: 1 }],
+        ]);
+        const ast = createAST('root', nodes);
+        const { container } = render(OpenUIRenderer, {
+            props: { ast, library: lib, isStreaming: true },
+        });
+        const skeleton = container.querySelector('.openui-skeleton');
+        expect(skeleton).not.toBeNull();
+        expect(skeleton?.getAttribute('aria-busy')).toBe('true');
+    });
+    it('buildRegistry returns registered components from library', () => {
+        lib.registerComponent('Card', Card);
+        lib.registerComponent('Button', Button);
+        const nodes = new Map([
+            ['root', { type: 'element', identifier: 'root', component: 'Button', args: ['Save'], line: 1 }],
+        ]);
+        const ast = createAST('root', nodes);
+        const { container } = render(OpenUIRenderer, {
+            props: { ast, library: lib },
+        });
+        expect(container.querySelector('.ds-button')).not.toBeNull();
+    });
+});

package/dist/g0-geo/SovereignMap.svelte

@@ -9,6 +9,7 @@
 
   import { onMount, onDestroy } from 'svelte';
   import 'leaflet/dist/leaflet.css';
+  import type { LayerGroup, Map } from 'leaflet';
 
   interface GeoPoint {
     lat: number;
@@ -32,29 +33,28 @@
 
   let { center, zoom = 12, markers = [], onMarkerSelect }: Props = $props();
 
+  type LeafletApi = typeof import('leaflet');
+
   let mapEl: HTMLDivElement;
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  let map: any = null;
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  let markerLayer: any = null;
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  let L: any = null;
+  let map: Map | null = null;
+  let markerLayer: LayerGroup | null = null;
+  let leafletApi: LeafletApi | null = null;
 
   onMount(async () => {
     // Dynamic import keeps Leaflet out of the critical bundle path.
     // CSS is statically imported at top of file — resolved from node_modules at build time (ADR: 2026-04-05-sovereign-map-css-delivery-adr.md).
     const leafletModule = await import('leaflet');
-    L = leafletModule.default;
+    leafletApi = leafletModule.default as LeafletApi;
 
-    map = L.map(mapEl).setView([center.lat, center.lon], zoom);
+    map = leafletApi.map(mapEl).setView([center.lat, center.lon], zoom);
 
-    L.tileLayer('https://{s}.basemaps.cartocdn.com/dark_all/{z}/{x}/{y}{r}.png', {
+    leafletApi.tileLayer('https://{s}.basemaps.cartocdn.com/dark_all/{z}/{x}/{y}{r}.png', {
       attribution: '&copy; <a href="https://www.openstreetmap.org/copyright">OpenStreetMap</a> contributors &copy; <a href="https://carto.com/attributions">CARTO</a>',
       subdomains: 'abcd',
       maxZoom: 19,
     }).addTo(map);
 
-    markerLayer = L.layerGroup().addTo(map);
+    markerLayer = leafletApi.layerGroup().addTo(map);
     syncMarkers();
   });
 
@@ -74,18 +74,18 @@
   });
 
   function syncMarkers() {
-    if (!markerLayer || !L) return;
+    if (!markerLayer || !leafletApi) return;
     markerLayer.clearLayers();
 
     for (const m of markers) {
-      const icon = L.divIcon({
+      const icon = leafletApi.divIcon({
         className: '',
         html: `<div class="sov-marker${m.selected ? ' sov-marker--selected' : ''}"></div>`,
         iconSize: [12, 12],
         iconAnchor: [6, 6],
       });
 
-      const leafletMarker = L.marker([m.lat, m.lon], { icon }).addTo(markerLayer);
+      const leafletMarker = leafletApi.marker([m.lat, m.lon], { icon }).addTo(markerLayer);
       leafletMarker.bindTooltip(m.label, { permanent: false, direction: 'top' });
 
       if (onMarkerSelect) {

package/dist/g0-geo/SovereignMap.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SovereignMap.svelte.d.ts","sourceRoot":"","sources":["../../src/g0-geo/SovereignMap.svelte.ts"],"names":[],"mappings":"AAWA,OAAO,0BAA0B,CAAC;AAGhC,UAAU,QAAQ;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,KAAK;IACb,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAwFH,QAAA,MAAM,YAAY,2CAAwC,CAAC;AAC3D,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AACpD,eAAe,YAAY,CAAC"}
+{"version":3,"file":"SovereignMap.svelte.d.ts","sourceRoot":"","sources":["../../src/g0-geo/SovereignMap.svelte.ts"],"names":[],"mappings":"AAWA,OAAO,0BAA0B,CAAC;AAIhC,UAAU,QAAQ;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,KAAK;IACb,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAyFH,QAAA,MAAM,YAAY,2CAAwC,CAAC;AAC3D,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AACpD,eAAe,YAAY,CAAC"}

package/dist/index.d.ts

@@ -7,7 +7,6 @@ export * from './p0-primitives';
 export * from './u0-primitives';
 export * from './l0-layout';
 export * from './s0-lifecycle';
-export * from './s0-state';
 export * from './t0-transport';
 export * from './f0-forms';
 export * from './d0-data-viz';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,YAAY,CAAC;AAEpB,OAAO,4CAA4C,CAAC;AACpD,OAAO,+BAA+B,CAAC;AACvC,OAAO,6BAA6B,CAAC;AAGrC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,iBAAiB,CAAC;AAEhC,cAAc,iBAAiB,CAAC;AAEhC,cAAc,aAAa,CAAC;AAE5B,cAAc,gBAAgB,CAAC;AAE/B,cAAc,YAAY,CAAC;AAE3B,cAAc,gBAAgB,CAAC;AAE/B,cAAc,YAAY,CAAC;AAE3B,cAAc,eAAe,CAAC;AAE9B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,aAAa,CAAC;AAG5B,cAAc,YAAY,CAAC;AAG3B,YAAY,EACV,SAAS,EACT,SAAS,EACT,aAAa,EACb,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,aAAa,EACb,aAAa,EACb,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,YAAY,CAAC;AAGpB,OAAO,4CAA4C,CAAC;AACpD,OAAO,+BAA+B,CAAC;AACvC,OAAO,6BAA6B,CAAC;AAGrC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,iBAAiB,CAAC;AAEhC,cAAc,iBAAiB,CAAC;AAEhC,cAAc,aAAa,CAAC;AAE5B,cAAc,gBAAgB,CAAC;AAK/B,cAAc,gBAAgB,CAAC;AAE/B,cAAc,YAAY,CAAC;AAE3B,cAAc,eAAe,CAAC;AAE9B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,aAAa,CAAC;AAG5B,cAAc,YAAY,CAAC;AAG3B,YAAY,EACV,SAAS,EACT,SAAS,EACT,aAAa,EACb,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,aAAa,EACb,aAAa,EACb,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -6,6 +6,7 @@
 // CSS imports
 import './base.css';
 /* NOTE: control-room.css is opt-in via data-theme="control-room" — import it explicitly if needed */
+/* NOTE: ambient.css is opt-in decorative tokens/utilities for marketing/docs surfaces — import it explicitly if needed */
 import './p0-primitives/tokens/validity-tokens.css';
 import './n0-node-graph/n0-tokens.css';
 import './d0-data-viz/d0-tokens.css';
@@ -20,7 +21,8 @@ export * from './l0-layout';
 // S0 Lifecycle — Component lifecycle phases (constrain → layout → interact → render)
 export * from './s0-lifecycle';
 // S0 State — Store primitives (Svelte 5 runes)
-export * from './s0-state';
+// Subpath only: consumers must import via @stephen-netu/design-system/s0-state
+// to avoid module-scope singleton side effects from the root barrel.
 // T0 Transport — Tauri IPC
 export * from './t0-transport';
 // F0 Forms — Form primitives