@adminiumjs/manifest 0.3.16 → 0.3.18-rc.0

package/dist/state-actions.d.ts

@@ -0,0 +1,185 @@
+/**
+ * STATE ACTIONS — the buttons of a generated record page.
+ *
+ * A table with states says which moves exist; its `actions` say which of them
+ * (and what else) a person is offered on the row's own page, in the words the
+ * app or the add-on chooses: "Send", "Mark received", "Top up". Four forms:
+ *
+ *  - `move`  moves the row to a state, optionally asking for a few columns in
+ *            the confirm and setting others;
+ *  - `set`   writes columns and moves nothing ("Send again");
+ *  - `link`  opens another page for the row;
+ *  - `child` opens a small form that adds a row of a child table.
+ *
+ * `set` is always a key of the action itself. On a move or a set action it
+ * names columns of the row; on a child action, columns of the new child row.
+ *
+ * Pure. Nothing imported from the states file, which imports this one.
+ */
+import { z } from 'zod';
+import { type ReferenceIssue } from './refs.js';
+/** The most actions one table offers. */
+export declare const STATE_ACTIONS_MAX = 12;
+export declare const stateActionSchema: z.ZodUnion<readonly [z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+    move: z.ZodObject<{
+        to: z.ZodString;
+    }, z.core.$strict>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        primary: "primary";
+        neutral: "neutral";
+        danger: "danger";
+    }>>;
+    confirm: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+    set: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+        now: z.ZodLiteral<true>;
+    }, z.core.$strict>]>>>;
+    ask: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+    set: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+        now: z.ZodLiteral<true>;
+    }, z.core.$strict>]>>;
+    in: z.ZodArray<z.ZodString>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        primary: "primary";
+        neutral: "neutral";
+        danger: "danger";
+    }>>;
+    confirm: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+    ask: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+    link: z.ZodObject<{
+        page: z.ZodOptional<z.ZodString>;
+        addOnPage: z.ZodOptional<z.ZodString>;
+        param: z.ZodString;
+    }, z.core.$strict>;
+    in: z.ZodArray<z.ZodString>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        primary: "primary";
+        neutral: "neutral";
+        danger: "danger";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+    child: z.ZodObject<{
+        table: z.ZodString;
+        via: z.ZodString;
+        form: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    set: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    in: z.ZodArray<z.ZodString>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        primary: "primary";
+        neutral: "neutral";
+        danger: "danger";
+    }>>;
+    confirm: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+}, z.core.$strict>]>;
+export type StateAction = z.infer<typeof stateActionSchema>;
+export declare const stateActionsSchema: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+    move: z.ZodObject<{
+        to: z.ZodString;
+    }, z.core.$strict>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        primary: "primary";
+        neutral: "neutral";
+        danger: "danger";
+    }>>;
+    confirm: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+    set: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+        now: z.ZodLiteral<true>;
+    }, z.core.$strict>]>>>;
+    ask: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+    set: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+        now: z.ZodLiteral<true>;
+    }, z.core.$strict>]>>;
+    in: z.ZodArray<z.ZodString>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        primary: "primary";
+        neutral: "neutral";
+        danger: "danger";
+    }>>;
+    confirm: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+    ask: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+    link: z.ZodObject<{
+        page: z.ZodOptional<z.ZodString>;
+        addOnPage: z.ZodOptional<z.ZodString>;
+        param: z.ZodString;
+    }, z.core.$strict>;
+    in: z.ZodArray<z.ZodString>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        primary: "primary";
+        neutral: "neutral";
+        danger: "danger";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+    child: z.ZodObject<{
+        table: z.ZodString;
+        via: z.ZodString;
+        form: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    set: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    in: z.ZodArray<z.ZodString>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        primary: "primary";
+        neutral: "neutral";
+        danger: "danger";
+    }>>;
+    confirm: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+}, z.core.$strict>]>>;
+/** Which of the four an action is. */
+export declare function stateActionKind(action: StateAction): 'move' | 'set' | 'link' | 'child';
+interface ActionColumn {
+    ref: string;
+    type: string;
+    enum?: readonly string[] | undefined;
+    role?: string | undefined;
+    references?: string | undefined;
+    rules?: Readonly<Record<string, unknown>> | undefined;
+}
+/** What the checks read of the table the actions are on, and of the manifest around it. */
+export interface StateActionsContext {
+    table: string;
+    /** The states column, and the moves between its values. A move is a state's name, or an object with `to`. */
+    states: {
+        column: string;
+        moves: Readonly<Record<string, readonly unknown[]>>;
+        lock?: {
+            when: readonly string[];
+            except?: readonly string[] | undefined;
+        } | undefined;
+    };
+    column: (table: string, column: string) => ActionColumn | undefined;
+    hasTable: (table: string) => boolean;
+    /** Whether another rule already writes a column of the table. */
+    decided: (column: string) => boolean;
+    /** Why a column of the table is kept from readers, or null. */
+    keptFromReaders: (column: string) => string | null;
+    /** The manifest's generated page refs, and its code page refs when it is an add-on. */
+    pages: ReadonlySet<string>;
+    codePages: ReadonlySet<string>;
+}
+/**
+ * Everything wrong with a table's state actions: a move nobody may make by
+ * hand, a state that is none, a column that is not the row's to set, a child
+ * that is no child, a page that is none.
+ */
+export declare function stateActionIssues(actions: readonly StateAction[], ctx: StateActionsContext, at: (...rest: (string | number)[]) => (string | number)[]): ReferenceIssue[];
+export {};
+//# sourceMappingURL=state-actions.d.ts.map

