@liteforge/runtime 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SchildW3rk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,216 @@
+# @liteforge/runtime
+
+DOM runtime for LiteForge: components, context, lifecycle, and control flow.
+
+## Installation
+
+```bash
+npm install @liteforge/runtime @liteforge/core
+```
+
+Peer dependency: `@liteforge/core >= 0.1.0`
+
+## Overview
+
+`@liteforge/runtime` provides the component model, app creation, context system, and control flow primitives for LiteForge applications.
+
+## API
+
+### createApp
+
+Creates and mounts a LiteForge application.
+
+```tsx
+import { createApp } from '@liteforge/runtime'
+import { App } from './App'
+
+const app = createApp({
+  root: '#app',          // CSS selector or HTMLElement
+  router: myRouter,      // Optional: router instance
+  stores: [userStore],   // Optional: stores to register
+  plugins: [devtools()], // Optional: plugins
+})
+
+app.mount(App)
+```
+
+### createComponent
+
+Creates a component with lifecycle hooks and async data loading.
+
+```tsx
+import { createComponent } from '@liteforge/runtime'
+import { signal } from '@liteforge/core'
+
+const UserProfile = createComponent({
+  // Define props with validation
+  props: {
+    userId: { type: String, required: true },
+    showEmail: { type: Boolean, default: false }
+  },
+
+  // Synchronous setup (runs immediately)
+  setup({ props, use }) {
+    const isEditing = signal(false)
+    return { isEditing }
+  },
+
+  // Async data loading (component waits for this)
+  async load({ props, setup, use }) {
+    const api = use('api')
+    const user = await api.get(`/users/${props.userId}`)
+    return { user }
+  },
+
+  // Shown while load() is pending
+  placeholder: () => <div class="skeleton" />,
+
+  // Shown if load() throws
+  error: ({ error, retry }) => (
+    <div>
+      <p>Error: {error.message}</p>
+      <button onclick={retry}>Retry</button>
+    </div>
+  ),
+
+  // Main render function
+  component: ({ props, data, setup }) => (
+    <div>
+      <h1>{data.user.name}</h1>
+      {() => props.showEmail && <p>{data.user.email}</p>}
+    </div>
+  ),
+
+  // After DOM insertion
+  mounted({ el }) {
+    el.classList.add('fade-in')
+  },
+
+  // Before removal
+  destroyed() {
+    console.log('Cleanup')
+  }
+})
+```
+
+**Lifecycle Order:** `setup()` → `placeholder` renders → `load()` → `component` renders → `mounted()` → `destroyed()`
+
+### use
+
+Access registered services, stores, and the router.
+
+```tsx
+import { use } from '@liteforge/runtime'
+
+// Inside a component
+const MyComponent = createComponent({
+  component: () => {
+    const router = use('router')
+    const userStore = use('users')
+    
+    return <button onclick={() => router.navigate('/')}>Home</button>
+  }
+})
+```
+
+### Control Flow
+
+#### Show
+
+Conditionally renders content.
+
+```tsx
+import { Show } from '@liteforge/runtime'
+
+<Show when={() => isLoggedIn()} fallback={<LoginPrompt />}>
+  <Dashboard />
+</Show>
+```
+
+#### For
+
+Renders a list of items.
+
+```tsx
+import { For } from '@liteforge/runtime'
+
+<For each={() => items()} fallback={<p>No items</p>}>
+  {(item, index) => (
+    <li>{index()}: {item.name}</li>
+  )}
+</For>
+```
+
+#### Switch / Match
+
+Renders the first matching case.
+
+```tsx
+import { Switch, Match } from '@liteforge/runtime'
+
+<Switch fallback={<NotFound />}>
+  <Match when={() => status() === 'loading'}>
+    <Spinner />
+  </Match>
+  <Match when={() => status() === 'error'}>
+    <ErrorMessage />
+  </Match>
+  <Match when={() => status() === 'success'}>
+    <Content />
+  </Match>
+</Switch>
+```
+
+#### Dynamic
+
+Dynamically renders a component based on a signal.
+
+```tsx
+import { Dynamic } from '@liteforge/runtime'
+
+const currentView = signal(HomeView)
+
+<Dynamic component={() => currentView()} props={{ user }} />
+```
+
+### h and Fragment
+
+The JSX factory functions (used by the Vite plugin).
+
+```tsx
+import { h, Fragment } from '@liteforge/runtime'
+
+// Usually not called directly — JSX compiles to h() calls
+const element = h('div', { class: 'container' }, 
+  h('p', null, 'Hello')
+)
+
+// Fragment for multiple root elements
+const items = (
+  <>
+    <li>One</li>
+    <li>Two</li>
+  </>
+)
+```
+
+## Types
+
+```ts
+import type {
+  ComponentDefinition,
+  ComponentFactory,
+  AppConfig,
+  AppInstance,
+  Plugin,
+  ShowProps,
+  ForProps,
+  SwitchProps,
+  MatchProps,
+  DynamicProps
+} from '@liteforge/runtime'
+```
+
+## License
+
+MIT

