typia 13.1.1 → 13.2.0

package/lib/internal/_randomFormatDuration.mjs

@@ -1,19 +1,28 @@
 import { _randomInteger } from "./_randomInteger.mjs";
+import { _randomLengthPick, _randomLengthWindow } from "./_randomStringLength.mjs";
+import { __randomNumeric } from "./private/__randomComposition.mjs";
 //#region src/internal/_randomFormatDuration.ts
-const _randomFormatDuration = () => {
-	const period = durate([
-		["Y", random(0, 100)],
-		["M", random(0, 12)],
-		["D", random(0, 31)]
-	]);
-	const time = durate([
-		["H", random(0, 24)],
-		["M", random(0, 60)],
-		["S", random(0, 60)]
-	]);
-	if (period.length + time.length === 0) return "PT0S";
-	return `P${period}${time.length ? "T" : ""}${time}`;
+const _randomFormatDuration = (props) => {
+	if (props?.minLength === void 0 && props?.maxLength === void 0) {
+		const period = durate([
+			["Y", random(0, 100)],
+			["M", random(0, 12)],
+			["D", random(0, 31)]
+		]);
+		const time = durate([
+			["H", random(0, 24)],
+			["M", random(0, 60)],
+			["S", random(0, 60)]
+		]);
+		if (period.length + time.length === 0) return "PT0S";
+		return `P${period}${time.length ? "T" : ""}${time}`;
+	}
+	return `P${__randomNumeric(_randomLengthPick(_randomLengthWindow(props, {
+		minimum: MINIMUM,
+		spread: 6
+	})) - MINIMUM + 1)}Y`;
 };
+const MINIMUM = 3;
 const durate = (elements) => elements.filter(([_unit, value]) => value !== 0).map(([unit, value]) => `${value}${unit}`).join("");
 const random = (minimum, maximum) => _randomInteger({
 	type: "integer",

package/lib/internal/_randomFormatDuration.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatDuration.mjs","names":[],"sources":["../../src/internal/_randomFormatDuration.ts"],"sourcesContent":["import { _randomInteger } from \"./_randomInteger\";\n\nexport const _randomFormatDuration = (): string => {\n  const period: string = durate([\n    [\"Y\", random(0, 100)],\n    [\"M\", random(0, 12)],\n    [\"D\", random(0, 31)],\n  ]);\n  const time: string = durate([\n    [\"H\", random(0, 24)],\n    [\"M\", random(0, 60)],\n    [\"S\", random(0, 60)],\n  ]);\n  if (period.length + time.length === 0) return \"PT0S\";\n  return `P${period}${time.length ? \"T\" : \"\"}${time}`;\n};\nconst durate = (elements: [string, number][]) =>\n  elements\n    .filter(([_unit, value]) => value !== 0)\n    .map(([unit, value]) => `${value}${unit}`)\n    .join(\"\");\nconst random = (minimum: number, maximum: number) =>\n  _randomInteger({\n    type: \"integer\",\n    minimum,\n    maximum,\n  });\n"],"mappings":";;AAEA,MAAa,8BAAsC;CACjD,MAAM,SAAiB,OAAO;EAC5B,CAAC,KAAK,OAAO,GAAG,GAAG,CAAC;EACpB,CAAC,KAAK,OAAO,GAAG,EAAE,CAAC;EACnB,CAAC,KAAK,OAAO,GAAG,EAAE,CAAC;CACrB,CAAC;CACD,MAAM,OAAe,OAAO;EAC1B,CAAC,KAAK,OAAO,GAAG,EAAE,CAAC;EACnB,CAAC,KAAK,OAAO,GAAG,EAAE,CAAC;EACnB,CAAC,KAAK,OAAO,GAAG,EAAE,CAAC;CACrB,CAAC;CACD,IAAI,OAAO,SAAS,KAAK,WAAW,GAAG,OAAO;CAC9C,OAAO,IAAI,SAAS,KAAK,SAAS,MAAM,KAAK;AAC/C;AACA,MAAM,UAAU,aACd,SACG,QAAQ,CAAC,OAAO,WAAW,UAAU,CAAC,CAAC,CACvC,KAAK,CAAC,MAAM,WAAW,GAAG,QAAQ,MAAM,CAAC,CACzC,KAAK,EAAE;AACZ,MAAM,UAAU,SAAiB,YAC/B,eAAe;CACb,MAAM;CACN;CACA;AACF,CAAC"}
+{"version":3,"file":"_randomFormatDuration.mjs","names":[],"sources":["../../src/internal/_randomFormatDuration.ts"],"sourcesContent":["import { _randomInteger } from \"./_randomInteger\";\nimport {\n  _ILengthProps,\n  _randomLengthPick,\n  _randomLengthWindow,\n} from \"./_randomStringLength\";\nimport { __randomNumeric } from \"./private/__randomComposition\";\n\nexport const _randomFormatDuration = (props?: _ILengthProps): string => {\n  if (props?.minLength === undefined && props?.maxLength === undefined) {\n    const period: string = durate([\n      [\"Y\", random(0, 100)],\n      [\"M\", random(0, 12)],\n      [\"D\", random(0, 31)],\n    ]);\n    const time: string = durate([\n      [\"H\", random(0, 24)],\n      [\"M\", random(0, 60)],\n      [\"S\", random(0, 60)],\n    ]);\n    if (period.length + time.length === 0) return \"PT0S\";\n    return `P${period}${time.length ? \"T\" : \"\"}${time}`;\n  }\n  // A single designator carries an unbounded digit count, so `P<n>Y` expresses\n  // every length from three upward and `P1Y` is the shortest duration there is.\n  const length: number = _randomLengthPick(\n    _randomLengthWindow(props, { minimum: MINIMUM, spread: 6 }),\n  );\n  return `P${__randomNumeric(length - MINIMUM + 1)}Y`;\n};\n\nconst MINIMUM = \"P1Y\".length;\n\nconst durate = (elements: [string, number][]) =>\n  elements\n    .filter(([_unit, value]) => value !== 0)\n    .map(([unit, value]) => `${value}${unit}`)\n    .join(\"\");\nconst random = (minimum: number, maximum: number) =>\n  _randomInteger({\n    type: \"integer\",\n    minimum,\n    maximum,\n  });\n"],"mappings":";;;;AAQA,MAAa,yBAAyB,UAAkC;CACtE,IAAI,OAAO,cAAc,KAAA,KAAa,OAAO,cAAc,KAAA,GAAW;EACpE,MAAM,SAAiB,OAAO;GAC5B,CAAC,KAAK,OAAO,GAAG,GAAG,CAAC;GACpB,CAAC,KAAK,OAAO,GAAG,EAAE,CAAC;GACnB,CAAC,KAAK,OAAO,GAAG,EAAE,CAAC;EACrB,CAAC;EACD,MAAM,OAAe,OAAO;GAC1B,CAAC,KAAK,OAAO,GAAG,EAAE,CAAC;GACnB,CAAC,KAAK,OAAO,GAAG,EAAE,CAAC;GACnB,CAAC,KAAK,OAAO,GAAG,EAAE,CAAC;EACrB,CAAC;EACD,IAAI,OAAO,SAAS,KAAK,WAAW,GAAG,OAAO;EAC9C,OAAO,IAAI,SAAS,KAAK,SAAS,MAAM,KAAK;CAC/C;CAMA,OAAO,IAAI,gBAHY,kBACrB,oBAAoB,OAAO;EAAE,SAAS;EAAS,QAAQ;CAAE,CAAC,CAE5B,IAAI,UAAU,CAAC,EAAE;AACnD;AAEA,MAAM,UAAU;AAEhB,MAAM,UAAU,aACd,SACG,QAAQ,CAAC,OAAO,WAAW,UAAU,CAAC,CAAC,CACvC,KAAK,CAAC,MAAM,WAAW,GAAG,QAAQ,MAAM,CAAC,CACzC,KAAK,EAAE;AACZ,MAAM,UAAU,SAAiB,YAC/B,eAAe;CACb,MAAM;CACN;CACA;AACF,CAAC"}

package/lib/internal/_randomFormatEmail.d.ts

@@ -1 +1,2 @@
-export declare const _randomFormatEmail: () => string;
+import { _ILengthProps } from "./_randomStringLength";
+export declare const _randomFormatEmail: (props?: _ILengthProps) => string;

package/lib/internal/_randomFormatEmail.js

@@ -2,7 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._randomFormatEmail = void 0;
 const _randomString_1 = require("./_randomString");
-const _randomFormatEmail = () => `${random(10)}@${random(10)}.${random(3)}`;
+const _randomStringLength_1 = require("./_randomStringLength");
+const _randomFormatEmail = (props) => {
+    if ((props === null || props === void 0 ? void 0 : props.minLength) === undefined && (props === null || props === void 0 ? void 0 : props.maxLength) === undefined)
+        return `${random(10)}@${random(10)}.${random(3)}`;
+    // `<local>@<domain>.<tld>`: the local part absorbs the requested length while
+    // a one-character domain and tld keep the fixed overhead (`@`, `.`) minimal.
+    return `${(0, _randomStringLength_1._randomSegmentLength)(props, 4, 10, 1)}@${random(1)}.${random(1)}`;
+};
 exports._randomFormatEmail = _randomFormatEmail;
 const random = (length) => (0, _randomString_1._randomString)({
     type: "string",

package/lib/internal/_randomFormatEmail.js.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatEmail.js","sourceRoot":"","sources":["../../src/internal/_randomFormatEmail.ts"],"names":[],"mappings":";;;AAAA,mDAAgD;AAEzC,MAAM,kBAAkB,GAAG,GAAW,EAAE,CAC7C,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AADhC,QAAA,kBAAkB,GAAlB,kBAAkB,CACc;AAE7C,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,EAAE,CAChC,IAAA,6BAAa,EAAC;IACZ,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,MAAM;IACjB,SAAS,EAAE,MAAM;CAClB,CAAC,CAAC"}
+{"version":3,"file":"_randomFormatEmail.js","sourceRoot":"","sources":["../../src/internal/_randomFormatEmail.ts"],"names":[],"mappings":";;;AAAA,mDAAgD;AAChD,+DAA4E;AAErE,MAAM,kBAAkB,GAAG,CAAC,KAAqB,EAAU,EAAE;IAClE,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS;QAClE,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,8EAA8E;IAC9E,6EAA6E;IAC7E,OAAO,GAAG,IAAA,0CAAoB,EAAC,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9E,CAAC,CAAC;AANW,QAAA,kBAAkB,GAAlB,kBAAkB,CAM7B;AAEF,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,EAAE,CAChC,IAAA,6BAAa,EAAC;IACZ,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,MAAM;IACjB,SAAS,EAAE,MAAM;CAClB,CAAC,CAAC"}

package/lib/internal/_randomFormatEmail.mjs

@@ -1,6 +1,10 @@
 import { _randomString } from "./_randomString.mjs";
+import { _randomSegmentLength } from "./_randomStringLength.mjs";
 //#region src/internal/_randomFormatEmail.ts
-const _randomFormatEmail = () => `${random(10)}@${random(10)}.${random(3)}`;
+const _randomFormatEmail = (props) => {
+	if (props?.minLength === void 0 && props?.maxLength === void 0) return `${random(10)}@${random(10)}.${random(3)}`;
+	return `${_randomSegmentLength(props, 4, 10, 1)}@${random(1)}.${random(1)}`;
+};
 const random = (length) => _randomString({
 	type: "string",
 	minLength: length,

package/lib/internal/_randomFormatEmail.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatEmail.mjs","names":[],"sources":["../../src/internal/_randomFormatEmail.ts"],"sourcesContent":["import { _randomString } from \"./_randomString\";\n\nexport const _randomFormatEmail = (): string =>\n  `${random(10)}@${random(10)}.${random(3)}`;\n\nconst random = (length: number) =>\n  _randomString({\n    type: \"string\",\n    minLength: length,\n    maxLength: length,\n  });\n"],"mappings":";;AAEA,MAAa,2BACX,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC;AAEzC,MAAM,UAAU,WACd,cAAc;CACZ,MAAM;CACN,WAAW;CACX,WAAW;AACb,CAAC"}
+{"version":3,"file":"_randomFormatEmail.mjs","names":[],"sources":["../../src/internal/_randomFormatEmail.ts"],"sourcesContent":["import { _randomString } from \"./_randomString\";\nimport { _ILengthProps, _randomSegmentLength } from \"./_randomStringLength\";\n\nexport const _randomFormatEmail = (props?: _ILengthProps): string => {\n  if (props?.minLength === undefined && props?.maxLength === undefined)\n    return `${random(10)}@${random(10)}.${random(3)}`;\n  // `<local>@<domain>.<tld>`: the local part absorbs the requested length while\n  // a one-character domain and tld keep the fixed overhead (`@`, `.`) minimal.\n  return `${_randomSegmentLength(props, 4, 10, 1)}@${random(1)}.${random(1)}`;\n};\n\nconst random = (length: number) =>\n  _randomString({\n    type: \"string\",\n    minLength: length,\n    maxLength: length,\n  });\n"],"mappings":";;;AAGA,MAAa,sBAAsB,UAAkC;CACnE,IAAI,OAAO,cAAc,KAAA,KAAa,OAAO,cAAc,KAAA,GACzD,OAAO,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC;CAGhD,OAAO,GAAG,qBAAqB,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC;AAC1E;AAEA,MAAM,UAAU,WACd,cAAc;CACZ,MAAM;CACN,WAAW;CACX,WAAW;AACb,CAAC"}

package/lib/internal/_randomFormatHostname.d.ts

@@ -1 +1,8 @@
-export declare const _randomFormatHostname: () => string;
+import { _ILengthProps } from "./_randomStringLength";
+export declare const _randomFormatHostname: (props?: _ILengthProps) => string;
+/**
+ * Builds dot-joined hostname labels totaling exactly `length` characters, each
+ * label within 63 chars. Shared with the idn-hostname generator, which reserves
+ * a fixed `.<tld>` suffix and realizes the rest as these leading labels.
+ */
+export declare const _randomHostnameLabels: (length: number) => string;

package/lib/internal/_randomFormatHostname.js

@@ -1,8 +1,51 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._randomFormatHostname = void 0;
+exports._randomHostnameLabels = exports._randomFormatHostname = void 0;
+const _randomInteger_1 = require("./_randomInteger");
 const _randomString_1 = require("./_randomString");
-const _randomFormatHostname = () => `${random(10)}.${random(3)}`;
+const _randomFormatHostname = (props) => {
+    if ((props === null || props === void 0 ? void 0 : props.minLength) === undefined && (props === null || props === void 0 ? void 0 : props.maxLength) === undefined)
+        return `${random(10)}.${random(3)}`;
+    // A hostname is dot-joined labels of 1..63 chars whose total is capped at 253,
+    // so the requested length is realized by splitting it across enough labels.
+    return (0, exports._randomHostnameLabels)(pickLength(props));
+};
 exports._randomFormatHostname = _randomFormatHostname;
+const MAX_TOTAL = 253;
+const MAX_LABEL = 63;
+const pickLength = (props) => {
+    let low = props.minLength === undefined ? 1 : props.minLength;
+    if (low < 1)
+        low = 1;
+    const high = props.maxLength === undefined
+        ? Math.min(MAX_TOTAL, low + 14)
+        : Math.min(MAX_TOTAL, props.maxLength);
+    if (high < low)
+        throw new Error("unable to generate a random hostname satisfying both the format and the length constraints.");
+    return (0, _randomInteger_1._randomInteger)({ type: "integer", minimum: low, maximum: high });
+};
+/**
+ * Builds dot-joined hostname labels totaling exactly `length` characters, each
+ * label within 63 chars. Shared with the idn-hostname generator, which reserves
+ * a fixed `.<tld>` suffix and realizes the rest as these leading labels.
+ */
+const _randomHostnameLabels = (length) => {
+    const parts = [];
+    let remaining = length;
+    while (remaining > MAX_LABEL + 1) {
+        // one full label plus its joining dot
+        parts.push(random(MAX_LABEL));
+        remaining -= MAX_LABEL + 1;
+    }
+    if (remaining <= MAX_LABEL)
+        parts.push(random(remaining));
+    else {
+        // remaining === MAX_LABEL + 1: two labels keep every label within 63 chars
+        parts.push(random(MAX_LABEL - 1));
+        parts.push(random(1));
+    }
+    return parts.join(".");
+};
+exports._randomHostnameLabels = _randomHostnameLabels;
 const random = (length) => (0, _randomString_1._randomString)({ type: "string", minLength: length, maxLength: length });
 //# sourceMappingURL=_randomFormatHostname.js.map

package/lib/internal/_randomFormatHostname.js.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatHostname.js","sourceRoot":"","sources":["../../src/internal/_randomFormatHostname.ts"],"names":[],"mappings":";;;AAAA,mDAAgD;AAEzC,MAAM,qBAAqB,GAAG,GAAW,EAAE,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AAAnE,QAAA,qBAAqB,GAArB,qBAAqB,CAA8C;AAEhF,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,EAAE,CAChC,IAAA,6BAAa,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC"}
+{"version":3,"file":"_randomFormatHostname.js","sourceRoot":"","sources":["../../src/internal/_randomFormatHostname.ts"],"names":[],"mappings":";;;AAAA,qDAAkD;AAClD,mDAAgD;AAGzC,MAAM,qBAAqB,GAAG,CAAC,KAAqB,EAAU,EAAE;IACrE,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS;QAClE,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACtC,+EAA+E;IAC/E,4EAA4E;IAC5E,OAAO,IAAA,QAAA,qBAAqB,EAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;AAClD,CAAC,CAAC;AANW,QAAA,qBAAqB,GAArB,qBAAqB,CAMhC;AAEF,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB,MAAM,UAAU,GAAG,CAAC,KAAoB,EAAU,EAAE;IAClD,IAAI,GAAG,GAAW,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC;IACtE,IAAI,GAAG,GAAG,CAAC;QAAE,GAAG,GAAG,CAAC,CAAC;IACrB,MAAM,IAAI,GACR,KAAK,CAAC,SAAS,KAAK,SAAS;QAC3B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,GAAG,EAAE,CAAC;QAC/B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,IAAI,GAAG,GAAG;QACZ,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;IACJ,OAAO,IAAA,+BAAc,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAC1E,CAAC,CAAC;AAEF;;;;GAIG;AACI,MAAM,qBAAqB,GAAG,CAAC,MAAc,EAAU,EAAE;IAC9D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,SAAS,GAAW,MAAM,CAAC;IAC/B,OAAO,SAAS,GAAG,SAAS,GAAG,CAAC,EAAE,CAAC;QACjC,sCAAsC;QACtC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAC9B,SAAS,IAAI,SAAS,GAAG,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,SAAS,IAAI,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;SACrD,CAAC;QACJ,2EAA2E;QAC3E,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC,CAAC;AAfW,QAAA,qBAAqB,GAArB,qBAAqB,CAehC;AAEF,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,EAAE,CAChC,IAAA,6BAAa,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC"}

package/lib/internal/_randomFormatHostname.mjs

@@ -1,12 +1,48 @@
+import { _randomInteger } from "./_randomInteger.mjs";
 import { _randomString } from "./_randomString.mjs";
 //#region src/internal/_randomFormatHostname.ts
-const _randomFormatHostname = () => `${random(10)}.${random(3)}`;
+const _randomFormatHostname = (props) => {
+	if (props?.minLength === void 0 && props?.maxLength === void 0) return `${random(10)}.${random(3)}`;
+	return _randomHostnameLabels(pickLength(props));
+};
+const MAX_TOTAL = 253;
+const MAX_LABEL = 63;
+const pickLength = (props) => {
+	let low = props.minLength === void 0 ? 1 : props.minLength;
+	if (low < 1) low = 1;
+	const high = props.maxLength === void 0 ? Math.min(MAX_TOTAL, low + 14) : Math.min(MAX_TOTAL, props.maxLength);
+	if (high < low) throw new Error("unable to generate a random hostname satisfying both the format and the length constraints.");
+	return _randomInteger({
+		type: "integer",
+		minimum: low,
+		maximum: high
+	});
+};
+/**
+* Builds dot-joined hostname labels totaling exactly `length` characters, each
+* label within 63 chars. Shared with the idn-hostname generator, which reserves
+* a fixed `.<tld>` suffix and realizes the rest as these leading labels.
+*/
+const _randomHostnameLabels = (length) => {
+	const parts = [];
+	let remaining = length;
+	while (remaining > 64) {
+		parts.push(random(MAX_LABEL));
+		remaining -= 64;
+	}
+	if (remaining <= MAX_LABEL) parts.push(random(remaining));
+	else {
+		parts.push(random(MAX_LABEL - 1));
+		parts.push(random(1));
+	}
+	return parts.join(".");
+};
 const random = (length) => _randomString({
 	type: "string",
 	minLength: length,
 	maxLength: length
 });
 //#endregion
-export { _randomFormatHostname };
+export { _randomFormatHostname, _randomHostnameLabels };
 
 //# sourceMappingURL=_randomFormatHostname.mjs.map

package/lib/internal/_randomFormatHostname.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatHostname.mjs","names":[],"sources":["../../src/internal/_randomFormatHostname.ts"],"sourcesContent":["import { _randomString } from \"./_randomString\";\n\nexport const _randomFormatHostname = (): string => `${random(10)}.${random(3)}`;\n\nconst random = (length: number) =>\n  _randomString({ type: \"string\", minLength: length, maxLength: length });\n"],"mappings":";;AAEA,MAAa,8BAAsC,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC;AAE5E,MAAM,UAAU,WACd,cAAc;CAAE,MAAM;CAAU,WAAW;CAAQ,WAAW;AAAO,CAAC"}
+{"version":3,"file":"_randomFormatHostname.mjs","names":[],"sources":["../../src/internal/_randomFormatHostname.ts"],"sourcesContent":["import { _randomInteger } from \"./_randomInteger\";\nimport { _randomString } from \"./_randomString\";\nimport { _ILengthProps } from \"./_randomStringLength\";\n\nexport const _randomFormatHostname = (props?: _ILengthProps): string => {\n  if (props?.minLength === undefined && props?.maxLength === undefined)\n    return `${random(10)}.${random(3)}`;\n  // A hostname is dot-joined labels of 1..63 chars whose total is capped at 253,\n  // so the requested length is realized by splitting it across enough labels.\n  return _randomHostnameLabels(pickLength(props));\n};\n\nconst MAX_TOTAL = 253;\nconst MAX_LABEL = 63;\n\nconst pickLength = (props: _ILengthProps): number => {\n  let low: number = props.minLength === undefined ? 1 : props.minLength;\n  if (low < 1) low = 1;\n  const high: number =\n    props.maxLength === undefined\n      ? Math.min(MAX_TOTAL, low + 14)\n      : Math.min(MAX_TOTAL, props.maxLength);\n  if (high < low)\n    throw new Error(\n      \"unable to generate a random hostname satisfying both the format and the length constraints.\",\n    );\n  return _randomInteger({ type: \"integer\", minimum: low, maximum: high });\n};\n\n/**\n * Builds dot-joined hostname labels totaling exactly `length` characters, each\n * label within 63 chars. Shared with the idn-hostname generator, which reserves\n * a fixed `.<tld>` suffix and realizes the rest as these leading labels.\n */\nexport const _randomHostnameLabels = (length: number): string => {\n  const parts: string[] = [];\n  let remaining: number = length;\n  while (remaining > MAX_LABEL + 1) {\n    // one full label plus its joining dot\n    parts.push(random(MAX_LABEL));\n    remaining -= MAX_LABEL + 1;\n  }\n  if (remaining <= MAX_LABEL) parts.push(random(remaining));\n  else {\n    // remaining === MAX_LABEL + 1: two labels keep every label within 63 chars\n    parts.push(random(MAX_LABEL - 1));\n    parts.push(random(1));\n  }\n  return parts.join(\".\");\n};\n\nconst random = (length: number) =>\n  _randomString({ type: \"string\", minLength: length, maxLength: length });\n"],"mappings":";;;AAIA,MAAa,yBAAyB,UAAkC;CACtE,IAAI,OAAO,cAAc,KAAA,KAAa,OAAO,cAAc,KAAA,GACzD,OAAO,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC;CAGlC,OAAO,sBAAsB,WAAW,KAAK,CAAC;AAChD;AAEA,MAAM,YAAY;AAClB,MAAM,YAAY;AAElB,MAAM,cAAc,UAAiC;CACnD,IAAI,MAAc,MAAM,cAAc,KAAA,IAAY,IAAI,MAAM;CAC5D,IAAI,MAAM,GAAG,MAAM;CACnB,MAAM,OACJ,MAAM,cAAc,KAAA,IAChB,KAAK,IAAI,WAAW,MAAM,EAAE,IAC5B,KAAK,IAAI,WAAW,MAAM,SAAS;CACzC,IAAI,OAAO,KACT,MAAM,IAAI,MACR,6FACF;CACF,OAAO,eAAe;EAAE,MAAM;EAAW,SAAS;EAAK,SAAS;CAAK,CAAC;AACxE;;;;;;AAOA,MAAa,yBAAyB,WAA2B;CAC/D,MAAM,QAAkB,CAAC;CACzB,IAAI,YAAoB;CACxB,OAAO,YAAY,IAAe;EAEhC,MAAM,KAAK,OAAO,SAAS,CAAC;EAC5B,aAAa;CACf;CACA,IAAI,aAAa,WAAW,MAAM,KAAK,OAAO,SAAS,CAAC;MACnD;EAEH,MAAM,KAAK,OAAO,YAAY,CAAC,CAAC;EAChC,MAAM,KAAK,OAAO,CAAC,CAAC;CACtB;CACA,OAAO,MAAM,KAAK,GAAG;AACvB;AAEA,MAAM,UAAU,WACd,cAAc;CAAE,MAAM;CAAU,WAAW;CAAQ,WAAW;AAAO,CAAC"}

package/lib/internal/_randomFormatIdnEmail.d.ts

@@ -1 +1,2 @@
-export declare const _randomFormatIdnEmail: () => string;
+import { _ILengthProps } from "./_randomStringLength";
+export declare const _randomFormatIdnEmail: (props?: _ILengthProps) => string;

package/lib/internal/_randomFormatIdnEmail.js

@@ -1,7 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._randomFormatIdnEmail = void 0;
-const _randomFormatEmail_1 = require("./_randomFormatEmail");
-const _randomFormatIdnEmail = () => (0, _randomFormatEmail_1._randomFormatEmail)();
+const _randomString_1 = require("./_randomString");
+const _randomStringLength_1 = require("./_randomStringLength");
+const _randomFormatIdnEmail = (props) => {
+    if ((props === null || props === void 0 ? void 0 : props.minLength) === undefined && (props === null || props === void 0 ? void 0 : props.maxLength) === undefined)
+        return `${random(10)}@${random(10)}.${random(3)}`;
+    // `_isFormatIdnEmail` requires a >=2-char TLD (`(…\.)+[^…]{2,}`), so the fixed
+    // overhead is `@` + domain(1) + `.` + tld(2) = 5 and the local part absorbs the
+    // requested length; a one-character TLD (the non-idn generator's length path)
+    // would be rejected by the idn checker on every draw.
+    return `${(0, _randomStringLength_1._randomSegmentLength)(props, 5, 10, 1)}@${random(1)}.${random(2)}`;
+};
 exports._randomFormatIdnEmail = _randomFormatIdnEmail;
+const random = (length) => (0, _randomString_1._randomString)({
+    type: "string",
+    minLength: length,
+    maxLength: length,
+});
 //# sourceMappingURL=_randomFormatIdnEmail.js.map

package/lib/internal/_randomFormatIdnEmail.js.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatIdnEmail.js","sourceRoot":"","sources":["../../src/internal/_randomFormatIdnEmail.ts"],"names":[],"mappings":";;;AAAA,6DAA0D;AAEnD,MAAM,qBAAqB,GAAG,GAAW,EAAE,CAAC,IAAA,uCAAkB,GAAE,CAAC;AAA3D,QAAA,qBAAqB,GAArB,qBAAqB,CAAsC"}
+{"version":3,"file":"_randomFormatIdnEmail.js","sourceRoot":"","sources":["../../src/internal/_randomFormatIdnEmail.ts"],"names":[],"mappings":";;;AAAA,mDAAgD;AAChD,+DAA4E;AAErE,MAAM,qBAAqB,GAAG,CAAC,KAAqB,EAAU,EAAE;IACrE,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS;QAClE,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,+EAA+E;IAC/E,gFAAgF;IAChF,8EAA8E;IAC9E,sDAAsD;IACtD,OAAO,GAAG,IAAA,0CAAoB,EAAC,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9E,CAAC,CAAC;AARW,QAAA,qBAAqB,GAArB,qBAAqB,CAQhC;AAEF,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,EAAE,CAChC,IAAA,6BAAa,EAAC;IACZ,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,MAAM;IACjB,SAAS,EAAE,MAAM;CAClB,CAAC,CAAC"}

package/lib/internal/_randomFormatIdnEmail.mjs

@@ -1,6 +1,15 @@
-import { _randomFormatEmail } from "./_randomFormatEmail.mjs";
+import { _randomString } from "./_randomString.mjs";
+import { _randomSegmentLength } from "./_randomStringLength.mjs";
 //#region src/internal/_randomFormatIdnEmail.ts
-const _randomFormatIdnEmail = () => _randomFormatEmail();
+const _randomFormatIdnEmail = (props) => {
+	if (props?.minLength === void 0 && props?.maxLength === void 0) return `${random(10)}@${random(10)}.${random(3)}`;
+	return `${_randomSegmentLength(props, 5, 10, 1)}@${random(1)}.${random(2)}`;
+};
+const random = (length) => _randomString({
+	type: "string",
+	minLength: length,
+	maxLength: length
+});
 //#endregion
 export { _randomFormatIdnEmail };
 

package/lib/internal/_randomFormatIdnEmail.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatIdnEmail.mjs","names":[],"sources":["../../src/internal/_randomFormatIdnEmail.ts"],"sourcesContent":["import { _randomFormatEmail } from \"./_randomFormatEmail\";\n\nexport const _randomFormatIdnEmail = (): string => _randomFormatEmail();\n"],"mappings":";;AAEA,MAAa,8BAAsC,mBAAmB"}
+{"version":3,"file":"_randomFormatIdnEmail.mjs","names":[],"sources":["../../src/internal/_randomFormatIdnEmail.ts"],"sourcesContent":["import { _randomString } from \"./_randomString\";\nimport { _ILengthProps, _randomSegmentLength } from \"./_randomStringLength\";\n\nexport const _randomFormatIdnEmail = (props?: _ILengthProps): string => {\n  if (props?.minLength === undefined && props?.maxLength === undefined)\n    return `${random(10)}@${random(10)}.${random(3)}`;\n  // `_isFormatIdnEmail` requires a >=2-char TLD (`(…\\.)+[^…]{2,}`), so the fixed\n  // overhead is `@` + domain(1) + `.` + tld(2) = 5 and the local part absorbs the\n  // requested length; a one-character TLD (the non-idn generator's length path)\n  // would be rejected by the idn checker on every draw.\n  return `${_randomSegmentLength(props, 5, 10, 1)}@${random(1)}.${random(2)}`;\n};\n\nconst random = (length: number) =>\n  _randomString({\n    type: \"string\",\n    minLength: length,\n    maxLength: length,\n  });\n"],"mappings":";;;AAGA,MAAa,yBAAyB,UAAkC;CACtE,IAAI,OAAO,cAAc,KAAA,KAAa,OAAO,cAAc,KAAA,GACzD,OAAO,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC;CAKhD,OAAO,GAAG,qBAAqB,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC;AAC1E;AAEA,MAAM,UAAU,WACd,cAAc;CACZ,MAAM;CACN,WAAW;CACX,WAAW;AACb,CAAC"}

