@craft-ts/core 0.7.0-beta.13

package/src/lib/form/insert-form-internals.d.ts

@@ -0,0 +1,110 @@
+import { Injector, Signal } from '../host/craft-compat';
+import type { InsertionStateFactoryContext } from '../query.core';
+import { Source$ as SourceDollarType } from '../source$';
+import { MergeObject } from '../util/types/util.type';
+import { FilterSource, IsEmptyObject } from '../util/util.type';
+import { CraftFieldTree } from './craft-field';
+import { type NonYieldableInsertionMethod, type YieldableInsertionMethods } from '../yieldable';
+import type { YieldableInsertionWrite } from '../query.core';
+import { type CraftFieldExceptionSourceCarrier, type CraftFieldValidationCasesCarrier, type FieldValidationCasesFromInsertions } from './field-exception';
+type Source$Method<SourceType> = [SourceType] extends [void] ? () => Generator<never, void, unknown> : (value: SourceType) => Generator<never, void, unknown>;
+type RawExposedFormInsertions<Insertions> = YieldableInsertionMethods<MergeObject<IsEmptyObject<Insertions> extends true ? {} : FilterSource<Insertions>, {
+    [K in keyof FilterSource<Insertions> as FilterSource<Insertions>[K] extends SourceDollarType<any> ? K : never]: FilterSource<Insertions>[K] extends SourceDollarType<infer SourceType> ? Source$Method<SourceType> : never;
+}>>;
+type JoinFieldPath<Prefix extends string, Path extends string> = Prefix extends '' ? Path : Path extends '[]' ? `${Prefix}[]` : `${Prefix}.${Path}`;
+type PrefixSelectedFormPath<Result, Prefix extends string> = Result extends FormWithInsertions<infer Model, infer Insertions, infer Path extends string> ? FormWithInsertions<Model, Insertions, JoinFieldPath<Prefix, Path>> : Result;
+type PrefixSelectedFormMethod<Value, Prefix extends string> = Value extends NonYieldableInsertionMethod<infer Args, infer Result> ? NonYieldableInsertionMethod<Args, PrefixSelectedFormPath<Result, Prefix>> : Value;
+type ExposedFormInsertions<Insertions, Path extends string = ''> = {
+    [Key in keyof RawExposedFormInsertions<Insertions>]: PrefixSelectedFormMethod<RawExposedFormInsertions<Insertions>[Key], Path>;
+};
+type FormExceptionSignal<Insertions, ExceptionName extends string> = `${Uncapitalize<ExceptionName>}Exceptions` extends keyof ExposedFormInsertions<Insertions> ? ExposedFormInsertions<Insertions>[`${Uncapitalize<ExceptionName>}Exceptions`] extends Signal<infer Exceptions> ? Exceptions : never : never;
+type HasFormExceptionSignalPair<Insertions, ExceptionName extends string, HasExceptionKey extends keyof ExposedFormInsertions<Insertions>> = ExposedFormInsertions<Insertions>[HasExceptionKey] extends Signal<boolean> ? `${Uncapitalize<ExceptionName>}Exceptions` extends keyof ExposedFormInsertions<Insertions> ? ExposedFormInsertions<Insertions>[`${Uncapitalize<ExceptionName>}Exceptions`] extends Signal<unknown> ? true : false : false : false;
+type FormExceptionMap<Insertions> = {
+    [K in keyof ExposedFormInsertions<Insertions> as K extends string ? K extends `has${infer Name}Exceptions` ? HasFormExceptionSignalPair<Insertions, Name, K> extends true ? Uncapitalize<Name> : never : never : never]: K extends `has${infer Name}Exceptions` ? FormExceptionSignal<Insertions, Name> : never;
+};
+type FormExceptionsInsertion<Insertions> = keyof FormExceptionMap<Insertions> extends never ? {} : {
+    hasExceptions: Signal<boolean>;
+    exceptions: Signal<FormExceptionMap<Insertions>>;
+};
+/**
+ * The full type of a craft form, exposed by `insertForm`.
+ *
+ * It is a `CraftFieldTree<Model>` (with sub-field navigation) merged with all the
+ * insertion outputs (e.g. submit, exceptions, validators) and aggregated exception signals.
+ */
+export type FormWithInsertions<Model, Insertions, Path extends string = ''> = CraftFieldTree<Model> & ExposedFormInsertions<Insertions, Path> & CraftFieldValidationCasesCarrier<FieldValidationCasesFromInsertions<Insertions, Path>> & CraftFieldExceptionSourceCarrier & {
+    hasAttemptedSubmit: Signal<boolean>;
+    submitting: Signal<boolean>;
+    validatedFormValue: Signal<ValidatedFormValue<Model>>;
+} & FormExceptionsInsertion<Insertions>;
+export type InsertionFormFactoryContext<StateType, PreviousInsertionsOutputs, FormIdentifier extends string | number | unknown> = InsertionStateFactoryContext<StateType, PreviousInsertionsOutputs> & {
+    field: CraftFieldTree<StateType>;
+    hasAttemptedSubmit: Signal<boolean>;
+    submitting: Signal<boolean>;
+    validatedFormValue: Signal<ValidatedFormValue<StateType>>;
+    setAttemptedSubmit: () => void;
+    setSubmitting: (submitting: boolean) => void;
+    formIdentifier: FormIdentifier;
+};
+export type InsertionsFormFactory<State, FormIdentifier extends string | number | unknown, InsertionsOutputs, PreviousInsertionsOutputs = {}, Yielded = never> = (context: InsertionFormFactoryContext<State, PreviousInsertionsOutputs, FormIdentifier>) => InsertionsOutputs | Generator<Yielded, InsertionsOutputs, unknown>;
+export declare const validatedFormValueSymbol: unique symbol;
+export type ValidatedFormValue<FormValue> = (FormValue & {
+    [validatedFormValueSymbol]: true;
+}) | undefined;
+export declare function createFormExceptions(rawInsertionsOutput: Record<string, unknown>, exposedInsertionsOutput: Record<string, unknown>): {
+    hasExceptions?: undefined;
+    exceptions?: undefined;
+} | {
+    hasExceptions: import("../..").ɵCraftSignal<boolean>;
+    exceptions: import("../..").ɵCraftSignal<{
+        [x: string]: unknown;
+    }>;
+};
+export type SubmissionController = {
+    hasAttemptedSubmit: Signal<boolean>;
+    submitting: Signal<boolean>;
+    setAttemptedSubmit: () => void;
+    setSubmitting: (submitting: boolean) => void;
+    reset: () => void;
+};
+export declare function createSubmissionController(): SubmissionController;
+/**
+ * Wrap a CraftFieldTree with extra properties (insertion outputs, exception
+ * aggregates, submission state) so the merged object behaves like a
+ * `FormWithInsertions`. Used by sub-form builders.
+ */
+export declare function wrapSubFieldWithExtras<T>(subField: CraftFieldTree<T>, extras: Record<string, unknown>): CraftFieldTree<T>;
+/**
+ * Build a fully-decorated sub-form (field tree + insertion outputs + exception
+ * aggregates) from a sub-field plus a state read/write pair. Used by both
+ * `insertSelectFormTree` (structural sub-fields) and `insertSubFormField`
+ * (derived sub-fields).
+ */
+export declare function buildSubForm<Sub>(options: {
+    parentContext: InsertionFormFactoryContext<unknown, unknown, unknown>;
+    subField: CraftFieldTree<Sub>;
+    subState: () => Sub;
+    setSub: (next: Sub) => void;
+    insertions: InsertionsFormFactory<Sub, unknown, Record<string, unknown>, Record<string, unknown>>[];
+    injector: Injector;
+}): FormWithInsertions<Sub, Record<string, unknown>>;
+export declare function executeFormInsertions<Model>(formInsertions: InsertionsFormFactory<Model, unknown, Record<string, unknown>, Record<string, unknown>>[], options: {
+    field: CraftFieldTree<Model>;
+    state: Signal<Model>;
+    submission: SubmissionController;
+    set: YieldableInsertionWrite<[newState: Model], Model>;
+    update: YieldableInsertionWrite<[
+        updateFn: (currentState: Model) => Model
+    ], Model>;
+    patch: YieldableInsertionWrite<[
+        patchFn: (currentState: Model) => Partial<Model>
+    ], Model>;
+    inheritedInsertions: Record<string, unknown>;
+    injector: Injector;
+    formIdentifier: string | number | unknown;
+}): {
+    rawInsertionsOutput: Record<string, unknown>;
+    exposedInsertionsOutput: Record<string, unknown>;
+};
+export {};
+//# sourceMappingURL=insert-form-internals.d.ts.map

