typia 13.1.19 → 13.3.0

package/lib/internal/_randomFormatTime.mjs

@@ -1,12 +1,47 @@
 import { _randomInteger } from "./_randomInteger.mjs";
-import { _randomFormatLength } from "./_randomStringLength.mjs";
+import { _RANDOM_LENGTH_ERROR, _randomLengthPick, _randomLengthWindow } from "./_randomStringLength.mjs";
+import { __randomDigits } from "./private/__randomComposition.mjs";
 //#region src/internal/_randomFormatTime.ts
-const _randomFormatTime = (props) => _randomFormatLength(props, () => new Date(_randomInteger({
+const _randomFormatTime = (props) => {
+	const clock = () => new Date(_randomInteger({
+		type: "integer",
+		minimum: 0,
+		maximum: DAY
+	})).toISOString();
+	if (props?.minLength === void 0 && props?.maxLength === void 0) return clock().substring(11);
+	const window = _randomLengthWindow(props, {
+		minimum: CLOCK + 1,
+		spread: 6
+	});
+	let length = _randomLengthPick(window);
+	if (length === CLOCK + 2) length = window.high >= CLOCK + 3 ? CLOCK + 3 : CLOCK + 1;
+	if (length < window.low || length > window.high) throw new Error(_RANDOM_LENGTH_ERROR);
+	const base = clock().substring(11, 11 + CLOCK);
+	if (length === CLOCK + 1) return `${base}Z`;
+	const fraction = length - CLOCK - OFFSET - 1;
+	return (fraction === -1 || fraction >= 1) && _randomInteger({
+		type: "integer",
+		minimum: 0,
+		maximum: 1
+	}) === 1 ? fraction === -1 ? `${base}${offset()}` : `${base}.${__randomDigits(fraction)}${offset()}` : `${base}.${__randomDigits(length - CLOCK - 2)}Z`;
+};
+const DAY = 864e5;
+const CLOCK = 8;
+const OFFSET = 6;
+const offset = () => `${_randomInteger({
 	type: "integer",
 	minimum: 0,
-	maximum: DAY
-})).toISOString().substring(11));
-const DAY = 864e5;
+	maximum: 1
+}) === 0 ? "+" : "-"}${pad(_randomInteger({
+	type: "integer",
+	minimum: 0,
+	maximum: 23
+}))}:${pad(_randomInteger({
+	type: "integer",
+	minimum: 0,
+	maximum: 59
+}))}`;
+const pad = (value) => String(value).padStart(2, "0");
 //#endregion
 export { _randomFormatTime };
 

package/lib/internal/_randomFormatTime.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatTime.mjs","names":[],"sources":["../../src/internal/_randomFormatTime.ts"],"sourcesContent":["import { _randomInteger } from \"./_randomInteger\";\nimport { _ILengthProps, _randomFormatLength } from \"./_randomStringLength\";\n\nexport const _randomFormatTime = (props?: _ILengthProps): string =>\n  _randomFormatLength(props, () =>\n    new Date(\n      _randomInteger({\n        type: \"integer\",\n        minimum: 0,\n        maximum: DAY,\n      }),\n    )\n      .toISOString()\n      .substring(11),\n  );\n\nconst DAY = 86_400_000;\n"],"mappings":";;;AAGA,MAAa,qBAAqB,UAChC,oBAAoB,aAClB,IAAI,KACF,eAAe;CACb,MAAM;CACN,SAAS;CACT,SAAS;AACX,CAAC,CACH,CAAC,CACE,YAAY,CAAC,CACb,UAAU,EAAE,CACjB;AAEF,MAAM,MAAM"}
+{"version":3,"file":"_randomFormatTime.mjs","names":[],"sources":["../../src/internal/_randomFormatTime.ts"],"sourcesContent":["import { _randomInteger } from \"./_randomInteger\";\nimport {\n  _ILengthProps,\n  _RANDOM_LENGTH_ERROR,\n  _randomLengthPick,\n  _randomLengthWindow,\n} from \"./_randomStringLength\";\nimport { __randomDigits } from \"./private/__randomComposition\";\n\nexport const _randomFormatTime = (props?: _ILengthProps): string => {\n  const clock = (): string =>\n    new Date(\n      _randomInteger({ type: \"integer\", minimum: 0, maximum: DAY }),\n    ).toISOString();\n  if (props?.minLength === undefined && props?.maxLength === undefined)\n    return clock().substring(11);\n  // `HH:MM:SS` carries a mandatory offset — one character as `Z`, six as\n  // `+HH:MM` — and an optional fraction between them that RFC 3339 leaves\n  // open above. Together they express 9 and every length from 11 upward; 10 is\n  // the one gap, because a fraction needs both a dot and a digit.\n  const window = _randomLengthWindow(props, {\n    minimum: CLOCK + 1,\n    spread: 6,\n  });\n  let length: number = _randomLengthPick(window);\n  if (length === CLOCK + 2)\n    length = window.high >= CLOCK + 3 ? CLOCK + 3 : CLOCK + 1;\n  if (length < window.low || length > window.high)\n    throw new Error(_RANDOM_LENGTH_ERROR);\n  const base: string = clock().substring(11, 11 + CLOCK);\n  if (length === CLOCK + 1) return `${base}Z`;\n  // The `Z` form reaches every remaining length by itself, so the numeric\n  // offset is a choice rather than a fallback: it spends six characters, which\n  // leaves either nothing (14, `HH:MM:SS+HH:MM`) or a whole fraction (16 and\n  // up). At 15 only the `Z` form fits, since the offset would demand a dot\n  // with no digit after it.\n  const fraction: number = length - CLOCK - OFFSET - 1;\n  return (fraction === -1 || fraction >= 1) &&\n    _randomInteger({ type: \"integer\", minimum: 0, maximum: 1 }) === 1\n    ? fraction === -1\n      ? `${base}${offset()}`\n      : `${base}.${__randomDigits(fraction)}${offset()}`\n    : `${base}.${__randomDigits(length - CLOCK - 2)}Z`;\n};\n\nconst DAY = 86_400_000;\nconst CLOCK = \"00:00:00\".length;\nconst OFFSET = \"+00:00\".length;\n\nconst offset = (): string =>\n  `${_randomInteger({ type: \"integer\", minimum: 0, maximum: 1 }) === 0 ? \"+\" : \"-\"}${pad(\n    _randomInteger({ type: \"integer\", minimum: 0, maximum: 23 }),\n  )}:${pad(_randomInteger({ type: \"integer\", minimum: 0, maximum: 59 }))}`;\n\nconst pad = (value: number): string => String(value).padStart(2, \"0\");\n"],"mappings":";;;;AASA,MAAa,qBAAqB,UAAkC;CAClE,MAAM,cACJ,IAAI,KACF,eAAe;EAAE,MAAM;EAAW,SAAS;EAAG,SAAS;CAAI,CAAC,CAC9D,CAAC,CAAC,YAAY;CAChB,IAAI,OAAO,cAAc,KAAA,KAAa,OAAO,cAAc,KAAA,GACzD,OAAO,MAAM,CAAC,CAAC,UAAU,EAAE;CAK7B,MAAM,SAAS,oBAAoB,OAAO;EACxC,SAAS,QAAQ;EACjB,QAAQ;CACV,CAAC;CACD,IAAI,SAAiB,kBAAkB,MAAM;CAC7C,IAAI,WAAW,QAAQ,GACrB,SAAS,OAAO,QAAQ,QAAQ,IAAI,QAAQ,IAAI,QAAQ;CAC1D,IAAI,SAAS,OAAO,OAAO,SAAS,OAAO,MACzC,MAAM,IAAI,MAAM,oBAAoB;CACtC,MAAM,OAAe,MAAM,CAAC,CAAC,UAAU,IAAI,KAAK,KAAK;CACrD,IAAI,WAAW,QAAQ,GAAG,OAAO,GAAG,KAAK;CAMzC,MAAM,WAAmB,SAAS,QAAQ,SAAS;CACnD,QAAQ,aAAa,MAAM,YAAY,MACrC,eAAe;EAAE,MAAM;EAAW,SAAS;EAAG,SAAS;CAAE,CAAC,MAAM,IAC9D,aAAa,KACX,GAAG,OAAO,OAAO,MACjB,GAAG,KAAK,GAAG,eAAe,QAAQ,IAAI,OAAO,MAC/C,GAAG,KAAK,GAAG,eAAe,SAAS,QAAQ,CAAC,EAAE;AACpD;AAEA,MAAM,MAAM;AACZ,MAAM,QAAQ;AACd,MAAM,SAAS;AAEf,MAAM,eACJ,GAAG,eAAe;CAAE,MAAM;CAAW,SAAS;CAAG,SAAS;AAAE,CAAC,MAAM,IAAI,MAAM,MAAM,IACjF,eAAe;CAAE,MAAM;CAAW,SAAS;CAAG,SAAS;AAAG,CAAC,CAC7D,EAAE,GAAG,IAAI,eAAe;CAAE,MAAM;CAAW,SAAS;CAAG,SAAS;AAAG,CAAC,CAAC;AAEvE,MAAM,OAAO,UAA0B,OAAO,KAAK,CAAC,CAAC,SAAS,GAAG,GAAG"}

package/lib/internal/_randomPattern.js.map

@@ -1 +1 @@
-{"version":3,"file":"_randomPattern.js","sourceRoot":"","sources":["../../src/internal/_randomPattern.ts"],"names":[],"mappings":";;;;;;AAAA,sDAA8B;AAIvB,MAAM,cAAc,GAAG,CAAC,KAAa,EAAE,KAAqB,EAAU,EAAE;IAC7E,MAAM,CAAC,GAAY,IAAI,iBAAO,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,GAAG,GAAuB,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,CAAC;IACjD,MAAM,GAAG,GAAuB,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,CAAC;IAEjD,6EAA6E;IAC7E,8EAA8E;IAC9E,6EAA6E;IAC7E,IAAI,GAAG,KAAK,SAAS;QAAE,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC;SAC9B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG;QAAE,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;IAE/D,MAAM,OAAO,GAAY,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,CAAC;IAChE,MAAM,KAAK,GAAW,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;QACvC,MAAM,GAAG,GAAW,CAAC,CAAC,GAAG,EAAE,CAAC;QAC5B,IACE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;YACf,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC;YACxC,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC;YAExC,OAAO,GAAG,CAAC;IACf,CAAC;IACD,MAAM,IAAI,KAAK,CACb,OAAO;QACL,CAAC,CAAC,kFAAkF;QACpF,CAAC,CAAC,0DAA0D,CAC/D,CAAC;AACJ,CAAC,CAAC;AA3BW,QAAA,cAAc,GAAd,cAAc,CA2BzB"}
+{"version":3,"file":"_randomPattern.js","sourceRoot":"","sources":["../../src/internal/_randomPattern.ts"],"names":[],"mappings":";;;;;;AAAA,sDAA8B;AAIvB,MAAM,cAAc,GAAG,CAC5B,KAAa,EACb,KAAqB,EACb,EAAE;IACV,MAAM,CAAC,GAAY,IAAI,iBAAO,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,GAAG,GAAuB,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,CAAC;IACjD,MAAM,GAAG,GAAuB,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,CAAC;IAEjD,6EAA6E;IAC7E,8EAA8E;IAC9E,6EAA6E;IAC7E,IAAI,GAAG,KAAK,SAAS;QAAE,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC;SAC9B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG;QAAE,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;IAE/D,MAAM,OAAO,GAAY,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,CAAC;IAChE,MAAM,KAAK,GAAW,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;QACvC,MAAM,GAAG,GAAW,CAAC,CAAC,GAAG,EAAE,CAAC;QAC5B,IACE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;YACf,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC;YACxC,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC;YAExC,OAAO,GAAG,CAAC;IACf,CAAC;IACD,MAAM,IAAI,KAAK,CACb,OAAO;QACL,CAAC,CAAC,kFAAkF;QACpF,CAAC,CAAC,0DAA0D,CAC/D,CAAC;AACJ,CAAC,CAAC;AA9BW,QAAA,cAAc,GAAd,cAAc,CA8BzB"}

package/lib/internal/_randomPattern.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_randomPattern.mjs","names":[],"sources":["../../src/internal/_randomPattern.ts"],"sourcesContent":["import RandExp from \"randexp\";\n\nimport { _ILengthProps } from \"./_randomStringLength\";\n\nexport const _randomPattern = (regex: RegExp, props?: _ILengthProps): string => {\n  const r: RandExp = new RandExp(regex);\n  const min: number | undefined = props?.minLength;\n  const max: number | undefined = props?.maxLength;\n\n  // RandExp expands an unbounded quantifier to `randInt(token.min, token.min +\n  // r.max)`, so steering `r.max` biases the generated length toward the window.\n  // There is no matching floor control, so the length is still verified below.\n  if (max !== undefined) r.max = max;\n  else if (min !== undefined && min * 2 > r.max) r.max = min * 2;\n\n  const bounded: boolean = min !== undefined || max !== undefined;\n  const limit: number = bounded ? 1024 : 10;\n  for (let i: number = 0; i < limit; ++i) {\n    const str: string = r.gen();\n    if (\n      regex.test(str) &&\n      (min === undefined || str.length >= min) &&\n      (max === undefined || str.length <= max)\n    )\n      return str;\n  }\n  throw new Error(\n    bounded\n      ? \"unable to generate a random string matching the pattern within the length range.\"\n      : \"unable to generate a random string matching the pattern.\",\n  );\n};\n"],"mappings":";;AAIA,MAAa,kBAAkB,OAAe,UAAkC;CAC9E,MAAM,IAAa,IAAI,QAAQ,KAAK;CACpC,MAAM,MAA0B,OAAO;CACvC,MAAM,MAA0B,OAAO;CAKvC,IAAI,QAAQ,KAAA,GAAW,EAAE,MAAM;MAC1B,IAAI,QAAQ,KAAA,KAAa,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,MAAM;CAE7D,MAAM,UAAmB,QAAQ,KAAA,KAAa,QAAQ,KAAA;CACtD,MAAM,QAAgB,UAAU,OAAO;CACvC,KAAK,IAAI,IAAY,GAAG,IAAI,OAAO,EAAE,GAAG;EACtC,MAAM,MAAc,EAAE,IAAI;EAC1B,IACE,MAAM,KAAK,GAAG,MACb,QAAQ,KAAA,KAAa,IAAI,UAAU,SACnC,QAAQ,KAAA,KAAa,IAAI,UAAU,MAEpC,OAAO;CACX;CACA,MAAM,IAAI,MACR,UACI,qFACA,0DACN;AACF"}
+{"version":3,"file":"_randomPattern.mjs","names":[],"sources":["../../src/internal/_randomPattern.ts"],"sourcesContent":["import RandExp from \"randexp\";\n\nimport { _ILengthProps } from \"./_randomStringLength\";\n\nexport const _randomPattern = (\n  regex: RegExp,\n  props?: _ILengthProps,\n): string => {\n  const r: RandExp = new RandExp(regex);\n  const min: number | undefined = props?.minLength;\n  const max: number | undefined = props?.maxLength;\n\n  // RandExp expands an unbounded quantifier to `randInt(token.min, token.min +\n  // r.max)`, so steering `r.max` biases the generated length toward the window.\n  // There is no matching floor control, so the length is still verified below.\n  if (max !== undefined) r.max = max;\n  else if (min !== undefined && min * 2 > r.max) r.max = min * 2;\n\n  const bounded: boolean = min !== undefined || max !== undefined;\n  const limit: number = bounded ? 1024 : 10;\n  for (let i: number = 0; i < limit; ++i) {\n    const str: string = r.gen();\n    if (\n      regex.test(str) &&\n      (min === undefined || str.length >= min) &&\n      (max === undefined || str.length <= max)\n    )\n      return str;\n  }\n  throw new Error(\n    bounded\n      ? \"unable to generate a random string matching the pattern within the length range.\"\n      : \"unable to generate a random string matching the pattern.\",\n  );\n};\n"],"mappings":";;AAIA,MAAa,kBACX,OACA,UACW;CACX,MAAM,IAAa,IAAI,QAAQ,KAAK;CACpC,MAAM,MAA0B,OAAO;CACvC,MAAM,MAA0B,OAAO;CAKvC,IAAI,QAAQ,KAAA,GAAW,EAAE,MAAM;MAC1B,IAAI,QAAQ,KAAA,KAAa,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,MAAM;CAE7D,MAAM,UAAmB,QAAQ,KAAA,KAAa,QAAQ,KAAA;CACtD,MAAM,QAAgB,UAAU,OAAO;CACvC,KAAK,IAAI,IAAY,GAAG,IAAI,OAAO,EAAE,GAAG;EACtC,MAAM,MAAc,EAAE,IAAI;EAC1B,IACE,MAAM,KAAK,GAAG,MACb,QAAQ,KAAA,KAAa,IAAI,UAAU,SACnC,QAAQ,KAAA,KAAa,IAAI,UAAU,MAEpC,OAAO;CACX;CACA,MAAM,IAAI,MACR,UACI,qFACA,0DACN;AACF"}

