@superblocksteam/vite-plugin-file-sync 1.99.99-next.2

package/dist/parsing/page.d.ts

@@ -0,0 +1,9 @@
+import type { ParseResult } from "@babel/parser";
+import type { File } from "@babel/types";
+import type { RootNode } from "@superblocksteam/library-shared";
+export declare function getPageRoots(fileName: string, file: {
+    code: string;
+    ast: ParseResult<File> | null;
+}): RootNode[];
+export declare function getPageName(file: File): string;
+//# sourceMappingURL=page.d.ts.map

package/dist/parsing/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/parsing/page.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAGhE,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IACJ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC/B,GACA,QAAQ,EAAE,CAkIZ;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CA6C9C"}

package/dist/parsing/page.js

@@ -0,0 +1,156 @@
+import { transformFromAstSync } from "@babel/core";
+import { parse } from "@babel/parser";
+import { traverse } from "../traverse.js";
+import { getErrorMeta, getLogger } from "../util/logger.js";
+import { getSbElementId, supplementElementIds } from "./ids.js";
+import { buildNodes, getDescriptiveName, getProperties, tagNameToWidgetType, } from "./jsx.js";
+import { getIdentiferName, getTagName, isScopeFunction, nodeToValue, } from "./util.js";
+export function getPageRoots(fileName, file) {
+    let ast;
+    let shouldModifyAst = true;
+    // if we are passing an ast in, we need to clone it so we do not mutate the original
+    if (file.ast) {
+        const clonedAst = transformFromAstSync(file.ast, undefined, { ast: true });
+        if (!clonedAst?.ast) {
+            throw new Error("Failed to clone AST for file " + fileName);
+        }
+        ast = clonedAst.ast;
+        shouldModifyAst = false;
+    }
+    else {
+        ast = parse(file.code, {
+            sourceType: "module",
+            sourceFilename: fileName,
+            plugins: ["jsx", "typescript"],
+        });
+    }
+    if (!ast) {
+        throw new Error("Failed to parse AST for file " + fileName);
+    }
+    try {
+        const roots = [];
+        const componentBindings = [];
+        supplementElementIds({ fileName, ast, shouldModifyAst });
+        const traverseOptions = {
+            JSXElement(path) {
+                const tagName = getTagName(path.node);
+                if (!tagName) {
+                    path.skip();
+                    return;
+                }
+                // TODO: do we have a better way of doing this?
+                const isPage = tagName === "SbPage";
+                const rootKind = isPage ? "page" : "component";
+                const rootName = isPage
+                    ? getPageName(ast)
+                    : getDescriptiveName(path.node);
+                if (!rootName) {
+                    path.skip();
+                    return;
+                }
+                const rootNode = {
+                    name: rootName,
+                    id: rootName,
+                    type: "RootNode",
+                    kind: rootKind,
+                    root: {
+                        type: "WidgetNode",
+                        name: rootName,
+                        id: getSbElementId(path.node.openingElement) ?? rootName,
+                        widgetType: tagNameToWidgetType(tagName),
+                        tagName,
+                        properties: getProperties(path),
+                        children: [],
+                    },
+                };
+                path.get("children").forEach((child) => {
+                    buildNodes(child, rootNode.root, { bindings: componentBindings });
+                });
+                roots.push(rootNode);
+                path.skip();
+            },
+        };
+        traverse(ast, {
+            Program: {
+                enter(path) {
+                    // We want to collect all of the function components that are defined on the page that return a
+                    // JSXElement that we've attached an SB id to, which lets us set references to them when we parse
+                    // a page
+                    Object.values(path.scope.getProgramParent().getAllBindingsOfKind("hoisted")).filter((binding) => {
+                        let isJSXComponent = false;
+                        binding.path.traverse({
+                            JSXElement(path) {
+                                if (!isJSXComponent) {
+                                    path.skip();
+                                    return;
+                                }
+                                const sbElementId = getSbElementId(path.node.openingElement);
+                                if (sbElementId) {
+                                    componentBindings.push({
+                                        binding,
+                                        sbElementId,
+                                    });
+                                    path.skip();
+                                }
+                            },
+                            ReturnStatement(path) {
+                                if (path.get("argument").isJSXElement()) {
+                                    isJSXComponent = true;
+                                }
+                            },
+                        });
+                        return isJSXComponent;
+                    });
+                },
+            },
+            ReturnStatement(path) {
+                if (path.get("argument").isJSXElement()) {
+                    path.traverse(traverseOptions);
+                    path.skip();
+                    return;
+                }
+            },
+        });
+        return roots;
+    }
+    catch (e) {
+        getLogger().error("Error parsing page", getErrorMeta(e));
+        return [];
+    }
+}
+export function getPageName(file) {
+    let pageName = "";
+    if (!file) {
+        return "";
+    }
+    const traverseFn = traverse.default || traverse;
+    traverseFn(file, {
+        CallExpression(path) {
+            if (path.node.callee.type === "Identifier" &&
+                isScopeFunction(path.node.callee.name)) {
+                const nodeArguments = path.node.arguments;
+                if (nodeArguments.length > 1 &&
+                    nodeArguments[1]?.type === "ObjectExpression") {
+                    const object = nodeArguments[1];
+                    const name = object.properties.find((property) => property.type === "ObjectProperty" &&
+                        getIdentiferName(property.key) === "name" &&
+                        property.value.type === "StringLiteral");
+                    if (name) {
+                        pageName = nodeToValue(name.value);
+                    }
+                }
+                return;
+            }
+        },
+        // Legacy, name=PageName attribute
+        JSXElement(path) {
+            const tagName = getTagName(path.node);
+            if (tagName !== "SbPage") {
+                return;
+            }
+            pageName = getDescriptiveName(path.node) ?? "";
+        },
+    });
+    return pageName;
+}
+//# sourceMappingURL=page.js.map

