@contember/bindx 0.1.0

package/dist/events/types.d.ts

@@ -0,0 +1,264 @@
+/**
+ * Type-safe event system for bindx.
+ *
+ * Events are categorized into:
+ * - Before events (interceptable): Can be cancelled or modified
+ * - After events (notifications): Fired after state changes
+ */
+import type { FieldError } from '../errors/types.js';
+/**
+ * Base interface for all bindx events.
+ */
+export interface BindxEvent<TType extends string = string> {
+    readonly type: TType;
+    readonly timestamp: number;
+    readonly entityType: string;
+    readonly entityId: string;
+}
+/**
+ * Base interface for field-scoped events.
+ */
+export interface FieldScopedEvent<TType extends string> extends BindxEvent<TType> {
+    readonly fieldName: string;
+}
+/**
+ * Fired before a field value changes. Can be intercepted to cancel or modify.
+ */
+export interface FieldChangingEvent extends FieldScopedEvent<'field:changing'> {
+    readonly fieldPath: readonly string[];
+    readonly oldValue: unknown;
+    readonly newValue: unknown;
+}
+/**
+ * Fired after a field value has changed.
+ */
+export interface FieldChangedEvent extends FieldScopedEvent<'field:changed'> {
+    readonly fieldPath: readonly string[];
+    readonly oldValue: unknown;
+    readonly newValue: unknown;
+}
+/**
+ * Fired before a has-one relation is connected.
+ */
+export interface RelationConnectingEvent extends FieldScopedEvent<'relation:connecting'> {
+    readonly targetId: string;
+    readonly previousId: string | null;
+}
+/**
+ * Fired after a has-one relation has been connected.
+ */
+export interface RelationConnectedEvent extends FieldScopedEvent<'relation:connected'> {
+    readonly targetId: string;
+    readonly previousId: string | null;
+}
+/**
+ * Fired before a has-one relation is disconnected.
+ */
+export interface RelationDisconnectingEvent extends FieldScopedEvent<'relation:disconnecting'> {
+    readonly currentId: string | null;
+}
+/**
+ * Fired after a has-one relation has been disconnected.
+ */
+export interface RelationDisconnectedEvent extends FieldScopedEvent<'relation:disconnected'> {
+    readonly previousId: string | null;
+}
+/**
+ * Fired before a has-one relation is deleted.
+ */
+export interface RelationDeletingEvent extends FieldScopedEvent<'relation:deleting'> {
+    readonly currentId: string | null;
+}
+/**
+ * Fired after a has-one relation has been deleted.
+ */
+export interface RelationDeletedEvent extends FieldScopedEvent<'relation:deleted'> {
+    readonly previousId: string | null;
+}
+/**
+ * Fired before an item is connected to a has-many relation.
+ */
+export interface HasManyConnectingEvent extends FieldScopedEvent<'hasMany:connecting'> {
+    readonly itemId: string;
+}
+/**
+ * Fired after an item has been connected to a has-many relation.
+ */
+export interface HasManyConnectedEvent extends FieldScopedEvent<'hasMany:connected'> {
+    readonly itemId: string;
+}
+/**
+ * Fired before an item is disconnected from a has-many relation.
+ */
+export interface HasManyDisconnectingEvent extends FieldScopedEvent<'hasMany:disconnecting'> {
+    readonly itemId: string;
+}
+/**
+ * Fired after an item has been disconnected from a has-many relation.
+ */
+export interface HasManyDisconnectedEvent extends FieldScopedEvent<'hasMany:disconnected'> {
+    readonly itemId: string;
+}
+/**
+ * Fired before an entity is persisted (create or update).
+ */
+export interface EntityPersistingEvent extends BindxEvent<'entity:persisting'> {
+    readonly isNew: boolean;
+}
+/**
+ * Fired after an entity has been successfully persisted.
+ */
+export interface EntityPersistedEvent extends BindxEvent<'entity:persisted'> {
+    readonly isNew: boolean;
+    readonly persistedId: string;
+}
+/**
+ * Fired when entity persistence fails.
+ */
+export interface EntityPersistFailedEvent extends BindxEvent<'entity:persistFailed'> {
+    readonly isNew: boolean;
+    readonly error: Error;
+}
+/**
+ * Fired before an entity is reset to server state.
+ */
+export interface EntityResettingEvent extends BindxEvent<'entity:resetting'> {
+}
+/**
+ * Fired after an entity has been reset to server state.
+ */
+export interface EntityResetEvent extends BindxEvent<'entity:reset'> {
+}
+/**
+ * Fired before an entity is deleted.
+ */
+export interface EntityDeletingEvent extends BindxEvent<'entity:deleting'> {
+}
+/**
+ * Fired after an entity has been deleted.
+ */
+export interface EntityDeletedEvent extends BindxEvent<'entity:deleted'> {
+}
+/**
+ * Fired when an error is added to a field, entity, or relation.
+ */
+export interface ErrorAddedEvent extends BindxEvent<'error:added'> {
+    readonly target: 'entity' | 'field' | 'relation';
+    readonly targetName: string | null;
+    readonly error: FieldError;
+}
+/**
+ * Fired when errors are cleared.
+ */
+export interface ErrorsClearedEvent extends BindxEvent<'errors:cleared'> {
+    readonly target: 'entity' | 'field' | 'relation' | 'all';
+    readonly targetName: string | null;
+}
+/**
+ * Fired when entity load state changes.
+ */
+export interface LoadStateChangedEvent extends BindxEvent<'load:stateChanged'> {
+    readonly previousStatus: string | undefined;
+    readonly newStatus: string;
+    readonly error?: FieldError;
+}
+/**
+ * All "before" events that can be intercepted and cancelled.
+ */
+export type BeforeEvent = FieldChangingEvent | RelationConnectingEvent | RelationDisconnectingEvent | RelationDeletingEvent | HasManyConnectingEvent | HasManyDisconnectingEvent | EntityPersistingEvent | EntityResettingEvent | EntityDeletingEvent;
+/**
+ * All "after" events (notifications).
+ */
+export type AfterEvent = FieldChangedEvent | RelationConnectedEvent | RelationDisconnectedEvent | RelationDeletedEvent | HasManyConnectedEvent | HasManyDisconnectedEvent | EntityPersistedEvent | EntityPersistFailedEvent | EntityResetEvent | EntityDeletedEvent | ErrorAddedEvent | ErrorsClearedEvent | LoadStateChangedEvent;
+/**
+ * All bindx events.
+ */
+export type AnyBindxEvent = BeforeEvent | AfterEvent;
+/**
+ * All before event type strings.
+ */
+export type BeforeEventType = BeforeEvent['type'];
+/**
+ * All after event type strings.
+ */
+export type AfterEventType = AfterEvent['type'];
+/**
+ * All event type strings.
+ */
+export type AnyEventType = AnyBindxEvent['type'];
+/**
+ * Map of event types to their event objects.
+ * Enables type-safe subscriptions.
+ */
+export interface EventTypeMap {
+    'field:changing': FieldChangingEvent;
+    'field:changed': FieldChangedEvent;
+    'relation:connecting': RelationConnectingEvent;
+    'relation:connected': RelationConnectedEvent;
+    'relation:disconnecting': RelationDisconnectingEvent;
+    'relation:disconnected': RelationDisconnectedEvent;
+    'relation:deleting': RelationDeletingEvent;
+    'relation:deleted': RelationDeletedEvent;
+    'hasMany:connecting': HasManyConnectingEvent;
+    'hasMany:connected': HasManyConnectedEvent;
+    'hasMany:disconnecting': HasManyDisconnectingEvent;
+    'hasMany:disconnected': HasManyDisconnectedEvent;
+    'entity:persisting': EntityPersistingEvent;
+    'entity:persisted': EntityPersistedEvent;
+    'entity:persistFailed': EntityPersistFailedEvent;
+    'entity:resetting': EntityResettingEvent;
+    'entity:reset': EntityResetEvent;
+    'entity:deleting': EntityDeletingEvent;
+    'entity:deleted': EntityDeletedEvent;
+    'error:added': ErrorAddedEvent;
+    'errors:cleared': ErrorsClearedEvent;
+    'load:stateChanged': LoadStateChangedEvent;
+}
+/**
+ * Extract event type from event name.
+ */
+export type EventByType<T extends keyof EventTypeMap> = EventTypeMap[T];
+/**
+ * Result of an interceptor execution.
+ */
+export type InterceptorResult<T extends BeforeEvent = BeforeEvent> = {
+    readonly action: 'cancel';
+} | {
+    readonly action: 'continue';
+} | {
+    readonly action: 'modify';
+    readonly event: T;
+};
+/**
+ * Interceptor function type.
+ * Can be sync or async.
+ * Return undefined/void to continue without changes.
+ */
+export type Interceptor<T extends BeforeEvent> = (event: T) => InterceptorResult<T> | Promise<InterceptorResult<T>> | void | Promise<void>;
+/**
+ * Event listener function type.
+ */
+export type EventListener<T extends AfterEvent> = (event: T) => void;
+/**
+ * Unsubscribe function returned by subscription methods.
+ */
+export type Unsubscribe = () => void;
+/**
+ * Extract before events from EventTypeMap.
+ */
+export type BeforeEventTypes = {
+    [K in keyof EventTypeMap]: EventTypeMap[K] extends BeforeEvent ? K : never;
+}[keyof EventTypeMap];
+/**
+ * Extract after events from EventTypeMap.
+ */
+export type AfterEventTypes = {
+    [K in keyof EventTypeMap]: EventTypeMap[K] extends AfterEvent ? K : never;
+}[keyof EventTypeMap];
+/**
+ * Extract field-scoped events.
+ */
+export type FieldScopedEventTypes = {
+    [K in keyof EventTypeMap]: EventTypeMap[K] extends FieldScopedEvent<string> ? K : never;
+}[keyof EventTypeMap];
+//# sourceMappingURL=types.d.ts.map