package/lib/internal/_randomFormatIdnHostname.d.ts

@@ -1 +1,2 @@
-export declare const _randomFormatIdnHostname: () => string;
+import { _ILengthProps } from "./_randomStringLength";
+export declare const _randomFormatIdnHostname: (props?: _ILengthProps) => string;

package/lib/internal/_randomFormatIdnHostname.js

@@ -2,6 +2,31 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._randomFormatIdnHostname = void 0;
 const _randomFormatHostname_1 = require("./_randomFormatHostname");
-const _randomFormatIdnHostname = () => (0, _randomFormatHostname_1._randomFormatHostname)();
+const _randomInteger_1 = require("./_randomInteger");
+const _randomString_1 = require("./_randomString");
+const _randomFormatIdnHostname = (props) => {
+    if ((props === null || props === void 0 ? void 0 : props.minLength) === undefined && (props === null || props === void 0 ? void 0 : props.maxLength) === undefined)
+        return `${random(10)}.${random(3)}`;
+    // `_isFormatIdnHostname` requires at least one label, a dot, and a >=2-char
+    // TLD (`(…\.)+[a-z¡-￿]{2,}`), none of which the non-idn hostname generator
+    // guarantees on its length path (it can emit a single dotless label). Reserve
+    // a fixed `.<2-char TLD>` and realize the rest as dot-joined leading labels.
+    const length = pickLength(props);
+    return `${(0, _randomFormatHostname_1._randomHostnameLabels)(length - 3)}.${random(2)}`;
+};
 exports._randomFormatIdnHostname = _randomFormatIdnHostname;
