@antelopejs/interface-dms 0.4.1 → 0.4.2

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## v0.4.2
+
+[compare changes](https://github.com/AntelopeJS/dms/compare/interface-v0.4.1...v0.4.2)
+
+### 🚀 Enhancements
+
+- **dms:** Compose block texts client-side with typed params and resolve layout banners per request ([#173](https://github.com/AntelopeJS/dms/pull/173))
+- **dms:** Compose table cell sub-lines and add the two_line display and empty identities ([#175](https://github.com/AntelopeJS/dms/pull/175))
+
+### 🏡 Chore
+
+- **release:** @antelopejs/dms v0.6.1 ([3c2fb0a](https://github.com/AntelopeJS/dms/commit/3c2fb0a))
+
+### ❤️ Contributors
+
+- Antony Rizzitelli <rizzitelli.antony@pm.me>
+
 ## v0.4.1
 
 [compare changes](https://github.com/AntelopeJS/dms/compare/interface-v0.4.0...v0.4.1)

package/dist/base/banner.d.ts

@@ -2,6 +2,7 @@ import { ComponentBuilder } from "../component";
 import { z } from "zod";
 import { type BlockLinkAction } from "./display";
 import type { BaseComponentProps } from "./types";
+import type { BlockText } from "./types/composed-text";
 import type { Tone } from "./types/tone";
 /** The tones a banner washes with. */
 export declare const BANNER_TONES: readonly ["info", "success", "warning", "error", "primary"];
@@ -12,9 +13,14 @@ export declare const BANNER_SIZES: readonly ["md", "sm"];
 export type BannerSize = (typeof BANNER_SIZES)[number];
 /** The options `Banner` takes. */
 export interface BannerProps extends BaseComponentProps {
-    /** `$`-prefixed for an i18n key, like every text of the block. */
-    title?: string;
-    description?: string;
+    /**
+     * `$`-prefixed for an i18n key, like every text of the block, or a
+     * `ComposedText` composed in the reader's language ("Payment failed, retry
+     * {date}").
+     */
+    title?: BlockText;
+    /** A string or a `ComposedText`, like `title`. */
+    description?: BlockText;
     tone?: BannerTone;
     /** Overrides the tone's icon. */
     icon?: string;
@@ -52,8 +58,8 @@ export interface BannerProps extends BaseComponentProps {
 export declare function Banner(options?: BannerProps): ComponentBuilder<BannerProps>;
 /** The options `Banner` accepts. */
 export declare const BannerSchema: z.ZodObject<{
-    title: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodType<BlockText, z.ZodTypeDef, BlockText>>;
+    description: z.ZodOptional<z.ZodType<BlockText, z.ZodTypeDef, BlockText>>;
     actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
         label: z.ZodString;
         to: z.ZodString;
@@ -81,8 +87,8 @@ export declare const BannerSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     size: "sm" | "md";
     tone: "primary" | "success" | "info" | "warning" | "error";
-    description?: string | undefined;
-    title?: string | undefined;
+    description?: BlockText | undefined;
+    title?: BlockText | undefined;
     icon?: string | undefined;
     actions?: {
         label: string;
@@ -94,9 +100,9 @@ export declare const BannerSchema: z.ZodObject<{
     dismissible?: boolean | undefined;
     dismissKey?: string | undefined;
 }, {
-    description?: string | undefined;
+    description?: BlockText | undefined;
     size?: "sm" | "md" | undefined;
-    title?: string | undefined;
+    title?: BlockText | undefined;
     icon?: string | undefined;
     actions?: {
         label: string;

package/dist/base/banner.js

@@ -7,6 +7,7 @@ const zod_1 = require("zod");
 const block_registry_1 = require("./block-registry");
 const display_1 = require("./display");
 const display_2 = require("./internal/display");
+const composed_text_1 = require("./internal/composed-text");
 /** The tones a banner washes with. */
 exports.BANNER_TONES = [
     "info",
@@ -43,14 +44,18 @@ function Banner(options) {
     return new component_1.ComponentBuilder(BANNER_COMPONENT_NAME)
         .options({ ...BANNER_DEFAULTS, ...options })
         .meta({
-        name: options?.title || "Banner",
+        name: (typeof options?.title === "string" && options.title) || "Banner",
         icon: options?.icon || BANNER_ICON,
     });
 }
 /** The options `Banner` accepts. */
 exports.BannerSchema = zod_1.z.object({
-    title: (0, block_registry_1.ui)(zod_1.z.string().optional(), { label: "Title", group: "content" }),
-    description: (0, block_registry_1.ui)(zod_1.z.string().optional(), {
+    title: (0, block_registry_1.ui)((0, composed_text_1.blockTextSchema)().optional(), {
+        label: "Title",
+        group: "content",
+        widget: "text",
+    }),
+    description: (0, block_registry_1.ui)((0, composed_text_1.blockTextSchema)().optional(), {
         label: "Description",
         group: "content",
         widget: "textarea",

package/dist/base/banner.js.map

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

package/dist/base/card.d.ts

@@ -74,8 +74,8 @@ export declare const CardSchema: z.ZodObject<{
     padded: boolean;
     description?: string | undefined;
     title?: string | undefined;
-    footer?: string | undefined;
     count?: string | number | undefined;
+    footer?: string | undefined;
     actions?: {
         label: string;
         to: string;
@@ -86,9 +86,9 @@ export declare const CardSchema: z.ZodObject<{
 }, {
     description?: string | undefined;
     title?: string | undefined;
+    count?: string | number | undefined;
     variant?: "default" | "elevated" | undefined;
     footer?: string | undefined;
-    count?: string | number | undefined;
     actions?: {
         label: string;
         to: string;

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

@@ -57,7 +57,7 @@ export declare const ChartCardSchema: z.ZodObject<{
     fetchUrl?: string | undefined;
     fetchUrlMethod?: HttpMethod | undefined;
     periodScope?: string | undefined;
-    valueFormat?: "number" | "compact" | "percent" | "currency" | undefined;
+    valueFormat?: "number" | "percent" | "compact" | "currency" | undefined;
     currencyCode?: string | undefined;
     primaryLabel?: string | undefined;
     comparisonLabel?: string | undefined;
@@ -70,7 +70,7 @@ export declare const ChartCardSchema: z.ZodObject<{
     fetchUrlMethod?: HttpMethod | undefined;
     showLegend?: boolean | undefined;
     periodScope?: string | undefined;
-    valueFormat?: "number" | "compact" | "percent" | "currency" | undefined;
+    valueFormat?: "number" | "percent" | "compact" | "currency" | undefined;
     currencyCode?: string | undefined;
     showDelta?: boolean | undefined;
     primaryLabel?: string | undefined;

package/dist/base/internal/composed-text.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+import { type BlockText, type ComposedText } from "../types/composed-text";
+/**
+ * The zod schema of a {@link ComposedText}.
+ *
+ * @internal
+ */
+export declare const ComposedTextSchema: z.ZodType<ComposedText>;
+/**
+ * The schema of a block text option: a plain string or a composed text.
+ *
+ * @internal
+ */
+export declare const blockTextSchema: () => z.ZodType<BlockText>;

package/dist/base/internal/composed-text.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.blockTextSchema = exports.ComposedTextSchema = void 0;
+const zod_1 = require("zod");
+const composed_text_1 = require("../types/composed-text");
+const DateValueSchema = zod_1.z.union([zod_1.z.string(), zod_1.z.number()]);
+const TypedParamSchema = zod_1.z.discriminatedUnion("type", [
+    zod_1.z.object({
+        type: zod_1.z.literal("money"),
+        value: zod_1.z.number(),
+        currency: zod_1.z.string(),
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("date"),
+        value: DateValueSchema,
+        format: zod_1.z.enum(composed_text_1.COMPOSED_TEXT_DATE_FORMATS).optional(),
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("datetime"),
+        value: DateValueSchema,
+        format: zod_1.z.enum(composed_text_1.COMPOSED_TEXT_DATE_FORMATS).optional(),
+    }),
+    zod_1.z.object({ type: zod_1.z.literal("relative"), value: DateValueSchema }),
+    zod_1.z.object({
+        type: zod_1.z.literal("number"),
+        value: zod_1.z.number(),
+        format: zod_1.z.enum(composed_text_1.COMPOSED_TEXT_NUMBER_FORMATS).optional(),
+    }),
+    zod_1.z.object({ type: zod_1.z.literal("count"), value: zod_1.z.number() }),
+]);
+// A parameter may itself be a composed text, so the two schemas name each
+// other through `z.lazy`.
+const ComposedTextParamSchema = zod_1.z.lazy(() => zod_1.z.union([zod_1.z.string(), zod_1.z.number(), TypedParamSchema, exports.ComposedTextSchema]));
+/**
+ * The zod schema of a {@link ComposedText}.
+ *
+ * @internal
+ */
+exports.ComposedTextSchema = zod_1.z.object({
+    key: zod_1.z.string().min(1),
+    params: zod_1.z.record(ComposedTextParamSchema).optional(),
+    plural: zod_1.z.string().optional(),
+});
+/**
+ * The schema of a block text option: a plain string or a composed text.
+ *
+ * @internal
+ */
+const blockTextSchema = () => zod_1.z.union([zod_1.z.string(), exports.ComposedTextSchema]);
+exports.blockTextSchema = blockTextSchema;
+//# sourceMappingURL=composed-text.js.map

package/dist/base/internal/composed-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composed-text.js","sourceRoot":"","sources":["../../../src/base/internal/composed-text.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,0DAMgC;AAEhC,MAAM,eAAe,GAAG,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AAE1D,MAAM,gBAAgB,GAAG,OAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACpD,OAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QACxB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;QACjB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;KACrB,CAAC;IACF,OAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACvB,KAAK,EAAE,eAAe;QACtB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,0CAA0B,CAAC,CAAC,QAAQ,EAAE;KACtD,CAAC;IACF,OAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,UAAU,CAAC;QAC3B,KAAK,EAAE,eAAe;QACtB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,0CAA0B,CAAC,CAAC,QAAQ,EAAE;KACtD,CAAC;IACF,OAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;IACjE,OAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;QACzB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;QACjB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,4CAA4B,CAAC,CAAC,QAAQ,EAAE;KACxD,CAAC;IACF,OAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,CAAC;CAC1D,CAAC,CAAC;AAEH,0EAA0E;AAC1E,0BAA0B;AAC1B,MAAM,uBAAuB,GAAiC,OAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CACxE,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,gBAAgB,EAAE,0BAAkB,CAAC,CAAC,CACxE,CAAC;AAEF;;;;GAIG;AACU,QAAA,kBAAkB,GAA4B,OAAC,CAAC,MAAM,CAAC;IAClE,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC,QAAQ,EAAE;IACpD,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH;;;;GAIG;AACI,MAAM,eAAe,GAAG,GAAyB,EAAE,CACxD,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,0BAAkB,CAAC,CAAC,CAAC;AAD/B,QAAA,eAAe,mBACgB"}

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

@@ -3,6 +3,7 @@ import { z } from "zod";
 import { type BlockItemsSource } from "./display";
 import { type Tone } from "./types/tone";
 import type { BaseComponentProps } from "./types";
+import type { BlockText } from "./types/composed-text";
 /**
  * How a value is drawn: `text` plain, `status` a tinted pill, `money` a
  * currency amount, `date` a localized date, `link` an accent link, `mono` an
@@ -14,17 +15,22 @@ export type KeyValueType = (typeof KEY_VALUE_TYPES)[number];
 export interface KeyValueListItem {
     /** Stable key; the position is used without one. */
     id?: string;
-    /** `$`-prefixed for an i18n key. */
-    label: string;
-    /** Raw value: an ISO date for `date`, a number for `money`. */
-    value?: string | number | null;
+    /** `$`-prefixed for an i18n key, or a `ComposedText`. */
+    label: BlockText;
+    /**
+     * Raw value: an ISO date for `date`, a number for `money`. A
+     * `ComposedText` is composed in the reader's language and drawn as text,
+     * whatever the `type` — its parameters already say how each value is
+     * written.
+     */
+    value?: BlockText | number | null;
     type?: KeyValueType;
     /** Route, `#anchor` or URL the value links to. */
     to?: string;
     /** Text colour, or the pill tone of a `status` value. */
     tone?: Tone;
-    /** Dim note after the value. */
-    detail?: string;
+    /** Dim note after the value: a string or a `ComposedText`. */
+    detail?: BlockText;
     /** ISO 4217 code of a `money` value; overrides the list's `currency`. */
     currency?: string;
 }
@@ -81,29 +87,29 @@ export declare const KeyValueListSchema: z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
     items: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
-        label: z.ZodString;
-        value: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        label: z.ZodType<BlockText, z.ZodTypeDef, BlockText>;
+        value: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodType<BlockText, z.ZodTypeDef, BlockText>, z.ZodNumber]>>>;
         type: z.ZodOptional<z.ZodEnum<["text", "status", "money", "date", "link", "mono"]>>;
         to: z.ZodOptional<z.ZodString>;
         tone: z.ZodOptional<z.ZodEnum<["primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral", ...("primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral")[]]>>;
-        detail: z.ZodOptional<z.ZodString>;
+        detail: z.ZodOptional<z.ZodType<BlockText, z.ZodTypeDef, BlockText>>;
         currency: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        label: string;
-        type?: "link" | "date" | "status" | "text" | "mono" | "money" | undefined;
-        value?: string | number | null | undefined;
+        label: BlockText;
+        type?: "link" | "date" | "status" | "money" | "text" | "mono" | undefined;
+        value?: number | BlockText | null | undefined;
         id?: string | undefined;
         to?: string | undefined;
-        detail?: string | undefined;
+        detail?: BlockText | undefined;
         tone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | undefined;
         currency?: string | undefined;
     }, {
-        label: string;
-        type?: "link" | "date" | "status" | "text" | "mono" | "money" | undefined;
-        value?: string | number | null | undefined;
+        label: BlockText;
+        type?: "link" | "date" | "status" | "money" | "text" | "mono" | undefined;
+        value?: number | BlockText | null | undefined;
         id?: string | undefined;
         to?: string | undefined;
-        detail?: string | undefined;
+        detail?: BlockText | undefined;
         tone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | undefined;
         currency?: string | undefined;
     }>, "many">>;
@@ -115,12 +121,12 @@ export declare const KeyValueListSchema: z.ZodObject<{
     card: boolean;
     columns: number;
     items?: {
-        label: string;
-        type?: "link" | "date" | "status" | "text" | "mono" | "money" | undefined;
-        value?: string | number | null | undefined;
+        label: BlockText;
+        type?: "link" | "date" | "status" | "money" | "text" | "mono" | undefined;
+        value?: number | BlockText | null | undefined;
         id?: string | undefined;
         to?: string | undefined;
-        detail?: string | undefined;
+        detail?: BlockText | undefined;
         tone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | undefined;
         currency?: string | undefined;
     }[] | undefined;
@@ -136,12 +142,12 @@ export declare const KeyValueListSchema: z.ZodObject<{
     dense?: boolean | undefined;
 }, {
     items?: {
-        label: string;
-        type?: "link" | "date" | "status" | "text" | "mono" | "money" | undefined;
-        value?: string | number | null | undefined;
+        label: BlockText;
+        type?: "link" | "date" | "status" | "money" | "text" | "mono" | undefined;
+        value?: number | BlockText | null | undefined;
         id?: string | undefined;
         to?: string | undefined;
-        detail?: string | undefined;
+        detail?: BlockText | undefined;
         tone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | undefined;
         currency?: string | undefined;
     }[] | undefined;

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

@@ -8,6 +8,7 @@ const block_registry_1 = require("./block-registry");
 const display_1 = require("./display");
 const display_2 = require("./internal/display");
 const tone_1 = require("./types/tone");
+const composed_text_1 = require("./internal/composed-text");
 /**
  * How a value is drawn: `text` plain, `status` a tinted pill, `money` a
  * currency amount, `date` a localized date, `link` an accent link, `mono` an
@@ -54,9 +55,10 @@ function KeyValueList(options) {
 }
 const KeyValueListItemSchema = zod_1.z.object({
     id: (0, block_registry_1.ui)(zod_1.z.string().optional(), { label: "Key", advanced: true }),
-    label: (0, block_registry_1.ui)(zod_1.z.string(), { label: "Label" }),
-    value: (0, block_registry_1.ui)(zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).nullable().optional(), {
+    label: (0, block_registry_1.ui)((0, composed_text_1.blockTextSchema)(), { label: "Label", widget: "text" }),
+    value: (0, block_registry_1.ui)(zod_1.z.union([(0, composed_text_1.blockTextSchema)(), zod_1.z.number()]).nullable().optional(), {
         label: "Value",
+        widget: "text",
     }),
     type: (0, block_registry_1.ui)(zod_1.z.enum(exports.KEY_VALUE_TYPES).optional(), {
         label: "Type",
@@ -67,7 +69,7 @@ const KeyValueListItemSchema = zod_1.z.object({
         label: "Tone",
         widget: "select",
     }),
-    detail: (0, block_registry_1.ui)(zod_1.z.string().optional(), { label: "Detail" }),
+    detail: (0, block_registry_1.ui)((0, composed_text_1.blockTextSchema)().optional(), { label: "Detail", widget: "text" }),
     currency: (0, block_registry_1.ui)(zod_1.z.string().optional(), { label: "Currency", advanced: true }),
 });
 /** The options `KeyValueList` accepts. */

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":";;;AAuFA,oCASC;AAhGD,4CAAgD;AAChD,6BAAwB;AACxB,qDAA+E;AAC/E,uCAImB;AACnB,gDAA8C;AAC9C,uCAAgD;AAGhD;;;;GAIG;AACU,QAAA,eAAe,GAAG;IAC7B,MAAM;IACN,QAAQ;IACR,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;CACE,CAAC;AAuCX,MAAM,6BAA6B,GAAG,0BAA0B,CAAC;AACjE,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AAC/C,MAAM,uBAAuB,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAW,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,YAAY,CAC1B,OAA2B;IAE3B,OAAO,IAAI,4BAAgB,CAAoB,6BAA6B,CAAC;SAC1E,OAAO,CAAC,EAAE,GAAG,uBAAuB,EAAE,GAAG,OAAO,EAAE,CAAC;SACnD,IAAI,CAAC;QACJ,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,kBAAkB;QAC1C,IAAI,EAAE,mBAAmB;KAC1B,CAAC,CAAC;AACP,CAAC;AAED,MAAM,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC/D,KAAK,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IACzC,KAAK,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE;QACjE,KAAK,EAAE,OAAO;KACf,CAAC;IACF,IAAI,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,IAAI,CAAC,uBAAe,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC3C,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,QAAQ;KACjB,CAAC;IACF,EAAE,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC/D,IAAI,EAAE,IAAA,mBAAE,EAAC,IAAA,kBAAQ,EAAC,YAAK,CAAC,CAAC,QAAQ,EAAE,EAAE;QACnC,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,QAAQ;KACjB,CAAC;IACF,MAAM,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IACtD,QAAQ,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;CAC3E,CAA6C,CAAC;AAE/C,0CAA0C;AAC7B,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC,EAAE;QACtE,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,SAAS;KACjB,CAAC;IACF,KAAK,EAAE,IAAA,mBAAE,EACP,OAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAC1E,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CACpC;IACD,IAAI,EAAE,IAAA,yBAAe,EAAC,uBAAuB,CAAC,IAAI,CAAC;IACnD,KAAK,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE;QAC1D,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,QAAQ;KACjB,CAAC;IACF,OAAO,EAAE,IAAA,mBAAE,EACT,OAAC;SACE,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,CAAC,CAAC;SACN,OAAO,CAAC,uBAAuB,CAAC,OAAO,CAAC;SACxC,QAAQ,CAAC,0BAA0B,CAAC,EACvC,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CACxE;IACD,QAAQ,EAAE,IAAA,mBAAE,EACV,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC,EACnE,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,CAC3C;IACD,GAAG,IAAA,iCAAuB,GAAE;CAC7B,CAA8C,CAAC;AAEhD,IAAA,kCAAiB,EAAC;IAChB,IAAI,EAAE,cAAc;IACpB,aAAa,EAAE,6BAA6B;IAC5C,MAAM,EAAE,0BAAkB;IAC1B,IAAI,EAAE;QACJ,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,qDAAqD;QAClE,KAAK,EAAE,SAAS;KACjB;CACF,CAAC,CAAC"}
+{"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

@@ -62,7 +62,7 @@ export declare const KpiCardSchema: z.ZodObject<{
     fetchUrl?: string | undefined;
     fetchUrlMethod?: HttpMethod | undefined;
     periodScope?: string | undefined;
-    valueFormat?: "number" | "compact" | "percent" | "currency" | undefined;
+    valueFormat?: "number" | "percent" | "compact" | "currency" | undefined;
     currencyCode?: string | undefined;
     showDelta?: boolean | undefined;
     showSparkline?: boolean | undefined;
@@ -80,7 +80,7 @@ export declare const KpiCardSchema: z.ZodObject<{
     fetchUrl?: string | undefined;
     fetchUrlMethod?: HttpMethod | undefined;
     periodScope?: string | undefined;
-    valueFormat?: "number" | "compact" | "percent" | "currency" | undefined;
+    valueFormat?: "number" | "percent" | "compact" | "currency" | undefined;
     currencyCode?: string | undefined;
     showDelta?: boolean | undefined;
     showSparkline?: boolean | undefined;

package/dist/base/stat-group.d.ts

@@ -3,6 +3,7 @@ import { z } from "zod";
 import { type BlockItemsSource } from "./display";
 import { type Tone, type IconTone } from "./types/tone";
 import type { BaseComponentProps } from "./types";
+import type { BlockText } from "./types/composed-text";
 /** One cell of a stat group. */
 export interface StatGroupItem {
     /** Stable key; the position is used without one. */
@@ -14,12 +15,20 @@ export interface StatGroupItem {
      * cards layout.
      */
     tone?: IconTone;
-    /** Mono label above the value; `$`-prefixed for an i18n key. */
-    eyebrow: string;
-    /** The figure or the short state; a number is formatted for the locale. */
-    value: string | number;
-    /** One line under the value. */
-    detail?: string;
+    /**
+     * Mono label above the value; `$`-prefixed for an i18n key, or a
+     * `ComposedText`.
+     */
+    eyebrow: BlockText;
+    /**
+     * The figure or the short state; a number is formatted for the locale, and
+     * a `ComposedText` composes an amount, a date or a count in the
+     * reader's language (`{ key: "saas.stats.mrr", params: { amount: { type:
+     * "money", value: 92200, currency: "EUR" } } }`).
+     */
+    value: BlockText | number;
+    /** One line under the value: a string or a `ComposedText`. */
+    detail?: BlockText;
     /** Tone of the detail line (`neutral` = muted). */
     detailTone?: Tone;
     /** Route, `#anchor` or URL the whole cell links to. */
@@ -80,27 +89,27 @@ export declare const StatGroupSchema: z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         icon: z.ZodOptional<z.ZodString>;
         tone: z.ZodOptional<z.ZodEnum<["primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | "muted", ...("primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | "muted")[]]>>;
-        eyebrow: z.ZodString;
-        value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
-        detail: z.ZodOptional<z.ZodString>;
+        eyebrow: z.ZodType<BlockText, z.ZodTypeDef, BlockText>;
+        value: z.ZodUnion<[z.ZodType<BlockText, z.ZodTypeDef, BlockText>, z.ZodNumber]>;
+        detail: z.ZodOptional<z.ZodType<BlockText, z.ZodTypeDef, BlockText>>;
         detailTone: z.ZodOptional<z.ZodEnum<["primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral", ...("primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral")[]]>>;
         to: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        value: string | number;
-        eyebrow: string;
+        value: number | BlockText;
+        eyebrow: BlockText;
         id?: string | undefined;
         icon?: string | undefined;
         to?: string | undefined;
-        detail?: string | undefined;
+        detail?: BlockText | undefined;
         tone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | "muted" | undefined;
         detailTone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | undefined;
     }, {
-        value: string | number;
-        eyebrow: string;
+        value: number | BlockText;
+        eyebrow: BlockText;
         id?: string | undefined;
         icon?: string | undefined;
         to?: string | undefined;
-        detail?: string | undefined;
+        detail?: BlockText | undefined;
         tone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | "muted" | undefined;
         detailTone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | undefined;
     }>, "many">>;
@@ -110,12 +119,12 @@ export declare const StatGroupSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     layout: "cards" | "joined";
     items?: {
-        value: string | number;
-        eyebrow: string;
+        value: number | BlockText;
+        eyebrow: BlockText;
         id?: string | undefined;
         icon?: string | undefined;
         to?: string | undefined;
-        detail?: string | undefined;
+        detail?: BlockText | undefined;
         tone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | "muted" | undefined;
         detailTone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | undefined;
     }[] | undefined;
@@ -130,12 +139,12 @@ export declare const StatGroupSchema: z.ZodObject<{
     skeletonCount?: number | undefined;
 }, {
     items?: {
-        value: string | number;
-        eyebrow: string;
+        value: number | BlockText;
+        eyebrow: BlockText;
         id?: string | undefined;
         icon?: string | undefined;
         to?: string | undefined;
-        detail?: string | undefined;
+        detail?: BlockText | undefined;
         tone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | "muted" | undefined;
         detailTone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | undefined;
     }[] | undefined;

package/dist/base/stat-group.js

@@ -8,6 +8,7 @@ const block_registry_1 = require("./block-registry");
 const display_1 = require("./display");
 const display_2 = require("./internal/display");
 const tone_1 = require("./types/tone");
+const composed_text_1 = require("./internal/composed-text");
 /** How a stat group lays its cells out: see `StatGroupProps.layout`. */
 exports.STAT_GROUP_LAYOUTS = ["joined", "cards"];
 const STAT_GROUP_COMPONENT_NAME = "dms-stat-group-block";
@@ -44,11 +45,14 @@ const StatGroupItemSchema = zod_1.z.object({
         label: "Tone",
         widget: "select",
     }),
-    eyebrow: (0, block_registry_1.ui)(zod_1.z.string().describe("Mono label above the value."), {
+    eyebrow: (0, block_registry_1.ui)((0, composed_text_1.blockTextSchema)().describe("Mono label above the value."), {
         label: "Label",
+        widget: "text",
     }),
-    value: (0, block_registry_1.ui)(zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).describe("The figure or the state."), { label: "Value" }),
-    detail: (0, block_registry_1.ui)(zod_1.z.string().optional(), { label: "Detail" }),
+    value: (0, block_registry_1.ui)(zod_1.z
+        .union([(0, composed_text_1.blockTextSchema)(), zod_1.z.number()])
+        .describe("The figure or the state."), { label: "Value", widget: "text" }),
+    detail: (0, block_registry_1.ui)((0, composed_text_1.blockTextSchema)().optional(), { label: "Detail", widget: "text" }),
     detailTone: (0, block_registry_1.ui)((0, display_2.toneEnum)(tone_1.TONES).optional(), {
         label: "Detail tone",
         widget: "select",

package/dist/base/stat-group.js.map

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

package/dist/base/table-view/column-display.d.ts

@@ -1,4 +1,5 @@
 import { type Class, type ClassDecorator } from "@antelopejs/interface-core/decorators";
+import type { BlockText } from "../types/composed-text";
 import type { Tone } from "../types/tone";
 /**
  * How table cells (and expanded-row fields) draw a column's value, in place of
@@ -36,6 +37,39 @@ export interface ColumnDisplaySerialized {
 export declare const RegisterDisplay: (id: string) => ClassDecorator<Class<ColumnDisplay<object>>>;
 /** The tones of a cell's text. */
 export type CellTone = "default" | "muted" | "dimmed" | "highlighted" | "success" | "warning" | "error" | "info" | "primary";
+/**
+ * A cell's secondary line as a row field holds it, with the tone that row
+ * gives it: "Payment failed · retry Oct 10" in `error`, "Due Oct 28" in
+ * `muted`. The server picks the text and the tone per row; the column only
+ * names the field.
+ *
+ * @example
+ * ```ts
+ * @Listable(["status", "attemptCount", "nextPaymentAttemptAt"])
+ * get statusDetail(): CellSubline | null {
+ *   if (this.status !== "open" || !this.nextPaymentAttemptAt) return null;
+ *   const date = this.nextPaymentAttemptAt.toISOString();
+ *   return {
+ *     text: {
+ *       key: "$saas.invoice.sub_state.retry",
+ *       params: { date: { type: "date", value: date, format: "day" } },
+ *     },
+ *     tone: "error",
+ *   };
+ * }
+ * ```
+ */
+export interface CellSubline {
+    /** The line: a string (`$`-prefixed for an i18n key) or a composed text. */
+    text: BlockText;
+    /** Tone of the line; the display's own tone when left out. */
+    tone?: CellTone;
+}
+/**
+ * What a row field drawn as a cell's secondary line holds: a text, or a text
+ * and its tone. Nothing (`null`, `""`) draws no line.
+ */
+export type CellSublineValue = BlockText | CellSubline;
 export declare namespace DefaultDisplays {
     /** A badge an identity cell shows when a field of the row matches. */
     interface IdentityBadge {
@@ -55,8 +89,14 @@ export declare namespace DefaultDisplays {
         avatarField?: string;
         /** Icon drawn in a tile instead of an avatar. */
         icon?: string;
-        /** Row field drawn as the secondary line. */
+        /**
+         * Row field drawn as the secondary line: a string, drawn as written (an
+         * address, an id), or a `ComposedText` or {@link CellSubline}
+         * composed in the reader's language.
+         */
         subtitleField?: string;
+        /** Tone of the secondary line when the row gives none. Defaults to `dimmed`. */
+        subtitleTone?: CellTone;
         /** Row field holding the user id that marks the signed-in user's row. */
         selfField?: string;
         /** Tag of the signed-in user's row ("You"). `$`-prefixed: an i18n key. */
@@ -64,10 +104,18 @@ export declare namespace DefaultDisplays {
         badges?: IdentityBadge[];
         /** File storage the avatar is read from. */
         storage?: string;
+        /**
+         * Name drawn, muted, for a row without a value ("Automatic" for a credit
+         * note no operator issued). `$`-prefixed: an i18n key.
+         */
+        emptyLabel?: string;
+        /** Icon drawn in a tile for a row without a value (`i-ph-robot`). */
+        emptyIcon?: string;
     }
     /**
      * Avatar or icon tile, the value as the name, a "You" tag on the signed-in
-     * user's row, badges and a secondary line, all read off the row.
+     * user's row, badges and a secondary line, all read off the row; an empty
+     * label and icon for a row without a value.
      */
     class IdentityDisplay extends ColumnDisplay<IdentityDisplayOptions> {
     }
@@ -142,14 +190,43 @@ export declare namespace DefaultDisplays {
          * @example { healthy: "success", degraded: "warning", failing: "error" }
          */
         tones: Record<string, Tone>;
-        /** Row field drawn under the pill, in its tone (the failure's cause). */
+        /**
+         * Row field drawn under the pill (the failure's cause): a string
+         * (`$`-prefixed for an i18n key), a `ComposedText` or a
+         * {@link CellSubline} carrying its own tone.
+         */
         subField?: string;
+        /** Tone of the line under the pill when the row gives none; the pill's by default. */
+        subTone?: CellTone;
         /** A pulsing dot for these values (a run in progress). */
         liveValues?: string[];
     }
     /** A status as a tinted pill led by a dot, with an optional line under it. */
     class StatusPillDisplay extends ColumnDisplay<StatusPillDisplayOptions> {
     }
+    interface TwoLineDisplayOptions {
+        /**
+         * Row field holding the primary line, a string (`$`-prefixed for an i18n
+         * key) or a `ComposedText`, drawn in place of the column's value
+         * ("Renews in 3 days" over a `renewsAt` date column). Without it the
+         * primary line is the column's value, written by the column's own data
+         * type (an amount, a date, a select's label) or composed when the value
+         * is a `ComposedText`.
+         */
+        primaryField?: string;
+        /** Row field holding the secondary line: a {@link CellSublineValue}. */
+        subField?: string;
+        /** Tone of the secondary line when the row gives none. Defaults to `muted`. */
+        subTone?: CellTone;
+        /** Text drawn for an empty primary line. `$`-prefixed: an i18n key. Defaults to "—". */
+        emptyLabel?: string;
+    }
+    /**
+     * A primary line over a secondary one, without an avatar: a plan over its
+     * price per seat, an amount over what it means, a reason over its memo.
+     */
+    class TwoLineDisplay extends ColumnDisplay<TwoLineDisplayOptions> {
+    }
     interface ProgressDisplayOptions {
         /** Row field holding the number of items done. */
         doneField: string;

package/dist/base/table-view/column-display.js

@@ -47,7 +47,8 @@ var DefaultDisplays;
 (function (DefaultDisplays) {
     /**
      * Avatar or icon tile, the value as the name, a "You" tag on the signed-in
-     * user's row, badges and a secondary line, all read off the row.
+     * user's row, badges and a secondary line, all read off the row; an empty
+     * label and icon for a row without a value.
      */
     let IdentityDisplay = class IdentityDisplay extends ColumnDisplay {
     };
@@ -89,6 +90,16 @@ var DefaultDisplays;
         (0, exports.RegisterDisplay)("status_pill")
     ], StatusPillDisplay);
     DefaultDisplays.StatusPillDisplay = StatusPillDisplay;
+    /**
+     * A primary line over a secondary one, without an avatar: a plan over its
+     * price per seat, an amount over what it means, a reason over its memo.
+     */
+    let TwoLineDisplay = class TwoLineDisplay extends ColumnDisplay {
+    };
+    TwoLineDisplay = __decorate([
+        (0, exports.RegisterDisplay)("two_line")
+    ], TwoLineDisplay);
+    DefaultDisplays.TwoLineDisplay = TwoLineDisplay;
     /**
      * A bar filled with the share of items done ("31 / 44"), failed items in
      * red at its end; green once every item is done.

package/dist/base/table-view/column-display.js.map

@@ -1 +1 @@
-{"version":3,"file":"column-display.js","sourceRoot":"","sources":["../../../src/base/table-view/column-display.ts"],"names":[],"mappings":";;;;;;;;;AAAA,sEAI+C;AAE/C,8DAAuD;AAEvD;;;;;;;;;;;;;;;GAeG;AACH,MAAsB,aAAa;IAML;IAH5B,qEAAqE;IAClD,eAAe,GAAG,IAAI,CAAC;IAE1C,YAA4B,OAAiB;QAAjB,YAAO,GAAP,OAAO,CAAU;IAAG,CAAC;CAClD;AAPD,sCAOC;AASD;;;;;GAKG;AACU,QAAA,eAAe,GAEwB,IAAA,+BAAkB,EACpE,CAAC,MAAM,EAAE,EAAU,EAAE,EAAE;IACrB,2BAAU,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC,CACF,CAAC;AAcF,IAAiB,eAAe,CAkL/B;AAlLD,WAAiB,eAAe;IA+B9B;;;OAGG;IAEH,IAAa,eAAe,GAA5B,MAAa,eAAgB,SAAQ,aAAqC;KAAG,CAAA;IAAhE,eAAe;QAD3B,IAAA,uBAAe,EAAC,UAAU,CAAC;OACf,eAAe,CAAiD;IAAhE,+BAAe,kBAAiD,CAAA;IAoB7E;;;OAGG;IAEH,IAAa,YAAY,GAAzB,MAAa,YAAa,SAAQ,aAAkC;KAAG,CAAA;IAA1D,YAAY;QADxB,IAAA,uBAAe,EAAC,OAAO,CAAC;OACZ,YAAY,CAA8C;IAA1D,4BAAY,eAA8C,CAAA;IA2BvE;;;OAGG;IAEH,IAAa,mBAAmB,GAAhC,MAAa,mBAAoB,SAAQ,aAAyC;KAAG,CAAA;IAAxE,mBAAmB;QAD/B,IAAA,uBAAe,EAAC,eAAe,CAAC;OACpB,mBAAmB,CAAqD;IAAxE,mCAAmB,sBAAqD,CAAA;IAarF,0EAA0E;IAE1E,IAAa,gBAAgB,GAA7B,MAAa,gBAAiB,SAAQ,aAAsC;KAAG,CAAA;IAAlE,gBAAgB;QAD5B,IAAA,uBAAe,EAAC,WAAW,CAAC;OAChB,gBAAgB,CAAkD;IAAlE,gCAAgB,mBAAkD,CAAA;IAe/E,8EAA8E;IAE9E,IAAa,iBAAiB,GAA9B,MAAa,iBAAkB,SAAQ,aAAuC;KAAG,CAAA;IAApE,iBAAiB;QAD7B,IAAA,uBAAe,EAAC,aAAa,CAAC;OAClB,iBAAiB,CAAmD;IAApE,iCAAiB,oBAAmD,CAAA;IAWjF;;;OAGG;IAEH,IAAa,eAAe,GAA5B,MAAa,eAAgB,SAAQ,aAAqC;KAAG,CAAA;IAAhE,eAAe;QAD3B,IAAA,uBAAe,EAAC,UAAU,CAAC;OACf,eAAe,CAAiD;IAAhE,+BAAe,kBAAiD,CAAA;IAS7E,gEAAgE;IAEhE,IAAa,gBAAgB,GAA7B,MAAa,gBAAiB,SAAQ,aAAsC;KAAG,CAAA;IAAlE,gBAAgB;QAD5B,IAAA,uBAAe,EAAC,WAAW,CAAC;OAChB,gBAAgB,CAAkD;IAAlE,gCAAgB,mBAAkD,CAAA;IAU/E,6EAA6E;IAE7E,IAAa,eAAe,GAA5B,MAAa,eAAgB,SAAQ,aAAqC;KAAG,CAAA;IAAhE,eAAe;QAD3B,IAAA,uBAAe,EAAC,UAAU,CAAC;OACf,eAAe,CAAiD;IAAhE,+BAAe,kBAAiD,CAAA;IAE7E,oEAAoE;IAEpE,IAAa,YAAY,GAAzB,MAAa,YAAa,SAAQ,aAAoC;KAAG,CAAA;IAA5D,YAAY;QADxB,IAAA,uBAAe,EAAC,OAAO,CAAC;OACZ,YAAY,CAAgD;IAA5D,4BAAY,eAAgD,CAAA;IAOzE,wDAAwD;IAExD,IAAa,WAAW,GAAxB,MAAa,WAAY,SAAQ,aAAiC;KAAG,CAAA;IAAxD,WAAW;QADvB,IAAA,uBAAe,EAAC,MAAM,CAAC;OACX,WAAW,CAA6C;IAAxD,2BAAW,cAA6C,CAAA;AACvE,CAAC,EAlLgB,eAAe,+BAAf,eAAe,QAkL/B"}
+{"version":3,"file":"column-display.js","sourceRoot":"","sources":["../../../src/base/table-view/column-display.ts"],"names":[],"mappings":"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"}

package/dist/base/table-view/schema.d.ts

@@ -897,7 +897,7 @@ export declare const TableViewSchema: z.ZodObject<{
         countLabel?: string | undefined;
     } | undefined;
     labelKey?: string | undefined;
-    layout?: "full" | "compact" | undefined;
+    layout?: "compact" | "full" | undefined;
     card?: {
         component?: import("../..").Component<unknown> | undefined;
         fields?: string[] | undefined;
@@ -1093,7 +1093,7 @@ export declare const TableViewSchema: z.ZodObject<{
         countLabel?: string | undefined;
     } | undefined;
     labelKey?: string | undefined;
-    layout?: "full" | "compact" | undefined;
+    layout?: "compact" | "full" | undefined;
     card?: {
         component?: import("../..").Component<unknown> | undefined;
         fields?: string[] | undefined;

package/dist/base/top-list-card.d.ts

@@ -135,7 +135,7 @@ export declare const TopListCardSchema: z.ZodObject<{
     maxHeight?: string | undefined;
     skeletonCount?: number | undefined;
     periodScope?: string | undefined;
-    valueFormat?: "number" | "compact" | "percent" | "currency" | undefined;
+    valueFormat?: "number" | "percent" | "compact" | "currency" | undefined;
     currencyCode?: string | undefined;
     showDelta?: boolean | undefined;
     showSparkline?: boolean | undefined;
@@ -169,7 +169,7 @@ export declare const TopListCardSchema: z.ZodObject<{
     maxHeight?: string | undefined;
     skeletonCount?: number | undefined;
     periodScope?: string | undefined;
-    valueFormat?: "number" | "compact" | "percent" | "currency" | undefined;
+    valueFormat?: "number" | "percent" | "compact" | "currency" | undefined;
     currencyCode?: string | undefined;
     showDelta?: boolean | undefined;
     showSparkline?: boolean | undefined;

package/dist/base/types/composed-text.d.ts

@@ -0,0 +1,120 @@
+/**
+ * A text the dashboard composes in the reader's language: an i18n key and the
+ * raw values its message names, each formatted for the reader's locale, time
+ * zone and clock when the text is drawn. The server sends the values, never a
+ * finished sentence, so a route answers the same JSON whatever the language of
+ * the person reading it.
+ *
+ * The key is looked up like any `$`-prefixed text, with or without its `$`:
+ * `"saas.billing.retry"` and `"$saas.billing.retry"` are the same message.
+ * A key the active language lacks falls back to the fallback language, then to
+ * the bare key.
+ *
+ * Plurals follow vue-i18n: the message lists its forms split by `|`
+ * (`"no seat | {count} seat | {count} seats"`) and the number named by
+ * `plural` picks one — by default the first `count` parameter.
+ *
+ * @example
+ * ```typescript
+ * // "saas.banner.past_due": "Invoice {invoice} of {amount} failed, retry {date}"
+ * const text: ComposedText = {
+ *   key: "saas.banner.past_due",
+ *   params: {
+ *     invoice: "INV-0042",
+ *     amount: { type: "money", value: 2900, currency: "EUR" },
+ *     date: { type: "date", value: "2026-10-10", format: "day" },
+ *   },
+ * };
+ * ```
+ */
+export interface ComposedText {
+    /** The i18n key of the message; the leading `$` is optional. */
+    key: string;
+    /** The values the message names, by the name it gives them. */
+    params?: Record<string, ComposedTextParam>;
+    /**
+     * The parameter whose number picks the plural form. Defaults to the first
+     * `count` parameter; without one the message is not pluralised.
+     */
+    plural?: string;
+}
+/**
+ * An amount in the minor unit of its currency (cents for `EUR`, yen for
+ * `JPY`), written with the currency's symbol in the reader's locale:
+ * `{ type: "money", value: 92200, currency: "EUR" }` reads "€922.00" in
+ * English, "922,00 €" in French.
+ */
+export interface ComposedTextMoneyParam {
+    type: "money";
+    /** The amount in minor units: an integer, the way payment providers store it. */
+    value: number;
+    /** ISO 4217 code. An unknown code writes the amount as a plain number. */
+    currency: string;
+}
+/** How much of a date a `date` or `datetime` parameter writes. */
+export declare const COMPOSED_TEXT_DATE_FORMATS: readonly ["day", "short", "medium", "long"];
+/**
+ * `day`: day and month ("Oct 10"); `short`: numeric ("10/10/2026");
+ * `medium`: the month abbreviated ("Oct 10, 2026"); `long`: the month in
+ * full ("October 10, 2026").
+ */
+export type ComposedTextDateFormat = (typeof COMPOSED_TEXT_DATE_FORMATS)[number];
+/**
+ * A date (`date`), or a date and its time (`datetime`), in the reader's
+ * language, time zone and date format preference.
+ */
+export interface ComposedTextDateParam {
+    type: "date" | "datetime";
+    /** An ISO 8601 string or a timestamp in milliseconds. */
+    value: string | number;
+    /** Defaults to `medium`. */
+    format?: ComposedTextDateFormat;
+}
+/**
+ * The distance from now, past or future, in the largest whole unit: "in 3
+ * days", "tomorrow", "2 hours ago". It is computed when the text is drawn.
+ */
+export interface ComposedTextRelativeDateParam {
+    type: "relative";
+    /** An ISO 8601 string or a timestamp in milliseconds. */
+    value: string | number;
+}
+/** How a `number` parameter is written. */
+export declare const COMPOSED_TEXT_NUMBER_FORMATS: readonly ["decimal", "percent", "compact"];
+/**
+ * `decimal`: grouped digits ("1,284.5"); `percent`: a ratio as a percentage
+ * (`0.25` → "25%"); `compact`: a short form ("1.3K").
+ */
+export type ComposedTextNumberFormat = (typeof COMPOSED_TEXT_NUMBER_FORMATS)[number];
+/** A number written for the reader's locale. */
+export interface ComposedTextNumberParam {
+    type: "number";
+    value: number;
+    /** Defaults to `decimal`. */
+    format?: ComposedTextNumberFormat;
+}
+/**
+ * A count: written like a number, and the parameter that picks the plural
+ * form of the message unless `ComposedText.plural` names another one.
+ */
+export interface ComposedTextCountParam {
+    type: "count";
+    value: number;
+}
+/** A parameter that says how its value is written. */
+export type ComposedTextTypedParam = ComposedTextMoneyParam | ComposedTextDateParam | ComposedTextRelativeDateParam | ComposedTextNumberParam | ComposedTextCountParam;
+/** The `type` of a typed parameter. */
+export type ComposedTextParamType = ComposedTextTypedParam["type"];
+/**
+ * A value a composed text names. A string is inserted as written — it is
+ * data (an invoice number, a plan name), not a key; a bare number is written
+ * for the locale; a typed parameter is formatted by its `type`; a nested
+ * `ComposedText` is composed first ("Business · {seats}" inside a sentence).
+ */
+export type ComposedTextParam = string | number | ComposedTextTypedParam | ComposedText;
+/**
+ * Any text a block draws: a plain string, `$`-prefixed for an i18n key, or a
+ * {@link ComposedText}. Every option and fetched field typed `BlockText`
+ * accepts both, so a route can answer either.
+ */
+export type BlockText = string | ComposedText;

package/dist/base/types/composed-text.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMPOSED_TEXT_NUMBER_FORMATS = exports.COMPOSED_TEXT_DATE_FORMATS = void 0;
+/** How much of a date a `date` or `datetime` parameter writes. */
+exports.COMPOSED_TEXT_DATE_FORMATS = [
+    "day",
+    "short",
+    "medium",
+    "long",
+];
+/** How a `number` parameter is written. */
+exports.COMPOSED_TEXT_NUMBER_FORMATS = [
+    "decimal",
+    "percent",
+    "compact",
+];
+//# sourceMappingURL=composed-text.js.map

package/dist/base/types/composed-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composed-text.js","sourceRoot":"","sources":["../../../src/base/types/composed-text.ts"],"names":[],"mappings":";;;AAuDA,kEAAkE;AACrD,QAAA,0BAA0B,GAAG;IACxC,KAAK;IACL,OAAO;IACP,QAAQ;IACR,MAAM;CACE,CAAC;AAgCX,2CAA2C;AAC9B,QAAA,4BAA4B,GAAG;IAC1C,SAAS;IACT,SAAS;IACT,SAAS;CACD,CAAC"}

package/dist/base/types/index.d.ts

@@ -1,6 +1,7 @@
 export * from "./base-component-props";
 export * from "./button";
 export * from "./color";
+export * from "./composed-text";
 export * from "./component-input";
 export * from "./confirm-dialog";
 export * from "./custom-button";

package/dist/base/types/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./base-component-props"), exports);
 __exportStar(require("./button"), exports);
 __exportStar(require("./color"), exports);
+__exportStar(require("./composed-text"), exports);
 __exportStar(require("./component-input"), exports);
 __exportStar(require("./confirm-dialog"), exports);
 __exportStar(require("./custom-button"), exports);

package/dist/base/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/base/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,2CAAyB;AACzB,0CAAwB;AACxB,oDAAkC;AAClC,mDAAiC;AACjC,kDAAgC;AAChC,gDAA8B;AAC9B,0CAAwB;AACxB,kDAAgC;AAChC,iDAA+B;AAC/B,8CAA4B;AAC5B,gDAA8B;AAC9B,yCAAuB;AACvB,yCAAuB;AACvB,gDAA8B;AAC9B,sDAAoC;AACpC,yCAAuB;AACvB,yCAAuB;AACvB,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/base/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,2CAAyB;AACzB,0CAAwB;AACxB,kDAAgC;AAChC,oDAAkC;AAClC,mDAAiC;AACjC,kDAAgC;AAChC,gDAA8B;AAC9B,0CAAwB;AACxB,kDAAgC;AAChC,iDAA+B;AAC/B,8CAA4B;AAC5B,gDAA8B;AAC9B,yCAAuB;AACvB,yCAAuB;AACvB,gDAA8B;AAC9B,sDAAoC;AACpC,yCAAuB;AACvB,yCAAuB;AACvB,0CAAwB"}

package/dist/layout-banners.d.ts

@@ -1,5 +1,7 @@
 import { RegisteringProxy } from "@antelopejs/interface-core";
 import type { User } from "./auth/db";
+import type { BlockLinkAction } from "./base/display";
+import type { BlockText } from "./base/types/composed-text";
 import type { MaybePromise } from "./types";
 /**
  * Semantic look of a layout banner. It also picks the banner's ARIA role:
@@ -13,8 +15,8 @@ export declare const LayoutBannerVariant: {
 };
 export type LayoutBannerVariant = (typeof LayoutBannerVariant)[keyof typeof LayoutBannerVariant];
 /**
- * What a banner's `visible` resolver decides on: the request the site layout
- * is being built for.
+ * What a banner's `visible` or `resolve` resolver decides on: the request the
+ * site layout is being built for.
  */
 export interface LayoutBannerContext {
     /** Undefined for an unauthenticated request. */
@@ -41,6 +43,31 @@ export interface LayoutBannerContext {
  * does not answer within two seconds, hides its banner for that request.
  */
 export type LayoutBannerVisibility = (context: LayoutBannerContext) => MaybePromise<boolean>;
+/**
+ * What a text banner shows: its message and, after it, link buttons.
+ */
+export interface LayoutBannerContent {
+    /**
+     * The message: a `$`-prefixed value resolves as an i18n key, and a
+     * `ComposedText` is composed in the reader's language from the raw values
+     * it carries — an amount, a date, a count.
+     */
+    text: BlockText;
+    /**
+     * Link buttons after the message; the last one is the main action. Their
+     * labels follow the `$` convention.
+     */
+    actions?: BlockLinkAction[];
+}
+/**
+ * Builds a banner's content per request, or answers `undefined` to hide it:
+ * the visibility and the message in one read, for a banner whose message
+ * names the state that makes it show (an invoice number, the amount due, the
+ * date the workspace is suspended). Runs where and when a
+ * {@link LayoutBannerVisibility} does, under the same two-second budget: a
+ * resolver that throws or does not answer hides its banner for that request.
+ */
+export type LayoutBannerResolver = (context: LayoutBannerContext) => MaybePromise<LayoutBannerContent | undefined>;
 interface LayoutBannerBase {
     /**
      * Unique key of the banner across the deployment: re-registering a key
@@ -62,18 +89,19 @@ interface LayoutBannerBase {
      * leaves the banner out. Defaults to `false`.
      */
     dismissible?: boolean;
+}
+interface LayoutBannerStaticBase extends LayoutBannerBase {
     /** Absent means the banner shows on every request. */
     visible?: LayoutBannerVisibility;
+    resolve?: never;
 }
-/** A banner showing a line of text. */
-export interface LayoutBannerTextInfo extends LayoutBannerBase {
-    /** The message. A `$`-prefixed value resolves as an i18n key. */
-    text: string;
+/** A banner showing a fixed message, and optionally link buttons. */
+export interface LayoutBannerTextInfo extends LayoutBannerStaticBase, LayoutBannerContent {
     component?: never;
     props?: never;
 }
 /** A banner mounting a component of a frontend layer as its content. */
-export interface LayoutBannerComponentInfo extends LayoutBannerBase {
+export interface LayoutBannerComponentInfo extends LayoutBannerStaticBase {
     /**
      * Name of a global component, provided by a frontend layer, rendered as the
      * banner's content. The DMS still draws the chrome: color, icon, dismiss
@@ -83,21 +111,56 @@ export interface LayoutBannerComponentInfo extends LayoutBannerBase {
     /** Props passed to the component. Must be serializable. */
     props?: Record<string, unknown>;
     text?: never;
+    actions?: never;
+}
+/**
+ * A banner whose message and buttons are built per request by `resolve`,
+ * which also decides whether it shows.
+ *
+ * @example
+ * ```typescript
+ * RegisterLayoutBanner({
+ *   key: "saas:past-due",
+ *   variant: LayoutBannerVariant.ERROR,
+ *   resolve: async ({ tenantId }) => {
+ *     const invoice = await openInvoice(tenantId);
+ *     if (!invoice) return undefined;
+ *     return {
+ *       text: {
+ *         key: "saas.banner.past_due",
+ *         params: {
+ *           amount: { type: "money", value: invoice.due, currency: invoice.currency },
+ *           date: { type: "date", value: invoice.retryAt, format: "day" },
+ *         },
+ *       },
+ *       actions: [{ label: "$saas.banner.pay", to: "/settings/workspace/billing" }],
+ *     };
+ *   },
+ * });
+ * ```
+ */
+export interface LayoutBannerResolvedInfo extends LayoutBannerBase {
+    resolve: LayoutBannerResolver;
+    visible?: never;
+    text?: never;
+    actions?: never;
+    component?: never;
+    props?: never;
 }
 /**
  * A global banner rendered under the header of the dashboard layout, on every
  * page — tenant pages and module back-office pages alike.
  */
-export type LayoutBannerInfo = LayoutBannerTextInfo | LayoutBannerComponentInfo;
+export type LayoutBannerInfo = LayoutBannerTextInfo | LayoutBannerComponentInfo | LayoutBannerResolvedInfo;
 /** @internal */
 export declare namespace internal {
     const RegisterLayoutBanner: RegisteringProxy<(info: LayoutBannerInfo) => void>;
 }
 /**
  * Register a global banner under the dashboard header. Banners stack by
- * `order`, and each one's `visible` resolver is evaluated server-side for every
- * site layout request, so the banner is in the server-rendered page. When the
- * state a resolver reads changes, call `NotifyMenuChanged(tenantId)` so the
+ * `order`, and each one's `visible` or `resolve` resolver is evaluated
+ * server-side for every site layout request, so the banner is in the
+ * server-rendered page. When the state a resolver reads changes, call `NotifyMenuChanged(tenantId)` so the
  * connected clients re-fetch their site layout.
  *
  * The registration is dropped automatically when the registering module stops.

package/dist/layout-banners.js

@@ -20,9 +20,9 @@ var internal;
 })(internal || (exports.internal = internal = {}));
 /**
  * Register a global banner under the dashboard header. Banners stack by
- * `order`, and each one's `visible` resolver is evaluated server-side for every
- * site layout request, so the banner is in the server-rendered page. When the
- * state a resolver reads changes, call `NotifyMenuChanged(tenantId)` so the
+ * `order`, and each one's `visible` or `resolve` resolver is evaluated
+ * server-side for every site layout request, so the banner is in the
+ * server-rendered page. When the state a resolver reads changes, call `NotifyMenuChanged(tenantId)` so the
  * connected clients re-fetch their site layout.
  *
  * The registration is dropped automatically when the registering module stops.

package/dist/layout-banners.js.map

@@ -1 +1 @@
-{"version":3,"file":"layout-banners.js","sourceRoot":"","sources":["../src/layout-banners.ts"],"names":[],"mappings":";;;AA0HA,oDAGC;AA7HD,+DAA8D;AAI9D;;;;GAIG;AACU,QAAA,mBAAmB,GAAG;IACjC,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;CACN,CAAC;AA0FX,gBAAgB;AAChB,IAAiB,QAAQ,CAIxB;AAJD,WAAiB,QAAQ;IACV,6BAAoB,GAAG,IAAI,iCAAgB,EAErD,CAAC;AACN,CAAC,EAJgB,QAAQ,wBAAR,QAAQ,QAIxB;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,oBAAoB,CAAC,IAAsB;IACzD,QAAQ,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"layout-banners.js","sourceRoot":"","sources":["../src/layout-banners.ts"],"names":[],"mappings":";;;AAmMA,oDAGC;AAtMD,+DAA8D;AAM9D;;;;GAIG;AACU,QAAA,mBAAmB,GAAG;IACjC,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;CACN,CAAC;AAiKX,gBAAgB;AAChB,IAAiB,QAAQ,CAIxB;AAJD,WAAiB,QAAQ;IACV,6BAAoB,GAAG,IAAI,iCAAgB,EAErD,CAAC;AACN,CAAC,EAJgB,QAAQ,wBAAR,QAAQ,QAIxB;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,oBAAoB,CAAC,IAAsB;IACzD,QAAQ,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antelopejs/interface-dms",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Public AntelopeJS interfaces of the DMS: pages, components, permissions, tenancy, auth, notifications and HTML rendering.",
   "keywords": [
     "antelopejs",