@cosmicdrift/kumiko-framework 0.133.0 → 0.135.0

package/src/engine/factories.ts

@@ -230,8 +230,8 @@ export function createDateField<R extends true | false = false>(
  * (createdAt, loginAt, actualPickupAt). Temporal.Instant intern.
  *
  * Mit `locatedBy: "<name>Tz"` wird das Feld zum Wall-Clock-Pair eines
- * Termins an einem Ort — bevorzuge dafür den `locatedTimestamp(name)`
- * Helper, der Pair + Marker atomar erzeugt.
+ * Termins an einem Ort — bevorzuge dafür `createLocatedTimestampField()`,
+ * das EIN atomares Feld statt eines lose verdrahteten Pairs erzeugt.
  */
 export function createTimestampField<R extends true | false = false>(
   overrides?: Partial<Omit<TimestampFieldDef, "type" | "required">> & { required?: R },
@@ -300,53 +300,6 @@ export function createLocatedTimestampField<R extends true | false = false>(
   } as LocatedTimestampFieldDef & { required: R }; // @cast-boundary engine-payload
 }
 
-/**
- * @deprecated Verwende stattdessen `createLocatedTimestampField()` —
- * EIN Field-Type statt zwei lose Pair-Felder. Migration: ersetze
- * `...locatedTimestamp("pickup")` durch `pickup: createLocatedTimestampField()`.
- *
- * Wall-Clock-Termin an einem Ort — Helper der ZWEI verbundene Felder
- * erzeugt. Bevorzugte Form für jeden Date-Wert mit Location-Bezug
- * (Pickup, Delivery, Meeting, Schedule).
- *
- * ```ts
- * r.entity("order", {
- *   fields: {
- *     ...locatedTimestamp("pickup"),    // → pickupAt + pickupTz
- *     ...locatedTimestamp("delivery"),  // → deliveryAt + deliveryTz
- *   },
- * });
- * ```
- *
- * Zur Laufzeit wird:
- * - DB: `<name>_at TIMESTAMPTZ` (UTC) + `<name>_tz TEXT` (IANA-Name)
- * - JSON: `{ <name>At: "2026-04-03T10:00:00", <name>Tz: "Europe/Lisbon" }`
- *   (Wall-Clock OHNE Offset, plus IANA-Name — zwei getrennte Felder)
- * - Reducer/Apply: kann mit Temporal.ZonedDateTime arbeiten
- *
- * Optionen pro Feld (z.B. `required` auf den At-Teil) per zweitem Argument.
- */
-export function locatedTimestamp(
-  name: string,
-  overrides?: { readonly required?: boolean; readonly access?: TimestampFieldDef["access"] },
-): Readonly<Record<string, TimestampFieldDef | TzFieldDef>> {
-  const atName = `${name}At`;
-  const tzName = `${name}Tz`;
-  return {
-    [atName]: {
-      type: "timestamp",
-      locatedBy: tzName,
-      required: overrides?.required,
-      access: overrides?.access,
-    },
-    [tzName]: {
-      type: "tz",
-      required: overrides?.required,
-      access: overrides?.access,
-    },
-  };
-}
-
 export function createFileField(overrides?: Partial<Omit<FileFieldDef, "type">>): FileFieldDef {
   return { type: "file", ...overrides };
 }

package/src/engine/feature-ast/extractors/index.ts

@@ -58,10 +58,7 @@ export {
   extractUnmanagedTable,
   extractUsesApi,
 } from "./round5";
-export {
-  extractTree,
-  extractTreeActions,
-} from "./round6";
+export { extractTreeActions } from "./round6";
 export type { ExtractOutput } from "./shared";
 export {
   fail,

package/src/engine/feature-ast/extractors/round6.ts

@@ -1,15 +1,8 @@
 import type { CallExpression, SourceFile } from "ts-morph";
 import type { TreeActionDef } from "../../types/tree-node";
-import type { TreeActionsPattern, TreePattern } from "../patterns";
+import type { TreeActionsPattern } from "../patterns";
 import { sourceLocationFromNode } from "../source-location";
-import {
-  type ExtractOutput,
-  fail,
-  findFunctionLiteral,
-  isPlainObject,
-  ok,
-  readDataLiteralNode,
-} from "./shared";
+import { type ExtractOutput, fail, isPlainObject, ok, readDataLiteralNode } from "./shared";
 
 export function extractTreeActions(
   call: CallExpression,
@@ -37,30 +30,3 @@ export function extractTreeActions(
     definitions: definitions as Readonly<Record<string, TreeActionDef>>,
   });
 }
-
-export function extractTree(
-  call: CallExpression,
-  sourceFile: SourceFile,
-): ExtractOutput<TreePattern> {
-  const arg = call.getArguments()[0];
-  if (!arg) {
-    return fail(
-      "tree",
-      sourceLocationFromNode(call, sourceFile),
-      "expected a tree-provider function as first argument",
-    );
-  }
-  const fn = findFunctionLiteral(arg);
-  if (!fn) {
-    return fail(
-      "tree",
-      sourceLocationFromNode(call, sourceFile),
-      "first argument must be an inline arrow function or function expression",
-    );
-  }
-  return ok({
-    kind: "tree",
-    source: sourceLocationFromNode(call, sourceFile),
-    providerBody: sourceLocationFromNode(fn, sourceFile),
-  });
-}

package/src/engine/feature-ast/parse.ts

@@ -56,7 +56,6 @@ import {
   extractSystemScope,
   extractToggleable,
   extractTranslations,
-  extractTree,
   extractTreeActions,
   extractUiHints,
   extractUnmanagedTable,
@@ -364,11 +363,9 @@ function dispatchExtractor(
       return extractExposesApi(call, sourceFile);
     case "unmanagedTable":
       return extractUnmanagedTable(call, sourceFile);
-    // Round 6 — Visual-Tree patterns
+    // Round 6 — Tree-Actions pattern
     case "treeActions":
       return extractTreeActions(call, sourceFile);
-    case "tree":
-      return extractTree(call, sourceFile);
     // Round 7 — env-schema contract (opaque, Zod-expression argument)
     case "envSchema":
       return extractEnvSchema(call, sourceFile);

package/src/engine/feature-ast/patch.ts

@@ -84,8 +84,7 @@ export type PatternId =
   | { readonly kind: "config" }
   | { readonly kind: "translations" }
   | { readonly kind: "authClaims" }
-  | { readonly kind: "treeActions" }
-  | { readonly kind: "tree" };
+  | { readonly kind: "treeActions" };
 
 // =============================================================================
 // Change ops — generic apply API
@@ -277,10 +276,9 @@ export const SINGLETON_KINDS: ReadonlySet<PatternId["kind"]> = new Set([
   "config",
   "translations",
   "authClaims",
-  // Visual-Tree slots — at-most-one per feature, mirrors the registrar's
+  // Tree-Actions slot — at-most-one per feature, mirrors the registrar's
   // only-once-guard in define-feature.ts.
   "treeActions",
-  "tree",
 ]);
 
 /**
@@ -336,7 +334,6 @@ function callMatchesId(call: CallExpression, id: PatternId): boolean {
     case "translations":
     case "authClaims":
     case "treeActions":
-    case "tree":
       return true;
 
     case "entity":

package/src/engine/feature-ast/patterns.ts

@@ -445,18 +445,6 @@ export type AuthClaimsPattern = {
   readonly fnBody: SourceLocation;
 };
 
-// `r.tree(provider)` — the feature's top-level tree provider: a subscribe
-// function (emit-fn in, unsubscribe-fn out) that feeds workspaces with
-// `navigation: "tree"`. Features without `r.tree()` are invisible there —
-// provider presence IS the filter, there is no workspace mapping.
-// Closure-only, no header form: the Designer renders a read-only code
-// block, the AI patcher overwrites the span verbatim.
-export type TreePattern = {
-  readonly kind: "tree";
-  readonly source: SourceLocation;
-  readonly providerBody: SourceLocation;
-};
-
 // `r.httpRoute(definition)` — mounts an HTTP route owned by the feature,
 // outside the dispatcher pipeline (not under `/api/write|query|batch`) —
 // for RSS/Atom feeds, OG images, OpenAPI specs and similar. Duplicate
@@ -625,7 +613,6 @@ export type FeaturePattern =
   | DefineEventPattern
   | EventMigrationPattern
   | ExtendsRegistrarPattern
-  | TreePattern
   | EnvSchemaPattern
   // Catch-all
   | UnknownPattern;
@@ -684,7 +671,6 @@ export function getEditability(pattern: FeaturePattern): Editability {
       return "mixed";
     case "authClaims":
     case "extendsRegistrar":
-    case "tree":
     case "envSchema":
     case "uiHints":
     case "unknown":

package/src/engine/feature-ast/render.ts

@@ -49,7 +49,6 @@ import type {
   ToggleablePattern,
   TranslationsPattern,
   TreeActionsPattern,
-  TreePattern,
   UiHintsPattern,
   UnknownPattern,
   UseExtensionPattern,
@@ -139,8 +138,6 @@ export function renderPattern(pattern: FeaturePattern): string {
       return renderExposesApi(pattern);
     case "treeActions":
       return renderTreeActions(pattern);
-    case "tree":
-      return renderTree(pattern);
     case "envSchema":
       return renderEnvSchema(pattern);
     case "unknown":
@@ -433,16 +430,11 @@ function renderAuthClaims(p: AuthClaimsPattern): string {
   return `r.authClaims(${p.fnBody.raw});`;
 }
 
-// Visual-Tree patterns. treeActions is a static object-literal (mirrors
-// renderWorkspace), tree is opaque-only (mirrors renderAuthClaims).
+// treeActions is a static object-literal (mirrors renderWorkspace).
 function renderTreeActions(p: TreeActionsPattern): string {
   return `r.treeActions(${renderValue(p.definitions)});`;
 }
 
-function renderTree(p: TreePattern): string {
-  return `r.tree(${p.providerBody.raw});`;
-}
-
 function renderHttpRoute(p: HttpRoutePattern): string {
   const lines: string[] = ["r.httpRoute({"];
   lines.push(`  method: ${JSON.stringify(p.method)},`);

package/src/engine/index.ts

@@ -123,7 +123,6 @@ export {
   createTextField,
   createTimestampField,
   createTzField,
-  locatedTimestamp,
 } from "./factories";
 // AST inspection + patching pipeline — used by the CLI scaffolder, the
 // Designer (C5/C6), and the AI-Builder (L2). See feature-ast/index.ts

package/src/engine/pattern-library/__tests__/library.test.ts

@@ -60,7 +60,6 @@ const ALL_KINDS: FeaturePatternKind[] = [
   "usesApi",
   "exposesApi",
   "treeActions",
-  "tree",
   "envSchema",
   "unknown",
 ];
@@ -351,8 +350,6 @@ function makePlaceholderPattern(kind: FeaturePatternKind): FeaturePattern {
       };
     case "treeActions":
       return { kind, source: PLACEHOLDER_LOC, definitions: {} };
-    case "tree":
-      return { kind, source: PLACEHOLDER_LOC, providerBody: PLACEHOLDER_BODY_LOC };
     case "envSchema":
       return { kind, source: PLACEHOLDER_LOC, schemaBody: PLACEHOLDER_BODY_LOC };
     case "unknown":

package/src/engine/pattern-library/library.ts

@@ -1102,24 +1102,6 @@ const treeActionsSchema: PatternFormSchema = {
   ],
 };
 
-const treeSchema: PatternFormSchema = {
-  kind: "tree",
-  label: { en: "Tree provider", de: "Tree-Provider" },
-  summary: { en: "Subscribe-Function emitting top-level Visual-Tree nodes." },
-  category: "ui",
-  editability: "opaque",
-  singleton: true,
-  fields: [
-    {
-      path: "providerBody",
-      label: { en: "Provider body (source)", de: "Provider-Body (Source)" },
-      input: "code-block",
-      language: "typescript",
-      readOnly: true,
-    },
-  ],
-};
-
 const envSchemaSchema: PatternFormSchema = {
   kind: "envSchema",
   label: { en: "Env schema", de: "Env-Schema" },
@@ -1200,7 +1182,6 @@ export const PATTERN_LIBRARY: Readonly<Record<FeaturePatternKind, PatternFormSch
   usesApi: usesApiSchema,
   exposesApi: exposesApiSchema,
   treeActions: treeActionsSchema,
-  tree: treeSchema,
   envSchema: envSchemaSchema,
   unknown: unknownSchema,
 } satisfies Readonly<Record<FeaturePatternKind, PatternFormSchema>>;

package/src/engine/registry.ts

@@ -57,7 +57,6 @@ import type {
   SecretKeyDefinition,
   TranslationKeys,
   TreeActionDef,
-  TreeChildrenSubscribe,
   UnmanagedTableDef,
   WorkspaceDefinition,
   WriteHandlerDef,
@@ -291,12 +290,10 @@ export function createRegistry(features: readonly FeatureDefinition[]): Registry
   const navsByWorkspace = new Map<string, string[]>();
   let defaultWorkspace: WorkspaceDefinition | undefined;
 
-  // Visual-Tree-Provider — keyed by declaring feature name (NOT qualified;
-  // ein Feature liefert genau einen Provider). Visual-Tree-Component
-  // iteriert die Map zur Mount-Zeit. Tree-Actions parallel — featureName
-  // → erased Action-Map (compile-time-typed Variante geht über
-  // setup-export-handle, siehe FeatureRegistrar.treeActions docs).
-  const treeProvidersMap = new Map<string, TreeChildrenSubscribe>();
+  // Tree-Actions — keyed by declaring feature name (NOT qualified; ein
+  // Feature liefert genau eine erased Action-Map (compile-time-typed
+  // Variante geht über setup-export-handle, siehe
+  // FeatureRegistrar.treeActions docs).
   const treeActionsMap = new Map<string, Readonly<Record<string, TreeActionDef>>>();
 
   // Local alias for readability — `qualifyEntityName` is the shared helper
@@ -786,12 +783,9 @@ export function createRegistry(features: readonly FeatureDefinition[]): Registry
       }
     }
 
-    // Visual-Tree slots — at-most-one per feature (only-once-guard im
-    // registrar). Erased Maps für Runtime-Lookup; compile-time-typed
+    // Tree-Actions slot — at-most-one per feature (only-once-guard im
+    // registrar). Erased Map für Runtime-Lookup; compile-time-typed
     // Surface läuft über FeatureDefinition.exports (TreeActionsHandle).
-    if (feature.treeProvider !== undefined) {
-      treeProvidersMap.set(feature.name, feature.treeProvider);
-    }
     if (feature.treeActions !== undefined) {
       treeActionsMap.set(feature.name, feature.treeActions);
     }
@@ -1693,10 +1687,6 @@ export function createRegistry(features: readonly FeatureDefinition[]): Registry
       return defaultWorkspace;
     },
 
-    getTreeProviders(): ReadonlyMap<string, TreeChildrenSubscribe> {
-      return treeProvidersMap;
-    },
-
     getTreeActions(featureName: string): Readonly<Record<string, TreeActionDef>> | undefined {
       return treeActionsMap.get(featureName);
     },

package/src/engine/types/feature.ts

@@ -70,7 +70,7 @@ import type {
 } from "./projection";
 import type { EntityRelations, RelationDefinition } from "./relations";
 import type { ScreenDefinition } from "./screen";
-import type { TreeActionDef, TreeActionsHandle, TreeChildrenSubscribe } from "./tree-node";
+import type { TreeActionDef, TreeActionsHandle } from "./tree-node";
 import type { WorkspaceDefinition } from "./workspace";
 
 // --- Metrics (declared by features via r.metric()) ---
@@ -352,13 +352,6 @@ export type FeatureDefinition = {
   // feature exports via setup-return — buildTarget consumes the handle,
   // not this slot. See visual-tree.md A5 + A7.
   readonly treeActions?: Readonly<Record<string, TreeActionDef>>;
-  // Tree-Provider declared via r.tree(). At-most-one per feature.
-  // Provider liefert die Top-Level-Knoten dieses Features im Visual-
-  // Workspace (navigation: "tree"). Subscribe-Form mit lazy-Eval: erst
-  // beim Mount des Workspaces aufgerufen, kann Updates emittieren.
-  // Feature ohne treeProvider ist im Visual-Workspace unsichtbar
-  // (Zero-Whitelist-Filter aus visual-tree.md A2).
-  readonly treeProvider?: TreeChildrenSubscribe;
   // HTTP-Routes declared via r.httpRoute(). Index is "METHOD path"
   // (z.B. "GET /feed.xml") — eindeutig pro Feature. Die App-Server-
   // Boot-Stage iteriert getAllHttpRoutes() und mountet jede Route auf
@@ -771,20 +764,6 @@ export type FeatureRegistrar<TFeature extends string = string> = {
   // k8s-secret hints) goes into `.meta({ kumiko: { pulumi: {...} } })`
   // — see framework/env/index.ts for the meta-shape.
   envSchema(schema: z.ZodObject<z.ZodRawShape>): void;
-
-  // Register the tree-provider for this feature — the Subscribe-Function
-  // that emits the top-level Tree-Knoten when the Visual-Workspace
-  // (navigation: "tree") mounts. At-most-one call per feature.
-  //
-  // Provider returns a Subscribe-Function (emit-fn → unsubscribe-fn).
-  // Initial-emit synchron oder async, weitere Emits beliebig oft (e.g.
-  // on entity-update SSE). Provider sind session-bound; tenantId fließt
-  // über die Backend-Session bei fetch/dispatch, nicht über ein ctx-Arg.
-  //
-  // A feature without r.tree() is invisible in `navigation: "tree"`-
-  // workspaces — that's the Zero-Whitelist-Filter from visual-tree.md A2:
-  // provider-Vorhandensein ist der Filter, kein Workspace-Mapping.
-  tree(provider: TreeChildrenSubscribe): void;
 };
 
 // --- Registry (created from features) ---
@@ -977,18 +956,9 @@ export type Registry = {
   // the first workspace the user has access to.
   getDefaultWorkspace(): WorkspaceDefinition | undefined;
 
-  // Tree-Providers declared via r.tree() across all features. Keyed by
-  // declaring feature name (NOT qualified — Provider sind feature-bound,
-  // ein Feature liefert genau eine Provider-Function). The Visual-Tree
-  // component (renderer-web) iteriert getTreeProviders() beim Mount des
-  // navigation: "tree"-Workspaces, ruft jeden Provider mit ctx auf,
-  // sammelt die emitted TreeNode[] und merged sie zur Top-Level-Liste.
-  // See visual-tree.md A2 (Zero-Whitelist) + A4 (Subscribe-Form).
-  getTreeProviders(): ReadonlyMap<string, TreeChildrenSubscribe>;
-
   // Tree-Actions-Map des Features. Returns the erased Record (compile-
-  // time-typed handle wandert über setup-export, nicht hier). Visual-
-  // Tree-Component nutzt das für Runtime-Action-Lookup beim Klick auf
+  // time-typed handle wandert über setup-export, nicht hier). Die
+  // Content-Tree-Nav nutzt das für Runtime-Action-Lookup beim Klick auf
   // einen TreeNode.target — der Resolver findet das Feature via
   // TargetRef.featureId und holt sich die zugehörige Action-Definition.
   getTreeActions(featureName: string): Readonly<Record<string, TreeActionDef>> | undefined;

package/src/engine/types/fields.ts

@@ -354,7 +354,7 @@ export type JsonbFieldDef = {
 // Legacy "date" — JS-Date-Object, semantisch unklar (Wall-Clock vs Instant).
 // Für neue Felder bevorzuge:
 //   - `timestamp` für UTC-Instant ("wann ist das passiert")
-//   - `locatedTimestamp(name)` Helper für Termine die an einem Ort
+//   - `createLocatedTimestampField()` für Termine die an einem Ort
 //     stattfinden ("Pickup um 10:00 in Lissabon")
 //   - (kommt) `plainDate` für Kalender-Daten ohne Uhrzeit (z.B. Geburtstag)
 // Siehe docs/plans/architecture/timezones.md
@@ -384,8 +384,8 @@ export type DateFieldDef = {
 // speichert Wall-Clock+tz und konvertiert transparent (siehe DB-Wrapper,
 // kommt in einer späteren Iteration).
 //
-// Verwendung über den `locatedTimestamp(name)` Helper, der das Pair atomar
-// erzeugt und die Marker korrekt verdrahtet.
+// Für neue Felder bevorzuge `createLocatedTimestampField()` — EIN atomares
+// Feld statt eines lose verdrahteten Pairs (siehe LocatedTimestampFieldDef).
 export type TimestampFieldDef = {
   readonly type: "timestamp";
   readonly required?: boolean;
@@ -397,8 +397,9 @@ export type TimestampFieldDef = {
    * Marker: dieses Timestamp-Feld ist Wall-Clock-Zeit an einem Ort.
    * Wert ist der Name des begleitenden tz-Felds (IANA-Zone).
    *
-   * Beispiel: `locatedTimestamp("pickup")` erzeugt
+   * Beispiel: manuelles Pair
    *   { pickupAt: { type: "timestamp", locatedBy: "pickupTz" }, pickupTz: { type: "tz" } }
+   * — bevorzuge stattdessen `createLocatedTimestampField()`.
    */
   readonly locatedBy?: string;
   /** Erlaubte Grenzen als ISO-Datetime. Begrenzt den Picker auf

package/src/engine/types/index.ts

@@ -220,9 +220,14 @@ export type {
   CustomScreenDefinition,
   CustomScreenRoute,
   DashboardChartPanel,
+  DashboardCustomPanel,
+  DashboardFeedPanel,
+  DashboardFilterDefinition,
   DashboardListPanel,
   DashboardPanelDefinition,
+  DashboardProgressListPanel,
   DashboardScreenDefinition,
+  DashboardStatGroupPanel,
   DashboardStatPanel,
   EditExtensionSection,
   EditFieldSpec,

package/src/engine/types/screen.ts

@@ -369,15 +369,78 @@ export type DashboardListPanel = {
   readonly columns: readonly ListColumnSpec[];
 };
 
+// Betitelte Sektion aus mehreren Stat-Panels (z.B. "Net Worth": Assets/Debts/
+// Net). Ein Nesting-Level, kein Group-of-Groups — jedes Kind bleibt ein
+// vollwertiges DashboardStatPanel mit eigener Query/id/label, der Renderer
+// zieht sie nur gemeinsam unter einen Sektions-Titel.
+export type DashboardStatGroupPanel = {
+  readonly kind: "stat-group";
+  readonly id: string;
+  readonly label: string;
+  readonly stats: readonly DashboardStatPanel[];
+};
+
+// Nicht-tabellarische Kurzliste (z.B. "nächste Termine"). Query-Result-
+// Contract: `{ rows: { primary: string; trailing?: string }[] }`.
+export type DashboardFeedPanel = {
+  readonly kind: "feed";
+  readonly id: string;
+  readonly label: string;
+  readonly query: string;
+  readonly emptyLabel?: string;
+};
+
+// Liste aus Label/Wert/Fortschrittsbalken (z.B. Tilgungsfortschritt pro
+// Kredit). Query-Result-Contract: `{ rows: { label: string; value: string;
+// fraction: number }[] }` — fraction wird auf 0..1 geclampt.
+export type DashboardProgressListPanel = {
+  readonly kind: "progress-list";
+  readonly id: string;
+  readonly label: string;
+  readonly query: string;
+};
+
+// Eingehängte App-Komponente, die ihre Daten/Titel selbst verwaltet (wie ein
+// custom Screen, nur als Panel — bleibt an ihrer Array-Position statt in
+// einen separaten Slot zu wandern). Kein `query`, keine `label`: der Renderer
+// löst `component` über dieselbe extensionSectionComponents-Registry auf wie
+// entityEdit-Extension-Sections und List-Header-Slots.
+export type DashboardCustomPanel = {
+  readonly kind: "custom";
+  readonly id: string;
+  readonly component: PlatformComponent;
+};
+
 export type DashboardPanelDefinition =
   | DashboardStatPanel
+  | DashboardStatGroupPanel
   | DashboardChartPanel
-  | DashboardListPanel;
+  | DashboardListPanel
+  | DashboardFeedPanel
+  | DashboardProgressListPanel
+  | DashboardCustomPanel;
+
+// Screen-weiter Picker (Combobox), dessen gewählter Wert unter `id` in JEDE
+// Panel-Query dieses Screens gemerged wird (Query-Handler validieren den Wert
+// selbst gegen die Tenant-Sicht — dies ist UX-Scoping, keine Access-Boundary).
+// Genau eins von `options`/`optionsQuery` ist gesetzt (Boot-Validator prüft).
+export type DashboardFilterDefinition = {
+  readonly id: string;
+  readonly label: string;
+  readonly kind: "select";
+  readonly placeholder?: string;
+  /** i18n-Key für den "(alle)"-Eintrag. */
+  readonly allLabel?: string;
+  readonly options?: readonly { readonly value: string; readonly label: string }[];
+  /** Query-Result-Contract: `{ rows: { value: string; label: string }[] }`. */
+  readonly optionsQuery?: string;
+};
 
 export type DashboardScreenDefinition = {
   readonly id: string;
   readonly type: "dashboard";
   readonly panels: readonly DashboardPanelDefinition[];
+  readonly filter?: DashboardFilterDefinition;
   readonly slots?: ScreenSlots;
   readonly access?: AccessRule;
 };

package/src/engine/types/workspace.ts

@@ -39,11 +39,4 @@ export type WorkspaceDefinition = {
   // Default workspace at login when the user has access to multiple. Boot
   // validator rejects more than one default per app.
   readonly default?: boolean;
-  // Render mode of the workspace's sidebar. "nav" (default, missing-ok)
-  // mounts the existing NavTree component as before. "tree" mounts the
-  // Visual-Tree component which collects r.tree() providers across all
-  // active features. Default-on-undefined preserves backwards-compat —
-  // every existing workspace stays nav-mode without code touch.
-  // See visual-tree.md A1.
-  readonly navigation?: "nav" | "tree";
 };

package/src/errors/classes.ts

@@ -2,7 +2,7 @@ import { toSnakeCase } from "../utils/case";
 import type { FieldIssue } from "./field-issue";
 import { type ErrorOpts, KumikoError } from "./kumiko-error";
 
-export type { FieldIssue, ValidationFieldIssue } from "./field-issue";
+export type { FieldIssue } from "./field-issue";
 
 export type ValidationDetails = {
   readonly fields: readonly FieldIssue[];

package/src/errors/field-issue.ts

@@ -6,6 +6,3 @@ export type FieldIssue = {
   readonly i18nKey: string;
   readonly params?: Readonly<Record<string, unknown>>;
 };
-
-/** @deprecated Use `FieldIssue` — kept for existing imports. */
-export type ValidationFieldIssue = FieldIssue;

package/src/errors/index.ts

@@ -7,7 +7,6 @@ export type {
   UniqueViolationDetails,
   UnprocessableOpts,
   ValidationDetails,
-  ValidationFieldIssue,
   VersionConflictDetails,
 } from "./classes";
 export {

package/src/i18n/required-surface-keys.ts

@@ -1,6 +1,8 @@
 import type {
   ActionFormScreenDefinition,
   ConfigEditScreenDefinition,
+  DashboardFilterDefinition,
+  DashboardPanelDefinition,
   DashboardScreenDefinition,
   EntityEditScreenDefinition,
   EntityListScreenDefinition,
@@ -66,6 +68,32 @@ function pushRowActionKeys(out: Set<string>, action: RowAction): void {
   }
 }
 
+function pushDashboardScreenKeys(out: Set<string>, dashboard: DashboardScreenDefinition): void {
+  for (const panel of dashboard.panels) pushDashboardPanelKeys(out, panel);
+  if (dashboard.filter !== undefined) pushDashboardFilterKeys(out, dashboard.filter);
+}
+
+function pushDashboardPanelKeys(out: Set<string>, panel: DashboardPanelDefinition): void {
+  // skip: custom-Panel übersetzt sich selbst, kein Key hier
+  if (panel.kind === "custom") return;
+  pushKey(out, panel.label);
+  if (panel.kind === "stat-group") {
+    for (const stat of panel.stats) pushKey(out, stat.label);
+  }
+  if (panel.kind === "list") {
+    for (const col of panel.columns) {
+      const normalized = normalizeListColumn(col);
+      if (normalized.label !== undefined) pushKey(out, normalized.label);
+    }
+  }
+}
+
+function pushDashboardFilterKeys(out: Set<string>, filter: DashboardFilterDefinition): void {
+  pushKey(out, filter.label);
+  if (filter.allLabel !== undefined) pushKey(out, filter.allLabel);
+  for (const opt of filter.options ?? []) pushKey(out, opt.label);
+}
+
 function pushToolbarActionKeys(out: Set<string>, action: ToolbarAction): void {
   pushKey(out, action.label);
   if (action.kind === "writeHandler") {
@@ -108,16 +136,7 @@ export function requiredKeysFromScreen(
       break;
     }
     case "dashboard": {
-      const dashboard = screen as DashboardScreenDefinition;
-      for (const panel of dashboard.panels) {
-        pushKey(out, panel.label);
-        if (panel.kind === "list") {
-          for (const col of panel.columns) {
-            const normalized = normalizeListColumn(col);
-            if (normalized.label !== undefined) pushKey(out, normalized.label);
-          }
-        }
-      }
+      pushDashboardScreenKeys(out, screen as DashboardScreenDefinition);
       break;
     }
     case "entityEdit": {