@voidhash/mimic 0.0.1 → 0.0.3

package/dist/primitives/Boolean.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Boolean.mjs","names":["OperationDefinition.make","Operation.fromDefinition","OperationPath.pathsOverlap"],"sources":["../../src/primitives/Boolean.ts"],"sourcesContent":["import { Schema } from \"effect\";\nimport * as OperationDefinition from \"../OperationDefinition\";\nimport * as Operation from \"../Operation\";\nimport * as OperationPath from \"../OperationPath\";\nimport * as ProxyEnvironment from \"../ProxyEnvironment\";\nimport * as Transform from \"../Transform\";\nimport type { Primitive, PrimitiveInternal, MaybeUndefined, Validator, NeedsValue } from \"./shared\";\nimport { runValidators, isCompatibleOperation, ValidationError } from \"./shared\";\n\n\ntype InferSetInput<TRequired extends boolean = false, THasDefault extends boolean = false> = NeedsValue<boolean, TRequired, THasDefault>\ntype InferUpdateInput<TRequired extends boolean = false, THasDefault extends boolean = false> = NeedsValue<boolean, TRequired, THasDefault>\n\nexport interface BooleanProxy<TRequired extends boolean = false, THasDefault extends boolean = false> {\n  /** Gets the current boolean value */\n  get(): MaybeUndefined<boolean, TRequired, THasDefault>;\n  /** Sets the boolean value, generating a boolean.set operation */\n  set(value: InferSetInput<TRequired, THasDefault>): void;\n  /** This is the same as set. Updates the boolean value, generating a boolean.set operation */\n  update(value: InferUpdateInput<TRequired, THasDefault>): void;\n  /** Returns a readonly snapshot of the boolean value for rendering */\n  toSnapshot(): MaybeUndefined<boolean, TRequired, THasDefault>;\n}\n\ninterface BooleanPrimitiveSchema {\n  readonly required: boolean;\n  readonly defaultValue: boolean | undefined;\n  readonly validators: readonly Validator<boolean>[];\n}\n\nexport class BooleanPrimitive<TRequired extends boolean = false, THasDefault extends boolean = false> implements Primitive<boolean, BooleanProxy<TRequired, THasDefault>, TRequired, THasDefault, InferSetInput<TRequired, THasDefault>, InferUpdateInput<TRequired, THasDefault>> {\n  readonly _tag = \"BooleanPrimitive\" as const;\n  readonly _State!: boolean;\n  readonly _Proxy!: BooleanProxy<TRequired, THasDefault>;\n  readonly _TRequired!: TRequired;\n  readonly _THasDefault!: THasDefault;\n  readonly TUpdateInput!: InferUpdateInput<TRequired, THasDefault>;\n  readonly TSetInput!: InferSetInput<TRequired, THasDefault>;\n\n  private readonly _schema: BooleanPrimitiveSchema;\n\n  private readonly _opDefinitions = {\n    set: OperationDefinition.make({\n      kind: \"boolean.set\" as const,\n      payload: Schema.Boolean,\n      target: Schema.Boolean,\n      apply: (payload) => payload,\n    }),\n  };\n\n  constructor(schema: BooleanPrimitiveSchema) {\n    this._schema = schema;\n  }\n\n  /** Mark this boolean as required */\n  required(): BooleanPrimitive<true, THasDefault> {\n    return new BooleanPrimitive({\n      ...this._schema,\n      required: true,\n    });\n  }\n\n  /** Set a default value for this boolean */\n  default(defaultValue: boolean): BooleanPrimitive<TRequired, true> {\n    return new BooleanPrimitive({\n      ...this._schema,\n      defaultValue,\n    });\n  }\n\n  /** Add a custom validation rule */\n  refine(fn: (value: boolean) => boolean, message: string): BooleanPrimitive<TRequired, THasDefault> {\n    return new BooleanPrimitive({\n      ...this._schema,\n      validators: [...this._schema.validators, { validate: fn, message }],\n    });\n  }\n\n  readonly _internal: PrimitiveInternal<boolean, BooleanProxy<TRequired, THasDefault>> = {\n    createProxy: (env: ProxyEnvironment.ProxyEnvironment, operationPath: OperationPath.OperationPath): BooleanProxy<TRequired, THasDefault> => {\n      const defaultValue = this._schema.defaultValue;\n      return {\n        get: (): MaybeUndefined<boolean, TRequired, THasDefault> => {\n          const state = env.getState(operationPath) as boolean | undefined;\n          return (state ?? defaultValue) as MaybeUndefined<boolean, TRequired, THasDefault>;\n        },\n        set: (value: InferSetInput<TRequired, THasDefault>) => {\n          env.addOperation(\n            Operation.fromDefinition(operationPath, this._opDefinitions.set, value)\n          );\n        },\n        update: (value: InferUpdateInput<TRequired, THasDefault>) => {\n          env.addOperation(\n            Operation.fromDefinition(operationPath, this._opDefinitions.set, value)\n          );\n        },\n        toSnapshot: (): MaybeUndefined<boolean, TRequired, THasDefault> => {\n          const state = env.getState(operationPath) as boolean | undefined;\n          return (state ?? defaultValue) as MaybeUndefined<boolean, TRequired, THasDefault>;\n        },\n      };\n    },\n\n    applyOperation: (_state: boolean | undefined, operation: Operation.Operation<any, any, any>): boolean => {\n      if (operation.kind !== \"boolean.set\") {\n        throw new ValidationError(`BooleanPrimitive cannot apply operation of kind: ${operation.kind}`);\n      }\n\n      const payload = operation.payload;\n      if (typeof payload !== \"boolean\") {\n        throw new ValidationError(`BooleanPrimitive.set requires a boolean payload, got: ${typeof payload}`);\n      }\n\n      // Run validators\n      runValidators(payload, this._schema.validators);\n\n      return payload;\n    },\n\n    getInitialState: (): boolean | undefined => {\n      return this._schema.defaultValue;\n    },\n\n    transformOperation: (\n      clientOp: Operation.Operation<any, any, any>,\n      serverOp: Operation.Operation<any, any, any>\n    ): Transform.TransformResult => {\n      // If paths don't overlap, no transformation needed\n      if (!OperationPath.pathsOverlap(clientOp.path, serverOp.path)) {\n        return { type: \"transformed\", operation: clientOp };\n      }\n\n      // For same path, client wins (last-write-wins)\n      return { type: \"transformed\", operation: clientOp };\n    },\n  };\n}\n\n/** Creates a new BooleanPrimitive */\nexport const Boolean = (): BooleanPrimitive<false, false> =>\n  new BooleanPrimitive({ required: false, defaultValue: undefined, validators: [] });\n\n"],"mappings":";;;;;;;;;AA8BA,IAAa,mBAAb,MAAa,iBAAsQ;CAoBjR,YAAY,QAAgC;wBAnBnC,QAAO;wBACP;wBACA;wBACA;wBACA;wBACA;wBACA;wBAEQ;wBAEA,kBAAiB,EAChC,KAAKA,KAAyB;GAC5B,MAAM;GACN,SAAS,OAAO;GAChB,QAAQ,OAAO;GACf,QAAQ,YAAY;GACrB,CAAC,EACH;wBA8BQ,aAA8E;GACrF,cAAc,KAAwC,kBAAqF;IACzI,MAAM,eAAe,KAAK,QAAQ;AAClC,WAAO;KACL,WAA4D;MAC1D,MAAM,QAAQ,IAAI,SAAS,cAAc;AACzC,aAAQ,6CAAS;;KAEnB,MAAM,UAAiD;AACrD,UAAI,aACFC,eAAyB,eAAe,KAAK,eAAe,KAAK,MAAM,CACxE;;KAEH,SAAS,UAAoD;AAC3D,UAAI,aACFA,eAAyB,eAAe,KAAK,eAAe,KAAK,MAAM,CACxE;;KAEH,kBAAmE;MACjE,MAAM,QAAQ,IAAI,SAAS,cAAc;AACzC,aAAQ,6CAAS;;KAEpB;;GAGH,iBAAiB,QAA6B,cAA2D;AACvG,QAAI,UAAU,SAAS,cACrB,OAAM,IAAI,gBAAgB,oDAAoD,UAAU,OAAO;IAGjG,MAAM,UAAU,UAAU;AAC1B,QAAI,OAAO,YAAY,UACrB,OAAM,IAAI,gBAAgB,yDAAyD,OAAO,UAAU;AAItG,kBAAc,SAAS,KAAK,QAAQ,WAAW;AAE/C,WAAO;;GAGT,uBAA4C;AAC1C,WAAO,KAAK,QAAQ;;GAGtB,qBACE,UACA,aAC8B;AAE9B,QAAI,CAACC,aAA2B,SAAS,MAAM,SAAS,KAAK,CAC3D,QAAO;KAAE,MAAM;KAAe,WAAW;KAAU;AAIrD,WAAO;KAAE,MAAM;KAAe,WAAW;KAAU;;GAEtD;AApFC,OAAK,UAAU;;;CAIjB,WAAgD;AAC9C,SAAO,IAAI,mDACN,KAAK,gBACR,UAAU,QACV;;;CAIJ,QAAQ,cAA0D;AAChE,SAAO,IAAI,mDACN,KAAK,gBACR,gBACA;;;CAIJ,OAAO,IAAiC,SAA2D;AACjG,SAAO,IAAI,mDACN,KAAK,gBACR,YAAY,CAAC,GAAG,KAAK,QAAQ,YAAY;GAAE,UAAU;GAAI;GAAS,CAAC,IACnE;;;;AAgEN,MAAa,gBACX,IAAI,iBAAiB;CAAE,UAAU;CAAO,cAAc;CAAW,YAAY,EAAE;CAAE,CAAC"}

