@cosmicdrift/kumiko-types 0.391.1 → 0.392.1

package/dist/fields.d.ts

@@ -181,7 +181,7 @@ export type BooleanFieldDef = {
     readonly default?: boolean;
     readonly access?: FieldAccess;
 };
-export declare const SELECT_OPTION_TONES: readonly ["ok", "warn", "bad", "neutral"];
+export declare const SELECT_OPTION_TONES: readonly ["ok", "warn", "bad", "critical", "accent", "neutral"];
 export type SelectOptionTone = (typeof SELECT_OPTION_TONES)[number];
 /** One `optionsQueryPayload` entry: a literal, or `{ field }` = the current value of
  *  a sibling field of the same form (config keys: another key of the owner feature). */

package/dist/fields.js

@@ -1,6 +1,6 @@
 /// <reference types="temporal-polyfill/global" preserve="true" />
 // --- Field Types ---
-export const SELECT_OPTION_TONES = ["ok", "warn", "bad", "neutral"];
+export const SELECT_OPTION_TONES = ["ok", "warn", "bad", "critical", "accent", "neutral"];
 export function isOptionsQueryFieldRef(value) {
     return typeof value === "object" && value !== null;
 }

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

@@ -2,7 +2,7 @@ import type { FormFieldDefinition } 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 { DashboardPanelVisibility } from "./screen-dashboard.ts";
+import type { ScreenVisibility } from "./screen-dashboard.ts";
 import type { EditLayout } from "./screen-entity-edit.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`
@@ -35,7 +35,7 @@ export type ActionFormScreenDefinition = {
      *  app); exempts it from the nav-area boot check. */
     readonly dormant?: boolean;
     /** UI-only gate, also on direct URL access; handlers still enforce access. Unmet or failed renders `fallback`. */
-    readonly visibleWhen?: DashboardPanelVisibility;
+    readonly visibleWhen?: ScreenVisibility;
     /** Same-feature short id or cross-feature QN `<feature>:screen:<id>` shown when `visibleWhen` is unmet (default: standard notice). */
     readonly fallback?: string;
     /** Derived by buildAppSchema — see EntityEditScreenDefinition.urlPrefillFields. */
@@ -272,7 +272,7 @@ export type SecretMintScreenDefinition = {
      *  app); exempts it from the nav-area boot check. */
     readonly dormant?: boolean;
     /** UI-only gate, also on direct URL access; handlers still enforce access. Unmet or failed renders `fallback`. */
-    readonly visibleWhen?: DashboardPanelVisibility;
+    readonly visibleWhen?: ScreenVisibility;
     /** Same-feature short id or cross-feature QN `<feature>:screen:<id>` shown when `visibleWhen` is unmet (default: standard notice). */
     readonly fallback?: string;
     /** Derived by buildAppSchema — see EntityEditScreenDefinition.urlPrefillFields. */

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

@@ -1,7 +1,7 @@
 import type { FieldDefinition } from "./fields.ts";
 import type { AccessRule, AgentScreenHints } from "./handlers.ts";
 import type { PlatformComponent, ScreenNavSugar, ScreenSlots } from "./screen.ts";