package/lib/internal/_randomStringLength.d.ts

@@ -1,3 +1,4 @@
+export declare const _RANDOM_LENGTH_ERROR = "unable to generate a random string satisfying both the format and the length constraints.";
 /**
  * Length bounds forwarded to a string format or pattern generator.
  *
@@ -15,19 +16,49 @@ export interface _ILengthProps {
  * 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>`).
+ * 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>`).
  */
 export declare const _randomSegmentLength: (props: _ILengthProps | undefined, fixed: number, fallback: number, minimum: number) => string;
 /**
- * Wraps a fixed- or narrow-length format generator (uuid, ipv4, date, ...) with
- * the requested length window.
+ * Intersects the requested length window with the lengths a format's grammar
+ * can express, and draws one of them.
  *
- * These formats cannot grow an arbitrary segment, so the generator is retried a
- * bounded number of times and the first draw inside the window is returned. A
- * window that excludes every length the format can produce is unsatisfiable and
- * throws instead of silently yielding an out-of-range value.
+ * `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).
+ */
+export declare const _randomLengthWindow: (props: _ILengthProps | undefined, format: {
+    minimum: number;
+    maximum?: number;
+    spread?: number;
+}) => {
+    low: number;
+    high: number;
+};
+/** Draws a length inside a window produced by {@link _randomLengthWindow}. */
+export declare const _randomLengthPick: (window: {
+    low: number;
+    high: number;
+}) => number;
+/**
+ * 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.
  */
 export declare const _randomFormatLength: (props: _ILengthProps | undefined, generate: () => string) => string;

