@cosmicdrift/kumiko-types 0.243.3 → 0.243.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.243.3",
+  "version": "0.243.4",
   "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/entity-handlers.ts

@@ -5,17 +5,25 @@ export type EntityHandlerOptions = {
   readonly access?: AccessRule;
   readonly description?: string;
   readonly agent?: AgentHandlerHints;
-};
-
-export type EntityQueryHandlerOptions = EntityHandlerOptions & {
-  /** Reads across every tenant instead of the caller's own — for a
-   *  SystemAdmin-only operator inspector over an otherwise tenant-scoped
-   *  entity. Scope this to the ONE handler that needs it rather than making
-   *  the whole feature r.systemScope(), which would drop tenant isolation
-   *  from every other handler the feature registers too. */
+  /** Reads and writes across every tenant instead of the caller's own — for a
+   *  SystemAdmin-only operator handler over an otherwise tenant-scoped entity.
+   *  Scope this to the ONE handler that needs it rather than making the whole
+   *  feature r.systemScope(), which would drop tenant isolation from every
+   *  other handler the feature registers too. This only lifts row filtering;
+   *  who may call the handler at all stays gated by `access`.
+   *
+   *  On write handlers it additionally addresses the event stream by the
+   *  target row's tenant instead of the acting user's, so update/delete/
+   *  restore hit the row's own stream. `create` has no target row and stays
+   *  on the acting user's tenant. On write handlers this also satisfies
+   *  entity write-ownership rules that compare against the acting user's
+   *  tenant, so `access` is the only remaining gate — grant it to operator
+   *  roles only. */
   readonly crossTenant?: boolean;
 };
 
+export type EntityQueryHandlerOptions = EntityHandlerOptions;
+
 export type EntityCrudVerb = "create" | "update" | "delete" | "restore" | "list" | "detail";
 
 export type RegisterEntityCrudOptions = {

package/src/screen.ts

@@ -208,7 +208,10 @@ export type RowFieldExtractor =
 //   - "navigate" (Tier 2.7e): navigiert zu einem anderen Screen,
 //     optional mit URL-Search-Params aus `params`. Use-case: "Edit",
 //     "View Audit-Log", "Open in actionForm" etc.
-export type RowAction = RowActionWriteHandler | RowActionNavigate;
+//   - "drawer" (fw#2710): mounts an actionForm in a Drawer without leaving
+//     the list/detail screen, prefilled from the clicked row via `params`.
+//     Row-level pendant to ToolbarAction's "drawer" variant (fw#2225).
+export type RowAction = RowActionWriteHandler | RowActionNavigate | RowActionDrawer;
 
 export type RowActionWriteHandler = {
   /** Default für RowActions ohne explizit gesetzten `kind` —
@@ -294,6 +297,27 @@ export type RowActionNavigate = RowActionNavigateBase &
       }
   );
 
+export type RowActionDrawer = {
+  readonly kind: "drawer";
+  readonly id: string;
+  readonly label: string;
+  /** Short, unqualified id of an `actionForm` screen in the same feature.
+   *  Boot validator rejects a missing screen and a screen whose `type`
+   *  isn't `actionForm` — same check as ToolbarAction's drawer variant
+   *  (see docs/plans/bundled-features-screen-standardisierung.md §2.6c). */
+  readonly screen: string;
+  /** Declarative prefill extracted from the clicked row. `pick` extracts
+   *  fields of the same name; `map` renames them. */
+  readonly params?: RowFieldExtractor;
+  /** Per-row conditional visibility. */
+  readonly visible?: FieldCondition;
+  readonly style?: "primary" | "secondary";
+  /** Overrides the id-based default icon (see ACTION_ICON_BY_ID in
+   *  kumiko-renderer) — closed IconKey vocabulary into the ICONS registry
+   *  (renderer-web), analogous to EditFieldSpec.icon. */
+  readonly icon?: IconKey;
+};
+
 // ToolbarAction — button in the list header. Three variants: navigate to
 // another screen (e.g. a full-page actionForm), dispatch a handler directly
 // (e.g. "Sync All" without a form), or mount an actionForm in a Drawer