package/dist/state-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-actions.d.ts","sourceRoot":"","sources":["../src/state-actions.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAmE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AASjH,yCAAyC;AACzC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAoD5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAIoG,CAAC;AAEpI,sCAAsC;AACtC,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAEtF;AAQD,UAAU,YAAY;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACvD;AAED,2FAA2F;AAC3F,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,6GAA6G;IAC7G,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE;YAAE,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;YAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;SAAE,GAAG,SAAS,CAAA;KAAE,CAAC;IACxK,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,YAAY,GAAG,SAAS,CAAC;IACpE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACrC,iEAAiE;IACjE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IACrC,+DAA+D;IAC/D,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACnD,uFAAuF;IACvF,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,EAAE,GAAG,EAAE,mBAAmB,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,cAAc,EAAE,CAsGxK"}

package/dist/state-actions.js

@@ -0,0 +1,223 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * STATE ACTIONS — the buttons of a generated record page.
+ *
+ * A table with states says which moves exist; its `actions` say which of them
+ * (and what else) a person is offered on the row's own page, in the words the
+ * app or the add-on chooses: "Send", "Mark received", "Top up". Four forms:
+ *
+ *  - `move`  moves the row to a state, optionally asking for a few columns in
+ *            the confirm and setting others;
+ *  - `set`   writes columns and moves nothing ("Send again");
+ *  - `link`  opens another page for the row;
+ *  - `child` opens a small form that adds a row of a child table.
+ *
+ * `set` is always a key of the action itself. On a move or a set action it
+ * names columns of the row; on a child action, columns of the new child row.
+ *
+ * Pure. Nothing imported from the states file, which imports this one.
+ */
+import { z } from 'zod';
+import { refSchema, scalarSchema, textOrLabels, valueFits, wordsOrLabels } from './refs.js';
+const kebab = z.string().regex(/^[a-z][a-z0-9-]{0,39}$/, 'a kebab-case id');
+const stateName = z.string().min(1).max(40);
+const tone = z.enum(['primary', 'neutral', 'danger']);
+const now = z.object({ now: z.literal(true) }).strict();
+const setRow = z.record(refSchema, z.union([scalarSchema, now]));
+const setChild = z.record(refSchema, scalarSchema);
+/** The most actions one table offers. */
+export const STATE_ACTIONS_MAX = 12;
+export const stateActionSchema = z.union([
+    z
+        .object({
+        id: kebab,
+        label: textOrLabels,
+        move: z.object({ to: stateName }).strict(),
+        tone: tone.optional(),
+        confirm: wordsOrLabels.optional(),
+        set: setRow.optional(),
+        /** Columns typed in the confirm, before the move is made. */
+        ask: z.array(refSchema).min(1).max(4).optional(),
+    })
+        .strict(),
+    z
+        .object({
+        id: kebab,
+        label: textOrLabels,
+        set: setRow,
+        in: z.array(stateName).min(1).max(16),
+        tone: tone.optional(),
+        confirm: wordsOrLabels.optional(),
+        ask: z.array(refSchema).min(1).max(4).optional(),
+    })
+        .strict(),
+    z
+        .object({
+        id: kebab,
+        label: textOrLabels,
+        /** A generated page of the manifest, or a code page (`<ref>`, or `<add-on key>:<ref>`), opened with the row's key as `param`. */
+        link: z
+            .object({
+            page: z.string().regex(/^[a-z][a-z0-9-]*$/, 'a page ref').optional(),
+            addOnPage: z.string().regex(/^([a-z][a-z0-9-]{1,79}:)?[a-z][a-z0-9-]*$/, '<ref>, or <add-on key>:<ref>').optional(),
+            param: z.string().regex(/^[a-z][a-z0-9_]{0,23}$/, 'a snake_case parameter name'),
+        })
+            .strict()
+            .refine((link) => (link.page === undefined) !== (link.addOnPage === undefined), { message: 'a link opens one page: "page" or "addOnPage"' }),
+        in: z.array(stateName).min(1).max(16),
+        tone: tone.optional(),
+    })
+        .strict(),
+    z
+        .object({
+        id: kebab,
+        label: textOrLabels,
+        child: z.object({ table: refSchema, via: refSchema, form: z.array(refSchema).max(6) }).strict(),
+        set: setChild.optional(),
+        in: z.array(stateName).min(1).max(16),
+        tone: tone.optional(),
+        confirm: wordsOrLabels.optional(),
+    })
+        .strict(),
+]);
+export const stateActionsSchema = z
+    .array(stateActionSchema)
+    .min(1)
+    .max(STATE_ACTIONS_MAX)
+    .refine((actions) => new Set(actions.map((action) => action.id)).size === actions.length, { message: 'two actions share an id' });
+/** Which of the four an action is. */
+export function stateActionKind(action) {
+    return 'move' in action ? 'move' : 'link' in action ? 'link' : 'child' in action ? 'child' : 'set';
+}
+/** Whether a fixed value is one the column holds; a date or a time is written as one (`2026-01-31`, never a word such as "@now"). */
+function fits(column, value) {
+    if (column.type === 'date' || column.type === 'timestamptz')
+        return typeof value === 'string' && /^\d{4}-\d{2}-\d{2}/.test(value) && !Number.isNaN(Date.parse(value));
+    return valueFits(column, value);
+}
+/**
+ * Everything wrong with a table's state actions: a move nobody may make by
+ * hand, a state that is none, a column that is not the row's to set, a child
+ * that is no child, a page that is none.
+ */
+export function stateActionIssues(actions, ctx, at) {
+    const out = [];
+    const { states, table } = ctx;
+    const target = (move) => (typeof move === 'string' ? move : String(move.to));
+    const planned = (move) => typeof move === 'object' && move !== null && move.planned === true;
+    const known = new Set(Object.keys(states.moves));
+    for (const moves of Object.values(states.moves))
+        for (const move of moves)
+            known.add(target(move));
+    /** The states a move to `to` may be made from by a person. */
+    const sources = (to) => Object.entries(states.moves).flatMap(([from, moves]) => (moves.some((move) => target(move) === to && !planned(move)) ? [from] : []));
+    actions.forEach((action, a) => {
+        const here = (...rest) => at('actions', a, ...rest);
+        const kind = stateActionKind(action);
+        // The states the action is offered in: where its move starts, or the ones it lists.
+        let offered;
+        if ('move' in action) {
+            offered = sources(action.move.to);
+            if (offered.length === 0) {
+                const only = Object.values(states.moves).some((moves) => moves.some((move) => target(move) === action.move.to));
+                out.push({
+                    path: here('move', 'to'),
+                    message: only
+                        ? `every move to "${action.move.to}" is planned, which only a ledger's own update makes: no button offers it`
+                        : `no listed move goes to "${action.move.to}": add it to "moves", from each state the button is offered in`,
+                });
+            }
+        }
+        else {
+            offered = action.in;
+            action.in.forEach((state, s) => {
+                if (!known.has(state))
+                    out.push({ path: here('in', s), message: `"${state}" is not a state of "${table}" (neither a key nor a target of "moves")` });
+            });
+        }
+        if (kind === 'move' || kind === 'set') {
+            const set = Object.keys(('set' in action ? action.set : undefined) ?? {});
+            const ask = ('ask' in action ? action.ask : undefined) ?? [];
+            for (const ref of ask)
+                if (set.includes(ref))
+                    out.push({ path: here('ask'), message: `"${ref}" is set by the action or asked for in its confirm, not both` });
+            // Where the table is locked in a state the action is offered in (or moves to), only what the lock leaves open is written.
+            const lock = states.lock;
+            const reaches = [...offered, ...('move' in action ? [action.move.to] : [])];
+            const locked = lock !== undefined && reaches.some((state) => lock.when.includes(state));
+            for (const [list, refs] of [['set', set], ['ask', ask]]) {
+                refs.forEach((ref) => {
+                    const path = list === 'set' ? here('set', ref) : here('ask');
+                    const found = ctx.column(table, ref);
+                    if (found === undefined) {
+                        out.push({ path, message: `"${table}" has no column "${ref}"` });
+                        return;
+                    }
+                    if (ref === states.column)
+                        out.push({ path, message: `"${ref}" is the state itself: a move sets it, an action's "${list}" never does` });
+                    else if (found.role === 'pk')
+                        out.push({ path, message: `"${table}.${ref}" is the row's key` });
+                    // A stamp the write itself does not trigger is still the row's own column to set.
+                    else if (ctx.decided(ref) && !(found.rules?.['stamp'] !== undefined && Object.keys(found.rules).length === 1))
+                        out.push({ path, message: `"${table}.${ref}" is decided by Adminium: an action cannot ${list === 'set' ? 'set' : 'ask for'} it` });
+                    if (list === 'ask') {
+                        const kept = ctx.keptFromReaders(ref);
+                        const hidden = found.rules?.['code']?.hiddenFromStaff === true;
+                        if (found.rules?.['secret'] === true || hidden || kept === 'a secret')
+                            out.push({ path, message: `"${table}.${ref}" is kept from staff: no confirm asks for it` });
+                    }
+                    if (list === 'set') {
+                        const value = action.set[ref];
+                        if (typeof value === 'object' && value !== null) {
+                            if (found.type !== 'timestamptz')
+                                out.push({ path, message: `{"now": true} is the moment the action is made: "${table}.${ref}" is ${found.type}, not a timestamptz` });
+                        }
+                        else if (!fits(found, value))
+                            out.push({ path, message: `${JSON.stringify(value)} is not a value "${table}.${ref}" takes` });
+                    }
+                    if (locked && !(lock?.except ?? []).includes(ref)) {
+                        out.push({ path, message: `"${table}" is locked in ${lock.when.filter((state) => reaches.includes(state)).map((state) => `"${state}"`).join(', ')}, where this action is offered: add "${ref}" to lock.except, or the write is refused` });
+                    }
+                });
+            }
+            return;
+        }
+        if ('child' in action) {
+            const child = action.child;
+            if (!ctx.hasTable(child.table)) {
+                out.push({ path: here('child', 'table'), message: `"${child.table}" is not one of this manifest's tables` });
+                return;
+            }
+            const via = ctx.column(child.table, child.via);
+            if (via === undefined || via.type !== 'fk' || via.references !== table)
+                out.push({ path: here('child', 'via'), message: `"${child.table}.${child.via}" is not a foreign key to "${table}"` });
+            const set = Object.keys(action.set ?? {});
+            child.form.forEach((ref, f) => {
+                if (ref === child.via)
+                    out.push({ path: here('child', 'form', f), message: `"${ref}" links the new row to this one: the form never asks for it` });
+                else if (ctx.column(child.table, ref) === undefined)
+                    out.push({ path: here('child', 'form', f), message: `"${child.table}" has no column "${ref}"` });
+                else if (set.includes(ref))
+                    out.push({ path: here('child', 'form', f), message: `"${ref}" is set by the action or asked for in its form, not both` });
+            });
+            for (const ref of set) {
+                if (ref === child.via)
+                    out.push({ path: here('set', ref), message: `"${ref}" links the new row to this one: Adminium fills it` });
+                else if (ctx.column(child.table, ref) === undefined)
+                    out.push({ path: here('set', ref), message: `"${child.table}" has no column "${ref}"` });
+                else if (!fits(ctx.column(child.table, ref), action.set?.[ref]))
+                    out.push({ path: here('set', ref), message: `${JSON.stringify(action.set?.[ref])} is not a value "${child.table}.${ref}" takes` });
+            }
+            return;
+        }
+        // A link: a page of this manifest.
+        const link = action.link;
+        if (link.page !== undefined && !ctx.pages.has(link.page))
+            out.push({ path: here('link', 'page'), message: `"${link.page}" is not one of this manifest's pages` });
+        if (link.addOnPage !== undefined && !link.addOnPage.includes(':') && !ctx.codePages.has(link.addOnPage)) {
+            out.push({ path: here('link', 'addOnPage'), message: `"${link.addOnPage}" is not one of this add-on's own pages (addOn.pages): name another add-on's page as "<add-on key>:<ref>"` });
+        }
+    });
+    return out;
+}
+//# sourceMappingURL=state-actions.js.map

