@nestia/migrate 14.0.0 → 14.0.2

package/lib/programmers/NestiaMigrateApiStartProgrammer.js

@@ -7,11 +7,29 @@ const StatementFactory_1 = require("../factories/StatementFactory");
 const FilePrinter_1 = require("../utils/FilePrinter");
 const NestiaMigrateE2eFileProgrammer_1 = require("./NestiaMigrateE2eFileProgrammer");
 const NestiaMigrateImportProgrammer_1 = require("./NestiaMigrateImportProgrammer");
+/**
+ * Generates the `test/start.ts` of an SDK project: a small program that calls
+ * one API function.
+ *
+ * @evidence contracts/common.md#principled-implementation The program builds a connection from the global test settings and the first server of the document, adds the simulate flag when requested, and calls the first route the way the generated e2e tests do, so one command can check that the SDK and a server agree.
+ * @evidence contracts/common.md#clear-and-simple-design One entry function and private helpers for the connection, the main function, and the starter.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The route is the first one, so the same document always generates the same file.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 var NestiaMigrateApiStartProgrammer;
 (function (NestiaMigrateApiStartProgrammer) {
+    /**
+     * Returns the `test/start.ts` file of an SDK project.
+     *
+     * @evidence contracts/common.md#principled-implementation The file imports what the body uses, defines `main`, and starts it, exiting with a failure status when it rejects.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The content derives from the document.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     NestiaMigrateApiStartProgrammer.write = (context) => {
         const importer = new NestiaMigrateImportProgrammer_1.NestiaMigrateImportProgrammer();
-        const route = pick(context.application.routes);
+        // the first route, so the same document always generates the same file
+        const route = context.application.routes[0];
         const main = writeMain(context, importer, route);
         const statements = [
             ...importer.toStatements((name) => `@ORGANIZATION/PROJECT-api/lib/structures/${name}`),
@@ -75,11 +93,4 @@ var NestiaMigrateApiStartProgrammer;
         ], true)),
     ]);
 })(NestiaMigrateApiStartProgrammer || (exports.NestiaMigrateApiStartProgrammer = NestiaMigrateApiStartProgrammer = {}));
-const pick = (array) => {
-    if (array.length === 0)
-        return undefined;
-    const rand = Math.random() * array.length;
-    const index = Math.min(array.length - 1, Math.floor(rand));
-    return array[index];
-};
 //# sourceMappingURL=NestiaMigrateApiStartProgrammer.js.map

package/lib/programmers/NestiaMigrateApiStartProgrammer.js.map

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

package/lib/programmers/NestiaMigrateApiStartProgrammer.mjs

@@ -9,7 +9,7 @@ let NestiaMigrateApiStartProgrammer;
 (function(_NestiaMigrateApiStartProgrammer) {
 	_NestiaMigrateApiStartProgrammer.write = (context) => {
 		const importer = new NestiaMigrateImportProgrammer();
-		const route = pick(context.application.routes);
+		const route = context.application.routes[0];
 		const main = writeMain(context, importer, route);
 		const statements = [
 			...importer.toStatements((name) => `@ORGANIZATION/PROJECT-api/lib/structures/${name}`),
@@ -40,11 +40,6 @@ let NestiaMigrateApiStartProgrammer;
 	], true))], NodeFlags.Const));
 	const writeStarter = () => factory.createCallExpression(factory.createPropertyAccessExpression(factory.createCallExpression(factory.createIdentifier("main"), void 0, void 0), "catch"), void 0, [factory.createArrowFunction(void 0, void 0, [IdentifierFactory.parameter("exp")], void 0, void 0, factory.createBlock([factory.createExpressionStatement(factory.createCallExpression(factory.createPropertyAccessExpression(factory.createIdentifier("console"), "log"), void 0, [factory.createIdentifier("exp")])), factory.createExpressionStatement(factory.createCallExpression(factory.createPropertyAccessExpression(factory.createIdentifier("process"), "exit"), void 0, [factory.createPrefixMinus(factory.createNumericLiteral("1"))]))], true))]);
 })(NestiaMigrateApiStartProgrammer || (NestiaMigrateApiStartProgrammer = {}));
-const pick = (array) => {
-	if (array.length === 0) return void 0;
-	const rand = Math.random() * array.length;
-	return array[Math.min(array.length - 1, Math.floor(rand))];
-};
 //#endregion
 export { NestiaMigrateApiStartProgrammer };
 

package/lib/programmers/NestiaMigrateDtoProgrammer.d.ts

@@ -2,14 +2,44 @@ import { OpenApi } from "@typia/interface";
 import ts from "../internal/ts";
 import { INestiaMigrateConfig } from "../structures/INestiaMigrateConfig";
 import { NestiaMigrateImportProgrammer } from "./NestiaMigrateImportProgrammer";
+/**
+ * Generates the DTO type aliases from the component schemas.
+ *
+ * @evidence contracts/common.md#principled-implementation Each component name is normalized into a valid dotted name, the dots become nested namespaces, and each schema becomes an exported type alias with its description and its tags as a comment.
+ * @evidence contracts/common.md#clear-and-simple-design One public function and private builders for the module tree and the alias.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The names derive from the schema names.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 export declare namespace NestiaMigrateDtoProgrammer {
+    /**
+     * A node of the DTO namespace tree: its name, its children, and the writer of
+     * its alias, or `null` for a namespace without a type of its own.
+     *
+     * @evidence contracts/common.md#principled-implementation The tree mirrors the dotted names of the schemas, so a namespace exists exactly when a name passes through it.
+     * @evidence contracts/common.md#clear-and-simple-design A three-member record.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It is a type and adds no runtime behavior.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the meaning of each member.
+     */
     interface IModule {
         name: string;
+        /** Child segments of qualified schema names, preserving insertion order. */
         children: Map<string, IModule>;
+        /** Alias writer for a schema at this node, or null for a namespace alone. */
         programmer: null | ((importer: NestiaMigrateImportProgrammer) => ts.TypeAliasDeclaration);
     }
