@hegeldev/hegel 0.1.0

package/dist/generators/primitives.js

@@ -0,0 +1,240 @@
+/**
+ * Primitive and format generators: integers, floats, booleans, text, binary,
+ * just, sampledFrom, fromRegex, and format generators (emails, urls, etc.).
+ *
+ * @packageDocumentation
+ */
+import { BasicGenerator } from "./core.js";
+// ---------------------------------------------------------------------------
+// Built-in generators
+// ---------------------------------------------------------------------------
+/**
+ * Generate integers.
+ *
+ * @param minValue - Minimum value (inclusive), or null for unbounded.
+ * @param maxValue - Maximum value (inclusive), or null for unbounded.
+ */
+export function integers(minValue = null, maxValue = null) {
+    if (minValue !== null && maxValue !== null && minValue > maxValue) {
+        throw new Error(`Cannot have max_value=${maxValue} < min_value=${minValue}`);
+    }
+    const schema = { type: "integer" };
+    if (minValue !== null)
+        schema["min_value"] = minValue;
+    if (maxValue !== null)
+        schema["max_value"] = maxValue;
+    return new BasicGenerator(schema);
+}
+/**
+ * Generate floating-point numbers.
+ *
+ * By default, allows NaN and infinity unless a range is given. When a min or
+ * max is provided the defaults tighten: NaN becomes disallowed, and infinity
+ * is disallowed on the bounded side.
+ *
+ * @param minValue - Minimum value (inclusive), or null for unbounded.
+ * @param maxValue - Maximum value (inclusive), or null for unbounded.
+ * @param allowNan - Whether to allow NaN. Defaults to true only when both bounds are absent.
+ * @param allowInfinity - Whether to allow ±Infinity. Defaults to true when at least one bound is absent.
+ * @param excludeMin - Whether to exclude the minimum value (open interval on the left).
+ * @param excludeMax - Whether to exclude the maximum value (open interval on the right).
+ */
+export function floats(minValue = null, maxValue = null, allowNan = null, allowInfinity = null, excludeMin = false, excludeMax = false) {
+    const hasMin = minValue !== null;
+    const hasMax = maxValue !== null;
+    const resolvedAllowNan = allowNan !== null ? allowNan : !hasMin && !hasMax;
+    const resolvedAllowInfinity = allowInfinity !== null ? allowInfinity : !hasMin || !hasMax;
+    if (resolvedAllowNan && (hasMin || hasMax)) {
+        throw new Error("Cannot have allow_nan=true with min_value or max_value");
+    }
+    if (hasMin && hasMax && minValue > maxValue) {
+        throw new Error(`There are no floats between min_value=${minValue} and max_value=${maxValue}`);
+    }
+    if (resolvedAllowInfinity && hasMin && hasMax) {
+        throw new Error("Cannot have allow_infinity=true with both min_value and max_value");
+    }
+    const schema = { type: "float" };
+    if (hasMin)
+        schema["min_value"] = minValue;
+    if (hasMax)
+        schema["max_value"] = maxValue;
+    schema["allow_nan"] = resolvedAllowNan;
+    schema["allow_infinity"] = resolvedAllowInfinity;
+    // exclude_min/exclude_max are only valid when the corresponding bound is set;
+    // sending them without a bound causes the server to return InvalidArgument.
+    schema["exclude_min"] = hasMin && excludeMin;
+    schema["exclude_max"] = hasMax && excludeMax;
+    schema["width"] = 64;
+    return new BasicGenerator(schema);
+}
+/**
+ * Generate booleans.
+ */
+export function booleans() {
+    return new BasicGenerator({ type: "boolean" });
+}
+/**
+ * Generate text strings.
+ *
+ * @param minSize - Minimum number of Unicode codepoints. Defaults to 0.
+ * @param maxSize - Maximum number of Unicode codepoints, or null for unbounded.
+ * @param opts - Character filtering options.
+ */
+export function text(minSize = 0, maxSize = null, opts = {}) {
+    if (minSize < 0) {
+        throw new Error(`min_size=${minSize} must be non-negative`);
+    }
+    if (maxSize !== null && maxSize < 0) {
+        throw new Error(`max_size=${maxSize} must be non-negative`);
+    }
+    if (maxSize !== null && minSize > maxSize) {
+        throw new Error(`Cannot have max_size=${maxSize} < min_size=${minSize}`);
+    }
+    const schema = { type: "string", min_size: minSize };
+    if (maxSize !== null)
+        schema["max_size"] = maxSize;
+    if (opts.codec !== undefined)
+        schema["codec"] = opts.codec;
+    if (opts.minCodepoint !== undefined)
+        schema["min_codepoint"] = opts.minCodepoint;
+    if (opts.maxCodepoint !== undefined)
+        schema["max_codepoint"] = opts.maxCodepoint;
+    if (opts.categories !== undefined)
+        schema["categories"] = opts.categories;
+    if (opts.excludeCategories !== undefined)
+        schema["exclude_categories"] = opts.excludeCategories;
+    if (opts.includeCharacters !== undefined)
+        schema["include_characters"] = opts.includeCharacters;
+    if (opts.excludeCharacters !== undefined)
+        schema["exclude_characters"] = opts.excludeCharacters;
+    return new BasicGenerator(schema);
+}
+/**
+ * Generate single Unicode characters.
+ *
+ * This is a convenience for `text(1, 1, opts)` — it generates single-character
+ * strings with the same character filtering options as {@link text}.
+ *
+ * @param opts - Character filtering options.
+ */
+export function characters(opts = {}) {
+    return text(1, 1, opts);
+}
+/**
+ * Generate binary data (byte strings).
+ *
+ * The server returns CBOR byte strings which are decoded directly as
+ * `Uint8Array`. No transform is needed.
+ *
+ * @param minSize - Minimum byte length. Defaults to 0.
+ * @param maxSize - Maximum byte length, or null for unbounded.
+ */
+export function binary(minSize = 0, maxSize = null) {
+    if (minSize < 0) {
+        throw new Error(`min_size=${minSize} must be non-negative`);
+    }
+    if (maxSize !== null && maxSize < 0) {
+        throw new Error(`max_size=${maxSize} must be non-negative`);
+    }
+    if (maxSize !== null && minSize > maxSize) {
+        throw new Error(`Cannot have max_size=${maxSize} < min_size=${minSize}`);
+    }
+    const schema = { type: "binary", min_size: minSize };
+    if (maxSize !== null)
+        schema["max_size"] = maxSize;
+    return new BasicGenerator(schema);
+}
+/**
+ * Always return the same constant value, ignoring the server's suggestion.
+ *
+ * @param value - The constant to always return.
+ */
+export function just(value) {
+    return new BasicGenerator({ type: "constant", value: null }, (_raw) => value);
+}
+/**
+ * Pick uniformly at random from a list of values.
+ *
+ * The server generates an integer index; the transform maps it to the
+ * corresponding element of `values`.
+ *
+ * @param values - The list to sample from. Must be non-empty.
+ * @throws {Error} If `values` is empty.
+ */
+export function sampledFrom(values) {
+    const elements = Array.from(values);
+    if (elements.length === 0) {
+        throw new Error("sampledFrom requires at least one element");
+    }
+    const schema = {
+        type: "integer",
+        min_value: 0,
+        max_value: elements.length - 1,
+    };
+    return new BasicGenerator(schema, (idx) => elements[idx]);
+}
+/**
+ * Generate strings matching a regular expression pattern.
+ *
+ * @param pattern - The regex pattern to match.
+ * @param fullmatch - If true (default), the entire string must match the pattern.
+ *                    If false, a substring match is sufficient.
+ */
+export function fromRegex(pattern, fullmatch = true) {
+    return new BasicGenerator({ type: "regex", pattern, fullmatch });
+}
+/**
+ * Generate email addresses.
+ *
+ * Each generated value is a valid email address string containing '@'.
+ */
+export function emails() {
+    return new BasicGenerator({ type: "email" });
+}
+/**
+ * Generate URLs.
+ *
+ * Each generated value is a valid URL string starting with "http://" or "https://".
+ */
+export function urls() {
+    return new BasicGenerator({ type: "url" });
+}
+/**
+ * Generate domain names.
+ *
+ * @param maxLength - Optional maximum length for generated domain names.
+ */
+export function domains(maxLength = null) {
+    if (maxLength !== null && (maxLength < 4 || maxLength > 255)) {
+        throw new Error(`max_length=${maxLength} must be between 4 and 255`);
+    }
+    const schema = { type: "domain" };
+    if (maxLength !== null)
+        schema["max_length"] = maxLength;
+    return new BasicGenerator(schema);
+}
+/**
+ * Generate dates.
+ *
+ * Each generated value is an ISO 8601 date string in YYYY-MM-DD format.
+ */
+export function dates() {
+    return new BasicGenerator({ type: "date" });
+}
+/**
+ * Generate times.
+ *
+ * Each generated value is a time string containing ':'.
+ */
+export function times() {
+    return new BasicGenerator({ type: "time" });
+}
+/**
+ * Generate datetimes.
+ *
+ * Each generated value is a datetime string containing 'T'.
+ */
+export function datetimes() {
+    return new BasicGenerator({ type: "datetime" });
+}
+//# sourceMappingURL=primitives.js.map