package/src/lib/form/insert-form-internals.d.ts.map

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

package/src/lib/form/insert-form-internals.js

@@ -0,0 +1,276 @@
+import { computed, isSignal, runInInjectionContext, signal, } from '../host/craft-compat';
+import { isGenerator, runCraftGenerator } from '../craft-generator-runtime';
+import { injectFnWrapper } from '../fn-wrapper';
+import { ɵcreateHostTaggedInjector } from '../craft-service';
+import { isSource } from '../util/util';
+import { createYieldableInsertionMethod, isNonYieldableInsertionMethod, yieldableInvocation, } from '../yieldable';
+import { createYieldableReactiveValue, isYieldableReactiveValue, } from '../reactive-read';
+export const validatedFormValueSymbol = Symbol('validatedFormValue');
+function isSource$(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'emit' in value &&
+        typeof value.emit === 'function' &&
+        'subscribe' in value &&
+        typeof value.subscribe === 'function');
+}
+const FORM_INSERTION_METHOD_INVALID_YIELD_ERROR_MESSAGE = 'form insertion method generators can only yield craftService dependencies or exposed dependency helpers.';
+const FORM_INSERTION_METHOD_APP_START_ERROR_MESSAGE = 'form insertion method generators do not support onAppStart(...).';
+function createExposedInsertions(rawInsertionsOutput, injector) {
+    return Object.entries(rawInsertionsOutput).reduce((acc, [key, value]) => {
+        if (isSource(value))
+            return acc;
+        if (isSource$(value)) {
+            const localSource = value;
+            const sourceInjector = ɵcreateHostTaggedInjector(injector, `source:${key}`);
+            acc[key] = createYieldableInsertionMethod((payload) => localSource.emit(payload), {
+                injector: sourceInjector,
+                invalidYieldErrorMessage: FORM_INSERTION_METHOD_INVALID_YIELD_ERROR_MESSAGE,
+                multipleAppStartErrorMessage: FORM_INSERTION_METHOD_APP_START_ERROR_MESSAGE,
+                onAppStartNotSupportedErrorMessage: FORM_INSERTION_METHOD_APP_START_ERROR_MESSAGE,
+            });
+            return acc;
+        }
+        if (typeof value === 'function' &&
+            !isSignal(value) &&
+            !isYieldableReactiveValue(value) &&
+            !isNonYieldableInsertionMethod(value)) {
+            const methodInjector = ɵcreateHostTaggedInjector(injector, `method:${key}`);
+            const wrappedFn = runInInjectionContext(injector, () => injectFnWrapper()(value));
+            acc[key] = createYieldableInsertionMethod(wrappedFn, {
+                injector: methodInjector,
+                invalidYieldErrorMessage: FORM_INSERTION_METHOD_INVALID_YIELD_ERROR_MESSAGE,
+                multipleAppStartErrorMessage: FORM_INSERTION_METHOD_APP_START_ERROR_MESSAGE,
+                onAppStartNotSupportedErrorMessage: FORM_INSERTION_METHOD_APP_START_ERROR_MESSAGE,
+            });
+            return acc;
+        }
+        acc[key] = value;
+        return acc;
+    }, {});
+}
+function toExceptionInsertionName(name) {
+    return `${name.charAt(0).toLowerCase()}${name.slice(1)}`;
+}
+function toExceptionRecord(value) {
+    return typeof value === 'object' && value !== null
+        ? value
+        : {};
+}
+export function createFormExceptions(rawInsertionsOutput, exposedInsertionsOutput) {
+    const directHasExceptions = isSignal(exposedInsertionsOutput['hasExceptions'])
+        ? exposedInsertionsOutput['hasExceptions']
+        : undefined;
+    const directExceptions = isSignal(exposedInsertionsOutput['exceptions'])
+        ? exposedInsertionsOutput['exceptions']
+        : undefined;
+    const exceptionInsertions = Object.entries(exposedInsertionsOutput).flatMap(([key, value]) => {
+        const match = /^has(.+)Exceptions$/.exec(key);
+        if (!match || typeof value !== 'function')
+            return [];
+        const insertionName = toExceptionInsertionName(match[1]);
+        const exceptionsKey = `${insertionName}Exceptions`;
+        const exceptionSignal = exposedInsertionsOutput[exceptionsKey];
+        if (typeof exceptionSignal !== 'function')
+            return [];
+        return [
+            {
+                insertionName,
+                hasExceptionSignal: value,
+                exceptionSignal: exceptionSignal,
+            },
+        ];
+    });
+    if (exceptionInsertions.length === 0 &&
+        !directHasExceptions &&
+        !directExceptions) {
+        return {};
+    }
+    return {
+        hasExceptions: computed(() => (directHasExceptions?.() ?? false) ||
+            exceptionInsertions.some(({ hasExceptionSignal }) => hasExceptionSignal())),
+        exceptions: computed(() => exceptionInsertions.reduce((acc, { insertionName, exceptionSignal }) => {
+            acc[insertionName] = exceptionSignal();
+            return acc;
+        }, {
+            ...toExceptionRecord(directExceptions?.()),
+        })),
+    };
+}
+export function createSubmissionController() {
+    const attempted = signal(false);
+    const submitting = signal(false);
+    return {
+        hasAttemptedSubmit: attempted.asReadonly(),
+        submitting: submitting.asReadonly(),
+        setAttemptedSubmit: () => attempted.set(true),
+        setSubmitting: (next) => {
+            if (next)
+                attempted.set(true);
+            submitting.set(next);
+        },
+        reset: () => {
+            attempted.set(false);
+            submitting.set(false);
+        },
+    };
+}
+/**
+ * Wrap a CraftFieldTree with extra properties (insertion outputs, exception
+ * aggregates, submission state) so the merged object behaves like a
+ * `FormWithInsertions`. Used by sub-form builders.
+ */
+export function wrapSubFieldWithExtras(subField, extras) {
+    return new Proxy(subField, {
+        get(_target, prop, receiver) {
+            if (typeof prop === 'string' && prop in extras)
+                return extras[prop];
+            return Reflect.get(subField, prop, receiver);
+        },
+        has(_target, prop) {
+            if (typeof prop === 'string' && prop in extras)
+                return true;
+            return prop in subField;
+        },
+        ownKeys() {
+            return [
+                ...new Set([
+                    ...Reflect.ownKeys(subField),
+                    ...Object.keys(extras),
+                ]),
+            ];
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            if (typeof prop === 'string' && prop in extras) {
+                return {
+                    enumerable: true,
+                    configurable: true,
+                    value: extras[prop],
+                    writable: false,
+                };
+            }
+            return Object.getOwnPropertyDescriptor(subField, prop);
+        },
+    });
+}
+/**
+ * Build a fully-decorated sub-form (field tree + insertion outputs + exception
+ * aggregates) from a sub-field plus a state read/write pair. Used by both
+ * `insertSelectFormTree` (structural sub-fields) and `insertSubFormField`
+ * (derived sub-fields).
+ */
+export function buildSubForm(options) {
+    const stateSignal = computed(() => options.subState());
+    const subContext = {
+        state: stateSignal,
+        set: (next) => {
+            options.setSub(next);
+            return yieldableInvocation(next);
+        },
+        update: (fn) => {
+            const next = fn(options.subState());
+            options.setSub(next);
+            return yieldableInvocation(next);
+        },
+        patch: (fn) => {
+            const curr = options.subState();
+            const partial = fn(curr);
+            const next = curr && typeof curr === 'object' && !Array.isArray(curr)
+                ? { ...curr, ...partial }
+                : partial;
+            options.setSub(next);
+            return yieldableInvocation(next);
+        },
+        insertions: (options.parentContext.insertions ?? {}),
+    };
+    const { rawInsertionsOutput, exposedInsertionsOutput } = executeFormInsertions(options.insertions, {
+        field: options.subField,
+        state: stateSignal,
+        submission: {
+            hasAttemptedSubmit: options.parentContext.hasAttemptedSubmit,
+            submitting: options.parentContext.submitting,
+            setAttemptedSubmit: options.parentContext.setAttemptedSubmit,
+            setSubmitting: options.parentContext.setSubmitting,
+            reset: () => {
+                /* parent owns reset */
+            },
+        },
+        set: subContext.set,
+        update: subContext.update,
+        patch: subContext.patch,
+        inheritedInsertions: subContext.insertions,
+        injector: options.injector,
+        formIdentifier: options.parentContext.formIdentifier,
+    });
+    const formExceptions = createFormExceptions(rawInsertionsOutput, exposedInsertionsOutput);
+    return wrapSubFieldWithExtras(options.subField, {
+        ...exposedInsertionsOutput,
+        ...formExceptions,
+        hasAttemptedSubmit: options.parentContext.hasAttemptedSubmit,
+        submitting: options.parentContext.submitting,
+    });
+}
+export function executeFormInsertions(formInsertions, options) {
+    const validatedFormValue = computed(() => {
+        const fieldRoot = options.field;
+        if (!fieldRoot.valid())
+            return undefined;
+        const value = fieldRoot.value();
+        if (value && typeof value === 'object') {
+            return Object.assign(value, {
+                [validatedFormValueSymbol]: true,
+            });
+        }
+        return value;
+    });
+    const FORM_INSERTION_INVALID_YIELD_ERROR_MESSAGE = 'insertSelectFormTree generators can only yield craftService dependencies or exposed dependency helpers.';
+    const FORM_INSERTION_APP_START_ERROR_MESSAGE = 'insertSelectFormTree generators do not support onAppStart(...).';
+    return formInsertions.reduce((acc, insertion) => {
+        const wrappedInsertion = runInInjectionContext(options.injector, () => injectFnWrapper()(insertion));
+        const insertionCallResult = runInInjectionContext(options.injector, () => wrappedInsertion({
+            state: createYieldableReactiveValue(options.state, 'state', {
+                primitive: 'form',
+                path: 'form.state',
+            }),
+            set: options.set,
+            update: options.update,
+            patch: options.patch,
+            field: options.field,
+            hasAttemptedSubmit: options.submission.hasAttemptedSubmit,
+            submitting: options.submission.submitting,
+            validatedFormValue,
+            setAttemptedSubmit: options.submission.setAttemptedSubmit,
+            setSubmitting: options.submission.setSubmitting,
+            formIdentifier: options.formIdentifier,
+            insertions: {
+                ...options.inheritedInsertions,
+                ...acc.exposedInsertionsOutput,
+            },
+        }));
+        const nextRawInsertions = (isGenerator(insertionCallResult)
+            ? runInInjectionContext(options.injector, () => runCraftGenerator({
+                iterator: insertionCallResult,
+                injector: options.injector,
+                hostScope: 'function',
+                invalidYieldErrorMessage: FORM_INSERTION_INVALID_YIELD_ERROR_MESSAGE,
+                multipleAppStartErrorMessage: FORM_INSERTION_APP_START_ERROR_MESSAGE,
+                onAppStartNotSupportedErrorMessage: FORM_INSERTION_APP_START_ERROR_MESSAGE,
+            }).value)
+            : insertionCallResult);
+        const nextExposedInsertions = createExposedInsertions(nextRawInsertions, options.injector);
+        return {
+            rawInsertionsOutput: {
+                ...acc.rawInsertionsOutput,
+                ...nextRawInsertions,
+            },
+            exposedInsertionsOutput: {
+                ...acc.exposedInsertionsOutput,
+                ...nextExposedInsertions,
+            },
+        };
+    }, {
+        rawInsertionsOutput: {},
+        exposedInsertionsOutput: {},
+    });
+}
+//# sourceMappingURL=insert-form-internals.js.map