+    /**
+     * Returns the root of the DTO tree: a map from the first name segment to its
+     * module.
+     *
+     * @evidence contracts/common.md#principled-implementation Each schema key is split on slashes, its segments are escaped into valid identifiers and joined, and the result is inserted along its dotted path.
+     * @evidence contracts/common.md#clear-and-simple-design One function over one insertion helper.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The names come from the document.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     const compose: (props: {
+        /** Calling convention and optional generated features for this operation. */
         config: INestiaMigrateConfig;
+        /** Component schemas used to resolve DTO references. */
         components: OpenApi.IComponents;
     }) => Map<string, IModule>;
 }

package/lib/programmers/NestiaMigrateDtoProgrammer.js

@@ -6,8 +6,25 @@ const FilePrinter_1 = require("../utils/FilePrinter");
 const MapUtil_1 = require("../utils/MapUtil");
 const StringUtil_1 = require("../utils/StringUtil");
 const NestiaMigrateSchemaProgrammer_1 = require("./NestiaMigrateSchemaProgrammer");
+/**
+ * Generates the DTO type aliases from the component schemas.
+ *
+ * @evidence contracts/common.md#principled-implementation Each component name is normalized into a valid dotted name, the dots become nested namespaces, and each schema becomes an exported type alias with its description and its tags as a comment.
+ * @evidence contracts/common.md#clear-and-simple-design One public function and private builders for the module tree and the alias.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The names derive from the schema names.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 var NestiaMigrateDtoProgrammer;
 (function (NestiaMigrateDtoProgrammer) {
+    /**
+     * Returns the root of the DTO tree: a map from the first name segment to its
+     * module.
+     *
+     * @evidence contracts/common.md#principled-implementation Each schema key is split on slashes, its segments are escaped into valid identifiers and joined, and the result is inserted along its dotted path.
+     * @evidence contracts/common.md#clear-and-simple-design One function over one insertion helper.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The names come from the document.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     NestiaMigrateDtoProgrammer.compose = (props) => {
         var _a;
         const dict = new Map();

package/lib/programmers/NestiaMigrateDtoProgrammer.js.map

@@ -1 +1 @@
-{"version":3,"file":"NestiaMigrateDtoProgrammer.js","sourceRoot":"","sources":["../../src/programmers/NestiaMigrateDtoProgrammer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"NestiaMigrateDtoProgrammer.js","sourceRoot":"","sources":["../../src/programmers/NestiaMigrateDtoProgrammer.ts"],"names":[],"mappings":";;;AAAA,2CAAoD;AAMpD,sDAAmD;AACnD,8CAA2C;AAC3C,oDAAiD;AAEjD,mFAAgF;AAEhF;;;;;;;GAOG;AACH,IAAiB,0BAA0B,CA6F1C;AA7FD,WAAiB,0BAA0B;IAsBzC;;;;;;;;OAQG;IACU,kCAAO,GAAG,CAAC,KAMvB,EAAwB,EAAE;;QACzB,MAAM,IAAI,GAAyB,IAAI,GAAG,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,OAAC,KAAK,CAAC,UAAU,CAAC,OAAO,mCAAI,EAAE,CAAC,EAAE,CAAC;YAC1E,MAAM,UAAU,GAAW,GAAG;iBAC3B,KAAK,CAAC,GAAG,CAAC;iBACV,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC;iBACjC,GAAG,CAAC,uBAAU,CAAC,iBAAiB,CAAC;iBACjC,IAAI,CAAC,EAAE,CAAC,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CACrC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,UAAU,EAAE,KAAK,CAAC,CACxE,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,MAAM,OAAO,GACX,CAAC,IAA0B,EAAE,EAAE,CAC/B,CAAC,IAAY,EAAE,EAAE,CACjB,CACE,UAE4B,EAC5B,EAAE;QACF,MAAM,SAAS,GAAa,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAsB,EAAE,KAAK,EAAE,IAAK,EAAE,CAAC;QAEnD,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YAC3B,MAAM,CAAC,KAAK,GAAG,iBAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;gBAC5C,IAAI,EAAE,GAAG;gBACT,QAAQ,EAAE,IAAI,GAAG,EAAE;gBACnB,UAAU,EAAE,IAAI;aACjB,CAAC,CAAC,CAAC;YACJ,IAAI,CAAC,KAAK,SAAS,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC;YACrE,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC/B,CAAC,CAAC,CAAC;QACH,OAAO,MAAO,CAAC;IACjB,CAAC,CAAC;IAEJ,MAAM,UAAU,GACd,CAAC,MAA4B,EAAE,EAAE,CACjC,CAAC,UAA+B,EAAE,EAAE,CACpC,CAAC,QAAuC,EAAE,EAAE,CAC5C,CAAC,GAAW,EAAE,KAA0B,EAAE,EAAE,CAC1C,yBAAW,CAAC,WAAW,CACrB,iBAAO,CAAC,0BAA0B,CAChC,CAAC,iBAAO,CAAC,WAAW,CAAC,oBAAU,CAAC,aAAa,CAAC,CAAC,EAC/C,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,EACtB,EAAE,EACF,6DAA6B,CAAC,KAAK,CAAC;QAClC,UAAU;QACV,QAAQ;QACR,MAAM,EAAE,KAAK;KACd,CAAC,CACH,EACD,YAAY,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CACrD,CAAC;AACR,CAAC,EA7FgB,0BAA0B,aAA1B,0BAA0B,GAA1B,0BAA0B,QA6F1C;AAED,MAAM,YAAY,GAChB,CAAC,MAA4B,EAAE,EAAE,CACjC,CAAC,MAA2B,EAAE,GAAY,EAAU,EAAE;;;IACpD,uCAAuC;IACvC,EAAE;IACF,2EAA2E;IAC3E,2EAA2E;IAC3E,mDAAmD;IACnD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;QAC/C,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAC,KAAK,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7C,OAAO;QACL,GAAG,CAAC,CAAA,MAAA,MAAM,CAAC,WAAW,0CAAE,MAAM,EAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,CAAA,MAAA,MAAM,CAAC,WAAW,0CAAE,MAAM;YAC9B,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS;gBACzB,MAAM,CAAC,UAAU,KAAK,IAAI;gBAC1B,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;YACrB,CAAC,CAAC,CAAC,EAAE,CAAC;YACN,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,GAAG,OAAO;QACV,GAAG,CAAC,GAAG;YACL,CAAC,CAAC;gBACE,IAAI,MAAA,MAAA,MAAM,CAAC,MAAM,0CAAE,GAAG,mCAAI,QAAQ,IAAI,MAAA,MAAA,MAAM,CAAC,MAAM,0CAAE,KAAK,mCAAI,yDAAyD,EAAE;aAC1H;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC,CAAC;AAEJ,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAAsC,EAAE,CAC9E,OAAO,KAAK,KAAK,SAAS;IAC1B,OAAO,KAAK,KAAK,QAAQ;IACzB,OAAO,KAAK,KAAK,QAAQ,CAAC"}

package/lib/programmers/NestiaMigrateE2eFileProgrammer.d.ts

@@ -3,13 +3,52 @@ import { OpenApi } from "typia";
 import ts from "../internal/ts";
 import { INestiaMigrateConfig } from "../structures/INestiaMigrateConfig";
 import { NestiaMigrateImportProgrammer } from "./NestiaMigrateImportProgrammer";
+/**
+ * Generates the e2e test function of one route.
+ *
+ * @evidence contracts/common.md#principled-implementation The function calls the route through the SDK with random arguments made by `typia.random`, including generated headers, and asserts the response with `typia.assert`, so the test checks that the server's answer matches the declared type.
+ * @evidence contracts/common.md#clear-and-simple-design One entry function, one public body writer shared with the start programmer, and a private call writer.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The arguments are drawn at run time, and no route is special-cased.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 export declare namespace NestiaMigrateE2eFunctionProgrammer {
+    /**
+     * The input of one test function: the configuration, the components, the
+     * importer, and the route.
+     *
+     * @evidence contracts/common.md#principled-implementation The record holds exactly what the generation needs.
+     * @evidence contracts/common.md#clear-and-simple-design A flat record.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It is a type and adds no runtime behavior.
+     * @evidence contracts/common.md#meaningful-documentation The comment lists the fields.
+     */
     interface IContext {
+        /** Calling convention and optional generated features for this operation. */
         config: INestiaMigrateConfig;
+        /** Component schemas used to resolve DTO references. */
         components: OpenApi.IComponents;
+        /** File-local import collector shared with the surrounding file writer. */
         importer: NestiaMigrateImportProgrammer;
+        /** Analyzed operation, with the accessor chosen for this generation. */
         route: IHttpMigrateRoute;
     }
