@antelopejs/interface-dms 0.7.4 → 0.8.0

package/dist/base/live-toggle.d.ts

@@ -11,6 +11,9 @@ export type LiveToggleAlign = (typeof LIVE_TOGGLE_ALIGNS)[number];
  */
 export declare const LIVE_TOGGLE_VARIANTS: readonly ["segmented", "pill"];
 export type LiveToggleVariant = (typeof LIVE_TOGGLE_VARIANTS)[number];
+/** How large the toggle and its texts are drawn. */
+export declare const LIVE_TOGGLE_SIZES: readonly ["xs", "sm", "md"];
+export type LiveToggleSize = (typeof LIVE_TOGGLE_SIZES)[number];
 export interface LiveToggleProps extends BaseComponentProps {
     align?: LiveToggleAlign;
     /**
@@ -20,6 +23,11 @@ export interface LiveToggleProps extends BaseComponentProps {
     showUpdatedAt?: boolean;
     /** How the toggle is drawn (see {@link LiveToggleVariant}). Defaults to `segmented`. */
     variant?: LiveToggleVariant;
+    /**
+     * How large it is drawn, either variant. Defaults to the size of the
+     * `PageToolbar` holding it, else `sm`.
+     */
+    size?: LiveToggleSize;
     /**
      * What the paused toggle calls the events it missed: an i18n key (prefixed
      * with `$`) or a text, given `{count}` and pluralised on it, e.g.
@@ -54,13 +62,16 @@ export declare const LiveToggleSchema: z.ZodObject<{
     align: z.ZodOptional<z.ZodEnum<["left", "center", "right"]>>;
     showUpdatedAt: z.ZodOptional<z.ZodBoolean>;
     variant: z.ZodOptional<z.ZodEnum<["segmented", "pill"]>>;
+    size: z.ZodOptional<z.ZodEnum<["xs", "sm", "md"]>>;
     missedLabel: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    size?: "xs" | "sm" | "md" | undefined;
     variant?: "segmented" | "pill" | undefined;
     align?: "left" | "right" | "center" | undefined;
     showUpdatedAt?: boolean | undefined;
     missedLabel?: string | undefined;
 }, {
+    size?: "xs" | "sm" | "md" | undefined;
     variant?: "segmented" | "pill" | undefined;
     align?: "left" | "right" | "center" | undefined;
     showUpdatedAt?: boolean | undefined;

package/dist/base/live-toggle.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LiveToggleSchema = exports.LIVE_TOGGLE_VARIANTS = exports.LIVE_TOGGLE_ALIGNS = void 0;
+exports.LiveToggleSchema = exports.LIVE_TOGGLE_SIZES = exports.LIVE_TOGGLE_VARIANTS = exports.LIVE_TOGGLE_ALIGNS = void 0;
 exports.LiveToggle = LiveToggle;
 const zod_1 = require("zod");
 const component_1 = require("../component");
@@ -13,6 +13,8 @@ exports.LIVE_TOGGLE_ALIGNS = ["left", "center", "right"];
  * button, and a Resume button while paused.
  */
 exports.LIVE_TOGGLE_VARIANTS = ["segmented", "pill"];
+/** How large the toggle and its texts are drawn. */
+exports.LIVE_TOGGLE_SIZES = ["xs", "sm", "md"];
 const LIVE_TOGGLE_COMPONENT_NAME = "dms-live-toggle-block";
 /**
  * The Live / Pause switch of a page declared with `live` (see
@@ -56,6 +58,11 @@ exports.LiveToggleSchema = zod_1.z.object({
         group: "appearance",
         widget: "segmented",
     }),
+    size: (0, block_registry_1.ui)(zod_1.z.enum(exports.LIVE_TOGGLE_SIZES).optional(), {
+        label: "Size",
+        group: "appearance",
+        widget: "segmented",
+    }),
     missedLabel: (0, block_registry_1.ui)(zod_1.z
         .string()
         .optional()

package/dist/base/live-toggle.js.map

@@ -1 +1 @@
-{"version":3,"file":"live-toggle.js","sourceRoot":"","sources":["../../src/base/live-toggle.ts"],"names":[],"mappings":";;;AAyDA,gCAMC;AA/DD,6BAAwB;AACxB,4CAAgD;AAChD,qDAA+E;AAG/E,wCAAwC;AAC3B,QAAA,kBAAkB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AAGvE;;;;GAIG;AACU,QAAA,oBAAoB,GAAG,CAAC,WAAW,EAAE,MAAM,CAAU,CAAC;AAoBnE,MAAM,0BAA0B,GAAG,uBAAuB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,UAAU,CACxB,OAAyB;IAEzB,OAAO,IAAI,4BAAgB,CAAkB,0BAA0B,CAAC;SACrE,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC;SACvB,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,wCAAwC;AAC3B,QAAA,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,IAAI,CAAC,0BAAkB,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC/C,KAAK,EAAE,WAAW;QAClB,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,WAAW;KACpB,CAAC;IACF,aAAa,EAAE,IAAA,mBAAE,EACf,OAAC;SACE,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,iDAAiD,CAAC,EAC9D,EAAE,KAAK,EAAE,sBAAsB,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,CACzE;IACD,OAAO,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,IAAI,CAAC,4BAAoB,CAAC,CAAC,QAAQ,EAAE,EAAE;QACnD,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,WAAW;KACpB,CAAC;IACF,WAAW,EAAE,IAAA,mBAAE,EACb,OAAC;SACE,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,gEAAgE,CACjE,EACH,EAAE,KAAK,EAAE,qBAAqB,EAAE,KAAK,EAAE,SAAS,EAAE,CACnD;CACF,CAA4C,CAAC;AAE9C,IAAA,kCAAiB,EAAC;IAChB,IAAI,EAAE,YAAY;IAClB,aAAa,EAAE,0BAA0B;IACzC,MAAM,EAAE,wBAAgB;IACxB,IAAI,EAAE;QACJ,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,0EAA0E;QAC5E,KAAK,EAAE,MAAM;KACd;CACF,CAAC,CAAC"}
+{"version":3,"file":"live-toggle.js","sourceRoot":"","sources":["../../src/base/live-toggle.ts"],"names":[],"mappings":";;;AAkEA,gCAMC;AAxED,6BAAwB;AACxB,4CAAgD;AAChD,qDAA+E;AAG/E,wCAAwC;AAC3B,QAAA,kBAAkB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AAGvE;;;;GAIG;AACU,QAAA,oBAAoB,GAAG,CAAC,WAAW,EAAE,MAAM,CAAU,CAAC;AAGnE,oDAAoD;AACvC,QAAA,iBAAiB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAyB7D,MAAM,0BAA0B,GAAG,uBAAuB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,UAAU,CACxB,OAAyB;IAEzB,OAAO,IAAI,4BAAgB,CAAkB,0BAA0B,CAAC;SACrE,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC;SACvB,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,wCAAwC;AAC3B,QAAA,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,IAAI,CAAC,0BAAkB,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC/C,KAAK,EAAE,WAAW;QAClB,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,WAAW;KACpB,CAAC;IACF,aAAa,EAAE,IAAA,mBAAE,EACf,OAAC;SACE,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,iDAAiD,CAAC,EAC9D,EAAE,KAAK,EAAE,sBAAsB,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,CACzE;IACD,OAAO,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,IAAI,CAAC,4BAAoB,CAAC,CAAC,QAAQ,EAAE,EAAE;QACnD,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,WAAW;KACpB,CAAC;IACF,IAAI,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,IAAI,CAAC,yBAAiB,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC7C,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,WAAW;KACpB,CAAC;IACF,WAAW,EAAE,IAAA,mBAAE,EACb,OAAC;SACE,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,gEAAgE,CACjE,EACH,EAAE,KAAK,EAAE,qBAAqB,EAAE,KAAK,EAAE,SAAS,EAAE,CACnD;CACF,CAA4C,CAAC;AAE9C,IAAA,kCAAiB,EAAC;IAChB,IAAI,EAAE,YAAY;IAClB,aAAa,EAAE,0BAA0B;IACzC,MAAM,EAAE,wBAAgB;IACxB,IAAI,EAAE;QACJ,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,0EAA0E;QAC5E,KAAK,EAAE,MAAM;KACd;CACF,CAAC,CAAC"}

package/dist/base/page-toolbar.d.ts

@@ -0,0 +1,158 @@
+import { z } from "zod";
+import { type Component, ComponentBuilder, type ComponentMetadata } from "../component";
+import type { MaybePromise } from "../types";
+import { type LiveToggleProps } from "./live-toggle";
+import { type PeriodSelectorProps } from "./period-selector";
+import type { BaseComponentProps } from "./types";
+/** How large the toolbar draws its controls, its children's by default. */
+export declare const PAGE_TOOLBAR_SIZES: readonly ["xs", "sm", "md"];
+export type PageToolbarSize = (typeof PAGE_TOOLBAR_SIZES)[number];
+export interface PageToolbarProps extends BaseComponentProps {
+    /**
+     * The size of the `LiveToggle` and `PeriodSelector` it holds, and of its
+     * own "updated" label, unless a child sets its own. Defaults to `sm`.
+     */
+    size?: PageToolbarSize;
+    /**
+     * On a page without `live` (or without a `LiveToggle` in the toolbar),
+     * shows how long ago the page last read its data ("updated 12 s ago"),
+     * where the toggle would sit. Defaults to true.
+     */
+    showUpdatedAt?: boolean;
+    /**
+     * On a page without `live` (or without a `LiveToggle` in the toolbar), a
+     * button beside the "updated" label reading every block of the page
+     * again. Defaults to true.
+     */
+    refresh?: boolean;
+}
+/**
+ * The context bar of a page with a period or live data, first in its body,
+ * under the page header: its own children on the left (a scope chip, a
+ * picker), then on the right, whatever order they were added in, the time
+ * since the page last read its data, the `LiveToggle` (Direct / Pause) and
+ * the `PeriodSelector` (its window, its comparison, its presets), all at one
+ * `size`. It wraps onto more lines on a narrow screen.
+ *
+ * On a page without `live` it shows "updated 12 s ago" and a refresh button
+ * where the toggle would be (see `showUpdatedAt`, `refresh`); a `LiveToggle`
+ * there draws nothing.
+ *
+ * Its children are ordinary blocks, with ids of their own: `pageToolbar()`
+ * builds one with the usual defaults.
+ *
+ * ```ts
+ * static toolbar = PageToolbar()
+ *   .child("scope", scopeChip())
+ *   .child("live", LiveToggle({ variant: "pill" }))
+ *   .child("period", PeriodSelector({ variant: "segmented" }));
+ * ```
+ */
+export declare function PageToolbar(options?: PageToolbarProps): ComponentBuilder<PageToolbarProps>;
+/**
+ * How `pageToolbar()` places one of its own children (the `LiveToggle`, the
+ * `PeriodSelector`), besides the control's options: the child id roles and
+ * permissions name it by, and the metadata the roles editor shows for it.
+ */
+export interface PageToolbarChildOptions<P = Record<string, unknown>> {
+    /**
+     * The child id under the toolbar. Defaults to `live` for the toggle and
+     * `period` for the selector; set it to keep an id roles already grant
+     * (a page that had its toggle under `toggle`).
+     */
+    childId?: string;
+    /** The child's name, description and icon in the roles editor. */
+    meta?: Partial<ComponentMetadata>;
+    /**
+     * Changes the control's options each time the page is registered, as
+     * `ComponentBuilder.transformOptions` does: for what is only known once
+     * the module is configured (a retention read in `construct()`, after the
+     * page class was built). It receives the options over the defaults and
+     * returns new ones, without mutating them. The comparison control the
+     * helper derived from `comparisons` at build time is not derived again.
+     */
+    transformOptions?: (options: P | undefined) => MaybePromise<P | undefined>;
+}
+/** The `live` entry of {@link PageToolbarOptions}. */
+export type PageToolbarLiveOptions = LiveToggleProps & PageToolbarChildOptions<LiveToggleProps>;
+/** The `period` entry of {@link PageToolbarOptions}. */
+export type PageToolbarPeriodOptions = PeriodSelectorProps & PageToolbarChildOptions<PeriodSelectorProps>;
+/** What `pageToolbar()` puts in the toolbar. */
+export interface PageToolbarOptions extends PageToolbarProps {
+    /**
+     * The blocks on the left, keyed by child id, in order: a scope chip, a
+     * picker, a badge. Their ids are the ones permissions name them by.
+     */
+    leading?: Record<string, Component>;
+    /**
+     * The `LiveToggle` (child id `live`), over the defaults of
+     * {@link PAGE_TOOLBAR_LIVE_DEFAULTS}; `false` leaves it out. Kept by
+     * default: it draws nothing on a page without `live`. `childId` and `meta`
+     * place the child (see {@link PageToolbarChildOptions}).
+     */
+    live?: PageToolbarLiveOptions | false;
+    /**
+     * The `PeriodSelector` (child id `period`), over the defaults of
+     * {@link PAGE_TOOLBAR_PERIOD_DEFAULTS}; `false` leaves it out, for a page
+     * without a period. `childId` and `meta` place the child (see
+     * {@link PageToolbarChildOptions}); `id` stays the period scope's id.
+     */
+    period?: PageToolbarPeriodOptions | false;
+}
+/** The `LiveToggle` of `pageToolbar()` unless its `live` says otherwise. */
+export declare const PAGE_TOOLBAR_LIVE_DEFAULTS: LiveToggleProps;
+/**
+ * The `PeriodSelector` of `pageToolbar()` unless its `period` says otherwise:
+ * the start of the window from now ("since yesterday 11:29"), then the
+ * 1H / 24H / 7D / 30D presets, on the last 24 hours by default. Its
+ * comparison control depends on what the period offers: a menu naming the
+ * compared window ("vs 16 – 17 Oct ▾") for more than one choice, `none`
+ * included, on its first comparison besides `none`; none for a single
+ * comparison, which then stays on and reads "vs …" beside the window.
+ */
+export declare const PAGE_TOOLBAR_PERIOD_DEFAULTS: PeriodSelectorProps;
+/** The child id of the toolbar's `LiveToggle` unless `live.childId` says otherwise. */
+export declare const PAGE_TOOLBAR_LIVE_CHILD_ID = "live";
+/** The child id of the toolbar's `PeriodSelector` unless `period.childId` says otherwise. */
+export declare const PAGE_TOOLBAR_PERIOD_CHILD_ID = "period";
+/**
+ * A `PageToolbar` with its usual children: `leading` on the left, then the
+ * `LiveToggle` as a pill (`live`) and the `PeriodSelector` as segmented
+ * presets (`period`), each over its defaults. A page puts it first:
+ *
+ * ```ts
+ * static toolbar = pageToolbar({
+ *   leading: { scope: scopeChip() },
+ *   live: { missedLabel: "$api.live.new_requests" },
+ *   period: {
+ *     id: "api",
+ *     rememberKey: "api",
+ *     comparisons: ["previous-period"],
+ *   },
+ * });
+ * ```
+ *
+ * Each control keeps the id and the roles-editor metadata a page gives it:
+ *
+ * ```ts
+ * static toolbar = pageToolbar({
+ *   live: { childId: "toggle", meta: { name: "$my.permissions.live.name" } },
+ *   period: { id: "my-scope", meta: { name: "$my.permissions.period.name" } },
+ * }).meta({ name: "$my.permissions.toolbar.name" });
+ * ```
+ */
+export declare function pageToolbar(options?: PageToolbarOptions): ComponentBuilder<PageToolbarProps>;
+/** The options `PageToolbar` accepts. */
+export declare const PageToolbarSchema: z.ZodObject<{
+    size: z.ZodOptional<z.ZodEnum<["xs", "sm", "md"]>>;
+    showUpdatedAt: z.ZodOptional<z.ZodBoolean>;
+    refresh: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    size?: "xs" | "sm" | "md" | undefined;
+    showUpdatedAt?: boolean | undefined;
+    refresh?: boolean | undefined;
+}, {
+    size?: "xs" | "sm" | "md" | undefined;
+    showUpdatedAt?: boolean | undefined;
+    refresh?: boolean | undefined;
+}>;

package/dist/base/page-toolbar.js

@@ -0,0 +1,198 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PageToolbarSchema = exports.PAGE_TOOLBAR_PERIOD_CHILD_ID = exports.PAGE_TOOLBAR_LIVE_CHILD_ID = exports.PAGE_TOOLBAR_PERIOD_DEFAULTS = exports.PAGE_TOOLBAR_LIVE_DEFAULTS = exports.PAGE_TOOLBAR_SIZES = void 0;
+exports.PageToolbar = PageToolbar;
+exports.pageToolbar = pageToolbar;
+const zod_1 = require("zod");
+const component_1 = require("../component");
+const block_registry_1 = require("./block-registry");
+const live_toggle_1 = require("./live-toggle");
+const period_selector_1 = require("./period-selector");
+/** How large the toolbar draws its controls, its children's by default. */
+exports.PAGE_TOOLBAR_SIZES = ["xs", "sm", "md"];
+const PAGE_TOOLBAR_COMPONENT_NAME = "dms-page-toolbar-block";
+/**
+ * The context bar of a page with a period or live data, first in its body,
+ * under the page header: its own children on the left (a scope chip, a
+ * picker), then on the right, whatever order they were added in, the time
+ * since the page last read its data, the `LiveToggle` (Direct / Pause) and
+ * the `PeriodSelector` (its window, its comparison, its presets), all at one
+ * `size`. It wraps onto more lines on a narrow screen.
+ *
+ * On a page without `live` it shows "updated 12 s ago" and a refresh button
+ * where the toggle would be (see `showUpdatedAt`, `refresh`); a `LiveToggle`
+ * there draws nothing.
+ *
+ * Its children are ordinary blocks, with ids of their own: `pageToolbar()`
+ * builds one with the usual defaults.
+ *
+ * ```ts
+ * static toolbar = PageToolbar()
+ *   .child("scope", scopeChip())
+ *   .child("live", LiveToggle({ variant: "pill" }))
+ *   .child("period", PeriodSelector({ variant: "segmented" }));
+ * ```
+ */
+function PageToolbar(options) {
+    return new component_1.ComponentBuilder(PAGE_TOOLBAR_COMPONENT_NAME)
+        .options({ ...options })
+        .meta({ name: "PageToolbar", icon: "i-ph-sliders-horizontal" });
+}
+/** The `LiveToggle` of `pageToolbar()` unless its `live` says otherwise. */
+exports.PAGE_TOOLBAR_LIVE_DEFAULTS = {
+    align: "right",
+    variant: "pill",
+};
+const TOOLBAR_PRESETS = [
+    "last-hour",
+    "last-24h",
+    "last-7-days",
+    "last-30-days",
+];
+/**
+ * The `PeriodSelector` of `pageToolbar()` unless its `period` says otherwise:
+ * the start of the window from now ("since yesterday 11:29"), then the
+ * 1H / 24H / 7D / 30D presets, on the last 24 hours by default. Its
+ * comparison control depends on what the period offers: a menu naming the
+ * compared window ("vs 16 – 17 Oct ▾") for more than one choice, `none`
+ * included, on its first comparison besides `none`; none for a single
+ * comparison, which then stays on and reads "vs …" beside the window.
+ */
+exports.PAGE_TOOLBAR_PERIOD_DEFAULTS = {
+    variant: "segmented",
+    align: "right",
+    rangeLabel: "relative",
+    presets: TOOLBAR_PRESETS,
+    defaultPreset: "last-24h",
+};
+const NO_COMPARISON = "none";
+// What a `PeriodSelector` offers without `comparisons`.
+const SELECTOR_DEFAULT_COMPARISONS = [
+    NO_COMPARISON,
+    "previous-period",
+    "previous-year",
+];
+// The comparison control of PAGE_TOOLBAR_PERIOD_DEFAULTS' doc, under what
+// the page's `period` sets itself.
+function toolbarComparisonSetup(period) {
+    const offered = period.comparisons ?? SELECTOR_DEFAULT_COMPARISONS;
+    if (offered.length <= 1)
+        return { comparisonControl: "hidden" };
+    const firstComparison = offered.find((comparison) => comparison !== NO_COMPARISON);
+    return firstComparison
+        ? { comparisonControl: "menu", defaultComparison: firstComparison }
+        : { comparisonControl: "menu" };
+}
+/** The child id of the toolbar's `LiveToggle` unless `live.childId` says otherwise. */
+exports.PAGE_TOOLBAR_LIVE_CHILD_ID = "live";
+/** The child id of the toolbar's `PeriodSelector` unless `period.childId` says otherwise. */
+exports.PAGE_TOOLBAR_PERIOD_CHILD_ID = "period";
+// A control built over its defaults, carrying the metadata and the options
+// transform it was given.
+function placed(builder, { meta, transformOptions }) {
+    if (meta)
+        builder.meta(meta);
+    if (transformOptions)
+        builder.transformOptions(transformOptions);
+    return builder;
+}
+/**
+ * A `PageToolbar` with its usual children: `leading` on the left, then the
+ * `LiveToggle` as a pill (`live`) and the `PeriodSelector` as segmented
+ * presets (`period`), each over its defaults. A page puts it first:
+ *
+ * ```ts
+ * static toolbar = pageToolbar({
+ *   leading: { scope: scopeChip() },
+ *   live: { missedLabel: "$api.live.new_requests" },
+ *   period: {
+ *     id: "api",
+ *     rememberKey: "api",
+ *     comparisons: ["previous-period"],
+ *   },
+ * });
+ * ```
+ *
+ * Each control keeps the id and the roles-editor metadata a page gives it:
+ *
+ * ```ts
+ * static toolbar = pageToolbar({
+ *   live: { childId: "toggle", meta: { name: "$my.permissions.live.name" } },
+ *   period: { id: "my-scope", meta: { name: "$my.permissions.period.name" } },
+ * }).meta({ name: "$my.permissions.toolbar.name" });
+ * ```
+ */
+function pageToolbar(options = {}) {
+    const { leading, live, period, ...props } = options;
+    const toolbar = PageToolbar(props);
+    for (const [id, component] of Object.entries(leading ?? {})) {
+        toolbar.child(id, component);
+    }
+    for (const control of toolbarControls(live, period)) {
+        toolbar.child(control.id, control.build());
+    }
+    return toolbar;
+}
+/**
+ * The toolbar's default children, in order: the `LiveToggle` then the
+ * `PeriodSelector`, each over its defaults. The one source of what a toolbar
+ * holds, for `pageToolbar()` and for the catalog's `initialChildren`.
+ */
+function toolbarControls(live, period) {
+    const controls = [];
+    if (live !== false) {
+        const { childId, meta, transformOptions, ...liveProps } = live ?? {};
+        const liveOptions = { ...exports.PAGE_TOOLBAR_LIVE_DEFAULTS, ...liveProps };
+        controls.push({
+            id: childId ?? exports.PAGE_TOOLBAR_LIVE_CHILD_ID,
+            type: "LiveToggle",
+            options: liveOptions,
+            build: () => placed((0, live_toggle_1.LiveToggle)(liveOptions), { meta, transformOptions }),
+        });
+    }
+    if (period !== false) {
+        const { childId, meta, transformOptions, ...periodProps } = period ?? {};
+        const periodOptions = {
+            ...exports.PAGE_TOOLBAR_PERIOD_DEFAULTS,
+            ...toolbarComparisonSetup(periodProps),
+            ...periodProps,
+        };
+        controls.push({
+            id: childId ?? exports.PAGE_TOOLBAR_PERIOD_CHILD_ID,
+            type: "PeriodSelector",
+            options: periodOptions,
+            build: () => placed((0, period_selector_1.PeriodSelector)(periodOptions), { meta, transformOptions }),
+        });
+    }
+    return controls;
+}
+/** The options `PageToolbar` accepts. */
+exports.PageToolbarSchema = zod_1.z.object({
+    size: (0, block_registry_1.ui)(zod_1.z
+        .enum(exports.PAGE_TOOLBAR_SIZES)
+        .optional()
+        .describe("The size of the controls the toolbar holds."), { label: "Size", group: "appearance", widget: "segmented" }),
+    showUpdatedAt: (0, block_registry_1.ui)(zod_1.z
+        .boolean()
+        .optional()
+        .describe("Without live mode, shows how long ago the page last read its data."), { label: "Show the last update", group: "appearance", widget: "switch" }),
+    refresh: (0, block_registry_1.ui)(zod_1.z
+        .boolean()
+        .optional()
+        .describe("Without live mode, offers a button reading the page again."), { label: "Refresh button", group: "behavior", widget: "switch" }),
+});
+(0, block_registry_1.RegisterBlockType)({
+    type: "PageToolbar",
+    componentName: PAGE_TOOLBAR_COMPONENT_NAME,
+    schema: exports.PageToolbarSchema,
+    container: true,
+    meta: {
+        name: "Page toolbar",
+        icon: "i-ph-sliders-horizontal",
+        description: "Context bar of a page: its scope, the last update, live mode and period.",
+        group: "data",
+    },
+    // What `pageToolbar()` places, for an editor building a toolbar.
+    initialChildren: toolbarControls(undefined, undefined).map(({ id, type, options }) => ({ id, type, options })),
+});
+//# sourceMappingURL=page-toolbar.js.map

package/dist/base/page-toolbar.js.map

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

package/dist/base/period-selector.d.ts

@@ -72,6 +72,11 @@ export interface PeriodSelectorProps extends BaseComponentProps {
     presetLabels?: Partial<Record<PeriodPreset, string>>;
     comparisonLabels?: Partial<Record<PeriodComparison, string>>;
     align?: PeriodAlign;
+    /**
+     * How large the controls are drawn. Defaults to the size of the
+     * `PageToolbar` holding the selector, where the window beside them scales
+     * with it too, else `sm`.
+     */
     size?: "xs" | "sm" | "md" | "lg" | "xl";
     showRangeLabel?: boolean;
     /**
@@ -83,8 +88,10 @@ export interface PeriodSelectorProps extends BaseComponentProps {
     /**
      * How the comparisons are offered (see {@link PeriodComparisonControl}).
      * Defaults to `toggle` when `comparisons` offers a single comparison
-     * besides `none`, `menu` otherwise. The toggle switches between that
-     * comparison and `none`; `hidden` keeps the comparison on
+     * besides `none`, `menu` otherwise. The menu's trigger names the compared
+     * window ("vs 16 – 17 Oct", the option's name in its tooltip), and the
+     * window beside it then leaves its "vs …" part out. The toggle switches
+     * between that comparison and `none`; `hidden` keeps the comparison on
      * (`defaultComparison`, else the first one offered besides `none`).
      */
     comparisonControl?: PeriodComparisonControl;

package/dist/base/period-selector.js.map

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

package/dist/base/placeholder.d.ts

@@ -26,12 +26,12 @@ export declare const PlaceholderSchema: z.ZodObject<{
     width: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     label?: string | undefined;
-    height?: string | undefined;
     width?: string | undefined;
+    height?: string | undefined;
 }, {
     label?: string | undefined;
-    height?: string | undefined;
     width?: string | undefined;
+    height?: string | undefined;
 }>;
 /**
  * Placeholder - Development Placeholder Component

package/dist/base/section.d.ts

@@ -95,11 +95,11 @@ export declare const FieldRowSchema: z.ZodObject<{
     required?: boolean | undefined;
     description?: string | undefined;
     label?: string | undefined;
-    layout?: "stack" | "inline" | "form" | undefined;
+    layout?: "inline" | "form" | "stack" | undefined;
 }, {
     disabled?: boolean | undefined;
     required?: boolean | undefined;
     description?: string | undefined;
     label?: string | undefined;
-    layout?: "stack" | "inline" | "form" | undefined;
+    layout?: "inline" | "form" | "stack" | undefined;
 }>;

package/dist/base/stack.d.ts

@@ -101,11 +101,11 @@ export declare const HStackSchema: z.ZodObject<{
     spacing: string;
     grow?: number | undefined;
 }, {
-    grow?: number | undefined;
     wrap?: boolean | undefined;
     alignment?: "end" | "start" | "center" | "stretch" | undefined;
     distribution?: "end" | "start" | "center" | "space-between" | "space-around" | "space-evenly" | undefined;
     spacing?: string | undefined;
+    grow?: number | undefined;
 }>;
 /** The options `VStack` accepts. */
 export declare const VStackSchema: z.ZodObject<{
@@ -119,10 +119,10 @@ export declare const VStackSchema: z.ZodObject<{
     spacing: string;
     grow?: number | undefined;
 }, {
-    grow?: number | undefined;
     alignment?: "end" | "start" | "center" | "stretch" | undefined;
     distribution?: "end" | "start" | "center" | "space-between" | "space-around" | "space-evenly" | undefined;
     spacing?: string | undefined;
+    grow?: number | undefined;
 }>;
 /** The options `Spacer` accepts. */
 export declare const SpacerSchema: z.ZodObject<{

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

@@ -50,9 +50,18 @@ export interface StatGroupProps extends BaseComponentProps, BlockItemsSource {
     layout?: StatGroupLayout;
     /** Columns on wide screens (1–6); defaults to the number of items. */
     columns?: number;
+    /**
+     * The group's own width from which all `columns` sit side by side, as a
+     * container size: `sm` 24rem, `md` 28rem, `lg` 32rem, `xl` 36rem. Below
+     * it, one column (`joined`) or the narrow count of `cards`. Defaults to the
+     * group's usual steps for its column count (`xl` for three).
+     */
+    columnsFrom?: StatGroupColumnsFrom;
     /** Accessible name of the group. */
     label?: string;
 }
+/** The container sizes {@link StatGroupProps.columnsFrom} takes. */
+export type StatGroupColumnsFrom = "sm" | "md" | "lg" | "xl";
 /**
  * StatGroup — a row of headline figures, each with its icon, a mono label, a
  * value and a detail line, optionally linking to where it is managed.
@@ -105,8 +114,8 @@ export declare const StatGroupSchema: z.ZodObject<{
         id?: string | undefined;
         icon?: string | undefined;
         to?: string | undefined;
-        detail?: BlockText | undefined;
         tone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | "muted" | undefined;
+        detail?: BlockText | undefined;
         detailTone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | undefined;
     }, {
         value: number | BlockText;
@@ -114,23 +123,24 @@ export declare const StatGroupSchema: z.ZodObject<{
         id?: string | undefined;
         icon?: string | undefined;
         to?: string | undefined;
-        detail?: BlockText | undefined;
         tone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | "muted" | undefined;
+        detail?: BlockText | undefined;
         detailTone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | undefined;
     }>, "many">>;
     layout: z.ZodDefault<z.ZodEnum<["joined", "cards"]>>;
     columns: z.ZodOptional<z.ZodNumber>;
+    columnsFrom: z.ZodOptional<z.ZodEnum<["sm", "md", "lg", "xl"]>>;
     label: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    layout: "cards" | "joined";
+    layout: "joined" | "cards";
     items?: {
         value: number | BlockText;
         eyebrow: BlockText;
         id?: string | undefined;
         icon?: string | undefined;
         to?: string | undefined;
-        detail?: BlockText | undefined;
         tone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | "muted" | undefined;
+        detail?: BlockText | undefined;
         detailTone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | undefined;
     }[] | undefined;
     label?: string | undefined;
@@ -144,6 +154,7 @@ export declare const StatGroupSchema: z.ZodObject<{
         description?: string | undefined;
     } | undefined;
     skeletonCount?: number | undefined;
+    columnsFrom?: "sm" | "md" | "lg" | "xl" | undefined;
 }, {
     items?: {
         value: number | BlockText;
@@ -151,14 +162,14 @@ export declare const StatGroupSchema: z.ZodObject<{
         id?: string | undefined;
         icon?: string | undefined;
         to?: string | undefined;
-        detail?: BlockText | undefined;
         tone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | "muted" | undefined;
+        detail?: BlockText | undefined;
         detailTone?: "primary" | "secondary" | "success" | "info" | "warning" | "error" | "neutral" | undefined;
     }[] | undefined;
     label?: string | undefined;
     fetchUrl?: string | undefined;
     fetchUrlMethod?: import("./types").HttpMethod | undefined;
-    layout?: "cards" | "joined" | undefined;
+    layout?: "joined" | "cards" | undefined;
     periodScope?: string | undefined;
     columns?: number | undefined;
     realtimeTopic?: string | string[] | undefined;
@@ -167,4 +178,5 @@ export declare const StatGroupSchema: z.ZodObject<{
         description?: string | undefined;
     } | undefined;
     skeletonCount?: number | undefined;
+    columnsFrom?: "sm" | "md" | "lg" | "xl" | undefined;
 }>;

package/dist/base/stat-group.js

@@ -82,6 +82,15 @@ exports.StatGroupSchema = zod_1.z.object({
         .max(6)
         .optional()
         .describe("How many columns on a wide screen; by default, one per cell."), { label: "Columns", group: "layout", widget: "number", min: 1, max: 6 }),
+    columnsFrom: (0, block_registry_1.ui)(zod_1.z
+        .enum(["sm", "md", "lg", "xl"])
+        .optional()
+        .describe("The group's width from which all columns sit side by side (sm 24rem, md 28rem, lg 32rem, xl 36rem)."), {
+        label: "All columns from",
+        group: "layout",
+        widget: "segmented",
+        advanced: true,
+    }),
     label: (0, block_registry_1.ui)(zod_1.z.string().optional().describe("Accessible name of the group."), {
         label: "Accessible name",
         group: "advanced",