@cosmicdrift/kumiko-types 0.416.0 → 0.417.0

package/dist/action-icon.d.ts

@@ -1,3 +1,3 @@
 import type { IconKey } from "./nav-icon.ts";
 export declare const ACTION_ICON_BY_ID: Readonly<Partial<Record<string, IconKey>>>;
-export declare function resolveActionIcon(id: string, declared?: IconKey): IconKey | undefined;
+export declare function resolveActionIcon(id: string, declared?: IconKey | false): IconKey | undefined;

package/dist/action-icon.js

@@ -43,6 +43,8 @@ function kebabFirstSegment(id) {
 // segment). `declared` is `undefined` for ToolbarAction, which has no
 // author-facing icon field.
 export function resolveActionIcon(id, declared) {
+    if (declared === false)
+        return undefined;
     if (declared !== undefined)
         return declared;
     return (ACTION_ICON_BY_ID[id] ??

package/dist/config.d.ts

@@ -85,6 +85,10 @@ export type ConfigMask = {
     readonly order?: number;
     /** Shows the value on the generated settings screen without an input; a read-only key cannot also be `required`. */
     readonly readOnly?: boolean;
+    /** Draws the generated settings screen of this key compact (like `configEdit` `compact: true`: no origin icon or reset link, no accent bar, large section labels, no name-derived field icons). One key per screen is enough. */
+    readonly compact?: true;
+    /** i18n key of a section title: keys sharing it form their own titled section on the generated settings screen, after the untitled-by-mask keys. */
+    readonly section?: string;
 };
 export type ConfigDefinition = {
     readonly keys: Readonly<Record<string, ConfigKeyDefinition>>;

package/dist/handler-context-facets.d.ts

@@ -46,6 +46,11 @@ export type HandlerEvents<TMap extends object = KumikoEventTypeMap> = {
         readonly asOf?: never;
         readonly includeArchived?: boolean;
     }) => Promise<readonly import("./event-store-types.ts").StoredEvent[]>;
+    readonly loadByTypes: (args: {
+        readonly aggregateIds: readonly string[];
+        readonly eventTypes: readonly string[];
+        readonly includeArchived?: boolean;
+    }) => Promise<readonly import("./event-store-types.ts").StoredEvent[]>;
     readonly archive: (aggregateId: string, args: {
         readonly aggregateType: string;
         readonly reason?: string;

package/dist/screen-custom-config.d.ts

@@ -101,6 +101,9 @@ export type ConfigEditScreenDefinition = {
     readonly requiredFields?: readonly string[];
     /** i18n key for the submit button. Default: "kumiko.actions.save". */
     readonly submitLabel?: string;
+    /** Compact rows: no origin icon, no reset link, no accent bar on changed fields; the form
+     *  column is capped to a readable width. */
+    readonly compact?: true;
     /** Handler buttons drawn as their own row after `afterField` (settings-list layout). */
     readonly actions?: readonly ConfigEditAction[];
     readonly slots?: ScreenSlots;

package/dist/screen-dashboard.d.ts

@@ -91,6 +91,8 @@ export type DashboardStatPanel = DashboardPanelQueryOptions & DashboardPanelGate
     readonly labelField?: string;
     /** i18n key shown instead of the label in the one-line phone strip of a titled stat-group ("2 requests"). Only used for stats inside a stat-group. */
     readonly narrowLabel?: string;
+    /** i18n key replacing `label` below the `sm` breakpoint wherever the stat draws its label (a dynamic `labelField` text still wins). */
+    readonly labelNarrow?: string;
     readonly subField?: string;
     readonly toneField?: string;
     /** Formats a numeric value as currency (minor units) or, with `relativeTime`, as
@@ -264,7 +266,8 @@ export type DashboardListNarrow = {
 };
 /** Link to a screen from a panel; `label` is an i18n key, `namedFilter` only for list screens. */
 export type DashboardListFooterLink = {
-    readonly label: string;
+    /** i18n key of the link text. Without it the footer shows only the `moreText` count as muted text, no link; `screen` still has to resolve. */
+    readonly label?: string;
     /** i18n key of the text before the link when more rows exist than shown; `{count}` is the rest. Default "k more". */
     readonly moreText?: string;
     /** i18n key used instead of `moreText` below `sm`. */
@@ -312,12 +315,18 @@ export type DashboardFeedPanel = DashboardPanelQueryOptions & DashboardPanelEmpt
     readonly id: string;
     readonly label: string;
     readonly query: string;
+    /** Shows the count in the panel head, right-aligned like a list panel's `showTotal`: `{total}` is the query's `total`, else the rows returned. `text` is an i18n key with `{shown}` and `{total}`; without it "{shown} of {total}". */
+    readonly showTotal?: true | Pick<DashboardListShowTotal, "text">;
 };
 export type DashboardProgressTone = "default" | "danger";
 export type DashboardProgressListPanel = DashboardPanelQueryOptions & DashboardPanelEmptyState & DashboardPanelGate & DashboardPanelNarrow & {
     readonly kind: "progress-list";
     readonly id: string;
     readonly label: string;
+    /** Fills the translated `label` from the query answer: maps a label placeholder to a top-level answer field, e.g. `{ month: "monthName" }` for "Quota {month}" with `{ rows, monthName: "November" }`. Until the answer arrives the placeholders are empty. */
+    readonly labelParams?: Readonly<Record<string, string>>;
+    /** Top-level answer field holding a text shown muted at the right end of the panel head, e.g. the period ("November"). */
+    readonly subtitleField?: string;
     readonly query: string;
 };
 export type DashboardCustomPanel = DashboardPanelNarrow & {

package/dist/screen-entity-edit.d.ts

@@ -51,6 +51,17 @@ export type EditFieldSpec = string | {
      *  the field to its value. The values come from another field of the same form that
      *  holds an array of numbers (e.g. hidden and `submit: false`, seeded by prefill). */
     readonly valueChips?: FieldValueChips;
+    /** Read-only display of a value the viewer may not see: the value (or the mask the query
+     *  returns) shows muted with a lock icon instead of a replacement text. */
+    readonly concealed?: true;
+    /** Pill next to the label, e.g. "price source open" in `warn`. `label` is an i18n key; `field` names a
+     *  value field of the form or record whose non-empty text is the pill text (no text: no pill). */
+    readonly badge?: FieldBadge;
+    /** Value field whose non-empty text shows as a muted small hint under the field
+     *  (e.g. "From the buyer: Skoda Octavia"). */
+    readonly hintField?: string;
+    /** Leaves the field out below `sm`; its value is still submitted. */
+    readonly hideOnNarrow?: true;
     /** Marks this field as a reference lookup instead of a plain value —
      *  for projectionDetail fields, which have no `EntityDefinition` to
      *  carry a real `reference` field type. Same target convention as
@@ -73,6 +84,14 @@ export type EditFieldSpec = string | {
      *  field `default`, it is not applied server-side. */
     readonly prefill?: EditFieldPrefill;
 };
+/** Pill next to a field label: a fixed i18n `label`, or the text of another value `field`. */
+export type FieldBadge = {
+    readonly label: string;
+    readonly tone: SelectOptionTone;
+} | {
+    readonly field: string;
+    readonly tone: SelectOptionTone;
+};
 export type FieldAffix = string | {
     readonly field: string;
 };
@@ -138,8 +157,21 @@ export type EditFieldPrefill = {
     readonly kind: "currentUser";
     readonly property: "displayName" | "email" | "id";
 };
+/** Presentation options every section kind of a projectionDetail takes. */
+export type EditSectionPresentation = {
+    /** i18n key of the tab name when the layout is in tabs mode; the section `title` stays the card heading. Without it the tab is named after the title of the first section with that tab id. */
+    readonly tabLabel?: string;
+    /** Component drawn directly under this section's card, in its column (also beside photos); same `{ react: { __component } }` form as `slots.afterForm`, receiving the same props. */
+    readonly after?: PlatformComponent;
+    /** Leaves the section out below `sm`. Exclusive with `showOnNarrowOnly`. */
+    readonly hideOnNarrow?: true;
+    /** Shows the section only below `sm` (e.g. a compact facts block for phones). */
+    readonly showOnNarrowOnly?: true;
+    /** `false` leaves the section title out below `sm` (phone); the title stays from `sm` up. */
+    readonly titleOnNarrow?: false;
+};
 export type EditSectionSpec = EditFieldsSection | EditExtensionSection | EditRelatedListSection | EditWriteFormSection | EditStepListSection;
-type EditFieldsSectionBase = {
+type EditFieldsSectionBase = EditSectionPresentation & {
     /** Kebab-case tab id, used as the `?tab=` value. Required by the
      *  boot-validator when the enclosing `EditLayout.mode` is "tabs". */
     readonly id?: string;
@@ -158,6 +190,8 @@ type EditFieldsSectionBase = {
      *  `subtitle` slot as `FormProps.subtitle`. Works without `title` too
      *  (subtitle-only section). */
     readonly description?: string;
+    /** i18n key of a short text shown instead of `description` below `sm`. */
+    readonly descriptionNarrow?: string;
     readonly columns?: number;
     /** Rendered left of the section title, `text-muted-foreground` — closed
      *  IconKey vocabulary into the ICONS registry (renderer/web), analogous
@@ -186,7 +220,8 @@ type EditFieldsSectionBase = {
 export type EditFieldGroup = {
     readonly title: string;
     readonly fields: readonly EditFieldSpec[];
-    /** Default 2. */
+    /** Edit mode renders 2 columns by default. In read mode only a declared value turns the group
+     *  into a label/value grid; without it the stacked layout stays. */
     readonly columns?: number;
 };
 /** Either a flat `fields` grid or titled `groups` cards, never both: the groups branch has no
@@ -208,7 +243,7 @@ export type StepListItem = {
 /** Vertical numbered step list (circles joined by a line), fed from one field of the detail
  *  query. Only supported on projectionDetail. Several sections sharing one `id` stack inside one
  *  tab, e.g. fields, relatedList and stepList under "Overview". */
-export type EditStepListSection = {
+export type EditStepListSection = EditSectionPresentation & {
     readonly id?: string;
     readonly visibleWhen?: Exclude<FieldCondition, boolean>;
     readonly kind: "stepList";
@@ -218,7 +253,7 @@ export type EditStepListSection = {
     /** Present only so section-actions readers accept the union; a step list has no title-row actions. */
     readonly actions?: undefined;
 };
-export type EditExtensionSection = {
+export type EditExtensionSection = EditSectionPresentation & {
     /** Kebab-case tab id, used as the `?tab=` value. Required by the
      *  boot-validator when the enclosing `EditLayout.mode` is "tabs". */
     readonly id?: string;
@@ -278,7 +313,7 @@ export type ListEmptyStateSpec = {
     readonly description?: string;
     readonly action?: RowAction;
 };
-export type EditRelatedListSection = {
+export type EditRelatedListSection = EditSectionPresentation & {
     /** Kebab-case tab id, used as the `?tab=` value. Required by the
      *  boot-validator when the enclosing `EditLayout.mode` is "tabs". */
     readonly id?: string;
@@ -401,8 +436,12 @@ export type EditRelatedListSection = {
     readonly photoGrid?: {
         /** Row field holding a FileRef id (or an id array, the first shows). */
         readonly imageField: string;
-        /** Row field printed under the image. */
+        /** Row field printed under the image; without it the tile reads "Photo n". */
         readonly captionField?: string;
+        /** Row field whose non-empty text shows as a warn badge on the image's top left. */
+        readonly badgeField?: string;
+        /** On a phone (below `sm`) tiles whose `badgeField` has text come first, the rest keep their order; from `sm` up the natural order stays. */
+        readonly badgeFirst?: true;
     };
 };
 /** Empty-state text for one parent-record state, e.g. "still running" vs. "finished without rows". */
@@ -416,7 +455,7 @@ export type RelatedListEmptyStateVariant = {
 export type RelatedListEmptyStateSpec = ListEmptyStateSpec & {
     readonly variants?: readonly RelatedListEmptyStateVariant[];
 };
-export type EditWriteFormSection = {
+export type EditWriteFormSection = EditSectionPresentation & {
     /** Kebab-case tab id, used as the `?tab=` value. Required by the
      *  boot-validator when the enclosing `EditLayout.mode` is "tabs". */
     readonly id?: string;
@@ -427,6 +466,8 @@ export type EditWriteFormSection = {
     readonly kind: "writeForm";
     readonly title?: string;
     readonly description?: string;
+    /** i18n key of a short text shown instead of `description` below `sm`. */
+    readonly descriptionNarrow?: string;
     readonly columns?: number;
     readonly icon?: IconKey;
     /** Field-type map for this section's own form — same shape as
@@ -445,6 +486,8 @@ export type EditWriteFormSection = {
     readonly handler: string;
     /** i18n-key for the submit button. Default: "kumiko.actions.save". */
     readonly submitLabel?: string;
+    /** Id of a writeHandler action in the screen's `actions`. The section then has no submit button of its own: the action sends its own payload plus this form's current values in one write to the action's handler, after the form validated (an invalid form sends nothing). A form field named like a payload key of the action is rejected at boot; `handler` is not dispatched. */
+    readonly submitWith?: string;
     /** Rendered top-right in the section's Card title row — same
      *  navigate/drawer/writeHandler dispatch as `ProjectionDetailScreenDefinition.actions`,
      *  evaluated against the same record. Every action must resolve an icon
@@ -466,6 +509,8 @@ export type EditLayout = {
      *  boot-validator rejects it on entityEdit, see the check for the reason);
      *  requires >= 2 sections, each with a title and an `id`. */
     readonly mode?: "single" | "wizard" | "tabs";
+    /** `false` (tabs mode): below `sm` there is no tab strip, the visible sections of every tab stand one under the other. */
+    readonly narrowTabs?: false;
     /** "settings-list" lays each section out as a band with a title column on
      *  the left and one hairline-separated row per field (label + help left,
      *  control right) — the familiar settings pattern, for screens that are a

package/dist/screen-entity-list.d.ts

@@ -50,17 +50,34 @@ export type ListColumnSpec = string | {
      *  header with tabular figures, like an entityList column of that field
      *  type. Ignored on entityList columns, where the field's own type wins. */
     readonly valueType?: "number" | "decimal" | "bigInt" | "money";
-    /** `false` leaves an empty cell blank instead of drawing the "—" placeholder. Not combinable with `hint`, whose empty sentence is `hint.emptyLabel`. */
-    readonly emptyPlaceholder?: false;
+    /** An empty cell stays blank by default; a string (i18n key or literal) is shown muted in its place, e.g. "No vehicle". Not combinable with `hint`, whose empty sentence is `hint.emptyLabel`. */
+    readonly emptyPlaceholder?: string | false;
     /** Leaves the column out of the compact card layout used below the
-     *  `md` breakpoint (tables keep it). For columns that only make sense
+     *  `md` breakpoint (phone viewport). For columns that only make sense
      *  next to the others, like a sort key. */
     readonly hideOnNarrow?: boolean;
+    /** Leaves the column out of a table whose container is narrower than `md` (docked assistant panel); the viewport is not looked at,
+     *  so the phone card still shows it. */
+    readonly hideWhenDocked?: true;
     /** Counterpart of `hideOnNarrow`: the column shows only in the compact card layout and not in the table.
      *  Not combinable with `hideOnNarrow`, `hidden` or `pinned`. */
     readonly showOnNarrowOnly?: true;
     /** In the compact card, consecutive `narrowInline` columns stand side by side on one line (12px gap, no separator) instead of one line each. */
     readonly narrowInline?: true;
+    /** One line with a trailing ellipsis in the table; the full text is the cell's `title`. */
+    readonly ellipsis?: true;
+    /** Free text: the cell wraps instead of ending in "…", and a line break (`\n`) in the value starts a new line (table and phone card). */
+    readonly multiline?: true;
+    /** Phone card: the column's line stands above the title (muted, e.g. "date, channel") instead of below it. Consecutive `narrowInline` columns share the line. */
+    readonly cardAbove?: true;
+    /** Cell text in medium weight and foreground colour, like the title column of a board. */
+    readonly emphasis?: true;
+    /** `"muted"` draws every cell of the column in the muted text colour (e.g. a free-text message beside primary columns). */
+    readonly tone?: "muted";
+    /** The phone card shows this column as its badge: right of the title, as an outlined neutral pill (a `display: "badge"` column keeps its own pill). Without one the first select column is the badge. */
+    readonly cardBadge?: true;
+    /** Timestamp or relativeTime column: a value older than this many days shows the date only, without the time. */
+    readonly dateOnlyAfterDays?: number;
     /** Start state for the column picker: the column begins hidden and the
      *  user can show it. Only valid together with `table.columnPicker`. */
     readonly hidden?: boolean;
@@ -83,10 +100,12 @@ export type ListColumnSpec = string | {
     readonly display?: ListColumnDisplay;
     /** `"primary"` draws a `display: "button"` link as a filled primary button instead of the outline default (dashboard list panels only). Needs `display: "button"`. */
     readonly variant?: "primary";
-    /** Row field naming the badge tone; only with `display: "badge"`. */
+    /** Row field naming the badge tone: a `ListBadgeTone` word or a `SelectOptionTone` word (`ok`, `bad`, `critical`, `accent`); only with `display: "badge"`. */
     readonly badgeToneField?: string;
     /** `false` draws the badge pill without its leading dot; only with `display: "badge"`. */
     readonly badgeDot?: false;
+    /** `"sparkles"` marks an AI-prepared value: the dashboard list draws the badge as the soft blue AI pill with a sparkles icon, like an AI row action; only with `display: "badge"`. */
+    readonly badgeIcon?: "sparkles";
     /** Row field holding a second label, drawn as a pill next to the cell's own value
      *  (e.g. a vehicle name with a "free" pill). Not combinable with `display` or `hint`. */
     readonly pillField?: string;
@@ -156,9 +175,10 @@ export type RowFieldExtractor = {
  *  `"link"` without one). `"responsive"` is a `"button"` with icon and label
  *  from tablet width up and an icon-only button below it, the label staying the
  *  accessible name (needs a resolved icon, falls back to `"button"` without
- *  one). Unset: the renderer decides (primary action as link, the rest in the
+ *  one). `"text"` is a closed state without an action: muted text, not
+ *  clickable (the row click still applies). Unset: the renderer decides (primary action as link, the rest in the
  *  kebab menu). */
-export type RowActionDisplay = "button" | "link" | "icon" | "responsive";
+export type RowActionDisplay = "button" | "link" | "icon" | "responsive" | "text";
 /** Row-action column layout. `"adaptive"` (default): primary action as link,
  *  the rest in a kebab menu — except actions with an explicit `display`, which
  *  stay inline. `"inline"`: every action inline, no kebab. `"menu"`: every
@@ -250,8 +270,9 @@ export type RowActionNavigateBase = {
     readonly rowClick?: boolean;
     /** Overrides the id-based default icon (see ACTION_ICON_BY_ID in
      *  kumiko-renderer) — closed IconKey vocabulary into the ICONS registry
-     *  (renderer/web), analogous to EditFieldSpec.icon. */
-    readonly icon?: IconKey;
+     *  (renderer/web), analogous to EditFieldSpec.icon. `false` draws no icon at all, not even the
+     *  id-derived default (a plain text button). */
+    readonly icon?: IconKey | false;
     /** Inline render form in the row-action column — see `RowActionDisplay`. */
     readonly display?: RowActionDisplay;
 };
@@ -473,6 +494,8 @@ export type EntityListScreenDefinition = {
     readonly columns: readonly ListColumnSpec[];
     /** Row field holding a SelectOptionTone; the row is toned like relatedList `rowTone`, other values leave it untoned. */
     readonly rowToneField?: string;
+    /** Row field (boolean): a row with a true value is drawn entirely in the muted text colour. */
+    readonly mutedRowField?: string;
     /** Computed row fields from an app query, readable by `rowToneField`, column `hint`, `linkScreenField`/`linkParamsField` and rowAction `visible`/`params`/`payload`; a column may name a decoration field. */
     readonly rowDecoration?: ListRowDecoration;
     readonly rowRenderer?: PlatformComponent;

package/dist/screen-projection.d.ts

@@ -5,7 +5,7 @@ import type { NamedFilterFacetOptions, NamedListFilterRef } from "./named-list-f
 import type { NavIconKey } from "./nav-icon.ts";
 import type { FormatSpec, PlatformComponent, ScreenNavSugar, ScreenSlots } from "./screen.ts";
 import type { DashboardStatTone, ScreenVisibility } from "./screen-dashboard.ts";
-import type { EditLayout, ListEmptyStateSpec } from "./screen-entity-edit.ts";
+import type { EditLayout, EntityEditAction, ListEmptyStateSpec } from "./screen-entity-edit.ts";
 import type { ListColumnSpec, ListPaginationMode, ListRowDecoration, ListSortOption, ListSortSpec, RowAction, RowActionMode, RowFieldExtractor, ScreenFilter, ToolbarAction } from "./screen-entity-list.ts";
 import type { ScreenFallback } from "./screen-fallback.ts";
 import type { ListBulkAction } from "./screen-list-bulk.ts";
@@ -81,6 +81,8 @@ export type ProjectionListScreenDefinition = {
     readonly columns: readonly ListColumnSpec[];
     /** Row field holding a SelectOptionTone; the row is toned like relatedList `rowTone`, other values leave it untoned. */
     readonly rowToneField?: string;
+    /** Row field (boolean): a row with a true value is drawn entirely in the muted text colour. */
+    readonly mutedRowField?: string;
     /** Computed row fields from an app query, merged into the query rows; see `ListRowDecoration`. */
     readonly rowDecoration?: ListRowDecoration;
     readonly rowRenderer?: PlatformComponent;
@@ -159,6 +161,8 @@ export type RecordHeaderSpec = {
     readonly subtitle?: string | readonly RecordHeaderSubtitlePart[];
     /** Field holding a plain-text subtitle shown instead of `subtitle` below `sm` (e.g. "Main St 12, Berlin · 3 rooms"). */
     readonly narrowSubtitle?: string;
+    /** i18n key of a short title for the phone top bar ("Approval") instead of the record title. */
+    readonly narrowTitle?: string;
     readonly status?: string;
     /** Formats the badge text (typically `enumOption` with a `keyPrefix`); tones still resolve on the raw value. Needs `status`. Without it, the `status` field's layout renderer is used when it is `enumOption` or `i18nText`. */
     readonly statusFormat?: FormatSpec;
@@ -205,6 +209,8 @@ export type MetricSpec = {
     readonly icon?: NavIconKey;
     /** Formats the displayed value (e.g. `date`, `enumOption`); the tone still resolves on the raw value. */
     readonly format?: FormatSpec;
+    /** Shows the metric only while the loaded record matches; same `{ field, eq | ne | in | notIn }` syntax as a section's `visibleWhen`. `field` must be an output field of the detail query. */
+    readonly visibleWhen?: Exclude<FieldCondition, boolean>;
 };
 export type ProjectionDetailScreenDefinition = {
     readonly id: string;
@@ -262,10 +268,16 @@ export type ProjectionDetailScreenDefinition = {
     readonly metrics?: readonly MetricSpec[];
     /** "tiles" draws the metrics as the dashboard KPI tiles (StatCard) instead of the plain band. */
     readonly metricsStyle?: "band" | "tiles";
-    /** `narrow: "after-guidance"` moves the metrics below the summary, banner and steps on screens under md, ahead of the tabs. Works with the page header and the head card; only the metric tiles move, the subtitle and status line stay under the title. */
+    /** On screens under md, `narrow: "after-guidance"` moves the metrics below the summary, banner and steps, ahead of the tabs; `"before-steps"` puts them below the summary and banner, ahead of the next step. Works with the page header and the head card; only the metric tiles move, the subtitle and status line stay under the title. */
     readonly metricsPlacement?: {
-        readonly narrow?: "after-guidance";
+        readonly narrow?: "after-guidance" | "before-steps";
     };
+    /** Record field holding one line of text shown instead of the metrics below `sm`. The metrics stay on larger screens; an empty value keeps them on phones too. */
+    readonly mobileSummary?: string;
+    /** `false` leaves out the "On this page" navigation of a stacked (non-tabs) layout. */
+    readonly pageNavigation?: false;
+    /** A tab holding fields sections and a relatedList with `photoGrid` shows the fields left and the photos right from `lg` up. */
+    readonly photosBeside?: true;
     /** Path above the header (query column holding items). */
     readonly breadcrumb?: RecordBreadcrumbSpec;
     /** One emphasized sentence below the header. */
@@ -284,8 +296,10 @@ export type ProjectionDetailScreenDefinition = {
      *  displayed record stands in for the "row", so `pick`/`map`, `visible`,
      *  `confirm`/`confirmLabel` and `style` keep their meaning unchanged.
      *  `rowClick` has no target here (there is no row to click) and is
-     *  rejected by the boot-validator. */
-    readonly actions?: readonly RowAction[];
+     *  rejected by the boot-validator. `placement: "menu"` puts the action
+     *  into the header "…" menu instead of a button (without a header menu it
+     *  falls back to inline). */
+    readonly actions?: readonly EntityEditAction[];
     /** Id of the action that stays the visible header button when the actions
      *  collapse into a menu (and the one that keeps the phone icon slot when it
      *  has an icon and no confirm). An `actions` id or `"edit"` (the default edit

package/dist/screen-record-guidance.d.ts

@@ -61,6 +61,8 @@ export type RecordSummarySpec = {
 export type RecordBannerSpec = {
     /** Holds `RecordNotice | null`; null shows no banner. */
     readonly field: string;
+    /** Draws the notice without the tone icon. */
+    readonly iconless?: true;
     readonly actions?: readonly RecordGuidanceAction[];
 };
 export type RecordStepsSpec = {

package/dist/screen.d.ts

@@ -29,9 +29,9 @@ export interface FieldFormatRegistry {
         /** IANA zone id (e.g. "Europe/Berlin"). Default: the runtime's zone. */
         readonly timeZone?: string;
     };
-    /** Epoch ms or ISO timestamp, shown as "5 minutes ago" at render time (a table cell does not tick).
-     *  `style: "short"` gives "5 min. ago"; `withTime` adds the clock time to "yesterday" and to the absolute date;
-     *  from `absoluteAfterDays` days on the absolute date ("29 Oct 2026") replaces the relative text. */
+    /** Epoch ms or ISO timestamp, shown as "5 min. ago" at render time (a table cell does not tick).
+     *  Defaults: `style: "short"`, `withTime: true` (clock time on "yesterday" and on the absolute date; `false` leaves it out),
+     *  `absoluteAfterDays: 7` (from then on the absolute date, "29 Oct 2026", replaces the relative text); under a minute reads "just now". */
     relativeTime: {
         readonly locale?: string;
         readonly style?: "long" | "short" | "narrow";
@@ -135,7 +135,7 @@ export type { ActionFormFooterAction, ActionFormLoad, ActionFormRedirect, Action
 export type { ConfigEditAction, ConfigEditScreenDefinition, CustomScreenDefinition, CustomScreenRoute, SecretsEditScreenDefinition, SecretsEditSection, } from "./screen-custom-config.ts";
 export type { DashboardChartKind, DashboardChartMarkerKind, DashboardChartPanel, DashboardChartRangeOption, DashboardChartRanges, DashboardChartTone, DashboardCurrencyFormat, DashboardCustomPanel, DashboardDateParam, DashboardFeedPanel, DashboardFilterDefinition, DashboardI18nText, DashboardLayout, DashboardListFooterLink, DashboardListNarrow, DashboardListPanel, DashboardListRowLink, DashboardListRowToneMarker, DashboardMoneyParam, DashboardPanelColumn, DashboardPanelDefinition, DashboardPanelEmptyState, DashboardPanelGate, DashboardPanelNarrow, DashboardPanelQueryOptions, DashboardPanelSpan, DashboardPanelVisibility, DashboardProgressListPanel, DashboardProgressTone, DashboardRecordBinding, DashboardRefresh, DashboardRelativeTimeFormat, DashboardRelativeTimeParam, DashboardScopeDefinition, DashboardScreenDefinition, DashboardScreenPanel, DashboardStatGroupLayout, DashboardStatGroupLink, DashboardStatGroupNarrow, DashboardStatGroupPanel, DashboardStatPanel, DashboardStatTone, DashboardText, DashboardTextBlock, DashboardTextPanel, DashboardTextParam, DashboardTimeRangeDefinition, DashboardValueFormat, ScreenVisibility, } from "./screen-dashboard.ts";
 export { DASHBOARD_MIN_REFRESH_SECONDS, DASHBOARD_STAT_TONES } from "./screen-dashboard.ts";
-export type { EditExtensionSection, EditFieldGroup, EditFieldPrefill, EditFieldSpec, EditFieldsSection, EditLayout, EditRelatedListSection, EditSectionSpec, EditStepListSection, EditWriteFormSection, EmbeddedListEditSpec, EntityEditAction, EntityEditActionPlacement, EntityEditScreenDefinition, EntityWriteExcludedFields, FieldAffix, FieldAiAssist, FieldAiAssistChip, FieldFillAction, FieldTextRef, FieldValueChips, FormWidth, ListEmptyStateSpec, RelatedListEmptyStateSpec, RelatedListEmptyStateVariant, RelatedListRowTone, StepListItem, } from "./screen-entity-edit.ts";
+export type { EditExtensionSection, EditFieldGroup, EditFieldPrefill, EditFieldSpec, EditFieldsSection, EditLayout, EditRelatedListSection, EditSectionSpec, EditStepListSection, EditWriteFormSection, EmbeddedListEditSpec, EntityEditAction, EntityEditActionPlacement, EntityEditScreenDefinition, EntityWriteExcludedFields, FieldAffix, FieldAiAssist, FieldAiAssistChip, FieldBadge, FieldFillAction, FieldTextRef, FieldValueChips, FormWidth, ListEmptyStateSpec, RelatedListEmptyStateSpec, RelatedListEmptyStateVariant, RelatedListRowTone, StepListItem, } from "./screen-entity-edit.ts";
 export { relatedListGroupHeaderLabel, relatedListGroupKey } from "./screen-entity-edit.ts";
 export type { EntityListFacetConfig, EntityListFacetExtraOption, EntityListScreenDefinition, ListBadgeTone, ListColumnDisplay, ListColumnHint, ListColumnSpec, ListPaginationMode, ListRowDecoration, ListSortDir, ListSortOption, ListSortSpec, RelatedListToolbarAction, RowAction, RowActionClientAction, RowActionDisplay, RowActionDrawer, RowActionMode, RowActionNavigate, RowActionNavigateBase, RowActionWriteHandler, RowFieldExtractor, ScreenFilter, ScreenFilterOp, ToolbarAction, } from "./screen-entity-list.ts";
 export type { EntityListExpandableRow, ExpandableRowGrouping } from "./screen-expandable-row.ts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.416.0",
+  "version": "0.417.0",
   "description": "Framework-Type-Definitions für Kumiko — FeatureDefinition, BootCheck-Types und die reinen Engine-Types. Erlaubt Downstream-Konsumenten, gegen die Type-Contracts zu bauen, ohne das ganze Framework-Package zu importieren. Enthaelt keine identitaets-sensitiven Runtime-Werte mehr (Error-Klassen leben seit #1629 in kumiko-framework, Brand-Symbole nutzen Symbol.for) und ist deshalb eine plain dependency, keine peerDependency.",
   "license": "MIT",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",