+    /**
+     * Returns the exported async test function of a route, named `test_api_`
+     * followed by its accessor.
+     *
+     * @evidence contracts/common.md#principled-implementation The name joins `test`, `api`, and the accessor with underscores, so it is unique for a route and matches the prefix that the e2e executor discovers.
+     * @evidence contracts/common.md#clear-and-simple-design One expression.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The name derives from the accessor.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the naming rule.
+     */
     const write: (ctx: IContext) => ts.FunctionDeclaration;
+    /**
+     * Returns the statements of the test body: the call with random arguments and
+     * the type assertion of its output.
+     *
+     * @evidence contracts/common.md#principled-implementation The call expression follows the parameter mode of the configuration, and the output is typed by the response schema when there is one.
+     * @evidence contracts/common.md#clear-and-simple-design One function shared with the start programmer.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The body follows the route.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     const writeBody: (ctx: IContext) => ts.Statement[];
 }

package/lib/programmers/NestiaMigrateE2eFileProgrammer.js

@@ -5,8 +5,25 @@ const factory_1 = require("@ttsc/factory");
 const IdentifierFactory_1 = require("../factories/IdentifierFactory");
 const LiteralFactory_1 = require("../factories/LiteralFactory");
 const NestiaMigrateSchemaProgrammer_1 = require("./NestiaMigrateSchemaProgrammer");
+/**
+ * Generates the e2e test function of one route.
+ *
+ * @evidence contracts/common.md#principled-implementation The function calls the route through the SDK with random arguments made by `typia.random`, including generated headers, and asserts the response with `typia.assert`, so the test checks that the server's answer matches the declared type.
+ * @evidence contracts/common.md#clear-and-simple-design One entry function, one public body writer shared with the start programmer, and a private call writer.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The arguments are drawn at run time, and no route is special-cased.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 var NestiaMigrateE2eFunctionProgrammer;
 (function (NestiaMigrateE2eFunctionProgrammer) {
+    /**
+     * Returns the exported async test function of a route, named `test_api_`
+     * followed by its accessor.
+     *
+     * @evidence contracts/common.md#principled-implementation The name joins `test`, `api`, and the accessor with underscores, so it is unique for a route and matches the prefix that the e2e executor discovers.
+     * @evidence contracts/common.md#clear-and-simple-design One expression.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The name derives from the accessor.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the naming rule.
+     */
     NestiaMigrateE2eFunctionProgrammer.write = (ctx) => factory_1.factory.createFunctionDeclaration([
         factory_1.factory.createModifier(factory_1.SyntaxKind.ExportKeyword),
         factory_1.factory.createModifier(factory_1.SyntaxKind.AsyncKeyword),
@@ -17,6 +34,15 @@ var NestiaMigrateE2eFunctionProgrammer;
             name: "api",
         })), factory_1.factory.createIdentifier("IConnection")))),
     ], undefined, factory_1.factory.createBlock(NestiaMigrateE2eFunctionProgrammer.writeBody(ctx), true));
