@fukict/basic 0.1.0

package/dist/renderer/index.js

@@ -0,0 +1,93 @@
+/**
+ * @fukict/basic - Renderer
+ *
+ * Main rendering API
+ */
+import * as dom from '../dom/index.js';
+import { createRealNode } from './create.js';
+import { removeNode } from './diff/index.js';
+import { activate } from './mount.js';
+// Export diff function for use in Fukict.update
+export { diff } from './diff/index.js';
+/**
+ * Attach VNode to container (complete mounting flow)
+ *
+ * @param vnode - VNode to render
+ * @param container - Container element
+ * @returns Unmount function
+ */
+export function attach(vnode, container) {
+    if (vnode === null || vnode === undefined) {
+        // Clear container
+        while (container.firstChild) {
+            dom.removeChild(container, container.firstChild);
+        }
+        return null;
+    }
+    // 1. Create real DOM nodes (ClassComponent creates placeholder)
+    createRealNode(vnode);
+    // 2. Activate: mount DOM and trigger lifecycle
+    activate({ vnode, container });
+    // Return unmount function
+    return () => {
+        removeNode(vnode, container);
+    };
+}
+/**
+ * Replace an existing DOM node with a new VNode
+ *
+ * @param oldNode - Existing DOM node to replace
+ * @param newVNode - New VNode to render
+ * @param _oldVNode - Optional VNode associated with oldNode (unused, kept for API compatibility)
+ * @returns New DOM node(s) or null
+ */
+export function replaceNode(oldNode, newVNode, _oldVNode) {
+    const parentNode = oldNode.parentNode;
+    if (!parentNode) {
+        return null;
+    }
+    // If new VNode is null, just remove old node
+    if (newVNode === null || newVNode === undefined) {
+        dom.removeChild(parentNode, oldNode);
+        return null;
+    }
+    // Create new node(s)
+    const newNode = createRealNode(newVNode);
+    if (newNode) {
+        if (Array.isArray(newNode)) {
+            // Multiple nodes - insert all before oldNode, then remove oldNode
+            newNode.forEach(n => {
+                parentNode.insertBefore(n, oldNode);
+            });
+            parentNode.removeChild(oldNode);
+        }
+        else {
+            // Single node - replace directly
+            dom.replaceChild(parentNode, newNode, oldNode);
+        }
+        return newNode;
+    }
+    // If creation failed, remove old node
+    dom.removeChild(parentNode, oldNode);
+    return null;
+}
+/**
+ * Unmount node (DOM removal)
+ *
+ * @param node - DOM node or node array
+ */
+export function unmount(node) {
+    if (Array.isArray(node)) {
+        node.forEach(n => {
+            if (n.parentNode) {
+                dom.removeChild(n.parentNode, n);
+            }
+        });
+    }
+    else {
+        if (node.parentNode) {
+            dom.removeChild(node.parentNode, node);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/renderer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/renderer/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,GAAG,MAAM,iBAAiB,CAAC;AAEvC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,gDAAgD;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CACpB,KAAiB,EACjB,SAAkB;IAElB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,kBAAkB;QAClB,OAAO,SAAS,CAAC,UAAU,EAAE,CAAC;YAC5B,GAAG,CAAC,WAAW,CAAC,SAAS,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gEAAgE;IAChE,cAAc,CAAC,KAAK,CAAC,CAAC;IAEtB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAE/B,0BAA0B;IAC1B,OAAO,GAAG,EAAE;QACV,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC/B,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CACzB,OAAa,EACb,QAAoB,EACpB,SAAiB;IAEjB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6CAA6C;IAC7C,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChD,GAAG,CAAC,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qBAAqB;IACrB,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAEzC,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,kEAAkE;YAClE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;gBAClB,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;YACH,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,iCAAiC;YACjC,GAAG,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,sCAAsC;IACtC,GAAG,CAAC,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,IAAmB;IACzC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YACf,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;gBACjB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;YACnC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/renderer/mount.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fukict/basic - Renderer: Activate Nodes
+ *
+ * Mount DOM nodes and trigger lifecycle hooks at mounting moment
+ */
+import type { VNodeChild } from '../types/index.js';
+type ActivateOptions = {
+    vnode: VNodeChild;
+    container: Element;
+    onMounted?: () => void;
+} | {
+    vnode: VNodeChild;
+    placeholder: Comment;
+    onMounted?: () => void;
+};
+/**
+ * Strategy registry
+ */
+/**
+ * Activate VNode: mount DOM and trigger lifecycle at mounting moment
+ *
+ * Two modes:
+ * 1. container mode: mount DOM to container (used by attach)
+ * 2. placeholder mode: replace placeholder with DOM (used by ClassComponent.mount)
+ *
+ * @param options - { vnode, container } or { vnode, placeholder }
+ */
+export declare function activate(options: ActivateOptions): void;
+export {};
+//# sourceMappingURL=mount.d.ts.map

package/dist/renderer/mount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../src/renderer/mount.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAOV,UAAU,EACX,MAAM,mBAAmB,CAAC;AAG3B,KAAK,eAAe,GAChB;IACE,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB,GACD;IACE,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB,CAAC;AA0MN;;GAEG;AAQH;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAuCvD"}

package/dist/renderer/mount.js

@@ -0,0 +1,209 @@
+import { VNodeType } from '../types/index.js';
+/**
+ * Helper: Auto-activate ClassComponents in VNode tree
+ *
+ * For JSX natural mounting - placeholders are already in DOM.
+ * Recursively searches for ClassComponents, but stops at ClassComponent nodes
+ * (since they handle their own children).
+ */
+function autoActivateClassComponentsInTree(vnode, _container) {
+    // Special handling for FunctionComponent: use __rendered__ instead of children
+    if (vnode.__type__ === VNodeType.FunctionComponent) {
+        const rendered = vnode.__rendered__;
+        if (rendered && typeof rendered === 'object' && '__type__' in rendered) {
+            autoActivateClassComponentsInTree(rendered, _container);
+        }
+        return;
+    }
+    // For other node types (Element, Fragment), check children
+    if (vnode.children && Array.isArray(vnode.children)) {
+        for (const child of vnode.children) {
+            if (child && typeof child === 'object' && '__type__' in child) {
+                const childVNode = child;
+                // If child is a ClassComponent, activate it and stop recursion
+                if (childVNode.__type__ === VNodeType.ClassComponent) {
+                    const instance = childVNode.__instance__;
+                    const placeholder = childVNode.__placeholder__;
+                    // Placeholder is already in DOM (from parent's createRealNode)
+                    // Use placeholder replacement mounting
+                    if (instance && placeholder && placeholder.parentNode) {
+                        instance.mount(placeholder.parentNode, placeholder);
+                    }
+                    // Don't recurse into ClassComponent's children (it handles its own)
+                }
+                else {
+                    // For other node types, recurse
+                    autoActivateClassComponentsInTree(childVNode, _container);
+                }
+            }
+        }
+    }
+}
+/**
+ * Strategy: Activate ClassComponent
+ *
+ * Supports both container and placeholder modes:
+ * - container mode: for manual mounting via attach()
+ * - placeholder mode: for diff/replace operations
+ */
+function activateClassComponent(ctx) {
+    const { vnode, container, placeholder, onMounted } = ctx;
+    const instance = vnode.__instance__;
+    if (!instance)
+        return;
+    // Determine which mode to use
+    if (placeholder && placeholder.parentNode) {
+        // Placeholder mode: replace placeholder with component DOM
+        onMounted?.();
+        instance.mount(placeholder.parentNode, placeholder);
+    }
+    else if (container) {
+        // Container mode: mount to container
+        onMounted?.();
+        instance.mount(container);
+    }
+}
+/**
+ * Strategy: Activate Element
+ */
+function activateElement(ctx) {
+    const { vnode, container, placeholder, onMounted } = ctx;
+    const dom = vnode.__dom__;
+    const actualContainer = container || placeholder?.parentNode;
+    if (!actualContainer)
+        return;
+    // Mount or replace DOM
+    if (dom) {
+        if (placeholder && placeholder.parentNode) {
+            placeholder.parentNode.replaceChild(dom, placeholder);
+        }
+        else {
+            actualContainer.appendChild(dom);
+        }
+    }
+    onMounted?.();
+    // Auto-activate ClassComponent children (their placeholders are already in dom)
+    autoActivateClassComponentsInTree(vnode, dom);
+}
+/**
+ * Strategy: Activate Fragment
+ */
+function activateFragment(ctx) {
+    const { vnode, container, placeholder, onMounted } = ctx;
+    const domArray = vnode.__dom__;
+    const actualContainer = container || placeholder?.parentNode;
+    if (!actualContainer)
+        return;
+    // Mount or replace DOM array
+    if (Array.isArray(domArray)) {
+        if (placeholder && placeholder.parentNode) {
+            // Replace mode: insert all before placeholder, then remove
+            domArray.forEach(node => {
+                placeholder.parentNode.insertBefore(node, placeholder);
+            });
+            placeholder.parentNode.removeChild(placeholder);
+        }
+        else {
+            // Mount mode: append all to container
+            domArray.forEach(node => actualContainer.appendChild(node));
+        }
+    }
+    onMounted?.();
+    // Auto-activate ClassComponent children (their placeholders are already in actualContainer)
+    autoActivateClassComponentsInTree(vnode, actualContainer);
+}
+/**
+ * Strategy: Activate FunctionComponent
+ */
+function activateFunctionComponent(ctx) {
+    const { vnode, container, placeholder, onMounted } = ctx;
+    const dom = vnode.__dom__;
+    const actualContainer = container || placeholder?.parentNode;
+    if (!actualContainer)
+        return;
+    // Mount or replace DOM (can be single or array)
+    if (dom) {
+        if (placeholder && placeholder.parentNode) {
+            // Replace mode
+            if (Array.isArray(dom)) {
+                dom.forEach(node => {
+                    placeholder.parentNode.insertBefore(node, placeholder);
+                });
+                placeholder.parentNode.removeChild(placeholder);
+            }
+            else {
+                placeholder.parentNode.replaceChild(dom, placeholder);
+            }
+        }
+        else {
+            // Mount mode
+            if (Array.isArray(dom)) {
+                dom.forEach(node => actualContainer.appendChild(node));
+            }
+            else {
+                actualContainer.appendChild(dom);
+            }
+        }
+    }
+    onMounted?.();
+    // Auto-activate all ClassComponents in __rendered__ tree
+    const rendered = vnode.__rendered__;
+    if (rendered && typeof rendered === 'object' && '__type__' in rendered) {
+        autoActivateClassComponentsInTree(rendered, actualContainer);
+    }
+}
+/**
+ * Strategy registry
+ */
+// const strategies: Record<VNodeType, ActivateStrategy> = {
+//   [VNodeType.ClassComponent]: activateClassComponent,
+//   [VNodeType.Element]: activateElement,
+//   [VNodeType.Fragment]: activateFragment,
+//   [VNodeType.FunctionComponent]: activateFunctionComponent,
+// };
+/**
+ * Activate VNode: mount DOM and trigger lifecycle at mounting moment
+ *
+ * Two modes:
+ * 1. container mode: mount DOM to container (used by attach)
+ * 2. placeholder mode: replace placeholder with DOM (used by ClassComponent.mount)
+ *
+ * @param options - { vnode, container } or { vnode, placeholder }
+ */
+export function activate(options) {
+    const { vnode, onMounted } = options;
+    const container = 'container' in options ? options.container : undefined;
+    const placeholder = 'placeholder' in options ? options.placeholder : undefined;
+    // Early return for invalid vnodes
+    if (!vnode || typeof vnode !== 'object' || !('__type__' in vnode)) {
+        return;
+    }
+    const vnodeObj = vnode;
+    switch (vnodeObj.__type__) {
+        case VNodeType.ClassComponent:
+            activateClassComponent({
+                vnode: vnodeObj,
+                container,
+                placeholder,
+                onMounted,
+            });
+            break;
+        case VNodeType.Element:
+            activateElement({ vnode: vnodeObj, container, placeholder, onMounted });
+            break;
+        case VNodeType.Fragment:
+            activateFragment({ vnode: vnodeObj, container, placeholder, onMounted });
+            break;
+        case VNodeType.FunctionComponent:
+            activateFunctionComponent({
+                vnode: vnodeObj,
+                container,
+                placeholder,
+                onMounted,
+            });
+            break;
+        default:
+            break;
+    }
+}
+//# sourceMappingURL=mount.js.map

package/dist/renderer/mount.js.map

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

package/dist/types/class.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @fukict/basic - Class Component Type Definitions
+ *
+ * Types for Fukict class components (stateful, lifecycle, self-updating)
+ * Runtime implementation is in component-class/index.ts
+ */
+import type { VNode, VNodeChild } from './core.js';
+/**
+ * Slots object type
+ * Maps slot names to their content (single VNodeChild or array)
+ */
+export type Slots = Record<string, VNodeChild | VNodeChild[]>;
+/**
+ * Ref object type
+ * Holds a reference to a DOM element or component instance
+ */
+export interface Ref<T = any> {
+    current: T | null;
+}
+/**
+ * Lifecycle hooks interface for Fukict class components
+ */
+export interface FukictLifecycle<P extends Record<string, any> = any> {
+    /**
+     * Called after component is mounted to DOM
+     * Use for: DOM manipulation, event listeners, data fetching
+     */
+    mounted?(): void;
+    /**
+     * Called before component is unmounted from DOM
+     * Use for: cleanup, removing event listeners, canceling timers
+     */
+    beforeUnmount?(): void;
+    /**
+     * Called after component is updated (props changed or self-update)
+     * @param prevProps - Previous props before update
+     */
+    updated?(prevProps: P): void;
+}
+/**
+ * Fukict class component interface
+ *
+ * Type parameters:
+ * - P: Props type (extends Record<string, any>)
+ * - S: Slots type (extends Slots, default to Slots)
+ */
+export interface FukictComponent<P extends Record<string, any> = {}, S extends Slots = Slots> extends FukictLifecycle<P> {
+    /** Component props (readonly) */
+    readonly props: P;
+    /** Extracted slots from children */
+    readonly slots: S;
+    /** Refs map (shared with framework and user) */
+    readonly refs: Map<string | symbol, Ref>;
+    /** Current rendered VNode (internal, framework use) */
+    __vnode__: VNode | null;
+    /** Parent DOM container (internal, framework use) */
+    __container__: Element | null;
+    /** Render method (must be implemented) */
+    render(): VNode;
+    /**
+     * Update component (props-driven update with built-in diff)
+     *
+     * Called by renderer when parent updates props.
+     * Can be overridden for custom update logic (e.g., shouldUpdate).
+     * Skipped when fukict:detach is set (props updated, but no re-render).
+     */
+    update(newProps: P): void;
+    /**
+     * Mount method (called by renderer after instance creation)
+     * @internal
+     */
+    mount(container: Element, placeholder?: Comment): void;
+    /** Unmount method (internal, framework use) */
+    unmount(): void;
+}
+/**
+ * Helper type to extract props type from Fukict component
+ */
+export type FukictProps<T> = T extends FukictComponent<infer P, any> ? P : never;
+/**
+ * Helper type to extract slots type from Fukict component
+ */
+export type FukictSlots<T> = T extends FukictComponent<any, infer S> ? S : never;
+/**
+ * Helper type for Fukict class constructor
+ */
+export type FukictConstructor<P extends Record<string, any> = any, S extends Slots = Slots> = new (props: P, children?: VNodeChild[]) => FukictComponent<P, S>;
+//# sourceMappingURL=class.d.ts.map

package/dist/types/class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class.d.ts","sourceRoot":"","sources":["../../src/types/class.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,EAAE,CAAC,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,GAAG,CAAC,CAAC,GAAG,GAAG;IAC1B,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG;IAClE;;;OAGG;IACH,OAAO,CAAC,IAAI,IAAI,CAAC;IAEjB;;;OAGG;IACH,aAAa,CAAC,IAAI,IAAI,CAAC;IAEvB;;;OAGG;IACH,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe,CAC9B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE,EAClC,CAAC,SAAS,KAAK,GAAG,KAAK,CACvB,SAAQ,eAAe,CAAC,CAAC,CAAC;IAC1B,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAElB,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAElB,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC;IAEzC,uDAAuD;IACvD,SAAS,EAAE,KAAK,GAAG,IAAI,CAAC;IAExB,qDAAqD;IACrD,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;IAE9B,0CAA0C;IAC1C,MAAM,IAAI,KAAK,CAAC;IAEhB;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC;IAE1B;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAEvD,+CAA+C;IAC/C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IACvB,CAAC,SAAS,eAAe,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IACvB,CAAC,SAAS,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAC3B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EACnC,CAAC,SAAS,KAAK,GAAG,KAAK,IACrB,KAAK,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,UAAU,EAAE,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/dist/types/class.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=class.js.map

package/dist/types/class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class.js","sourceRoot":"","sources":["../../src/types/class.ts"],"names":[],"mappings":""}

package/dist/types/context.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @fukict/basic - Context Types
+ *
+ * Context system for passing data down the component tree
+ * without prop drilling. Context is stored on VNode tree with
+ * no global state.
+ */
+/**
+ * Context definition
+ *
+ * Use Symbol or string as key for type-safe context.
+ * Symbol is recommended for production to avoid naming collisions.
+ *
+ * @example
+ * ```ts
+ * // contexts.ts
+ * export const THEME_CONTEXT = Symbol('theme');
+ * export interface ThemeContext {
+ *   mode: 'light' | 'dark';
+ *   color: string;
+ * }
+ * ```
+ */
+export interface Context<T> {
+    key: string | symbol;
+    defaultValue?: T;
+}
+/**
+ * Context data structure on VNode
+ * @internal
+ */
+export interface ContextData {
+    [key: string | symbol]: any;
+    __parent__?: ContextData;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/types/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/types/context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,CAAC,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC;IAC5B,UAAU,CAAC,EAAE,WAAW,CAAC;CAC1B"}

package/dist/types/context.js

@@ -0,0 +1,9 @@
+/**
+ * @fukict/basic - Context Types
+ *
+ * Context system for passing data down the component tree
+ * without prop drilling. Context is stored on VNode tree with
+ * no global state.
+ */
+export {};
+//# sourceMappingURL=context.js.map

package/dist/types/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/types/context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/types/core.d.ts

@@ -0,0 +1,124 @@
+/**
+ * @fukict/runtime - Core Type Definitions
+ *
+ * Core VNode and basic runtime types
+ */
+import type { ContextData } from './context.js';
+/**
+ * VNode child types - supports primitives, VNodes, and nested arrays
+ */
+export type VNodeChild = VNode | string | number | boolean | null | undefined | VNodeChild[];
+/**
+ * VNode type enum
+ */
+export declare enum VNodeType {
+    Element = "element",
+    Fragment = "fragment",
+    FunctionComponent = "function",
+    ClassComponent = "class"
+}
+/**
+ * Base VNode properties (shared by all VNode types)
+ */
+interface VNodeBase {
+    /** Props (including on: prefixed events) */
+    props: Record<string, any> | null;
+    /** Child VNodes */
+    children: VNodeChild[];
+    /**
+     * Detached flag
+     * When true, component won't be updated by parent
+     */
+    __detached__?: boolean;
+    /**
+     * Slot name for slot mechanism
+     */
+    __slot_name__?: string;
+    /**
+     * Context data (added in v3.1)
+     * Stores context chain for data passing without prop drilling
+     * @see {@link ContextData}
+     */
+    __context__?: ContextData;
+}
+/**
+ * Element VNode
+ * - type: string (tag name like 'div', 'span')
+ * - __dom__: Node (single DOM element)
+ */
+export interface ElementVNode extends VNodeBase {
+    __type__: VNodeType.Element;
+    type: string;
+    __dom__?: Node | null;
+}
+/**
+ * Fragment VNode
+ * - type: Fragment symbol
+ * - __dom__: Node[] (all child nodes)
+ */
+export interface FragmentVNode extends VNodeBase {
+    __type__: VNodeType.Fragment;
+    type: symbol;
+    __dom__?: Node[] | null;
+}
+/**
+ * Function Component VNode
+ * - type: Function
+ * - __rendered__: VNode (cached result of function call)
+ * - __dom__: Node | Node[] (depends on rendered result)
+ */
+export interface FunctionComponentVNode extends VNodeBase {
+    __type__: VNodeType.FunctionComponent;
+    type: Function;
+    __rendered__?: VNode;
+    __dom__?: Node | Node[] | null;
+}
+/**
+ * Class Component VNode
+ * - type: Function (class constructor)
+ * - __instance__: FukictInstance (component instance)
+ * - __placeholder__: Comment node as placeholder for insertion position
+ * - __dom__: ❌ NOT USED (managed by instance)
+ */
+export interface ClassComponentVNode extends VNodeBase {
+    __type__: VNodeType.ClassComponent;
+    type: Function;
+    __instance__?: any;
+    __placeholder__?: Comment;
+}
+/**
+ * VNode - Discriminated Union
+ *
+ * Use __type__ to narrow down to specific VNode type:
+ *
+ * ```typescript
+ * if (vnode.__type__ === VNodeType.Element) {
+ *   // vnode is ElementVNode
+ *   const element: Node = vnode.__dom__;
+ * } else if (vnode.__type__ === VNodeType.Fragment) {
+ *   // vnode is FragmentVNode
+ *   const nodes: Node[] = vnode.__dom__;
+ * } else if (vnode.__type__ === VNodeType.FunctionComponent) {
+ *   // vnode is FunctionComponentVNode
+ *   const rendered = vnode.__rendered__;
+ * } else if (vnode.__type__ === VNodeType.ClassComponent) {
+ *   // vnode is ClassComponentVNode
+ *   const instance = vnode.__instance__;
+ * }
+ * ```
+ */
+export type VNode = ElementVNode | FragmentVNode | FunctionComponentVNode | ClassComponentVNode;
+/**
+ * Fragment symbol for multiple root elements
+ */
+export declare const Fragment: unique symbol;
+/**
+ * Ref callback type
+ */
+export type RefCallback<T extends Element = Element> = (element: T) => void;
+/**
+ * Unregister function returned by registration APIs
+ */
+export type UnregisterFn = () => void;
+export {};
+//# sourceMappingURL=core.d.ts.map

package/dist/types/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/types/core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,KAAK,GACL,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,UAAU,EAAE,CAAC;AAEjB;;GAEG;AACH,oBAAY,SAAS;IACnB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,iBAAiB,aAAa;IAC9B,cAAc,UAAU;CACzB;AAED;;GAEG;AACH,UAAU,SAAS;IACjB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAElC,mBAAmB;IACnB,QAAQ,EAAE,UAAU,EAAE,CAAC;IAEvB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAuB,SAAQ,SAAS;IACvD,QAAQ,EAAE,SAAS,CAAC,iBAAiB,CAAC;IACtC,IAAI,EAAE,QAAQ,CAAC;IACf,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;CAChC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAoB,SAAQ,SAAS;IACpD,QAAQ,EAAE,SAAS,CAAC,cAAc,CAAC;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;CAE3B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,KAAK,GACb,YAAY,GACZ,aAAa,GACb,sBAAsB,GACtB,mBAAmB,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,QAAQ,eAAqB,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC"}

package/dist/types/core.js

@@ -0,0 +1,15 @@
+/**
+ * VNode type enum
+ */
+export var VNodeType;
+(function (VNodeType) {
+    VNodeType["Element"] = "element";
+    VNodeType["Fragment"] = "fragment";
+    VNodeType["FunctionComponent"] = "function";
+    VNodeType["ClassComponent"] = "class";
+})(VNodeType || (VNodeType = {}));
+/**
+ * Fragment symbol for multiple root elements
+ */
+export const Fragment = Symbol('Fragment');
+//# sourceMappingURL=core.js.map

package/dist/types/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/types/core.ts"],"names":[],"mappings":"AAmBA;;GAEG;AACH,MAAM,CAAN,IAAY,SAKX;AALD,WAAY,SAAS;IACnB,gCAAmB,CAAA;IACnB,kCAAqB,CAAA;IACrB,2CAA8B,CAAA;IAC9B,qCAAwB,CAAA;AAC1B,CAAC,EALW,SAAS,KAAT,SAAS,QAKpB;AA4GD;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC"}