@nestia/sdk 14.0.1 → 14.0.3

package/lib/analyses/AccessorAnalyzer.js

@@ -2,8 +2,34 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AccessorAnalyzer = void 0;
 const utils_1 = require("@typia/utils");
+/**
+ * Assigns each route the accessor path under which the generated SDK exposes
+ * it.
+ *
+ * @evidence contracts/common.md#principled-implementation The accessors are shrunk where a name repeats, escaped into valid unique identifiers, shrunk again, and each route is renamed to its last accessor segment.
+ * @evidence contracts/common.md#clear-and-simple-design One public function over three private passes.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The passes follow the accessor structure and no route or controller name is special-cased.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * efficient algorithms: For R routes of at most D accessor segments, the prefix maps avoid repeated route-to-route searches. Prefix slicing and joining costs O(R D²) character work before collision escapes; collisions add probes and longer names. Two shrink passes are required around escaping because escaping changes the names being shrunk.
+ * reuse equivalent work: This invocation computes its own result and coordinates no completed or in-flight computation across requests.
+ * bound retention and release resources: This operation owns only invocation-local values, with no retained cache, handle or background task.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation AccessorAnalyzer analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 var AccessorAnalyzer;
 (function (AccessorAnalyzer) {
+    /**
+     * Rewrites the accessor of every route in place so that accessors are valid,
+     * unique, and as short as they can be.
+     *
+     * @evidence contracts/common.md#principled-implementation Segments that repeat their parent are removed when no sibling shares the parent, non-identifier characters become underscores, a segment that collides with an existing accessor gets an underscore prefix, and the route name becomes the last segment.
+     * @evidence contracts/common.md#clear-and-simple-design One function that runs the passes in a fixed order.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The rules apply to every route, and reserved names are computed from the routes themselves.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the passes and the in-place rewrite.
+     * efficient algorithms: For R routes of at most D accessor segments, the prefix maps avoid repeated route-to-route searches. Prefix slicing and joining costs O(R D²) character work before collision escapes; collisions add probes and longer names. Two shrink passes are required around escaping because escaping changes the names being shrunk.
+     * reuse equivalent work: This invocation computes its own result and coordinates no completed or in-flight computation across requests.
+     * bound retention and release resources: This operation owns only invocation-local values, with no retained cache, handle or background task.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation AccessorAnalyzer.analyze analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     AccessorAnalyzer.analyze = (routes) => {
         var _b;
         shrink(routes);

package/lib/analyses/AccessorAnalyzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"AccessorAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/AccessorAnalyzer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AccessorAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/AccessorAnalyzer.ts"],"names":[],"mappings":";;;AAAA,wCAAgD;AAQhD;;;;;;;;;;;;GAYG;AACH,IAAiB,gBAAgB,CAiGhC;AAjGD,WAAiB,gBAAgB;IAC/B;;;;;;;;;;;;OAYG;IACU,wBAAO,GAAG,CAAC,MAAuB,EAAE,EAAE;;QACjD,MAAM,CAAC,MAAM,CAAC,CAAC;QACf,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjB,MAAM,CAAC,MAAM,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,MAAM;YAAE,CAAC,CAAC,IAAI,SAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,mCAAI,CAAC,CAAC,IAAI,CAAC;IAC/D,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,SAA0B,EAAuB,EAAE;QAClE,MAAM,IAAI,GAAwB,IAAI,GAAG,EAAE,CAAC;QAC5C,KAAK,MAAM,KAAK,IAAI,SAAS;YAC3B,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE;;gBAC/B,MAAM,GAAG,GAAW,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC7D,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,mCAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1C,CAAC,CAAC,CAAC;QACL,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,SAA0B,EAAE,EAAE;QAC9C,MAAM,QAAQ,GAAgB,OAAO,CAAC,SAAS,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAwB,IAAI,GAAG,EAAE,CAAC;QAChD,MAAM,IAAI,GAAgB,IAAI,GAAG,EAAE,CAAC;QACpC,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE;gBACrC,MAAM,MAAM,GAAW,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAChE,MAAM,UAAU,GAAuB,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBAC5D,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;oBAC7B,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;oBAC5C,OAAO;gBACT,CAAC;gBAED,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;gBAC/B,OAAO,wBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,KAAK;oBAClD,QAAQ,GAAG,GAAG,GAAG,QAAQ,CAAC;gBAC5B,OAAO,IAAI,EAAE,CAAC;oBACZ,MAAM,OAAO,GAAW,CAAC,GAAG,OAAO,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACzD,IACE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK;wBAC3B,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,IAAI,OAAO,KAAK,MAAM,CAAC,EACvD,CAAC;wBACD,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;wBAC9B,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;wBAClB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;wBACvB,MAAM;oBACR,CAAC;oBACD,QAAQ,GAAG,GAAG,GAAG,QAAQ,CAAC;gBAC5B,CAAC;YACH,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,SAA0B,EAAe,EAAE;QAC1D,MAAM,MAAM,GAAgB,IAAI,GAAG,EAAE,CAAC;QACtC,KAAK,MAAM,KAAK,IAAI,SAAS;YAC3B,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE;gBAC/B,MAAM,OAAO,GAAa,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBACzD,IAAI,OAAO,CAAC,KAAK,CAAC,wBAAgB,CAAC,QAAQ,CAAC;oBAC1C,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAClC,CAAC,CAAC,CAAC;QACL,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,QAAgB,EAAU,EAAE;QAC7C,MAAM,MAAM,GAAW,QAAQ,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;QAChE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;IACtC,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,SAA0B,EAAE,EAAE;;QAC5C,MAAM,IAAI,GAAwB,OAAO,CAAC,SAAS,CAAC,CAAC;QACrD,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,IACE,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;gBACzB,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBAE/C,SAAS;YAEX,MAAM,GAAG,GAAa,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAClD,IAAI,OAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,mCAAI,CAAC,CAAC,GAAG,CAAC;gBAAE,SAAS;YAEjD,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC;QACvB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC,EAjGgB,gBAAgB,aAAhB,gBAAgB,GAAhB,gBAAgB,QAiGhC"}

package/lib/analyses/ConfigAnalyzer.d.ts

@@ -1,7 +1,48 @@
 import { INestApplication } from "@nestjs/common";
 import { INestiaConfig } from "../INestiaConfig";
 import { INestiaSdkInput } from "../structures/INestiaSdkInput";
+/**
+ * Finds the controllers a configuration names, either by compiling and
+ * importing sources or by reading a running application.
+ *
+ * @evidence contracts/common.md#principled-implementation Sources are compiled once through ttsc into a temporary directory, imported, and the exports that carry the Nest `path` metadata are the controllers; an application is read from its module container; results are memoized per configuration object in a weakly keyed map, so a configuration the watcher reloads releases its entry with the object.
+ * @evidence contracts/common.md#clear-and-simple-design Two public functions and a private runtime compiler; the output-specific bundle filter comes from SdkInputFilter and configuration/runtime materializations share the owned-child cleanup registry.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The generated SDK's own files are excluded from the input by the bundle list of the SDK, not by name, and the container is read through internals, as noted at `application`.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * efficient algorithms: Discovery traverses candidate files once, compiles one runtime project and inspects every exported value; work scales with source/compiler input and export population. Application input instead traverses container controllers and resolves each unique class location.
+ * reuse equivalent work: The promise cache shares concurrent and completed analyses for the same config object. It assumes that object, its input sources and application state remain unchanged during its lifetime; callers must supply a fresh config object after changes. Bundle exclusion shares only installed asset descriptions and derives native/realpath roots separately for each output; distinct outputs never reuse one captured prefix.
+ * bound retention and release resources: The weakly keyed input map does not retain released config objects, but emitted directories are registered until owned generation cleanup or process exit. Imported CommonJS/ESM modules remain in the hosting Node loader; direct programmatic callers have no per-generation unload guarantee. CLI watch generations isolate this state in a short-lived child.
+ * @evidence contracts/portability.md#os-neutral-implementation Source/controller identity is obtained from Node path/file-URL conversion, module resolution and native fs. Compiler projects use explicit cwd and native paths; emitted module imports use file URLs. Route prefix/version spelling is kept as protocol text, not treated as filesystem identity.
+ */
 export declare namespace ConfigAnalyzer {
+    /**
+     * Returns the analyzed input of a configuration: the controllers with their
+     * files and the global prefix and versioning options.
+     *
+     * The result is cached per configuration object.
+     *
+     * @evidence contracts/common.md#principled-implementation A function input is asked for the application and read as a running app; otherwise the matched TypeScript sources are compiled and imported, and the memo stores the promise so concurrent callers share one compilation.
+     * @evidence contracts/common.md#clear-and-simple-design One function delegating to `application` or to the runtime compiler.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The cache is keyed by the identity of the configuration object, so a different or reloaded configuration object is never served another's result; one object keeps its first result, which is the contract of a configuration that is not mutated between generations.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the two input forms and the caching.
+     * efficient algorithms: Discovery traverses candidate files once, compiles one runtime project and inspects every exported value; work scales with source/compiler input and export population. Application input instead traverses container controllers and resolves each unique class location.
+     * reuse equivalent work: The promise cache shares concurrent and completed analyses for the same config object. It assumes that object, its input sources and application state remain unchanged during its lifetime; callers must supply a fresh config object after changes. Bundle exclusion shares only installed asset descriptions and derives native/realpath roots separately for each output; distinct outputs never reuse one captured prefix.
+     * bound retention and release resources: The weakly keyed input map does not retain released config objects, but emitted directories are registered until owned generation cleanup or process exit. Imported CommonJS/ESM modules remain in the hosting Node loader; direct programmatic callers have no per-generation unload guarantee. CLI watch generations isolate this state in a short-lived child.
+     * @evidence contracts/portability.md#os-neutral-implementation Source/controller identity is obtained from Node path/file-URL conversion, module resolution and native fs. Compiler projects use explicit cwd and native paths; emitted module imports use file URLs. Route prefix/version spelling is kept as protocol text, not treated as filesystem identity.
+     */
     const input: (config: INestiaConfig) => Promise<INestiaSdkInput>;
+    /**
+     * Reads the controllers, the global prefix, and the versioning options of a
+     * running NestJS application.
+     *
+     * @evidence contracts/common.md#principled-implementation The controllers come from the module container with their module paths, their files from the location of each class, decoded from the `file:` URL, and the prefix and versioning options from the application's configuration.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts NestJS exposes no public accessor for the container or the configuration, so the function reads `app.container` and `app.config`; this is the one foreign-internal read of the package and stays a stated limit.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what is read.
+     * efficient algorithms: The container is traversed once and a hash map groups each class with its module prefixes, so location lookup occurs once per unique controller class.
+     * reuse equivalent work: This invocation computes its own result and coordinates no completed or in-flight computation across requests.
+     * bound retention and release resources: The invocation retains local module/controller collections until it returns. The running application and its controllers remain caller-owned; this reader neither starts nor closes the app.
+     * @evidence contracts/portability.md#os-neutral-implementation Source/controller identity is obtained from Node path/file-URL conversion, module resolution and native fs. Compiler projects use explicit cwd and native paths; emitted module imports use file URLs. Route prefix/version spelling is kept as protocol text, not treated as filesystem identity.
+     */
     const application: (app: INestApplication) => Promise<INestiaSdkInput>;
 }

