@fieldia/core 0.9.2 → 0.11.0

package/src/lib/record/rules.mjs.map

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

package/src/lib/record/run.d.mts

@@ -0,0 +1,169 @@
+import type { ActionStep, OpenStep, PanelSide } from '../format/actions.mjs';
+import type { Field } from '../format/field.mjs';
+import type { JsonValue } from '../format/json.mjs';
+import type { Tone } from '../format/layout.mjs';
+import { type ExpressionEnv } from '../expression/expression.mjs';
+import { type RecordId, type Values } from './values.mjs';
+/**
+ * The engine that runs steps — a button's, a moment's, or the app's own —
+ * against a form. Steps run in order; one whose `when` does not hold is
+ * passed over; the first that fails or is refused stops the rest, and the
+ * run's result says which and why. What the core cannot draw — a page opened,
+ * words said, a question asked — it asks of the host the viewer gives.
+ */
+/** A button pressed, or a `call` step run: what the app's `onAction` is handed. */
+export interface ActionRequest {
+    /** The button or stat button pressed; for a moment, `on.open`, `on.change.<field>`, `on.beforeSave`, `on.afterSave` or `on.show.<id>`; for `form.run`, the id it was given. */
+    id: string;
+    action: string;
+    params?: {
+        [key: string]: JsonValue;
+    };
+    recordId: RecordId | null;
+    values: Values;
+    /** The records chosen in a list, when the button belongs to one. */
+    recordIds?: RecordId[];
+}
+/**
+ * What the app may answer a call with. Nothing at all means go on. `values`
+ * are set as a `set` step sets them (no person's change); `say` is said;
+ * `open` runs as an `open` step would; `stop` stops the steps after it — with
+ * words, said to the person as a warning.
+ */
+export interface ActionResult {
+    values?: Values;
+    say?: string | {
+        message: string;
+        tone?: Tone;
+    };
+    open?: Omit<OpenStep, 'do' | 'when'>;
+    stop?: boolean | string;
+}
+/** What a button does that only the app can: handed over, and awaited. */
+export type OnAction = (request: ActionRequest) => void | ActionResult | Promise<void | ActionResult>;
+/** A page the host is asked to open: in a dialog over the form, a panel beside it, or in its place. */
+export interface OpenRequest {
+    /** The page's id, as the app's `pages` finds it. */
+    page: string;
+    /** One published version; left out, the latest. */
+    version?: number;
+    as: 'dialog' | 'panel' | 'page';
+    /** Where a panel comes from, when its step names a side: the end of the line unless told. */
+    side?: PanelSide;
+    /** The words over it; left out, the page's own title. */
+    title?: string;
+    /** The record to open; null for a new one. */
+    recordId?: RecordId | null;
+    /** What a new one starts with. */
+    values?: Values;
+}
+/** How an opened page ended: saved (or sent), or closed without. */
+export interface OpenResult {
+    saved: boolean;
+    /** The record it saved. */
+    recordId?: RecordId | null;
+    /** Its values, once saved. */
+    values?: Values;
+    /** The saved record's name, as its page's title field shows it: what a link set to it is labelled. */
+    label?: string;
+}
+/**
+ * The UI the core cannot draw, given by the viewer. Without one, a form says
+ * nothing, asks `FormOptions.confirm` (or goes on as though answered Yes), and
+ * cannot open, close or show a tab: those steps stop with reason `cannot`.
+ */
+export interface ActionHost {
+    open(request: OpenRequest): Promise<OpenResult>;
+    say(message: string, tone: Tone): void;
+    ask(message: string): Promise<boolean>;
+    /** Close the dialog or panel this form was opened in. */
+    close?(): void;
+    /** Show a tab by its id. The viewer then calls `form.shown(id)`, as for a tab a person picks. */
+    show?(target: string): void;
+}
+/**
+ * Why a run stopped: a check found problems (`check`), a question was
+ * answered No (`no`), a save was refused (`save`), the app said stop or threw
+ * (`app`), an opened page was closed without saving (`closed`), or the step
+ * could not run here — no host to open with, a field the page lacks
+ * (`cannot`).
+ */
+export type RunStop = 'check' | 'no' | 'save' | 'app' | 'closed' | 'cannot';
+/** How a run of steps ended. */
+export interface RunResult {
+    /** Every step ran, or was passed over by its `when`. */
+    done: boolean;
+    /**
+     * The place, among the steps run, of the one that stopped: for a step of
+     * an `open`'s `then`, the open step's place; for a button's `action`, one
+     * past its steps. Absent when a button's `confirm` was answered No.
+     */
+    stoppedAt?: number;
+    /** The step that stopped, wherever it was. */
+    step?: ActionStep;
+    reason?: RunStop;
+    /** Why, in words: the first problem found, the question, the save's or the app's words. */
+    message?: string;
+    /** What the app or the host threw, when that stopped it. */
+    error?: unknown;
+}
+/** What a run is for: the id calls carry, the records chosen in a list. */
+export interface RunContext {
+    id?: string;
+    recordIds?: RecordId[];
+}
+/** A step stopped: why, and which (a step of an `open`'s `then`, the deepest). */
+export interface Stopped {
+    reason: RunStop;
+    message?: string;
+    step?: ActionStep;
+    error?: unknown;
+}
+/** A run as it goes: its id, the records chosen, and the moments it was set off by — a moment one of them sets off again does not run. */
+export interface RunScope {
+    id: string;
+    recordIds?: RecordId[];
+    chain: readonly string[];
+}
+/** What a run reaches its form by: the form gives these. */
+export interface RunForm {
+    readonly fields: Readonly<Record<string, Field>>;
+    values(): Readonly<Values>;
+    recordId(): RecordId | null;
+    /** The values as expressions read them, and what else they read. */
+    reading(): {
+        context: Record<string, unknown>;
+        env: ExpressionEnv;
+    };
+    today(): string;
+    /** Write fields as a step does: worked out once, no person's change. Throws for a field the page lacks. */
+    write(values: Values): void;
+    addLine(field: string, values: Values): void;
+    check(fields: readonly string[] | undefined): Stopped | null;
+    save(chain: readonly string[]): Promise<Stopped | null>;
+    reset(): void;
+    /** Go to a wizard's step; `undefined` when the target is none of its steps (a tab). */
+    goTo(target: string, chain: readonly string[]): Stopped | null | undefined;
+    /** Run `show` of the host while `chain` is the run's, so a tab it shows knows who showed it. */
+    showing(chain: readonly string[], show: () => void): void;
+    host?: ActionHost;
+    confirm?: (message: string) => boolean | Promise<boolean>;
+    onAction?: OnAction;
+    /** The app answered a call. */
+    answered(request: ActionRequest, result: ActionResult | undefined): void;
+}
+export declare const DONE: RunResult;
+/** Steps run against one form. Expressions are read once and kept. */
+export declare function createRunner(form: RunForm): {
+    runSteps: (steps: readonly ActionStep[], scope: RunScope) => Promise<RunResult>;
+    ask: (message: string) => Promise<boolean>;
+};
+/**
+ * One run of each moment at a time. A moment set off by a step of its own
+ * run — or a run it set off — does not run. Set off while a run of it is
+ * going: `again` moments (open, change, show) run once more after it, with
+ * the values as they are then, however many times they were set off
+ * meanwhile; the others (beforeSave, afterSave) do not run — a save made
+ * meanwhile goes ahead without them, so nothing waits on itself.
+ */
+export declare function createMoments(run: (key: string, steps: readonly ActionStep[], chain: readonly string[]) => Promise<RunResult>): (key: string, steps: readonly ActionStep[] | undefined, chain: readonly string[], again: boolean) => Promise<RunResult>;

