@nestia/sdk 14.0.1 → 14.0.2

package/lib/factories/IdentifierFactory.js

@@ -10,12 +10,24 @@ const isVariableName = (str) => VARIABLE_REGEX.test(str);
 /**
  * Identifier and member-access helpers. The surface kept here is the subset
  * nestia generators actually call (`identifier`, `access`, `parameter`).
+ *
+ * @evidence contracts/common.md#principled-implementation The functions choose an identifier or a string literal by the syntax of the name, so any string can be a key.
+ * @evidence contracts/common.md#clear-and-simple-design Three functions.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The identifier test is inlined and conservative.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation IdentifierFactory constructs TypeScript syntax nodes; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
  */
 var IdentifierFactory;
 (function (IdentifierFactory) {
     /**
      * Build an identifier or string literal depending on whether `name` is a
      * valid JavaScript identifier.
+     *
+     * @evidence contracts/common.md#principled-implementation The name is tested against the identifier grammar, and a valid name outside the conservative pattern becomes an equivalent quoted key.
+     * @evidence contracts/common.md#clear-and-simple-design One conditional.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The test applies to every name.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the two results.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation IdentifierFactory.identifier constructs TypeScript syntax nodes; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
      */
     IdentifierFactory.identifier = (name) => isVariableName(name)
         ? factory_1.factory.createIdentifier(name)
@@ -23,6 +35,12 @@ var IdentifierFactory;
     /**
      * Member access on `input` by `key`. Falls back to element access when the
      * key is not a valid identifier.
+     *
+     * @evidence contracts/common.md#principled-implementation The key becomes a property when it is an identifier and an element access otherwise.
+     * @evidence contracts/common.md#clear-and-simple-design One function delegating the naming rule.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It never concatenates source text.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the forms.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation IdentifierFactory.access constructs TypeScript syntax nodes; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
      */
     IdentifierFactory.access = (input, key, chain) => {
         const postfix = IdentifierFactory.identifier(key);
@@ -37,6 +55,12 @@ var IdentifierFactory;
     /**
      * Parameter declaration with default `any` type when the caller omits one.
      * Passing a `QuestionToken` as `init` marks the parameter optional.
+     *
+     * @evidence contracts/common.md#principled-implementation The question token becomes the optional marker and any other initializer is passed through.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It follows the declaration grammar.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the optional marker.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation IdentifierFactory.parameter constructs TypeScript syntax nodes; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
      */
     IdentifierFactory.parameter = (name, type, init) => {
         const isQuestionToken = !!init &&

package/lib/factories/IdentifierFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"IdentifierFactory.js","sourceRoot":"","sources":["../../src/factories/IdentifierFactory.ts"],"names":[],"mappings":";;;AAAA,2CASuB;AAEvB,+CAA4C;AAE5C,yEAAyE;AACzE,yEAAyE;AACzE,MAAM,cAAc,GAAG,4BAA4B,CAAC;AACpD,MAAM,cAAc,GAAG,CAAC,GAAW,EAAW,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE1E;;;GAGG;AACH,IAAiB,iBAAiB,CA6DjC;AA7DD,WAAiB,iBAAiB;IAChC;;;OAGG;IACU,4BAAU,GAAG,CAAC,IAAY,EAA8B,EAAE,CACrE,cAAc,CAAC,IAAI,CAAC;QAClB,CAAC,CAAC,iBAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC;QAChC,CAAC,CAAC,iBAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAExC;;;OAGG;IACU,wBAAM,GAAG,CACpB,KAAiB,EACjB,GAAW,EACX,KAAe,EACH,EAAE;QACd,MAAM,OAAO,GAAG,4BAAU,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,OAAO,CAAC,IAAI,KAAK,eAAe;YAClC,OAAO,KAAK,KAAK,IAAI;gBACnB,CAAC,CAAC,iBAAO,CAAC,wBAAwB,CAC9B,KAAK,EACL,iBAAO,CAAC,WAAW,CAAC,oBAAU,CAAC,gBAAgB,CAAC,EAChD,OAAO,CACR;gBACH,CAAC,CAAC,iBAAO,CAAC,6BAA6B,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC5D,OAAO,KAAK,KAAK,IAAI;YACnB,CAAC,CAAC,iBAAO,CAAC,yBAAyB,CAC/B,KAAK,EACL,iBAAO,CAAC,WAAW,CAAC,oBAAU,CAAC,gBAAgB,CAAC,EAChD,OAAO,CACR;YACH,CAAC,CAAC,iBAAO,CAAC,8BAA8B,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC,CAAC;IAEF;;;OAGG;IACU,2BAAS,GAAG,CACvB,IAAyB,EACzB,IAAe,EACf,IAAyB,EACH,EAAE;QACxB,MAAM,eAAe,GACnB,CAAC,CAAC,IAAI;YACN,IAAI,CAAC,IAAI,KAAK,OAAO;YACpB,IAAc,CAAC,KAAK,KAAK,oBAAU,CAAC,aAAa,CAAC;QACrD,OAAO,iBAAO,CAAC,0BAA0B,CACvC,SAAS,EACT,SAAS,EACT,IAAI,EACJ,eAAe;YACb,CAAC,CAAC,iBAAO,CAAC,WAAW,CAAC,oBAAU,CAAC,aAAa,CAAC;YAC/C,CAAC,CAAC,SAAS,EACb,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,yBAAW,CAAC,OAAO,CAAC,KAAK,CAAC,EAClC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,IAA+B,CAC/D,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,EA7DgB,iBAAiB,aAAjB,iBAAiB,GAAjB,iBAAiB,QA6DjC"}
+{"version":3,"file":"IdentifierFactory.js","sourceRoot":"","sources":["../../src/factories/IdentifierFactory.ts"],"names":[],"mappings":";;;AAAA,2CASuB;AAEvB,+CAA4C;AAE5C,yEAAyE;AACzE,yEAAyE;AACzE,MAAM,cAAc,GAAG,4BAA4B,CAAC;AACpD,MAAM,cAAc,GAAG,CAAC,GAAW,EAAW,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE1E;;;;;;;;;GASG;AACH,IAAiB,iBAAiB,CA+EjC;AA/ED,WAAiB,iBAAiB;IAChC;;;;;;;;;OASG;IACU,4BAAU,GAAG,CAAC,IAAY,EAA8B,EAAE,CACrE,cAAc,CAAC,IAAI,CAAC;QAClB,CAAC,CAAC,iBAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC;QAChC,CAAC,CAAC,iBAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAExC;;;;;;;;;OASG;IACU,wBAAM,GAAG,CACpB,KAAiB,EACjB,GAAW,EACX,KAAe,EACH,EAAE;QACd,MAAM,OAAO,GAAG,4BAAU,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,OAAO,CAAC,IAAI,KAAK,eAAe;YAClC,OAAO,KAAK,KAAK,IAAI;gBACnB,CAAC,CAAC,iBAAO,CAAC,wBAAwB,CAC9B,KAAK,EACL,iBAAO,CAAC,WAAW,CAAC,oBAAU,CAAC,gBAAgB,CAAC,EAChD,OAAO,CACR;gBACH,CAAC,CAAC,iBAAO,CAAC,6BAA6B,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC5D,OAAO,KAAK,KAAK,IAAI;YACnB,CAAC,CAAC,iBAAO,CAAC,yBAAyB,CAC/B,KAAK,EACL,iBAAO,CAAC,WAAW,CAAC,oBAAU,CAAC,gBAAgB,CAAC,EAChD,OAAO,CACR;YACH,CAAC,CAAC,iBAAO,CAAC,8BAA8B,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC,CAAC;IAEF;;;;;;;;;OASG;IACU,2BAAS,GAAG,CACvB,IAAyB,EACzB,IAAe,EACf,IAAyB,EACH,EAAE;QACxB,MAAM,eAAe,GACnB,CAAC,CAAC,IAAI;YACN,IAAI,CAAC,IAAI,KAAK,OAAO;YACpB,IAAc,CAAC,KAAK,KAAK,oBAAU,CAAC,aAAa,CAAC;QACrD,OAAO,iBAAO,CAAC,0BAA0B,CACvC,SAAS,EACT,SAAS,EACT,IAAI,EACJ,eAAe;YACb,CAAC,CAAC,iBAAO,CAAC,WAAW,CAAC,oBAAU,CAAC,aAAa,CAAC;YAC/C,CAAC,CAAC,SAAS,EACb,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,yBAAW,CAAC,OAAO,CAAC,KAAK,CAAC,EAClC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,IAA+B,CAC/D,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,EA/EgB,iBAAiB,aAAjB,iBAAiB,GAAjB,iBAAiB,QA+EjC"}

package/lib/factories/LiteralFactory.d.ts

@@ -1,9 +1,27 @@
 import { type Expression } from "@ttsc/factory";
 /**
- * Recursive value-to-AST-literal builder. Hands back already-AST inputs
- * unchanged (so callers can mix factory output with raw JS values inside the
- * same object/array), and emits the appropriate literal node otherwise.
+ * Recursive value-to-AST-literal builder. Arrow-function, call-expression and
+ * identifier nodes pass through only when the caller explicitly requests
+ * expression preservation. Ordinary values may contain the same `kind` names.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace maps values to literal nodes by type.
+ * @evidence contracts/common.md#clear-and-simple-design One function and two helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The mapping is by type.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation LiteralFactory constructs TypeScript syntax nodes; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
  */
 export declare namespace LiteralFactory {
-    const write: (input: any) => Expression;
+    /**
+     * Builds the expression of a value; arrow function, call, and identifier
+     * nodes pass through when `preserveExpressions` is true. Functions become
+     * `undefined`; other unsupported types throw, and object properties whose
+     * values are undefined are omitted.
+     *
+     * @evidence contracts/common.md#principled-implementation The value is dispatched by type in a fixed order and containers are written element by element.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The dispatch is general.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the mapping.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation LiteralFactory.write constructs TypeScript syntax nodes; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
+    const write: (input: any, preserveExpressions?: boolean) => Expression;
 }

package/lib/factories/LiteralFactory.js

@@ -13,21 +13,41 @@ const isNode = (value) => typeof value === "object" &&
     value !== null &&
     typeof value.kind === "string";
 /**
- * Recursive value-to-AST-literal builder. Hands back already-AST inputs
- * unchanged (so callers can mix factory output with raw JS values inside the
- * same object/array), and emits the appropriate literal node otherwise.
+ * Recursive value-to-AST-literal builder. Arrow-function, call-expression and
+ * identifier nodes pass through only when the caller explicitly requests
+ * expression preservation. Ordinary values may contain the same `kind` names.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace maps values to literal nodes by type.
+ * @evidence contracts/common.md#clear-and-simple-design One function and two helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The mapping is by type.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation LiteralFactory constructs TypeScript syntax nodes; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
  */
 var LiteralFactory;
 (function (LiteralFactory) {
-    LiteralFactory.write = (input) => {
+    /**
+     * Builds the expression of a value; arrow function, call, and identifier
+     * nodes pass through when `preserveExpressions` is true. Functions become
+     * `undefined`; other unsupported types throw, and object properties whose
+     * values are undefined are omitted.
+     *
+     * @evidence contracts/common.md#principled-implementation The value is dispatched by type in a fixed order and containers are written element by element.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The dispatch is general.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the mapping.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation LiteralFactory.write constructs TypeScript syntax nodes; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
+    LiteralFactory.write = (input, preserveExpressions = false) => {
         if (input === null)
             return factory_1.factory.createNull();
-        if (isNode(input) && PASSTHROUGH_KINDS.has(input.kind))
+        if (preserveExpressions &&
+            isNode(input) &&
+            PASSTHROUGH_KINDS.has(input.kind))
             return input;
         if (Array.isArray(input))
-            return writeArray(input);
+            return writeArray(input, preserveExpressions);
         if (typeof input === "object")
-            return writeObject(input);
+            return writeObject(input, preserveExpressions);
         if (typeof input === "boolean")
             return input ? factory_1.factory.createTrue() : factory_1.factory.createFalse();
         if (typeof input === "number")
@@ -42,9 +62,9 @@ var LiteralFactory;
             return factory_1.factory.createIdentifier("undefined");
         throw new TypeError("LiteralFactory.write: unsupported input type.");
     };
-    const writeObject = (obj) => factory_1.factory.createObjectLiteralExpression(Object.entries(obj)
+    const writeObject = (obj, preserveExpressions) => factory_1.factory.createObjectLiteralExpression(Object.entries(obj)
         .filter(([, value]) => value !== undefined)
-        .map(([key, value]) => factory_1.factory.createPropertyAssignment(IdentifierFactory_1.IdentifierFactory.identifier(key), LiteralFactory.write(value))), true);
-    const writeArray = (array) => factory_1.factory.createArrayLiteralExpression(array.map(LiteralFactory.write), true);
+        .map(([key, value]) => factory_1.factory.createPropertyAssignment(IdentifierFactory_1.IdentifierFactory.identifier(key), LiteralFactory.write(value, preserveExpressions))), true);
+    const writeArray = (array, preserveExpressions) => factory_1.factory.createArrayLiteralExpression(array.map((value) => LiteralFactory.write(value, preserveExpressions)), true);
 })(LiteralFactory || (exports.LiteralFactory = LiteralFactory = {}));
 //# sourceMappingURL=LiteralFactory.js.map

package/lib/factories/LiteralFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"LiteralFactory.js","sourceRoot":"","sources":["../../src/factories/LiteralFactory.ts"],"names":[],"mappings":";;;AAAA,2CAAqE;AAErE,2DAAwD;AACxD,2DAAwD;AAExD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAS;IACxC,eAAe;IACf,gBAAgB;IAChB,YAAY;CACb,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,CAAC,KAAc,EAAuB,EAAE,CACrD,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACd,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ,CAAC;AAEzD;;;;GAIG;AACH,IAAiB,cAAc,CAqC9B;AArCD,WAAiB,cAAc;IAChB,oBAAK,GAAG,CAAC,KAAU,EAAc,EAAE;QAC9C,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,iBAAO,CAAC,UAAU,EAAE,CAAC;QAChD,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QACrE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,WAAW,CAAC,KAAe,CAAC,CAAC;QACnE,IAAI,OAAO,KAAK,KAAK,SAAS;YAC5B,OAAO,KAAK,CAAC,CAAC,CAAC,iBAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,iBAAO,CAAC,WAAW,EAAE,CAAC;QAC9D,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,qCAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,iBAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACzE,IAAI,OAAO,KAAK,KAAK,QAAQ;YAC3B,OAAO,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC;gBACtB,CAAC,CAAC,iBAAO,CAAC,2BAA2B,CACjC,oBAAU,CAAC,UAAU,EACrB,iBAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,CACjD;gBACH,CAAC,CAAC,iBAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACpD,IAAI,OAAO,KAAK,KAAK,UAAU;YAC7B,OAAO,iBAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAC/C,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAC;IACvE,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,CAAC,GAAW,EAAc,EAAE,CAC9C,iBAAO,CAAC,6BAA6B,CACnC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;SAChB,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;SAC1C,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CACpB,iBAAO,CAAC,wBAAwB,CAC9B,qCAAiB,CAAC,UAAU,CAAC,GAAG,CAAC,EACjC,oBAAK,CAAC,KAAK,CAAC,CACb,CACF,EACH,IAAI,CACL,CAAC;IAEJ,MAAM,UAAU,GAAG,CAAC,KAAqB,EAAc,EAAE,CACvD,iBAAO,CAAC,4BAA4B,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAK,CAAC,EAAE,IAAI,CAAC,CAAC;AACjE,CAAC,EArCgB,cAAc,aAAd,cAAc,GAAd,cAAc,QAqC9B"}
+{"version":3,"file":"LiteralFactory.js","sourceRoot":"","sources":["../../src/factories/LiteralFactory.ts"],"names":[],"mappings":"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"}

package/lib/factories/StatementFactory.d.ts

@@ -1,11 +1,38 @@
 import { type Expression, type TypeNode, type VariableStatement } from "@ttsc/factory";
-/** Variable-statement helpers. `constant` emits `const`, `mut` emits `let`. */
+/**
+ * Variable-statement helpers. `constant` emits `const`, `mut` emits `let`.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace builds `let` and `const` statements.
+ * @evidence contracts/common.md#clear-and-simple-design Two functions, one for let and one for const.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It only builds nodes.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation StatementFactory constructs TypeScript syntax nodes; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 export declare namespace StatementFactory {
+    /**
+     * Builds a `let` statement; without a type and an initializer it is typed
+     * `any`.
+     *
+     * @evidence contracts/common.md#principled-implementation A declaration without either would be implicitly any, so the type is stated.
+     * @evidence contracts/common.md#clear-and-simple-design One expression.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It follows the grammar.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the default type.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation StatementFactory.mut constructs TypeScript syntax nodes; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     const mut: (props: {
         name: string;
         type?: TypeNode | undefined;
         initializer?: Expression | undefined;
     }) => VariableStatement;
+    /**
+     * Builds a `const` statement from a name, a type, and a value.
+     *
+     * @evidence contracts/common.md#principled-implementation The declaration list carries the const flag and the given parts.
+     * @evidence contracts/common.md#clear-and-simple-design One expression.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It follows the grammar.
+     * @evidence contracts/common.md#meaningful-documentation The comment states its inputs.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation StatementFactory.constant constructs TypeScript syntax nodes; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     const constant: (props: {
         name: string;
         type?: TypeNode | undefined;

package/lib/factories/StatementFactory.js

@@ -3,9 +3,27 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.StatementFactory = void 0;
 const factory_1 = require("@ttsc/factory");
 const TypeFactory_1 = require("./TypeFactory");
-/** Variable-statement helpers. `constant` emits `const`, `mut` emits `let`. */
+/**
+ * Variable-statement helpers. `constant` emits `const`, `mut` emits `let`.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace builds `let` and `const` statements.
+ * @evidence contracts/common.md#clear-and-simple-design Two functions, one for let and one for const.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It only builds nodes.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation StatementFactory constructs TypeScript syntax nodes; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 var StatementFactory;
 (function (StatementFactory) {
+    /**
+     * Builds a `let` statement; without a type and an initializer it is typed
+     * `any`.
+     *
+     * @evidence contracts/common.md#principled-implementation A declaration without either would be implicitly any, so the type is stated.
+     * @evidence contracts/common.md#clear-and-simple-design One expression.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It follows the grammar.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the default type.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation StatementFactory.mut constructs TypeScript syntax nodes; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     StatementFactory.mut = (props) => factory_1.factory.createVariableStatement(undefined, factory_1.factory.createVariableDeclarationList([
         factory_1.factory.createVariableDeclaration(props.name, undefined, props.type !== undefined
             ? props.type
@@ -13,6 +31,15 @@ var StatementFactory;
                 ? TypeFactory_1.TypeFactory.keyword("any")
                 : undefined, props.initializer),
     ], factory_1.NodeFlags.Let));
+    /**
+     * Builds a `const` statement from a name, a type, and a value.
+     *
+     * @evidence contracts/common.md#principled-implementation The declaration list carries the const flag and the given parts.
+     * @evidence contracts/common.md#clear-and-simple-design One expression.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It follows the grammar.
+     * @evidence contracts/common.md#meaningful-documentation The comment states its inputs.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation StatementFactory.constant constructs TypeScript syntax nodes; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     StatementFactory.constant = (props) => factory_1.factory.createVariableStatement(undefined, factory_1.factory.createVariableDeclarationList([
         factory_1.factory.createVariableDeclaration(props.name, undefined, props.type, props.value),
     ], factory_1.NodeFlags.Const));

package/lib/factories/StatementFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"StatementFactory.js","sourceRoot":"","sources":["../../src/factories/StatementFactory.ts"],"names":[],"mappings":";;;AAAA,2CAMuB;AAEvB,+CAA4C;AAE5C,+EAA+E;AAC/E,IAAiB,gBAAgB,CA4ChC;AA5CD,WAAiB,gBAAgB;IAClB,oBAAG,GAAG,CAAC,KAInB,EAAqB,EAAE,CACtB,iBAAO,CAAC,uBAAuB,CAC7B,SAAS,EACT,iBAAO,CAAC,6BAA6B,CACnC;QACE,iBAAO,CAAC,yBAAyB,CAC/B,KAAK,CAAC,IAAI,EACV,SAAS,EACT,KAAK,CAAC,IAAI,KAAK,SAAS;YACtB,CAAC,CAAC,KAAK,CAAC,IAAI;YACZ,CAAC,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS;gBAC/B,CAAC,CAAC,yBAAW,CAAC,OAAO,CAAC,KAAK,CAAC;gBAC5B,CAAC,CAAC,SAAS,EACf,KAAK,CAAC,WAAW,CAClB;KACF,EACD,mBAAS,CAAC,GAAG,CACd,CACF,CAAC;IAES,yBAAQ,GAAG,CAAC,KAIxB,EAAqB,EAAE,CACtB,iBAAO,CAAC,uBAAuB,CAC7B,SAAS,EACT,iBAAO,CAAC,6BAA6B,CACnC;QACE,iBAAO,CAAC,yBAAyB,CAC/B,KAAK,CAAC,IAAI,EACV,SAAS,EACT,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,KAAK,CACZ;KACF,EACD,mBAAS,CAAC,KAAK,CAChB,CACF,CAAC;AACN,CAAC,EA5CgB,gBAAgB,aAAhB,gBAAgB,GAAhB,gBAAgB,QA4ChC"}
+{"version":3,"file":"StatementFactory.js","sourceRoot":"","sources":["../../src/factories/StatementFactory.ts"],"names":[],"mappings":";;;AAAA,2CAMuB;AAEvB,+CAA4C;AAE5C;;;;;;;;GAQG;AACH,IAAiB,gBAAgB,CA+DhC;AA/DD,WAAiB,gBAAgB;IAC/B;;;;;;;;;OASG;IACU,oBAAG,GAAG,CAAC,KAInB,EAAqB,EAAE,CACtB,iBAAO,CAAC,uBAAuB,CAC7B,SAAS,EACT,iBAAO,CAAC,6BAA6B,CACnC;QACE,iBAAO,CAAC,yBAAyB,CAC/B,KAAK,CAAC,IAAI,EACV,SAAS,EACT,KAAK,CAAC,IAAI,KAAK,SAAS;YACtB,CAAC,CAAC,KAAK,CAAC,IAAI;YACZ,CAAC,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS;gBAC/B,CAAC,CAAC,yBAAW,CAAC,OAAO,CAAC,KAAK,CAAC;gBAC5B,CAAC,CAAC,SAAS,EACf,KAAK,CAAC,WAAW,CAClB;KACF,EACD,mBAAS,CAAC,GAAG,CACd,CACF,CAAC;IAEJ;;;;;;;;OAQG;IACU,yBAAQ,GAAG,CAAC,KAIxB,EAAqB,EAAE,CACtB,iBAAO,CAAC,uBAAuB,CAC7B,SAAS,EACT,iBAAO,CAAC,6BAA6B,CACnC;QACE,iBAAO,CAAC,yBAAyB,CAC/B,KAAK,CAAC,IAAI,EACV,SAAS,EACT,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,KAAK,CACZ;KACF,EACD,mBAAS,CAAC,KAAK,CAChB,CACF,CAAC;AACN,CAAC,EA/DgB,gBAAgB,aAAhB,gBAAgB,GAAhB,gBAAgB,QA+DhC"}

package/lib/factories/TypeFactory.d.ts

@@ -5,6 +5,12 @@ import { type KeywordTypeNode, SyntaxKind } from "@ttsc/factory";
  * Wraps {@link factory.createKeywordTypeNode} with a name-based interface so
  * generator code reads as `TypeFactory.keyword("any")` instead of selecting the
  * `SyntaxKind.AnyKeyword` token by hand.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace maps names to the keyword syntax kinds.
+ * @evidence contracts/common.md#clear-and-simple-design One table, one type, and one function.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It only builds nodes.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation TypeFactory constructs TypeScript syntax nodes; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
  */
 export declare namespace TypeFactory {
     const KEYWORDS: {
@@ -18,7 +24,25 @@ export declare namespace TypeFactory {
         readonly never: SyntaxKind.NeverKeyword;
         readonly undefined: SyntaxKind.UndefinedKeyword;
     };
+    /**
+     * The names of the supported keyword types.
+     *
+     * @evidence contracts/common.md#principled-implementation The type is the key set of the table, so a keyword is one table entry.
+     * @evidence contracts/common.md#clear-and-simple-design One derived type.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It is a type and adds no runtime behavior.
+     * @evidence contracts/common.md#meaningful-documentation The comment names the set.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation TypeFactory.Keyword is the key union of the syntax-kind table and defines no native path conversion or process boundary.
+     */
     export type Keyword = keyof typeof KEYWORDS;
+    /**
+     * Builds the keyword type node of a name.
+     *
+     * @evidence contracts/common.md#principled-implementation The name is looked up in the table.
+     * @evidence contracts/common.md#clear-and-simple-design One lookup.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It follows the grammar.
+     * @evidence contracts/common.md#meaningful-documentation The comment states its input.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation TypeFactory.keyword constructs TypeScript syntax nodes; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     export const keyword: (type: Keyword) => KeywordTypeNode;
     export {};
 }

package/lib/factories/TypeFactory.js

@@ -8,6 +8,12 @@ const factory_1 = require("@ttsc/factory");
  * Wraps {@link factory.createKeywordTypeNode} with a name-based interface so
  * generator code reads as `TypeFactory.keyword("any")` instead of selecting the
  * `SyntaxKind.AnyKeyword` token by hand.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace maps names to the keyword syntax kinds.
+ * @evidence contracts/common.md#clear-and-simple-design One table, one type, and one function.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It only builds nodes.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation TypeFactory constructs TypeScript syntax nodes; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
  */
 var TypeFactory;
 (function (TypeFactory) {
@@ -22,6 +28,15 @@ var TypeFactory;
         never: factory_1.SyntaxKind.NeverKeyword,
         undefined: factory_1.SyntaxKind.UndefinedKeyword,
     };
+    /**
+     * Builds the keyword type node of a name.
+     *
+     * @evidence contracts/common.md#principled-implementation The name is looked up in the table.
+     * @evidence contracts/common.md#clear-and-simple-design One lookup.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It follows the grammar.
+     * @evidence contracts/common.md#meaningful-documentation The comment states its input.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation TypeFactory.keyword constructs TypeScript syntax nodes; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     TypeFactory.keyword = (type) => factory_1.factory.createKeywordTypeNode(KEYWORDS[type]);
 })(TypeFactory || (exports.TypeFactory = TypeFactory = {}));
 //# sourceMappingURL=TypeFactory.js.map

package/lib/factories/TypeFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"TypeFactory.js","sourceRoot":"","sources":["../../src/factories/TypeFactory.ts"],"names":[],"mappings":";;;AAAA,2CAA0E;AAE1E;;;;;;GAMG;AACH,IAAiB,WAAW,CAiB3B;AAjBD,WAAiB,WAAW;IAC1B,MAAM,QAAQ,GAAG;QACf,IAAI,EAAE,oBAAU,CAAC,WAAW;QAC5B,GAAG,EAAE,oBAAU,CAAC,UAAU;QAC1B,OAAO,EAAE,oBAAU,CAAC,cAAc;QAClC,OAAO,EAAE,oBAAU,CAAC,cAAc;QAClC,MAAM,EAAE,oBAAU,CAAC,aAAa;QAChC,MAAM,EAAE,oBAAU,CAAC,aAAa;QAChC,MAAM,EAAE,oBAAU,CAAC,aAAa;QAChC,KAAK,EAAE,oBAAU,CAAC,YAAY;QAC9B,SAAS,EAAE,oBAAU,CAAC,gBAAgB;KAC9B,CAAC;IAIE,mBAAO,GAAG,CAAC,IAAa,EAAmB,EAAE,CACxD,iBAAO,CAAC,qBAAqB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC,EAjBgB,WAAW,aAAX,WAAW,GAAX,WAAW,QAiB3B"}
+{"version":3,"file":"TypeFactory.js","sourceRoot":"","sources":["../../src/factories/TypeFactory.ts"],"names":[],"mappings":";;;AAAA,2CAA0E;AAE1E;;;;;;;;;;;;GAYG;AACH,IAAiB,WAAW,CAmC3B;AAnCD,WAAiB,WAAW;IAC1B,MAAM,QAAQ,GAAG;QACf,IAAI,EAAE,oBAAU,CAAC,WAAW;QAC5B,GAAG,EAAE,oBAAU,CAAC,UAAU;QAC1B,OAAO,EAAE,oBAAU,CAAC,cAAc;QAClC,OAAO,EAAE,oBAAU,CAAC,cAAc;QAClC,MAAM,EAAE,oBAAU,CAAC,aAAa;QAChC,MAAM,EAAE,oBAAU,CAAC,aAAa;QAChC,MAAM,EAAE,oBAAU,CAAC,aAAa;QAChC,KAAK,EAAE,oBAAU,CAAC,YAAY;QAC9B,SAAS,EAAE,oBAAU,CAAC,gBAAgB;KAC9B,CAAC;IAaX;;;;;;;;OAQG;IACU,mBAAO,GAAG,CAAC,IAAa,EAAmB,EAAE,CACxD,iBAAO,CAAC,qBAAqB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC,EAnCgB,WAAW,aAAX,WAAW,GAAX,WAAW,QAmC3B"}

package/lib/generates/CloneGenerator.d.ts

@@ -1,4 +1,26 @@
 import { ITypedApplication } from "../structures/ITypedApplication";
+/**
+ * Writes the DTO declarations of the SDK: the `structures` files that the
+ * functions import when `clone` is on.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace composes the declarations from the analyzed types, rewrites the routes to reference them, and prints one file per top-level module.
+ * @evidence contracts/common.md#clear-and-simple-design One public function with two private helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Every declaration goes through the shared printer, and no type is special-cased.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+ * @evidence contracts/portability.md#os-neutral-implementation The writer passes native output locations to Node fs and FilePrinter; module specifiers are produced separately by ImportDictionary. The structures suffix uses forward slashes, which Node accepts on Windows and POSIX, without treating spelling as canonical file identity.
+ */
 export declare namespace CloneGenerator {
+    /**
+     * Writes the `structures` directory of the SDK output.
+     *
+     * Structural route references are updated even when every JSON DTO is inline
+     * and no structure file is needed. WebSocket source cloning stays separate.
+     *
+     * @evidence contracts/common.md#principled-implementation HTTP and MCP JSON declarations share the analyzed collection; WebSocket sources are copied separately. Route references are updated even for inline-only graphs, then named modules are written sequentially so a failure stops at the first file.
+     * @evidence contracts/common.md#clear-and-simple-design One function over the two programmers, the referencer, and the file writer.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The directory is created recursively and its failure is not swallowed.
+     * @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 the output structures directory and FilePrinter writes generated declarations; WebSocket source lookup and copying remain delegated to its source-cloning owner. Filesystem errors propagate rather than being translated into platform-specific shell commands.
+     */
     const write: (app: ITypedApplication) => Promise<void>;
 }

package/lib/generates/CloneGenerator.js

@@ -20,18 +20,39 @@ const ImportDictionary_1 = require("./internal/ImportDictionary");
 const SdkHttpCloneProgrammer_1 = require("./internal/SdkHttpCloneProgrammer");
 const SdkHttpCloneReferencer_1 = require("./internal/SdkHttpCloneReferencer");
 const SdkWebSocketCloneProgrammer_1 = require("./internal/SdkWebSocketCloneProgrammer");
+/**
+ * Writes the DTO declarations of the SDK: the `structures` files that the
+ * functions import when `clone` is on.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace composes the declarations from the analyzed types, rewrites the routes to reference them, and prints one file per top-level module.
+ * @evidence contracts/common.md#clear-and-simple-design One public function with two private helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Every declaration goes through the shared printer, and no type is special-cased.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+ * @evidence contracts/portability.md#os-neutral-implementation The writer passes native output locations to Node fs and FilePrinter; module specifiers are produced separately by ImportDictionary. The structures suffix uses forward slashes, which Node accepts on Windows and POSIX, without treating spelling as canonical file identity.
+ */
 var CloneGenerator;
 (function (CloneGenerator) {
+    /**
+     * Writes the `structures` directory of the SDK output.
+     *
+     * Structural route references are updated even when every JSON DTO is inline
+     * and no structure file is needed. WebSocket source cloning stays separate.
+     *
+     * @evidence contracts/common.md#principled-implementation HTTP and MCP JSON declarations share the analyzed collection; WebSocket sources are copied separately. Route references are updated even for inline-only graphs, then named modules are written sequentially so a failure stops at the first file.
+     * @evidence contracts/common.md#clear-and-simple-design One function over the two programmers, the referencer, and the file writer.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The directory is created recursively and its failure is not swallowed.
+     * @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 the output structures directory and FilePrinter writes generated declarations; WebSocket source lookup and copying remain delegated to its source-cloning owner. Filesystem errors propagate rather than being translated into platform-specific shell commands.
+     */
     CloneGenerator.write = (app) => __awaiter(this, void 0, void 0, function* () {
         const dict = SdkHttpCloneProgrammer_1.SdkHttpCloneProgrammer.write(app);
         const websocket = yield SdkWebSocketCloneProgrammer_1.SdkWebSocketCloneProgrammer.write(app);
+        SdkHttpCloneReferencer_1.SdkHttpCloneReferencer.replace(app, websocket);
         if (dict.size === 0 && websocket.size === 0)
             return;
-        SdkHttpCloneReferencer_1.SdkHttpCloneReferencer.replace(app, websocket);
-        try {
-            yield fs_1.default.promises.mkdir(`${app.project.config.output}/structures`);
-        }
-        catch (_a) { }
+        yield fs_1.default.promises.mkdir(`${app.project.config.output}/structures`, {
+            recursive: true,
+        });
         for (const [key, value] of dict)
             yield writeDtoFile(app.project)(key, value);
     });

package/lib/generates/CloneGenerator.js.map

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

package/lib/generates/E2eGenerator.d.ts

@@ -1,4 +1,23 @@
 import { ITypedApplication } from "../structures/ITypedApplication";
+/**
+ * Writes the e2e test functions of the SDK.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace creates the output directories and writes one test file per HTTP route.
+ * @evidence contracts/common.md#clear-and-simple-design One public function and one directory helper.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Only HTTP routes have a test, and no route is skipped by name.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+ * @evidence contracts/portability.md#os-neutral-implementation The output root is resolved with Node path.resolve, descendants use path.join and recursive fs.mkdir creates them. SDK import paths are passed to E2eFileProgrammer independently from native directory paths.
+ */
 export declare namespace E2eGenerator {
+    /**
+     * Writes one test function per HTTP route under `features/api/automated` of
+     * the e2e output directory, creating the directories as needed.
+     *
+     * @evidence contracts/common.md#principled-implementation The directories are created recursively, so an existing tree is reused, and each route's file is written in sequence.
+     * @evidence contracts/common.md#clear-and-simple-design One loop over the routes.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts WebSocket and MCP routes are not tests of the HTTP SDK and are left out by protocol.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidence contracts/portability.md#os-neutral-implementation Native output and SDK roots use path.resolve and path.join before mkdir or file generation. No shell or filesystem case assumption participates; the generated HTTP route names have already passed accessor analysis.
+     */
     const generate: (app: ITypedApplication) => Promise<void>;
 }

package/lib/generates/E2eGenerator.js

@@ -16,8 +16,27 @@ exports.E2eGenerator = void 0;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const E2eFileProgrammer_1 = require("./internal/E2eFileProgrammer");
+/**
+ * Writes the e2e test functions of the SDK.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace creates the output directories and writes one test file per HTTP route.
+ * @evidence contracts/common.md#clear-and-simple-design One public function and one directory helper.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Only HTTP routes have a test, and no route is skipped by name.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+ * @evidence contracts/portability.md#os-neutral-implementation The output root is resolved with Node path.resolve, descendants use path.join and recursive fs.mkdir creates them. SDK import paths are passed to E2eFileProgrammer independently from native directory paths.
+ */
 var E2eGenerator;
 (function (E2eGenerator) {
+    /**
+     * Writes one test function per HTTP route under `features/api/automated` of
+     * the e2e output directory, creating the directories as needed.
+     *
+     * @evidence contracts/common.md#principled-implementation The directories are created recursively, so an existing tree is reused, and each route's file is written in sequence.
+     * @evidence contracts/common.md#clear-and-simple-design One loop over the routes.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts WebSocket and MCP routes are not tests of the HTTP SDK and are left out by protocol.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidence contracts/portability.md#os-neutral-implementation Native output and SDK roots use path.resolve and path.join before mkdir or file generation. No shell or filesystem case assumption participates; the generated HTTP route names have already passed accessor analysis.
+     */
     E2eGenerator.generate = (app) => __awaiter(this, void 0, void 0, function* () {
         console.log("Generating E2E Test Functions");
         // PREPARE DIRECTORIES

package/lib/generates/E2eGenerator.js.map

@@ -1 +1 @@
-{"version":3,"file":"E2eGenerator.js","sourceRoot":"","sources":["../../src/generates/E2eGenerator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,4CAAoB;AACpB,gDAAwB;AAGxB,oEAAiE;AAEjE,IAAiB,YAAY,CAmB5B;AAnBD,WAAiB,YAAY;IACd,qBAAQ,GAAG,CAAO,GAAsB,EAAiB,EAAE;QACtE,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAE7C,sBAAsB;QACtB,MAAM,MAAM,GAAW,cAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,GAAI,CAAC,CAAC;QAC7D,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QACpB,MAAM,KAAK,CAAC,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;QAC3C,MAAM,KAAK,CAAC,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;QAClD,MAAM,KAAK,CAAC,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;QAE/D,2BAA2B;QAC3B,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM;YAC5B,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM;gBAC3B,MAAM,qCAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBAC5C,GAAG,EAAE,cAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,MAAO,CAAC;oBAC7C,OAAO,EAAE,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,CAAC;iBAC3D,CAAC,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC,CAAA,CAAC;AACJ,CAAC,EAnBgB,YAAY,aAAZ,YAAY,GAAZ,YAAY,QAmB5B;AAED,MAAM,KAAK,GAAG,CAAO,QAAgB,EAAiB,EAAE;IACtD,MAAM,YAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACzD,CAAC,CAAA,CAAC"}
+{"version":3,"file":"E2eGenerator.js","sourceRoot":"","sources":["../../src/generates/E2eGenerator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,4CAAoB;AACpB,gDAAwB;AAGxB,oEAAiE;AAEjE;;;;;;;;GAQG;AACH,IAAiB,YAAY,CA6B5B;AA7BD,WAAiB,YAAY;IAC3B;;;;;;;;;OASG;IACU,qBAAQ,GAAG,CAAO,GAAsB,EAAiB,EAAE;QACtE,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAE7C,sBAAsB;QACtB,MAAM,MAAM,GAAW,cAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,GAAI,CAAC,CAAC;QAC7D,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QACpB,MAAM,KAAK,CAAC,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;QAC3C,MAAM,KAAK,CAAC,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;QAClD,MAAM,KAAK,CAAC,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;QAE/D,2BAA2B;QAC3B,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM;YAC5B,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM;gBAC3B,MAAM,qCAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBAC5C,GAAG,EAAE,cAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,MAAO,CAAC;oBAC7C,OAAO,EAAE,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,CAAC;iBAC3D,CAAC,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC,CAAA,CAAC;AACJ,CAAC,EA7BgB,YAAY,aAAZ,YAAY,GAAZ,YAAY,QA6B5B;AAED,MAAM,KAAK,GAAG,CAAO,QAAgB,EAAiB,EAAE;IACtD,MAAM,YAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACzD,CAAC,CAAA,CAAC"}

package/lib/generates/SdkGenerator.d.ts

@@ -1,7 +1,39 @@
 import { IReflectOperationError } from "../structures/IReflectOperationError";
 import { ITypedApplication } from "../structures/ITypedApplication";
+/**
+ * Generates the SDK library and validates the analyzed routes it needs.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace bundles the static files, writes the DTOs and the functions, composes the distribution package, and reports the errors the generation would meet.
+ * @evidence contracts/common.md#clear-and-simple-design Two public functions, one public constant, and the private validators.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Validation and generation share the same route model.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+ * @evidence contracts/portability.md#os-neutral-implementation Static bundle enumeration and output creation use Node fs; declaration/module path conversion and distribution process launching are delegated to ImportDictionary and SdkDistributionComposer. Existing file spelling is checked by the filesystem rather than an OS-name case rule.
+ */
 export declare namespace SdkGenerator {
+    /**
+     * Writes the SDK into the configured output directory: the bundled files, the
+     * DTOs when `clone` is on, the functions, and the distribution package when
+     * `distribute` is set.
+     *
+     * @evidence contracts/common.md#principled-implementation The steps run in dependency order, the bundle first and the distribution last. An absent output option throws before writing; a configured directory that does not exist is created recursively.
+     * @evidence contracts/common.md#clear-and-simple-design One function that delegates each step.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The steps are sequential and each awaits the previous one.
+     * @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 and the bundle writer accept the configured native output path; subsequent file and process boundaries belong to their delegated writers. Configuration omission is distinct from a missing on-disk directory.
+     */
     const generate: (app: ITypedApplication) => Promise<void>;
+    /**
+     * Returns the errors of routes that cannot become an SDK: MCP tools with
+     * duplicate names or accessors, and, without `clone`, HTTP routes whose
+     * parameter or return types are implicit, plus implicit exception types when
+     * propagation is enabled.
+     *
+     * @evidence contracts/common.md#principled-implementation The MCP checks always apply, and the implicit return check applies only where the SDK would have to name the type, because `clone` writes it as a declaration instead.
+     * @evidence contracts/common.md#clear-and-simple-design One function over three checks.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The list is collected, not thrown, so one run reports every error.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation Validation judges analyzed route types and names and performs no native filesystem or process operation.
+     */
     const validate: (app: ITypedApplication) => IReflectOperationError[];
     /**
      * Emplace the static bundle files (`index.ts`, `module.ts`, ...) into the SDK
@@ -10,6 +42,12 @@ export declare namespace SdkGenerator {
      * Files the user already has are never touched, so that hand-written
      * customizations (e.g. extra re-exports in `module.ts`) survive regeneration.
      * Only missing files are filled in from the bundle.
+     *
+     * @evidence contracts/common.md#principled-implementation A file that the user has customized is never overwritten, and only files that are missing are filled in from the bundle.
+     * @evidence contracts/common.md#clear-and-simple-design One loop with two guards.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The existing target is checked before the write.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidence contracts/portability.md#os-neutral-implementation fs.readdir/stat enumerate the installed bundle and fs.existsSync checks each target under the filesystem's own policy before writing UTF-8. Forward slash suffixes are accepted by Node on supported native platforms; concurrent generation into the same output is not an exclusive ownership guarantee.
      */
     const bundle: (output: string) => Promise<void>;
     const BUNDLE_PATH: string;