@faiwer/react 0.8.0

package/dist/core/reconciliation/postCommit.js

@@ -0,0 +1,47 @@
+import { reactRender } from './render';
+import { runEffects } from './effects';
+/**
+ * A stage that happens after we've applied all necessary DOM and fiber changes
+ * in applyActions (the "commit" phase). In this stage we:
+ * - run all kinds of effects
+ * - when needed, schedule another render cycle (if effects updated component
+ *   state)
+ * - or move the app to the idle stage
+ */
+export function postCommit(app, depth) {
+    app.tempContext.clear();
+    // Run "ref" and "layout" effects. They must be run in the same microtask
+    // queue as the commit phase.
+    if (app.effects.layout.length > 0 || app.effects.refs.length > 0) {
+        app.state = 'layoutEffects';
+        runEffects(app, 'layout'); // It will also run "ref" effects
+        if (app.invalidatedComponents.size > 0) {
+            // 1+ component was invalidated in an effect
+            if (app.effects.normal.length > 0) {
+                // Layout effect component invalidations should be applied within the
+                // same microtask queue, so we need to run the scheduled normal effects
+                // right away.
+                app.state = 'effects';
+                runEffects(app, 'normal');
+            }
+            app.state = 'scheduled';
+            queueMicrotask(() => reactRender(app, depth + 1));
+            return;
+        }
+    }
+    if (app.effects.normal.length === 0) {
+        app.state = 'idle';
+        return;
+    }
+    app.state = 'effects';
+    setTimeout(() => {
+        runEffects(app, 'normal');
+        if (app.invalidatedComponents.size > 0) {
+            app.state = 'scheduled';
+            setTimeout(() => reactRender(app), 0);
+            return;
+        }
+        app.state = 'idle';
+    }, 0);
+}
+//# sourceMappingURL=postCommit.js.map

package/dist/core/reconciliation/postCommit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postCommit.js","sourceRoot":"","sources":["../../../src/core/reconciliation/postCommit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,GAAQ,EAAE,KAAa,EAAE;IAClD,GAAG,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAExB,yEAAyE;IACzE,6BAA6B;IAC7B,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,KAAK,GAAG,eAAe,CAAC;QAC5B,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,iCAAiC;QAE5D,IAAI,GAAG,CAAC,qBAAqB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACvC,4CAA4C;YAC5C,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClC,qEAAqE;gBACrE,uEAAuE;gBACvE,cAAc;gBACd,GAAG,CAAC,KAAK,GAAG,SAAS,CAAC;gBACtB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YAC5B,CAAC;YAED,GAAG,CAAC,KAAK,GAAG,WAAW,CAAC;YACxB,cAAc,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;IACH,CAAC;IAED,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC;QACnB,OAAO;IACT,CAAC;IAED,GAAG,CAAC,KAAK,GAAG,SAAS,CAAC;IACtB,UAAU,CAAC,GAAG,EAAE,CAAC;QACf,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAE1B,IAAI,GAAG,CAAC,qBAAqB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACvC,GAAG,CAAC,KAAK,GAAG,WAAW,CAAC;YACxB,UAAU,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YACtC,OAAO;QACT,CAAC;QAED,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC;IAAA,CACpB,EAAE,CAAC,CAAC,CAAC;AAAA,CACP"}

package/dist/core/reconciliation/render.d.ts

@@ -0,0 +1,11 @@
+import type { App } from '../../types';
+/**
+ * Performs another rendering round. Once anything changes a component's state
+ * (invalidates it), a new render cycle is scheduled. The render consists of:
+ *
+ * 1. running components, collecting needed changes (actions), scheduling effects
+ * 2. applying actions to the DOM and fiber trees
+ * 3. running scheduled effects, updating ref handlers (postCommit)
+ */
+export declare function reactRender(app: App, depth?: number): void;
+//# sourceMappingURL=render.d.ts.map