package/dist/app.d.ts

@@ -0,0 +1,38 @@
+/**
+ * LiteForge createApp
+ *
+ * Central app bootstrap: mounts root component, initializes stores,
+ * sets up context, router, plugins, and debug utilities.
+ */
+import type { AppConfig, AppInstance } from './types.js';
+/**
+ * Create and bootstrap a LiteForge application.
+ *
+ * This is an async function that:
+ * 1. Resolves the target element
+ * 2. Builds the app context (custom context + router + stores)
+ * 3. Runs plugin beforeInit hooks
+ * 4. Initializes stores (calls initialize() if present)
+ * 5. Starts the router (if present)
+ * 6. Mounts the root component
+ * 7. Runs plugin afterMount hooks
+ * 8. Sets up debug utilities (if debug mode)
+ * 9. Calls onReady callback
+ *
+ * @param config - Application configuration
+ * @returns Promise resolving to the app instance
+ *
+ * @example
+ * ```ts
+ * const app = await createApp({
+ *   root: App,
+ *   target: '#app',
+ *   router: createAppRouter(),
+ *   stores: [authStore, uiStore],
+ *   context: { api: createApiClient() },
+ *   debug: true,
+ * });
+ * ```
+ */
+export declare function createApp(config: AppConfig): Promise<AppInstance>;
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EAIZ,MAAM,YAAY,CAAC;AAoBpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAuPvE"}

package/dist/app.js