package/dist/primitives/Either.cjs

@@ -0,0 +1,200 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_defineProperty = require('../_virtual/_@oxc-project_runtime@0.103.0/helpers/defineProperty.cjs');
+const require_objectSpread2 = require('../_virtual/_@oxc-project_runtime@0.103.0/helpers/objectSpread2.cjs');
+const require_shared = require('./shared.cjs');
+const require_OperationDefinition = require('../OperationDefinition.cjs');
+const require_OperationPath = require('../OperationPath.cjs');
+const require_Operation = require('../Operation.cjs');
+let effect = require("effect");
+
+//#region src/primitives/Either.ts
+var EitherPrimitive = class EitherPrimitive {
+	constructor(schema) {
+		require_defineProperty._defineProperty(this, "_tag", "EitherPrimitive");
+		require_defineProperty._defineProperty(this, "_State", void 0);
+		require_defineProperty._defineProperty(this, "_Proxy", void 0);
+		require_defineProperty._defineProperty(this, "_TRequired", void 0);
+		require_defineProperty._defineProperty(this, "_THasDefault", void 0);
+		require_defineProperty._defineProperty(this, "TUpdateInput", void 0);
+		require_defineProperty._defineProperty(this, "TSetInput", void 0);
+		require_defineProperty._defineProperty(this, "_schema", void 0);
+		require_defineProperty._defineProperty(this, "_opDefinitions", { set: require_OperationDefinition.make({
+			kind: "either.set",
+			payload: effect.Schema.Unknown,
+			target: effect.Schema.Unknown,
+			apply: (payload) => payload
+		}) });
+		require_defineProperty._defineProperty(this, "_internal", {
+			createProxy: (env, operationPath) => {
+				const defaultValue = this._schema.defaultValue;
+				return {
+					get: () => {
+						const state = env.getState(operationPath);
+						return state !== null && state !== void 0 ? state : defaultValue;
+					},
+					set: (value) => {
+						env.addOperation(require_Operation.fromDefinition(operationPath, this._opDefinitions.set, value));
+					},
+					update: (value) => {
+						env.addOperation(require_Operation.fromDefinition(operationPath, this._opDefinitions.set, value));
+					},
+					match: (handlers) => {
+						const currentState = env.getState(operationPath);
+						const effectiveState = currentState !== null && currentState !== void 0 ? currentState : defaultValue;
+						if (effectiveState === void 0) return void 0;
+						const valueType = this._getValueType(effectiveState);
+						if (!valueType) return void 0;
+						switch (valueType) {
+							case "string":
+								var _handlers$string;
+								return (_handlers$string = handlers.string) === null || _handlers$string === void 0 ? void 0 : _handlers$string.call(handlers, effectiveState);
+							case "number":
+								var _handlers$number;
+								return (_handlers$number = handlers.number) === null || _handlers$number === void 0 ? void 0 : _handlers$number.call(handlers, effectiveState);
+							case "boolean":
+								var _handlers$boolean;
+								return (_handlers$boolean = handlers.boolean) === null || _handlers$boolean === void 0 ? void 0 : _handlers$boolean.call(handlers, effectiveState);
+							case "literal":
+								var _handlers$literal;
+								return (_handlers$literal = handlers.literal) === null || _handlers$literal === void 0 ? void 0 : _handlers$literal.call(handlers, effectiveState);
+							default: return;
+						}
+					},
+					toSnapshot: () => {
+						const state = env.getState(operationPath);
+						return state !== null && state !== void 0 ? state : defaultValue;
+					}
+				};
+			},
+			applyOperation: (_state, operation) => {
+				if (operation.kind !== "either.set") throw new require_shared.ValidationError(`EitherPrimitive cannot apply operation of kind: ${operation.kind}`);
+				const payload = operation.payload;
+				this._validateAndApplyToVariant(payload, operation.path);
+				return payload;
+			},
+			getInitialState: () => {
+				return this._schema.defaultValue;
+			},
+			transformOperation: (clientOp, serverOp) => {
+				if (!require_OperationPath.pathsOverlap(clientOp.path, serverOp.path)) return {
+					type: "transformed",
+					operation: clientOp
+				};
+				return {
+					type: "transformed",
+					operation: clientOp
+				};
+			}
+		});
+		this._schema = schema;
+	}
+	/** Mark this either as required */
+	required() {
+		return new EitherPrimitive(require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, this._schema), {}, { required: true }));
+	}
+	/** Set a default value for this either */
+	default(defaultValue) {
+		return new EitherPrimitive(require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, this._schema), {}, { defaultValue }));
+	}
+	/** Get the variants */
+	get variants() {
+		return this._schema.variants;
+	}
+	/**
+	* Determine the type category of a value based on the variants
+	*/
+	_getValueType(value) {
+		const valueType = typeof value;
+		for (const variant of this._schema.variants) if (variant._tag === "LiteralPrimitive") {
+			if (value === variant.literal) return "literal";
+		}
+		if (valueType === "string") {
+			for (const variant of this._schema.variants) if (variant._tag === "StringPrimitive") return "string";
+		}
+		if (valueType === "number") {
+			for (const variant of this._schema.variants) if (variant._tag === "NumberPrimitive") return "number";
+		}
+		if (valueType === "boolean") {
+			for (const variant of this._schema.variants) if (variant._tag === "BooleanPrimitive") return "boolean";
+		}
+	}
+	/**
+	* Find the matching variant for a value.
+	* For literals, matches exact value. For other types, matches by typeof.
+	*/
+	_findMatchingVariant(value) {
+		const valueType = typeof value;
+		for (const variant of this._schema.variants) if (variant._tag === "LiteralPrimitive") {
+			if (value === variant.literal) return variant;
+		}
+		if (valueType === "string") {
+			for (const variant of this._schema.variants) if (variant._tag === "StringPrimitive") return variant;
+		}
+		if (valueType === "number") {
+			for (const variant of this._schema.variants) if (variant._tag === "NumberPrimitive") return variant;
+		}
+		if (valueType === "boolean") {
+			for (const variant of this._schema.variants) if (variant._tag === "BooleanPrimitive") return variant;
+		}
+	}
+	/**
+	* Get the operation kind for a variant
+	*/
+	_getVariantOperationKind(variant) {
+		switch (variant._tag) {
+			case "StringPrimitive": return "string.set";
+			case "NumberPrimitive": return "number.set";
+			case "BooleanPrimitive": return "boolean.set";
+			case "LiteralPrimitive": return "literal.set";
+			default: return "unknown.set";
+		}
+	}
+	/**
+	* Validate a value against the matching variant, including running its validators.
+	* Throws ValidationError if the value doesn't match any variant or fails validation.
+	*/
+	_validateAndApplyToVariant(value, path) {
+		const matchingVariant = this._findMatchingVariant(value);
+		if (!matchingVariant) throw new require_shared.ValidationError(`EitherPrimitive.set requires a value matching one of: ${this._schema.variants.map((v) => v._tag).join(", ")}, got: ${typeof value}`);
+		const syntheticOp = {
+			kind: this._getVariantOperationKind(matchingVariant),
+			path,
+			payload: value
+		};
+		matchingVariant._internal.applyOperation(void 0, syntheticOp);
+	}
+};
+/**
+* Creates a new EitherPrimitive with the given scalar variant types.
+* Validators defined on the variants are applied when validating values.
+*
+* @example
+* ```typescript
+* // String or number
+* const value = Either(String(), Number());
+*
+* // String, number, or boolean
+* const status = Either(String(), Number(), Boolean()).default("pending");
+*
+* // With literal types
+* const mode = Either(Literal("auto"), Literal("manual"), Number());
+*
+* // With validators - validates string length and number range
+* const constrained = Either(
+*   String().min(2).max(50),
+*   Number().max(255)
+* );
+* ```
+*/
+function Either(...variants) {
+	if (variants.length === 0) throw new require_shared.ValidationError("Either requires at least one variant");
+	return new EitherPrimitive({
+		required: false,
+		defaultValue: void 0,
+		variants
+	});
+}
+
+//#endregion
+exports.Either = Either;
+exports.EitherPrimitive = EitherPrimitive;