package/src/lib/form/insert-form-internals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-form-internals.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/form/insert-form-internals.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  computed,\n  Injector,\n  isSignal,\n  runInInjectionContext,\n  signal,\n  Signal,\n} from '../host/craft-compat';\nimport { isGenerator, runCraftGenerator } from '../craft-generator-runtime';\nimport { injectFnWrapper } from '../fn-wrapper';\nimport { ɵcreateHostTaggedInjector } from '../craft-service';\nimport type { InsertionStateFactoryContext } from '../query.core';\nimport { Source$ as SourceDollarType } from '../source$';\nimport { MergeObject } from '../util/types/util.type';\nimport { FilterSource, IsEmptyObject } from '../util/util.type';\nimport { isSource } from '../util/util';\nimport { CraftField, CraftFieldTree } from './craft-field';\nimport {\n  createYieldableInsertionMethod,\n  isNonYieldableInsertionMethod,\n  yieldableInvocation,\n  type NonYieldableInsertionMethod,\n  type YieldableInsertionMethods,\n} from '../yieldable';\nimport type { YieldableInsertionWrite } from '../query.core';\nimport {\n  createYieldableReactiveValue,\n  isYieldableReactiveValue,\n} from '../reactive-read';\nimport {\n  type CraftFieldExceptionSourceCarrier,\n  type CraftFieldValidationCasesCarrier,\n  type FieldValidationCasesFromInsertions,\n} from './field-exception';\n\ntype Source$Method<SourceType> = [SourceType] extends [void]\n  ? () => Generator<never, void, unknown>\n  : (value: SourceType) => Generator<never, void, unknown>;\n\ntype RawExposedFormInsertions<Insertions> = YieldableInsertionMethods<\n  MergeObject<\n    IsEmptyObject<Insertions> extends true ? {} : FilterSource<Insertions>,\n    {\n      [K in keyof FilterSource<Insertions> as FilterSource<Insertions>[K] extends SourceDollarType<any>\n        ? K\n        : never]: FilterSource<Insertions>[K] extends SourceDollarType<\n        infer SourceType\n      >\n        ? Source$Method<SourceType>\n        : never;\n    }\n  >\n>;\n\ntype JoinFieldPath<\n  Prefix extends string,\n  Path extends string,\n> = Prefix extends ''\n  ? Path\n  : Path extends '[]'\n    ? `${Prefix}[]`\n    : `${Prefix}.${Path}`;\n\ntype PrefixSelectedFormPath<Result, Prefix extends string> =\n  Result extends FormWithInsertions<\n    infer Model,\n    infer Insertions,\n    infer Path extends string\n  >\n    ? FormWithInsertions<Model, Insertions, JoinFieldPath<Prefix, Path>>\n    : Result;\n\ntype PrefixSelectedFormMethod<Value, Prefix extends string> =\n  Value extends NonYieldableInsertionMethod<infer Args, infer Result>\n    ? NonYieldableInsertionMethod<Args, PrefixSelectedFormPath<Result, Prefix>>\n    : Value;\n\ntype ExposedFormInsertions<Insertions, Path extends string = ''> = {\n  [Key in keyof RawExposedFormInsertions<Insertions>]: PrefixSelectedFormMethod<\n    RawExposedFormInsertions<Insertions>[Key],\n    Path\n  >;\n};\n\ntype FormExceptionSignal<\n  Insertions,\n  ExceptionName extends string,\n> = `${Uncapitalize<ExceptionName>}Exceptions` extends keyof ExposedFormInsertions<Insertions>\n  ? ExposedFormInsertions<Insertions>[`${Uncapitalize<ExceptionName>}Exceptions`] extends Signal<\n      infer Exceptions\n    >\n    ? Exceptions\n    : never\n  : never;\n\ntype HasFormExceptionSignalPair<\n  Insertions,\n  ExceptionName extends string,\n  HasExceptionKey extends keyof ExposedFormInsertions<Insertions>,\n> =\n  ExposedFormInsertions<Insertions>[HasExceptionKey] extends Signal<boolean>\n    ? `${Uncapitalize<ExceptionName>}Exceptions` extends keyof ExposedFormInsertions<Insertions>\n      ? ExposedFormInsertions<Insertions>[`${Uncapitalize<ExceptionName>}Exceptions`] extends Signal<unknown>\n        ? true\n        : false\n      : false\n    : false;\n\ntype FormExceptionMap<Insertions> = {\n  [K in keyof ExposedFormInsertions<Insertions> as K extends string\n    ? K extends `has${infer Name}Exceptions`\n      ? HasFormExceptionSignalPair<Insertions, Name, K> extends true\n        ? Uncapitalize<Name>\n        : never\n      : never\n    : never]: K extends `has${infer Name}Exceptions`\n    ? FormExceptionSignal<Insertions, Name>\n    : never;\n};\n\ntype FormExceptionsInsertion<Insertions> =\n  keyof FormExceptionMap<Insertions> extends never\n    ? {}\n    : {\n        hasExceptions: Signal<boolean>;\n        exceptions: Signal<FormExceptionMap<Insertions>>;\n      };\n\n/**\n * The full type of a craft form, exposed by `insertForm`.\n *\n * It is a `CraftFieldTree<Model>` (with sub-field navigation) merged with all the\n * insertion outputs (e.g. submit, exceptions, validators) and aggregated exception signals.\n */\nexport type FormWithInsertions<\n  Model,\n  Insertions,\n  Path extends string = '',\n> = CraftFieldTree<Model> &\n  ExposedFormInsertions<Insertions, Path> &\n  CraftFieldValidationCasesCarrier<\n    FieldValidationCasesFromInsertions<Insertions, Path>\n  > &\n  CraftFieldExceptionSourceCarrier & {\n    hasAttemptedSubmit: Signal<boolean>;\n    submitting: Signal<boolean>;\n    validatedFormValue: Signal<ValidatedFormValue<Model>>;\n  } & FormExceptionsInsertion<Insertions>;\n\nexport type InsertionFormFactoryContext<\n  StateType,\n  PreviousInsertionsOutputs,\n  FormIdentifier extends string | number | unknown,\n> = InsertionStateFactoryContext<StateType, PreviousInsertionsOutputs> & {\n  field: CraftFieldTree<StateType>;\n  hasAttemptedSubmit: Signal<boolean>;\n  submitting: Signal<boolean>;\n  validatedFormValue: Signal<ValidatedFormValue<StateType>>;\n  setAttemptedSubmit: () => void;\n  setSubmitting: (submitting: boolean) => void;\n  formIdentifier: FormIdentifier;\n};\n\nexport type InsertionsFormFactory<\n  State,\n  FormIdentifier extends string | number | unknown,\n  InsertionsOutputs,\n  PreviousInsertionsOutputs = {},\n  Yielded = never,\n> = (\n  context: InsertionFormFactoryContext<\n    State,\n    PreviousInsertionsOutputs,\n    FormIdentifier\n  >,\n) => InsertionsOutputs | Generator<Yielded, InsertionsOutputs, unknown>;\n\nexport const validatedFormValueSymbol = Symbol('validatedFormValue');\nexport type ValidatedFormValue<FormValue> =\n  | (FormValue & {\n      [validatedFormValueSymbol]: true;\n    })\n  | undefined;\n\nfunction isSource$(value: unknown): value is SourceDollarType<unknown> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'emit' in value &&\n    typeof (value as SourceDollarType<unknown>).emit === 'function' &&\n    'subscribe' in value &&\n    typeof (value as SourceDollarType<unknown>).subscribe === 'function'\n  );\n}\n\nconst FORM_INSERTION_METHOD_INVALID_YIELD_ERROR_MESSAGE =\n  'form insertion method generators can only yield craftService dependencies or exposed dependency helpers.';\nconst FORM_INSERTION_METHOD_APP_START_ERROR_MESSAGE =\n  'form insertion method generators do not support onAppStart(...).';\n\nfunction createExposedInsertions(\n  rawInsertionsOutput: Record<string, unknown>,\n  injector: Injector,\n): Record<string, unknown> {\n  return Object.entries(rawInsertionsOutput).reduce(\n    (acc, [key, value]) => {\n      if (isSource(value)) return acc;\n      if (isSource$(value)) {\n        const localSource = value;\n        const sourceInjector = ɵcreateHostTaggedInjector(\n          injector,\n          `source:${key}`,\n        );\n        acc[key] = createYieldableInsertionMethod(\n          (payload: unknown) => localSource.emit(payload as never),\n          {\n            injector: sourceInjector,\n            invalidYieldErrorMessage:\n              FORM_INSERTION_METHOD_INVALID_YIELD_ERROR_MESSAGE,\n            multipleAppStartErrorMessage:\n              FORM_INSERTION_METHOD_APP_START_ERROR_MESSAGE,\n            onAppStartNotSupportedErrorMessage:\n              FORM_INSERTION_METHOD_APP_START_ERROR_MESSAGE,\n          },\n        );\n        return acc;\n      }\n      if (\n        typeof value === 'function' &&\n        !isSignal(value) &&\n        !isYieldableReactiveValue(value) &&\n        !isNonYieldableInsertionMethod(value)\n      ) {\n        const methodInjector = ɵcreateHostTaggedInjector(\n          injector,\n          `method:${key}`,\n        );\n        const wrappedFn = runInInjectionContext(injector, () =>\n          injectFnWrapper()(value as (...args: unknown[]) => unknown),\n        );\n        acc[key] = createYieldableInsertionMethod(wrappedFn, {\n          injector: methodInjector,\n          invalidYieldErrorMessage:\n            FORM_INSERTION_METHOD_INVALID_YIELD_ERROR_MESSAGE,\n          multipleAppStartErrorMessage:\n            FORM_INSERTION_METHOD_APP_START_ERROR_MESSAGE,\n          onAppStartNotSupportedErrorMessage:\n            FORM_INSERTION_METHOD_APP_START_ERROR_MESSAGE,\n        });\n        return acc;\n      }\n      acc[key] = value;\n      return acc;\n    },\n    {} as Record<string, unknown>,\n  );\n}\n\nfunction toExceptionInsertionName(name: string) {\n  return `${name.charAt(0).toLowerCase()}${name.slice(1)}`;\n}\n\nfunction toExceptionRecord(value: unknown): Record<string, unknown> {\n  return typeof value === 'object' && value !== null\n    ? (value as Record<string, unknown>)\n    : {};\n}\n\nexport function createFormExceptions(\n  rawInsertionsOutput: Record<string, unknown>,\n  exposedInsertionsOutput: Record<string, unknown>,\n) {\n  const directHasExceptions = isSignal(exposedInsertionsOutput['hasExceptions'])\n    ? (exposedInsertionsOutput['hasExceptions'] as Signal<boolean>)\n    : undefined;\n  const directExceptions = isSignal(exposedInsertionsOutput['exceptions'])\n    ? (exposedInsertionsOutput['exceptions'] as Signal<unknown>)\n    : undefined;\n\n  const exceptionInsertions = Object.entries(exposedInsertionsOutput).flatMap(\n    ([key, value]) => {\n      const match = /^has(.+)Exceptions$/.exec(key);\n      if (!match || typeof value !== 'function') return [];\n\n      const insertionName = toExceptionInsertionName(match[1]);\n      const exceptionsKey = `${insertionName}Exceptions`;\n      const exceptionSignal = exposedInsertionsOutput[exceptionsKey];\n      if (typeof exceptionSignal !== 'function') return [];\n\n      return [\n        {\n          insertionName,\n          hasExceptionSignal: value as Signal<boolean>,\n          exceptionSignal: exceptionSignal as Signal<unknown>,\n        },\n      ];\n    },\n  );\n\n  if (\n    exceptionInsertions.length === 0 &&\n    !directHasExceptions &&\n    !directExceptions\n  ) {\n    return {};\n  }\n\n  return {\n    hasExceptions: computed(\n      () =>\n        (directHasExceptions?.() ?? false) ||\n        exceptionInsertions.some(({ hasExceptionSignal }) =>\n          hasExceptionSignal(),\n        ),\n    ),\n    exceptions: computed(() =>\n      exceptionInsertions.reduce(\n        (acc, { insertionName, exceptionSignal }) => {\n          acc[insertionName] = exceptionSignal();\n          return acc;\n        },\n        {\n          ...toExceptionRecord(directExceptions?.()),\n        },\n      ),\n    ),\n  };\n}\n\nexport type SubmissionController = {\n  hasAttemptedSubmit: Signal<boolean>;\n  submitting: Signal<boolean>;\n  setAttemptedSubmit: () => void;\n  setSubmitting: (submitting: boolean) => void;\n  reset: () => void;\n};\n\nexport function createSubmissionController(): SubmissionController {\n  const attempted = signal(false);\n  const submitting = signal(false);\n  return {\n    hasAttemptedSubmit: attempted.asReadonly(),\n    submitting: submitting.asReadonly(),\n    setAttemptedSubmit: () => attempted.set(true),\n    setSubmitting: (next: boolean) => {\n      if (next) attempted.set(true);\n      submitting.set(next);\n    },\n    reset: () => {\n      attempted.set(false);\n      submitting.set(false);\n    },\n  };\n}\n\n/**\n * Wrap a CraftFieldTree with extra properties (insertion outputs, exception\n * aggregates, submission state) so the merged object behaves like a\n * `FormWithInsertions`. Used by sub-form builders.\n */\nexport function wrapSubFieldWithExtras<T>(\n  subField: CraftFieldTree<T>,\n  extras: Record<string, unknown>,\n): CraftFieldTree<T> {\n  return new Proxy(subField as unknown as object, {\n    get(_target, prop, receiver) {\n      if (typeof prop === 'string' && prop in extras) return extras[prop];\n      return Reflect.get(subField as object, prop, receiver);\n    },\n    has(_target, prop) {\n      if (typeof prop === 'string' && prop in extras) return true;\n      return prop in (subField as object);\n    },\n    ownKeys() {\n      return [\n        ...new Set([\n          ...Reflect.ownKeys(subField as object),\n          ...Object.keys(extras),\n        ]),\n      ];\n    },\n    getOwnPropertyDescriptor(_target, prop) {\n      if (typeof prop === 'string' && prop in extras) {\n        return {\n          enumerable: true,\n          configurable: true,\n          value: extras[prop],\n          writable: false,\n        };\n      }\n      return Object.getOwnPropertyDescriptor(subField, prop);\n    },\n  }) as unknown as CraftFieldTree<T>;\n}\n\n/**\n * Build a fully-decorated sub-form (field tree + insertion outputs + exception\n * aggregates) from a sub-field plus a state read/write pair. Used by both\n * `insertSelectFormTree` (structural sub-fields) and `insertSubFormField`\n * (derived sub-fields).\n */\nexport function buildSubForm<Sub>(options: {\n  parentContext: InsertionFormFactoryContext<unknown, unknown, unknown>;\n  subField: CraftFieldTree<Sub>;\n  subState: () => Sub;\n  setSub: (next: Sub) => void;\n  insertions: InsertionsFormFactory<\n    Sub,\n    unknown,\n    Record<string, unknown>,\n    Record<string, unknown>\n  >[];\n  injector: Injector;\n}): FormWithInsertions<Sub, Record<string, unknown>> {\n  const stateSignal = computed(() => options.subState() as Sub);\n\n  const subContext = {\n    state: stateSignal,\n    set: (next: Sub) => {\n      options.setSub(next);\n      return yieldableInvocation(next);\n    },\n    update: (fn: (curr: Sub) => Sub) => {\n      const next = fn(options.subState());\n      options.setSub(next);\n      return yieldableInvocation(next);\n    },\n    patch: (fn: (curr: Sub) => Partial<Sub>) => {\n      const curr = options.subState();\n      const partial = fn(curr);\n      const next =\n        curr && typeof curr === 'object' && !Array.isArray(curr)\n          ? ({ ...(curr as object), ...partial } as Sub)\n          : (partial as Sub);\n      options.setSub(next);\n      return yieldableInvocation(next);\n    },\n    insertions: (options.parentContext.insertions ?? {}) as never,\n  };\n\n  const { rawInsertionsOutput, exposedInsertionsOutput } =\n    executeFormInsertions(options.insertions, {\n      field: options.subField,\n      state: stateSignal,\n      submission: {\n        hasAttemptedSubmit: options.parentContext.hasAttemptedSubmit,\n        submitting: options.parentContext.submitting,\n        setAttemptedSubmit: options.parentContext.setAttemptedSubmit,\n        setSubmitting: options.parentContext.setSubmitting,\n        reset: () => {\n          /* parent owns reset */\n        },\n      },\n      set: subContext.set,\n      update: subContext.update,\n      patch: subContext.patch,\n      inheritedInsertions: subContext.insertions as Record<string, unknown>,\n      injector: options.injector,\n      formIdentifier: options.parentContext.formIdentifier,\n    });\n\n  const formExceptions = createFormExceptions(\n    rawInsertionsOutput,\n    exposedInsertionsOutput,\n  );\n\n  return wrapSubFieldWithExtras(options.subField, {\n    ...exposedInsertionsOutput,\n    ...formExceptions,\n    hasAttemptedSubmit: options.parentContext.hasAttemptedSubmit,\n    submitting: options.parentContext.submitting,\n  }) as unknown as FormWithInsertions<Sub, Record<string, unknown>>;\n}\n\nexport function executeFormInsertions<Model>(\n  formInsertions: InsertionsFormFactory<\n    Model,\n    unknown,\n    Record<string, unknown>,\n    Record<string, unknown>\n  >[],\n  options: {\n    field: CraftFieldTree<Model>;\n    state: Signal<Model>;\n    submission: SubmissionController;\n    set: YieldableInsertionWrite<[newState: Model], Model>;\n    update: YieldableInsertionWrite<[\n      updateFn: (currentState: Model) => Model,\n    ], Model>;\n    patch: YieldableInsertionWrite<[\n      patchFn: (currentState: Model) => Partial<Model>,\n    ], Model>;\n    inheritedInsertions: Record<string, unknown>;\n    injector: Injector;\n    formIdentifier: string | number | unknown;\n  },\n) {\n  const validatedFormValue = computed<ValidatedFormValue<Model>>(() => {\n    const fieldRoot = options.field as unknown as CraftField<Model>;\n    if (!fieldRoot.valid()) return undefined;\n    const value = fieldRoot.value();\n    if (value && typeof value === 'object') {\n      return Object.assign(value as object, {\n        [validatedFormValueSymbol]: true,\n      }) as ValidatedFormValue<Model>;\n    }\n    return value as ValidatedFormValue<Model>;\n  });\n\n  const FORM_INSERTION_INVALID_YIELD_ERROR_MESSAGE =\n    'insertSelectFormTree generators can only yield craftService dependencies or exposed dependency helpers.';\n  const FORM_INSERTION_APP_START_ERROR_MESSAGE =\n    'insertSelectFormTree generators do not support onAppStart(...).';\n\n  return formInsertions.reduce(\n    (acc, insertion) => {\n      const wrappedInsertion = runInInjectionContext(options.injector, () =>\n        injectFnWrapper()(insertion),\n      );\n      const insertionCallResult = runInInjectionContext(options.injector, () =>\n        wrappedInsertion({\n          state: createYieldableReactiveValue(options.state, 'state', {\n            primitive: 'form',\n            path: 'form.state',\n          }),\n          set: options.set,\n          update: options.update,\n          patch: options.patch,\n          field: options.field,\n          hasAttemptedSubmit: options.submission.hasAttemptedSubmit,\n          submitting: options.submission.submitting,\n          validatedFormValue,\n          setAttemptedSubmit: options.submission.setAttemptedSubmit,\n          setSubmitting: options.submission.setSubmitting,\n          formIdentifier: options.formIdentifier!,\n          insertions: {\n            ...options.inheritedInsertions,\n            ...acc.exposedInsertionsOutput,\n          },\n        }),\n      );\n      const nextRawInsertions = (\n        isGenerator(insertionCallResult)\n          ? runInInjectionContext(\n              options.injector,\n              () =>\n                runCraftGenerator({\n                  iterator: insertionCallResult,\n                  injector: options.injector,\n                  hostScope: 'function',\n                  invalidYieldErrorMessage:\n                    FORM_INSERTION_INVALID_YIELD_ERROR_MESSAGE,\n                  multipleAppStartErrorMessage:\n                    FORM_INSERTION_APP_START_ERROR_MESSAGE,\n                  onAppStartNotSupportedErrorMessage:\n                    FORM_INSERTION_APP_START_ERROR_MESSAGE,\n                }).value,\n            )\n          : insertionCallResult\n      ) as Record<string, unknown>;\n      const nextExposedInsertions = createExposedInsertions(\n        nextRawInsertions,\n        options.injector,\n      );\n\n      return {\n        rawInsertionsOutput: {\n          ...acc.rawInsertionsOutput,\n          ...nextRawInsertions,\n        },\n        exposedInsertionsOutput: {\n          ...acc.exposedInsertionsOutput,\n          ...nextExposedInsertions,\n        },\n      };\n    },\n    {\n      rawInsertionsOutput: {} as Record<string, unknown>,\n      exposedInsertionsOutput: {} as Record<string, unknown>,\n    },\n  );\n}\n"]}

