@craft-ts/core 0.7.0-beta.13

package/src/lib/fn-wrapper.js

@@ -0,0 +1,66 @@
+import { inject, InjectionToken } from './host/craft-compat';
+import { isGenerator, isGeneratorFunction } from './craft-generator-runtime';
+export { isGenerator, isGeneratorFunction } from './craft-generator-runtime';
+const IDENTITY_ADAPTER = ((factory) => factory);
+export const FN_WRAPPER = new InjectionToken('FN_WRAPPER', {
+    providedIn: 'root',
+    factory: () => [],
+    multi: true,
+});
+export const FN_WRAP_OBSERVER = new InjectionToken('FN_WRAP_OBSERVER', {
+    providedIn: 'root',
+    factory: () => [],
+    multi: true,
+});
+// The warning literal is part of the public API to make the runtime DI risk
+// explicit at every call site.
+export function provideFnWrapper(_warning, wrapper) {
+    return { provide: FN_WRAPPER, useValue: wrapper, multi: true };
+}
+export function provideFnWrapObserver(observer) {
+    return { provide: FN_WRAP_OBSERVER, useValue: observer, multi: true };
+}
+export function injectFnWrapper() {
+    const wrappers = inject(FN_WRAPPER);
+    const observers = inject(FN_WRAP_OBSERVER);
+    if (wrappers.length === 0 && observers.length === 0) {
+        return IDENTITY_ADAPTER;
+    }
+    return ((factory) => {
+        for (const observer of observers) {
+            observer(factory);
+        }
+        if (wrappers.length === 0) {
+            return factory;
+        }
+        let current = toGeneratorFactory(factory);
+        // First registered wrapper is the outermost; iterate from last to first.
+        for (let i = wrappers.length - 1; i >= 0; i--) {
+            const wrapper = wrappers[i];
+            const inner = current;
+            current = function* (...args) {
+                return yield* wrapper(inner, this, args);
+            };
+        }
+        return current;
+    });
+}
+function toGeneratorFactory(factory) {
+    if (isGeneratorFunction(factory)) {
+        return factory;
+    }
+    return function* (...args) {
+        const result = factory.apply(this, args);
+        // A sync factory may legally RETURN a generator (`(ctx) => Outputs |
+        // Generator`). The unwrapped path drives it (`isGenerator(result)` in
+        // executeGeneratorCompatibleFactory); delegate here too, otherwise the
+        // generator becomes the wrapper generator's return VALUE, is never
+        // driven, and the factory's outputs are silently lost whenever any
+        // FN_WRAPPER (correlation-id tracking, app snapshots) is installed.
+        if (isGenerator(result)) {
+            return yield* result;
+        }
+        return result;
+    };
+}
+//# sourceMappingURL=fn-wrapper.js.map

