@creact-labs/creact 0.1.0

package/dist/core/Renderer.d.ts

@@ -0,0 +1,276 @@
+/**
+
+ * 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;
+    /**
+     * 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;
+    /**
+     * Find the root component from a set of components
+     *
+     * @param components - Array of components
+     * @returns Root component or null
+     */
+    private findRootComponent;
+    /**
+     * 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;
+}