constructa-generators 0.0.11 → 0.1.0

package/README.md

@@ -4,6 +4,42 @@ Built-in generator implementations for Constructa.
 
 The first implementation set will include integer, boolean, choice, decimal, string, date, UUID, object, array, and template generators. Each generator should own its configuration validation, metadata, implementation, and tests while conforming to the common core contract.
 
+## Integer
+
+`integer({ min, max })` returns a portable definition whose output is inferred as `number`. Both safe-integer bounds are required and inclusive. `integerGenerator` uses the execution context's random source, and `registerIntegerGenerator(registry)` is available for advanced custom registries.
+
+## Boolean
+
+`boolean()` returns a portable definition whose output is inferred as `boolean`. It has no configuration and selects `false` and `true` with equal probability through the execution context's random source. `registerBooleanGenerator(registry)` is available for advanced custom registries.
+
+## Choice
+
+`choice(values)` accepts a non-empty array of portable JSON values and infers the union of its members, including array literals without `as const`. It selects a member through the execution context's unbiased integer source. `registerChoiceGenerator(registry)` is available for advanced custom registries.
+
+## Decimal
+
+`decimal({ min, max, precision })` returns a JavaScript `number` rounded with `Number#toFixed`; it is not arbitrary-precision decimal arithmetic. Bounds must be finite and inclusive. Precision is required and ranges from 0 through 15. `registerDecimalGenerator(registry)` is available for advanced custom registries.
+
+## String
+
+`string({ length, charset? })` returns a random character string. Length is required and ranges from 0 through 10,000. The explicit default charset is `alphanumeric`; `alphabetic`, `numeric`, `alphanumeric`, and `hex` are predefined, while any other non-empty string is used as a custom charset. `registerStringGenerator(registry)` is available for advanced custom registries.
+
+## Date
+
+`date({ min, max })` returns an inclusive `YYYY-MM-DD` ISO calendar-date string. Dates are validated canonically and generated with UTC calendar arithmetic, so results do not depend on the local timezone. `registerDateGenerator(registry)` is available for advanced custom registries.
+
+## UUID
+
+`uuid()` returns a canonical UUID v4 string. It obtains exactly 16 bytes from the execution context, sets the RFC 4122 version and variant bits, and is deterministic when the executor is seeded. `registerUuidGenerator(registry)` is available for advanced custom registries.
+
+## Object
+
+`object(fields)` composes named child definitions and infers a mapped object output from them. Each child is delegated through the execution engine using its field name as the path segment, so nested errors retain their full field path. `registerObjectGenerator(registry)` is available for advanced custom registries.
+
+## Array
+
+`array(item, { length })` creates one fixed-length array value and infers `Infer<typeof item>[]`. Length must be a non-negative safe integer no greater than 10,000. Array items are delegated through the execution engine using numeric index path segments; this is distinct from repeated root execution. `registerArrayGenerator(registry)` is available for advanced custom registries.
+
 ## Dependency boundary
 
 This package may import `constructa-core` for the generator contract and registration APIs, and `constructa-schema` for portable definitions. It must not import exporters, the SDK, applications, UI, environment, persistence, or transport code.

package/dist/index.d.ts