package/dist/events/types.d.ts.map

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

package/dist/handles/BaseHandle.d.ts

@@ -0,0 +1,64 @@
+import type { Disposable } from '../core/Disposable.js';
+import type { ActionDispatcher } from '../core/ActionDispatcher.js';
+import type { SnapshotStore } from '../store/SnapshotStore.js';
+/**
+ * Base class for all handles.
+ * Provides common functionality for subscription and disposal.
+ *
+ * Handles are stable objects that:
+ * - Have stable identity (same instance across renders)
+ * - Provide subscribe/getSnapshot for useSyncExternalStore
+ * - Dispatch actions for mutations
+ */
+export declare abstract class BaseHandle implements Disposable {
+    protected readonly store: SnapshotStore;
+    protected readonly dispatcher: ActionDispatcher;
+    protected _disposed: boolean;
+    constructor(store: SnapshotStore, dispatcher: ActionDispatcher);
+    /**
+     * Subscribe to changes. Used by useSyncExternalStore.
+     */
+    abstract subscribe(callback: () => void): () => void;
+    /**
+     * Get current version for change detection.
+     */
+    abstract getVersion(): number;
+    /**
+     * Dispose resources (unsubscribe, cleanup).
+     */
+    dispose(): void;
+    /**
+     * Check if the handle has been disposed.
+     */
+    get isDisposed(): boolean;
+    /**
+     * Throws if the handle has been disposed.
+     */
+    protected assertNotDisposed(): void;
+}
+/**
+ * Base class for entity-related handles.
+ * Provides common entity subscription logic.
+ */
+export declare abstract class EntityRelatedHandle extends BaseHandle {
+    protected readonly entityType: string;
+    protected readonly entityId: string;
+    constructor(entityType: string, entityId: string, store: SnapshotStore, dispatcher: ActionDispatcher);
+    /**
+     * Subscribe to entity changes.
+     */
+    subscribe(callback: () => void): () => void;
+    /**
+     * Get entity snapshot version.
+     */
+    getVersion(): number;
+    /**
+     * Get entity data.
+     */
+    protected getEntityData(): Record<string, unknown> | undefined;
+    /**
+     * Get entity server data.
+     */
+    protected getServerData(): Record<string, unknown> | undefined;
+}
+//# sourceMappingURL=BaseHandle.d.ts.map

