@creact-labs/creact 0.1.8 → 0.2.1

package/dist/core/Renderer.d.ts

@@ -1,336 +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 { FiberNode, JSXElement, ReRenderReason } from './types';
-import { RenderScheduler } from './RenderScheduler';
-/**
- * Renderer transforms JSX into a Fiber tree
- *
- * The Fiber tree is an intermediate representation that includes:
- * - All components (containers + resources)
- * - Hierarchical paths for identity tracking
- * - Props and children resolved recursively
- *
- * Enhanced with context reactivity:
- * - Tracks context provider value changes
- * - Integrates with ContextDependencyTracker for selective re-rendering
- * - Detects when context values change and triggers appropriate re-renders
- *
- * No dependencies injected - pure transformation logic
- */
-export declare class Renderer {
-    private currentFiber;
-    private currentPath;
-    private renderScheduler?;
-    private contextDependencyTracker?;
-    private structuralChangeDetector?;
-    private previousStructures;
-    /**
-     * Render JSX to Fiber tree
-     *
-     * @param jsx - JSX element to render
-     * @returns Root Fiber node
-     */
-    render(jsx: JSXElement): FiberNode;
-    /**
-     * Recursively render a JSX element to a Fiber node
-     *
-     * @param element - JSX element
-     * @param parentPath - Path from parent
-     * @param siblingIndex - Sibling index for automatic key generation (default 0)
-     * @returns Fiber node
-     */
-    private renderElement;
-    /**
-     * Execute a component function to resolve its children
-     *
-     * Note: setRenderContext should already be called by renderComponent before this
-     *
-     * @param type - Component type (function or class)
-     * @param props - Props to pass
-     * @param path - Current path (for context)
-     * @returns Children elements
-     */
-    private executeComponent;
-    /**
-     * Render children elements
-     *
-     * @param children - Children to render (can be array, single element, or null)
-     * @param parentPath - Path from parent
-     * @returns Array of Fiber nodes
-     */
-    private renderChildren;
-    /**
-     * Get a human-readable type name for warning messages
-     *
-     * @param type - Component type
-     * @returns Type name string
-     */
-    private getTypeName;
-    /**
-     * Get current path (for hooks to access)
-     */
-    getCurrentPath(): string[];
-    /**
-     * Get current Fiber for post-deployment effects
-     *
-     * @returns Current Fiber node or null
-     */
-    getCurrentFiber(): FiberNode | null;
-    /**
-     * Set the RenderScheduler for selective re-rendering integration
-     *
-     * @param scheduler - RenderScheduler instance
-     */
-    setRenderScheduler(scheduler: RenderScheduler): void;
-    /**
-     * Set the ContextDependencyTracker for context reactivity
-     *
-     * @param tracker - ContextDependencyTracker instance
-     */
-    setContextDependencyTracker(tracker: any): void;
-    /**
-     * Set structural change detector for topology change detection
-     * @param detector - StructuralChangeDetector instance
-     */
-    setStructuralChangeDetector(detector: any): void;
-    /**
-     * Handle context provider value changes
-     * Called when a context provider's value prop changes
-     *
-     * @param contextId - Context identifier
-     * @param newValue - New context value
-     */
-    private handleContextProviderValueChange;
-    /**
-     * Detect structural changes in a component
-     * Compares the current structure with the previous render
-     *
-     * @param fiber - Fiber node to check for structural changes
-     * @returns True if structural changes were detected
-     */
-    private detectStructuralChanges;
-    /**
-     * Generate a structural signature for a fiber node
-     * This captures the essential structure that affects CloudDOM generation
-     *
-     * @param fiber - Fiber node to generate signature for
-     * @returns Structural signature string
-     */
-    private generateStructuralSignature;
-    /**
-     * Check for structural changes and schedule re-renders if needed
-     * Called during component re-execution
-     *
-     * @param fiber - Fiber node to check
-     */
-    private handleStructuralChanges;
-    /**
-     * Handle structural changes between old and new fiber trees
-     * Called during re-rendering to detect topology changes
-     *
-     * @param oldFiber - Previous fiber tree
-     * @param newFiber - New fiber tree after re-render
-     */
-    private handleStructuralChangesComparison;
-    /**
-     * Extract CloudDOM nodes from a fiber tree for structural comparison
-     *
-     * @param fiber - Fiber tree to extract CloudDOM from
-     * @returns Array of CloudDOM nodes
-     */
-    private extractCloudDOMFromFiber;
-    /**
-     * Re-render specific components with selective updates
-     * This method re-executes only the specified components and their children
-     *
-     * @param components - Array of fiber nodes to re-render
-     * @param reason - Reason for the re-render
-     * @returns Updated root fiber node
-     */
-    reRenderComponents(components: FiberNode[], reason: ReRenderReason): FiberNode;
-    /**
-     * Find components that depend on changed state/outputs
-     * This method traverses the fiber tree to find dependent components
-     *
-     * @param changedFiber - Fiber node that changed
-     * @returns Set of fiber nodes that depend on the changed fiber
-     */
-    findDependentComponents(changedFiber: FiberNode): Set<FiberNode>;
-    /**
-     * Track component dependencies during render
-     * This builds the dependency graph for selective re-rendering
-     *
-     * @param components - Components being rendered
-     */
-    private trackDependenciesDuringRender;
-    /**
-     * Build dependency graph for a component
-     * This analyzes the component's usage patterns to determine dependencies
-     *
-     * @param component - Component to analyze
-     */
-    private buildDependencyGraph;
-    /**
-     * Find the context provider fiber for a given context ID
-     * This traverses up the fiber tree to find the provider
-     *
-     * @param contextId - Context identifier to find provider for
-     * @returns Provider fiber node or null if not found
-     */
-    private findContextProvider;
-    /**
-     * Recursively search for a context provider in the fiber tree
-     *
-     * @param fiber - Current fiber to search
-     * @param contextId - Context ID to find
-     * @returns Provider fiber or null
-     */
-    private searchForProvider;
-    /**
-     * Perform selective re-render of specific components
-     * Only re-executes components that need updates
-     *
-     * @param rootFiber - Root fiber node
-     * @param componentsToReRender - Set of components that need re-rendering
-     * @param reason - Reason for re-render
-     * @returns Updated fiber tree
-     */
-    private selectiveReRender;
-    /**
-     * Recursively perform selective re-rendering
-     *
-     * @param fiber - Current fiber node
-     * @param componentsToReRender - Set of components to re-render
-     * @param reason - Reason for re-render
-     * @param currentPath - Current path in the tree
-     */
-    private selectiveReRenderRecursive;
-    /**
-     * Check if component should re-render by matching paths
-     * This works with cloned fibers where object identity doesn't match
-     *
-     * @param fiber - Current fiber to check
-     * @param componentsToReRender - Set of original fibers to re-render
-     * @returns True if this fiber's path matches any in the set
-     */
-    private shouldReRenderComponentByPath;
-    /**
-     * Determine if a component should be re-rendered
-     *
-     * @param fiber - Fiber node to check
-     * @param componentsToReRender - Set of components marked for re-rendering
-     * @returns True if component should be re-rendered
-     */
-    private shouldReRenderComponent;
-    /**
-     * Re-execute a component function
-     *
-     * @param fiber - Fiber node to re-execute
-     * @param currentPath - Current path in the tree
-     */
-    private reExecuteComponent;
-    /**
-     * Restore context stack for a fiber by traversing parent providers
-     * This ensures useContext() gets the correct values during re-renders
-     *
-     * @param fiber - Fiber node to restore context for
-     */
-    private restoreContextStackForFiber;
-    /**
-     * Find all ancestor context providers for a fiber
-     * Returns providers in order from root to the fiber's parent
-     *
-     * @param fiber - Fiber node to find ancestors for
-     * @returns Array of provider fibers (root to leaf order)
-     */
-    private findAncestorProviders;
-    /**
-     * Recursively search for ancestor providers
-     *
-     * @param currentFiber - Current fiber being examined
-     * @param targetFiber - Target fiber we're looking for ancestors of
-     * @param providers - Array to collect providers
-     * @param path - Current path of provider fibers
-     * @returns True if targetFiber was found in this subtree
-     */
-    private findAncestorProvidersRecursive;
-    /**
-     * Find the root component from a set of components
-     *
-     * CRITICAL FIX: Find common ancestor instead of just shortest path
-     * When multiple components have the same path length (e.g., multi-environment apps),
-     * we need to find their common ancestor, not just pick the first one.
-     *
-     * @param components - Array of components
-     * @returns Root component or null
-     */
-    private findRootComponent;
-    /**
-     * Find common path prefix among multiple paths
-     *
-     * @param paths - Array of path arrays
-     * @returns Common prefix path
-     */
-    private findCommonPathPrefix;
-    /**
-     * Find fiber by path in the fiber tree
-     *
-     * @param fiber - Root fiber to search from
-     * @param targetPath - Path to find
-     * @returns Fiber at path or null
-     */
-    private findFiberByPath;
-    /**
-     * Find actual root by traversing up the fiber tree
-     *
-     * @param fiber - Starting fiber
-     * @returns Root fiber
-     */
-    private findActualRoot;
-    /**
-     * Recursively find dependent components
-     *
-     * @param currentFiber - Current fiber being examined
-     * @param changedFiber - Fiber that changed
-     * @param dependents - Set to collect dependents
-     */
-    private findDependentsRecursive;
-    /**
-     * Set StateBindingManager for context dependency tracker integration
-     */
-    setStateBindingManager(stateBindingManager: any): void;
-    /**
-     * Clone a fiber node for selective updates
-     *
-     * @param fiber - Fiber to clone
-     * @returns Cloned fiber
-     */
-    private cloneFiberForUpdate;
-}