@sectile/terminal 0.2.0 → 0.3.0

package/dist/editable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editable.d.ts","sourceRoot":"","sources":["../src/editable.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAA0B,KAAK,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEnF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CAChC;AAED,MAAM,MAAM,0BAA0B,GAAG,WAAW,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,CAAC;AACvF,MAAM,MAAM,4BAA4B,GAAG,WAAW,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAC3F,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC;AAE7E,MAAM,WAAW,kBAAkB;IACjC,WAAW,IAAI,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAC/C,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC;IAC5E,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;IAC3C,mBAAmB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC;CAC5D;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,eAAoB,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,CAElG;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,eAAoB,GAAG,MAAM,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,CAAC,CAE7G"}

package/dist/editable.js

@@ -0,0 +1,70 @@
+import { createFacadeConnection } from './internal/facade.js';
+import { unwrap } from '@sectile/core/result';
+import { applyEditableEvent, tryCreateEditableState, } from '@sectile/core/editable';
+import { createSemanticController } from './internal/semantic-controller.js';
+import { applyTerminalTextInput } from './keyboard.js';
+export function createEditable(options = {}) {
+    return unwrap(tryCreateEditable(options));
+}
+export function tryCreateEditable(options = {}) {
+    return createFacadeConnection(options, (resolved) => tryCreateEditableConnection(resolved));
+}
+function tryCreateEditableConnection(options) {
+    const controlled = options.value !== undefined;
+    const runtime = createSemanticController({
+        initial: tryCreateEditableState(options.value ?? options.defaultValue ?? ''),
+        reducer: (state, event) => applyEditableEvent(state, event, options.policies),
+        reconcile: (previous, proposed) => tryCreateEditableState(controlled ? previous.value : proposed.value, proposed.editing ? proposed.draft : controlled ? previous.value : proposed.value, proposed.editing),
+        notify: (previous, proposed) => {
+            if (previous.value !== proposed.value)
+                options.onValueChange?.(proposed.value);
+            if (previous.editing !== proposed.editing)
+                options.onEditingChange?.(proposed.editing);
+        },
+        toEffect: (command) => command,
+        interaction: options,
+    });
+    return runtime.ok
+        ? { ok: true, value: new TerminalEditable(options, runtime.value, controlled) }
+        : runtime;
+}
+class TerminalEditable {
+    #options;
+    #runtime;
+    #controlled;
+    constructor(options, runtime, controlled) {
+        this.#options = options;
+        this.#runtime = runtime;
+        this.#controlled = controlled;
+    }
+    getSnapshot() {
+        return this.#runtime.getSnapshot();
+    }
+    syncControlledValue(value) {
+        if (!this.#controlled) {
+            return { ok: false, error: { class: 'construction', code: 'uncontrolled-controller-sync', message: 'An uncontrolled editable cannot be synchronized externally.' } };
+        }
+        const state = this.getSnapshot().state;
+        const result = this.#runtime.replace(tryCreateEditableState(value, state.editing ? state.draft : value, state.editing));
+        if (result.ok)
+            this.#options.onUpdate?.();
+        return result;
+    }
+    handleEvent(event) {
+        const result = this.#runtime.handle(event);
+        if (result.ok)
+            this.#options.onUpdate?.();
+        return result.ok;
+    }
+    handleKeyboardInput(input) {
+        if (input.key === 'enter')
+            return this.handleEvent(this.getSnapshot().state.editing ? 'commit' : 'start-edit');
+        if (input.key === 'escape')
+            return this.handleEvent('cancel');
+        if (!this.getSnapshot().state.editing)
+            return false;
+        const draft = applyTerminalTextInput(this.getSnapshot().state.draft, input);
+        return draft === null ? false : this.handleEvent({ type: 'input', text: draft });
+    }
+}
+//# sourceMappingURL=editable.js.map

package/dist/editable.js.map

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

package/dist/feed.d.ts

