@craft-ts/core 0.7.0-beta.13

package/src/lib/form/validator.d.ts

@@ -0,0 +1,174 @@
+import { Signal } from '../host/craft-compat';
+import { AnyCraftException, CraftExceptionResult, ExcludeByCode, ExtractCodeFromCraftResultUnion } from '../craft-exception';
+import { type YieldableReactiveValue } from '../reactive-read';
+import { MergeObjects } from '../util/util.type';
+import { CraftValidator, CraftValidatorContext, FieldAttributeMeta } from './craft-field';
+export declare const VALIDATOR_OUTPUT_SYMBOL: unique symbol;
+export type ValidatorType = 'sync' | 'async';
+export type ValidatorUtilBrand<Name, Type extends ValidatorType = ValidatorType, Meta extends object = {}> = {
+    __brand: Name;
+    type: Type;
+} & Meta;
+export type ValidatorSuccess<Name extends string, Type extends ValidatorType = 'sync', Meta extends object = {}> = {
+    valid: true;
+} & ValidatorUtilBrand<Name, Type, Meta>;
+export type ValidatorPending<Name extends string, Type extends ValidatorType = 'async', Meta extends object = {}> = {
+    valid: false;
+} & ValidatorUtilBrand<Name, Type, Meta>;
+type ValidatorRuntimeKind = 'signal';
+type ValidatorRuntime<Name extends string = string, Type extends ValidatorType = ValidatorType, Kind extends ValidatorRuntimeKind = ValidatorRuntimeKind> = {
+    readonly name: Name;
+    readonly type: Type;
+    readonly kind: Kind;
+};
+type ValidatorRuntimeCarrier<Name extends string = string, Type extends ValidatorType = ValidatorType, Kind extends ValidatorRuntimeKind = ValidatorRuntimeKind> = {
+    readonly [VALIDATOR_OUTPUT_SYMBOL]: ValidatorRuntime<Name, Type, Kind>;
+};
+/**
+ * A Craft validator factory output.
+ *
+ * Calling the returned function from inside `CraftField.ɵregisterValidator` (which
+ * `insertFormAttributes` does internally) yields a `CraftValidatorResult` that the
+ * field aggregates into its `errors()` and native-constraint signals.
+ */
+export type ValidatorOutput<TValue, Name extends string, Exceptions, Type extends ValidatorType = 'sync', Identifier = unknown, Meta extends object = {}> = CraftValidator<TValue> & ValidatorRuntimeCarrier<Name, Type, 'signal'> & {
+    /** @internal phantom marker for type extraction */
+    readonly __exceptions?: Exceptions;
+    /** @internal phantom marker for type extraction */
+    readonly __meta?: Meta;
+    /** @internal phantom marker for type extraction */
+    readonly __identifier?: Identifier;
+};
+type ValidatorOption<TValue> = TValue | (() => TValue);
+type ValidatorConfig = {
+    when?: ValidatorOption<boolean>;
+};
+type ValueWithLengthOrSize = {
+    length: number;
+} | {
+    size: number;
+};
+type ValidatorException<Code extends string, Payload = undefined> = CraftExceptionResult<{
+    _tag: Code;
+}, Payload>;
+export type CRequiredException = ValidatorException<'required'>;
+export type CEmailException = ValidatorException<'email'>;
+export type CMinException = ValidatorException<'min', number>;
+export type CMaxException = ValidatorException<'max', number>;
+export type CMinLengthException = ValidatorException<'minLength', number>;
+export type CMaxLengthException = ValidatorException<'maxLength', number>;
+type CPatternException = ValidatorException<'pattern', RegExp>;
+type CRequiredConfig<TValue> = ValidatorConfig;
+type CEmailConfig<TValue extends string | null | undefined> = ValidatorConfig;
+type CMinConfig<TValue extends number | string | null | undefined> = ValidatorConfig & ({
+    min: ValidatorOption<number | undefined>;
+    minValue?: never;
+} | {
+    min?: never;
+    minValue: ValidatorOption<number | undefined>;
+});
+type CMaxConfig<TValue extends number | string | null | undefined> = ValidatorConfig & ({
+    max: ValidatorOption<number | undefined>;
+    maxValue?: never;
+} | {
+    max?: never;
+    maxValue: ValidatorOption<number | undefined>;
+});
+type CMinLengthConfig<TValue extends ValueWithLengthOrSize> = ValidatorConfig & {
+    minLength: ValidatorOption<number | undefined>;
+};
+type CMaxLengthConfig<TValue extends ValueWithLengthOrSize> = ValidatorConfig & {
+    maxLength: ValidatorOption<number | undefined>;
+};
+type CPatternConfig<TValue extends string | null | undefined> = ValidatorConfig & {
+    pattern: ValidatorOption<RegExp | undefined>;
+};
+type CValidateBaseConfig<Name extends string> = {
+    name: Name;
+    type?: 'sync';
+};
+type CValidateAdvancedSyncConfig<TValue, Name extends string, Exceptions, Identifier = unknown> = CValidateBaseConfig<Name> & {
+    validate: (context: CraftValidatorContext<TValue> & {
+        identifier: Identifier;
+    }) => Signal<Exceptions | undefined>;
+};
+type CValidateSimpleSyncConfig<TValue, Name extends string, Exceptions, Identifier = unknown> = CValidateBaseConfig<Name> & ValidatorConfig & {
+    validWhen: ValidatorOption<boolean>;
+    exception: ValidatorOption<Exceptions>;
+};
+type CValidateSyncConfig<TValue, Name extends string, Exceptions, Identifier = unknown> = CValidateAdvancedSyncConfig<TValue, Name, Exceptions, Identifier> | CValidateSimpleSyncConfig<TValue, Name, Exceptions, Identifier>;
+type AsyncReactiveValue<T> = Signal<T> | YieldableReactiveValue<T>;
+type AnyAsyncCraftResourceRef = {
+    kind: 'query' | 'mutation';
+    exceptions: AsyncReactiveValue<{
+        list: AnyCraftException[];
+    }>;
+    hasException: AsyncReactiveValue<boolean>;
+    resourceParamsSrc: AsyncReactiveValue<unknown>;
+    call?: (value: any) => unknown;
+    mutate?: (value: any) => unknown;
+    select?: (identifier: any) => unknown;
+};
+type AsyncValidatorResourceTarget<TResourceRef> = TResourceRef extends {
+    select: (...args: any[]) => infer SelectedResource;
+} ? NonNullable<SelectedResource> : TResourceRef;
+type AsyncValidatorResourceIdentifier<TResourceRef> = TResourceRef extends {
+    select: (identifier: infer Identifier) => unknown;
+} ? Identifier : unknown;
+type AsyncValidatorResourceExceptionUnion<TResource> = TResource extends {
+    exceptions: AsyncReactiveValue<{
+        list: (infer Exception)[];
+    }>;
+} ? Exception : never;
+type ExtractValidatorExceptionItems<T> = T extends readonly (infer Item)[] ? Item : T;
+type AsyncValidatorContext<TValue, TResourceRef extends AnyAsyncCraftResourceRef, Identifier = unknown, TResource = AsyncValidatorResourceTarget<TResourceRef>, ResourceExceptions = AsyncValidatorResourceExceptionUnion<TResource>, ResourceExceptionCodes = ExtractCodeFromCraftResultUnion<ResourceExceptions>> = CraftValidatorContext<TValue> & {
+    identifier: Identifier;
+    validateAsyncCraftResource: TResource;
+    omitExceptions: <C extends ResourceExceptionCodes>(codes: readonly C[]) => ExcludeByCode<ResourceExceptions, C>[];
+};
+type IsValidAsyncExceptions<T> = [unknown] extends [T] ? true : NonNullable<T> extends AnyCraftException ? true : NonNullable<T> extends readonly (infer Item)[] ? Item extends AnyCraftException ? true : false : false;
+type HasValidAsyncExceptionReturn<SuccessExceptions, ErrorExceptions, ExceptionExceptions> = IsValidAsyncExceptions<SuccessExceptions> extends true ? IsValidAsyncExceptions<ErrorExceptions> extends true ? IsValidAsyncExceptions<ExceptionExceptions> extends true ? true : {
+    success: true;
+    error: true;
+    exceptions: false;
+} : {
+    success: true;
+    error: false;
+    exceptions: IsValidAsyncExceptions<ExceptionExceptions>;
+} : {
+    success: false;
+    error: IsValidAsyncExceptions<ErrorExceptions>;
+    exceptions: IsValidAsyncExceptions<ExceptionExceptions>;
+};
+type ValidationDetails = {
+    success: boolean;
+    error: boolean;
+    exceptions: boolean;
+};
+type InvalidAsyncExceptionsMessage<T> = T extends true ? never : T extends ValidationDetails ? `Not valid ${(T['success'] extends false ? 'exceptionsOnSuccess callback' : never) | (T['error'] extends false ? 'error callback' : never) | (T['exceptions'] extends false ? 'onException callback' : never)}` : never;
+type CAsyncValidateConfig<TValue, Name extends string, TResourceRef extends AnyAsyncCraftResourceRef, SuccessExceptions, ErrorExceptions, ExceptionExceptions, Identifier = unknown> = MergeObjects<[
+    ValidatorConfig & {
+        name: Name;
+        isValidSuccess?: (context: AsyncValidatorContext<TValue, TResourceRef, Identifier>) => boolean;
+        exceptionsOnSuccess?: (context: AsyncValidatorContext<TValue, TResourceRef, Identifier>) => SuccessExceptions;
+        exception?: (context: AsyncValidatorContext<TValue, TResourceRef, Identifier>) => ErrorExceptions;
+        onException?: (context: AsyncValidatorContext<TValue, TResourceRef, Identifier>) => ExceptionExceptions;
+    },
+    HasValidAsyncExceptionReturn<SuccessExceptions, ErrorExceptions, ExceptionExceptions> extends true ? {} : {
+        typingError: `cAsyncValidate callbacks must only return Craft exceptions, arrays of Craft exceptions, or undefined. ${InvalidAsyncExceptionsMessage<HasValidAsyncExceptionReturn<SuccessExceptions, ErrorExceptions, ExceptionExceptions>>}`;
+    }
+]>;
+type ToAsyncValidatorExceptions<ResourceExceptions, SuccessExceptions, ErrorExceptions, ExceptionExceptions> = [unknown] extends [ExceptionExceptions] ? Exclude<ResourceExceptions | ExtractValidatorExceptionItems<SuccessExceptions> | ExtractValidatorExceptionItems<ErrorExceptions>, undefined> : Exclude<ExtractValidatorExceptionItems<SuccessExceptions> | ExtractValidatorExceptionItems<ErrorExceptions> | ExtractValidatorExceptionItems<ExceptionExceptions>, undefined>;
+export declare function cRequired<TValue>(config?: CRequiredConfig<TValue>): ValidatorOutput<TValue, 'cRequired', CRequiredException>;
+export declare function cEmail<TValue extends string | null | undefined>(config?: CEmailConfig<TValue>): ValidatorOutput<TValue, 'cEmail', CEmailException>;
+export declare function cMin<TValue extends number | string | null | undefined>(config: CMinConfig<TValue>): ValidatorOutput<TValue, 'cMin', CMinException>;
+export declare function cMax<TValue extends number | string | null | undefined>(config: CMaxConfig<TValue>): ValidatorOutput<TValue, 'cMax', CMaxException>;
+export declare function cMinLength<TValue extends ValueWithLengthOrSize>(config: CMinLengthConfig<TValue>): ValidatorOutput<TValue, 'cMinLength', CMinLengthException>;
+export declare function cMaxLength<TValue extends ValueWithLengthOrSize>(config: CMaxLengthConfig<TValue>): ValidatorOutput<TValue, 'cMaxLength', CMaxLengthException>;
+export declare function cPattern<TValue extends string | null | undefined>(config: CPatternConfig<TValue>): ValidatorOutput<TValue, 'cPattern', CPatternException>;
+export declare function cValidate<TValue, const Name extends string, Exceptions, Identifier = unknown>(config: CValidateSyncConfig<TValue, Name, Exceptions, Identifier>): ValidatorOutput<TValue, Name, Exceptions, 'sync', Identifier>;
+export declare const cValidator: typeof cValidate;
+export declare function cAsyncValidate<TValue, TResourceRef extends AnyAsyncCraftResourceRef, const Name extends string, SuccessExceptions = undefined, ErrorExceptions = undefined, ExceptionExceptions = unknown, Identifier = AsyncValidatorResourceIdentifier<TResourceRef>>(resourceRef: TResourceRef, config: CAsyncValidateConfig<TValue, Name, TResourceRef, SuccessExceptions, ErrorExceptions, ExceptionExceptions, Identifier>): ValidatorOutput<TValue, Name, ToAsyncValidatorExceptions<AsyncValidatorResourceExceptionUnion<AsyncValidatorResourceTarget<TResourceRef>>, SuccessExceptions, ErrorExceptions, ExceptionExceptions>, 'async', Identifier>;
+export declare const cAsyncValidator: typeof cAsyncValidate;
+export type { CraftValidator, CraftValidatorContext, FieldAttributeMeta };
+//# sourceMappingURL=validator.d.ts.map

