typia 13.1.1 → 13.2.0

package/lib/internal/_randomStringLength.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._randomFormatLength = exports._randomLengthPick = exports._randomLengthWindow = exports._randomSegmentLength = exports._RANDOM_LENGTH_ERROR = void 0;
+const _randomInteger_1 = require("./_randomInteger");
+const _randomString_1 = require("./_randomString");
+exports._RANDOM_LENGTH_ERROR = "unable to generate a random string satisfying both the format and the length constraints.";
+/**
+ * Builds the variable segment of a fixed-shape format string so that the total
+ * length `fixed + segment.length` lands inside the requested window.
+ *
+ * `fixed` is the number of characters the format always contributes around the
+ * segment, `fallback` is the segment length used when the leaf is unconstrained
+ * on that side, and `minimum` is the smallest segment the format still
+ * validates with. Throws when the window cannot be satisfied by this format's
+ * shape (e.g. `Format<"email"> & MaxLength<3>`).
+ */
+const _randomSegmentLength = (props, fixed, fallback, minimum) => {
+    let low = (props === null || props === void 0 ? void 0 : props.minLength) === undefined ? minimum : props.minLength - fixed;
+    if (low < minimum)
+        low = minimum;
+    // With only a lower bound, spread the segment across `fallback` extra
+    // characters so the generated length varies, mirroring `_randomString`.
+    const high = (props === null || props === void 0 ? void 0 : props.maxLength) === undefined ? low + fallback : props.maxLength - fixed;
+    if (high < low || high < minimum)
+        throw new Error(exports._RANDOM_LENGTH_ERROR);
+    return (0, _randomString_1._randomString)({ type: "string", minLength: low, maxLength: high });
+};
+exports._randomSegmentLength = _randomSegmentLength;
+/**
+ * Intersects the requested length window with the lengths a format's grammar
+ * can express, and draws one of them.
+ *
+ * `minimum` and `maximum` are the shortest and longest values the format admits
+ * — omit `maximum` when the grammar is open above — and `spread` is how far
+ * past the floor an unbounded request may reach, so an open side still varies
+ * the way `_randomString` does. The caller draws from the returned window and
+ * applies whatever step its grammar has (base64 lengths are multiples of four,
+ * a fractional second needs at least one digit).
+ *
+ * Throws only when the window and the grammar do not overlap at all. That is
+ * the distinction the retry driver below cannot make: it redraws one shape, so
+ * it gives up on every length that shape never emits even when the format
+ * itself accepts one (issue #2284).
+ */
+const _randomLengthWindow = (props, format) => {
+    var _a, _b, _c, _d;
+    const ceiling = (_a = format.maximum) !== null && _a !== void 0 ? _a : Number.MAX_SAFE_INTEGER;
+    const low = Math.max((_b = props === null || props === void 0 ? void 0 : props.minLength) !== null && _b !== void 0 ? _b : format.minimum, format.minimum);
+    const high = Math.min((_c = props === null || props === void 0 ? void 0 : props.maxLength) !== null && _c !== void 0 ? _c : low + ((_d = format.spread) !== null && _d !== void 0 ? _d : 0), ceiling);
+    if (low > high)
+        throw new Error(exports._RANDOM_LENGTH_ERROR);
+    return { low, high };
+};
+exports._randomLengthWindow = _randomLengthWindow;
+/** Draws a length inside a window produced by {@link _randomLengthWindow}. */
+const _randomLengthPick = (window) => (0, _randomInteger_1._randomInteger)({
+    type: "integer",
+    minimum: window.low,
+    maximum: window.high,
+});
+exports._randomLengthPick = _randomLengthPick;
+/**
+ * Wraps a fixed-length format generator (uuid, date) with the requested length
+ * window.
+ *
+ * Use it only where the grammar admits exactly one length, so a window that
+ * excludes it is genuinely unsatisfiable. A format that can express more than
+ * one length must build its value at a length drawn from
+ * {@link _randomLengthWindow} instead; redrawing one shape cannot reach a length
+ * that shape never emits.
+ */
+const _randomFormatLength = (props, generate) => {
+    if ((props === null || props === void 0 ? void 0 : props.minLength) === undefined && (props === null || props === void 0 ? void 0 : props.maxLength) === undefined)
+        return generate();
+    for (let i = 0; i < 256; ++i) {
+        const value = generate();
+        if ((props.minLength === undefined || value.length >= props.minLength) &&
+            (props.maxLength === undefined || value.length <= props.maxLength))
+            return value;
+    }
+    throw new Error(exports._RANDOM_LENGTH_ERROR);
+};
+exports._randomFormatLength = _randomFormatLength;
+//# sourceMappingURL=_randomStringLength.js.map

package/lib/internal/_randomStringLength.js.map

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

package/lib/internal/_randomStringLength.mjs

