@antelopejs/interface-dms 0.7.4 → 0.8.0

package/dist/base/form-types.d.ts

@@ -7,9 +7,11 @@ export declare namespace FormEvents {
     const SUBMIT_SUCCESS = "DmsComponent.Form.SubmitSuccess";
     const SUBMIT_ERROR = "DmsComponent.Form.SubmitError";
     /**
-     * A field's value, as `{ fieldId, value }`: once for each field with the
-     * values the form starts from (defaults, loaded record), then on each
-     * change. A watch keyed on `fieldId` alone therefore runs at load.
+     * A field's value, as `{ fieldId, value, initial }`: once for each field
+     * with the values the form starts from (defaults, loaded record), then on
+     * each change. A watch keyed on `fieldId` alone therefore runs at load.
+     * `initial` is `true` while the field still holds the value it started
+     * from and never held another.
      */
     const FIELD_CHANGE = "DmsComponent.Form.FieldChange";
     const RESET = "DmsComponent.Form.Reset";
@@ -18,6 +20,28 @@ export declare namespace FormFunctions {
     const SET_FIELD_DISABLED = "DmsComponent.Form.SetFieldDisabled";
     const SET_FIELD_HIDDEN = "DmsComponent.Form.SetFieldHidden";
     const SET_FIELD_REQUIRED = "DmsComponent.Form.SetFieldRequired";
+    /**
+     * Writes a field's value: `value`, or the entry of `valueMap` named by
+     * the value of the field that changed. Never on the values the form
+     * starts from (see {@link SetFieldValueParams}).
+     */
+    const SET_FIELD_VALUE = "DmsComponent.Form.SetFieldValue";
+}
+/**
+ * What {@link FormFunctions.SET_FIELD_VALUE} writes, and where. Set `value`
+ * for a fixed value, or `valueMap` to pick one by the value of the field
+ * the event names (`{ won: 100, lost: 0 }` on a stage change); a value the
+ * map has no entry for writes nothing.
+ *
+ * It runs on a change only: a `FIELD_CHANGE` the form sends for a value it
+ * started from (a default, the loaded record) writes nothing, so a record
+ * keeps its stored values as it opens and a field nobody edited is never
+ * sent as changed.
+ */
+export interface SetFieldValueParams {
+    targetField: string;
+    value?: unknown;
+    valueMap?: Record<string, unknown>;
 }
 /** A pill shown beside a read-only field's value. */
 export interface FormFieldBadge {
@@ -51,12 +75,23 @@ export interface FormField {
      * link to where it is changed (`link`).
      */
     readonly?: boolean | FormFieldReadonly;
-    required?: boolean;
     /**
-     * The value of a new record. On a loaded one, a field holding something
-     * else offers "Use default", showing it.
+     * A form creating a record leaves out a read-only field (`disabled` or
+     * `readonly`) that holds nothing yet, a value the server sets once the
+     * record exists: `true` shows it empty all the same.
      */
+    showEmptyOnCreate?: boolean;
+    required?: boolean;
+    /** The value of a new record: the field starts with it. */
     defaultValue?: DefaultValue;
+    /**
+     * `defaultValue` is the module's default for a setting, not only a new
+     * record's starting value: while the field holds something else, it shows
+     * "Module default: X" with "Use default", which puts it back. Off unless
+     * set, so a record form (a table view's) never presents a column's initial
+     * value as a default the user strayed from.
+     */
+    offersDefault?: boolean;
     localized?: boolean;
 }
 export interface FormFieldSerialized extends Omit<FormField, "type" | "inputComponent"> {
@@ -115,7 +150,7 @@ export interface FormSectionSerialized extends Omit<FormSection, "fields"> {
     fieldIds: string[];
 }
 /** What a form edits: see `FormProps.kind`. */
-export declare const FORM_KINDS: readonly ["record", "action"];
+export declare const FORM_KINDS: readonly ["record", "create", "action"];
 export type FormKind = (typeof FORM_KINDS)[number];
 /** The options `Form` takes. */
 export interface FormProps extends BaseComponentProps {
@@ -164,18 +199,26 @@ export interface FormProps extends BaseComponentProps {
     saveMode?: FormSaveMode;
     /**
      * What the form edits. `record` (the default): a record, a settings page,
-     * a table view's form; it keeps its values once saved, and offers Cancel
-     * while clean when it has somewhere to go back to (`backTo`, or the drawer
-     * or modal it sits in). `action`: a form that does something each time it
-     * is sent — send a message, invite someone, run a job; its `submitLabel`
+     * a table view's edit form; it keeps its values once saved, and offers
+     * Cancel when it has somewhere to go back to (`backTo`, the drawer or
+     * modal it sits in, or the page of the app the user came from): changes or
+     * not, Cancel drops them and leaves, in one click. `create`: a form that
+     * makes a new record (a table view's add form and the duplicate it opens,
+     * a relation's add form); its submit reads "Create" and shows from the
+     * start, and its fields list no changes, since all it holds is new.
+     * Declared, never guessed from the method: a settings page posting the
+     * record it read stays a `record`. `action`: a form that does something
+     * each time it is sent — send a message, invite someone, run a job; its `submitLabel`
      * shows from the start, so its defaults can be sent as they are, with
      * Reset once a value changes (in a drawer or a modal, Cancel before that),
      * and it empties after a successful submit.
      */
     kind?: FormKind;
     /**
-     * Where Cancel leads a `record` form placed on a page; without it the form
-     * offers no Cancel. Table views set it on their form pages, to the list.
+     * Where Cancel leads a `record` form placed on a page opened directly (a
+     * link from outside the app, a bookmark); reached from another page of the
+     * app, Cancel goes back to it. Without either, the form offers no Cancel.
+     * Table views set it on their form pages, to the list.
      * Takes the page URL tokens (`{{params.X}}`, `{{query.X}}`).
      */
     backTo?: string;

package/dist/base/form-types.js

@@ -9,9 +9,11 @@ var FormEvents;
     FormEvents.SUBMIT_SUCCESS = "DmsComponent.Form.SubmitSuccess";
     FormEvents.SUBMIT_ERROR = "DmsComponent.Form.SubmitError";
     /**
-     * A field's value, as `{ fieldId, value }`: once for each field with the
-     * values the form starts from (defaults, loaded record), then on each
-     * change. A watch keyed on `fieldId` alone therefore runs at load.
+     * A field's value, as `{ fieldId, value, initial }`: once for each field
+     * with the values the form starts from (defaults, loaded record), then on
+     * each change. A watch keyed on `fieldId` alone therefore runs at load.
+     * `initial` is `true` while the field still holds the value it started
+     * from and never held another.
      */
     FormEvents.FIELD_CHANGE = "DmsComponent.Form.FieldChange";
     FormEvents.RESET = "DmsComponent.Form.Reset";
@@ -21,6 +23,12 @@ var FormFunctions;
     FormFunctions.SET_FIELD_DISABLED = "DmsComponent.Form.SetFieldDisabled";
     FormFunctions.SET_FIELD_HIDDEN = "DmsComponent.Form.SetFieldHidden";
     FormFunctions.SET_FIELD_REQUIRED = "DmsComponent.Form.SetFieldRequired";
+    /**
+     * Writes a field's value: `value`, or the entry of `valueMap` named by
+     * the value of the field that changed. Never on the values the form
+     * starts from (see {@link SetFieldValueParams}).
+     */
+    FormFunctions.SET_FIELD_VALUE = "DmsComponent.Form.SetFieldValue";
 })(FormFunctions || (exports.FormFunctions = FormFunctions = {}));
 function isFieldGroup(item) {
     return "fields" in item && Array.isArray(item.fields);
@@ -33,5 +41,5 @@ exports.FORM_SAVE_MODES = ["bar", "footer", "none", "instant"];
 /** How a sectioned form lists its sections: see `FormProps.sectionNav`. */
 exports.FORM_SECTION_NAVS = ["side", "jump", "none"];
 /** What a form edits: see `FormProps.kind`. */
-exports.FORM_KINDS = ["record", "action"];
+exports.FORM_KINDS = ["record", "create", "action"];
 //# sourceMappingURL=form-types.js.map

package/dist/base/form-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-types.js","sourceRoot":"","sources":["../../src/base/form-types.ts"],"names":[],"mappings":";;;AAuGA,oCAEC;AAED,wDAIC;AArGD,IAAiB,UAAU,CAW1B;AAXD,WAAiB,UAAU;IACZ,iBAAM,GAAG,0BAA0B,CAAC;IACpC,yBAAc,GAAG,iCAAiC,CAAC;IACnD,uBAAY,GAAG,+BAA+B,CAAC;IAC5D;;;;OAIG;IACU,uBAAY,GAAG,+BAA+B,CAAC;IAC/C,gBAAK,GAAG,yBAAyB,CAAC;AACjD,CAAC,EAXgB,UAAU,0BAAV,UAAU,QAW1B;AAED,IAAiB,aAAa,CAI7B;AAJD,WAAiB,aAAa;IACf,gCAAkB,GAAG,oCAAoC,CAAC;IAC1D,8BAAgB,GAAG,kCAAkC,CAAC;IACtD,gCAAkB,GAAG,oCAAoC,CAAC;AACzE,CAAC,EAJgB,aAAa,6BAAb,aAAa,QAI7B;AA4ED,SAAgB,YAAY,CAAC,IAAsB;IACjD,OAAO,QAAQ,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACxD,CAAC;AAED,SAAgB,sBAAsB,CACpC,IAAgC;IAEhC,OAAO,QAAQ,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACxD,CAAC;AAED,2DAA2D;AAC9C,QAAA,eAAe,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAI7E,2EAA2E;AAC9D,QAAA,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAgCnE,+CAA+C;AAClC,QAAA,UAAU,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAU,CAAC"}
+{"version":3,"file":"form-types.js","sourceRoot":"","sources":["../../src/base/form-types.ts"],"names":[],"mappings":";;;AA2IA,oCAEC;AAED,wDAIC;AAzID,IAAiB,UAAU,CAa1B;AAbD,WAAiB,UAAU;IACZ,iBAAM,GAAG,0BAA0B,CAAC;IACpC,yBAAc,GAAG,iCAAiC,CAAC;IACnD,uBAAY,GAAG,+BAA+B,CAAC;IAC5D;;;;;;OAMG;IACU,uBAAY,GAAG,+BAA+B,CAAC;IAC/C,gBAAK,GAAG,yBAAyB,CAAC;AACjD,CAAC,EAbgB,UAAU,0BAAV,UAAU,QAa1B;AAED,IAAiB,aAAa,CAU7B;AAVD,WAAiB,aAAa;IACf,gCAAkB,GAAG,oCAAoC,CAAC;IAC1D,8BAAgB,GAAG,kCAAkC,CAAC;IACtD,gCAAkB,GAAG,oCAAoC,CAAC;IACvE;;;;OAIG;IACU,6BAAe,GAAG,iCAAiC,CAAC;AACnE,CAAC,EAVgB,aAAa,6BAAb,aAAa,QAU7B;AAwGD,SAAgB,YAAY,CAAC,IAAsB;IACjD,OAAO,QAAQ,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACxD,CAAC;AAED,SAAgB,sBAAsB,CACpC,IAAgC;IAEhC,OAAO,QAAQ,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACxD,CAAC;AAED,2DAA2D;AAC9C,QAAA,eAAe,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAI7E,2EAA2E;AAC9D,QAAA,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAgCnE,+CAA+C;AAClC,QAAA,UAAU,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC"}

package/dist/base/guard.d.ts

@@ -82,11 +82,11 @@ export declare const GuardSchema: z.ZodObject<{
             copy: z.ZodOptional<z.ZodBoolean>;
         }, "strip", z.ZodTypeAny, {
             content: string;
-            language?: "text" | "json" | "sql" | "html" | "javascript" | "shell" | "typescript" | undefined;
+            language?: "text" | "json" | "sql" | "html" | "javascript" | "typescript" | "shell" | undefined;
             copy?: boolean | undefined;
         }, {
             content: string;
-            language?: "text" | "json" | "sql" | "html" | "javascript" | "shell" | "typescript" | undefined;
+            language?: "text" | "json" | "sql" | "html" | "javascript" | "typescript" | "shell" | undefined;
             copy?: boolean | undefined;
         }>>>;
         variant: z.ZodOptional<z.ZodDefault<z.ZodEnum<["no-data", "no-result", "no-access", "error"]>>>;
@@ -98,7 +98,7 @@ export declare const GuardSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         code?: {
             content: string;
-            language?: "text" | "json" | "sql" | "html" | "javascript" | "shell" | "typescript" | undefined;
+            language?: "text" | "json" | "sql" | "html" | "javascript" | "typescript" | "shell" | undefined;
             copy?: boolean | undefined;
         } | undefined;
         description?: string | undefined;
@@ -119,7 +119,7 @@ export declare const GuardSchema: z.ZodObject<{
     }, {
         code?: {
             content: string;
-            language?: "text" | "json" | "sql" | "html" | "javascript" | "shell" | "typescript" | undefined;
+            language?: "text" | "json" | "sql" | "html" | "javascript" | "typescript" | "shell" | undefined;
             copy?: boolean | undefined;
         } | undefined;
         description?: string | undefined;
@@ -147,7 +147,7 @@ export declare const GuardSchema: z.ZodObject<{
     fallback?: {
         code?: {
             content: string;
-            language?: "text" | "json" | "sql" | "html" | "javascript" | "shell" | "typescript" | undefined;
+            language?: "text" | "json" | "sql" | "html" | "javascript" | "typescript" | "shell" | undefined;
             copy?: boolean | undefined;
         } | undefined;
         description?: string | undefined;
@@ -175,7 +175,7 @@ export declare const GuardSchema: z.ZodObject<{
     fallback?: {
         code?: {
             content: string;
-            language?: "text" | "json" | "sql" | "html" | "javascript" | "shell" | "typescript" | undefined;
+            language?: "text" | "json" | "sql" | "html" | "javascript" | "typescript" | "shell" | undefined;
             copy?: boolean | undefined;
         } | undefined;
         description?: string | undefined;

package/dist/base/helpers/archive-mode-helpers.js

@@ -31,10 +31,14 @@ function applyArchiveModeDefaultRules(rowActions, archiveField) {
             };
             continue;
         }
-        if (typeof userConfig === "object" && !userConfig.rule) {
+        // A rule of the table's own narrows the archive one, never lifts it: an
+        // archived row stays out of reach of edit, a live one of delete.
+        if (typeof userConfig === "object") {
             result[actionKey] = {
                 ...userConfig,
-                rule: defaultRule,
+                rule: userConfig.rule
+                    ? { and: [defaultRule, userConfig.rule] }
+                    : defaultRule,
             };
         }
     }

package/dist/base/helpers/archive-mode-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"archive-mode-helpers.js","sourceRoot":"","sources":["../../../src/base/helpers/archive-mode-helpers.ts"],"names":[],"mappings":";;AAGA,oEAkDC;AAlDD,SAAgB,4BAA4B,CAC1C,UAAoD,EACpD,YAAoB;IAEpB,MAAM,MAAM,GAAiC,EAAE,GAAG,UAAU,EAAE,CAAC;IAE/D,MAAM,KAAK,GAAG;QACZ,IAAI,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE;QAC9C,SAAS,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE;QACnD,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE;QACjD,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE;QAC9C,MAAM,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE;KAC9C,CAAC;IAEF,KAAK,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,MAAM,SAAS,GAAG,MAA4B,CAAC;QAC/C,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC,SAAS,CAAC,CAAC;QAE3C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,CAAC,SAAS,CAAC,GAAG;gBAClB,SAAS,EAAE,IAAI;gBACf,IAAI,EAAE,WAA+B;aACT,CAAC;YAC/B,SAAS;QACX,CAAC;QAED,IACE,UAAU,KAAK,KAAK;YACpB,CAAC,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,SAAS,KAAK,KAAK,CAAC,EAClE,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,MAAM,CAAC,SAAS,CAAC,GAAG;gBAClB,SAAS,EAAE,IAAI;gBACf,IAAI,EAAE,WAA+B;aACT,CAAC;YAC/B,SAAS;QACX,CAAC;QAED,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YACvD,MAAM,CAAC,SAAS,CAAC,GAAG;gBAClB,GAAG,UAAU;gBACb,IAAI,EAAE,WAA+B;aACT,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"archive-mode-helpers.js","sourceRoot":"","sources":["../../../src/base/helpers/archive-mode-helpers.ts"],"names":[],"mappings":";;AAGA,oEAsDC;AAtDD,SAAgB,4BAA4B,CAC1C,UAAoD,EACpD,YAAoB;IAEpB,MAAM,MAAM,GAAiC,EAAE,GAAG,UAAU,EAAE,CAAC;IAE/D,MAAM,KAAK,GAAG;QACZ,IAAI,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE;QAC9C,SAAS,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE;QACnD,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE;QACjD,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE;QAC9C,MAAM,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE;KAC9C,CAAC;IAEF,KAAK,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,MAAM,SAAS,GAAG,MAA4B,CAAC;QAC/C,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC,SAAS,CAAC,CAAC;QAE3C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,CAAC,SAAS,CAAC,GAAG;gBAClB,SAAS,EAAE,IAAI;gBACf,IAAI,EAAE,WAA+B;aACT,CAAC;YAC/B,SAAS;QACX,CAAC;QAED,IACE,UAAU,KAAK,KAAK;YACpB,CAAC,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,SAAS,KAAK,KAAK,CAAC,EAClE,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,MAAM,CAAC,SAAS,CAAC,GAAG;gBAClB,SAAS,EAAE,IAAI;gBACf,IAAI,EAAE,WAA+B;aACT,CAAC;YAC/B,SAAS;QACX,CAAC;QAED,wEAAwE;QACxE,iEAAiE;QACjE,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YACnC,MAAM,CAAC,SAAS,CAAC,GAAG;gBAClB,GAAG,UAAU;gBACb,IAAI,EAAE,UAAU,CAAC,IAAI;oBACnB,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,WAA+B,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE;oBAC7D,CAAC,CAAE,WAAgC;aACT,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/base/index.d.ts

@@ -23,6 +23,7 @@ export * from "./layouts";
 export * from "./live-toggle";
 export * from "./meter";
 export * from "./nav-card-grid";
+export * from "./page-toolbar";
 export * from "./period-selector";
 export * from "./placeholder";
 export * from "./resource-form-schema";

package/dist/base/index.js

@@ -44,6 +44,7 @@ __exportStar(require("./layouts"), exports);
 __exportStar(require("./live-toggle"), exports);
 __exportStar(require("./meter"), exports);
 __exportStar(require("./nav-card-grid"), exports);
+__exportStar(require("./page-toolbar"), exports);
 __exportStar(require("./period-selector"), exports);
 __exportStar(require("./placeholder"), exports);
 __exportStar(require("./resource-form-schema"), exports);

package/dist/base/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/base/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8EAA8E;AAC9E,6EAA6E;AAC7E,2EAA2E;AAC3E,uEAAuE;AACvE,mEAAmE;AACnE,sCAAoC;AACpC,oCAAkC;AAElC,kDAAgC;AAChC,gDAA8B;AAC9B,iDAA+B;AAC/B,mDAAiC;AACjC,2CAAyB;AACzB,yCAAuB;AACvB,0CAAwB;AACxB,+CAA6B;AAC7B,kDAAgC;AAChC,+CAA6B;AAC7B,mDAAiC;AACjC,4CAA0B;AAC1B,gDAA8B;AAC9B,gDAA8B;AAC9B,yCAAuB;AACvB,yCAAuB;AACvB,0CAAwB;AACxB,mDAAiC;AACjC,6CAA2B;AAC3B,4CAA0B;AAC1B,gDAA8B;AAC9B,0CAAwB;AACxB,kDAAgC;AAChC,oDAAkC;AAClC,gDAA8B;AAC9B,yDAAuC;AACvC,+CAA6B;AAC7B,4CAA0B;AAC1B,0CAAwB;AACxB,+CAA6B;AAC7B,wCAAsB;AACtB,+CAA6B;AAC7B,0DAAwC;AACxC,kDAAgC;AAChC,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/base/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8EAA8E;AAC9E,6EAA6E;AAC7E,2EAA2E;AAC3E,uEAAuE;AACvE,mEAAmE;AACnE,sCAAoC;AACpC,oCAAkC;AAElC,kDAAgC;AAChC,gDAA8B;AAC9B,iDAA+B;AAC/B,mDAAiC;AACjC,2CAAyB;AACzB,yCAAuB;AACvB,0CAAwB;AACxB,+CAA6B;AAC7B,kDAAgC;AAChC,+CAA6B;AAC7B,mDAAiC;AACjC,4CAA0B;AAC1B,gDAA8B;AAC9B,gDAA8B;AAC9B,yCAAuB;AACvB,yCAAuB;AACvB,0CAAwB;AACxB,mDAAiC;AACjC,6CAA2B;AAC3B,4CAA0B;AAC1B,gDAA8B;AAC9B,0CAAwB;AACxB,kDAAgC;AAChC,iDAA+B;AAC/B,oDAAkC;AAClC,gDAA8B;AAC9B,yDAAuC;AACvC,+CAA6B;AAC7B,4CAA0B;AAC1B,0CAAwB;AACxB,+CAA6B;AAC7B,wCAAsB;AACtB,+CAA6B;AAC7B,0DAAwC;AACxC,kDAAgC;AAChC,0CAAwB"}

package/dist/base/internal/form-schema.js

@@ -17,9 +17,11 @@ function serializeFormField(field) {
         component: field.inputComponent || field.type.inputComponent(),
         disabled: field.disabled,
         readonly: field.readonly,
+        showEmptyOnCreate: field.showEmptyOnCreate,
         type: typeId,
         required: field.required,
         defaultValue: field.defaultValue,
+        offersDefault: field.offersDefault,
         localized: field.localized,
     };
 }

package/dist/base/internal/form-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-schema.js","sourceRoot":"","sources":["../../../src/base/internal/form-schema.ts"],"names":[],"mappings":";;AAQA,gDAgBC;AAxBD,6CAAmD;AAGnD;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,KAAgB;IACjD,MAAM,MAAM,GAAG,IAAA,oBAAa,EAAC,KAAK,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;IAEtD,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,SAAS,EAAE,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE;QAC9D,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"form-schema.js","sourceRoot":"","sources":["../../../src/base/internal/form-schema.ts"],"names":[],"mappings":";;AAQA,gDAkBC;AA1BD,6CAAmD;AAGnD;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,KAAgB;IACjD,MAAM,MAAM,GAAG,IAAA,oBAAa,EAAC,KAAK,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;IAEtD,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,SAAS,EAAE,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE;QAC9D,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC;AACJ,CAAC"}

package/dist/base/internal/layouts.d.ts

@@ -20,6 +20,8 @@ export interface PageHeaderButtonSerialized extends Omit<CustomButtonSerialized,
     buttonId?: string;
     /** Place among the header's buttons (`PageHeaderButton.order`). */
     order?: number;
+    /** Acts on the page's record (`PageHeaderButton.requiresRecord`). */
+    requiresRecord?: boolean;
 }
 /**
  * A header button as the layout holds it until a request is served: its
@@ -44,4 +46,6 @@ export interface DefaultLayoutSerializedOptions extends Omit<DefaultLayoutOption
      * buttons again when the page URL's query no longer matches it.
      */
     headerActionsQuery?: Readonly<Record<string, string>>;
+    /** The route parameters (`:id`) of the page URL, likewise. */
+    headerActionsParams?: Readonly<Record<string, string>>;
 }

package/dist/base/key-value-list.d.ts

@@ -49,7 +49,10 @@ export interface KeyValueListProps extends BaseComponentProps, BlockItemsSource
     items?: KeyValueListItem[];
     /** Tighter rows, for side panels. */
     dense?: boolean;
-    /** Columns on wide screens (1–3). */
+    /**
+     * Columns (1–3) once the list itself is wide enough: two from 560px, three
+     * from 840px of its own width (a drawer, a card), one below.
+     */
     columns?: number;
     /** Default ISO 4217 code of `money` values. */
     currency?: string;
@@ -114,10 +117,10 @@ export declare const KeyValueListSchema: z.ZodObject<{
         value?: number | BlockText | null | undefined;
         id?: string | undefined;
         to?: string | undefined;
-        copy?: boolean | undefined;
-        detail?: BlockText | undefined;
         tone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | undefined;
         currency?: string | undefined;
+        detail?: BlockText | undefined;
+        copy?: boolean | undefined;
         copyValue?: string | undefined;
     }, {
         label: BlockText;
@@ -125,10 +128,10 @@ export declare const KeyValueListSchema: z.ZodObject<{
         value?: number | BlockText | null | undefined;
         id?: string | undefined;
         to?: string | undefined;
-        copy?: boolean | undefined;
-        detail?: BlockText | undefined;
         tone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | undefined;
         currency?: string | undefined;
+        detail?: BlockText | undefined;
+        copy?: boolean | undefined;
         copyValue?: string | undefined;
     }>, "many">>;
     card: z.ZodDefault<z.ZodBoolean>;
@@ -144,10 +147,10 @@ export declare const KeyValueListSchema: z.ZodObject<{
         value?: number | BlockText | null | undefined;
         id?: string | undefined;
         to?: string | undefined;
-        copy?: boolean | undefined;
-        detail?: BlockText | undefined;
         tone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | undefined;
         currency?: string | undefined;
+        detail?: BlockText | undefined;
+        copy?: boolean | undefined;
         copyValue?: string | undefined;
     }[] | undefined;
     title?: string | undefined;
@@ -169,10 +172,10 @@ export declare const KeyValueListSchema: z.ZodObject<{
         value?: number | BlockText | null | undefined;
         id?: string | undefined;
         to?: string | undefined;
-        copy?: boolean | undefined;
-        detail?: BlockText | undefined;
         tone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | undefined;
         currency?: string | undefined;
+        detail?: BlockText | undefined;
+        copy?: boolean | undefined;
         copyValue?: string | undefined;
     }[] | undefined;
     title?: string | undefined;

package/dist/base/key-value-list.js

@@ -97,7 +97,7 @@ exports.KeyValueListSchema = zod_1.z.object({
         .min(1)
         .max(3)
         .default(KEY_VALUE_LIST_DEFAULTS.columns)
-        .describe("How many columns on a wide screen."), { label: "Columns", group: "layout", widget: "number", min: 1, max: 3 }),
+        .describe("How many columns once the list is wide enough."), { label: "Columns", group: "layout", widget: "number", min: 1, max: 3 }),
     currency: (0, block_registry_1.ui)(zod_1.z
         .string()
         .optional()

package/dist/base/key-value-list.js.map

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

package/dist/base/kpi-card.d.ts

@@ -15,18 +15,43 @@ export interface KpiCardProps extends BaseComponentProps {
      */
     fetchUrl?: string;
     fetchUrlMethod?: EnumOption<HttpMethod>;
+    /**
+     * Id of the `PeriodSelector` driving the card. The comparison it selects
+     * names the card's change ("vs previous year"), and "no comparison" hides
+     * the change, the comparison value and the comparison label.
+     */
     periodScope?: string;
+    /**
+     * Topics the backend publishes on (`PublishMessage`) when the figure moves:
+     * the card reads `fetchUrl` again on each event, keeping what it shows,
+     * through the page's `live` gate. The page registers them.
+     */
+    realtimeTopic?: string | string[];
     valueFormat?: ValueFormat;
     currencyCode?: string;
     valuePrecision?: ValuePrecision;
     showDelta?: boolean;
+    /**
+     * Shows the figure the value is compared against ("vs €42,900"), formatted
+     * as the value, when the data carries `previousValue`. Defaults to `true`;
+     * `false` keeps a card compact.
+     */
+    showPreviousValue?: boolean;
     showSparkline?: boolean;
     sparklineAccent?: ChartColorValue | "auto";
     invert?: boolean;
+    /**
+     * The caption of the change. Optional: a card with a `periodScope` and no
+     * `description` names the comparison its selector applies on its own, so
+     * set it only for a wording of your own. Shown with the change only:
+     * without a comparison, `description` shows in its place.
+     */
     compareLabel?: string;
     staticValue?: number;
     /** The change in percent, as a fetched `delta`: 12.5 reads +12.5 %. */
     staticDelta?: number;
+    /** The figure compared against, as a fetched `previousValue`. */
+    staticPreviousValue?: number;
     staticSparkline?: number[];
 }
 /**
@@ -45,15 +70,18 @@ export declare const KpiCardSchema: z.ZodObject<{
     fetchUrl: z.ZodOptional<z.ZodString>;
     fetchUrlMethod: z.ZodOptional<z.ZodNativeEnum<typeof HttpMethod>>;
     periodScope: z.ZodOptional<z.ZodString>;
+    realtimeTopic: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
     valueFormat: z.ZodOptional<z.ZodEnum<["number", "currency", "percent", "compact"]>>;
     currencyCode: z.ZodOptional<z.ZodString>;
     showDelta: z.ZodOptional<z.ZodBoolean>;
+    showPreviousValue: z.ZodOptional<z.ZodBoolean>;
     showSparkline: z.ZodOptional<z.ZodBoolean>;
-    sparklineAccent: z.ZodOptional<z.ZodType<"auto" | ChartColorValue, z.ZodTypeDef, "auto" | ChartColorValue>>;
+    sparklineAccent: z.ZodOptional<z.ZodType<ChartColorValue | "auto", z.ZodTypeDef, ChartColorValue | "auto">>;
     invert: z.ZodOptional<z.ZodBoolean>;
     compareLabel: z.ZodOptional<z.ZodString>;
     staticValue: z.ZodOptional<z.ZodNumber>;
     staticDelta: z.ZodOptional<z.ZodNumber>;
+    staticPreviousValue: z.ZodOptional<z.ZodNumber>;
     staticSparkline: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
 }, "strip", z.ZodTypeAny, {
     title: string;
@@ -63,15 +91,18 @@ export declare const KpiCardSchema: z.ZodObject<{
     fetchUrl?: string | undefined;
     fetchUrlMethod?: HttpMethod | undefined;
     periodScope?: string | undefined;
+    realtimeTopic?: string | string[] | undefined;
     valueFormat?: "number" | "percent" | "compact" | "currency" | undefined;
     currencyCode?: string | undefined;
     showDelta?: boolean | undefined;
-    showSparkline?: boolean | undefined;
-    sparklineAccent?: "auto" | ChartColorValue | undefined;
     invert?: boolean | undefined;
+    showPreviousValue?: boolean | undefined;
+    showSparkline?: boolean | undefined;
+    sparklineAccent?: ChartColorValue | "auto" | undefined;
     compareLabel?: string | undefined;
     staticValue?: number | undefined;
     staticDelta?: number | undefined;
+    staticPreviousValue?: number | undefined;
     staticSparkline?: number[] | undefined;
 }, {
     title: string;
@@ -81,14 +112,17 @@ export declare const KpiCardSchema: z.ZodObject<{
     fetchUrl?: string | undefined;
     fetchUrlMethod?: HttpMethod | undefined;
     periodScope?: string | undefined;
+    realtimeTopic?: string | string[] | undefined;
     valueFormat?: "number" | "percent" | "compact" | "currency" | undefined;
     currencyCode?: string | undefined;
     showDelta?: boolean | undefined;
-    showSparkline?: boolean | undefined;
-    sparklineAccent?: "auto" | ChartColorValue | undefined;
     invert?: boolean | undefined;
+    showPreviousValue?: boolean | undefined;
+    showSparkline?: boolean | undefined;
+    sparklineAccent?: ChartColorValue | "auto" | undefined;
     compareLabel?: string | undefined;
     staticValue?: number | undefined;
     staticDelta?: number | undefined;
+    staticPreviousValue?: number | undefined;
     staticSparkline?: number[] | undefined;
 }>;

package/dist/base/kpi-card.js

@@ -5,6 +5,8 @@ exports.KpiCard = KpiCard;
 const component_1 = require("../component");
 const zod_1 = require("zod");
 const block_registry_1 = require("./block-registry");
+const display_1 = require("./display");
+const realtime_topics_1 = require("./internal/realtime-topics");
 const chart_1 = require("./chart");
 const http_1 = require("./types/http");
 const KPI_CARD_COMPONENT_NAME = "dms-kpi-card";
@@ -15,12 +17,12 @@ const KPI_CARD_COMPONENT_NAME = "dms-kpi-card";
  * on every edit — so a block with nothing set yet has to be a legal call.
  */
 function KpiCard(options) {
-    return new component_1.ComponentBuilder(KPI_CARD_COMPONENT_NAME)
+    return (0, realtime_topics_1.attachRealtimeTopicsHook)(new component_1.ComponentBuilder(KPI_CARD_COMPONENT_NAME)
         .options({ ...options })
         .meta({
         name: options?.title || "KPI card",
         icon: options?.icon || "i-ph-trend-up",
-    });
+    }), options?.realtimeTopic);
 }
 /** The options `KpiCard` accepts. */
 exports.KpiCardSchema = zod_1.z.object({
@@ -54,6 +56,7 @@ exports.KpiCardSchema = zod_1.z.object({
         .string()
         .optional()
         .describe("Id of the PeriodSelector driving this card."), { label: "Period scope", group: "advanced" }),
+    realtimeTopic: (0, display_1.blockRealtimeTopicOption)(),
     valueFormat: (0, block_registry_1.ui)(zod_1.z.enum(chart_1.VALUE_FORMATS).optional(), {
         label: "Value format",
         group: "appearance",
@@ -68,6 +71,10 @@ exports.KpiCardSchema = zod_1.z.object({
         group: "appearance",
         widget: "switch",
     }),
+    showPreviousValue: (0, block_registry_1.ui)(zod_1.z
+        .boolean()
+        .optional()
+        .describe("Show the figure the value is compared against."), { label: "Show comparison value", group: "appearance", widget: "switch" }),
     showSparkline: (0, block_registry_1.ui)(zod_1.z.boolean().optional(), {
         label: "Show sparkline",
         group: "appearance",
@@ -82,16 +89,21 @@ exports.KpiCardSchema = zod_1.z.object({
         .boolean()
         .optional()
         .describe("Treat a falling value as the good outcome."), { label: "Invert variation", group: "behavior", widget: "switch" }),
-    compareLabel: (0, block_registry_1.ui)(zod_1.z.string().optional(), {
-        label: "Comparison label",
-        group: "content",
-    }),
+    compareLabel: (0, block_registry_1.ui)(zod_1.z
+        .string()
+        .optional()
+        .describe("Caption of the variation; follows the period selector's comparison when empty."), { label: "Comparison label", group: "content" }),
     staticValue: (0, block_registry_1.ui)(zod_1.z.number().optional().describe("Value shown when no data source is set."), { label: "Static value", group: "advanced", widget: "number" }),
     staticDelta: (0, block_registry_1.ui)(zod_1.z.number().optional(), {
         label: "Static variation",
         group: "advanced",
         widget: "number",
     }),
+    staticPreviousValue: (0, block_registry_1.ui)(zod_1.z.number().optional(), {
+        label: "Static comparison value",
+        group: "advanced",
+        widget: "number",
+    }),
     staticSparkline: (0, block_registry_1.ui)(zod_1.z.array(zod_1.z.number()).optional(), {
         label: "Static sparkline",
         group: "advanced",

package/dist/base/kpi-card.js.map

@@ -1 +1 @@
-{"version":3,"file":"kpi-card.js","sourceRoot":"","sources":["../../src/base/kpi-card.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"kpi-card.js","sourceRoot":"","sources":["../../src/base/kpi-card.ts"],"names":[],"mappings":";;;AA+EA,0BAYC;AA3FD,4CAAgD;AAChD,6BAAwB;AACxB,qDAK0B;AAC1B,uCAAqD;AACrD,gEAAsE;AACtE,mCAKiB;AAEjB,uCAA0C;AAsD1C,MAAM,uBAAuB,GAAG,cAAc,CAAC;AAE/C;;;;;GAKG;AACH,SAAgB,OAAO,CACrB,OAAsB;IAEtB,OAAO,IAAA,0CAAwB,EAC7B,IAAI,4BAAgB,CAAe,uBAAuB,CAAC;SACxD,OAAO,CAAC,EAAE,GAAG,OAAO,EAAkB,CAAC;SACvC,IAAI,CAAC;QACJ,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,UAAU;QAClC,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,eAAe;KACvC,CAAC,EACJ,OAAO,EAAE,aAAa,CACvB,CAAC;AACJ,CAAC;AAED,qCAAqC;AACxB,QAAA,aAAa,GAAG,OAAC,CAAC,MAAM,CAAC;IACpC,KAAK,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE;QAC9C,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,SAAS;KACjB,CAAC;IACF,WAAW,EAAE,IAAA,mBAAE,EACb,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC,EACjE,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,CAC/D;IACD,IAAI,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC,EAAE;QACtE,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,MAAM;KACf,CAAC;IACF,OAAO,EAAE,IAAA,mBAAE,EACT,OAAC;SACE,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;SACzB,QAAQ,EAAE;SACV,QAAQ,CAAC,yCAAyC,CAAC,EACtD,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,CAC/D;IACD,QAAQ,EAAE,IAAA,mBAAE,EACV,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC,EACtE;QACE,KAAK,EAAE,aAAa;QACpB,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,YAAY;QACpB,aAAa,EAAE,OAAO;QACtB,YAAY,EAAE,aAAa;KAC5B,CACF;IACD,cAAc,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,UAAU,CAAC,iBAAU,CAAC,CAAC,QAAQ,EAAE,EAAE;QACtD,KAAK,EAAE,aAAa;QACpB,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,QAAQ;KACjB,CAAC;IACF,WAAW,EAAE,IAAA,mBAAE,EACb,OAAC;SACE,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,6CAA6C,CAAC,EAC1D,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,EAAE,CAC7C;IACD,aAAa,EAAE,IAAA,kCAAwB,GAAE;IACzC,WAAW,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,IAAI,CAAC,qBAAa,CAAC,CAAC,QAAQ,EAAE,EAAE;QAChD,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,WAAW;KACpB,CAAC;IACF,YAAY,EAAE,IAAA,mBAAE,EACd,OAAC;SACE,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,gFAAgF,CACjF,EACH,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,CAC3C;IACD,SAAS,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE;QACpC,KAAK,EAAE,gBAAgB;QACvB,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,QAAQ;KACjB,CAAC;IACF,iBAAiB,EAAE,IAAA,mBAAE,EACnB,OAAC;SACE,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,gDAAgD,CAAC,EAC7D,EAAE,KAAK,EAAE,uBAAuB,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,CAC1E;IACD,aAAa,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE;QACxC,KAAK,EAAE,gBAAgB;QACvB,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,QAAQ;KACjB,CAAC;IACF,eAAe,EAAE,IAAA,mBAAE,EAAC,IAAA,6BAAY,GAA4B,CAAC,QAAQ,EAAE,EAAE;QACvE,KAAK,EAAE,kBAAkB;QACzB,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,OAAO;KAChB,CAAC;IACF,MAAM,EAAE,IAAA,mBAAE,EACR,OAAC;SACE,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,4CAA4C,CAAC,EACzD,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CACnE;IACD,YAAY,EAAE,IAAA,mBAAE,EACd,OAAC;SACE,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,gFAAgF,CACjF,EACH,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,SAAS,EAAE,CAChD;IACD,WAAW,EAAE,IAAA,mBAAE,EACb,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC,EACzE,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAC/D;IACD,WAAW,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;QACrC,KAAK,EAAE,kBAAkB;QACzB,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,QAAQ;KACjB,CAAC;IACF,mBAAmB,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;QAC7C,KAAK,EAAE,yBAAyB;QAChC,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,QAAQ;KACjB,CAAC;IACF,eAAe,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE;QAClD,KAAK,EAAE,kBAAkB;QACzB,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,MAAM;KACf,CAAC;CACH,CAAyC,CAAC;AAE3C,IAAA,kCAAiB,EAAC;IAChB,IAAI,EAAE,SAAS;IACf,aAAa,EAAE,uBAAuB;IACtC,MAAM,EAAE,qBAAa;IACrB,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,4CAA4C;QACzD,KAAK,EAAE,eAAe;KACvB;CACF,CAAC,CAAC"}

package/dist/base/layouts.d.ts

@@ -11,6 +11,24 @@ export interface PageHeaderButton extends CustomButton {
      * "header"`) take `0`.
      */
     order?: number;
+    /**
+     * The button acts on the record the page shows (the layout's `record`): it
+     * is disabled while the record loads, and left out of a page whose record
+     * cannot be read (not found). A target naming `{{record.X}}` implies it.
+     */
+    requiresRecord?: boolean;
+}
+/**
+ * The record a page shows, which its header buttons read: a target may name
+ * its fields as `{{record.X}}` (an address in a maps link).
+ */
+export interface PageRecordSource {
+    /**
+     * URL answering the record, typically its controller's `get` route;
+     * `{{params.X}}` and `{{query.X}}` are filled in from the page URL.
+     * @example "/api/sites/get?id={{params.id}}"
+     */
+    fetchUrl: string;
 }
 export interface DefaultLayoutOptions {
     /**
@@ -40,6 +58,12 @@ export interface DefaultLayoutOptions {
      * An `availability` disables a button for one request, or hides it.
      */
     headerActions?: PageHeaderButton[];
+    /**
+     * The record the page shows, for the header buttons that act on it
+     * (`requiresRecord`, or a `{{record.X}}` in their target). Read once per
+     * page: a block reading the same `fetchUrl` shares the request.
+     */
+    record?: PageRecordSource;
 }
 export declare function DefaultLayout(options?: DefaultLayoutOptions): ComponentInfo;
 /**

package/dist/base/layouts.js.map

@@ -1 +1 @@
-{"version":3,"file":"layouts.js","sourceRoot":"","sources":["../../src/base/layouts.ts"],"names":[],"mappings":";;AAiFA,sCAKC;AAMD,wCAIC;AAQD,wCAIC;AAED,kCAKC;AAlHD,8DAAmE;AACnE,kEAAuE;AAkDvE,8DAA8D;AAC9D,MAAM,uBAAuB,GAAG,SAAS,CAAC;AAE1C,SAAS,mBAAmB,CAC1B,MAAwB,EACxB,KAAa;IAEb,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACvE,MAAM,QAAQ,GAA6B;QACzC,GAAG,IAAI;QACP,EAAE,EAAE,EAAE,IAAI,GAAG,uBAAuB,GAAG,KAAK,EAAE;QAC9C,MAAM,EAAE,IAAA,qCAAqB,EAAC,MAAM,CAAC;KACtC,CAAC;IACF,IAAI,OAAO;QAAE,QAAQ,CAAC,OAAO,GAAG,IAAA,uCAAsB,EAAC,OAAO,CAAC,CAAC;IAChE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,eAAe,CACtB,aAAqB,EACrB,OAA6B;IAE7B,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAC3C,MAAM,aAAa,GAAmC,IAAI,CAAC;IAC3D,IAAI,aAAa,EAAE,CAAC;QAClB,aAAa,CAAC,aAAa,GAAG,aAAa,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;AACnD,CAAC;AAED,SAAgB,aAAa,CAAC,OAA8B;IAC1D,OAAO,eAAe,CAAC,oBAAoB,EAAE;QAC3C,SAAS,EAAE,IAAI;QACf,GAAG,OAAO;KACX,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAC5B,OAAiD;IAEjD,OAAO,aAAa,CAAC,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAC5B,OAAiD;IAEjD,OAAO,eAAe,CAAC,qBAAqB,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,SAAgB,WAAW;IACzB,OAAO;QACL,aAAa,EAAE,kBAAkB;QACjC,OAAO,EAAE,EAAE;KACZ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"layouts.js","sourceRoot":"","sources":["../../src/base/layouts.ts"],"names":[],"mappings":";;AA0GA,sCAKC;AAMD,wCAIC;AAQD,wCAIC;AAED,kCAKC;AA3ID,8DAAmE;AACnE,kEAAuE;AA2EvE,8DAA8D;AAC9D,MAAM,uBAAuB,GAAG,SAAS,CAAC;AAE1C,SAAS,mBAAmB,CAC1B,MAAwB,EACxB,KAAa;IAEb,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACvE,MAAM,QAAQ,GAA6B;QACzC,GAAG,IAAI;QACP,EAAE,EAAE,EAAE,IAAI,GAAG,uBAAuB,GAAG,KAAK,EAAE;QAC9C,MAAM,EAAE,IAAA,qCAAqB,EAAC,MAAM,CAAC;KACtC,CAAC;IACF,IAAI,OAAO;QAAE,QAAQ,CAAC,OAAO,GAAG,IAAA,uCAAsB,EAAC,OAAO,CAAC,CAAC;IAChE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,eAAe,CACtB,aAAqB,EACrB,OAA6B;IAE7B,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAC3C,MAAM,aAAa,GAAmC,IAAI,CAAC;IAC3D,IAAI,aAAa,EAAE,CAAC;QAClB,aAAa,CAAC,aAAa,GAAG,aAAa,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;AACnD,CAAC;AAED,SAAgB,aAAa,CAAC,OAA8B;IAC1D,OAAO,eAAe,CAAC,oBAAoB,EAAE;QAC3C,SAAS,EAAE,IAAI;QACf,GAAG,OAAO;KACX,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAC5B,OAAiD;IAEjD,OAAO,aAAa,CAAC,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAC5B,OAAiD;IAEjD,OAAO,eAAe,CAAC,qBAAqB,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,SAAgB,WAAW;IACzB,OAAO;QACL,aAAa,EAAE,kBAAkB;QACjC,OAAO,EAAE,EAAE;KACZ,CAAC;AACJ,CAAC"}