@signaltree/ng-forms 6.0.5 → 6.0.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaltree/ng-forms",
-  "version": "6.0.5",
+  "version": "6.0.9",
   "description": "Complete Angular forms integration for SignalTree. FormTree creation, custom directives, validators, form state tracking, and RxJS bridge.",
   "type": "module",
   "sideEffects": false,

package/dist/audit/audit.js

@@ -1,74 +0,0 @@
-import { getChanges } from '../get-changes.js';
-
-function createAuditTracker(tree, auditLog, config = {}) {
-  const {
-    getMetadata,
-    includePreviousValues = false,
-    filter,
-    maxEntries = 0
-  } = config;
-  let previousState = structuredClone(tree());
-  let isTracking = true;
-  const handleChange = () => {
-    if (!isTracking) return;
-    const currentState = tree();
-    const changes = getChanges(previousState, currentState);
-    if (Object.keys(changes).length > 0) {
-      if (filter && !filter(changes)) {
-        previousState = structuredClone(currentState);
-        return;
-      }
-      const entry = {
-        timestamp: Date.now(),
-        changes,
-        metadata: getMetadata?.()
-      };
-      if (includePreviousValues) {
-        const prevValues = {};
-        for (const key of Object.keys(changes)) {
-          prevValues[key] = previousState[key];
-        }
-        entry.previousValues = prevValues;
-      }
-      auditLog.push(entry);
-      if (maxEntries > 0 && auditLog.length > maxEntries) {
-        auditLog.splice(0, auditLog.length - maxEntries);
-      }
-    }
-    previousState = structuredClone(currentState);
-  };
-  let unsubscribe;
-  let pollingId;
-  if ('subscribe' in tree && typeof tree.subscribe === 'function') {
-    try {
-      unsubscribe = tree.subscribe(handleChange);
-    } catch {
-      pollingId = setInterval(handleChange, 100);
-    }
-  } else {
-    pollingId = setInterval(handleChange, 100);
-  }
-  return () => {
-    isTracking = false;
-    if (unsubscribe) {
-      unsubscribe();
-    }
-    if (pollingId) {
-      clearInterval(pollingId);
-    }
-  };
-}
-function createAuditCallback(auditLog, getMetadata) {
-  return (previousState, currentState) => {
-    const changes = getChanges(previousState, currentState);
-    if (Object.keys(changes).length > 0) {
-      auditLog.push({
-        timestamp: Date.now(),
-        changes,
-        metadata: getMetadata?.()
-      });
-    }
-  };
-}
-
-export { createAuditCallback, createAuditTracker };

package/dist/audit/index.js

@@ -1 +0,0 @@
-export { createAuditCallback, createAuditTracker } from './audit.js';

package/dist/get-changes.js

@@ -1,11 +0,0 @@
-function getChanges(oldState, newState) {
-  const changes = {};
-  for (const key in newState) {
-    if (oldState[key] !== newState[key]) {
-      changes[key] = newState[key];
-    }
-  }
-  return changes;
-}
-
-export { getChanges };

package/dist/index.js

@@ -1,4 +0,0 @@
-export * from './core/ng-forms.js';
-export * from './core/validators.js';
-export * from './core/async-validators.js';
-export * from './history/index.js';

package/src/audit/audit.d.ts

@@ -1,21 +0,0 @@
-import type { ISignalTree } from '@signaltree/core';
-export interface AuditEntry<T = unknown> {
-    timestamp: number;
-    changes: Partial<T>;
-    previousValues?: Partial<T>;
-    metadata?: AuditMetadata;
-}
-export interface AuditMetadata {
-    userId?: string;
-    source?: string;
-    description?: string;
-    [key: string]: unknown;
-}
-export interface AuditTrackerConfig<T> {
-    getMetadata?: () => AuditMetadata;
-    includePreviousValues?: boolean;
-    filter?: (changes: Partial<T>) => boolean;
-    maxEntries?: number;
-}
-export declare function createAuditTracker<T extends Record<string, unknown>>(tree: ISignalTree<T>, auditLog: AuditEntry<T>[], config?: AuditTrackerConfig<T>): () => void;
-export declare function createAuditCallback<T extends Record<string, unknown>>(auditLog: AuditEntry<T>[], getMetadata?: () => AuditMetadata): (previousState: T, currentState: T) => void;