package/lib/internal/_randomStringLength.js

@@ -1,16 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._randomFormatLength = exports._randomSegmentLength = void 0;
+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>`).
+ * 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;
@@ -20,18 +22,52 @@ const _randomSegmentLength = (props, fixed, fallback, minimum) => {
     // 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("unable to generate a random string satisfying both the format and the length constraints.");
+        throw new Error(exports._RANDOM_LENGTH_ERROR);
     return (0, _randomString_1._randomString)({ type: "string", minLength: low, maxLength: high });
 };
 exports._randomSegmentLength = _randomSegmentLength;
 /**
- * Wraps a fixed- or narrow-length format generator (uuid, ipv4, date, ...) with
- * the requested length window.
+ * Intersects the requested length window with the lengths a format's grammar
+ * can express, and draws one of them.
  *
- * These formats cannot grow an arbitrary segment, so the generator is retried a
- * bounded number of times and the first draw inside the window is returned. A
- * window that excludes every length the format can produce is unsatisfiable and
- * throws instead of silently yielding an out-of-range value.
+ * `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)
@@ -42,7 +78,7 @@ const _randomFormatLength = (props, generate) => {
             (props.maxLength === undefined || value.length <= props.maxLength))
             return value;
     }
-    throw new Error("unable to generate a random string satisfying both the format and the length constraints.");
+    throw new Error(exports._RANDOM_LENGTH_ERROR);
 };
 exports._randomFormatLength = _randomFormatLength;
 //# sourceMappingURL=_randomStringLength.js.map

