@creact-labs/creact 0.1.7 → 0.2.0

package/dist/hooks/context.js

@@ -1,334 +0,0 @@
-"use strict";
-/**
-
- * Licensed under the Apache License, Version 2.0 (the "License");
-
- * you may not use this file except in compliance with the License.
-
- * You may obtain a copy of the License at
-
- *
-
- *     http://www.apache.org/licenses/LICENSE-2.0
-
- *
-
- * Unless required by applicable law or agreed to in writing, software
-
- * distributed under the License is distributed on an "AS IS" BASIS,
-
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-
- * See the License for the specific language governing permissions and
-
- * limitations under the License.
-
- *
-
- * Copyright 2025 Daniel Coutinho Ribeiro
-
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.requireHookContext = requireHookContext;
-exports.runWithHookContext = runWithHookContext;
-exports.incrementHookIndex = incrementHookIndex;
-exports.setRenderContext = setRenderContext;
-exports.clearRenderContext = clearRenderContext;
-exports.hasRenderContext = hasRenderContext;
-exports.getCurrentState = getCurrentState;
-exports.pushContextValue = pushContextValue;
-exports.popContextValue = popContextValue;
-exports.getContextValue = getContextValue;
-exports.clearContextStacks = clearContextStacks;
-exports.clearPreviousOutputs = clearPreviousOutputs;
-exports.setPreviousOutputs = setPreviousOutputs;
-exports.getCurrentPath = getCurrentPath;
-exports.isRendering = isRendering;
-exports.startAccessTracking = startAccessTracking;
-exports.endAccessTracking = endAccessTracking;
-exports.trackOutputAccess = trackOutputAccess;
-exports.getAccessTrackingSession = getAccessTrackingSession;
-// Hook context management using AsyncLocalStorage for thread safety
-// This ensures hook state is isolated per execution context in concurrent deployments
-const async_hooks_1 = require("async_hooks");
-/**
- * AsyncLocalStorage instance for hook context isolation
- */
-const hookContextStorage = new async_hooks_1.AsyncLocalStorage();
-/**
- * Module-level previousOutputsMap that persists across context creations
- * This is necessary because runWithHookContext creates fresh contexts,
- * but we need to preserve outputs set by setPreviousOutputs() for re-renders
- */
-let globalPreviousOutputsMap = null;
-/**
- * Create a new consolidated hook context
- */
-function createConsolidatedHookContext() {
-    return {
-        // Single fiber reference for all hooks
-        currentFiber: null,
-        // Separate indices per hook type
-        stateHookIndex: 0,
-        effectHookIndex: 0,
-        contextHookIndex: 0,
-        instanceHookIndex: 0,
-        // Context stacks
-        contextStacks: new Map(),
-        // useInstance context
-        currentPath: [],
-        previousOutputsMap: globalPreviousOutputsMap, // Use global map
-        // Access tracking
-        accessTrackingSessions: new Map(),
-    };
-}
-/**
- * Get the consolidated hook context with validation
- * This is the primary function all hooks should use
- */
-function requireHookContext() {
-    const context = hookContextStorage.getStore();
-    if (!context) {
-        throw new Error('Hook called outside of rendering context. ' +
-            'Hooks must be called inside component functions during render.');
-    }
-    if (!context.currentFiber) {
-        throw new Error('Hook called without active fiber context. ' +
-            'This indicates a timing issue in the rendering pipeline.');
-    }
-    return context;
-}
-/**
- * Get the current hook context, returning null if not available
- */
-function getHookContextSafe() {
-    return hookContextStorage.getStore() || null;
-}
-/**
- * Run a function with a new consolidated hook context
- */
-function runWithHookContext(fn) {
-    const context = createConsolidatedHookContext();
-    return hookContextStorage.run(context, fn);
-}
-/**
- * Increment hook index for specific hook type
- */
-function incrementHookIndex(hookType = 'state') {
-    const context = requireHookContext();
-    switch (hookType) {
-        case 'state':
-            const stateIndex = context.stateHookIndex;
-            context.stateHookIndex++;
-            return stateIndex;
-        case 'effect':
-            const effectIndex = context.effectHookIndex;
-            context.effectHookIndex++;
-            return effectIndex;
-        case 'context':
-            const contextIndex = context.contextHookIndex;
-            context.contextHookIndex++;
-            return contextIndex;
-        case 'instance':
-            const instanceIndex = context.instanceHookIndex;
-            context.instanceHookIndex++;
-            return instanceIndex;
-        default:
-            throw new Error(`Unknown hook type: ${hookType}`);
-    }
-}
-// ============================================================================
-// Render Context Management
-// ============================================================================
-/**
- * Set the current rendering context for all hooks
- * Called by Renderer before executing a component
- *
- * Requirements: 8.2, 8.4
- */
-function setRenderContext(fiber, path) {
-    const context = getHookContextSafe();
-    if (context) {
-        context.currentFiber = fiber;
-        context.currentPath = path || [];
-        context.stateHookIndex = 0;
-        context.effectHookIndex = 0;
-        context.contextHookIndex = 0;
-        context.instanceHookIndex = 0;
-    }
-}
-/**
- * Clear the current rendering context for all hooks
- * Called by Renderer after component execution
- *
- * Requirements: 8.2, 8.4
- */
-function clearRenderContext() {
-    const context = getHookContextSafe();
-    if (context) {
-        context.currentFiber = null;
-        context.stateHookIndex = 0;
-        context.effectHookIndex = 0;
-        context.contextHookIndex = 0;
-        context.instanceHookIndex = 0;
-    }
-}
-/**
- * Check if there is an active render context
- */
-function hasRenderContext() {
-    const context = getHookContextSafe();
-    return context?.currentFiber !== null;
-}
-/**
- * Get the current fiber state
- */
-function getCurrentState() {
-    const context = getHookContextSafe();
-    return context?.currentFiber?.state;
-}
-// ============================================================================
-// useContext Support Functions
-// ============================================================================
-/**
- * Push a context value onto the stack
- * Called by Renderer when entering a Provider
- */
-function pushContextValue(contextId, value) {
-    const context = getHookContextSafe();
-    if (context) {
-        if (!context.contextStacks.has(contextId)) {
-            context.contextStacks.set(contextId, []);
-        }
-        context.contextStacks.get(contextId).push(value);
-    }
-}
-/**
- * Pop a context value from the stack
- * Called by Renderer when exiting a Provider
- */
-function popContextValue(contextId) {
-    const context = getHookContextSafe();
-    if (context) {
-        const stack = context.contextStacks.get(contextId);
-        if (stack && stack.length > 0) {
-            stack.pop();
-        }
-    }
-}
-/**
- * Get the current context value from the stack
- */
-function getContextValue(contextId) {
-    const context = getHookContextSafe();
-    if (!context) {
-        throw new Error('Hook called outside of rendering context. This is likely a bug in CReact.');
-    }
-    const stack = context.contextStacks.get(contextId);
-    if (stack && stack.length > 0) {
-        return { hasValue: true, value: stack[stack.length - 1] };
-    }
-    return { hasValue: false, value: undefined };
-}
-/**
- * Clear all context stacks
- * Called by Renderer to prevent memory leaks
- */
-function clearContextStacks() {
-    const context = getHookContextSafe();
-    if (context) {
-        context.contextStacks.clear();
-    }
-}
-/**
- * Clear the global previous outputs map
- * Called for test isolation and cleanup
- */
-function clearPreviousOutputs() {
-    globalPreviousOutputsMap = null;
-    const context = getHookContextSafe();
-    if (context) {
-        context.previousOutputsMap = null;
-    }
-}
-// ============================================================================
-// useInstance Support Functions
-// ============================================================================
-/**
- * Set previous outputs map for restoration during render
- * Called by CReact before rendering
- */
-function setPreviousOutputs(outputsMap) {
-    // Set the global map so it persists across context creations
-    globalPreviousOutputsMap = outputsMap;
-    // Also update current context if available
-    const context = getHookContextSafe();
-    if (context) {
-        context.previousOutputsMap = outputsMap;
-    }
-}
-/**
- * Get the current rendering path
- */
-function getCurrentPath() {
-    const context = getHookContextSafe();
-    if (!context) {
-        throw new Error('Hook called outside of rendering context. This is likely a bug in CReact.');
-    }
-    return [...context.currentPath];
-}
-/**
- * Check if currently rendering
- */
-function isRendering() {
-    const context = getHookContextSafe();
-    return context?.currentFiber !== null;
-}
-// ============================================================================
-// Access Tracking for Output Dependency Analysis
-// ============================================================================
-/**
- * Start tracking output accesses for a fiber
- * Used by useEffect to track which outputs are accessed in dependencies
- */
-function startAccessTracking(fiber) {
-    const context = requireHookContext();
-    context.accessTrackingSessions.set(fiber, {
-        fiber,
-        startTime: Date.now(),
-        trackedOutputs: new Set(),
-        isActive: true,
-    });
-}
-/**
- * End tracking and return the set of accessed outputs
- */
-function endAccessTracking(fiber) {
-    const context = requireHookContext();
-    const session = context.accessTrackingSessions.get(fiber);
-    if (!session) {
-        return new Set();
-    }
-    session.isActive = false;
-    context.accessTrackingSessions.delete(fiber);
-    return session.trackedOutputs;
-}
-/**
- * Track an output access during an active tracking session
- */
-function trackOutputAccess(fiber, bindingKey) {
-    const context = getHookContextSafe();
-    if (!context)
-        return;
-    const session = context.accessTrackingSessions.get(fiber);
-    if (session?.isActive) {
-        session.trackedOutputs.add(bindingKey);
-    }
-}
-/**
- * Get the current access tracking session for a fiber
- */
-function getAccessTrackingSession(fiber) {
-    const context = getHookContextSafe();
-    return context?.accessTrackingSessions.get(fiber);
-}

