typia 13.0.0-dev.20260626.1 → 13.0.0-dev.20260701.1

package/lib/internal/_randomArray.d.ts

@@ -1,4 +1,5 @@
-import { OpenApi } from "@typia/interface";
+import type { OpenApi } from "@typia/interface";
 export declare const _randomArray: <T>(props: Omit<OpenApi.IJsonSchema.IArray, "items"> & {
     element: (index: number, count: number) => T;
+    recursive?: boolean;
 }) => any[];

package/lib/internal/_randomArray.js

@@ -2,12 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._randomArray = void 0;
 const _randomInteger_1 = require("./_randomInteger");
+const DEFAULT_MIN_ITEMS = 1;
+const DEFAULT_RANGE = 5;
+const DEFAULT_RECURSIVE_RANGE = 2;
 const _randomArray = (props) => {
     var _a, _b, _c;
+    const defaultMinimum = props.recursive === true ? 0 : DEFAULT_MIN_ITEMS;
+    const minimum = (_a = props.minItems) !== null && _a !== void 0 ? _a : Math.min((_b = props.maxItems) !== null && _b !== void 0 ? _b : defaultMinimum, defaultMinimum);
     const count = (0, _randomInteger_1._randomInteger)({
         type: "integer",
-        minimum: ((_a = props.minItems) !== null && _a !== void 0 ? _a : 0),
-        maximum: (_b = props.maxItems) !== null && _b !== void 0 ? _b : ((_c = props.minItems) !== null && _c !== void 0 ? _c : 0) + 5,
+        minimum,
+        maximum: (_c = props.maxItems) !== null && _c !== void 0 ? _c : minimum +
+            (props.recursive === true ? DEFAULT_RECURSIVE_RANGE : DEFAULT_RANGE),
     });
     if (props.uniqueItems !== true)
         return new Array(count).fill(null).map((_, i) => props.element(i, count));

package/lib/internal/_randomArray.js.map

@@ -1 +1 @@
-{"version":3,"file":"_randomArray.js","sourceRoot":"","sources":["../../src/internal/_randomArray.ts"],"names":[],"mappings":";;;AAEA,qDAAkD;AAE3C,MAAM,YAAY,GAAG,CAC1B,KAEC,EACD,EAAE;;IACF,MAAM,KAAK,GAAW,IAAA,+BAAc,EAAC;QACnC,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,OAAC,KAAK,CAAC,QAAQ,mCAAI,CAAC,CAA4B;QACzD,OAAO,QAAE,KAAK,CAAC,QAAQ,mCAAI,OAAC,KAAK,CAAC,QAAQ,mCAAI,CAAC,CAAC,GAAG,CAAC;KACrD,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,WAAW,KAAK,IAAI;QAC5B,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAa,IAAI,GAAG,EAAE,CAAC;IACrC,OAAO,QAAQ,CAAC,IAAI,KAAK,KAAK;QAC5B,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC,CAAC;AAhBW,QAAA,YAAY,GAAZ,YAAY,CAgBvB"}
+{"version":3,"file":"_randomArray.js","sourceRoot":"","sources":["../../src/internal/_randomArray.ts"],"names":[],"mappings":";;;AAEA,qDAAkD;AAElD,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAE3B,MAAM,YAAY,GAAG,CAC1B,KAGC,EACD,EAAE;;IACF,MAAM,cAAc,GAClB,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC;IACnD,MAAM,OAAO,SACX,KAAK,CAAC,QAAQ,mCACd,IAAI,CAAC,GAAG,OAAC,KAAK,CAAC,QAAQ,mCAAI,cAAc,EAAE,cAAc,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAW,IAAA,+BAAc,EAAC;QACnC,IAAI,EAAE,SAAS;QACf,OAAO;QACP,OAAO,QACL,KAAK,CAAC,QAAQ,mCACd,OAAO;YACL,CAAC,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,aAAa,CAAC;KACzE,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,WAAW,KAAK,IAAI;QAC5B,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAa,IAAI,GAAG,EAAE,CAAC;IACrC,OAAO,QAAQ,CAAC,IAAI,KAAK,KAAK;QAC5B,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC,CAAC;AAzBW,QAAA,YAAY,GAAZ,YAAY,CAyBvB"}

package/lib/internal/_randomArray2.mjs

@@ -5,12 +5,18 @@ import { __exports as _randomInteger } from '../_virtual/_randomInteger.mjs';
 Object.defineProperty(_randomArray$1, "__esModule", { value: true });
 var _randomArray_2 = _randomArray$1._randomArray = void 0;
 const _randomInteger_1 = _randomInteger;
+const DEFAULT_MIN_ITEMS = 1;
+const DEFAULT_RANGE = 5;
+const DEFAULT_RECURSIVE_RANGE = 2;
 const _randomArray = (props) => {
     var _a, _b, _c;
+    const defaultMinimum = props.recursive === true ? 0 : DEFAULT_MIN_ITEMS;
+    const minimum = (_a = props.minItems) !== null && _a !== void 0 ? _a : Math.min((_b = props.maxItems) !== null && _b !== void 0 ? _b : defaultMinimum, defaultMinimum);
     const count = (0, _randomInteger_1._randomInteger)({
         type: "integer",
-        minimum: ((_a = props.minItems) !== null && _a !== void 0 ? _a : 0),
-        maximum: (_b = props.maxItems) !== null && _b !== void 0 ? _b : ((_c = props.minItems) !== null && _c !== void 0 ? _c : 0) + 5,
+        minimum,
+        maximum: (_c = props.maxItems) !== null && _c !== void 0 ? _c : minimum +
+            (props.recursive === true ? DEFAULT_RECURSIVE_RANGE : DEFAULT_RANGE),
     });
     if (props.uniqueItems !== true)
         return new Array(count).fill(null).map((_, i) => props.element(i, count));

package/lib/internal/_randomArray2.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_randomArray2.mjs","sources":["_randomArray.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports._randomArray = void 0;\nconst _randomInteger_1 = require(\"./_randomInteger\");\nconst _randomArray = (props) => {\n    var _a, _b, _c;\n    const count = (0, _randomInteger_1._randomInteger)({\n        type: \"integer\",\n        minimum: ((_a = props.minItems) !== null && _a !== void 0 ? _a : 0),\n        maximum: (_b = props.maxItems) !== null && _b !== void 0 ? _b : ((_c = props.minItems) !== null && _c !== void 0 ? _c : 0) + 5,\n    });\n    if (props.uniqueItems !== true)\n        return new Array(count).fill(null).map((_, i) => props.element(i, count));\n    const elements = new Set();\n    while (elements.size !== count)\n        elements.add(props.element(elements.size, count));\n    return Array.from(elements);\n};\nexports._randomArray = _randomArray;\n//# sourceMappingURL=_randomArray.js.map"],"names":["_randomArray_1","require$$0"],"mappings":";;;;AACA,MAAM,CAAC,cAAc,CAACA,cAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,IAAA,cAAA,GAAAA,cAAA,CAAA,YAAoB,GAAG;AACvB,MAAM,gBAAgB,GAAGC,cAA2B;AACpD,MAAM,YAAY,GAAG,CAAC,KAAK,KAAK;AAChC,IAAI,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE;AAClB,IAAI,MAAM,KAAK,GAAG,IAAI,gBAAgB,CAAC,cAAc,EAAE;AACvD,QAAQ,IAAI,EAAE,SAAS;AACvB,QAAQ,OAAO,GAAG,CAAC,EAAE,GAAG,KAAK,CAAC,QAAQ,MAAM,IAAI,IAAI,EAAE,KAAK,MAAM,GAAG,EAAE,GAAG,CAAC,CAAC;AAC3E,QAAQ,OAAO,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,QAAQ,MAAM,IAAI,IAAI,EAAE,KAAK,MAAM,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,QAAQ,MAAM,IAAI,IAAI,EAAE,KAAK,MAAM,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC;AACtI,KAAK,CAAC;AACN,IAAI,IAAI,KAAK,CAAC,WAAW,KAAK,IAAI;AAClC,QAAQ,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACjF,IAAI,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAE;AAC9B,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,KAAK;AAClC,QAAQ,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACzD,IAAI,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;AAC/B,CAAC;AACD,cAAA,GAAAD,cAAA,CAAA,YAAoB,GAAG,YAAY;;;;"}
+{"version":3,"file":"_randomArray2.mjs","sources":["_randomArray.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports._randomArray = void 0;\nconst _randomInteger_1 = require(\"./_randomInteger\");\nconst DEFAULT_MIN_ITEMS = 1;\nconst DEFAULT_RANGE = 5;\nconst DEFAULT_RECURSIVE_RANGE = 2;\nconst _randomArray = (props) => {\n    var _a, _b, _c;\n    const defaultMinimum = props.recursive === true ? 0 : DEFAULT_MIN_ITEMS;\n    const minimum = (_a = props.minItems) !== null && _a !== void 0 ? _a : Math.min((_b = props.maxItems) !== null && _b !== void 0 ? _b : defaultMinimum, defaultMinimum);\n    const count = (0, _randomInteger_1._randomInteger)({\n        type: \"integer\",\n        minimum,\n        maximum: (_c = props.maxItems) !== null && _c !== void 0 ? _c : minimum +\n            (props.recursive === true ? DEFAULT_RECURSIVE_RANGE : DEFAULT_RANGE),\n    });\n    if (props.uniqueItems !== true)\n        return new Array(count).fill(null).map((_, i) => props.element(i, count));\n    const elements = new Set();\n    while (elements.size !== count)\n        elements.add(props.element(elements.size, count));\n    return Array.from(elements);\n};\nexports._randomArray = _randomArray;\n//# sourceMappingURL=_randomArray.js.map"],"names":["_randomArray_1","require$$0"],"mappings":";;;;AACA,MAAM,CAAC,cAAc,CAACA,cAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,IAAA,cAAA,GAAAA,cAAA,CAAA,YAAoB,GAAG;AACvB,MAAM,gBAAgB,GAAGC,cAA2B;AACpD,MAAM,iBAAiB,GAAG,CAAC;AAC3B,MAAM,aAAa,GAAG,CAAC;AACvB,MAAM,uBAAuB,GAAG,CAAC;AACjC,MAAM,YAAY,GAAG,CAAC,KAAK,KAAK;AAChC,IAAI,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE;AAClB,IAAI,MAAM,cAAc,GAAG,KAAK,CAAC,SAAS,KAAK,IAAI,GAAG,CAAC,GAAG,iBAAiB;AAC3E,IAAI,MAAM,OAAO,GAAG,CAAC,EAAE,GAAG,KAAK,CAAC,QAAQ,MAAM,IAAI,IAAI,EAAE,KAAK,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,QAAQ,MAAM,IAAI,IAAI,EAAE,KAAK,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,cAAc,CAAC;AAC1K,IAAI,MAAM,KAAK,GAAG,IAAI,gBAAgB,CAAC,cAAc,EAAE;AACvD,QAAQ,IAAI,EAAE,SAAS;AACvB,QAAQ,OAAO;AACf,QAAQ,OAAO,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,QAAQ,MAAM,IAAI,IAAI,EAAE,KAAK,MAAM,GAAG,EAAE,GAAG,OAAO;AAC/E,aAAa,KAAK,CAAC,SAAS,KAAK,IAAI,GAAG,uBAAuB,GAAG,aAAa,CAAC;AAChF,KAAK,CAAC;AACN,IAAI,IAAI,KAAK,CAAC,WAAW,KAAK,IAAI;AAClC,QAAQ,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACjF,IAAI,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAE;AAC9B,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,KAAK;AAClC,QAAQ,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACzD,IAAI,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;AAC/B,CAAC;AACD,cAAA,GAAAD,cAAA,CAAA,YAAoB,GAAG,YAAY;;;;"}

package/lib/internal/_randomString.d.ts

@@ -1,2 +1,2 @@
-import { OpenApi } from "@typia/interface";
+import type { OpenApi } from "@typia/interface";
 export declare const _randomString: (props: OpenApi.IJsonSchema.IString) => string;

package/lib/internal/_randomString.js

@@ -2,12 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._randomString = void 0;
 const _randomInteger_1 = require("./_randomInteger");
+const DEFAULT_MIN_LENGTH = 5;
+const DEFAULT_RANGE = 5;
 const _randomString = (props) => {
-    var _a;
+    var _a, _b, _c;
+    const minimum = (_a = props.minLength) !== null && _a !== void 0 ? _a : Math.min((_b = props.maxLength) !== null && _b !== void 0 ? _b : DEFAULT_MIN_LENGTH, DEFAULT_MIN_LENGTH);
     const length = (0, _randomInteger_1._randomInteger)({
         type: "integer",
-        minimum: ((_a = props.minLength) !== null && _a !== void 0 ? _a : 0),
-        maximum: props.maxLength,
+        minimum,
+        maximum: (_c = props.maxLength) !== null && _c !== void 0 ? _c : minimum + DEFAULT_RANGE,
     });
     return new Array(length)
         .fill(0)

package/lib/internal/_randomString.js.map

@@ -1 +1 @@
-{"version":3,"file":"_randomString.js","sourceRoot":"","sources":["../../src/internal/_randomString.ts"],"names":[],"mappings":";;;AAEA,qDAAkD;AAE3C,MAAM,aAAa,GAAG,CAAC,KAAkC,EAAE,EAAE;;IAClE,MAAM,MAAM,GAAW,IAAA,+BAAc,EAAC;QACpC,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,OAAC,KAAK,CAAC,SAAS,mCAAI,CAAC,CAA4B;QAC1D,OAAO,EAAE,KAAK,CAAC,SAA4D;KAC5E,CAAC,CAAC;IACH,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC;SACrB,IAAI,CAAC,CAAC,CAAC;SACP,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;SAC9B,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC,CAAC;AAVW,QAAA,aAAa,GAAb,aAAa,CAUxB;AAEF,MAAM,SAAS,GAAG,4BAA4B,CAAC;AAE/C,MAAM,MAAM,GAAG,GAAG,EAAE,CAClB,IAAA,+BAAc,EAAC;IACb,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC;CAC9B,CAAC,CAAC"}
+{"version":3,"file":"_randomString.js","sourceRoot":"","sources":["../../src/internal/_randomString.ts"],"names":[],"mappings":";;;AAEA,qDAAkD;AAElD,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAC7B,MAAM,aAAa,GAAG,CAAC,CAAC;AAEjB,MAAM,aAAa,GAAG,CAAC,KAAkC,EAAE,EAAE;;IAClE,MAAM,OAAO,SACX,KAAK,CAAC,SAAS,mCACf,IAAI,CAAC,GAAG,OAAC,KAAK,CAAC,SAAS,mCAAI,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;IACtE,MAAM,MAAM,GAAW,IAAA,+BAAc,EAAC;QACpC,IAAI,EAAE,SAAS;QACf,OAAO;QACP,OAAO,QAAE,KAAK,CAAC,SAAS,mCAAI,OAAO,GAAG,aAAa;KACpD,CAAC,CAAC;IACH,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC;SACrB,IAAI,CAAC,CAAC,CAAC;SACP,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;SAC9B,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC,CAAC;AAbW,QAAA,aAAa,GAAb,aAAa,CAaxB;AAEF,MAAM,SAAS,GAAG,4BAA4B,CAAC;AAE/C,MAAM,MAAM,GAAG,GAAG,EAAE,CAClB,IAAA,+BAAc,EAAC;IACb,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC;CAC9B,CAAC,CAAC"}

package/lib/internal/_randomString2.mjs

@@ -5,12 +5,15 @@ import { __exports as _randomInteger } from '../_virtual/_randomInteger.mjs';
 Object.defineProperty(_randomString$1, "__esModule", { value: true });
 var _randomString_2 = _randomString$1._randomString = void 0;
 const _randomInteger_1 = _randomInteger;
+const DEFAULT_MIN_LENGTH = 5;
+const DEFAULT_RANGE = 5;
 const _randomString = (props) => {
-    var _a;
+    var _a, _b, _c;
+    const minimum = (_a = props.minLength) !== null && _a !== void 0 ? _a : Math.min((_b = props.maxLength) !== null && _b !== void 0 ? _b : DEFAULT_MIN_LENGTH, DEFAULT_MIN_LENGTH);
     const length = (0, _randomInteger_1._randomInteger)({
         type: "integer",
-        minimum: ((_a = props.minLength) !== null && _a !== void 0 ? _a : 0),
-        maximum: props.maxLength,
+        minimum,
+        maximum: (_c = props.maxLength) !== null && _c !== void 0 ? _c : minimum + DEFAULT_RANGE,
     });
     return new Array(length)
         .fill(0)

package/lib/internal/_randomString2.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_randomString2.mjs","sources":["_randomString.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports._randomString = void 0;\nconst _randomInteger_1 = require(\"./_randomInteger\");\nconst _randomString = (props) => {\n    var _a;\n    const length = (0, _randomInteger_1._randomInteger)({\n        type: \"integer\",\n        minimum: ((_a = props.minLength) !== null && _a !== void 0 ? _a : 0),\n        maximum: props.maxLength,\n    });\n    return new Array(length)\n        .fill(0)\n        .map(() => ALPHABETS[random()])\n        .join(\"\");\n};\nexports._randomString = _randomString;\nconst ALPHABETS = \"abcdefghijklmnopqrstuvwxyz\";\nconst random = () => (0, _randomInteger_1._randomInteger)({\n    type: \"integer\",\n    minimum: 0,\n    maximum: ALPHABETS.length - 1,\n});\n//# sourceMappingURL=_randomString.js.map"],"names":["_randomString_1","require$$0"],"mappings":";;;;AACA,MAAM,CAAC,cAAc,CAACA,eAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,IAAA,eAAA,GAAAA,eAAA,CAAA,aAAqB,GAAG;AACxB,MAAM,gBAAgB,GAAGC,cAA2B;AACpD,MAAM,aAAa,GAAG,CAAC,KAAK,KAAK;AACjC,IAAI,IAAI,EAAE;AACV,IAAI,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,cAAc,EAAE;AACxD,QAAQ,IAAI,EAAE,SAAS;AACvB,QAAQ,OAAO,GAAG,CAAC,EAAE,GAAG,KAAK,CAAC,SAAS,MAAM,IAAI,IAAI,EAAE,KAAK,MAAM,GAAG,EAAE,GAAG,CAAC,CAAC;AAC5E,QAAQ,OAAO,EAAE,KAAK,CAAC,SAAS;AAChC,KAAK,CAAC;AACN,IAAI,OAAO,IAAI,KAAK,CAAC,MAAM;AAC3B,SAAS,IAAI,CAAC,CAAC;AACf,SAAS,GAAG,CAAC,MAAM,SAAS,CAAC,MAAM,EAAE,CAAC;AACtC,SAAS,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC;AACD,eAAA,GAAAD,eAAA,CAAA,aAAqB,GAAG,aAAa;AACrC,MAAM,SAAS,GAAG,4BAA4B;AAC9C,MAAM,MAAM,GAAG,MAAM,IAAI,gBAAgB,CAAC,cAAc,EAAE;AAC1D,IAAI,IAAI,EAAE,SAAS;AACnB,IAAI,OAAO,EAAE,CAAC;AACd,IAAI,OAAO,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC;AACjC,CAAC,CAAC;;;;"}
+{"version":3,"file":"_randomString2.mjs","sources":["_randomString.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports._randomString = void 0;\nconst _randomInteger_1 = require(\"./_randomInteger\");\nconst DEFAULT_MIN_LENGTH = 5;\nconst DEFAULT_RANGE = 5;\nconst _randomString = (props) => {\n    var _a, _b, _c;\n    const minimum = (_a = props.minLength) !== null && _a !== void 0 ? _a : Math.min((_b = props.maxLength) !== null && _b !== void 0 ? _b : DEFAULT_MIN_LENGTH, DEFAULT_MIN_LENGTH);\n    const length = (0, _randomInteger_1._randomInteger)({\n        type: \"integer\",\n        minimum,\n        maximum: (_c = props.maxLength) !== null && _c !== void 0 ? _c : minimum + DEFAULT_RANGE,\n    });\n    return new Array(length)\n        .fill(0)\n        .map(() => ALPHABETS[random()])\n        .join(\"\");\n};\nexports._randomString = _randomString;\nconst ALPHABETS = \"abcdefghijklmnopqrstuvwxyz\";\nconst random = () => (0, _randomInteger_1._randomInteger)({\n    type: \"integer\",\n    minimum: 0,\n    maximum: ALPHABETS.length - 1,\n});\n//# sourceMappingURL=_randomString.js.map"],"names":["_randomString_1","require$$0"],"mappings":";;;;AACA,MAAM,CAAC,cAAc,CAACA,eAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,IAAA,eAAA,GAAAA,eAAA,CAAA,aAAqB,GAAG;AACxB,MAAM,gBAAgB,GAAGC,cAA2B;AACpD,MAAM,kBAAkB,GAAG,CAAC;AAC5B,MAAM,aAAa,GAAG,CAAC;AACvB,MAAM,aAAa,GAAG,CAAC,KAAK,KAAK;AACjC,IAAI,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE;AAClB,IAAI,MAAM,OAAO,GAAG,CAAC,EAAE,GAAG,KAAK,CAAC,SAAS,MAAM,IAAI,IAAI,EAAE,KAAK,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,SAAS,MAAM,IAAI,IAAI,EAAE,KAAK,MAAM,GAAG,EAAE,GAAG,kBAAkB,EAAE,kBAAkB,CAAC;AACpL,IAAI,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,cAAc,EAAE;AACxD,QAAQ,IAAI,EAAE,SAAS;AACvB,QAAQ,OAAO;AACf,QAAQ,OAAO,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,SAAS,MAAM,IAAI,IAAI,EAAE,KAAK,MAAM,GAAG,EAAE,GAAG,OAAO,GAAG,aAAa;AAChG,KAAK,CAAC;AACN,IAAI,OAAO,IAAI,KAAK,CAAC,MAAM;AAC3B,SAAS,IAAI,CAAC,CAAC;AACf,SAAS,GAAG,CAAC,MAAM,SAAS,CAAC,MAAM,EAAE,CAAC;AACtC,SAAS,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC;AACD,eAAA,GAAAD,eAAA,CAAA,aAAqB,GAAG,aAAa;AACrC,MAAM,SAAS,GAAG,4BAA4B;AAC9C,MAAM,MAAM,GAAG,MAAM,IAAI,gBAAgB,CAAC,cAAc,EAAE;AAC1D,IAAI,IAAI,EAAE,SAAS;AACnB,IAAI,OAAO,EAAE,CAAC;AACd,IAAI,OAAO,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC;AACjC,CAAC,CAAC;;;;"}

package/lib/transform.d.ts

@@ -1,2 +1,3 @@
 import type { ITtscPlugin, ITtscPluginFactoryContext } from "ttsc";
-export default function createTtscPlugin(context: ITtscPluginFactoryContext): ITtscPlugin;
+export declare function createTtscPlugin(context: ITtscPluginFactoryContext): ITtscPlugin;
+export default createTtscPlugin;

package/lib/transform.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = createTtscPlugin;
+exports.createTtscPlugin = createTtscPlugin;
 const node_module_1 = require("node:module");
 const node_path_1 = __importDefault(require("node:path"));
 function createTtscPlugin(context) {
@@ -17,4 +17,5 @@ function createTtscPlugin(context) {
         source: node_path_1.default.resolve(root, "native", "cmd", "ttsc-typia"),
     };
 }
+exports.default = createTtscPlugin;
 //# sourceMappingURL=transform.js.map

package/lib/transform.js.map

@@ -1 +1 @@
-{"version":3,"file":"transform.js","sourceRoot":"","sources":["../src/transform.ts"],"names":[],"mappings":";;;;;;AAAA,6CAA4C;AAC5C,0DAA6B;AAG7B,0BACE,OAAkC;IAElC,oEAAoE;IACpE,wEAAwE;IACxE,2EAA2E;IAC3E,MAAM,WAAW,GAAG,IAAA,2BAAa,EAC/B,mBAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,CAC/C,CAAC;IACF,MAAM,IAAI,GAAW,mBAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC7E,OAAO;QACL,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,mBAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC;KAC1D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../src/transform.ts"],"names":[],"mappings":";;;;;;AAAA,6CAA4C;AAC5C,0DAA6B;AAG7B,0BACE,OAAkC;IAElC,oEAAoE;IACpE,wEAAwE;IACxE,2EAA2E;IAC3E,MAAM,WAAW,GAAG,IAAA,2BAAa,EAC/B,mBAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,CAC/C,CAAC;IACF,MAAM,IAAI,GAAW,mBAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC7E,OAAO;QACL,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,mBAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC;KAC1D,CAAC;AACJ,CAAC;kBAEc,gBAAgB"}

package/lib/transform.mjs

@@ -1,2 +1,2 @@
-export { default } from './transform2.mjs';
+export { createTtscPlugin, default } from './transform2.mjs';
 //# sourceMappingURL=transform.mjs.map

package/lib/transform2.mjs

@@ -6,7 +6,7 @@ var __importDefault = (transform && transform.__importDefault) || function (mod)
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(transform, "__esModule", { value: true });
-var _default = transform.default = createTtscPlugin;
+var createTtscPlugin_1 = transform.createTtscPlugin = createTtscPlugin;
 const node_module_1 = require$$3;
 const node_path_1 = __importDefault(require$$2);
 function createTtscPlugin(context) {
@@ -20,6 +20,7 @@ function createTtscPlugin(context) {
         source: node_path_1.default.resolve(root, "native", "cmd", "ttsc-typia"),
     };
 }
+var _default = transform.default = createTtscPlugin;
 
-export { _default as default };
+export { createTtscPlugin_1 as createTtscPlugin, _default as default };
 //# sourceMappingURL=transform2.mjs.map

package/lib/transform2.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"transform2.mjs","sources":["transform.js"],"sourcesContent":["\"use strict\";\nvar __importDefault = (this && this.__importDefault) || function (mod) {\n    return (mod && mod.__esModule) ? mod : { \"default\": mod };\n};\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.default = createTtscPlugin;\nconst node_module_1 = require(\"node:module\");\nconst node_path_1 = __importDefault(require(\"node:path\"));\nfunction createTtscPlugin(context) {\n    // ttsc loads this descriptor as ESM, where the ambient `require` is\n    // unavailable; anchor a CJS resolver on the consuming project to locate\n    // typia's own package root (not the project root, which has no `native/`).\n    const requireFrom = (0, node_module_1.createRequire)(node_path_1.default.join(context.projectRoot, \"package.json\"));\n    const root = node_path_1.default.dirname(requireFrom.resolve(\"typia/package.json\"));\n    return {\n        name: \"typia\",\n        source: node_path_1.default.resolve(root, \"native\", \"cmd\", \"ttsc-typia\"),\n    };\n}\n//# sourceMappingURL=transform.js.map"],"names":["this","require$$0","require$$1"],"mappings":";;;;AACA,IAAI,eAAe,GAAG,CAACA,SAAI,IAAIA,SAAI,CAAC,eAAe,KAAK,UAAU,GAAG,EAAE;AACvE,IAAI,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE;AAC7D,CAAC;AACD,MAAM,CAAC,cAAc,CAAC,SAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,IAAA,QAAA,GAAA,SAAA,CAAA,OAAe,GAAG;AAClB,MAAM,aAAa,GAAGC,UAAsB;AAC5C,MAAM,WAAW,GAAG,eAAe,CAACC,UAAoB,CAAC;AACzD,SAAS,gBAAgB,CAAC,OAAO,EAAE;AACnC;AACA;AACA;AACA,IAAI,MAAM,WAAW,GAAG,IAAI,aAAa,CAAC,aAAa,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;AACvH,IAAI,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;AACvF,IAAI,OAAO;AACX,QAAQ,IAAI,EAAE,OAAO;AACrB,QAAQ,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC;AAChF,KAAK;AACL;;;;"}
+{"version":3,"file":"transform2.mjs","sources":["transform.js"],"sourcesContent":["\"use strict\";\nvar __importDefault = (this && this.__importDefault) || function (mod) {\n    return (mod && mod.__esModule) ? mod : { \"default\": mod };\n};\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createTtscPlugin = createTtscPlugin;\nconst node_module_1 = require(\"node:module\");\nconst node_path_1 = __importDefault(require(\"node:path\"));\nfunction createTtscPlugin(context) {\n    // ttsc loads this descriptor as ESM, where the ambient `require` is\n    // unavailable; anchor a CJS resolver on the consuming project to locate\n    // typia's own package root (not the project root, which has no `native/`).\n    const requireFrom = (0, node_module_1.createRequire)(node_path_1.default.join(context.projectRoot, \"package.json\"));\n    const root = node_path_1.default.dirname(requireFrom.resolve(\"typia/package.json\"));\n    return {\n        name: \"typia\",\n        source: node_path_1.default.resolve(root, \"native\", \"cmd\", \"ttsc-typia\"),\n    };\n}\nexports.default = createTtscPlugin;\n//# sourceMappingURL=transform.js.map"],"names":["this","require$$0","require$$1"],"mappings":";;;;AACA,IAAI,eAAe,GAAG,CAACA,SAAI,IAAIA,SAAI,CAAC,eAAe,KAAK,UAAU,GAAG,EAAE;AACvE,IAAI,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE;AAC7D,CAAC;AACD,MAAM,CAAC,cAAc,CAAC,SAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,IAAA,kBAAA,GAAA,SAAA,CAAA,gBAAwB,GAAG;AAC3B,MAAM,aAAa,GAAGC,UAAsB;AAC5C,MAAM,WAAW,GAAG,eAAe,CAACC,UAAoB,CAAC;AACzD,SAAS,gBAAgB,CAAC,OAAO,EAAE;AACnC;AACA;AACA;AACA,IAAI,MAAM,WAAW,GAAG,IAAI,aAAa,CAAC,aAAa,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;AACvH,IAAI,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;AACvF,IAAI,OAAO;AACX,QAAQ,IAAI,EAAE,OAAO;AACrB,QAAQ,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC;AAChF,KAAK;AACL;AACA,IAAA,QAAA,GAAA,SAAA,CAAA,OAAe,GAAG;;;;"}