package/dist/generators/primitives.js.map

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

package/dist/generators/strings.d.ts

@@ -0,0 +1,73 @@
+/**
+ * String, character, binary, regex, and format generators.
+ *
+ * @packageDocumentation
+ */
+import { Generator } from "./core.js";
+/**
+ * Options for character filtering, shared between text() and characters().
+ *
+ * `alphabet` is a shorthand that sets `includeCharacters` and clears categories.
+ * It cannot be combined with other character filtering options.
+ */
+export interface CharacterFilterOptions {
+    /** Restrict to characters in this explicit set. Mutually exclusive with other character options. */
+    alphabet?: string;
+    /** Restrict to characters encodable in this codec (e.g. "ascii", "utf-8", "latin-1"). */
+    codec?: string;
+    /** Minimum Unicode codepoint (inclusive). */
+    minCodepoint?: number;
+    /** Maximum Unicode codepoint (inclusive). */
+    maxCodepoint?: number;
+    /** Include only characters from these Unicode general categories (e.g. ["L", "Nd"]). */
+    categories?: string[];
+    /** Exclude characters from these Unicode general categories. */
+    excludeCategories?: string[];
+    /** Always include these specific characters. */
+    includeCharacters?: string;
+    /** Always exclude these specific characters. */
+    excludeCharacters?: string;
+}
+export interface TextOptions extends CharacterFilterOptions {
+    minSize?: number;
+    maxSize?: number;
+}
+/** Generate text strings. */
+export declare function text(options?: TextOptions): Generator<string>;
+export type CharacterOptions = CharacterFilterOptions;
+/** Generate single characters. */
+export declare function characters(options?: CharacterOptions): Generator<string>;
+export interface BinaryOptions {
+    minSize?: number;
+    maxSize?: number;
+}
+/** Generate binary data (Uint8Array). */
+export declare function binary(options?: BinaryOptions): Generator<Uint8Array>;
+export interface RegexOptions {
+    fullmatch?: boolean;
+}
+/** Generate strings matching a regex pattern. Defaults to substring match. */
+export declare function fromRegex(pattern: string, options?: RegexOptions): Generator<string>;
+/** Generate email addresses. */
+export declare function emails(): Generator<string>;
+/** Generate URLs. */
+export declare function urls(): Generator<string>;
+export interface DomainOptions {
+    /** Maximum length (must be between 4 and 255, default 255). */
+    maxLength?: number;
+}
+/** Generate domain names. */
+export declare function domains(options?: DomainOptions): Generator<string>;
+export interface IpAddressOptions {
+    /** Restrict to a specific IP version. Omit to generate either IPv4 or IPv6. */
+    version?: 4 | 6;
+}
+/** Generate IP address strings. Defaults to either IPv4 or IPv6; pass `{ version }` to restrict. */
+export declare function ipAddresses(options?: IpAddressOptions): Generator<string>;
+/** Generate date strings (ISO 8601). */
+export declare function dates(): Generator<string>;
+/** Generate time strings (ISO 8601). */
+export declare function times(): Generator<string>;
+/** Generate datetime strings (ISO 8601). */
+export declare function datetimes(): Generator<string>;
+//# sourceMappingURL=strings.d.ts.map

