@sigx/runtime-core 0.1.3 → 0.1.5

package/dist/lazy.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Lazy loading utilities for sigx components.
+ *
+ * Provides runtime-only lazy loading with no build dependencies.
+ * Works with any bundler that supports dynamic import().
+ */
+import { type ComponentFactory } from './component.js';
+import { type JSXElement } from './jsx-runtime.js';
+/**
+ * Module with default export
+ */
+type ModuleWithDefault<T> = {
+    default: T;
+};
+/**
+ * Loader function that returns a component or module with default export
+ */
+type ComponentLoader<T> = () => Promise<T | ModuleWithDefault<T>>;
+/**
+ * Extended component factory with lazy loading methods
+ */
+export type LazyComponentFactory<T extends ComponentFactory<any, any, any>> = T & {
+    /** Preload the component without rendering */
+    preload: () => Promise<T>;
+    /** Check if the component is loaded */
+    isLoaded: () => boolean;
+    /** @internal Marker for lazy components */
+    __lazy: true;
+};
+/**
+ * Props for the Suspense component
+ */
+export type SuspenseProps = {
+    /** Fallback content to show while loading */
+    fallback?: JSXElement | (() => JSXElement);
+};
+/**
+ * Register a promise with the current Suspense boundary
+ * @internal
+ */
+export declare function registerPendingPromise(promise: Promise<any>): boolean;
+/**
+ * Create a lazy-loaded component wrapper.
+ *
+ * The component will be loaded on first render. Use with `<Suspense>` to show
+ * a fallback while loading.
+ *
+ * @param loader - Function that returns a Promise resolving to the component
+ * @returns A component factory that loads the real component on demand
+ *
+ * @example
+ * ```tsx
+ * import { lazy, Suspense } from 'sigx';
+ *
+ * // Component will be in a separate chunk
+ * const HeavyChart = lazy(() => import('./components/HeavyChart'));
+ *
+ * // Usage
+ * <Suspense fallback={<Spinner />}>
+ *     <HeavyChart data={chartData} />
+ * </Suspense>
+ *
+ * // Preload on hover
+ * <button onMouseEnter={() => HeavyChart.preload()}>
+ *     Show Chart
+ * </button>
+ * ```
+ */
+export declare function lazy<T extends ComponentFactory<any, any, any>>(loader: ComponentLoader<T>): LazyComponentFactory<T>;
+/**
+ * Suspense boundary component for handling async loading states.
+ *
+ * Wraps lazy-loaded components and shows a fallback while they load.
+ *
+ * @example
+ * ```tsx
+ * import { lazy, Suspense } from 'sigx';
+ *
+ * const LazyDashboard = lazy(() => import('./Dashboard'));
+ *
+ * // Basic usage
+ * <Suspense fallback={<div>Loading...</div>}>
+ *     <LazyDashboard />
+ * </Suspense>
+ *
+ * // With spinner component
+ * <Suspense fallback={<Spinner size="large" />}>
+ *     <LazyDashboard />
+ *     <LazyCharts />
+ * </Suspense>
+ * ```
+ */
+export declare const Suspense: ComponentFactory<SuspenseProps, void, {}>;
+/**
+ * Check if a component is a lazy-loaded component
+ */
+export declare function isLazyComponent(component: any): component is LazyComponentFactory<any>;
+export {};
+//# sourceMappingURL=lazy.d.ts.map

package/dist/lazy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.d.ts","sourceRoot":"","sources":["../src/lazy.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAO,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAWxD;;GAEG;AACH,KAAK,iBAAiB,CAAC,CAAC,IAAI;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,CAAC;AAE3C;;GAEG;AACH,KAAK,eAAe,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG;IAC9E,8CAA8C;IAC9C,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1B,uCAAuC;IACvC,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,2CAA2C;IAC3C,MAAM,EAAE,IAAI,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IACxB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,UAAU,GAAG,CAAC,MAAM,UAAU,CAAC,CAAC;CAC9C,CAAC;AAgBF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAcrE;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAC1D,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GAC3B,oBAAoB,CAAC,CAAC,CAAC,CAkGzB;AAMD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,QAAQ,2CA4EpB,CAAC;AAMF;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,GAAG,GAAG,SAAS,IAAI,oBAAoB,CAAC,GAAG,CAAC,CAEtF"}

package/dist/plugins.d.ts