package/dist/primitives/Either.d.cts

@@ -0,0 +1,113 @@
+import { InferState, MaybeUndefined, NeedsValue, Primitive, PrimitiveInternal } from "./shared.cjs";
+import { StringPrimitive } from "./String.cjs";
+import { BooleanPrimitive } from "./Boolean.cjs";
+import { NumberPrimitive } from "./Number.cjs";
+import { LiteralPrimitive, LiteralValue } from "./Literal.cjs";
+
+//#region src/primitives/Either.d.ts
+type InferSetInput<TVariants extends readonly ScalarPrimitive[], TRequired extends boolean = false, THasDefault extends boolean = false> = NeedsValue<InferEitherState<TVariants>, TRequired, THasDefault>;
+type InferUpdateInput<TVariants extends readonly ScalarPrimitive[], TRequired extends boolean = false, THasDefault extends boolean = false> = NeedsValue<InferEitherState<TVariants>, TRequired, THasDefault>;
+/**
+ * Scalar primitives that can be used as variants in Either
+ */
+type ScalarPrimitive = StringPrimitive<any, any> | NumberPrimitive<any, any> | BooleanPrimitive<any, any> | LiteralPrimitive<any, any, any>;
+/**
+ * Infer the union state type from a tuple of scalar primitives
+ */
+type InferEitherState<TVariants extends readonly ScalarPrimitive[]> = InferState<TVariants[number]>;
+/**
+ * Infer the union snapshot type from a tuple of scalar primitives
+ */
+type InferEitherSnapshot<TVariants extends readonly ScalarPrimitive[]> = InferState<TVariants[number]>;
+/**
+ * Match handlers for Either - optional handlers for each scalar type
+ */
+interface EitherMatchHandlers<R> {
+  string?: (value: string) => R;
+  number?: (value: number) => R;
+  boolean?: (value: boolean) => R;
+  literal?: (value: LiteralValue) => R;
+}
+/**
+ * Proxy for accessing Either values
+ */
+interface EitherProxy<TVariants extends readonly ScalarPrimitive[], TRequired extends boolean = false, THasDefault extends boolean = false> {
+  /** Gets the current value */
+  get(): MaybeUndefined<InferEitherState<TVariants>, TRequired, THasDefault>;
+  /** Sets the value to any of the allowed variant types */
+  set(value: InferSetInput<TVariants, TRequired, THasDefault>): void;
+  /** This is the same as set. Updates the value, generating an either.set operation */
+  update(value: InferUpdateInput<TVariants, TRequired, THasDefault>): void;
+  /** Pattern match on the value type */
+  match<R>(handlers: EitherMatchHandlers<R>): R | undefined;
+  /** Returns a readonly snapshot of the value for rendering */
+  toSnapshot(): MaybeUndefined<InferEitherSnapshot<TVariants>, TRequired, THasDefault>;
+}
+interface EitherPrimitiveSchema<TVariants extends readonly ScalarPrimitive[]> {
+  readonly required: boolean;
+  readonly defaultValue: InferEitherState<TVariants> | undefined;
+  readonly variants: TVariants;
+}
+declare class EitherPrimitive<TVariants extends readonly ScalarPrimitive[], TRequired extends boolean = false, THasDefault extends boolean = false> implements Primitive<InferEitherState<TVariants>, EitherProxy<TVariants, TRequired, THasDefault>, TRequired, THasDefault, InferSetInput<TVariants, TRequired, THasDefault>, InferUpdateInput<TVariants, TRequired, THasDefault>> {
+  readonly _tag: "EitherPrimitive";
+  readonly _State: InferEitherState<TVariants>;
+  readonly _Proxy: EitherProxy<TVariants, TRequired, THasDefault>;
+  readonly _TRequired: TRequired;
+  readonly _THasDefault: THasDefault;
+  readonly TUpdateInput: InferUpdateInput<TVariants, TRequired, THasDefault>;
+  readonly TSetInput: InferSetInput<TVariants, TRequired, THasDefault>;
+  private readonly _schema;
+  private readonly _opDefinitions;
+  constructor(schema: EitherPrimitiveSchema<TVariants>);
+  /** Mark this either as required */
+  required(): EitherPrimitive<TVariants, true, THasDefault>;
+  /** Set a default value for this either */
+  default(defaultValue: InferEitherState<TVariants>): EitherPrimitive<TVariants, TRequired, true>;
+  /** Get the variants */
+  get variants(): TVariants;
+  /**
+   * Determine the type category of a value based on the variants
+   */
+  private _getValueType;
+  /**
+   * Find the matching variant for a value.
+   * For literals, matches exact value. For other types, matches by typeof.
+   */
+  private _findMatchingVariant;
+  /**
+   * Get the operation kind for a variant
+   */
+  private _getVariantOperationKind;
+  /**
+   * Validate a value against the matching variant, including running its validators.
+   * Throws ValidationError if the value doesn't match any variant or fails validation.
+   */
+  private _validateAndApplyToVariant;
+  readonly _internal: PrimitiveInternal<InferEitherState<TVariants>, EitherProxy<TVariants, TRequired, THasDefault>>;
+}
+/**
+ * Creates a new EitherPrimitive with the given scalar variant types.
+ * Validators defined on the variants are applied when validating values.
+ *
+ * @example
+ * ```typescript
+ * // String or number
+ * const value = Either(String(), Number());
+ *
+ * // String, number, or boolean
+ * const status = Either(String(), Number(), Boolean()).default("pending");
+ *
+ * // With literal types
+ * const mode = Either(Literal("auto"), Literal("manual"), Number());
+ *
+ * // With validators - validates string length and number range
+ * const constrained = Either(
+ *   String().min(2).max(50),
+ *   Number().max(255)
+ * );
+ * ```
+ */
+declare function Either<TVariants extends readonly ScalarPrimitive[]>(...variants: TVariants): EitherPrimitive<TVariants, false, false>;
+//#endregion
+export { Either, EitherMatchHandlers, EitherPrimitive, EitherProxy, InferEitherSnapshot, InferEitherState, ScalarPrimitive };
+//# sourceMappingURL=Either.d.cts.map

