@fukict/basic 0.1.0

package/dist/utils/context.js

@@ -0,0 +1,80 @@
+/**
+ * Create immutable proxy for context values
+ *
+ * Prevents child components from mutating context values,
+ * ensuring unidirectional data flow.
+ *
+ * **Important**: Proxy only prevents mutation, it does NOT trigger updates.
+ * Context updates must be explicit:
+ * 1. Call provideContext() to replace the context value
+ * 2. Call this.update() to trigger re-rendering
+ * 3. Child components get new value via getContext() during render
+ *
+ * @param value - Context value to wrap
+ * @returns Proxied immutable value
+ * @internal
+ */
+export function createImmutableProxy(value) {
+    // Primitive values don't need proxy
+    if (typeof value !== 'object' || value === null) {
+        return value;
+    }
+    return new Proxy(value, {
+        set() {
+            console.warn('[Fukict] Context values are immutable and cannot be modified');
+            return false; // Block modification, but does NOT trigger update
+        },
+        deleteProperty() {
+            console.warn('[Fukict] Context values are immutable and cannot be modified');
+            return false;
+        },
+        get(target, prop) {
+            const result = Reflect.get(target, prop);
+            // Deep proxy for nested objects
+            if (typeof result === 'object' && result !== null) {
+                return createImmutableProxy(result);
+            }
+            return result;
+        },
+    });
+}
+/**
+ * Get parent context from VNode
+ *
+ * Traverses up the wrapper VNode tree to find nearest parent component with context.
+ * The wrapper VNode is the ClassComponentVNode that wraps a component instance.
+ *
+ * @param vnode - Current VNode (unused, we traverse via __wrapper__ on instance)
+ * @returns Parent context data or undefined
+ * @internal
+ */
+export function getParentContext(vnode) {
+    // Get instance from ClassComponentVNode
+    const vnodeWithInstance = vnode;
+    const instance = vnodeWithInstance.__instance__;
+    if (!instance) {
+        return undefined;
+    }
+    // Get wrapper VNode (the ClassComponentVNode that wraps this instance)
+    const wrapper = instance.__wrapper__;
+    if (!wrapper || !wrapper.props) {
+        return undefined;
+    }
+    // Look for parent context by traversing up the VNode tree
+    // We need to find the parent component that rendered this wrapper VNode
+    // This requires walking through the children arrays to find parent relationship
+    // For now, implement a simpler approach:
+    // Look for context in parent by checking if wrapper has __parentInstance__
+    // This will be set during rendering
+    // Alternative: Search through all active component instances
+    // But this violates the "no global state" principle
+    // The correct approach: During render, when parent creates child VNode,
+    // we should store parent instance reference on the child's wrapper VNode
+    // Let's add __parentInstance__ field during createRealNode
+    const parentInstance = instance.__parentInstance__;
+    if (parentInstance && parentInstance.__vnode__) {
+        return parentInstance.__vnode__.__context__;
+    }
+    return undefined;
+}
+//# sourceMappingURL=context.js.map

package/dist/utils/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/utils/context.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,oBAAoB,CAAI,KAAQ;IAC9C,oCAAoC;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,KAAK,CAAC,KAAe,EAAE;QAChC,GAAG;YACD,OAAO,CAAC,IAAI,CACV,8DAA8D,CAC/D,CAAC;YACF,OAAO,KAAK,CAAC,CAAC,kDAAkD;QAClE,CAAC;QACD,cAAc;YACZ,OAAO,CAAC,IAAI,CACV,8DAA8D,CAC/D,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC;QACD,GAAG,CAAC,MAAM,EAAE,IAAI;YACd,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAY,CAAC;YACpD,gCAAgC;YAChC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBAClD,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;YACtC,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAM,CAAC;AACV,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAY;IAC3C,wCAAwC;IACxC,MAAM,iBAAiB,GAAG,KAA4B,CAAC;IACvD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,YAEtB,CAAC;IACd,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,uEAAuE;IACvE,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC;IACrC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,0DAA0D;IAC1D,wEAAwE;IACxE,gFAAgF;IAEhF,yCAAyC;IACzC,2EAA2E;IAC3E,oCAAoC;IAEpC,6DAA6D;IAC7D,oDAAoD;IAEpD,wEAAwE;IACxE,yEAAyE;IACzE,2DAA2D;IAE3D,MAAM,cAAc,GAAG,QAAQ,CAAC,kBAAkB,CAAC;IACnD,IAAI,cAAc,IAAI,cAAc,CAAC,SAAS,EAAE,CAAC;QAC/C,OAAO,cAAc,CAAC,SAAS,CAAC,WAAW,CAAC;IAC9C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/utils/dom-helpers.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fukict/basic - DOM Helper Utilities
+ *
+ * Helper functions for working with DOM references in VNodes
+ */
+import type { VNode } from '../types/index.js';
+/**
+ * Check if __dom__ is an array (Fragment or multi-node)
+ */
+export declare function isDomArray(dom: unknown): dom is Node[];
+/**
+ * Normalize __dom__ to array (for unified processing)
+ */
+export declare function normalizeDom(dom: Node | Node[] | null | undefined): Node[];
+/**
+ * Get first DOM node from VNode
+ * Returns null for class components (they don't have __dom__)
+ */
+export declare function getFirstDomNode(vnode: VNode): Node | null;
+/**
+ * Get all DOM nodes from VNode
+ * Returns empty array for class components
+ */
+export declare function getAllDomNodes(vnode: VNode): Node[];
+/**
+ * Check if vnode is a valid VNode object
+ */
+export declare function isVNode(value: unknown): value is VNode;
+//# sourceMappingURL=dom-helpers.d.ts.map