package/dist/hooks/useContext.d.ts

@@ -1,113 +0,0 @@
-/**
-
- * Licensed under the Apache License, Version 2.0 (the "License");
-
- * you may not use this file except in compliance with the License.
-
- * You may obtain a copy of the License at
-
- *
-
- *     http://www.apache.org/licenses/LICENSE-2.0
-
- *
-
- * Unless required by applicable law or agreed to in writing, software
-
- * distributed under the License is distributed on an "AS IS" BASIS,
-
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-
- * See the License for the specific language governing permissions and
-
- * limitations under the License.
-
- *
-
- * Copyright 2025 Daniel Coutinho Ribeiro
-
- */
-import { Context } from '../context/createContext';
-import { FiberNode } from '../core/types';
-/**
- * Set the context dependency tracker instance
- * Called by CReact during initialization
- *
- * @internal
- */
-export declare function setContextDependencyTracker(tracker: any): void;
-/**
- * Get the context dependency tracker instance
- *
- * @internal
- */
-export declare function getContextDependencyTracker(): any;
-/**
- * Set the current rendering context for useContext
- * Called by Renderer before executing a component
- *
- * @internal
- */
-export declare function setContextRenderContext(fiber: FiberNode): void;
-/**
- * Clear the current rendering context for useContext
- * Called by Renderer after component execution
- *
- * @internal
- */
-export declare function clearContextRenderContext(): void;
-/**
- * Push a context value onto the stack
- * Called by Renderer when entering a Provider
- *
- * @internal
- */
-export declare function pushContextValue(contextId: symbol, value: any): void;
-/**
- * Pop a context value from the stack
- * Called by Renderer when exiting a Provider
- *
- * @internal
- */
-export declare function popContextValue(contextId: symbol): void;
-/**
- * Clear all context stacks
- * Called by Renderer to prevent memory leaks
- *
- * @internal
- */
-export declare function clearContextStacks(): void;
-/**
- * useContext hook - Retrieve value from nearest Provider (like React.useContext)
- *
- * This hook retrieves the value from the nearest Provider in the component tree.
- * The Renderer maintains a stack of context values as it traverses the tree.
- *
- * Enhanced with reactive capabilities:
- * - Tracks context dependencies for selective re-rendering
- * - Only triggers re-renders when context values are bound to provider outputs
- * - Integrates with ContextDependencyTracker for change detection
- *
- * REQ-02: Stack Context (declarative outputs)
- * REQ-3.1, 3.2, 3.3, 3.4, 3.5: Context reactivity system
- *
- * @param context - Context object created by createContext
- * @returns Value from nearest Provider, or default value if no Provider found
- * @throws Error if no Provider found and no default value provided
- *
- * @example
- * ```tsx
- * const RegistryContext = createContext<{ repositoryUrl?: string }>({});
- *
- * function Service() {
- *   const { repositoryUrl } = useContext(RegistryContext);
- *
- *   const service = useInstance(AppRunnerService, {
- *     image: `${repositoryUrl}:latest`
- *   });
- *
- *   return <></>;
- * }
- * ```
- */
-export declare function useContext<T>(context: Context<T>): T;

