@nicolastoulemont/std 0.4.0 → 0.5.0

package/dist/adt-DH37Pprw.mjs

@@ -1,318 +0,0 @@
-import { i as createHashMethod, n as createADTHashMethod, r as createEqualsMethod, t as createADTEqualsMethod } from "./equality-C2l3BIi8.mjs";
-import { n as isPromise } from "./flow-D4cE0EAg.mjs";
-import { f as ok, r as err } from "./result-DhYA-J-M.mjs";
-
-//#region src/shared/is-plain-object.ts
-/**
-* Check if a value is a plain object.
-* A plain object is an object created with `{}`, `Object.create(null)`, or `new Object()`.
-* Arrays, functions, dates, maps, etc. are not considered plain objects.
-*/
-function isPlainObject(value) {
-	if (value === null || typeof value !== "object") return false;
-	const proto = Object.getPrototypeOf(value);
-	return proto === null || proto === Object.prototype;
-}
-
-//#endregion
-//#region src/adt/adt.utils.ts
-/**
-* Check if a value is a RecordObject created by record().
-* RecordObjects are callable functions with static properties.
-*/
-function isRecord(value) {
-	return typeof value === "function" && "_record" in value && value["_record"] === true;
-}
-/**
-* Wrap Standard Schema validation result into our Result type.
-*/
-function wrapValidationResult(result) {
-	if (result.issues) return err({ issues: result.issues.map((issue) => ({
-		message: issue.message,
-		path: issue.path?.map((segment) => typeof segment === "object" && "key" in segment ? segment.key : segment)
-	})) });
-	return ok(result.value);
-}
-/**
-* Validate data using a Standard Schema, enforcing sync-only validation.
-* Throws if the schema returns a Promise.
-*/
-function validateSync(schema, data$1, _tag) {
-	const result = schema["~standard"].validate(data$1);
-	if (isPromise(result)) throw new Error(`Async validation not supported. Schema for "${_tag}" returned a Promise. Use a synchronous schema or handle async validation separately.`);
-	return wrapValidationResult(result);
-}
-/**
-* Create a type guard function for a specific _tag.
-*/
-function createIsGuard(_tag) {
-	return (value) => {
-		return isPlainObject(value) && "_tag" in value && value["_tag"] === _tag;
-	};
-}
-/**
-* Create a type guard function for multiple _tags (ADT root guard).
-*/
-function createIsAnyGuard(_tags) {
-	const _tagSet = new Set(_tags);
-	return (value) => {
-		return isPlainObject(value) && "_tag" in value && typeof value["_tag"] === "string" && _tagSet.has(value["_tag"]);
-	};
-}
-
-//#endregion
-//#region src/adt/adt.codec.ts
-/**
-* Create a CodecError with consistent structure.
-*/
-function createCodecError(kind, message, cause, validationIssues) {
-	if (cause !== void 0 && validationIssues !== void 0) return {
-		kind,
-		message,
-		cause,
-		validationIssues
-	};
-	if (cause !== void 0) return {
-		kind,
-		message,
-		cause
-	};
-	if (validationIssues !== void 0) return {
-		kind,
-		message,
-		validationIssues
-	};
-	return {
-		kind,
-		message
-	};
-}
-/**
-* Built-in JSON codec that works with any schema.
-* Encodes to JSON string and decodes with JSON.parse.
-*/
-function createJsonCodec(_tag) {
-	return {
-		to: (value) => {
-			return JSON.stringify(value);
-		},
-		from: (input) => {
-			try {
-				const parsed = JSON.parse(input);
-				if (typeof parsed === "object" && parsed !== null && "_tag" in parsed) {
-					const { _tag: _, ...rest } = parsed;
-					return rest;
-				}
-				return parsed;
-			} catch {
-				return null;
-			}
-		}
-	};
-}
-/**
-* Create the "to" methods object with JSON codec and custom codecs.
-* All methods return Result<T, CodecError> for consistent error handling.
-*/
-function createToMethods(_tag, schema, customCodecs) {
-	const jsonCodec = createJsonCodec(_tag);
-	const to = { json: (value) => {
-		const result = validateSync(schema, {
-			...value,
-			_tag
-		}, _tag);
-		if (!result.ok) return err(createCodecError("ValidationError", `Cannot encode invalid data: ${result.error.issues.map((i) => i.message).join(", ")}`, void 0, result.error.issues));
-		try {
-			return ok(jsonCodec.to(result.value));
-		} catch (e) {
-			return err(createCodecError("EncodingError", `JSON encoding failed: ${e instanceof Error ? e.message : String(e)}`, e));
-		}
-	} };
-	if (customCodecs) for (const [name, codec] of Object.entries(customCodecs)) to[name] = (value) => {
-		const result = validateSync(schema, {
-			...value,
-			_tag
-		}, _tag);
-		if (!result.ok) return err(createCodecError("ValidationError", `Cannot encode invalid data: ${result.error.issues.map((i) => i.message).join(", ")}`, void 0, result.error.issues));
-		try {
-			return ok(codec.to(result.value));
-		} catch (e) {
-			return err(createCodecError("EncodingError", `Encoding with codec '${name}' failed: ${e instanceof Error ? e.message : String(e)}`, e));
-		}
-	};
-	return to;
-}
-/**
-* Create the "from" methods object with JSON codec and custom codecs.
-* All methods return Result<T, CodecError> for consistent error handling.
-*/
-function createFromMethods(_tag, schema, customCodecs) {
-	const jsonCodec = createJsonCodec(_tag);
-	const from = { json: (input) => {
-		const decoded = jsonCodec.from(input);
-		if (decoded === null) return err(createCodecError("DecodingError", "Invalid JSON format"));
-		const result = validateSync(schema, {
-			...decoded,
-			_tag
-		}, _tag);
-		if (!result.ok) return err(createCodecError("ValidationError", "Decoded data failed schema validation", void 0, result.error.issues));
-		return ok({
-			...result.value,
-			_tag
-		});
-	} };
-	if (customCodecs) for (const [name, codec] of Object.entries(customCodecs)) from[name] = (input) => {
-		let decoded;
-		try {
-			decoded = codec.from(input);
-		} catch (e) {
-			return err(createCodecError("DecodingError", `Decoding with codec '${name}' threw an error`, e));
-		}
-		if (decoded === null) return err(createCodecError("DecodingError", `Codec '${name}' failed to decode input`));
-		const result = validateSync(schema, {
-			...decoded,
-			_tag
-		}, _tag);
-		if (!result.ok) return err(createCodecError("ValidationError", "Decoded data failed schema validation", void 0, result.error.issues));
-		return ok({
-			...result.value,
-			_tag
-		});
-	};
-	return from;
-}
-
-//#endregion
-//#region src/adt/adt.record.ts
-function record(_tag, schema, codecs) {
-	const isGuard = createIsGuard(_tag);
-	const to = createToMethods(_tag, schema, codecs);
-	const from = createFromMethods(_tag, schema, codecs);
-	const equals = createEqualsMethod(_tag);
-	const hash = createHashMethod(_tag);
-	const constructor = (input) => {
-		const result = validateSync(schema, {
-			...input,
-			_tag
-		}, _tag);
-		if (!result.ok) return err(result.error);
-		return ok({
-			...result.value,
-			_tag
-		});
-	};
-	constructor._record = true;
-	constructor._tag = _tag;
-	constructor.schema = schema;
-	if (codecs) constructor.codecs = codecs;
-	constructor.is = isGuard;
-	constructor.to = to;
-	constructor.from = from;
-	constructor.equals = equals;
-	constructor.hash = hash;
-	return constructor;
-}
-
-//#endregion
-//#region src/adt/adt.data.ts
-/**
-* Compose records or schemas into a discriminated union (ADT).
-*
-* Accepts either:
-* - Pre-built RecordObjects from record() (codecs are preserved)
-* - Raw Standard Schema validators (will be wrapped internally)
-*
-* When using pre-built records, the object key overrides the original _tag.
-*
-* @template R - Record of variant names to RecordObjects or StandardSchema validators
-* @param name - The name of this ADT (for identification)
-* @param records - An object mapping _tag names to RecordObjects or schemas
-* @returns An ADT object with accessors for each variant
-*
-* @see {@link record} for creating individual record types
-* @see {@link match} for exhaustive pattern matching on ADT values
-*
-* @example
-* ```ts
-* // From pre-built records
-* const Circle = record('Circle', CircleSchema)
-* const Square = record('Square', SquareSchema)
-* const Shape = data('Shape', { Circle, Square })
-*
-* // From raw schemas (JSON codec is automatically included)
-* const Shape = data('Shape', {
-*   Circle: CircleSchema,
-*   Square: SquareSchema
-* })
-*
-* // JSON codec works on all variants
-* Shape.Circle.to.json({ radius: 10 })
-* Shape.Circle.from.json(jsonString)
-*
-* // Mixed
-* const Shape = data('Shape', {
-*   Circle,              // Pre-built record
-*   Square: SquareSchema // Raw schema
-* })
-*
-* // Usage
-* Shape.Circle({ radius: 10 })
-* Shape.is(someValue)        // type guard for any variant
-* Shape.Circle.is(someValue) // type guard for Circle
-* ```
-*/
-function data(name, records) {
-	const tags = Object.keys(records);
-	const variants = {};
-	for (const [_tag, def] of Object.entries(records)) if (isRecord(def)) if (def._tag === _tag) variants[_tag] = def;
-	else if (def.codecs) variants[_tag] = record(_tag, def.schema, def.codecs);
-	else variants[_tag] = record(_tag, def.schema);
-	else variants[_tag] = record(_tag, def);
-	return {
-		_name: name,
-		is: createIsAnyGuard(tags),
-		equals: createADTEqualsMethod(tags),
-		hash: createADTHashMethod(tags),
-		...variants
-	};
-}
-
-//#endregion
-//#region src/adt/adt.match.ts
-/**
-* Exhaustive pattern matching for discriminated unions.
-*
-* TypeScript will error if any variant is missing from handlers,
-* ensuring exhaustive handling of all cases.
-*
-* @template T - The discriminated union type (must have readonly _tag)
-* @template TResult - The return type of all handlers
-* @template Handlers - The handler object type (inferred)
-* @param value - A discriminated union value with _tag
-* @param handlers - An object with a handler function for each variant
-* @returns The result of calling the matching handler
-*
-* @see {@link data} for creating discriminated unions
-* @see {@link record} for creating individual record types
-*
-* @example
-* ```ts
-* const Shape = data('Shape', { Circle, Square })
-* type Shape = Infer<typeof Shape>
-*
-* function describeShape(shape: Shape): string {
-*   return match(shape, {
-*     Circle: (c) => `Circle with radius ${c.radius}`,
-*     Square: (s) => `Square with size ${s.size}`,
-*   })
-* }
-* ```
-*/
-function match(value, handlers) {
-	const handler = handlers[value._tag];
-	return handler(value);
-}
-
-//#endregion
-export { createCodecError as i, data as n, record as r, match as t };
-//# sourceMappingURL=adt-DH37Pprw.mjs.map