@@ -0,0 +1,36 @@
+import type { Result, StableID } from '@sectile/core';
+import { type FeedDirection, type FeedEvent, type FeedState } from '@sectile/core/feed';
+import type { RevisionSnapshot } from '@sectile/core/revision';
+import { type FacadeConnection } from './internal/facade.js';
+import type { TerminalKeyboardInput } from './keyboard.js';
+export interface FeedOptions<ID extends StableID = StableID> {
+    readonly items: readonly ID[];
+    readonly revision?: number;
+    readonly start?: number;
+    readonly total?: number | null;
+    readonly defaultHighlightedValue?: ID | null;
+    readonly disabled?: boolean;
+    readonly onHighlightedValueChange?: (value: ID | null) => void;
+    readonly onRequestWindow?: (direction: FeedDirection, anchor: ID | null, revision: number, requestGeneration: number) => void;
+    readonly onUpdate?: () => void;
+}
+export type FeedHighlightedValueChangeHandler<ID extends StableID = StableID> = NonNullable<FeedOptions<ID>['onHighlightedValueChange']>;
+export type FeedRequestWindowHandler<ID extends StableID = StableID> = NonNullable<FeedOptions<ID>['onRequestWindow']>;
+export type FeedUpdateHandler<ID extends StableID = StableID> = NonNullable<FeedOptions<ID>['onUpdate']>;
+export interface FeedWindow<ID extends StableID = StableID> {
+    readonly items: readonly ID[];
+    readonly revision: number;
+    readonly requestGeneration?: number;
+    readonly start?: number;
+    readonly total?: number | null;
+    readonly highlightedValue?: ID | null;
+}
+export interface FeedConnection<ID extends StableID = StableID> {
+    getSnapshot(): RevisionSnapshot<FeedState<ID>>;
+    syncWindow(window: FeedWindow<ID>): Result<RevisionSnapshot<FeedState<ID>>>;
+    handleEvent(event: FeedEvent<ID>): boolean;
+    handleKeyboardInput(input: TerminalKeyboardInput): boolean;
+}
+export declare function createFeed<ID extends StableID>(options: FeedOptions<ID>): FacadeConnection<FeedConnection<ID>>;
+export declare function tryCreateFeed<ID extends StableID>(options: FeedOptions<ID>): Result<FacadeConnection<FeedConnection<ID>>>;
+//# sourceMappingURL=feed.d.ts.map

package/dist/feed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feed.d.ts","sourceRoot":"","sources":["../src/feed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,WAAW,WAAW,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ;IACzD,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,uBAAuB,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,KAAK,IAAI,CAAC;IAC/D,QAAQ,CAAC,eAAe,CAAC,EAAE,CACzB,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,EAAE,GAAG,IAAI,EACjB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,KACtB,IAAI,CAAC;IACV,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CAChC;AAED,MAAM,MAAM,iCAAiC,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ,IAC1E,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC;AAC3D,MAAM,MAAM,wBAAwB,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ,IACjE,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAClD,MAAM,MAAM,iBAAiB,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ,IAC1D,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AAE3C,MAAM,WAAW,UAAU,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ;IACxD,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,cAAc,CAAC,EAAE,SAAS,QAAQ,GAAG,QAAQ;IAC5D,WAAW,IAAI,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/C,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5E,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC;IAC3C,mBAAmB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC;CAC5D;AAED,wBAAgB,UAAU,CAAC,EAAE,SAAS,QAAQ,EAC5C,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC,GACvB,gBAAgB,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAEtC;AAED,wBAAgB,aAAa,CAAC,EAAE,SAAS,QAAQ,EAC/C,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC,GACvB,MAAM,CAAC,gBAAgB,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,CAE9C"}

package/dist/feed.js

