@exponential_app/engine 0.0.0-stage → 0.1.1

package/dist/types/domain-contract/src/app-records.d.ts

@@ -0,0 +1,3148 @@
+/** The keys every record row carries; a kind's schema may not declare them. */
+export declare const APP_RECORD_ROW_KEYS: readonly string[];
+/** One synced `app_records` row as the host reads it. */
+export interface AppRecordRow {
+    id: string;
+    kind: string;
+    data: Record<string, unknown>;
+    createdBy: string | null;
+    /** VAPP-187: whose record it is (null/missing on a legacy row = `createdBy`). */
+    authorId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** VAPP-187: a record's AUTHOR (`authorId ?? createdBy`): whose record it
+ *  is, what `mine`/`user=` and the per-member views read. */
+export declare function recordAuthor(row: {
+    authorId?: string | null;
+    createdBy: string | null;
+}): string | null;
+/** VAPP-187 OWNERSHIP (fixture `ownership`): the default per-kind policy and
+ *  the server's refusal. */
+export declare const APP_RECORDS_OWNERSHIP: {
+    policy: Record<`update` | `delete`, `author` | `member`>;
+    refusal: string;
+};
+/** May `viewer` (with team `role`; null = not a member) `op` the record?
+ *  Policy `author` = the author or a team owner (`canChangeCases`). */
+export declare function canChangeRecord(row: {
+    authorId?: string | null;
+    createdBy: string | null;
+}, viewer: string | null, role: string | null, op?: `update` | `delete`): boolean;
+/** VAPP-188 ON-BEHALF (fixture `onBehalf`): who may name another member as
+ *  a write's author, and the server's refusals. */
+export declare const APP_RECORDS_ON_BEHALF: {
+    refusal: string;
+    notMember: string;
+};
+export type WriteAsVerdict = `ok` | `forbidden` | `notMember`;
+/** May `viewer` (team `role`; null = not a member) write a record as
+ *  `author` (null = as themself)? Another member = owners only, and the
+ *  author must be one of `members` (`writeAsCases`). */
+export declare function writeAsVerdict(viewer: string | null, role: string | null, author: string | null | undefined, members: readonly string[]): WriteAsVerdict;
+/** An imported record's author (`importCases`): absent, the importer or a
+ *  stranger to the team = the importer; another member = them when the
+ *  importer is an owner, else the importer too (VAPP-192: a member
+ *  importing a teammate's export keeps the rows as their own). */
+export declare function importAuthor(importer: string, role: string | null, author: string | null | undefined, members: readonly string[]): string;
+/** Settings → Apps → the app: "1,240 records", "1,240 of 25,000 records"
+ *  (max = the team's quota, null = unlimited), "No records". */
+export declare function recordsCountLabel(count: number, max: number | null): string;
+/** VAPP-159 PURGE: how long a deleted record (or a trashed app's record)
+ *  stays before the server hard-deletes it, and the rows per sweep. */
+export declare const APP_RECORDS_PURGE: {
+    retentionDays: number;
+    batch: number;
+};
+/** A record is due for the purge once its own `deleted_at` or its app's
+ *  trash stamp (`app_deleted_at`) is older than the retention. */
+export declare function appRecordPurgeDue(deletedAt: Date | null, appDeletedAt: Date | null, now: Date): boolean;
+export declare const APP_DATA_TAB: {
+    $comment: string;
+    copy: {
+        kindOption: string;
+        addRecord: string;
+        edit: string;
+        delete: string;
+        deleteTitle: string;
+        deleteBody: string;
+        by: string;
+        updated: string;
+        empty: string;
+        noKinds: string;
+        emptyTitle: string;
+        newTitle: string;
+        editTitle: string;
+        save: string;
+        cancel: string;
+        yes: string;
+        no: string;
+        none: string;
+        optional: string;
+        listHint: string;
+        author: string;
+        byFor: string;
+        file: string;
+        files: string;
+    };
+    columns: {
+        byWidth: number;
+        updatedWidth: number;
+        menuWidth: number;
+        minWidth: number;
+        typeWidths: {
+            date: number;
+            time: number;
+            "date-time": number;
+            number: number;
+            integer: number;
+            boolean: number;
+        };
+        gap: number;
+    };
+    placeholders: {
+        date: string;
+        time: string;
+        "date-time": string;
+    };
+    testIds: {
+        kind: string;
+        add: string;
+        row: string;
+        menu: string;
+        form: string;
+        save: string;
+        error: string;
+        history: string;
+        historyRow: string;
+        restore: string;
+    };
+    kindCases: ({
+        $why: string;
+        manifest: {
+            records: {
+                target: {
+                    schema: {
+                        type: string;
+                        properties: {};
+                    };
+                };
+                entry: {
+                    schema: {
+                        type: string;
+                        properties: {
+                            tags: {
+                                type: string;
+                                items: {
+                                    type: string;
+                                };
+                            };
+                            note: {
+                                type: string;
+                                maxLength: number;
+                            };
+                            hours: {
+                                type: string;
+                                minimum: number;
+                                maximum: number;
+                            };
+                            date: {
+                                type: string;
+                                format: string;
+                            };
+                            billable: {
+                                type: string;
+                            };
+                            kind: {
+                                type: string;
+                                enum: string[];
+                            };
+                            count: {
+                                type: string;
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+            };
+        };
+        rows: {
+            kind: string;
+        }[];
+        kinds: {
+            kind: string;
+            count: number;
+        }[];
+    } | {
+        $why: string;
+        manifest: {
+            records: {
+                entry: {
+                    schema: {
+                        type: string;
+                        properties: {
+                            tags: {
+                                type: string;
+                                items: {
+                                    type: string;
+                                };
+                            };
+                            note: {
+                                type: string;
+                                maxLength: number;
+                            };
+                            hours: {
+                                type: string;
+                                minimum: number;
+                                maximum: number;
+                            };
+                            date: {
+                                type: string;
+                                format: string;
+                            };
+                            billable: {
+                                type: string;
+                            };
+                            kind: {
+                                type: string;
+                                enum: string[];
+                            };
+                            count: {
+                                type: string;
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                target?: undefined;
+            };
+        };
+        rows: never[];
+        kinds: {
+            kind: string;
+            count: number;
+        }[];
+    } | {
+        $why: string;
+        manifest: {
+            records?: undefined;
+        };
+        rows: {
+            kind: string;
+        }[];
+        kinds: never[];
+    } | {
+        $why: string;
+        manifest: null;
+        rows: never[];
+        kinds: never[];
+    })[];
+    columnCases: ({
+        schema: {
+            type: string;
+            properties: {
+                tags: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                note: {
+                    type: string;
+                    maxLength: number;
+                };
+                hours: {
+                    type: string;
+                    minimum: number;
+                    maximum: number;
+                };
+                date: {
+                    type: string;
+                    format: string;
+                };
+                billable: {
+                    type: string;
+                };
+                kind: {
+                    type: string;
+                    enum: string[];
+                };
+                count: {
+                    type: string;
+                };
+                b?: undefined;
+                a?: undefined;
+            };
+            required: string[];
+        };
+        columns: string[];
+        $why?: undefined;
+    } | {
+        $why: string;
+        schema: {
+            type: string;
+            properties: {
+                b: {
+                    type: string;
+                };
+                a: {
+                    type: string;
+                };
+                tags?: undefined;
+                note?: undefined;
+                hours?: undefined;
+                date?: undefined;
+                billable?: undefined;
+                kind?: undefined;
+                count?: undefined;
+            };
+            required: string[];
+        };
+        columns: string[];
+    } | {
+        schema: {
+            type: string;
+            properties: {
+                tags?: undefined;
+                note?: undefined;
+                hours?: undefined;
+                date?: undefined;
+                billable?: undefined;
+                kind?: undefined;
+                count?: undefined;
+                b?: undefined;
+                a?: undefined;
+            };
+            required?: undefined;
+        };
+        columns: never[];
+        $why?: undefined;
+    })[];
+    rowsCases: {
+        $why: string;
+        kind: string;
+        rows: {
+            id: string;
+            kind: string;
+            updatedAt: string;
+        }[];
+        order: string[];
+    }[];
+    cellCases: ({
+        value: null;
+        text: string;
+        $why?: undefined;
+    } | {
+        $why: string;
+        text: string;
+        value?: undefined;
+    } | {
+        value: string;
+        text: string;
+        $why?: undefined;
+    } | {
+        value: number;
+        text: string;
+        $why?: undefined;
+    } | {
+        value: boolean;
+        text: string;
+        $why?: undefined;
+    } | {
+        value: string[];
+        text: string;
+        $why?: undefined;
+    } | {
+        value: (number | boolean)[];
+        text: string;
+        $why?: undefined;
+    } | {
+        value: {
+            a: number;
+        };
+        text: string;
+        $why?: undefined;
+    } | {
+        $why: string;
+        value: string;
+        text: string;
+    } | {
+        $why: string;
+        value: string[];
+        text: string;
+    })[];
+    formCases: ({
+        schema: {
+            type: string;
+            properties: {
+                tags: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                note: {
+                    type: string;
+                    maxLength: number;
+                };
+                hours: {
+                    type: string;
+                    minimum: number;
+                    maximum: number;
+                };
+                date: {
+                    type: string;
+                    format: string;
+                };
+                billable: {
+                    type: string;
+                };
+                kind: {
+                    type: string;
+                    enum: string[];
+                };
+                count: {
+                    type: string;
+                };
+                at?: undefined;
+                when?: undefined;
+                nums?: undefined;
+                amount?: undefined;
+                receipt?: undefined;
+                photos?: undefined;
+            };
+            required: string[];
+        };
+        fields: ({
+            name: string;
+            control: string;
+            required: boolean;
+            placeholder: string;
+            options?: undefined;
+            itemType?: undefined;
+        } | {
+            name: string;
+            control: string;
+            required: boolean;
+            placeholder?: undefined;
+            options?: undefined;
+            itemType?: undefined;
+        } | {
+            name: string;
+            control: string;
+            required: boolean;
+            options: string[];
+            placeholder?: undefined;
+            itemType?: undefined;
+        } | {
+            name: string;
+            control: string;
+            required: boolean;
+            itemType: string;
+            placeholder?: undefined;
+            options?: undefined;
+        })[];
+        $why?: undefined;
+    } | {
+        schema: {
+            type: string;
+            properties: {
+                at: {
+                    type: string;
+                    format: string;
+                };
+                when: {
+                    type: string;
+                    format: string;
+                };
+                nums: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                tags?: undefined;
+                note?: undefined;
+                hours?: undefined;
+                date?: undefined;
+                billable?: undefined;
+                kind?: undefined;
+                count?: undefined;
+                amount?: undefined;
+                receipt?: undefined;
+                photos?: undefined;
+            };
+            required?: undefined;
+        };
+        fields: ({
+            name: string;
+            control: string;
+            required: boolean;
+            placeholder: string;
+            itemType?: undefined;
+        } | {
+            name: string;
+            control: string;
+            required: boolean;
+            itemType: string;
+            placeholder?: undefined;
+        })[];
+        $why?: undefined;
+    } | {
+        $why: string;
+        schema: {
+            type: string;
+            properties: {
+                amount: {
+                    type: string;
+                };
+                receipt: {
+                    type: string;
+                    format: string;
+                };
+                photos: {
+                    type: string;
+                    items: {
+                        type: string;
+                        format: string;
+                    };
+                };
+                tags: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                note?: undefined;
+                hours?: undefined;
+                date?: undefined;
+                billable?: undefined;
+                kind?: undefined;
+                count?: undefined;
+                at?: undefined;
+                when?: undefined;
+                nums?: undefined;
+            };
+            required: string[];
+        };
+        fields: ({
+            name: string;
+            control: string;
+            required: boolean;
+            itemType?: undefined;
+        } | {
+            name: string;
+            control: string;
+            required: boolean;
+            itemType: string;
+        })[];
+    })[];
+    inputCases: ({
+        control: string;
+        value: string;
+        input: string;
+    } | {
+        control: string;
+        value: null;
+        input: string;
+    } | {
+        control: string;
+        value: number;
+        input: string;
+    } | {
+        control: string;
+        value: string[];
+        input: string;
+    } | {
+        control: string;
+        value: number[];
+        input: string;
+    } | {
+        control: string;
+        value: boolean;
+        input: boolean;
+    } | {
+        control: string;
+        value: null;
+        input: boolean;
+    })[];
+    parseCases: ({
+        $why: string;
+        schema: {
+            type: string;
+            properties: {
+                tags: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                note: {
+                    type: string;
+                    maxLength: number;
+                };
+                hours: {
+                    type: string;
+                    minimum: number;
+                    maximum: number;
+                };
+                date: {
+                    type: string;
+                    format: string;
+                };
+                billable: {
+                    type: string;
+                };
+                kind: {
+                    type: string;
+                    enum: string[];
+                };
+                count: {
+                    type: string;
+                };
+                nums?: undefined;
+                flags?: undefined;
+            };
+            required: string[];
+        };
+        editing: boolean;
+        inputs: {
+            date: string;
+            hours: string;
+            billable: boolean;
+            count: string;
+            kind: string;
+            note: string;
+            tags: string;
+            nums?: undefined;
+            flags?: undefined;
+        };
+        data: {
+            date: string;
+            hours: number;
+            billable: boolean;
+            note: string;
+            tags: string[];
+            count?: undefined;
+            kind?: undefined;
+            nums?: undefined;
+            flags?: undefined;
+        };
+    } | {
+        $why: string;
+        schema: {
+            type: string;
+            properties: {
+                tags: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                note: {
+                    type: string;
+                    maxLength: number;
+                };
+                hours: {
+                    type: string;
+                    minimum: number;
+                    maximum: number;
+                };
+                date: {
+                    type: string;
+                    format: string;
+                };
+                billable: {
+                    type: string;
+                };
+                kind: {
+                    type: string;
+                    enum: string[];
+                };
+                count: {
+                    type: string;
+                };
+                nums?: undefined;
+                flags?: undefined;
+            };
+            required: string[];
+        };
+        editing: boolean;
+        inputs: {
+            date: string;
+            hours: string;
+            billable: boolean;
+            count: string;
+            kind: string;
+            note: string;
+            tags: string;
+            nums?: undefined;
+            flags?: undefined;
+        };
+        data: {
+            date: string;
+            hours: number;
+            billable: boolean;
+            count: null;
+            kind: string;
+            note: null;
+            tags: null;
+            nums?: undefined;
+            flags?: undefined;
+        };
+    } | {
+        $why: string;
+        schema: {
+            type: string;
+            properties: {
+                tags: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                note: {
+                    type: string;
+                    maxLength: number;
+                };
+                hours: {
+                    type: string;
+                    minimum: number;
+                    maximum: number;
+                };
+                date: {
+                    type: string;
+                    format: string;
+                };
+                billable: {
+                    type: string;
+                };
+                kind: {
+                    type: string;
+                    enum: string[];
+                };
+                count: {
+                    type: string;
+                };
+                nums?: undefined;
+                flags?: undefined;
+            };
+            required: string[];
+        };
+        editing: boolean;
+        inputs: {
+            date: string;
+            hours: string;
+            billable: boolean;
+            count?: undefined;
+            kind?: undefined;
+            note?: undefined;
+            tags?: undefined;
+            nums?: undefined;
+            flags?: undefined;
+        };
+        data: {
+            hours: string;
+            billable: boolean;
+            date?: undefined;
+            note?: undefined;
+            tags?: undefined;
+            count?: undefined;
+            kind?: undefined;
+            nums?: undefined;
+            flags?: undefined;
+        };
+    } | {
+        $why: string;
+        schema: {
+            type: string;
+            properties: {
+                nums: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                flags: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                tags?: undefined;
+                note?: undefined;
+                hours?: undefined;
+                date?: undefined;
+                billable?: undefined;
+                kind?: undefined;
+                count?: undefined;
+            };
+            required?: undefined;
+        };
+        editing: boolean;
+        inputs: {
+            nums: string;
+            flags: string;
+            date?: undefined;
+            hours?: undefined;
+            billable?: undefined;
+            count?: undefined;
+            kind?: undefined;
+            note?: undefined;
+            tags?: undefined;
+        };
+        data: {
+            nums: (string | number)[];
+            flags: boolean[];
+            date?: undefined;
+            hours?: undefined;
+            billable?: undefined;
+            note?: undefined;
+            tags?: undefined;
+            count?: undefined;
+            kind?: undefined;
+        };
+    })[];
+    bylineCases: ({
+        name: string;
+        createdBy: string;
+        authorId: string;
+        names: {
+            u1: string;
+            u2: string;
+        };
+        fallback: string;
+        text: string;
+    } | {
+        name: string;
+        createdBy: string;
+        authorId: null;
+        names: {
+            u1: string;
+            u2: string;
+        };
+        fallback: string;
+        text: string;
+    } | {
+        name: string;
+        createdBy: null;
+        authorId: null;
+        names: {
+            u1: string;
+            u2: string;
+        };
+        fallback: string;
+        text: string;
+    })[];
+    authorOptionCases: {
+        users: {
+            id: string;
+            name: string;
+        }[];
+        order: string[];
+    }[];
+    formAuthorCases: ({
+        name: string;
+        viewer: string;
+        record: null;
+        picked: string;
+        default: string;
+        send: null;
+    } | {
+        name: string;
+        viewer: string;
+        record: null;
+        picked: string;
+        default: string;
+        send: string;
+    } | {
+        name: string;
+        viewer: string;
+        record: {
+            authorId: string;
+            createdBy: string;
+        };
+        picked: string;
+        default: string;
+        send: null;
+    } | {
+        name: string;
+        viewer: string;
+        record: {
+            authorId: string;
+            createdBy: string;
+        };
+        picked: string;
+        default: string;
+        send: string;
+    } | {
+        name: string;
+        viewer: string;
+        record: {
+            authorId: null;
+            createdBy: string;
+        };
+        picked: string;
+        default: string;
+        send: null;
+    } | {
+        name: string;
+        viewer: string;
+        record: {
+            authorId: null;
+            createdBy: null;
+        };
+        picked: string;
+        default: string;
+        send: string;
+    })[];
+};
+export declare const APP_DATA_COPY: {
+    kindOption: string;
+    addRecord: string;
+    edit: string;
+    delete: string;
+    deleteTitle: string;
+    deleteBody: string;
+    by: string;
+    updated: string;
+    empty: string;
+    noKinds: string;
+    emptyTitle: string;
+    newTitle: string;
+    editTitle: string;
+    save: string;
+    cancel: string;
+    yes: string;
+    no: string;
+    none: string;
+    optional: string;
+    listHint: string;
+    author: string;
+    byFor: string;
+    file: string;
+    files: string;
+};
+/** A kind's schema field (the SDK's JSON Schema subset, host/records.ts). */
+export interface DataField {
+    type: `string` | `number` | `integer` | `boolean` | `array`;
+    enum?: string[];
+    items?: {
+        type: `string` | `number` | `integer` | `boolean`;
+        format?: string;
+    };
+    format?: `date` | `date-time` | `time` | `attachment`;
+}
+/** VAPP-221: a field holding files (`format: "attachment"` on a string or
+ *  a list's string items): no form field, the app's FileUpload writes it. */
+export declare function isAttachmentField(field: DataField): boolean;
+export interface DataSchema {
+    type?: `object`;
+    properties: Record<string, DataField>;
+    required?: string[];
+}
+/** The head manifest's kinds, sorted by name, each with its live count
+ *  (`kindCases`); a row of an undeclared kind is ignored. */
+export declare function dataKinds(manifest: {
+    records?: Record<string, {
+        schema: DataSchema;
+    }>;
+} | null | undefined, rows: readonly {
+    kind: string;
+}[]): {
+    kind: string;
+    count: number;
+}[];
+/** The columns (`columnCases`): the `required` names in their order, then
+ *  every other property sorted by name (never the declaration order: a
+ *  host's JSON layer may lose it). */
+export declare function dataColumns(schema: DataSchema): string[];
+/** A kind's rows, `updatedAt` desc, ties by id (`rowsCases`). */
+export declare function dataRows<T extends {
+    id: string;
+    kind: string;
+    updatedAt: string;
+}>(rows: readonly T[], kind: string): T[];
+/** One cell's text (`cellCases`). */
+export declare function cellText(value: unknown): string;
+export type DataControl = `text` | `number` | `switch` | `select` | `list`;
+export interface DataFormField {
+    name: string;
+    control: DataControl;
+    required: boolean;
+    placeholder?: string;
+    options?: string[];
+    itemType?: `string` | `number` | `integer` | `boolean`;
+}
+/** The form's fields, in column order (`formCases`). */
+export declare function formFields(schema: DataSchema): DataFormField[];
+/** A stored value → the control's initial input (`inputCases`): a switch
+ *  takes a boolean, every other control text. */
+export declare function formInput(control: DataControl, value: unknown): string | boolean;
+/** The inputs → the record's data (`parseCases`): an empty field = null,
+ *  numbers and list items parse (unparsable stays the raw text, so the
+ *  server names it); CREATE omits the nulls, EDIT keeps them (null clears). */
+export declare function formData(schema: DataSchema, inputs: Record<string, string | boolean | undefined>, editing: boolean): Record<string, unknown>;
+/** A column's fixed width in px (`columns.typeWidths`), or null = it shares
+ *  the rest of the row. */
+export declare function columnWidth(field: DataField): number | null;
+/** VAPP-188: the `by` cell (`bylineCases`): the author's name (else
+ *  `fallback`, apps.json `copy.byAgent`), `{writer} for {author}` when
+ *  someone else with a name wrote it. */
+export declare function recordByline(row: {
+    authorId?: string | null;
+    createdBy: string | null;
+}, names: Readonly<Record<string, string>>, fallback: string): string;
+/** VAPP-188: the owner's Author picker, members by name (case-insensitive,
+ *  ties by id: `authorOptionCases`). */
+export declare function authorOptions<T extends {
+    id: string;
+    name: string;
+}>(users: readonly T[]): T[];
+/** VAPP-188: the picker's default (the record's author on edit, the viewer
+ *  on create) and what Save sends (`send`: the pick when it differs from
+ *  the record's author / the viewer, else null = omit; `formAuthorCases`). */
+export declare function formAuthor(viewer: string | null, record: {
+    authorId?: string | null;
+    createdBy: string | null;
+} | null, picked: string | null): {
+    default: string | null;
+    send: string | null;
+};
+export declare const APP_RECORD_HISTORY: {
+    $comment: string;
+    undoSeconds: number;
+    retentionDays: number;
+    batch: number;
+    historyLimit: number;
+    maxFields: number;
+    ops: string[];
+    vias: string[];
+    copy: {
+        history: string;
+        restore: string;
+        undo: string;
+        created: string;
+        deleted: string;
+        restored: string;
+        changed: string;
+        more: string;
+        saved: string;
+        empty: string;
+        undoCreate: string;
+        undoUpdate: string;
+        undoDelete: string;
+        undoBatch: string;
+        undoVerb: string;
+        undoThing: string;
+    };
+    stateCases: ({
+        name: string;
+        event: {
+            op: string;
+            before: null;
+            patch: {
+                hours: number;
+            };
+        };
+        state: {
+            hours: number;
+            note?: undefined;
+        };
+    } | {
+        name: string;
+        event: {
+            op: string;
+            before: {
+                hours: number;
+                note: string;
+            };
+            patch: {
+                hours: number;
+            };
+        };
+        state: {
+            hours: number;
+            note: string;
+        };
+    } | {
+        name: string;
+        event: {
+            op: string;
+            before: {
+                hours: number;
+                note?: undefined;
+            };
+            patch: null;
+        };
+        state: null;
+    })[];
+    inverseCases: ({
+        name: string;
+        event: {
+            op: string;
+            before: null;
+            patch: {
+                hours: number;
+            };
+        };
+        inverse: {
+            op: string;
+            data?: undefined;
+        };
+    } | {
+        name: string;
+        event: {
+            op: string;
+            before: {
+                hours: number;
+                note: string;
+            };
+            patch: {
+                hours: number;
+            };
+        };
+        inverse: {
+            op: string;
+            data: {
+                hours: number;
+                note: string;
+            };
+        };
+    } | {
+        name: string;
+        event: {
+            op: string;
+            before: {
+                hours: number;
+                note?: undefined;
+            };
+            patch: null;
+        };
+        inverse: {
+            op: string;
+            data: {
+                hours: number;
+                note?: undefined;
+            };
+        };
+    } | {
+        name: string;
+        event: {
+            op: string;
+            before: {
+                hours: number;
+                note?: undefined;
+            };
+            patch: {
+                hours: number;
+            };
+        };
+        inverse: {
+            op: string;
+            data: {
+                hours: number;
+                note?: undefined;
+            };
+        };
+    })[];
+    labelCases: ({
+        name: string;
+        event: {
+            op: string;
+            before: null;
+            patch: {
+                hours: number;
+                note?: undefined;
+                day?: undefined;
+                tags?: undefined;
+                e?: undefined;
+                d?: undefined;
+                c?: undefined;
+                b?: undefined;
+                a?: undefined;
+            };
+        };
+        label: string;
+    } | {
+        name: string;
+        event: {
+            op: string;
+            before: {
+                hours: number;
+                note?: undefined;
+                day?: undefined;
+                tags?: undefined;
+                a?: undefined;
+                b?: undefined;
+                c?: undefined;
+                d?: undefined;
+                e?: undefined;
+            };
+            patch: null;
+        };
+        label: string;
+    } | {
+        name: string;
+        event: {
+            op: string;
+            before: {
+                note: string;
+                hours: number;
+                day: string;
+                tags?: undefined;
+                a?: undefined;
+                b?: undefined;
+                c?: undefined;
+                d?: undefined;
+                e?: undefined;
+            };
+            patch: {
+                note: string;
+                hours: number;
+                day: string;
+                tags?: undefined;
+                e?: undefined;
+                d?: undefined;
+                c?: undefined;
+                b?: undefined;
+                a?: undefined;
+            };
+        };
+        label: string;
+    } | {
+        name: string;
+        event: {
+            op: string;
+            before: {
+                hours: number;
+                note?: undefined;
+                day?: undefined;
+                tags?: undefined;
+                a?: undefined;
+                b?: undefined;
+                c?: undefined;
+                d?: undefined;
+                e?: undefined;
+            };
+            patch: {
+                note: string;
+                hours?: undefined;
+                day?: undefined;
+                tags?: undefined;
+                e?: undefined;
+                d?: undefined;
+                c?: undefined;
+                b?: undefined;
+                a?: undefined;
+            };
+        };
+        label: string;
+    } | {
+        name: string;
+        event: {
+            op: string;
+            before: {
+                tags: string[];
+                hours?: undefined;
+                note?: undefined;
+                day?: undefined;
+                a?: undefined;
+                b?: undefined;
+                c?: undefined;
+                d?: undefined;
+                e?: undefined;
+            };
+            patch: {
+                tags: string[];
+                hours?: undefined;
+                note?: undefined;
+                day?: undefined;
+                e?: undefined;
+                d?: undefined;
+                c?: undefined;
+                b?: undefined;
+                a?: undefined;
+            };
+        };
+        label: string;
+    } | {
+        name: string;
+        event: {
+            op: string;
+            before: {
+                a: number;
+                b: number;
+                c: number;
+                d: number;
+                e: number;
+                hours?: undefined;
+                note?: undefined;
+                day?: undefined;
+                tags?: undefined;
+            };
+            patch: {
+                e: number;
+                d: number;
+                c: number;
+                b: number;
+                a: number;
+                hours?: undefined;
+                note?: undefined;
+                day?: undefined;
+                tags?: undefined;
+            };
+        };
+        label: string;
+    } | {
+        name: string;
+        event: {
+            op: string;
+            before: {
+                hours: number;
+                note?: undefined;
+                day?: undefined;
+                tags?: undefined;
+                a?: undefined;
+                b?: undefined;
+                c?: undefined;
+                d?: undefined;
+                e?: undefined;
+            };
+            patch: {
+                hours: number;
+                note?: undefined;
+                day?: undefined;
+                tags?: undefined;
+                e?: undefined;
+                d?: undefined;
+                c?: undefined;
+                b?: undefined;
+                a?: undefined;
+            };
+        };
+        label: string;
+    })[];
+    rowsCases: ({
+        name: string;
+        names: {
+            u1: string;
+            u2: string;
+        };
+        fallback: string;
+        events: ({
+            id: string;
+            op: string;
+            actor: string;
+            before: null;
+            patch: {
+                hours: number;
+            };
+            createdAt: string;
+        } | {
+            id: string;
+            op: string;
+            actor: string;
+            before: {
+                hours: number;
+            };
+            patch: null;
+            createdAt: string;
+        } | {
+            id: string;
+            op: string;
+            actor: string;
+            before: {
+                hours: number;
+            };
+            patch: {
+                hours: number;
+            };
+            createdAt: string;
+        })[];
+        rows: {
+            id: string;
+            label: string;
+            who: string;
+            at: string;
+            restorable: boolean;
+        }[];
+    } | {
+        name: string;
+        names: {
+            u1?: undefined;
+            u2?: undefined;
+        };
+        fallback: string;
+        events: never[];
+        rows: never[];
+    })[];
+};
+export declare const APP_HISTORY_COPY: {
+    history: string;
+    restore: string;
+    undo: string;
+    created: string;
+    deleted: string;
+    restored: string;
+    changed: string;
+    more: string;
+    saved: string;
+    empty: string;
+    undoCreate: string;
+    undoUpdate: string;
+    undoDelete: string;
+    undoBatch: string;
+    undoVerb: string;
+    undoThing: string;
+};
+export type RecordEventOp = `create` | `update` | `delete` | `restore`;
+export type RecordEventVia = `editor` | `app` | `mcp` | `action` | `import` | `migration` | `share:${string}`;
+/** The part of an event the pure rules read. */
+export interface RecordEventCore {
+    op: RecordEventOp;
+    before: Record<string, unknown> | null;
+    patch: Record<string, unknown> | null;
+}
+/** One event as `apps.records.history` returns it (newest first). */
+export interface RecordEvent extends RecordEventCore {
+    id: string;
+    actor: string | null;
+    createdAt: string;
+    /** VAPP-241: `share:<name>` = a guest's submission (app-share.json). */
+    via?: string;
+}
+/** The write that undoes an event: a delete, or a restore of `data`. */
+export type InverseWrite = {
+    op: `delete`;
+} | {
+    op: `restore`;
+    data: Record<string, unknown>;
+};
+/** The record an event left (`stateCases`): null = gone. */
+export declare function eventState(event: RecordEventCore): Record<string, unknown> | null;
+/** Undo = a new write of the event's `before` (`inverseCases`). */
+export declare function inverseWrite(event: RecordEventCore): InverseWrite;
+/** Deep JSON equality (objects by key, numbers by value). */
+export declare function jsonEqual(a: unknown, b: unknown): boolean;
+/** A History row's title (`labelCases`). */
+export declare function eventLabel(event: RecordEventCore): string;
+export interface HistoryRow {
+    id: string;
+    label: string;
+    who: string;
+    at: string;
+    restorable: boolean;
+}
+/** The History list (`rowsCases`): the events in the server's order (newest
+ *  first); Restore on every row but the newest, never on a delete. */
+export declare function historyRows(events: readonly RecordEvent[], names: Readonly<Record<string, string>>, fallback: string): HistoryRow[];
+/** The Undo toast's title for a UI write. */
+export declare function undoTitle(write: `create` | `update` | `delete` | `batch`): string;
+export declare const APP_RECORDS_OUTBOX: {
+    $comment: string;
+    ackGraceSeconds: number;
+    retryCodes: string[];
+    copy: {
+        pendingOne: string;
+        pending: string;
+    };
+    writesCases: ({
+        name: string;
+        call: string;
+        args: {
+            kind: string;
+            data: {
+                hours: number;
+            };
+            id?: undefined;
+            writes?: undefined;
+        };
+        newIds: string[];
+        writes: {
+            op: string;
+            id: string;
+            kind: string;
+            data: {
+                hours: number;
+            };
+        }[];
+    } | {
+        name: string;
+        call: string;
+        args: {
+            kind: string;
+            data: {
+                hours: number;
+            };
+            id: string;
+            writes?: undefined;
+        };
+        newIds: never[];
+        writes: {
+            op: string;
+            id: string;
+            kind: string;
+            data: {
+                hours: number;
+            };
+        }[];
+    } | {
+        name: string;
+        call: string;
+        args: {
+            id: string;
+            kind?: undefined;
+            data?: undefined;
+            writes?: undefined;
+        };
+        newIds: never[];
+        writes: {
+            op: string;
+            id: string;
+        }[];
+    } | {
+        name: string;
+        call: string;
+        args: {
+            writes: ({
+                op: string;
+                kind: string;
+                data: {
+                    hours: number;
+                    note?: undefined;
+                };
+                id?: undefined;
+            } | {
+                op: string;
+                kind: string;
+                data: {
+                    note: string;
+                    hours?: undefined;
+                };
+                id: string;
+            } | {
+                op: string;
+                id: string;
+                kind?: undefined;
+                data?: undefined;
+            })[];
+            kind?: undefined;
+            data?: undefined;
+            id?: undefined;
+        };
+        newIds: string[];
+        writes: ({
+            op: string;
+            id: string;
+            kind: string;
+            data: {
+                hours: number;
+                note?: undefined;
+            };
+        } | {
+            op: string;
+            id: string;
+            kind: string;
+            data: {
+                note: string;
+                hours?: undefined;
+            };
+        } | {
+            op: string;
+            id: string;
+            kind?: undefined;
+            data?: undefined;
+        })[];
+    } | {
+        name: string;
+        call: string;
+        args: {
+            kind: string;
+            data?: undefined;
+            id?: undefined;
+            writes?: undefined;
+        };
+        newIds: string[];
+        writes: {
+            op: string;
+            id: string;
+            kind: string;
+            data: {};
+        }[];
+    })[];
+    requestCases: ({
+        name: string;
+        entry: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+        };
+        request: {
+            call: string;
+            input: {
+                kind: string;
+                data: {
+                    hours: number;
+                };
+                newId: string;
+                writeId: string;
+                recordId?: undefined;
+                writes?: undefined;
+            };
+        };
+    } | {
+        name: string;
+        entry: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+        };
+        request: {
+            call: string;
+            input: {
+                kind: string;
+                data: {
+                    hours: number;
+                };
+                recordId: string;
+                writeId: string;
+                newId?: undefined;
+                writes?: undefined;
+            };
+        };
+    } | {
+        name: string;
+        entry: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+            }[];
+            at: string;
+            state: string;
+        };
+        request: {
+            call: string;
+            input: {
+                recordId: string;
+                writeId: string;
+                kind?: undefined;
+                data?: undefined;
+                newId?: undefined;
+                writes?: undefined;
+            };
+        };
+    } | {
+        name: string;
+        entry: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: ({
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                    note?: undefined;
+                };
+            } | {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    note: string;
+                    hours?: undefined;
+                };
+            } | {
+                op: string;
+                id: string;
+                kind?: undefined;
+                data?: undefined;
+            })[];
+            at: string;
+            state: string;
+        };
+        request: {
+            call: string;
+            input: {
+                writes: ({
+                    op: string;
+                    kind: string;
+                    data: {
+                        hours: number;
+                        note?: undefined;
+                    };
+                    newId: string;
+                    id?: undefined;
+                } | {
+                    op: string;
+                    kind: string;
+                    data: {
+                        note: string;
+                        hours?: undefined;
+                    };
+                    id: string;
+                    newId?: undefined;
+                } | {
+                    op: string;
+                    id: string;
+                    kind?: undefined;
+                    data?: undefined;
+                    newId?: undefined;
+                })[];
+                writeId: string;
+                kind?: undefined;
+                data?: undefined;
+                newId?: undefined;
+                recordId?: undefined;
+            };
+        };
+    })[];
+    rowsCases: ({
+        name: string;
+        me: string;
+        rows: {
+            id: string;
+            kind: string;
+            data: {
+                hours: number;
+            };
+            createdBy: string;
+            authorId: string;
+            createdAt: string;
+            updatedAt: string;
+        }[];
+        entries: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+        }[];
+        expected: {
+            id: string;
+            kind: string;
+            data: {
+                hours: number;
+            };
+            createdBy: string;
+            authorId: string;
+            createdAt: string;
+            updatedAt: string;
+        }[];
+    } | {
+        name: string;
+        me: string;
+        rows: {
+            id: string;
+            kind: string;
+            data: {
+                hours: number;
+                note: string;
+            };
+            createdBy: string;
+            authorId: string;
+            createdAt: string;
+            updatedAt: string;
+        }[];
+        entries: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+        }[];
+        expected: {
+            id: string;
+            kind: string;
+            data: {
+                hours: number;
+                note: string;
+            };
+            createdBy: string;
+            authorId: string;
+            createdAt: string;
+            updatedAt: string;
+        }[];
+    } | {
+        name: string;
+        me: string;
+        rows: {
+            id: string;
+            kind: string;
+            data: {
+                hours: number;
+            };
+            createdBy: string;
+            authorId: string;
+            createdAt: string;
+            updatedAt: string;
+        }[];
+        entries: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+            }[];
+            at: string;
+            state: string;
+        }[];
+        expected: {
+            id: string;
+            kind: string;
+            data: {
+                hours: number;
+            };
+            createdBy: string;
+            authorId: string;
+            createdAt: string;
+            updatedAt: string;
+        }[];
+    } | {
+        name: string;
+        me: string;
+        rows: never[];
+        entries: ({
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+        } | {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    note: string;
+                };
+            }[];
+            at: string;
+            state: string;
+        })[];
+        expected: ({
+            id: string;
+            kind: string;
+            data: {
+                hours: number;
+                note: string;
+            };
+            createdBy: string;
+            authorId: string;
+            createdAt: string;
+            updatedAt: string;
+        } | {
+            id: string;
+            kind: string;
+            data: {
+                hours: number;
+                note?: undefined;
+            };
+            createdBy: string;
+            authorId: string;
+            createdAt: string;
+            updatedAt: string;
+        })[];
+    } | {
+        name: string;
+        me: string;
+        rows: never[];
+        entries: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: ({
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            } | {
+                op: string;
+                id: string;
+                kind?: undefined;
+                data?: undefined;
+            })[];
+            at: string;
+            state: string;
+        }[];
+        expected: never[];
+    } | {
+        name: string;
+        me: string;
+        rows: {
+            id: string;
+            kind: string;
+            data: {
+                hours: number;
+            };
+            createdBy: string;
+            authorId: string;
+            createdAt: string;
+            updatedAt: string;
+        }[];
+        entries: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+            ackedAt: string;
+        }[];
+        expected: {
+            id: string;
+            kind: string;
+            data: {
+                hours: number;
+            };
+            createdBy: string;
+            authorId: string;
+            createdAt: string;
+            updatedAt: string;
+        }[];
+    })[];
+    outcomeCases: ({
+        name: string;
+        entry: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+        };
+        result: {
+            ok: boolean;
+            transport?: undefined;
+            code?: undefined;
+        };
+        outcome: string;
+    } | {
+        name: string;
+        entry: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+        };
+        result: {
+            transport: boolean;
+            ok?: undefined;
+            code?: undefined;
+        };
+        outcome: string;
+    } | {
+        name: string;
+        entry: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+        };
+        result: {
+            code: string;
+            ok?: undefined;
+            transport?: undefined;
+        };
+        outcome: string;
+    } | {
+        name: string;
+        entry: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+            }[];
+            at: string;
+            state: string;
+        };
+        result: {
+            code: string;
+            ok?: undefined;
+            transport?: undefined;
+        };
+        outcome: string;
+    } | {
+        name: string;
+        entry: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: string;
+                };
+            }[];
+            at: string;
+            state: string;
+        };
+        result: {
+            code: string;
+            ok?: undefined;
+            transport?: undefined;
+        };
+        outcome: string;
+    })[];
+    flushCases: ({
+        name: string;
+        now: string;
+        entries: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+        }[];
+        results: {
+            w1: {
+                ok: boolean;
+                transport?: undefined;
+                code?: undefined;
+            };
+            w2: {
+                ok: boolean;
+                code?: undefined;
+            };
+            w3?: undefined;
+        };
+        sent: string[];
+        refused: never[];
+        after: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+            ackedAt: string;
+        }[];
+    } | {
+        name: string;
+        now: string;
+        entries: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+        }[];
+        results: {
+            w1: {
+                transport: boolean;
+                ok?: undefined;
+                code?: undefined;
+            };
+            w2: {
+                ok: boolean;
+                code?: undefined;
+            };
+            w3?: undefined;
+        };
+        sent: string[];
+        refused: never[];
+        after: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+        }[];
+    } | {
+        name: string;
+        now: string;
+        entries: ({
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: string;
+                };
+            }[];
+            at: string;
+            state: string;
+        } | {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+            }[];
+            at: string;
+            state: string;
+        } | {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+        })[];
+        results: {
+            w1: {
+                code: string;
+                ok?: undefined;
+                transport?: undefined;
+            };
+            w2: {
+                code: string;
+                ok?: undefined;
+            };
+            w3: {
+                ok: boolean;
+            };
+        };
+        sent: string[];
+        refused: {
+            writeId: string;
+            verb: string;
+        }[];
+        after: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+            ackedAt: string;
+        }[];
+    } | {
+        name: string;
+        now: string;
+        entries: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+        }[];
+        results: {
+            w1: {
+                code: string;
+                ok?: undefined;
+                transport?: undefined;
+            };
+            w2?: undefined;
+            w3?: undefined;
+        };
+        sent: string[];
+        refused: never[];
+        after: never[];
+    } | {
+        name: string;
+        now: string;
+        entries: ({
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+            ackedAt: string;
+        } | {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+            }[];
+            at: string;
+            state: string;
+            ackedAt?: undefined;
+        })[];
+        results: {
+            w2: {
+                ok: boolean;
+                code?: undefined;
+            };
+            w1?: undefined;
+            w3?: undefined;
+        };
+        sent: string[];
+        refused: never[];
+        after: ({
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+            ackedAt: string;
+        } | {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+            }[];
+            at: string;
+            state: string;
+            ackedAt: string;
+        })[];
+    })[];
+    pruneCases: ({
+        name: string;
+        now: string;
+        rows: never[];
+        entries: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+        }[];
+        kept: string[];
+    } | {
+        name: string;
+        now: string;
+        rows: {
+            id: string;
+            kind: string;
+            data: {
+                hours: number;
+                note: null;
+            };
+            createdBy: string;
+            authorId: string;
+            createdAt: string;
+            updatedAt: string;
+        }[];
+        entries: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+            ackedAt: string;
+        }[];
+        kept: never[];
+    } | {
+        name: string;
+        now: string;
+        rows: {
+            id: string;
+            kind: string;
+            data: {
+                hours: number;
+            };
+            createdBy: string;
+            authorId: string;
+            createdAt: string;
+            updatedAt: string;
+        }[];
+        entries: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+            ackedAt: string;
+        }[];
+        kept: string[];
+    } | {
+        name: string;
+        now: string;
+        rows: never[];
+        entries: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+            }[];
+            at: string;
+            state: string;
+            ackedAt: string;
+        }[];
+        kept: never[];
+    })[];
+    pendingCases: ({
+        name: string;
+        entries: {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+            ackedAt: string;
+        }[];
+        appId: string;
+        label: null;
+    } | {
+        name: string;
+        entries: ({
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+                kind: string;
+                data: {
+                    hours: number;
+                };
+            }[];
+            at: string;
+            state: string;
+        } | {
+            writeId: string;
+            appId: string;
+            call: string;
+            writes: {
+                op: string;
+                id: string;
+            }[];
+            at: string;
+            state: string;
+        })[];
+        appId: string;
+        label: string;
+    })[];
+};
+export declare const APP_OUTBOX_COPY: {
+    pendingOne: string;
+    pending: string;
+};
+export type OutboxCall = `upsert` | `delete` | `batch`;
+export type OutboxWrite = {
+    op: `create` | `update`;
+    id: string;
+    kind: string;
+    data: Record<string, unknown>;
+} | {
+    op: `delete`;
+    id: string;
+};
+export interface OutboxEntry {
+    writeId: string;
+    appId: string;
+    call: OutboxCall;
+    writes: OutboxWrite[];
+    /** ISO time the write was made. */
+    at: string;
+    state: `pending` | `acked`;
+    ackedAt?: string | null;
+}
+/** A replay's answer: ok, no network, or the server's tRPC code. */
+export type OutboxResult = {
+    ok: true;
+} | {
+    transport: true;
+} | {
+    code: string;
+};
+export type OutboxOutcome = `done` | `retry` | `dropped` | `refused`;
+type Obj = Record<string, unknown>;
+/** A host call's writes (`writesCases`): a create takes the next client id. */
+export declare function outboxWrites(call: OutboxCall, args: Obj, newIds: readonly string[]): OutboxWrite[];
+/** The replay request of an entry (`requestCases`); the host adds the app. */
+export declare function outboxRequest(entry: OutboxEntry): {
+    call: OutboxCall;
+    input: Obj;
+};
+/** The visible rows: the synced rows with every entry laid over them, oldest
+ *  first (`rowsCases`). */
+export declare function outboxRows(rows: readonly AppRecordRow[], entries: readonly OutboxEntry[], me: string | null): AppRecordRow[];
+/** What a replay's answer does to its entry (`outcomeCases`). */
+export declare function outboxOutcome(entry: OutboxEntry, result: OutboxResult): OutboxOutcome;
+/** The failed-action toast's verb for a refused entry. */
+export declare function outboxVerb(entry: OutboxEntry): `save` | `delete`;
+/** One flush (`flushCases`): pending entries oldest first, one at a time;
+ *  a retry stops it; `results` = each write id's answer. */
+export declare function outboxFlush(entries: readonly OutboxEntry[], results: Record<string, OutboxResult>, now: string): {
+    sent: string[];
+    refused: {
+        writeId: string;
+        verb: `save` | `delete`;
+    }[];
+    after: OutboxEntry[];
+};
+/** Do the synced rows reflect an entry? */
+export declare function outboxReflected(entry: OutboxEntry, rows: readonly AppRecordRow[]): boolean;
+/** The entries that stay (`pruneCases`): pending ones, and acked ones the
+ *  rows don't reflect yet within the grace. */
+export declare function outboxPrune(entries: readonly OutboxEntry[], rows: readonly AppRecordRow[], now: string): OutboxEntry[];
+/** The header glyph's label for an app's pending entries (`pendingCases`);
+ *  null = no glyph. */
+export declare function outboxPendingLabel(entries: readonly OutboxEntry[], appId: string): string | null;
+export declare const APP_CSV_IMPORT: {
+    $comment: string;
+    maxRows: number;
+    previewRows: number;
+    issuesShown: number;
+    trueWords: string[];
+    falseWords: string[];
+    authorKeys: string[];
+    copy: {
+        importButton: string;
+        title: string;
+        placeholder: string;
+        chooseFile: string;
+        skip: string;
+        me: string;
+        column: string;
+        issue: string;
+        rowIssue: string;
+        moreIssues: string;
+        ready: string;
+        tooMany: string;
+        noRows: string;
+        importAction: string;
+        imported: string;
+    };
+    issues: {
+        notNumber: string;
+        notInteger: string;
+        notBoolean: string;
+        notDate: string;
+        slashDate: string;
+        notTime: string;
+        notDateTime: string;
+        notEnum: string;
+        notMember: string;
+        extraCells: string;
+    };
+    testIds: {
+        button: string;
+        dialog: string;
+        text: string;
+        file: string;
+        map: string;
+        author: string;
+        preview: string;
+        error: string;
+        confirm: string;
+    };
+    parseCases: {
+        name: string;
+        text: string;
+        header: string[];
+        rows: {
+            row: number;
+            cells: string[];
+        }[];
+    }[];
+    mapCases: ({
+        name: string;
+        fields: string[];
+        header: string[];
+        mapping: {
+            date: number;
+            hours: number;
+            note: number;
+            hoursbilled?: undefined;
+            issueRef?: undefined;
+            billable?: undefined;
+            stunden?: undefined;
+            groesse?: undefined;
+        };
+    } | {
+        name: string;
+        fields: string[];
+        header: string[];
+        mapping: {
+            date: number;
+            hours: number;
+            note?: undefined;
+            hoursbilled?: undefined;
+            issueRef?: undefined;
+            billable?: undefined;
+            stunden?: undefined;
+            groesse?: undefined;
+        };
+    } | {
+        name: string;
+        fields: string[];
+        header: string[];
+        mapping: {
+            hours: null;
+            date?: undefined;
+            note?: undefined;
+            hoursbilled?: undefined;
+            issueRef?: undefined;
+            billable?: undefined;
+            stunden?: undefined;
+            groesse?: undefined;
+        };
+    } | {
+        name: string;
+        fields: string[];
+        header: string[];
+        mapping: {
+            hours: number;
+            hoursbilled: number;
+            date?: undefined;
+            note?: undefined;
+            issueRef?: undefined;
+            billable?: undefined;
+            stunden?: undefined;
+            groesse?: undefined;
+        };
+    } | {
+        name: string;
+        fields: string[];
+        header: string[];
+        mapping: {
+            issueRef: number;
+            billable: number;
+            date?: undefined;
+            hours?: undefined;
+            note?: undefined;
+            hoursbilled?: undefined;
+            stunden?: undefined;
+            groesse?: undefined;
+        };
+    } | {
+        name: string;
+        fields: string[];
+        header: string[];
+        mapping: {
+            stunden: number;
+            groesse: null;
+            date?: undefined;
+            hours?: undefined;
+            note?: undefined;
+            hoursbilled?: undefined;
+            issueRef?: undefined;
+            billable?: undefined;
+        };
+    } | {
+        name: string;
+        fields: string[];
+        header: never[];
+        mapping: {
+            date: null;
+            hours?: undefined;
+            note?: undefined;
+            hoursbilled?: undefined;
+            issueRef?: undefined;
+            billable?: undefined;
+            stunden?: undefined;
+            groesse?: undefined;
+        };
+    })[];
+    authorColumnCases: ({
+        header: string[];
+        column: number;
+    } | {
+        header: string[];
+        column: null;
+    })[];
+    cellCases: ({
+        name: string;
+        field: {
+            type: string;
+            enum?: undefined;
+            format?: undefined;
+            items?: undefined;
+        };
+        cell: string;
+        value: null;
+        issue?: undefined;
+    } | {
+        name: string;
+        field: {
+            type: string;
+            enum?: undefined;
+            format?: undefined;
+            items?: undefined;
+        };
+        cell: string;
+        value: string;
+        issue?: undefined;
+    } | {
+        name: string;
+        field: {
+            type: string;
+            enum?: undefined;
+            format?: undefined;
+            items?: undefined;
+        };
+        cell: string;
+        value: number;
+        issue?: undefined;
+    } | {
+        name: string;
+        field: {
+            type: string;
+            enum?: undefined;
+            format?: undefined;
+            items?: undefined;
+        };
+        cell: string;
+        issue: string;
+        value?: undefined;
+    } | {
+        name: string;
+        field: {
+            type: string;
+            enum?: undefined;
+            format?: undefined;
+            items?: undefined;
+        };
+        cell: string;
+        value: boolean;
+        issue?: undefined;
+    } | {
+        name: string;
+        field: {
+            type: string;
+            enum: string[];
+            format?: undefined;
+            items?: undefined;
+        };
+        cell: string;
+        value: string;
+        issue?: undefined;
+    } | {
+        name: string;
+        field: {
+            type: string;
+            enum: string[];
+            format?: undefined;
+            items?: undefined;
+        };
+        cell: string;
+        issue: string;
+        value?: undefined;
+    } | {
+        name: string;
+        field: {
+            type: string;
+            format: string;
+            enum?: undefined;
+            items?: undefined;
+        };
+        cell: string;
+        value: string;
+        issue?: undefined;
+    } | {
+        name: string;
+        field: {
+            type: string;
+            format: string;
+            enum?: undefined;
+            items?: undefined;
+        };
+        cell: string;
+        issue: string;
+        value?: undefined;
+    } | {
+        name: string;
+        field: {
+            type: string;
+            items: {
+                type: string;
+            };
+            enum?: undefined;
+            format?: undefined;
+        };
+        cell: string;
+        value: string[];
+        issue?: undefined;
+    } | {
+        name: string;
+        field: {
+            type: string;
+            items: {
+                type: string;
+            };
+            enum?: undefined;
+            format?: undefined;
+        };
+        cell: string;
+        value: number[];
+        issue?: undefined;
+    } | {
+        name: string;
+        field: {
+            type: string;
+            items: {
+                type: string;
+            };
+            enum?: undefined;
+            format?: undefined;
+        };
+        cell: string;
+        issue: string;
+        value?: undefined;
+    } | {
+        name: string;
+        field: {
+            type: string;
+            items: {
+                type: string;
+            };
+            enum?: undefined;
+            format?: undefined;
+        };
+        cell: string;
+        value: null;
+        issue?: undefined;
+    })[];
+    rowsCases: ({
+        name: string;
+        schema: {
+            type: string;
+            properties: {
+                date: {
+                    type: string;
+                    format: string;
+                };
+                hours: {
+                    type: string;
+                };
+                note: {
+                    type: string;
+                };
+                kind: {
+                    type: string;
+                    enum: string[];
+                };
+                tags: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+            };
+            required: string[];
+        };
+        header: string[];
+        rows: {
+            row: number;
+            cells: string[];
+        }[];
+        mapping: {
+            date: number;
+            hours: number;
+            kind: number;
+            note: number;
+            tags: number;
+        };
+        records: ({
+            row: number;
+            data: {
+                date: string;
+                hours: number;
+                kind: string;
+                note: string;
+                tags: string[];
+            };
+            issues: never[];
+        } | {
+            row: number;
+            data: {
+                date: string;
+                kind: string;
+                hours?: undefined;
+                note?: undefined;
+                tags?: undefined;
+            };
+            issues: never[];
+        } | {
+            row: number;
+            data: {
+                note: string;
+                date?: undefined;
+                hours?: undefined;
+                kind?: undefined;
+                tags?: undefined;
+            };
+            issues: string[];
+        } | {
+            row: number;
+            data: {
+                date: string;
+                hours: number;
+                kind?: undefined;
+                note?: undefined;
+                tags?: undefined;
+            };
+            issues: never[];
+        })[];
+        author?: undefined;
+    } | {
+        name: string;
+        schema: {
+            type: string;
+            properties: {
+                date: {
+                    type: string;
+                    format: string;
+                };
+                hours: {
+                    type: string;
+                };
+                note: {
+                    type: string;
+                };
+                kind: {
+                    type: string;
+                    enum: string[];
+                };
+                tags: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+            };
+            required: string[];
+        };
+        header: string[];
+        rows: {
+            row: number;
+            cells: string[];
+        }[];
+        mapping: {
+            date: number;
+            hours: number;
+            note: null;
+            kind: null;
+            tags: null;
+        };
+        records: {
+            row: number;
+            data: {
+                date: string;
+                hours: number;
+            };
+            issues: string[];
+        }[];
+        author?: undefined;
+    } | {
+        name: string;
+        schema: {
+            type: string;
+            properties: {
+                date: {
+                    type: string;
+                    format: string;
+                };
+                hours: {
+                    type: string;
+                };
+                note: {
+                    type: string;
+                };
+                kind: {
+                    type: string;
+                    enum: string[];
+                };
+                tags: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+            };
+            required: string[];
+        };
+        header: string[];
+        rows: {
+            row: number;
+            cells: string[];
+        }[];
+        mapping: {
+            date: number;
+            hours: number;
+            kind: null;
+            note: null;
+            tags: null;
+        };
+        author: {
+            column: number;
+            importer: string;
+            members: {
+                id: string;
+                name: string;
+                email: string;
+            }[];
+        };
+        records: ({
+            row: number;
+            data: {
+                date: string;
+                hours: number;
+            };
+            issues: never[];
+            author: string;
+        } | {
+            row: number;
+            data: {
+                date: string;
+                hours: number;
+            };
+            issues: string[];
+            author?: undefined;
+        })[];
+    })[];
+};
+export declare const APP_CSV_COPY: {
+    importButton: string;
+    title: string;
+    placeholder: string;
+    chooseFile: string;
+    skip: string;
+    me: string;
+    column: string;
+    issue: string;
+    rowIssue: string;
+    moreIssues: string;
+    ready: string;
+    tooMany: string;
+    noRows: string;
+    importAction: string;
+    imported: string;
+};
+export interface CsvRow {
+    /** The record number (header = 1, blank lines counted). */
+    row: number;
+    cells: string[];
+}
+export interface CsvTable {
+    header: string[];
+    rows: CsvRow[];
+}
+/** RFC 4180 → the header + the data rows (`parseCases`). */
+export declare function csvParse(input: string): CsvTable;
+/** A name's matching key: lowercased, only ASCII a–z and 0–9. */
+export declare function csvKey(name: string): string;
+/** The first pick per field (`mapCases`): equal keys first, then the ONE
+ *  free column containing the field's key; a column maps at most once. */
+export declare function csvAutoMap(fields: readonly string[], header: readonly string[]): Record<string, number | null>;
+/** The owner's Author pick: the first column whose key is an `authorKeys` entry, else null (= Me). */
+export declare function csvAuthorColumn(header: readonly string[]): number | null;
+export type CsvCell = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    message: string;
+};
+/** One cell → the field's value (`cellCases`); empty = null. */
+export declare function csvCell(field: DataField, cell: string): CsvCell;
+export interface CsvMember {
+    id: string;
+    name: string;
+    email: string;
+}
+export interface CsvAuthor {
+    /** The Author column (null = every row is the importer's). */
+    column: number | null;
+    importer: string;
+    members: readonly CsvMember[];
+}
+export interface CsvRecord {
+    row: number;
+    data: Record<string, unknown>;
+    /** A member's id when the row is someone else's (an on-behalf write). */
+    author?: string;
+    issues: string[];
+}
+/** The rows → records + their issues (`rowsCases`), before the host's schema check. */
+export declare function csvRecords(schema: DataSchema, header: readonly string[], rows: readonly CsvRow[], mapping: Readonly<Record<string, number | null>>, author?: CsvAuthor): CsvRecord[];
+/** The preview's count line (`copy.ready`). */
+export declare function csvSummary(records: readonly {
+    issues: readonly string[];
+}[]): string;
+export {};