package/src/audit/index.d.ts

@@ -1 +0,0 @@
-export { createAuditTracker, createAuditCallback, type AuditEntry, type AuditMetadata, type AuditTrackerConfig, } from './audit.js';

package/src/core/async-validators.d.ts

@@ -1,3 +0,0 @@
-import type { FormTreeAsyncValidatorFn } from './ng-forms';
-export declare function unique(checkFn: (value: unknown) => Promise<boolean>, message?: string): FormTreeAsyncValidatorFn<unknown>;
-export declare function debounce(validator: FormTreeAsyncValidatorFn<unknown>, delayMs: number): FormTreeAsyncValidatorFn<unknown>;

package/src/core/ng-forms.d.ts

@@ -1,90 +0,0 @@
-import { DestroyRef, EventEmitter, OnInit, Signal, WritableSignal } from '@angular/core';
-import { AbstractControl, ControlValueAccessor, FormArray, FormGroup } from '@angular/forms';
-import { Observable } from 'rxjs';
-import type { ISignalTree, TreeConfig, TreeNode } from '@signaltree/core';
-export type FormTreeAsyncValidatorFn<T> = (value: T) => Observable<string | null> | Promise<string | null>;
-export type EnhancedArraySignal<T> = WritableSignal<T[]> & {
-    push: (item: T) => void;
-    removeAt: (index: number) => void;
-    setAt: (index: number, value: T) => void;
-    insertAt: (index: number, item: T) => void;
-    move: (from: number, to: number) => void;
-    clear: () => void;
-};
-export type FieldValidator = (value: unknown) => string | null;
-export interface FieldConfig {
-    debounceMs?: number;
-    validators?: Record<string, FieldValidator> | FieldValidator[];
-    asyncValidators?: Record<string, FormTreeAsyncValidatorFn<unknown>> | Array<FormTreeAsyncValidatorFn<unknown>>;
-}
-export interface ConditionalField<T> {
-    when: (values: T) => boolean;
-    fields: string[];
-}
-export interface FormTreeOptions<T extends Record<string, unknown>> extends TreeConfig {
-    validators?: SyncValidatorMap;
-    asyncValidators?: AsyncValidatorMap;
-    destroyRef?: DestroyRef;
-    fieldConfigs?: Record<string, FieldConfig>;
-    conditionals?: Array<ConditionalField<T>>;
-    persistKey?: string;
-    storage?: Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>;
-    persistDebounceMs?: number;
-    validationBatchMs?: number;
-}
-export type FormTree<T extends Record<string, unknown>> = {
-    state: TreeNode<T>;
-    $: TreeNode<T>;
-    form: FormGroup;
-    errors: WritableSignal<Record<string, string>>;
-    asyncErrors: WritableSignal<Record<string, string>>;
-    touched: WritableSignal<Record<string, boolean>>;
-    asyncValidating: WritableSignal<Record<string, boolean>>;
-    dirty: WritableSignal<boolean>;
-    valid: WritableSignal<boolean>;
-    submitting: WritableSignal<boolean>;
-    unwrap(): T;
-    setValue(field: string, value: unknown): void;
-    setValues(values: Partial<T>): void;
-    reset(): void;
-    submit<TResult>(submitFn: (values: T) => Promise<TResult>): Promise<TResult>;
-    validate(field?: string): Promise<void>;
-    getFieldError(field: string): Signal<string | undefined>;
-    getFieldAsyncError(field: string): Signal<string | undefined>;
-    getFieldTouched(field: string): Signal<boolean | undefined>;
-    isFieldValid(field: string): Signal<boolean>;
-    isFieldAsyncValidating(field: string): Signal<boolean | undefined>;
-    fieldErrors: Record<string, Signal<string | undefined>>;
-    fieldAsyncErrors: Record<string, Signal<string | undefined>>;
-    values: ISignalTree<T>;
-    destroy(): void;
-};
-export declare class FormValidationError extends Error {
-    readonly errors: Record<string, string>;
-    readonly asyncErrors: Record<string, string>;
-    constructor(errors: Record<string, string>, asyncErrors: Record<string, string>);
-}
-type SyncValidatorMap = Record<string, (value: unknown) => string | null>;
-type AsyncValidatorMap = Record<string, FormTreeAsyncValidatorFn<unknown>>;
-export declare function createFormTree<T extends Record<string, unknown>>(initialValues: T, config?: FormTreeOptions<T>): FormTree<T>;
-export declare function createVirtualFormArray<T>(items: T[], visibleRange: {
-    start: number;
-    end: number;
-}, controlFactory?: (value: T, index: number) => AbstractControl): FormArray;
-export declare class SignalValueDirective implements ControlValueAccessor, OnInit {
-    signalTreeSignalValue: WritableSignal<unknown>;
-    signalTreeSignalValueChange: EventEmitter<unknown>;
-    private elementRef;
-    private renderer;
-    private onChange;
-    private onTouched;
-    ngOnInit(): void;
-    handleChange(event: Event): void;
-    handleBlur(): void;
-    writeValue(value: unknown): void;
-    registerOnChange(fn: (value: unknown) => void): void;
-    registerOnTouched(fn: () => void): void;
-    setDisabledState?(isDisabled: boolean): void;
-}
-export declare const SIGNAL_FORM_DIRECTIVES: (typeof SignalValueDirective)[];
-export {};

