@antelopejs/interface-dms 0.3.4 → 0.3.6

package/dist/base/period-selector.js

@@ -6,6 +6,7 @@ const component_1 = require("../component");
 const zod_1 = require("zod");
 const block_registry_1 = require("./block-registry");
 const size_1 = require("./types/size");
+/** Every date range the selector can offer. */
 exports.PERIOD_PRESETS = [
     "last-hour",
     "last-24h",
@@ -22,16 +23,29 @@ exports.PERIOD_PRESETS = [
     "last-year",
     "custom",
 ];
+/** Every comparison the selector can offer. */
 exports.PERIOD_COMPARISONS = [
     "none",
     "previous-period",
     "previous-year",
     "custom",
 ];
+/** Where the selector sits in its row. */
 exports.PERIOD_ALIGNS = ["left", "center", "right"];
+/** How the selector renders its presets. */
 exports.PERIOD_SELECTOR_VARIANTS = ["default", "segmented"];
+/**
+ * The scope a selector drives when nothing else is named: the one a builder
+ * binds a card's period to. One selector per page needs no other.
+ */
 exports.DEFAULT_PERIOD_SCOPE = "page";
 const PERIOD_SELECTOR_COMPONENT_NAME = "dms-period-selector";
+/**
+ * `options` is optional because a page is written as it is built: the editor
+ * places a block before anything is configured, and writes that as the bare
+ * call `PeriodSelector()`. A page under construction has to compile — it is typechecked
+ * on every edit — so a block with nothing set yet has to be a legal call.
+ */
 function PeriodSelector(options) {
     return new component_1.ComponentBuilder(PERIOD_SELECTOR_COMPONENT_NAME)
         .options({ ...options, id: options?.id ?? exports.DEFAULT_PERIOD_SCOPE })
@@ -40,6 +54,10 @@ function PeriodSelector(options) {
         icon: "i-ph-calendar",
     });
 }