package/dist/utils/dom-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/dom-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG/C;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,IAAI,EAAE,CAEtD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,EAAE,CAI1E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI,CAczD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,CAQnD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD"}

package/dist/utils/dom-helpers.js

@@ -0,0 +1,53 @@
+import { VNodeType } from '../types/index.js';
+/**
+ * Check if __dom__ is an array (Fragment or multi-node)
+ */
+export function isDomArray(dom) {
+    return Array.isArray(dom);
+}
+/**
+ * Normalize __dom__ to array (for unified processing)
+ */
+export function normalizeDom(dom) {
+    if (!dom)
+        return [];
+    if (Array.isArray(dom))
+        return dom;
+    return [dom];
+}
+/**
+ * Get first DOM node from VNode
+ * Returns null for class components (they don't have __dom__)
+ */
+export function getFirstDomNode(vnode) {
+    // Class components don't have __dom__
+    if (vnode.__type__ === VNodeType.ClassComponent) {
+        return null;
+    }
+    const dom = '__dom__' in vnode ? vnode.__dom__ : null;
+    if (!dom)
+        return null;
+    if (Array.isArray(dom)) {
+        return dom[0] || null;
+    }
+    return dom;
+}
+/**
+ * Get all DOM nodes from VNode
+ * Returns empty array for class components
+ */
+export function getAllDomNodes(vnode) {
+    // Class components don't have __dom__
+    if (vnode.__type__ === VNodeType.ClassComponent) {
+        return [];
+    }
+    const dom = '__dom__' in vnode ? vnode.__dom__ : null;
+    return normalizeDom(dom);
+}
+/**
+ * Check if vnode is a valid VNode object
+ */
+export function isVNode(value) {
+    return typeof value === 'object' && value !== null && '__type__' in value;
+}
+//# sourceMappingURL=dom-helpers.js.map

package/dist/utils/dom-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-helpers.js","sourceRoot":"","sources":["../../src/utils/dom-helpers.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAqC;IAChE,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAY;IAC1C,sCAAsC;IACtC,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,cAAc,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACxB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAY;IACzC,sCAAsC;IACtC,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,cAAc,EAAE,CAAC;QAChD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,GAAG,GAAG,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,UAAU,IAAI,KAAK,CAAC;AAC5E,CAAC"}

package/dist/vnode.d.ts

@@ -0,0 +1,28 @@
+import type { VNode, VNodeChild } from './types/index.js';
+import { Fragment } from './types/index.js';
+/**
+ * Create a VNode
+ *
+ * Runtime hyperscript function creates a plain VNode structure.
+ * The __type__ field should be added by babel-plugin at compile time.
+ * If not present, we detect it at runtime (slower but works).
+ *
+ * @param type - Element tag name or component function
+ * @param props - Properties (including on: prefixed events)
+ * @param children - Child nodes
+ * @returns VNode (plain structure, __type__ expected from babel-plugin)
+ */
+export declare function hyperscript(type: string | Function | typeof Fragment, props: Record<string, any> | null, children: VNodeChild[]): VNode;
+/**
+ * Alias for hyperscript (shorter name)
+ */
+export declare const h: typeof hyperscript;
+/**
+ * JSX automatic runtime exports
+ * These are standard exports for JSX automatic runtime
+ * All point to hyperscript since our babel plugin directly generates hyperscript calls
+ */
+export declare const jsx: typeof hyperscript;
+export declare const jsxs: typeof hyperscript;
+export declare const jsxDEV: typeof hyperscript;
+//# sourceMappingURL=vnode.d.ts.map

package/dist/vnode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vnode.d.ts","sourceRoot":"","sources":["../src/vnode.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAa,MAAM,kBAAkB,CAAC;AA+BvD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,QAAQ,EACzC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,EACjC,QAAQ,EAAE,UAAU,EAAE,GACrB,KAAK,CAaP;AAED;;GAEG;AACH,eAAO,MAAM,CAAC,oBAAc,CAAC;AAE7B;;;;GAIG;AACH,eAAO,MAAM,GAAG,oBAAc,CAAC;AAC/B,eAAO,MAAM,IAAI,oBAAc,CAAC;AAChC,eAAO,MAAM,MAAM,oBAAc,CAAC"}

package/dist/vnode.js

