@nestia/migrate 14.0.1 → 14.0.3

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":"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"}

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

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/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":"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"}

package/lib/programmers/NestiaMigrateImportProgrammer.mjs

@@ -3,14 +3,42 @@ import { TypeLiteralFactory } from "../factories/TypeLiteralFactory.mjs";
 import { MapUtil } from "../utils/MapUtil.mjs";
 import { SyntaxKind, factory } from "@ttsc/factory";
 //#region src/programmers/NestiaMigrateImportProgrammer.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.
+*/
 var NestiaMigrateImportProgrammer = class {
 	constructor() {
 		this.external_ = /* @__PURE__ */ new Map();
 		this.dtos_ = /* @__PURE__ */ 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.take(this.external_)(props.library)(() => ({
 			default: null,
@@ -21,11 +49,29 @@ var NestiaMigrateImportProgrammer = class {
 		else 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);
-		return factory.createTypeReferenceNode(namespace?.length ? factory.createQualifiedName(factory.createIdentifier(namespace), factory.createIdentifier(file)) : name);
+		const segments = name.split(".");
+		this.dtos_.add(segments[0]);
+		return factory.createTypeReferenceNode(namespace?.length ? segments.reduce((left, segment) => factory.createQualifiedName(left, factory.createIdentifier(segment)), 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",
@@ -34,6 +80,15 @@ var NestiaMigrateImportProgrammer = class {
 		});
 		return factory.createTypeReferenceNode(`${instance}.${type}`, arg === void 0 ? [] : [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) {
 		const modules = /* @__PURE__ */ new Map();
 		for (const name of this.dtos_) if (current === void 0 || name !== current.split(".")[0]) MapUtil.take(modules)(dtoPath(name))(() => []).push(name);

package/lib/programmers/NestiaMigrateNestControllerProgrammer.d.ts

@@ -2,11 +2,39 @@ import { OpenApi } from "@typia/interface";
 import ts from "../internal/ts";
 import { INestiaMigrateConfig } from "../structures/INestiaMigrateConfig";
 import { INestiaMigrateController } from "../structures/INestiaMigrateController";
+/**
+ * Generates the source of one NestJS controller.
+ *
+ * @evidence contracts/common.md#principled-implementation The controller class is decorated with `@Controller` and its path, each route becomes a method written by the configured method programmer or the default one, and the DTO types are imported by package name because they live in the API package.
+ * @evidence contracts/common.md#clear-and-simple-design One function; the method programmer is replaceable through the configuration.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The replaceable programmer is a documented extension point.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 export declare namespace NestiaMigrateNestControllerProgrammer {
+    /**
+     * The input of one controller: the configuration, the components, and the
+     * controller.
+     *
+     * @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 IProps {
+        /** Generation options and an optional controller-method writer. */
         config: INestiaMigrateConfig;
+        /** Schemas needed by generated controller method types. */
         components: OpenApi.IComponents;
+        /** Controller name, router prefix and grouped operations. */
         controller: INestiaMigrateController;
     }
+    /**
+     * Returns the statements of a controller file.
+     *
+     * @evidence contracts/common.md#principled-implementation Blank lines separate the methods, and the imports come first.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The content follows the controller.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     const write: (props: IProps) => ts.Statement[];
 }

package/lib/programmers/NestiaMigrateNestControllerProgrammer.js

@@ -5,8 +5,24 @@ const factory_1 = require("@ttsc/factory");
 const FilePrinter_1 = require("../utils/FilePrinter");
 const NestiaMigrateImportProgrammer_1 = require("./NestiaMigrateImportProgrammer");
 const NestiaMigrateNestMethodProgrammer_1 = require("./NestiaMigrateNestMethodProgrammer");
+/**
+ * Generates the source of one NestJS controller.
+ *
+ * @evidence contracts/common.md#principled-implementation The controller class is decorated with `@Controller` and its path, each route becomes a method written by the configured method programmer or the default one, and the DTO types are imported by package name because they live in the API package.
+ * @evidence contracts/common.md#clear-and-simple-design One function; the method programmer is replaceable through the configuration.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The replaceable programmer is a documented extension point.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 var NestiaMigrateNestControllerProgrammer;
 (function (NestiaMigrateNestControllerProgrammer) {
+    /**
+     * Returns the statements of a controller file.
+     *
+     * @evidence contracts/common.md#principled-implementation Blank lines separate the methods, and the imports come first.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The content follows the controller.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     NestiaMigrateNestControllerProgrammer.write = (props) => {
         const importer = new NestiaMigrateImportProgrammer_1.NestiaMigrateImportProgrammer();
         const $class = factory_1.factory.createClassDeclaration([

package/lib/programmers/NestiaMigrateNestControllerProgrammer.js.map

@@ -1 +1 @@
-{"version":3,"file":"NestiaMigrateNestControllerProgrammer.js","sourceRoot":"","sources":["../../src/programmers/NestiaMigrateNestControllerProgrammer.ts"],"names":[],"mappings":";;;AAAA,2CAAoD;AAMpD,sDAAmD;AACnD,mFAAgF;AAChF,2FAAwF;AAExF,IAAiB,qCAAqC,CAuDrD;AAvDD,WAAiB,qCAAqC;IAOvC,2CAAK,GAAG,CAAC,KAAa,EAAkB,EAAE;QACrD,MAAM,QAAQ,GACZ,IAAI,6DAA6B,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,iBAAO,CAAC,sBAAsB,CAC3C;YACE,iBAAO,CAAC,eAAe,CACrB,iBAAO,CAAC,oBAAoB,CAC1B,iBAAO,CAAC,gBAAgB,CACtB,QAAQ,CAAC,QAAQ,CAAC;gBAChB,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,gBAAgB;gBACzB,IAAI,EAAE,YAAY;aACnB,CAAC,CACH,EACD,EAAE,EACF,CAAC,iBAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CACrD,CACF;YACD,iBAAO,CAAC,WAAW,CAAC,oBAAU,CAAC,aAAa,CAAC;SAC9C,EACD,KAAK,CAAC,UAAU,CAAC,IAAI,EACrB,EAAE,EACF,EAAE,EACF,KAAK,CAAC,UAAU,CAAC,MAAM;aACpB,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,0BAAC;YACrB,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,yBAAW,CAAC,OAAO,EAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,OACE,MAAA,KAAK,CAAC,MAAM,CAAC,UAAU,0CAAE,gBAAgB,mCACzC,qEAAiC,CAAC,KAAK,CACxC,CAAC;gBACA,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,QAAQ;gBACR,KAAK;aACN,CAAC;SACH,GAAA,CAAC;aACD,IAAI,EAAE,CACV,CAAC;QACF,OAAO;YACL,kEAAkE;YAClE,sEAAsE;YACtE,uDAAuD;YACvD,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,2BAA2B,CAAC;YAC3D,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,yBAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YACpD,MAAM;SACP,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,EAvDgB,qCAAqC,aAArC,qCAAqC,GAArC,qCAAqC,QAuDrD"}
+{"version":3,"file":"NestiaMigrateNestControllerProgrammer.js","sourceRoot":"","sources":["../../src/programmers/NestiaMigrateNestControllerProgrammer.ts"],"names":[],"mappings":";;;AAAA,2CAAoD;AAMpD,sDAAmD;AACnD,mFAAgF;AAChF,2FAAwF;AAExF;;;;;;;GAOG;AACH,IAAiB,qCAAqC,CA6ErD;AA7ED,WAAiB,qCAAqC;IAqBpD;;;;;;;OAOG;IACU,2CAAK,GAAG,CAAC,KAAa,EAAkB,EAAE;QACrD,MAAM,QAAQ,GACZ,IAAI,6DAA6B,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,iBAAO,CAAC,sBAAsB,CAC3C;YACE,iBAAO,CAAC,eAAe,CACrB,iBAAO,CAAC,oBAAoB,CAC1B,iBAAO,CAAC,gBAAgB,CACtB,QAAQ,CAAC,QAAQ,CAAC;gBAChB,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,gBAAgB;gBACzB,IAAI,EAAE,YAAY;aACnB,CAAC,CACH,EACD,EAAE,EACF,CAAC,iBAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CACrD,CACF;YACD,iBAAO,CAAC,WAAW,CAAC,oBAAU,CAAC,aAAa,CAAC;SAC9C,EACD,KAAK,CAAC,UAAU,CAAC,IAAI,EACrB,EAAE,EACF,EAAE,EACF,KAAK,CAAC,UAAU,CAAC,MAAM;aACpB,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,0BAAC;YACrB,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,yBAAW,CAAC,OAAO,EAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,OACE,MAAA,KAAK,CAAC,MAAM,CAAC,UAAU,0CAAE,gBAAgB,mCACzC,qEAAiC,CAAC,KAAK,CACxC,CAAC;gBACA,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,QAAQ;gBACR,KAAK;aACN,CAAC;SACH,GAAA,CAAC;aACD,IAAI,EAAE,CACV,CAAC;QACF,OAAO;YACL,kEAAkE;YAClE,sEAAsE;YACtE,uDAAuD;YACvD,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,2BAA2B,CAAC;YAC3D,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,yBAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YACpD,MAAM;SACP,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,EA7EgB,qCAAqC,aAArC,qCAAqC,GAArC,qCAAqC,QA6ErD"}

package/lib/programmers/NestiaMigrateNestMethodProgrammer.d.ts

@@ -4,13 +4,43 @@ import ts from "../internal/ts";
 import { INestiaMigrateConfig } from "../structures/INestiaMigrateConfig";
 import { INestiaMigrateController } from "../structures/INestiaMigrateController";
 import { NestiaMigrateImportProgrammer } from "./NestiaMigrateImportProgrammer";
+/**
+ * Generates the controller method of one route.
+ *
+ * @evidence contracts/common.md#principled-implementation The method carries `TypedRoute`, `TypedException`, `HumanRoute`, and example decorators as the route requires, one parameter per path, header, query, and body input with the matching typed decorator, and a body that mentions each parameter and returns `typia.random` of the response type.
+ * @evidence contracts/common.md#clear-and-simple-design One entry function and private writers for the description, the decorators, and the parameters.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The output derives from the route; the body is a stub that returns random data because the document does not define the behavior.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 export declare namespace NestiaMigrateNestMethodProgrammer {
+    /**
+     * The input of one method: the configuration, the components, the importer,
+     * the controller, 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 {
+        /** Generation options, including the author tag used on the handler. */
         config: INestiaMigrateConfig;
+        /** Component schemas referenced by request and response types. */
         components: OpenApi.IComponents;
+        /** Controller-file import collector shared by all its methods. */
         importer: NestiaMigrateImportProgrammer;
+        /** Controller prefix removed from this operation's router path. */
         controller: INestiaMigrateController;
+        /** Analyzed operation supplying method, schemas and examples. */
         route: IHttpMigrateRoute;
     }
+    /**
+     * Returns the method declaration of a route.
+     *
+     * @evidence contracts/common.md#principled-implementation The decorators and the parameters follow the route's HTTP method, path relative to the controller, and inputs.
+     * @evidence contracts/common.md#clear-and-simple-design One function composing the private writers.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The method follows the route.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     const write: (ctx: IContext) => ts.MethodDeclaration;
 }