package/dist/generators/strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../src/generators/strings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,SAAS,EAAkB,MAAM,WAAW,CAAC;AAGtD;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,oGAAoG;IACpG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAY,SAAQ,sBAAsB;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAsFD,6BAA6B;AAC7B,wBAAgB,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAE7D;AAMD,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAgBtD,kCAAkC;AAClC,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC,MAAM,CAAC,CAExE;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA0BD,yCAAyC;AACzC,wBAAgB,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC,UAAU,CAAC,CAErE;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAYD,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC,MAAM,CAAC,CAEpF;AAQD,gCAAgC;AAChC,wBAAgB,MAAM,IAAI,SAAS,CAAC,MAAM,CAAC,CAE1C;AAQD,qBAAqB;AACrB,wBAAgB,IAAI,IAAI,SAAS,CAAC,MAAM,CAAC,CAExC;AAED,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAYD,6BAA6B;AAC7B,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,CAElE;AAED,MAAM,WAAW,gBAAgB;IAC/B,+EAA+E;IAC/E,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CACjB;AAQD,oGAAoG;AACpG,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC,MAAM,CAAC,CAIzE;AAQD,wCAAwC;AACxC,wBAAgB,KAAK,IAAI,SAAS,CAAC,MAAM,CAAC,CAEzC;AAQD,wCAAwC;AACxC,wBAAgB,KAAK,IAAI,SAAS,CAAC,MAAM,CAAC,CAEzC;AAQD,4CAA4C;AAC5C,wBAAgB,SAAS,IAAI,SAAS,CAAC,MAAM,CAAC,CAE7C"}