package/src/lib/form/insert-form-schema.d.ts

@@ -0,0 +1,10 @@
+import { type Signal } from '../host/craft-compat';
+import { type CraftSchema, type SchemaInput, type SchemaValidationException } from '../schema-validation';
+import type { InsertionsFormFactory } from './insert-form-internals';
+export type FormSchemaInsertionOutputs = {
+    hasSchema: Signal<true>;
+    hasSchemaExceptions: Signal<boolean>;
+    schemaExceptions: Signal<ReadonlyArray<SchemaValidationException>>;
+};
+export declare function insertFormSchema<Schema extends CraftSchema>(schema: Schema): InsertionsFormFactory<SchemaInput<Schema>, unknown, FormSchemaInsertionOutputs, {}>;
+//# sourceMappingURL=insert-form-schema.d.ts.map

package/src/lib/form/insert-form-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-form-schema.d.ts","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/form/insert-form-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,yBAAyB,EAC/B,MAAM,sBAAsB,CAAC;AAI9B,OAAO,KAAK,EAEV,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AAMjC,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACrC,gBAAgB,EAAE,MAAM,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC,CAAC;CACpE,CAAC;AAuDF,wBAAgB,gBAAgB,CAAC,MAAM,SAAS,WAAW,EACzD,MAAM,EAAE,MAAM,GACb,qBAAqB,CACtB,WAAW,CAAC,MAAM,CAAC,EACnB,OAAO,EACP,0BAA0B,EAC1B,EAAE,CACH,CAuBA"}