package/dist/primitives/Either.d.cts.map

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

package/dist/primitives/Either.d.mts

@@ -0,0 +1,113 @@
+import { InferState, MaybeUndefined, NeedsValue, Primitive, PrimitiveInternal } from "./shared.mjs";
+import { StringPrimitive } from "./String.mjs";
+import { BooleanPrimitive } from "./Boolean.mjs";
+import { NumberPrimitive } from "./Number.mjs";
+import { LiteralPrimitive, LiteralValue } from "./Literal.mjs";
+
+//#region src/primitives/Either.d.ts
+type InferSetInput<TVariants extends readonly ScalarPrimitive[], TRequired extends boolean = false, THasDefault extends boolean = false> = NeedsValue<InferEitherState<TVariants>, TRequired, THasDefault>;
+type InferUpdateInput<TVariants extends readonly ScalarPrimitive[], TRequired extends boolean = false, THasDefault extends boolean = false> = NeedsValue<InferEitherState<TVariants>, TRequired, THasDefault>;
+/**
+ * Scalar primitives that can be used as variants in Either
+ */
+type ScalarPrimitive = StringPrimitive<any, any> | NumberPrimitive<any, any> | BooleanPrimitive<any, any> | LiteralPrimitive<any, any, any>;
+/**
+ * Infer the union state type from a tuple of scalar primitives
+ */
+type InferEitherState<TVariants extends readonly ScalarPrimitive[]> = InferState<TVariants[number]>;
+/**
+ * Infer the union snapshot type from a tuple of scalar primitives
+ */
+type InferEitherSnapshot<TVariants extends readonly ScalarPrimitive[]> = InferState<TVariants[number]>;
+/**
+ * Match handlers for Either - optional handlers for each scalar type
+ */
+interface EitherMatchHandlers<R> {
+  string?: (value: string) => R;
+  number?: (value: number) => R;
+  boolean?: (value: boolean) => R;
+  literal?: (value: LiteralValue) => R;
+}
+/**
+ * Proxy for accessing Either values
+ */
+interface EitherProxy<TVariants extends readonly ScalarPrimitive[], TRequired extends boolean = false, THasDefault extends boolean = false> {
+  /** Gets the current value */
+  get(): MaybeUndefined<InferEitherState<TVariants>, TRequired, THasDefault>;
+  /** Sets the value to any of the allowed variant types */
+  set(value: InferSetInput<TVariants, TRequired, THasDefault>): void;
+  /** This is the same as set. Updates the value, generating an either.set operation */
+  update(value: InferUpdateInput<TVariants, TRequired, THasDefault>): void;
+  /** Pattern match on the value type */
+  match<R>(handlers: EitherMatchHandlers<R>): R | undefined;
+  /** Returns a readonly snapshot of the value for rendering */
+  toSnapshot(): MaybeUndefined<InferEitherSnapshot<TVariants>, TRequired, THasDefault>;
+}
+interface EitherPrimitiveSchema<TVariants extends readonly ScalarPrimitive[]> {
+  readonly required: boolean;
+  readonly defaultValue: InferEitherState<TVariants> | undefined;
+  readonly variants: TVariants;
+}
+declare class EitherPrimitive<TVariants extends readonly ScalarPrimitive[], TRequired extends boolean = false, THasDefault extends boolean = false> implements Primitive<InferEitherState<TVariants>, EitherProxy<TVariants, TRequired, THasDefault>, TRequired, THasDefault, InferSetInput<TVariants, TRequired, THasDefault>, InferUpdateInput<TVariants, TRequired, THasDefault>> {
+  readonly _tag: "EitherPrimitive";
+  readonly _State: InferEitherState<TVariants>;
+  readonly _Proxy: EitherProxy<TVariants, TRequired, THasDefault>;
+  readonly _TRequired: TRequired;
+  readonly _THasDefault: THasDefault;
+  readonly TUpdateInput: InferUpdateInput<TVariants, TRequired, THasDefault>;
+  readonly TSetInput: InferSetInput<TVariants, TRequired, THasDefault>;
+  private readonly _schema;
+  private readonly _opDefinitions;
+  constructor(schema: EitherPrimitiveSchema<TVariants>);
+  /** Mark this either as required */
+  required(): EitherPrimitive<TVariants, true, THasDefault>;
+  /** Set a default value for this either */
+  default(defaultValue: InferEitherState<TVariants>): EitherPrimitive<TVariants, TRequired, true>;
+  /** Get the variants */
+  get variants(): TVariants;
+  /**
+   * Determine the type category of a value based on the variants
+   */
+  private _getValueType;
+  /**
+   * Find the matching variant for a value.
+   * For literals, matches exact value. For other types, matches by typeof.
+   */
+  private _findMatchingVariant;
+  /**
+   * Get the operation kind for a variant
+   */
+  private _getVariantOperationKind;
+  /**
+   * Validate a value against the matching variant, including running its validators.
+   * Throws ValidationError if the value doesn't match any variant or fails validation.
+   */
+  private _validateAndApplyToVariant;
+  readonly _internal: PrimitiveInternal<InferEitherState<TVariants>, EitherProxy<TVariants, TRequired, THasDefault>>;
+}
+/**
+ * Creates a new EitherPrimitive with the given scalar variant types.
+ * Validators defined on the variants are applied when validating values.
+ *
+ * @example
+ * ```typescript
+ * // String or number
+ * const value = Either(String(), Number());
+ *
+ * // String, number, or boolean
+ * const status = Either(String(), Number(), Boolean()).default("pending");
+ *
+ * // With literal types
+ * const mode = Either(Literal("auto"), Literal("manual"), Number());
+ *
+ * // With validators - validates string length and number range
+ * const constrained = Either(
+ *   String().min(2).max(50),
+ *   Number().max(255)
+ * );
+ * ```
+ */
+declare function Either<TVariants extends readonly ScalarPrimitive[]>(...variants: TVariants): EitherPrimitive<TVariants, false, false>;
+//#endregion
+export { Either, EitherMatchHandlers, EitherPrimitive, EitherProxy, InferEitherSnapshot, InferEitherState, ScalarPrimitive };
+//# sourceMappingURL=Either.d.mts.map