+    /**
+     * Returns the statements of the test body: the call with random arguments and
+     * the type assertion of its output.
+     *
+     * @evidence contracts/common.md#principled-implementation The call expression follows the parameter mode of the configuration, and the output is typed by the response schema when there is one.
+     * @evidence contracts/common.md#clear-and-simple-design One function shared with the start programmer.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The body follows the route.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     NestiaMigrateE2eFunctionProgrammer.writeBody = (ctx) => [
         factory_1.factory.createVariableStatement([], factory_1.factory.createVariableDeclarationList([
             factory_1.factory.createVariableDeclaration("output", undefined, ctx.route.success
@@ -35,16 +61,31 @@ var NestiaMigrateE2eFunctionProgrammer;
     ];
     const writeCallExpressionn = (ctx) => {
         const fetch = factory_1.factory.createPropertyAccessExpression(factory_1.factory.createIdentifier("api.functional"), factory_1.factory.createIdentifier(ctx.route.accessor.join(".")));
-        const connection = factory_1.factory.createIdentifier("connection");
-        if (ctx.route.parameters.length === 0 &&
-            ctx.route.query === null &&
-            ctx.route.body === null)
-            return factory_1.factory.createCallExpression(fetch, undefined, [connection]);
         const random = factory_1.factory.createPropertyAccessExpression(factory_1.factory.createIdentifier(ctx.importer.external({
             type: "default",
             library: "typia",
             name: "typia",
         })), "random");
+        // the route's headers travel in the connection, as the server requires
+        const connection = ctx.route.headers
+            ? factory_1.factory.createObjectLiteralExpression([
+                factory_1.factory.createSpreadAssignment(factory_1.factory.createIdentifier("connection")),
+                factory_1.factory.createPropertyAssignment("headers", factory_1.factory.createObjectLiteralExpression([
+                    factory_1.factory.createSpreadAssignment(factory_1.factory.createIdentifier("connection.headers")),
+                    factory_1.factory.createSpreadAssignment(factory_1.factory.createCallExpression(random, [
+                        NestiaMigrateSchemaProgrammer_1.NestiaMigrateSchemaProgrammer.write({
+                            components: ctx.components,
+                            importer: ctx.importer,
+                            schema: ctx.route.headers.schema,
+                        }),
+                    ], undefined)),
+                ], true)),
+            ], true)
+            : factory_1.factory.createIdentifier("connection");
+        if (ctx.route.parameters.length === 0 &&
+            ctx.route.query === null &&
+            ctx.route.body === null)
+            return factory_1.factory.createCallExpression(fetch, undefined, [connection]);
         if (ctx.config.keyword === true)
             return factory_1.factory.createCallExpression(fetch, undefined, [
                 connection,

package/lib/programmers/NestiaMigrateE2eFileProgrammer.js.map

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

package/lib/programmers/NestiaMigrateE2eFileProgrammer.mjs

@@ -25,13 +25,17 @@ let NestiaMigrateE2eFunctionProgrammer;
 	})), "assert"), void 0, [factory.createIdentifier("output")]))];
 	const writeCallExpressionn = (ctx) => {
 		const fetch = factory.createPropertyAccessExpression(factory.createIdentifier("api.functional"), factory.createIdentifier(ctx.route.accessor.join(".")));
-		const connection = factory.createIdentifier("connection");
-		if (ctx.route.parameters.length === 0 && ctx.route.query === null && ctx.route.body === null) return factory.createCallExpression(fetch, void 0, [connection]);
 		const random = factory.createPropertyAccessExpression(factory.createIdentifier(ctx.importer.external({
 			type: "default",
 			library: "typia",
 			name: "typia"
 		})), "random");
+		const connection = ctx.route.headers ? factory.createObjectLiteralExpression([factory.createSpreadAssignment(factory.createIdentifier("connection")), factory.createPropertyAssignment("headers", factory.createObjectLiteralExpression([factory.createSpreadAssignment(factory.createIdentifier("connection.headers")), factory.createSpreadAssignment(factory.createCallExpression(random, [NestiaMigrateSchemaProgrammer.write({
+			components: ctx.components,
+			importer: ctx.importer,
+			schema: ctx.route.headers.schema
+		})], void 0))], true))], true) : factory.createIdentifier("connection");
+		if (ctx.route.parameters.length === 0 && ctx.route.query === null && ctx.route.body === null) return factory.createCallExpression(fetch, void 0, [connection]);
 		if (ctx.config.keyword === true) return factory.createCallExpression(fetch, void 0, [connection, LiteralFactory.write(Object.fromEntries([
 			...ctx.route.parameters,
 			ctx.route.query,

package/lib/programmers/NestiaMigrateE2eProgrammer.d.ts

@@ -1,4 +1,20 @@
 import { INestiaMigrateContext } from "../structures/INestiaMigrateContext";
+/**
+ * Generates the e2e test files, one per route.
+ *
+ * @evidence contracts/common.md#principled-implementation Each route becomes a file whose path depends on the mode and whose imports are resolved through the package name for a monorepo and through the built library path otherwise.
+ * @evidence contracts/common.md#clear-and-simple-design One public function and one private file writer.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The layout follows the accessors.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 export declare namespace NestiaMigrateE2eProgrammer {
+    /**
+     * Returns the map from file path to content of the e2e tests.
+     *
+     * @evidence contracts/common.md#principled-implementation The file name is `test_api_` plus the accessor, so each route has exactly one file.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The names follow the accessors.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     const write: (ctx: INestiaMigrateContext) => Record<string, string>;
 }

package/lib/programmers/NestiaMigrateE2eProgrammer.js

@@ -4,8 +4,24 @@ exports.NestiaMigrateE2eProgrammer = void 0;
 const FilePrinter_1 = require("../utils/FilePrinter");
 const NestiaMigrateE2eFileProgrammer_1 = require("./NestiaMigrateE2eFileProgrammer");
 const NestiaMigrateImportProgrammer_1 = require("./NestiaMigrateImportProgrammer");
+/**
+ * Generates the e2e test files, one per route.
+ *
+ * @evidence contracts/common.md#principled-implementation Each route becomes a file whose path depends on the mode and whose imports are resolved through the package name for a monorepo and through the built library path otherwise.
+ * @evidence contracts/common.md#clear-and-simple-design One public function and one private file writer.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The layout follows the accessors.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 var NestiaMigrateE2eProgrammer;
 (function (NestiaMigrateE2eProgrammer) {
+    /**
+     * Returns the map from file path to content of the e2e tests.
+     *
+     * @evidence contracts/common.md#principled-implementation The file name is `test_api_` plus the accessor, so each route has exactly one file.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The names follow the accessors.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     NestiaMigrateE2eProgrammer.write = (ctx) => Object.fromEntries(ctx.application.routes
         .map((r) => writeFile(ctx.mode, ctx.config, ctx.application.document().components, r))
         .map((r) => [`${r.location}/${r.file}`, r.content]));

package/lib/programmers/NestiaMigrateE2eProgrammer.js.map

@@ -1 +1 @@
-{"version":3,"file":"NestiaMigrateE2eProgrammer.js","sourceRoot":"","sources":["../../src/programmers/NestiaMigrateE2eProgrammer.ts"],"names":[],"mappings":";;;AAMA,sDAAmD;AACnD,qFAAsF;AACtF,mFAAgF;AAEhF,IAAiB,0BAA0B,CAmD1C;AAnDD,WAAiB,0BAA0B;IAC5B,gCAAK,GAAG,CAAC,GAA0B,EAA0B,EAAE,CAC1E,MAAM,CAAC,WAAW,CAChB,GAAG,CAAC,WAAW,CAAC,MAAM;SACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACT,SAAS,CACP,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,MAAM,EACV,GAAG,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,UAAU,EACrC,CAAC,CACF,CACF;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CACtD,CAAC;IAEJ,MAAM,SAAS,GAAG,CAChB,IAAmC,EACnC,MAA4B,EAC5B,UAA+B,EAC/B,KAAwB,EACJ,EAAE;QACtB,MAAM,QAAQ,GACZ,IAAI,6DAA6B,EAAE,CAAC;QACtC,MAAM,IAAI,GACR,mEAAkC,CAAC,KAAK,CAAC;YACvC,MAAM;YACN,UAAU;YACV,QAAQ;YACR,KAAK;SACN,CAAC,CAAC;QACL,MAAM,UAAU,GAAmB;YACjC,uEAAuE;YACvE,sEAAsE;YACtE,wDAAwD;YACxD,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE,CAChC,IAAI,KAAK,MAAM;gBACb,CAAC,CAAC,2BAA2B;gBAC7B,CAAC,CAAC,4CAA4C,IAAI,EAAE,CACvD;YACD,yBAAW,CAAC,OAAO,EAAE;YACrB,IAAI;SACL,CAAC;QACF,OAAO;YACL,QAAQ,EACN,IAAI,KAAK,MAAM;gBACb,CAAC,CAAC,oCAAoC;gBACtC,CAAC,CAAC,mBAAmB;YACzB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK;YAC1D,OAAO,EAAE,yBAAW,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;SAC3C,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,EAnDgB,0BAA0B,aAA1B,0BAA0B,GAA1B,0BAA0B,QAmD1C"}
+{"version":3,"file":"NestiaMigrateE2eProgrammer.js","sourceRoot":"","sources":["../../src/programmers/NestiaMigrateE2eProgrammer.ts"],"names":[],"mappings":";;;AAMA,sDAAmD;AACnD,qFAAsF;AACtF,mFAAgF;AAEhF;;;;;;;GAOG;AACH,IAAiB,0BAA0B,CA2D1C;AA3DD,WAAiB,0BAA0B;IACzC;;;;;;;OAOG;IACU,gCAAK,GAAG,CAAC,GAA0B,EAA0B,EAAE,CAC1E,MAAM,CAAC,WAAW,CAChB,GAAG,CAAC,WAAW,CAAC,MAAM;SACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACT,SAAS,CACP,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,MAAM,EACV,GAAG,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,UAAU,EACrC,CAAC,CACF,CACF;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CACtD,CAAC;IAEJ,MAAM,SAAS,GAAG,CAChB,IAAmC,EACnC,MAA4B,EAC5B,UAA+B,EAC/B,KAAwB,EACJ,EAAE;QACtB,MAAM,QAAQ,GACZ,IAAI,6DAA6B,EAAE,CAAC;QACtC,MAAM,IAAI,GACR,mEAAkC,CAAC,KAAK,CAAC;YACvC,MAAM;YACN,UAAU;YACV,QAAQ;YACR,KAAK;SACN,CAAC,CAAC;QACL,MAAM,UAAU,GAAmB;YACjC,uEAAuE;YACvE,sEAAsE;YACtE,wDAAwD;YACxD,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE,CAChC,IAAI,KAAK,MAAM;gBACb,CAAC,CAAC,2BAA2B;gBAC7B,CAAC,CAAC,4CAA4C,IAAI,EAAE,CACvD;YACD,yBAAW,CAAC,OAAO,EAAE;YACrB,IAAI;SACL,CAAC;QACF,OAAO;YACL,QAAQ,EACN,IAAI,KAAK,MAAM;gBACb,CAAC,CAAC,oCAAoC;gBACtC,CAAC,CAAC,mBAAmB;YACzB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK;YAC1D,OAAO,EAAE,yBAAW,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;SAC3C,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,EA3DgB,0BAA0B,aAA1B,0BAA0B,GAA1B,0BAA0B,QA2D1C"}

package/lib/programmers/NestiaMigrateImportProgrammer.d.ts

@@ -1,18 +1,93 @@
 import ts from "../internal/ts";
+/**
+ * Collects the imports that generated code needs and turns them into import
+ * statements.
+ *
+ * @evidence contracts/common.md#principled-implementation External imports are grouped by library into one clause with an optional default and a set of named instances, DTO imports are grouped by module specifier and emitted type-only, and a DTO is never imported into its own file.
+ * @evidence contracts/common.md#clear-and-simple-design One class with two collections and one emitter; the tag helper builds `typia.tags` references.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The imports follow the code that asks for them.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ */
 export declare class NestiaMigrateImportProgrammer {
     private external_;
     private dtos_;
     constructor();
+    /**
+     * Reports whether no import has been requested.
+     *
+     * @evidence contracts/common.md#principled-implementation The importer is empty exactly when both collections are empty.
+     * @evidence contracts/common.md#clear-and-simple-design One expression.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It reads the state.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the meaning.
+     */
     empty(): boolean;
+    /**
+     * Requests an import from a library and returns the local name to use.
+     *
+     * The returned name is the first segment of the requested name, so a nested
+     * name such as `tags.Type` imports `tags`.
+     *
+     * @evidence contracts/common.md#principled-implementation A default import replaces the clause's default and an instance import adds a named import, and the first segment of a dotted name is what the code refers to.
+     * @evidence contracts/common.md#clear-and-simple-design One function over one map.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The library and the name come from the caller.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the returned name.
+     */
     external(props: MigrateImportProgrammer.IProps): string;
+    /**
+     * Requests a DTO import and returns a reference to it, qualified by a
+     * namespace when one is given.
+     *
+     * @evidence contracts/common.md#principled-implementation The DTO is recorded by the first segment of its dotted name, which is the file that exports it, and the returned reference keeps the full name, with the namespace prepended when one is given.
+     * @evidence contracts/common.md#clear-and-simple-design One function over one set.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The name comes from the caller.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the reference.
+     */
     dto(name: string, namespace?: string): ts.TypeReferenceNode;
+    /**
+     * Requests the `typia` tags import and returns a reference to a tag with an
+     * optional literal argument.
+     *
+     * @evidence contracts/common.md#principled-implementation The argument is converted to a literal type, so `Minimum<3>` is written as a type reference with the literal.
+     * @evidence contracts/common.md#clear-and-simple-design One function delegating the literal building.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The tag name and the argument come from the caller.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the reference.
+     */
     tag(type: string, arg?: any): ts.TypeReferenceNode;
+    /**
+     * Returns the import statements: the external imports, a blank line when both
+     * kinds exist, and the type-only DTO imports.
+     *
+     * @evidence contracts/common.md#principled-implementation DTO names are grouped by the specifier that `dtoPath` returns, a name equal to the current file is skipped so a file never imports itself, and package specifiers merge into one clause.
+     * @evidence contracts/common.md#clear-and-simple-design One function with two emit sections.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The specifier rule is the caller's.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result and the self-import rule.
+     */
     toStatements(dtoPath: (name: string) => string, current?: string): ts.Statement[];
 }
