typia 15.0.0 → 15.1.0

package/lib/internal/_randomFormatIpv6.js

@@ -5,6 +5,14 @@ const _randomFormatIpv4_1 = require("./_randomFormatIpv4");
 const _randomInteger_1 = require("./_randomInteger");
 const _randomStringLength_1 = require("./_randomStringLength");
 const __randomComposition_1 = require("./private/__randomComposition");
+/**
+ * Generate an IPv6 address at a length the bounds allow.
+ *
+ * @evidence contracts/common.md#principled-implementation The length window selects among the compressed form for short lengths, the eight-group form for the middle and a six-group form with a dotted IPv4 tail for the longest, composing hexadecimal digits so every length from two to the longest form is reachable.
+ * @evidence contracts/common.md#clear-and-simple-design One function with three length ranges and shared composers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The forms are those of the address grammar.
+ * @evidence contracts/common.md#meaningful-documentation Inline comments explain the three forms.
+ */
 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(":");

package/lib/internal/_randomFormatIpv6.js.map

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

package/lib/internal/_randomFormatIpv6.mjs

@@ -3,6 +3,14 @@ import { _randomLengthPick, _randomLengthWindow } from "./_randomStringLength.mj
 import { __randomComposition } from "./private/__randomComposition.mjs";
 import { _randomFormatIpv4 } from "./_randomFormatIpv4.mjs";
 //#region src/internal/_randomFormatIpv6.ts