+const MAX_TOTAL = 253;
+const MIN_TOTAL = 4; // the shortest idn hostname, `x.yy`: label(1) + `.` + tld(2)
+const pickLength = (props) => {
+    let low = props.minLength === undefined ? MIN_TOTAL : props.minLength;
+    if (low < MIN_TOTAL)
+        low = MIN_TOTAL;
+    const high = props.maxLength === undefined
+        ? Math.min(MAX_TOTAL, low + 14)
+        : Math.min(MAX_TOTAL, props.maxLength);
+    if (high < low)
+        throw new Error("unable to generate a random idn hostname satisfying both the format and the length constraints.");
+    return (0, _randomInteger_1._randomInteger)({ type: "integer", minimum: low, maximum: high });
+};
+const random = (length) => (0, _randomString_1._randomString)({ type: "string", minLength: length, maxLength: length });
 //# sourceMappingURL=_randomFormatIdnHostname.js.map

package/lib/internal/_randomFormatIdnHostname.js.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatIdnHostname.js","sourceRoot":"","sources":["../../src/internal/_randomFormatIdnHostname.ts"],"names":[],"mappings":";;;AAAA,mEAAgE;AAEzD,MAAM,wBAAwB,GAAG,GAAW,EAAE,CAAC,IAAA,6CAAqB,GAAE,CAAC;AAAjE,QAAA,wBAAwB,GAAxB,wBAAwB,CAAyC"}
+{"version":3,"file":"_randomFormatIdnHostname.js","sourceRoot":"","sources":["../../src/internal/_randomFormatIdnHostname.ts"],"names":[],"mappings":";;;AAAA,mEAAgE;AAChE,qDAAkD;AAClD,mDAAgD;AAGzC,MAAM,wBAAwB,GAAG,CAAC,KAAqB,EAAU,EAAE;IACxE,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS;QAClE,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACtC,4EAA4E;IAC5E,2EAA2E;IAC3E,8EAA8E;IAC9E,6EAA6E;IAC7E,MAAM,MAAM,GAAW,UAAU,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO,GAAG,IAAA,6CAAqB,EAAC,MAAM,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7D,CAAC,CAAC;AATW,QAAA,wBAAwB,GAAxB,wBAAwB,CASnC;AAEF,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,MAAM,SAAS,GAAG,CAAC,CAAC,CAAC,6DAA6D;AAElF,MAAM,UAAU,GAAG,CAAC,KAAoB,EAAU,EAAE;IAClD,IAAI,GAAG,GAAW,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC;IAC9E,IAAI,GAAG,GAAG,SAAS;QAAE,GAAG,GAAG,SAAS,CAAC;IACrC,MAAM,IAAI,GACR,KAAK,CAAC,SAAS,KAAK,SAAS;QAC3B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,GAAG,EAAE,CAAC;QAC/B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,IAAI,GAAG,GAAG;QACZ,MAAM,IAAI,KAAK,CACb,iGAAiG,CAClG,CAAC;IACJ,OAAO,IAAA,+BAAc,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAC1E,CAAC,CAAC;AAEF,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,EAAE,CAChC,IAAA,6BAAa,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC"}