package/dist/parsing/page.js.map

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

package/dist/parsing/properties.d.ts

@@ -0,0 +1,5 @@
+import type { NodePath } from "@babel/traverse";
+import type t from "@babel/types";
+import type { PropertyInfo } from "@superblocksteam/library-shared";
+export declare function parseNodeProperties(node: NodePath<t.Node>): PropertyInfo<unknown> | null;
+//# sourceMappingURL=properties.d.ts.map

package/dist/parsing/properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../src/parsing/properties.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GACrB,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAoG9B"}

package/dist/parsing/properties.js

@@ -0,0 +1,89 @@
+import { Property } from "@superblocksteam/library-shared";
+import { getErrorMeta, getLogger } from "../util/logger.js";
+import { isDimNode, isSbComputedNode, isSbEventFlowNode, isSbTemplateNode, isSBTemplateNode, } from "./jsx-utils.js";
+import { parsingRegistry } from "./type-parsing-registry.js";
+import { getFunctionExpressionBody } from "./util.js";
+import { getTemplateString, nodeToValue, getIdentiferName } from "./util.js";
+export function parseNodeProperties(node) {
+    const logger = getLogger();
+    const expression = node.isJSXExpressionContainer()
+        ? node.get("expression")
+        : node;
+    if (isSbTemplateNode(expression)) {
+        const templateString = parsingRegistry.TEMPLATE.toValue(expression);
+        return templateString != null ? Property.Template(templateString) : null;
+    }
+    if (isSbComputedNode(expression)) {
+        const computedBody = parsingRegistry.COMPUTED.toValue(expression);
+        return Property.Computed(computedBody);
+    }
+    if (isSbEventFlowNode(expression)) {
+        const event = parsingRegistry.EVENT.toValue(expression);
+        return event ? Property.Event(event) : null;
+    }
+    if (isDimNode(expression)) {
+        const dimension = parsingRegistry.DIMENSION.toValue(expression);
+        return dimension ? Property.Dimension(dimension) : null;
+    }
+    if (expression.isStringLiteral() || expression.isNumericLiteral()) {
+        return Property.Static(expression.node.value);
+    }
+    if (isSBTemplateNode(expression)) {
+        const quasi = expression.get("quasi");
+        const templateString = getTemplateString(quasi.node);
+        return templateString ? Property.Binding(templateString) : null;
+    }
+    if (expression.isCallExpression()) {
+        return Property.Computed(expression.toString());
+    }
+    // We make an exception for arrow functions that return a template, because we want these to show
+    // up as strings in the UI
+    if (expression.isTemplateLiteral() ||
+        (expression.isArrowFunctionExpression() &&
+            expression.get("body").isTemplateLiteral())) {
+        const body = expression.isTemplateLiteral()
+            ? expression
+            : expression.get("body");
+        const templateString = parsingRegistry.TEMPLATE.toValue(body);
+        if (templateString) {
+            return Property.Template(templateString);
+        }
+    }
+    // TODO: check that property type is not a function
+    if (expression.isArrowFunctionExpression() ||
+        expression.isFunctionExpression()) {
+        return Property.Computed(getFunctionExpressionBody(expression));
+    }
+    if (expression.isObjectExpression()) {
+        const parentObject = {};
+        expression.get("properties").forEach((property) => {
+            if (!property.isObjectProperty()) {
+                logger.warn(`We only support nested parsing of object properties: ${property.toString()}`);
+                return;
+            }
+            const key = getIdentiferName(property.get("key").node);
+            if (!key) {
+                logger.warn(`Could not get key for object property: ${property.toString()}`);
+                return;
+            }
+            const value = property.get("value");
+            const parsedValue = parseNodeProperties(value);
+            if (parsedValue) {
+                parentObject[key] = parsedValue;
+            }
+        });
+        return Property.Static(parentObject);
+    }
+    try {
+        const value = nodeToValue(expression.node);
+        if (value !== null || expression.node.type === "NullLiteral") {
+            return Property.Static(value);
+        }
+    }
+    catch (e) {
+        logger.error(`Error parsing expression: ${expression}`, getErrorMeta(e));
+    }
+    // we assume that anything that is not a static value is js code
+    return Property.Computed(expression.toString());
+}
+//# sourceMappingURL=properties.js.map

