@codeyam/codeyam-cli 0.1.0-staging.8e7b1bd → 0.1.0-staging.b8a55ba

package/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/MuiManager.js

@@ -0,0 +1,454 @@
+/**
+ * Framework manager for MUI (Material UI) components.
+ *
+ * Handles patterns where MUI component callbacks receive data from array props:
+ *
+ * 1. DataGrid: `rows` array → `columns[].renderCell` callback receives `params.row`
+ * 2. Autocomplete: `options` array → `renderOption`/`getOptionLabel` callbacks receive option
+ *
+ * Example DataGrid:
+ * ```tsx
+ * <DataGrid
+ *   rows={data}
+ *   columns={[{ renderCell: (params) => <Cell value={params.row.id} /> }]}
+ * />
+ * ```
+ *
+ * Example Autocomplete:
+ * ```tsx
+ * <Autocomplete
+ *   options={users}
+ *   getOptionLabel={(option) => option.name}
+ *   renderOption={(props, option) => <li {...props}>{option.email}</li>}
+ * />
+ * ```
+ */
+export class MuiManager {
+    constructor() {
+        this.internalFunctions = new Set([
+            'DataGrid',
+            'DataGridPro',
+            'DataGridPremium',
+            'Autocomplete',
+        ]);
+    }
+    postProcess(scopeNode, scopeDataStructure) {
+        // Check this scope for DataGrid patterns when it's post-processed
+        this.processDataGridCallbacks(scopeNode, scopeDataStructure);
+        // Check for Autocomplete patterns
+        this.processAutocompleteCallbacks(scopeNode, scopeDataStructure);
+        // Also check if this scope is inside a DataGrid callback and propagate row property accesses
+        this.propagateFromChildScope(scopeNode, scopeDataStructure);
+    }
+    processDataGridCallbacks(scopeNode, scopeDataStructure) {
+        // Find DataGrid calls and link renderCell callbacks to rows
+        for (const [path, equivalencies] of Object.entries(scopeNode.equivalencies)) {
+            // Look for DataGrid().signature[0].columns equivalency (DataGrid, DataGridPro, DataGridPremium)
+            const dataGridMatch = path.match(/^(DataGrid(?:Pro|Premium)?\(\))\.signature\[0\]\.columns$/);
+            if (!dataGridMatch)
+                continue;
+            const dataGridCall = dataGridMatch[1];
+            // Find what columns is equivalent to (e.g., "columns" variable)
+            for (const equiv of equivalencies) {
+                const columnsVar = equiv.schemaPath;
+                // Find renderCell callbacks, following equivalency chains if needed
+                const callbackScopes = this.findRenderCellCallbacks(columnsVar, scopeNode, new Set(), scopeDataStructure);
+                for (const callbackScopeName of callbackScopes) {
+                    // Get the callback scope node
+                    const callbackScopeNode = scopeDataStructure.getScopeOrFunctionCallInfo(callbackScopeName);
+                    if (!callbackScopeNode) {
+                        continue;
+                    }
+                    // Add equivalency: signature[0].row ≡ DataGrid().signature[0].rows[]
+                    const callbackParamRowPath = 'signature[0].row';
+                    const rowsArrayElementPath = `${dataGridCall}.signature[0].rows[]`;
+                    scopeDataStructure.addEquivalency(callbackParamRowPath, rowsArrayElementPath, scopeNode.name, callbackScopeNode, 'MUI DataGrid renderCell params.row equivalency');
+                }
+            }
+        }
+    }
+    /**
+     * Process Autocomplete callbacks to link option parameters to options array.
+     *
+     * Autocomplete has two callback props that receive individual options:
+     * - getOptionLabel(option) - param 0 is the option
+     * - renderOption(props, option, state) - param 1 is the option
+     */
+    processAutocompleteCallbacks(scopeNode, scopeDataStructure) {
+        for (const [path, equivalencies] of Object.entries(scopeNode.equivalencies)) {
+            // Look for Autocomplete().signature[0].options equivalency
+            const autocompleteMatch = path.match(/^(Autocomplete\(\))\.signature\[0\]\.options$/);
+            if (!autocompleteMatch)
+                continue;
+            const autocompleteCall = autocompleteMatch[1];
+            // Find callback props: getOptionLabel, renderOption
+            for (const callbackProp of ['getOptionLabel', 'renderOption']) {
+                const callbackPath = `${autocompleteCall}.signature[0].${callbackProp}`;
+                const callbackEquivs = scopeNode.equivalencies[callbackPath];
+                if (callbackEquivs) {
+                    for (const callbackEquiv of callbackEquivs) {
+                        const callbackMatch = callbackEquiv.schemaPath.match(/^(cyScope[0-9A-Fa-f]+)\(\)\.functionCallReturnValue$/);
+                        if (!callbackMatch)
+                            continue;
+                        const callbackScopeName = callbackMatch[1];
+                        const callbackScopeNode = scopeDataStructure.getScopeOrFunctionCallInfo(callbackScopeName);
+                        if (!callbackScopeNode)
+                            continue;
+                        // Determine which parameter index receives the option
+                        // getOptionLabel: (option) => ... → param 0
+                        // renderOption: (props, option, state) => ... → param 1
+                        const paramIndex = callbackProp === 'renderOption' ? 1 : 0;
+                        const callbackParamPath = `signature[${paramIndex}]`;
+                        const optionsArrayElementPath = `${autocompleteCall}.signature[0].options[]`;
+                        scopeDataStructure.addEquivalency(callbackParamPath, optionsArrayElementPath, scopeNode.name, callbackScopeNode, `MUI Autocomplete ${callbackProp} option equivalency`);
+                        // Note: Property accesses are propagated in finalize() after all scopes are established
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Propagate property accesses from Autocomplete callback scope.
+     * When we find usages like `option.email`, create equivalencies to `options[].email`
+     * and trace back to the original data source (e.g., `users[].email`).
+     */
+    propagateAutocompletePropertyAccesses(callbackScope, autocompleteCall, optionParamIndex, parentScopeName, scopeDataStructure) {
+        const parentScope = scopeDataStructure.getScopeOrFunctionCallInfo(parentScopeName);
+        if (!parentScope)
+            return;
+        // Find what options is equivalent to (e.g., "users")
+        const optionsPath = `${autocompleteCall}.signature[0].options`;
+        const optionsEquivs = parentScope.equivalencies?.[optionsPath];
+        const dataSourcePath = optionsEquivs?.[0]?.schemaPath;
+        // Check for property accesses on the option parameter in the schema
+        // The schema contains entries like "signature[1].email" for property accesses
+        for (const schemaPath of Object.keys(callbackScope.schema || {})) {
+            // Match patterns like signature[0].name, signature[1].email (depending on param index)
+            const optionPropertyMatch = schemaPath.match(new RegExp(`^signature\\[${optionParamIndex}\\]\\.(\\w+)$`));
+            if (optionPropertyMatch) {
+                const propertyName = optionPropertyMatch[1];
+                // Create equivalency: schemaPath → options[].propertyName
+                const optionsPropertyPath = `${autocompleteCall}.signature[0].options[].${propertyName}`;
+                scopeDataStructure.addEquivalency(schemaPath, optionsPropertyPath, parentScopeName, callbackScope, 'MUI Autocomplete option property equivalency');
+                // Also create equivalency to the data source (e.g., users[].email)
+                if (dataSourcePath) {
+                    const dataPropertyPath = `${dataSourcePath}[].${propertyName}`;
+                    // Add to parent scope's schema
+                    if (!parentScope.schema[dataPropertyPath]) {
+                        parentScope.schema[dataPropertyPath] = 'unknown';
+                    }
+                    // Create bidirectional equivalencies to ensure propagation
+                    scopeDataStructure.addEquivalency(schemaPath, dataPropertyPath, parentScopeName, callbackScope, 'MUI Autocomplete option property equivalency');
+                    scopeDataStructure.addEquivalency(dataPropertyPath, schemaPath, parentScopeName, parentScope, 'MUI Autocomplete option property equivalency');
+                }
+            }
+        }
+    }
+    /**
+     * Find renderCell callbacks for a columns variable, following equivalency chains.
+     * For example: tableColumns → allColumns → allColumns[].renderCell → cyScope
+     *
+     * Also handles useMemo patterns where:
+     * - tableColumns → useMemo(cyScope(), [allColumns]).functionCallReturnValue
+     * - And allColumns[].renderCell → cyScope()
+     */
+    findRenderCellCallbacks(columnsVar, scopeNode, visited, scopeDataStructure) {
+        if (visited.has(columnsVar))
+            return [];
+        visited.add(columnsVar);
+        const callbackScopes = [];
+        // Try direct path: columnsVar[].renderCell - check both current scope and parent scopes
+        // Also check for indexed paths like columnsVar[3].renderCell (with specific indices)
+        const renderCellPath = `${columnsVar}[].renderCell`;
+        let renderCellEquivs = scopeNode.equivalencies[renderCellPath];
+        // If not found in current scope, check parent scopes (via scopeNode.tree)
+        if (!renderCellEquivs && scopeDataStructure && scopeNode.tree) {
+            for (const parentScopeName of scopeNode.tree) {
+                const parentScope = scopeDataStructure.getScopeOrFunctionCallInfo(parentScopeName);
+                if (parentScope?.equivalencies?.[renderCellPath]) {
+                    renderCellEquivs = parentScope.equivalencies[renderCellPath];
+                    break;
+                }
+            }
+        }
+        // Also look for indexed paths like tableColumns[3].renderCell, tableColumns[5].renderCell, etc.
+        // This is needed because column definitions often have specific indices
+        const indexedRenderCellPattern = new RegExp(`^${columnsVar.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\[\\d+\\]\\.renderCell$`);
+        const allScopesToCheck = [scopeNode];
+        if (scopeDataStructure && scopeNode.tree) {
+            for (const parentScopeName of scopeNode.tree) {
+                const parentScope = scopeDataStructure.getScopeOrFunctionCallInfo(parentScopeName);
+                if (parentScope)
+                    allScopesToCheck.push(parentScope);
+            }
+        }
+        for (const scope of allScopesToCheck) {
+            for (const [path, equivs] of Object.entries(scope.equivalencies || {})) {
+                if (indexedRenderCellPattern.test(path)) {
+                    for (const equiv of equivs) {
+                        const callbackMatch = equiv.schemaPath.match(/^(cyScope\d+)\(\)\.functionCallReturnValue$/);
+                        if (callbackMatch && !callbackScopes.includes(callbackMatch[1])) {
+                            callbackScopes.push(callbackMatch[1]);
+                        }
+                    }
+                }
+            }
+        }
+        if (renderCellEquivs) {
+            for (const renderCellEquiv of renderCellEquivs) {
+                // Check if it points to a callback (cyScope().functionCallReturnValue)
+                const callbackMatch = renderCellEquiv.schemaPath.match(/^(cyScope\d+)\(\)\.functionCallReturnValue$/);
+                if (callbackMatch && !callbackScopes.includes(callbackMatch[1])) {
+                    callbackScopes.push(callbackMatch[1]);
+                }
+            }
+        }
+        // If no direct callbacks found, follow equivalency chains
+        if (callbackScopes.length === 0) {
+            // Look for what columnsVar is equivalent to - check current scope and parent scopes
+            let varEquivs = scopeNode.equivalencies[columnsVar];
+            let equivScopeNode = scopeNode;
+            // If not found or only self-reference, check parent scopes (via scopeNode.tree)
+            if ((!varEquivs ||
+                (varEquivs.length === 1 && varEquivs[0].schemaPath === columnsVar)) &&
+                scopeDataStructure &&
+                scopeNode.tree) {
+                for (const parentScopeName of scopeNode.tree) {
+                    const parentScope = scopeDataStructure.getScopeOrFunctionCallInfo(parentScopeName);
+                    if (parentScope?.equivalencies?.[columnsVar]) {
+                        const parentEquivs = parentScope.equivalencies[columnsVar];
+                        // Check if it has non-self-reference equivalencies
+                        if (parentEquivs.some((e) => e.schemaPath !== columnsVar) ||
+                            parentEquivs.some((e) => e.schemaPath.includes('useMemo'))) {
+                            varEquivs = parentEquivs;
+                            equivScopeNode = parentScope;
+                            break;
+                        }
+                    }
+                }
+            }
+            if (varEquivs) {
+                for (const varEquiv of varEquivs) {
+                    const schemaPath = varEquiv.schemaPath;
+                    // Handle useMemo pattern: useMemo(cyScope(), [allColumns]).functionCallReturnValue
+                    // The second argument [allColumns] tells us what's being passed to useMemo
+                    const useMemoMatch = schemaPath.match(/^useMemo\(cyScope\d+\(\), \[([^\]]+)\]\)\.functionCallReturnValue$/);
+                    if (useMemoMatch) {
+                        // The array in the dependency list often contains the actual columns variable
+                        const depsList = useMemoMatch[1];
+                        // Parse the deps - could be comma-separated
+                        const deps = depsList.split(',').map((d) => d.trim());
+                        for (const dep of deps) {
+                            const nestedCallbacks = this.findRenderCellCallbacks(dep, equivScopeNode, visited, scopeDataStructure);
+                            callbackScopes.push(...nestedCallbacks);
+                        }
+                        continue;
+                    }
+                    // Skip other function calls and internal paths
+                    if (schemaPath.includes('()') || schemaPath.includes('[')) {
+                        continue;
+                    }
+                    // Skip self-references
+                    if (schemaPath === columnsVar) {
+                        continue;
+                    }
+                    // Recursively search in the equivalent variable
+                    const nestedCallbacks = this.findRenderCellCallbacks(schemaPath, equivScopeNode, visited, scopeDataStructure);
+                    callbackScopes.push(...nestedCallbacks);
+                }
+            }
+        }
+        return callbackScopes;
+    }
+    /**
+     * Propagate row property accesses from callback scope and its children.
+     * When we find usages like `params.row.id`, create equivalencies to `rows[].id`.
+     */
+    propagateRowPropertyAccesses(callbackScope, dataGridCall, parentScopeName, scopeDataStructure) {
+        // Check all scopes (callback and its children) for params.row.* accesses
+        const scopesToCheck = [callbackScope];
+        // Find child scopes by looking for scopes whose tree includes the callback scope
+        const callbackScopeName = callbackScope.name;
+        for (const [scopeName, scope] of Object.entries(scopeDataStructure.scopeNodes)) {
+            if (scope.tree &&
+                scope.tree.includes(callbackScopeName) &&
+                scopeName !== callbackScopeName) {
+                scopesToCheck.push(scope);
+            }
+        }
+        for (const scope of scopesToCheck) {
+            // Find equivalencies that reference params.row.* or signature[0].row.*
+            for (const [path, equivs] of Object.entries(scope.equivalencies)) {
+                for (const equiv of equivs) {
+                    const schemaPath = equiv.schemaPath;
+                    // Match patterns like params.row.id, params.row.flagged, signature[0].row.status
+                    const rowPropertyMatch = schemaPath.match(/^(?:params|signature\[0\])\.row\.(\w+)$/);
+                    if (rowPropertyMatch) {
+                        const propertyName = rowPropertyMatch[1];
+                        // Create equivalency: the path accessing params.row.X → rows[].X
+                        // e.g., updateStatus().signature[0].id → DataGrid().signature[0].rows[].id
+                        const rowsPropertyPath = `${dataGridCall}.signature[0].rows[].${propertyName}`;
+                        scopeDataStructure.addEquivalency(path, rowsPropertyPath, parentScopeName, scope, 'MUI DataGrid renderCell params.row equivalency');
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Process from child scope perspective: look for params.row.* accesses
+     * and trace back to find DataGrid rows equivalency in parent scopes.
+     */
+    propagateFromChildScope(scopeNode, scopeDataStructure) {
+        // Look for equivalencies in this scope that reference params.row.*
+        for (const [path, equivs] of Object.entries(scopeNode.equivalencies)) {
+            for (const equiv of equivs) {
+                const schemaPath = equiv.schemaPath;
+                // Match patterns like params.row.id, params.row.status
+                const rowPropertyMatch = schemaPath.match(/^params\.row\.(\w+)$/);
+                if (rowPropertyMatch) {
+                    const propertyName = rowPropertyMatch[1];
+                    // Look in parent scopes for DataGrid rows equivalency
+                    // The pattern we're looking for is: signature[0].row → DataGrid().signature[0].rows[]
+                    const dataGridCall = this.findDataGridInParentScopes(scopeNode, scopeDataStructure);
+                    if (dataGridCall) {
+                        // Find the parent scope that has the DataGrid
+                        const parentScopeName = this.findDataGridScopeName(scopeNode, scopeDataStructure);
+                        const parentScope = parentScopeName
+                            ? scopeDataStructure.getScopeOrFunctionCallInfo(parentScopeName)
+                            : undefined;
+                        // Find what DataGrid().signature[0].rows is equivalent to (e.g., "data.quotes")
+                        const rowsPath = `${dataGridCall}.signature[0].rows`;
+                        const rowsEquivs = parentScope?.equivalencies?.[rowsPath];
+                        const dataSourcePath = rowsEquivs?.[0]?.schemaPath;
+                        if (dataSourcePath && parentScope) {
+                            // Create equivalency: path → dataSource[].propertyName (e.g., data.quotes[].id)
+                            const dataPropertyPath = `${dataSourcePath}[].${propertyName}`;
+                            // Add equivalency in child scope
+                            scopeDataStructure.addEquivalency(path, dataPropertyPath, parentScopeName || scopeNode.name, scopeNode, 'MUI DataGrid renderCell params.row equivalency');
+                            // Also add the property access to the parent scope's schema
+                            // This ensures that data.quotes[].id shows up as an accessed property
+                            if (!parentScope.schema[dataPropertyPath]) {
+                                parentScope.schema[dataPropertyPath] = 'unknown';
+                            }
+                            // And create an equivalency FROM the data path so it propagates to returnValue
+                            scopeDataStructure.addEquivalency(dataPropertyPath, path, parentScopeName, parentScope, 'MUI DataGrid renderCell params.row equivalency');
+                        }
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Find the DataGrid call in parent scopes by looking for signature[0].row → DataGrid().signature[0].rows[]
+     */
+    findDataGridInParentScopes(scopeNode, scopeDataStructure) {
+        // Check the scope tree (parent scopes)
+        if (!scopeNode.tree)
+            return undefined;
+        for (const parentScopeName of scopeNode.tree) {
+            const parentScope = scopeDataStructure.getScopeOrFunctionCallInfo(parentScopeName);
+            if (!parentScope?.equivalencies)
+                continue;
+            // Look for signature[0].row → DataGrid().signature[0].rows[]
+            const rowEquivs = parentScope.equivalencies['signature[0].row'];
+            if (rowEquivs) {
+                for (const equiv of rowEquivs) {
+                    const match = equiv.schemaPath.match(/^(DataGrid(?:Pro|Premium)?)\(\)\.signature\[0\]\.rows\[\]$/);
+                    if (match) {
+                        return `${match[1]}()`;
+                    }
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Find the scope name that contains the DataGrid call
+     */
+    findDataGridScopeName(scopeNode, scopeDataStructure) {
+        if (!scopeNode.tree)
+            return undefined;
+        for (const parentScopeName of scopeNode.tree) {
+            const parentScope = scopeDataStructure.getScopeOrFunctionCallInfo(parentScopeName);
+            if (!parentScope?.equivalencies)
+                continue;
+            // Look for DataGrid().signature[0].columns
+            for (const path of Object.keys(parentScope.equivalencies)) {
+                if (path.match(/^DataGrid(?:Pro|Premium)?\(\)\.signature\[0\]\.columns$/)) {
+                    return parentScopeName;
+                }
+            }
+        }
+        return undefined;
+    }
+    isInterestedInSubpath(subPathParts, _scopeNode, _scopeDataStructure) {
+        // We're interested in MUI component paths (DataGrid variants and Autocomplete)
+        const hasMuiComponent = subPathParts.some((part) => part.match(/^(DataGrid(Pro|Premium)?|Autocomplete)\(/));
+        return hasMuiComponent;
+    }
+    addEquivalencies(_addEquivalenciesInfo) {
+        // We handle DataGrid in finalize() instead, since we need to scan
+        // for all equivalencies after they've been established
+        return false;
+    }
+    finalize(_scopeNode, scopeDataStructure) {
+        // Iterate through all scopes (finalize is only called on root)
+        for (const [scopeName, scopeNode] of Object.entries(scopeDataStructure.scopeNodes)) {
+            this.finalizeScope(scopeNode, scopeDataStructure);
+        }
+    }
+    finalizeScope(scopeNode, scopeDataStructure) {
+        // Propagate row property accesses after all scopes are established
+        // Find DataGrid calls in this scope and link renderCell params.row.* to rows[].*
+        for (const [path, equivalencies] of Object.entries(scopeNode.equivalencies)) {
+            // Look for DataGrid().signature[0].columns equivalency
+            const dataGridMatch = path.match(/^(DataGrid(?:Pro|Premium)?\(\))\.signature\[0\]\.columns$/);
+            if (dataGridMatch) {
+                const dataGridCall = dataGridMatch[1];
+                // Find what columns is equivalent to
+                for (const equiv of equivalencies) {
+                    const columnsVar = equiv.schemaPath;
+                    // Find renderCell callbacks
+                    const callbackScopes = this.findRenderCellCallbacks(columnsVar, scopeNode, new Set(), scopeDataStructure);
+                    for (const callbackScopeName of callbackScopes) {
+                        const callbackScopeNode = scopeDataStructure.getScopeOrFunctionCallInfo(callbackScopeName);
+                        if (!callbackScopeNode)
+                            continue;
+                        // Propagate sub-property accesses from params.row.*
+                        this.propagateRowPropertyAccesses(callbackScopeNode, dataGridCall, scopeNode.name, scopeDataStructure);
+                    }
+                }
+                continue;
+            }
+            // Look for Autocomplete().signature[0].options equivalency
+            const autocompleteMatch = path.match(/^(Autocomplete\(\))\.signature\[0\]\.options$/);
+            if (autocompleteMatch) {
+                const autocompleteCall = autocompleteMatch[1];
+                // Find callback props and propagate property accesses
+                for (const callbackProp of ['getOptionLabel', 'renderOption']) {
+                    const callbackPath = `${autocompleteCall}.signature[0].${callbackProp}`;
+                    const callbackEquivs = scopeNode.equivalencies[callbackPath];
+                    if (callbackEquivs) {
+                        for (const callbackEquiv of callbackEquivs) {
+                            const callbackMatch = callbackEquiv.schemaPath.match(/^(cyScope[0-9A-Fa-f]+)\(\)\.functionCallReturnValue$/);
+                            if (!callbackMatch)
+                                continue;
+                            const callbackScopeName = callbackMatch[1];
+                            const callbackScopeNode = scopeDataStructure.getScopeOrFunctionCallInfo(callbackScopeName);
+                            if (!callbackScopeNode)
+                                continue;
+                            // Determine which parameter index receives the option
+                            const paramIndex = callbackProp === 'renderOption' ? 1 : 0;
+                            // Propagate property accesses from this callback
+                            this.propagateAutocompletePropertyAccesses(callbackScopeNode, autocompleteCall, paramIndex, scopeNode.name, scopeDataStructure);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    toString() {
+        return 'MuiManager';
+    }
+}
+//# sourceMappingURL=MuiManager.js.map

package/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/MuiManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MuiManager.js","sourceRoot":"","sources":["../../../../../../../../../packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/MuiManager.ts"],"names":[],"mappings":"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"}

package/packages/ai/src/lib/dataStructure/equivalencyManagers/frameworks/ReactFrameworkManager.js

@@ -4,6 +4,12 @@ export class ReactFrameworkManager {
     constructor() {
         this.useStateInfos = [];
         this.useCallbackEquivalents = {};
+        // Track variables used as ref props - they should be typed as 'null'
+        // Format: { scopeNodeName -> Set of variable paths }
+        this.refVariables = new Map();
+        // Track ref variable source paths for updating external function call schemas in finalize
+        // Format: { functionCallName -> Set of source paths (e.g., 'useAutoAnimate().functionCallReturnValue[]') }
+        this.refVariableSources = new Map();
         this.internalFunctions = new Set([
             'useState',
             'useEffect',
@@ -92,7 +98,26 @@ export class ReactFrameworkManager {
         }
         return propagated;
     }
-    finalize(_scopeNode, _scopeDataStructure) { }
+    finalize(scopeNode, scopeDataStructure) {
+        // Set all tracked ref variables to 'null' type
+        // This ensures mock data generation uses null instead of placeholder strings
+        const refVarsForScope = this.refVariables.get(scopeNode.name);
+        if (refVarsForScope) {
+            for (const refVar of refVarsForScope) {
+                scopeNode.schema[refVar] = 'null';
+            }
+        }
+        // Update external function call schemas with ref source paths
+        // This runs AFTER schema building is complete, so the null values won't be overwritten
+        for (const efc of scopeDataStructure.externalFunctionCalls) {
+            const refSourcePaths = this.refVariableSources.get(efc.name);
+            if (refSourcePaths) {
+                for (const sourcePath of refSourcePaths) {
+                    efc.schema[sourcePath] = 'null';
+                }
+            }
+        }
+    }
     findUseStateInfo(useStateCall) {
         return this.useStateInfos.find((useStateInfo) => useStateInfo.useStateCall === useStateCall);
     }
@@ -337,6 +362,83 @@ export class ReactFrameworkManager {
             }
         }
         for (const [equivalentPath, equivalentValues] of Object.entries(scopeNode.equivalencies)) {
+            // Check if the equivalency KEY (e.g., "div().signature[0].ref") ends with .ref
+            // If so, the VALUE (e.g., "parent") should be marked as null
+            const equivalentPathParts = scopeDataStructure.splitPath(equivalentPath);
+            const pathLength = equivalentPathParts.length;
+            if (pathLength >= 2) {
+                const secondToLast = equivalentPathParts[pathLength - 2];
+                const last = equivalentPathParts[pathLength - 1];
+                if (secondToLast === 'signature[0]' && last === 'ref') {
+                    // This is a ref prop usage like div().signature[0].ref -> parent
+                    for (const equivalentValue of equivalentValues) {
+                        propagated = true;
+                        // Track this variable as a ref - we'll set its type to 'null' in finalize()
+                        // after the schema is built (setting directly here would be overwritten)
+                        // IMPORTANT: The ref variable might be defined in a parent scope, not the
+                        // current scope. We need to find where the variable is actually defined by
+                        // walking up the scope tree.
+                        const varName = equivalentValue.schemaPath;
+                        let targetScope = scopeNode;
+                        // Walk up the scope tree to find where this variable is defined
+                        while (targetScope) {
+                            // Check if this scope has the variable in its schema or equivalencies
+                            const hasVariable = varName in (targetScope.schema || {}) ||
+                                varName in (targetScope.equivalencies || {});
+                            if (hasVariable) {
+                                if (!this.refVariables.has(targetScope.name)) {
+                                    this.refVariables.set(targetScope.name, new Set());
+                                }
+                                this.refVariables.get(targetScope.name).add(varName);
+                                // IMPORTANT: Also update the source of the ref variable in the external
+                                // function call's schema. This ensures dataForMocks produces [null]
+                                // instead of ["string"] for hooks like useAutoAnimate.
+                                const varEquivalencies = targetScope.equivalencies?.[varName];
+                                if (varEquivalencies) {
+                                    for (const varEquivalency of varEquivalencies) {
+                                        const sourcePath = varEquivalency.schemaPath;
+                                        // Check if this comes from an external function call
+                                        // (contains functionCallReturnValue which indicates it's a hook/function return)
+                                        if (sourcePath.includes('functionCallReturnValue')) {
+                                            // Store the source path for later - we'll update the external function
+                                            // call's schema in finalize() which runs AFTER schema building is complete.
+                                            // Setting it here would be overwritten by later schema building.
+                                            for (const efc of scopeDataStructure.externalFunctionCalls) {
+                                                if (sourcePath.startsWith(efc.name)) {
+                                                    if (!this.refVariableSources.has(efc.name)) {
+                                                        this.refVariableSources.set(efc.name, new Set());
+                                                    }
+                                                    // Store both the specific indexed path and the generic [] path
+                                                    this.refVariableSources
+                                                        .get(efc.name)
+                                                        .add(sourcePath);
+                                                    const genericPath = sourcePath.replace(/\[\d+\]/g, '[]');
+                                                    if (genericPath !== sourcePath) {
+                                                        this.refVariableSources
+                                                            .get(efc.name)
+                                                            .add(genericPath);
+                                                    }
+                                                }
+                                            }
+                                        }
+                                    }
+                                }
+                            }
+                            // Move up to parent scope
+                            if (targetScope.tree && targetScope.tree.length > 0) {
+                                const parentScopeName = targetScope.tree[targetScope.tree.length - 1];
+                                targetScope = scopeDataStructure.getScopeOrFunctionCallInfo(parentScopeName);
+                            }
+                            else {
+                                targetScope = null;
+                            }
+                        }
+                        scopeDataStructure.removeEquivalency(equivalentPath, equivalentValue, scopeNode);
+                    }
+                    continue;
+                }
+            }
+            // Original logic for checking the value side
             for (const equivalentValue of equivalentValues) {
                 const equivalentValueParts = scopeDataStructure.splitPath(equivalentValue.schemaPath);
                 for (let i = 0; i < equivalentValueParts.length; i++) {