package/lib/internal/_randomFormatIdnHostname.mjs

@@ -1,6 +1,29 @@
-import { _randomFormatHostname } from "./_randomFormatHostname.mjs";
+import { _randomInteger } from "./_randomInteger.mjs";
+import { _randomString } from "./_randomString.mjs";
+import { _randomHostnameLabels } from "./_randomFormatHostname.mjs";
 //#region src/internal/_randomFormatIdnHostname.ts
-const _randomFormatIdnHostname = () => _randomFormatHostname();
+const _randomFormatIdnHostname = (props) => {
+	if (props?.minLength === void 0 && props?.maxLength === void 0) return `${random(10)}.${random(3)}`;
+	return `${_randomHostnameLabels(pickLength(props) - 3)}.${random(2)}`;
+};
+const MAX_TOTAL = 253;
+const MIN_TOTAL = 4;
+const pickLength = (props) => {
+	let low = props.minLength === void 0 ? MIN_TOTAL : props.minLength;
+	if (low < MIN_TOTAL) low = MIN_TOTAL;
+	const high = props.maxLength === void 0 ? Math.min(MAX_TOTAL, low + 14) : Math.min(MAX_TOTAL, props.maxLength);
+	if (high < low) throw new Error("unable to generate a random idn hostname satisfying both the format and the length constraints.");
+	return _randomInteger({
+		type: "integer",
+		minimum: low,
+		maximum: high
+	});
+};
+const random = (length) => _randomString({
+	type: "string",
+	minLength: length,
+	maxLength: length
+});
 //#endregion
 export { _randomFormatIdnHostname };
 