@@ -0,0 +1,266 @@
+/**
+ * LiteForge createApp
+ *
+ * Central app bootstrap: mounts root component, initializes stores,
+ * sets up context, router, plugins, and debug utilities.
+ */
+import { initAppContext, clearContext, use } from './context.js';
+import { isComponentFactory } from './component.js';
+// ============================================================================
+// createApp Implementation
+// ============================================================================
+/**
+ * Create and bootstrap a LiteForge application.
+ *
+ * This is an async function that:
+ * 1. Resolves the target element
+ * 2. Builds the app context (custom context + router + stores)
+ * 3. Runs plugin beforeInit hooks
+ * 4. Initializes stores (calls initialize() if present)
+ * 5. Starts the router (if present)
+ * 6. Mounts the root component
+ * 7. Runs plugin afterMount hooks
+ * 8. Sets up debug utilities (if debug mode)
+ * 9. Calls onReady callback
+ *
+ * @param config - Application configuration
+ * @returns Promise resolving to the app instance
+ *
+ * @example
+ * ```ts
+ * const app = await createApp({
+ *   root: App,
+ *   target: '#app',
+ *   router: createAppRouter(),
+ *   stores: [authStore, uiStore],
+ *   context: { api: createApiClient() },
+ *   debug: true,
+ * });
+ * ```
+ */
+export async function createApp(config) {
+    let rootInstance = null;
+    let rootNode = null;
+    let targetElement = null;
+    let isMounted = false;
+    const appContext = {};
+    const storesMap = {};
+    // Determine debug mode (auto-detect from Vite's import.meta.env.DEV)
+    const isDebug = config.debug ??
+        (typeof globalThis !== 'undefined' &&
+            globalThis.__DEV__ === true);
+    try {
+        // ========================================
+        // 1. Resolve target element
+        // ========================================
+        if (typeof config.target === 'string') {
+            targetElement = document.querySelector(config.target);
+            if (!targetElement) {
+                throw new Error(`Target element "${config.target}" not found`);
+            }
+        }
+        else {
+            targetElement = config.target;
+        }
+        // ========================================
+        // 2. Build app context
+        // ========================================
+        // 2a. Custom context values
+        if (config.context) {
+            Object.assign(appContext, config.context);
+        }
+        // 2b. Router
+        if (config.router) {
+            appContext.router = config.router;
+        }
+        // 2c. Stores - register under $name and with store: prefix
+        if (config.stores) {
+            for (const store of config.stores) {
+                storesMap[store.$name] = store;
+                appContext[`store:${store.$name}`] = store;
+                // Also register directly by name for convenience
+                appContext[store.$name] = store;
+            }
+        }
+        // 2d. Plugin provide values
+        if (config.plugins) {
+            for (const plugin of config.plugins) {
+                if (plugin.provide) {
+                    Object.assign(appContext, plugin.provide);
+                }
+            }
+        }
+        // ========================================
+        // 3. Plugin beforeInit hooks
+        // ========================================
+        if (config.plugins) {
+            for (const plugin of config.plugins) {
+                if (plugin.beforeInit) {
+                    await plugin.beforeInit({ context: appContext });
+                }
+            }
+        }
+        // Initialize app-level context (makes use() work)
+        initAppContext(appContext);
+        // ========================================
+        // 4. Initialize stores
+        // ========================================
+        if (config.stores) {
+            for (const store of config.stores) {
+                if ('initialize' in store && typeof store.initialize === 'function') {
+                    if (isDebug) {
+                        console.log(`[LiteForge] Initializing store: ${store.$name}`);
+                    }
+                    await store.initialize();
+                }
+            }
+        }
+        // ========================================
+        // 5. Start router
+        // ========================================
+        if (config.router && 'start' in config.router && typeof config.router.start === 'function') {
+            if (isDebug) {
+                console.log('[LiteForge] Starting router...');
+            }
+            await config.router.start();
+        }
+        // ========================================
+        // 6. Mount root component
+        // ========================================
+        const rootConfig = config.root;
+        if (isComponentFactory(rootConfig)) {
+            // It's a ComponentFactory from createComponent()
+            rootInstance = rootConfig({});
+            rootInstance.mount(targetElement);
+        }
+        else {
+            // It's a simple render function () => Node
+            rootNode = rootConfig();
+            targetElement.appendChild(rootNode);
+        }
+        isMounted = true;
+        // ========================================
+        // 7. Plugin afterMount hooks
+        // ========================================
+        // Create app instance first so plugins can use it
+        // Note: We build the object conditionally to satisfy exactOptionalPropertyTypes
+        const app = Object.assign({
+            unmount,
+            use: createAppUse(appContext),
+            stores: storesMap,
+        }, config.router ? { router: config.router } : {});
+        if (config.plugins) {
+            for (const plugin of config.plugins) {
+                if (plugin.afterMount) {
+                    await plugin.afterMount(app);
+                }
+            }
+        }
+        // ========================================
+        // 8. Debug utilities
+        // ========================================
+        if (isDebug && typeof window !== 'undefined') {
+            const debugUtils = {
+                router: config.router,
+                stores: storesMap,
+                snapshot: () => {
+                    const result = {};
+                    for (const [name, store] of Object.entries(storesMap)) {
+                        result[name] = store.$snapshot();
+                    }
+                    return result;
+                },
+                unmount: () => app.unmount(),
+                context: appContext,
+            };
+            Object.defineProperty(window, '$lf', {
+                value: debugUtils,
+                configurable: true,
+                writable: false,
+            });
+            console.log('='.repeat(50));
+            console.log('[LiteForge] Application started in debug mode');
+            console.log('  $lf.stores    — Store instances');
+            console.log('  $lf.router    — Router instance');
+            console.log('  $lf.snapshot()— Full state snapshot');
+            console.log('  $lf.context   — App context');
+            console.log('  $lf.unmount() — Unmount app');
+            console.log('='.repeat(50));
+        }
+        // ========================================
+        // 9. onReady callback
+        // ========================================
+        if (config.onReady) {
+            config.onReady(app);
+        }
+        return app;
+    }
+    catch (error) {
+        // Handle bootstrap errors
+        const err = error instanceof Error ? error : new Error(String(error));
+        if (config.onError) {
+            config.onError(err);
+        }
+        // Re-throw so the promise rejects
+        throw err;
+    }
+    // ========================================
+    // Internal Functions
+    // ========================================
+    function unmount() {
+        if (!isMounted)
+            return;
+        // Plugin beforeUnmount hooks
+        if (config.plugins) {
+            for (const plugin of config.plugins) {
+                if (plugin.beforeUnmount) {
+                    const appForPlugin = Object.assign({
+                        unmount,
+                        use: createAppUse(appContext),
+                        stores: storesMap,
+                    }, config.router ? { router: config.router } : {});
+                    plugin.beforeUnmount(appForPlugin);
+                }
+            }
+        }
+        // Unmount root component
+        if (rootInstance) {
+            rootInstance.unmount();
+            rootInstance = null;
+        }
+        // Remove simple render function node
+        if (rootNode && rootNode.parentNode) {
+            rootNode.parentNode.removeChild(rootNode);
+            rootNode = null;
+        }
+        // Clear target element
+        if (targetElement) {
+            targetElement.innerHTML = '';
+        }
+        // Stop router
+        if (config.router && 'stop' in config.router && typeof config.router.stop === 'function') {
+            config.router.stop();
+        }
+        // Remove debug utilities from window
+        if (typeof window !== 'undefined' && '$lf' in window) {
+            delete window.$lf;
+        }
+        // Clear context
+        clearContext();
+        isMounted = false;
+    }
+}
+/**
+ * Create a bound use() function for the app instance.
+ * This allows accessing context from outside components.
+ */
+function createAppUse(appContext) {
+    return function appUse(key) {
+        if (key in appContext) {
+            return appContext[key];
+        }
+        // Fall back to global use() which checks the context stack
+        return use(key);
+    };
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

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

package/dist/component.d.ts

@@ -0,0 +1,45 @@
+/**
+ * LiteForge createComponent
+ *
+ * The central factory for creating reactive components with full lifecycle support.
+ *
+ * Lifecycle Flow:
+ * 1. setup()      - Synchronous, create local signals
+ * 2. placeholder  - Shown immediately (if load exists)
+ * 3. load()       - Async data fetching
+ * 4. component()  - Render (only when load resolved)
+ * 5. mounted()    - After DOM insertion
+ * 6. destroyed()  - On unmount
+ */
+import type { ComponentDefinition, ComponentFactory, PropDefinition, InputPropsFromSchema, Simplify } from './types.js';
+/**
+ * Create a component factory from a component definition.
+ *
+ * @param definition - The component definition object
+ * @returns A component factory function
+ *
+ * @example
+ * ```ts
+ * const MyComponent = createComponent({
+ *   props: { name: { type: String, required: true } },
+ *   setup({ props }) {
+ *     const count = signal(0);
+ *     return { count };
+ *   },
+ *   component({ props, setup }) {
+ *     return <div>Hello {props.name}, count: {setup.count()}</div>;
+ *   },
+ * });
+ * ```
+ */
+export declare function createComponent<Schema extends Record<string, PropDefinition<unknown>>, P extends {
+    [K in keyof Schema]: Schema[K] extends PropDefinition<infer T> ? T : never;
+}, D = undefined, S = undefined>(definition: ComponentDefinition<P, D, S> & {
+    props: Schema;
+}): ComponentFactory<P, Simplify<InputPropsFromSchema<Schema, P>>>;
+export declare function createComponent<P extends Record<string, unknown> = Record<string, unknown>, D = undefined, S = undefined>(definition: ComponentDefinition<P, D, S>): ComponentFactory<P, P>;
+/**
+ * Check if a value is a LiteForge component factory.
+ */
+export declare function isComponentFactory(value: unknown): value is ComponentFactory<Record<string, unknown>>;
+//# sourceMappingURL=component.d.ts.map

package/dist/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAEhB,cAAc,EACd,oBAAoB,EACpB,QAAQ,EACT,MAAM,YAAY,CAAC;AAuBpB;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,wBAAgB,eAAe,CAC7B,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,EACtD,CAAC,SAAS;KAAG,CAAC,IAAI,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;CAAE,EACxF,CAAC,GAAG,SAAS,EACb,CAAC,GAAG,SAAS,EAEb,UAAU,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3D,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC,oBAAoB,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAGlE,wBAAgB,eAAe,CAC7B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,CAAC,GAAG,SAAS,EACb,CAAC,GAAG,SAAS,EACb,UAAU,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAkTpE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAKrG"}