package/src/lib/form/insert-form-schema.js

@@ -0,0 +1,62 @@
+import { computed, inject, Injector } from '../host/craft-compat';
+import { createSchemaValidationException, parseSchema, } from '../schema-validation';
+import { rawReactiveValue } from '../reactive-read';
+import { craftLinkedSignal } from '../host/craft-linked-signal';
+function normalizeIssuePath(path) {
+    if (!path)
+        return [];
+    const normalized = [];
+    for (const segment of path) {
+        const key = typeof segment === 'object' && segment !== null && 'key' in segment
+            ? segment.key
+            : segment;
+        if (typeof key !== 'string' && typeof key !== 'number')
+            return [];
+        normalized.push(key);
+    }
+    return normalized;
+}
+function createSchemaErrorEntries(schema, value, context) {
+    const parsed = parseSchema(schema, value, {
+        primitive: 'form',
+        name: 'form',
+        stage: 'form',
+        operation: 'validate',
+    });
+    if (parsed instanceof Promise) {
+        throw new Error('Form schemas must be synchronous. Use cAsyncValidate or an async resource for asynchronous validation.');
+    }
+    if (parsed.ok)
+        return [];
+    return parsed.exception.payload.issues.map((issue) => ({
+        path: normalizeIssuePath(issue.path),
+        error: createSchemaValidationException({
+            issues: [issue],
+            value,
+            primitive: 'form',
+            name: 'form',
+            stage: 'form',
+            operation: 'validate',
+            ...(context.formIdentifier === undefined
+                ? {}
+                : { identifier: String(context.formIdentifier) }),
+        }),
+    }));
+}
+export function insertFormSchema(schema) {
+    return (context) => {
+        const stateValue = craftLinkedSignal({
+            source: () => rawReactiveValue(context.state)(),
+            computation: (value) => value,
+            injector: inject(Injector),
+        });
+        const errors = computed(() => createSchemaErrorEntries(schema, stateValue(), context));
+        context.field.ɵregisterSchemaErrorSource(errors);
+        return {
+            hasSchema: computed(() => true),
+            hasSchemaExceptions: computed(() => errors().length > 0),
+            schemaExceptions: computed(() => errors().map((entry) => entry.error)),
+        };
+    };
+}
+//# sourceMappingURL=insert-form-schema.js.map