package/src/lib/fn-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fn-wrapper.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/fn-wrapper.ts"],"names":[],"mappings":"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","sourcesContent":["import { inject, InjectionToken, type Provider } from './host/craft-compat';\nimport { isGenerator, isGeneratorFunction } from './craft-generator-runtime';\n\nexport { isGenerator, isGeneratorFunction } from './craft-generator-runtime';\n\ntype AnyFactory = (...args: any[]) => any;\ntype AnyGeneratorFactory = (\n  ...args: any[]\n) => Generator<unknown, unknown, unknown>;\n\nexport type FnWrapper = (\n  factory: AnyGeneratorFactory,\n  thisArg: unknown,\n  args: unknown[],\n) => Generator<unknown, unknown, unknown>;\n\nexport type FnFactoryAdapter = <F extends AnyFactory>(factory: F) => F;\nexport type FnWrapObserver = (factory: AnyFactory) => void;\n\nconst IDENTITY_ADAPTER: FnFactoryAdapter = ((factory) =>\n  factory) as FnFactoryAdapter;\n\nexport const FN_WRAPPER = new InjectionToken<readonly FnWrapper[]>(\n  'FN_WRAPPER',\n  {\n    providedIn: 'root',\n    factory: () => [],\n    multi: true,\n  },\n);\n\nexport const FN_WRAP_OBSERVER = new InjectionToken<readonly FnWrapObserver[]>(\n  'FN_WRAP_OBSERVER',\n  {\n    providedIn: 'root',\n    factory: () => [],\n    multi: true,\n  },\n);\n\n// The warning literal is part of the public API to make the runtime DI risk\n// explicit at every call site.\nexport function provideFnWrapper(\n  _warning: string,\n  wrapper: FnWrapper,\n): Provider {\n  return { provide: FN_WRAPPER, useValue: wrapper, multi: true };\n}\n\nexport function provideFnWrapObserver(observer: FnWrapObserver): Provider {\n  return { provide: FN_WRAP_OBSERVER, useValue: observer, multi: true };\n}\n\nexport function injectFnWrapper(): FnFactoryAdapter {\n  const wrappers = inject(FN_WRAPPER);\n  const observers = inject(FN_WRAP_OBSERVER);\n  if (wrappers.length === 0 && observers.length === 0) {\n    return IDENTITY_ADAPTER;\n  }\n  return (<F extends AnyFactory>(factory: F): F => {\n    for (const observer of observers) {\n      observer(factory);\n    }\n    if (wrappers.length === 0) {\n      return factory;\n    }\n    let current: AnyGeneratorFactory = toGeneratorFactory(factory);\n    // First registered wrapper is the outermost; iterate from last to first.\n    for (let i = wrappers.length - 1; i >= 0; i--) {\n      const wrapper = wrappers[i];\n      const inner = current;\n      current = function* (this: unknown, ...args: unknown[]) {\n        return yield* wrapper(inner, this, args);\n      };\n    }\n    return current as unknown as F;\n  }) as FnFactoryAdapter;\n}\n\nfunction toGeneratorFactory(factory: AnyFactory): AnyGeneratorFactory {\n  if (isGeneratorFunction(factory)) {\n    return factory as AnyGeneratorFactory;\n  }\n  return function* (this: unknown, ...args: unknown[]) {\n    const result = factory.apply(this, args);\n    // A sync factory may legally RETURN a generator (`(ctx) => Outputs |\n    // Generator`). The unwrapped path drives it (`isGenerator(result)` in\n    // executeGeneratorCompatibleFactory); delegate here too, otherwise the\n    // generator becomes the wrapper generator's return VALUE, is never\n    // driven, and the factory's outputs are silently lost whenever any\n    // FN_WRAPPER (correlation-id tracking, app snapshots) is installed.\n    if (isGenerator(result)) {\n      return yield* result;\n    }\n    return result;\n  };\n}\n"]}

package/src/lib/form/craft-field.d.ts