@@ -0,0 +1,68 @@
+/**
+ * @fukict/runtime - VNode Creation (hyperscript)
+ *
+ * Create VNode from function calls
+ */
+import { Fukict } from './component-class/fukict.js';
+import { Fragment, VNodeType } from './types/index.js';
+/**
+ * Detect VNode type at runtime (fallback if babel-plugin is not used)
+ */
+function detectVNodeType(type) {
+    // Fragment
+    if (type === Fragment) {
+        return VNodeType.Fragment;
+    }
+    // Element (string tag name)
+    if (typeof type === 'string') {
+        return VNodeType.Element;
+    }
+    // Function
+    if (typeof type === 'function') {
+        // Class Component (extends Fukict)
+        if (type.prototype && type.prototype instanceof Fukict) {
+            return VNodeType.ClassComponent;
+        }
+        // Function Component
+        return VNodeType.FunctionComponent;
+    }
+    // Fallback to element
+    return VNodeType.Element;
+}
+/**
+ * Create a VNode
+ *
+ * Runtime hyperscript function creates a plain VNode structure.
+ * The __type__ field should be added by babel-plugin at compile time.
+ * If not present, we detect it at runtime (slower but works).
+ *
+ * @param type - Element tag name or component function
+ * @param props - Properties (including on: prefixed events)
+ * @param children - Child nodes
+ * @returns VNode (plain structure, __type__ expected from babel-plugin)
+ */
+export function hyperscript(type, props, children) {
+    const vnode = {
+        type,
+        props: props || {},
+        children,
+    };
+    // If __type__ not set by babel-plugin, detect it at runtime
+    if (!('__type__' in vnode)) {
+        vnode.__type__ = detectVNodeType(type);
+    }
+    return vnode;
+}
+/**
+ * Alias for hyperscript (shorter name)
+ */
+export const h = hyperscript;
+/**
+ * JSX automatic runtime exports
+ * These are standard exports for JSX automatic runtime
+ * All point to hyperscript since our babel plugin directly generates hyperscript calls
+ */
+export const jsx = hyperscript;
+export const jsxs = hyperscript;
+export const jsxDEV = hyperscript;
+//# sourceMappingURL=vnode.js.map

package/dist/vnode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vnode.js","sourceRoot":"","sources":["../src/vnode.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;GAEG;AACH,SAAS,eAAe,CAAC,IAAyC;IAChE,WAAW;IACX,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC,QAAQ,CAAC;IAC5B,CAAC;IAED,4BAA4B;IAC5B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAC,OAAO,CAAC;IAC3B,CAAC;IAED,WAAW;IACX,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,mCAAmC;QACnC,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,YAAY,MAAM,EAAE,CAAC;YACvD,OAAO,SAAS,CAAC,cAAc,CAAC;QAClC,CAAC;QAED,qBAAqB;QACrB,OAAO,SAAS,CAAC,iBAAiB,CAAC;IACrC,CAAC;IAED,sBAAsB;IACtB,OAAO,SAAS,CAAC,OAAO,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CACzB,IAAyC,EACzC,KAAiC,EACjC,QAAsB;IAEtB,MAAM,KAAK,GAAG;QACZ,IAAI;QACJ,KAAK,EAAE,KAAK,IAAI,EAAE;QAClB,QAAQ;KACA,CAAC;IAEX,4DAA4D;IAC5D,IAAI,CAAC,CAAC,UAAU,IAAI,KAAK,CAAC,EAAE,CAAC;QAC1B,KAAe,CAAC,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC;AAE7B;;;;GAIG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,WAAW,CAAC;AAC/B,MAAM,CAAC,MAAM,IAAI,GAAG,WAAW,CAAC;AAChC,MAAM,CAAC,MAAM,MAAM,GAAG,WAAW,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@fukict/basic",
+  "version": "0.1.0",
+  "description": "Lightweight DOM rendering basic with extension mechanism",
+  "keywords": [
+    "fukict",
+    "basic",
+    "vdom",
+    "rendering",
+    "dom",
+    "browser"
+  ],
+  "bugs": {
+    "url": "https://github.com/fukict/fukict/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fukict/fukict.git",
+    "directory": "packages/basic"
+  },
+  "license": "MIT",
+  "author": "Fukict Team",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "browser": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./jsx-runtime": {
+      "types": "./dist/jsx-runtime.d.ts",
+      "browser": "./dist/jsx-runtime.js",
+      "default": "./dist/jsx-runtime.js"
+    },
+    "./jsx-dev-runtime": {
+      "types": "./dist/jsx-runtime.d.ts",
+      "browser": "./dist/jsx-runtime.js",
+      "default": "./dist/jsx-runtime.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "devDependencies": {
+    "typescript": "^5.6.3"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "scripts": {
+    "build": "tsx ../../scripts/build-package.ts --pkg-name basic --no-watch",
+    "dev": "tsx ../../scripts/build-package.ts --pkg-name basic --watch",
+    "lint": "tsc --noEmit",
+    "typecheck": "tsc --noEmit"
+  }
+}