package/src/lib/form/insert-form-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-form-schema.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/form/insert-form-schema.ts"],"names":[],"mappings":"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","sourcesContent":["import { computed, inject, Injector, type Signal } from '../host/craft-compat';\nimport {\n  createSchemaValidationException,\n  parseSchema,\n  type CraftSchema,\n  type SchemaInput,\n  type SchemaValidationException,\n} from '../schema-validation';\nimport type { StandardSchemaV1PathSegment } from '../standard-schema';\nimport { rawReactiveValue } from '../reactive-read';\nimport { craftLinkedSignal } from '../host/craft-linked-signal';\nimport type {\n  InsertionFormFactoryContext,\n  InsertionsFormFactory,\n} from './insert-form-internals';\nimport type {\n  CraftFieldSchemaErrorEntry,\n  CraftFieldSchemaErrorSource,\n} from './craft-field';\n\nexport type FormSchemaInsertionOutputs = {\n  hasSchema: Signal<true>;\n  hasSchemaExceptions: Signal<boolean>;\n  schemaExceptions: Signal<ReadonlyArray<SchemaValidationException>>;\n};\n\nfunction normalizeIssuePath(\n  path: ReadonlyArray<PropertyKey | StandardSchemaV1PathSegment> | undefined,\n): ReadonlyArray<string | number> {\n  if (!path) return [];\n\n  const normalized: Array<string | number> = [];\n  for (const segment of path) {\n    const key =\n      typeof segment === 'object' && segment !== null && 'key' in segment\n        ? segment.key\n        : segment;\n    if (typeof key !== 'string' && typeof key !== 'number') return [];\n    normalized.push(key);\n  }\n  return normalized;\n}\n\nfunction createSchemaErrorEntries<Schema extends CraftSchema>(\n  schema: Schema,\n  value: SchemaInput<Schema>,\n  context: InsertionFormFactoryContext<SchemaInput<Schema>, {}, unknown>,\n): ReadonlyArray<CraftFieldSchemaErrorEntry> {\n  const parsed = parseSchema<unknown>(schema, value, {\n    primitive: 'form',\n    name: 'form',\n    stage: 'form',\n    operation: 'validate',\n  });\n\n  if (parsed instanceof Promise) {\n    throw new Error(\n      'Form schemas must be synchronous. Use cAsyncValidate or an async resource for asynchronous validation.',\n    );\n  }\n\n  if (parsed.ok) return [];\n\n  return parsed.exception.payload.issues.map((issue) => ({\n    path: normalizeIssuePath(issue.path),\n    error: createSchemaValidationException({\n      issues: [issue],\n      value,\n      primitive: 'form',\n      name: 'form',\n      stage: 'form',\n      operation: 'validate',\n      ...(context.formIdentifier === undefined\n        ? {}\n        : { identifier: String(context.formIdentifier) }),\n    }),\n  }));\n}\n\nexport function insertFormSchema<Schema extends CraftSchema>(\n  schema: Schema,\n): InsertionsFormFactory<\n  SchemaInput<Schema>,\n  unknown,\n  FormSchemaInsertionOutputs,\n  {}\n> {\n  return (\n    context: InsertionFormFactoryContext<SchemaInput<Schema>, {}, unknown>,\n  ) => {\n    const stateValue = craftLinkedSignal({\n      source: () => rawReactiveValue(context.state)(),\n      computation: (value) => value,\n      injector: inject(Injector),\n    });\n    const errors = computed(() =>\n      createSchemaErrorEntries(schema, stateValue(), context),\n    ) as CraftFieldSchemaErrorSource;\n\n    context.field.ɵregisterSchemaErrorSource(errors);\n\n    return {\n      hasSchema: computed(() => true as const),\n      hasSchemaExceptions: computed(() => errors().length > 0),\n      schemaExceptions: computed(() =>\n        errors().map((entry) => entry.error as SchemaValidationException),\n      ),\n    };\n  };\n}\n"]}