package/dist/state-actions.js.map

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

package/dist/states.d.ts

@@ -150,6 +150,7 @@ export declare const stateMoveSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObj
     roles: z.ZodOptional<z.ZodArray<z.ZodString>>;
     undo: z.ZodOptional<z.ZodLiteral<true>>;
     clears: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    planned: z.ZodOptional<z.ZodLiteral<true>>;
 }, z.core.$strict>]>;
 export type StateMove = z.infer<typeof stateMoveSchema>;
 export declare const stateChildSchema: z.ZodObject<{
@@ -351,6 +352,7 @@ export declare const statesSchema: z.ZodObject<{
         roles: z.ZodOptional<z.ZodArray<z.ZodString>>;
         undo: z.ZodOptional<z.ZodLiteral<true>>;
         clears: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        planned: z.ZodOptional<z.ZodLiteral<true>>;
     }, z.core.$strict>]>>>;
     lock: z.ZodOptional<z.ZodObject<{
         when: z.ZodArray<z.ZodString>;
@@ -452,6 +454,67 @@ export declare const statesSchema: z.ZodObject<{
             }, z.core.$strict>>>;
         }, z.core.$strict>;
     }, z.core.$strict>>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+        move: z.ZodObject<{
+            to: z.ZodString;
+        }, z.core.$strict>;
+        tone: z.ZodOptional<z.ZodEnum<{
+            primary: "primary";
+            neutral: "neutral";
+            danger: "danger";
+        }>>;
+        confirm: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+        set: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+            now: z.ZodLiteral<true>;
+        }, z.core.$strict>]>>>;
+        ask: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+        set: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+            now: z.ZodLiteral<true>;
+        }, z.core.$strict>]>>;
+        in: z.ZodArray<z.ZodString>;
+        tone: z.ZodOptional<z.ZodEnum<{
+            primary: "primary";
+            neutral: "neutral";
+            danger: "danger";
+        }>>;
+        confirm: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+        ask: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+        link: z.ZodObject<{
+            page: z.ZodOptional<z.ZodString>;
+            addOnPage: z.ZodOptional<z.ZodString>;
+            param: z.ZodString;
+        }, z.core.$strict>;
+        in: z.ZodArray<z.ZodString>;
+        tone: z.ZodOptional<z.ZodEnum<{
+            primary: "primary";
+            neutral: "neutral";
+            danger: "danger";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+        child: z.ZodObject<{
+            table: z.ZodString;
+            via: z.ZodString;
+            form: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        set: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        in: z.ZodArray<z.ZodString>;
+        tone: z.ZodOptional<z.ZodEnum<{
+            primary: "primary";
+            neutral: "neutral";
+            danger: "danger";
+        }>>;
+        confirm: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+    }, z.core.$strict>]>>>;
 }, z.core.$strict>;
 export type States = z.infer<typeof statesSchema>;
 /** A move written as a bare state is a move with nothing asked first. */