+/**
+ * Types of the importer: the properties of an external import request.
+ *
+ * @evidence contracts/common.md#principled-implementation The record names the import kind, the library, and the name.
+ * @evidence contracts/common.md#clear-and-simple-design One namespace with one interface.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It contains types only.
+ * @evidence contracts/common.md#meaningful-documentation The comment names its content.
+ */
 export declare namespace MigrateImportProgrammer {
+    /**
+     * An external import request: `default` or `instance`, the library, and the
+     * name.
+     *
+     * @evidence contracts/common.md#principled-implementation The kind selects between the default clause and a named import.
+     * @evidence contracts/common.md#clear-and-simple-design A three-field record.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It is a type and adds no runtime behavior.
+     * @evidence contracts/common.md#meaningful-documentation The comment states each field.
+     */
     interface IProps {
+        /** Select the default export or a named import. */
         type: "default" | "instance";
+        /** Module specifier emitted in the import declaration. */
         library: string;
+        /** Requested binding; named imports use its leading dotted segment. */
         name: string;
     }
 }

package/lib/programmers/NestiaMigrateImportProgrammer.js

@@ -5,14 +5,42 @@ const factory_1 = require("@ttsc/factory");
 const TypeLiteralFactory_1 = require("../factories/TypeLiteralFactory");
 const FilePrinter_1 = require("../utils/FilePrinter");
 const MapUtil_1 = require("../utils/MapUtil");