package/dist/generators/strings.js

@@ -0,0 +1,215 @@
+/**
+ * String, character, binary, regex, and format generators.
+ *
+ * @packageDocumentation
+ */
+import { generateRaw } from "../testCase.js";
+import { Generator, BasicGenerator } from "./core.js";
+import { oneOf } from "./combinators.js";
+function buildCharacterSchema(options) {
+    const hasAlphabet = options.alphabet !== undefined;
+    const hasCharParams = options.codec !== undefined ||
+        options.minCodepoint !== undefined ||
+        options.maxCodepoint !== undefined ||
+        options.categories !== undefined ||
+        options.excludeCategories !== undefined ||
+        options.includeCharacters !== undefined ||
+        options.excludeCharacters !== undefined;
+    if (hasAlphabet && hasCharParams) {
+        throw new Error("Cannot combine alphabet with other character filtering options");
+    }
+    if (hasAlphabet) {
+        // alphabet() in Rust sets categories=[] and includeCharacters=chars
+        return {
+            categories: [],
+            include_characters: options.alphabet,
+        };
+    }
+    const schema = {};
+    if (options.codec !== undefined)
+        schema["codec"] = options.codec;
+    if (options.minCodepoint !== undefined)
+        schema["min_codepoint"] = options.minCodepoint;
+    if (options.maxCodepoint !== undefined)
+        schema["max_codepoint"] = options.maxCodepoint;
+    if (options.categories !== undefined)
+        schema["categories"] = options.categories;
+    if (options.excludeCategories !== undefined)
+        schema["exclude_categories"] = options.excludeCategories;
+    if (options.includeCharacters !== undefined)
+        schema["include_characters"] = options.includeCharacters;
+    if (options.excludeCharacters !== undefined)
+        schema["exclude_characters"] = options.excludeCharacters;
+    return schema;
+}
+function parseString(raw) {
+    return String(raw);
+}
+function parseBytes(raw) {
+    // Buffer is a subclass of Uint8Array, so this catches both.
+    if (raw instanceof Uint8Array)
+        return raw;
+    throw new Error(`Expected bytes, got ${typeof raw}`);
+}
+/**
+ * Convenience base for generators that are pure schema+parse wrappers.
+ * Subclasses supply a schema in the constructor; doDraw and asBasic use it.
+ */
+class SchemaStringGenerator extends Generator {
+    schema;
+    constructor(schema) {
+        super();
+        this.schema = schema;
+    }
+    doDraw(tc) {
+        return parseString(generateRaw(tc, this.schema));
+    }
+    asBasic() {
+        return new BasicGenerator(this.schema, parseString);
+    }
+}
+class TextGenerator extends SchemaStringGenerator {
+    constructor(options) {
+        const schema = {
+            type: "string",
+            min_size: options?.minSize ?? 0,
+        };
+        if (options?.maxSize !== undefined) {
+            schema["max_size"] = options.maxSize;
+        }
+        if (options) {
+            Object.assign(schema, buildCharacterSchema(options));
+        }
+        super(schema);
+    }
+}
+/** Generate text strings. */
+export function text(options) {
+    return new TextGenerator(options);
+}
+class CharactersGenerator extends SchemaStringGenerator {
+    constructor(options) {
+        const schema = {
+            type: "string",
+            min_size: 1,
+            max_size: 1,
+        };
+        if (options) {
+            Object.assign(schema, buildCharacterSchema(options));
+        }
+        super(schema);
+    }
+}
+/** Generate single characters. */
+export function characters(options) {
+    return new CharactersGenerator(options);
+}
+class BinaryGenerator extends Generator {
+    schema;
+    constructor(options) {
+        super();
+        const schema = {
+            type: "binary",
+            min_size: options?.minSize ?? 0,
+        };
+        if (options?.maxSize !== undefined) {
+            schema["max_size"] = options.maxSize;
+        }
+        this.schema = schema;
+    }
+    doDraw(tc) {
+        return parseBytes(generateRaw(tc, this.schema));
+    }
+    asBasic() {
+        return new BasicGenerator(this.schema, parseBytes);
+    }
+}
+/** Generate binary data (Uint8Array). */
+export function binary(options) {
+    return new BinaryGenerator(options);
+}
+class FromRegexGenerator extends SchemaStringGenerator {
+    constructor(pattern, options) {
+        super({
+            type: "regex",
+            pattern,
+            fullmatch: options?.fullmatch ?? false,
+        });
+    }
+}
+/** Generate strings matching a regex pattern. Defaults to substring match. */
+export function fromRegex(pattern, options) {
+    return new FromRegexGenerator(pattern, options);
+}
+class EmailsGenerator extends SchemaStringGenerator {
+    constructor() {
+        super({ type: "email" });
+    }
+}
+/** Generate email addresses. */
+export function emails() {
+    return new EmailsGenerator();
+}
+class UrlsGenerator extends SchemaStringGenerator {
+    constructor() {
+        super({ type: "url" });
+    }
+}
+/** Generate URLs. */
+export function urls() {
+    return new UrlsGenerator();
+}
+class DomainsGenerator extends SchemaStringGenerator {
+    constructor(options) {
+        const schema = { type: "domain" };
+        if (options?.maxLength !== undefined) {
+            schema["max_length"] = options.maxLength;
+        }
+        super(schema);
+    }
+}
+/** Generate domain names. */
+export function domains(options) {
+    return new DomainsGenerator(options);
+}
+class IpAddressesGenerator extends SchemaStringGenerator {
+    constructor(version) {
+        super({ type: version === 4 ? "ipv4" : "ipv6" });
+    }
+}
+/** Generate IP address strings. Defaults to either IPv4 or IPv6; pass `{ version }` to restrict. */
+export function ipAddresses(options) {
+    if (options?.version === 4)
+        return new IpAddressesGenerator(4);
+    if (options?.version === 6)
+        return new IpAddressesGenerator(6);
+    return oneOf(new IpAddressesGenerator(4), new IpAddressesGenerator(6));
+}
+class DatesGenerator extends SchemaStringGenerator {
+    constructor() {
+        super({ type: "date" });
+    }
+}
+/** Generate date strings (ISO 8601). */
+export function dates() {
+    return new DatesGenerator();
+}
+class TimesGenerator extends SchemaStringGenerator {
+    constructor() {
+        super({ type: "time" });
+    }
+}
+/** Generate time strings (ISO 8601). */
+export function times() {
+    return new TimesGenerator();
+}
+class DatetimesGenerator extends SchemaStringGenerator {
+    constructor() {
+        super({ type: "datetime" });
+    }
+}
+/** Generate datetime strings (ISO 8601). */
+export function datetimes() {
+    return new DatetimesGenerator();
+}
+//# sourceMappingURL=strings.js.map