@@ -0,0 +1,90 @@
+import { applyFeedEvent, synchronizeFeedWindow, tryCreateFeedState, } from '@sectile/core/feed';
+import { unwrap } from '@sectile/core/result';
+import { tryCreateSequence } from '@sectile/core/sequence';
+import { createFacadeConnection } from './internal/facade.js';
+import { createSemanticController } from './internal/semantic-controller.js';
+export function createFeed(options) {
+    return unwrap(tryCreateFeed(options));
+}
+export function tryCreateFeed(options) {
+    return createFacadeConnection(options, (normalized) => tryCreateFeedConnection(normalized));
+}
+function tryCreateFeedConnection(options) {
+    const items = tryCreateSequence(options.items);
+    if (!items.ok)
+        return items;
+    const model = { value: items.value };
+    const runtime = createSemanticController({
+        initial: tryCreateFeedState(items.value, options.defaultHighlightedValue ?? options.items[0] ?? null, options.revision ?? 0, null, { start: options.start ?? 0, total: options.total ?? null }),
+        reducer: (state, event) => applyFeedEvent(model.value, state, event),
+        notify: (previous, proposed) => {
+            if (previous.cursor.current !== proposed.cursor.current) {
+                options.onHighlightedValueChange?.(proposed.cursor.current);
+            }
+        },
+        toEffect: (command) => command,
+        interaction: options,
+    });
+    return runtime.ok
+        ? { ok: true, value: new TerminalFeed(options, model, runtime.value) }
+        : runtime;
+}
+class TerminalFeed {
+    #options;
+    #model;
+    #runtime;
+    constructor(options, model, runtime) {
+        this.#options = options;
+        this.#model = model;
+        this.#runtime = runtime;
+    }
+    getSnapshot() {
+        return this.#runtime.getSnapshot();
+    }
+    syncWindow(window) {
+        const items = tryCreateSequence(window.items);
+        if (!items.ok)
+            return items;
+        const previous = this.getSnapshot().state;
+        const state = synchronizeFeedWindow(items.value, previous, {
+            revision: window.revision,
+            ...(window.requestGeneration === undefined ? {} : { requestGeneration: window.requestGeneration }),
+            ...(window.start === undefined ? {} : { start: window.start }),
+            ...(window.total === undefined ? {} : { total: window.total }),
+            current: window.highlightedValue
+                ?? (previous.cursor.current !== null && items.value.contains(previous.cursor.current)
+                    ? previous.cursor.current
+                    : window.items[0] ?? null),
+        });
+        if (!state.ok)
+            return state;
+        this.#model.value = items.value;
+        const result = this.#runtime.replace(state);
+        if (result.ok)
+            this.#options.onUpdate?.();
+        return result;
+    }
+    handleEvent(event) {
+        const result = this.#runtime.handle(event);
+        if (result.ok) {
+            for (const command of result.commands) {
+                if (command.type === 'request-window') {
+                    this.#options.onRequestWindow?.(command.direction, command.anchor, command.revision, command.requestGeneration);
+                }
+            }
+        }
+        this.#options.onUpdate?.();
+        return result.ok;
+    }
+    handleKeyboardInput(input) {
+        const event = input.key === 'down' || input.key === 'page-down'
+            ? 'next'
+            : input.key === 'up' || input.key === 'page-up'
+                ? 'previous'
+                : input.key === 'load-before'
+                    ? 'request-before'
+                    : input.key === 'load-after' ? 'request-after' : null;
+        return event === null ? false : this.handleEvent(event);
+    }
+}
+//# sourceMappingURL=feed.js.map

package/dist/feed.js.map

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

package/dist/form.d.ts