package/native/cmd/ttsc-typia/random_recursive_min_items_diagnostic_test.go

@@ -0,0 +1,234 @@
+package main
+
+import (
+  "os"
+  "path/filepath"
+  "strings"
+  "testing"
+)
+
+// TestRandomRecursiveMinItemsDiagnostic verifies impossible recursive arrays fail.
+//
+// A recursive random array can be depth-stopped to `[]`; combining that edge
+// with a positive `MinItems` constraint is unsatisfiable. The build command must
+// report a real transform diagnostic across direct aliases, type aliases, graph
+// cycles, map-key and map-value graph cycles, nested direct aliases, and
+// tuple-union nesting for both immediate and factory random entrypoints.
+//
+// 1. Build a recursive object whose child array has `MinItems<1>`.
+// 2. Build a direct recursive array alias with `MinItems<1>`.
+// 3. Build alias-property, graph, map-key graph, and nested direct alias variants.
+// 4. Require each project to fail through the transform-diagnostic path.
+func TestRandomRecursiveMinItemsDiagnostic(t *testing.T) {
+  for _, tt := range []struct {
+    name   string
+    source string
+  }{
+    {"object-child", randomRecursiveMinItemsObjectSource},
+    {"property-alias", randomRecursiveMinItemsPropertyAliasSource},
+    {"mutual-graph", randomRecursiveMinItemsGraphSource},
+    {"map-key-graph", randomRecursiveMinItemsMapKeyGraphSource},
+    {"map-value-graph", randomRecursiveMinItemsMapValueGraphSource},
+    {"direct-alias", randomRecursiveMinItemsAliasSource},
+    {"direct-map-alias", randomRecursiveMinItemsMapAliasSource},
+    {"direct-map-value-alias", randomRecursiveMinItemsMapValueAliasSource},
+    {"direct-matrix-alias", randomRecursiveMinItemsMatrixAliasSource},
+    {"tuple-owner", randomRecursiveMinItemsTupleOwnerSource},
+    {"tuple-union", randomRecursiveMinItemsTupleUnionSource},
+  } {
+    randomRecursiveMinItemsExpectDiagnostic(t, tt.name, tt.source)
+  }
+}
+
+func randomRecursiveMinItemsExpectDiagnostic(t *testing.T, name string, source string) {
+  t.Helper()
+  project := randomRecursiveMinItemsProject(t, name, source)
+  _, errText, code := ttscTypiaTestCapture(func() int {
+    return runBuild([]string{
+      "--cwd", project,
+      "--tsconfig", "tsconfig.json",
+      "--emit",
+      "--outDir", filepath.Join(project, "dist"),
+    })
+  })
+  if code != 3 {
+    t.Fatalf("%s recursive MinItems build should fail with code 3, got %d\nstderr=%s", name, code, errText)
+  }
+  normalized := filepath.ToSlash(errText)
+  for _, fragment := range []string{
+    "error TS(typia.random):",
+    "error TS(typia.createRandom):",
+    "recursive array type cannot have MinItems<1>.",
+  } {
+    if !strings.Contains(normalized, fragment) {
+      t.Fatalf("%s recursive MinItems diagnostic missing %q:\n%s", name, fragment, errText)
+    }
+  }
+}
+
+func randomRecursiveMinItemsProject(t *testing.T, name string, source string) string {
+  t.Helper()
+  root := ttscTypiaTestRepoRoot(t)
+  base := filepath.Join(root, "packages", "typia", "native", ".tmp-ttsc-typia-tests")
+  if err := os.MkdirAll(base, 0o755); err != nil {
+    t.Fatalf("mkdir temp base: %v", err)
+  }
+  dir, err := os.MkdirTemp(base, "random-recursive-min-items-"+name+"-")
+  if err != nil {
+    t.Fatalf("create temp fixture: %v", err)
+  }
+  t.Cleanup(func() {
+    _ = os.RemoveAll(dir)
+  })
+  src := filepath.Join(dir, "src")
+  if err := os.MkdirAll(src, 0o755); err != nil {
+    t.Fatalf("mkdir fixture src: %v", err)
+  }
+  if err := os.WriteFile(filepath.Join(dir, "tsconfig.json"), []byte(randomRecursiveMinItemsTSConfig), 0o644); err != nil {
+    t.Fatalf("write tsconfig: %v", err)
+  }
+  if err := os.WriteFile(filepath.Join(src, "main.ts"), []byte(source), 0o644); err != nil {
+    t.Fatalf("write source: %v", err)
+  }
+  return dir
+}
+
+const randomRecursiveMinItemsTSConfig = `{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "commonjs",
+    "moduleResolution": "bundler",
+    "ignoreDeprecations": "6.0",
+    "types": ["*"],
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src"]
+}
+`
+
+const randomRecursiveMinItemsObjectSource = `import typia, { tags } from "typia";
+
+interface INode {
+  value: string;
+  children: INode[] & tags.MinItems<1>;
+}
+
+typia.random<INode>();
+typia.createRandom<INode>();
+`
+
+const randomRecursiveMinItemsPropertyAliasSource = `import typia, { tags } from "typia";
+
+type Children = INode[] & tags.MinItems<1>;
+
+interface INode {
+  value: string;
+  children: Children;
+}
+
+typia.random<INode>();
+typia.createRandom<INode>();
+`
+
+const randomRecursiveMinItemsGraphSource = `import typia, { tags } from "typia";
+
+interface IParent {
+  name: string;
+  children: IChild[] & tags.MinItems<1>;
+}
+
+interface IChild {
+  name: string;
+  parent: IParent;
+}
+
+typia.random<IParent>();
+typia.createRandom<IParent>();
+`
+
+const randomRecursiveMinItemsMapKeyGraphSource = `import typia, { tags } from "typia";
+
+interface IParent {
+  name: string;
+  children: IChild[] & tags.MinItems<1>;
+}
+
+interface IChild {
+  name: string;
+  links: Map<IParent, string>;
+}
+
+typia.random<IParent>();
+typia.createRandom<IParent>();
+`
+
+const randomRecursiveMinItemsMapValueGraphSource = `import typia, { tags } from "typia";
+
+interface IParent {
+  name: string;
+  children: IChild[] & tags.MinItems<1>;
+}
+
+interface IChild {
+  name: string;
+  links: Map<string, IParent>;
+}
+
+typia.random<IParent>();
+typia.createRandom<IParent>();
+`
+
+const randomRecursiveMinItemsAliasSource = `import typia, { tags } from "typia";
+
+type IRecursiveArray = IRecursiveArray[] & tags.MinItems<1>;
+
+typia.random<IRecursiveArray>();
+typia.createRandom<IRecursiveArray>();
+`
+
+const randomRecursiveMinItemsMapAliasSource = `import typia, { tags } from "typia";
+
+type IRecursiveMapArray = Map<IRecursiveMapArray, string>[] & tags.MinItems<1>;
+
+typia.random<IRecursiveMapArray>();
+typia.createRandom<IRecursiveMapArray>();
+`
+
+const randomRecursiveMinItemsMapValueAliasSource = `import typia, { tags } from "typia";
+
+type IRecursiveMapValueArray = Map<string, IRecursiveMapValueArray>[] & tags.MinItems<1>;
+
+typia.random<IRecursiveMapValueArray>();
+typia.createRandom<IRecursiveMapValueArray>();
+`
+
+const randomRecursiveMinItemsMatrixAliasSource = `import typia, { tags } from "typia";
+
+type IRecursiveMatrix = IRecursiveMatrix[][] & tags.MinItems<1>;
+
+typia.random<IRecursiveMatrix>();
+typia.createRandom<IRecursiveMatrix>();
+`
+
+const randomRecursiveMinItemsTupleOwnerSource = `import typia, { tags } from "typia";
+
+type IRecursiveTuple = [IRecursiveTuple[] & tags.MinItems<1>];
+
+typia.random<IRecursiveTuple>();
+typia.createRandom<IRecursiveTuple>();
+`
+
+const randomRecursiveMinItemsTupleUnionSource = `import typia, { tags } from "typia";
+
+interface INode {
+  value: string;
+  nested: [INode[] & tags.MinItems<1>] | null;
+}
+
+typia.random<INode>();
+typia.createRandom<INode>();
+`