package/dist/core/reconciliation/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/core/reconciliation/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAM9C;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,SAAI,QAuB9C"}

package/dist/core/reconciliation/render.js

@@ -0,0 +1,35 @@
+import { validateTree } from './validateTree';
+import { collectActionsFromApp } from './collect/fromApp';
+import { postCommit } from './postCommit';
+import { applyActions } from './applyActions';
+/**
+ * Performs another rendering round. Once anything changes a component's state
+ * (invalidates it), a new render cycle is scheduled. The render consists of:
+ *
+ * 1. running components, collecting needed changes (actions), scheduling effects
+ * 2. applying actions to the DOM and fiber trees
+ * 3. running scheduled effects, updating ref handlers (postCommit)
+ */
+export function reactRender(app, depth = 0) {
+    if (depth > MAX_DEPTH) {
+        throw new Error(`Maximum update depth exceeded`);
+    }
+    if (app.testMode && app.invalidatedComponents.size === 0) {
+        throw new Error(`Unnecessary react render`);
+    }
+    if (app.state === 'killed') {
+        return;
+    }
+    if (app.testMode)
+        validateTree(app.root);
+    app.state = 'render';
+    const actions = collectActionsFromApp(app);
+    if (app.testMode)
+        validateTree(app.root);
+    applyActions(app, actions);
+    if (app.testMode)
+        validateTree(app.root);
+    postCommit(app, depth);
+}
+const MAX_DEPTH = 50; // Like in React.
+//# sourceMappingURL=render.js.map

package/dist/core/reconciliation/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/core/reconciliation/render.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,GAAQ,EAAE,KAAK,GAAG,CAAC,EAAE;IAC/C,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,qBAAqB,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,GAAG,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ;QAAE,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAEzC,GAAG,CAAC,KAAK,GAAG,QAAQ,CAAC;IACrB,MAAM,OAAO,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,GAAG,CAAC,QAAQ;QAAE,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAEzC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC3B,IAAI,GAAG,CAAC,QAAQ;QAAE,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAEzC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAAA,CACxB;AAED,MAAM,SAAS,GAAG,EAAE,CAAC,CAAC,iBAAiB"}

package/dist/core/reconciliation/runFiberComponents.d.ts

@@ -0,0 +1,10 @@
+import type { App, FiberNode } from '../../types';
+/**
+ * By default we don't run all components. We run only those that were manually
+ * invalidated, as if they were all wrapped with `memo()`. So the `.children`
+ * node of such fibers is empty. This method recursively goes through all of the
+ * given fiber DOM subtree nodes and runs all found components to fill their
+ * `.children`. Should be used only for not-yet-mounted component fiber nodes.
+ */
+export declare const runFiberComponents: (app: App, fiber: FiberNode) => void;
+//# sourceMappingURL=runFiberComponents.d.ts.map

package/dist/core/reconciliation/runFiberComponents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runFiberComponents.d.ts","sourceRoot":"","sources":["../../../src/core/reconciliation/runFiberComponents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAKzD;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,sCAsB9B,CAAC"}

package/dist/core/reconciliation/runFiberComponents.js

@@ -0,0 +1,37 @@
+import { runComponent } from '../components';
+import { jsxElementToFiberNode } from '../reactNodeToFiberNode';
+import { FAKE_CONTAINER_TAG, toFiberChildren } from './fibers';
+/**
+ * By default we don't run all components. We run only those that were manually
+ * invalidated, as if they were all wrapped with `memo()`. So the `.children`
+ * node of such fibers is empty. This method recursively goes through all of the
+ * given fiber DOM subtree nodes and runs all found components to fill their
+ * `.children`. Should be used only for not-yet-mounted component fiber nodes.
+ */
+export const runFiberComponents = (app, fiber) => {
+    if (app.testMode)
+        checkParents(fiber);
+    switch (fiber.type) {
+        case 'fragment':
+        case 'tag':
+            for (const child of fiber.children) {
+                runFiberComponents(app, child);
+            }
+            break;
+        case 'component': {
+            const newChildren = runComponent(fiber, null);
+            const child = jsxElementToFiberNode(newChildren, fiber, true /* run children-components recursively */);
+            fiber.children = toFiberChildren(child);
+            break;
+        }
+    }
+};
+const checkParents = (fiber) => {
+    let parent = fiber.parent;
+    while (parent && parent.tag !== FAKE_CONTAINER_TAG)
+        parent = parent.parent;
+    if (!parent) {
+        throw new Error(`runFiberComponents shouldn't be called for already mounted fiber nodes`);
+    }
+};
+//# sourceMappingURL=runFiberComponents.js.map