package/lib/internal/_randomFormatIdnHostname.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatIdnHostname.mjs","names":[],"sources":["../../src/internal/_randomFormatIdnHostname.ts"],"sourcesContent":["import { _randomFormatHostname } from \"./_randomFormatHostname\";\n\nexport const _randomFormatIdnHostname = (): string => _randomFormatHostname();\n"],"mappings":";;AAEA,MAAa,iCAAyC,sBAAsB"}
+{"version":3,"file":"_randomFormatIdnHostname.mjs","names":[],"sources":["../../src/internal/_randomFormatIdnHostname.ts"],"sourcesContent":["import { _randomHostnameLabels } from \"./_randomFormatHostname\";\nimport { _randomInteger } from \"./_randomInteger\";\nimport { _randomString } from \"./_randomString\";\nimport { _ILengthProps } from \"./_randomStringLength\";\n\nexport const _randomFormatIdnHostname = (props?: _ILengthProps): string => {\n  if (props?.minLength === undefined && props?.maxLength === undefined)\n    return `${random(10)}.${random(3)}`;\n  // `_isFormatIdnHostname` requires at least one label, a dot, and a >=2-char\n  // TLD (`(…\\.)+[a-z¡-￿]{2,}`), none of which the non-idn hostname generator\n  // guarantees on its length path (it can emit a single dotless label). Reserve\n  // a fixed `.<2-char TLD>` and realize the rest as dot-joined leading labels.\n  const length: number = pickLength(props);\n  return `${_randomHostnameLabels(length - 3)}.${random(2)}`;\n};\n\nconst MAX_TOTAL = 253;\nconst MIN_TOTAL = 4; // the shortest idn hostname, `x.yy`: label(1) + `.` + tld(2)\n\nconst pickLength = (props: _ILengthProps): number => {\n  let low: number = props.minLength === undefined ? MIN_TOTAL : props.minLength;\n  if (low < MIN_TOTAL) low = MIN_TOTAL;\n  const high: number =\n    props.maxLength === undefined\n      ? Math.min(MAX_TOTAL, low + 14)\n      : Math.min(MAX_TOTAL, props.maxLength);\n  if (high < low)\n    throw new Error(\n      \"unable to generate a random idn hostname satisfying both the format and the length constraints.\",\n    );\n  return _randomInteger({ type: \"integer\", minimum: low, maximum: high });\n};\n\nconst random = (length: number) =>\n  _randomString({ type: \"string\", minLength: length, maxLength: length });\n"],"mappings":";;;;AAKA,MAAa,4BAA4B,UAAkC;CACzE,IAAI,OAAO,cAAc,KAAA,KAAa,OAAO,cAAc,KAAA,GACzD,OAAO,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC;CAMlC,OAAO,GAAG,sBADa,WAAW,KACG,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC;AACzD;AAEA,MAAM,YAAY;AAClB,MAAM,YAAY;AAElB,MAAM,cAAc,UAAiC;CACnD,IAAI,MAAc,MAAM,cAAc,KAAA,IAAY,YAAY,MAAM;CACpE,IAAI,MAAM,WAAW,MAAM;CAC3B,MAAM,OACJ,MAAM,cAAc,KAAA,IAChB,KAAK,IAAI,WAAW,MAAM,EAAE,IAC5B,KAAK,IAAI,WAAW,MAAM,SAAS;CACzC,IAAI,OAAO,KACT,MAAM,IAAI,MACR,iGACF;CACF,OAAO,eAAe;EAAE,MAAM;EAAW,SAAS;EAAK,SAAS;CAAK,CAAC;AACxE;AAEA,MAAM,UAAU,WACd,cAAc;CAAE,MAAM;CAAU,WAAW;CAAQ,WAAW;AAAO,CAAC"}