package/lib/analyses/ConfigAnalyzer.js

@@ -21,15 +21,44 @@ const get_function_location_1 = __importDefault(require("get-function-location")
 const path_1 = __importDefault(require("path"));
 const tstl_1 = require("tstl");
 const url_1 = require("url");
-const SdkGenerator_1 = require("../generates/SdkGenerator");
-const ArrayUtil_1 = require("../utils/ArrayUtil");
 const EmittedJavaScriptPatcher_1 = require("../utils/EmittedJavaScriptPatcher");
 const MapUtil_1 = require("../utils/MapUtil");
+const PathUtil_1 = require("../utils/PathUtil");
+const SdkInputFilter_1 = require("../utils/SdkInputFilter");
 const SourceFinder_1 = require("../utils/SourceFinder");
+const TemporaryDirectory_1 = require("../utils/TemporaryDirectory");
 const TsConfigReader_1 = require("../utils/TsConfigReader");
 const TtscExecutor_1 = require("../utils/TtscExecutor");
+/**
+ * Finds the controllers a configuration names, either by compiling and
+ * importing sources or by reading a running application.
+ *
+ * @evidence contracts/common.md#principled-implementation Sources are compiled once through ttsc into a temporary directory, imported, and the exports that carry the Nest `path` metadata are the controllers; an application is read from its module container; results are memoized per configuration object in a weakly keyed map, so a configuration the watcher reloads releases its entry with the object.
+ * @evidence contracts/common.md#clear-and-simple-design Two public functions and a private runtime compiler; the output-specific bundle filter comes from SdkInputFilter and configuration/runtime materializations share the owned-child cleanup registry.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The generated SDK's own files are excluded from the input by the bundle list of the SDK, not by name, and the container is read through internals, as noted at `application`.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * efficient algorithms: Discovery traverses candidate files once, compiles one runtime project and inspects every exported value; work scales with source/compiler input and export population. Application input instead traverses container controllers and resolves each unique class location.
+ * reuse equivalent work: The promise cache shares concurrent and completed analyses for the same config object. It assumes that object, its input sources and application state remain unchanged during its lifetime; callers must supply a fresh config object after changes. Bundle exclusion shares only installed asset descriptions and derives native/realpath roots separately for each output; distinct outputs never reuse one captured prefix.
+ * bound retention and release resources: The weakly keyed input map does not retain released config objects, but emitted directories are registered until owned generation cleanup or process exit. Imported CommonJS/ESM modules remain in the hosting Node loader; direct programmatic callers have no per-generation unload guarantee. CLI watch generations isolate this state in a short-lived child.
+ * @evidence contracts/portability.md#os-neutral-implementation Source/controller identity is obtained from Node path/file-URL conversion, module resolution and native fs. Compiler projects use explicit cwd and native paths; emitted module imports use file URLs. Route prefix/version spelling is kept as protocol text, not treated as filesystem identity.
+ */
 var ConfigAnalyzer;
 (function (ConfigAnalyzer) {
+    /**
+     * Returns the analyzed input of a configuration: the controllers with their
+     * files and the global prefix and versioning options.
+     *
+     * The result is cached per configuration object.
+     *
+     * @evidence contracts/common.md#principled-implementation A function input is asked for the application and read as a running app; otherwise the matched TypeScript sources are compiled and imported, and the memo stores the promise so concurrent callers share one compilation.
+     * @evidence contracts/common.md#clear-and-simple-design One function delegating to `application` or to the runtime compiler.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The cache is keyed by the identity of the configuration object, so a different or reloaded configuration object is never served another's result; one object keeps its first result, which is the contract of a configuration that is not mutated between generations.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the two input forms and the caching.
+     * efficient algorithms: Discovery traverses candidate files once, compiles one runtime project and inspects every exported value; work scales with source/compiler input and export population. Application input instead traverses container controllers and resolves each unique class location.
+     * reuse equivalent work: The promise cache shares concurrent and completed analyses for the same config object. It assumes that object, its input sources and application state remain unchanged during its lifetime; callers must supply a fresh config object after changes. Bundle exclusion shares only installed asset descriptions and derives native/realpath roots separately for each output; distinct outputs never reuse one captured prefix.
+     * bound retention and release resources: The weakly keyed input map does not retain released config objects, but emitted directories are registered until owned generation cleanup or process exit. Imported CommonJS/ESM modules remain in the hosting Node loader; direct programmatic callers have no per-generation unload guarantee. CLI watch generations isolate this state in a short-lived child.
+     * @evidence contracts/portability.md#os-neutral-implementation Source/controller identity is obtained from Node path/file-URL conversion, module resolution and native fs. Compiler projects use explicit cwd and native paths; emitted module imports use file URLs. Route prefix/version spelling is kept as protocol text, not treated as filesystem identity.
+     */
     ConfigAnalyzer.input = (config) => __awaiter(this, void 0, void 0, function* () {
         return MapUtil_1.MapUtil.take(memory, config, () => __awaiter(this, void 0, void 0, function* () {
             var _a;
@@ -44,7 +73,7 @@ var ConfigAnalyzer;
                 exclude: typeof config.input === "object" && !Array.isArray(config.input)
                     ? ((_a = config.input.exclude) !== null && _a !== void 0 ? _a : [])
                     : [],
-                filter: filter(config),
+                filter: yield SdkInputFilter_1.SdkInputFilter.create(config.output),
             });
             const runtime = yield RuntimeCompiler.compile(sources);
             const controllers = [];
@@ -67,6 +96,19 @@ var ConfigAnalyzer;
             };
         }));
     });