package/dist/core/reconciliation/runFiberComponents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runFiberComponents.js","sourceRoot":"","sources":["../../../src/core/reconciliation/runFiberComponents.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAQ,EAAE,KAAgB,EAAQ,EAAE,CAAC;IACtE,IAAI,GAAG,CAAC,QAAQ;QAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IAEtC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,UAAU,CAAC;QAChB,KAAK,KAAK;YACR,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACnC,kBAAkB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACjC,CAAC;YACD,MAAM;QAER,KAAK,WAAW,EAAE,CAAC;YACjB,MAAM,WAAW,GAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC3D,MAAM,KAAK,GAAc,qBAAqB,CAC5C,WAAW,EACX,KAAK,EACL,IAAI,CAAC,yCAAyC,CAC/C,CAAC;YACF,KAAK,CAAC,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YACxC,MAAM;QACR,CAAC;IACH,CAAC;AAAA,CACF,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,KAAgB,EAAQ,EAAE,CAAC;IAC/C,IAAI,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC1B,OAAO,MAAM,IAAI,MAAM,CAAC,GAAG,KAAK,kBAAkB;QAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,wEAAwE,CACzE,CAAC;IACJ,CAAC;AAAA,CACF,CAAC"}

package/dist/core/reconciliation/typeGuards.d.ts

@@ -0,0 +1,12 @@
+import type { ElementType, FiberNode, TagAttrValue } from '../../types';
+/**
+ * Returns true if the given fiber can contain children fiber nodes.
+ */
+export declare const isContainerFiber: (fiber: FiberNode) => boolean;
+export declare const isContextProvider: (node: ElementType | import("../../index.js").ReactContextProvider<unknown>) => node is import("../../index.js").ReactContextProvider<unknown>;
+/**
+ * Validates that the given value can be used as an event handler or a tag
+ * attribute value. Throws if not.
+ */
+export declare function assertsTagAttrValue(v: unknown): asserts v is TagAttrValue;
+//# sourceMappingURL=typeGuards.d.ts.map

package/dist/core/reconciliation/typeGuards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeGuards.d.ts","sourceRoot":"","sources":["../../../src/core/reconciliation/typeGuards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EAET,YAAY,EACb,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,eAAO,MAAM,gBAAgB,+BAGP,CAAC;AAGvB,eAAO,MAAM,iBAAiB,4IAM7B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,IAAI,YAAY,CAkBzE"}

package/dist/core/reconciliation/typeGuards.js

@@ -0,0 +1,32 @@
+/**
+ * Returns true if the given fiber can contain children fiber nodes.
+ */
+export const isContainerFiber = (fiber) => fiber.type === 'component' ||
+    fiber.type === 'fragment' ||
+    fiber.type === 'tag';
+// The rest of them: tag, null, text
+export const isContextProvider = (node) => {
+    const ctx = typeof node === 'object' && node && '__ctx' in node ? node : null;
+    return ctx !== null;
+};
+/**
+ * Validates that the given value can be used as an event handler or a tag
+ * attribute value. Throws if not.
+ */
+export function assertsTagAttrValue(v) {
+    switch (typeof v) {
+        case 'undefined':
+        case 'string':
+        case 'boolean':
+        case 'number':
+        case 'function':
+            return;
+        case 'object':
+            if (v === null)
+                return;
+        case 'bigint':
+        case 'symbol':
+            throw new Error(`Unsupported format of tag attribute value (${String(v)})`);
+    }
+}
+//# sourceMappingURL=typeGuards.js.map