+/**
+* Generate an IPv6 address at a length the bounds allow.
+*
+* @evidence contracts/common.md#principled-implementation The length window selects among the compressed form for short lengths, the eight-group form for the middle and a six-group form with a dotted IPv4 tail for the longest, composing hexadecimal digits so every length from two to the longest form is reachable.
+* @evidence contracts/common.md#clear-and-simple-design One function with three length ranges and shared composers.
+* @evidence contracts/common.md#prohibited-implementation-shortcuts The forms are those of the address grammar.
+* @evidence contracts/common.md#meaningful-documentation Inline comments explain the three forms.
+*/
 const _randomFormatIpv6 = (props) => {
 	if (props?.minLength === void 0 && props?.maxLength === void 0) return new Array(GROUPS).fill(0).map(random).join(":");
 	const length = _randomLengthPick(_randomLengthWindow(props, {

package/lib/internal/_randomFormatIpv6.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatIpv6.mjs","names":[],"sources":["../../src/internal/_randomFormatIpv6.ts"],"sourcesContent":["import { _randomFormatIpv4 } from \"./_randomFormatIpv4\";\nimport { _randomInteger } from \"./_randomInteger\";\nimport {\n  _ILengthProps,\n  _randomLengthPick,\n  _randomLengthWindow,\n} from \"./_randomStringLength\";\nimport { __randomComposition } from \"./private/__randomComposition\";\n\nexport const _randomFormatIpv6 = (props?: _ILengthProps): string => {\n  if (props?.minLength === undefined && props?.maxLength === undefined)\n    return new Array(GROUPS).fill(0).map(random).join(\":\");\n  const length: number = _randomLengthPick(\n    _randomLengthWindow(props, {\n      minimum: SHORTEST,\n      maximum: LONGEST,\n      spread: 12,\n    }),\n  );\n  // `::` alone is the all-zero address, and the three forms below cover every\n  // length between it and the padded IPv4-suffixed address: a compressed prefix\n  // for the short ones, eight groups of one to four hexadecimal digits for the\n  // middle, and six groups plus a dotted-quad tail for the long ones.\n  if (length === SHORTEST) return \"::\";\n  if (length < GROUPS * DIGITS_MIN + COLONS) {\n    // `::` plus `count` groups spends one colon between each pair.\n    const count: number = Math.ceil((length - 1) / (DIGITS_MAX + 1));\n    return `::${compose(length - 1 - count, count)}`;\n  }\n  if (length <= GROUPS * DIGITS_MAX + COLONS)\n    return compose(length - COLONS, GROUPS);\n  // The dotted-quad tail is drawn at its longest so the six leading groups keep\n  // a composable number of digits.\n  const tail: string = _randomFormatIpv4({\n    minLength: IPV4_MAX,\n    maxLength: IPV4_MAX,\n  });\n  return `${compose(length - IPV4_MAX - EMBEDDED, EMBEDDED)}:${tail}`;\n};\n\nconst GROUPS = 8;\nconst COLONS = GROUPS - 1;\nconst DIGITS_MIN = 1;\nconst DIGITS_MAX = 4;\nconst EMBEDDED = 6; // groups preceding a dotted-quad tail\nconst IPV4_MAX = \"255.255.255.255\".length;\nconst SHORTEST = \"::\".length;\nconst LONGEST = EMBEDDED * DIGITS_MAX + EMBEDDED + IPV4_MAX;\n\nconst compose = (digits: number, count: number): string =>\n  __randomComposition({\n    total: digits,\n    count,\n    minimum: DIGITS_MIN,\n    maximum: DIGITS_MAX,\n  })\n    .map(group)\n    .join(\":\");\n\nconst random = () =>\n  _randomInteger({\n    type: \"integer\",\n    minimum: 0,\n    maximum: 65_535,\n  }).toString(16);\n\nconst group = (digits: number): string => {\n  let text: string = \"\";\n  for (let i: number = 0; i < digits; ++i)\n    text += _randomInteger({\n      type: \"integer\",\n      minimum: 0,\n      maximum: 15,\n    }).toString(16);\n  return text;\n};\n"],"mappings":";;;;;AASA,MAAa,qBAAqB,UAAkC;CAClE,IAAI,OAAO,cAAc,KAAA,KAAa,OAAO,cAAc,KAAA,GACzD,OAAO,IAAI,MAAM,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,GAAG;CACvD,MAAM,SAAiB,kBACrB,oBAAoB,OAAO;EACzB,SAAS;EACT,SAAS;EACT,QAAQ;CACV,CAAC,CACH;CAKA,IAAI,WAAW,UAAU,OAAO;CAChC,IAAI,SAAS,SAAS,aAAa,QAAQ;EAEzC,MAAM,QAAgB,KAAK,MAAM,SAAS,MAAM,aAAa,EAAE;EAC/D,OAAO,KAAK,QAAQ,SAAS,IAAI,OAAO,KAAK;CAC/C;CACA,IAAI,UAAU,SAAS,aAAa,QAClC,OAAO,QAAQ,SAAS,QAAQ,MAAM;CAGxC,MAAM,OAAe,kBAAkB;EACrC,WAAW;EACX,WAAW;CACb,CAAC;CACD,OAAO,GAAG,QAAQ,SAAS,WAAW,UAAU,QAAQ,EAAE,GAAG;AAC/D;AAEA,MAAM,SAAS;AACf,MAAM,SAAS,SAAS;AACxB,MAAM,aAAa;AACnB,MAAM,aAAa;AACnB,MAAM,WAAW;AACjB,MAAM,WAAW;AACjB,MAAM,WAAW;AACjB,MAAM,UAAU;AAEhB,MAAM,WAAW,QAAgB,UAC/B,oBAAoB;CAClB,OAAO;CACP;CACA,SAAS;CACT,SAAS;AACX,CAAC,CAAC,CACC,IAAI,KAAK,CAAC,CACV,KAAK,GAAG;AAEb,MAAM,eACJ,eAAe;CACb,MAAM;CACN,SAAS;CACT,SAAS;AACX,CAAC,CAAC,CAAC,SAAS,EAAE;AAEhB,MAAM,SAAS,WAA2B;CACxC,IAAI,OAAe;CACnB,KAAK,IAAI,IAAY,GAAG,IAAI,QAAQ,EAAE,GACpC,QAAQ,eAAe;EACrB,MAAM;EACN,SAAS;EACT,SAAS;CACX,CAAC,CAAC,CAAC,SAAS,EAAE;CAChB,OAAO;AACT"}
+{"version":3,"file":"_randomFormatIpv6.mjs","names":[],"sources":["../../src/internal/_randomFormatIpv6.ts"],"sourcesContent":["import { _randomFormatIpv4 } from \"./_randomFormatIpv4\";\nimport { _randomInteger } from \"./_randomInteger\";\nimport {\n  _ILengthProps,\n  _randomLengthPick,\n  _randomLengthWindow,\n} from \"./_randomStringLength\";\nimport { __randomComposition } from \"./private/__randomComposition\";\n\n/**\n * Generate an IPv6 address at a length the bounds allow.\n *\n * @evidence contracts/common.md#principled-implementation The length window selects among the compressed form for short lengths, the eight-group form for the middle and a six-group form with a dotted IPv4 tail for the longest, composing hexadecimal digits so every length from two to the longest form is reachable.\n * @evidence contracts/common.md#clear-and-simple-design One function with three length ranges and shared composers.\n * @evidence contracts/common.md#prohibited-implementation-shortcuts The forms are those of the address grammar.\n * @evidence contracts/common.md#meaningful-documentation Inline comments explain the three forms.\n */\nexport const _randomFormatIpv6 = (props?: _ILengthProps): string => {\n  if (props?.minLength === undefined && props?.maxLength === undefined)\n    return new Array(GROUPS).fill(0).map(random).join(\":\");\n  const length: number = _randomLengthPick(\n    _randomLengthWindow(props, {\n      minimum: SHORTEST,\n      maximum: LONGEST,\n      spread: 12,\n    }),\n  );\n  // `::` alone is the all-zero address, and the three forms below cover every\n  // length between it and the padded IPv4-suffixed address: a compressed prefix\n  // for the short ones, eight groups of one to four hexadecimal digits for the\n  // middle, and six groups plus a dotted-quad tail for the long ones.\n  if (length === SHORTEST) return \"::\";\n  if (length < GROUPS * DIGITS_MIN + COLONS) {\n    // `::` plus `count` groups spends one colon between each pair.\n    const count: number = Math.ceil((length - 1) / (DIGITS_MAX + 1));\n    return `::${compose(length - 1 - count, count)}`;\n  }\n  if (length <= GROUPS * DIGITS_MAX + COLONS)\n    return compose(length - COLONS, GROUPS);\n  // The dotted-quad tail is drawn at its longest so the six leading groups keep\n  // a composable number of digits.\n  const tail: string = _randomFormatIpv4({\n    minLength: IPV4_MAX,\n    maxLength: IPV4_MAX,\n  });\n  return `${compose(length - IPV4_MAX - EMBEDDED, EMBEDDED)}:${tail}`;\n};\n\nconst GROUPS = 8;\nconst COLONS = GROUPS - 1;\nconst DIGITS_MIN = 1;\nconst DIGITS_MAX = 4;\nconst EMBEDDED = 6; // groups preceding a dotted-quad tail\nconst IPV4_MAX = \"255.255.255.255\".length;\nconst SHORTEST = \"::\".length;\nconst LONGEST = EMBEDDED * DIGITS_MAX + EMBEDDED + IPV4_MAX;\n\nconst compose = (digits: number, count: number): string =>\n  __randomComposition({\n    total: digits,\n    count,\n    minimum: DIGITS_MIN,\n    maximum: DIGITS_MAX,\n  })\n    .map(group)\n    .join(\":\");\n\nconst random = () =>\n  _randomInteger({\n    type: \"integer\",\n    minimum: 0,\n    maximum: 65_535,\n  }).toString(16);\n\nconst group = (digits: number): string => {\n  let text: string = \"\";\n  for (let i: number = 0; i < digits; ++i)\n    text += _randomInteger({\n      type: \"integer\",\n      minimum: 0,\n      maximum: 15,\n    }).toString(16);\n  return text;\n};\n"],"mappings":";;;;;;;;;;;;;AAiBA,MAAa,qBAAqB,UAAkC;CAClE,IAAI,OAAO,cAAc,KAAA,KAAa,OAAO,cAAc,KAAA,GACzD,OAAO,IAAI,MAAM,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,GAAG;CACvD,MAAM,SAAiB,kBACrB,oBAAoB,OAAO;EACzB,SAAS;EACT,SAAS;EACT,QAAQ;CACV,CAAC,CACH;CAKA,IAAI,WAAW,UAAU,OAAO;CAChC,IAAI,SAAS,SAAS,aAAa,QAAQ;EAEzC,MAAM,QAAgB,KAAK,MAAM,SAAS,MAAM,aAAa,EAAE;EAC/D,OAAO,KAAK,QAAQ,SAAS,IAAI,OAAO,KAAK;CAC/C;CACA,IAAI,UAAU,SAAS,aAAa,QAClC,OAAO,QAAQ,SAAS,QAAQ,MAAM;CAGxC,MAAM,OAAe,kBAAkB;EACrC,WAAW;EACX,WAAW;CACb,CAAC;CACD,OAAO,GAAG,QAAQ,SAAS,WAAW,UAAU,QAAQ,EAAE,GAAG;AAC/D;AAEA,MAAM,SAAS;AACf,MAAM,SAAS,SAAS;AACxB,MAAM,aAAa;AACnB,MAAM,aAAa;AACnB,MAAM,WAAW;AACjB,MAAM,WAAW;AACjB,MAAM,WAAW;AACjB,MAAM,UAAU;AAEhB,MAAM,WAAW,QAAgB,UAC/B,oBAAoB;CAClB,OAAO;CACP;CACA,SAAS;CACT,SAAS;AACX,CAAC,CAAC,CACC,IAAI,KAAK,CAAC,CACV,KAAK,GAAG;AAEb,MAAM,eACJ,eAAe;CACb,MAAM;CACN,SAAS;CACT,SAAS;AACX,CAAC,CAAC,CAAC,SAAS,EAAE;AAEhB,MAAM,SAAS,WAA2B;CACxC,IAAI,OAAe;CACnB,KAAK,IAAI,IAAY,GAAG,IAAI,QAAQ,EAAE,GACpC,QAAQ,eAAe;EACrB,MAAM;EACN,SAAS;EACT,SAAS;CACX,CAAC,CAAC,CAAC,SAAS,EAAE;CAChB,OAAO;AACT"}

package/lib/internal/_randomFormatIri.d.ts

@@ -1,2 +1,13 @@
 import { _ILengthProps } from "./_randomStringLength";
+/**
+ * Generate an IRI from the ASCII HTTPS URL subset.
+ *
+ * The URI syntax is also valid IRI syntax. {@link _randomFormatUrl} owns the
+ * length bounds and throws when they exclude its shortest 12-character form.
+ *
+ * @evidence contracts/common.md#principled-implementation An absolute URL is also a valid IRI, so the generator reuses the URL builder and its length handling.
+ * @evidence contracts/common.md#clear-and-simple-design One delegation.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It does not generate non-ASCII characters.
+ * @evidence contracts/common.md#meaningful-documentation Native prose distinguishes the sampled ASCII HTTPS subset from the full IRI grammar and identifies the delegated length floor/failure.
+ */
 export declare const _randomFormatIri: (props?: _ILengthProps) => string;

package/lib/internal/_randomFormatIri.js

@@ -2,6 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._randomFormatIri = void 0;
 const _randomFormatUrl_1 = require("./_randomFormatUrl");
+/**
+ * Generate an IRI from the ASCII HTTPS URL subset.
+ *
+ * The URI syntax is also valid IRI syntax. {@link _randomFormatUrl} owns the
+ * length bounds and throws when they exclude its shortest 12-character form.
+ *
+ * @evidence contracts/common.md#principled-implementation An absolute URL is also a valid IRI, so the generator reuses the URL builder and its length handling.
+ * @evidence contracts/common.md#clear-and-simple-design One delegation.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It does not generate non-ASCII characters.
+ * @evidence contracts/common.md#meaningful-documentation Native prose distinguishes the sampled ASCII HTTPS subset from the full IRI grammar and identifies the delegated length floor/failure.
+ */
 const _randomFormatIri = (props) => (0, _randomFormatUrl_1._randomFormatUrl)(props);
 exports._randomFormatIri = _randomFormatIri;
 //# sourceMappingURL=_randomFormatIri.js.map

package/lib/internal/_randomFormatIri.js.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatIri.js","sourceRoot":"","sources":["../../src/internal/_randomFormatIri.ts"],"names":[],"mappings":";;;AAAA,yDAAsD;AAG/C,MAAM,gBAAgB,GAAG,CAAC,KAAqB,EAAU,EAAE,CAChE,IAAA,mCAAgB,EAAC,KAAK,CAAC,CAAC;AADb,QAAA,gBAAgB,GAAhB,gBAAgB,CACH"}
+{"version":3,"file":"_randomFormatIri.js","sourceRoot":"","sources":["../../src/internal/_randomFormatIri.ts"],"names":[],"mappings":";;;AAAA,yDAAsD;AAGtD;;;;;;;;;;GAUG;AACI,MAAM,gBAAgB,GAAG,CAAC,KAAqB,EAAU,EAAE,CAChE,IAAA,mCAAgB,EAAC,KAAK,CAAC,CAAC;AADb,QAAA,gBAAgB,GAAhB,gBAAgB,CACH"}

package/lib/internal/_randomFormatIri.mjs

@@ -1,5 +1,16 @@
 import { _randomFormatUrl } from "./_randomFormatUrl.mjs";
 //#region src/internal/_randomFormatIri.ts
+/**
+* Generate an IRI from the ASCII HTTPS URL subset.
+*
+* The URI syntax is also valid IRI syntax. {@link _randomFormatUrl} owns the
+* length bounds and throws when they exclude its shortest 12-character form.
+*
+* @evidence contracts/common.md#principled-implementation An absolute URL is also a valid IRI, so the generator reuses the URL builder and its length handling.
+* @evidence contracts/common.md#clear-and-simple-design One delegation.
+* @evidence contracts/common.md#prohibited-implementation-shortcuts It does not generate non-ASCII characters.
+* @evidence contracts/common.md#meaningful-documentation Native prose distinguishes the sampled ASCII HTTPS subset from the full IRI grammar and identifies the delegated length floor/failure.
+*/
 const _randomFormatIri = (props) => _randomFormatUrl(props);
 //#endregion
 export { _randomFormatIri };

package/lib/internal/_randomFormatIri.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatIri.mjs","names":[],"sources":["../../src/internal/_randomFormatIri.ts"],"sourcesContent":["import { _randomFormatUrl } from \"./_randomFormatUrl\";\nimport { _ILengthProps } from \"./_randomStringLength\";\n\nexport const _randomFormatIri = (props?: _ILengthProps): string =>\n  _randomFormatUrl(props);\n"],"mappings":";;AAGA,MAAa,oBAAoB,UAC/B,iBAAiB,KAAK"}
+{"version":3,"file":"_randomFormatIri.mjs","names":[],"sources":["../../src/internal/_randomFormatIri.ts"],"sourcesContent":["import { _randomFormatUrl } from \"./_randomFormatUrl\";\nimport { _ILengthProps } from \"./_randomStringLength\";\n\n/**\n * Generate an IRI from the ASCII HTTPS URL subset.\n *\n * The URI syntax is also valid IRI syntax. {@link _randomFormatUrl} owns the\n * length bounds and throws when they exclude its shortest 12-character form.\n *\n * @evidence contracts/common.md#principled-implementation An absolute URL is also a valid IRI, so the generator reuses the URL builder and its length handling.\n * @evidence contracts/common.md#clear-and-simple-design One delegation.\n * @evidence contracts/common.md#prohibited-implementation-shortcuts It does not generate non-ASCII characters.\n * @evidence contracts/common.md#meaningful-documentation Native prose distinguishes the sampled ASCII HTTPS subset from the full IRI grammar and identifies the delegated length floor/failure.\n */\nexport const _randomFormatIri = (props?: _ILengthProps): string =>\n  _randomFormatUrl(props);\n"],"mappings":";;;;;;;;;;;;;AAcA,MAAa,oBAAoB,UAC/B,iBAAiB,KAAK"}