package/dist/adt-DH37Pprw.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"adt-DH37Pprw.mjs","names":["data"],"sources":["../src/shared/is-plain-object.ts","../src/adt/adt.utils.ts","../src/adt/adt.codec.ts","../src/adt/adt.record.ts","../src/adt/adt.data.ts","../src/adt/adt.match.ts"],"sourcesContent":["/**\n * Check if a value is a plain object.\n * A plain object is an object created with `{}`, `Object.create(null)`, or `new Object()`.\n * Arrays, functions, dates, maps, etc. are not considered plain objects.\n */\nexport function isPlainObject(value: unknown): value is Record<PropertyKey, unknown> {\n  if (value === null || typeof value !== \"object\") {\n    return false\n  }\n\n  const proto = Object.getPrototypeOf(value)\n  return proto === null || proto === Object.prototype\n}\n","import { ok, err } from \"../result/result\"\nimport type { Result } from \"../result/result.types\"\nimport { isPlainObject } from \"../shared/is-plain-object\"\nimport { isPromise } from \"../shared/is-promise\"\nimport type { RecordObject, ValidationError } from \"./adt.types\"\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\"\n\n/**\n * Check if a value is a RecordObject created by record().\n * RecordObjects are callable functions with static properties.\n */\nexport function isRecord(value: unknown): value is RecordObject {\n  return typeof value === \"function\" && \"_record\" in value && value[\"_record\"] === true\n}\n\n/**\n * Wrap Standard Schema validation result into our Result type.\n */\nfunction wrapValidationResult<T>(result: StandardSchemaV1.Result<T>): Result<T, ValidationError> {\n  if (result.issues) {\n    return err({\n      issues: result.issues.map((issue) => ({\n        message: issue.message,\n        path: issue.path?.map((segment) => (typeof segment === \"object\" && \"key\" in segment ? segment.key : segment)),\n      })),\n    })\n  }\n  return ok(result.value)\n}\n\n/**\n * Validate data using a Standard Schema, enforcing sync-only validation.\n * Throws if the schema returns a Promise.\n */\nexport function validateSync<T>(\n  schema: StandardSchemaV1<unknown, T>,\n  data: unknown,\n  _tag: string,\n): Result<T, ValidationError> {\n  const result = schema[\"~standard\"].validate(data)\n\n  if (isPromise(result)) {\n    throw new Error(\n      `Async validation not supported. Schema for \"${_tag}\" returned a Promise. ` +\n        `Use a synchronous schema or handle async validation separately.`,\n    )\n  }\n\n  return wrapValidationResult(result)\n}\n\n/**\n * Create a type guard function for a specific _tag.\n */\nexport function createIsGuard<Tag extends string, T>(\n  _tag: Tag,\n): (value: unknown) => value is T & { readonly _tag: Tag } {\n  return (value: unknown): value is T & { readonly _tag: Tag } => {\n    return isPlainObject(value) && \"_tag\" in value && value[\"_tag\"] === _tag\n  }\n}\n\n/**\n * Create a type guard function for multiple _tags (ADT root guard).\n */\nexport function createIsAnyGuard<T>(_tags: readonly string[]): (value: unknown) => value is T {\n  const _tagSet = new Set(_tags)\n  return (value: unknown): value is T => {\n    return isPlainObject(value) && \"_tag\" in value && typeof value[\"_tag\"] === \"string\" && _tagSet.has(value[\"_tag\"])\n  }\n}\n","import { ok, err } from \"../result/result\"\nimport type { Result } from \"../result/result.types\"\nimport type { Discriminator } from \"../shared/discriminator.types\"\nimport type {\n  CodecConstraint,\n  CodecDef,\n  CodecError,\n  InferInput,\n  InferOutput,\n  ValidationError,\n  ToMethods,\n  FromMethods,\n} from \"./adt.types\"\nimport { validateSync } from \"./adt.utils\"\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\"\n\n/**\n * Create a CodecError with consistent structure.\n */\nexport function createCodecError(\n  kind: CodecError[\"kind\"],\n  message: string,\n  cause?: unknown,\n  validationIssues?: ValidationError[\"issues\"],\n): CodecError {\n  if (cause !== undefined && validationIssues !== undefined) {\n    return { kind, message, cause, validationIssues }\n  }\n  if (cause !== undefined) {\n    return { kind, message, cause }\n  }\n  if (validationIssues !== undefined) {\n    return { kind, message, validationIssues }\n  }\n  return { kind, message }\n}\n\n/**\n * Built-in JSON codec that works with any schema.\n * Encodes to JSON string and decodes with JSON.parse.\n */\nfunction createJsonCodec<Tag extends string, S extends StandardSchemaV1>(\n  _tag: Tag,\n): CodecDef<InferOutput<S> & Discriminator<Tag>, string, InferInput<S>> {\n  return {\n    to: (value) => {\n      // JSON.stringify can throw for circular references, BigInt, etc.\n      // We let it throw and catch it in the wrapper\n      return JSON.stringify(value)\n    },\n    /* oxlint-disable no-unsafe-assignment, no-unsafe-type-assertion, no-unsafe-return -- Required for JSON parsing which returns unknown types */\n    from: (input: string) => {\n      try {\n        const parsed = JSON.parse(input)\n        // Return parsed object without _tag - it will be added during validation\n        if (typeof parsed === \"object\" && parsed !== null && \"_tag\" in parsed) {\n          const { _tag: _, ...rest } = parsed\n          return rest as InferInput<S>\n        }\n        return parsed\n      } catch {\n        return null\n      }\n    },\n    /* oxlint-enable no-unsafe-assignment, no-unsafe-type-assertion, no-unsafe-return */\n  }\n}\n\n/**\n * Create the \"to\" methods object with JSON codec and custom codecs.\n * All methods return Result<T, CodecError> for consistent error handling.\n */\nexport function createToMethods<\n  Tag extends string,\n  S extends StandardSchemaV1,\n  Codecs extends CodecConstraint<Tag, S> | undefined = undefined,\n>(_tag: Tag, schema: S, customCodecs?: Codecs): ToMethods<S, Codecs> {\n  type Output = InferOutput<S> & Discriminator<Tag>\n\n  const jsonCodec = createJsonCodec<Tag, S>(_tag)\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const to: Record<string, (value: InferInput<S>) => Result<any, CodecError>> = {\n    json: (value: InferInput<S>): Result<string, CodecError> => {\n      // First, create a validated record to ensure we're encoding valid data\n      // oxlint-disable-next-line no-unsafe-type-assertion -- Required for spreading generic input into object\n      const taggedInput = { ...(value as object), _tag }\n      const result = validateSync(schema, taggedInput, _tag)\n\n      if (!result.ok) {\n        return err(\n          createCodecError(\n            \"ValidationError\",\n            `Cannot encode invalid data: ${result.error.issues.map((i) => i.message).join(\", \")}`,\n            undefined,\n            result.error.issues,\n          ),\n        )\n      }\n\n      try {\n        // oxlint-disable-next-line no-unsafe-type-assertion -- Required for validated value cast\n        return ok(jsonCodec.to(result.value as Output))\n      } catch (e) {\n        return err(\n          createCodecError(\"EncodingError\", `JSON encoding failed: ${e instanceof Error ? e.message : String(e)}`, e),\n        )\n      }\n    },\n  }\n\n  // Add custom codecs\n  if (customCodecs) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    for (const [name, codec] of Object.entries(customCodecs) as Array<[string, CodecDef<Output, any, any>]>) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      to[name] = (value: InferInput<S>): Result<any, CodecError> => {\n        // Validate input first\n        // oxlint-disable-next-line no-unsafe-type-assertion -- Required for spreading generic input\n        const taggedInput = { ...(value as object), _tag }\n        const result = validateSync(schema, taggedInput, _tag)\n\n        if (!result.ok) {\n          return err(\n            createCodecError(\n              \"ValidationError\",\n              `Cannot encode invalid data: ${result.error.issues.map((i) => i.message).join(\", \")}`,\n              undefined,\n              result.error.issues,\n            ),\n          )\n        }\n\n        try {\n          // oxlint-disable-next-line no-unsafe-type-assertion -- Required for validated value cast\n          return ok(codec.to(result.value as Output))\n        } catch (e) {\n          return err(\n            createCodecError(\n              \"EncodingError\",\n              `Encoding with codec '${name}' failed: ${e instanceof Error ? e.message : String(e)}`,\n              e,\n            ),\n          )\n        }\n      }\n    }\n  }\n\n  // oxlint-disable-next-line no-unsafe-type-assertion -- Required for generic return type\n  return to as ToMethods<S, Codecs>\n}\n\n/**\n * Create the \"from\" methods object with JSON codec and custom codecs.\n * All methods return Result<T, CodecError> for consistent error handling.\n */\nexport function createFromMethods<\n  Tag extends string,\n  S extends StandardSchemaV1,\n  Codecs extends CodecConstraint<Tag, S> | undefined = undefined,\n>(_tag: Tag, schema: S, customCodecs?: Codecs): FromMethods<Tag, S, Codecs> {\n  type Output = InferOutput<S> & Discriminator<Tag>\n\n  const jsonCodec = createJsonCodec<Tag, S>(_tag)\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const from: Record<string, (input: any) => Result<Output, CodecError>> = {\n    json: (input: string): Result<Output, CodecError> => {\n      // Decode\n      const decoded = jsonCodec.from(input)\n      if (decoded === null) {\n        return err(createCodecError(\"DecodingError\", \"Invalid JSON format\"))\n      }\n\n      // Validate through schema\n      // oxlint-disable-next-line no-unsafe-type-assertion -- Required for spreading decoded value\n      const taggedInput = { ...(decoded as object), _tag }\n      const result = validateSync(schema, taggedInput, _tag)\n\n      if (!result.ok) {\n        return err(\n          createCodecError(\"ValidationError\", \"Decoded data failed schema validation\", undefined, result.error.issues),\n        )\n      }\n\n      // Ensure _tag in output\n      // oxlint-disable-next-line no-unsafe-type-assertion -- Required for output construction\n      const output = { ...(result.value as object), _tag } as Output\n      return ok(output)\n    },\n  }\n\n  // Add custom codecs\n  if (customCodecs) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    for (const [name, codec] of Object.entries(customCodecs) as Array<[string, CodecDef<Output, any, any>]>) {\n      from[name] = (input: unknown): Result<Output, CodecError> => {\n        // Decode\n        let decoded: unknown\n        try {\n          decoded = codec.from(input)\n        } catch (e) {\n          return err(createCodecError(\"DecodingError\", `Decoding with codec '${name}' threw an error`, e))\n        }\n\n        if (decoded === null) {\n          return err(createCodecError(\"DecodingError\", `Codec '${name}' failed to decode input`))\n        }\n\n        // Validate through schema\n        // oxlint-disable-next-line no-unsafe-type-assertion -- Required for spreading decoded value\n        const taggedInput = { ...(decoded as object), _tag }\n        const result = validateSync(schema, taggedInput, _tag)\n\n        if (!result.ok) {\n          return err(\n            createCodecError(\n              \"ValidationError\",\n              \"Decoded data failed schema validation\",\n              undefined,\n              result.error.issues,\n            ),\n          )\n        }\n\n        // Ensure _tag in output\n        // oxlint-disable-next-line no-unsafe-type-assertion -- Required for output construction\n        const output = { ...(result.value as object), _tag } as Output\n        return ok(output)\n      }\n    }\n  }\n\n  // oxlint-disable-next-line no-unsafe-type-assertion -- Required for generic return type\n  return from as FromMethods<Tag, S, Codecs>\n}\n","import { createEqualsMethod, createHashMethod } from \"../equality/equality\"\nimport { ok, err } from \"../result/result\"\nimport type { Result } from \"../result/result.types\"\nimport type { Discriminator } from \"../shared/discriminator.types\"\nimport { createToMethods, createFromMethods } from \"./adt.codec\"\nimport type { CodecConstraint, InferInput, InferOutput, RecordObject, ValidationError } from \"./adt.types\"\nimport { createIsGuard, validateSync } from \"./adt.utils\"\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\"\n\n/**\n * Create a standalone tagged record from a Standard Schema with optional codecs.\n *\n * Records can be used independently or composed into an ADT via data().\n * All defaults should be defined at the schema level (e.g., Zod's .default()).\n *\n * @template Tag - The string literal type for the _tag discriminator\n * @template S - The Standard Schema type for validation\n * @template Codecs - Optional codec definitions for custom serialization formats\n * @param _tag - The _tag discriminator value\n * @param schema - A Standard Schema compliant validator\n * @param codecs - Optional codec definitions for custom serialization formats\n * @returns A callable RecordObject with is(), to, and from methods\n *\n * @see {@link data} for composing records into discriminated unions\n * @see {@link tagged} for unvalidated tagged value constructors\n *\n * @example\n * ```ts\n * const CircleSchema = z.object({\n *   radius: z.number().positive(),\n *   color: z.string().default('blue')\n * })\n *\n * // Basic record with JSON codec (always included)\n * const Circle = record('Circle', CircleSchema)\n *\n * const result = Circle({ radius: 10 })\n * // { ok: true, value: { _tag: 'Circle', radius: 10, color: 'blue' } }\n *\n * Circle.is(someValue) // type guard\n *\n * const json = Circle.to.json({ radius: 10 }) // JSON string\n * const result2 = Circle.from.json(json) // Result<Circle, CodecError>\n *\n * // Record with custom codec\n * const Circle2 = record('Circle', CircleSchema, {\n *   graphic: {\n *     to: (circle) => `(${circle.radius})`,\n *     from: (input: string) => {\n *       const match = input.match(/^\\((\\d+)\\)$/)\n *       return match ? { radius: parseInt(match[1]!) } : null\n *     }\n *   }\n * })\n *\n * const graphic = Circle2.to.graphic({ radius: 10 }) // \"(10)\"\n * const result3 = Circle2.from.graphic(\"(10)\") // Result<Circle, CodecError>\n * ```\n */\n// Overload: with codecs\nexport function record<Tag extends string, S extends StandardSchemaV1, Codecs extends CodecConstraint<Tag, S>>(\n  _tag: Tag,\n  schema: S,\n  codecs: Codecs,\n): RecordObject<Tag, S, Codecs>\n\n// Overload: without codecs\nexport function record<Tag extends string, S extends StandardSchemaV1>(_tag: Tag, schema: S): RecordObject<Tag, S>\n\n// Implementation\nexport function record<\n  Tag extends string,\n  S extends StandardSchemaV1,\n  Codecs extends CodecConstraint<Tag, S> | undefined,\n>(_tag: Tag, schema: S, codecs?: Codecs): RecordObject<Tag, S, Codecs> {\n  type Output = InferOutput<S> & Discriminator<Tag>\n\n  const isGuard = createIsGuard<Tag, Output>(_tag)\n  const to = createToMethods(_tag, schema, codecs)\n  const from = createFromMethods(_tag, schema, codecs)\n  const equals = createEqualsMethod<Tag, InferOutput<S>>(_tag)\n  const hash = createHashMethod<Tag, InferOutput<S>>(_tag)\n\n  // Constructor function\n  const constructor = (input: InferInput<S>): Result<Output, ValidationError> => {\n    // Add _tag to the input before validation\n    // oxlint-disable-next-line no-unsafe-type-assertion -- Required for spreading generic input\n    const taggedInput = { ...(input as object), _tag }\n\n    // Validate using the schema\n    const result = validateSync(schema, taggedInput, _tag)\n\n    if (!result.ok) {\n      return err(result.error)\n    }\n\n    // Ensure _tag is in the output (schema might strip unknown keys)\n    // oxlint-disable-next-line no-unsafe-type-assertion -- Required for output construction\n    const output = { ...(result.value as object), _tag } as Output\n    return ok(output)\n  }\n\n  // Attach static properties to constructor function\n  constructor._record = true as const\n  constructor._tag = _tag\n  constructor.schema = schema\n  if (codecs) {\n    // oxlint-disable-next-line no-unsafe-type-assertion -- Conditional assignment of codecs\n    ;(constructor as { codecs?: Codecs }).codecs = codecs\n  }\n  constructor.is = isGuard\n  constructor.to = to\n  constructor.from = from\n  constructor.equals = equals\n  constructor.hash = hash\n\n  return constructor as RecordObject<Tag, S, Codecs>\n}\n","import { createADTEqualsMethod, createADTHashMethod } from \"../equality/equality\"\nimport { record } from \"./adt.record\"\nimport type { ADT, RecordDef, RecordObject } from \"./adt.types\"\nimport { createIsAnyGuard, isRecord } from \"./adt.utils\"\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\"\n\n/**\n * Compose records or schemas into a discriminated union (ADT).\n *\n * Accepts either:\n * - Pre-built RecordObjects from record() (codecs are preserved)\n * - Raw Standard Schema validators (will be wrapped internally)\n *\n * When using pre-built records, the object key overrides the original _tag.\n *\n * @template R - Record of variant names to RecordObjects or StandardSchema validators\n * @param name - The name of this ADT (for identification)\n * @param records - An object mapping _tag names to RecordObjects or schemas\n * @returns An ADT object with accessors for each variant\n *\n * @see {@link record} for creating individual record types\n * @see {@link match} for exhaustive pattern matching on ADT values\n *\n * @example\n * ```ts\n * // From pre-built records\n * const Circle = record('Circle', CircleSchema)\n * const Square = record('Square', SquareSchema)\n * const Shape = data('Shape', { Circle, Square })\n *\n * // From raw schemas (JSON codec is automatically included)\n * const Shape = data('Shape', {\n *   Circle: CircleSchema,\n *   Square: SquareSchema\n * })\n *\n * // JSON codec works on all variants\n * Shape.Circle.to.json({ radius: 10 })\n * Shape.Circle.from.json(jsonString)\n *\n * // Mixed\n * const Shape = data('Shape', {\n *   Circle,              // Pre-built record\n *   Square: SquareSchema // Raw schema\n * })\n *\n * // Usage\n * Shape.Circle({ radius: 10 })\n * Shape.is(someValue)        // type guard for any variant\n * Shape.Circle.is(someValue) // type guard for Circle\n * ```\n */\nexport function data<R extends Record<string, RecordDef>>(name: string, records: R): ADT<R> {\n  const tags = Object.keys(records)\n  const variants: Record<string, RecordObject> = {}\n\n  for (const [_tag, def] of Object.entries(records)) {\n    if (isRecord(def)) {\n      // Pre-built RecordObject - key overrides original _tag\n      if (def._tag === _tag) {\n        // _tag matches key, use as-is (preserves codecs)\n        variants[_tag] = def\n        // oxlint-disable-next-line strict-boolean-expressions -- codecs can be undefined\n      } else if (def.codecs) {\n        // _tag differs from key - create new record with key as _tag\n        // Preserve codecs\n        variants[_tag] = record(_tag, def.schema, def.codecs)\n      } else {\n        // _tag differs from key and no codecs\n        variants[_tag] = record(_tag, def.schema)\n      }\n    } else {\n      // Raw schema - wrap in record\n      // Note: Even without custom codecs, this still gets JSON codec!\n      // oxlint-disable-next-line no-unsafe-type-assertion -- def is a StandardSchemaV1 in this branch\n      variants[_tag] = record(_tag, def as StandardSchemaV1)\n    }\n  }\n\n  // Create the root type guard for any variant\n  const isAnyVariant = createIsAnyGuard(tags)\n  const equals = createADTEqualsMethod(tags)\n  const hash = createADTHashMethod(tags)\n\n  // oxlint-disable-next-line no-unsafe-type-assertion -- Required for generic ADT return type\n  return {\n    _name: name,\n    is: isAnyVariant,\n    equals,\n    hash,\n    ...variants,\n  } as ADT<R>\n}\n","/**\n * Handler functions for each variant in a discriminated union.\n * Each key maps to a function that receives the variant value and returns TResult.\n *\n * @template T - The discriminated union type (must have readonly _tag)\n * @template TResult - The return type of all handlers\n */\nexport type MatchHandlers<T extends { readonly _tag: string }, TResult> = {\n  [K in T[\"_tag\"]]: (value: Extract<T, { readonly _tag: K }>) => TResult\n}\n\n/**\n * Exhaustive pattern matching for discriminated unions.\n *\n * TypeScript will error if any variant is missing from handlers,\n * ensuring exhaustive handling of all cases.\n *\n * @template T - The discriminated union type (must have readonly _tag)\n * @template TResult - The return type of all handlers\n * @template Handlers - The handler object type (inferred)\n * @param value - A discriminated union value with _tag\n * @param handlers - An object with a handler function for each variant\n * @returns The result of calling the matching handler\n *\n * @see {@link data} for creating discriminated unions\n * @see {@link record} for creating individual record types\n *\n * @example\n * ```ts\n * const Shape = data('Shape', { Circle, Square })\n * type Shape = Infer<typeof Shape>\n *\n * function describeShape(shape: Shape): string {\n *   return match(shape, {\n *     Circle: (c) => `Circle with radius ${c.radius}`,\n *     Square: (s) => `Square with size ${s.size}`,\n *   })\n * }\n * ```\n */\nexport function match<\n  T extends { readonly _tag: string },\n  TResult,\n  Handlers extends MatchHandlers<T, TResult> = MatchHandlers<T, TResult>,\n>(value: T, handlers: Handlers): TResult {\n  const tag = value._tag as keyof Handlers\n  const handler = handlers[tag]\n  // oxlint-disable-next-line no-explicit-any, no-unsafe-argument, no-unsafe-type-assertion -- Required for variant dispatch\n  return handler(value as any)\n}\n"],"mappings":"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"}