package/dist/handles/BaseHandle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseHandle.d.ts","sourceRoot":"","sources":["../../src/handles/BaseHandle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,uBAAuB,CAAA;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAE9D;;;;;;;;GAQG;AACH,8BAAsB,UAAW,YAAW,UAAU;IAIpD,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,aAAa;IACvC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,gBAAgB;IAJhD,SAAS,CAAC,SAAS,UAAQ;gBAGP,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,gBAAgB;IAGhD;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAEpD;;OAEG;IACH,QAAQ,CAAC,UAAU,IAAI,MAAM;IAE7B;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,IAAI;CAKnC;AAED;;;GAGG;AACH,8BAAsB,mBAAoB,SAAQ,UAAU;IAE1D,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM;IACrC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM;gBADhB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EACnC,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,gBAAgB;IAK7B;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAI3C;;OAEG;IACH,UAAU,IAAI,MAAM;IAKpB;;OAEG;IACH,SAAS,CAAC,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAK9D;;OAEG;IACH,SAAS,CAAC,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;CAI9D"}

package/dist/handles/EntityHandle.d.ts

@@ -0,0 +1,208 @@
+import { EntityRelatedHandle } from './BaseHandle.js';
+import { FieldHandle } from './FieldHandle.js';
+import type { ActionDispatcher } from '../core/ActionDispatcher.js';
+import { type SnapshotStore } from '../store/SnapshotStore.js';
+import type { SchemaRegistry } from '../schema/SchemaRegistry.js';
+import type { EntitySnapshot } from '../store/snapshots.js';
+import { type EntityRef, type SelectedEntityFields, type Unsubscribe } from './types.js';
+import { type ErrorInput, type FieldError } from '../errors/types.js';
+import type { EventTypeMap, AfterEventTypes, BeforeEventTypes, EventListener, Interceptor, EntityPersistedEvent, EntityPersistingEvent } from '../events/types.js';
+import { HasOneHandle } from './HasOneHandle.js';
+import { HasManyListHandle } from './HasManyListHandle.js';
+import type { SelectionMeta } from '../selection/types.js';
+/**
+ * EntityHandle provides stable access to an entity.
+ * Implements EntityRef interface for consistent usage across the system.
+ *
+ * Supports direct field access for shorter chains:
+ * - `entity.fieldName` is equivalent to `entity.$fields.fieldName`
+ * - Handle properties use $ prefix to avoid collision with field names: `$id`, `$data`, `$isDirty`, etc.
+ *
+ * Key characteristics:
+ * - Stable identity (same instance across renders when id doesn't change)
+ * - Provides field handles for individual fields
+ * - Provides relation handles for has-one and has-many relations
+ * - Tracks dirty state across all fields
+ *
+ * @typeParam T - The full entity type
+ * @typeParam TSelected - The selected subset of fields (defaults to T for backwards compatibility)
+ */
+export declare class EntityHandle<T extends object = object, TSelected = T> extends EntityRelatedHandle implements EntityRef<T, TSelected> {
+    private readonly schema;
+    private readonly selection?;
+    /** Cache for field handles to ensure stable identity */
+    private readonly fieldHandleCache;
+    /** Cache for relation handles */
+    private readonly relationHandleCache;
+    /** Runtime brand symbols for validation */
+    readonly __brands?: Set<symbol>;
+    /** Type brand for schema - placeholder at runtime */
+    readonly __schema: Record<string, object>;
+    readonly $fields: SelectedEntityFields<T, TSelected>;
+    readonly $data: TSelected | null;
+    readonly $isDirty: boolean;
+    readonly $persistedId: string | null;
+    readonly $isNew: boolean;
+    readonly $errors: readonly FieldError[];
+    readonly $hasError: boolean;
+    $addError: (error: ErrorInput) => void;
+    $clearErrors: () => void;
+    $clearAllErrors: () => void;
+    $on: <E extends AfterEventTypes>(eventType: E, listener: EventListener<EventTypeMap[E]>) => Unsubscribe;
+    $intercept: <E extends BeforeEventTypes>(eventType: E, interceptor: Interceptor<EventTypeMap[E]>) => Unsubscribe;
+    $onPersisted: (listener: EventListener<EntityPersistedEvent>) => Unsubscribe;
+    $interceptPersisting: (interceptor: Interceptor<EntityPersistingEvent>) => Unsubscribe;
+    private constructor();
+    static create<T extends object = object, TSelected = T>(id: string, entityType: string, store: SnapshotStore, dispatcher: ActionDispatcher, schema: SchemaRegistry, brands?: Set<symbol>, selection?: SelectionMeta): EntityHandle<T, TSelected>;
+    /**
+     * Gets the entity ID.
+     */
+    get id(): string;
+    /**
+     * Gets the entity type.
+     */
+    get type(): string;
+    /**
+     * Gets the current entity snapshot.
+     */
+    getSnapshot(): EntitySnapshot<T> | undefined;
+    /**
+     * Gets the current entity data.
+     * Returns selected fields subset as specified by TSelected type parameter.
+     */
+    get data(): TSelected | null;
+    /**
+     * Gets the server data.
+     */
+    get serverData(): T | undefined;
+    /**
+     * Checks if the entity has been loaded.
+     */
+    get isLoaded(): boolean;
+    /**
+     * Checks if the entity is currently loading.
+     */
+    get isLoading(): boolean;
+    /**
+     * Checks if there was an error loading the entity.
+     */
+    get isError(): boolean;
+    /**
+     * Gets the loading error if any.
+     */
+    get error(): FieldError | undefined;
+    /**
+     * Checks if the entity is currently being persisted.
+     */
+    get isPersisting(): boolean;
+    /**
+     * Checks if any field on the entity has been modified.
+     * This includes scalar field changes and relation changes (hasOne, hasMany).
+     */
+    get isDirty(): boolean;
+    /**
+     * Gets the persisted ID (server-assigned ID after create).
+     * Returns the ID itself if it's already a real ID, null if it's a temp ID without mapping.
+     */
+    get persistedId(): string | null;
+    /**
+     * Checks if this entity is new (created locally, not yet persisted to server).
+     */
+    get isNew(): boolean;
+    /**
+     * Gets a field handle for a specific field.
+     * Returns cached handle to ensure stable identity.
+     */
+    field<K extends keyof T>(fieldName: K): FieldHandle<T[K]>;
+    /**
+     * Gets a has-one relation handle.
+     */
+    hasOne<TRelated extends object>(fieldName: string, nestedSelection?: SelectionMeta): HasOneHandle<TRelated>;
+    /**
+     * Gets a has-many relation handle.
+     *
+     * @param alias - Optional alias for the relation. When the same field is used multiple times
+     *                with different parameters (filter, orderBy, limit), each needs a unique alias.
+     */
+    hasMany<TItem extends object>(fieldName: string, alias?: string, nestedSelection?: SelectionMeta): HasManyListHandle<TItem>;
+    /**
+     * Resets the entity to server data.
+     * Also resets all relation states (hasOne, hasMany).
+     */
+    reset(): void;
+    /**
+     * Commits changes (serverData = data).
+     */
+    commit(): void;
+    /**
+     * Disposes the handle and all cached child handles.
+     */
+    dispose(): void;
+    /**
+     * Creates a proxy for field access.
+     * Returns appropriate handle type based on schema field definition:
+     * - Scalar fields -> FieldHandle
+     * - HasOne relations -> HasOneHandle
+     * - HasMany relations -> HasManyListHandle
+     *
+     * Implements EntityRef.fields - returns selection-aware field accessors.
+     */
+    get fields(): SelectedEntityFields<T, TSelected>;
+    /**
+     * Type brand - ensures EntityRef<Author> is not assignable to EntityRef<Tag>.
+     * This is a phantom property that only exists in the type system.
+     * Implements EntityRef.__entityType.
+     */
+    get __entityType(): T;
+    /**
+     * Entity name for type inference.
+     * Carries the entity type name (e.g., 'Article', 'Author').
+     * Implements EntityRef.__entityName.
+     */
+    get __entityName(): string;
+    /**
+     * Gets the list of entity-level errors (not including field or relation errors).
+     */
+    get errors(): readonly FieldError[];
+    /**
+     * Checks if this entity has any errors (entity-level, fields, or relations).
+     */
+    get hasError(): boolean;
+    /**
+     * Adds a client-side error to this entity.
+     */
+    addError(error: ErrorInput): void;
+    /**
+     * Clears entity-level errors.
+     */
+    clearErrors(): void;
+    /**
+     * Clears all errors (entity-level, fields, and relations).
+     */
+    clearAllErrors(): void;
+    /**
+     * Gets the list of dirty scalar fields.
+     */
+    getDirtyFields(): readonly string[];
+    /**
+     * Gets the list of dirty relations.
+     */
+    getDirtyRelations(): readonly string[];
+    /**
+     * Subscribe to any event on this entity.
+     */
+    on<E extends AfterEventTypes>(eventType: E, listener: EventListener<EventTypeMap[E]>): Unsubscribe;
+    /**
+     * Intercept any before event on this entity.
+     */
+    intercept<E extends BeforeEventTypes>(eventType: E, interceptor: Interceptor<EventTypeMap[E]>): Unsubscribe;
+    /**
+     * Subscribe to persist success events.
+     */
+    onPersisted(listener: EventListener<EntityPersistedEvent>): Unsubscribe;
+    /**
+     * Intercept persist (can cancel).
+     */
+    interceptPersisting(interceptor: Interceptor<EntityPersistingEvent>): Unsubscribe;
+}
+//# sourceMappingURL=EntityHandle.d.ts.map