package/native/cmd/ttsc-typia/random_unsatisfiable_recursive_diagnostic_test.go

@@ -0,0 +1,146 @@
+package main
+
+import (
+  "os"
+  "path/filepath"
+  "strings"
+  "testing"
+)
+
+// TestRandomUnsatisfiableRecursiveDiagnostic verifies non-terminating recursive
+// types fail.
+//
+// Random generation terminates a recursive type through an escape it can take at
+// the depth cutoff: an array/set/map (or a tuple rest spread) empties, a nullable
+// edge becomes null, an optional or index-signature property is dropped, or a
+// union picks a finite variant. A recursive cycle whose every step is a required,
+// non-nullable, non-container value has no such escape, so the generated function
+// would recurse until the stack overflows. The build must reject it through the
+// transform diagnostic path across object, mutual-object, deep-chain, and
+// array-of-owner shapes, for both immediate and factory random entrypoints.
+//
+//  1. Build a self-referential required object and a mutual object cycle.
+//  2. Build a deep required object chain.
+//  3. Build an array whose element is an unsatisfiable recursive object.
+//  4. Require each project to fail through the transform-diagnostic path.
+func TestRandomUnsatisfiableRecursiveDiagnostic(t *testing.T) {
+  for _, tt := range []struct {
+    name   string
+    source string
+  }{
+    {"required-self", randomUnsatisfiableSelfSource},
+    {"mutual-object", randomUnsatisfiableMutualSource},
+    {"deep-chain", randomUnsatisfiableDeepChainSource},
+    {"array-of-owner", randomUnsatisfiableArrayOfOwnerSource},
+  } {
+    randomUnsatisfiableExpectDiagnostic(t, tt.name, tt.source)
+  }
+}
+
+func randomUnsatisfiableExpectDiagnostic(t *testing.T, name string, source string) {
+  t.Helper()
+  project := randomUnsatisfiableProject(t, name, source)
+  _, errText, code := ttscTypiaTestCapture(func() int {
+    return runBuild([]string{
+      "--cwd", project,
+      "--tsconfig", "tsconfig.json",
+      "--emit",
+      "--outDir", filepath.Join(project, "dist"),
+    })
+  })
+  if code != 3 {
+    t.Fatalf("%s unsatisfiable recursive build should fail with code 3, got %d\nstderr=%s", name, code, errText)
+  }
+  normalized := filepath.ToSlash(errText)
+  for _, fragment := range []string{
+    "error TS(typia.random):",
+    "error TS(typia.createRandom):",
+    "cannot be randomly generated because the recursion never terminates",
+  } {
+    if !strings.Contains(normalized, fragment) {
+      t.Fatalf("%s unsatisfiable recursive diagnostic missing %q:\n%s", name, fragment, errText)
+    }
+  }
+}
+
+func randomUnsatisfiableProject(t *testing.T, name string, source string) string {
+  t.Helper()
+  root := ttscTypiaTestRepoRoot(t)
+  base := filepath.Join(root, "packages", "typia", "native", ".tmp-ttsc-typia-tests")
+  if err := os.MkdirAll(base, 0o755); err != nil {
+    t.Fatalf("mkdir temp base: %v", err)
+  }
+  dir, err := os.MkdirTemp(base, "random-unsatisfiable-recursive-"+name+"-")
+  if err != nil {
+    t.Fatalf("create temp fixture: %v", err)
+  }
+  t.Cleanup(func() {
+    _ = os.RemoveAll(dir)
+  })
+  src := filepath.Join(dir, "src")
+  if err := os.MkdirAll(src, 0o755); err != nil {
+    t.Fatalf("mkdir fixture src: %v", err)
+  }
+  if err := os.WriteFile(filepath.Join(dir, "tsconfig.json"), []byte(randomRecursiveMinItemsTSConfig), 0o644); err != nil {
+    t.Fatalf("write tsconfig: %v", err)
+  }
+  if err := os.WriteFile(filepath.Join(src, "main.ts"), []byte(source), 0o644); err != nil {
+    t.Fatalf("write source: %v", err)
+  }
+  return dir
+}
+
+const randomUnsatisfiableSelfSource = `import typia from "typia";
+
+interface INode {
+  value: string;
+  self: INode;
+}
+
+typia.random<INode>();
+typia.createRandom<INode>();
+`
+
+const randomUnsatisfiableMutualSource = `import typia from "typia";
+
+interface IParent {
+  name: string;
+  child: IChild;
+}
+
+interface IChild {
+  parent: IParent;
+}
+
+typia.random<IParent>();
+typia.createRandom<IParent>();
+`
+
+const randomUnsatisfiableDeepChainSource = `import typia from "typia";
+
+interface IA {
+  b: IB;
+}
+
+interface IB {
+  c: IC;
+}
+
+interface IC {
+  a: IA;
+}
+
+typia.random<IA>();
+typia.createRandom<IA>();
+`
+
+const randomUnsatisfiableArrayOfOwnerSource = `import typia from "typia";
+
+interface INode {
+  value: string;
+  self: INode;
+}
+
+typia.random<INode[]>();
+typia.createRandom<INode[]>();
+`

