@azure-tools/typespec-ts 0.30.1 → 0.31.0

package/CHANGELOG.md

@@ -1,3 +1,22 @@
+## 0.31.0 (2024-07-23)
+
+- [Feature] Set user agent prefix at different layer for modular. Please refer to [#2616](https://github.com/Azure/autorest.typescript/pull/2616).
+- [Feature] Spread is spread support. Please refer to [#2653](https://github.com/Azure/autorest.typescript/pull/2653).
+- [Feature] Upgrade TypeSpec compiler version to 0.58.x. Please refer to [#2679](https://github.com/Azure/autorest.typescript/pull/2679).
+- [Feature] Support Modular readme.md generation. Please refer to [#2655](https://github.com/Azure/autorest.typescript/pull/2655). 
+- [Feature] Engineering system related improvements.
+    - Bump typescript version to ~5.5.3, please refer to [#2646](https://github.com/Azure/autorest.typescript/pull/2646); 
+    - vitest timeout config, please refer to [#2632](https://github.com/Azure/autorest.typescript/pull/2632); 
+    - recorded client for esm package improve, please refer to [#2632](https://github.com/Azure/autorest.typescript/pull/2632);
+    - skip sample validation if generateSample is false, please refer to [#2650](https://github.com/Azure/autorest.typescript/pull/2650); 
+    - remove unused configuration files, please refer to [#2655](https://github.com/Azure/autorest.typescript/pull/2655); 
+    - add and refine document for generated code, please refer to [#2661](https://github.com/Azure/autorest.typescript/pull/2661) and [#2621](https://github.com/Azure/autorest.typescript/pull/2621).
+- [Bugfix] Fix the isUnexpected narrowing issue in Modular. Please refer to [#2654](https://github.com/Azure/autorest.typescript/pull/2654).
+- [Bugfix] Fix the extensible enum with null union generation failure in RLC. Please refer to [#2682](https://github.com/Azure/autorest.typescript/pull/2682).
+- [Bugfix] Remove hard code for lro in patch operation. Please refer to [#2583](https://github.com/Azure/autorest.typescript/pull/2583).
+- [Bugfix] Fix client option interface name inconsistent issue. Please refer to [#2671](https://github.com/Azure/autorest.typescript/pull/2671).
+- [Bugfix] Fix nullable dictionaries and array element nullable serialization issues. Please refer to [#2631](https://github.com/Azure/autorest.typescript/pull/2631) and [#2643](https://github.com/Azure/autorest.typescript/pull/2643).
+
 ## 0.30.1 (2024-06-29)
 
 - [Bugfix] Remove runtime references to @azure/core-util devDependency. Please refer to [#2634](https://github.com/Azure/autorest.typescript/pull/2634/files).

package/dist/src/contextManager.d.ts

@@ -2,6 +2,8 @@ import { Project, SourceFile } from "ts-morph";
 import { ModularMetaTree, RlcMetaTree } from "./metaTree.js";
 import { EmitContext } from "@typespec/compiler";
 import { SdkContext } from "@azure-tools/typespec-client-generator-core";
+import { SdkTypeContext } from "./framework/hooks/sdkTypes.js";
+import { Binder } from "./framework/hooks/binder.js";
 /**
  * Contexts Object Guidelines
  * --------------------------
@@ -20,10 +22,12 @@ type Contexts = {
     modularMetaTree: ModularMetaTree;
     outputProject: Project;
     symbolMap: Map<string, SourceFile>;
+    sdkTypes: SdkTypeContext;
     emitContext: {
         compilerContext: EmitContext;
         tcgcContext: SdkContext;
     };
+    binder: Binder;
 };
 type ContextKey = keyof Contexts;
 /**

package/dist/src/contextManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contextManager.d.ts","sourceRoot":"","sources":["../../src/contextManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,6CAA6C,CAAC;AAEzE;;;;;;;;;;;;GAYG;AACH,KAAK,QAAQ,GAAG;IACd,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,EAAE,eAAe,CAAC;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,WAAW,EAAE;QACX,eAAe,EAAE,WAAW,CAAC;QAC7B,WAAW,EAAE,UAAU,CAAC;KACzB,CAAC;CACH,CAAC;AAEF,KAAK,UAAU,GAAG,MAAM,QAAQ,CAAC;AAEjC;;;GAGG;AACH,cAAM,cAAc;IAClB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAmC;IAEnD,OAAO;IAEP;;;OAGG;WACW,WAAW,IAAI,cAAc;IAO3C;;;;OAIG;IACI,UAAU,CAAC,CAAC,SAAS,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IAIzE;;;;OAIG;IACI,UAAU,CAAC,CAAC,SAAS,UAAU,EAAE,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS;CAGzE;AAGD,eAAO,MAAM,cAAc,gBAA+B,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,UAAU,EAAE,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAMpE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,UAAU,EACjD,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GACjB,IAAI,CAEN"}
+{"version":3,"file":"contextManager.d.ts","sourceRoot":"","sources":["../../src/contextManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,6CAA6C,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,KAAK,QAAQ,GAAG;IACd,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,EAAE,eAAe,CAAC;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE;QACX,eAAe,EAAE,WAAW,CAAC;QAC7B,WAAW,EAAE,UAAU,CAAC;KACzB,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,KAAK,UAAU,GAAG,MAAM,QAAQ,CAAC;AAEjC;;;GAGG;AACH,cAAM,cAAc;IAClB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAmC;IAEnD,OAAO;IAEP;;;OAGG;WACW,WAAW,IAAI,cAAc;IAO3C;;;;OAIG;IACI,UAAU,CAAC,CAAC,SAAS,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IAIzE;;;;OAIG;IACI,UAAU,CAAC,CAAC,SAAS,UAAU,EAAE,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS;CAGzE;AAGD,eAAO,MAAM,cAAc,gBAA+B,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,UAAU,EAAE,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAMpE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,UAAU,EACjD,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GACjB,IAAI,CAEN"}

package/dist/src/contextManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"contextManager.js","sourceRoot":"","sources":["../../src/contextManager.ts"],"names":[],"mappings":"AA+BA;;;GAGG;AACH,MAAM,cAAc;IAIlB;QAFQ,aAAQ,GAAyB,IAAI,GAAG,EAAE,CAAC;IAE5B,CAAC;IAExB;;;OAGG;IACI,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;YAC7B,cAAc,CAAC,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;QACjD,CAAC;QACD,OAAO,cAAc,CAAC,QAAQ,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACI,UAAU,CAAuB,GAAM,EAAE,KAAkB;QAChE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACI,UAAU,CAAuB,GAAM;QAC5C,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAA4B,CAAC;IAC3D,CAAC;CACF;AAED,wDAAwD;AACxD,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAuB,GAAM;IACrD,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,YAAY,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAM,EACN,KAAkB;IAElB,cAAc,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AACxC,CAAC"}
+{"version":3,"file":"contextManager.js","sourceRoot":"","sources":["../../src/contextManager.ts"],"names":[],"mappings":"AAmCA;;;GAGG;AACH,MAAM,cAAc;IAIlB;QAFQ,aAAQ,GAAyB,IAAI,GAAG,EAAE,CAAC;IAE5B,CAAC;IAExB;;;OAGG;IACI,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;YAC7B,cAAc,CAAC,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;QACjD,CAAC;QACD,OAAO,cAAc,CAAC,QAAQ,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACI,UAAU,CAAuB,GAAM,EAAE,KAAkB;QAChE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACI,UAAU,CAAuB,GAAM;QAC5C,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAA4B,CAAC;IAC3D,CAAC;CACF;AAED,wDAAwD;AACxD,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAuB,GAAM;IACrD,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,YAAY,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAM,EACN,KAAkB;IAElB,cAAc,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AACxC,CAAC"}

package/dist/src/framework/declaration.d.ts

@@ -0,0 +1,9 @@
+import { SourceFile, ClassDeclarationStructure, EnumDeclarationStructure, FunctionDeclarationStructure, InterfaceDeclarationStructure, TypeAliasDeclarationStructure, ClassDeclaration, EnumDeclaration, FunctionDeclaration, InterfaceDeclaration, TypeAliasDeclaration } from "ts-morph";
+export type DeclarationStructures = ClassDeclarationStructure | EnumDeclarationStructure | FunctionDeclarationStructure | InterfaceDeclarationStructure | TypeAliasDeclarationStructure;
+export type Declarations = ClassDeclaration | EnumDeclaration | FunctionDeclaration | InterfaceDeclaration | TypeAliasDeclaration;
+export declare function addDeclaration(sourceFile: SourceFile, declaration: ClassDeclarationStructure, refkey: unknown): ClassDeclaration;
+export declare function addDeclaration(sourceFile: SourceFile, declaration: EnumDeclarationStructure, refkey: unknown): EnumDeclaration;
+export declare function addDeclaration(sourceFile: SourceFile, declaration: FunctionDeclarationStructure, refkey: unknown): FunctionDeclaration;
+export declare function addDeclaration(sourceFile: SourceFile, declaration: InterfaceDeclarationStructure, refkey: unknown): InterfaceDeclaration;
+export declare function addDeclaration(sourceFile: SourceFile, declaration: TypeAliasDeclarationStructure, refkey: unknown): TypeAliasDeclaration;
+//# sourceMappingURL=declaration.d.ts.map

package/dist/src/framework/declaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.d.ts","sourceRoot":"","sources":["../../../src/framework/declaration.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,EAC5B,6BAA6B,EAC7B,6BAA6B,EAE7B,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAGlB,MAAM,MAAM,qBAAqB,GAC7B,yBAAyB,GACzB,wBAAwB,GACxB,4BAA4B,GAC5B,6BAA6B,GAC7B,6BAA6B,CAAC;AAElC,MAAM,MAAM,YAAY,GACpB,gBAAgB,GAChB,eAAe,GACf,mBAAmB,GACnB,oBAAoB,GACpB,oBAAoB,CAAC;AAEzB,wBAAgB,cAAc,CAC5B,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,yBAAyB,EACtC,MAAM,EAAE,OAAO,GACd,gBAAgB,CAAC;AAEpB,wBAAgB,cAAc,CAC5B,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,wBAAwB,EACrC,MAAM,EAAE,OAAO,GACd,eAAe,CAAC;AAEnB,wBAAgB,cAAc,CAC5B,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,4BAA4B,EACzC,MAAM,EAAE,OAAO,GACd,mBAAmB,CAAC;AAEvB,wBAAgB,cAAc,CAC5B,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,6BAA6B,EAC1C,MAAM,EAAE,OAAO,GACd,oBAAoB,CAAC;AAExB,wBAAgB,cAAc,CAC5B,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,6BAA6B,EAC1C,MAAM,EAAE,OAAO,GACd,oBAAoB,CAAC"}

package/dist/src/framework/declaration.js

@@ -0,0 +1,28 @@
+import { StructureKind } from "ts-morph";
+import { useBinder } from "./hooks/binder.js";
+import { refkey as getRefKey } from "./refkey.js";
+export function addDeclaration(sourceFile, declaration, refkey) {
+    const binder = useBinder();
+    if (!declaration.name) {
+        throw new Error(`Declaration must have a name ${JSON.stringify(declaration)}`);
+    }
+    const stringRefkey = typeof refkey === "string" ? refkey : getRefKey(refkey);
+    const trackedDeclarationName = binder.trackDeclaration(stringRefkey, declaration.name, sourceFile);
+    // Update the declaration name to be unique
+    const trackedDeclaration = { ...declaration, name: trackedDeclarationName };
+    switch (trackedDeclaration.kind) {
+        case StructureKind.Class:
+            return sourceFile.addClass(trackedDeclaration);
+        case StructureKind.Enum:
+            return sourceFile.addEnum(trackedDeclaration);
+        case StructureKind.Function:
+            return sourceFile.addFunction(trackedDeclaration);
+        case StructureKind.Interface:
+            return sourceFile.addInterface(trackedDeclaration);
+        case StructureKind.TypeAlias:
+            return sourceFile.addTypeAlias(trackedDeclaration);
+        default:
+            throw new Error(`Unsupported declaration kind ${trackedDeclaration.kind}`);
+    }
+}
+//# sourceMappingURL=declaration.js.map

package/dist/src/framework/declaration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.js","sourceRoot":"","sources":["../../../src/framework/declaration.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,aAAa,EAMd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AA4ClD,MAAM,UAAU,cAAc,CAC5B,UAAsB,EACtB,WAAkC,EAClC,MAAe;IAEf,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,gCAAgC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAC9D,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAE7E,MAAM,sBAAsB,GAAG,MAAM,CAAC,gBAAgB,CACpD,YAAY,EACZ,WAAW,CAAC,IAAI,EAChB,UAAU,CACX,CAAC;IAEF,2CAA2C;IAC3C,MAAM,kBAAkB,GAAG,EAAE,GAAG,WAAW,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC;IAE5E,QAAQ,kBAAkB,CAAC,IAAI,EAAE,CAAC;QAChC,KAAK,aAAa,CAAC,KAAK;YACtB,OAAO,UAAU,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;QACjD,KAAK,aAAa,CAAC,IAAI;YACrB,OAAO,UAAU,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAChD,KAAK,aAAa,CAAC,QAAQ;YACzB,OAAO,UAAU,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;QACpD,KAAK,aAAa,CAAC,SAAS;YAC1B,OAAO,UAAU,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC;QACrD,KAAK,aAAa,CAAC,SAAS;YAC1B,OAAO,UAAU,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC;QACrD;YACE,MAAM,IAAI,KAAK,CACb,gCAAiC,kBAA0B,CAAC,IAAI,EAAE,CACnE,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/src/framework/hooks/binder.d.ts

@@ -0,0 +1,25 @@
+import { SourceFile, Project } from "ts-morph";
+export interface DeclarationInfo {
+    name: string;
+    sourceFile: SourceFile;
+    alias?: string;
+}
+export interface Binder {
+    /**
+     * Tracks a new declaration.
+     * @param refkey - A unique reference key for the declaration.
+     * @param name - The name of the declaration.
+     * @param sourceFile - The source file where the declaration is made.
+     * @returns The tracked declaration name.
+     */
+    trackDeclaration(refkey: unknown, name: string, sourceFile: SourceFile): string;
+    resolveReference(refkey: unknown): string;
+    applyImports(): void;
+}
+export declare function provideBinder(project?: Project): void;
+/**
+ * Hook to use the binder context.
+ * @returns The binder instance.
+ */
+export declare function useBinder(): Binder;
+//# sourceMappingURL=binder.d.ts.map

package/dist/src/framework/hooks/binder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binder.d.ts","sourceRoot":"","sources":["../../../../src/framework/hooks/binder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAIV,OAAO,EACR,MAAM,UAAU,CAAC;AAGlB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,MAAM;IACrB;;;;;;OAMG;IACH,gBAAgB,CACd,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,GACrB,MAAM,CAAC;IACV,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1C,YAAY,IAAI,IAAI,CAAC;CACtB;AAgMD,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAErD;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC"}

package/dist/src/framework/hooks/binder.js

@@ -0,0 +1,168 @@
+import { StructureKind, Project } from "ts-morph";
+import { provideContext, useContext } from "../../contextManager.js";
+class BinderImp {
+    constructor(project) {
+        this.declarations = new Map();
+        this.imports = new Map();
+        this.symbolsBySourceFile = new Map();
+        this.project = project !== null && project !== void 0 ? project : new Project();
+    }
+    trackDeclaration(refkey, name, sourceFile) {
+        const uniqueName = this.generateLocallyUniqueDeclarationName(name, sourceFile);
+        const declarationInfo = { name: uniqueName, sourceFile };
+        this.declarations.set(refkey, declarationInfo);
+        // Ensure symbolsBySourceFile has an entry for this sourceFile
+        if (!this.symbolsBySourceFile.has(sourceFile)) {
+            this.symbolsBySourceFile.set(sourceFile, new Set());
+        }
+        this.symbolsBySourceFile.get(sourceFile).add(uniqueName);
+        return uniqueName;
+    }
+    /**
+     * Generates a locally unique name for a declaration within a source file.
+     * @param name - The base name of the declaration.
+     * @param sourceFile - The source file where the declaration is made.
+     * @returns A unique name for the declaration within the file.
+     */
+    generateLocallyUniqueDeclarationName(name, sourceFile) {
+        var _a;
+        const existingNamesInFile = (_a = this.symbolsBySourceFile.get(sourceFile)) !== null && _a !== void 0 ? _a : new Set();
+        return this.generateLocallyUniqueName(name, existingNamesInFile);
+    }
+    /**
+     * Generates a locally unique name for an import within a source file.
+     * @param name - The base name of the import.
+     * @param sourceFile - The source file where the import is made.
+     * @returns A unique name for the import within the file.
+     */
+    generateLocallyUniqueImportName(name, sourceFile) {
+        var _a, _b;
+        const existingImports = ((_a = this.imports.get(sourceFile)) !== null && _a !== void 0 ? _a : [])
+            .flatMap((i) => i.namedImports)
+            .map((i) => { var _a; return (_a = i.alias) !== null && _a !== void 0 ? _a : i.name; });
+        const existingDeclarations = (_b = this.symbolsBySourceFile.get(sourceFile)) !== null && _b !== void 0 ? _b : new Set();
+        return this.generateLocallyUniqueName(name, new Set([...existingImports, ...existingDeclarations]));
+    }
+    /**
+     * Generates a locally unique name within a set of existing names.
+     * @param name - The base name.
+     * @param existingNames - A set of names already in use.
+     * @returns A unique name not present in the existing names set.
+     */
+    generateLocallyUniqueName(name, existingNames) {
+        let uniqueName = name;
+        let counter = 1;
+        while (existingNames.has(uniqueName)) {
+            uniqueName = `${name}_${counter}`;
+            counter++;
+        }
+        return uniqueName;
+    }
+    /**
+     * Resolves a reference to a declaration.
+     *  If a declaration is not ready yet, a placeholder is added to the source file.
+     *  Placeholders will be resolved when the imports are applied.
+     * @param refkey - The reference key for the declaration.
+     * @param currentSourceFile - The current source file where the reference is being resolved.
+     * @returns The declaration information if resolved, or a placeholder if not found.
+     */
+    resolveReference(refkey) {
+        return this.serializePlaceholder(refkey);
+    }
+    /**
+     * Serializes a placeholder reference key to a string.
+     * @param refkey - The reference key.
+     * @returns The serialized placeholder string.
+     */
+    serializePlaceholder(refkey) {
+        return `PLACEHOLDER:${String(refkey)}`;
+    }
+    /**
+     * Adds an import declaration to a source file.
+     * @param fileWhereImportIsAdded - The source file where the import is added.
+     * @param fileWhereImportPointsTo - The source file being imported.
+     * @param name - The name of the import.
+     * @returns The import specifier structure.
+     */
+    addImport(fileWhereImportIsAdded, fileWhereImportPointsTo, name) {
+        const importAlias = this.generateLocallyUniqueImportName(name, fileWhereImportIsAdded);
+        const relativePath = fileWhereImportIsAdded.getRelativePathAsModuleSpecifierTo(fileWhereImportPointsTo);
+        const importStructures = this.imports.get(fileWhereImportIsAdded) || [];
+        let importStructure = importStructures.find((imp) => imp.moduleSpecifier === relativePath);
+        if (!importStructure) {
+            importStructure = {
+                kind: StructureKind.ImportDeclaration,
+                moduleSpecifier: relativePath,
+                namedImports: []
+            };
+            importStructures.push(importStructure);
+        }
+        const namedImports = importStructure.namedImports;
+        let importSpecifier = namedImports.find((n) => n.name === importAlias);
+        if (!importSpecifier) {
+            importSpecifier = {
+                name: name,
+                alias: name === importAlias ? undefined : importAlias,
+                kind: StructureKind.ImportSpecifier
+            };
+            namedImports.push(importSpecifier);
+        }
+        importStructure.namedImports = namedImports;
+        this.imports.set(fileWhereImportIsAdded, importStructures);
+        return importSpecifier;
+    }
+    /**
+     * Applies all tracked imports to their respective source files.
+     */
+    applyImports() {
+        var _a;
+        for (const file of this.project.getSourceFiles()) {
+            for (const [declarationKey, declaration] of this.declarations) {
+                const placeholderKey = this.serializePlaceholder(declarationKey);
+                let name = declaration.name;
+                if (file !== declaration.sourceFile) {
+                    const importDec = this.addImport(file, declaration.sourceFile, declaration.name);
+                    name = (_a = importDec.alias) !== null && _a !== void 0 ? _a : declaration.name;
+                }
+                replacePlaceholder(file, placeholderKey, name);
+            }
+        }
+        for (const [sourceFile, importStructures] of this.imports) {
+            for (const importStructure of importStructures) {
+                sourceFile.addImportDeclaration(importStructure);
+            }
+        }
+    }
+}
+// Provide the binder context to be used globally
+export function provideBinder(project) {
+    return provideContext("binder", new BinderImp(project));
+}
+/**
+ * Hook to use the binder context.
+ * @returns The binder instance.
+ */
+export function useBinder() {
+    return useContext("binder");
+}
+/**
+ * Replaces all instances of a placeholder in a source file with a given value.
+ * @param sourceFile - The source file where the replacement occurs.
+ * @param placeholder - The placeholder string to replace.
+ * @param value - The value to replace the placeholder with.
+ */
+function replacePlaceholder(sourceFile, placeholder, value) {
+    const fileText = sourceFile.getFullText();
+    const regex = new RegExp(escapeRegExp(placeholder), "g");
+    const updatedText = fileText.replace(regex, value);
+    sourceFile.replaceWithText(updatedText);
+}
+/**
+ * Escapes special characters in a string to be used in a regular expression.
+ * @param string - The input string.
+ * @returns The escaped string.
+ */
+function escapeRegExp(string) {
+    return string.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=binder.js.map

package/dist/src/framework/hooks/binder.js.map

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

package/dist/src/framework/hooks/sdkTypes.d.ts

@@ -0,0 +1,12 @@
+import { SdkHttpOperation, SdkPackage, SdkServiceMethod, SdkType } from "@azure-tools/typespec-client-generator-core";
+import { Operation, Type } from "@typespec/compiler";
+export interface SdkTypeContext {
+    operations: Map<Type, SdkServiceMethod<SdkHttpOperation>>;
+    types: Map<Type, SdkType>;
+}
+export declare function useSdkTypes(): {
+    (type: Operation): SdkServiceMethod<SdkHttpOperation>;
+    (type: Type): SdkType;
+};
+export declare function provideSdkTypes(sdkPackage: SdkPackage<SdkHttpOperation>): void;
+//# sourceMappingURL=sdkTypes.d.ts.map

package/dist/src/framework/hooks/sdkTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdkTypes.d.ts","sourceRoot":"","sources":["../../../../src/framework/hooks/sdkTypes.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,OAAO,EAER,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAwB,MAAM,oBAAoB,CAAC;AAG3E,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,GAAG,CAAC,IAAI,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC1D,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;CAC3B;AAED,wBAAgB,WAAW;WAIC,SAAS,GAAG,gBAAgB,CAAC,gBAAgB,CAAC;WAC9C,IAAI,GAAG,OAAO;EA6BzC;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,gBAAgB,CAAC,QAiCvE"}

package/dist/src/framework/hooks/sdkTypes.js

@@ -0,0 +1,67 @@
+import { getClientType } from "@azure-tools/typespec-client-generator-core";
+import { getNamespaceFullName } from "@typespec/compiler";
+import { provideContext, useContext } from "../../contextManager.js";
+export function useSdkTypes() {
+    const sdkTypesContext = useContext("sdkTypes");
+    const { tcgcContext } = useContext("emitContext");
+    function getSdkType(type) {
+        var _a;
+        let sdkType;
+        if (type.kind === "Operation") {
+            sdkType = sdkTypesContext.operations.get(type);
+        }
+        else {
+            sdkType =
+                (_a = sdkTypesContext.types.get(type)) !== null && _a !== void 0 ? _a : getClientType(tcgcContext, type);
+        }
+        if (!sdkType) {
+            throw new Error(`SdkType not found for type: ${type.kind} ${"name" in type && typeof type.name == "string" ? type.name : ""} ${"namespace" in type && type.namespace
+                ? ` in ${getNamespaceFullName(type.namespace)}`
+                : ""}`);
+        }
+        return sdkType;
+    }
+    return getSdkType;
+}
+export function provideSdkTypes(sdkPackage) {
+    const sdkTypesContext = {
+        operations: new Map(),
+        types: new Map()
+    };
+    for (const sdkEnum of sdkPackage.enums) {
+        if (!sdkEnum.__raw) {
+            continue;
+        }
+        sdkTypesContext.types.set(sdkEnum.__raw, sdkEnum);
+    }
+    for (const sdkModel of sdkPackage.models) {
+        if (!sdkModel.__raw) {
+            continue;
+        }
+        sdkTypesContext.types.set(sdkModel.__raw, sdkModel);
+    }
+    for (const client of sdkPackage.clients) {
+        for (const method of getAllOperationsFromClient(client)) {
+            if (!method.__raw) {
+                continue;
+            }
+            sdkTypesContext.operations.set(method.__raw, method);
+        }
+    }
+    provideContext("sdkTypes", sdkTypesContext);
+}
+function getAllOperationsFromClient(client) {
+    const methodQueue = [...client.methods];
+    const operations = [];
+    while (methodQueue.length > 0) {
+        const method = methodQueue.pop();
+        if (method.kind === "clientaccessor") {
+            method.response.methods.forEach((m) => methodQueue.push(m));
+        }
+        else {
+            operations.push(method);
+        }
+    }
+    return operations;
+}
+//# sourceMappingURL=sdkTypes.js.map

package/dist/src/framework/hooks/sdkTypes.js.map

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

package/dist/src/framework/reference.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveReference(refkey: unknown): string | undefined;
+//# sourceMappingURL=reference.d.ts.map

package/dist/src/framework/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../../src/framework/reference.ts"],"names":[],"mappings":"AAGA,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAKpE"}

package/dist/src/framework/reference.js

@@ -0,0 +1,8 @@
+import { useBinder } from "./hooks/binder.js";
+import { refkey as getRefKey } from "./refkey.js";
+export function resolveReference(refkey) {
+    const binder = useBinder();
+    const stringRefkey = typeof refkey === "string" ? refkey : getRefKey(refkey);
+    return binder.resolveReference(stringRefkey);
+}
+//# sourceMappingURL=reference.js.map

package/dist/src/framework/reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.js","sourceRoot":"","sources":["../../../src/framework/reference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,UAAU,gBAAgB,CAAC,MAAe;IAC9C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,YAAY,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAE7E,OAAO,MAAM,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;AAC/C,CAAC"}

package/dist/src/framework/refkey.d.ts

@@ -0,0 +1,7 @@
+declare const RefkeySym: unique symbol;
+export type RefKey = string & {
+    [RefkeySym]: true;
+};
+export declare function refkey(...args: unknown[]): string;
+export {};
+//# sourceMappingURL=refkey.d.ts.map

package/dist/src/framework/refkey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refkey.d.ts","sourceRoot":"","sources":["../../../src/framework/refkey.ts"],"names":[],"mappings":"AAcA,OAAO,CAAC,MAAM,SAAS,EAAE,OAAO,MAAM,CAAC;AACvC,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG;IAAE,CAAC,SAAS,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAUpD,wBAAgB,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,UAExC"}

package/dist/src/framework/refkey.js

@@ -0,0 +1,22 @@
+const objectIds = new WeakMap();
+let objId = 0;
+function getObjectKey(value) {
+    if (objectIds.has(value)) {
+        return `${objectIds.get(value)}`;
+    }
+    const key = `o${objId++}`;
+    objectIds.set(value, key);
+    return key;
+}
+function getKey(value) {
+    if (typeof value === "object" && value !== null) {
+        return getObjectKey(value);
+    }
+    else {
+        return `s${String(value)}`;
+    }
+}
+export function refkey(...args) {
+    return args.map((v) => getKey(v)).join("\u2063");
+}
+//# sourceMappingURL=refkey.js.map

package/dist/src/framework/refkey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refkey.js","sourceRoot":"","sources":["../../../src/framework/refkey.ts"],"names":[],"mappings":"AAAA,MAAM,SAAS,GAAG,IAAI,OAAO,EAAmB,CAAC;AACjD,IAAI,KAAK,GAAG,CAAC,CAAC;AAEd,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;IACnC,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,EAAE,CAAC;IAC1B,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAE1B,OAAO,GAAG,CAAC;AACb,CAAC;AAKD,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,YAAY,CAAC,KAAK,CAAW,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,EAAY,CAAC;IACvC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAG,IAAe;IACvC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACnD,CAAC"}

package/dist/src/framework/sample.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sample.d.ts.map

package/dist/src/framework/sample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample.d.ts","sourceRoot":"","sources":["../../../src/framework/sample.ts"],"names":[],"mappings":""}

package/dist/src/framework/sample.js

@@ -0,0 +1,71 @@
+import { Project, StructureKind } from "ts-morph";
+import { useBinder } from "./hooks/binder.js";
+import { addDeclaration } from "./declaration.js";
+import { resolveReference } from "./reference.js";
+// Create a new ts-morph project
+const project = new Project();
+// Create a source file
+const sourceFile = project.createSourceFile("test.ts", "", { overwrite: true });
+// Initialize the binder
+const binder = useBinder();
+// Define an interface model. In practice this would be a type object (e.g. from TypeSpec, TCGC, modelerfour, etc.)
+// At this framework level, we're just using a simple object, there is no coupling with the actual type system, but this is flexible so any object can be used.
+const modelType = {
+    name: "MyInterface",
+    properties: [{ name: "id", type: "number" }]
+};
+// Define a function model
+const functionType = {
+    name: "MyFunction",
+    returnType: "void",
+    body: `console.log("Hello World");`
+};
+// Create an interface declaration structure. This illustrates a similar pattern to the one used in the emitter. Transorming a model into a structure for ts-morph.
+const interfaceDeclaration = {
+    kind: StructureKind.Interface,
+    name: modelType.name,
+    properties: modelType.properties.map((p) => ({
+        name: p.name,
+        type: p.type
+    }))
+};
+// Create a function declaration structure
+const functionDeclaration = {
+    kind: StructureKind.Function,
+    name: functionType.name,
+    returnType: functionType.returnType,
+    statements: functionType.body
+};
+// Helper functions to add the declarations to the source file. These are needed to be able to leverage the binder to track the declarations.
+// We'll be moving from sourceFile.addInterface(interfaceDeclaration) to addDeclaration(sourceFile, interfaceDeclaration, interfaceModel)
+addDeclaration(sourceFile, interfaceDeclaration, modelType);
+addDeclaration(sourceFile, functionDeclaration, functionType);
+// Create another source file
+const sourceFile2 = project.createSourceFile("test2.ts", "", {
+    overwrite: true
+});
+// Add statements referencing the tracked declarations
+const functionReference = resolveReference(functionType);
+const modelReference = resolveReference(modelType);
+sourceFile2.addStatements(`${functionReference}();`);
+sourceFile2.addStatements(`let obj: ${modelReference} = { id: 1 };`);
+// Apply imports to ensure correct references
+binder.applyImports();
+// Output the generated files
+console.log("// test.ts");
+console.log(sourceFile.getFullText());
+console.log("// test2.ts");
+console.log(sourceFile2.getFullText());
+// Output
+// test.ts
+// interface MyInterface {
+//     id: number;
+// }
+// function MyFunction(): void {
+//     console.log("Hello World");
+// }
+// // test2.ts
+// import { MyFunction, MyInterface } from "./test";
+// MyFunction();
+// let obj: MyInterface = { id: 1 };
+//# sourceMappingURL=sample.js.map

package/dist/src/framework/sample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample.js","sourceRoot":"","sources":["../../../src/framework/sample.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,aAAa,EAGd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,gCAAgC;AAChC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,uBAAuB;AACvB,MAAM,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAEhF,wBAAwB;AACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;AAE3B,mHAAmH;AACnH,+JAA+J;AAC/J,MAAM,SAAS,GAAG;IAChB,IAAI,EAAE,aAAa;IACnB,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;CAC7C,CAAC;AAEF,0BAA0B;AAC1B,MAAM,YAAY,GAAG;IACnB,IAAI,EAAE,YAAY;IAClB,UAAU,EAAE,MAAM;IAClB,IAAI,EAAE,6BAA6B;CACpC,CAAC;AAEF,mKAAmK;AACnK,MAAM,oBAAoB,GAAkC;IAC1D,IAAI,EAAE,aAAa,CAAC,SAAS;IAC7B,IAAI,EAAE,SAAS,CAAC,IAAI;IACpB,UAAU,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,CAAC,CAAC,IAAI;KACb,CAAC,CAAC;CACJ,CAAC;AAEF,0CAA0C;AAC1C,MAAM,mBAAmB,GAAiC;IACxD,IAAI,EAAE,aAAa,CAAC,QAAQ;IAC5B,IAAI,EAAE,YAAY,CAAC,IAAI;IACvB,UAAU,EAAE,YAAY,CAAC,UAAU;IACnC,UAAU,EAAE,YAAY,CAAC,IAAI;CAC9B,CAAC;AAEF,6IAA6I;AAC7I,yIAAyI;AACzI,cAAc,CAAC,UAAU,EAAE,oBAAoB,EAAE,SAAS,CAAC,CAAC;AAC5D,cAAc,CAAC,UAAU,EAAE,mBAAmB,EAAE,YAAY,CAAC,CAAC;AAE9D,6BAA6B;AAC7B,MAAM,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC,UAAU,EAAE,EAAE,EAAE;IAC3D,SAAS,EAAE,IAAI;CAChB,CAAC,CAAC;AAEH,sDAAsD;AACtD,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;AACzD,MAAM,cAAc,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;AAEnD,WAAW,CAAC,aAAa,CAAC,GAAG,iBAAiB,KAAK,CAAC,CAAC;AACrD,WAAW,CAAC,aAAa,CAAC,YAAY,cAAc,eAAe,CAAC,CAAC;AAErE,6CAA6C;AAC7C,MAAM,CAAC,YAAY,EAAE,CAAC;AAEtB,6BAA6B;AAC7B,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAC1B,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;AACtC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AAC3B,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;AAEvC,SAAS;AACT,UAAU;AACV,0BAA0B;AAC1B,kBAAkB;AAClB,IAAI;AAEJ,gCAAgC;AAChC,kCAAkC;AAClC,IAAI;AAEJ,cAAc;AACd,oDAAoD;AAEpD,gBAAgB;AAChB,oCAAoC"}

package/dist/src/framework/utils/tsmorph-helpers.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tsmorph-helpers.d.ts.map

package/dist/src/framework/utils/tsmorph-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsmorph-helpers.d.ts","sourceRoot":"","sources":["../../../../src/framework/utils/tsmorph-helpers.ts"],"names":[],"mappings":""}

package/dist/src/framework/utils/tsmorph-helpers.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tsmorph-helpers.js.map

package/dist/src/framework/utils/tsmorph-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsmorph-helpers.js","sourceRoot":"","sources":["../../../../src/framework/utils/tsmorph-helpers.ts"],"names":[],"mappings":""}

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAiCA,OAAO,EAAE,WAAW,EAAW,MAAM,oBAAoB,CAAC;AAkC1D,OAAO,EAAuB,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIxE,cAAc,UAAU,CAAC;AAEzB,wBAAsB,OAAO,CAAC,OAAO,EAAE,WAAW,iBAwQjD;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GACxC,UAAU,CAkBZ"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAiCA,OAAO,EAAE,WAAW,EAAW,MAAM,oBAAoB,CAAC;AAiC1D,OAAO,EAAuB,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAKxE,cAAc,UAAU,CAAC;AAEzB,wBAAsB,OAAO,CAAC,OAAO,EAAE,WAAW,iBAsQjD;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GACxC,UAAU,CAkBZ"}