@sectile/dom 0.2.0 → 0.3.0

package/dist/feed.js

@@ -0,0 +1,151 @@
+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 { setInteractionAttributes } from './internal/interaction.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 ?? options.setSize ?? 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 DOMFeed(options, model, runtime.value) }
+        : runtime;
+}
+class DOMFeed {
+    #options;
+    #model;
+    #runtime;
+    #elements = new Map();
+    #keydown;
+    constructor(options, model, runtime) {
+        this.#options = options;
+        this.#model = model;
+        this.#runtime = runtime;
+        this.#keydown = (event) => {
+            const semantic = event.key === 'ArrowDown' || event.key === 'PageDown'
+                ? 'next'
+                : event.key === 'ArrowUp' || event.key === 'PageUp' ? 'previous' : null;
+            if (semantic !== null) {
+                this.handleEvent(semantic);
+                event.preventDefault();
+            }
+        };
+        options.root.addEventListener('keydown', this.#keydown);
+        options.root.setAttribute('role', 'feed');
+        setInteractionAttributes(options.root, options);
+    }
+    getSnapshot() {
+        return this.#runtime.getSnapshot();
+    }
+    syncWindow(window) {
+        const items = tryCreateSequence(window.items);
+        if (!items.ok)
+            return items;
+        const state = synchronizeFeedWindow(items.value, this.getSnapshot().state, {
+            revision: window.revision,
+            ...(window.requestGeneration === undefined ? {} : { requestGeneration: window.requestGeneration }),
+            ...(window.start === undefined ? {} : { start: window.start }),
+            ...(window.total === undefined ? {} : { total: window.total }),
+            current: window.highlightedValue ?? resolveCurrent(items.value, this.getSnapshot().state.cursor.current),
+        });
+        if (!state.ok)
+            return state;
+        this.#model.value = items.value;
+        for (const [id, registration] of this.#elements) {
+            if (items.value.contains(id))
+                continue;
+            registration.element.removeEventListener('click', registration.click);
+            this.#elements.delete(id);
+        }
+        const result = this.#runtime.replace(state);
+        if (result.ok) {
+            this.#refresh();
+            this.#options.onUpdate?.();
+            this.focusCurrent();
+        }
+        return result;
+    }
+    setItemAttributes(element, id) {
+        if (!this.#model.value.contains(id))
+            return;
+        const previous = this.#elements.get(id);
+        if (previous !== undefined)
+            previous.element.removeEventListener('click', previous.click);
+        const click = () => { this.handleEvent({ type: 'focus', id }); };
+        element.addEventListener('click', click);
+        this.#elements.set(id, { element, click });
+        this.#refresh();
+    }
+    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);
+                }
+                else {
+                    this.#elements.get(command.id)?.element.focus();
+                }
+            }
+            this.#refresh();
+        }
+        this.#options.onUpdate?.();
+        this.focusCurrent();
+        return result.ok;
+    }
+    focusCurrent() {
+        queueMicrotask(() => {
+            const current = this.getSnapshot().state.cursor.current;
+            if (current === null)
+                this.#options.root.focus();
+            else
+                this.#elements.get(current)?.element.focus();
+        });
+    }
+    disconnect() {
+        this.#options.root.removeEventListener('keydown', this.#keydown);
+        for (const { element, click } of this.#elements.values()) {
+            element.removeEventListener('click', click);
+        }
+        this.#elements.clear();
+    }
+    #refresh() {
+        const current = this.getSnapshot().state.cursor.current;
+        if (this.#options.label !== undefined) {
+            this.#options.root.setAttribute('aria-label', this.#options.label);
+        }
+        for (const [id, { element }] of this.#elements) {
+            element.setAttribute('role', 'article');
+            if (this.#options.setSize !== undefined) {
+                element.setAttribute('aria-setsize', String(this.#options.setSize));
+            }
+            const position = this.#options.getPosition?.(id);
+            if (position !== undefined)
+                element.setAttribute('aria-posinset', String(position));
+            element.tabIndex = id === current ? 0 : -1;
+        }
+    }
+}
+function resolveCurrent(items, current) {
+    return current !== null && items.contains(current) ? current : items.at(0);
+}
+//# 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,82 @@
+import { type FormFieldPath, type FormIssue, type FormIssueSource, type FormState, type FormValidationIntent, type FormValidationTrigger, type FormValues } from '@sectile/core/form';
+import type { Result, StableID } from '@sectile/core';
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+export { appendFormFieldPath, createFormFieldPath, createFormRelativePath, encodeFormFieldPath, type FormFieldPath, type FormPathSegment, type FormRelativePath, } from '@sectile/core/form';
+export type { FormValues } from '@sectile/core/form';
+export interface FormValidationIssue {
+    readonly message: string;
+    readonly path?: FormFieldPath;
+}
+export interface FormValidationResult {
+    readonly issues?: readonly FormValidationIssue[];
+}
+export type FormSchema<Input = unknown, Output = Input> = StandardSchemaV1<Input, Output>;
+export type FormInteractionValidationTrigger = Exclude<FormValidationTrigger, 'submit'>;
+export interface FormValidateContext<ID extends StableID = StableID> {
+    readonly trigger: FormValidationTrigger;
+    readonly intent: FormValidationIntent;
+    readonly changedFieldId: ID | null;
+    readonly signal: AbortSignal;
+}
+export type FormValidateHandler<ID extends StableID = StableID, Values extends object = FormValues> = (values: Values, context: FormValidateContext<ID>) => FormValidationResult | PromiseLike<FormValidationResult>;
+export type FormFocusHandler = () => boolean | void;
+export type FormResetHandler = () => void;
+export type FormAnnounceSummaryHandler<ID extends StableID = StableID> = (issues: readonly FormIssue<ID>[]) => void;
+export type FormStateChangeHandler<ID extends StableID = StableID> = (state: FormState<ID>) => void;
+export type FormUpdateHandler = () => void;
+export type FormSubmissionElement = HTMLButtonElement | HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement;
+export interface FormParticipant<ID extends StableID = StableID> {
+    readonly id: ID;
+    readonly element: HTMLElement;
+    readonly semanticControl?: HTMLElement;
+    readonly focusTarget?: HTMLElement;
+    readonly submissionElements?: readonly FormSubmissionElement[];
+    readonly name?: FormFieldPath | null;
+    readonly focus?: FormFocusHandler;
+    readonly reset?: FormResetHandler;
+}
+export interface FormSubmitPayload<ID extends StableID = StableID, Values extends object = FormValues> {
+    readonly event: SubmitEvent;
+    readonly formData: FormData;
+    readonly values: Values;
+    readonly submitter: HTMLElement | null;
+    readonly state: FormState<ID>;
+}
+export type FormSubmitHandler<ID extends StableID = StableID, Values extends object = FormValues> = (payload: FormSubmitPayload<ID, Values>) => void;
+export interface FormSnapshot<ID extends StableID = StableID> {
+    readonly revision: number;
+    readonly state: FormState<ID>;
+}
+export type FormSnapshotListener<ID extends StableID = StableID> = (snapshot: FormSnapshot<ID>) => void;
+export interface FormOptions<ID extends StableID = StableID, Input extends object = FormValues, Output extends object = Input> {
+    readonly form: HTMLFormElement;
+    readonly summary?: HTMLElement;
+    readonly participants?: readonly FormParticipant<ID>[];
+    readonly issues?: readonly FormIssue<ID>[];
+    readonly schema?: FormSchema<Input, Output>;
+    readonly validate?: FormValidateHandler<ID, Input>;
+    readonly validateOn?: readonly FormInteractionValidationTrigger[];
+    readonly revalidateOn?: readonly FormInteractionValidationTrigger[];
+    readonly onSubmit?: FormSubmitHandler<ID, Output>;
+    readonly onReset?: FormResetHandler;
+    readonly onAnnounceSummary?: FormAnnounceSummaryHandler<ID>;
+    readonly onStateChange?: FormStateChangeHandler<ID>;
+    readonly onUpdate?: FormUpdateHandler;
+}
+export interface FormConnection<ID extends StableID = StableID> {
+    readonly state: FormState<ID>;
+    getSnapshot(): FormSnapshot<ID>;
+    getFormData(submitter?: HTMLElement | null): FormData;
+    registerParticipant(participant: FormParticipant<ID>): () => void;
+    refreshParticipant(id: ID): boolean;
+    replaceIssues(source: FormIssueSource, issues: readonly FormIssue<ID>[]): boolean;
+    submitStarted(): number | null;
+    submitSucceeded(generation: number): boolean;
+    submitFailed(generation: number, issues?: readonly FormIssue<ID>[]): boolean;
+    reset(): void;
+    subscribe(listener: FormSnapshotListener<ID>): () => void;
+    destroy(): void;
+}
+export declare function createForm<ID extends StableID = StableID, Input extends object = FormValues, Output extends object = Input>(options: FormOptions<ID, Input, Output>): FormConnection<ID>;
+export declare function tryCreateForm<ID extends StableID = StableID, Input extends object = FormValues, Output extends object = Input>(options: FormOptions<ID, Input, Output>): Result<FormConnection<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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"}