+/**
+ * Collects the imports that generated code needs and turns them into import
+ * statements.
+ *
+ * @evidence contracts/common.md#principled-implementation External imports are grouped by library into one clause with an optional default and a set of named instances, DTO imports are grouped by module specifier and emitted type-only, and a DTO is never imported into its own file.
+ * @evidence contracts/common.md#clear-and-simple-design One class with two collections and one emitter; the tag helper builds `typia.tags` references.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The imports follow the code that asks for them.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ */
 class NestiaMigrateImportProgrammer {
     constructor() {
         this.external_ = new Map();
         this.dtos_ = new Set();
     }
+    /**
+     * Reports whether no import has been requested.
+     *
+     * @evidence contracts/common.md#principled-implementation The importer is empty exactly when both collections are empty.
+     * @evidence contracts/common.md#clear-and-simple-design One expression.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It reads the state.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the meaning.
+     */
     empty() {
         return this.external_.size === 0 && this.dtos_.size === 0;
     }
+    /**
+     * Requests an import from a library and returns the local name to use.
+     *
+     * The returned name is the first segment of the requested name, so a nested
+     * name such as `tags.Type` imports `tags`.
+     *
+     * @evidence contracts/common.md#principled-implementation A default import replaces the clause's default and an instance import adds a named import, and the first segment of a dotted name is what the code refers to.
+     * @evidence contracts/common.md#clear-and-simple-design One function over one map.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The library and the name come from the caller.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the returned name.
+     */
     external(props) {
         const clause = MapUtil_1.MapUtil.take(this.external_)(props.library)(() => ({
             default: null,
@@ -25,13 +53,31 @@ class NestiaMigrateImportProgrammer {
             clause.instances.add(name);
         return name;
     }
+    /**
+     * Requests a DTO import and returns a reference to it, qualified by a
+     * namespace when one is given.
+     *
+     * @evidence contracts/common.md#principled-implementation The DTO is recorded by the first segment of its dotted name, which is the file that exports it, and the returned reference keeps the full name, with the namespace prepended when one is given.
+     * @evidence contracts/common.md#clear-and-simple-design One function over one set.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The name comes from the caller.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the reference.
+     */
     dto(name, namespace) {
-        const file = name.split(".")[0];
-        this.dtos_.add(file);
+        const segments = name.split(".");
+        this.dtos_.add(segments[0]);
         return factory_1.factory.createTypeReferenceNode((namespace === null || namespace === void 0 ? void 0 : namespace.length)
-            ? factory_1.factory.createQualifiedName(factory_1.factory.createIdentifier(namespace), factory_1.factory.createIdentifier(file))
+            ? segments.reduce((left, segment) => factory_1.factory.createQualifiedName(left, factory_1.factory.createIdentifier(segment)), factory_1.factory.createIdentifier(namespace))
             : name);
     }
+    /**
+     * Requests the `typia` tags import and returns a reference to a tag with an
+     * optional literal argument.
+     *
+     * @evidence contracts/common.md#principled-implementation The argument is converted to a literal type, so `Minimum<3>` is written as a type reference with the literal.
+     * @evidence contracts/common.md#clear-and-simple-design One function delegating the literal building.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The tag name and the argument come from the caller.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the reference.
+     */
     tag(type, arg) {
         const instance = this.external({
             type: "instance",
@@ -40,6 +86,15 @@ class NestiaMigrateImportProgrammer {
         });
         return factory_1.factory.createTypeReferenceNode(`${instance}.${type}`, arg === undefined ? [] : [TypeLiteralFactory_1.TypeLiteralFactory.generate(arg)]);
     }
+    /**
+     * Returns the import statements: the external imports, a blank line when both
+     * kinds exist, and the type-only DTO imports.
+     *
+     * @evidence contracts/common.md#principled-implementation DTO names are grouped by the specifier that `dtoPath` returns, a name equal to the current file is skipped so a file never imports itself, and package specifiers merge into one clause.
+     * @evidence contracts/common.md#clear-and-simple-design One function with two emit sections.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The specifier rule is the caller's.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result and the self-import rule.
+     */
     toStatements(dtoPath, current) {
         // Group the DTO references by their resolved module specifier: relative
         // specifiers stay one-import-per-file, while package specifiers (e.g. the

package/lib/programmers/NestiaMigrateImportProgrammer.js.map

@@ -1 +1 @@
-{"version":3,"file":"NestiaMigrateImportProgrammer.js","sourceRoot":"","sources":["../../src/programmers/NestiaMigrateImportProgrammer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"NestiaMigrateImportProgrammer.js","sourceRoot":"","sources":["../../src/programmers/NestiaMigrateImportProgrammer.ts"],"names":[],"mappings":";;;AAAA,2CAAqE;AAErE,wEAAqE;AAErE,sDAAmD;AACnD,8CAA2C;AAE3C;;;;;;;;GAQG;AACH;IAIE;QAHQ,cAAS,GAAyB,IAAI,GAAG,EAAE,CAAC;QAC5C,UAAK,GAAgB,IAAI,GAAG,EAAE,CAAC;IAEjB,CAAC;IAEvB;;;;;;;OAOG;IACI,KAAK;QACV,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;;;;;;OAUG;IACI,QAAQ,CAAC,KAAqC;QACnD,MAAM,MAAM,GAAY,iBAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACzE,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI,GAAG,EAAE;SACrB,CAAC,CAAC,CAAC;QACJ,MAAM,IAAI,GAAW,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QAC/C,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC;;YACrD,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;OAQG;IACI,GAAG,CAAC,IAAY,EAAE,SAAkB;QACzC,MAAM,QAAQ,GAAa,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC;QAC7B,OAAO,iBAAO,CAAC,uBAAuB,CACpC,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,MAAM;YACf,CAAC,CAAC,QAAQ,CAAC,MAAM,CACb,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAChB,iBAAO,CAAC,mBAAmB,CACzB,IAAI,EACJ,iBAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAClC,EACH,iBAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC,CACpC;YACH,CAAC,CAAC,IAAI,CACT,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACI,GAAG,CAAC,IAAY,EAAE,GAAS;QAChC,MAAM,QAAQ,GAAW,IAAI,CAAC,QAAQ,CAAC;YACrC,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;QACH,OAAO,iBAAO,CAAC,uBAAuB,CACpC,GAAG,QAAQ,IAAI,IAAI,EAAE,EACrB,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,uCAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAC5D,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACI,YAAY,CACjB,OAAiC,EACjC,OAAgB;QAEhB,wEAAwE;QACxE,0EAA0E;QAC1E,sEAAsE;QACtE,MAAM,OAAO,GAA0B,IAAI,GAAG,EAAE,CAAC;QACjD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK;YAC3B,IAAI,OAAO,KAAK,SAAS,IAAI,IAAI,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACzD,iBAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9D,OAAO;YACL,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,CACxD,iBAAO,CAAC,uBAAuB,CAC7B,SAAS,EACT,iBAAO,CAAC,kBAAkB,CACxB,SAAS,EACT,KAAK,CAAC,OAAO,KAAK,IAAI;gBACpB,CAAC,CAAC,iBAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC;gBACzC,CAAC,CAAC,SAAS,EACb,KAAK,CAAC,SAAS,CAAC,IAAI;gBAClB,CAAC,CAAC,iBAAO,CAAC,kBAAkB,CACxB,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC7B,iBAAO,CAAC,qBAAqB,CAC3B,KAAK,EACL,SAAS,EACT,iBAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAC5B,CACF,CACF;gBACH,CAAC,CAAC,SAAS,CACd,EACD,iBAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,CACrC,CACF;YACD,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI;gBACxC,CAAC,CAAC,CAAC,yBAAW,CAAC,OAAO,EAAE,CAAC;gBACzB,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,CACnD,iBAAO,CAAC,uBAAuB,CAC7B,SAAS;YACT,mEAAmE;YACnE,gEAAgE;YAChE,4CAA4C;YAC5C,iBAAO,CAAC,kBAAkB,CACxB,oBAAU,CAAC,WAAW,EACtB,SAAS,EACT,iBAAO,CAAC,kBAAkB,CACxB,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACjB,iBAAO,CAAC,qBAAqB,CAC3B,KAAK,EACL,SAAS,EACT,iBAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAC/B,CACF,CACF,CACF,EACD,iBAAO,CAAC,mBAAmB,CAAC,SAAS,CAAC,CACvC,CACF;SACF,CAAC;IACJ,CAAC;CACF"}