package/dist/brand-BqcqFXj5.mjs

@@ -1,165 +0,0 @@
-import { t as Result } from "./result-DhYA-J-M.mjs";
-
-//#region src/brand/brand.ts
-/**
-* Create a branded value without validation.
-* This is a type-level cast with zero runtime cost.
-*
-* Use this when you trust the value source (e.g., from a database)
-* or when validation happens elsewhere.
-*
-* @template B - The branded type
-* @param value - The value to brand
-* @returns The value as a branded type
-*
-* @example
-* ```ts
-* type UserId = Branded<string, "UserId">
-*
-* // Trust the value from database
-* const userId = Brand.make<UserId>(row.id)
-*
-* // Or use in a validated factory
-* function createUserId(input: string): UserId {
-*   if (!input.startsWith("user_")) throw new Error("Invalid")
-*   return Brand.make<UserId>(input)
-* }
-* ```
-*/
-const make = (value) => {
-	return value;
-};
-/**
-* Alias for make() - explicitly indicates no validation occurs.
-* Prefer this when readability about the lack of validation is important.
-*
-* @template B - The branded type
-* @param value - The value to brand (unchecked)
-* @returns The value as a branded type
-*
-* @example
-* ```ts
-* type PositiveNumber = Branded<number, "PositiveNumber">
-*
-* // Explicitly unsafe - reader knows no validation
-* const n = Brand.unsafeMake<PositiveNumber>(-5) // No error, but logically wrong
-* ```
-*/
-const unsafeMake = (value) => {
-	return value;
-};
-/**
-* Create a type guard with validation for a branded type.
-* Returns a refinement predicate that narrows to the branded type.
-*
-* @template T - The base type
-* @template K - The brand key (string literal)
-* @param validator - A function that validates the base value
-* @returns A type guard that returns true if validation passes
-*
-* @example
-* ```ts
-* type PositiveNumber = Branded<number, "PositiveNumber">
-*
-* const isPositive = Brand.is<number, "PositiveNumber">(n => n > 0)
-*
-* const value: number = 42
-* if (isPositive(value)) {
-*   // value is now PositiveNumber
-*   acceptPositive(value) // OK
-* }
-* ```
-*/
-const is = (validator) => {
-	return (value) => validator(value);
-};
-/**
-* Create a validated branded value wrapped in a Result.
-* Returns `Result.ok(brandedValue)` on success, `Result.err(BrandError)` on failure.
-*
-* The returned Result is yieldable in Do computations via `yield*`.
-*
-* @template B - The branded type
-* @param validator - A function that validates the base value
-* @param errorMessage - Optional custom error message (or function)
-* @returns A function that takes a value and returns a Result
-*
-* @example
-* ```ts
-* type Email = Branded<string, "Email">
-*
-* const parseEmail = Brand.refine<Email>(
-*   s => s.includes("@"),
-*   (v) => `Invalid email: ${v}`
-* )
-*
-* // Basic usage
-* const result = parseEmail("user@example.com")
-* // { ok: true, value: "user@example.com" }
-*
-* const bad = parseEmail("not-an-email")
-* // { ok: false, error: { _tag: "BrandError", value: "not-an-email", message: "..." } }
-*
-* // With Do computation
-* const computation = Fx.gen(function* () {
-*   const email = yield* parseEmail(input)
-*   return email
-* })
-*
-* // With pipe
-* pipe(
-*   userInput,
-*   parseEmail,
-*   Result.map(email => sendTo(email)),
-*   Result.unwrapOr(defaultEmail)
-* )
-* ```
-*/
-const refine = (validator, errorMessage) => {
-	return (value) => {
-		if (!validator(value)) {
-			const msg = typeof errorMessage === "function" ? errorMessage(value) : errorMessage ?? "Brand validation failed";
-			return Result.err({
-				_tag: "BrandError",
-				value,
-				message: msg
-			});
-		}
-		return Result.ok(value);
-	};
-};
-/**
-* Brand namespace containing utilities for nominal typing in TypeScript.
-*
-* Brand types add type-level distinctiveness to primitive types without
-* any runtime overhead. This prevents accidental mixing of semantically
-* different values that share the same structural type.
-*
-* @example
-* ```ts
-* import { Brand } from "@repo/std"
-* import type { Branded } from "@repo/std"
-*
-* // Define branded types
-* type UserId = Branded<string, "UserId">
-* type Email = Branded<string, "Email">
-*
-* // Create values
-* const userId = Brand.make<UserId>("user-123")
-* const isValidEmail = Brand.is<Email>(s => s.includes("@"))
-*
-* // Type safety
-* function sendEmail(email: Email) { ... }
-* sendEmail(userId) // Type error! UserId is not Email
-* ```
-*/
-const Brand = {
-	make,
-	unsafeMake,
-	is,
-	refine
-};
-
-//#endregion
-export { unsafeMake as a, refine as i, is as n, make as r, Brand as t };
-//# sourceMappingURL=brand-BqcqFXj5.mjs.map

package/dist/chunk-DRYujVrt.mjs

@@ -1,18 +0,0 @@
-//#region rolldown:runtime
-var __defProp = Object.defineProperty;
-var __exportAll = (all, symbols) => {
-	let target = {};
-	for (var name in all) {
-		__defProp(target, name, {
-			get: all[name],
-			enumerable: true
-		});
-	}
-	if (symbols) {
-		__defProp(target, Symbol.toStringTag, { value: "Module" });
-	}
-	return target;
-};
-
-//#endregion
-export { __exportAll as t };