package/dist/core/reconciliation/typeGuards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeGuards.js","sourceRoot":"","sources":["../../../src/core/reconciliation/typeGuards.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAgB,EAAW,EAAE,CAC5D,KAAK,CAAC,IAAI,KAAK,WAAW;IAC1B,KAAK,CAAC,IAAI,KAAK,UAAU;IACzB,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC;AACvB,oCAAoC;AAEpC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAA4C,EACV,EAAE,CAAC;IACrC,MAAM,GAAG,GACP,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,IAAI,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,OAAO,GAAG,KAAK,IAAI,CAAC;AAAA,CACrB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,CAAU,EAA6B;IACzE,QAAQ,OAAO,CAAC,EAAE,CAAC;QACjB,KAAK,WAAW,CAAC;QACjB,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ,CAAC;QACd,KAAK,UAAU;YACb,OAAO;QAET,KAAK,QAAQ;YACX,IAAI,CAAC,KAAK,IAAI;gBAAE,OAAO;QAEzB,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ;YACX,MAAM,IAAI,KAAK,CACb,8CAA8C,MAAM,CAAC,CAAC,CAAC,GAAG,CAC3D,CAAC;IACN,CAAC;AAAA,CACF"}

package/dist/core/reconciliation/validateTree.d.ts

@@ -0,0 +1,6 @@
+import type { FiberNode } from '../../types';
+/**
+ * Validates the given fiber node and its subnodes. In case of error it throws.
+ */
+export declare const validateTree: (node: FiberNode, path?: string) => void;
+//# sourceMappingURL=validateTree.d.ts.map

package/dist/core/reconciliation/validateTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateTree.d.ts","sourceRoot":"","sources":["../../../src/core/reconciliation/validateTree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGpD;;GAEG;AACH,eAAO,MAAM,YAAY,0CA+BxB,CAAC"}

package/dist/core/reconciliation/validateTree.js

@@ -0,0 +1,48 @@
+import { nullthrows } from '../../utils';
+/**
+ * Validates the given fiber node and its subnodes. In case of error it throws.
+ */
+export const validateTree = (node, path = '') => {
+    // Each rendered node must be associated with at least one real DOM node.
+    nullthrows(node.element, `${path}.element`);
+    if (node.type === 'tag') {
+        if (!node.tag) {
+            throw new Error(`${path} has empty "tag" field `);
+        }
+        const domNode = node.role === 'portal' ? node.data : node.element;
+        if (!(domNode instanceof Element)) {
+            throw new Error(`${path} doesn't have element`);
+        }
+    }
+    else if (node.type === 'component' && !node.component) {
+        throw new Error(`${path} has empty "component" field `);
+    }
+    else if (node.role === 'context' && !node.data.ctx) {
+        throw new Error(`${path} has no context`);
+    }
+    else if (node.type === 'text' && !(node.element instanceof Text)) {
+        throw new Error(`${path}'s element is not a Text`);
+    }
+    for (const [idx, child] of node.children.entries()) {
+        const label = getFiberPathLabel(child);
+        const key = (child.key ?? idx) + `^${label}`;
+        if (child.parent !== node) {
+            throw new Error(`${path}.${key}.parent is ${child.parent ? 'wrong' : 'empty'}`);
+        }
+        validateTree(child, `${path}.${key}`);
+    }
+};
+const getFiberPathLabel = (node) => {
+    return node.type === 'text' || node.type === 'null'
+        ? node.type
+        : node.type === 'tag'
+            ? `<${nullthrows(node.tag)}/>`
+            : node.type === 'fragment'
+                ? node.role === 'context'
+                    ? '<ctx/>'
+                    : '[]'
+                : node.type === 'component'
+                    ? `<${node.component.name || 'Comp'}/>`
+                    : 'unknown';
+};
+//# sourceMappingURL=validateTree.js.map

