@bromscandium/runtime 1.0.0

package/dist/lifecycle.js

@@ -0,0 +1,116 @@
+/**
+ * Component lifecycle hook system.
+ * @module
+ */
+let currentInstance = null;
+/**
+ * Sets the currently rendering component instance.
+ * Used internally by the renderer.
+ *
+ * @param instance - The component instance or null
+ */
+export function setCurrentInstance(instance) {
+    currentInstance = instance;
+}
+/**
+ * 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 function getCurrentInstance() {
+    return currentInstance;
+}
+function registerLifecycleHook(type, fn) {
+    if (!currentInstance) {
+        if (import.meta.env?.DEV) {
+            console.warn(`${type} hook called outside of component setup. ` +
+                `Lifecycle hooks can only be used inside a component function.`);
+        }
+        return;
+    }
+    currentInstance[type].push(fn);
+}
+/**
+ * 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 function onMounted(fn) {
+    registerLifecycleHook('mounted', fn);
+}
+/**
+ * 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 function onUnmounted(fn) {
+    registerLifecycleHook('unmounted', fn);
+}
+/**
+ * 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 function onUpdated(fn) {
+    registerLifecycleHook('updated', fn);
+}
+/**
+ * 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 function invokeLifecycleHooks(hooks, errorContext) {
+    hooks.forEach(hook => {
+        try {
+            hook();
+        }
+        catch (error) {
+            console.error(`Error in ${errorContext || 'lifecycle hook'}:`, error);
+        }
+    });
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,IAAI,eAAe,GAA6B,IAAI,CAAC;AAErD;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAkC;IACnE,eAAe,GAAG,QAAQ,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,SAAS,qBAAqB,CAC5B,IAAyC,EACzC,EAAc;IAEd,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CACV,GAAG,IAAI,2CAA2C;gBAClD,+DAA+D,CAChE,CAAC;QACJ,CAAC;QACD,OAAO;IACT,CAAC;IAED,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,SAAS,CAAC,EAAc;IACtC,qBAAqB,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,WAAW,CAAC,EAAc;IACxC,qBAAqB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,SAAS,CAAC,EAAc;IACtC,qBAAqB,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAwB,EACxB,YAAqB;IAErB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QACnB,IAAI,CAAC;YACH,IAAI,EAAE,CAAC;QACT,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,YAAY,YAAY,IAAI,gBAAgB,GAAG,EAAE,KAAK,CAAC,CAAC;QACxE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/renderer.d.ts

@@ -0,0 +1,65 @@
+/**
+ * DOM Renderer with virtual DOM reconciliation and diffing.
+ * @module
+ */
+import { VNode, ComponentFunction } from './vnode.js';
+/**
+ * Renders a virtual DOM tree into a container element.
+ * Handles mounting, updating, and unmounting based on the previous state.
+ *
+ * @param vnode - The virtual node to render, or null to unmount
+ * @param container - The DOM element to render into
+ *
+ * @example
+ * ```ts
+ * const vnode = h('div', { className: 'app' }, 'Hello');
+ * render(vnode, document.getElementById('root')!);
+ *
+ * // Update
+ * render(h('div', { className: 'app' }, 'Updated'), container);
+ *
+ * // Unmount
+ * render(null, container);
+ * ```
+ */
+export declare function render(vnode: VNode | null, container: Element): void;
+/**
+ * Configuration options for creating a Bromium application.
+ */
+export interface AppConfig {
+    /** Path to the favicon image */
+    favicon?: string;
+}
+/**
+ * Creates a new Bromium application instance.
+ *
+ * @param rootComponent - The root component function to render
+ * @param config - Optional application configuration
+ * @returns An app instance with mount and unmount methods
+ *
+ * @example
+ * ```ts
+ * function App() {
+ *   return <div>Hello, Bromium!</div>;
+ * }
+ *
+ * const app = createApp(App, { favicon: '/icon.png' });
+ * app.mount('#app');
+ *
+ * // Later: app.unmount();
+ * ```
+ */
+export declare function createApp(rootComponent: ComponentFunction, config?: AppConfig): {
+    /**
+     * Mounts the application to a DOM element.
+     *
+     * @param selector - A CSS selector string or DOM Element to mount to
+     * @returns The app instance for chaining
+     */
+    mount(selector: string | Element): /*elided*/ any;
+    /**
+     * Unmounts the application and cleans up resources.
+     */
+    unmount(): void;
+};
+//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAkB,iBAAiB,EAAqB,MAAM,YAAY,CAAC;AAuBzF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAcpE;AA2eD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAsBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,aAAa,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,SAAS;IAU1E;;;;;OAKG;oBACa,MAAM,GAAG,OAAO;IA0BhC;;OAEG;;EAWN"}