@@ -0,0 +1,65 @@
+import { type FormFieldInput, type FormIssue, type FormIssueSource, type FormState } from '@sectile/core/form';
+import type { Result, StableID } from '@sectile/core';
+import type { TerminalKeyboardInput } from './keyboard.js';
+export interface TerminalFormFieldValidation<ID extends StableID = StableID> {
+    readonly valid: boolean;
+    readonly issues?: readonly FormIssue<ID>[];
+}
+export type TerminalFormFieldValidator<ID extends StableID = StableID> = () => TerminalFormFieldValidation<ID>;
+export type TerminalFormFieldResetHandler = () => void;
+export interface TerminalFormField<ID extends StableID = StableID> extends Omit<FormFieldInput<ID>, 'valid' | 'issues'> {
+    readonly label: string;
+    readonly available?: boolean;
+    readonly validate?: TerminalFormFieldValidator<ID>;
+    readonly reset?: TerminalFormFieldResetHandler;
+}
+export interface TerminalFormSnapshot<ID extends StableID = StableID> {
+    readonly revision: number;
+    readonly state: FormState<ID>;
+    readonly currentFieldId: ID | null;
+    readonly summaryIssues: readonly FormIssue<ID>[];
+}
+export type TerminalFormSnapshotListener<ID extends StableID = StableID> = (snapshot: TerminalFormSnapshot<ID>) => void;
+export interface TerminalFormSubmitPayload<ID extends StableID = StableID> {
+    readonly state: FormState<ID>;
+    readonly currentFieldId: ID | null;
+}
+export type TerminalFormSubmitHandler<ID extends StableID = StableID> = (payload: TerminalFormSubmitPayload<ID>) => void;
+export type TerminalFormCurrentFieldChangeHandler<ID extends StableID = StableID> = (id: ID | null) => void;
+export type TerminalFormAnnounceSummaryHandler<ID extends StableID = StableID> = (issues: readonly FormIssue<ID>[]) => void;
+export type TerminalFormStateChangeHandler<ID extends StableID = StableID> = (state: FormState<ID>) => void;
+export type TerminalFormUpdateHandler = () => void;
+export interface TerminalFormOptions<ID extends StableID = StableID> {
+    readonly fields?: readonly TerminalFormField<ID>[];
+    readonly issues?: readonly FormIssue<ID>[];
+    readonly defaultCurrentFieldId?: ID | null;
+    readonly onCurrentFieldChange?: TerminalFormCurrentFieldChangeHandler<ID>;
+    readonly onSubmit?: TerminalFormSubmitHandler<ID>;
+    readonly onAnnounceSummary?: TerminalFormAnnounceSummaryHandler<ID>;
+    readonly onStateChange?: TerminalFormStateChangeHandler<ID>;
+    readonly onUpdate?: TerminalFormUpdateHandler;
+}
+export interface TerminalFormConnection<ID extends StableID = StableID> {
+    readonly state: FormState<ID>;
+    readonly currentFieldId: ID | null;
+    readonly summaryIssues: readonly FormIssue<ID>[];
+    getSnapshot(): TerminalFormSnapshot<ID>;
+    registerField(field: TerminalFormField<ID>): () => void;
+    refreshField(id: ID, flags?: {
+        readonly touched?: boolean;
+        readonly dirty?: boolean;
+    }): boolean;
+    focusField(id: ID): boolean;
+    handleKeyboardInput(input: TerminalKeyboardInput): boolean;
+    replaceIssues(source: FormIssueSource, issues: readonly FormIssue<ID>[]): boolean;
+    submit(): boolean;
+    submitStarted(): number | null;
+    submitSucceeded(generation: number): boolean;
+    submitFailed(generation: number, issues?: readonly FormIssue<ID>[]): boolean;
+    reset(): boolean;
+    subscribe(listener: TerminalFormSnapshotListener<ID>): () => void;
+    destroy(): void;
+}
+export declare function createForm<ID extends StableID = StableID>(options?: TerminalFormOptions<ID>): TerminalFormConnection<ID>;
+export declare function tryCreateForm<ID extends StableID = StableID>(options?: TerminalFormOptions<ID>): Result<TerminalFormConnection<ID>>;
+//# sourceMappingURL=form.d.ts.map

package/dist/form.d.ts.map

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