@@ -0,0 +1,155 @@
+import { Signal, WritableSignal } from '../host/craft-compat';
+import type { AnyCraftException } from '../craft-exception';
+export type CraftFieldError = AnyCraftException;
+export type CraftFieldSchemaErrorEntry = {
+    readonly path: ReadonlyArray<string | number>;
+    readonly error: CraftFieldError;
+};
+export type CraftFieldSchemaErrorSource = Signal<ReadonlyArray<CraftFieldSchemaErrorEntry>>;
+export type FieldAttributeMeta = {
+    kind: 'native-constraint';
+    target: 'min';
+    value: number | Date | undefined;
+} | {
+    kind: 'native-constraint';
+    target: 'max';
+    value: number | Date | undefined;
+} | {
+    kind: 'native-constraint';
+    target: 'minLength';
+    value: number | undefined;
+} | {
+    kind: 'native-constraint';
+    target: 'maxLength';
+    value: number | undefined;
+} | {
+    kind: 'native-constraint';
+    target: 'pattern';
+    value: RegExp | undefined;
+} | {
+    kind: 'native-constraint';
+    target: 'required';
+    value: boolean;
+};
+export type CraftValidatorPending = {
+    pending: true;
+};
+export type CraftValidatorOutput = undefined | CraftFieldError | ReadonlyArray<CraftFieldError> | CraftValidatorPending;
+export type CraftValidatorContext<T> = {
+    value: Signal<T>;
+    field: CraftField<T>;
+    identifier: unknown;
+};
+export type CraftValidator<T = unknown> = (context: CraftValidatorContext<T>) => {
+    result: Signal<CraftValidatorOutput>;
+    attribute?: Signal<FieldAttributeMeta | undefined>;
+};
+export interface ControlSyncer<T> {
+    /** Called when the model value changes. Implementation pushes value to DOM/component. */
+    writeValue(next: T): void;
+    /** Called on reset to force re-sync to DOM (even if model value did not change). */
+    resync?(): void;
+    /** Cleanup. */
+    destroy?(): void;
+}
+export interface CraftValueControl<T> {
+    value: {
+        (): T;
+        set: (next: T) => void;
+    };
+}
+export interface CraftCheckboxControl {
+    checked: {
+        (): boolean;
+        set: (next: boolean) => void;
+    };
+}
+export type FieldStateBindingKind = 'hidden' | 'disabled' | 'readonly';
+type FieldRootBackingStore<T> = {
+    read: () => T;
+    set: (next: T) => void;
+    asReadonly: () => Signal<T>;
+};
+type CraftFieldInternals<T> = CraftField<T> & {
+    __raw: () => T;
+    __setRaw: (next: T) => void;
+    __children: Map<string | number, CraftFieldInternals<unknown>>;
+    __resetTriggerCount: WritableSignal<number>;
+    __propagateDirty: (dirty: boolean) => void;
+    __propagateTouched: (touched: boolean) => void;
+    __resetCascade: () => void;
+    __bumpRevision: () => void;
+    __schemaErrorSources: CraftFieldSchemaErrorSource[];
+    __schemaErrorRevision: WritableSignal<number>;
+};
+export type CraftField<T> = {
+    value: Signal<T>;
+    set(next: T): void;
+    patch(fn: (current: T) => Partial<T>): void;
+    reset(initialValue?: T): void;
+    dirty: Signal<boolean>;
+    touched: Signal<boolean>;
+    hidden: Signal<boolean>;
+    disabled: Signal<boolean>;
+    readonly: Signal<boolean>;
+    pending: Signal<boolean>;
+    invalid: Signal<boolean>;
+    valid: Signal<boolean>;
+    errors: Signal<ReadonlyArray<CraftFieldError>>;
+    required: Signal<boolean>;
+    min: Signal<number | Date | undefined>;
+    max: Signal<number | Date | undefined>;
+    minLength: Signal<number | undefined>;
+    maxLength: Signal<number | undefined>;
+    pattern: Signal<RegExp | undefined>;
+    disabledReasons: Signal<ReadonlyArray<string>>;
+    ɵregisterControl(syncer: ControlSyncer<T>): () => void;
+    ɵmarkTouched(): void;
+    ɵmarkUntouched(): void;
+    ɵmarkDirty(): void;
+    ɵmarkPristine(): void;
+    ɵregisterValidator(validator: CraftValidator<T>, identifier?: unknown): () => void;
+    ɵregisterSchemaErrorSource(source: CraftFieldSchemaErrorSource): () => void;
+    ɵregisterStateBinding(kind: FieldStateBindingKind, source: Signal<boolean>): () => void;
+    ɵregisterDisabledReason(source: Signal<string | undefined>): () => void;
+    ɵresetTrigger: Signal<number>;
+    ɵpath: ReadonlyArray<string | number>;
+};
+export type CraftFieldTree<T> = CraftField<T> & ([T] extends [ReadonlyArray<infer Item>] ? {
+    item(index: number): CraftFieldTree<Item>;
+    length: Signal<number>;
+} : T extends Record<string, unknown> ? {
+    [K in keyof T]-?: CraftFieldTree<T[K]>;
+} : object);
+/** Returns whether a value exposes the public Craft field contract. */
+export declare function isCraftField(value: unknown): value is CraftField<unknown>;
+/**
+ * Create a Craft field tree from an external mutable backing store.
+ * Used by `insertForm` to bridge the Craft `state()` signal into the field tree.
+ */
+export declare function createCraftFieldTree<T>(backing: FieldRootBackingStore<T>): CraftFieldTree<T>;
+/**
+ * Create a Craft field tree backed by a writable signal (convenience for tests / standalone usage).
+ */
+export declare function craftField<T>(initial: T | WritableSignal<T> | Signal<T>): CraftFieldTree<T>;
+/** @internal */
+export declare function ɵgetCraftFieldInternals<T>(field: CraftField<T>): CraftFieldInternals<T>;
+/**
+ * @internal
+ * Create (or return a cached) child field whose value is **derived** from the
+ * parent via an arbitrary lens (read + write functions), rather than indexed
+ * by an object key or array index.
+ *
+ * The returned child plugs into the same `ParentLink` machinery used for
+ * structural children, so dirty/touched/disabled/hidden/validation/reset
+ * cascades work exactly the same way.
+ *
+ * Two calls with the same `name` on the same parent return the same child
+ * instance — the lens passed on the first call wins.
+ */
+export declare function ɵgetOrCreateDerivedChild<Source, Sub>(parent: CraftField<Source>, name: string, lens: {
+    read: (s: Source) => Sub;
+    write: (s: Source, next: Sub) => Source;
+}): CraftFieldTree<Sub>;
+export {};
+//# sourceMappingURL=craft-field.d.ts.map