package/dist/core/reconciliation/validateTree.js.map

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

package/dist/hooks/helpers.d.ts

@@ -0,0 +1,19 @@
+import { type FiberNode, type HookDeps } from '../types';
+/**
+ * We could save the given deps as is, but this version allows to avoid memory
+ * leaks by means of using WeakRefs for object-based dependencies.
+ */
+export declare const saveDeps: (deps: unknown[]) => HookDeps;
+/**
+ * Returns `false` if some of the deps were changed.
+ * Note: it compares deps shallowly.
+ */
+export declare const checkDeps: (saved: unknown[], deps: unknown[]) => boolean;
+/**
+ * Returns the current hook state for 2nd+ renders and runs the given fn to
+ * create the initial hook state during the 1st render.
+ */
+export declare const getNextHookOrCreate: <T extends {
+    type: "context" | "effect" | "memo" | "ref" | "state";
+}>(type: "context" | "effect" | "memo" | "ref" | "state", fn: (fiber: FiberNode) => T) => T;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/hooks/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/hooks/helpers.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,SAAS,EAAsB,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAE7E;;;GAGG;AACH,eAAO,MAAM,QAAQ,+BAIpB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,SAAS,gDASrB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC;;2FAyBpC,CAAC"}

package/dist/hooks/helpers.js

@@ -0,0 +1,40 @@
+import { getCurrentComponentFiber, getNextFiberState, isFirstFiberRender, registerStateItem, } from '../core/components';
+/**
+ * We could save the given deps as is, but this version allows to avoid memory
+ * leaks by means of using WeakRefs for object-based dependencies.
+ */
+export const saveDeps = (deps) => {
+    return deps.map((dep) => typeof dep === 'object' && dep ? new WeakRef(dep) : dep);
+};
+/**
+ * Returns `false` if some of the deps were changed.
+ * Note: it compares deps shallowly.
+ */
+export const checkDeps = (saved, deps) => {
+    return (saved.length === deps.length &&
+        saved.every((s, idx) => s instanceof WeakRef
+            ? !!deps[idx] && s.deref() === deps[idx]
+            : s === deps[idx]));
+};
+/**
+ * Returns the current hook state for 2nd+ renders and runs the given fn to
+ * create the initial hook state during the 1st render.
+ */
+export const getNextHookOrCreate = (type, fn) => {
+    const firstRender = isFirstFiberRender();
+    const fiber = getCurrentComponentFiber();
+    if (!Array.isArray(fiber.data.hooks)) {
+        throw new Error(`Hooks cannot be used outside of components`);
+    }
+    if (firstRender) {
+        const item = fn(fiber);
+        registerStateItem(item);
+        return item;
+    }
+    const item = firstRender ? fiber.data.hooks.at(-1) : getNextFiberState();
+    if (item.type !== type) {
+        throw new Error(`The order of the hooks is violated. Expected: ${type}, got: ${item.type}`);
+    }
+    return item;
+};
+//# sourceMappingURL=helpers.js.map