@@ -0,0 +1,79 @@
+import { _randomInteger } from "./_randomInteger.mjs";
+import { _randomString } from "./_randomString.mjs";
+//#region src/internal/_randomStringLength.ts
+const _RANDOM_LENGTH_ERROR = "unable to generate a random string satisfying both the format and the length constraints.";
+/**
+* Builds the variable segment of a fixed-shape format string so that the total
+* length `fixed + segment.length` lands inside the requested window.
+*
+* `fixed` is the number of characters the format always contributes around the
+* segment, `fallback` is the segment length used when the leaf is unconstrained
+* on that side, and `minimum` is the smallest segment the format still
+* validates with. Throws when the window cannot be satisfied by this format's
+* shape (e.g. `Format<"email"> & MaxLength<3>`).
+*/
+const _randomSegmentLength = (props, fixed, fallback, minimum) => {
+	let low = props?.minLength === void 0 ? minimum : props.minLength - fixed;
+	if (low < minimum) low = minimum;
+	const high = props?.maxLength === void 0 ? low + fallback : props.maxLength - fixed;
+	if (high < low || high < minimum) throw new Error(_RANDOM_LENGTH_ERROR);
+	return _randomString({
+		type: "string",
+		minLength: low,
+		maxLength: high
+	});
+};
+/**
+* Intersects the requested length window with the lengths a format's grammar
+* can express, and draws one of them.
+*
+* `minimum` and `maximum` are the shortest and longest values the format admits
+* — omit `maximum` when the grammar is open above — and `spread` is how far
+* past the floor an unbounded request may reach, so an open side still varies
+* the way `_randomString` does. The caller draws from the returned window and
+* applies whatever step its grammar has (base64 lengths are multiples of four,
+* a fractional second needs at least one digit).
+*
+* Throws only when the window and the grammar do not overlap at all. That is
+* the distinction the retry driver below cannot make: it redraws one shape, so
+* it gives up on every length that shape never emits even when the format
+* itself accepts one (issue #2284).
+*/
+const _randomLengthWindow = (props, format) => {
+	const ceiling = format.maximum ?? Number.MAX_SAFE_INTEGER;
+	const low = Math.max(props?.minLength ?? format.minimum, format.minimum);
+	const high = Math.min(props?.maxLength ?? low + (format.spread ?? 0), ceiling);
+	if (low > high) throw new Error(_RANDOM_LENGTH_ERROR);
+	return {
+		low,
+		high
+	};
+};
+/** Draws a length inside a window produced by {@link _randomLengthWindow}. */
+const _randomLengthPick = (window) => _randomInteger({
+	type: "integer",
+	minimum: window.low,
+	maximum: window.high
+});
+/**
+* Wraps a fixed-length format generator (uuid, date) with the requested length
+* window.
+*
+* Use it only where the grammar admits exactly one length, so a window that
+* excludes it is genuinely unsatisfiable. A format that can express more than
+* one length must build its value at a length drawn from
+* {@link _randomLengthWindow} instead; redrawing one shape cannot reach a length
+* that shape never emits.
+*/
+const _randomFormatLength = (props, generate) => {
+	if (props?.minLength === void 0 && props?.maxLength === void 0) return generate();
+	for (let i = 0; i < 256; ++i) {
+		const value = generate();
+		if ((props.minLength === void 0 || value.length >= props.minLength) && (props.maxLength === void 0 || value.length <= props.maxLength)) return value;
+	}
+	throw new Error(_RANDOM_LENGTH_ERROR);
+};
+//#endregion
+export { _RANDOM_LENGTH_ERROR, _randomFormatLength, _randomLengthPick, _randomLengthWindow, _randomSegmentLength };
+
+//# sourceMappingURL=_randomStringLength.mjs.map

package/lib/internal/_randomStringLength.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_randomStringLength.mjs","names":[],"sources":["../../src/internal/_randomStringLength.ts"],"sourcesContent":["import { _randomInteger } from \"./_randomInteger\";\nimport { _randomString } from \"./_randomString\";\n\nexport const _RANDOM_LENGTH_ERROR =\n  \"unable to generate a random string satisfying both the format and the length constraints.\";\n\n/**\n * Length bounds forwarded to a string format or pattern generator.\n *\n * `typia.random<T>()` passes this object to the `_randomFormat*` and\n * `_randomPattern` helpers whenever the string leaf also carries a `MinLength`\n * or `MaxLength` tag, so a constrained format or pattern is generated at a\n * length its own validator accepts (issue #2189).\n */\nexport interface _ILengthProps {\n  minLength?: number;\n  maxLength?: number;\n}\n\n/**\n * Builds the variable segment of a fixed-shape format string so that the total\n * length `fixed + segment.length` lands inside the requested window.\n *\n * `fixed` is the number of characters the format always contributes around the\n * segment, `fallback` is the segment length used when the leaf is unconstrained\n * on that side, and `minimum` is the smallest segment the format still\n * validates with. Throws when the window cannot be satisfied by this format's\n * shape (e.g. `Format<\"email\"> & MaxLength<3>`).\n */\nexport const _randomSegmentLength = (\n  props: _ILengthProps | undefined,\n  fixed: number,\n  fallback: number,\n  minimum: number,\n): string => {\n  let low: number =\n    props?.minLength === undefined ? minimum : props.minLength - fixed;\n  if (low < minimum) low = minimum;\n  // With only a lower bound, spread the segment across `fallback` extra\n  // characters so the generated length varies, mirroring `_randomString`.\n  const high: number =\n    props?.maxLength === undefined ? low + fallback : props.maxLength - fixed;\n  if (high < low || high < minimum) throw new Error(_RANDOM_LENGTH_ERROR);\n  return _randomString({ type: \"string\", minLength: low, maxLength: high });\n};\n\n/**\n * Intersects the requested length window with the lengths a format's grammar\n * can express, and draws one of them.\n *\n * `minimum` and `maximum` are the shortest and longest values the format admits\n * — omit `maximum` when the grammar is open above — and `spread` is how far\n * past the floor an unbounded request may reach, so an open side still varies\n * the way `_randomString` does. The caller draws from the returned window and\n * applies whatever step its grammar has (base64 lengths are multiples of four,\n * a fractional second needs at least one digit).\n *\n * Throws only when the window and the grammar do not overlap at all. That is\n * the distinction the retry driver below cannot make: it redraws one shape, so\n * it gives up on every length that shape never emits even when the format\n * itself accepts one (issue #2284).\n */\nexport const _randomLengthWindow = (\n  props: _ILengthProps | undefined,\n  format: { minimum: number; maximum?: number; spread?: number },\n): { low: number; high: number } => {\n  const ceiling: number = format.maximum ?? Number.MAX_SAFE_INTEGER;\n  const low: number = Math.max(\n    props?.minLength ?? format.minimum,\n    format.minimum,\n  );\n  const high: number = Math.min(\n    props?.maxLength ?? low + (format.spread ?? 0),\n    ceiling,\n  );\n  if (low > high) throw new Error(_RANDOM_LENGTH_ERROR);\n  return { low, high };\n};\n\n/** Draws a length inside a window produced by {@link _randomLengthWindow}. */\nexport const _randomLengthPick = (window: {\n  low: number;\n  high: number;\n}): number =>\n  _randomInteger({\n    type: \"integer\",\n    minimum: window.low,\n    maximum: window.high,\n  });\n\n/**\n * Wraps a fixed-length format generator (uuid, date) with the requested length\n * window.\n *\n * Use it only where the grammar admits exactly one length, so a window that\n * excludes it is genuinely unsatisfiable. A format that can express more than\n * one length must build its value at a length drawn from\n * {@link _randomLengthWindow} instead; redrawing one shape cannot reach a length\n * that shape never emits.\n */\nexport const _randomFormatLength = (\n  props: _ILengthProps | undefined,\n  generate: () => string,\n): string => {\n  if (props?.minLength === undefined && props?.maxLength === undefined)\n    return generate();\n  for (let i: number = 0; i < 256; ++i) {\n    const value: string = generate();\n    if (\n      (props.minLength === undefined || value.length >= props.minLength) &&\n      (props.maxLength === undefined || value.length <= props.maxLength)\n    )\n      return value;\n  }\n  throw new Error(_RANDOM_LENGTH_ERROR);\n};\n"],"mappings":";;;AAGA,MAAa,uBACX;;;;;;;;;;;AAyBF,MAAa,wBACX,OACA,OACA,UACA,YACW;CACX,IAAI,MACF,OAAO,cAAc,KAAA,IAAY,UAAU,MAAM,YAAY;CAC/D,IAAI,MAAM,SAAS,MAAM;CAGzB,MAAM,OACJ,OAAO,cAAc,KAAA,IAAY,MAAM,WAAW,MAAM,YAAY;CACtE,IAAI,OAAO,OAAO,OAAO,SAAS,MAAM,IAAI,MAAM,oBAAoB;CACtE,OAAO,cAAc;EAAE,MAAM;EAAU,WAAW;EAAK,WAAW;CAAK,CAAC;AAC1E;;;;;;;;;;;;;;;;;AAkBA,MAAa,uBACX,OACA,WACkC;CAClC,MAAM,UAAkB,OAAO,WAAW,OAAO;CACjD,MAAM,MAAc,KAAK,IACvB,OAAO,aAAa,OAAO,SAC3B,OAAO,OACT;CACA,MAAM,OAAe,KAAK,IACxB,OAAO,aAAa,OAAO,OAAO,UAAU,IAC5C,OACF;CACA,IAAI,MAAM,MAAM,MAAM,IAAI,MAAM,oBAAoB;CACpD,OAAO;EAAE;EAAK;CAAK;AACrB;;AAGA,MAAa,qBAAqB,WAIhC,eAAe;CACb,MAAM;CACN,SAAS,OAAO;CAChB,SAAS,OAAO;AAClB,CAAC;;;;;;;;;;;AAYH,MAAa,uBACX,OACA,aACW;CACX,IAAI,OAAO,cAAc,KAAA,KAAa,OAAO,cAAc,KAAA,GACzD,OAAO,SAAS;CAClB,KAAK,IAAI,IAAY,GAAG,IAAI,KAAK,EAAE,GAAG;EACpC,MAAM,QAAgB,SAAS;EAC/B,KACG,MAAM,cAAc,KAAA,KAAa,MAAM,UAAU,MAAM,eACvD,MAAM,cAAc,KAAA,KAAa,MAAM,UAAU,MAAM,YAExD,OAAO;CACX;CACA,MAAM,IAAI,MAAM,oBAAoB;AACtC"}