package/dist/handles/EntityHandle.d.ts.map

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

package/dist/handles/FieldHandle.d.ts

@@ -0,0 +1,111 @@
+import { EntityRelatedHandle } from './BaseHandle.js';
+import type { ActionDispatcher } from '../core/ActionDispatcher.js';
+import type { SnapshotStore } from '../store/SnapshotStore.js';
+import { FIELD_REF_META, type FieldRef, type FieldRefMeta, type InputProps, type Unsubscribe } from './types.js';
+import { type ErrorInput, type FieldError } from '../errors/types.js';
+import type { FieldChangedEvent, FieldChangingEvent, EventListener, Interceptor } from '../events/types.js';
+/**
+ * FieldHandle provides stable access to a scalar field.
+ *
+ * Key characteristics:
+ * - Stable identity (same instance across renders)
+ * - Reads data from SnapshotStore snapshots
+ * - Dispatches actions for mutations
+ * - Provides inputProps for form integration
+ * - Implements FieldRef interface for JSX compatibility
+ */
+export declare class FieldHandle<T = unknown> extends EntityRelatedHandle implements FieldRef<T> {
+    private readonly fieldPath;
+    private readonly _enumName?;
+    private readonly _columnType?;
+    private _cachedInputProps;
+    private _cachedInputPropsValue;
+    private readonly _boundSetValue;
+    private constructor();
+    static create<T = unknown>(entityType: string, entityId: string, fieldPath: string[], store: SnapshotStore, dispatcher: ActionDispatcher, enumName?: string, columnType?: string): FieldHandle<T>;
+    /**
+     * JSX field reference metadata for collection phase.
+     * Implements FieldRef interface.
+     */
+    get [FIELD_REF_META](): FieldRefMeta;
+    /**
+     * Gets the current field value.
+     */
+    get value(): T | null;
+    /**
+     * Gets the server value (for dirty tracking).
+     */
+    get serverValue(): T | null;
+    /**
+     * Checks if the field has been modified.
+     */
+    get isDirty(): boolean;
+    /**
+     * Checks if the field has been touched (interacted with by the user).
+     * Useful for showing errors only after user interaction.
+     */
+    get isTouched(): boolean;
+    /**
+     * Marks the field as touched.
+     * Call this on blur or other interaction events.
+     */
+    touch(): void;
+    /**
+     * Sets the field value.
+     * Also clears non-sticky client errors.
+     */
+    setValue(value: T | null): void;
+    /**
+     * Gets the list of errors on this field.
+     */
+    get errors(): readonly FieldError[];
+    /**
+     * Checks if this field has any errors.
+     */
+    get hasError(): boolean;
+    /**
+     * Adds a client-side error to this field.
+     */
+    addError(error: ErrorInput): void;
+    /**
+     * Clears all errors from this field.
+     */
+    clearErrors(): void;
+    /**
+     * Gets input binding props for form integration.
+     *
+     * @example
+     * ```tsx
+     * <input {...field.inputProps} />
+     * // or with custom handler
+     * <input
+     *   value={field.inputProps.value ?? ''}
+     *   onChange={e => field.inputProps.onChange(e.target.value)}
+     * />
+     * ```
+     */
+    get inputProps(): InputProps<T>;
+    /**
+     * Gets the field path.
+     */
+    get path(): readonly string[];
+    /**
+     * Gets the field name (last segment of path).
+     */
+    get fieldName(): string;
+    /**
+     * Creates a nested field handle for a subfield.
+     */
+    nested<K extends keyof NonNullable<T>>(key: K): FieldHandle<NonNullable<T>[K]>;
+    /**
+     * Subscribe to field value changes.
+     * The listener is called after the value has changed.
+     */
+    onChange(listener: EventListener<FieldChangedEvent>): Unsubscribe;
+    /**
+     * Intercept field value changes.
+     * The interceptor can cancel or modify the change.
+     */
+    onChanging(interceptor: Interceptor<FieldChangingEvent>): Unsubscribe;
+}
+//# sourceMappingURL=FieldHandle.d.ts.map