package/lib/internal/_randomFormatIriReference.d.ts

@@ -1,2 +1,14 @@
 import { _ILengthProps } from "./_randomStringLength";
+/**
+ * Generate an IRI reference from the ASCII absolute HTTPS URL subset.
+ *
+ * {@link _randomFormatUrl} owns the length bounds and throws when they exclude
+ * its shortest 12-character form. Relative references are valid members of the
+ * format but are outside this generator's sample shapes.
+ *
+ * @evidence contracts/common.md#principled-implementation An absolute IRI is also a valid IRI reference, so the generator reuses the URL builder.
+ * @evidence contracts/common.md#clear-and-simple-design One delegation.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It does not generate relative references.
+ * @evidence contracts/common.md#meaningful-documentation Native prose identifies the absolute ASCII HTTPS sample, the unsampled relative forms and the delegated length floor/failure.
+ */
 export declare const _randomFormatIriReference: (props?: _ILengthProps) => string;

package/lib/internal/_randomFormatIriReference.js

@@ -2,6 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._randomFormatIriReference = void 0;
 const _randomFormatUrl_1 = require("./_randomFormatUrl");
+/**
+ * Generate an IRI reference from the ASCII absolute HTTPS URL subset.
+ *
+ * {@link _randomFormatUrl} owns the length bounds and throws when they exclude
+ * its shortest 12-character form. Relative references are valid members of the
+ * format but are outside this generator's sample shapes.
+ *
+ * @evidence contracts/common.md#principled-implementation An absolute IRI is also a valid IRI reference, so the generator reuses the URL builder.
+ * @evidence contracts/common.md#clear-and-simple-design One delegation.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It does not generate relative references.
+ * @evidence contracts/common.md#meaningful-documentation Native prose identifies the absolute ASCII HTTPS sample, the unsampled relative forms and the delegated length floor/failure.
+ */
 const _randomFormatIriReference = (props) => (0, _randomFormatUrl_1._randomFormatUrl)(props);
 exports._randomFormatIriReference = _randomFormatIriReference;
 //# sourceMappingURL=_randomFormatIriReference.js.map

package/lib/internal/_randomFormatIriReference.js.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatIriReference.js","sourceRoot":"","sources":["../../src/internal/_randomFormatIriReference.ts"],"names":[],"mappings":";;;AAAA,yDAAsD;AAG/C,MAAM,yBAAyB,GAAG,CAAC,KAAqB,EAAU,EAAE,CACzE,IAAA,mCAAgB,EAAC,KAAK,CAAC,CAAC;AADb,QAAA,yBAAyB,GAAzB,yBAAyB,CACZ"}
+{"version":3,"file":"_randomFormatIriReference.js","sourceRoot":"","sources":["../../src/internal/_randomFormatIriReference.ts"],"names":[],"mappings":";;;AAAA,yDAAsD;AAGtD;;;;;;;;;;;GAWG;AACI,MAAM,yBAAyB,GAAG,CAAC,KAAqB,EAAU,EAAE,CACzE,IAAA,mCAAgB,EAAC,KAAK,CAAC,CAAC;AADb,QAAA,yBAAyB,GAAzB,yBAAyB,CACZ"}

package/lib/internal/_randomFormatIriReference.mjs

@@ -1,5 +1,17 @@
 import { _randomFormatUrl } from "./_randomFormatUrl.mjs";
 //#region src/internal/_randomFormatIriReference.ts
+/**
+* Generate an IRI reference from the ASCII absolute HTTPS URL subset.
+*
+* {@link _randomFormatUrl} owns the length bounds and throws when they exclude
+* its shortest 12-character form. Relative references are valid members of the
+* format but are outside this generator's sample shapes.
+*
+* @evidence contracts/common.md#principled-implementation An absolute IRI is also a valid IRI reference, so the generator reuses the URL builder.
+* @evidence contracts/common.md#clear-and-simple-design One delegation.
+* @evidence contracts/common.md#prohibited-implementation-shortcuts It does not generate relative references.
+* @evidence contracts/common.md#meaningful-documentation Native prose identifies the absolute ASCII HTTPS sample, the unsampled relative forms and the delegated length floor/failure.
+*/
 const _randomFormatIriReference = (props) => _randomFormatUrl(props);
 //#endregion
 export { _randomFormatIriReference };

package/lib/internal/_randomFormatIriReference.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatIriReference.mjs","names":[],"sources":["../../src/internal/_randomFormatIriReference.ts"],"sourcesContent":["import { _randomFormatUrl } from \"./_randomFormatUrl\";\nimport { _ILengthProps } from \"./_randomStringLength\";\n\nexport const _randomFormatIriReference = (props?: _ILengthProps): string =>\n  _randomFormatUrl(props);\n"],"mappings":";;AAGA,MAAa,6BAA6B,UACxC,iBAAiB,KAAK"}
+{"version":3,"file":"_randomFormatIriReference.mjs","names":[],"sources":["../../src/internal/_randomFormatIriReference.ts"],"sourcesContent":["import { _randomFormatUrl } from \"./_randomFormatUrl\";\nimport { _ILengthProps } from \"./_randomStringLength\";\n\n/**\n * Generate an IRI reference from the ASCII absolute HTTPS URL subset.\n *\n * {@link _randomFormatUrl} owns the length bounds and throws when they exclude\n * its shortest 12-character form. Relative references are valid members of the\n * format but are outside this generator's sample shapes.\n *\n * @evidence contracts/common.md#principled-implementation An absolute IRI is also a valid IRI reference, so the generator reuses the URL builder.\n * @evidence contracts/common.md#clear-and-simple-design One delegation.\n * @evidence contracts/common.md#prohibited-implementation-shortcuts It does not generate relative references.\n * @evidence contracts/common.md#meaningful-documentation Native prose identifies the absolute ASCII HTTPS sample, the unsampled relative forms and the delegated length floor/failure.\n */\nexport const _randomFormatIriReference = (props?: _ILengthProps): string =>\n  _randomFormatUrl(props);\n"],"mappings":";;;;;;;;;;;;;;AAeA,MAAa,6BAA6B,UACxC,iBAAiB,KAAK"}

package/lib/internal/_randomFormatJsonPointer.d.ts

@@ -1,2 +1,14 @@
 import { _ILengthProps } from "./_randomStringLength";
+/**
+ * Generate a JSON pointer at a length the bounds allow.
+ *
+ * Uses `/components/schemas/` when the length ceiling allows it, otherwise a
+ * single-token or empty pointer. Bounds are inclusive code-point lengths; an
+ * empty allowed window throws. All sampled tokens are lowercase ASCII.
+ *
+ * @evidence contracts/common.md#principled-implementation An unconstrained draw is a fixed components prefix followed by a random token; a constrained one lets the token absorb the length, and below the prefix length it produces the empty pointer or a single `/`-token, which are both valid pointers.
+ * @evidence contracts/common.md#clear-and-simple-design One function over the segment helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The shapes are the grammar's.
+ * @evidence contracts/common.md#meaningful-documentation Native prose states the sampled token alphabet, prefix versus short-form policy, inclusive code-point bounds and failure; inline comments explain the empty pointer.
+ */
 export declare const _randomFormatJsonPointer: (props?: _ILengthProps) => string;