package/lib/internal/_stringLength.d.ts

@@ -0,0 +1 @@
+export declare const _stringLength: (value: string) => number;

package/lib/internal/_stringLength.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._stringLength = void 0;
+const _stringLength = (value) => {
+    let count = 0;
+    for (const _ch of value)
+        ++count;
+    return count;
+};
+exports._stringLength = _stringLength;
+//# sourceMappingURL=_stringLength.js.map

package/lib/internal/_stringLength.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_stringLength.js","sourceRoot":"","sources":["../../src/internal/_stringLength.ts"],"names":[],"mappings":";;;AAAO,MAAM,aAAa,GAAG,CAAC,KAAa,EAAU,EAAE;IACrD,IAAI,KAAK,GAAW,CAAC,CAAC;IACtB,KAAK,MAAM,GAAG,IAAI,KAAK;QAAE,EAAE,KAAK,CAAC;IACjC,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAJW,QAAA,aAAa,GAAb,aAAa,CAIxB"}

package/lib/internal/_stringLength.mjs

@@ -0,0 +1,10 @@
+//#region src/internal/_stringLength.ts
+const _stringLength = (value) => {
+	let count = 0;
+	for (const _ch of value) ++count;
+	return count;
+};
+//#endregion
+export { _stringLength };
+
+//# sourceMappingURL=_stringLength.mjs.map

package/lib/internal/_stringLength.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_stringLength.mjs","names":[],"sources":["../../src/internal/_stringLength.ts"],"sourcesContent":["export const _stringLength = (value: string): number => {\n  let count: number = 0;\n  for (const _ch of value) ++count;\n  return count;\n};\n"],"mappings":";AAAA,MAAa,iBAAiB,UAA0B;CACtD,IAAI,QAAgB;CACpB,KAAK,MAAM,OAAO,OAAO,EAAE;CAC3B,OAAO;AACT"}

package/lib/internal/_validateReport.js

