@fieldia/core 0.28.0 → 0.30.0

package/src/lib/format/layout.d.ts

@@ -950,9 +950,16 @@ export interface Statusbar {
  * that opens a departure wizard. The app's own report under Print is an
  * `action` whose answer hands the viewer its file (`ActionResult.file`): its
  * PDF shown over the record, or saved.
+ *
+ * An item with a `menu` of its own, or one the app gives (`menuFrom`), opens
+ * it beside it — "Templates ›" — rather than doing anything itself; a
+ * `divider` is a line between items, left out where nothing shows on one side
+ * of it.
  */
 export interface MenuItem {
     id: string;
+    /** A line between the items round it, with nothing else of its own: `{ "type": "divider", "id": "m-rule" }`. */
+    type?: 'divider';
     /** Its words; a built-in's own, in the page's language, when left out. */
     label?: string;
     /**
@@ -975,6 +982,19 @@ export interface MenuItem {
     icon?: string;
     invisible?: Modifier;
     roles?: Roles;
+    /**
+     * A menu of its own, opened beside it — by pointing at it, a press, Enter or
+     * the arrow toward it — its items pressed as this menu's are. With
+     * `menuFrom`, these come first.
+     */
+    menu?: MenuItem[];
+    /**
+     * Items the app gives as the menu opens — templates that depend on the
+     * record — by the app's action of this name: `onAction` is asked with it and
+     * this item's `params`, and answers `{ menu: [...] }`. Each is pressed as a
+     * page's item is: its steps, then its action, its `confirm` asked first.
+     */
+    menuFrom?: string;
 }
 /**
  * What sits over a record, around its sheet: the gear menu the page fills,
@@ -1223,6 +1243,13 @@ export interface ListNode {
      * counted as they change. Off unless true.
      */
     filterSheet?: boolean;
+    /**
+     * A search typed in plain words turned into filters — "villas in New Cairo under 15M" into Type: Villa, District:
+     * New Cairo, Price: up to 15,000,000 — by the data source's `searchToFilter` (the app's own model: Fieldia ships
+     * none): a ✦ button beside the search box while it holds words. Each filter made is shown, to take away as any, with
+     * the app's why and Undo, which puts the words back. Hidden where the source has no `searchToFilter`. Off unless true.
+     */
+    searchToFilter?: boolean;
     /** Rows nested under their parent by this many2one (to the list's own model), with Expand all and Collapse all in the header. */
     parentField?: string;
     /**
@@ -1304,6 +1331,32 @@ export interface ListNode {
      * that record alone, as a button for the rows chosen runs with them.
      */
     rowButtons?: ButtonNode[];
+    /**
+     * Its cells changed in place, as a price list or a week's hours are kept:
+     * a press on a cell, or Enter, opens it in its field's own box with its
+     * rules; Tab and Shift+Tab go from cell to cell, Escape puts back what it
+     * held; each row is saved through the data source as it is left, and one
+     * refused says why under it, the person's typing kept; a row is added at
+     * the end. `true`: every column a cell can change — of a kind a box in a
+     * cell takes, not read-only, not worked out; `fields`, those columns alone;
+     * `add: false`, no row added; `open: true`, an Open button on each row. A
+     * row whose source says this person may not change it (`can`) stays as it
+     * is. Off unless given.
+     */
+    editable?: boolean | ListEditable;
+}
+/** What a list changes in place (`ListNode.editable`). */
+export interface ListEditable {
+    /** The columns changed in place: every column a cell can change unless said. */
+    fields?: string[];
+    /** A row added at the end of the list, saved once it is left; unless false. */
+    add?: boolean;
+    /**
+     * An Open button at each row's end, where the app opens records (`onOpenRecord`), as Flectra's `open_form_view`:
+     * a press on a cell it changes edits that cell, so a row whose every cell changes is opened by it. Off unless true;
+     * a press on a cell it does not change opens the record as before.
+     */
+    open?: boolean;
 }
 /**
  * A filter of a field's range in a list's filter bar (`ListNode.filterRanges`): From and To, and where it names them,
@@ -1681,8 +1734,8 @@ export declare const FieldNodeSchema: z.ZodObject<{
         content: "content";
     }>>;
     editMode: z.ZodOptional<z.ZodEnum<{
-        cell: "cell";
         row: "row";
+        cell: "cell";
     }>>;
     labels: z.ZodOptional<z.ZodEnum<{
         above: "above";
@@ -2726,8 +2779,8 @@ export declare const ListCellSchema: z.ZodObject<{
     total: z.ZodOptional<z.ZodEnum<{
         min: "min";
         max: "max";
-        sum: "sum";
         count: "count";
+        sum: "sum";
         avg: "avg";
     }>>;
     rule: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodType<`${number}px`, unknown, z.z.core.$ZodTypeInternals<`${number}px`, unknown>>]>>;
@@ -2778,6 +2831,11 @@ export declare const ListGallerySchema: z.ZodObject<{
         large: "large";
     }>>;
 }, z.z.core.$strict>;
+export declare const ListEditableSchema: z.ZodObject<{
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    add: z.ZodOptional<z.ZodBoolean>;
+    open: z.ZodOptional<z.ZodBoolean>;
+}, z.z.core.$strict>;
 /**
  * A related list: another model's records whose link (`field`) is this record, a page at a time, in a record's page.
  * Its columns are fields of its own `fields`.
@@ -2790,6 +2848,8 @@ export declare const RelatedNodeSchema: z.ZodObject<{
     model: z.ZodString;
     field: z.ZodString;
     fields: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        translate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        requiredIn: z.ZodOptional<z.ZodArray<z.ZodString>>;
         size: z.ZodOptional<z.ZodInt>;
         pattern: z.ZodOptional<z.ZodString>;
         patternHint: z.ZodOptional<z.ZodString>;
@@ -2807,6 +2867,8 @@ export declare const RelatedNodeSchema: z.ZodObject<{
         }, z.z.core.$strict>>>;
         type: z.ZodLiteral<"char">;
     }, z.z.core.$strict>, z.ZodObject<{
+        translate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        requiredIn: z.ZodOptional<z.ZodArray<z.ZodString>>;
         size: z.ZodOptional<z.ZodInt>;
         label: z.ZodString;
         help: z.ZodOptional<z.ZodString>;
@@ -3040,8 +3102,8 @@ export declare const RelatedNodeSchema: z.ZodObject<{
         total: z.ZodOptional<z.ZodEnum<{
             min: "min";
             max: "max";
-            sum: "sum";
             count: "count";
+            sum: "sum";
             avg: "avg";
         }>>;
         rule: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodType<`${number}px`, unknown, z.z.core.$ZodTypeInternals<`${number}px`, unknown>>]>>;
@@ -3515,8 +3577,8 @@ export declare const LayoutNodeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         content: "content";
     }>>;
     editMode: z.ZodOptional<z.ZodEnum<{
-        cell: "cell";
         row: "row";
+        cell: "cell";
     }>>;
     labels: z.ZodOptional<z.ZodEnum<{
         above: "above";
@@ -4216,6 +4278,8 @@ export declare const LayoutNodeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     model: z.ZodString;
     field: z.ZodString;
     fields: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        translate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        requiredIn: z.ZodOptional<z.ZodArray<z.ZodString>>;
         size: z.ZodOptional<z.ZodInt>;
         pattern: z.ZodOptional<z.ZodString>;
         patternHint: z.ZodOptional<z.ZodString>;
@@ -4233,6 +4297,8 @@ export declare const LayoutNodeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }, z.z.core.$strict>>>;
         type: z.ZodLiteral<"char">;
     }, z.z.core.$strict>, z.ZodObject<{
+        translate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        requiredIn: z.ZodOptional<z.ZodArray<z.ZodString>>;
         size: z.ZodOptional<z.ZodInt>;
         label: z.ZodString;
         help: z.ZodOptional<z.ZodString>;
@@ -4466,8 +4532,8 @@ export declare const LayoutNodeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         total: z.ZodOptional<z.ZodEnum<{
             min: "min";
             max: "max";
-            sum: "sum";
             count: "count";
+            sum: "sum";
             avg: "avg";
         }>>;
         rule: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodType<`${number}px`, unknown, z.z.core.$ZodTypeInternals<`${number}px`, unknown>>]>>;
@@ -5292,6 +5358,7 @@ export declare const AlertSchema: z.ZodObject<{
 }, z.z.core.$strict>;
 export declare const MenuItemSchema: z.ZodObject<{
     id: z.ZodString;
+    type: z.ZodOptional<z.ZodLiteral<"divider">>;
     label: z.ZodOptional<z.ZodString>;
     builtin: z.ZodOptional<z.ZodEnum<{
         archive: "archive";
@@ -5446,6 +5513,8 @@ export declare const MenuItemSchema: z.ZodObject<{
     icon: z.ZodOptional<z.ZodString>;
     invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
     roles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    menu: z.ZodOptional<z.ZodArray<typeof MenuItemSchema>>;
+    menuFrom: z.ZodOptional<z.ZodString>;
 }, z.z.core.$strict>;
 export declare const BadgeSchema: z.ZodObject<{
     id: z.ZodString;
@@ -5723,8 +5792,8 @@ export declare const HeadBandSchema: z.ZodObject<{
             content: "content";
         }>>;
         editMode: z.ZodOptional<z.ZodEnum<{
-            cell: "cell";
             row: "row";
+            cell: "cell";
         }>>;
         labels: z.ZodOptional<z.ZodEnum<{
             above: "above";
@@ -6424,6 +6493,8 @@ export declare const HeadBandSchema: z.ZodObject<{
         model: z.ZodString;
         field: z.ZodString;
         fields: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+            translate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            requiredIn: z.ZodOptional<z.ZodArray<z.ZodString>>;
             size: z.ZodOptional<z.ZodInt>;
             pattern: z.ZodOptional<z.ZodString>;
             patternHint: z.ZodOptional<z.ZodString>;
@@ -6441,6 +6512,8 @@ export declare const HeadBandSchema: z.ZodObject<{
             }, z.z.core.$strict>>>;
             type: z.ZodLiteral<"char">;
         }, z.z.core.$strict>, z.ZodObject<{
+            translate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            requiredIn: z.ZodOptional<z.ZodArray<z.ZodString>>;
             size: z.ZodOptional<z.ZodInt>;
             label: z.ZodString;
             help: z.ZodOptional<z.ZodString>;
@@ -6674,8 +6747,8 @@ export declare const HeadBandSchema: z.ZodObject<{
             total: z.ZodOptional<z.ZodEnum<{
                 min: "min";
                 max: "max";
-                sum: "sum";
                 count: "count";
+                sum: "sum";
                 avg: "avg";
             }>>;
             rule: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodType<`${number}px`, unknown, z.z.core.$ZodTypeInternals<`${number}px`, unknown>>]>>;
@@ -7054,8 +7127,8 @@ export declare const SheetHeadSchema: z.ZodObject<{
             content: "content";
         }>>;
         editMode: z.ZodOptional<z.ZodEnum<{
-            cell: "cell";
             row: "row";
+            cell: "cell";
         }>>;
         labels: z.ZodOptional<z.ZodEnum<{
             above: "above";
@@ -7530,8 +7603,8 @@ export declare const SheetHeadSchema: z.ZodObject<{
                 content: "content";
             }>>;
             editMode: z.ZodOptional<z.ZodEnum<{
-                cell: "cell";
                 row: "row";
+                cell: "cell";
             }>>;
             labels: z.ZodOptional<z.ZodEnum<{
                 above: "above";
@@ -8231,6 +8304,8 @@ export declare const SheetHeadSchema: z.ZodObject<{
             model: z.ZodString;
             field: z.ZodString;
             fields: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+                translate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                requiredIn: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 size: z.ZodOptional<z.ZodInt>;
                 pattern: z.ZodOptional<z.ZodString>;
                 patternHint: z.ZodOptional<z.ZodString>;
@@ -8248,6 +8323,8 @@ export declare const SheetHeadSchema: z.ZodObject<{
                 }, z.z.core.$strict>>>;
                 type: z.ZodLiteral<"char">;
             }, z.z.core.$strict>, z.ZodObject<{
+                translate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                requiredIn: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 size: z.ZodOptional<z.ZodInt>;
                 label: z.ZodString;
                 help: z.ZodOptional<z.ZodString>;
@@ -8481,8 +8558,8 @@ export declare const SheetHeadSchema: z.ZodObject<{
                 total: z.ZodOptional<z.ZodEnum<{
                     min: "min";
                     max: "max";
-                    sum: "sum";
                     count: "count";
+                    sum: "sum";
                     avg: "avg";
                 }>>;
                 rule: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodType<`${number}px`, unknown, z.z.core.$ZodTypeInternals<`${number}px`, unknown>>]>>;
@@ -8870,8 +8947,8 @@ export declare const SheetNodeSchema: z.ZodObject<{
                 content: "content";
             }>>;
             editMode: z.ZodOptional<z.ZodEnum<{
-                cell: "cell";
                 row: "row";
+                cell: "cell";
             }>>;
             labels: z.ZodOptional<z.ZodEnum<{
                 above: "above";
@@ -9346,8 +9423,8 @@ export declare const SheetNodeSchema: z.ZodObject<{
                     content: "content";
                 }>>;
                 editMode: z.ZodOptional<z.ZodEnum<{
-                    cell: "cell";
                     row: "row";
+                    cell: "cell";
                 }>>;
                 labels: z.ZodOptional<z.ZodEnum<{
                     above: "above";
@@ -10047,6 +10124,8 @@ export declare const SheetNodeSchema: z.ZodObject<{
                 model: z.ZodString;
                 field: z.ZodString;
                 fields: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    translate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    requiredIn: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     size: z.ZodOptional<z.ZodInt>;
                     pattern: z.ZodOptional<z.ZodString>;
                     patternHint: z.ZodOptional<z.ZodString>;
@@ -10064,6 +10143,8 @@ export declare const SheetNodeSchema: z.ZodObject<{
                     }, z.z.core.$strict>>>;
                     type: z.ZodLiteral<"char">;
                 }, z.z.core.$strict>, z.ZodObject<{
+                    translate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    requiredIn: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     size: z.ZodOptional<z.ZodInt>;
                     label: z.ZodString;
                     help: z.ZodOptional<z.ZodString>;
@@ -10297,8 +10378,8 @@ export declare const SheetNodeSchema: z.ZodObject<{
                     total: z.ZodOptional<z.ZodEnum<{
                         min: "min";
                         max: "max";
-                        sum: "sum";
                         count: "count";
+                        sum: "sum";
                         avg: "avg";
                     }>>;
                     rule: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodType<`${number}px`, unknown, z.z.core.$ZodTypeInternals<`${number}px`, unknown>>]>>;
@@ -10682,8 +10763,8 @@ export declare const SheetNodeSchema: z.ZodObject<{
                 content: "content";
             }>>;
             editMode: z.ZodOptional<z.ZodEnum<{
-                cell: "cell";
                 row: "row";
+                cell: "cell";
             }>>;
             labels: z.ZodOptional<z.ZodEnum<{
                 above: "above";
@@ -10836,8 +10917,8 @@ export declare const SheetNodeSchema: z.ZodObject<{
                 content: "content";
             }>>;
             editMode: z.ZodOptional<z.ZodEnum<{
-                cell: "cell";
                 row: "row";
+                cell: "cell";
             }>>;
             labels: z.ZodOptional<z.ZodEnum<{
                 above: "above";
@@ -10990,8 +11071,8 @@ export declare const SheetNodeSchema: z.ZodObject<{
                 content: "content";
             }>>;
             editMode: z.ZodOptional<z.ZodEnum<{
-                cell: "cell";
                 row: "row";
+                cell: "cell";
             }>>;
             labels: z.ZodOptional<z.ZodEnum<{
                 above: "above";
@@ -11144,8 +11225,8 @@ export declare const SheetNodeSchema: z.ZodObject<{
                 content: "content";
             }>>;
             editMode: z.ZodOptional<z.ZodEnum<{
-                cell: "cell";
                 row: "row";
+                cell: "cell";
             }>>;
             labels: z.ZodOptional<z.ZodEnum<{
                 above: "above";
@@ -11785,6 +11866,7 @@ export declare const SheetNodeSchema: z.ZodObject<{
     toolbar: z.ZodOptional<z.ZodObject<{
         menu: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
+            type: z.ZodOptional<z.ZodLiteral<"divider">>;
             label: z.ZodOptional<z.ZodString>;
             builtin: z.ZodOptional<z.ZodEnum<{
                 archive: "archive";
@@ -11939,6 +12021,8 @@ export declare const SheetNodeSchema: z.ZodObject<{
             icon: z.ZodOptional<z.ZodString>;
             invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
             roles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            menu: z.ZodOptional<z.ZodArray<typeof MenuItemSchema>>;
+            menuFrom: z.ZodOptional<z.ZodString>;
         }, z.z.core.$strict>>>;
         pager: z.ZodOptional<z.ZodBoolean>;
         breadcrumbs: z.ZodOptional<z.ZodBoolean>;
@@ -12668,8 +12752,8 @@ export declare const ListNodeSchema: z.ZodObject<{
         total: z.ZodOptional<z.ZodEnum<{
             min: "min";
             max: "max";
-            sum: "sum";
             count: "count";
+            sum: "sum";
             avg: "avg";
         }>>;
         rule: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodType<`${number}px`, unknown, z.z.core.$ZodTypeInternals<`${number}px`, unknown>>]>>;
@@ -12687,6 +12771,7 @@ export declare const ListNodeSchema: z.ZodObject<{
     }, z.z.core.$strict>>>;
     filterCounts: z.ZodOptional<z.ZodBoolean>;
     filterSheet: z.ZodOptional<z.ZodBoolean>;
+    searchToFilter: z.ZodOptional<z.ZodBoolean>;
     parentField: z.ZodOptional<z.ZodString>;
     export: z.ZodOptional<z.ZodBoolean>;
     bulkEdit: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
@@ -12916,6 +13001,11 @@ export declare const ListNodeSchema: z.ZodObject<{
         menuLabel: z.ZodOptional<z.ZodString>;
         primaryWhenChanged: z.ZodOptional<z.ZodBoolean>;
     }, z.z.core.$strict>>>;
+    editable: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        add: z.ZodOptional<z.ZodBoolean>;
+        open: z.ZodOptional<z.ZodBoolean>;
+    }, z.z.core.$strict>]>>;
 }, z.z.core.$strict>;
 export declare const RootLayoutSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"sheet">;
@@ -13024,8 +13114,8 @@ export declare const RootLayoutSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 content: "content";
             }>>;
             editMode: z.ZodOptional<z.ZodEnum<{
-                cell: "cell";
                 row: "row";
+                cell: "cell";
             }>>;
             labels: z.ZodOptional<z.ZodEnum<{
                 above: "above";
@@ -13500,8 +13590,8 @@ export declare const RootLayoutSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     content: "content";
                 }>>;
                 editMode: z.ZodOptional<z.ZodEnum<{
-                    cell: "cell";
                     row: "row";
+                    cell: "cell";
                 }>>;
                 labels: z.ZodOptional<z.ZodEnum<{
                     above: "above";
@@ -14201,6 +14291,8 @@ export declare const RootLayoutSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 model: z.ZodString;
                 field: z.ZodString;
                 fields: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    translate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    requiredIn: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     size: z.ZodOptional<z.ZodInt>;
                     pattern: z.ZodOptional<z.ZodString>;
                     patternHint: z.ZodOptional<z.ZodString>;
@@ -14218,6 +14310,8 @@ export declare const RootLayoutSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     }, z.z.core.$strict>>>;
                     type: z.ZodLiteral<"char">;
                 }, z.z.core.$strict>, z.ZodObject<{
+                    translate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    requiredIn: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     size: z.ZodOptional<z.ZodInt>;
                     label: z.ZodString;
                     help: z.ZodOptional<z.ZodString>;
@@ -14451,8 +14545,8 @@ export declare const RootLayoutSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     total: z.ZodOptional<z.ZodEnum<{
                         min: "min";
                         max: "max";
-                        sum: "sum";
                         count: "count";
+                        sum: "sum";
                         avg: "avg";
                     }>>;
                     rule: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodType<`${number}px`, unknown, z.z.core.$ZodTypeInternals<`${number}px`, unknown>>]>>;
@@ -14836,8 +14930,8 @@ export declare const RootLayoutSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 content: "content";
             }>>;
             editMode: z.ZodOptional<z.ZodEnum<{
-                cell: "cell";
                 row: "row";
+                cell: "cell";
             }>>;
             labels: z.ZodOptional<z.ZodEnum<{
                 above: "above";
@@ -14990,8 +15084,8 @@ export declare const RootLayoutSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 content: "content";
             }>>;
             editMode: z.ZodOptional<z.ZodEnum<{
-                cell: "cell";
                 row: "row";
+                cell: "cell";
             }>>;
             labels: z.ZodOptional<z.ZodEnum<{
                 above: "above";
@@ -15144,8 +15238,8 @@ export declare const RootLayoutSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 content: "content";
             }>>;
             editMode: z.ZodOptional<z.ZodEnum<{
-                cell: "cell";
                 row: "row";
+                cell: "cell";
             }>>;
             labels: z.ZodOptional<z.ZodEnum<{
                 above: "above";
@@ -15298,8 +15392,8 @@ export declare const RootLayoutSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 content: "content";
             }>>;
             editMode: z.ZodOptional<z.ZodEnum<{
-                cell: "cell";
                 row: "row";
+                cell: "cell";
             }>>;
             labels: z.ZodOptional<z.ZodEnum<{
                 above: "above";
@@ -15939,6 +16033,7 @@ export declare const RootLayoutSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     toolbar: z.ZodOptional<z.ZodObject<{
         menu: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
+            type: z.ZodOptional<z.ZodLiteral<"divider">>;
             label: z.ZodOptional<z.ZodString>;
             builtin: z.ZodOptional<z.ZodEnum<{
                 archive: "archive";
@@ -16093,6 +16188,8 @@ export declare const RootLayoutSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             icon: z.ZodOptional<z.ZodString>;
             invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
             roles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            menu: z.ZodOptional<z.ZodArray<typeof MenuItemSchema>>;
+            menuFrom: z.ZodOptional<z.ZodString>;
         }, z.z.core.$strict>>>;
         pager: z.ZodOptional<z.ZodBoolean>;
         breadcrumbs: z.ZodOptional<z.ZodBoolean>;
@@ -16875,8 +16972,8 @@ export declare const RootLayoutSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         total: z.ZodOptional<z.ZodEnum<{
             min: "min";
             max: "max";
-            sum: "sum";
             count: "count";
+            sum: "sum";
             avg: "avg";
         }>>;
         rule: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodType<`${number}px`, unknown, z.z.core.$ZodTypeInternals<`${number}px`, unknown>>]>>;
@@ -16894,6 +16991,7 @@ export declare const RootLayoutSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.z.core.$strict>>>;
     filterCounts: z.ZodOptional<z.ZodBoolean>;
     filterSheet: z.ZodOptional<z.ZodBoolean>;
+    searchToFilter: z.ZodOptional<z.ZodBoolean>;
     parentField: z.ZodOptional<z.ZodString>;
     export: z.ZodOptional<z.ZodBoolean>;
     bulkEdit: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
@@ -17123,4 +17221,9 @@ export declare const RootLayoutSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         menuLabel: z.ZodOptional<z.ZodString>;
         primaryWhenChanged: z.ZodOptional<z.ZodBoolean>;
     }, z.z.core.$strict>>>;
+    editable: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        add: z.ZodOptional<z.ZodBoolean>;
+        open: z.ZodOptional<z.ZodBoolean>;
+    }, z.z.core.$strict>]>>;
 }, z.z.core.$strict>], "type">;

package/src/lib/format/layout.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SheetNodeSchema = exports.SheetHeadSchema = exports.HeadBandSchema = exports.HeadLinkSchema = exports.SheetKindSchema = exports.BadgeSchema = exports.MenuItemSchema = exports.AlertSchema = exports.RibbonSchema = exports.StatButtonSchema = exports.SectionsNodeSchema = exports.WizardNodeSchema = exports.StepNodeSchema = exports.LayoutNodeSchema = exports.TabsNodeSchema = exports.TabNodeSchema = exports.SectionNodeSchema = exports.FormNodeSchema = exports.RelatedNodeSchema = exports.ListGallerySchema = exports.FilterRangeSchema = exports.ListCardSchema = exports.ListCellSchema = exports.SlotNodeSchema = exports.MapNodeSchema = exports.MapLayerSchema = exports.MapFenceSchema = exports.MapReachSchema = exports.MapRegionsSchema = exports.MapRouteSchema = exports.MapCardSchema = exports.CardPartSchema = exports.PluralWordsSchema = exports.PinSchema = exports.ImageNodeSchema = exports.SpacerNodeSchema = exports.DividerNodeSchema = exports.TextNodeSchema = exports.ButtonNodeSchema = exports.LineFormSchema = exports.FieldNodeSchema = exports.AnswerRuleSchema = exports.CellRulesSchema = exports.PlaceholderWhenSchema = exports.ToneWhenSchema = exports.RolesSchema = exports.ModifierSchema = exports.wideColumns = exports.ScreenWidthSchema = exports.HelpShownSchema = void 0;
-exports.RootLayoutSchema = exports.ListNodeSchema = exports.FilterPeriodSchema = exports.ListCalendarSchema = exports.ListMapSchema = void 0;
+exports.SheetHeadSchema = exports.HeadBandSchema = exports.HeadLinkSchema = exports.SheetKindSchema = exports.BadgeSchema = exports.MenuItemSchema = exports.AlertSchema = exports.RibbonSchema = exports.StatButtonSchema = exports.SectionsNodeSchema = exports.WizardNodeSchema = exports.StepNodeSchema = exports.LayoutNodeSchema = exports.TabsNodeSchema = exports.TabNodeSchema = exports.SectionNodeSchema = exports.FormNodeSchema = exports.RelatedNodeSchema = exports.ListEditableSchema = exports.ListGallerySchema = exports.FilterRangeSchema = exports.ListCardSchema = exports.ListCellSchema = exports.SlotNodeSchema = exports.MapNodeSchema = exports.MapLayerSchema = exports.MapFenceSchema = exports.MapReachSchema = exports.MapRegionsSchema = exports.MapRouteSchema = exports.MapCardSchema = exports.CardPartSchema = exports.PluralWordsSchema = exports.PinSchema = exports.ImageNodeSchema = exports.SpacerNodeSchema = exports.DividerNodeSchema = exports.TextNodeSchema = exports.ButtonNodeSchema = exports.LineFormSchema = exports.FieldNodeSchema = exports.AnswerRuleSchema = exports.CellRulesSchema = exports.PlaceholderWhenSchema = exports.ToneWhenSchema = exports.RolesSchema = exports.ModifierSchema = exports.wideColumns = exports.ScreenWidthSchema = exports.HelpShownSchema = void 0;
+exports.RootLayoutSchema = exports.ListNodeSchema = exports.FilterPeriodSchema = exports.ListCalendarSchema = exports.ListMapSchema = exports.SheetNodeSchema = void 0;
 const z = require("zod");
 const field_1 = require("./field");
 Object.defineProperty(exports, "ModifierSchema", { enumerable: true, get: function () { return field_1.ModifierSchema; } });
@@ -15,6 +15,8 @@ const picker_options_1 = require("./picker-options");
 const phone_1 = require("./phone");
 const slots_options_1 = require("./slots-options");
 const signature_options_1 = require("./signature-options");
+const photos_options_1 = require("./photos-options");
+const scan_options_1 = require("./scan-options");
 const section_checks_1 = require("./section-checks");
 const periods_1 = require("../record/periods");
 exports.HelpShownSchema = z.enum(['below', 'tooltip', 'both']).meta({ id: 'HelpShown' });
@@ -49,6 +51,11 @@ exports.CellRulesSchema = z
     options: z.object({ clear: z.boolean().optional() }).catchall(json_1.JsonValueSchema).optional(),
     width: z.int().min(1).max(200).optional(),
     roles,
+})
+    // A column scanned into (`options.scan`): its settings' shape, as a field's.
+    .superRefine((rules, context) => {
+    for (const issue of (0, scan_options_1.scanOptionIssues)(rules))
+        context.addIssue({ code: 'custom', ...issue });
 })
     .meta({ id: 'CellRules' });
 exports.AnswerRuleSchema = z
@@ -122,7 +129,7 @@ exports.FieldNodeSchema = z.strictObject({
     hotkey: z.string().regex(/^[a-z0-9]$/, 'an access key is one letter or digit of the label, in small letters: "e"').optional(),
 }).superRefine((node, context) => {
     // A widget's own options, where the format knows them: an address with suggestions.
-    for (const issue of [...(0, picker_options_1.pickerOptionIssues)(node), ...(0, phone_1.phoneOptionIssues)(node), ...(0, slots_options_1.slotsOptionIssues)(node), ...(0, signature_options_1.signatureOptionIssues)(node)])
+    for (const issue of [...(0, picker_options_1.pickerOptionIssues)(node), ...(0, phone_1.phoneOptionIssues)(node), ...(0, slots_options_1.slotsOptionIssues)(node), ...(0, signature_options_1.signatureOptionIssues)(node), ...(0, photos_options_1.photosOptionIssues)(node), ...(0, scan_options_1.scanOptionIssues)(node)])
         context.addIssue({ code: 'custom', ...issue });
     if (node.widget !== 'address-search')
         return;
@@ -344,6 +351,13 @@ exports.ListGallerySchema = z
     size: z.enum(['small', 'medium', 'large']).optional(),
 })
     .meta({ id: 'ListGallery' });
+exports.ListEditableSchema = z
+    .strictObject({
+    fields: z.array(fieldName).min(1).optional(),
+    add: z.boolean().optional(),
+    open: z.boolean().optional(),
+})
+    .meta({ id: 'ListEditable' });
 /**
  * A related list: another model's records whose link (`field`) is this record, a page at a time, in a record's page.
  * Its columns are fields of its own `fields`.
@@ -508,6 +522,7 @@ exports.AlertSchema = z.strictObject({
 exports.MenuItemSchema = z
     .strictObject({
     id,
+    type: z.literal('divider').optional(),
     label: z.string().optional(),
     builtin: z.enum(['archive', 'unarchive', 'duplicate', 'delete', 'print']).optional(),
     group: z.enum(['actions', 'print']).optional(),
@@ -518,6 +533,10 @@ exports.MenuItemSchema = z
     icon: z.string().optional(),
     invisible,
     roles,
+    get menu() {
+        return z.array(exports.MenuItemSchema).min(1).optional();
+    },
+    menuFrom: z.string().min(1).optional(),
 })
     .meta({ id: 'MenuItem' });
 exports.BadgeSchema = z.strictObject({ id, label: z.string(), tone: tone.optional(), icon: z.string().min(1).optional(), invisible, roles });
@@ -687,6 +706,7 @@ exports.ListNodeSchema = z.strictObject({
     filterRanges: z.record(fieldName, exports.FilterRangeSchema).optional(),
     filterCounts: z.boolean().optional(),
     filterSheet: z.boolean().optional(),
+    searchToFilter: z.boolean().optional(),
     parentField: fieldName.optional(),
     export: z.boolean().optional(),
     bulkEdit: z.union([z.boolean(), z.array(fieldName).min(1)]).optional(),
@@ -699,6 +719,7 @@ exports.ListNodeSchema = z.strictObject({
     rowBold: field_1.ModifierSchema.optional(),
     rowBoldLabel: z.string().min(1).optional(),
     rowButtons: z.array(exports.ButtonNodeSchema).min(1).optional(),
+    editable: z.union([z.boolean(), exports.ListEditableSchema]).optional(),
 }).meta({ id: 'ListNode' });
 exports.RootLayoutSchema = z
     .discriminatedUnion('type', [exports.SheetNodeSchema, exports.SectionsNodeSchema, exports.TabsNodeSchema, exports.WizardNodeSchema, exports.ListNodeSchema])