package/dist/form.js

@@ -0,0 +1,234 @@
+import { applyFormEvent, tryCreateFormState, } from '@sectile/core/form';
+import { unwrap } from '@sectile/core/result';
+export function createForm(options = {}) {
+    return unwrap(tryCreateForm(options));
+}
+export function tryCreateForm(options = {}) {
+    const fieldInputs = (options.fields ?? []).map(toFieldInput);
+    const initial = tryCreateFormState({ fields: fieldInputs, issues: options.issues ?? [] });
+    if (!initial.ok)
+        return initial;
+    const fields = new Map((options.fields ?? []).map((field) => [field.id, field]));
+    const subscribers = new Set();
+    let state = initial.value;
+    let currentFieldId = resolveInitialField(fields, options.defaultCurrentFieldId ?? null);
+    let summaryIssues = Object.freeze([]);
+    let revision = 0;
+    let active = true;
+    const snapshot = () => Object.freeze({
+        revision,
+        state,
+        currentFieldId,
+        summaryIssues,
+    });
+    const notify = () => {
+        revision += 1;
+        const next = snapshot();
+        options.onStateChange?.(state);
+        options.onUpdate?.();
+        for (const subscriber of subscribers)
+            subscriber(next);
+    };
+    const setCurrent = (id) => {
+        if (id !== null && !isAvailable(fields.get(id)))
+            return false;
+        if (currentFieldId === id)
+            return true;
+        currentFieldId = id;
+        options.onCurrentFieldChange?.(id);
+        notify();
+        return true;
+    };
+    const orderedIssues = () => Object.freeze([
+        ...state.fields.flatMap((field) => field.issues),
+        ...state.issues,
+    ]);
+    const execute = (commands) => {
+        for (const command of commands) {
+            if (command.type === 'focus-field')
+                setCurrent(command.id);
+            if (command.type === 'announce-summary') {
+                summaryIssues = Object.freeze(orderedIssues().filter((issue) => command.issueIds.includes(issue.id)));
+                options.onAnnounceSummary?.(summaryIssues);
+            }
+            if (command.type === 'submit-requested') {
+                options.onSubmit?.({ state, currentFieldId });
+            }
+            if (command.type === 'reset-field')
+                fields.get(command.id)?.reset?.();
+        }
+    };
+    const transition = (event) => {
+        if (!active)
+            return false;
+        const result = applyFormEvent(state, event);
+        if (!result.ok)
+            return false;
+        state = result.value.state;
+        execute(result.value.commands);
+        notify();
+        return true;
+    };
+    const refreshField = (id, flags = {}) => {
+        const field = fields.get(id);
+        const current = state.fields.find((candidate) => candidate.id === id);
+        if (field === undefined || current === undefined)
+            return false;
+        const validation = field.validate?.() ?? { valid: true, issues: [] };
+        if (!transition({
+            type: 'validation-started',
+            trigger: 'input',
+            intent: 'interaction',
+        }))
+            return false;
+        const generation = state.validationGeneration;
+        if (!transition({
+            type: 'update-field',
+            id,
+            touched: flags.touched ?? current.touched,
+            dirty: flags.dirty ?? current.dirty,
+            valid: validation.valid,
+            issues: validation.issues ?? [],
+        }))
+            return false;
+        return transition({
+            type: 'validation-completed',
+            trigger: 'input',
+            intent: 'interaction',
+            generation,
+        });
+    };
+    const validateAllForSubmission = () => {
+        if (!transition({
+            type: 'validation-started',
+            trigger: 'submit',
+            intent: 'submission',
+        }))
+            return false;
+        const generation = state.validationGeneration;
+        for (const [id, field] of fields) {
+            const current = state.fields.find((candidate) => candidate.id === id);
+            if (current === undefined)
+                continue;
+            const validation = field.validate?.() ?? { valid: true, issues: [] };
+            if (!transition({
+                type: 'update-field',
+                id,
+                touched: current.touched,
+                dirty: current.dirty,
+                valid: validation.valid,
+                issues: validation.issues ?? [],
+            }))
+                return false;
+        }
+        return transition({
+            type: 'validation-completed',
+            trigger: 'submit',
+            intent: 'submission',
+            generation,
+        });
+    };
+    const move = (offset) => {
+        const available = [...fields.values()].filter((field) => isAvailable(field));
+        if (available.length === 0)
+            return false;
+        const index = available.findIndex((field) => field.id === currentFieldId);
+        const next = index < 0
+            ? available[0]
+            : available[(index + offset + available.length) % available.length];
+        return setCurrent(next.id);
+    };
+    const registerField = (field) => {
+        const previous = fields.get(field.id);
+        fields.set(field.id, field);
+        transition({ type: 'register-field', field: toFieldInput(field) });
+        transition({ type: 'reorder-fields', ids: [...fields.keys()] });
+        if (currentFieldId === null && isAvailable(field))
+            setCurrent(field.id);
+        return () => {
+            if (fields.get(field.id) !== field)
+                return;
+            if (previous === undefined)
+                fields.delete(field.id);
+            else
+                fields.set(field.id, previous);
+            transition(previous === undefined
+                ? { type: 'unregister-field', id: field.id }
+                : { type: 'register-field', field: toFieldInput(previous) });
+            if (currentFieldId === field.id) {
+                setCurrent(resolveInitialField(fields, null));
+            }
+        };
+    };
+    const connection = {
+        get state() { return state; },
+        get currentFieldId() { return currentFieldId; },
+        get summaryIssues() { return summaryIssues; },
+        getSnapshot: snapshot,
+        registerField,
+        refreshField,
+        focusField: setCurrent,
+        handleKeyboardInput: (input) => {
+            if (input.key === 'down' || input.key === 'right' || input.key === 'tab') {
+                return move(input.shiftKey === true ? -1 : 1);
+            }
+            if (input.key === 'up' || input.key === 'left' || input.key === 'shift-tab') {
+                return move(-1);
+            }
+            if (input.key === 'home') {
+                return setCurrent(resolveInitialField(fields, null));
+            }
+            if (input.key === 'end') {
+                const available = [...fields.values()].filter((field) => isAvailable(field));
+                return setCurrent(available.at(-1)?.id ?? null);
+            }
+            if (input.key === 'enter' || input.key === 'submit')
+                return connection.submit();
+            if (input.key === 'reset')
+                return connection.reset();
+            return false;
+        },
+        replaceIssues: (source, issues) => transition({ type: 'replace-issues', source, issues }),
+        submit: validateAllForSubmission,
+        submitStarted: () => {
+            const generation = state.submissionGeneration;
+            return transition({ type: 'submit-started', generation }) ? generation : null;
+        },
+        submitSucceeded: (generation) => transition({ type: 'submit-succeeded', generation }),
+        submitFailed: (generation, issues = []) => transition({ type: 'submit-failed', generation, issues }),
+        reset: () => {
+            summaryIssues = Object.freeze([]);
+            const reset = transition('reset');
+            if (reset)
+                setCurrent(resolveInitialField(fields, options.defaultCurrentFieldId ?? null));
+            return reset;
+        },
+        subscribe: (listener) => {
+            subscribers.add(listener);
+            return () => { subscribers.delete(listener); };
+        },
+        destroy: () => {
+            active = false;
+            fields.clear();
+            subscribers.clear();
+        },
+    };
+    return { ok: true, value: connection };
+}
+function toFieldInput(field) {
+    return {
+        id: field.id,
+        ...(field.name === undefined ? {} : { name: field.name }),
+        ...(field.touched === undefined ? {} : { touched: field.touched }),
+        ...(field.dirty === undefined ? {} : { dirty: field.dirty }),
+    };
+}
+function isAvailable(field) {
+    return field !== undefined && field.available !== false;
+}
+function resolveInitialField(fields, preferred) {
+    if (preferred !== null && isAvailable(fields.get(preferred)))
+        return preferred;
+    return [...fields.values()].find((field) => isAvailable(field))?.id ?? null;
+}
+//# sourceMappingURL=form.js.map