package/dist/hooks/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/hooks/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAG3B;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAe,EAAY,EAAE,CAAC;IACrD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACtB,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CACxD,CAAC;AAAA,CACH,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAgB,EAAE,IAAe,EAAW,EAAE,CAAC;IACvE,OAAO,CACL,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;QAC5B,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CACrB,CAAC,YAAY,OAAO;YAClB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,IAAI,CAAC,GAAG,CAAC;YACxC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,CACpB,CACF,CAAC;AAAA,CACH,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,IAA2B,EAC3B,EAA2B,EACxB,EAAE,CAAC;IACN,MAAM,WAAW,GAAG,kBAAkB,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,wBAAwB,EAAE,CAAC;IAEzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,IAAI,GAAM,EAAE,CAAC,KAAK,CAAC,CAAC;QAC1B,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC;IAC1E,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,iDAAiD,IAAI,UAAU,IAAI,CAAC,IAAI,EAAE,CAC3E,CAAC;IACJ,CAAC;IAED,OAAO,IAAoB,CAAC;AAAA,CAC7B,CAAC"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,9 @@
+export { useCallback } from './useCallback';
+export { createContext, useContext } from './useContext';
+export { useEffect, useLayoutEffect } from './useEffect';
+export { useStableCallback } from './useStableCallback';
+export { useId } from './useId';
+export { useMemo } from './useMemo';
+export { useRef } from './useRef';
+export { useState } from './useState';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,9 @@
+export { useCallback } from './useCallback';
+export { createContext, useContext } from './useContext';
+export { useEffect, useLayoutEffect } from './useEffect';
+export { useStableCallback } from './useStableCallback';
+export { useId } from './useId';
+export { useMemo } from './useMemo';
+export { useRef } from './useRef';
+export { useState } from './useState';
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/hooks/useCallback.d.ts

@@ -0,0 +1,2 @@
+export declare function useCallback<TArgs extends unknown[], TRes>(fn: (...args: TArgs) => TRes, deps: unknown[]): (...args: TArgs) => TRes;
+//# sourceMappingURL=useCallback.d.ts.map

package/dist/hooks/useCallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCallback.d.ts","sourceRoot":"","sources":["../../src/hooks/useCallback.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,IAAI,EACvD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,IAAI,EAC5B,IAAI,EAAE,OAAO,EAAE,4BAGhB"}

package/dist/hooks/useCallback.js

@@ -0,0 +1,5 @@
+import { useMemo } from './useMemo';
+export function useCallback(fn, deps) {
+    return useMemo(() => fn, deps);
+}
+//# sourceMappingURL=useCallback.js.map

package/dist/hooks/useCallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCallback.js","sourceRoot":"","sources":["../../src/hooks/useCallback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,UAAU,WAAW,CACzB,EAA4B,EAC5B,IAAe,EACf;IACA,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;AAAA,CAChC"}

package/dist/hooks/useContext.d.ts

@@ -0,0 +1,37 @@
+import { type ReactContext } from '../types';
+/**
+ * Creates a React context object that can be used to pass data through the
+ * component tree without having to pass props down manually at every level.
+ *
+ * @example
+ * // Create a theme context
+ * const ThemeContext = createContext('light');
+ *
+ * // Use in a component tree
+ * const App = () => (
+ *   <ThemeContext.Provider value="dark">
+ *     <UserInterface />
+ *   </ThemeContext.Provider>
+ * );
+ *
+ * const UserInterface = () => {
+ *   const theme = useContext(ThemeContext); // 'dark'
+ *   return <div className={theme}>Content</div>;
+ * };
+ */
+export declare const createContext: <T>(defaultValue: T) => ReactContext<T>;
+/**
+ * A hook that allows you to consume context values from the nearest Provider up
+ * the component tree. The component will re-render when the context value
+ * changes. If no context provider is found, the default context value is used.
+ *
+ * @example
+ * const ThemeContext = createContext('light');
+ *
+ * const ThemedButton = () => {
+ *   const theme = useContext(ThemeContext);
+ *   return <button className={`btn-${theme}`}>Click me</button>
+ * };
+ */
+export declare const useContext: <T>(ctx: ReactContext<T>) => T;
+//# sourceMappingURL=useContext.d.ts.map

package/dist/hooks/useContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useContext.d.ts","sourceRoot":"","sources":["../../src/hooks/useContext.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,YAAY,EAIlB,MAAM,UAAU,CAAC;AAGlB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,qCAmB9B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,4BAqC3B,CAAC"}

package/dist/hooks/useContext.js