package/src/lib/form/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/form/validator.ts"],"names":[],"mappings":"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"}

package/src/lib/form/validator.js

@@ -0,0 +1,465 @@
+import { computed, effect, signal, untracked } from '../host/craft-compat';
+import { CRAFT_EXCEPTION_SYMBOL, isCraftException, } from '../craft-exception';
+import { isYieldableReactiveValue, rawReactiveFacade, rawReactiveValue, } from '../reactive-read';
+export const VALIDATOR_OUTPUT_SYMBOL = Symbol('VALIDATOR_OUTPUT_SYMBOL');
+const SYNC_VALIDATOR_TYPE = 'sync';
+const ASYNC_VALIDATOR_TYPE = 'async';
+function resolveValidatorOption(option) {
+    if (typeof option === 'function') {
+        return option();
+    }
+    return option;
+}
+function shouldValidate(when) {
+    return when === undefined ? true : resolveValidatorOption(when);
+}
+function brandException(name, type, _tag, payload) {
+    return {
+        _tag,
+        [CRAFT_EXCEPTION_SYMBOL]: true,
+        payload,
+        [_tag]: payload,
+        __brand: name,
+        type,
+    };
+}
+function brandRawException(name, type, exception) {
+    if (Array.isArray(exception)) {
+        return exception.map((e) => ({ ...e, __brand: name, type }));
+    }
+    return { ...exception, __brand: name, type };
+}
+function withRuntime(validator, runtime) {
+    return Object.assign(validator, {
+        [VALIDATOR_OUTPUT_SYMBOL]: runtime,
+    });
+}
+function isEmptyValue(value) {
+    if (value === null || value === undefined)
+        return true;
+    if (typeof value === 'string')
+        return value.length === 0;
+    if (Array.isArray(value))
+        return value.length === 0;
+    return false;
+}
+function asNumber(value) {
+    if (value === null || value === undefined || value === '')
+        return undefined;
+    const n = typeof value === 'number' ? value : Number(value);
+    return Number.isNaN(n) ? undefined : n;
+}
+function lengthOf(value) {
+    if (value === null || value === undefined)
+        return undefined;
+    if (typeof value === 'string')
+        return value.length;
+    if (Array.isArray(value))
+        return value.length;
+    if (typeof value === 'object' &&
+        'length' in value &&
+        typeof value.length === 'number') {
+        return value.length;
+    }
+    if (typeof value === 'object' &&
+        'size' in value &&
+        typeof value.size === 'number') {
+        return value.size;
+    }
+    return undefined;
+}
+function normalizeCraftExceptionOutput(value) {
+    if (value === undefined)
+        return undefined;
+    if (Array.isArray(value)) {
+        const list = value.filter(isCraftException);
+        return list.length === 0 ? undefined : { raw: list, list };
+    }
+    if (!isCraftException(value))
+        return undefined;
+    return { raw: value, list: [value] };
+}
+function getResourceExceptionList(value) {
+    if (typeof value !== 'object' ||
+        value === null ||
+        !('exceptions' in value) ||
+        typeof value.exceptions !== 'function') {
+        return [];
+    }
+    const exceptions = value.exceptions;
+    const list = readAsyncReactiveValue(exceptions)?.list;
+    return Array.isArray(list) ? list.filter(isCraftException) : [];
+}
+function hasResourceExceptions(value) {
+    if (typeof value === 'object' &&
+        value !== null &&
+        'hasException' in value &&
+        typeof value.hasException === 'function') {
+        return !!readAsyncReactiveValue(value.hasException);
+    }
+    return getResourceExceptionList(value).length > 0;
+}
+function isResourceRefWithSelection(value) {
+    return 'select' in value && typeof value.select === 'function';
+}
+function readAsyncReactiveValue(value) {
+    return isYieldableReactiveValue(value) ? rawReactiveValue(value)() : value();
+}
+function resolveAsyncValidatorResourceTarget(resourceRef, identifier) {
+    if (!isResourceRefWithSelection(resourceRef)) {
+        return resourceRef;
+    }
+    if (identifier === undefined || identifier === null)
+        return undefined;
+    return resourceRef.select(identifier);
+}
+// =====================================================================
+//  Built-in validators
+// =====================================================================
+function createRequiredValidator({ when, }) {
+    const validator = ({ value }) => ({
+        result: computed(() => {
+            if (!shouldValidate(when))
+                return undefined;
+            return isEmptyValue(value())
+                ? brandException('cRequired', SYNC_VALIDATOR_TYPE, 'required', undefined)
+                : undefined;
+        }),
+        attribute: computed(() => {
+            if (!shouldValidate(when))
+                return undefined;
+            return { kind: 'native-constraint', target: 'required', value: true };
+        }),
+    });
+    return withRuntime(validator, {
+        name: 'cRequired',
+        type: SYNC_VALIDATOR_TYPE,
+        kind: 'signal',
+    });
+}
+const EMAIL_REGEX = /^[a-zA-Z0-9_.+-]+@[a-zA-Z0-9-]+\.[a-zA-Z0-9-.]+$/;
+function createEmailValidator({ when, }) {
+    const validator = ({ value }) => ({
+        result: computed(() => {
+            if (!shouldValidate(when))
+                return undefined;
+            const v = value();
+            if (v === null || v === undefined || v === '')
+                return undefined;
+            if (typeof v !== 'string')
+                return undefined;
+            return EMAIL_REGEX.test(v)
+                ? undefined
+                : brandException('cEmail', SYNC_VALIDATOR_TYPE, 'email', undefined);
+        }),
+    });
+    return withRuntime(validator, {
+        name: 'cEmail',
+        type: SYNC_VALIDATOR_TYPE,
+        kind: 'signal',
+    });
+}
+function createMinValidator({ when, min: minValue, }) {
+    const validator = ({ value }) => ({
+        result: computed(() => {
+            if (!shouldValidate(when))
+                return undefined;
+            const m = resolveValidatorOption(minValue);
+            if (m === undefined)
+                return undefined;
+            const n = asNumber(value());
+            if (n === undefined)
+                return undefined;
+            return n < m
+                ? brandException('cMin', SYNC_VALIDATOR_TYPE, 'min', m)
+                : undefined;
+        }),
+        attribute: computed(() => {
+            const m = resolveValidatorOption(minValue);
+            return m !== undefined && shouldValidate(when)
+                ? { kind: 'native-constraint', target: 'min', value: m }
+                : undefined;
+        }),
+    });
+    return withRuntime(validator, {
+        name: 'cMin',
+        type: SYNC_VALIDATOR_TYPE,
+        kind: 'signal',
+    });
+}
+function createMaxValidator({ when, max: maxValue, }) {
+    const validator = ({ value }) => ({
+        result: computed(() => {
+            if (!shouldValidate(when))
+                return undefined;
+            const m = resolveValidatorOption(maxValue);
+            if (m === undefined)
+                return undefined;
+            const n = asNumber(value());
+            if (n === undefined)
+                return undefined;
+            return n > m
+                ? brandException('cMax', SYNC_VALIDATOR_TYPE, 'max', m)
+                : undefined;
+        }),
+        attribute: computed(() => {
+            const m = resolveValidatorOption(maxValue);
+            return m !== undefined && shouldValidate(when)
+                ? { kind: 'native-constraint', target: 'max', value: m }
+                : undefined;
+        }),
+    });
+    return withRuntime(validator, {
+        name: 'cMax',
+        type: SYNC_VALIDATOR_TYPE,
+        kind: 'signal',
+    });
+}
+function createMinLengthValidator({ when, minLength, }) {
+    const validator = ({ value }) => ({
+        result: computed(() => {
+            if (!shouldValidate(when))
+                return undefined;
+            const m = resolveValidatorOption(minLength);
+            if (m === undefined)
+                return undefined;
+            const len = lengthOf(value());
+            if (len === undefined)
+                return undefined;
+            return len < m
+                ? brandException('cMinLength', SYNC_VALIDATOR_TYPE, 'minLength', m)
+                : undefined;
+        }),
+        attribute: computed(() => {
+            const m = resolveValidatorOption(minLength);
+            return m !== undefined && shouldValidate(when)
+                ? { kind: 'native-constraint', target: 'minLength', value: m }
+                : undefined;
+        }),
+    });
+    return withRuntime(validator, {
+        name: 'cMinLength',
+        type: SYNC_VALIDATOR_TYPE,
+        kind: 'signal',
+    });
+}
+function createMaxLengthValidator({ when, maxLength, }) {
+    const validator = ({ value }) => ({
+        result: computed(() => {
+            if (!shouldValidate(when))
+                return undefined;
+            const m = resolveValidatorOption(maxLength);
+            if (m === undefined)
+                return undefined;
+            const len = lengthOf(value());
+            if (len === undefined)
+                return undefined;
+            return len > m
+                ? brandException('cMaxLength', SYNC_VALIDATOR_TYPE, 'maxLength', m)
+                : undefined;
+        }),
+        attribute: computed(() => {
+            const m = resolveValidatorOption(maxLength);
+            return m !== undefined && shouldValidate(when)
+                ? { kind: 'native-constraint', target: 'maxLength', value: m }
+                : undefined;
+        }),
+    });
+    return withRuntime(validator, {
+        name: 'cMaxLength',
+        type: SYNC_VALIDATOR_TYPE,
+        kind: 'signal',
+    });
+}
+function createPatternValidator({ when, pattern, }) {
+    const validator = ({ value }) => ({
+        result: computed(() => {
+            if (!shouldValidate(when))
+                return undefined;
+            const p = resolveValidatorOption(pattern);
+            if (p === undefined)
+                return undefined;
+            const v = value();
+            if (v === null || v === undefined || v === '')
+                return undefined;
+            if (typeof v !== 'string')
+                return undefined;
+            return p.test(v)
+                ? undefined
+                : brandException('cPattern', SYNC_VALIDATOR_TYPE, 'pattern', p);
+        }),
+    });
+    return withRuntime(validator, {
+        name: 'cPattern',
+        type: SYNC_VALIDATOR_TYPE,
+        kind: 'signal',
+    });
+}
+function createCustomSyncValidator(config) {
+    const { name } = config;
+    if ('validate' in config) {
+        const fn = config.validate;
+        const validator = (context) => {
+            const inner = fn({
+                ...context,
+                identifier: context.identifier,
+            });
+            return {
+                result: computed(() => {
+                    const result = inner();
+                    if (result === undefined)
+                        return undefined;
+                    const normalized = normalizeCraftExceptionOutput(result);
+                    if (!normalized)
+                        return undefined;
+                    return brandRawException(name, SYNC_VALIDATOR_TYPE, normalized.raw);
+                }),
+            };
+        };
+        return withRuntime(validator, {
+            name,
+            type: SYNC_VALIDATOR_TYPE,
+            kind: 'signal',
+        });
+    }
+    const simpleConfig = config;
+    const validator = () => ({
+        result: computed(() => {
+            if (!shouldValidate(simpleConfig.when))
+                return undefined;
+            if (resolveValidatorOption(simpleConfig.validWhen))
+                return undefined;
+            const exception = resolveValidatorOption(simpleConfig.exception);
+            const normalized = normalizeCraftExceptionOutput(exception);
+            if (!normalized)
+                return undefined;
+            return brandRawException(name, SYNC_VALIDATOR_TYPE, normalized.raw);
+        }),
+    });
+    return withRuntime(validator, {
+        name,
+        type: SYNC_VALIDATOR_TYPE,
+        kind: 'signal',
+    });
+}
+function createCustomAsyncValidator(resourceRef, config) {
+    const { name } = config;
+    const cfg = config;
+    const validator = (context) => {
+        const identifier = context.identifier;
+        const resourceTarget = computed(() => resolveAsyncValidatorResourceTarget(resourceRef, identifier));
+        const lastTriggered = signal(undefined);
+        // Trigger the resource when the value changes.
+        effect(() => {
+            const v = context.value();
+            const target = rawReactiveFacade(untracked(() => resourceTarget()));
+            if (!target)
+                return;
+            if (!shouldValidate(cfg.when))
+                return;
+            lastTriggered.set(v);
+            if (typeof target.mutate === 'function') {
+                target.mutate(v);
+            }
+            else if (typeof target.call === 'function') {
+                target.call(v);
+            }
+        });
+        const buildContext = (currentResource) => {
+            const exceptions = getResourceExceptionList(currentResource);
+            return {
+                ...context,
+                identifier: identifier,
+                validateAsyncCraftResource: currentResource,
+                omitExceptions: ((codes) => exceptions.filter((e) => !codes.includes(e._tag))),
+            };
+        };
+        const result = computed(() => {
+            const currentResource = resourceTarget();
+            const r = rawReactiveFacade(currentResource);
+            if (!r)
+                return undefined;
+            if (lastTriggered() === undefined)
+                return undefined;
+            if (r.isLoading())
+                return { pending: true };
+            const status = r.status();
+            const asyncCtx = buildContext(currentResource);
+            if (hasResourceExceptions(r)) {
+                const overridden = normalizeCraftExceptionOutput(cfg.onException?.(asyncCtx));
+                const fallback = normalizeCraftExceptionOutput(getResourceExceptionList(r));
+                const final = overridden ?? fallback;
+                if (!final)
+                    return undefined;
+                return brandRawException(name, ASYNC_VALIDATOR_TYPE, final.raw);
+            }
+            if (status === 'exception') {
+                const errorOutput = normalizeCraftExceptionOutput(cfg.exception?.(asyncCtx));
+                return errorOutput
+                    ? brandRawException(name, ASYNC_VALIDATOR_TYPE, errorOutput.raw)
+                    : undefined;
+            }
+            // Resolved
+            const isValid = cfg.isValidSuccess?.(asyncCtx) ?? true;
+            const onSuccess = normalizeCraftExceptionOutput(cfg.exceptionsOnSuccess?.(asyncCtx));
+            if (!isValid || onSuccess) {
+                if (onSuccess) {
+                    return brandRawException(name, ASYNC_VALIDATOR_TYPE, onSuccess.raw);
+                }
+                return brandException(name, ASYNC_VALIDATOR_TYPE, 'invalid', undefined);
+            }
+            return undefined;
+        });
+        return { result };
+    };
+    return withRuntime(validator, {
+        name,
+        type: ASYNC_VALIDATOR_TYPE,
+        kind: 'signal',
+    });
+}
+// =====================================================================
+//  Public API
+// =====================================================================
+export function cRequired(config) {
+    return createRequiredValidator(config ?? {});
+}
+export function cEmail(config) {
+    return createEmailValidator(config ?? {});
+}
+export function cMin(config) {
+    return createMinValidator({
+        when: config.when,
+        min: 'min' in config && config.min !== undefined
+            ? config.min
+            : config
+                .minValue,
+    });
+}
+export function cMax(config) {
+    return createMaxValidator({
+        when: config.when,
+        max: 'max' in config && config.max !== undefined
+            ? config.max
+            : config
+                .maxValue,
+    });
+}
+export function cMinLength(config) {
+    return createMinLengthValidator(config);
+}
+export function cMaxLength(config) {
+    return createMaxLengthValidator(config);
+}
+export function cPattern(config) {
+    return createPatternValidator(config);
+}
+export function cValidate(config) {
+    return createCustomSyncValidator(config);
+}
+export const cValidator = cValidate;
+export function cAsyncValidate(resourceRef, config) {
+    return createCustomAsyncValidator(resourceRef, config);
+}
+export const cAsyncValidator = cAsyncValidate;
+//# sourceMappingURL=validator.js.map