package/lib/internal/_randomFormatJsonPointer.js

@@ -3,6 +3,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports._randomFormatJsonPointer = void 0;
 const _randomString_1 = require("./_randomString");
 const _randomStringLength_1 = require("./_randomStringLength");
+/**
+ * Generate a JSON pointer at a length the bounds allow.
+ *
+ * Uses `/components/schemas/` when the length ceiling allows it, otherwise a
+ * single-token or empty pointer. Bounds are inclusive code-point lengths; an
+ * empty allowed window throws. All sampled tokens are lowercase ASCII.
+ *
+ * @evidence contracts/common.md#principled-implementation An unconstrained draw is a fixed components prefix followed by a random token; a constrained one lets the token absorb the length, and below the prefix length it produces the empty pointer or a single `/`-token, which are both valid pointers.
+ * @evidence contracts/common.md#clear-and-simple-design One function over the segment helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The shapes are the grammar's.
+ * @evidence contracts/common.md#meaningful-documentation Native prose states the sampled token alphabet, prefix versus short-form policy, inclusive code-point bounds and failure; inline comments explain the empty pointer.
+ */
 const _randomFormatJsonPointer = (props) => {
     if ((props === null || props === void 0 ? void 0 : props.minLength) === undefined && (props === null || props === void 0 ? void 0 : props.maxLength) === undefined)
         return `${PREFIX}${random()}`;

package/lib/internal/_randomFormatJsonPointer.js.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatJsonPointer.js","sourceRoot":"","sources":["../../src/internal/_randomFormatJsonPointer.ts"],"names":[],"mappings":";;;AAAA,mDAAgD;AAChD,+DAK+B;AAExB,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,GAAG,MAAM,EAAE,EAAE,CAAC;IAChC,6EAA6E;IAC7E,yDAAyD;IACzD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM;QACnE,OAAO,GAAG,MAAM,GAAG,IAAA,0CAAoB,EAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;IACzE,4EAA4E;IAC5E,uEAAuE;IACvE,MAAM,MAAM,GAAW,IAAA,uCAAiB,EACtC,IAAA,yCAAmB,EAAC,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CACtD,CAAC;IACF,OAAO,MAAM,KAAK,CAAC;QACjB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,IAAI,IAAA,6BAAa,EAAC;YAChB,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,MAAM,GAAG,CAAC;YACrB,SAAS,EAAE,MAAM,GAAG,CAAC;SACtB,CAAC,EAAE,CAAC;AACX,CAAC,CAAC;AAnBW,QAAA,wBAAwB,GAAxB,wBAAwB,CAmBnC;AAEF,MAAM,MAAM,GAAG,sBAAsB,CAAC;AAEtC,MAAM,MAAM,GAAG,GAAG,EAAE,CAClB,IAAA,6BAAa,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC"}
+{"version":3,"file":"_randomFormatJsonPointer.js","sourceRoot":"","sources":["../../src/internal/_randomFormatJsonPointer.ts"],"names":[],"mappings":";;;AAAA,mDAAgD;AAChD,+DAK+B;AAE/B;;;;;;;;;;;GAWG;AACI,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,GAAG,MAAM,EAAE,EAAE,CAAC;IAChC,6EAA6E;IAC7E,yDAAyD;IACzD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM;QACnE,OAAO,GAAG,MAAM,GAAG,IAAA,0CAAoB,EAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;IACzE,4EAA4E;IAC5E,uEAAuE;IACvE,MAAM,MAAM,GAAW,IAAA,uCAAiB,EACtC,IAAA,yCAAmB,EAAC,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CACtD,CAAC;IACF,OAAO,MAAM,KAAK,CAAC;QACjB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,IAAI,IAAA,6BAAa,EAAC;YAChB,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,MAAM,GAAG,CAAC;YACrB,SAAS,EAAE,MAAM,GAAG,CAAC;SACtB,CAAC,EAAE,CAAC;AACX,CAAC,CAAC;AAnBW,QAAA,wBAAwB,GAAxB,wBAAwB,CAmBnC;AAEF,MAAM,MAAM,GAAG,sBAAsB,CAAC;AAEtC,MAAM,MAAM,GAAG,GAAG,EAAE,CAClB,IAAA,6BAAa,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC"}

package/lib/internal/_randomFormatJsonPointer.mjs

@@ -1,6 +1,18 @@
 import { _randomString } from "./_randomString.mjs";
 import { _randomLengthPick, _randomLengthWindow, _randomSegmentLength } from "./_randomStringLength.mjs";
 //#region src/internal/_randomFormatJsonPointer.ts
+/**
+* Generate a JSON pointer at a length the bounds allow.
+*
+* Uses `/components/schemas/` when the length ceiling allows it, otherwise a
+* single-token or empty pointer. Bounds are inclusive code-point lengths; an
+* empty allowed window throws. All sampled tokens are lowercase ASCII.
+*
+* @evidence contracts/common.md#principled-implementation An unconstrained draw is a fixed components prefix followed by a random token; a constrained one lets the token absorb the length, and below the prefix length it produces the empty pointer or a single `/`-token, which are both valid pointers.
+* @evidence contracts/common.md#clear-and-simple-design One function over the segment helpers.
+* @evidence contracts/common.md#prohibited-implementation-shortcuts The shapes are the grammar's.
+* @evidence contracts/common.md#meaningful-documentation Native prose states the sampled token alphabet, prefix versus short-form policy, inclusive code-point bounds and failure; inline comments explain the empty pointer.
+*/
 const _randomFormatJsonPointer = (props) => {
 	if (props?.minLength === void 0 && props?.maxLength === void 0) return `${PREFIX}${random()}`;
 	if (props.maxLength === void 0 || props.maxLength >= PREFIX.length) return `${PREFIX}${_randomSegmentLength(props, PREFIX.length, 10, 0)}`;

package/lib/internal/_randomFormatJsonPointer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatJsonPointer.mjs","names":[],"sources":["../../src/internal/_randomFormatJsonPointer.ts"],"sourcesContent":["import { _randomString } from \"./_randomString\";\nimport {\n  _ILengthProps,\n  _randomLengthPick,\n  _randomLengthWindow,\n  _randomSegmentLength,\n} from \"./_randomStringLength\";\n\nexport const _randomFormatJsonPointer = (props?: _ILengthProps): string => {\n  if (props?.minLength === undefined && props?.maxLength === undefined)\n    return `${PREFIX}${random()}`;\n  // The `/components/schemas/` prefix (20 chars) is fixed; the reference token\n  // after it grows or shrinks to hit the requested length.\n  if (props.maxLength === undefined || props.maxLength >= PREFIX.length)\n    return `${PREFIX}${_randomSegmentLength(props, PREFIX.length, 10, 0)}`;\n  // Below that prefix a pointer still exists: the empty pointer addresses the\n  // whole document, and one `/`-prefixed token addresses a member of it.\n  const length: number = _randomLengthPick(\n    _randomLengthWindow(props, { minimum: 0, spread: 6 }),\n  );\n  return length === 0\n    ? \"\"\n    : `/${_randomString({\n        type: \"string\",\n        minLength: length - 1,\n        maxLength: length - 1,\n      })}`;\n};\n\nconst PREFIX = \"/components/schemas/\";\n\nconst random = () =>\n  _randomString({ type: \"string\", minLength: 10, maxLength: 10 });\n"],"mappings":";;;AAQA,MAAa,4BAA4B,UAAkC;CACzE,IAAI,OAAO,cAAc,KAAA,KAAa,OAAO,cAAc,KAAA,GACzD,OAAO,GAAG,SAAS,OAAO;CAG5B,IAAI,MAAM,cAAc,KAAA,KAAa,MAAM,aAAa,OAAO,QAC7D,OAAO,GAAG,SAAS,qBAAqB,OAAO,OAAO,QAAQ,IAAI,CAAC;CAGrE,MAAM,SAAiB,kBACrB,oBAAoB,OAAO;EAAE,SAAS;EAAG,QAAQ;CAAE,CAAC,CACtD;CACA,OAAO,WAAW,IACd,KACA,IAAI,cAAc;EAChB,MAAM;EACN,WAAW,SAAS;EACpB,WAAW,SAAS;CACtB,CAAC;AACP;AAEA,MAAM,SAAS;AAEf,MAAM,eACJ,cAAc;CAAE,MAAM;CAAU,WAAW;CAAI,WAAW;AAAG,CAAC"}
+{"version":3,"file":"_randomFormatJsonPointer.mjs","names":[],"sources":["../../src/internal/_randomFormatJsonPointer.ts"],"sourcesContent":["import { _randomString } from \"./_randomString\";\nimport {\n  _ILengthProps,\n  _randomLengthPick,\n  _randomLengthWindow,\n  _randomSegmentLength,\n} from \"./_randomStringLength\";\n\n/**\n * Generate a JSON pointer at a length the bounds allow.\n *\n * Uses `/components/schemas/` when the length ceiling allows it, otherwise a\n * single-token or empty pointer. Bounds are inclusive code-point lengths; an\n * empty allowed window throws. All sampled tokens are lowercase ASCII.\n *\n * @evidence contracts/common.md#principled-implementation An unconstrained draw is a fixed components prefix followed by a random token; a constrained one lets the token absorb the length, and below the prefix length it produces the empty pointer or a single `/`-token, which are both valid pointers.\n * @evidence contracts/common.md#clear-and-simple-design One function over the segment helpers.\n * @evidence contracts/common.md#prohibited-implementation-shortcuts The shapes are the grammar's.\n * @evidence contracts/common.md#meaningful-documentation Native prose states the sampled token alphabet, prefix versus short-form policy, inclusive code-point bounds and failure; inline comments explain the empty pointer.\n */\nexport const _randomFormatJsonPointer = (props?: _ILengthProps): string => {\n  if (props?.minLength === undefined && props?.maxLength === undefined)\n    return `${PREFIX}${random()}`;\n  // The `/components/schemas/` prefix (20 chars) is fixed; the reference token\n  // after it grows or shrinks to hit the requested length.\n  if (props.maxLength === undefined || props.maxLength >= PREFIX.length)\n    return `${PREFIX}${_randomSegmentLength(props, PREFIX.length, 10, 0)}`;\n  // Below that prefix a pointer still exists: the empty pointer addresses the\n  // whole document, and one `/`-prefixed token addresses a member of it.\n  const length: number = _randomLengthPick(\n    _randomLengthWindow(props, { minimum: 0, spread: 6 }),\n  );\n  return length === 0\n    ? \"\"\n    : `/${_randomString({\n        type: \"string\",\n        minLength: length - 1,\n        maxLength: length - 1,\n      })}`;\n};\n\nconst PREFIX = \"/components/schemas/\";\n\nconst random = () =>\n  _randomString({ type: \"string\", minLength: 10, maxLength: 10 });\n"],"mappings":";;;;;;;;;;;;;;;AAoBA,MAAa,4BAA4B,UAAkC;CACzE,IAAI,OAAO,cAAc,KAAA,KAAa,OAAO,cAAc,KAAA,GACzD,OAAO,GAAG,SAAS,OAAO;CAG5B,IAAI,MAAM,cAAc,KAAA,KAAa,MAAM,aAAa,OAAO,QAC7D,OAAO,GAAG,SAAS,qBAAqB,OAAO,OAAO,QAAQ,IAAI,CAAC;CAGrE,MAAM,SAAiB,kBACrB,oBAAoB,OAAO;EAAE,SAAS;EAAG,QAAQ;CAAE,CAAC,CACtD;CACA,OAAO,WAAW,IACd,KACA,IAAI,cAAc;EAChB,MAAM;EACN,WAAW,SAAS;EACpB,WAAW,SAAS;CACtB,CAAC;AACP;AAEA,MAAM,SAAS;AAEf,MAAM,eACJ,cAAc;CAAE,MAAM;CAAU,WAAW;CAAI,WAAW;AAAG,CAAC"}