@@ -0,0 +1,101 @@
+import { getAppByFiber } from '../core/reconciliation/app';
+import { getNextHookOrCreate } from './helpers';
+/**
+ * Creates a React context object that can be used to pass data through the
+ * component tree without having to pass props down manually at every level.
+ *
+ * @example
+ * // Create a theme context
+ * const ThemeContext = createContext('light');
+ *
+ * // Use in a component tree
+ * const App = () => (
+ *   <ThemeContext.Provider value="dark">
+ *     <UserInterface />
+ *   </ThemeContext.Provider>
+ * );
+ *
+ * const UserInterface = () => {
+ *   const theme = useContext(ThemeContext); // 'dark'
+ *   return <div className={theme}>Content</div>;
+ * };
+ */
+export const createContext = (
+/** The default value that will be used when a component consumes the context
+ * but is not wrapped by a Provider */
+defaultValue) => {
+    const id = ++idx; // Unique ID.
+    const ctx = {
+        __id: id,
+        __default: defaultValue,
+        // @ts-ignore the real type is very different. But it's React way of typing.
+        Provider: { __ctx: null },
+        Consumer: null,
+    };
+    ctx.Provider.__ctx = ctx;
+    ctx.Consumer = function ContextConsumer({ children }) {
+        return children(useContext(ctx));
+    };
+    return ctx;
+};
+/**
+ * A hook that allows you to consume context values from the nearest Provider up
+ * the component tree. The component will re-render when the context value
+ * changes. If no context provider is found, the default context value is used.
+ *
+ * @example
+ * const ThemeContext = createContext('light');
+ *
+ * const ThemedButton = () => {
+ *   const theme = useContext(ThemeContext);
+ *   return <button className={`btn-${theme}`}>Click me</button>
+ * };
+ */
+export const useContext = (
+/** The context object created by createContext. */
+ctx) => {
+    const item = getNextHookOrCreate('context', (fiber) => {
+        const providerFiber = findProvider(fiber, ctx.__id);
+        if (providerFiber) {
+            // We can assume that the found provider never changes, because when it
+            // changes, all its children die (including this component).
+            providerFiber.data.consumers.add(fiber);
+        }
+        return {
+            type: 'context',
+            ctx,
+            providerFiber,
+            destructor: () => {
+                providerFiber?.data.consumers.delete(fiber);
+            },
+        };
+    });
+    if (item.providerFiber) {
+        const { tempContext } = getAppByFiber(item.providerFiber);
+        const { id } = item.providerFiber;
+        if (tempContext.has(id)) {
+            // When we're here it means the provider's value was invalidated during
+            // the active render.
+            return tempContext.get(id);
+        }
+        // Provider is given, its value wasn't updated in this cycle.
+        return item.providerFiber.props.value;
+    }
+    // Provider not found. Use the default value.
+    return ctx.__default;
+};
+/**
+ * Traverse through the given fiber's parent nodes and search for the provider
+ * <ctx.Provider/>. Returns `null` if it is not found.
+ */
+const findProvider = (fiber, id) => {
+    while (fiber.role !== 'context' || fiber.data.ctx.__id !== id) {
+        fiber = fiber.parent;
+        if (!fiber.parent) {
+            return null;
+        }
+    }
+    return fiber;
+};
+let idx = 0;
+//# sourceMappingURL=useContext.js.map