@@ -487,6 +550,9 @@ interface StatesContext<C extends ColumnShape> {
     lineOf?: ((table: string) => string | undefined) | undefined;
     /** The app's outbox table, whose rows move only by the outbox's own moves. */
     outboxTable?: string | undefined;
+    /** The manifest's generated page refs and, for an add-on, its code page refs: what a state action's link may open. */
+    pages?: ReadonlySet<string> | undefined;
+    codePages?: ReadonlySet<string> | undefined;
 }
 /** A column of the table as the judge of an undo's `clears` needs it. */
 export interface UndoColumn {

package/dist/states.d.ts.map

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

package/dist/states.js

@@ -70,6 +70,7 @@
  * state their rows were in.
  */
 import { z } from 'zod';
+import { stateActionIssues, stateActionsSchema } from './state-actions.js';
 import { momentIssues, momentOffsetSchema, momentSchema, refSchema, scalarSchema, valueFits, } from './refs.js';
 const stateName = z.string().min(1).max(64);
 const roleKey = z.string().regex(/^[a-z][a-z0-9-]*$/, 'a role key');
@@ -140,6 +141,12 @@ export const stateMoveSchema = z.union([
          * for that move only. Only on a move marked `undo`.
          */
         clears: z.array(refSchema).min(1).max(8).optional(),
+        /**
+         * The move is made only by a ledger's own planned update (an order
+         * received when its last line is in): no person and no role makes it,
+         * no button offers it, and no timed rule reaches it.
+         */
+        planned: z.literal(true).optional(),
     })
         .strict(),
 ]);