package/lib/internal/_randomFormatIpv4.d.ts

@@ -1 +1,2 @@
-export declare const _randomFormatIpv4: () => string;
+import { _ILengthProps } from "./_randomStringLength";
+export declare const _randomFormatIpv4: (props?: _ILengthProps) => string;

package/lib/internal/_randomFormatIpv4.js

@@ -2,11 +2,42 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._randomFormatIpv4 = void 0;
 const _randomInteger_1 = require("./_randomInteger");
-const _randomFormatIpv4 = () => new Array(4).fill(0).map(random).join(".");
+const _randomStringLength_1 = require("./_randomStringLength");
+const __randomComposition_1 = require("./private/__randomComposition");
+const _randomFormatIpv4 = (props) => {
+    if ((props === null || props === void 0 ? void 0 : props.minLength) === undefined && (props === null || props === void 0 ? void 0 : props.maxLength) === undefined)
+        return new Array(4).fill(0).map(random).join(".");
+    // Three dots plus four octets of one to three digits: `0.0.0.0` is the
+    // shortest address and `255.255.255.255` the longest, and every length
+    // between them is reached by choosing how many digits each octet spends.
+    const length = (0, _randomStringLength_1._randomLengthPick)((0, _randomStringLength_1._randomLengthWindow)(props, {
+        minimum: 4 * DIGITS_MIN + DOTS,
+        maximum: 4 * DIGITS_MAX + DOTS,
+        spread: 8,
+    }));
+    return (0, __randomComposition_1.__randomComposition)({
+        total: length - DOTS,
+        count: 4,
+        minimum: DIGITS_MIN,
+        maximum: DIGITS_MAX,
+    })
+        .map(octet)
+        .join(".");
+};
 exports._randomFormatIpv4 = _randomFormatIpv4;