package/src/core/validators.d.ts

@@ -1,9 +0,0 @@
-import type { FieldValidator } from './ng-forms';
-export declare function required(message?: string): FieldValidator;
-export declare function email(message?: string): FieldValidator;
-export declare function minLength(min: number, message?: string): FieldValidator;
-export declare function maxLength(max: number, message?: string): FieldValidator;
-export declare function pattern(regex: RegExp, message?: string): FieldValidator;
-export declare function min(min: number, message?: string): FieldValidator;
-export declare function max(max: number, message?: string): FieldValidator;
-export declare function compose(validators: FieldValidator[]): FieldValidator;

package/src/history/history.d.ts

@@ -1,21 +0,0 @@
-import { Signal } from '@angular/core';
-interface FormTree<T extends Record<string, unknown>> {
-    form: any;
-    unwrap(): T;
-    destroy(): void;
-    setValues(values: Partial<T>): void;
-}
-export interface FormHistory<T> {
-    past: T[];
-    present: T;
-    future: T[];
-}
-export declare function withFormHistory<T extends Record<string, unknown>>(formTree: FormTree<T>, options?: {
-    capacity?: number;
-}): FormTree<T> & {
-    undo: () => void;
-    redo: () => void;
-    clearHistory: () => void;
-    history: Signal<FormHistory<T>>;
-};
-export {};

package/src/history/index.d.ts

@@ -1 +0,0 @@
-export { withFormHistory, type FormHistory } from './history';

package/src/index.d.ts

@@ -1,4 +0,0 @@
-export * from './core/ng-forms';
-export * from './core/validators';
-export * from './core/async-validators';
-export * from './history';

package/src/rxjs/index.d.ts

@@ -1 +0,0 @@
-export * from './public-api';

package/src/rxjs/public-api.d.ts

@@ -1 +0,0 @@
-export * from './rxjs-bridge';

package/src/rxjs/rxjs-bridge.d.ts

@@ -1,3 +0,0 @@
-import { Signal } from '@angular/core';
-import { Observable } from 'rxjs';
-export declare function toObservable<T>(signal: Signal<T>): Observable<T>;

package/src/wizard/index.d.ts

@@ -1 +0,0 @@
-export { createWizardForm, type FormStep } from './wizard';

package/src/wizard/wizard.d.ts

@@ -1,19 +0,0 @@
-import { Signal } from '@angular/core';
-type FormTreeOptions = Record<string, unknown>;
-interface FormTree<T extends Record<string, unknown>> {
-    unwrap(): T;
-}
-export interface FormStep<T extends Record<string, unknown>> {
-    fields: Array<keyof T | string>;
-    validate?: (form: FormTree<T>) => Promise<boolean> | boolean;
-    canSkip?: (values: T) => boolean;
-}
-export declare function createWizardForm<T extends Record<string, unknown>>(steps: FormStep<T>[], initialValues: T, config?: FormTreeOptions): FormTree<T> & {
-    currentStep: Signal<number>;
-    nextStep: () => Promise<boolean>;
-    previousStep: () => void;
-    goToStep: (index: number) => Promise<boolean>;
-    canGoToStep: (index: number) => boolean;
-    isFieldVisible: (field: keyof T | string) => Signal<boolean>;
-};
-export {};