@cosmicdrift/kumiko-types 0.414.0 → 0.416.0

package/dist/config.d.ts

@@ -83,6 +83,8 @@ export type ConfigMask = {
     readonly description?: string;
     readonly icon?: NavIconKey;
     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;
 };
 export type ConfigDefinition = {
     readonly keys: Readonly<Record<string, ConfigKeyDefinition>>;
@@ -164,6 +166,8 @@ export type MaxPerTenantOptions = {
     readonly onLimit: "skip" | "defer";
     readonly deferMs?: number | undefined;
 };
+export declare const IRREVERSIBLE_WITHOUT_ENTRY_HANDLER_CASES: readonly ["rebuildable-derived-data", "high-risk-or-cron-pipeline", "per-dispatch-record-key"];
+export type IrreversibleWithoutEntryHandler = (typeof IRREVERSIBLE_WITHOUT_ENTRY_HANDLER_CASES)[number];
 export type JobDefinition = {
     readonly name: string;
     readonly handler: JobHandlerFn;
@@ -189,6 +193,7 @@ export type JobDefinition = {
     readonly tenantVisibleRun?: {
         readonly subjectFields?: readonly string[] | undefined;
     } | undefined;
+    readonly irreversibleWithoutEntryHandler?: IrreversibleWithoutEntryHandler | undefined;
 };
 export type NotificationRecipientFn = (result: import("./hooks.ts").SaveContext) => string | readonly string[] | {
     readonly tenant: string;

package/dist/config.js

@@ -1 +1,10 @@
-export {};
+// The only pipelines allowed to call an irreversible primitive (forget, hard delete, kms.eraseKey,
+// readAsInstruction write) without a directly dispatched entry handler. A new case is a framework change.
+//   rebuildable-derived-data   deletes derived data that is re-created from a reversible source
+//   high-risk-or-cron-pipeline runs behind a risk "high" handler or as a cron scan of expired data
+//   per-dispatch-record-key    the step-dispatcher erasing its per-dispatch record key
+export const IRREVERSIBLE_WITHOUT_ENTRY_HANDLER_CASES = [
+    "rebuildable-derived-data",
+    "high-risk-or-cron-pipeline",
+    "per-dispatch-record-key",
+];

package/dist/fields.d.ts

@@ -227,8 +227,8 @@ export type MultiSelectFieldDef<TOptions extends readonly string[] = readonly st
     readonly access?: FieldAccess;
     /** Renderer metadata: `"checkboxes"` renders every option as a visible
      *  checkbox with a select-all toggle. Default (omitted) stays the combobox
-     *  dropdown. */
-    readonly display?: "checkboxes" | "dropdown";
+     *  dropdown; `"chips"` renders toggle chips with a check mark on the chosen ones. */
+    readonly display?: "checkboxes" | "chips" | "dropdown";
     /** Renderer metadata: column count for the `"checkboxes"` grid at the widest
      *  breakpoint; narrow viewports always collapse to one column. Omitted =
      *  the renderer picks a sensible count. Ignored unless
@@ -830,4 +830,10 @@ export type EntityDefinition<F extends FieldsMap = FieldsMap, T extends EntityTe
     /** Attached files are readable only through the record's detail query: the files feature's
      *  privilegedRoles do not bypass it, the uploader check stays. */
     readonly attachedFileAccess?: "record-only";
+    /** Files of this entity may be read from another tenant when `query`, run with `{ id: <entityId> }`
+     *  as the requesting user, returns the record with that id. Read only: delete stays with the owning tenant. */
+    readonly crossTenantFileRead?: {
+        readonly query: string;
+        readonly reason: string;
+    };
 };

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

@@ -6,7 +6,7 @@ import type { EntityCache } from "./entity-cache.ts";
 import type { EnvelopeCipher } from "./envelope-cipher-types.ts";
 import type { FileContext } from "./file-handle-types.ts";
 import type { FileProviderResolver } from "./file-provider-resolver-types.ts";
-import type { DeliveryAttemptLogFactory, DeliveryAttemptLogFn, EscapeHatchAuditSink, JobRunnerRef, NotifyFactory, NotifyFn, SessionUser, TenantWriteTarget } from "./handlers.ts";
+import type { DeliveryAttemptLogFn, EscapeHatchAuditSink, JobRunnerRef, NotifyFactory, NotifyFn, SessionUser, TenantWriteTarget } from "./handlers.ts";
 import type { TenantId } from "./identifiers.ts";
 import type { KmsAdapter } from "./kms-adapter-types.ts";
 import type { RateLimitResolver } from "./rate-limit-types.ts";
@@ -44,7 +44,6 @@ export type ContextServices = {
     readonly _notifyFactory?: NotifyFactory;
     readonly _notifyInTransactionFactory?: (user: SessionUser, tenantId: TenantId) => NotifyFn;
     readonly _notifyAfterCommitFactory?: (user: SessionUser, tenantId: TenantId) => NotifyFn;
-    readonly _deliveryAttemptLogFactory?: DeliveryAttemptLogFactory;
     readonly _logOwnDeliveryAttempt?: DeliveryAttemptLogFn;
     readonly _escapeHatchAuditSink?: EscapeHatchAuditSink;
     readonly extensions: Readonly<Record<string, unknown>>;

package/dist/handlers.d.ts

@@ -143,6 +143,7 @@ export type JobRunnerRef = {
         readonly priority?: number;
         readonly jobId?: string;
     }): Promise<unknown>;
+    isJobPending?(jobName: string, jobId: string): Promise<boolean>;
 };
 export type DispatchWriteRef = {
     readonly write: (user: SessionUser, qn: string, payload: unknown, inheritedOrigin?: WriteOrigin) => Promise<WriteResult>;

package/dist/multi-stream-apply-context-types.d.ts

@@ -8,7 +8,9 @@ import type { AppendEventFn, UnsafeAppendEventFn } from "./handlers.ts";
 import type { SecretsContext } from "./secrets-types.ts";
 export type MultiStreamApplyContext<TMap extends object = KumikoEventTypeMap> = {
     readonly appendEvent: AppendEventFn<TMap>;
-    readonly unsafeAppendEvent: UnsafeAppendEventFn;
+    readonly unsafeAppendEvent: (args: Parameters<UnsafeAppendEventFn>[0] & {
+        readonly expectedVersion?: number;
+    }) => Promise<void>;
     readonly loadAggregate: (aggregateId: string, options?: {
         readonly asOf?: Temporal.Instant;
     }) => Promise<readonly StoredEvent[]>;

package/dist/named-list-filters.d.ts

@@ -31,19 +31,32 @@ export type NamedListFilterRef = {
     readonly label: string;
     /** Order while this filter is active and the URL carries no sort of its own; wins over `defaultSort`. */
     readonly sort?: ListSortSpec;
-    /** Shown instead of the generic "no matches" text when this filter yields an empty list and no search term is set; both are i18n keys. */
+    /** Select display: draws a divider line below this entry in the dropdown. */
+    readonly separatorAfter?: boolean;
+    /**
+     * Shown instead of the generic "no matches" text when this filter yields an empty list and no
+     * search term is set; `title` and `description` are i18n keys. `paramsQuery` (a registered query
+     * QN, called without payload) runs only while the empty state is on screen; its result object
+     * becomes the translation params of `description`. Without data (loading, error, no result) the
+     * description is not rendered.
+     */
     readonly emptyState?: {
         readonly title: string;
         readonly description?: string;
+        readonly paramsQuery?: string;
     };
-    /** Set by the framework from the entity filter's role rule; the chip is offered only to users holding one of them. */
-    readonly roles?: readonly string[];
+    /** Set by the framework from the entity filter's access rule; the client offers the chip only where `isUiAccessGranted` allows it. */
+    readonly access?: AccessRule;
 };
 /** How the named filters appear in the toolbar: toggle chips (default) or one single-choice select. */
 export type NamedFilterFacetOptions = {
     readonly display?: "chips" | "select";
     /** Ask the list query for each filter's hit count and show it next to the label. */
     readonly showCounts?: boolean;
+    /** Select entries with zero hits are left out (the active one and "all" stay). Asks for the counts like `showCounts` does, without showing the number unless `showCounts` is set. */
+    readonly hideEmpty?: boolean;
+    /** "behind-filter": the select opens behind the filter icon next to the search field instead of standing as a pill. Only below `sm`; otherwise it stays a pill. */
+    readonly narrowPlacement?: "behind-filter";
     /** i18n key for the select's label, e.g. "To do". */
     readonly label?: string;
 };

package/dist/nav-icon.js

@@ -10,7 +10,7 @@
 // versa.
 //
 // Declared as a runtime tuple (not just a type) so callers that sit outside
-// this repo's `tsc --build` project graph (e.g. samples, external consumers
+// this repo's typecheck project graph (e.g. samples, external consumers
 // resolving from a stale published type) still get a runtime-checkable
 // vocabulary — the boot-validator's validateActionHasIcon checks a declared
 // icon against NAV_ICON_KEYS instead of trusting "not undefined".

package/dist/projection.d.ts

@@ -1,4 +1,4 @@
-import type { RunIn } from "./config.ts";
+import type { IrreversibleWithoutEntryHandler, RunIn } from "./config.ts";
 import type { StoredEvent } from "./event-store-types.ts";
 import type { ExecutorManagedRunner } from "./executor-brand.ts";
 import type { EntityDefinition } from "./fields.ts";
@@ -38,4 +38,5 @@ export type MultiStreamProjectionDefinition = {
     readonly runIn?: RunIn;
     readonly delivery?: "shared" | "per-instance";
     readonly startFrom?: "beginning" | "now";
+    readonly irreversibleWithoutEntryHandler?: IrreversibleWithoutEntryHandler;
 };

package/dist/screen-action-form.d.ts

@@ -1,9 +1,9 @@
-import type { FormFieldDefinition } from "./fields.ts";
+import type { FormFieldDefinition, SelectOptionTone } from "./fields.ts";
 import type { AccessRule, AgentScreenHints } from "./handlers.ts";
 import type { IconKey } from "./nav-icon.ts";
 import type { ScreenNavSugar, ScreenSlots } from "./screen.ts";
 import type { ScreenVisibility } from "./screen-dashboard.ts";
-import type { EditLayout } from "./screen-entity-edit.ts";
+import type { EditLayout, FieldTextRef } from "./screen-entity-edit.ts";
 import type { ScreenFallback } from "./screen-fallback.ts";
 /** A form field computed from other fields of the same form. `listSum` adds one
  *  numeric cell over all rows of an embedded list field; its `whenEmpty`
@@ -70,7 +70,7 @@ export type ActionFormScreenDefinition = {
     readonly layout: EditLayout;
     /** Per-field label i18n key override, same type/semantics as
      *  `EntityEditScreenDefinition.fieldLabels`. Falls back to the convention when absent. */
-    readonly fieldLabels?: Readonly<Record<string, string>>;
+    readonly fieldLabels?: Readonly<Record<string, FieldTextRef>>;
     /** i18n key for the submit button. Default: the renderer's i18n default
      *  (typically "actions.submit"). */
     readonly submitLabel?: string;
@@ -87,7 +87,22 @@ export type ActionFormScreenDefinition = {
         readonly title: string;
         readonly subtitle?: string;
         readonly params?: Readonly<Record<string, string>>;
+        /** Fields of the `load` result that fill `{name}` placeholders too (static `params` win). Needs `load`. */
+        readonly paramsFromLoad?: readonly string[];
     };
+    /** Help text under a field (field name -> i18n key). */
+    readonly fieldDescriptions?: Readonly<Record<string, FieldTextRef>>;
+    /** i18n key of a short note in a banner above the fields, with a sparkles icon (e.g. "the AI
+     *  prepared everything, read the text, then send"). */
+    readonly infoBand?: string;
+    /** Badge next to a field's label (field name -> `{ label: i18n key, tone }`), e.g. "price
+     *  source open" in `warn`. */
+    readonly fieldBadges?: Readonly<Record<string, {
+        readonly label: string;
+        readonly tone: SelectOptionTone;
+    }>>;
+    /** Shows a failed submit's error banner above the fields instead of below them. */
+    readonly formErrorOnTop?: boolean;
     /** Visual style of the submit button. "danger" renders it red — for a form
      *  whose handler is destructive (terminate, revoke, delete), so the warning
      *  isn't lost on the way from the calling screen to this one. Default "primary". */
@@ -181,11 +196,16 @@ export type ActionFormRedirect = {
      *  Only used when the target screen type carries an id (`entityEdit`,
      *  `projectionDetail`); a non-string or missing value navigates without
      *  an id, same as a payload without `id` does today. */
-    readonly idFrom: string;
+    readonly idFrom?: string;
     /** Section id to open on the target `projectionDetail` with `layout.mode:
      *  "tabs"` (the `tab` search param, same as `ToolbarAction` navigate `tab`).
      *  Boot rejects other targets and unknown section ids. */
     readonly tab?: string;
+    /** URL search params of the target, each read from a flat success-payload
+     *  field (`{ cmd: "threadId" }` opens `?cmd=<threadId>`). Lets a redirect
+     *  reach a custom screen that is driven by search params instead of a
+     *  record id; a missing or non-string field leaves its param out. */
+    readonly searchParams?: Readonly<Record<string, string>>;
 };
 export type ActionFormLoad = {
     /** Query QN that returns the record. */
@@ -197,6 +217,10 @@ export type ActionFormLoad = {
      *  (same semantics as `ProjectionDetailScreenDefinition.singleton`). Boot
      *  rejects declaring `idParam` alongside it. */
     readonly singleton?: boolean;
+    /** Sends the values a drawer opens the form with (row-action params, e.g. `vehicleId`) in the
+     *  load payload next to `idParam`, so the query can pre-fill for the chosen item. The query's
+     *  schema must accept them. */
+    readonly passPrefill?: boolean;
 };
 /** One key figure of the success box, read from the handler's success payload. */
 export type ActionFormSuccessFact = {
@@ -217,7 +241,7 @@ export type ActionFormSuccessItems = {
     readonly link?: ActionFormSuccessLink;
 };
 /** A redirect target rendered as a link in the success box. */
-export type ActionFormSuccessLink = Omit<ActionFormRedirect, "idFrom"> & {
+export type ActionFormSuccessLink = Omit<ActionFormRedirect, "idFrom" | "searchParams"> & {
     /** Success-payload field carrying the navigation id. Required for a record
      *  target (`entityEdit`, `projectionDetail`); omit it for a list, dashboard
      *  or form target, which opens without an id. */

package/dist/screen-dashboard.d.ts

@@ -59,11 +59,17 @@ export type DashboardPanelGate = {
 };
 /** Phone layout switch shared by every panel kind. */
 export type DashboardPanelNarrow = {
-    /** Leaves the panel out below the `sm` breakpoint (phone). Not valid on a stat-group child: hide the group. */
+    /** Leaves the panel out below the `sm` breakpoint (phone). On a stat-group child it drops that stat from the group on a phone; not every child may hide. */
     readonly hideOnNarrow?: true;
     /** Position below `sm`, like CSS `order`: panels are laid out by ascending value, a panel without one counts as 0, equal values keep the declared order. Integer ≥ 0. Desktop keeps the declared order. */
     readonly narrowOrder?: number;
+    /** "side" puts the panel in the narrow right column of a `layout: "main-side"` dashboard, "top" in a full-width block above both columns; panels without it fill the main column. Not valid on a stat-group child or without that layout. */
+    readonly column?: DashboardPanelColumn;
 };
+/** "top" spans both columns above the main and side column, in declared order. */
+export type DashboardPanelColumn = "side" | "top";
+/** "main-side": from `lg` up the main column (2/3) stacks every panel without `column`, the side column (1/3) every `column: "side"` panel, each with its own heights; `column: "top"` panels span both columns above them; below `lg` they stack, below `sm` by `narrowOrder`. Default: one 12-column grid. Panel `span` is ignored in this layout. */
+export type DashboardLayout = "main-side";
 export type DashboardPanelSpan = "half" | "full" | "third" | "two-thirds";
 export type DashboardPanelEmptyState = {
     readonly span?: DashboardPanelSpan;
@@ -356,6 +362,8 @@ export type DashboardTextPanel = DashboardPanelGate & DashboardPanelQueryOptions
     readonly id: string;
     /** Panel title (i18n key). */
     readonly label?: string;
+    /** Icon shown before the text blocks (resolved like `DashboardStatGroupPanel.icon`). */
+    readonly icon?: PlatformComponent;
     readonly span?: DashboardPanelSpan;
     /** Query answering `{ blocks: DashboardTextBlock[] }`; its blocks replace the static ones.
      *  Static blocks show while it loads, on error and when it answers empty. It may add
@@ -459,6 +467,8 @@ export type DashboardScreenDefinition = {
     /** Same-feature short id or cross-feature QN `<feature>:screen:<id>` shown when `visibleWhen` is unmet (default: standard notice). */
     readonly fallback?: ScreenFallback;
     readonly panels: readonly DashboardPanelDefinition[];
+    /** Panel arrangement, see DashboardLayout. */
+    readonly layout?: DashboardLayout;
     /** Binds the dashboard to one record via a URL search param, see DashboardRecordBinding. */
     readonly record?: DashboardRecordBinding;
     /** Header actions on the bound record (writeHandler, navigate, clientAction).

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

@@ -44,6 +44,13 @@ export type EditFieldSpec = string | {
      *  the value can only come from the suggestion. Only for single-line
      *  text and number inputs; other kinds ignore it. */
     readonly fillAction?: FieldFillAction;
+    /** Helper under a `text` or `longText` input: stackable chips and an optional free
+     *  instruction call a query and write its `resultField` into the field. */
+    readonly aiAssist?: FieldAiAssist;
+    /** Quick-pick chips under a `number`, `decimal`, `bigInt` or `money` input; a chip sets
+     *  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;
     /** 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
@@ -69,6 +76,41 @@ export type EditFieldSpec = string | {
 export type FieldAffix = string | {
     readonly field: string;
 };
+/** A label or help text: an i18n key, or a key whose `{placeholder}`s are filled from form values.
+ *  `params` maps each placeholder to the name of a form field (hidden fields count). */
+export type FieldTextRef = string | {
+    readonly key: string;
+    readonly params: Readonly<Record<string, string>>;
+};
+/** One toggle chip: while active, its `params` are merged into the query payload. */
+export type FieldAiAssistChip = {
+    /** i18n key of the chip label. */
+    readonly label: string;
+    readonly params: Readonly<Record<string, string | number | boolean>>;
+};
+export type FieldAiAssist = {
+    /** Qualified query name, run with the form's context payload (the `load` id of an actionForm,
+     *  else the drawer row's prefill values) plus the `params` of the active chips. */
+    readonly query: string;
+    /** Key in the query result written into the field; the value must be a string. */
+    readonly resultField: string;
+    /** Key in the query result with a short note for the user (e.g. "could not rewrite, draft unchanged"). Shown as a quiet line under the field until the next result without one. */
+    readonly noteField?: string;
+    /** Other fields of the same form whose current values are sent in the payload (under their
+     *  field names). Changing one of them runs the query again and replaces the text. */
+    readonly contextFields?: readonly string[];
+    readonly chips?: readonly FieldAiAssistChip[];
+    /** Adds an input where the user types a free instruction; it is sent under `param`. */
+    readonly prompt?: {
+        readonly param: string;
+        /** i18n key of the input's placeholder. */
+        readonly placeholder?: string;
+    };
+};
+export type FieldValueChips = {
+    /** Name of a field of the same form whose value is an array of numbers. For `money`, major units. */
+    readonly from: string;
+};
 export type FieldFillAction = {
     /** i18n key (falls back to the literal) of the button label. */
     readonly label: string;
@@ -96,11 +138,15 @@ export type EditFieldPrefill = {
     readonly kind: "currentUser";
     readonly property: "displayName" | "email" | "id";
 };
-export type EditSectionSpec = EditFieldsSection | EditExtensionSection | EditRelatedListSection | EditWriteFormSection;
+export type EditSectionSpec = EditFieldsSection | EditExtensionSection | EditRelatedListSection | EditWriteFormSection | EditStepListSection;
 type EditFieldsSectionBase = {
     /** Kebab-case tab id, used as the `?tab=` value. Required by the
      *  boot-validator when the enclosing `EditLayout.mode` is "tabs". */
     readonly id?: string;
+    /** projectionDetail only: shows the section (and its tab) only while the loaded record matches,
+     *  same `{ field, eq | ne | in | notIn }` syntax as a field's `visibleWhen`. `field` must be an
+     *  output field of the detail query. */
+    readonly visibleWhen?: Exclude<FieldCondition, boolean>;
     readonly kind?: "fields";
     /** Optional. Without a title the section only renders its fields (no h3
      *  heading) — for flat forms (card title + fields directly, a single
@@ -152,10 +198,34 @@ export type EditFieldsSection = EditFieldsSectionBase & ({
      *  here still need to exist. */
     readonly groups: readonly EditFieldGroup[];
 });
+/** One step of an `EditStepListSection`; `status` renders as a pill in `statusTone`. */
+export type StepListItem = {
+    readonly title: string;
+    readonly status?: string;
+    readonly statusTone?: SelectOptionTone;
+    readonly description?: string;
+};
+/** 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 = {
+    readonly id?: string;
+    readonly visibleWhen?: Exclude<FieldCondition, boolean>;
+    readonly kind: "stepList";
+    readonly title?: string;
+    /** Output field of the detail query holding a `StepListItem[]`. */
+    readonly field: string;
+    /** Present only so section-actions readers accept the union; a step list has no title-row actions. */
+    readonly actions?: undefined;
+};
 export type EditExtensionSection = {
     /** Kebab-case tab id, used as the `?tab=` value. Required by the
      *  boot-validator when the enclosing `EditLayout.mode` is "tabs". */
     readonly id?: string;
+    /** projectionDetail only: shows the section (and its tab) only while the loaded record matches,
+     *  same `{ field, eq | ne | in | notIn }` syntax as a field's `visibleWhen`. `field` must be an
+     *  output field of the detail query. */
+    readonly visibleWhen?: Exclude<FieldCondition, boolean>;
     readonly kind: "extension";
     readonly title: string;
     /** Wizard layouts only: intro text above the step, same slot as `EditFieldsSection.description`. */
@@ -212,6 +282,10 @@ export type EditRelatedListSection = {
     /** Kebab-case tab id, used as the `?tab=` value. Required by the
      *  boot-validator when the enclosing `EditLayout.mode` is "tabs". */
     readonly id?: string;
+    /** projectionDetail only: shows the section (and its tab) only while the loaded record matches,
+     *  same `{ field, eq | ne | in | notIn }` syntax as a field's `visibleWhen`. `field` must be an
+     *  output field of the detail query. */
+    readonly visibleWhen?: Exclude<FieldCondition, boolean>;
     readonly kind: "relatedList";
     readonly title: string;
     /** Rows are aggregates or other values with no record of their own, so they lead nowhere on
@@ -322,6 +396,14 @@ export type EditRelatedListSection = {
      *  ("kumiko.list.no-entries") applies. `action`'s icon must resolve, same
      *  as `actions` above. */
     readonly emptyState?: RelatedListEmptyStateSpec;
+    /** Draws the rows as a tile grid of images instead of a table. Each tile shows the file in
+     *  `imageField` and the row's `rowActions` underneath; `columns` only name the row fields. */
+    readonly photoGrid?: {
+        /** Row field holding a FileRef id (or an id array, the first shows). */
+        readonly imageField: string;
+        /** Row field printed under the image. */
+        readonly captionField?: string;
+    };
 };
 /** Empty-state text for one parent-record state, e.g. "still running" vs. "finished without rows". */
 export type RelatedListEmptyStateVariant = {
@@ -338,6 +420,10 @@ export type EditWriteFormSection = {
     /** Kebab-case tab id, used as the `?tab=` value. Required by the
      *  boot-validator when the enclosing `EditLayout.mode` is "tabs". */
     readonly id?: string;
+    /** projectionDetail only: shows the section (and its tab) only while the loaded record matches,
+     *  same `{ field, eq | ne | in | notIn }` syntax as a field's `visibleWhen`. `field` must be an
+     *  output field of the detail query. */
+    readonly visibleWhen?: Exclude<FieldCondition, boolean>;
     readonly kind: "writeForm";
     readonly title?: string;
     readonly description?: string;
@@ -388,6 +474,8 @@ export type EditLayout = {
     readonly variant?: "form" | "settings-list";
     /** Hides the asterisk after required field labels. Default false (shown). */
     readonly hideRequiredMarker?: boolean;
+    /** `false` switches off the "all fields are required" hint when every field is required; each label then carries its own asterisk. */
+    readonly allRequiredHint?: false;
     /** Persists in-progress wizard state as a resumable draft instead of
      *  discarding it on navigation away. */
     readonly draft?: boolean;
@@ -509,7 +597,7 @@ export type EntityEditScreenDefinition = {
      *  natural field namespace — the settings hub injects the config key's
      *  `mask.title` label here. A missing entry falls back to the
      *  convention. */
-    readonly fieldLabels?: Readonly<Record<string, string>>;
+    readonly fieldLabels?: Readonly<Record<string, FieldTextRef>>;
     /** Record actions. Reuses `RowAction` — analogous to
      *  `ProjectionDetailScreenDefinition.actions` (the loaded record stands
      *  in for the "row"). `rowClick` has no target here and is rejected by

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

@@ -9,7 +9,7 @@ import type { ListEmptyStateSpec } from "./screen-entity-edit.ts";
 import type { EntityListExpandableRow } from "./screen-expandable-row.ts";
 import type { ScreenFallback } from "./screen-fallback.ts";
 import type { ListBulkAction } from "./screen-list-bulk.ts";
-import type { ListColumnPin, ListNarrowFacets, ListTableOptions } from "./screen-list-table.ts";
+import type { ListColumnPin, ListNarrowFacets, ListTableOptions, ListToolbarActionsPlacement } from "./screen-list-table.ts";
 export type ListColumnSpec = string | {
     readonly field: string;
     readonly renderer?: FieldRenderer;
@@ -59,6 +59,8 @@ export type ListColumnSpec = string | {
     /** 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;
     /** 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;
@@ -79,10 +81,17 @@ export type ListColumnSpec = string | {
      *  entityList or projectionList table is a rowAction with display "button" (boot-rejected
      *  on columns there). Other list renderers ignore `display`. */
     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"`. */
     readonly badgeToneField?: string;
     /** `false` draws the badge pill without its leading dot; only with `display: "badge"`. */
     readonly badgeDot?: false;
+    /** 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;
+    /** Row field naming the tone of the `pillField` pill (a `ListBadgeTone`). Needs `pillField`. */
+    readonly pillToneField?: string;
     /** Row field holding a screen QN (`<feature>:screen:<id>`): the cell links
      *  to that screen when the row sets it and the user may open it. For
      *  query-backed lists (projectionList, relatedList), whose rows can point
@@ -98,6 +107,8 @@ export type ListColumnHint = {
     readonly detailField?: string;
     /** Row field shown as the detail line below `sm` instead of `detailField` (a shorter line, e.g. "5 days · Anna Schneider"). Needs `detailField`. */
     readonly narrowDetailField?: string;
+    /** Row field shown as the sentence on the phone card instead of the column's own value (a shorter sentence); the table keeps the column value. An empty value falls back to it. */
+    readonly narrowField?: string;
     /** Row field holding a SelectOptionTone; defaults to the screen's `rowToneField`. Tone `neutral` draws the sentence muted and not bold, like `emptyLabel`, and no stripe on the phone card. */
     readonly toneField?: string;
     /** Row field with a longer reason, shown behind a "Why?" toggle in the cell. */
@@ -111,7 +122,7 @@ export type ListColumnHint = {
     /** The sentence keeps the normal text color (still bold); the tone stays on the row stripe, a badge and the detail line. */
     readonly plainSentence?: true;
 };
-/** Computed fields for the loaded rows: one `query` call per page answer with `{ ...params, ids }`, answering `{ rows: [{ id, ...fields }] }`. Fields are merged into the rows and win over same-named row fields. */
+/** Computed fields for the loaded rows: `query` calls with `{ ...params, ids }`, answering `{ rows: [{ id, ...fields }] }`. Fields are merged into the rows and win over same-named row fields. The ids go out in batches of the first page size (later pages send only the newly loaded ids; a reload re-asks all loaded rows batch by batch), so `ids.max` must cover at least the page size; a failing call shows plain rows. */
 export type ListRowDecoration = {
     readonly query: string;
     readonly params?: Readonly<Record<string, unknown>>;
@@ -153,9 +164,12 @@ export type RowActionDisplay = "button" | "link" | "icon" | "responsive";
  *  stay inline. `"inline"`: every action inline, no kebab. `"menu"`: every
  *  action in the kebab menu at the row end, none inline, the row opener
  *  (`rowClick: true`) included as an entry, so every row has a kebab; phone
- *  cards draw no kebab. */
+ *  cards draw no kebab when the row opens, a card without a row target keeps it. */
 export type RowActionMode = "adaptive" | "inline" | "menu";
-export type RowAction = RowActionWriteHandler | RowActionNavigate | RowActionDrawer | RowActionClientAction;
+export type RowAction = (RowActionWriteHandler | RowActionNavigate | RowActionDrawer | RowActionClientAction) & {
+    /** projectionDetail `footerActions` only: "start" sets the button apart on the left of the footer. */
+    readonly align?: "start";
+};
 export type RowActionWriteHandler = {
     /** Default for RowActions without an explicitly set `kind` —
      *  backwards-compatible form. Can also be set explicitly. */
@@ -318,8 +332,8 @@ export type RowActionClientAction = {
     /** Inline render form in the row-action column — see `RowActionDisplay`. */
     readonly display?: RowActionDisplay;
     /** i18n key of the toast shown after the handler reported `{ ok: true }`
-     *  (default `kumiko.clientAction.success`). */
-    readonly successMessage?: string;
+     *  (default `kumiko.clientAction.success`); `false` shows no toast. */
+    readonly successMessage?: string | false;
 };
 export type ToolbarAction = ({
     readonly kind: "navigate";
@@ -411,6 +425,8 @@ export type EntityListFacetExtraOption = {
     readonly values: readonly string[];
     /** Where the chip sits relative to the field's own options. Default "start". */
     readonly position?: "start" | "end";
+    /** Draws a divider line below this choice in the select dropdown (e.g. after a "needs action" bundle). */
+    readonly separatorAfter?: boolean;
 };
 export type EntityListFacetConfig = {
     /** `"select"` (default): dropdown with checkboxes. `"chips"`: one toggle
@@ -425,6 +441,8 @@ export type EntityListFacetConfig = {
      *  `showCounts`'s requests even when the number itself is not shown. */
     readonly hideEmpty?: boolean;
     readonly extraOptions?: readonly EntityListFacetExtraOption[];
+    /** "behind-filter": the facet opens behind the filter icon next to the search field instead of standing as a pill. Only below `sm`; otherwise it stays a pill. The remaining facets follow the usual phone rules and share the toggle panel. */
+    readonly narrowPlacement?: "behind-filter";
 };
 export type EntityListScreenDefinition = {
     readonly id: string;
@@ -509,14 +527,14 @@ export type EntityListScreenDefinition = {
     readonly emptyState?: ListEmptyStateSpec;
     /** i18n key for the primary create button label (default `kumiko.actions.create`). */
     readonly createLabel?: string;
-    /** "toolbar": from `sm` up the create button ends the filter row instead of standing in the header. Default "header". Needs a create button (no `allowCreate: false`). */
+    /** "toolbar": from `md` up (below md the compact header keeps its "+") the create button ends the filter row instead of standing in the header. Default "header". Needs a create button (no `allowCreate: false`). */
     readonly createPlacement?: "header" | "toolbar";
     /** From `sm` up, a "Sorted by" select in the filter row (same options as the narrow sort control); column headers stay sortable. */
     readonly toolbarSort?: true;
     /** "pills": below `sm` the select facets render as rounded pill triggers with a stronger border; from `sm` up unchanged. */
     readonly narrowFacets?: ListNarrowFacets;
     /** "toolbar": from `md` up the `toolbarActions` end the filter row, after the "Sorted by" select and the create button, instead of standing in the page header. Below `md` they stay in the header. Default "header". Needs `toolbarActions`. */
-    readonly toolbarActionsPlacement?: "header" | "toolbar";
+    readonly toolbarActionsPlacement?: ListToolbarActionsPlacement;
     /** i18n key of the plural noun for the list size in the phone sort line (`{count}` pluralised). Default `<feature>:entity:<entity>:noun`. */
     readonly itemNounKey?: string;
     /** i18n key for the search field placeholder (default `kumiko.list.search-placeholder`). */

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

@@ -8,9 +8,34 @@ export type ListColumnPin = (typeof LIST_COLUMN_PINS)[number];
 export declare const LIST_TABLE_OPTION_KEYS: readonly ["rememberState", "resetAll", "columnPicker", "density", "pinning", "resizing", "keyboardNavigation", "export", "grouping", "totals", "summaryRow", "compactHeader", "frame"];
 export declare const LIST_TABLE_FRAMES: readonly ["card"];
 export type ListTableFrame = (typeof LIST_TABLE_FRAMES)[number];
+export declare const LIST_TOOLBAR_ACTIONS_PLACEMENTS: readonly ["header", "toolbar"];
+export type ListToolbarActionsPlacement = (typeof LIST_TOOLBAR_ACTIONS_PLACEMENTS)[number];
 export declare const LIST_NARROW_FACETS: readonly ["pills"];
 export type ListNarrowFacets = (typeof LIST_NARROW_FACETS)[number];
 export declare const LIST_TABLE_SUMMARY_ROW_KEYS: readonly ["query", "params"];
+export type ListPayloadCapabilities = {
+    readonly searchable: boolean;
+    readonly filters: boolean;
+    readonly namedFilters: boolean;
+    readonly screenFilter: boolean;
+};
+export declare function listPayloadKeysSent(capabilities: ListPayloadCapabilities): readonly string[];
+type FlaggedFields = {
+    readonly fields: Readonly<Record<string, object>>;
+} | undefined;
+/** True when the entity has a `filterable` field; the facet dropdowns and the `filters` payload key rest on it. */
+export declare function entityHasFilterableFields(entity: FlaggedFields): boolean;
+/** An explicit `searchable` wins, otherwise a searchable field turns search on. The renderer additionally needs a search adapter. */
+export declare function entityListDeclaresSearch(screen: {
+    readonly searchable?: boolean;
+}, entity: FlaggedFields): boolean;
+/** Whether an entityList can send `filters`: filterable fields, default filters or a range facet. */
+export declare function entityListDeclaresFilters(screen: {
+    readonly defaultFilters?: object;
+    readonly facets?: Readonly<Record<string, false | {
+        readonly display?: string;
+    }>>;
+}, entity: FlaggedFields): boolean;
 export declare const LIST_TABLE_GROUPING_KEYS: readonly ["field", "label", "labels", "collapsedWhen", "userChoice", "fields"];
 export declare const LIST_TABLE_TOTAL_KEYS: readonly ["field", "kind"];
 export declare const LIST_TABLE_EXPORT_KEYS: readonly ["xlsx", "maxRows"];
@@ -90,3 +115,4 @@ export type BundledListsOptions = {
     /** Pins the first column left on every bundled list where no column is pinned. Needs `table.pinning: true`. */
     readonly pinFirstColumn?: boolean;
 };
+export {};

package/dist/screen-list-table.js

@@ -18,8 +18,35 @@ export const LIST_TABLE_OPTION_KEYS = [
     "frame",
 ];
 export const LIST_TABLE_FRAMES = ["card"];
+export const LIST_TOOLBAR_ACTIONS_PLACEMENTS = ["header", "toolbar"];
 export const LIST_NARROW_FACETS = ["pills"];
 export const LIST_TABLE_SUMMARY_ROW_KEYS = ["query", "params"];
+// The optional list-query keys a list screen sends for what it declares, in one place so the boot
+// validator (summary-row schema check) and the renderer's payload tests agree on them.
+export function listPayloadKeysSent(capabilities) {
+    return [
+        ...(capabilities.searchable ? ["search"] : []),
+        ...(capabilities.filters ? ["filters"] : []),
+        ...(capabilities.namedFilters ? ["namedFilter"] : []),
+        ...(capabilities.screenFilter ? ["filter"] : []),
+    ];
+}
+function someFieldFlagged(entity, flag) {
+    return Object.values(entity?.fields ?? {}).some((field) => Reflect.get(field, flag) === true);
+}
+/** True when the entity has a `filterable` field; the facet dropdowns and the `filters` payload key rest on it. */
+export function entityHasFilterableFields(entity) {
+    return someFieldFlagged(entity, "filterable");
+}
+/** An explicit `searchable` wins, otherwise a searchable field turns search on. The renderer additionally needs a search adapter. */
+export function entityListDeclaresSearch(screen, entity) {
+    return screen.searchable ?? someFieldFlagged(entity, "searchable");
+}
+/** Whether an entityList can send `filters`: filterable fields, default filters or a range facet. */
+export function entityListDeclaresFilters(screen, entity) {
+    const hasRangeFacet = Object.values(screen.facets ?? {}).some((facet) => facet !== false && facet.display === "range");
+    return entityHasFilterableFields(entity) || screen.defaultFilters !== undefined || hasRangeFacet;
+}
 export const LIST_TABLE_GROUPING_KEYS = [
     "field",
     "label",

package/dist/screen-projection.d.ts

@@ -1,3 +1,4 @@
+import type { FieldCondition } from "./field-state-conditions.ts";
 import type { SelectOptionTone } from "./fields.ts";
 import type { AccessRule, AgentScreenHints } from "./handlers.ts";
 import type { NamedFilterFacetOptions, NamedListFilterRef } from "./named-list-filters.ts";
@@ -8,12 +9,14 @@ import type { EditLayout, 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";
-import type { ListNarrowFacets, ListTableOptions } from "./screen-list-table.ts";
+import type { ListNarrowFacets, ListTableOptions, ListToolbarActionsPlacement } from "./screen-list-table.ts";
 import type { RecordBannerSpec, RecordBreadcrumbSpec, RecordProgressSpec, RecordStepsSpec, RecordSummarySpec } from "./screen-record-guidance.ts";
 export type ListFacetSpec = {
     readonly field: string;
     readonly type: "select";
     readonly label: string;
+    /** Below `sm` the facet opens behind the filter icon next to the search field. */
+    readonly narrowPlacement?: "behind-filter";
     readonly options: readonly {
         readonly value: string;
         readonly label: string;
@@ -22,12 +25,16 @@ export type ListFacetSpec = {
     readonly field: string;
     readonly type: "boolean";
     readonly label: string;
+    /** Below `sm` the facet opens behind the filter icon next to the search field. */
+    readonly narrowPlacement?: "behind-filter";
     readonly trueLabel: string;
     readonly falseLabel: string;
 } | {
     readonly field: string;
     readonly type: "reference";
     readonly label: string;
+    /** Below `sm` the facet opens behind the filter icon next to the search field. */
+    readonly narrowPlacement?: "behind-filter";
     /** Entity name (same feature) or `feature:entity` (cross-feature), same
      *  convention as `ListColumnSpec.refEntity`. Options load at render time. */
     readonly entity: string;
@@ -84,7 +91,7 @@ export type ProjectionListScreenDefinition = {
     readonly bulkActions?: readonly ListBulkAction[];
     readonly toolbarActions?: readonly ToolbarAction[];
     /** "toolbar": from `md` up the `toolbarActions` end the filter row, after the "Sorted by" select, instead of standing in the page header. Below `md` they stay in the header. Default "header". Needs `toolbarActions`. */
-    readonly toolbarActionsPlacement?: "header" | "toolbar";
+    readonly toolbarActionsPlacement?: ListToolbarActionsPlacement;
     /** From `sm` up, a "Sorted by" select in the filter row (same options as the narrow sort control); column headers stay sortable. Needs `sortOptions`. */
     readonly toolbarSort?: true;
     /** "pills": below `sm` the select facets render as rounded pill triggers with a stronger border; from `sm` up unchanged. */
@@ -140,6 +147,8 @@ export type RecordHeaderSubtitlePart = string | {
     readonly navigate?: MetricNavigate;
     /** Formats the raw field value (e.g. `timestamp`); an empty value is still dropped. */
     readonly format?: FormatSpec;
+    /** i18n key of a text before the value ("Owner "); it stays plain text, a `navigate` link covers only the value. Dropped with an empty value. */
+    readonly prefix?: string;
 };
 export type RecordHeaderSpec = {
     readonly title: string;
@@ -190,6 +199,8 @@ export type MetricSpec = {
     readonly toneField?: string;
     /** Record field of the detail query shown as a small line under the value; the value stays the number. Same name as `DashboardStatPanel.subField`. */
     readonly subField?: string;
+    /** Record field shown instead of `subField` below `sm` ("of 2,850 €" instead of "0 of 2,850.00 €"). */
+    readonly subFieldNarrow?: string;
     /** Icon chip of the tile; only drawn with `metricsStyle: "tiles"`. */
     readonly icon?: NavIconKey;
     /** Formats the displayed value (e.g. `date`, `enumOption`); the tone still resolves on the raw value. */
@@ -285,9 +296,21 @@ export type ProjectionDetailScreenDefinition = {
      *  collapses into the menu. Same id rules as `primaryAction`; the phone header keeps
      *  its single icon button. */
     readonly inlineActions?: readonly string[];
+    /** Ids of `actions` shown in the pinned footer bar instead of the header, in declaration order.
+     *  Style "primary" marks the main button. An id must not also be `primaryAction` or in `inlineActions`. */
+    readonly footerActions?: readonly string[];
+    /** i18n key of a note on the left of the footer bar ("Changes go out with the release"); hidden below `sm`. Needs `footerActions`. */
+    readonly footerHint?: string;
+    /** Tab that opens first when the URL names none: the first rule whose condition holds on the record wins, else the first visible tab. Needs `layout.mode: "tabs"`; every tab stays visible. */
+    readonly initialTab?: readonly ProjectionDetailInitialTab[];
     /** How head fields render. Default "text" — plain text instead of a
      *  disabled Input, since every field on this screen type is forced
      *  readOnly anyway (there is no write path, see the shim doc above).
      *  Set "form" to opt back into the disabled-Input look. */
     readonly valueDisplay?: "form" | "text";
 };
+/** One `initialTab` rule: `tab` is a section id of the layout. */
+export type ProjectionDetailInitialTab = {
+    readonly when: Exclude<FieldCondition, boolean>;
+    readonly tab: string;
+};

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

@@ -1,4 +1,6 @@
+import type { FieldCondition } from "./field-state-conditions.ts";
 import type { SelectOptionTone } from "./fields.ts";
+import type { IconKey } from "./nav-icon.ts";
 import type { RowAction } from "./screen-entity-list.ts";
 export type RecordBreadcrumbItem = {
     readonly label: string;
@@ -18,12 +20,18 @@ export type RecordGuidanceAction = RowAction & {
 export type RecordNotice = {
     readonly title: string;
     readonly text?: string;
+    /** Shown instead of `title` below `sm`. */
+    readonly narrowTitle?: string;
+    /** Shown instead of `text` below `sm`. */
+    readonly narrowText?: string;
     readonly tone?: SelectOptionTone;
     readonly [field: string]: unknown;
 };
 export type RecordStep = {
     readonly id: string;
     readonly title: string;
+    /** Shown instead of `title` below `sm`. */
+    readonly narrowTitle?: string;
     readonly detail?: string;
     /** Shown instead of `detail` below `sm`. */
     readonly narrowDetail?: string;
@@ -47,6 +55,8 @@ export type RecordSummarySpec = {
     readonly toneField?: string;
     /** Row field with a shorter sentence shown instead of `field` below `sm`. */
     readonly narrowField?: string;
+    /** Draws the sentence as plain text led by this icon (e.g. "sparkles" for an AI statement) instead of the bordered box. */
+    readonly icon?: IconKey;
 };
 export type RecordBannerSpec = {
     /** Holds `RecordNotice | null`; null shows no banner. */
@@ -64,6 +74,12 @@ export type RecordStepsSpec = {
     readonly emptyLabel?: string;
     /** Below `sm` only the first n steps show; the rest sits behind a "k more steps" toggle. */
     readonly narrowLimit?: number;
+    /** Plural base key for the toggle of the hidden rest: define `<key>.one` and `<key>.other` (the latter with `{count}`). Default `kumiko.detail.steps.more`. */
+    readonly narrowMoreLabel?: string;
+    /** i18n key of a short label before each step's further actions ("Clarify first?"). */
+    readonly moreActionsLabel?: string;
+    /** The whole panel is drawn only while the condition holds on the record. Default: always. */
+    readonly visibleWhen?: Exclude<FieldCondition, boolean>;
     readonly actions?: readonly RecordGuidanceAction[];
 };
 export type RecordProgressStep = {

package/dist/screen.d.ts

@@ -29,10 +29,23 @@ 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. */
+    relativeTime: {
+        readonly locale?: string;
+        readonly style?: "long" | "short" | "narrow";
+        readonly absoluteAfterDays?: number;
+        readonly withTime?: boolean;
+        /** IANA zone id for the clock time and the day boundary. Default: the runtime's zone. */
+        readonly timeZone?: string;
+    };
     date: {
         readonly locale?: string;
         readonly dateStyle?: "full" | "long" | "medium" | "short";
     };
+    /** Telephone number shown as a `tel:` link in list cells, like a read-only `format: "phone"` field. */
+    phone: Record<never, never>;
     boolean: {
         readonly trueLabel?: string;
         readonly falseLabel?: string;
@@ -120,9 +133,9 @@ export type ScreenDefinition = EntityListScreenDefinition | ProjectionListScreen
 export type { NamedFilterFacetOptions } from "./named-list-filters.ts";
 export type { ActionFormFooterAction, ActionFormLoad, ActionFormRedirect, ActionFormScreenDefinition, ActionFormSuccessFact, ActionFormSuccessItems, ActionFormSuccessLink, FormFieldDerivation, FormFieldDerivationWithoutList, SecretMintConfirmStep, SecretMintScreenDefinition, SecretReveal, SecretRevealField, } from "./screen-action-form.ts";
 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, DashboardListFooterLink, DashboardListNarrow, DashboardListPanel, DashboardListRowLink, DashboardListRowToneMarker, DashboardMoneyParam, 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 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, EditWriteFormSection, EmbeddedListEditSpec, EntityEditAction, EntityEditActionPlacement, EntityEditScreenDefinition, EntityWriteExcludedFields, FieldAffix, FieldFillAction, FormWidth, ListEmptyStateSpec, RelatedListEmptyStateSpec, RelatedListEmptyStateVariant, RelatedListRowTone, } 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, 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";
@@ -130,7 +143,7 @@ export type { ScreenFallback, ScreenFallbackByReason, ScreenFallbackReason, } fr
 export { fallbackTargetFor, fallbackTargets, SCREEN_FALLBACK_REASONS } from "./screen-fallback.ts";
 export type { ListBulkAction } from "./screen-list-bulk.ts";
 export { LIST_BULK_ACTION_KEYS, MAX_BULK_SELECTION } from "./screen-list-bulk.ts";
-export type { BundledListsOptions, ListColumnPin, ListNarrowFacets, ListTableDensity, ListTableExportOptions, ListTableFrame, ListTableGrouping, ListTableOptions, ListTableSummaryRow, ListTableTotal, } from "./screen-list-table.ts";
-export { DEFAULT_EXPORT_MAX_ROWS, LIST_COLUMN_MAX_WIDTH_PX, LIST_COLUMN_PINS, LIST_NARROW_FACETS, LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_EXPORT_KEYS, LIST_TABLE_FRAMES, LIST_TABLE_GROUPING_KEYS, LIST_TABLE_OPTION_KEYS, LIST_TABLE_SUMMARY_ROW_KEYS, LIST_TABLE_TOTAL_KEYS, MAX_EXPORT_MAX_ROWS, } from "./screen-list-table.ts";
-export type { ListFacetSpec, MetricNavigate, MetricSpec, ProjectionDetailScreenDefinition, ProjectionListScreenDefinition, RecordHeaderSpec, RecordHeaderSubtitlePart, } from "./screen-projection.ts";
+export type { BundledListsOptions, ListColumnPin, ListNarrowFacets, ListPayloadCapabilities, ListTableDensity, ListTableExportOptions, ListTableFrame, ListTableGrouping, ListTableOptions, ListTableSummaryRow, ListTableTotal, ListToolbarActionsPlacement, } from "./screen-list-table.ts";
+export { DEFAULT_EXPORT_MAX_ROWS, entityHasFilterableFields, entityListDeclaresFilters, entityListDeclaresSearch, LIST_COLUMN_MAX_WIDTH_PX, LIST_COLUMN_PINS, LIST_NARROW_FACETS, LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_EXPORT_KEYS, LIST_TABLE_FRAMES, LIST_TABLE_GROUPING_KEYS, LIST_TABLE_OPTION_KEYS, LIST_TABLE_SUMMARY_ROW_KEYS, LIST_TABLE_TOTAL_KEYS, LIST_TOOLBAR_ACTIONS_PLACEMENTS, listPayloadKeysSent, MAX_EXPORT_MAX_ROWS, } from "./screen-list-table.ts";
+export type { ListFacetSpec, MetricNavigate, MetricSpec, ProjectionDetailInitialTab, ProjectionDetailScreenDefinition, ProjectionListScreenDefinition, RecordHeaderSpec, RecordHeaderSubtitlePart, } from "./screen-projection.ts";
 export type { RecordBannerSpec, RecordBreadcrumbItem, RecordBreadcrumbSpec, RecordNotice, RecordProgress, RecordProgressSpec, RecordProgressStep, RecordStep, RecordStepsSpec, RecordSummarySpec, } from "./screen-record-guidance.ts";

package/dist/screen.js

@@ -2,4 +2,4 @@ export { DASHBOARD_MIN_REFRESH_SECONDS, DASHBOARD_STAT_TONES } from "./screen-da
 export { relatedListGroupHeaderLabel, relatedListGroupKey } from "./screen-entity-edit.js";
 export { fallbackTargetFor, fallbackTargets, SCREEN_FALLBACK_REASONS } from "./screen-fallback.js";
 export { LIST_BULK_ACTION_KEYS, MAX_BULK_SELECTION } from "./screen-list-bulk.js";
-export { DEFAULT_EXPORT_MAX_ROWS, LIST_COLUMN_MAX_WIDTH_PX, LIST_COLUMN_PINS, LIST_NARROW_FACETS, LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_EXPORT_KEYS, LIST_TABLE_FRAMES, LIST_TABLE_GROUPING_KEYS, LIST_TABLE_OPTION_KEYS, LIST_TABLE_SUMMARY_ROW_KEYS, LIST_TABLE_TOTAL_KEYS, MAX_EXPORT_MAX_ROWS, } from "./screen-list-table.js";
+export { DEFAULT_EXPORT_MAX_ROWS, entityHasFilterableFields, entityListDeclaresFilters, entityListDeclaresSearch, LIST_COLUMN_MAX_WIDTH_PX, LIST_COLUMN_PINS, LIST_NARROW_FACETS, LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_EXPORT_KEYS, LIST_TABLE_FRAMES, LIST_TABLE_GROUPING_KEYS, LIST_TABLE_OPTION_KEYS, LIST_TABLE_SUMMARY_ROW_KEYS, LIST_TABLE_TOTAL_KEYS, LIST_TOOLBAR_ACTIONS_PLACEMENTS, listPayloadKeysSent, MAX_EXPORT_MAX_ROWS, } from "./screen-list-table.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.414.0",
+  "version": "0.416.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>",