package/lib/internal/_randomStringLength.js.map

@@ -1 +1 @@
-{"version":3,"file":"_randomStringLength.js","sourceRoot":"","sources":["../../src/internal/_randomStringLength.ts"],"names":[],"mappings":";;;AAAA,mDAAgD;AAehD;;;;;;;;;GASG;AACI,MAAM,oBAAoB,GAAG,CAClC,KAAgC,EAChC,KAAa,EACb,QAAgB,EAChB,OAAe,EACP,EAAE;IACV,IAAI,GAAG,GACL,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC;IACrE,IAAI,GAAG,GAAG,OAAO;QAAE,GAAG,GAAG,OAAO,CAAC;IACjC,sEAAsE;IACtE,wEAAwE;IACxE,MAAM,IAAI,GACR,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC;IAC5E,IAAI,IAAI,GAAG,GAAG,IAAI,IAAI,GAAG,OAAO;QAC9B,MAAM,IAAI,KAAK,CACb,2FAA2F,CAC5F,CAAC;IACJ,OAAO,IAAA,6BAAa,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5E,CAAC,CAAC;AAlBW,QAAA,oBAAoB,GAApB,oBAAoB,CAkB/B;AAEF;;;;;;;;GAQG;AACI,MAAM,mBAAmB,GAAG,CACjC,KAAgC,EAChC,QAAsB,EACd,EAAE;IACV,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS;QAClE,OAAO,QAAQ,EAAE,CAAC;IACpB,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC;QACrC,MAAM,KAAK,GAAW,QAAQ,EAAE,CAAC;QACjC,IACE,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC;YAClE,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC;YAElE,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,IAAI,KAAK,CACb,2FAA2F,CAC5F,CAAC;AACJ,CAAC,CAAC;AAjBW,QAAA,mBAAmB,GAAnB,mBAAmB,CAiB9B"}
+{"version":3,"file":"_randomStringLength.js","sourceRoot":"","sources":["../../src/internal/_randomStringLength.ts"],"names":[],"mappings":";;;AAAA,qDAAkD;AAClD,mDAAgD;AAEnC,QAAA,oBAAoB,GAC/B,2FAA2F,CAAC;AAe9F;;;;;;;;;GASG;AACI,MAAM,oBAAoB,GAAG,CAClC,KAAgC,EAChC,KAAa,EACb,QAAgB,EAChB,OAAe,EACP,EAAE;IACV,IAAI,GAAG,GACL,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC;IACrE,IAAI,GAAG,GAAG,OAAO;QAAE,GAAG,GAAG,OAAO,CAAC;IACjC,sEAAsE;IACtE,wEAAwE;IACxE,MAAM,IAAI,GACR,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC;IAC5E,IAAI,IAAI,GAAG,GAAG,IAAI,IAAI,GAAG,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,QAAA,oBAAoB,CAAC,CAAC;IACxE,OAAO,IAAA,6BAAa,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5E,CAAC,CAAC;AAfW,QAAA,oBAAoB,GAApB,oBAAoB,CAe/B;AAEF;;;;;;;;;;;;;;;GAeG;AACI,MAAM,mBAAmB,GAAG,CACjC,KAAgC,EAChC,MAA8D,EAC/B,EAAE;;IACjC,MAAM,OAAO,SAAW,MAAM,CAAC,OAAO,mCAAI,MAAM,CAAC,gBAAgB,CAAC;IAClE,MAAM,GAAG,GAAW,IAAI,CAAC,GAAG,OAC1B,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,mCAAI,MAAM,CAAC,OAAO,EAClC,MAAM,CAAC,OAAO,CACf,CAAC;IACF,MAAM,IAAI,GAAW,IAAI,CAAC,GAAG,OAC3B,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,mCAAI,GAAG,GAAG,OAAC,MAAM,CAAC,MAAM,mCAAI,CAAC,CAAC,EAC9C,OAAO,CACR,CAAC;IACF,IAAI,GAAG,GAAG,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,QAAA,oBAAoB,CAAC,CAAC;IACtD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AACvB,CAAC,CAAC;AAfW,QAAA,mBAAmB,GAAnB,mBAAmB,CAe9B;AAEF,8EAA8E;AACvE,MAAM,iBAAiB,GAAG,CAAC,MAGjC,EAAU,EAAE,CACX,IAAA,+BAAc,EAAC;IACb,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,MAAM,CAAC,GAAG;IACnB,OAAO,EAAE,MAAM,CAAC,IAAI;CACrB,CAAC,CAAC;AARQ,QAAA,iBAAiB,GAAjB,iBAAiB,CAQzB;AAEL;;;;;;;;;GASG;AACI,MAAM,mBAAmB,GAAG,CACjC,KAAgC,EAChC,QAAsB,EACd,EAAE;IACV,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS;QAClE,OAAO,QAAQ,EAAE,CAAC;IACpB,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC;QACrC,MAAM,KAAK,GAAW,QAAQ,EAAE,CAAC;QACjC,IACE,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC;YAClE,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC;YAElE,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,QAAA,oBAAoB,CAAC,CAAC;AACxC,CAAC,CAAC;AAfW,QAAA,mBAAmB,GAAnB,mBAAmB,CAe9B"}

