@cosmicdrift/kumiko-types 0.258.1 → 0.260.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.258.1",
+  "version": "0.260.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": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",

package/src/screen.ts

@@ -530,6 +530,10 @@ export type MetricNavigate = {
   readonly entity?: string;
   readonly entityId?: string;
   readonly params?: RowFieldExtractor;
+  /** Section id of the tab to activate at the destination. Alone (no
+   *  `screen`/`entity`), it activates that tab on the current record
+   *  instead of navigating away. */
+  readonly tab?: string;
 };
 
 // A metric can navigate on click, so the plain string shorthand (field name,
@@ -709,6 +713,23 @@ export type DashboardCustomPanel = {
   readonly component: PlatformComponent;
 };
 
+// Live query, so a write that flips `field` swaps panels without reload; hidden while loading.
+export type DashboardPanelVisibility = {
+  readonly query: string;
+  readonly field: string;
+  readonly eq: string | number | boolean | null;
+};
+
+// Embedded redirect/cancelTarget navigate away from the dashboard — targets meant for tiles omit both.
+export type DashboardScreenPanel = {
+  readonly kind: "screen";
+  readonly id: string;
+  /** Same-feature short id or cross-feature QN `<feature>:screen:<id>`. */
+  readonly screen: string;
+  readonly label?: string;
+  readonly visibleWhen?: DashboardPanelVisibility;
+};
+
 export type DashboardPanelDefinition =
   | DashboardStatPanel
   | DashboardStatGroupPanel
@@ -716,7 +737,8 @@ export type DashboardPanelDefinition =
   | DashboardListPanel
   | DashboardFeedPanel
   | DashboardProgressListPanel
-  | DashboardCustomPanel;
+  | DashboardCustomPanel
+  | DashboardScreenPanel;
 
 // Screen-weiter Picker (Combobox), dessen gewählter Wert unter `id` in JEDE
 // Panel-Query dieses Screens gemerged wird (Query-Handler validieren den Wert
@@ -1008,8 +1030,13 @@ export type EntityEditScreenDefinition = {
    *  feature to the target at boot time — an app that doesn't mount the
    *  target feature fails the boot-validator; only use this form in a
    *  reusable feature when the target feature is guaranteed to be
-   *  mounted alongside it. */
-  readonly redirect?: string;
+   *  mounted alongside it.
+   *
+   *  The object form additionally names the success-payload field the
+   *  navigation id comes from (`ActionFormRedirect.idFrom`) — needed when
+   *  the edited record is a child and the target screen is the parent's
+   *  detail screen. */
+  readonly redirect?: string | ActionFormRedirect;
   /** Parent list screen (short id) for breadcrumb + nav highlighting when
    *  this screen has no nav entry of its own. Same field/semantics as on
    *  `custom`/`projectionDetail`; an explicit value here wins over the