package/dist/parsing/properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties.js","sourceRoot":"","sources":["../../src/parsing/properties.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAK7E,MAAM,UAAU,mBAAmB,CACjC,IAAsB;IAEtB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,wBAAwB,EAAE;QAChD,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC;QACxB,CAAC,CAAC,IAAI,CAAC;IAET,IAAI,gBAAgB,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,MAAM,cAAc,GAAG,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACpE,OAAO,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3E,CAAC;IAED,IAAI,gBAAgB,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,MAAM,YAAY,GAAG,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAClE,OAAO,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxD,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,CAAC;IAED,IAAI,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,eAAe,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAChE,OAAO,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1D,CAAC;IAED,IAAI,UAAU,CAAC,eAAe,EAAE,IAAI,UAAU,CAAC,gBAAgB,EAAE,EAAE,CAAC;QAClE,OAAO,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,gBAAgB,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,cAAc,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrD,OAAO,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,CAAC;IAED,IAAI,UAAU,CAAC,gBAAgB,EAAE,EAAE,CAAC;QAClC,OAAO,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,iGAAiG;IACjG,0BAA0B;IAC1B,IACE,UAAU,CAAC,iBAAiB,EAAE;QAC9B,CAAC,UAAU,CAAC,yBAAyB,EAAE;YACrC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,iBAAiB,EAAE,CAAC,EAC7C,CAAC;QACD,MAAM,IAAI,GAAG,UAAU,CAAC,iBAAiB,EAAE;YACzC,CAAC,CAAC,UAAU;YACZ,CAAC,CAAE,UAAU,CAAC,GAAG,CAAC,MAAM,CAAiC,CAAC;QAC5D,MAAM,cAAc,GAAG,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9D,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,IACE,UAAU,CAAC,yBAAyB,EAAE;QACtC,UAAU,CAAC,oBAAoB,EAAE,EACjC,CAAC;QACD,OAAO,QAAQ,CAAC,QAAQ,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,UAAU,CAAC,kBAAkB,EAAE,EAAE,CAAC;QACpC,MAAM,YAAY,GAA0C,EAAE,CAAC;QAC/D,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YAChD,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,EAAE,CAAC;gBACjC,MAAM,CAAC,IAAI,CACT,wDAAwD,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAC9E,CAAC;gBACF,OAAO;YACT,CAAC;YACD,MAAM,GAAG,GAAG,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAoB,CAAC,CAAC;YACvE,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,CAAC,IAAI,CACT,0CAA0C,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAChE,CAAC;gBACF,OAAO;YACT,CAAC;YACD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACpC,MAAM,WAAW,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAC/C,IAAI,WAAW,EAAE,CAAC;gBAChB,YAAY,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;YAClC,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,KAAK,KAAK,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAC7D,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,CAAC,KAAK,CAAC,6BAA6B,UAAU,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,gEAAgE;IAChE,OAAO,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;AAClD,CAAC"}