package/dist/hooks/useContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useContext.js","sourceRoot":"","sources":["../../src/hooks/useContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAQrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;AAC3B;sCACsC;AACtC,YAAe,EACE,EAAE,CAAC;IACpB,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,aAAa;IAC/B,MAAM,GAAG,GAAoB;QAC3B,IAAI,EAAE,EAAE;QACR,SAAS,EAAE,YAAY;QACvB,4EAA4E;QAC5E,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAkC,EAAE;QACvD,QAAQ,EAAE,IAA0C;KACrD,CAAC;IACF,GAAG,CAAC,QAAQ,CAAC,KAAK,GAAG,GAAG,CAAC;IACzB,GAAG,CAAC,QAAQ,GAAG,SAAS,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE;QACpD,OAAO,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAAA,CAClC,CAAC;IAEF,OAAO,GAAG,CAAC;AAAA,CACZ,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;AACxB,mDAAmD;AACnD,GAAoB,EACjB,EAAE,CAAC;IACN,MAAM,IAAI,GAAG,mBAAmB,CAAoB,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;QACxE,MAAM,aAAa,GAAG,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,aAAa,EAAE,CAAC;YAClB,uEAAuE;YACvE,4DAA4D;YAC5D,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO;YACL,IAAI,EAAE,SAAS;YACf,GAAG;YACH,aAAa;YACb,UAAU,EAAE,GAAG,EAAE,CAAC;gBAChB,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAAA,CAC7C;SACF,CAAC;IAAA,CACH,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,MAAM,EAAE,WAAW,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1D,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC;QAClC,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACxB,uEAAuE;YACvE,qBAAqB;YACrB,OAAO,WAAW,CAAC,GAAG,CAAC,EAAE,CAAM,CAAC;QAClC,CAAC;QAED,6DAA6D;QAC7D,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAU,CAAC;IAC7C,CAAC;IAED,6CAA6C;IAC7C,OAAO,GAAG,CAAC,SAAS,CAAC;AAAA,CACtB,CAAC;AAEF;;;GAGG;AACH,MAAM,YAAY,GAAG,CACnB,KAAgB,EAChB,EAAU,EACe,EAAE,CAAC;IAC5B,OAAO,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,EAAE,EAAE,CAAC;QAC9D,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AAAA,CACd,CAAC;AAEF,IAAI,GAAG,GAAG,CAAC,CAAC"}

package/dist/hooks/useEffect.d.ts

@@ -0,0 +1,48 @@
+import { type EffectHandler } from '../types';
+/**
+ * A hook that performs side effects in functional components. This enhanced
+ * version supports async functions and provides an AbortSignal for cleanup.
+ *
+ * Effects run after the render is committed to the screen, making them suitable
+ * for data fetching, subscriptions, or manually changing the DOM.
+ *
+ * @example
+ * // Basic effect with cleanup
+ * useEffect(() => {
+ *   const timer = setInterval(() => console.log('tick'), 1000);
+ *   return () => clearInterval(timer);
+ * }, []);
+ *
+ * // Async effect with abort signal
+ * useEffect(async (signal) => {
+ *   try {
+ *     const response = await fetch('/api/data', { signal });
+ *     const data = await response.json();
+ *     setData(data);
+ *   } catch (error) {
+ *     if (!signal.aborted) {
+ *       console.error('Fetch failed:', error);
+ *     }
+ *   }
+ * }, [userId]);
+ */
+export declare const useEffect: (fn: EffectHandler, deps?: unknown[] | undefined) => void;
+/**
+ * A hook that performs side effects synchronously after all DOM mutations but
+ * before the browser paints. This enhanced version supports async functions
+ * and provides an AbortSignal for cleanup.
+ *
+ * Use this for DOM measurements, synchronous DOM mutations, or when you need
+ * to read layout properties before the browser paints.
+ *
+ * @example
+ * // Measuring DOM elements before paint
+ * useLayoutEffect(() => {
+ *   const rect = elementRef.current?.getBoundingClientRect();
+ *   if (rect) {
+ *     setDimensions({ width: rect.width, height: rect.height });
+ *   }
+ * }, []);
+ */
+export declare const useLayoutEffect: (fn: EffectHandler, deps?: unknown[] | undefined) => void;
+//# sourceMappingURL=useEffect.d.ts.map

package/dist/hooks/useEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEffect.d.ts","sourceRoot":"","sources":["../../src/hooks/useEffect.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,UAAU,CAAC;AAyBlB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,SAAS,2DAWrB,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,2DAW3B,CAAC"}