+    /**
+     * Reads the controllers, the global prefix, and the versioning options of a
+     * running NestJS application.
+     *
+     * @evidence contracts/common.md#principled-implementation The controllers come from the module container with their module paths, their files from the location of each class, decoded from the `file:` URL, and the prefix and versioning options from the application's configuration.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts NestJS exposes no public accessor for the container or the configuration, so the function reads `app.container` and `app.config`; this is the one foreign-internal read of the package and stays a stated limit.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what is read.
+     * efficient algorithms: The container is traversed once and a hash map groups each class with its module prefixes, so location lookup occurs once per unique controller class.
+     * reuse equivalent work: This invocation computes its own result and coordinates no completed or in-flight computation across requests.
+     * bound retention and release resources: The invocation retains local module/controller collections until it returns. The running application and its controllers remain caller-owned; this reader neither starts nor closes the app.
+     * @evidence contracts/portability.md#os-neutral-implementation Source/controller identity is obtained from Node path/file-URL conversion, module resolution and native fs. Compiler projects use explicit cwd and native paths; emitted module imports use file URLs. Route prefix/version spelling is kept as protocol text, not treated as filesystem identity.
+     */
     ConfigAnalyzer.application = (app) => __awaiter(this, void 0, void 0, function* () {
         var _a, _b, _c, _d;
         var _e, _f, _g, _h, _j;
@@ -84,7 +126,7 @@ var ConfigAnalyzer;
             const file = (_g = (_a = (yield (0, get_function_location_1.default)(it.first))) === null || _a === void 0 ? void 0 : _a.source) !== null && _g !== void 0 ? _g : null;
             if (file === null)
                 continue;
-            const location = normalize_file(file);
+            const location = PathUtil_1.PathUtil.location(file);
             if (location.length === 0)
                 continue;
             controllers.push({
@@ -113,7 +155,7 @@ var ConfigAnalyzer;
         };
     });
 })(ConfigAnalyzer || (exports.ConfigAnalyzer = ConfigAnalyzer = {}));