package/dist/parsing/scope.d.ts

@@ -0,0 +1,90 @@
+import { type PropertyInfo } from "@superblocksteam/library-shared";
+import { type Import } from "./imports.js";
+import type { ParseResult } from "@babel/parser";
+import type { NodePath } from "@babel/traverse";
+import type { CallExpression, File, FunctionExpression, JSXElement, Node, ObjectExpression, ObjectProperty, TSTypeLiteral, ArrowFunctionExpression, VariableDeclaration, ObjectPattern } from "@babel/types";
+import type { AnyStaticSbEntity, SbElement, StaticScope } from "@superblocksteam/library-shared/types";
+import type { SbEntity } from "@superblocksteam/library-shared/types";
+export declare function getScopeElementId(scopeId: string, name: string): SbElement;
+export type SbScopeDefinition = {
+    name: string;
+    id: string;
+    entityNames: string[];
+    mainNode: NodePath<CallExpression>;
+    scopeEntities: NodePath<ObjectExpression>;
+    scopeComponents: NodePath<TSTypeLiteral> | null;
+    scopeNameToEntityId: Record<string, SbElement>;
+    destructuredEntitiesParam: NodePath<ObjectPattern> | null;
+    scopeFunction: NodePath<ArrowFunctionExpression | FunctionExpression>;
+};
+export type FileScopeDefinition = {
+    entities: NodePath<ObjectExpression> | null;
+    options?: NodePath<ObjectExpression> | null;
+};
+export declare function updateEntityNode(node: NodePath<ObjectProperty>, updates: Record<string, PropertyInfo>, entityId?: SbElement): {
+    imports: Import[];
+};
+export declare function fromEntityToNode(entity: SbEntity): {
+    entity: ObjectProperty;
+    imports: Import[];
+};
+export declare function fromNodeToEntity(property: NodePath<ObjectProperty>, entityId?: SbElement): AnyStaticSbEntity | null;
+export declare function getScope(fileName: string, file?: {
+    ast: ParseResult<File> | null;
+    code: string;
+}): StaticScope | null;
+/**
+ * Builds a map of scope usages within files
+ * @param ast The AST to analyze
+ * @param filePath The path of the file being analyzed
+ * @param scopeDefinitions List of scope definitions (name and entities)
+ * @param scopeNameToScopeUsage Existing map to update (optional)
+ * @returns Updated map of scope usages
+ */
+export declare function buildScopeDestructuredUsageMap(ast: ParseResult<File>, filePath: string, scopeNames: Set<string>, scopeNameToScopeUsage?: Record<string, Record<string, NodePath<Node>[]>>): Record<string, Record<string, NodePath<Node>[]>>;
+/**
+ * Updates all scope usages to include the complete list of entity names
+ * @param scopeUsages Map of file paths to NodePaths where the scope is used
+ * @param entityNames Complete list of entity names to include in all usages
+ */
+export declare function updateScopeUsages(scopeUsages: Record<string, NodePath<Node>[]>, entityNames: string[]): void;
+/**
+ * Adds scope destructuring and imports to a component based on a JSX element locator
+ * @param elementPath Path to the JSX element that serves as the locator
+ * @param scopeDef Scope definition containing name, entities, and file path
+ * @param componentFilePath Path to the component file (for relative import calculation)
+ * @returns The newly created destructuring node path or null if failed
+ */
+export declare function addScopeToComponent({ elementLocation, scopeDefinition, }: {
+    elementLocation: NodePath<JSXElement>;
+    scopeDefinition: SbScopeDefinition;
+}): NodePath<VariableDeclaration> | null;
+export declare function isComponentAlreadyUsingScope(elementLocation: NodePath<JSXElement>, usagesInFile?: NodePath<Node>[]): boolean;
+export declare function parseSbScopeDefinition(ast: ParseResult<File>): SbScopeDefinition;
+export declare function findBindComponentsInScopeUsage(usage: NodePath<Node>): string[];
+/**
+ * Creates an empty scope definition with the given scope name.
+ * This generates a minimal scope with no entities or components and returns the parsed definition.
+ * Useful as a fallback when components are missing and need to be initialized.
+ *
+ * @param scopeName - The name of the scope (e.g., "Page1")
+ * @returns A parsed SbScopeDefinition with empty entities and components
+ */
+export declare function createEmptyScopeDefinition(scopeName: string): SbScopeDefinition;
+/**
+ * Adds type parameters to an existing createSbScope call if they don't exist.
+ * This function modifies the AST directly by adding a TypeScript type parameter
+ * to the createSbScope call expression.
+ *
+ * @param scopeDefinition - The scope definition containing the AST nodes
+ * @returns The scope definition with type parameters added (modifies the scope definition in place)
+ */
+export declare function addTypeParametersToScope(scopeDefinition: SbScopeDefinition): SbScopeDefinition;
+/**
+ * Utility to update the destructured entities parameter in function-based scopes
+ * Handles both cases:
+ * 1. ({ entities }) => ... (needs to add destructuring)
+ * 2. () => ... (needs to add entire parameter)
+ */
+export declare function updateDestructuredEntitiesParam(scopeDef: SbScopeDefinition): void;
+//# sourceMappingURL=scope.d.ts.map