package/native/core/factories/internal/metadata/MetadataHelper.go

@@ -245,6 +245,53 @@ func metadata_node_description(symbol *nativeast.Symbol) *string {
   return nil
 }
 
+// metadata_node_type_description / metadata_node_type_js_doc_tags read the JSDoc
+// of a TYPE-level symbol (an interface, class, or `type` alias), skipping symbols
+// declared in a TypeScript default library file. Standard-library type aliases
+// carry their own JSDoc (e.g. `NonNullable`'s "Exclude null and undefined from
+// T", `Record`'s "Construct a type ...") and, since the type-name symbol of an
+// instantiation such as `NonNullable<...>` resolves to that library declaration,
+// an unfiltered read would leak the library comment into the user's schema. A
+// property's own comment is unaffected — it is read from the property symbol,
+// which is declared in user code.
+func metadata_node_type_description(symbol *nativeast.Symbol) *string {
+  if metadata_symbol_from_default_lib(symbol) {
+    return nil
+  }
+  return metadata_node_description(symbol)
+}
+
+func metadata_node_type_js_doc_tags(symbol *nativeast.Symbol) []schemametadata.IJsDocTagInfo {
+  if metadata_symbol_from_default_lib(symbol) {
+    return []schemametadata.IJsDocTagInfo{}
+  }
+  return metadata_node_js_doc_tags(symbol)
+}
+
+// metadata_symbol_from_default_lib reports whether the symbol's first locatable
+// declaration lives in a TypeScript default library file. Default library files
+// are always named `lib.<target>.d.ts` regardless of the install directory, so
+// the base name alone is a stable signal.
+func metadata_symbol_from_default_lib(symbol *nativeast.Symbol) bool {
+  for _, node := range metadata_node_declarations(symbol) {
+    src := nativeast.GetSourceFileOfNode(node)
+    if src == nil {
+      continue
+    }
+    return metadata_is_default_lib_file_name(src.FileName())
+  }
+  return false
+}
+
+func metadata_is_default_lib_file_name(fileName string) bool {
+  slash := strings.ReplaceAll(fileName, "\\", "/")
+  base := slash
+  if idx := strings.LastIndex(slash, "/"); idx >= 0 {
+    base = slash[idx+1:]
+  }
+  return strings.HasPrefix(base, "lib.") && strings.HasSuffix(base, ".d.ts")
+}
+
 func metadata_is_internal(symbol *nativeast.Symbol) bool {
   for _, tag := range metadata_node_js_doc_tags(symbol) {
     if tag.Name == "internal" {

package/native/core/factories/internal/metadata/emplace_metadata_alias.go

@@ -17,6 +17,13 @@ func Emplace_metadata_alias(props IMetadataIteratorProps) *schemametadata.Metada
     return alias
   }
 
+  // The MetadataCollection layer stubs description / tags (the AST JSDoc helpers
+  // live in this factory package), so fill them here from the alias symbol. The
+  // type-level readers skip default-library declarations, so a standard-library
+  // alias such as `NonNullable<...>` does not leak its own JSDoc.
+  alias.Description = metadata_node_type_description(symbol)
+  alias.JsDocTags = metadata_node_type_js_doc_tags(symbol)
+
   explore := props.Explore
   explore.Escaped = false
   explore.Aliased = true