package/dist/primitives/Either.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Either.d.mts","names":[],"sources":["../../src/primitives/Either.ts"],"sourcesContent":[],"mappings":";;;;;;;KAiBK,yCAAyC,6FAA6F,WAAW,iBAAiB,YAAY,WAAW;KACzL,4CAA4C,6FAA6F,WAAW,iBAAiB,YAAY,WAAW;AAPtI;;;AAM2F,KAM1I,eAAA,GACR,eAPkJ,CAAA,GAAA,EAAA,GAAA,CAAA,GAQlJ,eARkJ,CAAA,GAAA,EAAA,GAAA,CAAA,GASlJ,gBATkJ,CAAA,GAAA,EAAA,GAAA,CAAA,GAUlJ,gBAVkJ,CAAA,GAAA,EAAA,GAAA,EAAA,GAAA,CAAA;;;;AAAD,KAezI,gBAfyI,CAAA,kBAAA,SAe7F,eAf6F,EAAA,CAAA,GAgBnJ,UAhBmJ,CAgBxI,SAhBwI,CAAA,MAAA,CAAA,CAAA;AAAA;;;AACI,KAoB7I,mBApB6I,CAAA,kBAAA,SAoB9F,eApB8F,EAAA,CAAA,GAqBvJ,UArBuJ,CAqB5I,SArB4I,CAAA,MAAA,CAAA,CAAA;;;;AAAD,UA0BvI,mBA1BuI,CAAA,CAAA,CAAA,CAAA;EAK5I,MAAA,CAAA,EAAA,CAAA,KAAA,EAAA,MAAe,EAAA,GAsBG,CAtBH;EACvB,MAAA,CAAA,EAAA,CAAA,KAAA,EAAA,MAAA,EAAA,GAsB0B,CAtB1B;EACA,OAAA,CAAA,EAAA,CAAA,KAAA,EAAA,OAAA,EAAA,GAsB4B,CAtB5B;EACA,OAAA,CAAA,EAAA,CAAA,KAAA,EAsBgB,YAtBhB,EAAA,GAsBiC,CAtBjC;;;AAMJ;;AACa,UAqBI,WArBJ,CAAA,kBAAA,SAqB2C,eArB3C,EAAA,EAAA,kBAAA,OAAA,GAAA,KAAA,EAAA,oBAAA,OAAA,GAAA,KAAA,CAAA,CAAA;EAAX;EAAU,GAAA,EAAA,EAuBH,cAvBG,CAuBY,gBAvBZ,CAuB6B,SAvB7B,CAAA,EAuByC,SAvBzC,EAuBoD,WAvBpD,CAAA;EAKA;EAA+C,GAAA,CAAA,KAAA,EAqB9C,aArB8C,CAqBhC,SArBgC,EAqBrB,SArBqB,EAqBV,WArBU,CAAA,CAAA,EAAA,IAAA;EAC9C;EAAX,MAAA,CAAA,KAAA,EAuBc,gBAvBd,CAuB+B,SAvB/B,EAuB0C,SAvB1C,EAuBqD,WAvBrD,CAAA,CAAA,EAAA,IAAA;EAAU;EAKK,KAAA,CAAA,CAAA,CAAA,CAAA,QAAA,EAqBI,mBArBe,CAqBK,CArBL,CAAA,CAAA,EAqBU,CArBV,GAAA,SAAA;EACN;EACA,UAAA,EAAA,EAsBd,cAtBc,CAsBC,mBAtBD,CAsBqB,SAtBrB,CAAA,EAsBiC,SAtBjC,EAsB4C,WAtB5C,CAAA;;UAyBpB,qBAvBU,CAAA,kBAAA,SAuBuC,eAvBvC,EAAA,CAAA,CAAA;EAAiB,SAAA,QAAA,EAAA,OAAA;EAAC,SAAA,YAAA,EAyBb,gBAzBa,CAyBI,SAzBJ,CAAA,GAAA,SAAA;EAMrB,SAAA,QAAW,EAoBP,SApBO;;AAEa,cAqB5B,eArB4B,CAAA,kBAAA,SAqBe,eArBf,EAAA,EAAA,kBAAA,OAAA,GAAA,KAAA,EAAA,oBAAA,OAAA,GAAA,KAAA,CAAA,YAsB5B,SAtB4B,CAsBlB,gBAtBkB,CAsBD,SAtBC,CAAA,EAsBW,WAtBX,CAsBuB,SAtBvB,EAsBkC,SAtBlC,EAsB6C,WAtB7C,CAAA,EAsB2D,SAtB3D,EAsBsE,WAtBtE,EAsBmF,aAtBnF,CAsBiG,SAtBjG,EAsB4G,SAtB5G,EAsBuH,WAtBvH,CAAA,EAsBqI,gBAtBrI,CAsBsJ,SAtBtJ,EAsBiK,SAtBjK,EAsB4K,WAtB5K,CAAA,CAAA,CAAA;EAAjB,SAAA,IAAA,EAAA,iBAAA;EAA6B,SAAA,MAAA,EAyBjC,gBAzBiC,CAyBhB,SAzBgB,CAAA;EAAW,SAAA,MAAA,EA0B5C,WA1B4C,CA0BhC,SA1BgC,EA0BrB,SA1BqB,EA0BV,WA1BU,CAAA;EAAvD,SAAA,UAAA,EA2Be,SA3Bf;EAGkB,SAAA,YAAA,EAyBD,WAzBC;EAAW,SAAA,YAAA,EA0BZ,gBA1BY,CA0BK,SA1BL,EA0BgB,SA1BhB,EA0B2B,WA1B3B,CAAA;EAAW,SAAA,SAAA,EA2B1B,aA3B0B,CA2BZ,SA3BY,EA2BD,SA3BC,EA2BU,WA3BV,CAAA;EAApC,iBAAA,OAAA;EAGoB,iBAAA,cAAA;EAAW,WAAA,CAAA,MAAA,EAqCtB,qBArCsB,CAqCA,SArCA,CAAA;EAAW;EAAvC,QAAA,CAAA,CAAA,EA0CF,eA1CE,CA0Cc,SA1Cd,EAAA,IAAA,EA0C+B,WA1C/B,CAAA;EAGyB;EAApB,OAAA,CAAA,YAAA,EA+CG,gBA/CH,CA+CoB,SA/CpB,CAAA,CAAA,EA+CiC,eA/CjC,CA+CiD,SA/CjD,EA+C4D,SA/C5D,EAAA,IAAA,CAAA;EAAyB;EAGK,IAAA,QAAA,CAAA,CAAA,EAoDjC,SApDiC;EAApB;;;EAAf,QAAA,aAAA;EAAc;AAC7B;;;EAIwB,QAAA,oBAAA;EACJ;;AAGrB;EAAwD,QAAA,wBAAA;EAChB;;;;EAA8C,QAAA,0BAAA;EAAlC,SAAA,SAAA,EAoL9B,iBApL8B,CAoLZ,gBApLY,CAoLK,SApLL,CAAA,EAoLiB,WApLjB,CAoL6B,SApL7B,EAoLwC,SApLxC,EAoLmD,WApLnD,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;AAQJ,iBAuRhC,MAvRgC,CAAA,kBAAA,SAuRE,eAvRF,EAAA,CAAA,CAAA,GAAA,QAAA,EAwRjC,SAxRiC,CAAA,EAyR7C,eAzR6C,CAyR7B,SAzR6B,EAAA,KAAA,EAAA,KAAA,CAAA"}