package/lib/internal/_randomStringLength.mjs

@@ -1,20 +1,22 @@
+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>`).
+* 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("unable to generate a random string satisfying both the format and the length constraints.");
+	if (high < low || high < minimum) throw new Error(_RANDOM_LENGTH_ERROR);
 	return _randomString({
 		type: "string",
 		minLength: low,
@@ -22,13 +24,46 @@ const _randomSegmentLength = (props, fixed, fallback, minimum) => {
 	});
 };
 /**
-* Wraps a fixed- or narrow-length format generator (uuid, ipv4, date, ...) with
-* the requested length window.
+* Intersects the requested length window with the lengths a format's grammar
+* can express, and draws one of them.
 *
-* These formats cannot grow an arbitrary segment, so the generator is retried a
-* bounded number of times and the first draw inside the window is returned. A
-* window that excludes every length the format can produce is unsatisfiable and
-* throws instead of silently yielding an out-of-range value.
+* `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();
@@ -36,9 +71,9 @@ const _randomFormatLength = (props, generate) => {
 		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("unable to generate a random string satisfying both the format and the length constraints.");
+	throw new Error(_RANDOM_LENGTH_ERROR);
 };
 //#endregion
-export { _randomFormatLength, _randomSegmentLength };
+export { _RANDOM_LENGTH_ERROR, _randomFormatLength, _randomLengthPick, _randomLengthWindow, _randomSegmentLength };
 
 //# sourceMappingURL=_randomStringLength.mjs.map