-const memory = new Map();
+const memory = new WeakMap();
 class RuntimeCompiler {
     constructor(cwd, outDir) {
         this.cwd = cwd;
@@ -121,25 +163,25 @@ class RuntimeCompiler {
     }
     static compile(sources) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a;
+            var _a, _b;
             const cwd = process.cwd();
             const runtimeRoot = path_1.default.join(cwd, "node_modules", ".nestia", "runtime");
-            yield fs_1.default.promises.mkdir(runtimeRoot, { recursive: true });
-            ensureRuntimeCleanup(runtimeRoot);
-            const outDir = yield fs_1.default.promises.mkdtemp(path_1.default.join(runtimeRoot, "run-"));
-            const project = path_1.default.join(cwd, `.nestia.runtime.${process.pid}.${Date.now()}.json`);
-            const relative = (file) => path_1.default.relative(cwd, file).split("\\").join("/");
+            const outDir = TemporaryDirectory_1.TemporaryDirectory.create(runtimeRoot, "run-");
+            // Compiler materializations belong below node_modules with their emitted
+            // output. A project file in cwd is itself a watched JSON input and would
+            // schedule another generation when this compilation creates/removes it.
+            const project = path_1.default.join(outDir, "tsconfig.json");
             yield fs_1.default.promises.writeFile(project, JSON.stringify({
-                extends: normalizeProjectPath(process.env.NESTIA_PROJECT),
+                extends: path_1.default.resolve(cwd, (_a = process.env.NESTIA_PROJECT) !== null && _a !== void 0 ? _a : "tsconfig.json"),
                 compilerOptions: {
                     noEmit: false,
                     noUnusedLocals: false,
                     noUnusedParameters: false,
                     outDir,
                     plugins: yield runtimePlugins(cwd),
-                    rootDir: ".",
+                    rootDir: cwd,
                 },
-                include: sources.map(relative),
+                include: sources.map((file) => path_1.default.resolve(cwd, file)),
             }, null, 2), "utf8");
             try {
                 TtscExecutor_1.TtscExecutor.run({
@@ -150,7 +192,7 @@ class RuntimeCompiler {
             }
             catch (error) {
                 const output = error instanceof Error && "stderr" in error
-                    ? String((_a = error.stderr) !== null && _a !== void 0 ? _a : "")
+                    ? String((_b = error.stderr) !== null && _b !== void 0 ? _b : "")
                     : "";
                 throw new Error(output || `Failed to compile Nestia runtime inputs.`);
             }
@@ -167,41 +209,6 @@ class RuntimeCompiler {
         return emitted;
     }
 }
-const RUNTIME_ROOTS = new Set();
-let RUNTIME_CLEANUP_REGISTERED = false;
-const ensureRuntimeCleanup = (runtimeRoot) => {
-    RUNTIME_ROOTS.add(runtimeRoot);
-    if (RUNTIME_CLEANUP_REGISTERED === true)
-        return;
-    RUNTIME_CLEANUP_REGISTERED = true;
-    const sweep = () => {
-        for (const location of RUNTIME_ROOTS)
-            fs_1.default.rmSync(location, { force: true, recursive: true });
-    };
-    process.once("exit", sweep);
-    // process.once("exit", …) does not fire on SIGINT/SIGTERM. Without these
-    // handlers a Ctrl-C during codegen leaves `run-*` mkdtemp directories
-    // behind under node_modules/.nestia/runtime/ until a subsequent clean exit.
-    // The module-level RUNTIME_CLEANUP_REGISTERED flag above guards against
-    // re-entrancy within this module; we deliberately do NOT gate on
-    // `process.listenerCount(signal) > 0` because NestiaConfigLoader's parallel
-    // sweep registers first, and that gate would skip our registration —
-    // leaving RUNTIME_ROOTS unswept on Ctrl-C while config-loader cleans up.
-    // Windows note: `process.kill(pid, "SIGINT")` calls TerminateProcess
-    // rather than re-raising through the listener queue, so the handler
-    // cascade documented above only holds on POSIX. On Windows, whichever
-    // module registers FIRST runs its sweep and the second is skipped —
-    // RUNTIME_ROOTS cleanup is best-effort there. SIGHUP is a no-op for
-    // most common code paths on Windows (Node fires it on console-close
-    // and exits within seconds).
-    const onSignal = (signal) => {
-        sweep();
-        process.kill(process.pid, signal);
-    };
-    for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) {
-        process.once(signal, onSignal);
-    }
-};
 const sdkTransformEnv = () => process.env.NESTIA_SDK_TRANSFORM === undefined
     ? { NESTIA_SDK_TRANSFORM: "1" }
     : {};
@@ -243,35 +250,5 @@ const normalizeProjectPath = (project) => {
     const next = project !== null && project !== void 0 ? project : "tsconfig.json";
     return path_1.default.isAbsolute(next) || next.startsWith(".") ? next : `./${next}`;
 };
-const normalize_file = (str) => str.substring(str.startsWith("file:///")
-    ? process.cwd()[0] === "/"
-        ? 7
-        : 8
-    : str.startsWith("file://")
-        ? 7
-        : 0);
-const filter = (config) => (location) => __awaiter(void 0, void 0, void 0, function* () {
-    return SourceFinder_1.SourceFinder.isTypeScriptSource(location) &&
-        (config.output === undefined ||
-            (location.indexOf(path_1.default.join(config.output, "functional")) === -1 &&
-                (yield (yield bundler.get(config.output))(location))) === false);
-});
 const dynamicImport = Function("specifier", "return import(specifier);");
-const bundler = new tstl_1.Singleton((output) => __awaiter(void 0, void 0, void 0, function* () {
-    const assets = yield fs_1.default.promises.readdir(SdkGenerator_1.SdkGenerator.BUNDLE_PATH);
-    const tuples = yield ArrayUtil_1.ArrayUtil.asyncMap(assets, (file) => __awaiter(void 0, void 0, void 0, function* () {
-        const relative = path_1.default.join(output, file);
-        const location = path_1.default.join(SdkGenerator_1.SdkGenerator.BUNDLE_PATH, file);
-        const stats = yield fs_1.default.promises.stat(location);
-        return new tstl_1.Pair(relative, stats.isDirectory());
-    }));
-    return (file) => __awaiter(void 0, void 0, void 0, function* () {
-        for (const it of tuples)
-            if (it.second === false && file === it.first)
-                return true;
-            else if (it.second === true && file.indexOf(it.first) === 0)
-                return true;
-        return false;
-    });
-}));
 //# sourceMappingURL=ConfigAnalyzer.js.map

package/lib/analyses/ConfigAnalyzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/ConfigAnalyzer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,8DAA8D;AAC9D,2CAAkE;AAClE,wDAAuD;AAGvD,4CAAoB;AACpB,kFAAwD;AACxD,gDAAwB;AACxB,+BAAgD;AAChD,6BAAoC;AAGpC,4DAAyD;AAEzD,kDAA+C;AAC/C,gFAA6E;AAC7E,8CAA2C;AAC3C,wDAAqD;AACrD,4DAAyD;AACzD,wDAAqD;AAErD,IAAiB,cAAc,CAoG9B;AApGD,WAAiB,cAAc;IAChB,oBAAK,GAAG,CACnB,MAAqB,EACK,EAAE;QAC5B,OAAO,iBAAO,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAS,EAAE;;YAC7C,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,UAAU;gBACpC,OAAO,0BAAW,CAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAE3C,MAAM,OAAO,GAAa,MAAM,2BAAY,CAAC,IAAI,CAAC;gBAChD,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;oBAClC,CAAC,CAAC,MAAM,CAAC,KAAK;oBACd,CAAC,CAAC,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;wBAChC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO;wBACtB,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBACpB,OAAO,EACL,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;oBAC9D,CAAC,CAAC,OAAC,MAAM,CAAC,KAAK,CAAC,OAAO,mCAAI,EAAE,CAAC;oBAC9B,CAAC,CAAC,EAAE;gBACR,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;aACvB,CAAC,CAAC;YACH,MAAM,OAAO,GAAoB,MAAM,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACxE,MAAM,WAAW,GAAkC,EAAE,CAAC;YACtD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;gBAC3B,MAAM,QAAQ,GAA4B,MAAM,aAAa,CAC3D,IAAA,mBAAa,EAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CACzC,CAAC;gBACF,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;oBAC3B,MAAM,QAAQ,GAAY,QAAQ,CAAC,GAAG,CAAC,CAAC;oBACxC,IAAI,OAAO,QAAQ,KAAK,UAAU;wBAAE,SAAS;oBAC7C,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,SAAS;wBACrD,WAAW,CAAC,IAAI,CAAC;4BACf,KAAK,EAAE,QAAQ;4BACf,QAAQ,EAAE,IAAI;4BACd,QAAQ,EAAE,EAAE;yBACb,CAAC,CAAC;gBACP,CAAC;YACH,CAAC;YACD,OAAO;gBACL,WAAW;aACZ,CAAC;QACJ,CAAC,CAAA,CAAC,CAAC;IACL,CAAC,CAAA,CAAC;IAEW,0BAAW,GAAG,CACzB,GAAqB,EACK,EAAE;;;QAC5B,MAAM,SAAS,GAAmB,GAAW,CAAC,SAA0B,CAAC;QACzE,MAAM,OAAO,GAAa,CAAC,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CACnE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAC5B,CAAC;QACF,MAAM,MAAM,GAAmC,IAAI,cAAO,EAAE,CAAC;QAE7D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,eACR,OAAO,CAAC,WAAW,CACjB,uBAAW,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC,aAAa,EAClD,CAAC,CAAC,QAAQ,CACX,mCACD,OAAO,CAAC,WAAW,CAAC,uBAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,mCAC5C,EAAE,CAAC;YACL,KAAK,MAAM,UAAU,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;gBAChD,IAAI,OAAO,UAAU,KAAK,UAAU;oBAClC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,WAAW,GAAkC,EAAE,CAAC;QACtD,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,SACR,MAAA,CAAC,MAAM,IAAA,+BAAmB,EAAC,EAAE,CAAC,KAAK,CAAC,CAAC,0CAAE,MAAM,mCAAI,IAAI,CAAC;YACxD,IAAI,IAAI,KAAK,IAAI;gBAAE,SAAS;YAC5B,MAAM,QAAQ,GAAW,cAAc,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YACpC,WAAW,CAAC,IAAI,CAAC;gBACf,KAAK,EAAE,EAAE,CAAC,KAAK;gBACf,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC;gBAC/B,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;QAED,MAAM,UAAU,GAAG,MAAC,GAAW,CAAC,MAAM,0CAAE,iBAAiB,CAAC;QAC1D,OAAO;YACL,WAAW;YACX,YAAY,EACV,QAAO,MAAC,GAAW,CAAC,MAAM,0CAAE,YAAY,CAAA,KAAK,QAAQ;gBACnD,CAAC,CAAC;oBACE,MAAM,EAAG,GAAW,CAAC,MAAM,CAAC,YAAY;oBACxC,OAAO,QAAE,MAAC,GAAW,CAAC,MAAM,CAAC,mBAAmB,0CAAE,OAAO,mCAAI,EAAE;iBAChE;gBACH,CAAC,CAAC,SAAS;YACf,UAAU,EACR,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,IAAI,KAAK,uBAAc,CAAC,GAAG;gBAChE,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC;oBACE,iEAAiE;oBACjE,2DAA2D;oBAC3D,MAAM,EACJ,UAAU,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAC,UAAU,CAAC,MAAM,mCAAI,GAAG,CAAC;oBAC/D,cAAc,EAAE,UAAU,CAAC,cAAc;iBAC1C;SACR,CAAC;IACJ,CAAC,CAAA,CAAC;AACJ,CAAC,EApGgB,cAAc,aAAd,cAAc,GAAd,cAAc,QAoG9B;AACD,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2C,CAAC;AAClE,MAAM,eAAe;IACnB,YACmB,GAAW,EACX,MAAc;mBADd,GAAG;sBACH,MAAM;IACtB,CAAC;IAEG,MAAM,CAAO,OAAO,CAAC,OAAiB;;;YAC3C,MAAM,GAAG,GAAW,OAAO,CAAC,GAAG,EAAE,CAAC;YAClC,MAAM,WAAW,GAAW,cAAI,CAAC,IAAI,CACnC,GAAG,EACH,cAAc,EACd,SAAS,EACT,SAAS,CACV,CAAC;YACF,MAAM,YAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1D,oBAAoB,CAAC,WAAW,CAAC,CAAC;YAClC,MAAM,MAAM,GAAW,MAAM,YAAE,CAAC,QAAQ,CAAC,OAAO,CAC9C,cAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAC/B,CAAC;YACF,MAAM,OAAO,GAAW,cAAI,CAAC,IAAI,CAC/B,GAAG,EACH,mBAAmB,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,OAAO,CACpD,CAAC;YACF,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAU,EAAE,CACxC,cAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjD,MAAM,YAAE,CAAC,QAAQ,CAAC,SAAS,CACzB,OAAO,EACP,IAAI,CAAC,SAAS,CACZ;gBACE,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;gBACzD,eAAe,EAAE;oBACf,MAAM,EAAE,KAAK;oBACb,cAAc,EAAE,KAAK;oBACrB,kBAAkB,EAAE,KAAK;oBACzB,MAAM;oBACN,OAAO,EAAE,MAAM,cAAc,CAAC,GAAG,CAAC;oBAClC,OAAO,EAAE,GAAG;iBACb;gBACD,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;aAC/B,EACD,IAAI,EACJ,CAAC,CACF,EACD,MAAM,CACP,CAAC;YACF,IAAI,CAAC;gBACH,2BAAY,CAAC,GAAG,CAAC;oBACf,GAAG;oBACH,GAAG,EAAE,eAAe,EAAE;oBACtB,OAAO;iBACR,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,MAAM,GACV,KAAK,YAAY,KAAK,IAAI,QAAQ,IAAI,KAAK;oBACzC,CAAC,CAAC,MAAM,OAAE,KAAqC,CAAC,MAAM,mCAAI,EAAE,CAAC;oBAC7D,CAAC,CAAC,EAAE,CAAC;gBACT,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,0CAA0C,CAAC,CAAC;YACxE,CAAC;oBAAS,CAAC;gBACT,MAAM,YAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACjD,CAAC;YACD,MAAM,mDAAwB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YACrD,OAAO,IAAI,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;KAAA;IAEM,MAAM,CAAC,MAAc;QAC1B,MAAM,QAAQ,GAAW,cAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACzD,MAAM,OAAO,GAAW,cAAI,CAAC,IAAI,CAC/B,IAAI,CAAC,MAAM,EACX,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAClC,CAAC;QACF,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,MAAM,aAAa,GAAgB,IAAI,GAAG,EAAE,CAAC;AAC7C,IAAI,0BAA0B,GAAY,KAAK,CAAC;AAEhD,MAAM,oBAAoB,GAAG,CAAC,WAAmB,EAAQ,EAAE;IACzD,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC/B,IAAI,0BAA0B,KAAK,IAAI;QAAE,OAAO;IAChD,0BAA0B,GAAG,IAAI,CAAC;IAClC,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,KAAK,MAAM,QAAQ,IAAI,aAAa;YAClC,YAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC5B,yEAAyE;IACzE,sEAAsE;IACtE,4EAA4E;IAC5E,wEAAwE;IACxE,iEAAiE;IACjE,4EAA4E;IAC5E,qEAAqE;IACrE,yEAAyE;IACzE,qEAAqE;IACrE,oEAAoE;IACpE,sEAAsE;IACtE,oEAAoE;IACpE,oEAAoE;IACpE,oEAAoE;IACpE,6BAA6B;IAC7B,MAAM,QAAQ,GAAG,CAAC,MAAsB,EAAQ,EAAE;QAChD,KAAK,EAAE,CAAC;QACR,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC,CAAC;IACF,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,EAAE,CAAC;QAC9D,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjC,CAAC;AACH,CAAC,CAAC;AAIF,MAAM,eAAe,GAAG,GAAsB,EAAE,CAC9C,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,SAAS;IAC5C,CAAC,CAAC,EAAE,oBAAoB,EAAE,GAAG,EAAE;IAC/B,CAAC,CAAC,EAAE,CAAC;AAET,MAAM,cAAc,GAAG,CAAO,GAAW,EAA4B,EAAE;IACrE,MAAM,OAAO,GAAoB,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC/D,MAAM,KAAK,GAA8B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1D,WAAW,CAAC,CAAC,EAAE,OAAO,CAAC,CACxB,CAAC;IACF,MAAM,IAAI,GAA8B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACzD,WAAW,CAAC,CAAC,EAAE,cAAc,CAAC,CAC/B,CAAC;IACF,OAAO;wCAEA,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,CAAC,KAChB,SAAS,EAAE,qBAAqB,EAChC,OAAO,EAAE,KAAK;QAEhB,sBAAsB,iCACjB,CAAC,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,EAAE,CAAC,KACf,SAAS,EAAE,mCAAmC,IAC9C;KACH,CAAC;AACJ,CAAC,CAAA,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAO,GAAW,EAA4B,EAAE;IACzE,MAAM,OAAO,GAAW,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACzE,MAAM,IAAI,GAAW,cAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAC3C,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC5B,MAAM,MAAM,GAAG,MAAM,+BAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,eAEV,CAAC;IACd,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,CAAC;QACpC,CAAC,CAAC,OAAO,CAAC,OAAO;aACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC;aAClD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAO,CAA8B,EAAG,CAAC;QACzD,CAAC,CAAC,EAAE,CAAC;AACT,CAAC,CAAA,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAAC,MAAqB,EAAiB,EAAE;IACtE,MAAM,MAAM,qBAAuB,MAAM,CAAE,CAAC;IAC5C,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IACpD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,MAAqB,EAAE,IAAY,EAAW,EAAE,CACnE,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAE1E,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,SAAiB,EAAU,EAAE,CACnE,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE,CACxC,OAAO,CAAC,WAAW,EAAE,KAAK,MAAM;IAC9B,CAAC,CAAC,MAAM;IACR,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,MAAM;QAChC,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,SAAS,CAChB,CAAC;AAEJ,MAAM,oBAAoB,GAAG,CAAC,OAA2B,EAAU,EAAE;IACnE,MAAM,IAAI,GAAW,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,eAAe,CAAC;IAChD,OAAO,cAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;AAC5E,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,GAAW,EAAE,EAAE,CACrC,GAAG,CAAC,SAAS,CACX,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC;IACxB,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG;QACxB,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,CAAC,CACR,CAAC;AAEJ,MAAM,MAAM,GACV,CAAC,MAAqB,EAAE,EAAE,CAC1B,CAAO,QAAgB,EAAoB,EAAE;IAC3C,OAAA,2BAAY,CAAC,kBAAkB,CAAC,QAAQ,CAAC;QACzC,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS;YAC1B,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC;gBAC9D,CAAC,MAAM,CACL,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CACjC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAA;AAAA,CAAC,CAAD,CAAC;AAEjC,MAAM,aAAa,GAAwC,QAAQ,CACjE,WAAW,EACX,2BAA2B,CACW,CAAC;AAEzC,MAAM,OAAO,GAAG,IAAI,gBAAS,CAAC,CAAO,MAAc,EAAE,EAAE;IACrD,MAAM,MAAM,GAAa,MAAM,YAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,2BAAY,CAAC,WAAW,CAAC,CAAC;IAC7E,MAAM,MAAM,GAA4B,MAAM,qBAAS,CAAC,QAAQ,CAC9D,MAAM,EACN,CAAO,IAAI,EAAE,EAAE;QACb,MAAM,QAAQ,GAAW,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAW,cAAI,CAAC,IAAI,CAAC,2BAAY,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACnE,MAAM,KAAK,GAAa,MAAM,YAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzD,OAAO,IAAI,WAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACjD,CAAC,CAAA,CACF,CAAC;IACF,OAAO,CAAO,IAAY,EAAoB,EAAE;QAC9C,KAAK,MAAM,EAAE,IAAI,MAAM;YACrB,IAAI,EAAE,CAAC,MAAM,KAAK,KAAK,IAAI,IAAI,KAAK,EAAE,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;iBACrD,IAAI,EAAE,CAAC,MAAM,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC,CAAA,CAAC;AACJ,CAAC,CAAA,CAAC,CAAC"}
+{"version":3,"file":"ConfigAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/ConfigAnalyzer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,8DAA8D;AAC9D,2CAAkE;AAClE,wDAAuD;AAGvD,4CAAoB;AACpB,kFAAwD;AACxD,gDAAwB;AACxB,+BAA+B;AAC/B,6BAAoC;AAIpC,gFAA6E;AAC7E,8CAA2C;AAC3C,gDAA6C;AAC7C,4DAAyD;AACzD,wDAAqD;AACrD,oEAAiE;AACjE,4DAAyD;AACzD,wDAAqD;AAErD;;;;;;;;;;;;GAYG;AACH,IAAiB,cAAc,CAgI9B;AAhID,WAAiB,cAAc;IAC7B;;;;;;;;;;;;;;OAcG;IACU,oBAAK,GAAG,CACnB,MAAqB,EACK,EAAE;QAC5B,OAAO,iBAAO,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAS,EAAE;;YAC7C,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,UAAU;gBACpC,OAAO,0BAAW,CAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAE3C,MAAM,OAAO,GAAa,MAAM,2BAAY,CAAC,IAAI,CAAC;gBAChD,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;oBAClC,CAAC,CAAC,MAAM,CAAC,KAAK;oBACd,CAAC,CAAC,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;wBAChC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO;wBACtB,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBACpB,OAAO,EACL,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;oBAC9D,CAAC,CAAC,OAAC,MAAM,CAAC,KAAK,CAAC,OAAO,mCAAI,EAAE,CAAC;oBAC9B,CAAC,CAAC,EAAE;gBACR,MAAM,EAAE,MAAM,+BAAc,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;aACnD,CAAC,CAAC;YACH,MAAM,OAAO,GAAoB,MAAM,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACxE,MAAM,WAAW,GAAkC,EAAE,CAAC;YACtD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;gBAC3B,MAAM,QAAQ,GAA4B,MAAM,aAAa,CAC3D,IAAA,mBAAa,EAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CACzC,CAAC;gBACF,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;oBAC3B,MAAM,QAAQ,GAAY,QAAQ,CAAC,GAAG,CAAC,CAAC;oBACxC,IAAI,OAAO,QAAQ,KAAK,UAAU;wBAAE,SAAS;oBAC7C,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,SAAS;wBACrD,WAAW,CAAC,IAAI,CAAC;4BACf,KAAK,EAAE,QAAQ;4BACf,QAAQ,EAAE,IAAI;4BACd,QAAQ,EAAE,EAAE;yBACb,CAAC,CAAC;gBACP,CAAC;YACH,CAAC;YACD,OAAO;gBACL,WAAW;aACZ,CAAC;QACJ,CAAC,CAAA,CAAC,CAAC;IACL,CAAC,CAAA,CAAC;IAEF;;;;;;;;;;;;OAYG;IACU,0BAAW,GAAG,CACzB,GAAqB,EACK,EAAE;;;QAC5B,MAAM,SAAS,GAAmB,GAAW,CAAC,SAA0B,CAAC;QACzE,MAAM,OAAO,GAAa,CAAC,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CACnE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAC5B,CAAC;QACF,MAAM,MAAM,GAAmC,IAAI,cAAO,EAAE,CAAC;QAE7D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,eACR,OAAO,CAAC,WAAW,CACjB,uBAAW,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC,aAAa,EAClD,CAAC,CAAC,QAAQ,CACX,mCACD,OAAO,CAAC,WAAW,CAAC,uBAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,mCAC5C,EAAE,CAAC;YACL,KAAK,MAAM,UAAU,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;gBAChD,IAAI,OAAO,UAAU,KAAK,UAAU;oBAClC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,WAAW,GAAkC,EAAE,CAAC;QACtD,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,SACR,MAAA,CAAC,MAAM,IAAA,+BAAmB,EAAC,EAAE,CAAC,KAAK,CAAC,CAAC,0CAAE,MAAM,mCAAI,IAAI,CAAC;YACxD,IAAI,IAAI,KAAK,IAAI;gBAAE,SAAS;YAC5B,MAAM,QAAQ,GAAW,mBAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACjD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YACpC,WAAW,CAAC,IAAI,CAAC;gBACf,KAAK,EAAE,EAAE,CAAC,KAAK;gBACf,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC;gBAC/B,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;QAED,MAAM,UAAU,GAAG,MAAC,GAAW,CAAC,MAAM,0CAAE,iBAAiB,CAAC;QAC1D,OAAO;YACL,WAAW;YACX,YAAY,EACV,QAAO,MAAC,GAAW,CAAC,MAAM,0CAAE,YAAY,CAAA,KAAK,QAAQ;gBACnD,CAAC,CAAC;oBACE,MAAM,EAAG,GAAW,CAAC,MAAM,CAAC,YAAY;oBACxC,OAAO,QAAE,MAAC,GAAW,CAAC,MAAM,CAAC,mBAAmB,0CAAE,OAAO,mCAAI,EAAE;iBAChE;gBACH,CAAC,CAAC,SAAS;YACf,UAAU,EACR,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,IAAI,KAAK,uBAAc,CAAC,GAAG;gBAChE,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC;oBACE,iEAAiE;oBACjE,2DAA2D;oBAC3D,MAAM,EACJ,UAAU,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAC,UAAU,CAAC,MAAM,mCAAI,GAAG,CAAC;oBAC/D,cAAc,EAAE,UAAU,CAAC,cAAc;iBAC1C;SACR,CAAC;IACJ,CAAC,CAAA,CAAC;AACJ,CAAC,EAhIgB,cAAc,aAAd,cAAc,GAAd,cAAc,QAgI9B;AACD,MAAM,MAAM,GAAG,IAAI,OAAO,EAA2C,CAAC;AACtE,MAAM,eAAe;IACnB,YACmB,GAAW,EACX,MAAc;mBADd,GAAG;sBACH,MAAM;IACtB,CAAC;IAEG,MAAM,CAAO,OAAO,CAAC,OAAiB;;;YAC3C,MAAM,GAAG,GAAW,OAAO,CAAC,GAAG,EAAE,CAAC;YAClC,MAAM,WAAW,GAAW,cAAI,CAAC,IAAI,CACnC,GAAG,EACH,cAAc,EACd,SAAS,EACT,SAAS,CACV,CAAC;YACF,MAAM,MAAM,GAAW,uCAAkB,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YACtE,yEAAyE;YACzE,yEAAyE;YACzE,wEAAwE;YACxE,MAAM,OAAO,GAAW,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;YAC3D,MAAM,YAAE,CAAC,QAAQ,CAAC,SAAS,CACzB,OAAO,EACP,IAAI,CAAC,SAAS,CACZ;gBACE,OAAO,EAAE,cAAI,CAAC,OAAO,CACnB,GAAG,QACH,OAAO,CAAC,GAAG,CAAC,cAAc,mCAAI,eAAe,CAC9C;gBACD,eAAe,EAAE;oBACf,MAAM,EAAE,KAAK;oBACb,cAAc,EAAE,KAAK;oBACrB,kBAAkB,EAAE,KAAK;oBACzB,MAAM;oBACN,OAAO,EAAE,MAAM,cAAc,CAAC,GAAG,CAAC;oBAClC,OAAO,EAAE,GAAG;iBACb;gBACD,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;aACxD,EACD,IAAI,EACJ,CAAC,CACF,EACD,MAAM,CACP,CAAC;YACF,IAAI,CAAC;gBACH,2BAAY,CAAC,GAAG,CAAC;oBACf,GAAG;oBACH,GAAG,EAAE,eAAe,EAAE;oBACtB,OAAO;iBACR,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,MAAM,GACV,KAAK,YAAY,KAAK,IAAI,QAAQ,IAAI,KAAK;oBACzC,CAAC,CAAC,MAAM,OAAE,KAAqC,CAAC,MAAM,mCAAI,EAAE,CAAC;oBAC7D,CAAC,CAAC,EAAE,CAAC;gBACT,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,0CAA0C,CAAC,CAAC;YACxE,CAAC;oBAAS,CAAC;gBACT,MAAM,YAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACjD,CAAC;YACD,MAAM,mDAAwB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YACrD,OAAO,IAAI,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;KAAA;IAEM,MAAM,CAAC,MAAc;QAC1B,MAAM,QAAQ,GAAW,cAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACzD,MAAM,OAAO,GAAW,cAAI,CAAC,IAAI,CAC/B,IAAI,CAAC,MAAM,EACX,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAClC,CAAC;QACF,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAID,MAAM,eAAe,GAAG,GAAsB,EAAE,CAC9C,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,SAAS;IAC5C,CAAC,CAAC,EAAE,oBAAoB,EAAE,GAAG,EAAE;IAC/B,CAAC,CAAC,EAAE,CAAC;AAET,MAAM,cAAc,GAAG,CAAO,GAAW,EAA4B,EAAE;IACrE,MAAM,OAAO,GAAoB,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC/D,MAAM,KAAK,GAA8B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1D,WAAW,CAAC,CAAC,EAAE,OAAO,CAAC,CACxB,CAAC;IACF,MAAM,IAAI,GAA8B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACzD,WAAW,CAAC,CAAC,EAAE,cAAc,CAAC,CAC/B,CAAC;IACF,OAAO;wCAEA,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,CAAC,KAChB,SAAS,EAAE,qBAAqB,EAChC,OAAO,EAAE,KAAK;QAEhB,sBAAsB,iCACjB,CAAC,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,EAAE,CAAC,KACf,SAAS,EAAE,mCAAmC,IAC9C;KACH,CAAC;AACJ,CAAC,CAAA,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAO,GAAW,EAA4B,EAAE;IACzE,MAAM,OAAO,GAAW,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACzE,MAAM,IAAI,GAAW,cAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAC3C,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC5B,MAAM,MAAM,GAAG,MAAM,+BAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,eAEV,CAAC;IACd,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,CAAC;QACpC,CAAC,CAAC,OAAO,CAAC,OAAO;aACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC;aAClD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAO,CAA8B,EAAG,CAAC;QACzD,CAAC,CAAC,EAAE,CAAC;AACT,CAAC,CAAA,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAAC,MAAqB,EAAiB,EAAE;IACtE,MAAM,MAAM,qBAAuB,MAAM,CAAE,CAAC;IAC5C,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IACpD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,MAAqB,EAAE,IAAY,EAAW,EAAE,CACnE,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAE1E,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,SAAiB,EAAU,EAAE,CACnE,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE,CACxC,OAAO,CAAC,WAAW,EAAE,KAAK,MAAM;IAC9B,CAAC,CAAC,MAAM;IACR,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,MAAM;QAChC,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,SAAS,CAChB,CAAC;AAEJ,MAAM,oBAAoB,GAAG,CAAC,OAA2B,EAAU,EAAE;IACnE,MAAM,IAAI,GAAW,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,eAAe,CAAC;IAChD,OAAO,cAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;AAC5E,CAAC,CAAC;AAEF,MAAM,aAAa,GAAwC,QAAQ,CACjE,WAAW,EACX,2BAA2B,CACW,CAAC"}

package/lib/analyses/ImportAnalyzer.d.ts

@@ -1,4 +1,13 @@
 import { IReflectImport } from "../structures/IReflectImport";
+/**
+ * Helpers for the import lists of routes.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace merges the imports collected for one route and keeps a removal notice for the old analysis entry.
+ * @evidence contracts/common.md#clear-and-simple-design Two functions.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The merge is generic.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ImportAnalyzer analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 export declare namespace ImportAnalyzer {
     /**
      * @deprecated Removed in the Go-migration cycle. Import metadata is now
@@ -8,7 +17,23 @@ export declare namespace ImportAnalyzer {
      *   `ts.SourceFile` to derive imports should read the metadata delivered
      *   through `Reflect.getMetadata("nestia/OperationMetadata", …)` instead. See
      *   `packages/core/MIGRATION.md`.
+     * @evidence contracts/common.md#principled-implementation The function exists only to give an actionable error to a caller of the removed API, and always throws.
+     * @evidence contracts/common.md#clear-and-simple-design One statement.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It reports the removal instead of failing later with a missing function.
+     * @evidence contracts/common.md#meaningful-documentation The comment names the replacement.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ImportAnalyzer.analyze analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
      */
     const analyze: () => never;
+    /**
+     * Merges import records by file: namespace imports and default imports are
+     * deduplicated and sorted, and the named elements of every import of a file
+     * are combined with their aliases.
+     *
+     * @evidence contracts/common.md#principled-implementation Imports are grouped by file, each group emits its namespace imports, default imports, and one element list with an alias map for renamed elements, so the same file is imported once per kind.
+     * @evidence contracts/common.md#clear-and-simple-design One function over one group merger.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The merge follows the import records, with no file special-cased.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the grouping and the merging.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ImportAnalyzer.merge analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     const merge: (imports: IReflectImport[]) => IReflectImport[];
 }

package/lib/analyses/ImportAnalyzer.js

@@ -2,6 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ImportAnalyzer = void 0;
 const MapUtil_1 = require("../utils/MapUtil");
+/**
+ * Helpers for the import lists of routes.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace merges the imports collected for one route and keeps a removal notice for the old analysis entry.
+ * @evidence contracts/common.md#clear-and-simple-design Two functions.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The merge is generic.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ImportAnalyzer analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 var ImportAnalyzer;
 (function (ImportAnalyzer) {
     /**
@@ -12,12 +21,28 @@ var ImportAnalyzer;
      *   `ts.SourceFile` to derive imports should read the metadata delivered
      *   through `Reflect.getMetadata("nestia/OperationMetadata", …)` instead. See
      *   `packages/core/MIGRATION.md`.
+     * @evidence contracts/common.md#principled-implementation The function exists only to give an actionable error to a caller of the removed API, and always throws.
+     * @evidence contracts/common.md#clear-and-simple-design One statement.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It reports the removal instead of failing later with a missing function.
+     * @evidence contracts/common.md#meaningful-documentation The comment names the replacement.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ImportAnalyzer.analyze analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
      */
     ImportAnalyzer.analyze = () => {
         throw new Error("ImportAnalyzer.analyze was removed in @nestia/sdk@next. " +
             "Imports are now attached by the native transformer; read them from " +
             "IOperationMetadata.imports (see packages/core/MIGRATION.md).");
     };
+    /**
+     * Merges import records by file: namespace imports and default imports are
+     * deduplicated and sorted, and the named elements of every import of a file
+     * are combined with their aliases.
+     *
+     * @evidence contracts/common.md#principled-implementation Imports are grouped by file, each group emits its namespace imports, default imports, and one element list with an alias map for renamed elements, so the same file is imported once per kind.
+     * @evidence contracts/common.md#clear-and-simple-design One function over one group merger.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The merge follows the import records, with no file special-cased.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the grouping and the merging.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ImportAnalyzer.merge analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     ImportAnalyzer.merge = (imports) => {
         // group by files
         const fileGroups = new Map();

package/lib/analyses/ImportAnalyzer.js.map

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

package/lib/analyses/ParameterNameAnalyzer.d.ts

@@ -1,4 +1,22 @@
+/**
+ * Gives names to parameters that declare none, such as destructured ones.
+ *
+ * @evidence contracts/common.md#principled-implementation A missing name is derived from the field, camel-cased when it is not an identifier, or from the category, and then made unique against the names already taken.
+ * @evidence contracts/common.md#clear-and-simple-design One function, one record type, and one private candidate rule.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The rule is generic.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ParameterNameAnalyzer analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 export declare namespace ParameterNameAnalyzer {
+    /**
+     * A parameter to name: its current name, its category, and an optional field.
+     *
+     * @evidence contracts/common.md#principled-implementation The three members are the inputs of the naming rule.
+     * @evidence contracts/common.md#clear-and-simple-design A flat record with no behavior.
+     * @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 type describes and the meaning of its members.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ParameterNameAnalyzer.IParameter analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     interface IParameter {
         name: string;
         category: string;
@@ -15,6 +33,12 @@ export declare namespace ParameterNameAnalyzer {
      * dropped in camel case, otherwise its category, such as `body` or `query`.
      * The name yields to every other parameter's, which are the user's and are
      * kept.
+     *
+     * @evidence contracts/common.md#principled-implementation The names in use are collected first, and each new name is escaped against them with underscores and added, so the result has no duplicates.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Existing names are never changed.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the rule.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ParameterNameAnalyzer.name analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
      */
     const name: <T extends IParameter>(parameters: T[]) => T[];
 }

package/lib/analyses/ParameterNameAnalyzer.js

@@ -3,6 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ParameterNameAnalyzer = void 0;
 const utils_1 = require("@typia/utils");
 const StringUtil_1 = require("../utils/StringUtil");
+/**
+ * Gives names to parameters that declare none, such as destructured ones.
+ *
+ * @evidence contracts/common.md#principled-implementation A missing name is derived from the field, camel-cased when it is not an identifier, or from the category, and then made unique against the names already taken.
+ * @evidence contracts/common.md#clear-and-simple-design One function, one record type, and one private candidate rule.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The rule is generic.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ParameterNameAnalyzer analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 var ParameterNameAnalyzer;
 (function (ParameterNameAnalyzer) {
     /**
@@ -16,6 +25,12 @@ var ParameterNameAnalyzer;
      * dropped in camel case, otherwise its category, such as `body` or `query`.
      * The name yields to every other parameter's, which are the user's and are
      * kept.
+     *
+     * @evidence contracts/common.md#principled-implementation The names in use are collected first, and each new name is escaped against them with underscores and added, so the result has no duplicates.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Existing names are never changed.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the rule.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ParameterNameAnalyzer.name analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
      */
     ParameterNameAnalyzer.name = (parameters) => {
         const taken = parameters

package/lib/analyses/ParameterNameAnalyzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"ParameterNameAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/ParameterNameAnalyzer.ts"],"names":[],"mappings":";;;AAAA,wCAAgD;AAEhD,oDAAiD;AAEjD,IAAiB,qBAAqB,CA8CrC;AA9CD,WAAiB,qBAAqB;IAOpC;;;;;;;;;;;OAWG;IACU,0BAAI,GAAG,CAAuB,UAAe,EAAO,EAAE;QACjE,MAAM,KAAK,GAAa,UAAU;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;QACvC,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC1B,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAC;YAClC,MAAM,IAAI,GAAW,uBAAU,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YACrE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,uCAAY,CAAC,KAAE,IAAI,IAAG;QACxB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,CAAa,EAAU,EAAE;QAC1C,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtE,IAAI,wBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAC,KAAK,CAAC;YACvD,0BAA0B;YAC1B,MAAM,KAAK,GAAW,CAAC,CAAC,KAAK;iBAC1B,KAAK,CAAC,iBAAiB,CAAC;iBACxB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;iBACnC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CACf,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAC9D;iBACA,IAAI,CAAC,EAAE,CAAC,CAAC;YACZ,IAAI,wBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC;QACrD,CAAC;QACD,OAAO,CAAC,CAAC,QAAQ,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC,EA9CgB,qBAAqB,aAArB,qBAAqB,GAArB,qBAAqB,QA8CrC"}
+{"version":3,"file":"ParameterNameAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/ParameterNameAnalyzer.ts"],"names":[],"mappings":";;;AAAA,wCAAgD;AAEhD,oDAAiD;AAEjD;;;;;;;;GAQG;AACH,IAAiB,qBAAqB,CA6DrC;AA7DD,WAAiB,qBAAqB;IAgBpC;;;;;;;;;;;;;;;;;OAiBG;IACU,0BAAI,GAAG,CAAuB,UAAe,EAAO,EAAE;QACjE,MAAM,KAAK,GAAa,UAAU;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;QACvC,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC1B,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAC;YAClC,MAAM,IAAI,GAAW,uBAAU,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YACrE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,uCAAY,CAAC,KAAE,IAAI,IAAG;QACxB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,CAAa,EAAU,EAAE;QAC1C,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtE,IAAI,wBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAC,KAAK,CAAC;YACvD,0BAA0B;YAC1B,MAAM,KAAK,GAAW,CAAC,CAAC,KAAK;iBAC1B,KAAK,CAAC,iBAAiB,CAAC;iBACxB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;iBACnC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CACf,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAC9D;iBACA,IAAI,CAAC,EAAE,CAAC,CAAC;YACZ,IAAI,wBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC;QACrD,CAAC;QACD,OAAO,CAAC,CAAC,QAAQ,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC,EA7DgB,qBAAqB,aAArB,qBAAqB,GAArB,qBAAqB,QA6DrC"}