@@ -334,6 +341,8 @@ export const statesSchema = z
     effects: z.array(stateEffectSchema).min(1).max(8).optional(),
     /** What a new row must meet to be created (see {@link createRequiresSchema}). */
     create: createRequiresSchema.optional(),
+    /** The buttons a generated record page offers for a row (see `state-actions.ts`). */
+    actions: stateActionsSchema.optional(),
 })
     .strict();
 /** A move written as a bare state is a move with nothing asked first. */
@@ -437,6 +446,13 @@ export function statesIssues(table, states, ctx, at) {
                     out.push({ path: at('moves', from, m, 'roles'), message: `"${role}" is not one of the app's roles` });
                 }
             }
+            if (move.planned === true) {
+                // Made by a ledger's planned update alone: nothing a person does, so nothing a person's move carries.
+                if (move.undo === true)
+                    out.push({ path: at('moves', from, m, 'planned'), message: 'an undo is made by a person, a planned move by a ledger: a move is one or the other' });
+                if (move.roles !== undefined)
+                    out.push({ path: at('moves', from, m, 'roles'), message: 'a planned move is made by no role: take "roles" out' });
+            }
             // An undo takes back a listed move: the one from where it goes to where it starts.
             if (move.undo === true && !(states.moves[to] ?? []).some((back) => moveTarget(back) === from)) {
                 out.push({ path: at('moves', from, m, 'undo'), message: `no listed move goes from "${to}" to "${from}", so this move takes nothing back` });
@@ -565,6 +581,19 @@ export function statesIssues(table, states, ctx, at) {
             entry.in.forEach((state, s) => known(state, at('onlyLater', i, 'in', s)));
     });
     out.push(...conditionedMoveIssues(table, states, ctx, at, values));