package/lib/internal/_randomStringLength.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_randomStringLength.mjs","names":[],"sources":["../../src/internal/_randomStringLength.ts"],"sourcesContent":["import { _randomString } from \"./_randomString\";\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\n * unconstrained on that side, and `minimum` is the smallest segment the format\n * still validates with. Throws when the window cannot be satisfied by this\n * format's 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)\n    throw new Error(\n      \"unable to generate a random string satisfying both the format and the length constraints.\",\n    );\n  return _randomString({ type: \"string\", minLength: low, maxLength: high });\n};\n\n/**\n * Wraps a fixed- or narrow-length format generator (uuid, ipv4, date, ...) with\n * the requested length window.\n *\n * These formats cannot grow an arbitrary segment, so the generator is retried a\n * bounded number of times and the first draw inside the window is returned. A\n * window that excludes every length the format can produce is unsatisfiable and\n * throws instead of silently yielding an out-of-range value.\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(\n    \"unable to generate a random string satisfying both the format and the length constraints.\",\n  );\n};\n"],"mappings":";;;;;;;;;;;;AAyBA,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,SACvB,MAAM,IAAI,MACR,2FACF;CACF,OAAO,cAAc;EAAE,MAAM;EAAU,WAAW;EAAK,WAAW;CAAK,CAAC;AAC1E;;;;;;;;;;AAWA,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,MACR,2FACF;AACF"}
+{"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/private/__notationRename.js.map

@@ -1 +1 @@
-{"version":3,"file":"__notationRename.js","sourceRoot":"","sources":["../../../src/internal/private/__notationRename.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACI,MAAM,gBAAgB,GAC3B,CAAC,KAGA,EAAE,EAAE,CACL,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;AAbS,QAAA,gBAAgB,GAAhB,gBAAgB,CAazB"}
+{"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.map

@@ -1 +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: {\n    plain: (str: string) => string;\n    snake: (str: string) => string;\n  }) =>\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,WAIA,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"}
+{"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,31 @@
+/**
+ * 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` characters of the base64 alphabet.
+ *
+ * The caller passes a multiple of four, which `format: "byte"` accepts without
+ * padding; every character below is in the alphabet its validator spells out,
+ * so the result needs no encoding step.
+ */
+export declare const __randomBase64: (length: number) => string;
+/** 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,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__randomNumeric = exports.__randomDigits = exports.__randomBase64 = 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` characters of the base64 alphabet.
+ *
+ * The caller passes a multiple of four, which `format: "byte"` accepts without
+ * padding; every character below is in the alphabet its validator spells out,
+ * so the result needs no encoding step.
+ */
+const __randomBase64 = (length) => {
+    let text = "";
+    for (let i = 0; i < length; ++i)
+        text +=
+            BASE64[(0, _randomInteger_1._randomInteger)({
+                type: "integer",
+                minimum: 0,
+                maximum: BASE64.length - 1,
+            })];
+    return text;
+};
+exports.__randomBase64 = __randomBase64;
+const BASE64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+/** 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;;;;;;GAMG;AACI,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;YACF,MAAM,CACJ,IAAA,+BAAc,EAAC;gBACb,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC;aAC3B,CAAC,CACH,CAAC;IACN,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAZW,QAAA,cAAc,GAAd,cAAc,CAYzB;AAEF,MAAM,MAAM,GACV,kEAAkE,CAAC;AAErE,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,71 @@
+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` characters of the base64 alphabet.
+*
+* The caller passes a multiple of four, which `format: "byte"` accepts without
+* padding; every character below is in the alphabet its validator spells out,
+* so the result needs no encoding step.
+*/
+const __randomBase64 = (length) => {
+	let text = "";
+	for (let i = 0; i < length; ++i) text += BASE64[_randomInteger({
+		type: "integer",
+		minimum: 0,
+		maximum: BASE64.length - 1
+	})];
+	return text;
+};
+const BASE64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+/** 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 { __randomBase64, __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/**\n * Draws `length` characters of the base64 alphabet.\n *\n * The caller passes a multiple of four, which `format: \"byte\"` accepts without\n * padding; every character below is in the alphabet its validator spells out,\n * so the result needs no encoding step.\n */\nexport const __randomBase64 = (length: number): string => {\n  let text: string = \"\";\n  for (let i: number = 0; i < length; ++i)\n    text +=\n      BASE64[\n        _randomInteger({\n          type: \"integer\",\n          minimum: 0,\n          maximum: BASE64.length - 1,\n        })\n      ];\n  return text;\n};\n\nconst BASE64 =\n  \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/\";\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;;;;;;;;AASA,MAAa,kBAAkB,WAA2B;CACxD,IAAI,OAAe;CACnB,KAAK,IAAI,IAAY,GAAG,IAAI,QAAQ,EAAE,GACpC,QACE,OACE,eAAe;EACb,MAAM;EACN,SAAS;EACT,SAAS,OAAO,SAAS;CAC3B,CAAC;CAEP,OAAO;AACT;AAEA,MAAM,SACJ;;AAGF,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;