@sigx/runtime-core 0.1.2 → 0.1.4

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/renderer.d.ts

@@ -1,5 +1,34 @@
-import { JSXElement } from './jsx-runtime.js';
+import { VNode, JSXElement } from './jsx-runtime.js';
+import { EffectRunner } from '@sigx/reactivity';
 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>;
+}
+/**
+ * Internal slots object with tracking properties
+ */
+interface InternalSlotsObject {
+    default: () => any[];
+    _children: any;
+    _version: {
+        v: number;
+    };
+    _slotsFromProps: Record<string, any>;
+    _isPatching?: boolean;
+    [key: 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;
@@ -23,4 +52,5 @@ export declare function createRenderer<HostNode = any, HostElement = any>(option
         mount(selectorOrContainer: string | HostElement): void;
     };
 };
+export {};
 //# 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/package.json

@@ -1,52 +1,51 @@
-{
-    "name": "@sigx/runtime-core",
-    "version": "0.1.2",
-    "description": "Runtime core for SignalX",
-    "type": "module",
-    "main": "./dist/index.js",
-    "types": "./dist/index.d.ts",
-    "exports": {
-        ".": {
-            "import": "./dist/index.js",
-            "types": "./dist/index.d.ts"
-        },
-        "./jsx-runtime": {
-            "import": "./dist/index.js",
-            "types": "./dist/index.d.ts"
-        }
-    },
-    "files": [
-        "dist"
-    ],
-    "scripts": {
-        "build": "rolldown -c && tsc --emitDeclarationOnly",
-        "dev": "rolldown -c -w"
-    },
-    "keywords": [
-        "sigx",
-        "runtime",
-        "core",
-        "components",
-        "framework"
-    ],
-    "author": "Andreas Ekdahl",
-    "license": "MIT",
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/signalxjs/core.git",
-        "directory": "packages/runtime-core"
-    },
-    "homepage": "https://github.com/signalxjs",
-    "bugs": {
-        "url": "https://github.com/signalxjs/core/issues"
-    },
-    "dependencies": {
-        "@sigx/reactivity": "workspace:^"
-    },
-    "devDependencies": {
-        "@types/node": "^20.0.0",
-        "rolldown": "^1.0.0-beta.52",
-        "typescript": "^5.9.3"
-    }
-}
-
+{
+  "name": "@sigx/runtime-core",
+  "version": "0.1.4",
+  "description": "Runtime core for SignalX",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./jsx-runtime": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "sigx",
+    "runtime",
+    "core",
+    "components",
+    "framework"
+  ],
+  "author": "Andreas Ekdahl",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/signalxjs/core.git",
+    "directory": "packages/runtime-core"
+  },
+  "homepage": "https://github.com/signalxjs",
+  "bugs": {
+    "url": "https://github.com/signalxjs/core/issues"
+  },
+  "dependencies": {
+    "@sigx/reactivity": "^0.1.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "rolldown": "^1.0.0-beta.52",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "rolldown -c && tsc --emitDeclarationOnly",
+    "dev": "rolldown -c -w"
+  }
+}