@@ -1 +1,119 @@
-export {}
+import { GeneratorDefinition, GeneratorImplementation, GeneratorRegistry } from "constructa-core";
+import { JsonValue } from "constructa-schema";
+//#region src/index.d.ts
+declare const MAX_DECIMAL_PRECISION = 15;
+declare const MAX_STRING_LENGTH = 10000;
+declare const MAX_ARRAY_LENGTH = 10000;
+declare const STRING_CHARSETS: {
+  readonly alphabetic: "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
+  readonly numeric: "0123456789";
+  readonly alphanumeric: "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
+  readonly hex: "0123456789abcdef";
+};
+type UuidDefinition = GeneratorDefinition<string> & {
+  readonly type: "uuid";
+};
+/** Builds a portable UUID version 4 definition. */
+declare function uuid(): UuidDefinition;
+declare const uuidGenerator: GeneratorImplementation<UuidDefinition, string>;
+declare function registerUuidGenerator(registry: GeneratorRegistry): void;
+type ObjectFields = Readonly<Record<string, GeneratorDefinition>>;
+type ObjectOutput<Fields extends ObjectFields> = { [Key in keyof Fields]: InferGenerator<Fields[Key]>; };
+type ObjectDefinition<Fields extends ObjectFields = ObjectFields> = GeneratorDefinition<ObjectOutput<Fields>> & {
+  readonly type: "object";
+  readonly fields: Fields;
+};
+type InferGenerator<Definition> = Definition extends GeneratorDefinition<infer Output> ? Output : never;
+/** Builds a composite object definition from named child definitions. */
+declare function object<const Fields extends ObjectFields>(fields: Fields): ObjectDefinition<Fields>;
+declare const objectGenerator: GeneratorImplementation<ObjectDefinition, Record<string, unknown>>;
+declare function registerObjectGenerator(registry: GeneratorRegistry): void;
+type ArrayOptions = {
+  readonly length: number;
+};
+type ArrayDefinition<Item extends GeneratorDefinition = GeneratorDefinition> = GeneratorDefinition<InferGenerator<Item>[]> & {
+  readonly type: "array";
+  readonly item: Item;
+  readonly length: number;
+};
+/** Builds a fixed-length composite array definition. */
+declare function array<const Item extends GeneratorDefinition>(item: Item, options: ArrayOptions): ArrayDefinition<Item>;
+declare const arrayGenerator: GeneratorImplementation<ArrayDefinition, unknown[]>;
+declare function registerArrayGenerator(registry: GeneratorRegistry): void;
+type ChoiceDefinition<Value extends JsonValue = JsonValue> = GeneratorDefinition<Value> & {
+  readonly type: "choice";
+  readonly values: readonly Value[];
+};
+/** Builds a portable choice definition while preserving array-literal unions. */
+declare function choice<const Values extends readonly JsonValue[]>(values: Values): ChoiceDefinition<Values[number]>;
+declare const choiceGenerator: GeneratorImplementation<ChoiceDefinition, JsonValue>;
+declare function registerChoiceGenerator(registry: GeneratorRegistry): void;
+type DecimalOptions = {
+  readonly min: number;
+  readonly max: number;
+  readonly precision: number;
+};
+type DecimalDefinition = GeneratorDefinition<number> & {
+  readonly type: "decimal";
+  readonly min: number;
+  readonly max: number;
+  readonly precision: number;
+};
+/** Builds a finite JavaScript-number decimal definition. Precision is at most 15. */
+declare function decimal(options: DecimalOptions): DecimalDefinition;
+declare const decimalGenerator: GeneratorImplementation<DecimalDefinition, number>;
+declare function registerDecimalGenerator(registry: GeneratorRegistry): void;
+type StringCharset = keyof typeof STRING_CHARSETS | string;
+type StringOptions = {
+  readonly length: number;
+  readonly charset?: StringCharset;
+};
+type StringDefinition = GeneratorDefinition<string> & {
+  readonly type: "string";
+  readonly length: number;
+  readonly charset: string;
+};
+/** Builds a random-character string definition. The default charset is alphanumeric. */
+declare function string(options: StringOptions): StringDefinition;
+declare const stringGenerator: GeneratorImplementation<StringDefinition, string>;
+declare function registerStringGenerator(registry: GeneratorRegistry): void;
+type DateOptions = {
+  readonly min: string;
+  readonly max: string;
+};
+type DateDefinition = GeneratorDefinition<string> & {
+  readonly type: "date";
+  readonly min: string;
+  readonly max: string;
+};
+/** Builds an inclusive timezone-independent ISO calendar-date definition. */
+declare function date(options: DateOptions): DateDefinition;
+declare const dateGenerator: GeneratorImplementation<DateDefinition, string>;
+declare function registerDateGenerator(registry: GeneratorRegistry): void;
+type IntegerOptions = {
+  readonly min: number;
+  readonly max: number;
+};
+type BooleanDefinition = GeneratorDefinition<boolean> & {
+  readonly type: "boolean";
+};
+/** Builds a portable, evenly distributed boolean definition. */
+declare function boolean(): BooleanDefinition;
+/** Trusted implementation for the portable `boolean` definition. */
+declare const booleanGenerator: GeneratorImplementation<BooleanDefinition, boolean>;
+/** Registers the boolean built-in with an advanced custom registry. */
+declare function registerBooleanGenerator(registry: GeneratorRegistry): void;
+type IntegerDefinition = GeneratorDefinition<number> & {
+  readonly type: "integer";
+  readonly min: number;
+  readonly max: number;
+};
+/** Builds a portable integer definition with inclusive minimum and maximum bounds. */
+declare function integer(options: IntegerOptions): IntegerDefinition;
+/** Trusted implementation for the portable `integer` definition. */
+declare const integerGenerator: GeneratorImplementation<IntegerDefinition, number>;
+/** Registers the integer built-in with an advanced custom registry. */
+declare function registerIntegerGenerator(registry: GeneratorRegistry): void;
+//#endregion
+export { ArrayDefinition, ArrayOptions, BooleanDefinition, ChoiceDefinition, DateDefinition, DateOptions, DecimalDefinition, DecimalOptions, IntegerDefinition, IntegerOptions, MAX_ARRAY_LENGTH, MAX_DECIMAL_PRECISION, MAX_STRING_LENGTH, ObjectDefinition, ObjectFields, ObjectOutput, StringCharset, StringDefinition, StringOptions, UuidDefinition, array, arrayGenerator, boolean, booleanGenerator, choice, choiceGenerator, date, dateGenerator, decimal, decimalGenerator, integer, integerGenerator, object, objectGenerator, registerArrayGenerator, registerBooleanGenerator, registerChoiceGenerator, registerDateGenerator, registerDecimalGenerator, registerIntegerGenerator, registerObjectGenerator, registerStringGenerator, registerUuidGenerator, string, stringGenerator, uuid, uuidGenerator };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;cAea;cACA;cACA;cAEP;;;;;;KAQM,iBAAiB;WAClB;;;iBAIK,QAAQ;cAIX,eAAe,wBAAwB;iBAapC,sBAAsB,UAAU;KAIpC,eAAe,SAAS,eAAe;KACvC,aAAa,eAAe,mBACrC,aAAa,SAAS,eAAe,OAAO;KAEnC,iBAAiB,eAAe,eAAe,gBACzD,oBAAoB,aAAa;WACtB;WACA,QAAQ;;KAGhB,eAAe,cAClB,mBAAmB,0BAA0B,UAAU;;iBAGzC,aAAa,eAAe,cAC1C,QAAQ,SACP,iBAAiB;cAUP,iBAAiB,wBAC5B,kBACA;iBAcc,wBAAwB,UAAU;KAItC;WACD;;KAEC,gBACV,aAAa,sBAAsB,uBACjC,oBAAoB,eAAe;WAC5B;WACA,MAAM;WACN;;;iBAIK,YAAY,aAAa,qBACvC,MAAM,MACN,SAAS,eACR,gBAAgB;cAeN,gBAAgB,wBAC3B;iBAec,uBAAuB,UAAU;KAIrC,iBAAiB,cAAc,YAAY,aACrD,oBAAoB;WACT;WACA,iBAAiB;;;iBAId,aAAa,wBAAwB,aACnD,QAAQ,SACP,iBAAiB;cASP,iBAAiB,wBAC5B,kBACA;iBAYc,wBAAwB,UAAU;KAItC;WACD;WACA;WACA;;KAGC,oBAAoB;WACrB;WACA;WACA;WACA;;;iBAIK,QAAQ,SAAS,iBAAiB;cAWrC,kBAAkB,wBAC7B;iBAcc,yBAAyB,UAAU;KAIvC,6BAA6B;KAC7B;WACD;WACA,UAAU;;KAGT,mBAAmB;WACpB;WACA;WACA;;;iBAIK,OAAO,SAAS,gBAAgB;cAYnC,iBAAiB,wBAC5B;iBAgBc,wBAAwB,UAAU;KAItC;WACD;WACA;;KAGC,iBAAiB;WAClB;WACA;WACA;;;iBAIK,KAAK,SAAS,cAAc;cAW/B,eAAe,wBAAwB;iBAcpC,sBAAsB,UAAU;KAIpC;WACD;WACA;;KAGC,oBAAoB;WACrB;;;iBAIK,WAAW;;cAKd,kBAAkB,wBAC7B;;iBAYc,yBAAyB,UAAU;KAIvC,oBAAoB;WACrB;WACA;WACA;;;iBAIK,QAAQ,SAAS,iBAAiB;;cAsBrC,kBAAkB,wBAC7B;;iBAac,yBAAyB,UAAU"}

package/dist/index.js