+const DOTS = 3;
+const DIGITS_MIN = 1;
+const DIGITS_MAX = 3;
 const random = () => (0, _randomInteger_1._randomInteger)({
     type: "integer",
     minimum: 0,
     maximum: 255,
 });
+// An octet is bounded by 255, so a three-digit one starts at 100 and stops
+// there rather than at 999.
+const octet = (digits) => String((0, _randomInteger_1._randomInteger)({
+    type: "integer",
+    minimum: digits === 1 ? 0 : Math.pow(10, digits - 1),
+    maximum: digits === 3 ? 255 : Math.pow(10, digits) - 1,
+}));
 //# sourceMappingURL=_randomFormatIpv4.js.map

package/lib/internal/_randomFormatIpv4.js.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatIpv4.js","sourceRoot":"","sources":["../../src/internal/_randomFormatIpv4.ts"],"names":[],"mappings":";;;AAAA,qDAAkD;AAE3C,MAAM,iBAAiB,GAAG,GAAW,EAAE,CAC5C,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AADhC,QAAA,iBAAiB,GAAjB,iBAAiB,CACe;AAE7C,MAAM,MAAM,GAAG,GAAG,EAAE,CAClB,IAAA,+BAAc,EAAC;IACb,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,GAAG;CACb,CAAC,CAAC"}
+{"version":3,"file":"_randomFormatIpv4.js","sourceRoot":"","sources":["../../src/internal/_randomFormatIpv4.ts"],"names":[],"mappings":";;;AAAA,qDAAkD;AAClD,+DAI+B;AAC/B,uEAAoE;AAE7D,MAAM,iBAAiB,GAAG,CAAC,KAAqB,EAAU,EAAE;IACjE,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS;QAClE,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpD,uEAAuE;IACvE,uEAAuE;IACvE,yEAAyE;IACzE,MAAM,MAAM,GAAW,IAAA,uCAAiB,EACtC,IAAA,yCAAmB,EAAC,KAAK,EAAE;QACzB,OAAO,EAAE,CAAC,GAAG,UAAU,GAAG,IAAI;QAC9B,OAAO,EAAE,CAAC,GAAG,UAAU,GAAG,IAAI;QAC9B,MAAM,EAAE,CAAC;KACV,CAAC,CACH,CAAC;IACF,OAAO,IAAA,yCAAmB,EAAC;QACzB,KAAK,EAAE,MAAM,GAAG,IAAI;QACpB,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,UAAU;QACnB,OAAO,EAAE,UAAU;KACpB,CAAC;SACC,GAAG,CAAC,KAAK,CAAC;SACV,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC,CAAC;AArBW,QAAA,iBAAiB,GAAjB,iBAAiB,CAqB5B;AAEF,MAAM,IAAI,GAAG,CAAC,CAAC;AACf,MAAM,UAAU,GAAG,CAAC,CAAC;AACrB,MAAM,UAAU,GAAG,CAAC,CAAC;AAErB,MAAM,MAAM,GAAG,GAAG,EAAE,CAClB,IAAA,+BAAc,EAAC;IACb,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,GAAG;CACb,CAAC,CAAC;AAEL,2EAA2E;AAC3E,4BAA4B;AAC5B,MAAM,KAAK,GAAG,CAAC,MAAc,EAAU,EAAE,CACvC,MAAM,CACJ,IAAA,+BAAc,EAAC;IACb,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC;IACpD,OAAO,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;CACvD,CAAC,CACH,CAAC"}

package/lib/internal/_randomFormatIpv4.mjs

@@ -1,11 +1,33 @@
 import { _randomInteger } from "./_randomInteger.mjs";
+import { _randomLengthPick, _randomLengthWindow } from "./_randomStringLength.mjs";
+import { __randomComposition } from "./private/__randomComposition.mjs";
 //#region src/internal/_randomFormatIpv4.ts
-const _randomFormatIpv4 = () => new Array(4).fill(0).map(random).join(".");
+const _randomFormatIpv4 = (props) => {
+	if (props?.minLength === void 0 && props?.maxLength === void 0) return new Array(4).fill(0).map(random).join(".");
+	return __randomComposition({
+		total: _randomLengthPick(_randomLengthWindow(props, {
+			minimum: 4 * DIGITS_MIN + DOTS,
+			maximum: 4 * DIGITS_MAX + DOTS,
+			spread: 8
+		})) - DOTS,
+		count: 4,
+		minimum: DIGITS_MIN,
+		maximum: DIGITS_MAX
+	}).map(octet).join(".");
+};
+const DOTS = 3;
+const DIGITS_MIN = 1;
+const DIGITS_MAX = 3;
 const random = () => _randomInteger({
 	type: "integer",
 	minimum: 0,
 	maximum: 255
 });
+const octet = (digits) => String(_randomInteger({
+	type: "integer",
+	minimum: digits === 1 ? 0 : Math.pow(10, digits - 1),
+	maximum: digits === 3 ? 255 : Math.pow(10, digits) - 1
+}));
 //#endregion
 export { _randomFormatIpv4 };
 