-import type { DashboardPanelVisibility } from "./screen-dashboard.ts";
+import type { ScreenVisibility } from "./screen-dashboard.ts";
 import type { EditLayout } from "./screen-entity-edit.ts";
 export type CustomScreenRoute = {
     readonly path: string;
@@ -30,7 +30,7 @@ export type CustomScreenDefinition = {
      *  `dormant` on other screens. */
     readonly dormant?: boolean;
     /** UI-only gate, also on direct URL access; handlers still enforce access. Unmet or failed renders `fallback`. */
-    readonly visibleWhen?: DashboardPanelVisibility;
+    readonly visibleWhen?: ScreenVisibility;
     /** Same-feature short id or cross-feature QN `<feature>:screen:<id>` shown when `visibleWhen` is unmet (default: standard notice). */
     readonly fallback?: string;
 };
@@ -48,7 +48,7 @@ export type ConfigEditScreenDefinition = {
      *  app); exempts it from the nav-area boot check. */
     readonly dormant?: boolean;
     /** UI-only gate, also on direct URL access; handlers still enforce access. Unmet or failed renders `fallback`. */
-    readonly visibleWhen?: DashboardPanelVisibility;
+    readonly visibleWhen?: ScreenVisibility;
     /** Same-feature short id or cross-feature QN `<feature>:screen:<id>` shown when `visibleWhen` is unmet (default: standard notice). */
     readonly fallback?: string;
     /** scope for config:write:set calls. Must match the scope declaration of
@@ -101,7 +101,7 @@ export type SecretsEditScreenDefinition = {
      *  app); exempts it from the nav-area boot check. */
     readonly dormant?: boolean;
     /** UI-only gate, also on direct URL access; handlers still enforce access. Unmet or failed renders `fallback`. */
-    readonly visibleWhen?: DashboardPanelVisibility;
+    readonly visibleWhen?: ScreenVisibility;
     /** Same-feature short id or cross-feature QN `<feature>:screen:<id>` shown when `visibleWhen` is unmet (default: standard notice). */
     readonly fallback?: string;
     /** field id -> qualified secret name (`<feature>:secret:<kebab>`). */

package/dist/screen-dashboard.d.ts

@@ -200,6 +200,9 @@ export type DashboardCustomPanel = {
     readonly kind: "custom";
     readonly id: string;
     readonly component: PlatformComponent;
+    /** Static author values laid over the screen's filterParams, like
+     *  `DashboardPanelQueryOptions.params`; the panel wins on a name clash. */
+    readonly params?: Readonly<Record<string, unknown>>;
 };
 export type DashboardTextBlock = {
     readonly kind: "heading";
@@ -241,6 +244,11 @@ export type DashboardPanelVisibility = {
     readonly field: string;
     readonly eq: string | number | boolean | null;
 };
+export type ScreenVisibility = DashboardPanelVisibility & {
+    /** Payload key that receives the screen's route id (projectionDetail only). Without it
+     *  the gate query runs with an empty payload. */
+    readonly idParam?: string;
+};
 export type DashboardScreenPanel = {
     readonly kind: "screen";
     readonly id: string;
@@ -321,7 +329,7 @@ export type DashboardScreenDefinition = {
      *  app); exempts it from the nav-area boot check. */
     readonly dormant?: boolean;
     /** UI-only gate, also on direct URL access; handlers still enforce access. Unmet or failed renders `fallback`. */
-    readonly visibleWhen?: DashboardPanelVisibility;
+    readonly visibleWhen?: ScreenVisibility;
     /** Same-feature short id or cross-feature QN `<feature>:screen:<id>` shown when `visibleWhen` is unmet (default: standard notice). */
     readonly fallback?: string;
     readonly panels: readonly DashboardPanelDefinition[];

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

@@ -4,7 +4,7 @@ import type { AccessRule, AgentScreenHints } from "./handlers.ts";
 import type { IconKey } from "./nav-icon.ts";
 import type { FieldRenderer, PlatformComponent, ScreenNavSugar, ScreenSlots } from "./screen.ts";
 import type { ActionFormRedirect } from "./screen-action-form.ts";
-import type { DashboardPanelVisibility } from "./screen-dashboard.ts";
+import type { ScreenVisibility } from "./screen-dashboard.ts";
 import type { ListColumnSpec, ListSortSpec, RelatedListToolbarAction, RowAction, RowActionMode, RowFieldExtractor } from "./screen-entity-list.ts";
 import type { ListBulkAction } from "./screen-list-bulk.ts";
 import type { ListTableGrouping, ListTableOptions } from "./screen-list-table.ts";
@@ -292,7 +292,18 @@ export type EditRelatedListSection = {
      *  section's query returns zero rows. Omitted: the DataTable default
      *  ("kumiko.list.no-entries") applies. `action`'s icon must resolve, same
      *  as `actions` above. */
-    readonly emptyState?: ListEmptyStateSpec;
+    readonly emptyState?: RelatedListEmptyStateSpec;
+};
+/** Empty-state text for one parent-record state, e.g. "still running" vs. "finished without rows". */
+export type RelatedListEmptyStateVariant = {
+    readonly when: Exclude<FieldCondition, boolean>;
+    readonly title: string;
+    readonly description?: string;
+};
+/** The first `variants` entry whose `when` holds for the parent record replaces `title` and
+ *  `description`; `action` stays. */
+export type RelatedListEmptyStateSpec = ListEmptyStateSpec & {
+    readonly variants?: readonly RelatedListEmptyStateVariant[];
 };
 export type EditWriteFormSection = {
     /** Kebab-case tab id, used as the `?tab=` value. Required by the
@@ -378,7 +389,7 @@ export type EntityEditScreenDefinition = {
      *  app); exempts it from the nav-area boot check. */
     readonly dormant?: boolean;
     /** UI-only gate, also on direct URL access; handlers still enforce access. Unmet or failed renders `fallback`. */
-    readonly visibleWhen?: DashboardPanelVisibility;
+    readonly visibleWhen?: ScreenVisibility;
     /** Same-feature short id or cross-feature QN `<feature>:screen:<id>` shown when `visibleWhen` is unmet (default: standard notice). */
     readonly fallback?: string;
     /** Derived by buildAppSchema from the navigate `params` targeting this

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

@@ -3,7 +3,7 @@ import type { AccessRule, AgentScreenHints } from "./handlers.ts";
 import type { IconKey } from "./nav-icon.ts";
 import type { FieldRenderer, PlatformComponent, ScreenNavSugar, ScreenSlots } from "./screen.ts";
 import type { ActionFormRedirect } from "./screen-action-form.ts";
-import type { DashboardPanelVisibility } from "./screen-dashboard.ts";
+import type { ScreenVisibility } from "./screen-dashboard.ts";
 import type { ListEmptyStateSpec } from "./screen-entity-edit.ts";
 import type { EntityListExpandableRow } from "./screen-expandable-row.ts";
 import type { ListBulkAction } from "./screen-list-bulk.ts";
@@ -334,10 +334,17 @@ export type RelatedListToolbarAction = (Extract<ToolbarAction, {
     readonly kind: "writeHandler";
 }> & {
     readonly visible?: FieldCondition;
+    /** Values extracted from the parent record, merged over the static
+     *  `payload` (extracted values win). Without a parent record the action
+     *  stays hidden. */
+    readonly params?: RowFieldExtractor;
 }) | (Extract<ToolbarAction, {
     readonly kind: "drawer";
 }> & {
     readonly visible?: FieldCondition;
+    /** Values extracted from the parent record, prefilling the drawer's
+     *  actionForm. Without a parent record the action stays hidden. */
+    readonly params?: RowFieldExtractor;
 });
 /** An extra choice on a facet next to the field's own options: a named
  *  bundle of values ("Running" = several statuses) or "no filter" (`values:
@@ -381,7 +388,7 @@ export type EntityListScreenDefinition = {
      *  app); exempts it from the nav-area boot check. */
     readonly dormant?: boolean;
     /** UI-only gate, also on direct URL access; handlers still enforce access. Unmet or failed renders `fallback`. */
-    readonly visibleWhen?: DashboardPanelVisibility;
+    readonly visibleWhen?: ScreenVisibility;
     /** Same-feature short id or cross-feature QN `<feature>:screen:<id>` shown when `visibleWhen` is unmet (default: standard notice). */
     readonly fallback?: string;
     readonly entity: string;

package/dist/screen-projection.d.ts

@@ -1,8 +1,8 @@
 import type { SelectOptionTone } from "./fields.ts";
 import type { AccessRule, AgentScreenHints } from "./handlers.ts";
 import type { NavIconKey } from "./nav-icon.ts";
-import type { PlatformComponent, ScreenNavSugar, ScreenSlots } from "./screen.ts";
-import type { DashboardPanelVisibility, DashboardStatTone } from "./screen-dashboard.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 { ListColumnSpec, ListPaginationMode, ListSortSpec, RowAction, RowActionMode, RowFieldExtractor, ScreenFilter, ToolbarAction } from "./screen-entity-list.ts";
 import type { ListBulkAction } from "./screen-list-bulk.ts";
@@ -64,7 +64,7 @@ export type ProjectionListScreenDefinition = {
      *  app); exempts it from the nav-area boot check. */
     readonly dormant?: boolean;
     /** UI-only gate, also on direct URL access; handlers still enforce access. Unmet or failed renders `fallback`. */
-    readonly visibleWhen?: DashboardPanelVisibility;
+    readonly visibleWhen?: ScreenVisibility;
     /** Same-feature short id or cross-feature QN `<feature>:screen:<id>` shown when `visibleWhen` is unmet (default: standard notice). */
     readonly fallback?: string;
     readonly query: string;
@@ -124,6 +124,8 @@ export type RecordHeaderSpec = {
      *  joined by a separator; parts with an empty value are dropped. */
     readonly subtitle?: string | readonly RecordHeaderSubtitlePart[];
     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;
     /** Record field holding an absolute http(s) URL. When present and the
      *  field's value is such a URL, the subtitle renders as an external link
      *  (`target="_blank"`) instead of plain text. Only valid with the string
@@ -172,7 +174,7 @@ export type ProjectionDetailScreenDefinition = {
      *  app); exempts it from the nav-area boot check. */
     readonly dormant?: boolean;
     /** UI-only gate, also on direct URL access; handlers still enforce access. Unmet or failed renders `fallback`. */
-    readonly visibleWhen?: DashboardPanelVisibility;
+    readonly visibleWhen?: ScreenVisibility;
     /** Same-feature short id or cross-feature QN `<feature>:screen:<id>` shown when `visibleWhen` is unmet (default: standard notice). */
     readonly fallback?: string;
     readonly query: string;
@@ -226,6 +228,10 @@ export type ProjectionDetailScreenDefinition = {
      *  action); default precedence is `edit`, then `style: "primary"`, then the
      *  first action. */
     readonly primaryAction?: string;
+    /** Action ids that stay visible buttons next to the primary action when the rest
+     *  collapses into the menu. Same id rules as `primaryAction`; the phone header keeps
+     *  its single icon button. */
+    readonly inlineActions?: readonly string[];
     /** 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).

package/dist/screen.d.ts

@@ -117,9 +117,9 @@ export type ScreenNavSugar = {
 export type ScreenDefinition = EntityListScreenDefinition | ProjectionListScreenDefinition | ProjectionDetailScreenDefinition | DashboardScreenDefinition | EntityEditScreenDefinition | ActionFormScreenDefinition | ConfigEditScreenDefinition | SecretsEditScreenDefinition | SecretMintScreenDefinition | CustomScreenDefinition;
 export type { ActionFormFooterAction, ActionFormLoad, ActionFormRedirect, ActionFormScreenDefinition, ActionFormSuccessFact, ActionFormSuccessLink, FormFieldDerivation, FormFieldDerivationWithoutList, SecretMintConfirmStep, SecretMintScreenDefinition, SecretReveal, SecretRevealField, } from "./screen-action-form.ts";
 export type { ConfigEditScreenDefinition, CustomScreenDefinition, CustomScreenRoute, SecretsEditScreenDefinition, SecretsEditSection, } from "./screen-custom-config.ts";
-export type { DashboardChartKind, DashboardChartMarkerKind, DashboardChartPanel, DashboardChartRangeOption, DashboardChartRanges, DashboardChartTone, DashboardCurrencyFormat, DashboardCustomPanel, DashboardDateParam, DashboardFeedPanel, DashboardFilterDefinition, DashboardI18nText, DashboardListPanel, DashboardMoneyParam, DashboardPanelDefinition, DashboardPanelEmptyState, DashboardPanelGate, DashboardPanelQueryOptions, DashboardPanelSpan, DashboardPanelVisibility, DashboardProgressListPanel, DashboardProgressTone, DashboardRecordBinding, DashboardRefresh, DashboardRelativeTimeFormat, DashboardRelativeTimeParam, DashboardScopeDefinition, DashboardScreenDefinition, DashboardScreenPanel, DashboardStatGroupPanel, DashboardStatPanel, DashboardStatTone, DashboardText, DashboardTextBlock, DashboardTextPanel, DashboardTextParam, DashboardTimeRangeDefinition, DashboardValueFormat, } from "./screen-dashboard.ts";
+export type { DashboardChartKind, DashboardChartMarkerKind, DashboardChartPanel, DashboardChartRangeOption, DashboardChartRanges, DashboardChartTone, DashboardCurrencyFormat, DashboardCustomPanel, DashboardDateParam, DashboardFeedPanel, DashboardFilterDefinition, DashboardI18nText, DashboardListPanel, DashboardMoneyParam, DashboardPanelDefinition, DashboardPanelEmptyState, DashboardPanelGate, DashboardPanelQueryOptions, DashboardPanelSpan, DashboardPanelVisibility, DashboardProgressListPanel, DashboardProgressTone, DashboardRecordBinding, DashboardRefresh, DashboardRelativeTimeFormat, DashboardRelativeTimeParam, DashboardScopeDefinition, DashboardScreenDefinition, DashboardScreenPanel, 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, RelatedListRowTone, } from "./screen-entity-edit.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 { relatedListGroupHeaderLabel, relatedListGroupKey } from "./screen-entity-edit.ts";
 export type { EntityListFacetConfig, EntityListFacetExtraOption, EntityListScreenDefinition, ListBadgeTone, ListColumnDisplay, ListColumnSpec, ListPaginationMode, ListSortDir, 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.391.1",
+  "version": "0.392.1",
   "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>",

package/src/changes.json

@@ -1,4 +1,40 @@
 [
+  {
+    "version": "0.392.0",
+    "type": "improvement",
+    "title": "RecordHeaderSpec takes statusFormat",
+    "detail": "header.statusFormat is a FormatSpec for the header badge text, typically enumOption with a keyPrefix. The badge tone still resolves on the raw status value."
+  },
+  {
+    "version": "0.392.0",
+    "type": "improvement",
+    "title": "projectionDetail takes inlineActions",
+    "detail": "ProjectionDetailScreenDefinition.inlineActions lists action ids that stay visible buttons next to the primary action in the page header instead of folding into the \"More actions\" menu. Without it the header behaves as before. The phone header keeps its single icon button."
+  },
+  {
+    "version": "0.392.0",
+    "type": "improvement",
+    "title": "relatedList emptyState takes variants",
+    "detail": "EditRelatedListSection.emptyState is a RelatedListEmptyStateSpec. Its optional variants list pairs a FieldCondition on the parent record with a title and description; the first matching variant replaces the default text, the action stays."
+  },
+  {
+    "version": "0.392.0",
+    "type": "improvement",
+    "title": "relatedList drawer and writeHandler toolbar actions take params",
+    "detail": "RelatedListToolbarAction kind \"drawer\" and kind \"writeHandler\" accept params as a RowFieldExtractor evaluated against the parent record, for example params with map appId to id. A drawer gets the values as prefill, a writeHandler merges them over its static payload with the extracted values winning. Without a parent record the action stays hidden."
+  },
+  {
+    "version": "0.392.0",
+    "type": "improvement",
+    "title": "Option tones gain critical and accent",
+    "detail": "SelectOptionTone is now ok, warn, bad, critical, accent or neutral, for select optionTones, enumOption tones, relatedList rowTone and projectionDetail header.statusTones. critical and accent reuse the StatusBadge colors (status-critical and the primary brand color), neutral stays muted. An informative state such as \"Ready\" can use accent instead of a custom cell."
+  },
+  {
+    "version": "0.392.0",
+    "type": "improvement",
+    "title": "Custom dashboard panels accept static params",
+    "detail": "A dashboard panel of kind custom takes params, static values laid over the screen's filterParams for its component. The panel wins when a filter uses the same name. Without params nothing changes."
+  },
   {
     "version": "0.391.0",
     "type": "improvement",