@bromscandium/runtime 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bromscandium
+
+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,91 @@
+# @bromscandium/runtime
+
+JSX runtime, virtual DOM renderer, and hooks for BromiumJS.
+
+## Installation
+
+```bash
+npm install @bromscandium/runtime
+```
+
+## Usage
+
+```tsx
+import { createApp, h, Fragment } from '@bromscandium/runtime';
+import { ref } from '@bromscandium/core';
+
+function Counter() {
+  const count = ref(0);
+
+  return h('div', null,
+    h('p', null, `Count: ${count.value}`),
+    h('button', { onClick: () => count.value++ }, 'Increment')
+  );
+}
+
+createApp(Counter).mount('#app');
+```
+
+### With JSX
+
+Configure your bundler to use `@bromscandium/runtime` as the JSX import source:
+
+```json
+{
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "jsxImportSource": "@bromscandium/runtime"
+  }
+}
+```
+
+```tsx
+function Counter() {
+  const count = ref(0);
+
+  return (
+    <div>
+      <p>Count: {count.value}</p>
+      <button onClick={() => count.value++}>Increment</button>
+    </div>
+  );
+}
+```
+
+### Hooks
+
+```tsx
+import { useState, useRef, useMemo, useCallback, onMounted, onUnmounted } from '@bromscandium/runtime';
+
+function Component() {
+  const count = useState(0);
+  const inputRef = useRef<HTMLInputElement>(null);
+  const doubled = useMemo(() => count.value * 2, [count.value]);
+
+  onMounted(() => console.log('Mounted'));
+  onUnmounted(() => console.log('Unmounted'));
+
+  return <div>{doubled}</div>;
+}
+```
+
+## API
+
+| Export | Description |
+|--------|-------------|
+| `createApp(component)` | Create application instance |
+| `render(vnode, container)` | Render VNode to DOM |
+| `h(type, props, children)` | Create VNode (hyperscript) |
+| `jsx`, `jsxs`, `jsxDEV` | JSX runtime functions |
+| `Fragment` | Fragment component |
+| `useState(initial)` | State hook (returns Ref) |
+| `useRef(initial)` | Mutable ref hook |
+| `useMemo(factory, deps)` | Memoized value hook |
+| `useCallback(fn, deps)` | Memoized callback hook |
+| `onMounted(callback)` | Mount lifecycle hook |
+| `onUpdated(callback)` | Update lifecycle hook |
+| `onUnmounted(callback)` | Unmount lifecycle hook |
+
+## License
+
+MIT

package/dist/hooks.d.ts

@@ -0,0 +1,99 @@
+/**
+ * React-style hooks for state persistence across re-renders.
+ * @module
+ */
+import { Ref } from '@bromscandium/core';
+/**
+ * Creates a reactive state variable that persists across component re-renders.
+ * Similar to React's useState but returns a Ref for reactivity integration.
+ *
+ * @param initialValue - The initial value, or a function that returns the initial value
+ * @returns A reactive ref containing the state value
+ *
+ * @example
+ * ```ts
+ * function Counter() {
+ *   const count = useState(0);
+ *
+ *   return (
+ *     <button onClick={() => count.value++}>
+ *       Count: {count.value}
+ *     </button>
+ *   );
+ * }
+ *
+ * // With lazy initialization
+ * const expensive = useState(() => computeExpensiveValue());
+ * ```
+ */
+export declare function useState<T>(initialValue: T | (() => T)): Ref<T>;
+/**
+ * Creates a mutable ref object that persists across re-renders without triggering updates.
+ * Useful for storing DOM references or mutable values that don't affect rendering.
+ *
+ * @param initialValue - The initial value for the ref
+ * @returns An object with a `current` property containing the value
+ *
+ * @example
+ * ```ts
+ * function TextInput() {
+ *   const inputRef = useRef<HTMLInputElement>(null);
+ *
+ *   onMounted(() => {
+ *     inputRef.current?.focus();
+ *   });
+ *
+ *   return <input ref={inputRef} />;
+ * }
+ *
+ * // Storing mutable values
+ * const renderCount = useRef(0);
+ * renderCount.current++; // Doesn't trigger re-render
+ * ```
+ */
+export declare function useRef<T>(initialValue: T): {
+    current: T;
+};
+/**
+ * Memoizes an expensive computation, recalculating only when dependencies change.
+ *
+ * @param factory - A function that computes and returns the memoized value
+ * @param deps - An array of dependencies that trigger recalculation when changed
+ * @returns The memoized value
+ *
+ * @example
+ * ```ts
+ * function FilteredList({ items, filter }) {
+ *   const filtered = useMemo(
+ *     () => items.filter(item => item.includes(filter)),
+ *     [items, filter]
+ *   );
+ *
+ *   return <ul>{filtered.map(item => <li>{item}</li>)}</ul>;
+ * }
+ * ```
+ */
+export declare function useMemo<T>(factory: () => T, deps: any[]): T;
+/**
+ * Memoizes a callback function, returning the same reference until dependencies change.
+ * Useful for passing stable callbacks to child components to prevent unnecessary re-renders.
+ *
+ * @param callback - The callback function to memoize
+ * @param deps - An array of dependencies that trigger creating a new callback when changed
+ * @returns The memoized callback function
+ *
+ * @example
+ * ```ts
+ * function Parent() {
+ *   const [count, setCount] = useState(0);
+ *
+ *   const handleClick = useCallback(() => {
+ *     console.log('Clicked with count:', count);
+ *   }, [count]);
+ *
+ *   return <Child onClick={handleClick} />;
+ * }
+ * ```
+ */
+export declare function useCallback<T extends (...args: any[]) => any>(callback: T, deps: any[]): T;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAO,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAG9C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAsB/D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,CAczD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAuB3D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC3D,QAAQ,EAAE,CAAC,EACX,IAAI,EAAE,GAAG,EAAE,GACV,CAAC,CAEH"}