package/dist/hooks/useContext.js

@@ -1,169 +0,0 @@
-"use strict";
-/**
-
- * Licensed under the Apache License, Version 2.0 (the "License");
-
- * you may not use this file except in compliance with the License.
-
- * You may obtain a copy of the License at
-
- *
-
- *     http://www.apache.org/licenses/LICENSE-2.0
-
- *
-
- * Unless required by applicable law or agreed to in writing, software
-
- * distributed under the License is distributed on an "AS IS" BASIS,
-
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-
- * See the License for the specific language governing permissions and
-
- * limitations under the License.
-
- *
-
- * Copyright 2025 Daniel Coutinho Ribeiro
-
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setContextDependencyTracker = setContextDependencyTracker;
-exports.getContextDependencyTracker = getContextDependencyTracker;
-exports.setContextRenderContext = setContextRenderContext;
-exports.clearContextRenderContext = clearContextRenderContext;
-exports.pushContextValue = pushContextValue;
-exports.popContextValue = popContextValue;
-exports.clearContextStacks = clearContextStacks;
-exports.useContext = useContext;
-const context_1 = require("./context");
-// Global context dependency tracker instance
-let contextDependencyTracker = null;
-/**
- * Set the context dependency tracker instance
- * Called by CReact during initialization
- *
- * @internal
- */
-function setContextDependencyTracker(tracker) {
-    contextDependencyTracker = tracker;
-}
-/**
- * Get the context dependency tracker instance
- *
- * @internal
- */
-function getContextDependencyTracker() {
-    return contextDependencyTracker;
-}
-/**
- * Set the current rendering context for useContext
- * Called by Renderer before executing a component
- *
- * @internal
- */
-function setContextRenderContext(fiber) {
-    (0, context_1.setRenderContext)(fiber);
-}
-/**
- * Clear the current rendering context for useContext
- * Called by Renderer after component execution
- *
- * @internal
- */
-function clearContextRenderContext() {
-    (0, context_1.clearRenderContext)();
-}
-/**
- * Push a context value onto the stack
- * Called by Renderer when entering a Provider
- *
- * @internal
- */
-function pushContextValue(contextId, value) {
-    (0, context_1.pushContextValue)(contextId, value);
-}
-/**
- * Pop a context value from the stack
- * Called by Renderer when exiting a Provider
- *
- * @internal
- */
-function popContextValue(contextId) {
-    (0, context_1.popContextValue)(contextId);
-}
-/**
- * Clear all context stacks
- * Called by Renderer to prevent memory leaks
- *
- * @internal
- */
-function clearContextStacks() {
-    (0, context_1.clearContextStacks)();
-}
-/**
- * useContext hook - Retrieve value from nearest Provider (like React.useContext)
- *
- * This hook retrieves the value from the nearest Provider in the component tree.
- * The Renderer maintains a stack of context values as it traverses the tree.
- *
- * Enhanced with reactive capabilities:
- * - Tracks context dependencies for selective re-rendering
- * - Only triggers re-renders when context values are bound to provider outputs
- * - Integrates with ContextDependencyTracker for change detection
- *
- * REQ-02: Stack Context (declarative outputs)
- * REQ-3.1, 3.2, 3.3, 3.4, 3.5: Context reactivity system
- *
- * @param context - Context object created by createContext
- * @returns Value from nearest Provider, or default value if no Provider found
- * @throws Error if no Provider found and no default value provided
- *
- * @example
- * ```tsx
- * const RegistryContext = createContext<{ repositoryUrl?: string }>({});
- *
- * function Service() {
- *   const { repositoryUrl } = useContext(RegistryContext);
- *
- *   const service = useInstance(AppRunnerService, {
- *     image: `${repositoryUrl}:latest`
- *   });
- *
- *   return <></>;
- * }
- * ```
- */
-function useContext(context) {
-    // Use consolidated hook context
-    const hookContext = (0, context_1.requireHookContext)();
-    const currentFiber = hookContext.currentFiber; // Non-null assertion safe due to requireHookContext validation
-    // Get hook index for dependency tracking (context-specific)
-    const hookIndex = (0, context_1.incrementHookIndex)('context');
-    // Track context dependency for reactive updates
-    if (contextDependencyTracker) {
-        contextDependencyTracker.trackContextConsumption(context._contextId, currentFiber, hookIndex);
-    }
-    // Look up the context value from the stack
-    const result = (0, context_1.getContextValue)(context._contextId);
-    let contextValue;
-    // If Provider found, return the value (even if it's undefined)
-    if (result.hasValue) {
-        contextValue = result.value;
-    }
-    else if (context.defaultValue !== undefined) {
-        // If no Provider found, use default value
-        contextValue = context.defaultValue;
-    }
-    else {
-        // No Provider and no default value - throw error
-        throw new Error(`useContext called without a Provider for this context and no default value was provided. ` +
-            `Make sure to wrap your component tree with <Context.Provider value={...}>.`);
-    }
-    // Store the context value in the dependency tracker for change detection
-    if (contextDependencyTracker) {
-        contextDependencyTracker.setInitialContextValue(context._contextId, contextValue);
-    }
-    return contextValue;
-}