@@ -0,0 +1,388 @@
+import { createGeneratorDefinition, defineGenerator } from "constructa-core";
+import { ConstructaError, validateGeneratorDefinition, validateJsonValue } from "constructa-schema";
+//#region src/index.ts
+const MAX_DECIMAL_PRECISION = 15;
+const MAX_STRING_LENGTH = 1e4;
+const MAX_ARRAY_LENGTH = 1e4;
+const STRING_CHARSETS = {
+	alphabetic: "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ",
+	numeric: "0123456789",
+	alphanumeric: "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789",
+	hex: "0123456789abcdef"
+};
+/** Builds a portable UUID version 4 definition. */
+function uuid() {
+	return createGeneratorDefinition({ type: "uuid" });
+}
+const uuidGenerator = defineGenerator({
+	type: "uuid",
+	version: 1,
+	validateDefinition: validateUuidDefinition,
+	generate({ context }) {
+		const bytes = context.random.bytes(16);
+		bytes[6] = (bytes[6] ?? 0) & 15 | 64;
+		bytes[8] = (bytes[8] ?? 0) & 63 | 128;
+		return formatUuid(bytes);
+	}
+});
+function registerUuidGenerator(registry) {
+	registry.register(uuidGenerator);
+}
+function object(fields) {
+	assertValidGeneratorOptions(validateObjectDefinition({
+		type: "object",
+		fields
+	}));
+	return createGeneratorDefinition({
+		type: "object",
+		fields
+	});
+}
+const objectGenerator = defineGenerator({
+	type: "object",
+	version: 1,
+	validateDefinition: validateObjectDefinition,
+	generate({ definition, context }) {
+		const result = {};
+		for (const [key, child] of Object.entries(definition.fields)) result[key] = context.executeChild(child, key);
+		return result;
+	}
+});
+function registerObjectGenerator(registry) {
+	registry.register(objectGenerator);
+}
+function array(item, options) {
+	assertValidGeneratorOptions(validateArrayDefinition({
+		type: "array",
+		item,
+		...isDefinitionRecord(options) ? options : { length: void 0 }
+	}));
+	return createGeneratorDefinition({
+		type: "array",
+		item,
+		length: options.length
+	});
+}
+const arrayGenerator = defineGenerator({
+	type: "array",
+	version: 1,
+	validateDefinition: validateArrayDefinition,
+	generate({ definition, context }) {
+		const result = [];
+		for (let index = 0; index < definition.length; index += 1) result.push(context.executeChild(definition.item, index));
+		return result;
+	}
+});
+function registerArrayGenerator(registry) {
+	registry.register(arrayGenerator);
+}
+/** Builds a portable choice definition while preserving array-literal unions. */
+function choice(values) {
+	assertValidGeneratorOptions(validateChoiceDefinition({
+		type: "choice",
+		values
+	}));
+	return createGeneratorDefinition({
+		type: "choice",
+		values
+	});
+}
+const choiceGenerator = defineGenerator({
+	type: "choice",
+	version: 1,
+	validateDefinition: validateChoiceDefinition,
+	generate({ definition, context }) {
+		return definition.values[context.random.integer(definition.values.length)];
+	}
+});
+function registerChoiceGenerator(registry) {
+	registry.register(choiceGenerator);
+}
+function decimal(options) {
+	assertValidGeneratorOptions(validateDecimalDefinition(options));
+	return createGeneratorDefinition({
+		type: "decimal",
+		...options
+	});
+}
+const decimalGenerator = defineGenerator({
+	type: "decimal",
+	version: 1,
+	validateDefinition: validateDecimalDefinition,
+	generate({ definition, context }) {
+		const value = definition.min + context.random.float() * (definition.max - definition.min);
+		return Number(value.toFixed(definition.precision));
+	}
+});
+function registerDecimalGenerator(registry) {
+	registry.register(decimalGenerator);
+}
+function string(options) {
+	const normalized = normalizeStringOptions(options);
+	assertValidGeneratorOptions(validateStringDefinition(normalized));
+	return createGeneratorDefinition({
+		type: "string",
+		...normalized
+	});
+}
+const stringGenerator = defineGenerator({
+	type: "string",
+	version: 1,
+	validateDefinition: validateStringDefinition,
+	generate({ definition, context }) {
+		const characters = Array.from(resolveCharset(definition.charset));
+		let result = "";
+		for (let index = 0; index < definition.length; index += 1) result += characters[context.random.integer(characters.length)];
+		return result;
+	}
+});
+function registerStringGenerator(registry) {
+	registry.register(stringGenerator);
+}
+function date(options) {
+	assertValidGeneratorOptions(validateDateDefinition(options));
+	return createGeneratorDefinition({
+		type: "date",
+		...options
+	});
+}
+const dateGenerator = defineGenerator({
+	type: "date",
+	version: 1,
+	validateDefinition: validateDateDefinition,
+	generate({ definition, context }) {
+		const minimum = isoDateToDay(definition.min);
+		const maximum = isoDateToDay(definition.max);
+		return dayToIsoDate(minimum + context.random.integer(maximum - minimum + 1));
+	}
+});
+function registerDateGenerator(registry) {
+	registry.register(dateGenerator);
+}
+/** Builds a portable, evenly distributed boolean definition. */
+function boolean() {
+	return createGeneratorDefinition({ type: "boolean" });
+}
+/** Trusted implementation for the portable `boolean` definition. */
+const booleanGenerator = defineGenerator({
+	type: "boolean",
+	version: 1,
+	validateDefinition: validateBooleanDefinition,
+	generate({ context }) {
+		return context.random.integer(2) === 1;
+	}
+});
+/** Registers the boolean built-in with an advanced custom registry. */
+function registerBooleanGenerator(registry) {
+	registry.register(booleanGenerator);
+}
+function integer(options) {
+	const issue = validateIntegerDefinition(options)[0];
+	if (issue !== void 0) throw new ConstructaError({
+		kind: "configuration",
+		code: "INVALID_RANGE",
+		path: issue.path,
+		message: issue.message,
+		details: { issueCode: issue.code }
+	});
+	const definition = options;
+	return createGeneratorDefinition({
+		type: "integer",
+		min: definition.min,
+		max: definition.max
+	});
+}
+/** Trusted implementation for the portable `integer` definition. */
+const integerGenerator = defineGenerator({
+	type: "integer",
+	version: 1,
+	validateDefinition: validateIntegerDefinition,
+	generate({ definition, context }) {
+		const rangeSize = definition.max - definition.min + 1;
+		return definition.min + context.random.integer(rangeSize);
+	}
+});
+/** Registers the integer built-in with an advanced custom registry. */
+function registerIntegerGenerator(registry) {
+	registry.register(integerGenerator);
+}
+function validateIntegerDefinition(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return [invalidRange([], "integer definition must be an object")];
+	const definition = value;
+	const issues = [];
+	if (!Number.isSafeInteger(definition.min)) issues.push(invalidRange(["min"], "min must be a safe integer"));
+	if (!Number.isSafeInteger(definition.max)) issues.push(invalidRange(["max"], "max must be a safe integer"));
+	if (issues.length > 0) return issues;
+	const min = definition.min;
+	const max = definition.max;
+	if (min > max) return [invalidRange(["min"], "min must be less than or equal to max")];
+	if (!Number.isSafeInteger(max - min + 1)) return [invalidRange(["max"], "the inclusive integer range must fit within a safe integer")];
+	return [];
+}
+function validateUuidDefinition(value) {
+	return validateExactDefinitionKeys(value, "uuid", []);
+}
+function validateObjectDefinition(value) {
+	const keyIssues = validateExactDefinitionKeys(value, "object", ["fields"]);
+	if (keyIssues.length > 0) return keyIssues;
+	const fields = value.fields;
+	if (!isDefinitionRecord(fields)) return [invalidConfiguration(["fields"], "fields must be an object")];
+	const issues = [];
+	for (const [key, child] of Object.entries(fields)) for (const issue of validateGeneratorDefinition(child)) issues.push({
+		...issue,
+		path: [
+			"fields",
+			key,
+			...issue.path
+		]
+	});
+	return issues;
+}
+function validateArrayDefinition(value) {
+	const keyIssues = validateExactDefinitionKeys(value, "array", ["item", "length"]);
+	if (keyIssues.length > 0) return keyIssues;
+	const definition = value;
+	const issues = [];
+	for (const issue of validateGeneratorDefinition(definition.item)) issues.push({
+		...issue,
+		path: ["item", ...issue.path]
+	});
+	if (!Number.isSafeInteger(definition.length) || definition.length < 0 || definition.length > 1e4) issues.push(invalidLength(["length"], `length must be an integer from 0 to ${MAX_ARRAY_LENGTH}`));
+	return issues;
+}
+function validateExactDefinitionKeys(value, type, keys) {
+	if (!isDefinitionRecord(value)) return [invalidConfiguration([], `${type} definition must be an object`)];
+	if (value.type !== type) return [invalidConfiguration(["type"], `type must be ${type}`)];
+	const allowed = /* @__PURE__ */ new Set(["type", ...keys]);
+	return Object.keys(value).filter((key) => !allowed.has(key)).map((key) => invalidConfiguration([key], `Unknown ${type} property: ${key}`));
+}
+function validateBooleanDefinition(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return [{
+		code: "invalid_boolean_definition",
+		path: [],
+		message: "boolean definition must be an object"
+	}];
+	return Object.keys(value).filter((key) => key !== "type").map((key) => ({
+		code: "unknown_property",
+		path: [key],
+		message: `Unknown boolean property: ${key}`
+	}));
+}
+function validateChoiceDefinition(value) {
+	if (!isDefinitionRecord(value) || !Array.isArray(value.values)) return [invalidConfiguration([], "choice definition must contain a values array")];
+	if (value.values.length === 0) return [{
+		code: "empty_choice",
+		path: ["values"],
+		message: "values must not be empty"
+	}];
+	const issues = [];
+	for (let index = 0; index < value.values.length; index += 1) for (const issue of validateJsonValue(value.values[index])) issues.push({
+		...issue,
+		path: [
+			"values",
+			index,
+			...issue.path
+		]
+	});
+	return issues;
+}
+function validateDecimalDefinition(value) {
+	if (!isDefinitionRecord(value)) return [invalidRange([], "decimal definition must be an object")];
+	const issues = [];
+	if (!Number.isFinite(value.min)) issues.push(invalidRange(["min"], "min must be finite"));
+	if (!Number.isFinite(value.max)) issues.push(invalidRange(["max"], "max must be finite"));
+	if (!Number.isSafeInteger(value.precision) || value.precision < 0 || value.precision > 15) issues.push(invalidConfiguration(["precision"], `precision must be an integer from 0 to 15`));
+	if (issues.length > 0) return issues;
+	const min = value.min;
+	const max = value.max;
+	if (min > max || !Number.isFinite(max - min)) return [invalidRange(["max"], "max must be greater than or equal to min within a finite range")];
+	return [];
+}
+function normalizeStringOptions(value) {
+	if (!isDefinitionRecord(value)) return value;
+	return {
+		...value,
+		charset: value.charset ?? "alphanumeric"
+	};
+}
+function validateStringDefinition(value) {
+	if (!isDefinitionRecord(value)) return [invalidConfiguration([], "string definition must be an object")];
+	const issues = [];
+	if (!Number.isSafeInteger(value.length) || value.length < 0 || value.length > 1e4) issues.push(invalidLength(["length"], `length must be an integer from 0 to ${MAX_STRING_LENGTH}`));
+	if (typeof value.charset !== "string" || Array.from(resolveCharset(value.charset)).length === 0) issues.push(invalidConfiguration(["charset"], "charset must be a non-empty string"));
+	return issues;
+}
+function validateDateDefinition(value) {
+	if (!isDefinitionRecord(value)) return [invalidRange([], "date definition must be an object")];
+	const issues = [];
+	if (typeof value.min !== "string" || !isCanonicalIsoDate(value.min)) issues.push(invalidRange(["min"], "min must be a canonical ISO calendar date"));
+	if (typeof value.max !== "string" || !isCanonicalIsoDate(value.max)) issues.push(invalidRange(["max"], "max must be a canonical ISO calendar date"));
+	if (issues.length > 0) return issues;
+	if (isoDateToDay(value.min) > isoDateToDay(value.max)) return [invalidRange(["min"], "min must be on or before max")];
+	return [];
+}
+function assertValidGeneratorOptions(issues) {
+	const issue = issues[0];
+	if (issue === void 0) return;
+	throw new ConstructaError({
+		kind: "configuration",
+		code: {
+			empty_choice: "EMPTY_CHOICE",
+			invalid_length: "INVALID_LENGTH",
+			invalid_range: "INVALID_RANGE"
+		}[issue.code] ?? "INVALID_CONFIGURATION",
+		path: issue.path,
+		message: issue.message,
+		details: { issueCode: issue.code }
+	});
+}
+function isDefinitionRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function resolveCharset(charset) {
+	return STRING_CHARSETS[charset] ?? charset;
+}
+function formatUuid(bytes) {
+	const hexadecimal = Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0"));
+	return `${hexadecimal.slice(0, 4).join("")}-${hexadecimal.slice(4, 6).join("")}-${hexadecimal.slice(6, 8).join("")}-${hexadecimal.slice(8, 10).join("")}-${hexadecimal.slice(10, 16).join("")}`;
+}
+function isCanonicalIsoDate(value) {
+	if (!/^\d{4}-\d{2}-\d{2}$/u.test(value)) return false;
+	const day = isoDateToDay(value);
+	return Number.isFinite(day) && dayToIsoDate(day) === value;
+}
+function isoDateToDay(value) {
+	const [year, month, day] = value.split("-").map(Number);
+	const date = /* @__PURE__ */ new Date(0);
+	date.setUTCFullYear(year, month - 1, day);
+	date.setUTCHours(0, 0, 0, 0);
+	return date.getTime() / 864e5;
+}
+function dayToIsoDate(day) {
+	return (/* @__PURE__ */ new Date(day * 864e5)).toISOString().slice(0, 10);
+}
+function invalidLength(path, message) {
+	return {
+		code: "invalid_length",
+		path,
+		message
+	};
+}
+function invalidConfiguration(path, message) {
+	return {
+		code: "invalid_configuration",
+		path,
+		message
+	};
+}
+function invalidRange(path, message) {
+	return {
+		code: "invalid_range",
+		path,
+		message
+	};
+}
+//#endregion
+export { MAX_ARRAY_LENGTH, MAX_DECIMAL_PRECISION, MAX_STRING_LENGTH, array, arrayGenerator, boolean, booleanGenerator, choice, choiceGenerator, date, dateGenerator, decimal, decimalGenerator, integer, integerGenerator, object, objectGenerator, registerArrayGenerator, registerBooleanGenerator, registerChoiceGenerator, registerDateGenerator, registerDecimalGenerator, registerIntegerGenerator, registerObjectGenerator, registerStringGenerator, registerUuidGenerator, string, stringGenerator, uuid, uuidGenerator };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["definition"],"sources":["../src/index.ts"],"sourcesContent":["import {\n  createGeneratorDefinition,\n  defineGenerator,\n  type GeneratorDefinition,\n  type GeneratorImplementation,\n  type GeneratorRegistry,\n  type ValidationIssue,\n} from \"constructa-core\";\nimport {\n  ConstructaError,\n  type JsonValue,\n  validateGeneratorDefinition,\n  validateJsonValue,\n} from \"constructa-schema\";\n\nexport const MAX_DECIMAL_PRECISION = 15;\nexport const MAX_STRING_LENGTH = 10_000;\nexport const MAX_ARRAY_LENGTH = 10_000;\n\nconst STRING_CHARSETS = {\n  alphabetic: \"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ\",\n  numeric: \"0123456789\",\n  alphanumeric:\n    \"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\",\n  hex: \"0123456789abcdef\",\n} as const;\n\nexport type UuidDefinition = GeneratorDefinition<string> & {\n  readonly type: \"uuid\";\n};\n\n/** Builds a portable UUID version 4 definition. */\nexport function uuid(): UuidDefinition {\n  return createGeneratorDefinition({ type: \"uuid\" }) as UuidDefinition;\n}\n\nexport const uuidGenerator: GeneratorImplementation<UuidDefinition, string> =\n  defineGenerator({\n    type: \"uuid\",\n    version: 1,\n    validateDefinition: validateUuidDefinition,\n    generate({ context }) {\n      const bytes = context.random.bytes(16);\n      bytes[6] = ((bytes[6] ?? 0) & 0x0f) | 0x40;\n      bytes[8] = ((bytes[8] ?? 0) & 0x3f) | 0x80;\n      return formatUuid(bytes);\n    },\n  });\n\nexport function registerUuidGenerator(registry: GeneratorRegistry): void {\n  registry.register(uuidGenerator);\n}\n\nexport type ObjectFields = Readonly<Record<string, GeneratorDefinition>>;\nexport type ObjectOutput<Fields extends ObjectFields> = {\n  [Key in keyof Fields]: InferGenerator<Fields[Key]>;\n};\nexport type ObjectDefinition<Fields extends ObjectFields = ObjectFields> =\n  GeneratorDefinition<ObjectOutput<Fields>> & {\n    readonly type: \"object\";\n    readonly fields: Fields;\n  };\n\ntype InferGenerator<Definition> =\n  Definition extends GeneratorDefinition<infer Output> ? Output : never;\n\n/** Builds a composite object definition from named child definitions. */\nexport function object<const Fields extends ObjectFields>(\n  fields: Fields,\n): ObjectDefinition<Fields>;\nexport function object(fields: unknown): ObjectDefinition {\n  const issues = validateObjectDefinition({ type: \"object\", fields });\n  assertValidGeneratorOptions(issues);\n  return createGeneratorDefinition({\n    type: \"object\",\n    fields: fields as ObjectFields,\n  }) as ObjectDefinition;\n}\n\nexport const objectGenerator: GeneratorImplementation<\n  ObjectDefinition,\n  Record<string, unknown>\n> = defineGenerator({\n  type: \"object\",\n  version: 1,\n  validateDefinition: validateObjectDefinition,\n  generate({ definition, context }) {\n    const result: Record<string, unknown> = {};\n    for (const [key, child] of Object.entries(definition.fields)) {\n      result[key] = context.executeChild(child, key);\n    }\n    return result;\n  },\n});\n\nexport function registerObjectGenerator(registry: GeneratorRegistry): void {\n  registry.register(objectGenerator);\n}\n\nexport type ArrayOptions = {\n  readonly length: number;\n};\nexport type ArrayDefinition<\n  Item extends GeneratorDefinition = GeneratorDefinition,\n> = GeneratorDefinition<InferGenerator<Item>[]> & {\n  readonly type: \"array\";\n  readonly item: Item;\n  readonly length: number;\n};\n\n/** Builds a fixed-length composite array definition. */\nexport function array<const Item extends GeneratorDefinition>(\n  item: Item,\n  options: ArrayOptions,\n): ArrayDefinition<Item>;\nexport function array(item: unknown, options: unknown): ArrayDefinition {\n  const issues = validateArrayDefinition({\n    type: \"array\",\n    item,\n    ...(isDefinitionRecord(options) ? options : { length: undefined }),\n  });\n  assertValidGeneratorOptions(issues);\n  return createGeneratorDefinition({\n    type: \"array\",\n    item: item as GeneratorDefinition,\n    length: (options as ArrayOptions).length,\n  }) as ArrayDefinition;\n}\n\nexport const arrayGenerator: GeneratorImplementation<\n  ArrayDefinition,\n  unknown[]\n> = defineGenerator({\n  type: \"array\",\n  version: 1,\n  validateDefinition: validateArrayDefinition,\n  generate({ definition, context }) {\n    const result: unknown[] = [];\n    for (let index = 0; index < definition.length; index += 1) {\n      result.push(context.executeChild(definition.item, index));\n    }\n    return result;\n  },\n});\n\nexport function registerArrayGenerator(registry: GeneratorRegistry): void {\n  registry.register(arrayGenerator);\n}\n\nexport type ChoiceDefinition<Value extends JsonValue = JsonValue> =\n  GeneratorDefinition<Value> & {\n    readonly type: \"choice\";\n    readonly values: readonly Value[];\n  };\n\n/** Builds a portable choice definition while preserving array-literal unions. */\nexport function choice<const Values extends readonly JsonValue[]>(\n  values: Values,\n): ChoiceDefinition<Values[number]> {\n  const issues = validateChoiceDefinition({ type: \"choice\", values });\n  assertValidGeneratorOptions(issues);\n  return createGeneratorDefinition({\n    type: \"choice\",\n    values,\n  }) as ChoiceDefinition<Values[number]>;\n}\n\nexport const choiceGenerator: GeneratorImplementation<\n  ChoiceDefinition,\n  JsonValue\n> = defineGenerator({\n  type: \"choice\",\n  version: 1,\n  validateDefinition: validateChoiceDefinition,\n  generate({ definition, context }) {\n    return definition.values[\n      context.random.integer(definition.values.length)\n    ] as JsonValue;\n  },\n});\n\nexport function registerChoiceGenerator(registry: GeneratorRegistry): void {\n  registry.register(choiceGenerator);\n}\n\nexport type DecimalOptions = {\n  readonly min: number;\n  readonly max: number;\n  readonly precision: number;\n};\n\nexport type DecimalDefinition = GeneratorDefinition<number> & {\n  readonly type: \"decimal\";\n  readonly min: number;\n  readonly max: number;\n  readonly precision: number;\n};\n\n/** Builds a finite JavaScript-number decimal definition. Precision is at most 15. */\nexport function decimal(options: DecimalOptions): DecimalDefinition;\nexport function decimal(options: unknown): DecimalDefinition {\n  const issues = validateDecimalDefinition(options);\n  assertValidGeneratorOptions(issues);\n  const definition = options as DecimalOptions;\n  return createGeneratorDefinition({\n    type: \"decimal\",\n    ...definition,\n  }) as DecimalDefinition;\n}\n\nexport const decimalGenerator: GeneratorImplementation<\n  DecimalDefinition,\n  number\n> = defineGenerator({\n  type: \"decimal\",\n  version: 1,\n  validateDefinition: validateDecimalDefinition,\n  generate({ definition, context }) {\n    const value =\n      definition.min +\n      context.random.float() * (definition.max - definition.min);\n    return Number(value.toFixed(definition.precision));\n  },\n});\n\nexport function registerDecimalGenerator(registry: GeneratorRegistry): void {\n  registry.register(decimalGenerator);\n}\n\nexport type StringCharset = keyof typeof STRING_CHARSETS | string;\nexport type StringOptions = {\n  readonly length: number;\n  readonly charset?: StringCharset;\n};\n\nexport type StringDefinition = GeneratorDefinition<string> & {\n  readonly type: \"string\";\n  readonly length: number;\n  readonly charset: string;\n};\n\n/** Builds a random-character string definition. The default charset is alphanumeric. */\nexport function string(options: StringOptions): StringDefinition;\nexport function string(options: unknown): StringDefinition {\n  const normalized = normalizeStringOptions(options);\n  const issues = validateStringDefinition(normalized);\n  assertValidGeneratorOptions(issues);\n  const definition = normalized as StringOptions & { readonly charset: string };\n  return createGeneratorDefinition({\n    type: \"string\",\n    ...definition,\n  }) as StringDefinition;\n}\n\nexport const stringGenerator: GeneratorImplementation<\n  StringDefinition,\n  string\n> = defineGenerator({\n  type: \"string\",\n  version: 1,\n  validateDefinition: validateStringDefinition,\n  generate({ definition, context }) {\n    const characters = Array.from(resolveCharset(definition.charset));\n    let result = \"\";\n    for (let index = 0; index < definition.length; index += 1) {\n      result += characters[context.random.integer(characters.length)];\n    }\n    return result;\n  },\n});\n\nexport function registerStringGenerator(registry: GeneratorRegistry): void {\n  registry.register(stringGenerator);\n}\n\nexport type DateOptions = {\n  readonly min: string;\n  readonly max: string;\n};\n\nexport type DateDefinition = GeneratorDefinition<string> & {\n  readonly type: \"date\";\n  readonly min: string;\n  readonly max: string;\n};\n\n/** Builds an inclusive timezone-independent ISO calendar-date definition. */\nexport function date(options: DateOptions): DateDefinition;\nexport function date(options: unknown): DateDefinition {\n  const issues = validateDateDefinition(options);\n  assertValidGeneratorOptions(issues);\n  const definition = options as DateOptions;\n  return createGeneratorDefinition({\n    type: \"date\",\n    ...definition,\n  }) as DateDefinition;\n}\n\nexport const dateGenerator: GeneratorImplementation<DateDefinition, string> =\n  defineGenerator({\n    type: \"date\",\n    version: 1,\n    validateDefinition: validateDateDefinition,\n    generate({ definition, context }) {\n      const minimum = isoDateToDay(definition.min);\n      const maximum = isoDateToDay(definition.max);\n      return dayToIsoDate(\n        minimum + context.random.integer(maximum - minimum + 1),\n      );\n    },\n  });\n\nexport function registerDateGenerator(registry: GeneratorRegistry): void {\n  registry.register(dateGenerator);\n}\n\nexport type IntegerOptions = {\n  readonly min: number;\n  readonly max: number;\n};\n\nexport type BooleanDefinition = GeneratorDefinition<boolean> & {\n  readonly type: \"boolean\";\n};\n\n/** Builds a portable, evenly distributed boolean definition. */\nexport function boolean(): BooleanDefinition {\n  return createGeneratorDefinition({ type: \"boolean\" }) as BooleanDefinition;\n}\n\n/** Trusted implementation for the portable `boolean` definition. */\nexport const booleanGenerator: GeneratorImplementation<\n  BooleanDefinition,\n  boolean\n> = defineGenerator({\n  type: \"boolean\",\n  version: 1,\n  validateDefinition: validateBooleanDefinition,\n  generate({ context }) {\n    return context.random.integer(2) === 1;\n  },\n});\n\n/** Registers the boolean built-in with an advanced custom registry. */\nexport function registerBooleanGenerator(registry: GeneratorRegistry): void {\n  registry.register(booleanGenerator);\n}\n\nexport type IntegerDefinition = GeneratorDefinition<number> & {\n  readonly type: \"integer\";\n  readonly min: number;\n  readonly max: number;\n};\n\n/** Builds a portable integer definition with inclusive minimum and maximum bounds. */\nexport function integer(options: IntegerOptions): IntegerDefinition;\nexport function integer(options: unknown): IntegerDefinition {\n  const issues = validateIntegerDefinition(options);\n  const issue = issues[0];\n  if (issue !== undefined) {\n    throw new ConstructaError({\n      kind: \"configuration\",\n      code: \"INVALID_RANGE\",\n      path: issue.path,\n      message: issue.message,\n      details: { issueCode: issue.code },\n    });\n  }\n  const definition = options as IntegerOptions;\n  return createGeneratorDefinition({\n    type: \"integer\",\n    min: definition.min,\n    max: definition.max,\n  }) as IntegerDefinition;\n}\n\n/** Trusted implementation for the portable `integer` definition. */\nexport const integerGenerator: GeneratorImplementation<\n  IntegerDefinition,\n  number\n> = defineGenerator({\n  type: \"integer\",\n  version: 1,\n  validateDefinition: validateIntegerDefinition,\n  generate({ definition, context }) {\n    const rangeSize = definition.max - definition.min + 1;\n    return definition.min + context.random.integer(rangeSize);\n  },\n});\n\n/** Registers the integer built-in with an advanced custom registry. */\nexport function registerIntegerGenerator(registry: GeneratorRegistry): void {\n  registry.register(integerGenerator);\n}\n\nfunction validateIntegerDefinition(value: unknown): readonly ValidationIssue[] {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    return [invalidRange([], \"integer definition must be an object\")];\n  }\n\n  const definition = value as {\n    readonly min?: unknown;\n    readonly max?: unknown;\n  };\n  const issues: ValidationIssue[] = [];\n  if (!Number.isSafeInteger(definition.min)) {\n    issues.push(invalidRange([\"min\"], \"min must be a safe integer\"));\n  }\n  if (!Number.isSafeInteger(definition.max)) {\n    issues.push(invalidRange([\"max\"], \"max must be a safe integer\"));\n  }\n  if (issues.length > 0) return issues;\n\n  const min = definition.min as number;\n  const max = definition.max as number;\n  if (min > max) {\n    return [invalidRange([\"min\"], \"min must be less than or equal to max\")];\n  }\n  if (!Number.isSafeInteger(max - min + 1)) {\n    return [\n      invalidRange(\n        [\"max\"],\n        \"the inclusive integer range must fit within a safe integer\",\n      ),\n    ];\n  }\n  return [];\n}\n\nfunction validateUuidDefinition(value: unknown): readonly ValidationIssue[] {\n  return validateExactDefinitionKeys(value, \"uuid\", []);\n}\n\nfunction validateObjectDefinition(value: unknown): readonly ValidationIssue[] {\n  const keyIssues = validateExactDefinitionKeys(value, \"object\", [\"fields\"]);\n  if (keyIssues.length > 0) return keyIssues;\n\n  const fields = (value as { readonly fields?: unknown }).fields;\n  if (!isDefinitionRecord(fields)) {\n    return [invalidConfiguration([\"fields\"], \"fields must be an object\")];\n  }\n\n  const issues: ValidationIssue[] = [];\n  for (const [key, child] of Object.entries(fields)) {\n    for (const issue of validateGeneratorDefinition(child)) {\n      issues.push({ ...issue, path: [\"fields\", key, ...issue.path] });\n    }\n  }\n  return issues;\n}\n\nfunction validateArrayDefinition(value: unknown): readonly ValidationIssue[] {\n  const keyIssues = validateExactDefinitionKeys(value, \"array\", [\n    \"item\",\n    \"length\",\n  ]);\n  if (keyIssues.length > 0) return keyIssues;\n\n  const definition = value as {\n    readonly item?: unknown;\n    readonly length?: unknown;\n  };\n  const issues: ValidationIssue[] = [];\n  for (const issue of validateGeneratorDefinition(definition.item)) {\n    issues.push({ ...issue, path: [\"item\", ...issue.path] });\n  }\n  if (\n    !Number.isSafeInteger(definition.length) ||\n    (definition.length as number) < 0 ||\n    (definition.length as number) > MAX_ARRAY_LENGTH\n  ) {\n    issues.push(\n      invalidLength(\n        [\"length\"],\n        `length must be an integer from 0 to ${MAX_ARRAY_LENGTH}`,\n      ),\n    );\n  }\n  return issues;\n}\n\nfunction validateExactDefinitionKeys(\n  value: unknown,\n  type: string,\n  keys: readonly string[],\n): readonly ValidationIssue[] {\n  if (!isDefinitionRecord(value)) {\n    return [invalidConfiguration([], `${type} definition must be an object`)];\n  }\n  const definition = value as { readonly type?: unknown };\n  if (definition.type !== type) {\n    return [invalidConfiguration([\"type\"], `type must be ${type}`)];\n  }\n  const allowed = new Set([\"type\", ...keys]);\n  return Object.keys(value)\n    .filter((key) => !allowed.has(key))\n    .map((key) =>\n      invalidConfiguration([key], `Unknown ${type} property: ${key}`),\n    );\n}\n\nfunction validateBooleanDefinition(value: unknown): readonly ValidationIssue[] {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    return [\n      {\n        code: \"invalid_boolean_definition\",\n        path: [],\n        message: \"boolean definition must be an object\",\n      },\n    ];\n  }\n  return Object.keys(value)\n    .filter((key) => key !== \"type\")\n    .map((key) => ({\n      code: \"unknown_property\",\n      path: [key],\n      message: `Unknown boolean property: ${key}`,\n    }));\n}\n\nfunction validateChoiceDefinition(value: unknown): readonly ValidationIssue[] {\n  if (!isDefinitionRecord(value) || !Array.isArray(value.values)) {\n    return [\n      invalidConfiguration([], \"choice definition must contain a values array\"),\n    ];\n  }\n  if (value.values.length === 0) {\n    return [\n      {\n        code: \"empty_choice\",\n        path: [\"values\"],\n        message: \"values must not be empty\",\n      },\n    ];\n  }\n  const issues: ValidationIssue[] = [];\n  for (let index = 0; index < value.values.length; index += 1) {\n    for (const issue of validateJsonValue(value.values[index])) {\n      issues.push({ ...issue, path: [\"values\", index, ...issue.path] });\n    }\n  }\n  return issues;\n}\n\nfunction validateDecimalDefinition(value: unknown): readonly ValidationIssue[] {\n  if (!isDefinitionRecord(value)) {\n    return [invalidRange([], \"decimal definition must be an object\")];\n  }\n  const issues: ValidationIssue[] = [];\n  if (!Number.isFinite(value.min))\n    issues.push(invalidRange([\"min\"], \"min must be finite\"));\n  if (!Number.isFinite(value.max))\n    issues.push(invalidRange([\"max\"], \"max must be finite\"));\n  if (\n    !Number.isSafeInteger(value.precision) ||\n    (value.precision as number) < 0 ||\n    (value.precision as number) > MAX_DECIMAL_PRECISION\n  ) {\n    issues.push(\n      invalidConfiguration(\n        [\"precision\"],\n        `precision must be an integer from 0 to ${MAX_DECIMAL_PRECISION}`,\n      ),\n    );\n  }\n  if (issues.length > 0) return issues;\n  const min = value.min as number;\n  const max = value.max as number;\n  if (min > max || !Number.isFinite(max - min)) {\n    return [\n      invalidRange(\n        [\"max\"],\n        \"max must be greater than or equal to min within a finite range\",\n      ),\n    ];\n  }\n  return [];\n}\n\nfunction normalizeStringOptions(value: unknown): unknown {\n  if (!isDefinitionRecord(value)) return value;\n  return { ...value, charset: value.charset ?? \"alphanumeric\" };\n}\n\nfunction validateStringDefinition(value: unknown): readonly ValidationIssue[] {\n  if (!isDefinitionRecord(value)) {\n    return [invalidConfiguration([], \"string definition must be an object\")];\n  }\n  const issues: ValidationIssue[] = [];\n  if (\n    !Number.isSafeInteger(value.length) ||\n    (value.length as number) < 0 ||\n    (value.length as number) > MAX_STRING_LENGTH\n  ) {\n    issues.push(\n      invalidLength(\n        [\"length\"],\n        `length must be an integer from 0 to ${MAX_STRING_LENGTH}`,\n      ),\n    );\n  }\n  if (\n    typeof value.charset !== \"string\" ||\n    Array.from(resolveCharset(value.charset)).length === 0\n  ) {\n    issues.push(\n      invalidConfiguration([\"charset\"], \"charset must be a non-empty string\"),\n    );\n  }\n  return issues;\n}\n\nfunction validateDateDefinition(value: unknown): readonly ValidationIssue[] {\n  if (!isDefinitionRecord(value)) {\n    return [invalidRange([], \"date definition must be an object\")];\n  }\n  const issues: ValidationIssue[] = [];\n  if (typeof value.min !== \"string\" || !isCanonicalIsoDate(value.min)) {\n    issues.push(\n      invalidRange([\"min\"], \"min must be a canonical ISO calendar date\"),\n    );\n  }\n  if (typeof value.max !== \"string\" || !isCanonicalIsoDate(value.max)) {\n    issues.push(\n      invalidRange([\"max\"], \"max must be a canonical ISO calendar date\"),\n    );\n  }\n  if (issues.length > 0) return issues;\n  if (isoDateToDay(value.min as string) > isoDateToDay(value.max as string)) {\n    return [invalidRange([\"min\"], \"min must be on or before max\")];\n  }\n  return [];\n}\n\nfunction assertValidGeneratorOptions(issues: readonly ValidationIssue[]): void {\n  const issue = issues[0];\n  if (issue === undefined) return;\n  const codes: Record<string, Uppercase<string>> = {\n    empty_choice: \"EMPTY_CHOICE\",\n    invalid_length: \"INVALID_LENGTH\",\n    invalid_range: \"INVALID_RANGE\",\n  };\n  throw new ConstructaError({\n    kind: \"configuration\",\n    code: codes[issue.code] ?? \"INVALID_CONFIGURATION\",\n    path: issue.path,\n    message: issue.message,\n    details: { issueCode: issue.code },\n  });\n}\n\nfunction isDefinitionRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction resolveCharset(charset: string): string {\n  return STRING_CHARSETS[charset as keyof typeof STRING_CHARSETS] ?? charset;\n}\n\nfunction formatUuid(bytes: Uint8Array): string {\n  const hexadecimal = Array.from(bytes, (byte) =>\n    byte.toString(16).padStart(2, \"0\"),\n  );\n  return `${hexadecimal.slice(0, 4).join(\"\")}-${hexadecimal.slice(4, 6).join(\"\")}-${hexadecimal.slice(6, 8).join(\"\")}-${hexadecimal.slice(8, 10).join(\"\")}-${hexadecimal.slice(10, 16).join(\"\")}`;\n}\n\nfunction isCanonicalIsoDate(value: string): boolean {\n  if (!/^\\d{4}-\\d{2}-\\d{2}$/u.test(value)) return false;\n  const day = isoDateToDay(value);\n  return Number.isFinite(day) && dayToIsoDate(day) === value;\n}\n\nfunction isoDateToDay(value: string): number {\n  const [year, month, day] = value.split(\"-\").map(Number);\n  const date = new Date(0);\n  date.setUTCFullYear(year as number, (month as number) - 1, day as number);\n  date.setUTCHours(0, 0, 0, 0);\n  return date.getTime() / 86_400_000;\n}\n\nfunction dayToIsoDate(day: number): string {\n  return new Date(day * 86_400_000).toISOString().slice(0, 10);\n}\n\nfunction invalidLength(\n  path: readonly (string | number)[],\n  message: string,\n): ValidationIssue {\n  return { code: \"invalid_length\", path, message };\n}\n\nfunction invalidConfiguration(\n  path: readonly (string | number)[],\n  message: string,\n): ValidationIssue {\n  return { code: \"invalid_configuration\", path, message };\n}\n\nfunction invalidRange(\n  path: readonly (string | number)[],\n  message: string,\n): ValidationIssue {\n  return { code: \"invalid_range\", path, message };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "constructa-generators",
-  "version": "0.0.11",
+  "version": "0.1.0",
   "description": "Built-in primitive and composite generators for Constructa.",
   "private": false,
   "license": "MIT",
@@ -26,7 +26,7 @@
     "access": "public"
   },
   "dependencies": {
-    "constructa-core": "0.4.0",
+    "constructa-core": "0.5.0",
     "constructa-schema": "2.2.0"
   },
   "devDependencies": {