package/dist/handles/FieldHandle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldHandle.d.ts","sourceRoot":"","sources":["../../src/handles/FieldHandle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAE9D,OAAO,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AAEhH,OAAO,EAAqB,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACxF,OAAO,KAAK,EACX,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,MAAM,oBAAoB,CAAA;AAG3B;;;;;;;;;GASG;AACH,qBAAa,WAAW,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,mBAAoB,YAAW,QAAQ,CAAC,CAAC,CAAC;IAStF,OAAO,CAAC,QAAQ,CAAC,SAAS;IAG1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAZ9B,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,sBAAsB,CAAkC;IAEhE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkD;IAEjF,OAAO;IAYP,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,EACxB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EAAE,EACnB,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,gBAAgB,EAC5B,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GACjB,WAAW,CAAC,CAAC,CAAC;IAIjB;;;OAGG;IACH,IAAI,CAAC,cAAc,CAAC,IAAI,YAAY,CAWnC;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,CAAC,GAAG,IAAI,CAIpB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,CAAC,GAAG,IAAI,CAI1B;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;OAGG;IACH,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;IAS/B;;OAEG;IACH,IAAI,MAAM,IAAI,SAAS,UAAU,EAAE,CAElC;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAOjC;;OAEG;IACH,WAAW,IAAI,IAAI;IAOnB;;;;;;;;;;;;OAYG;IACH,IAAI,UAAU,IAAI,UAAU,CAAC,CAAC,CAAC,CAW9B;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,SAAS,MAAM,EAAE,CAE5B;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACH,MAAM,CAAC,CAAC,SAAS,MAAM,WAAW,CAAC,CAAC,CAAC,EACpC,GAAG,EAAE,CAAC,GACJ,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAYjC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,iBAAiB,CAAC,GAAG,WAAW;IAWjE;;;OAGG;IACH,UAAU,CAAC,WAAW,EAAE,WAAW,CAAC,kBAAkB,CAAC,GAAG,WAAW;CAWrE"}