package/dist/form.js.map

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

package/dist/grid.d.ts

@@ -0,0 +1,47 @@
+import { type FacadeConnection } from './internal/facade.js';
+import type { Result, StableID } from '@sectile/core';
+import { type Grid, type GridEditMode, type GridEvent, type GridOptions as StructureGridOptions, type GridPolicies, type GridState } from '@sectile/core/grid';
+import type { RevisionSnapshot } from '@sectile/core/revision';
+import type { TerminalKeyboardInput } from './keyboard.js';
+export interface GridOptions<ID extends StableID = StableID> extends StructureGridOptions {
+    readonly rows: readonly (readonly (ID | null)[])[];
+    readonly value?: ID | null;
+    readonly defaultValue?: ID | null;
+    readonly highlightedValue?: ID | null;
+    readonly defaultHighlightedValue?: ID | null;
+    readonly editMode?: GridEditMode;
+    readonly defaultEditMode?: GridEditMode;
+    readonly policies?: GridPolicies<ID>;
+    readonly disabledItems?: readonly ID[];
+    readonly disabled?: boolean;
+    readonly readOnly?: boolean;
+    readonly onValueChange?: (value: ID | null) => void;
+    readonly onHighlightedValueChange?: (value: ID | null) => void;
+    readonly onEditModeChange?: (mode: GridEditMode) => void;
+    readonly onEditStart?: (id: ID) => void;
+    readonly onEditCommit?: (id: ID) => void;
+    readonly onEditCancel?: (id: ID) => void;
+    readonly onUpdate?: () => void;
+}
+export type GridValueChangeHandler<ID extends StableID = StableID> = NonNullable<GridOptions<ID>['onValueChange']>;
+export type GridHighlightedValueChangeHandler<ID extends StableID = StableID> = NonNullable<GridOptions<ID>['onHighlightedValueChange']>;
+export type GridEditModeChangeHandler<ID extends StableID = StableID> = NonNullable<GridOptions<ID>['onEditModeChange']>;
+export type GridEditStartHandler<ID extends StableID = StableID> = NonNullable<GridOptions<ID>['onEditStart']>;
+export type GridEditCommitHandler<ID extends StableID = StableID> = NonNullable<GridOptions<ID>['onEditCommit']>;
+export type GridEditCancelHandler<ID extends StableID = StableID> = NonNullable<GridOptions<ID>['onEditCancel']>;
+export type GridUpdateHandler<ID extends StableID = StableID> = NonNullable<GridOptions<ID>['onUpdate']>;
+export interface GridControlledValues<ID extends StableID = StableID> {
+    readonly value?: ID | null;
+    readonly highlightedValue?: ID | null;
+    readonly editMode?: GridEditMode;
+}
+export interface GridConnection<ID extends StableID = StableID> {
+    readonly grid: Grid<ID>;
+    getSnapshot(): RevisionSnapshot<GridState<ID>>;
+    syncControlledValues(values: GridControlledValues<ID>): Result<RevisionSnapshot<GridState<ID>>>;
+    handleEvent(event: GridEvent<ID>): boolean;
+    handleKeyboardInput(input: TerminalKeyboardInput): boolean;
+}
+export declare function createGridControl<ID extends StableID>(options: GridOptions<ID>): FacadeConnection<GridConnection<ID>>;
+export declare function tryCreateGridControl<ID extends StableID>(options: GridOptions<ID>): Result<FacadeConnection<GridConnection<ID>>>;
+//# sourceMappingURL=grid.d.ts.map

package/dist/grid.d.ts.map

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