package/dist/generators/strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.js","sourceRoot":"","sources":["../../src/generators/strings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAY,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAgCzC,SAAS,oBAAoB,CAAC,OAA+B;IAC3D,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC;IACnD,MAAM,aAAa,GACjB,OAAO,CAAC,KAAK,KAAK,SAAS;QAC3B,OAAO,CAAC,YAAY,KAAK,SAAS;QAClC,OAAO,CAAC,YAAY,KAAK,SAAS;QAClC,OAAO,CAAC,UAAU,KAAK,SAAS;QAChC,OAAO,CAAC,iBAAiB,KAAK,SAAS;QACvC,OAAO,CAAC,iBAAiB,KAAK,SAAS;QACvC,OAAO,CAAC,iBAAiB,KAAK,SAAS,CAAC;IAE1C,IAAI,WAAW,IAAI,aAAa,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,oEAAoE;QACpE,OAAO;YACL,UAAU,EAAE,EAAE;YACd,kBAAkB,EAAE,OAAO,CAAC,QAAQ;SACrC,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;IACjE,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS;QAAE,MAAM,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IACvF,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS;QAAE,MAAM,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IACvF,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;QAAE,MAAM,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAChF,IAAI,OAAO,CAAC,iBAAiB,KAAK,SAAS;QACzC,MAAM,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAC3D,IAAI,OAAO,CAAC,iBAAiB,KAAK,SAAS;QACzC,MAAM,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAC3D,IAAI,OAAO,CAAC,iBAAiB,KAAK,SAAS;QACzC,MAAM,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAC3D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,GAAY;IAC/B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,UAAU,CAAC,GAAY;IAC9B,4DAA4D;IAC5D,IAAI,GAAG,YAAY,UAAU;QAAE,OAAO,GAAG,CAAC;IAC1C,MAAM,IAAI,KAAK,CAAC,uBAAuB,OAAO,GAAG,EAAE,CAAC,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,MAAe,qBAAsB,SAAQ,SAAiB;IACzC,MAAM,CAA0B;IAEnD,YAAY,MAA+B;QACzC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,EAAY;QACjB,OAAO,WAAW,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,CAAC;IAEQ,OAAO;QACd,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtD,CAAC;CACF;AAED,MAAM,aAAc,SAAQ,qBAAqB;IAC/C,YAAY,OAAqB;QAC/B,MAAM,MAAM,GAA4B;YACtC,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,OAAO,EAAE,OAAO,IAAI,CAAC;SAChC,CAAC;QACF,IAAI,OAAO,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;QACvC,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;CACF;AAED,6BAA6B;AAC7B,MAAM,UAAU,IAAI,CAAC,OAAqB;IACxC,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAQD,MAAM,mBAAoB,SAAQ,qBAAqB;IACrD,YAAY,OAA0B;QACpC,MAAM,MAAM,GAA4B;YACtC,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,CAAC;SACZ,CAAC;QACF,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;CACF;AAED,kCAAkC;AAClC,MAAM,UAAU,UAAU,CAAC,OAA0B;IACnD,OAAO,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC;AAOD,MAAM,eAAgB,SAAQ,SAAqB;IAChC,MAAM,CAA0B;IAEjD,YAAY,OAAuB;QACjC,KAAK,EAAE,CAAC;QACR,MAAM,MAAM,GAA4B;YACtC,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,OAAO,EAAE,OAAO,IAAI,CAAC;SAChC,CAAC;QACF,IAAI,OAAO,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;QACvC,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,EAAY;QACjB,OAAO,UAAU,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;IAEQ,OAAO;QACd,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrD,CAAC;CACF;AAED,yCAAyC;AACzC,MAAM,UAAU,MAAM,CAAC,OAAuB;IAC5C,OAAO,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC;AAMD,MAAM,kBAAmB,SAAQ,qBAAqB;IACpD,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC;YACJ,IAAI,EAAE,OAAO;YACb,OAAO;YACP,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,KAAK;SACvC,CAAC,CAAC;IACL,CAAC;CACF;AAED,8EAA8E;AAC9E,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,OAAsB;IAC/D,OAAO,IAAI,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,eAAgB,SAAQ,qBAAqB;IACjD;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3B,CAAC;CACF;AAED,gCAAgC;AAChC,MAAM,UAAU,MAAM;IACpB,OAAO,IAAI,eAAe,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,aAAc,SAAQ,qBAAqB;IAC/C;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACzB,CAAC;CACF;AAED,qBAAqB;AACrB,MAAM,UAAU,IAAI;IAClB,OAAO,IAAI,aAAa,EAAE,CAAC;AAC7B,CAAC;AAOD,MAAM,gBAAiB,SAAQ,qBAAqB;IAClD,YAAY,OAAuB;QACjC,MAAM,MAAM,GAA4B,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC3D,IAAI,OAAO,EAAE,SAAS,KAAK,SAAS,EAAE,CAAC;YACrC,MAAM,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;QAC3C,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;CACF;AAED,6BAA6B;AAC7B,MAAM,UAAU,OAAO,CAAC,OAAuB;IAC7C,OAAO,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC;AAOD,MAAM,oBAAqB,SAAQ,qBAAqB;IACtD,YAAY,OAAc;QACxB,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACnD,CAAC;CACF;AAED,oGAAoG;AACpG,MAAM,UAAU,WAAW,CAAC,OAA0B;IACpD,IAAI,OAAO,EAAE,OAAO,KAAK,CAAC;QAAE,OAAO,IAAI,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAC/D,IAAI,OAAO,EAAE,OAAO,KAAK,CAAC;QAAE,OAAO,IAAI,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAC/D,OAAO,KAAK,CAAC,IAAI,oBAAoB,CAAC,CAAC,CAAC,EAAE,IAAI,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,cAAe,SAAQ,qBAAqB;IAChD;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1B,CAAC;CACF;AAED,wCAAwC;AACxC,MAAM,UAAU,KAAK;IACnB,OAAO,IAAI,cAAc,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,cAAe,SAAQ,qBAAqB;IAChD;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1B,CAAC;CACF;AAED,wCAAwC;AACxC,MAAM,UAAU,KAAK;IACnB,OAAO,IAAI,cAAc,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,kBAAmB,SAAQ,qBAAqB;IACpD;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,4CAA4C;AAC5C,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,kBAAkB,EAAE,CAAC;AAClC,CAAC"}

