@nestia/sdk 14.0.0 → 14.0.2

package/lib/generates/internal/SdkDistributionComposer.js

@@ -16,82 +16,179 @@ exports.SdkDistributionComposer = void 0;
 const child_process_1 = __importDefault(require("child_process"));
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
+/**
+ * Composes the npm package of the SDK in the distribution directory.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace copies the bundle, fills its paths in, and installs the dependencies at the versions the project uses.
+ * @evidence contracts/common.md#clear-and-simple-design One public function and the private steps.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Each filesystem step resolves against the distribution directory; no process-global directory or foreign method is changed.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+ * @evidence contracts/portability.md#os-neutral-implementation Native paths use path.relative/path.join and generated paths use slash separators. npm receives an argument vector and an explicit cwd. POSIX launches npm directly; Windows launches the npm-cli.js shipped beside the first npm.cmd on PATH through Node because a cmd shim itself requires shell interpretation. A nonstandard Windows npm shim lacking that adjacent npm installation is rejected explicitly.
+ */
 var SdkDistributionComposer;
 (function (SdkDistributionComposer) {
+    /**
+     * Prepares the distribution package once: files, paths, and dependencies, and
+     * does nothing when the package is already configured.
+     *
+     * @evidence contracts/common.md#principled-implementation The package counts as configured when it holds `@nestia/fetcher`, which is installed last with its peers, so an interrupted setup runs again. The caller directory is captured once, and every output path and package-manager cwd is explicit.
+     * @evidence contracts/common.md#clear-and-simple-design One function of sequential steps.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts No process-global directory is changed, so independent compositions retain their own destinations.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidence contracts/portability.md#os-neutral-implementation Existence of the two package files is the filesystem's own answer, and the bundle files are copied over any file of the same name in a distribution directory that is not yet configured, so an interrupted setup repeats the copy.
+     */
     SdkDistributionComposer.compose = (props) => __awaiter(this, void 0, void 0, function* () {
-        if (!fs_1.default.existsSync(props.config.distribute))
-            yield fs_1.default.promises.mkdir(props.config.distribute, { recursive: true });
         const root = process.cwd();
+        const directory = path_1.default.resolve(props.config.distribute);
         const output = path_1.default.resolve(props.config.output);
-        process.chdir(props.config.distribute);
-        try {
-            if (yield configured())
-                return;
-            // COPY FILES
-            console.log("Composing SDK distribution environments...");
-            for (const file of yield fs_1.default.promises.readdir(BUNDLE))
-                yield fs_1.default.promises.copyFile(`${BUNDLE}/${file}`, file);
-            // CONFIGURE PATHS
-            for (const file of ["package.json", "tsconfig.json"])
-                yield replace({ root, output })(file);
-            // INSTALL PACKAGES
-            const v = yield dependencies({
-                websocket: props.websocket,
-            });
-            execute("npm install --save-dev rimraf");
-            execute(`npm install --save @nestia/fetcher@${v.version}`);
-            execute(`npm install --save typia@${v.typia}`);
-            if (props.mcp && v.mcp !== undefined)
-                execute(`npm install --save @modelcontextprotocol/sdk@${v.mcp}`);
-            if (props.websocket && v.tgrid !== undefined)
-                execute(`npm install --save tgrid@${v.tgrid}`);
-            execute("npx typia setup --manager npm");
-        }
-        finally {
-            process.chdir(root);
-        }
+        yield fs_1.default.promises.mkdir(directory, { recursive: true });
+        if (yield configured(directory))
+            return;
+        console.log("Composing SDK distribution environments...");
+        for (const file of yield fs_1.default.promises.readdir(BUNDLE))
+            yield fs_1.default.promises.copyFile(path_1.default.join(BUNDLE, file), path_1.default.join(directory, file));
+        for (const file of ["package.json", "tsconfig.json"])
+            yield replace({ root, output, directory })(file);
+        // Compile with ttsc, which applies typia's transform; typia no longer has
+        // a setup command. Install each dependency kind together so an interrupted
+        // setup cannot mark @nestia/fetcher configured before its runtime peers.
+        const v = yield dependencies({
+            root,
+            websocket: props.websocket,
+        });
+        execute(directory, [
+            "install",
+            "--save-dev",
+            "rimraf",
+            `ttsc@${v.ttsc}`,
+            `typescript@${v.typescript}`,
+        ]);
+        execute(directory, [
+            "install",
+            "--save",
+            `@nestia/fetcher@${v.version}`,
+            `typia@${v.typia}`,
+            ...(props.mcp && v.mcp !== undefined
+                ? [`@modelcontextprotocol/sdk@${v.mcp}`]
+                : []),
+            ...(props.websocket && v.tgrid !== undefined ? [`tgrid@${v.tgrid}`] : []),
+        ]);
     });
-    const configured = () => __awaiter(this, void 0, void 0, function* () {
-        return ["package.json", "tsconfig.json"].every(fs_1.default.existsSync) &&
+    const configured = (directory) => __awaiter(this, void 0, void 0, function* () {
+        return ["package.json", "tsconfig.json"].every((file) => fs_1.default.existsSync(path_1.default.join(directory, file))) &&
             (yield (() => __awaiter(this, void 0, void 0, function* () {
                 var _a;
-                const content = JSON.parse(yield fs_1.default.promises.readFile("package.json", "utf8"));
+                const content = JSON.parse(yield fs_1.default.promises.readFile(path_1.default.join(directory, "package.json"), "utf8"));
                 return !!((_a = content.dependencies) === null || _a === void 0 ? void 0 : _a["@nestia/fetcher"]);
             }))());
     });
-    const execute = (command) => {
-        console.log(`  - ${command}`);
-        child_process_1.default.execSync(command, { stdio: "ignore" });
+    const execute = (cwd, args) => {
+        var _a;
+        console.log(`  - npm ${args.join(" ")}`);
+        if (process.platform !== "win32")
+            child_process_1.default.execFileSync("npm", args, { cwd, stdio: "ignore" });
+        else {
+            // Windows cannot execute npm.cmd without cmd.exe. Launch the JavaScript
+            // entry point installed beside that shim instead, so dependency ranges
+            // and paths never pass through a shell's metacharacter interpretation.
+            const directories = ((_a = process.env.PATH) !== null && _a !== void 0 ? _a : "").split(path_1.default.delimiter);
+            const directory = directories.find((entry) => fs_1.default.existsSync(path_1.default.join(entry, "npm.cmd")));
+            const cli = directory === undefined
+                ? undefined
+                : [
+                    path_1.default.join(directory, "node_modules/npm/bin/npm-cli.js"),
+                    path_1.default.resolve(directory, "../npm/bin/npm-cli.js"),
+                ].find((entry) => fs_1.default.existsSync(entry));
+            if (cli === undefined)
+                throw new Error("Unable to locate npm's JavaScript entry point beside npm.cmd on PATH.");
+            child_process_1.default.execFileSync(process.execPath, [cli, ...args], {
+                cwd,
+                stdio: "ignore",
+            });
+        }
     };
     const replace = (props) => (file) => __awaiter(this, void 0, void 0, function* () {
         const relative = (from) => (to) => path_1.default.relative(from, to).split("\\").join("/");
-        const root = relative(process.cwd())(props.root);
-        const output = relative(process.cwd())(props.output);
-        const current = relative(props.root)(process.cwd());
-        const content = yield fs_1.default.promises.readFile(file, "utf8");
-        yield fs_1.default.promises.writeFile(file, content
-            .split("${root}")
-            .join(root)
-            .split("${output}")
-            .join(output)
-            .split("${current}")
-            .join(current), "utf8");
+        const root = relative(props.directory)(props.root);
+        const output = relative(props.directory)(props.output);
+        const current = relative(props.root)(props.directory);
+        const replacements = { root, output, current };
+        const location = path_1.default.join(props.directory, file);
+        const content = JSON.parse(yield fs_1.default.promises.readFile(location, "utf8"));
+        const substitute = (value) => {
+            if (typeof value === "string")
+                return value.replace(/\$\{(root|output|current)\}/g, (_match, key) => replacements[key]);
+            if (Array.isArray(value))
+                return value.map(substitute);
+            if (value !== null && typeof value === "object")
+                return Object.fromEntries(Object.entries(value).map(([key, element]) => [
+                    key,
+                    substitute(element),
+                ]));
+            return value;
+        };
+        yield fs_1.default.promises.writeFile(location, JSON.stringify(substitute(content), null, 2) + "\n", "utf8");
     });
+    /**
+     * The version of a package the project installed, exactly: the staged package
+     * must run the typia, and compile with the ttsc and TypeScript, the project
+     * itself uses, with the tgrid and MCP SDK its WebSocket and MCP functions
+     * import. `@nestia/sdk`'s own specifier is only the fallback, and a
+     * workspace's `catalog:` one names no version npm could install.
+     */
+    const installed = (root, name, fallback) => { var _a; return (_a = manifestVersion(root, name)) !== null && _a !== void 0 ? _a : (fallback !== undefined && fallback.startsWith("catalog:") === false
+        ? fallback
+        : undefined); };
+    /**
+     * The version in the manifest of the package as installed. Not every package
+     * exports its `package.json`, as tgrid does not, and a subpath export may map
+     * it to a nested manifest of no name, as `@modelcontextprotocol/sdk` maps it
+     * to `dist/cjs/package.json`; so the manifest is the nearest `package.json`
+     * naming the package, at or above what the request resolves to.
+     */
+    const manifestVersion = (root, name) => {
+        for (const request of [`${name}/package.json`, name]) {
+            let file;
+            try {
+                file = require.resolve(request, { paths: [root, __dirname] });
+            }
+            catch (_a) {
+                continue;
+            }
+            for (let directory = path_1.default.dirname(file);;) {
+                try {
+                    const json = JSON.parse(fs_1.default.readFileSync(path_1.default.join(directory, "package.json"), "utf8"));
+                    if (json.name === name &&
+                        typeof json.version === "string" &&
+                        json.version.length !== 0)
+                        return json.version;
+                }
+                catch (_b) { }
+                const parent = path_1.default.dirname(directory);
+                if (parent === directory)
+                    break;
+                directory = parent;
+            }
+        }
+        return undefined;
+    };
     const dependencies = (opts) => __awaiter(this, void 0, void 0, function* () {
         const content = yield fs_1.default.promises.readFile(__dirname + "/../../../package.json", "utf8");
         const json = JSON.parse(content);
         const dependencies = Object.assign(Object.assign({}, json.devDependencies), json.dependencies);
-        const required = (key) => {
-            const value = key === "version" ? json.version : dependencies[key];
+        const required = (key, value) => {
             if (typeof value !== "string" || value.length === 0)
                 throw new Error(`Unable to resolve ${key} version for SDK distribution.`);
             return value;
         };
+        const version = (name) => installed(opts.root, name, dependencies[name]);
         return {
-            version: required("version"),
-            typia: required("typia"),
-            tgrid: opts.websocket ? dependencies.tgrid : undefined,
-            mcp: dependencies["@modelcontextprotocol/sdk"],
+            version: required("@nestia/fetcher", json.version),
+            typia: required("typia", version("typia")),
+            ttsc: required("ttsc", version("ttsc")),
+            typescript: required("typescript", version("typescript")),
+            tgrid: opts.websocket ? version("tgrid") : undefined,
+            mcp: version("@modelcontextprotocol/sdk"),
         };
     });
 })(SdkDistributionComposer || (exports.SdkDistributionComposer = SdkDistributionComposer = {}));

package/lib/generates/internal/SdkDistributionComposer.js.map

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

package/lib/generates/internal/SdkFileProgrammer.d.ts

@@ -1,4 +1,22 @@
 import { ITypedApplication } from "../../structures/ITypedApplication";
+/**
+ * Writes the functional part of the SDK.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace builds the directory tree of the routes by accessor and prints one `index.ts` per directory.
+ * @evidence contracts/common.md#clear-and-simple-design One public function and two private helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The tree follows the accessors of the routes.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+ * @evidence contracts/portability.md#os-neutral-implementation Node mkdir creates native directories from the configured output and analyzed identifier accessors; ImportDictionary separately renders relative module specifiers with forward slashes. No filesystem case equivalence is inferred from route names.
+ */
 export declare namespace SdkFileProgrammer {
+    /**
+     * Writes the `functional` tree of the SDK from the routes' accessors.
+     *
+     * @evidence contracts/common.md#principled-implementation A route lands in the directory of its accessor without the last segment, and each directory exports its children as namespaces.
+     * @evidence contracts/common.md#clear-and-simple-design One tree build and one recursive writer.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The order of routes is the analysis order.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidence contracts/portability.md#os-neutral-implementation The recursive writer passes output paths to Node fs and FilePrinter, which accept the slash suffixes on Windows and POSIX. Accessor analysis supplies valid namespace names; module specifier spelling remains the importer’s separate responsibility.
+     */
     const generate: (app: ITypedApplication) => Promise<void>;
 }

package/lib/generates/internal/SdkFileProgrammer.js

@@ -16,17 +16,36 @@ exports.SdkFileProgrammer = void 0;
 const factory_1 = require("@ttsc/factory");
 const fs_1 = __importDefault(require("fs"));
 const MapUtil_1 = require("../../utils/MapUtil");
+const StringUtil_1 = require("../../utils/StringUtil");
 const FilePrinter_1 = require("./FilePrinter");
 const ImportDictionary_1 = require("./ImportDictionary");
 const SdkHttpRouteProgrammer_1 = require("./SdkHttpRouteProgrammer");
 const SdkMcpRouteProgrammer_1 = require("./SdkMcpRouteProgrammer");
 const SdkRouteDirectory_1 = require("./SdkRouteDirectory");
 const SdkWebSocketRouteProgrammer_1 = require("./SdkWebSocketRouteProgrammer");
+/**
+ * Writes the functional part of the SDK.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace builds the directory tree of the routes by accessor and prints one `index.ts` per directory.
+ * @evidence contracts/common.md#clear-and-simple-design One public function and two private helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The tree follows the accessors of the routes.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+ * @evidence contracts/portability.md#os-neutral-implementation Node mkdir creates native directories from the configured output and analyzed identifier accessors; ImportDictionary separately renders relative module specifiers with forward slashes. No filesystem case equivalence is inferred from route names.
+ */
 var SdkFileProgrammer;
 (function (SdkFileProgrammer) {
     /* ---------------------------------------------------------
           CONSTRUCTOR
       --------------------------------------------------------- */
+    /**
+     * Writes the `functional` tree of the SDK from the routes' accessors.
+     *
+     * @evidence contracts/common.md#principled-implementation A route lands in the directory of its accessor without the last segment, and each directory exports its children as namespaces.
+     * @evidence contracts/common.md#clear-and-simple-design One tree build and one recursive writer.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The order of routes is the analysis order.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidence contracts/portability.md#os-neutral-implementation The recursive writer passes output paths to Node fs and FilePrinter, which accept the slash suffixes on Windows and POSIX. Accessor analysis supplies valid namespace names; module specifier spelling remains the importer’s separate responsibility.
+     */
     SdkFileProgrammer.generate = (app) => __awaiter(this, void 0, void 0, function* () {
         // CONSTRUCT FOLDER TREE
         const root = new SdkRouteDirectory_1.SdkRouteDirectory(null, "functional");
@@ -58,18 +77,61 @@ var SdkFileProgrammer;
         if (statements.length && directory.routes.length)
             statements.push(FilePrinter_1.FilePrinter.enter());
         // ITERATE ROUTES
-        const importer = new ImportDictionary_1.ImportDictionary(`${outDir}/index.ts`);
-        directory.routes.forEach((route, i) => {
-            if (!(project.config.clone === true && route.protocol === "http"))
-                importer.declarations(route.imports);
-            statements.push(...(route.protocol === "http"
-                ? SdkHttpRouteProgrammer_1.SdkHttpRouteProgrammer.write(project)(importer)(route)
-                : route.protocol === "websocket"
-                    ? SdkWebSocketRouteProgrammer_1.SdkWebSocketRouteProgrammer.write(project)(importer)(route)
-                    : SdkMcpRouteProgrammer_1.SdkMcpRouteProgrammer.write(project)(importer)(route)));
-            if (i !== directory.routes.length - 1)
-                statements.push(FilePrinter_1.FilePrinter.enter());
-        });
+        const write = (locals) => {
+            const importer = new ImportDictionary_1.ImportDictionary(`${outDir}/index.ts`);
+            const output = [];
+            directory.routes.forEach((route, i) => {
+                if (!(project.config.clone === true && route.protocol === "http"))
+                    importer.declarations(route.imports);
+                const local = locals.get(route);
+                const target = local === undefined ? route : Object.assign(Object.assign({}, route), { name: local });
+                const written = target.protocol === "http"
+                    ? SdkHttpRouteProgrammer_1.SdkHttpRouteProgrammer.write(project)(importer)(target)
+                    : target.protocol === "websocket"
+                        ? SdkWebSocketRouteProgrammer_1.SdkWebSocketRouteProgrammer.write(project)(importer)(target)
+                        : SdkMcpRouteProgrammer_1.SdkMcpRouteProgrammer.write(project)(importer)(target);
+                if (local !== undefined) {
+                    written.forEach(unexport);
+                    written.push(factory_1.factory.createExportDeclaration(undefined, false, factory_1.factory.createNamedExports([
+                        factory_1.factory.createExportSpecifier(false, local, route.name),
+                    ]), undefined));
+                }
+                output.push(...written);
+                if (i !== directory.routes.length - 1)
+                    output.push(FilePrinter_1.FilePrinter.enter());
+            });
+            return { importer, statements: output };
+        };
+        // A route's function and namespace are declared in the module scope,
+        // where the file's imports and the globals its bodies reference live
+        // too. A route named like one of them shadows it for the whole file, or
+        // conflicts with the import, so the SDK would not compile (#1647); a
+        // method named `tags` whose path parameter is typed with `tags.Format`
+        // is enough. Its public name cannot change, so it is declared under a
+        // local one and exported as itself.
+        let file = write(new Map());
+        const scope = new Set([
+            ...file.importer.locals(),
+            ...MODULE_GLOBALS,
+        ]);
+        const shadowing = directory.routes.filter((r) => scope.has(r.name));
+        if (shadowing.length !== 0) {
+            // each local name distinct from the scope, the routes, and the other
+            // locals
+            const taken = [
+                ...scope,
+                ...directory.routes.map((r) => r.name),
+            ];
+            const locals = new Map();
+            for (const route of shadowing) {
+                const local = StringUtil_1.StringUtil.escapeDuplicate(taken)(route.name);
+                taken.push(local);
+                locals.set(route, local);
+            }
+            file = write(locals);
+        }
+        const importer = file.importer;
+        statements.push(...file.statements);
         // FINALIZE THE CONTENT
         if (directory.routes.length !== 0)
             statements.push(...importer.toStatements(outDir), ...(!importer.empty() && statements.length
@@ -87,4 +149,31 @@ var SdkFileProgrammer;
         });
     });
 })(SdkFileProgrammer || (exports.SdkFileProgrammer = SdkFileProgrammer = {}));
+/**
+ * Globals the generated route bodies reference, and names TypeScript reserves
+ * in a module's top-level scope: `Promise` in one with async functions, and
+ * `require` and `exports` in a CommonJS one.
+ */
+const MODULE_GLOBALS = [
+    "Array",
+    "Error",
+    "JSON",
+    "Object",
+    "Promise",
+    "ReadableStream",
+    "String",
+    "URLSearchParams",
+    "encodeURIComponent",
+    "exports",
+    "require",
+    "undefined",
+];
+/** Drops the `export` modifier of a route's function or namespace. */
+const unexport = (node) => {
+    const declaration = node;
+    if ((declaration.kind === "FunctionDeclaration" ||
+        declaration.kind === "ModuleDeclaration") &&
+        declaration.modifiers !== undefined)
+        declaration.modifiers = declaration.modifiers.filter((m) => m.token !== factory_1.SyntaxKind.ExportKeyword);
+};
 //# sourceMappingURL=SdkFileProgrammer.js.map

package/lib/generates/internal/SdkFileProgrammer.js.map

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

package/lib/generates/internal/SdkHttpCloneProgrammer.d.ts

@@ -1,11 +1,40 @@
 import { type Node } from "@ttsc/factory";
 import { ITypedApplication } from "../../structures/ITypedApplication";
 import { ImportDictionary } from "./ImportDictionary";
+/**
+ * Composes the DTO declarations of the HTTP routes.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace turns each named object, alias and recursive collection into a declaration, placed in a tree of modules by its dotted name.
+ * @evidence contracts/common.md#clear-and-simple-design One declaration-tree operation dispatches object, alias and recursive collection bodies through their owning writers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Implicit object and alias names are not declared; native-marked recursive collections supply named declarations so recursive references have a definition.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkHttpCloneProgrammer composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 export declare namespace SdkHttpCloneProgrammer {
+    /**
+     * A module of the declaration tree: its name, its children, and the writer of
+     * its own declaration.
+     *
+     * @evidence contracts/common.md#principled-implementation A module without a writer only holds children.
+     * @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 what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkHttpCloneProgrammer.IModule composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     interface IModule {
         name: string;
         children: Map<string, IModule>;
         programmer: null | ((importer: ImportDictionary) => Node);
     }
+    /**
+     * Returns the declaration tree of the application's named types, keyed by
+     * their top-level name.
+     *
+     * @evidence contracts/common.md#principled-implementation Named objects and aliases are registered, and implicit names are skipped. Recursive arrays and tuples also need declarations: each writes one collection body whose nested uses are named references. Finite and object-mediated collections stay inline.
+     * @evidence contracts/common.md#clear-and-simple-design Four collection loops feed the same declaration tree, so all named forms share namespace and import decisions.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The implicit test is the shared definition.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkHttpCloneProgrammer.write composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     const write: (app: ITypedApplication) => Map<string, IModule>;
 }

package/lib/generates/internal/SdkHttpCloneProgrammer.js

@@ -6,8 +6,27 @@ const MapUtil_1 = require("../../utils/MapUtil");
 const StringUtil_1 = require("../../utils/StringUtil");
 const FilePrinter_1 = require("./FilePrinter");
 const SdkTypeProgrammer_1 = require("./SdkTypeProgrammer");
+/**
+ * Composes the DTO declarations of the HTTP routes.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace turns each named object, alias and recursive collection into a declaration, placed in a tree of modules by its dotted name.
+ * @evidence contracts/common.md#clear-and-simple-design One declaration-tree operation dispatches object, alias and recursive collection bodies through their owning writers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Implicit object and alias names are not declared; native-marked recursive collections supply named declarations so recursive references have a definition.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkHttpCloneProgrammer composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 var SdkHttpCloneProgrammer;
 (function (SdkHttpCloneProgrammer) {
+    /**
+     * Returns the declaration tree of the application's named types, keyed by
+     * their top-level name.
+     *
+     * @evidence contracts/common.md#principled-implementation Named objects and aliases are registered, and implicit names are skipped. Recursive arrays and tuples also need declarations: each writes one collection body whose nested uses are named references. Finite and object-mediated collections stay inline.
+     * @evidence contracts/common.md#clear-and-simple-design Four collection loops feed the same declaration tree, so all named forms share namespace and import decisions.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The implicit test is the shared definition.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkHttpCloneProgrammer.write composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     SdkHttpCloneProgrammer.write = (app) => {
         // COMPOSE THE DICTIONARY
         const dict = new Map();
@@ -25,6 +44,20 @@ var SdkHttpCloneProgrammer;
                     name: k,
                     programmer: (importer) => writeAlias(app.project)(importer)(v),
                 });
+        for (const [k, v] of app.collection.arrays.entries())
+            if (v.recursive)
+                prepare({
+                    dict,
+                    name: k,
+                    programmer: (importer) => factory_1.factory.createTypeAliasDeclaration([factory_1.factory.createModifier(factory_1.SyntaxKind.ExportKeyword)], StringUtil_1.StringUtil.accessorsOf(k).at(-1), [], SdkTypeProgrammer_1.SdkTypeProgrammer.write_array_type(app.project)(importer)(v)),
+                });
+        for (const [k, v] of app.collection.tuples.entries())
+            if (v.recursive)
+                prepare({
+                    dict,
+                    name: k,
+                    programmer: (importer) => factory_1.factory.createTypeAliasDeclaration([factory_1.factory.createModifier(factory_1.SyntaxKind.ExportKeyword)], StringUtil_1.StringUtil.accessorsOf(k).at(-1), [], SdkTypeProgrammer_1.SdkTypeProgrammer.write_tuple_type(app.project)(importer)(v)),
+                });
         return dict;
     };
     const prepare = (props) => {

package/lib/generates/internal/SdkHttpCloneProgrammer.js.map

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

package/lib/generates/internal/SdkHttpCloneReferencer.d.ts

@@ -1,4 +1,23 @@
 import { ITypedApplication } from "../../structures/ITypedApplication";
+/**
+ * Rewrites the routes to refer to the cloned DTOs.
+ *
+ * @evidence contracts/common.md#principled-implementation HTTP and MCP JSON types and their namespace/tag imports are emitted together from resolved metadata by the cloned declaration writer; WebSocket declarations retain their source types and redirect only cloned imports.
+ * @evidence contracts/common.md#clear-and-simple-design One public function and three visitors.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The routes are rewritten in place, once.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkHttpCloneReferencer composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 export declare namespace SdkHttpCloneReferencer {
+    /**
+     * Rewrites the HTTP, MCP and WebSocket routes so their types and imports
+     * refer to the `structures` files.
+     *
+     * @evidence contracts/common.md#principled-implementation HTTP and MCP JSON routes use structural TypeNodes and the writer's registered imports. Empty and any/unknown forms retain their baked keyword distinction because they require no cloned component binding; WebSocket source types only redirect imports actually cloned.
+     * @evidence contracts/common.md#clear-and-simple-design One loop.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The routes are edited in place, as the generation owns them.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkHttpCloneReferencer.replace composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     const replace: (app: ITypedApplication, websocket?: Set<string>) => void;
 }