package/dist/parsing/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/parsing/scope.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,iCAAiC,CAAC;AAOzC,OAAO,EAAqC,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAO9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EACV,cAAc,EAGd,IAAI,EACJ,kBAAkB,EAClB,UAAU,EACV,IAAI,EACJ,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,uBAAuB,EACvB,mBAAmB,EAKnB,aAAa,EACd,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EACV,iBAAiB,EACjB,SAAS,EACT,WAAW,EACZ,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AAEtE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAE1E;AA0BD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACnC,aAAa,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC1C,eAAe,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IAChD,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/C,yBAAyB,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IAC1D,aAAa,EAAE,QAAQ,CAAC,uBAAuB,GAAG,kBAAkB,CAAC,CAAC;CACvE,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;CAC7C,CAAC;AA6BF,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EACrC,QAAQ,CAAC,EAAE,SAAS,GACnB;IACD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CA8CA;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG;IAClD,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAmBA;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,EAClC,QAAQ,CAAC,EAAE,SAAS,GACnB,iBAAiB,GAAG,IAAI,CAQ1B;AAED,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;IACL,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd,GACA,WAAW,GAAG,IAAI,CA6CpB;AAGD;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,qBAAqB,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAM,GAC3E,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAmClD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAC7C,WAAW,EAAE,MAAM,EAAE,GACpB,IAAI,CA2BN;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,eAAe,EACf,eAAe,GAChB,EAAE;IACD,eAAe,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IACtC,eAAe,EAAE,iBAAiB,CAAC;CACpC,GAAG,QAAQ,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAOvC;AAgID,wBAAgB,4BAA4B,CAC1C,eAAe,EAAE,QAAQ,CAAC,UAAU,CAAC,EACrC,YAAY,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,GAC9B,OAAO,CAuCT;AAuBD,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,GACrB,iBAAiB,CA8NnB;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,GACpB,MAAM,EAAE,CAQV;AA0BD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,GAChB,iBAAiB,CAUnB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,iBAAiB,GACjC,iBAAiB,CAqBnB;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,iBAAiB,GAC1B,IAAI,CAuDN"}