@@ -6,7 +6,7 @@
  * issues with ES module initialization.
  */
 /**
- * Plugin system for components (used by HMR, DevTools, etc.)
+ * Plugin system for components (used by HMR, DevTools, SSR, etc.)
  * Note: SetupFn type is duplicated here to avoid circular imports
  */
 export type ComponentPlugin = {
@@ -17,4 +17,28 @@ export declare function registerComponentPlugin(plugin: ComponentPlugin): void;
  * Get all registered plugins (internal use)
  */
 export declare function getComponentPlugins(): readonly ComponentPlugin[];
+/**
+ * Context extension system for adding properties to ComponentSetupContext
+ * Used by SSR, DevTools, and other packages that need to extend the context
+ */
+type ContextExtension = (ctx: any) => void;
+/**
+ * Register a function that will be called to extend every component context.
+ * Extensions are called in order of registration.
+ *
+ * @example
+ * ```ts
+ * // In @sigx/server-renderer/client
+ * registerContextExtension((ctx) => {
+ *     ctx.ssr = { load: () => {} };
+ * });
+ * ```
+ */
+export declare function registerContextExtension(extension: ContextExtension): void;
+/**
+ * Apply all registered context extensions to a context object.
+ * Called internally by the renderer when creating component contexts.
+ */
+export declare function applyContextExtensions(ctx: any): void;
+export {};
 //# sourceMappingURL=plugins.d.ts.map

package/dist/plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CAChF,CAAC;AAIF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAErE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,eAAe,EAAE,CAEhE"}
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CAChF,CAAC;AAIF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAErE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,eAAe,EAAE,CAEhE;AAED;;;GAGG;AACH,KAAK,gBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;AAG3C;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAE1E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAIrD"}

package/dist/renderer.d.ts

@@ -1,5 +1,23 @@
-import { JSXElement } from './jsx-runtime.js';
+import { VNode, JSXElement } from './jsx-runtime.js';
+import { EffectRunner } from '@sigx/reactivity';
+import { SetupFn } from './component.js';
+import { InternalSlotsObject } from './utils/slots.js';
 import { AppContext } from './app.js';
+/**
+ * Internal VNode with renderer-specific properties.
+ * These properties are used by the renderer to track component state
+ * but are not part of the public VNode API.
+ */
+export interface InternalVNode extends VNode {
+    /** The reactive effect that re-renders the component */
+    _effect?: EffectRunner;
+    /** The rendered sub-tree VNode of a component */
+    _subTree?: VNode;
+    /** The slots object for component children */
+    _slots?: InternalSlotsObject;
+    /** Reactive props signal for the component */
+    _componentProps?: Record<string, any>;
+}
 export interface RendererOptions<HostNode = any, HostElement = any> {
     patchProp(el: HostElement, key: string, prevValue: any, nextValue: any, isSVG?: boolean): void;
     insert(child: HostNode, parent: HostElement, anchor?: HostNode | null): void;
@@ -16,11 +34,26 @@ export interface RendererOptions<HostNode = any, HostElement = any> {
     cloneNode?(node: HostNode): HostNode;
     insertStaticContent?(content: string, parent: HostElement, anchor: HostNode | null, isSVG: boolean): [HostNode, HostNode];
 }
-export type RootRenderFunction<HostNode = any, HostElement = any> = (vnode: JSXElement, container: HostElement, isSVG?: boolean) => void;
-export declare function createRenderer<HostNode = any, HostElement = any>(options: RendererOptions<HostNode, HostElement>): {
-    render: (element: JSXElement, container: HostElement, appContext?: AppContext) => void;
+export type RootRenderFunction<HostNode = any, HostElement = any> = (vnode: JSXElement, container: HostElement, appContext?: AppContext) => void;
+/**
+ * Function types for renderer operations exposed for plugins/hydration
+ */
+export type RendererMountFn<HostNode = any, HostElement = any> = (vnode: VNode, container: HostElement, before?: HostNode | null) => void;
+export type RendererUnmountFn<HostNode = any, HostElement = any> = (vnode: VNode, container: HostElement) => void;
+export type RendererPatchFn<HostNode = any, HostElement = any> = (n1: VNode, n2: VNode, container: HostElement) => void;
+export type RendererMountComponentFn<HostNode = any, HostElement = any> = (vnode: VNode, container: HostElement, before: HostNode | null, setup: SetupFn<any, any, any, any>) => void;
+/**
+ * Renderer instance returned by createRenderer
+ */
+export interface Renderer<HostNode = any, HostElement = any> {
+    render: RootRenderFunction<HostNode, HostElement>;
+    patch: RendererPatchFn<HostNode, HostElement>;
+    mount: RendererMountFn<HostNode, HostElement>;
+    unmount: RendererUnmountFn<HostNode, HostElement>;
+    mountComponent: RendererMountComponentFn<HostNode, HostElement>;
     createApp: (rootComponent: any) => {
-        mount(selectorOrContainer: string | HostElement): void;
+        mount: (selectorOrContainer: string | HostElement) => void;
     };
-};
+}
+export declare function createRenderer<HostNode = any, HostElement = any>(options: RendererOptions<HostNode, HostElement>): Renderer<HostNode, HostElement>;
 //# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,UAAU,EAAQ,MAAM,kBAAkB,CAAC;AAGrE,OAAO,EACH,UAAU,EAOb,MAAM,UAAU,CAAC;AASlB,MAAM,WAAW,eAAe,CAAC,QAAQ,GAAG,GAAG,EAAE,WAAW,GAAG,GAAG;IAC9D,SAAS,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/F,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7E,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC9B,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IACxF,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACnC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACtC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACtD,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI,CAAC;IAC/C,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC7C,aAAa,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IACrD,UAAU,CAAC,CAAC,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,SAAS,CAAC,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACrC,mBAAmB,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;CAC7H;AAED,MAAM,MAAM,kBAAkB,CAAC,QAAQ,GAAG,GAAG,EAAE,WAAW,GAAG,GAAG,IAAI,CAChE,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,WAAW,EACtB,KAAK,CAAC,EAAE,OAAO,KACd,IAAI,CAAC;AAEV,wBAAgB,cAAc,CAAC,QAAQ,GAAG,GAAG,EAAE,WAAW,GAAG,GAAG,EAC5D,OAAO,EAAE,eAAe,CAAC,QAAQ,EAAE,WAAW,CAAC;sBAuBtB,UAAU,aAAa,WAAW,eAAe,UAAU,KAAG,IAAI;+BA+nB5D,GAAG;mCAGK,MAAM,GAAG,WAAW;;EAoB9D"}
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"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"}

package/dist/utils/component-helpers.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Shared component helpers used by both runtime-core renderer and server-renderer hydration.
+ * These are the canonical implementations - avoid duplication.
+ */
+import { VNode, JSXElement } from '../jsx-runtime.js';
+import { PropsAccessor } from '../component.js';
+/**
+ * Internal slots object with tracking properties
+ */
+export interface InternalSlotsObject {
+    default: () => any[];
+    _children: any;
+    _version: {
+        v: number;
+    };
+    _slotsFromProps: Record<string, any>;
+    _isPatching?: boolean;
+    [key: string]: any;
+}
+/**
+ * Creates a props accessor that can be called with defaults or accessed directly.
+ * After calling with defaults, direct property access uses those defaults.
+ */
+export declare function createPropsAccessor<TProps extends Record<string, any>>(reactiveProps: TProps): PropsAccessor<TProps>;
+/**
+ * Create slots object from children and slots prop.
+ * Uses a version signal to trigger re-renders when children change.
+ * Supports named slots via:
+ * - `slots` prop object (e.g., slots={{ header: () => <div>...</div> }})
+ * - `slot` prop on children (e.g., <div slot="header">...</div>)
+ */
+export declare function createSlots(children: any, slotsFromProps?: Record<string, any>): InternalSlotsObject;
+/**
+ * Normalize render result to a VNode (wrapping arrays in Fragment)
+ * Handles null, undefined, false, true by returning an empty Text node.
+ */
+export declare function normalizeSubTree(result: JSXElement | JSXElement[] | null | undefined | boolean): VNode;
+//# sourceMappingURL=component-helpers.d.ts.map

package/dist/utils/component-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/component-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAkB,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEtE,OAAO,EAAe,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;IACrB,SAAS,EAAE,GAAG,CAAC;IACf,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAClE,aAAa,EAAE,MAAM,GACtB,aAAa,CAAC,MAAM,CAAC,CAmDvB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,mBAAmB,CAwEpG;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,KAAK,CAmCtG"}

package/dist/utils/normalize.d.ts

@@ -0,0 +1,31 @@
+/**
+ * VNode normalization utilities.
+ * Converts render results into proper VNode structures.
+ */
+import { VNode, JSXElement } from '../jsx-runtime.js';
+/**
+ * Normalize render result to a VNode (wrapping arrays in Fragment).
+ * Handles null, undefined, false, true by returning an empty Text node.
+ *
+ * This is used to normalize the return value of component render functions
+ * into a consistent VNode structure for the renderer to process.
+ *
+ * @example
+ * ```ts
+ * // Conditional rendering returns null/false
+ * normalizeSubTree(null)     // → empty Text node
+ * normalizeSubTree(false)    // → empty Text node
+ *
+ * // Arrays become Fragments
+ * normalizeSubTree([<A/>, <B/>])  // → Fragment with children
+ *
+ * // Primitives become Text nodes
+ * normalizeSubTree("hello")  // → Text node
+ * normalizeSubTree(42)       // → Text node
+ *
+ * // VNodes pass through
+ * normalizeSubTree(<div/>)   // → same VNode
+ * ```
+ */
+export declare function normalizeSubTree(result: JSXElement | JSXElement[] | null | undefined | boolean): VNode;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/utils/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/utils/normalize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAkB,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,KAAK,CAmCtG"}

package/dist/utils/props-accessor.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Props accessor for component setup functions.
+ * Provides a callable proxy that supports defaults and reactive property access.
+ */
+import { PropsAccessor } from '../component.js';
+/**
+ * Creates a props accessor that can be called with defaults or accessed directly.
+ * After calling with defaults, direct property access uses those defaults.
+ *
+ * @example
+ * ```ts
+ * // In component setup:
+ * const props = createPropsAccessor(reactiveProps);
+ *
+ * // Set defaults
+ * props({ count: 0, label: 'Default' });
+ *
+ * // Access props (falls back to defaults if not provided)
+ * const count = props.count;
+ * ```
+ */
+export declare function createPropsAccessor<TProps extends Record<string, any>>(reactiveProps: TProps): PropsAccessor<TProps>;
+//# sourceMappingURL=props-accessor.d.ts.map

package/dist/utils/props-accessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"props-accessor.d.ts","sourceRoot":"","sources":["../../src/utils/props-accessor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAClE,aAAa,EAAE,MAAM,GACtB,aAAa,CAAC,MAAM,CAAC,CAmDvB"}

package/dist/utils/slots.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Slots system for component children.
+ * Supports default and named slots with reactivity.
+ */
+/**
+ * Internal slots object with tracking properties
+ */
+export interface InternalSlotsObject {
+    default: () => any[];
+    _children: any;
+    _version: {
+        v: number;
+    };
+    _slotsFromProps: Record<string, any>;
+    _isPatching?: boolean;
+    [key: string]: any;
+}
+/**
+ * Create slots object from children and slots prop.
+ * Uses a version signal to trigger re-renders when children change.
+ *
+ * Supports named slots via:
+ * - `slots` prop object (e.g., `slots={{ header: () => <div>...</div> }}`)
+ * - `slot` prop on children (e.g., `<div slot="header">...</div>`)
+ *
+ * @example
+ * ```tsx
+ * // Parent component
+ * <Card slots={{ header: () => <h1>Title</h1> }}>
+ *   <p>Default content</p>
+ *   <span slot="footer">Footer text</span>
+ * </Card>
+ *
+ * // Card component setup
+ * const slots = createSlots(children, slotsFromProps);
+ * return () => (
+ *   <div>
+ *     {slots.header()}
+ *     {slots.default()}
+ *     {slots.footer()}
+ *   </div>
+ * );
+ * ```
+ */
+export declare function createSlots(children: any, slotsFromProps?: Record<string, any>): InternalSlotsObject;
+//# sourceMappingURL=slots.d.ts.map

package/dist/utils/slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../src/utils/slots.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;IACrB,SAAS,EAAE,GAAG,CAAC;IACf,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,mBAAmB,CAwEpG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sigx/runtime-core",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Runtime core for SignalX",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,7 +37,7 @@
     "url": "https://github.com/signalxjs/core/issues"
   },
   "dependencies": {
-    "@sigx/reactivity": "^0.1.3"
+    "@sigx/reactivity": "^0.1.5"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",