+    // The buttons a record page offers: moves a person may make, columns that are the row's to set, a child that is one.
+    if (states.actions !== undefined) {
+        out.push(...stateActionIssues(states.actions, {
+            table,
+            states,
+            column: (of, ref) => index.column(of, ref),
+            hasTable: (of) => index.table(of) !== undefined,
+            decided: (ref) => ctx.decided?.(ref) === true,
+            keptFromReaders: (ref) => ctx.keptFromReaders?.(ref) ?? null,
+            pages: ctx.pages ?? new Set(),
+            codePages: ctx.codePages ?? new Set(),
+        }, at));
+    }
     return out;
 }
 /**
@@ -685,6 +714,8 @@ function conditionedMoveIssues(table, states, ctx, at, values) {
             out.push({ path: here('to'), message: `no listed move goes from "${timed.from}" to "${timed.to}"` });
         else if (typeof move === 'object' && move.undo === true)
             out.push({ path: here('to'), message: `the move from "${timed.from}" to "${timed.to}" is an undo, which only a person makes` });
+        else if (typeof move === 'object' && move.planned === true)
+            out.push({ path: here('to'), message: `the move from "${timed.from}" to "${timed.to}" is planned, which only a ledger's own update makes` });
         if ((states.timed ?? []).some((other, j) => j < i && other.from === timed.from)) {
             out.push({ path: here('from'), message: `another timed move already leaves "${timed.from}"` });
         }