@@ -2,11 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._validateReport = void 0;
 const _validateReport = (array) => {
+    const isAncestor = (ancestor, descendant) => descendant === ancestor ||
+        descendant.startsWith(`${ancestor}.`) ||
+        descendant.startsWith(`${ancestor}[`);
     const reportable = (path) => {
         if (array.length === 0)
             return true;
         const last = array[array.length - 1].path;
-        return path.length > last.length || last.substring(0, path.length) !== path;
+        return isAncestor(path, last) === false && isAncestor(last, path) === false;
     };
     return (exceptable, error) => {
         var _a;

package/lib/internal/_validateReport.js.map

@@ -1 +1 @@
-{"version":3,"file":"_validateReport.js","sourceRoot":"","sources":["../../src/internal/_validateReport.ts"],"names":[],"mappings":";;;AAEO,MAAM,eAAe,GAAG,CAAC,KAA2B,EAAE,EAAE;IAC7D,MAAM,UAAU,GAAG,CAAC,IAAY,EAAW,EAAE;QAC3C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACpC,MAAM,IAAI,GAAW,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,IAAI,CAAC;QACnD,OAAO,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IAC9E,CAAC,CAAC;IACF,OAAO,CAAC,UAAmB,EAAE,KAAyB,EAAS,EAAE;;QAC/D,IAAI,UAAU,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;gBAC3B,MAAA,KAAK,CAAC,WAAW,oCAAjB,KAAK,CAAC,WAAW,GAAK;oBACpB,wCAAwC;oBACxC,EAAE;oBACF,qBAAqB,KAAK,CAAC,QAAQ,2BAA2B;iBAC/D,CAAC,IAAI,CAAC,IAAI,CAAC,EAAC;YACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC,CAAC;AAlBW,QAAA,eAAe,GAAf,eAAe,CAkB1B"}
+{"version":3,"file":"_validateReport.js","sourceRoot":"","sources":["../../src/internal/_validateReport.ts"],"names":[],"mappings":";;;AAEO,MAAM,eAAe,GAAG,CAAC,KAA2B,EAAE,EAAE;IAC7D,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAE,UAAkB,EAAW,EAAE,CACnE,UAAU,KAAK,QAAQ;QACvB,UAAU,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,CAAC;QACrC,UAAU,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAW,EAAE;QAC3C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACpC,MAAM,IAAI,GAAW,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,IAAI,CAAC;QACnD,OAAO,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,KAAK,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,KAAK,CAAC;IAC9E,CAAC,CAAC;IACF,OAAO,CAAC,UAAmB,EAAE,KAAyB,EAAS,EAAE;;QAC/D,IAAI,UAAU,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;gBAC3B,MAAA,KAAK,CAAC,WAAW,oCAAjB,KAAK,CAAC,WAAW,GAAK;oBACpB,wCAAwC;oBACxC,EAAE;oBACF,qBAAqB,KAAK,CAAC,QAAQ,2BAA2B;iBAC/D,CAAC,IAAI,CAAC,IAAI,CAAC,EAAC;YACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC,CAAC;AAtBW,QAAA,eAAe,GAAf,eAAe,CAsB1B"}

package/lib/internal/_validateReport.mjs

@@ -1,9 +1,10 @@
 //#region src/internal/_validateReport.ts
 const _validateReport = (array) => {
+	const isAncestor = (ancestor, descendant) => descendant === ancestor || descendant.startsWith(`${ancestor}.`) || descendant.startsWith(`${ancestor}[`);
 	const reportable = (path) => {
 		if (array.length === 0) return true;
 		const last = array[array.length - 1].path;
-		return path.length > last.length || last.substring(0, path.length) !== path;
+		return isAncestor(path, last) === false && isAncestor(last, path) === false;
 	};
 	return (exceptable, error) => {
 		if (exceptable && reportable(error.path)) {

package/lib/internal/_validateReport.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_validateReport.mjs","names":[],"sources":["../../src/internal/_validateReport.ts"],"sourcesContent":["import { IValidation } from \"@typia/interface\";\n\nexport const _validateReport = (array: IValidation.IError[]) => {\n  const reportable = (path: string): boolean => {\n    if (array.length === 0) return true;\n    const last: string = array[array.length - 1]!.path;\n    return path.length > last.length || last.substring(0, path.length) !== path;\n  };\n  return (exceptable: boolean, error: IValidation.IError): false => {\n    if (exceptable && reportable(error.path)) {\n      if (error.value === undefined)\n        error.description ??= [\n          \"The value at this path is `undefined`.\",\n          \"\",\n          `Please fill the \\`${error.expected}\\` typed value next time.`,\n        ].join(\"\\n\");\n      array.push(error);\n    }\n    return false;\n  };\n};\n"],"mappings":";AAEA,MAAa,mBAAmB,UAAgC;CAC9D,MAAM,cAAc,SAA0B;EAC5C,IAAI,MAAM,WAAW,GAAG,OAAO;EAC/B,MAAM,OAAe,MAAM,MAAM,SAAS,EAAE,CAAE;EAC9C,OAAO,KAAK,SAAS,KAAK,UAAU,KAAK,UAAU,GAAG,KAAK,MAAM,MAAM;CACzE;CACA,QAAQ,YAAqB,UAAqC;EAChE,IAAI,cAAc,WAAW,MAAM,IAAI,GAAG;GACxC,IAAI,MAAM,UAAU,KAAA,GAClB,MAAM,gBAAgB;IACpB;IACA;IACA,qBAAqB,MAAM,SAAS;GACtC,CAAC,CAAC,KAAK,IAAI;GACb,MAAM,KAAK,KAAK;EAClB;EACA,OAAO;CACT;AACF"}
+{"version":3,"file":"_validateReport.mjs","names":[],"sources":["../../src/internal/_validateReport.ts"],"sourcesContent":["import { IValidation } from \"@typia/interface\";\n\nexport const _validateReport = (array: IValidation.IError[]) => {\n  const isAncestor = (ancestor: string, descendant: string): boolean =>\n    descendant === ancestor ||\n    descendant.startsWith(`${ancestor}.`) ||\n    descendant.startsWith(`${ancestor}[`);\n  const reportable = (path: string): boolean => {\n    if (array.length === 0) return true;\n    const last: string = array[array.length - 1]!.path;\n    return isAncestor(path, last) === false && isAncestor(last, path) === false;\n  };\n  return (exceptable: boolean, error: IValidation.IError): false => {\n    if (exceptable && reportable(error.path)) {\n      if (error.value === undefined)\n        error.description ??= [\n          \"The value at this path is `undefined`.\",\n          \"\",\n          `Please fill the \\`${error.expected}\\` typed value next time.`,\n        ].join(\"\\n\");\n      array.push(error);\n    }\n    return false;\n  };\n};\n"],"mappings":";AAEA,MAAa,mBAAmB,UAAgC;CAC9D,MAAM,cAAc,UAAkB,eACpC,eAAe,YACf,WAAW,WAAW,GAAG,SAAS,EAAE,KACpC,WAAW,WAAW,GAAG,SAAS,EAAE;CACtC,MAAM,cAAc,SAA0B;EAC5C,IAAI,MAAM,WAAW,GAAG,OAAO;EAC/B,MAAM,OAAe,MAAM,MAAM,SAAS,EAAE,CAAE;EAC9C,OAAO,WAAW,MAAM,IAAI,MAAM,SAAS,WAAW,MAAM,IAAI,MAAM;CACxE;CACA,QAAQ,YAAqB,UAAqC;EAChE,IAAI,cAAc,WAAW,MAAM,IAAI,GAAG;GACxC,IAAI,MAAM,UAAU,KAAA,GAClB,MAAM,gBAAgB;IACpB;IACA;IACA,qBAAqB,MAAM,SAAS;GACtC,CAAC,CAAC,KAAK,IAAI;GACb,MAAM,KAAK,KAAK;EAClB;EACA,OAAO;CACT;AACF"}

package/lib/internal/private/__notationRename.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared outer walk for the `camel`/`pascal` notations.
+ *
+ * Mirrors the `CamelCase<T>` / `PascalCase<T>` typings: leading underscores are
+ * preserved verbatim, an all-underscore key stays untouched, and the presence
+ * of any remaining underscore — not the number of non-empty segments — selects
+ * the `snake` conversion. Routing on underscore presence keeps a trailing or
+ * doubled underscore (`fooBar_`) on the same path the type takes, instead of
+ * collapsing it to the underscore-free `plain` path.
+ */
+export declare const __notationRename: (props: {
+    plain: (str: string) => string;
+    snake: (str: string) => string;
+}) => (str: string) => string;

package/lib/internal/private/__notationRename.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__notationRename = void 0;
+/**
+ * Shared outer walk for the `camel`/`pascal` notations.
+ *
+ * Mirrors the `CamelCase<T>` / `PascalCase<T>` typings: leading underscores are
+ * preserved verbatim, an all-underscore key stays untouched, and the presence
+ * of any remaining underscore — not the number of non-empty segments — selects
+ * the `snake` conversion. Routing on underscore presence keeps a trailing or
+ * doubled underscore (`fooBar_`) on the same path the type takes, instead of
+ * collapsing it to the underscore-free `plain` path.
+ */
+const __notationRename = (props) => (str) => {
+    let prefix = "";
+    while (str.startsWith("_")) {
+        prefix += "_";
+        str = str.substring(1);
+    }
+    if (str.length === 0)
+        return prefix;
+    return `${prefix}${str.includes("_") ? props.snake(str) : props.plain(str)}`;
+};
+exports.__notationRename = __notationRename;
+//# sourceMappingURL=__notationRename.js.map

package/lib/internal/private/__notationRename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"__notationRename.js","sourceRoot":"","sources":["../../../src/internal/private/__notationRename.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACI,MAAM,gBAAgB,GAC3B,CAAC,KAAyE,EAAE,EAAE,CAC9E,CAAC,GAAW,EAAU,EAAE;IACtB,IAAI,MAAM,GAAW,EAAE,CAAC;IACxB,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,CAAC;QACd,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACpC,OAAO,GAAG,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;AAC/E,CAAC,CAAC;AAVS,QAAA,gBAAgB,GAAhB,gBAAgB,CAUzB"}

package/lib/internal/private/__notationRename.mjs

@@ -0,0 +1,24 @@
+//#region src/internal/private/__notationRename.ts
+/**
+* Shared outer walk for the `camel`/`pascal` notations.
+*
+* Mirrors the `CamelCase<T>` / `PascalCase<T>` typings: leading underscores are
+* preserved verbatim, an all-underscore key stays untouched, and the presence
+* of any remaining underscore — not the number of non-empty segments — selects
+* the `snake` conversion. Routing on underscore presence keeps a trailing or
+* doubled underscore (`fooBar_`) on the same path the type takes, instead of
+* collapsing it to the underscore-free `plain` path.
+*/
+const __notationRename = (props) => (str) => {
+	let prefix = "";
+	while (str.startsWith("_")) {
+		prefix += "_";
+		str = str.substring(1);
+	}
+	if (str.length === 0) return prefix;
+	return `${prefix}${str.includes("_") ? props.snake(str) : props.plain(str)}`;
+};
+//#endregion
+export { __notationRename };
+
+//# sourceMappingURL=__notationRename.mjs.map

package/lib/internal/private/__notationRename.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"__notationRename.mjs","names":[],"sources":["../../../src/internal/private/__notationRename.ts"],"sourcesContent":["/**\n * Shared outer walk for the `camel`/`pascal` notations.\n *\n * Mirrors the `CamelCase<T>` / `PascalCase<T>` typings: leading underscores are\n * preserved verbatim, an all-underscore key stays untouched, and the presence\n * of any remaining underscore — not the number of non-empty segments — selects\n * the `snake` conversion. Routing on underscore presence keeps a trailing or\n * doubled underscore (`fooBar_`) on the same path the type takes, instead of\n * collapsing it to the underscore-free `plain` path.\n */\nexport const __notationRename =\n  (props: { plain: (str: string) => string; snake: (str: string) => string }) =>\n  (str: string): string => {\n    let prefix: string = \"\";\n    while (str.startsWith(\"_\")) {\n      prefix += \"_\";\n      str = str.substring(1);\n    }\n    if (str.length === 0) return prefix;\n    return `${prefix}${str.includes(\"_\") ? props.snake(str) : props.plain(str)}`;\n  };\n"],"mappings":";;;;;;;;;;;AAUA,MAAa,oBACV,WACA,QAAwB;CACvB,IAAI,SAAiB;CACrB,OAAO,IAAI,WAAW,GAAG,GAAG;EAC1B,UAAU;EACV,MAAM,IAAI,UAAU,CAAC;CACvB;CACA,IAAI,IAAI,WAAW,GAAG,OAAO;CAC7B,OAAO,GAAG,SAAS,IAAI,SAAS,GAAG,IAAI,MAAM,MAAM,GAAG,IAAI,MAAM,MAAM,GAAG;AAC3E"}

package/lib/internal/private/__randomComposition.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Splits `total` into `count` parts, each inside `[minimum, maximum]`.
+ *
+ * Used where a format's length is the sum of its segments — an IPv4 octet spans
+ * one to three digits, an IPv6 group one to four — so a requested total length
+ * is realized by choosing how many characters each segment contributes instead
+ * of redrawing whole addresses and hoping one lands in the window (issue
+ * #2284).
+ *
+ * The caller guarantees `count * minimum <= total <= count * maximum`; each
+ * part is drawn from the range that still leaves the remaining parts
+ * satisfiable.
+ */
+export declare const __randomComposition: (props: {
+    total: number;
+    count: number;
+    minimum: number;
+    maximum: number;
+}) => number[];
+/** Draws `length` decimal digits, leading zeros included. */
+export declare const __randomDigits: (length: number) => string;
+/** Draws a decimal number of exactly `length` digits without a leading zero. */
+export declare const __randomNumeric: (length: number) => string;

package/lib/internal/private/__randomComposition.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__randomNumeric = exports.__randomDigits = exports.__randomComposition = void 0;
+const _randomInteger_1 = require("../_randomInteger");
+/**
+ * Splits `total` into `count` parts, each inside `[minimum, maximum]`.
+ *
+ * Used where a format's length is the sum of its segments — an IPv4 octet spans
+ * one to three digits, an IPv6 group one to four — so a requested total length
+ * is realized by choosing how many characters each segment contributes instead
+ * of redrawing whole addresses and hoping one lands in the window (issue
+ * #2284).
+ *
+ * The caller guarantees `count * minimum <= total <= count * maximum`; each
+ * part is drawn from the range that still leaves the remaining parts
+ * satisfiable.
+ */
+const __randomComposition = (props) => {
+    const parts = [];
+    let remaining = props.total;
+    for (let i = 0; i < props.count; ++i) {
+        const rest = props.count - i - 1;
+        const value = (0, _randomInteger_1._randomInteger)({
+            type: "integer",
+            minimum: Math.max(props.minimum, remaining - rest * props.maximum),
+            maximum: Math.min(props.maximum, remaining - rest * props.minimum),
+        });
+        parts.push(value);
+        remaining -= value;
+    }
+    return parts;
+};
+exports.__randomComposition = __randomComposition;
+/** Draws `length` decimal digits, leading zeros included. */
+const __randomDigits = (length) => {
+    let text = "";
+    for (let i = 0; i < length; ++i)
+        text += String((0, _randomInteger_1._randomInteger)({ type: "integer", minimum: 0, maximum: 9 }));
+    return text;
+};
+exports.__randomDigits = __randomDigits;
+/** Draws a decimal number of exactly `length` digits without a leading zero. */
+const __randomNumeric = (length) => length <= 1
+    ? String((0, _randomInteger_1._randomInteger)({ type: "integer", minimum: 0, maximum: 9 }))
+    : String((0, _randomInteger_1._randomInteger)({ type: "integer", minimum: 1, maximum: 9 })) +
+        (0, exports.__randomDigits)(length - 1);
+exports.__randomNumeric = __randomNumeric;
+//# sourceMappingURL=__randomComposition.js.map

package/lib/internal/private/__randomComposition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"__randomComposition.js","sourceRoot":"","sources":["../../../src/internal/private/__randomComposition.ts"],"names":[],"mappings":";;;AAAA,sDAAmD;AAEnD;;;;;;;;;;;;GAYG;AACI,MAAM,mBAAmB,GAAG,CAAC,KAKnC,EAAY,EAAE;IACb,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,SAAS,GAAW,KAAK,CAAC,KAAK,CAAC;IACpC,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAW,KAAK,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;QACzC,MAAM,KAAK,GAAW,IAAA,+BAAc,EAAC;YACnC,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC;YAClE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC;SACnE,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,SAAS,IAAI,KAAK,CAAC;IACrB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAnBW,QAAA,mBAAmB,GAAnB,mBAAmB,CAmB9B;AAEF,6DAA6D;AACtD,MAAM,cAAc,GAAG,CAAC,MAAc,EAAU,EAAE;IACvD,IAAI,IAAI,GAAW,EAAE,CAAC;IACtB,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,MAAM,CAAC,IAAA,+BAAc,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9E,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AALW,QAAA,cAAc,GAAd,cAAc,CAKzB;AAEF,gFAAgF;AACzE,MAAM,eAAe,GAAG,CAAC,MAAc,EAAU,EAAE,CACxD,MAAM,IAAI,CAAC;IACT,CAAC,CAAC,MAAM,CAAC,IAAA,+BAAc,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC,MAAM,CAAC,IAAA,+BAAc,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QACnE,IAAA,QAAA,cAAc,EAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAJpB,QAAA,eAAe,GAAf,eAAe,CAIK"}

package/lib/internal/private/__randomComposition.mjs

@@ -0,0 +1,54 @@
+import { _randomInteger } from "../_randomInteger.mjs";
+//#region src/internal/private/__randomComposition.ts
+/**
+* Splits `total` into `count` parts, each inside `[minimum, maximum]`.
+*
+* Used where a format's length is the sum of its segments — an IPv4 octet spans
+* one to three digits, an IPv6 group one to four — so a requested total length
+* is realized by choosing how many characters each segment contributes instead
+* of redrawing whole addresses and hoping one lands in the window (issue
+* #2284).
+*
+* The caller guarantees `count * minimum <= total <= count * maximum`; each
+* part is drawn from the range that still leaves the remaining parts
+* satisfiable.
+*/
+const __randomComposition = (props) => {
+	const parts = [];
+	let remaining = props.total;
+	for (let i = 0; i < props.count; ++i) {
+		const rest = props.count - i - 1;
+		const value = _randomInteger({
+			type: "integer",
+			minimum: Math.max(props.minimum, remaining - rest * props.maximum),
+			maximum: Math.min(props.maximum, remaining - rest * props.minimum)
+		});
+		parts.push(value);
+		remaining -= value;
+	}
+	return parts;
+};
+/** Draws `length` decimal digits, leading zeros included. */
+const __randomDigits = (length) => {
+	let text = "";
+	for (let i = 0; i < length; ++i) text += String(_randomInteger({
+		type: "integer",
+		minimum: 0,
+		maximum: 9
+	}));
+	return text;
+};
+/** Draws a decimal number of exactly `length` digits without a leading zero. */
+const __randomNumeric = (length) => length <= 1 ? String(_randomInteger({
+	type: "integer",
+	minimum: 0,
+	maximum: 9
+})) : String(_randomInteger({
+	type: "integer",
+	minimum: 1,
+	maximum: 9
+})) + __randomDigits(length - 1);
+//#endregion
+export { __randomComposition, __randomDigits, __randomNumeric };
+
+//# sourceMappingURL=__randomComposition.mjs.map

package/lib/internal/private/__randomComposition.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"__randomComposition.mjs","names":[],"sources":["../../../src/internal/private/__randomComposition.ts"],"sourcesContent":["import { _randomInteger } from \"../_randomInteger\";\n\n/**\n * Splits `total` into `count` parts, each inside `[minimum, maximum]`.\n *\n * Used where a format's length is the sum of its segments — an IPv4 octet spans\n * one to three digits, an IPv6 group one to four — so a requested total length\n * is realized by choosing how many characters each segment contributes instead\n * of redrawing whole addresses and hoping one lands in the window (issue\n * #2284).\n *\n * The caller guarantees `count * minimum <= total <= count * maximum`; each\n * part is drawn from the range that still leaves the remaining parts\n * satisfiable.\n */\nexport const __randomComposition = (props: {\n  total: number;\n  count: number;\n  minimum: number;\n  maximum: number;\n}): number[] => {\n  const parts: number[] = [];\n  let remaining: number = props.total;\n  for (let i: number = 0; i < props.count; ++i) {\n    const rest: number = props.count - i - 1;\n    const value: number = _randomInteger({\n      type: \"integer\",\n      minimum: Math.max(props.minimum, remaining - rest * props.maximum),\n      maximum: Math.min(props.maximum, remaining - rest * props.minimum),\n    });\n    parts.push(value);\n    remaining -= value;\n  }\n  return parts;\n};\n\n/** Draws `length` decimal digits, leading zeros included. */\nexport const __randomDigits = (length: number): string => {\n  let text: string = \"\";\n  for (let i: number = 0; i < length; ++i)\n    text += String(_randomInteger({ type: \"integer\", minimum: 0, maximum: 9 }));\n  return text;\n};\n\n/** Draws a decimal number of exactly `length` digits without a leading zero. */\nexport const __randomNumeric = (length: number): string =>\n  length <= 1\n    ? String(_randomInteger({ type: \"integer\", minimum: 0, maximum: 9 }))\n    : String(_randomInteger({ type: \"integer\", minimum: 1, maximum: 9 })) +\n      __randomDigits(length - 1);\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAa,uBAAuB,UAKpB;CACd,MAAM,QAAkB,CAAC;CACzB,IAAI,YAAoB,MAAM;CAC9B,KAAK,IAAI,IAAY,GAAG,IAAI,MAAM,OAAO,EAAE,GAAG;EAC5C,MAAM,OAAe,MAAM,QAAQ,IAAI;EACvC,MAAM,QAAgB,eAAe;GACnC,MAAM;GACN,SAAS,KAAK,IAAI,MAAM,SAAS,YAAY,OAAO,MAAM,OAAO;GACjE,SAAS,KAAK,IAAI,MAAM,SAAS,YAAY,OAAO,MAAM,OAAO;EACnE,CAAC;EACD,MAAM,KAAK,KAAK;EAChB,aAAa;CACf;CACA,OAAO;AACT;;AAGA,MAAa,kBAAkB,WAA2B;CACxD,IAAI,OAAe;CACnB,KAAK,IAAI,IAAY,GAAG,IAAI,QAAQ,EAAE,GACpC,QAAQ,OAAO,eAAe;EAAE,MAAM;EAAW,SAAS;EAAG,SAAS;CAAE,CAAC,CAAC;CAC5E,OAAO;AACT;;AAGA,MAAa,mBAAmB,WAC9B,UAAU,IACN,OAAO,eAAe;CAAE,MAAM;CAAW,SAAS;CAAG,SAAS;AAAE,CAAC,CAAC,IAClE,OAAO,eAAe;CAAE,MAAM;CAAW,SAAS;CAAG,SAAS;AAAE,CAAC,CAAC,IAClE,eAAe,SAAS,CAAC"}

package/lib/internal/private/__randomEpoch.d.ts

@@ -0,0 +1,19 @@
+export interface __IEpochProps {
+    minimum?: number;
+    maximum?: number;
+}
+/**
+ * Draws an epoch millisecond inside the requested bounds.
+ *
+ * Shared by the `date` and `date-time` generators, which had the same bound
+ * expression written twice: `props?.maximum ?? props?.minimum === undefined`
+ * parses as `props?.maximum ?? (props?.minimum === undefined)` because `??`
+ * binds looser than `===`, so any supplied `maximum` made the condition truthy
+ * and was replaced by `Date.now()`, while `maximum: 0` fell through to
+ * `undefined + one year` and produced `NaN` (issue #2287). Keeping the
+ * resolution in one place is what stops the two copies from drifting again.
+ *
+ * With no bound at all the window ends at the present instant; with only a
+ * lower bound it spans one year from there.
+ */
+export declare const __randomEpoch: (props?: __IEpochProps) => number;

package/lib/internal/private/__randomEpoch.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__randomEpoch = void 0;
+const _randomInteger_1 = require("../_randomInteger");
+/**
+ * Draws an epoch millisecond inside the requested bounds.
+ *
+ * Shared by the `date` and `date-time` generators, which had the same bound
+ * expression written twice: `props?.maximum ?? props?.minimum === undefined`
+ * parses as `props?.maximum ?? (props?.minimum === undefined)` because `??`
+ * binds looser than `===`, so any supplied `maximum` made the condition truthy
+ * and was replaced by `Date.now()`, while `maximum: 0` fell through to
+ * `undefined + one year` and produced `NaN` (issue #2287). Keeping the
+ * resolution in one place is what stops the two copies from drifting again.
+ *
+ * With no bound at all the window ends at the present instant; with only a
+ * lower bound it spans one year from there.
+ */
+const __randomEpoch = (props) => {
+    var _a, _b;
+    const minimum = (_a = props === null || props === void 0 ? void 0 : props.minimum) !== null && _a !== void 0 ? _a : 0;
+    const maximum = (_b = props === null || props === void 0 ? void 0 : props.maximum) !== null && _b !== void 0 ? _b : ((props === null || props === void 0 ? void 0 : props.minimum) === undefined ? Date.now() : props.minimum + YEAR);
+    return (0, _randomInteger_1._randomInteger)({
+        type: "integer",
+        minimum,
+        maximum,
+    });
+};
+exports.__randomEpoch = __randomEpoch;
+const YEAR = 365 * 24 * 60 * 60 * 1000;
+//# sourceMappingURL=__randomEpoch.js.map

package/lib/internal/private/__randomEpoch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"__randomEpoch.js","sourceRoot":"","sources":["../../../src/internal/private/__randomEpoch.ts"],"names":[],"mappings":";;;AAAA,sDAAmD;AAOnD;;;;;;;;;;;;;GAaG;AACI,MAAM,aAAa,GAAG,CAAC,KAAqB,EAAU,EAAE;;IAC7D,MAAM,OAAO,SAAW,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,OAAO,mCAAI,CAAC,CAAC;IAC5C,MAAM,OAAO,SACX,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,OAAO,mCACd,CAAC,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,OAAO,MAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACrE,OAAO,IAAA,+BAAc,EAAC;QACpB,IAAI,EAAE,SAAS;QACf,OAAO;QACP,OAAO;KACR,CAAC,CAAC;AACL,CAAC,CAAC;AAVW,QAAA,aAAa,GAAb,aAAa,CAUxB;AAEF,MAAM,IAAI,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAK,CAAC"}

package/lib/internal/private/__randomEpoch.mjs

@@ -0,0 +1,28 @@
+import { _randomInteger } from "../_randomInteger.mjs";
+//#region src/internal/private/__randomEpoch.ts
+/**
+* Draws an epoch millisecond inside the requested bounds.
+*
+* Shared by the `date` and `date-time` generators, which had the same bound
+* expression written twice: `props?.maximum ?? props?.minimum === undefined`
+* parses as `props?.maximum ?? (props?.minimum === undefined)` because `??`
+* binds looser than `===`, so any supplied `maximum` made the condition truthy
+* and was replaced by `Date.now()`, while `maximum: 0` fell through to
+* `undefined + one year` and produced `NaN` (issue #2287). Keeping the
+* resolution in one place is what stops the two copies from drifting again.
+*
+* With no bound at all the window ends at the present instant; with only a
+* lower bound it spans one year from there.
+*/
+const __randomEpoch = (props) => {
+	return _randomInteger({
+		type: "integer",
+		minimum: props?.minimum ?? 0,
+		maximum: props?.maximum ?? (props?.minimum === void 0 ? Date.now() : props.minimum + YEAR)
+	});
+};
+const YEAR = 365 * 24 * 60 * 60 * 1e3;
+//#endregion
+export { __randomEpoch };
+
+//# sourceMappingURL=__randomEpoch.mjs.map

package/lib/internal/private/__randomEpoch.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"__randomEpoch.mjs","names":[],"sources":["../../../src/internal/private/__randomEpoch.ts"],"sourcesContent":["import { _randomInteger } from \"../_randomInteger\";\n\nexport interface __IEpochProps {\n  minimum?: number;\n  maximum?: number;\n}\n\n/**\n * Draws an epoch millisecond inside the requested bounds.\n *\n * Shared by the `date` and `date-time` generators, which had the same bound\n * expression written twice: `props?.maximum ?? props?.minimum === undefined`\n * parses as `props?.maximum ?? (props?.minimum === undefined)` because `??`\n * binds looser than `===`, so any supplied `maximum` made the condition truthy\n * and was replaced by `Date.now()`, while `maximum: 0` fell through to\n * `undefined + one year` and produced `NaN` (issue #2287). Keeping the\n * resolution in one place is what stops the two copies from drifting again.\n *\n * With no bound at all the window ends at the present instant; with only a\n * lower bound it spans one year from there.\n */\nexport const __randomEpoch = (props?: __IEpochProps): number => {\n  const minimum: number = props?.minimum ?? 0;\n  const maximum: number =\n    props?.maximum ??\n    (props?.minimum === undefined ? Date.now() : props.minimum + YEAR);\n  return _randomInteger({\n    type: \"integer\",\n    minimum,\n    maximum,\n  });\n};\n\nconst YEAR = 365 * 24 * 60 * 60 * 1_000;\n"],"mappings":";;;;;;;;;;;;;;;;AAqBA,MAAa,iBAAiB,UAAkC;CAK9D,OAAO,eAAe;EACpB,MAAM;EACN,SANsB,OAAO,WAAW;EAOxC,SALA,OAAO,YACN,OAAO,YAAY,KAAA,IAAY,KAAK,IAAI,IAAI,MAAM,UAAU;CAK/D,CAAC;AACH;AAEA,MAAM,OAAO,MAAM,KAAK,KAAK,KAAK"}

package/lib/json.d.ts

@@ -62,10 +62,10 @@ export declare function application(): never;
  *
  * - Custom LLM function calling schema formats
  * - API documentation or code generation tools
- * - Alternative LLM integrations beyond built-in providers
+ * - Alternative LLM integrations that need full JSON Schema
  *
  * For standard LLM function calling, use {@link llm.application} instead, which
- * provides provider-specific schemas (ChatGPT, Claude, Gemini, etc.).
+ * builds the LLM-optimized function schema directly.
  *
  * @template Class Target class or interface type
  * @template Version OpenAPI version (`"3.0"` | `"3.1"`). Default `"3.1"`