+/**
+ * What an editor calls each range and each comparison. The same words the
+ * selector shows in English, so an author sees the entry they are relabelling.
+ */
 const PERIOD_PRESET_LABELS = {
     "last-hour": "Last hour",
     "last-24h": "Last 24 hours",
@@ -68,7 +86,10 @@ const presetSchema = (0, block_registry_1.ui)(zod_1.z.enum(exports.PERIOD_PRESET
 const comparisonSchema = (0, block_registry_1.ui)(zod_1.z.enum(exports.PERIOD_COMPARISONS), {
     valueLabels: PERIOD_COMPARISON_LABELS,
 });
+/** The options `PeriodSelector` accepts. */
 exports.PeriodSelectorSchema = zod_1.z.object({
+    // A card bound to a period follows the page's scope, so a selector seeded
+    // with an id of its own drove no card at all — and said nothing.
     id: (0, block_registry_1.ui)(zod_1.z
         .string()
         .default(exports.DEFAULT_PERIOD_SCOPE)
@@ -91,6 +112,8 @@ exports.PeriodSelectorSchema = zod_1.z.object({
         label: "Available comparisons",
         group: "behavior",
     }),
+    // Keyed by a closed set, so an editor lists one entry per range to relabel
+    // rather than asking for an object typed by hand.
     presetLabels: (0, block_registry_1.ui)(zod_1.z.record(presetSchema, zod_1.z.string()).optional(), {
         label: "Range labels",
         group: "content",

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

@@ -1,10 +1,25 @@
 import { ComponentBuilder } from "../component";
 import { z } from "zod";
+/**
+ * Options for Placeholder component
+ */
 export interface PlaceholderOptions {
+    /**
+     * Label text to display in the box
+     */
     label?: string;
+    /**
+     * Height of the box (CSS unit)
+     * @default undefined (fills its cell, never under 120px)
+     */
     height?: string;
+    /**
+     * Width of the box (CSS unit)
+     * @default undefined (auto)
+     */
     width?: string;
 }
+/** The options `Placeholder` accepts. */
 export declare const PlaceholderSchema: z.ZodObject<{
     label: z.ZodOptional<z.ZodString>;
     height: z.ZodOptional<z.ZodString>;
@@ -18,4 +33,15 @@ export declare const PlaceholderSchema: z.ZodObject<{
     height?: string | undefined;
     width?: string | undefined;
 }>;
+/**
+ * Placeholder - Development Placeholder Component
+ *
+ * A visual placeholder component for demonstrations and examples.
+ * Shows a bordered box with a pattern background and optional label.
+ *
+ * @example
+ * ```typescript
+ * Placeholder({ label: 'Item 1', height: '200px' })
+ * ```
+ */
 export declare function Placeholder(options?: PlaceholderOptions): ComponentBuilder<PlaceholderOptions>;

package/dist/base/placeholder.js

@@ -6,6 +6,7 @@ const component_1 = require("../component");
 const zod_1 = require("zod");
 const block_registry_1 = require("./block-registry");
 const PLACEHOLDER_COMPONENT_NAME = "dms-placeholder";
+/** The options `Placeholder` accepts. */
 exports.PlaceholderSchema = zod_1.z.object({
     label: (0, block_registry_1.ui)(zod_1.z.string().optional().describe("Text shown inside the box."), {
         label: "Label",
@@ -20,6 +21,17 @@ exports.PlaceholderSchema = zod_1.z.object({
         .optional()
         .describe("Box width, as a CSS length. Fills its column when omitted."), { label: "Width", group: "appearance" }),
 });
+/**
+ * Placeholder - Development Placeholder Component
+ *
+ * A visual placeholder component for demonstrations and examples.
+ * Shows a bordered box with a pattern background and optional label.
+ *
+ * @example
+ * ```typescript
+ * Placeholder({ label: 'Item 1', height: '200px' })
+ * ```
+ */
 function Placeholder(options) {
     return new component_1.ComponentBuilder(PLACEHOLDER_COMPONENT_NAME)
         .options({ ...options })

package/dist/base/placeholder.js.map

@@ -1 +1 @@
-{"version":3,"file":"placeholder.js","sourceRoot":"","sources":["../../src/base/placeholder.ts"],"names":[],"mappings":";;;AA6DA,kCASC;AAtED,4CAAgD;AAChD,6BAAwB;AACxB,qDAA+E;AAE/E,MAAM,0BAA0B,GAAG,iBAAiB,CAAC;AAyBxC,QAAA,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,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,MAAM,EAAE,IAAA,mBAAE,EACR,OAAC;SACE,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2DAA2D,CAAC,EACxE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,CACzC;IACD,KAAK,EAAE,IAAA,mBAAE,EACP,OAAC;SACE,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4DAA4D,CAAC,EACzE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CACxC;CACF,CAA+C,CAAC;AAajD,SAAgB,WAAW,CACzB,OAA4B;IAE5B,OAAO,IAAI,4BAAgB,CAAqB,0BAA0B,CAAC;SACxE,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC;SACvB,IAAI,CAAC;QACJ,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,gBAAgB;KACvB,CAAC,CAAC;AACP,CAAC;AAED,IAAA,kCAAiB,EAAC;IAChB,IAAI,EAAE,aAAa;IACnB,aAAa,EAAE,0BAA0B;IACzC,MAAM,EAAE,yBAAiB;IACzB,IAAI,EAAE;QACJ,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,kDAAkD;QAC/D,KAAK,EAAE,QAAQ;KAChB;CACF,CAAC,CAAC"}
+{"version":3,"file":"placeholder.js","sourceRoot":"","sources":["../../src/base/placeholder.ts"],"names":[],"mappings":";;;AA6DA,kCASC;AAtED,4CAAgD;AAChD,6BAAwB;AACxB,qDAA+E;AAE/E,MAAM,0BAA0B,GAAG,iBAAiB,CAAC;AAwBrD,yCAAyC;AAC5B,QAAA,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,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,MAAM,EAAE,IAAA,mBAAE,EACR,OAAC;SACE,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2DAA2D,CAAC,EACxE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,CACzC;IACD,KAAK,EAAE,IAAA,mBAAE,EACP,OAAC;SACE,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4DAA4D,CAAC,EACzE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CACxC;CACF,CAA+C,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,SAAgB,WAAW,CACzB,OAA4B;IAE5B,OAAO,IAAI,4BAAgB,CAAqB,0BAA0B,CAAC;SACxE,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC;SACvB,IAAI,CAAC;QACJ,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,gBAAgB;KACvB,CAAC,CAAC;AACP,CAAC;AAED,IAAA,kCAAiB,EAAC;IAChB,IAAI,EAAE,aAAa;IACnB,aAAa,EAAE,0BAA0B;IACzC,MAAM,EAAE,yBAAiB;IACzB,IAAI,EAAE;QACJ,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,kDAAkD;QAC/D,KAAK,EAAE,QAAQ;KAChB;CACF,CAAC,CAAC"}

package/dist/base/query-response.d.ts

@@ -1,37 +1,87 @@
+/**
+ * Turning the points a generated query answers into what a block reads.
+ *
+ * A calculation answers one thing — a measure per group — while the blocks that
+ * read it want different arrangements of it: a chart wants the points, a card
+ * wants a headline figure above them, a ranked list wants entries. Rather than
+ * teach the generator to write each arrangement into every route, a route hands
+ * its points to one of these and returns the result.
+ *
+ * That keeps a generated route to a single expression, which is what lets the
+ * builder go on reading its own code back.
+ *
+ * Nothing here invents a figure it was not given: an absent measure stays absent
+ * all the way to the block, because a fabricated zero reads exactly like a
+ * measured one.
+ */
 import type { ChartSeries } from "./chart";
+/** One measured group: what it is, and what was measured. */
 export interface SeriesPoint {
     x: number | string;
+    /** Null for a group the calculation found nothing to measure in. */
     y: number | null;
 }
+/** How the headline figure is taken from the points. */
 export type SeriesMeasure = "count" | "sum" | "avg" | "min" | "max";
 export interface SeriesOptions {
     measure: SeriesMeasure;
+    /**
+     * What a legend and a tooltip call the series. The caller is expected to supply
+     * one a reader recognizes — the builder derives it from the measured field —
+     * because all that is left to name a series by is the measure's own word.
+     */
     label?: string;
+    /** The same calculation over the preceding period, when one was asked for. */
     previous?: SeriesPoint[];
 }
+/** A figure alongside the one before it, and the share between them. */
 export interface ComparedFigure {
+    /** Absent when the preceding period measured nothing to compare against. */
     previousValue?: number;
+    /**
+     * Absent when no share can be stated, which includes a preceding zero: growth
+     * away from nothing is unbounded, so 0 to 100 carries no variation at all.
+     * Blocks show none in that case rather than a stand-in for one. Written down
+     * because consumers depend on it, not left to be discovered.
+     */
     delta?: number;
 }
 export interface ChartCardData extends ComparedFigure {
+    /** Absent when no group was measured; see `headline`. */
     value?: number;
     series: ChartSeries[];
     comparisonSeries?: ChartSeries[];
 }
+/** What `kpiCardData` hands a `KpiCard`: its figure and the sparkline behind it. */
 export interface KpiCardData extends ComparedFigure {
+    /** Absent when no group was measured; see `headline`. */
     value?: number;
     sparkline?: number[];
 }
+/** One group of a `TopListCard`, with its change over the preceding period. */
 export interface TopListEntry {
     id: string | number;
     title: string;
     value: number;
     delta?: number | null;
 }
+/** What `topListData` hands a `TopListCard`: one entry per measured group. */
 export interface TopListData {
     items: TopListEntry[];
 }
-export declare function headline(points: SeriesPoint[], measure?: SeriesMeasure): number | undefined;
+/** Points as a chart card reads them: a figure, its series, and its variation. */
 export declare function chartCardData(points: SeriesPoint[], options: SeriesOptions): ChartCardData;
+/**
+ * Points as a KPI card reads them: one figure, and the points as its sparkline.
+ *
+ * The card draws the trend behind the number from the same calculation, so a KPI
+ * grouped over time costs no more than one without.
+ */
 export declare function kpiCardData(points: SeriesPoint[], options: SeriesOptions): KpiCardData;
+/**
+ * Points as a ranked list reads them, each group an entry.
+ *
+ * A group with nothing measured in it has no place in a ranking: entered as a
+ * zero it would outrank every real loss, so it is left out.
+ */
 export declare function topListData(points: SeriesPoint[], options: SeriesOptions): TopListData;

package/dist/base/query-response.js

@@ -1,46 +1,31 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.headline = headline;
 exports.chartCardData = chartCardData;
 exports.kpiCardData = kpiCardData;
 exports.topListData = topListData;
-const DEFAULT_MEASURE = "sum";
+const query_response_1 = require("./internal/query-response");
 const MS_PER_DAY = 86_400_000;
+/**
+ * The window a time bucket's key can fall in. Read as milliseconds, a group key
+ * outside it is a quantity or an identifier rather than an instant.
+ */
 const BUCKET_EPOCH_FIRST = Date.UTC(2000, 0, 1);
 const BUCKET_EPOCH_LAST = Date.UTC(2100, 0, 1);
 const ISO_DATE_END = 10;
 const ISO_MINUTE_END = 16;
-const total = (values) => values.reduce((running, value) => running + value, 0);
-const HEADLINE_BY_MEASURE = {
-    count: total,
-    sum: total,
-    avg: (values) => total(values) / values.length,
-    min: (values) => Math.min(...values),
-    max: (values) => Math.max(...values),
-};
-function measuredValues(points) {
-    return points
-        .map((point) => point.y)
-        .filter((value) => value !== null);
-}
-function headline(points, measure = DEFAULT_MEASURE) {
-    const values = measuredValues(points);
-    if (values.length === 0) {
-        return undefined;
-    }
-    return HEADLINE_BY_MEASURE[measure](values);
-}
+/** The share a figure gained or lost against the one before it. */
 function variation(current, previous) {
     if (previous === 0) {
         return current === 0 ? 0 : undefined;
     }
     return (current - previous) / previous;
 }
+/** Fill in the figure before this one and the share it moved, when there is one. */
 function addComparison(target, value, options) {
     if (!options.previous) {
         return;
     }
-    const previousValue = headline(options.previous, options.measure);
+    const previousValue = (0, query_response_1.headline)(options.previous, options.measure);
     if (previousValue === undefined) {
         return;
     }
@@ -53,35 +38,61 @@ function addComparison(target, value, options) {
         target.delta = delta;
     }
 }
+/**
+ * The points as the one named series a chart draws.
+ *
+ * A chart reads `{ name, data }` and indexes into `data`; handed the bare points
+ * it takes each of them for a series with nothing in it and draws an empty
+ * canvas, without an error anywhere to say why.
+ */
 function chartSeries(points, name) {
     return [{ name, data: points }];
 }
+/** Points as a chart card reads them: a figure, its series, and its variation. */
 function chartCardData(points, options) {
     const name = options.label ?? options.measure;
     const data = { series: chartSeries(points, name) };
-    const value = headline(points, options.measure);
+    const value = (0, query_response_1.headline)(points, options.measure);
     if (value !== undefined) {
         data.value = value;
     }
     addComparison(data, value, options);
     if (options.previous && options.previous.length > 0) {
+        // Named after the series it is compared against, not marked apart in its
+        // name: the block already sets it apart by colour and stroke, and a word
+        // added here would reach the legend in one language whatever the reader's is.
         data.comparisonSeries = chartSeries(options.previous, name);
     }
     return data;
 }
+/**
+ * Points as a KPI card reads them: one figure, and the points as its sparkline.
+ *
+ * The card draws the trend behind the number from the same calculation, so a KPI
+ * grouped over time costs no more than one without.
+ */
 function kpiCardData(points, options) {
     const data = {};
-    const value = headline(points, options.measure);
+    const value = (0, query_response_1.headline)(points, options.measure);
     if (value !== undefined) {
         data.value = value;
     }
     addComparison(data, value, options);
-    const values = measuredValues(points);
+    const values = (0, query_response_1.measuredValues)(points);
+    // One point is a figure, not a trend: a sparkline of it would draw a dot.
     if (values.length > 1) {
         data.sparkline = values;
     }
     return data;
 }
+/**
+ * A group's key as a person reads it.
+ *
+ * A time bucket arrives as epoch milliseconds, and a row titled `1772409600000`
+ * names nothing. A bucket that lands on a UTC midnight — which every day, month
+ * and year bucket does — is named by its date alone, since the zeroes below it
+ * carry no information.
+ */
 function groupTitle(key) {
     if (typeof key !== "number" ||
         !Number.isInteger(key) ||
@@ -116,6 +127,12 @@ function topListEntry(point, value, before) {
     }
     return entry;
 }
+/**
+ * Points as a ranked list reads them, each group an entry.
+ *
+ * A group with nothing measured in it has no place in a ranking: entered as a
+ * zero it would outrank every real loss, so it is left out.
+ */
 function topListData(points, options) {
     const before = measuredByGroup(options.previous ?? []);
     return {

package/dist/base/query-response.js.map

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

package/dist/base/resource-form-schema.d.ts

@@ -1,14 +1,32 @@
 import { z } from "zod";
 import type { FormProps } from "./form-types";
+/** Which of a resource's forms: creating a row, editing one, or reading one. */
 export declare const RESOURCE_FORM_MODES: readonly ["new", "edit", "view"];
 export type ResourceFormMode = (typeof RESOURCE_FORM_MODES)[number];
+/**
+ * The row a page reached as `…?id=<row>` is about. A page the builder writes
+ * has no route segment of its own to carry an id, so the query string does.
+ */
 export declare const QUERY_ROW_ID = "{{query.id}}";
+/** The row a page served under a `:id` route segment is about. */
+export declare const ROUTE_PARAM_ROW_ID = "{{params.id}}";
+/** What a form over a resource leaves open: everything but its fields and routes. */
 export interface ResourceFormOptions extends Omit<FormProps, "fields" | "fetchUrl" | "fetchUrlMethod" | "submitUrl" | "submitUrlMethod"> {
+    /**
+     * Where `edit` and `view` read the id of their row, as a token the form
+     * resolves against its page's URL.
+     */
     rowId?: string;
 }
+/** The options `ResourceForm` accepts, after its controller argument. */
 export interface ResourceFormBlockOptions extends ResourceFormOptions {
     mode: ResourceFormMode;
 }
+/**
+ * The options `ResourceForm` accepts. Deliberately few: which fields it shows,
+ * and where it loads and submits them, come from the resource and the mode —
+ * a field is configured on the resource, not on each form that shows it.
+ */
 export declare const ResourceFormSchema: z.ZodObject<{
     fieldsOrientation: z.ZodOptional<z.ZodEnum<["horizontal", "vertical"]>>;
     redirectOnSuccess: z.ZodOptional<z.ZodString>;

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

@@ -1,11 +1,28 @@
 "use strict";
+// The options of the `ResourceForm` block, declared without loading the table
+// view runtime, so builder tooling reads the block from the catalog alone. The
+// factory lives with the forms it shares with `TableView`, in
+// `table-view/resource-form`.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ResourceFormSchema = exports.QUERY_ROW_ID = exports.RESOURCE_FORM_MODES = void 0;
+exports.ResourceFormSchema = exports.ROUTE_PARAM_ROW_ID = exports.QUERY_ROW_ID = exports.RESOURCE_FORM_MODES = void 0;
 const zod_1 = require("zod");
 const block_registry_1 = require("./block-registry");
-const form_block_schema_1 = require("./form-block-schema");
+const form_block_schema_1 = require("./internal/form-block-schema");
+const form_block_schema_2 = require("./form-block-schema");
+/** Which of a resource's forms: creating a row, editing one, or reading one. */
 exports.RESOURCE_FORM_MODES = ["new", "edit", "view"];
+/**
+ * The row a page reached as `…?id=<row>` is about. A page the builder writes
+ * has no route segment of its own to carry an id, so the query string does.
+ */
 exports.QUERY_ROW_ID = "{{query.id}}";
+/** The row a page served under a `:id` route segment is about. */
+exports.ROUTE_PARAM_ROW_ID = "{{params.id}}";
+/**
+ * The options `ResourceForm` accepts. Deliberately few: which fields it shows,
+ * and where it loads and submits them, come from the resource and the mode —
+ * a field is configured on the resource, not on each form that shows it.
+ */
 exports.ResourceFormSchema = zod_1.z.object({
     mode: (0, block_registry_1.ui)(zod_1.z
         .enum(exports.RESOURCE_FORM_MODES)
@@ -26,7 +43,7 @@ exports.ResourceFormSchema = zod_1.z.object({
         order: 4,
         group: "content",
     }),
-    ...form_block_schema_1.SubmitMessageOptions,
+    ...form_block_schema_2.SubmitMessageOptions,
     fieldsOrientation: (0, block_registry_1.ui)(zod_1.z.enum(["horizontal", "vertical"]).optional(), {
         label: "Field orientation",
         group: "layout",

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

@@ -1 +1 @@
-{"version":3,"file":"resource-form-schema.js","sourceRoot":"","sources":["../../src/base/resource-form-schema.ts"],"names":[],"mappings":";;;AAKA,6BAAwB;AACxB,qDAA+E;AAC/E,2DAAgF;AAInE,QAAA,mBAAmB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAOvD,QAAA,YAAY,GAAG,cAAc,CAAC;AAwB9B,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,IAAA,mBAAE,EACN,OAAC;SACE,IAAI,CAAC,2BAAmB,CAAC;SACzB,QAAQ,CAAC,gDAAgD,CAAC,EAC7D,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAC9C;IACD,KAAK,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;QAC/B,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,SAAS;KACjB,CAAC;IACF,WAAW,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;QACrC,KAAK,EAAE,aAAa;QACpB,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,UAAU;KACnB,CAAC;IACF,WAAW,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;QACrC,KAAK,EAAE,qBAAqB;QAC5B,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,SAAS;KACjB,CAAC;IACF,GAAG,wCAAoB;IACvB,iBAAiB,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE;QACnE,KAAK,EAAE,mBAAmB;QAC1B,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,WAAW;KACpB,CAAC;IACF,iBAAiB,EAAE,IAAA,mBAAE,EACnB,OAAC;SACE,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,oEAAoE,CACrE,EACH,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,CAC1C;IACD,KAAK,EAAE,IAAA,mBAAE,EACP,OAAC;SACE,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,yDAAyD,oBAAY,GAAG,CACzE,EACH,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,oBAAY,EAAE,CACvE;IACD,cAAc,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE;QACnD,KAAK,EAAE,kBAAkB;QACzB,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,MAAM;KACf,CAAC;CACH,CAAqD,CAAC;AAEvD,IAAA,kCAAiB,EAAC;IAChB,IAAI,EAAE,cAAc;IACpB,aAAa,EAAE,uCAAmB;IAClC,MAAM,EAAE,0BAAkB;IAC1B,aAAa,EAAE,IAAI;IACnB,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,iGAAiG;QACnG,KAAK,EAAE,MAAM;KACd;CACF,CAAC,CAAC"}
+{"version":3,"file":"resource-form-schema.js","sourceRoot":"","sources":["../../src/base/resource-form-schema.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,+EAA+E;AAC/E,8DAA8D;AAC9D,8BAA8B;;;AAE9B,6BAAwB;AACxB,qDAA+E;AAC/E,oEAAmE;AACnE,2DAA2D;AAG3D,gFAAgF;AACnE,QAAA,mBAAmB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAGpE;;;GAGG;AACU,QAAA,YAAY,GAAG,cAAc,CAAC;AAE3C,kEAAkE;AACrD,QAAA,kBAAkB,GAAG,eAAe,CAAC;AAmBlD;;;;GAIG;AACU,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,IAAA,mBAAE,EACN,OAAC;SACE,IAAI,CAAC,2BAAmB,CAAC;SACzB,QAAQ,CAAC,gDAAgD,CAAC,EAC7D,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAC9C;IACD,KAAK,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;QAC/B,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,SAAS;KACjB,CAAC;IACF,WAAW,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;QACrC,KAAK,EAAE,aAAa;QACpB,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,UAAU;KACnB,CAAC;IACF,WAAW,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;QACrC,KAAK,EAAE,qBAAqB;QAC5B,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,SAAS;KACjB,CAAC;IACF,GAAG,wCAAoB;IACvB,iBAAiB,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE;QACnE,KAAK,EAAE,mBAAmB;QAC1B,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,WAAW;KACpB,CAAC;IACF,iBAAiB,EAAE,IAAA,mBAAE,EACnB,OAAC;SACE,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,oEAAoE,CACrE,EACH,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,CAC1C;IACD,KAAK,EAAE,IAAA,mBAAE,EACP,OAAC;SACE,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,yDAAyD,oBAAY,GAAG,CACzE,EACH,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,oBAAY,EAAE,CACvE;IACD,cAAc,EAAE,IAAA,mBAAE,EAAC,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE;QACnD,KAAK,EAAE,kBAAkB;QACzB,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,MAAM;KACf,CAAC;CACH,CAAqD,CAAC;AAEvD,IAAA,kCAAiB,EAAC;IAChB,IAAI,EAAE,cAAc;IACpB,aAAa,EAAE,uCAAmB;IAClC,MAAM,EAAE,0BAAkB;IAC1B,aAAa,EAAE,IAAI;IACnB,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,iGAAiG;QACnG,KAAK,EAAE,MAAM;KACd;CACF,CAAC,CAAC"}

package/dist/base/searchable.d.ts

@@ -3,6 +3,8 @@ export declare class SearchableMeta {
     static key: symbol;
     constructor(target: new (...args: unknown[]) => unknown);
     readonly searchableFields: Record<string, string>;
+    /** A controller derived from this one searches the same fields. */
+    inherit(parent: SearchableMeta): void;
     setSearchableField(key: string, compareMode: string): void;
     getSearchableFields(): Record<string, string>;
 }

package/dist/base/searchable.js

@@ -10,6 +10,10 @@ class SearchableMeta {
         this.target = target;
     }
     searchableFields = {};
+    /** A controller derived from this one searches the same fields. */
+    inherit(parent) {
+        Object.assign(this.searchableFields, parent.searchableFields);
+    }
     setSearchableField(key, compareMode) {
         this.searchableFields[key] = compareMode;
     }

package/dist/base/searchable.js.map

@@ -1 +1 @@
-{"version":3,"file":"searchable.js","sourceRoot":"","sources":["../../src/base/searchable.ts"],"names":[],"mappings":";;;AAAA,+DAAyD;AACzD,sEAA8E;AAE9E,MAAa,cAAc;IAGG;IAFrB,MAAM,CAAC,GAAG,GAAG,MAAM,EAAE,CAAC;IAE7B,YAA4B,MAA2C;QAA3C,WAAM,GAAN,MAAM,CAAqC;IAAG,CAAC;IAE3D,gBAAgB,GAA2B,EAAE,CAAC;IAEvD,kBAAkB,CAAC,GAAW,EAAE,WAAmB;QACxD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;IAC3C,CAAC;IAEM,mBAAmB;QACxB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;;AAbH,wCAcC;AAED,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAE3B,QAAA,UAAU,GAAG,IAAA,kCAAqB,EAC7C,CAAC,MAAM,EAAE,GAAG,EAAE,WAAoB,EAAE,EAAE;IACpC,MAAM,cAAc,GAAG,IAAA,4BAAW,EAAC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACvE,MAAM,oBAAoB,GAAG,WAAW,IAAI,oBAAoB,CAAC;IACjE,cAAc,CAAC,kBAAkB,CAAC,GAAa,EAAE,oBAAoB,CAAC,CAAC;AACzE,CAAC,CACF,CAAC"}
+{"version":3,"file":"searchable.js","sourceRoot":"","sources":["../../src/base/searchable.ts"],"names":[],"mappings":";;;AAAA,+DAAyD;AACzD,sEAA8E;AAE9E,MAAa,cAAc;IAGG;IAFrB,MAAM,CAAC,GAAG,GAAG,MAAM,EAAE,CAAC;IAE7B,YAA4B,MAA2C;QAA3C,WAAM,GAAN,MAAM,CAAqC;IAAG,CAAC;IAE3D,gBAAgB,GAA2B,EAAE,CAAC;IAE9D,mEAAmE;IAC5D,OAAO,CAAC,MAAsB;QACnC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAChE,CAAC;IAEM,kBAAkB,CAAC,GAAW,EAAE,WAAmB;QACxD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;IAC3C,CAAC;IAEM,mBAAmB;QACxB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;;AAlBH,wCAmBC;AAED,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAE3B,QAAA,UAAU,GAAG,IAAA,kCAAqB,EAC7C,CAAC,MAAM,EAAE,GAAG,EAAE,WAAoB,EAAE,EAAE;IACpC,MAAM,cAAc,GAAG,IAAA,4BAAW,EAAC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACvE,MAAM,oBAAoB,GAAG,WAAW,IAAI,oBAAoB,CAAC;IACjE,cAAc,CAAC,kBAAkB,CAAC,GAAa,EAAE,oBAAoB,CAAC,CAAC;AACzE,CAAC,CACF,CAAC"}

package/dist/base/section.d.ts

@@ -0,0 +1,105 @@
+import { ComponentBuilder } from "../component";
+import { z } from "zod";
+import type { BaseComponentProps } from "./types";
+/** The options `Section` takes. */
+export interface SectionProps extends BaseComponentProps {
+    /** Heading above the card (i18n key with `$` or literal). */
+    title?: string;
+    /** One line under the heading. */
+    description?: string;
+    /** Destructive actions: the frame and the title turn to the error color. */
+    danger?: boolean;
+    /**
+     * The card frame around the children. Defaults to `true`; off for grids
+     * and custom layouts.
+     */
+    card?: boolean;
+}
+/** How a field row lays its label and control out. */
+export declare const FIELD_ROW_LAYOUTS: readonly ["inline", "form", "stack"];
+export type FieldRowLayout = (typeof FIELD_ROW_LAYOUTS)[number];
+/** The options `FieldRow` takes. */
+export interface FieldRowProps extends BaseComponentProps {
+    /** Row label (i18n key with `$` or literal). */
+    label?: string;
+    /** Help text under the label. */
+    description?: string;
+    /**
+     * `inline` (default): label left, compact control right — switches, selects,
+     * buttons. `form`: a 240px label column beside a full-width control. `stack`:
+     * the label above the control.
+     */
+    layout?: FieldRowLayout;
+    /** Red asterisk after the label. */
+    required?: boolean;
+    /** Dims the whole row. */
+    disabled?: boolean;
+}
+/**
+ * Section - a titled settings block.
+ *
+ * A heading and a one-line description above a card whose children — field
+ * rows, a form, a list — are set apart by hairlines. A `Form` placed in a
+ * framed section drops its own card and lays its fields out as the section's
+ * rows.
+ *
+ * @example
+ * ```typescript
+ * Section({ title: "Workspace", description: "How the workspace appears." })
+ *   .child("name", FieldRow({ label: "Name", layout: "form" }).child("v", …))
+ *   .child("form", Form({ fields, submitUrl }))
+ * ```
+ */
+export declare function Section(options?: SectionProps): ComponentBuilder<SectionProps>;
+/**
+ * FieldRow - one row of a section: a label with its help text
+ * and the control its child block renders — a button, a status, a meter.
+ *
+ * Fields that are filled in and submitted belong to a `Form`, which owns their
+ * values, validation and submit; a field row holds a block that stands on its
+ * own.
+ *
+ * @example
+ * ```typescript
+ * FieldRow({ label: "Seats", description: "Billed monthly." })
+ *   .child("meter", Meter({ value: 8, max: 10 }))
+ * ```
+ */
+export declare function FieldRow(options?: FieldRowProps): ComponentBuilder<FieldRowProps>;
+/** The options `Section` accepts. */
+export declare const SectionSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    danger: z.ZodOptional<z.ZodBoolean>;
+    card: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    card: boolean;
+    description?: string | undefined;
+    title?: string | undefined;
+    danger?: boolean | undefined;
+}, {
+    description?: string | undefined;
+    title?: string | undefined;
+    card?: boolean | undefined;
+    danger?: boolean | undefined;
+}>;
+/** The options `FieldRow` accepts. */
+export declare const FieldRowSchema: z.ZodObject<{
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    layout: z.ZodOptional<z.ZodEnum<["inline", "form", "stack"]>>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    required?: boolean | undefined;
+    description?: string | undefined;
+    label?: string | undefined;
+    disabled?: boolean | undefined;
+    layout?: "stack" | "inline" | "form" | undefined;
+}, {
+    required?: boolean | undefined;
+    description?: string | undefined;
+    label?: string | undefined;
+    disabled?: boolean | undefined;
+    layout?: "stack" | "inline" | "form" | undefined;
+}>;