@azure-tools/typespec-ts 0.31.0 → 0.32.0

package/CHANGELOG.md

@@ -1,16 +1,34 @@
+## 0.32.0 (2024-08-15)
+
+- [Feature] Remove internal RLC layer from modular. Please refer to [#2728](https://github.com/Azure/autorest.typescript/pull/2728).
+- [Feature] Upgrade TypeSpec compiler to 0.59. Please refer to [#2741](https://github.com/Azure/autorest.typescript/pull/2741).
+- [Feature] Fix some issues with API version handling in new getClient. Please refer to [#2738](https://github.com/Azure/autorest.typescript/pull/2738).
+- [Feature] Binder support external dependencies. Please refer to [#2728](https://github.com/Azure/autorest.typescript/pull/2728) and [#2716](https://github.com/Azure/autorest.typescript/pull/2716).
+- [Feature] Update the existing package.json to correct lro or paging dependencies. Please refer to [#2732](https://github.com/Azure/autorest.typescript/pull/2732).
+- [Feature] Engineering system related improvements.
+  - Upgrade dependency vitest version to ^2.0.5 in generated packages, please refer to [#2749](https://github.com/Azure/autorest.typescript/pull/2749);
+  - Use ESLint flat config files in generated package, please refer to [#2754](https://github.com/Azure/autorest.typescript/pull/2754);
+  - Upgrade tshy to v2, please refer to [#2751](https://github.com/Azure/autorest.typescript/pull/2751).
+- [Bugfix] Enable changelog pack for RLC and Modular. Please refer to [#2695](https://github.com/Azure/autorest.typescript/pull/2695).
+- [Bugfix] Disable sampleUrl generation if generateSample is false. Please refer to [#2713](https://github.com/Azure/autorest.typescript/pull/2713).
+- [Bugfix] Fix resolve conflicts bug. Please refer to [#2717](https://github.com/Azure/autorest.typescript/pull/2717).
+- [Bugfix] Fix client name issue in Modular. Please refer to [#2744](https://github.com/Azure/autorest.typescript/pull/2744).
+- [Bugfix] Set as azure scope if package is under azure-rest. Please refer to [#2756](https://github.com/Azure/autorest.typescript/pull/2756).
+- [Bugfix] Emit warnings for un-supported credential and filter out non-200 status code in response check. Please refer to [#2704](https://github.com/Azure/autorest.typescript/pull/2704).
+
 ## 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] 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).
+  - 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).

package/README.md

@@ -145,6 +145,14 @@ addCredentials: true
 credentialKeyHeaderName: Your-Subscription-Key
 ```
 
+### clearOutputFolder
+
+If we enable this option `clearOutputFolder` we would empty the whole output folder. By default we only empty the sources folder which means any metadata files will not be removed if it is at project root. This would be useful in pipeline.
+
+```yaml
+clearOutputFolder: true
+```
+
 # Contributing
 
 If you want to contribute on this project read the [contrubuting document](./CONTRIBUTING.md) for more details.

package/dist/src/contextManager.d.ts

@@ -4,6 +4,7 @@ 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";
+import { ExternalDependencies } from "./framework/dependency.js";
 /**
  * Contexts Object Guidelines
  * --------------------------
@@ -28,6 +29,7 @@ type Contexts = {
         tcgcContext: SdkContext;
     };
     binder: Binder;
+    dependencies: ExternalDependencies;
 };
 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;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"}
+{"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;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE;;;;;;;;;;;;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;IACf,YAAY,EAAE,oBAAoB,CAAC;CACpC,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":"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"}
+{"version":3,"file":"contextManager.js","sourceRoot":"","sources":["../../src/contextManager.ts"],"names":[],"mappings":"AAqCA;;;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/dependency.d.ts

@@ -0,0 +1,69 @@
+export interface ReferenceableSymbol {
+    kind: string;
+    name: string;
+    module: string;
+    visibility?: "internal" | "public";
+}
+export type ExternalDependencies = CoreDependencies & Record<string, ReferenceableSymbol>;
+/**
+ * This interface defines the well known Core dependencies that plugins can use to override and provide their own implementations if needed
+ */
+export interface CoreDependencies extends Record<string, ReferenceableSymbol> {
+    Client: {
+        kind: "externalDependency";
+        name: "Client";
+        module: string;
+    };
+    ClientOptions: {
+        kind: "externalDependency";
+        name: "ClientOptions";
+        module: string;
+    };
+    Pipeline: {
+        kind: "externalDependency";
+        name: "Pipeline";
+        module: string;
+    };
+    getClient: {
+        kind: "externalDependency";
+        name: "getClient";
+        module: string;
+    };
+    RestError: {
+        kind: "externalDependency";
+        name: "RestError";
+        module: string;
+    };
+    OperationOptions: {
+        kind: "externalDependency";
+        name: "OperationOptions";
+        module: string;
+    };
+    PathUncheckedResponse: {
+        kind: "externalDependency";
+        name: "PathUncheckedResponse";
+        module: string;
+    };
+    AbortSignalLike: {
+        kind: "externalDependency";
+        name: "AbortSignalLike";
+        module: string;
+    };
+    createRestError: {
+        kind: "externalDependency";
+        name: "createRestError";
+        module: string;
+    };
+    operationOptionsToRequestParameters: {
+        kind: "externalDependency";
+        name: "operationOptionsToRequestParameters";
+        module: string;
+    };
+    uint8ArrayToString: {
+        kind: "externalDependency";
+        name: "uint8ArrayToString";
+        module: string;
+    };
+}
+export type CoreDependency = keyof CoreDependencies;
+//# sourceMappingURL=dependency.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dependency.d.ts","sourceRoot":"","sources":["../../../src/framework/dependency.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;CACpC;AAED,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GACjD,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAC3E,MAAM,EAAE;QAAE,IAAI,EAAE,oBAAoB,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,aAAa,EAAE;QACb,IAAI,EAAE,oBAAoB,CAAC;QAC3B,IAAI,EAAE,eAAe,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,QAAQ,EAAE;QAAE,IAAI,EAAE,oBAAoB,CAAC;QAAC,IAAI,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,SAAS,EAAE;QAAE,IAAI,EAAE,oBAAoB,CAAC;QAAC,IAAI,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7E,SAAS,EAAE;QAAE,IAAI,EAAE,oBAAoB,CAAC;QAAC,IAAI,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7E,gBAAgB,EAAE;QAChB,IAAI,EAAE,oBAAoB,CAAC;QAC3B,IAAI,EAAE,kBAAkB,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,qBAAqB,EAAE;QACrB,IAAI,EAAE,oBAAoB,CAAC;QAC3B,IAAI,EAAE,uBAAuB,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,eAAe,EAAE;QACf,IAAI,EAAE,oBAAoB,CAAC;QAC3B,IAAI,EAAE,iBAAiB,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,eAAe,EAAE;QACf,IAAI,EAAE,oBAAoB,CAAC;QAC3B,IAAI,EAAE,iBAAiB,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,mCAAmC,EAAE;QACnC,IAAI,EAAE,oBAAoB,CAAC;QAC3B,IAAI,EAAE,qCAAqC,CAAC;QAC5C,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,kBAAkB,EAAE;QAClB,IAAI,EAAE,oBAAoB,CAAC;QAC3B,IAAI,EAAE,oBAAoB,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,gBAAgB,CAAC"}

package/dist/src/framework/dependency.js

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

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

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

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

@@ -1,9 +1,15 @@
 import { SourceFile, Project } from "ts-morph";
+import { ReferenceableSymbol } from "../dependency.js";
+import { StaticHelperMetadata } from "../load-static-helpers.js";
 export interface DeclarationInfo {
     name: string;
     sourceFile: SourceFile;
     alias?: string;
 }
+export interface BinderOptions {
+    staticHelpers?: Map<string, StaticHelperMetadata>;
+    dependencies?: Record<string, ReferenceableSymbol>;
+}
 export interface Binder {
     /**
      * Tracks a new declaration.
@@ -14,9 +20,9 @@ export interface Binder {
      */
     trackDeclaration(refkey: unknown, name: string, sourceFile: SourceFile): string;
     resolveReference(refkey: unknown): string;
-    applyImports(): void;
+    resolveAllReferences(): void;
 }
-export declare function provideBinder(project?: Project): void;
+export declare function provideBinder(project: Project, options?: BinderOptions): Binder;
 /**
  * Hook to use the binder context.
  * @returns The binder instance.

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

@@ -1 +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"}
+{"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;AAElB,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EAGL,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CACpD;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,oBAAoB,IAAI,IAAI,CAAC;CAC9B;AAwRD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC"}

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

@@ -1,11 +1,20 @@
-import { StructureKind, Project } from "ts-morph";
+import { StructureKind } from "ts-morph";
 import { provideContext, useContext } from "../../contextManager.js";
+import { provideDependencies, useDependencies } from "./useDependencies.js";
+import { refkey } from "../refkey.js";
+import { isStaticHelperMetadata, SourceFileSymbol } from "../load-static-helpers.js";
+const PLACEHOLDER_PREFIX = "_PLACEHOLDER_";
 class BinderImp {
-    constructor(project) {
+    constructor(project, options = {}) {
+        var _a;
         this.declarations = new Map();
+        this.references = new Map();
         this.imports = new Map();
         this.symbolsBySourceFile = new Map();
-        this.project = project !== null && project !== void 0 ? project : new Project();
+        this.project = project;
+        provideDependencies(options.dependencies);
+        this.staticHelpers = (_a = options.staticHelpers) !== null && _a !== void 0 ? _a : new Map();
+        this.dependencies = useDependencies();
     }
     trackDeclaration(refkey, name, sourceFile) {
         const uniqueName = this.generateLocallyUniqueDeclarationName(name, sourceFile);
@@ -75,7 +84,7 @@ class BinderImp {
      * @returns The serialized placeholder string.
      */
     serializePlaceholder(refkey) {
-        return `PLACEHOLDER:${String(refkey)}`;
+        return `${PLACEHOLDER_PREFIX}${String(refkey)}_`;
     }
     /**
      * Adds an import declaration to a source file.
@@ -86,13 +95,20 @@ class BinderImp {
      */
     addImport(fileWhereImportIsAdded, fileWhereImportPointsTo, name) {
         const importAlias = this.generateLocallyUniqueImportName(name, fileWhereImportIsAdded);
-        const relativePath = fileWhereImportIsAdded.getRelativePathAsModuleSpecifierTo(fileWhereImportPointsTo);
+        let moduleSpecifier = "";
+        if (typeof fileWhereImportPointsTo === "string") {
+            moduleSpecifier = fileWhereImportPointsTo;
+        }
+        else {
+            moduleSpecifier =
+                fileWhereImportIsAdded.getRelativePathAsModuleSpecifierTo(fileWhereImportPointsTo) + ".js";
+        }
         const importStructures = this.imports.get(fileWhereImportIsAdded) || [];
-        let importStructure = importStructures.find((imp) => imp.moduleSpecifier === relativePath);
+        let importStructure = importStructures.find((imp) => imp.moduleSpecifier === moduleSpecifier);
         if (!importStructure) {
             importStructure = {
                 kind: StructureKind.ImportDeclaration,
-                moduleSpecifier: relativePath,
+                moduleSpecifier,
                 namedImports: []
             };
             importStructures.push(importStructure);
@@ -114,29 +130,94 @@ class BinderImp {
     /**
      * Applies all tracked imports to their respective source files.
      */
-    applyImports() {
-        var _a;
+    resolveAllReferences() {
         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);
-            }
+            this.resolveDeclarationReferences(file);
+            this.resolveDependencyReferences(file);
         }
         for (const [sourceFile, importStructures] of this.imports) {
             for (const importStructure of importStructures) {
                 sourceFile.addImportDeclaration(importStructure);
             }
         }
+        this.cleanUnreferencedHelpers();
+    }
+    resolveDependencyReferences(file) {
+        var _a;
+        if (!hasAnyPlaceholders(file)) {
+            return;
+        }
+        for (const dependency of Object.values(this.dependencies)) {
+            const placeholder = this.serializePlaceholder(refkey(dependency));
+            const { name, module } = dependency;
+            const occurences = countPlaceholderOccurrences(file, placeholder);
+            if (occurences > 0) {
+                const importDec = this.addImport(file, module, name);
+                const uniqueName = (_a = importDec.alias) !== null && _a !== void 0 ? _a : name;
+                replacePlaceholder(file, placeholder, uniqueName);
+            }
+        }
+    }
+    resolveDeclarationReferences(file) {
+        var _a;
+        if (!hasAnyPlaceholders(file)) {
+            return;
+        }
+        for (const [declarationKey, declaration] of [
+            ...this.declarations,
+            ...this.staticHelpers
+        ]) {
+            const placeholderKey = this.serializePlaceholder(declarationKey);
+            if (isStaticHelperMetadata(declaration) &&
+                !countPlaceholderOccurrences(file, placeholderKey)) {
+                continue;
+            }
+            let name = declaration.name;
+            let declarationSourceFile;
+            if ("sourceFile" in declaration) {
+                declarationSourceFile = declaration.sourceFile;
+            }
+            else {
+                declarationSourceFile = declaration[SourceFileSymbol];
+            }
+            if (file !== declarationSourceFile) {
+                this.trackReference(declarationKey, file);
+                const importDec = this.addImport(file, declarationSourceFile, name);
+                name = (_a = importDec.alias) !== null && _a !== void 0 ? _a : name;
+            }
+            replacePlaceholder(file, placeholderKey, name);
+        }
+    }
+    trackReference(refkey, sourceFile) {
+        if (!this.references.has(refkey)) {
+            this.references.set(refkey, new Set());
+        }
+        this.references.get(refkey).add(sourceFile);
+    }
+    cleanUnreferencedHelpers() {
+        const usedHelperFiles = new Set();
+        for (const helper of this.staticHelpers.values()) {
+            const sourceFile = helper[SourceFileSymbol];
+            if (!sourceFile) {
+                // This should be unreachable
+                throw new Error(`Static helper ${helper.name} does not have a source file. Make sure that loadStaticHelpers has been correctly initialized in index.ts`);
+            }
+            const referencedHelper = this.references.get(refkey(helper));
+            if (referencedHelper === null || referencedHelper === void 0 ? void 0 : referencedHelper.size) {
+                usedHelperFiles.add(sourceFile);
+            }
+        }
+        this.project
+            .getSourceFiles("**/static-helpers/**/*.ts")
+            .filter((helperFile) => !usedHelperFiles.has(helperFile))
+            .forEach((helperFile) => helperFile.delete());
     }
 }
 // Provide the binder context to be used globally
-export function provideBinder(project) {
-    return provideContext("binder", new BinderImp(project));
+export function provideBinder(project, options = {}) {
+    const binder = new BinderImp(project, options);
+    provideContext("binder", binder);
+    return binder;
 }
 /**
  * Hook to use the binder context.
@@ -157,6 +238,9 @@ function replacePlaceholder(sourceFile, placeholder, value) {
     const updatedText = fileText.replace(regex, value);
     sourceFile.replaceWithText(updatedText);
 }
+function countPlaceholderOccurrences(sourceFile, placeholder) {
+    return sourceFile.getFullText().split(placeholder).length - 1;
+}
 /**
  * Escapes special characters in a string to be used in a regular expression.
  * @param string - The input string.
@@ -165,4 +249,7 @@ function replacePlaceholder(sourceFile, placeholder, value) {
 function escapeRegExp(string) {
     return string.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
+function hasAnyPlaceholders(sourceFile) {
+    return sourceFile.getFullText().includes(PLACEHOLDER_PREFIX);
+}
 //# sourceMappingURL=binder.js.map

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

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

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

@@ -0,0 +1,4 @@
+import { ExternalDependencies } from "../dependency.js";
+export declare function provideDependencies(customDependencies?: Partial<ExternalDependencies>): void;
+export declare function useDependencies(): ExternalDependencies;
+//# sourceMappingURL=useDependencies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDependencies.d.ts","sourceRoot":"","sources":["../../../../src/framework/hooks/useDependencies.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,wBAAgB,mBAAmB,CACjC,kBAAkB,GAAE,OAAO,CAAC,oBAAoB,CAAM,QAQvD;AAED,wBAAgB,eAAe,IAAI,oBAAoB,CAEtD"}

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

@@ -0,0 +1,13 @@
+import { provideContext, useContext } from "../../contextManager.js";
+import { DefaultCoreDependencies } from "../../modular/external-dependencies.js";
+export function provideDependencies(customDependencies = {}) {
+    const dependencies = {
+        ...DefaultCoreDependencies,
+        ...customDependencies
+    };
+    provideContext("dependencies", dependencies);
+}
+export function useDependencies() {
+    return useContext("dependencies");
+}
+//# sourceMappingURL=useDependencies.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDependencies.js","sourceRoot":"","sources":["../../../../src/framework/hooks/useDependencies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAGjF,MAAM,UAAU,mBAAmB,CACjC,qBAAoD,EAAE;IAEtD,MAAM,YAAY,GAAG;QACnB,GAAG,uBAAuB;QAC1B,GAAG,kBAAkB;KACE,CAAC;IAE1B,cAAc,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,CAAC,cAAc,CAAC,CAAC;AACpC,CAAC"}

package/dist/src/framework/load-static-helpers.d.ts

@@ -0,0 +1,16 @@
+import { Project, SourceFile } from "ts-morph";
+export declare const SourceFileSymbol: unique symbol;
+export interface StaticHelperMetadata {
+    name: string;
+    kind: "function" | "interface" | "typeAlias" | "class";
+    location: string;
+    [SourceFileSymbol]?: SourceFile;
+}
+export declare function isStaticHelperMetadata(metadata: any): metadata is StaticHelperMetadata;
+export type StaticHelpers = Record<string, StaticHelperMetadata>;
+export interface LoadStaticHelpersOptions {
+    helpersAssetDirectory?: string;
+    sourcesDir?: string;
+}
+export declare function loadStaticHelpers(project: Project, helpers: StaticHelpers, options?: LoadStaticHelpersOptions): Promise<Map<string, StaticHelperMetadata>>;
+//# sourceMappingURL=load-static-helpers.d.ts.map

package/dist/src/framework/load-static-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-static-helpers.d.ts","sourceRoot":"","sources":["../../../src/framework/load-static-helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,OAAO,EACP,UAAU,EAEX,MAAM,UAAU,CAAC;AAGlB,eAAO,MAAM,gBAAgB,eAAuB,CAAC;AACrD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,CAAC,gBAAgB,CAAC,CAAC,EAAE,UAAU,CAAC;CACjC;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,GAAG,GACZ,QAAQ,IAAI,oBAAoB,CAQlC;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAIjE,MAAM,WAAW,wBAAwB;IACvC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAsC5C"}

package/dist/src/framework/load-static-helpers.js

@@ -0,0 +1,93 @@
+import { readdir, stat, readFile } from "fs/promises";
+import * as path from "path";
+import { refkey } from "./refkey.js";
+import { resolveProjectRoot } from "../utils/resolve-project-root.js";
+export const SourceFileSymbol = Symbol("SourceFile");
+export function isStaticHelperMetadata(metadata) {
+    return Boolean(metadata &&
+        metadata.name &&
+        metadata.kind &&
+        metadata.location &&
+        metadata[SourceFileSymbol]);
+}
+const DEFAULT_STATIC_HELPERS_PATH = "static/static-helpers";
+export async function loadStaticHelpers(project, helpers, options = {}) {
+    var _a, _b;
+    const sourcesDir = (_a = options.sourcesDir) !== null && _a !== void 0 ? _a : "";
+    const helpersMap = new Map();
+    const defaultStaticHelpersPath = path.join(resolveProjectRoot(), DEFAULT_STATIC_HELPERS_PATH);
+    const files = await traverseDirectory((_b = options.helpersAssetDirectory) !== null && _b !== void 0 ? _b : defaultStaticHelpersPath);
+    for (const file of files) {
+        const targetPath = path.join(sourcesDir, file.target);
+        const contents = await readFile(file.source, "utf-8");
+        const addedFile = project.createSourceFile(targetPath, contents, {
+            overwrite: true
+        });
+        for (const entry of Object.values(helpers)) {
+            if (!addedFile.getFilePath().endsWith(entry.location)) {
+                continue;
+            }
+            const declaration = getDeclarationByMetadata(addedFile, entry);
+            if (!declaration) {
+                throw new Error(`Declaration ${entry.name} not found in file ${addedFile.getFilePath()}\n This is an Emitter bug, make sure that the map of static helpers passed to loadStaticHelpers matches what is in the file.`);
+            }
+            entry[SourceFileSymbol] = addedFile;
+            helpersMap.set(refkey(entry), entry);
+        }
+    }
+    return assertAllHelpersLoadedPresent(helpersMap);
+}
+function assertAllHelpersLoadedPresent(helpers) {
+    const missingHelpers = [];
+    for (const helper of helpers.values()) {
+        if (!helper[SourceFileSymbol]) {
+            missingHelpers.push(helper);
+        }
+    }
+    if (missingHelpers.length > 0) {
+        const missingHelpersString = missingHelpers
+            .map((helper) => `${helper.name} - ${helper.location}`)
+            .join("\n");
+        throw new Error(`The following helpers were not found in the project, make sure they are defined in the expected static helper file: ${missingHelpersString}`);
+    }
+    return helpers;
+}
+function getDeclarationByMetadata(file, declaration) {
+    switch (declaration.kind) {
+        case "class":
+            return file.getClass(declaration.name);
+        case "function":
+            return file.getFunction(declaration.name);
+        case "interface":
+            return file.getInterface(declaration.name);
+        case "typeAlias":
+            return file.getTypeAlias(declaration.name);
+        default:
+            throw new Error(`invalid helper kind ${declaration.kind}\nAll helpers provided to loadStaticHelpers are of kind: function, interface, typeAlias, class`);
+    }
+}
+const _targetStaticHelpersBaseDir = "static-helpers";
+async function traverseDirectory(directory, result = [], relativePath = "") {
+    try {
+        const files = await readdir(directory);
+        await Promise.all(files.map(async (file) => {
+            const filePath = path.join(directory, file);
+            const fileStat = await stat(filePath);
+            if (fileStat.isDirectory()) {
+                await traverseDirectory(filePath, result, path.join(relativePath, file));
+            }
+            else if (fileStat.isFile() &&
+                !file.endsWith(".d.ts") &&
+                file.endsWith(".ts")) {
+                const target = path.join(_targetStaticHelpersBaseDir, relativePath, file);
+                result.push({ source: filePath, target });
+            }
+        }));
+        return result;
+    }
+    catch (error) {
+        console.error(`Error traversing directory ${directory}:`, error);
+        throw error;
+    }
+}
+//# sourceMappingURL=load-static-helpers.js.map

package/dist/src/framework/load-static-helpers.js.map

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

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

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

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

@@ -1 +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"}
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../../src/framework/reference.ts"],"names":[],"mappings":"AAQA,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAgBxD"}

package/dist/src/framework/reference.js

@@ -1,8 +1,22 @@
 import { useBinder } from "./hooks/binder.js";
-import { refkey as getRefKey } from "./refkey.js";
+import { refkey as getRefkey } from "./refkey.js";
+import { SourceFileSymbol } from "./load-static-helpers.js";
 export function resolveReference(refkey) {
     const binder = useBinder();
-    const stringRefkey = typeof refkey === "string" ? refkey : getRefKey(refkey);
+    let key = refkey;
+    if (isReferenceableSymbol(key)) {
+        key = getRefkey(key);
+    }
+    if (isStaticHelperMetadata(key)) {
+        key = getRefkey(key);
+    }
+    const stringRefkey = typeof key === "string" ? key : getRefkey(key);
     return binder.resolveReference(stringRefkey);
 }
+function isReferenceableSymbol(obj) {
+    return (obj === null || obj === void 0 ? void 0 : obj.kind) === "externalDependency";
+}
+function isStaticHelperMetadata(obj) {
+    return Boolean(obj[SourceFileSymbol]);
+}
 //# sourceMappingURL=reference.js.map

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

@@ -1 +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"}
+{"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,OAAO,EACL,gBAAgB,EAEjB,MAAM,0BAA0B,CAAC;AAElC,MAAM,UAAU,gBAAgB,CAAC,MAAe;IAC9C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,IAAI,GAAG,GAAG,MAAM,CAAC;IAEjB,IAAI,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,sBAAsB,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAEpE,OAAO,MAAM,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,qBAAqB,CAAC,GAAQ;IACrC,OAAO,CAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,IAAI,MAAK,oBAAoB,CAAC;AAC5C,CAAC;AAED,SAAS,sBAAsB,CAAC,GAAQ;IACtC,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC;AACxC,CAAC"}