package/src/lib/form/craft-field.d.ts.map

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

package/src/lib/form/craft-field.directive.d.ts

@@ -0,0 +1,70 @@
+import { InjectionToken, Injector, Renderer2 } from '../host/craft-compat';
+import type { GetDeps } from '../branded-component/branded-component';
+import { type CraftNodeDirective, type CraftNodeEffectFactory } from '../craft-node-directive';
+import type { CraftDomAdapter } from '../host/craft-dom';
+import { CraftCheckboxControl, CraftField, CraftValueControl } from './craft-field';
+import { type CraftFieldExceptionSourceCarrier, type CraftFieldValidationCasesCarrier, type FieldValidationCasesOf } from './field-exception';
+/**
+ * Token used by custom controls to declare themselves as Craft form value controls.
+ * A custom component should provide itself via this token to opt into [craftField] binding.
+ *
+ * @example
+ * @Component({
+ *   providers: [{ provide: CRAFT_FIELD_VALUE_CONTROL, useExisting: forwardRef(() => MyControl) }]
+ * })
+ * export class MyControl implements CraftValueControl<string> {
+ *   readonly value = model<string>('');
+ * }
+ */
+export declare const CRAFT_FIELD_VALUE_CONTROL: InjectionToken<CraftValueControl<unknown>>;
+/**
+ * Token used by custom checkbox-style controls to declare themselves as Craft form checkbox controls.
+ */
+export declare const CRAFT_FIELD_CHECKBOX_CONTROL: InjectionToken<CraftCheckboxControl>;
+export declare class CraftFieldBinding<T> {
+    private cleanupFns;
+    private strategy;
+    private readonly craftField;
+    private readonly createEffect;
+    private readonly element;
+    private readonly renderer;
+    private readonly injector;
+    private readonly field;
+    private readonly customValueControl;
+    private readonly customCheckboxControl;
+    constructor(element: HTMLElement, renderer: CraftDomAdapter, injector: Injector, field: CraftField<T>, customValueControl?: CraftValueControl<unknown> | null, customCheckboxControl?: CraftCheckboxControl | null, createEffect?: CraftNodeEffectFactory);
+    mount(): void;
+    destroy(): void;
+    private detectStrategy;
+    private bindStateAttributes;
+    private toggleAttribute;
+    private toggleClass;
+    private bindTextInput;
+    private bindNumericInput;
+    private bindTemporalInput;
+    private bindCheckboxInput;
+    private bindRadioInput;
+    private bindSelectInput;
+    private bindSignalValueControl;
+    private bindSignalCheckboxControl;
+}
+/** Mounts the complete native/custom-control field synchronization contract. */
+export declare function bindCraftField<T>(element: HTMLElement, field: CraftField<T>, renderer: CraftDomAdapter | object, injector: Injector | object, customValueControl?: CraftValueControl<unknown> | null, customCheckboxControl?: CraftCheckboxControl | null, createEffect?: CraftNodeEffectFactory): () => void;
+export type BoundCraftFieldDirective<Field> = CraftNodeDirective<Readonly<Record<never, never>>> & CraftFieldValidationCasesCarrier<FieldValidationCasesOf<Field>> & CraftFieldExceptionSourceCarrier;
+export declare function CraftFieldDirective<Field extends {
+    readonly value: (...args: any[]) => unknown;
+    set: (next: any) => void;
+}>(field: Field): BoundCraftFieldDirective<Field>;
+export type GenDeps_LegacyCraftFieldDirective = GetDeps<{
+    deps: Record<never, never>;
+    provided: Record<never, never>;
+    missingProvider: {
+        Renderer2: Renderer2;
+        Injector: Injector;
+        CRAFT_FIELD_VALUE_CONTROL: typeof CRAFT_FIELD_VALUE_CONTROL;
+        CRAFT_FIELD_CHECKBOX_CONTROL: typeof CRAFT_FIELD_CHECKBOX_CONTROL;
+    };
+}>;
+/** @deprecated DI metadata belongs to `LegacyCraftFieldDirective` only. */
+export type GenDeps_CraftFieldDirective = GenDeps_LegacyCraftFieldDirective;
+//# sourceMappingURL=craft-field.directive.d.ts.map

package/src/lib/form/craft-field.directive.d.ts.map

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