package/src/lib/record/run.d.ts

@@ -0,0 +1,169 @@
+import type { ActionStep, OpenStep, PanelSide } from '../format/actions';
+import type { Field } from '../format/field';
+import type { JsonValue } from '../format/json';
+import type { Tone } from '../format/layout';
+import { type ExpressionEnv } from '../expression/expression';
+import { type RecordId, type Values } from './values';
+/**
+ * The engine that runs steps — a button's, a moment's, or the app's own —
+ * against a form. Steps run in order; one whose `when` does not hold is
+ * passed over; the first that fails or is refused stops the rest, and the
+ * run's result says which and why. What the core cannot draw — a page opened,
+ * words said, a question asked — it asks of the host the viewer gives.
+ */
+/** A button pressed, or a `call` step run: what the app's `onAction` is handed. */
+export interface ActionRequest {
+    /** The button or stat button pressed; for a moment, `on.open`, `on.change.<field>`, `on.beforeSave`, `on.afterSave` or `on.show.<id>`; for `form.run`, the id it was given. */
+    id: string;
+    action: string;
+    params?: {
+        [key: string]: JsonValue;
+    };
+    recordId: RecordId | null;
+    values: Values;
+    /** The records chosen in a list, when the button belongs to one. */
+    recordIds?: RecordId[];
+}
+/**
+ * What the app may answer a call with. Nothing at all means go on. `values`
+ * are set as a `set` step sets them (no person's change); `say` is said;
+ * `open` runs as an `open` step would; `stop` stops the steps after it — with
+ * words, said to the person as a warning.
+ */
+export interface ActionResult {
+    values?: Values;
+    say?: string | {
+        message: string;
+        tone?: Tone;
+    };
+    open?: Omit<OpenStep, 'do' | 'when'>;
+    stop?: boolean | string;
+}
+/** What a button does that only the app can: handed over, and awaited. */
+export type OnAction = (request: ActionRequest) => void | ActionResult | Promise<void | ActionResult>;
+/** A page the host is asked to open: in a dialog over the form, a panel beside it, or in its place. */
+export interface OpenRequest {
+    /** The page's id, as the app's `pages` finds it. */
+    page: string;
+    /** One published version; left out, the latest. */
+    version?: number;
+    as: 'dialog' | 'panel' | 'page';
+    /** Where a panel comes from, when its step names a side: the end of the line unless told. */
+    side?: PanelSide;
+    /** The words over it; left out, the page's own title. */
+    title?: string;
+    /** The record to open; null for a new one. */
+    recordId?: RecordId | null;
+    /** What a new one starts with. */
+    values?: Values;
+}
+/** How an opened page ended: saved (or sent), or closed without. */
+export interface OpenResult {
+    saved: boolean;
+    /** The record it saved. */
+    recordId?: RecordId | null;
+    /** Its values, once saved. */
+    values?: Values;
+    /** The saved record's name, as its page's title field shows it: what a link set to it is labelled. */
+    label?: string;
+}
+/**
+ * The UI the core cannot draw, given by the viewer. Without one, a form says
+ * nothing, asks `FormOptions.confirm` (or goes on as though answered Yes), and
+ * cannot open, close or show a tab: those steps stop with reason `cannot`.
+ */
+export interface ActionHost {
+    open(request: OpenRequest): Promise<OpenResult>;
+    say(message: string, tone: Tone): void;
+    ask(message: string): Promise<boolean>;
+    /** Close the dialog or panel this form was opened in. */
+    close?(): void;
+    /** Show a tab by its id. The viewer then calls `form.shown(id)`, as for a tab a person picks. */
+    show?(target: string): void;
+}
+/**
+ * Why a run stopped: a check found problems (`check`), a question was
+ * answered No (`no`), a save was refused (`save`), the app said stop or threw
+ * (`app`), an opened page was closed without saving (`closed`), or the step
+ * could not run here — no host to open with, a field the page lacks
+ * (`cannot`).
+ */
+export type RunStop = 'check' | 'no' | 'save' | 'app' | 'closed' | 'cannot';
+/** How a run of steps ended. */
+export interface RunResult {
+    /** Every step ran, or was passed over by its `when`. */
+    done: boolean;
+    /**
+     * The place, among the steps run, of the one that stopped: for a step of
+     * an `open`'s `then`, the open step's place; for a button's `action`, one
+     * past its steps. Absent when a button's `confirm` was answered No.
+     */
+    stoppedAt?: number;
+    /** The step that stopped, wherever it was. */
+    step?: ActionStep;
+    reason?: RunStop;
+    /** Why, in words: the first problem found, the question, the save's or the app's words. */
+    message?: string;
+    /** What the app or the host threw, when that stopped it. */
+    error?: unknown;
+}
+/** What a run is for: the id calls carry, the records chosen in a list. */
+export interface RunContext {
+    id?: string;
+    recordIds?: RecordId[];
+}
+/** A step stopped: why, and which (a step of an `open`'s `then`, the deepest). */
+export interface Stopped {
+    reason: RunStop;
+    message?: string;
+    step?: ActionStep;
+    error?: unknown;
+}
+/** A run as it goes: its id, the records chosen, and the moments it was set off by — a moment one of them sets off again does not run. */
+export interface RunScope {
+    id: string;
+    recordIds?: RecordId[];
+    chain: readonly string[];
+}
+/** What a run reaches its form by: the form gives these. */
+export interface RunForm {
+    readonly fields: Readonly<Record<string, Field>>;
+    values(): Readonly<Values>;
+    recordId(): RecordId | null;
+    /** The values as expressions read them, and what else they read. */
+    reading(): {
+        context: Record<string, unknown>;
+        env: ExpressionEnv;
+    };
+    today(): string;
+    /** Write fields as a step does: worked out once, no person's change. Throws for a field the page lacks. */
+    write(values: Values): void;
+    addLine(field: string, values: Values): void;
+    check(fields: readonly string[] | undefined): Stopped | null;
+    save(chain: readonly string[]): Promise<Stopped | null>;
+    reset(): void;
+    /** Go to a wizard's step; `undefined` when the target is none of its steps (a tab). */
+    goTo(target: string, chain: readonly string[]): Stopped | null | undefined;
+    /** Run `show` of the host while `chain` is the run's, so a tab it shows knows who showed it. */
+    showing(chain: readonly string[], show: () => void): void;
+    host?: ActionHost;
+    confirm?: (message: string) => boolean | Promise<boolean>;
+    onAction?: OnAction;
+    /** The app answered a call. */
+    answered(request: ActionRequest, result: ActionResult | undefined): void;
+}
+export declare const DONE: RunResult;
+/** Steps run against one form. Expressions are read once and kept. */
+export declare function createRunner(form: RunForm): {
+    runSteps: (steps: readonly ActionStep[], scope: RunScope) => Promise<RunResult>;
+    ask: (message: string) => Promise<boolean>;
+};
+/**
+ * One run of each moment at a time. A moment set off by a step of its own
+ * run — or a run it set off — does not run. Set off while a run of it is
+ * going: `again` moments (open, change, show) run once more after it, with
+ * the values as they are then, however many times they were set off
+ * meanwhile; the others (beforeSave, afterSave) do not run — a save made
+ * meanwhile goes ahead without them, so nothing waits on itself.
+ */
+export declare function createMoments(run: (key: string, steps: readonly ActionStep[], chain: readonly string[]) => Promise<RunResult>): (key: string, steps: readonly ActionStep[] | undefined, chain: readonly string[], again: boolean) => Promise<RunResult>;