package/dist/generators/tuples.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tuple generators.
+ *
+ * @packageDocumentation
+ */
+import { Generator } from "./core.js";
+/** Generate tuples from the given element generators. */
+export declare function tuples<T extends unknown[]>(...generators: {
+    [K in keyof T]: Generator<T[K]>;
+}): Generator<T>;
+//# sourceMappingURL=tuples.d.ts.map

package/dist/generators/tuples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuples.d.ts","sourceRoot":"","sources":["../../src/generators/tuples.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,SAAS,EAAkB,MAAM,WAAW,CAAC;AAsCtD,yDAAyD;AACzD,wBAAgB,MAAM,CAAC,CAAC,SAAS,OAAO,EAAE,EACxC,GAAG,UAAU,EAAE;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACjD,SAAS,CAAC,CAAC,CAAC,CAEd"}

package/dist/generators/tuples.js

@@ -0,0 +1,43 @@
+/**
+ * Tuple generators.
+ *
+ * @packageDocumentation
+ */
+import { Labels } from "../testCase.js";
+import { Generator, BasicGenerator } from "./core.js";
+class TuplesGenerator extends Generator {
+    generators;
+    basic;
+    constructor(generators) {
+        super();
+        this.generators = generators;
+        const basics = generators.map((g) => g.asBasic());
+        if (basics.every((b) => b !== null)) {
+            const validBasics = basics;
+            this.basic = new BasicGenerator({ type: "tuple", elements: validBasics.map((b) => b.schema) }, (raw) => {
+                if (!Array.isArray(raw))
+                    throw new Error(`Expected array, got ${typeof raw}`);
+                return raw.map((v, i) => validBasics[i].parseRaw(v));
+            });
+        }
+        else {
+            this.basic = null;
+        }
+    }
+    doDraw(tc) {
+        if (this.basic)
+            return this.basic.doDraw(tc);
+        tc.startSpan(Labels.TUPLE);
+        const result = this.generators.map((g) => g.doDraw(tc));
+        tc.stopSpan();
+        return result;
+    }
+    asBasic() {
+        return this.basic;
+    }
+}
+/** Generate tuples from the given element generators. */
+export function tuples(...generators) {
+    return new TuplesGenerator(generators);
+}
+//# sourceMappingURL=tuples.js.map

package/dist/generators/tuples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuples.js","sourceRoot":"","sources":["../../src/generators/tuples.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAY,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEtD,MAAM,eAAgB,SAAQ,SAAoB;IAC/B,UAAU,CAAuB;IACjC,KAAK,CAAmC;IAEzD,YAAY,UAAgC;QAC1C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAE7B,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAClD,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;YACpC,MAAM,WAAW,GAAG,MAAmC,CAAC;YACxD,IAAI,CAAC,KAAK,GAAG,IAAI,cAAc,CAC7B,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAC7D,CAAC,GAAG,EAAE,EAAE;gBACN,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,OAAO,GAAG,EAAE,CAAC,CAAC;gBAC9E,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAU,EAAE,CAAS,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YACxE,CAAC,CACF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IAED,MAAM,CAAC,EAAY;QACjB,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7C,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACxD,EAAE,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,MAAM,CAAC;IAChB,CAAC;IAEQ,OAAO;QACd,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF;AAED,yDAAyD;AACzD,MAAM,UAAU,MAAM,CACpB,GAAG,UAA+C;IAElD,OAAO,IAAI,eAAe,CAAC,UAAkC,CAA4B,CAAC;AAC5F,CAAC"}