package/dist/primitives/Either.mjs

@@ -0,0 +1,199 @@
+import { _defineProperty } from "../_virtual/_@oxc-project_runtime@0.103.0/helpers/defineProperty.mjs";
+import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.103.0/helpers/objectSpread2.mjs";
+import { ValidationError } from "./shared.mjs";
+import { make } from "../OperationDefinition.mjs";
+import { pathsOverlap } from "../OperationPath.mjs";
+import { fromDefinition } from "../Operation.mjs";
+import { Schema } from "effect";
+
+//#region src/primitives/Either.ts
+var EitherPrimitive = class EitherPrimitive {
+	constructor(schema) {
+		_defineProperty(this, "_tag", "EitherPrimitive");
+		_defineProperty(this, "_State", void 0);
+		_defineProperty(this, "_Proxy", void 0);
+		_defineProperty(this, "_TRequired", void 0);
+		_defineProperty(this, "_THasDefault", void 0);
+		_defineProperty(this, "TUpdateInput", void 0);
+		_defineProperty(this, "TSetInput", void 0);
+		_defineProperty(this, "_schema", void 0);
+		_defineProperty(this, "_opDefinitions", { set: make({
+			kind: "either.set",
+			payload: Schema.Unknown,
+			target: Schema.Unknown,
+			apply: (payload) => payload
+		}) });
+		_defineProperty(this, "_internal", {
+			createProxy: (env, operationPath) => {
+				const defaultValue = this._schema.defaultValue;
+				return {
+					get: () => {
+						const state = env.getState(operationPath);
+						return state !== null && state !== void 0 ? state : defaultValue;
+					},
+					set: (value) => {
+						env.addOperation(fromDefinition(operationPath, this._opDefinitions.set, value));
+					},
+					update: (value) => {
+						env.addOperation(fromDefinition(operationPath, this._opDefinitions.set, value));
+					},
+					match: (handlers) => {
+						const currentState = env.getState(operationPath);
+						const effectiveState = currentState !== null && currentState !== void 0 ? currentState : defaultValue;
+						if (effectiveState === void 0) return void 0;
+						const valueType = this._getValueType(effectiveState);
+						if (!valueType) return void 0;
+						switch (valueType) {
+							case "string":
+								var _handlers$string;
+								return (_handlers$string = handlers.string) === null || _handlers$string === void 0 ? void 0 : _handlers$string.call(handlers, effectiveState);
+							case "number":
+								var _handlers$number;
+								return (_handlers$number = handlers.number) === null || _handlers$number === void 0 ? void 0 : _handlers$number.call(handlers, effectiveState);
+							case "boolean":
+								var _handlers$boolean;
+								return (_handlers$boolean = handlers.boolean) === null || _handlers$boolean === void 0 ? void 0 : _handlers$boolean.call(handlers, effectiveState);
+							case "literal":
+								var _handlers$literal;
+								return (_handlers$literal = handlers.literal) === null || _handlers$literal === void 0 ? void 0 : _handlers$literal.call(handlers, effectiveState);
+							default: return;
+						}
+					},
+					toSnapshot: () => {
+						const state = env.getState(operationPath);
+						return state !== null && state !== void 0 ? state : defaultValue;
+					}
+				};
+			},
+			applyOperation: (_state, operation) => {
+				if (operation.kind !== "either.set") throw new ValidationError(`EitherPrimitive cannot apply operation of kind: ${operation.kind}`);
+				const payload = operation.payload;
+				this._validateAndApplyToVariant(payload, operation.path);
+				return payload;
+			},
+			getInitialState: () => {
+				return this._schema.defaultValue;
+			},
+			transformOperation: (clientOp, serverOp) => {
+				if (!pathsOverlap(clientOp.path, serverOp.path)) return {
+					type: "transformed",
+					operation: clientOp
+				};
+				return {
+					type: "transformed",
+					operation: clientOp
+				};
+			}
+		});
+		this._schema = schema;
+	}
+	/** Mark this either as required */
+	required() {
+		return new EitherPrimitive(_objectSpread2(_objectSpread2({}, this._schema), {}, { required: true }));
+	}
+	/** Set a default value for this either */
+	default(defaultValue) {
+		return new EitherPrimitive(_objectSpread2(_objectSpread2({}, this._schema), {}, { defaultValue }));
+	}
+	/** Get the variants */
+	get variants() {
+		return this._schema.variants;
+	}
+	/**
+	* Determine the type category of a value based on the variants
+	*/
+	_getValueType(value) {
+		const valueType = typeof value;
+		for (const variant of this._schema.variants) if (variant._tag === "LiteralPrimitive") {
+			if (value === variant.literal) return "literal";
+		}
+		if (valueType === "string") {
+			for (const variant of this._schema.variants) if (variant._tag === "StringPrimitive") return "string";
+		}
+		if (valueType === "number") {
+			for (const variant of this._schema.variants) if (variant._tag === "NumberPrimitive") return "number";
+		}
+		if (valueType === "boolean") {
+			for (const variant of this._schema.variants) if (variant._tag === "BooleanPrimitive") return "boolean";
+		}
+	}
+	/**
+	* Find the matching variant for a value.
+	* For literals, matches exact value. For other types, matches by typeof.
+	*/
+	_findMatchingVariant(value) {
+		const valueType = typeof value;
+		for (const variant of this._schema.variants) if (variant._tag === "LiteralPrimitive") {
+			if (value === variant.literal) return variant;
+		}
+		if (valueType === "string") {
+			for (const variant of this._schema.variants) if (variant._tag === "StringPrimitive") return variant;
+		}
+		if (valueType === "number") {
+			for (const variant of this._schema.variants) if (variant._tag === "NumberPrimitive") return variant;
+		}
+		if (valueType === "boolean") {
+			for (const variant of this._schema.variants) if (variant._tag === "BooleanPrimitive") return variant;
+		}
+	}
+	/**
+	* Get the operation kind for a variant
+	*/
+	_getVariantOperationKind(variant) {
+		switch (variant._tag) {
+			case "StringPrimitive": return "string.set";
+			case "NumberPrimitive": return "number.set";
+			case "BooleanPrimitive": return "boolean.set";
+			case "LiteralPrimitive": return "literal.set";
+			default: return "unknown.set";
+		}
+	}
+	/**
+	* Validate a value against the matching variant, including running its validators.
+	* Throws ValidationError if the value doesn't match any variant or fails validation.
+	*/
+	_validateAndApplyToVariant(value, path) {
+		const matchingVariant = this._findMatchingVariant(value);
+		if (!matchingVariant) throw new ValidationError(`EitherPrimitive.set requires a value matching one of: ${this._schema.variants.map((v) => v._tag).join(", ")}, got: ${typeof value}`);
+		const syntheticOp = {
+			kind: this._getVariantOperationKind(matchingVariant),
+			path,
+			payload: value
+		};
+		matchingVariant._internal.applyOperation(void 0, syntheticOp);
+	}
+};
+/**
+* Creates a new EitherPrimitive with the given scalar variant types.
+* Validators defined on the variants are applied when validating values.
+*
+* @example
+* ```typescript
+* // String or number
+* const value = Either(String(), Number());
+*
+* // String, number, or boolean
+* const status = Either(String(), Number(), Boolean()).default("pending");
+*
+* // With literal types
+* const mode = Either(Literal("auto"), Literal("manual"), Number());
+*
+* // With validators - validates string length and number range
+* const constrained = Either(
+*   String().min(2).max(50),
+*   Number().max(255)
+* );
+* ```
+*/
+function Either(...variants) {
+	if (variants.length === 0) throw new ValidationError("Either requires at least one variant");
+	return new EitherPrimitive({
+		required: false,
+		defaultValue: void 0,
+		variants
+	});
+}
+
+//#endregion
+export { Either, EitherPrimitive };
+//# sourceMappingURL=Either.mjs.map