package/dist/hooks.js

@@ -0,0 +1,145 @@
+/**
+ * React-style hooks for state persistence across re-renders.
+ * @module
+ */
+import { ref } from '@bromscandium/core';
+import { getCurrentInstance } from './lifecycle.js';
+/**
+ * Creates a reactive state variable that persists across component re-renders.
+ * Similar to React's useState but returns a Ref for reactivity integration.
+ *
+ * @param initialValue - The initial value, or a function that returns the initial value
+ * @returns A reactive ref containing the state value
+ *
+ * @example
+ * ```ts
+ * function Counter() {
+ *   const count = useState(0);
+ *
+ *   return (
+ *     <button onClick={() => count.value++}>
+ *       Count: {count.value}
+ *     </button>
+ *   );
+ * }
+ *
+ * // With lazy initialization
+ * const expensive = useState(() => computeExpensiveValue());
+ * ```
+ */
+export function useState(initialValue) {
+    const instance = getCurrentInstance();
+    if (!instance) {
+        const value = typeof initialValue === 'function'
+            ? initialValue()
+            : initialValue;
+        return ref(value);
+    }
+    const hookIndex = instance.hookIndex++;
+    if (hookIndex >= instance.hooks.length) {
+        const value = typeof initialValue === 'function'
+            ? initialValue()
+            : initialValue;
+        const stateRef = ref(value);
+        instance.hooks.push(stateRef);
+        return stateRef;
+    }
+    return instance.hooks[hookIndex];
+}
+/**
+ * Creates a mutable ref object that persists across re-renders without triggering updates.
+ * Useful for storing DOM references or mutable values that don't affect rendering.
+ *
+ * @param initialValue - The initial value for the ref
+ * @returns An object with a `current` property containing the value
+ *
+ * @example
+ * ```ts
+ * function TextInput() {
+ *   const inputRef = useRef<HTMLInputElement>(null);
+ *
+ *   onMounted(() => {
+ *     inputRef.current?.focus();
+ *   });
+ *
+ *   return <input ref={inputRef} />;
+ * }
+ *
+ * // Storing mutable values
+ * const renderCount = useRef(0);
+ * renderCount.current++; // Doesn't trigger re-render
+ * ```
+ */
+export function useRef(initialValue) {
+    const instance = getCurrentInstance();
+    if (!instance) {
+        return { current: initialValue };
+    }
+    const hookIndex = instance.hookIndex++;
+    if (hookIndex >= instance.hooks.length) {
+        instance.hooks.push({ current: initialValue });
+    }
+    return instance.hooks[hookIndex];
+}
+/**
+ * Memoizes an expensive computation, recalculating only when dependencies change.
+ *
+ * @param factory - A function that computes and returns the memoized value
+ * @param deps - An array of dependencies that trigger recalculation when changed
+ * @returns The memoized value
+ *
+ * @example
+ * ```ts
+ * function FilteredList({ items, filter }) {
+ *   const filtered = useMemo(
+ *     () => items.filter(item => item.includes(filter)),
+ *     [items, filter]
+ *   );
+ *
+ *   return <ul>{filtered.map(item => <li>{item}</li>)}</ul>;
+ * }
+ * ```
+ */
+export function useMemo(factory, deps) {
+    const instance = getCurrentInstance();
+    if (!instance) {
+        return factory();
+    }
+    const hookIndex = instance.hookIndex++;
+    if (hookIndex >= instance.hooks.length) {
+        instance.hooks.push({ value: factory(), deps });
+        return instance.hooks[hookIndex].value;
+    }
+    const hook = instance.hooks[hookIndex];
+    const depsChanged = !hook.deps || deps.some((dep, i) => dep !== hook.deps[i]);
+    if (depsChanged) {
+        hook.value = factory();
+        hook.deps = deps;
+    }
+    return hook.value;
+}
+/**
+ * Memoizes a callback function, returning the same reference until dependencies change.
+ * Useful for passing stable callbacks to child components to prevent unnecessary re-renders.
+ *
+ * @param callback - The callback function to memoize
+ * @param deps - An array of dependencies that trigger creating a new callback when changed
+ * @returns The memoized callback function
+ *
+ * @example
+ * ```ts
+ * function Parent() {
+ *   const [count, setCount] = useState(0);
+ *
+ *   const handleClick = useCallback(() => {
+ *     console.log('Clicked with count:', count);
+ *   }, [count]);
+ *
+ *   return <Child onClick={handleClick} />;
+ * }
+ * ```
+ */
+export function useCallback(callback, deps) {
+    return useMemo(() => callback, deps);
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,GAAG,EAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,QAAQ,CAAI,YAA2B;IACrD,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;IAEtC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,KAAK,GAAG,OAAO,YAAY,KAAK,UAAU;YAC9C,CAAC,CAAE,YAAwB,EAAE;YAC7B,CAAC,CAAC,YAAY,CAAC;QACjB,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;IAEvC,IAAI,SAAS,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,OAAO,YAAY,KAAK,UAAU;YAC9C,CAAC,CAAE,YAAwB,EAAE;YAC7B,CAAC,CAAC,YAAY,CAAC;QACjB,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QAC5B,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,MAAM,CAAI,YAAe;IACvC,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;IAEtC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IACnC,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;IAEvC,IAAI,SAAS,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACvC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,OAAO,CAAI,OAAgB,EAAE,IAAW;IACtD,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;IAEtC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;IAEvC,IAAI,SAAS,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACvC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,OAAO,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC;IACzC,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9E,IAAI,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC;AACpB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,WAAW,CACzB,QAAW,EACX,IAAW;IAEX,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export type { VNode, VNodeChild, VNodeChildren, VNodeType, ComponentFunction, ComponentInstance, } from './vnode.js';
+export { Fragment, Text, createVNode, normalizeChildren, createTextVNode, isVNode, } from './vnode.js';
+export { jsx, jsxs, jsxDEV, createElement, h, } from './jsx-runtime.js';
+export type { JSXElement } from './jsx-runtime.js';
+export { render, createApp, } from './renderer.js';
+export type { AppConfig } from './renderer.js';
+export { onMounted, onUnmounted, onUpdated, getCurrentInstance, setCurrentInstance, } from './lifecycle.js';
+export { useState, useRef, useMemo, useCallback, } from './hooks.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,KAAK,EACL,UAAU,EACV,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,QAAQ,EACR,IAAI,EACJ,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,OAAO,GACR,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,GAAG,EACH,IAAI,EACJ,MAAM,EACN,aAAa,EACb,CAAC,GACF,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EACL,MAAM,EACN,SAAS,GACV,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EACL,SAAS,EACT,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,QAAQ,EACR,MAAM,EACN,OAAO,EACP,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+// Runtime package exports
+// Value exports from vnode
+export { Fragment, Text, createVNode, normalizeChildren, createTextVNode, isVNode, } from './vnode.js';
+// Value exports from jsx-runtime
+export { jsx, jsxs, jsxDEV, createElement, h, } from './jsx-runtime.js';
+export { render, createApp, } from './renderer.js';
+export { onMounted, onUnmounted, onUpdated, getCurrentInstance, setCurrentInstance, } from './lifecycle.js';
+// Hooks for state persistence
+export { useState, useRef, useMemo, useCallback, } from './hooks.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAY1B,2BAA2B;AAC3B,OAAO,EACL,QAAQ,EACR,IAAI,EACJ,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,OAAO,GACR,MAAM,YAAY,CAAC;AAEpB,iCAAiC;AACjC,OAAO,EACL,GAAG,EACH,IAAI,EACJ,MAAM,EACN,aAAa,EACb,CAAC,GACF,MAAM,kBAAkB,CAAC;AAK1B,OAAO,EACL,MAAM,EACN,SAAS,GACV,MAAM,eAAe,CAAC;AAIvB,OAAO,EACL,SAAS,EACT,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,8BAA8B;AAC9B,OAAO,EACL,QAAQ,EACR,MAAM,EACN,OAAO,EACP,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/jsx-runtime.d.ts

@@ -0,0 +1,77 @@
+/**
+ * JSX Runtime for TypeScript/Vite.
+ * Configure in tsconfig.json: "jsx": "react-jsx", "jsxImportSource": "@bromscandium/runtime"
+ * @module
+ */
+import { Fragment, VNode, VNodeType } from './vnode.js';
+export { Fragment };
+/**
+ * JSX element type alias for VNode.
+ */
+export interface JSXElement extends VNode {
+}
+/**
+ * Creates a virtual node from JSX syntax (React 17+ automatic runtime).
+ * This is called automatically by the TypeScript/Babel JSX transform.
+ *
+ * @param type - Element type (tag name or component function)
+ * @param props - Props object including children
+ * @param key - Optional key for list reconciliation
+ * @returns A virtual node
+ */
+export declare function jsx(type: VNodeType, props: Record<string, any> | null, key?: string | number | null): VNode;
+/**
+ * Creates a virtual node with static children (optimization hint).
+ * Functionally identical to jsx() but indicates children won't change.
+ *
+ * @param type - Element type (tag name or component function)
+ * @param props - Props object including children
+ * @param key - Optional key for list reconciliation
+ * @returns A virtual node
+ */
+export declare function jsxs(type: VNodeType, props: Record<string, any> | null, key?: string | number | null): VNode;
+/**
+ * Development version of jsx() with extra validation and warnings.
+ * Only performs validation when import.meta.env.DEV is true.
+ *
+ * @param type - Element type (tag name or component function)
+ * @param props - Props object including children
+ * @param key - Optional key for list reconciliation
+ * @param _isStatic - Unused static children hint
+ * @param _source - Source location for error messages
+ * @param _self - Component reference for error messages
+ * @returns A virtual node
+ */
+export declare function jsxDEV(type: VNodeType, props: Record<string, any> | null, key?: string | number | null, _isStatic?: boolean, _source?: {
+    fileName: string;
+    lineNumber: number;
+    columnNumber: number;
+}, _self?: any): VNode;
+/**
+ * Creates a virtual node using classic createElement syntax.
+ * Use this for manual VNode creation without JSX.
+ *
+ * @param type - Element type (tag name or component function)
+ * @param props - Props object (without children)
+ * @param children - Child elements as rest parameters
+ * @returns A virtual node
+ *
+ * @example
+ * ```ts
+ * const vnode = createElement('div', { className: 'app' },
+ *   createElement('h1', null, 'Hello'),
+ *   createElement('p', null, 'World')
+ * );
+ * ```
+ */
+export declare function createElement(type: VNodeType, props: Record<string, any> | null, ...children: any[]): VNode;
+/**
+ * Alias for createElement, providing a shorter hyperscript-style API.
+ *
+ * @example
+ * ```ts
+ * const vnode = h('div', { className: 'app' }, h('span', null, 'Hello'));
+ * ```
+ */
+export declare const h: typeof createElement;
+//# sourceMappingURL=jsx-runtime.d.ts.map

package/dist/jsx-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.d.ts","sourceRoot":"","sources":["../src/jsx-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAc,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAC,MAAM,YAAY,CAAC;AAEnE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,KAAK;CAAG;AAE5C;;;;;;;;GAQG;AACH,wBAAgB,GAAG,CACjB,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,EACjC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAC3B,KAAK,CAQP;AAED;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAClB,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,EACjC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAC3B,KAAK,CAEP;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CACpB,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,EACjC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC5B,SAAS,CAAC,EAAE,OAAO,EACnB,OAAO,CAAC,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,EACxE,KAAK,CAAC,EAAE,GAAG,GACV,KAAK,CAmBP;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,EACjC,GAAG,QAAQ,EAAE,GAAG,EAAE,GACjB,KAAK,CAKP;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,CAAC,sBAAgB,CAAC"}

package/dist/jsx-runtime.js

@@ -0,0 +1,90 @@
+/**
+ * JSX Runtime for TypeScript/Vite.
+ * Configure in tsconfig.json: "jsx": "react-jsx", "jsxImportSource": "@bromscandium/runtime"
+ * @module
+ */
+import { createVNode, Fragment } from './vnode.js';
+export { Fragment };
+/**
+ * Creates a virtual node from JSX syntax (React 17+ automatic runtime).
+ * This is called automatically by the TypeScript/Babel JSX transform.
+ *
+ * @param type - Element type (tag name or component function)
+ * @param props - Props object including children
+ * @param key - Optional key for list reconciliation
+ * @returns A virtual node
+ */
+export function jsx(type, props, key) {
+    const { children, ...restProps } = props || {};
+    return createVNode(type, { ...restProps, key: key ?? restProps?.key }, children);
+}
+/**
+ * Creates a virtual node with static children (optimization hint).
+ * Functionally identical to jsx() but indicates children won't change.
+ *
+ * @param type - Element type (tag name or component function)
+ * @param props - Props object including children
+ * @param key - Optional key for list reconciliation
+ * @returns A virtual node
+ */
+export function jsxs(type, props, key) {
+    return jsx(type, props, key);
+}
+/**
+ * Development version of jsx() with extra validation and warnings.
+ * Only performs validation when import.meta.env.DEV is true.
+ *
+ * @param type - Element type (tag name or component function)
+ * @param props - Props object including children
+ * @param key - Optional key for list reconciliation
+ * @param _isStatic - Unused static children hint
+ * @param _source - Source location for error messages
+ * @param _self - Component reference for error messages
+ * @returns A virtual node
+ */
+export function jsxDEV(type, props, key, _isStatic, _source, _self) {
+    if (import.meta.env?.DEV) {
+        if (typeof type === 'string' && type !== type.toLowerCase() && !type.includes('-')) {
+            console.warn(`Invalid element type: "${type}". HTML elements must be lowercase. ` +
+                `Did you mean to use a component? Components should start with uppercase.`);
+        }
+        if (props) {
+            if ('class' in props && !('className' in props)) {
+                console.warn(`Invalid prop "class" detected. Use "className" instead.`);
+            }
+        }
+    }
+    return jsx(type, props, key);
+}
+/**
+ * Creates a virtual node using classic createElement syntax.
+ * Use this for manual VNode creation without JSX.
+ *
+ * @param type - Element type (tag name or component function)
+ * @param props - Props object (without children)
+ * @param children - Child elements as rest parameters
+ * @returns A virtual node
+ *
+ * @example
+ * ```ts
+ * const vnode = createElement('div', { className: 'app' },
+ *   createElement('h1', null, 'Hello'),
+ *   createElement('p', null, 'World')
+ * );
+ * ```
+ */
+export function createElement(type, props, ...children) {
+    const normalizedProps = props || {};
+    const flatChildren = children.length === 1 ? children[0] : children;
+    return createVNode(type, normalizedProps, flatChildren);
+}
+/**
+ * Alias for createElement, providing a shorter hyperscript-style API.
+ *
+ * @example
+ * ```ts
+ * const vnode = h('div', { className: 'app' }, h('span', null, 'Hello'));
+ * ```
+ */
+export const h = createElement;
+//# sourceMappingURL=jsx-runtime.js.map

package/dist/jsx-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.js","sourceRoot":"","sources":["../src/jsx-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,WAAW,EAAE,QAAQ,EAAmB,MAAM,YAAY,CAAC;AAEnE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAOpB;;;;;;;;GAQG;AACH,MAAM,UAAU,GAAG,CACjB,IAAe,EACf,KAAiC,EACjC,GAA4B;IAE5B,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAS,EAAE,GAAG,KAAK,IAAI,EAAE,CAAC;IAE/C,OAAO,WAAW,CAChB,IAAI,EACJ,EAAC,GAAG,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI,SAAS,EAAE,GAAG,EAAC,EAC1C,QAAQ,CACT,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,IAAI,CAClB,IAAe,EACf,KAAiC,EACjC,GAA4B;IAE5B,OAAO,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,MAAM,CACpB,IAAe,EACf,KAAiC,EACjC,GAA4B,EAC5B,SAAmB,EACnB,OAAwE,EACxE,KAAW;IAEX,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;QACzB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACnF,OAAO,CAAC,IAAI,CACV,0BAA0B,IAAI,sCAAsC;gBACpE,0EAA0E,CAC3E,CAAC;QACJ,CAAC;QAED,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,WAAW,IAAI,KAAK,CAAC,EAAE,CAAC;gBAChD,OAAO,CAAC,IAAI,CACV,yDAAyD,CAC1D,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAe,EACf,KAAiC,EACjC,GAAG,QAAe;IAElB,MAAM,eAAe,GAAG,KAAK,IAAI,EAAE,CAAC;IACpC,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAEpE,OAAO,WAAW,CAAC,IAAI,EAAE,eAAe,EAAE,YAAY,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC"}

package/dist/lifecycle.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Component lifecycle hook system.
+ * @module
+ */
+import { ComponentInstance } from './vnode.js';
+/**
+ * Sets the currently rendering component instance.
+ * Used internally by the renderer.
+ *
+ * @param instance - The component instance or null
+ */
+export declare function setCurrentInstance(instance: ComponentInstance | null): void;
+/**
+ * Returns the currently rendering component instance.
+ * Used internally by hooks to access component state.
+ *
+ * @returns The current component instance or null if outside a component
+ */
+export declare function getCurrentInstance(): ComponentInstance | null;
+/**
+ * Registers a callback to be invoked after the component is mounted to the DOM.
+ * The callback runs after the initial render and DOM insertion.
+ *
+ * @param fn - The callback function to invoke on mount
+ *
+ * @example
+ * ```ts
+ * function MyComponent() {
+ *   onMounted(() => {
+ *     console.log('Component mounted!');
+ *     // DOM is available here
+ *   });
+ *
+ *   return <div>Hello</div>;
+ * }
+ * ```
+ */
+export declare function onMounted(fn: () => void): void;
+/**
+ * Registers a callback to be invoked before the component is unmounted.
+ * Use this to clean up side effects like timers, subscriptions, or event listeners.
+ *
+ * @param fn - The callback function to invoke on unmount
+ *
+ * @example
+ * ```ts
+ * function MyComponent() {
+ *   const timer = setInterval(() => {}, 1000);
+ *
+ *   onUnmounted(() => {
+ *     clearInterval(timer);
+ *   });
+ *
+ *   return <div>Hello</div>;
+ * }
+ * ```
+ */
+export declare function onUnmounted(fn: () => void): void;
+/**
+ * Registers a callback to be invoked after the component updates.
+ * The callback runs after each re-render caused by reactive state changes.
+ *
+ * @param fn - The callback function to invoke after updates
+ *
+ * @example
+ * ```ts
+ * function MyComponent() {
+ *   const count = ref(0);
+ *
+ *   onUpdated(() => {
+ *     console.log('Component updated, count is now:', count.value);
+ *   });
+ *
+ *   return <button onClick={() => count.value++}>{count.value}</button>;
+ * }
+ * ```
+ */
+export declare function onUpdated(fn: () => void): void;
+/**
+ * Invokes an array of lifecycle hook callbacks with error handling.
+ * Used internally by the renderer.
+ *
+ * @param hooks - Array of callback functions to invoke
+ * @param errorContext - Description of the hook type for error messages
+ */
+export declare function invokeLifecycleHooks(hooks: Array<() => void>, errorContext?: string): void;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAI/C;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAE3E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,iBAAiB,GAAG,IAAI,CAE7D;AAmBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAE9C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAEhD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAE9C;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,EACxB,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CAQN"}