package/lib/internal/_randomFormatIpv4.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatIpv4.mjs","names":[],"sources":["../../src/internal/_randomFormatIpv4.ts"],"sourcesContent":["import { _randomInteger } from \"./_randomInteger\";\n\nexport const _randomFormatIpv4 = (): string =>\n  new Array(4).fill(0).map(random).join(\".\");\n\nconst random = () =>\n  _randomInteger({\n    type: \"integer\",\n    minimum: 0,\n    maximum: 255,\n  });\n"],"mappings":";;AAEA,MAAa,0BACX,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,GAAG;AAE3C,MAAM,eACJ,eAAe;CACb,MAAM;CACN,SAAS;CACT,SAAS;AACX,CAAC"}
+{"version":3,"file":"_randomFormatIpv4.mjs","names":[],"sources":["../../src/internal/_randomFormatIpv4.ts"],"sourcesContent":["import { _randomInteger } from \"./_randomInteger\";\nimport {\n  _ILengthProps,\n  _randomLengthPick,\n  _randomLengthWindow,\n} from \"./_randomStringLength\";\nimport { __randomComposition } from \"./private/__randomComposition\";\n\nexport const _randomFormatIpv4 = (props?: _ILengthProps): string => {\n  if (props?.minLength === undefined && props?.maxLength === undefined)\n    return new Array(4).fill(0).map(random).join(\".\");\n  // Three dots plus four octets of one to three digits: `0.0.0.0` is the\n  // shortest address and `255.255.255.255` the longest, and every length\n  // between them is reached by choosing how many digits each octet spends.\n  const length: number = _randomLengthPick(\n    _randomLengthWindow(props, {\n      minimum: 4 * DIGITS_MIN + DOTS,\n      maximum: 4 * DIGITS_MAX + DOTS,\n      spread: 8,\n    }),\n  );\n  return __randomComposition({\n    total: length - DOTS,\n    count: 4,\n    minimum: DIGITS_MIN,\n    maximum: DIGITS_MAX,\n  })\n    .map(octet)\n    .join(\".\");\n};\n\nconst DOTS = 3;\nconst DIGITS_MIN = 1;\nconst DIGITS_MAX = 3;\n\nconst random = () =>\n  _randomInteger({\n    type: \"integer\",\n    minimum: 0,\n    maximum: 255,\n  });\n\n// An octet is bounded by 255, so a three-digit one starts at 100 and stops\n// there rather than at 999.\nconst octet = (digits: number): string =>\n  String(\n    _randomInteger({\n      type: \"integer\",\n      minimum: digits === 1 ? 0 : Math.pow(10, digits - 1),\n      maximum: digits === 3 ? 255 : Math.pow(10, digits) - 1,\n    }),\n  );\n"],"mappings":";;;;AAQA,MAAa,qBAAqB,UAAkC;CAClE,IAAI,OAAO,cAAc,KAAA,KAAa,OAAO,cAAc,KAAA,GACzD,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,GAAG;CAWlD,OAAO,oBAAoB;EACzB,OARqB,kBACrB,oBAAoB,OAAO;GACzB,SAAS,IAAI,aAAa;GAC1B,SAAS,IAAI,aAAa;GAC1B,QAAQ;EACV,CAAC,CAGW,IAAI;EAChB,OAAO;EACP,SAAS;EACT,SAAS;CACX,CAAC,CAAC,CACC,IAAI,KAAK,CAAC,CACV,KAAK,GAAG;AACb;AAEA,MAAM,OAAO;AACb,MAAM,aAAa;AACnB,MAAM,aAAa;AAEnB,MAAM,eACJ,eAAe;CACb,MAAM;CACN,SAAS;CACT,SAAS;AACX,CAAC;AAIH,MAAM,SAAS,WACb,OACE,eAAe;CACb,MAAM;CACN,SAAS,WAAW,IAAI,IAAI,KAAK,IAAI,IAAI,SAAS,CAAC;CACnD,SAAS,WAAW,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,IAAI;AACvD,CAAC,CACH"}

package/lib/internal/_randomFormatIpv6.d.ts

@@ -1 +1,2 @@
-export declare const _randomFormatIpv6: () => string;
+import { _ILengthProps } from "./_randomStringLength";
+export declare const _randomFormatIpv6: (props?: _ILengthProps) => string;

package/lib/internal/_randomFormatIpv6.js

@@ -1,12 +1,69 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._randomFormatIpv6 = void 0;
+const _randomFormatIpv4_1 = require("./_randomFormatIpv4");
 const _randomInteger_1 = require("./_randomInteger");
-const _randomFormatIpv6 = () => new Array(8).fill(0).map(random).join(":");
+const _randomStringLength_1 = require("./_randomStringLength");
+const __randomComposition_1 = require("./private/__randomComposition");
+const _randomFormatIpv6 = (props) => {
+    if ((props === null || props === void 0 ? void 0 : props.minLength) === undefined && (props === null || props === void 0 ? void 0 : props.maxLength) === undefined)
+        return new Array(GROUPS).fill(0).map(random).join(":");
+    const length = (0, _randomStringLength_1._randomLengthPick)((0, _randomStringLength_1._randomLengthWindow)(props, {
+        minimum: SHORTEST,
+        maximum: LONGEST,
+        spread: 12,
+    }));
+    // `::` alone is the all-zero address, and the three forms below cover every
+    // length between it and the padded IPv4-suffixed address: a compressed prefix
+    // for the short ones, eight groups of one to four hexadecimal digits for the
+    // middle, and six groups plus a dotted-quad tail for the long ones.
+    if (length === SHORTEST)
+        return "::";
+    if (length < GROUPS * DIGITS_MIN + COLONS) {
+        // `::` plus `count` groups spends one colon between each pair.
+        const count = Math.ceil((length - 1) / (DIGITS_MAX + 1));
+        return `::${compose(length - 1 - count, count)}`;
+    }
+    if (length <= GROUPS * DIGITS_MAX + COLONS)
+        return compose(length - COLONS, GROUPS);
+    // The dotted-quad tail is drawn at its longest so the six leading groups keep
+    // a composable number of digits.
+    const tail = (0, _randomFormatIpv4_1._randomFormatIpv4)({
+        minLength: IPV4_MAX,
+        maxLength: IPV4_MAX,
+    });
+    return `${compose(length - IPV4_MAX - EMBEDDED, EMBEDDED)}:${tail}`;
+};
 exports._randomFormatIpv6 = _randomFormatIpv6;
+const GROUPS = 8;
+const COLONS = GROUPS - 1;
+const DIGITS_MIN = 1;
+const DIGITS_MAX = 4;
+const EMBEDDED = 6; // groups preceding a dotted-quad tail
+const IPV4_MAX = "255.255.255.255".length;
+const SHORTEST = "::".length;
+const LONGEST = EMBEDDED * DIGITS_MAX + EMBEDDED + IPV4_MAX;
+const compose = (digits, count) => (0, __randomComposition_1.__randomComposition)({
+    total: digits,
+    count,
+    minimum: DIGITS_MIN,
+    maximum: DIGITS_MAX,
+})
+    .map(group)
+    .join(":");
 const random = () => (0, _randomInteger_1._randomInteger)({
     type: "integer",
     minimum: 0,
     maximum: 65535,
 }).toString(16);
+const group = (digits) => {
+    let text = "";
+    for (let i = 0; i < digits; ++i)
+        text += (0, _randomInteger_1._randomInteger)({
+            type: "integer",
+            minimum: 0,
+            maximum: 15,
+        }).toString(16);
+    return text;
+};
 //# sourceMappingURL=_randomFormatIpv6.js.map

package/lib/internal/_randomFormatIpv6.js.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatIpv6.js","sourceRoot":"","sources":["../../src/internal/_randomFormatIpv6.ts"],"names":[],"mappings":";;;AAAA,qDAAkD;AAE3C,MAAM,iBAAiB,GAAG,GAAW,EAAE,CAC5C,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AADhC,QAAA,iBAAiB,GAAjB,iBAAiB,CACe;AAE7C,MAAM,MAAM,GAAG,GAAG,EAAE,CAClB,IAAA,+BAAc,EAAC;IACb,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,KAAM;CAChB,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC"}
+{"version":3,"file":"_randomFormatIpv6.js","sourceRoot":"","sources":["../../src/internal/_randomFormatIpv6.ts"],"names":[],"mappings":"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"}