package/lib/internal/_randomFormatPassword.d.ts

@@ -1,2 +1,15 @@
 import { _ILengthProps } from "./_randomStringLength";
+/**
+ * Generate a password, which is any string within the bounds.
+ *
+ * Produces lowercase sample data for the documentation-only password format.
+ * This helper uses the platform's Math.random source, without a password
+ * strength or cryptographic randomness contract. Inclusive code-point bounds
+ * are forwarded to the string generator; the default length is four to 16.
+ *
+ * @evidence contracts/common.md#principled-implementation The password format has no grammar, so any string within the bounds is valid; the generator draws a random lowercase string of four to sixteen characters unless a bound is given.
+ * @evidence contracts/common.md#clear-and-simple-design One expression over the string generator.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The format is documentation-only.
+ * @evidence contracts/common.md#meaningful-documentation Native prose states the sample alphabet/default length, forwarded code-point bounds and absence of strength or cryptographic randomness guarantees.
+ */
 export declare const _randomFormatPassword: (props?: _ILengthProps) => string;

package/lib/internal/_randomFormatPassword.js

@@ -2,6 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._randomFormatPassword = void 0;
 const _randomString_1 = require("./_randomString");
+/**
+ * Generate a password, which is any string within the bounds.
+ *
+ * Produces lowercase sample data for the documentation-only password format.
+ * This helper uses the platform's Math.random source, without a password
+ * strength or cryptographic randomness contract. Inclusive code-point bounds
+ * are forwarded to the string generator; the default length is four to 16.
+ *
+ * @evidence contracts/common.md#principled-implementation The password format has no grammar, so any string within the bounds is valid; the generator draws a random lowercase string of four to sixteen characters unless a bound is given.
+ * @evidence contracts/common.md#clear-and-simple-design One expression over the string generator.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The format is documentation-only.
+ * @evidence contracts/common.md#meaningful-documentation Native prose states the sample alphabet/default length, forwarded code-point bounds and absence of strength or cryptographic randomness guarantees.
+ */
 const _randomFormatPassword = (props) => (0, _randomString_1._randomString)((props === null || props === void 0 ? void 0 : props.minLength) === undefined && (props === null || props === void 0 ? void 0 : props.maxLength) === undefined
     ? { type: "string", minLength: 4, maxLength: 16 }
     : {

package/lib/internal/_randomFormatPassword.js.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatPassword.js","sourceRoot":"","sources":["../../src/internal/_randomFormatPassword.ts"],"names":[],"mappings":";;;AAAA,mDAAgD;AAGzC,MAAM,qBAAqB,GAAG,CAAC,KAAqB,EAAU,EAAE,CACrE,IAAA,6BAAa,EACX,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS;IAC9D,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE;IACjD,CAAC,CAAC;QACE,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS;QAC3B,SAAS,EAAE,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS;KAC5B,CACN,CAAC;AATS,QAAA,qBAAqB,GAArB,qBAAqB,CAS9B"}
+{"version":3,"file":"_randomFormatPassword.js","sourceRoot":"","sources":["../../src/internal/_randomFormatPassword.ts"],"names":[],"mappings":";;;AAAA,mDAAgD;AAGhD;;;;;;;;;;;;GAYG;AACI,MAAM,qBAAqB,GAAG,CAAC,KAAqB,EAAU,EAAE,CACrE,IAAA,6BAAa,EACX,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS;IAC9D,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE;IACjD,CAAC,CAAC;QACE,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS;QAC3B,SAAS,EAAE,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS;KAC5B,CACN,CAAC;AATS,QAAA,qBAAqB,GAArB,qBAAqB,CAS9B"}

package/lib/internal/_randomFormatPassword.mjs

@@ -1,5 +1,18 @@
 import { _randomString } from "./_randomString.mjs";
 //#region src/internal/_randomFormatPassword.ts
+/**
+* Generate a password, which is any string within the bounds.
+*
+* Produces lowercase sample data for the documentation-only password format.
+* This helper uses the platform's Math.random source, without a password
+* strength or cryptographic randomness contract. Inclusive code-point bounds
+* are forwarded to the string generator; the default length is four to 16.
+*
+* @evidence contracts/common.md#principled-implementation The password format has no grammar, so any string within the bounds is valid; the generator draws a random lowercase string of four to sixteen characters unless a bound is given.
+* @evidence contracts/common.md#clear-and-simple-design One expression over the string generator.
+* @evidence contracts/common.md#prohibited-implementation-shortcuts The format is documentation-only.
+* @evidence contracts/common.md#meaningful-documentation Native prose states the sample alphabet/default length, forwarded code-point bounds and absence of strength or cryptographic randomness guarantees.
+*/
 const _randomFormatPassword = (props) => _randomString(props?.minLength === void 0 && props?.maxLength === void 0 ? {
 	type: "string",
 	minLength: 4,

package/lib/internal/_randomFormatPassword.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatPassword.mjs","names":[],"sources":["../../src/internal/_randomFormatPassword.ts"],"sourcesContent":["import { _randomString } from \"./_randomString\";\nimport { _ILengthProps } from \"./_randomStringLength\";\n\nexport const _randomFormatPassword = (props?: _ILengthProps): string =>\n  _randomString(\n    props?.minLength === undefined && props?.maxLength === undefined\n      ? { type: \"string\", minLength: 4, maxLength: 16 }\n      : {\n          type: \"string\",\n          minLength: props?.minLength,\n          maxLength: props?.maxLength,\n        },\n  );\n"],"mappings":";;AAGA,MAAa,yBAAyB,UACpC,cACE,OAAO,cAAc,KAAA,KAAa,OAAO,cAAc,KAAA,IACnD;CAAE,MAAM;CAAU,WAAW;CAAG,WAAW;AAAG,IAC9C;CACE,MAAM;CACN,WAAW,OAAO;CAClB,WAAW,OAAO;AACpB,CACN"}
+{"version":3,"file":"_randomFormatPassword.mjs","names":[],"sources":["../../src/internal/_randomFormatPassword.ts"],"sourcesContent":["import { _randomString } from \"./_randomString\";\nimport { _ILengthProps } from \"./_randomStringLength\";\n\n/**\n * Generate a password, which is any string within the bounds.\n *\n * Produces lowercase sample data for the documentation-only password format.\n * This helper uses the platform's Math.random source, without a password\n * strength or cryptographic randomness contract. Inclusive code-point bounds\n * are forwarded to the string generator; the default length is four to 16.\n *\n * @evidence contracts/common.md#principled-implementation The password format has no grammar, so any string within the bounds is valid; the generator draws a random lowercase string of four to sixteen characters unless a bound is given.\n * @evidence contracts/common.md#clear-and-simple-design One expression over the string generator.\n * @evidence contracts/common.md#prohibited-implementation-shortcuts The format is documentation-only.\n * @evidence contracts/common.md#meaningful-documentation Native prose states the sample alphabet/default length, forwarded code-point bounds and absence of strength or cryptographic randomness guarantees.\n */\nexport const _randomFormatPassword = (props?: _ILengthProps): string =>\n  _randomString(\n    props?.minLength === undefined && props?.maxLength === undefined\n      ? { type: \"string\", minLength: 4, maxLength: 16 }\n      : {\n          type: \"string\",\n          minLength: props?.minLength,\n          maxLength: props?.maxLength,\n        },\n  );\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,MAAa,yBAAyB,UACpC,cACE,OAAO,cAAc,KAAA,KAAa,OAAO,cAAc,KAAA,IACnD;CAAE,MAAM;CAAU,WAAW;CAAG,WAAW;AAAG,IAC9C;CACE,MAAM;CACN,WAAW,OAAO;CAClB,WAAW,OAAO;AACpB,CACN"}

package/lib/internal/_randomFormatRegex.d.ts

@@ -1,2 +1,10 @@
 import { _ILengthProps } from "./_randomStringLength";
+/**
+ * Generate a regular expression source of literal characters.
+ *
+ * @evidence contracts/common.md#principled-implementation Every character the string generator emits is a literal in regular expression syntax, so a string of any length, including the empty one, compiles; an unconstrained draw is a plain random string and a constrained one fixes the length first.
+ * @evidence contracts/common.md#clear-and-simple-design One function.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The argument is reasoned from the alphabet.
+ * @evidence contracts/common.md#meaningful-documentation An inline comment explains the literal alphabet.
+ */
 export declare const _randomFormatRegex: (props?: _ILengthProps) => string;

package/lib/internal/_randomFormatRegex.js

@@ -3,6 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports._randomFormatRegex = void 0;
 const _randomString_1 = require("./_randomString");
 const _randomStringLength_1 = require("./_randomStringLength");
+/**
+ * Generate a regular expression source of literal characters.
+ *
+ * @evidence contracts/common.md#principled-implementation Every character the string generator emits is a literal in regular expression syntax, so a string of any length, including the empty one, compiles; an unconstrained draw is a plain random string and a constrained one fixes the length first.
+ * @evidence contracts/common.md#clear-and-simple-design One function.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The argument is reasoned from the alphabet.
+ * @evidence contracts/common.md#meaningful-documentation An inline comment explains the literal alphabet.
+ */
 const _randomFormatRegex = (props) => {
     // Every character `_randomString` emits is a literal in regular expression
     // syntax, so a source of any length — including the empty source `new

package/lib/internal/_randomFormatRegex.js.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatRegex.js","sourceRoot":"","sources":["../../src/internal/_randomFormatRegex.ts"],"names":[],"mappings":";;;AAAA,mDAAgD;AAChD,+DAI+B;AAExB,MAAM,kBAAkB,GAAG,CAAC,KAAqB,EAAU,EAAE;IAClE,2EAA2E;IAC3E,sEAAsE;IACtE,wEAAwE;IACxE,sEAAsE;IACtE,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS;QAClE,OAAO,IAAA,6BAAa,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAW,IAAA,uCAAiB,EACtC,IAAA,yCAAmB,EAAC,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CACvD,CAAC;IACF,OAAO,IAAA,6BAAa,EAAC;QACnB,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,MAAM;QACjB,SAAS,EAAE,MAAM;KAClB,CAAC,CAAC;AACL,CAAC,CAAC;AAfW,QAAA,kBAAkB,GAAlB,kBAAkB,CAe7B"}
+{"version":3,"file":"_randomFormatRegex.js","sourceRoot":"","sources":["../../src/internal/_randomFormatRegex.ts"],"names":[],"mappings":";;;AAAA,mDAAgD;AAChD,+DAI+B;AAE/B;;;;;;;GAOG;AACI,MAAM,kBAAkB,GAAG,CAAC,KAAqB,EAAU,EAAE;IAClE,2EAA2E;IAC3E,sEAAsE;IACtE,wEAAwE;IACxE,sEAAsE;IACtE,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,MAAK,SAAS;QAClE,OAAO,IAAA,6BAAa,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAW,IAAA,uCAAiB,EACtC,IAAA,yCAAmB,EAAC,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CACvD,CAAC;IACF,OAAO,IAAA,6BAAa,EAAC;QACnB,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,MAAM;QACjB,SAAS,EAAE,MAAM;KAClB,CAAC,CAAC;AACL,CAAC,CAAC;AAfW,QAAA,kBAAkB,GAAlB,kBAAkB,CAe7B"}

package/lib/internal/_randomFormatRegex.mjs

@@ -1,6 +1,14 @@
 import { _randomString } from "./_randomString.mjs";
 import { _randomLengthPick, _randomLengthWindow } from "./_randomStringLength.mjs";
 //#region src/internal/_randomFormatRegex.ts
+/**
+* Generate a regular expression source of literal characters.
+*
+* @evidence contracts/common.md#principled-implementation Every character the string generator emits is a literal in regular expression syntax, so a string of any length, including the empty one, compiles; an unconstrained draw is a plain random string and a constrained one fixes the length first.
+* @evidence contracts/common.md#clear-and-simple-design One function.
+* @evidence contracts/common.md#prohibited-implementation-shortcuts The argument is reasoned from the alphabet.
+* @evidence contracts/common.md#meaningful-documentation An inline comment explains the literal alphabet.
+*/
 const _randomFormatRegex = (props) => {
 	if (props?.minLength === void 0 && props?.maxLength === void 0) return _randomString({ type: "string" });
 	const length = _randomLengthPick(_randomLengthWindow(props, {

package/lib/internal/_randomFormatRegex.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatRegex.mjs","names":[],"sources":["../../src/internal/_randomFormatRegex.ts"],"sourcesContent":["import { _randomString } from \"./_randomString\";\nimport {\n  _ILengthProps,\n  _randomLengthPick,\n  _randomLengthWindow,\n} from \"./_randomStringLength\";\n\nexport const _randomFormatRegex = (props?: _ILengthProps): string => {\n  // Every character `_randomString` emits is a literal in regular expression\n  // syntax, so a source of any length — including the empty source `new\n  // RegExp(\"\")` accepts — compiles. An unconstrained draw is therefore an\n  // unconstrained string, and a constrained one fixes the length first.\n  if (props?.minLength === undefined && props?.maxLength === undefined)\n    return _randomString({ type: \"string\" });\n  const length: number = _randomLengthPick(\n    _randomLengthWindow(props, { minimum: 0, spread: 16 }),\n  );\n  return _randomString({\n    type: \"string\",\n    minLength: length,\n    maxLength: length,\n  });\n};\n"],"mappings":";;;AAOA,MAAa,sBAAsB,UAAkC;CAKnE,IAAI,OAAO,cAAc,KAAA,KAAa,OAAO,cAAc,KAAA,GACzD,OAAO,cAAc,EAAE,MAAM,SAAS,CAAC;CACzC,MAAM,SAAiB,kBACrB,oBAAoB,OAAO;EAAE,SAAS;EAAG,QAAQ;CAAG,CAAC,CACvD;CACA,OAAO,cAAc;EACnB,MAAM;EACN,WAAW;EACX,WAAW;CACb,CAAC;AACH"}
+{"version":3,"file":"_randomFormatRegex.mjs","names":[],"sources":["../../src/internal/_randomFormatRegex.ts"],"sourcesContent":["import { _randomString } from \"./_randomString\";\nimport {\n  _ILengthProps,\n  _randomLengthPick,\n  _randomLengthWindow,\n} from \"./_randomStringLength\";\n\n/**\n * Generate a regular expression source of literal characters.\n *\n * @evidence contracts/common.md#principled-implementation Every character the string generator emits is a literal in regular expression syntax, so a string of any length, including the empty one, compiles; an unconstrained draw is a plain random string and a constrained one fixes the length first.\n * @evidence contracts/common.md#clear-and-simple-design One function.\n * @evidence contracts/common.md#prohibited-implementation-shortcuts The argument is reasoned from the alphabet.\n * @evidence contracts/common.md#meaningful-documentation An inline comment explains the literal alphabet.\n */\nexport const _randomFormatRegex = (props?: _ILengthProps): string => {\n  // Every character `_randomString` emits is a literal in regular expression\n  // syntax, so a source of any length — including the empty source `new\n  // RegExp(\"\")` accepts — compiles. An unconstrained draw is therefore an\n  // unconstrained string, and a constrained one fixes the length first.\n  if (props?.minLength === undefined && props?.maxLength === undefined)\n    return _randomString({ type: \"string\" });\n  const length: number = _randomLengthPick(\n    _randomLengthWindow(props, { minimum: 0, spread: 16 }),\n  );\n  return _randomString({\n    type: \"string\",\n    minLength: length,\n    maxLength: length,\n  });\n};\n"],"mappings":";;;;;;;;;;;AAeA,MAAa,sBAAsB,UAAkC;CAKnE,IAAI,OAAO,cAAc,KAAA,KAAa,OAAO,cAAc,KAAA,GACzD,OAAO,cAAc,EAAE,MAAM,SAAS,CAAC;CACzC,MAAM,SAAiB,kBACrB,oBAAoB,OAAO;EAAE,SAAS;EAAG,QAAQ;CAAG,CAAC,CACvD;CACA,OAAO,cAAc;EACnB,MAAM;EACN,WAAW;EACX,WAAW;CACb,CAAC;AACH"}

package/lib/internal/_randomFormatRelativeJsonPointer.d.ts

@@ -1,2 +1,10 @@
 import { _ILengthProps } from "./_randomStringLength";
+/**
+ * Generate a relative JSON pointer at a length the bounds allow.
+ *
+ * @evidence contracts/common.md#principled-implementation A relative pointer is a leading integer and then a hash or a token, so a length of one is a digit, two is a digit and a hash and longer ones add a `/` token that absorbs the remainder.
+ * @evidence contracts/common.md#clear-and-simple-design One function over the digit and string helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The shapes are the grammar's.
+ * @evidence contracts/common.md#meaningful-documentation An inline comment explains the shortest forms.
+ */
 export declare const _randomFormatRelativeJsonPointer: (props?: _ILengthProps) => string;

package/lib/internal/_randomFormatRelativeJsonPointer.js

@@ -5,6 +5,14 @@ const _randomInteger_1 = require("./_randomInteger");
 const _randomString_1 = require("./_randomString");
 const _randomStringLength_1 = require("./_randomStringLength");
 const __randomComposition_1 = require("./private/__randomComposition");
+/**
+ * Generate a relative JSON pointer at a length the bounds allow.
+ *
+ * @evidence contracts/common.md#principled-implementation A relative pointer is a leading integer and then a hash or a token, so a length of one is a digit, two is a digit and a hash and longer ones add a `/` token that absorbs the remainder.
+ * @evidence contracts/common.md#clear-and-simple-design One function over the digit and string helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The shapes are the grammar's.
+ * @evidence contracts/common.md#meaningful-documentation An inline comment explains the shortest forms.
+ */
 const _randomFormatRelativeJsonPointer = (props) => {
     if ((props === null || props === void 0 ? void 0 : props.minLength) === undefined && (props === null || props === void 0 ? void 0 : props.maxLength) === undefined)
         return `${(0, _randomInteger_1._randomInteger)({ type: "integer", minimum: 0, maximum: 10 })}#`;

package/lib/internal/_randomFormatRelativeJsonPointer.js.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatRelativeJsonPointer.js","sourceRoot":"","sources":["../../src/internal/_randomFormatRelativeJsonPointer.ts"],"names":[],"mappings":";;;AAAA,qDAAkD;AAClD,mDAAgD;AAChD,+DAI+B;AAC/B,uEAAgE;AAEzD,MAAM,gCAAgC,GAAG,CAC9C,KAAqB,EACb,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,GAAG,IAAA,+BAAc,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC;IAC5E,0EAA0E;IAC1E,+EAA+E;IAC/E,gDAAgD;IAChD,MAAM,MAAM,GAAW,IAAA,uCAAiB,EACtC,IAAA,yCAAmB,EAAC,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CACtD,CAAC;IACF,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,IAAA,qCAAe,EAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,IAAA,qCAAe,EAAC,CAAC,CAAC,GAAG,CAAC;IAClD,OAAO,GAAG,IAAA,qCAAe,EAAC,CAAC,CAAC,IAAI,IAAA,6BAAa,EAAC;QAC5C,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,MAAM,GAAG,CAAC;QACrB,SAAS,EAAE,MAAM,GAAG,CAAC;KACtB,CAAC,EAAE,CAAC;AACP,CAAC,CAAC;AAlBW,QAAA,gCAAgC,GAAhC,gCAAgC,CAkB3C"}
+{"version":3,"file":"_randomFormatRelativeJsonPointer.js","sourceRoot":"","sources":["../../src/internal/_randomFormatRelativeJsonPointer.ts"],"names":[],"mappings":";;;AAAA,qDAAkD;AAClD,mDAAgD;AAChD,+DAI+B;AAC/B,uEAAgE;AAEhE;;;;;;;GAOG;AACI,MAAM,gCAAgC,GAAG,CAC9C,KAAqB,EACb,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,GAAG,IAAA,+BAAc,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC;IAC5E,0EAA0E;IAC1E,+EAA+E;IAC/E,gDAAgD;IAChD,MAAM,MAAM,GAAW,IAAA,uCAAiB,EACtC,IAAA,yCAAmB,EAAC,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CACtD,CAAC;IACF,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,IAAA,qCAAe,EAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,IAAA,qCAAe,EAAC,CAAC,CAAC,GAAG,CAAC;IAClD,OAAO,GAAG,IAAA,qCAAe,EAAC,CAAC,CAAC,IAAI,IAAA,6BAAa,EAAC;QAC5C,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,MAAM,GAAG,CAAC;QACrB,SAAS,EAAE,MAAM,GAAG,CAAC;KACtB,CAAC,EAAE,CAAC;AACP,CAAC,CAAC;AAlBW,QAAA,gCAAgC,GAAhC,gCAAgC,CAkB3C"}

package/lib/internal/_randomFormatRelativeJsonPointer.mjs

@@ -3,6 +3,14 @@ import { _randomString } from "./_randomString.mjs";
 import { _randomLengthPick, _randomLengthWindow } from "./_randomStringLength.mjs";
 import { __randomNumeric } from "./private/__randomComposition.mjs";
 //#region src/internal/_randomFormatRelativeJsonPointer.ts
+/**
+* Generate a relative JSON pointer at a length the bounds allow.
+*
+* @evidence contracts/common.md#principled-implementation A relative pointer is a leading integer and then a hash or a token, so a length of one is a digit, two is a digit and a hash and longer ones add a `/` token that absorbs the remainder.
+* @evidence contracts/common.md#clear-and-simple-design One function over the digit and string helpers.
+* @evidence contracts/common.md#prohibited-implementation-shortcuts The shapes are the grammar's.
+* @evidence contracts/common.md#meaningful-documentation An inline comment explains the shortest forms.
+*/
 const _randomFormatRelativeJsonPointer = (props) => {
 	if (props?.minLength === void 0 && props?.maxLength === void 0) return `${_randomInteger({
 		type: "integer",

package/lib/internal/_randomFormatRelativeJsonPointer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"_randomFormatRelativeJsonPointer.mjs","names":[],"sources":["../../src/internal/_randomFormatRelativeJsonPointer.ts"],"sourcesContent":["import { _randomInteger } from \"./_randomInteger\";\nimport { _randomString } from \"./_randomString\";\nimport {\n  _ILengthProps,\n  _randomLengthPick,\n  _randomLengthWindow,\n} from \"./_randomStringLength\";\nimport { __randomNumeric } from \"./private/__randomComposition\";\n\nexport const _randomFormatRelativeJsonPointer = (\n  props?: _ILengthProps,\n): string => {\n  if (props?.minLength === undefined && props?.maxLength === undefined)\n    return `${_randomInteger({ type: \"integer\", minimum: 0, maximum: 10 })}#`;\n  // The leading non-negative integer stands alone as a pointer, so a single\n  // digit is the shortest form; `#` names the key and a `/`-prefixed token names\n  // a member, which absorbs any remaining length.\n  const length: number = _randomLengthPick(\n    _randomLengthWindow(props, { minimum: 1, spread: 6 }),\n  );\n  if (length === 1) return __randomNumeric(1);\n  if (length === 2) return `${__randomNumeric(1)}#`;\n  return `${__randomNumeric(1)}/${_randomString({\n    type: \"string\",\n    minLength: length - 2,\n    maxLength: length - 2,\n  })}`;\n};\n"],"mappings":";;;;;AASA,MAAa,oCACX,UACW;CACX,IAAI,OAAO,cAAc,KAAA,KAAa,OAAO,cAAc,KAAA,GACzD,OAAO,GAAG,eAAe;EAAE,MAAM;EAAW,SAAS;EAAG,SAAS;CAAG,CAAC,EAAE;CAIzE,MAAM,SAAiB,kBACrB,oBAAoB,OAAO;EAAE,SAAS;EAAG,QAAQ;CAAE,CAAC,CACtD;CACA,IAAI,WAAW,GAAG,OAAO,gBAAgB,CAAC;CAC1C,IAAI,WAAW,GAAG,OAAO,GAAG,gBAAgB,CAAC,EAAE;CAC/C,OAAO,GAAG,gBAAgB,CAAC,EAAE,GAAG,cAAc;EAC5C,MAAM;EACN,WAAW,SAAS;EACpB,WAAW,SAAS;CACtB,CAAC;AACH"}
+{"version":3,"file":"_randomFormatRelativeJsonPointer.mjs","names":[],"sources":["../../src/internal/_randomFormatRelativeJsonPointer.ts"],"sourcesContent":["import { _randomInteger } from \"./_randomInteger\";\nimport { _randomString } from \"./_randomString\";\nimport {\n  _ILengthProps,\n  _randomLengthPick,\n  _randomLengthWindow,\n} from \"./_randomStringLength\";\nimport { __randomNumeric } from \"./private/__randomComposition\";\n\n/**\n * Generate a relative JSON pointer at a length the bounds allow.\n *\n * @evidence contracts/common.md#principled-implementation A relative pointer is a leading integer and then a hash or a token, so a length of one is a digit, two is a digit and a hash and longer ones add a `/` token that absorbs the remainder.\n * @evidence contracts/common.md#clear-and-simple-design One function over the digit and string helpers.\n * @evidence contracts/common.md#prohibited-implementation-shortcuts The shapes are the grammar's.\n * @evidence contracts/common.md#meaningful-documentation An inline comment explains the shortest forms.\n */\nexport const _randomFormatRelativeJsonPointer = (\n  props?: _ILengthProps,\n): string => {\n  if (props?.minLength === undefined && props?.maxLength === undefined)\n    return `${_randomInteger({ type: \"integer\", minimum: 0, maximum: 10 })}#`;\n  // The leading non-negative integer stands alone as a pointer, so a single\n  // digit is the shortest form; `#` names the key and a `/`-prefixed token names\n  // a member, which absorbs any remaining length.\n  const length: number = _randomLengthPick(\n    _randomLengthWindow(props, { minimum: 1, spread: 6 }),\n  );\n  if (length === 1) return __randomNumeric(1);\n  if (length === 2) return `${__randomNumeric(1)}#`;\n  return `${__randomNumeric(1)}/${_randomString({\n    type: \"string\",\n    minLength: length - 2,\n    maxLength: length - 2,\n  })}`;\n};\n"],"mappings":";;;;;;;;;;;;;AAiBA,MAAa,oCACX,UACW;CACX,IAAI,OAAO,cAAc,KAAA,KAAa,OAAO,cAAc,KAAA,GACzD,OAAO,GAAG,eAAe;EAAE,MAAM;EAAW,SAAS;EAAG,SAAS;CAAG,CAAC,EAAE;CAIzE,MAAM,SAAiB,kBACrB,oBAAoB,OAAO;EAAE,SAAS;EAAG,QAAQ;CAAE,CAAC,CACtD;CACA,IAAI,WAAW,GAAG,OAAO,gBAAgB,CAAC;CAC1C,IAAI,WAAW,GAAG,OAAO,GAAG,gBAAgB,CAAC,EAAE;CAC/C,OAAO,GAAG,gBAAgB,CAAC,EAAE,GAAG,cAAc;EAC5C,MAAM;EACN,WAAW,SAAS;EACpB,WAAW,SAAS;CACtB,CAAC;AACH"}

package/lib/internal/_randomFormatTime.d.ts

@@ -1,2 +1,15 @@
 import { _ILengthProps } from "./_randomStringLength";
+/**
+ * Generate an RFC 3339 time with an offset at a length the bounds allow.
+ *
+ * Constrained output lengths are nine or at least 11 characters; ten is
+ * unreachable because a fractional part needs a dot and a digit. An allowed
+ * window containing no such length throws. Samples use ordinary seconds from a
+ * UTC clock, with either Z or a numeric offset, rather than leap seconds.
+ *
+ * @evidence contracts/common.md#principled-implementation An unconstrained draw is the clock part of a random instant, and a constrained one writes `HH:MM:SS` with either a `Z` offset or a numeric offset and a fraction, choosing the form that fits the window, with the single unreachable length of ten excluded and an empty window throwing.
+ * @evidence contracts/common.md#clear-and-simple-design One function with small offset helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The length arithmetic follows RFC 3339 and is explained inline.
+ * @evidence contracts/common.md#meaningful-documentation Native prose states the length gap, impossible-window failure and ordinary-second sample policy; inline comments justify the fraction/offset arithmetic.
+ */
 export declare const _randomFormatTime: (props?: _ILengthProps) => string;

package/lib/internal/_randomFormatTime.js

@@ -4,6 +4,19 @@ exports._randomFormatTime = void 0;
 const _randomInteger_1 = require("./_randomInteger");
 const _randomStringLength_1 = require("./_randomStringLength");
 const __randomComposition_1 = require("./private/__randomComposition");
+/**
+ * Generate an RFC 3339 time with an offset at a length the bounds allow.
+ *
+ * Constrained output lengths are nine or at least 11 characters; ten is
+ * unreachable because a fractional part needs a dot and a digit. An allowed
+ * window containing no such length throws. Samples use ordinary seconds from a
+ * UTC clock, with either Z or a numeric offset, rather than leap seconds.
+ *
+ * @evidence contracts/common.md#principled-implementation An unconstrained draw is the clock part of a random instant, and a constrained one writes `HH:MM:SS` with either a `Z` offset or a numeric offset and a fraction, choosing the form that fits the window, with the single unreachable length of ten excluded and an empty window throwing.
+ * @evidence contracts/common.md#clear-and-simple-design One function with small offset helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The length arithmetic follows RFC 3339 and is explained inline.
+ * @evidence contracts/common.md#meaningful-documentation Native prose states the length gap, impossible-window failure and ordinary-second sample policy; inline comments justify the fraction/offset arithmetic.
+ */
 const _randomFormatTime = (props) => {
     const clock = () => new Date((0, _randomInteger_1._randomInteger)({ type: "integer", minimum: 0, maximum: DAY })).toISOString();
     if ((props === null || props === void 0 ? void 0 : props.minLength) === undefined && (props === null || props === void 0 ? void 0 : props.maxLength) === undefined)

package/lib/internal/_randomFormatTime.js.map

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

package/lib/internal/_randomFormatTime.mjs

@@ -2,6 +2,19 @@ import { _randomInteger } from "./_randomInteger.mjs";
 import { _RANDOM_LENGTH_ERROR, _randomLengthPick, _randomLengthWindow } from "./_randomStringLength.mjs";
 import { __randomDigits } from "./private/__randomComposition.mjs";
 //#region src/internal/_randomFormatTime.ts
+/**
+* Generate an RFC 3339 time with an offset at a length the bounds allow.
+*
+* Constrained output lengths are nine or at least 11 characters; ten is
+* unreachable because a fractional part needs a dot and a digit. An allowed
+* window containing no such length throws. Samples use ordinary seconds from a
+* UTC clock, with either Z or a numeric offset, rather than leap seconds.
+*
+* @evidence contracts/common.md#principled-implementation An unconstrained draw is the clock part of a random instant, and a constrained one writes `HH:MM:SS` with either a `Z` offset or a numeric offset and a fraction, choosing the form that fits the window, with the single unreachable length of ten excluded and an empty window throwing.
+* @evidence contracts/common.md#clear-and-simple-design One function with small offset helpers.
+* @evidence contracts/common.md#prohibited-implementation-shortcuts The length arithmetic follows RFC 3339 and is explained inline.
+* @evidence contracts/common.md#meaningful-documentation Native prose states the length gap, impossible-window failure and ordinary-second sample policy; inline comments justify the fraction/offset arithmetic.
+*/
 const _randomFormatTime = (props) => {
 	const clock = () => new Date(_randomInteger({
 		type: "integer",

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 {\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"}
+{"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\n/**\n * Generate an RFC 3339 time with an offset at a length the bounds allow.\n *\n * Constrained output lengths are nine or at least 11 characters; ten is\n * unreachable because a fractional part needs a dot and a digit. An allowed\n * window containing no such length throws. Samples use ordinary seconds from a\n * UTC clock, with either Z or a numeric offset, rather than leap seconds.\n *\n * @evidence contracts/common.md#principled-implementation An unconstrained draw is the clock part of a random instant, and a constrained one writes `HH:MM:SS` with either a `Z` offset or a numeric offset and a fraction, choosing the form that fits the window, with the single unreachable length of ten excluded and an empty window throwing.\n * @evidence contracts/common.md#clear-and-simple-design One function with small offset helpers.\n * @evidence contracts/common.md#prohibited-implementation-shortcuts The length arithmetic follows RFC 3339 and is explained inline.\n * @evidence contracts/common.md#meaningful-documentation Native prose states the length gap, impossible-window failure and ordinary-second sample policy; inline comments justify the fraction/offset arithmetic.\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":";;;;;;;;;;;;;;;;;AAsBA,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"}