@cosmicdrift/kumiko-types 0.415.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>>;

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/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

@@ -81,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
@@ -159,7 +166,10 @@ export type RowActionDisplay = "button" | "link" | "icon" | "responsive";
  *  (`rowClick: true`) included as an entry, so every row has a kebab; phone
  *  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. */
@@ -322,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";

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";
@@ -295,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;
@@ -53,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. */
@@ -72,6 +76,10 @@ export type RecordStepsSpec = {
     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";
@@ -132,5 +145,5 @@ 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, 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, ProjectionDetailScreenDefinition, ProjectionListScreenDefinition, RecordHeaderSpec, RecordHeaderSubtitlePart, } from "./screen-projection.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/package.json

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