@cosmicdrift/kumiko-renderer 0.243.3 → 0.244.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer",
-  "version": "0.243.3",
+  "version": "0.244.0",
   "description": "Platform-agnostic React renderer for Kumiko screens. Contains the shared logic — primitives-contract, hooks, KumikoScreen, navigation & SSE abstractions — that any platform-specific renderer (web, native) composes. No DOM, no EventSource, no react-dom.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -15,8 +15,8 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.243.3",
-    "@cosmicdrift/kumiko-headless": "0.243.3",
+    "@cosmicdrift/kumiko-framework": "0.244.0",
+    "@cosmicdrift/kumiko-headless": "0.244.0",
     "react": "^19.2.6",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3"
@@ -27,7 +27,7 @@
     "@types/react-dom": "^19.2.3",
     "jsdom": "^29.1.1",
     "react-dom": "^19.2.6",
-    "@cosmicdrift/kumiko-locale-de": "0.243.3"
+    "@cosmicdrift/kumiko-locale-de": "0.244.0"
   },
   "repository": {
     "type": "git",

package/src/app/kumiko-screen.tsx

@@ -10,6 +10,7 @@ import type {
   ProjectionDetailScreenDefinition,
   ProjectionListScreenDefinition,
   RowAction,
+  RowActionDrawer,
   RowActionNavigate,
   ScreenDefinition,
   ToolbarAction,
@@ -372,6 +373,12 @@ export function mergeSearchParamsIntoInitial(
   searchParams: Readonly<Record<string, string>>,
   renderableFields?: ReadonlySet<string>,
   defaultCurrency?: string,
+  // Drawer-kind row actions (fw#2710) prefill directly from the clicked
+  // row's already-typed values — no URL round-trip, so no string coercion.
+  // Goes through the same renderableFields/sensitive gates as searchParams
+  // (a `params` extractor could still name a hidden or sensitive field) and
+  // wins over searchParams for a name present in both.
+  overrides?: Readonly<Record<string, unknown>>,
 ): Record<string, unknown> {
   const defaults = buildInitialValues(fields, defaultCurrency) as Record<string, unknown>;
   const merged: Record<string, unknown> = { ...defaults };
@@ -383,6 +390,10 @@ export function mergeSearchParamsIntoInitial(
       options?: readonly (string | { readonly value: string })[];
     };
     if (shape.sensitive === true) continue;
+    if (overrides !== undefined && name in overrides) {
+      merged[name] = overrides[name];
+      continue;
+    }
     const raw = searchParams[name];
     if (raw === undefined) continue;
     if (shape.type === "number") {
@@ -721,6 +732,9 @@ function EntityEditUpdateForm({
   const t = useTranslation();
   const effectiveTranslate = translate ?? t;
   const navigateToList = useNavigateToListAfter(schema, screen.entity);
+  const userRoles = useUserRoles();
+  const { drawerAction, drawerScreen, drawerInitialValues, openDrawer, closeDrawer } =
+    useDrawerAction(schema);
   // Header action buttons (fw entityEdit-actions) — same shape/dispatch
   // pattern as ProjectionDetailBody.headerActions above (the edited record
   // stands in for the "row"), minus the cross-feature defaultEditAction
@@ -779,6 +793,24 @@ function EntityEditUpdateForm({
         }
         continue;
       }
+      if (action.kind === "drawer") {
+        const drawerActionEntry = action;
+        const actionIcon = resolveActionIcon(action.id, action.icon);
+        out.push({
+          id: action.id,
+          label: effectiveTranslate(action.label),
+          ...(action.style !== undefined && { style: action.style }),
+          ...(actionIcon !== undefined && { icon: actionIcon }),
+          onPress: () => {
+            const initialValues =
+              drawerActionEntry.params !== undefined
+                ? evalRowExtractor(drawerActionEntry.params, record)
+                : undefined;
+            openDrawer(drawerActionEntry, initialValues);
+          },
+        });
+        continue;
+      }
       // writeHandler — same dispatch/reload/failure-surfacing pattern as
       // ProjectionDetailBody's headerActions above.
       const writeAction = action;
@@ -810,7 +842,7 @@ function EntityEditUpdateForm({
       });
     }
     return out.length > 0 ? out : undefined;
-  }, [screen.actions, effectiveTranslate, nav, dispatcher, record, entityId, onReload]);
+  }, [screen.actions, effectiveTranslate, nav, dispatcher, record, entityId, onReload, openDrawer]);
   const handleSubmitted = useCallback(
     (result: SubmitResult<unknown>) => {
       if (!result.isSuccess) return;
@@ -832,34 +864,49 @@ function EntityEditUpdateForm({
   }, [dispatcher, deleteCommand, entityId, navigateToList, onDeleted]);
 
   return (
-    <RenderEdit
-      screen={screen}
-      entity={entity}
-      featureName={schema.featureName}
-      initial={initial}
-      // Echte route-id an die extension-section (Set-Value-UI): das
-      // Update-Form lässt `id` bewusst aus den Form-values, daher braucht
-      // die Section die id explizit — sonst create-mode trotz Edit.
-      entityId={entityId}
-      // customFields-Bestand an die extension-section, damit sie beim Edit
-      // die gespeicherten Werte zeigt (nicht write-only).
-      extensionInitialValues={extensionInitialValues}
-      schema={formSchema}
-      writeCommand={writeCommand}
-      payloadMode="changes"
-      buildPayload={buildPayload}
-      onSubmit={handleSubmitted}
-      // allowDelete:false = Entity ohne CRUD-delete (History-Erhalt) —
-      // ohne das Gate dispatchte der Button gegen einen nicht
-      // registrierten `<entity>:delete`-Handler.
-      {...(screen.allowDelete !== false && { onDelete: handleDelete })}
-      onCancel={navigateToList}
-      onReload={() => void onReload()}
-      {...(screen.submitLabel !== undefined && { submitLabel: screen.submitLabel })}
-      {...(translate !== undefined && { translate })}
-      {...(onCopyLink !== undefined && { onCopyLink })}
-      {...(headerActions !== undefined && { actions: headerActions })}
-    />
+    <>
+      <RenderEdit
+        screen={screen}
+        entity={entity}
+        featureName={schema.featureName}
+        initial={initial}
+        // Real route id for the extension section (set-value UI): the update
+        // form deliberately keeps `id` out of the form values, so the section
+        // needs it explicitly — otherwise it renders in create mode.
+        entityId={entityId}
+        // Stored customFields for the extension section, so editing shows the
+        // persisted values instead of behaving write-only.
+        extensionInitialValues={extensionInitialValues}
+        schema={formSchema}
+        writeCommand={writeCommand}
+        payloadMode="changes"
+        buildPayload={buildPayload}
+        onSubmit={handleSubmitted}
+        // allowDelete:false marks an entity without a CRUD delete (history is
+        // kept) — without this gate the button dispatched against an
+        // unregistered `<entity>:delete` handler.
+        {...(screen.allowDelete !== false && { onDelete: handleDelete })}
+        onCancel={navigateToList}
+        onReload={() => void onReload()}
+        {...(screen.submitLabel !== undefined && { submitLabel: screen.submitLabel })}
+        {...(translate !== undefined && { translate })}
+        {...(onCopyLink !== undefined && { onCopyLink })}
+        {...(headerActions !== undefined && { actions: headerActions })}
+      />
+      <DrawerHost
+        schema={schema}
+        drawerAction={drawerAction}
+        drawerScreen={drawerScreen}
+        {...(drawerInitialValues !== undefined && { drawerInitialValues })}
+        userRoles={userRoles}
+        {...(translate !== undefined && { translate })}
+        onClose={closeDrawer}
+        onSuccess={() => {
+          closeDrawer();
+          void onReload();
+        }}
+      />
+    </>
   );
 }
 
@@ -1145,24 +1192,35 @@ function resolveProjectionFacetSpecs(
   );
 }
 
-// ---- toolbarAction kind:"drawer" (fw#2225) ----
+// ---- drawer-kind actions: ToolbarAction (fw#2225) + RowAction (fw#2710) ----
 //
-// Shared between EntityListBody and ProjectionListBody: state for "which
-// drawer-kind toolbar action is currently open" plus a host component that
-// mounts the referenced actionForm inside the Drawer primitive. Reuses
-// ActionFormBody (no second, parallel form renderer) with onSuccess/
-// onCancelOverride so submit-success closes the drawer + refetches the
-// list instead of navigating, mirroring what a full-page actionForm would
-// do via `redirect`.
-type ToolbarDrawerAction = Extract<ToolbarAction, { kind: "drawer" }>;
-
-function useToolbarDrawerAction(schema: FeatureSchema): {
-  readonly drawerAction: ToolbarDrawerAction | null;
+// Shared across EntityListBody, ProjectionListBody, ProjectionDetailBody and
+// EntityEditUpdateForm: state for "which drawer-kind action is currently
+// open" plus a host component that mounts the referenced actionForm inside
+// the Drawer primitive. Reuses ActionFormBody (no second, parallel form
+// renderer) with onSuccess/onCancelOverride so submit-success closes the
+// drawer + refetches the host screen instead of navigating, mirroring what
+// a full-page actionForm would do via `redirect`. The only difference
+// between the toolbar and row variants is prefill: a row action extracts
+// `initialValues` from the clicked row (see buildProjectionRowActions /
+// EntityListBody's rowActions builder); the toolbar variant has none.
+type DrawerLikeAction = Extract<ToolbarAction, { kind: "drawer" }> | RowActionDrawer;
+
+function useDrawerAction(schema: FeatureSchema): {
+  readonly drawerAction: DrawerLikeAction | null;
   readonly drawerScreen: ActionFormScreenDefinition | undefined;
-  readonly openDrawer: (action: ToolbarDrawerAction) => void;
+  readonly drawerInitialValues: Readonly<Record<string, unknown>> | undefined;
+  readonly openDrawer: (
+    action: DrawerLikeAction,
+    initialValues?: Readonly<Record<string, unknown>>,
+  ) => void;
   readonly closeDrawer: () => void;
 } {
-  const [drawerAction, setDrawerAction] = useState<ToolbarDrawerAction | null>(null);
+  const [drawerState, setDrawerState] = useState<{
+    readonly action: DrawerLikeAction;
+    readonly initialValues: Readonly<Record<string, unknown>> | undefined;
+  } | null>(null);
+  const drawerAction = drawerState?.action ?? null;
   const drawerScreen = useMemo(() => {
     if (drawerAction === null) return undefined;
     // Same same-feature, short-id resolution as runNavigate — the drawer's
@@ -1172,23 +1230,35 @@ function useToolbarDrawerAction(schema: FeatureSchema): {
         s.type === "actionForm" && lastSegment(s.id) === drawerAction.screen,
     );
   }, [drawerAction, schema.screens]);
-  const openDrawer = useCallback((action: ToolbarDrawerAction) => setDrawerAction(action), []);
-  const closeDrawer = useCallback(() => setDrawerAction(null), []);
-  return { drawerAction, drawerScreen, openDrawer, closeDrawer };
+  const openDrawer = useCallback(
+    (action: DrawerLikeAction, initialValues?: Readonly<Record<string, unknown>>) =>
+      setDrawerState({ action, initialValues }),
+    [],
+  );
+  const closeDrawer = useCallback(() => setDrawerState(null), []);
+  return {
+    drawerAction,
+    drawerScreen,
+    drawerInitialValues: drawerState?.initialValues,
+    openDrawer,
+    closeDrawer,
+  };
 }
 
-function ToolbarDrawerHost({
+function DrawerHost({
   schema,
   drawerAction,
   drawerScreen,
+  drawerInitialValues,
   userRoles,
   translate,
   onClose,
   onSuccess,
 }: {
   readonly schema: FeatureSchema;
-  readonly drawerAction: ToolbarDrawerAction | null;
+  readonly drawerAction: DrawerLikeAction | null;
   readonly drawerScreen: ActionFormScreenDefinition | undefined;
+  readonly drawerInitialValues?: Readonly<Record<string, unknown>>;
   readonly userRoles: readonly string[] | undefined;
   readonly translate?: Translate;
   readonly onClose: () => void;
@@ -1241,6 +1311,7 @@ function ToolbarDrawerHost({
           schema={schema}
           screen={drawerScreen}
           {...(translate !== undefined && { translate })}
+          {...(drawerInitialValues !== undefined && { initialOverrides: drawerInitialValues })}
           onSuccess={onSuccess}
           onCancelOverride={onClose}
         />
@@ -1303,7 +1374,8 @@ function EntityListBody({
   const queryType = entityQueryCommand(featureName, screen.entity, "list");
   const nav = useNav();
   const userRoles = useUserRoles();
-  const { drawerAction, drawerScreen, openDrawer, closeDrawer } = useToolbarDrawerAction(schema);
+  const { drawerAction, drawerScreen, drawerInitialValues, openDrawer, closeDrawer } =
+    useDrawerAction(schema);
 
   // URL-State: sort/dir/q/page leben unter dem screen.id-Namespace
   // (`/orders?orders.sort=createdAt&orders.dir=desc&orders.q=acme`),
@@ -1545,6 +1617,27 @@ function EntityListBody({
             }),
           };
         }
+        if (action.kind === "drawer") {
+          const drawerAction = action;
+          const actionVisible = action.visible;
+          const actionIcon = resolveActionIcon(action.id, action.icon);
+          return {
+            id: action.id,
+            label: effectiveTranslate(action.label),
+            ...(action.style !== undefined && { style: action.style }),
+            ...(actionIcon !== undefined && { icon: actionIcon }),
+            onTrigger: (row: ListRowViewModel) => {
+              const initialValues =
+                drawerAction.params !== undefined
+                  ? evalRowExtractor(drawerAction.params, row.values)
+                  : undefined;
+              openDrawer(drawerAction, initialValues);
+            },
+            ...(actionVisible !== undefined && {
+              isVisible: (row: ListRowViewModel) => evalFieldCondition(actionVisible, row.values),
+            }),
+          };
+        }
         if (dispatcher === undefined) return null;
         if (!isWriteHandlerRowAction(action)) return null;
         const writeAction = action;
@@ -1585,7 +1678,14 @@ function EntityListBody({
         };
       })
       .filter((a: DataTableRowAction | null): a is DataTableRowAction => a !== null);
-  }, [screen.rowActions, effectiveTranslate, dispatcher, runNavigate, refreshRowsAfterWrite]);
+  }, [
+    screen.rowActions,
+    effectiveTranslate,
+    dispatcher,
+    runNavigate,
+    refreshRowsAfterWrite,
+    openDrawer,
+  ]);
 
   // Row actions that all resolve an icon render inline and collapse to
   // icon-only (fw#2580) — the adaptive default would bury more than two of
@@ -1751,10 +1851,11 @@ function EntityListBody({
           onFilterReset: urlState.clearFilters,
         })}
       />
-      <ToolbarDrawerHost
+      <DrawerHost
         schema={schema}
         drawerAction={drawerAction}
         drawerScreen={drawerScreen}
+        {...(drawerInitialValues !== undefined && { drawerInitialValues })}
         userRoles={userRoles}
         {...(translate !== undefined && { translate })}
         onClose={closeDrawer}
@@ -1793,7 +1894,8 @@ function ProjectionListBody({
   const dispatcher = useOptionalDispatcher();
   const effectiveTranslate = translate ?? t;
   const userRoles = useUserRoles();
-  const { drawerAction, drawerScreen, openDrawer, closeDrawer } = useToolbarDrawerAction(schema);
+  const { drawerAction, drawerScreen, drawerInitialValues, openDrawer, closeDrawer } =
+    useDrawerAction(schema);
 
   // searchable/sortable/paginated are derived at buildAppSchema time from the
   // query handler's Zod schema (fw#2165) — not authored on the screen.
@@ -1893,8 +1995,9 @@ function ProjectionListBody({
         dispatcher,
         nav,
         refetch: rowsQuery.refetch,
+        openDrawer,
       }),
-    [screen.rowActions, effectiveTranslate, dispatcher, nav, rowsQuery.refetch],
+    [screen.rowActions, effectiveTranslate, dispatcher, nav, rowsQuery.refetch, openDrawer],
   );
 
   // Same icon-only collapse as entityList (fw#2580) — projectionList rows go
@@ -2030,10 +2133,11 @@ function ProjectionListBody({
           onFilterReset: urlState.clearFilters,
         })}
       />
-      <ToolbarDrawerHost
+      <DrawerHost
         schema={schema}
         drawerAction={drawerAction}
         drawerScreen={drawerScreen}
+        {...(drawerInitialValues !== undefined && { drawerInitialValues })}
         userRoles={userRoles}
         {...(translate !== undefined && { translate })}
         onClose={closeDrawer}
@@ -2136,6 +2240,8 @@ function ProjectionDetailBody({
   const appFeatures = useAppFeatures();
   const userRoles = useUserRoles();
   const dispatcher = useOptionalDispatcher();
+  const { drawerAction, drawerScreen, drawerInitialValues, openDrawer, closeDrawer } =
+    useDrawerAction(schema);
   const editScreen = useMemo(() => {
     const detailFor = screen.detailFor;
     if (detailFor === undefined) return undefined;
@@ -2247,6 +2353,24 @@ function ProjectionDetailBody({
         }
         continue;
       }
+      if (action.kind === "drawer") {
+        const drawerActionEntry = action;
+        const actionIcon = resolveActionIcon(action.id, action.icon);
+        out.push({
+          id: action.id,
+          label: effectiveTranslate(action.label),
+          ...(action.style !== undefined && { style: action.style }),
+          ...(actionIcon !== undefined && { icon: actionIcon }),
+          onPress: () => {
+            const initialValues =
+              drawerActionEntry.params !== undefined
+                ? evalRowExtractor(drawerActionEntry.params, record)
+                : undefined;
+            openDrawer(drawerActionEntry, initialValues);
+          },
+        });
+        continue;
+      }
       // writeHandler — same dispatch/refetch/failure-surfacing pattern as
       // ProjectionListBody's rowActions/toolbarActions above.
       if (dispatcher === undefined) continue;
@@ -2289,6 +2413,7 @@ function ProjectionDetailBody({
     dispatcher,
     detailQuery.data,
     detailQuery.refetch,
+    openDrawer,
   ]);
 
   if (effectiveEntityId === undefined && screen.singleton !== true) {
@@ -2406,21 +2531,37 @@ function ProjectionDetailBody({
     </>
   );
   return (
-    <RenderEdit
-      key={`${entityId}:${reloadNonce}`}
-      screen={detailScreen}
-      entity={entity}
-      featureName={schema.featureName}
-      initial={record as FormValues}
-      entityId={effectiveEntityId}
-      customSubmit={async () => ({ isSuccess: true, validationBlocked: false, data: undefined })}
-      onReload={reloadDetail}
-      {...(headerActions !== undefined && { actions: headerActions })}
-      {...(translate !== undefined && { translate })}
-      {...(hasTabs && { hideSectionTitles: true })}
-      {...((hasHeader || hasMetrics || hasTabs) && { headerRegion: headerContent })}
-      valueDisplay={screen.valueDisplay ?? "text"}
-    />
+    <>
+      <RenderEdit
+        key={`${entityId}:${reloadNonce}`}
+        screen={detailScreen}
+        entity={entity}
+        featureName={schema.featureName}
+        initial={record as FormValues}
+        entityId={effectiveEntityId}
+        customSubmit={async () => ({ isSuccess: true, validationBlocked: false, data: undefined })}
+        onReload={reloadDetail}
+        onRelatedListDrawerAction={openDrawer}
+        {...(headerActions !== undefined && { actions: headerActions })}
+        {...(translate !== undefined && { translate })}
+        {...(hasTabs && { hideSectionTitles: true })}
+        {...((hasHeader || hasMetrics || hasTabs) && { headerRegion: headerContent })}
+        valueDisplay={screen.valueDisplay ?? "text"}
+      />
+      <DrawerHost
+        schema={schema}
+        drawerAction={drawerAction}
+        drawerScreen={drawerScreen}
+        {...(drawerInitialValues !== undefined && { drawerInitialValues })}
+        userRoles={userRoles}
+        {...(translate !== undefined && { translate })}
+        onClose={closeDrawer}
+        onSuccess={() => {
+          closeDrawer();
+          void reloadDetail();
+        }}
+      />
+    </>
   );
 }
 // ---- actionForm (Tier 2.7d) ----
@@ -2442,12 +2583,17 @@ function ActionFormBody({
   schema,
   screen,
   translate,
+  initialOverrides,
   onSuccess,
   onCancelOverride,
 }: {
   readonly schema: FeatureSchema;
   readonly screen: ActionFormScreenDefinition;
   readonly translate?: Translate;
+  /** Row-drawer usage (RowAction kind:"drawer", fw#2710): prefill extracted
+   *  from the clicked row, applied on top of searchParams through the same
+   *  renderableFields/sensitive gates (see mergeSearchParamsIntoInitial). */
+  readonly initialOverrides?: Readonly<Record<string, unknown>>;
   /** Drawer-hosted usage (toolbarAction kind:"drawer", fw#2225): called
    *  instead of the redirect-based navigation on successful submit, so the
    *  host closes the drawer + refetches its list regardless of whether
@@ -2468,8 +2614,10 @@ function ActionFormBody({
         screen.fields,
         nav.searchParams,
         layoutFieldNames(synthScreen),
+        undefined,
+        initialOverrides,
       ) as FormValues,
-    [screen.fields, nav.searchParams, synthScreen],
+    [screen.fields, nav.searchParams, synthScreen, initialOverrides],
   );
   const handleSubmitted = useCallback(
     (result: SubmitResult<unknown>) => {

package/src/app/row-actions.ts

@@ -1,6 +1,7 @@
 import type {
   IconKey,
   RowAction,
+  RowActionDrawer,
   RowActionNavigate,
   RowActionWriteHandler,
   RowFieldExtractor,
@@ -134,6 +135,51 @@ export function runProjectionRowNavigate(
   }
 }
 
+function buildNavigateRowAction(
+  action: RowActionNavigate,
+  translate: Translate,
+  nav: NavApi,
+): DataTableRowAction {
+  const { visible } = action;
+  const actionIcon = resolveActionIcon(action.id, action.icon);
+  return {
+    id: action.id,
+    label: translate(action.label),
+    ...(action.style !== undefined && { style: action.style }),
+    ...(actionIcon !== undefined && { icon: actionIcon }),
+    onTrigger: (row: ListRowViewModel) => runProjectionRowNavigate(nav, action, row),
+    ...(visible !== undefined && {
+      isVisible: (row: ListRowViewModel) => evalFieldCondition(visible, row.values),
+    }),
+  };
+}
+
+type OpenDrawer = (
+  action: RowActionDrawer,
+  initialValues: Readonly<Record<string, unknown>> | undefined,
+) => void;
+
+function buildDrawerRowAction(
+  action: RowActionDrawer,
+  translate: Translate,
+  openDrawer: OpenDrawer,
+): DataTableRowAction {
+  const { visible, params } = action;
+  const actionIcon = resolveActionIcon(action.id, action.icon);
+  return {
+    id: action.id,
+    label: translate(action.label),
+    ...(action.style !== undefined && { style: action.style }),
+    ...(actionIcon !== undefined && { icon: actionIcon }),
+    onTrigger: (row: ListRowViewModel) => {
+      openDrawer(action, params !== undefined ? evalRowExtractor(params, row.values) : undefined);
+    },
+    ...(visible !== undefined && {
+      isVisible: (row: ListRowViewModel) => evalFieldCondition(visible, row.values),
+    }),
+  };
+}
+
 // Builds the DataTable-ready row-action set for a query-driven row source
 // (projectionList, relatedList) — navigate dispatches through
 // runProjectionRowNavigate, writeHandler dispatches through the shared
@@ -146,25 +192,22 @@ export function buildProjectionRowActions(options: {
   readonly dispatcher: Dispatcher | undefined;
   readonly nav: NavApi;
   readonly refetch: () => Promise<unknown>;
+  /** Opens the drawer-kind action's target actionForm, prefilled from the
+   *  clicked row. Omitted callers (none today) simply drop drawer actions —
+   *  mirrors the `dispatcher === undefined` skip below for writeHandler. */
+  readonly openDrawer?: OpenDrawer;
 }): readonly DataTableRowAction[] | undefined {
-  const { rowActions, translate, dispatcher, nav, refetch } = options;
+  const { rowActions, translate, dispatcher, nav, refetch, openDrawer } = options;
   if (rowActions === undefined) return undefined;
   const out: DataTableRowAction[] = [];
   for (const action of rowActions) {
     if (action.kind === "navigate") {
-      const navigateAction = action;
-      const visible = action.visible;
-      const actionIcon = resolveActionIcon(action.id, action.icon);
-      out.push({
-        id: action.id,
-        label: translate(action.label),
-        ...(action.style !== undefined && { style: action.style }),
-        ...(actionIcon !== undefined && { icon: actionIcon }),
-        onTrigger: (row: ListRowViewModel) => runProjectionRowNavigate(nav, navigateAction, row),
-        ...(visible !== undefined && {
-          isVisible: (row: ListRowViewModel) => evalFieldCondition(visible, row.values),
-        }),
-      });
+      out.push(buildNavigateRowAction(action, translate, nav));
+      continue;
+    }
+    if (action.kind === "drawer") {
+      if (openDrawer === undefined) continue;
+      out.push(buildDrawerRowAction(action, translate, openDrawer));
       continue;
     }
     // writeHandler (default-kind) — a swallowed failure result must become a

package/src/components/__tests__/related-list-section.test.tsx

@@ -237,3 +237,80 @@ describe("RelatedListSection — rowActions", () => {
     expect(rtlScreen.queryByTestId("action-end-item-ended-1")).toBeNull();
   });
 });
+
+// RelatedListSection never renders the Drawer itself (require-cycle with
+// kumiko-screen.tsx, which owns the shared Drawer state) — it only forwards
+// a drawer-kind rowAction to the injected `onOpenDrawer` callback. This
+// pins that hand-off, not the Drawer UI itself (covered by kumiko-screen's
+// own tests).
+describe("RelatedListSection — rowActions drawer-kind (fw#2710)", () => {
+  test("clicking a drawer rowAction calls onOpenDrawer with the action and the row's extracted values", async () => {
+    const { dispatcher } = stubDispatcher([{ id: "item-7", name: "Rent 2024", amount: 1200 }]);
+    const openDrawerCalls: unknown[][] = [];
+    render(
+      <LocaleProvider
+        resolver={createStaticLocaleResolver({ locale: "en-US" })}
+        fallbackBundles={[kumikoDefaultTranslations]}
+      >
+        <DispatcherProvider dispatcher={dispatcher}>
+          <PrimitivesProvider value={testPrimitives()}>
+            <NavProvider value={stubNav().nav}>
+              <RelatedListSection
+                section={{
+                  kind: "relatedList",
+                  title: "Positions",
+                  query: "lease:query:items:list",
+                  columns: [{ field: "name" }],
+                  rowActions: [
+                    {
+                      kind: "drawer",
+                      id: "adjust-rent",
+                      label: "actions.adjustRent",
+                      screen: "adjust-rent-form",
+                      params: { map: { itemId: "id", currentAmount: "amount" } },
+                    },
+                  ],
+                }}
+                parentId="order-1"
+                featureName="orders"
+                onOpenDrawer={(action, initialValues) =>
+                  openDrawerCalls.push([action, initialValues])
+                }
+              />
+            </NavProvider>
+          </PrimitivesProvider>
+        </DispatcherProvider>
+      </LocaleProvider>,
+    );
+
+    await waitFor(() => expect(rtlScreen.getByTestId("row-item-7")).toBeTruthy());
+    rtlScreen.getByTestId("action-adjust-rent-item-7").click();
+
+    await waitFor(() => expect(openDrawerCalls).toHaveLength(1));
+    const call = openDrawerCalls[0];
+    if (call === undefined) throw new Error("expected onOpenDrawer to have been called");
+    expect((call[0] as { readonly id: string }).id).toBe("adjust-rent");
+    expect(call[1]).toEqual({ itemId: "item-7", currentAmount: 1200 });
+  });
+
+  test("a drawer rowAction is dropped (not rendered) when no onOpenDrawer is wired", async () => {
+    const { dispatcher } = stubDispatcher([{ id: "item-7", name: "Rent 2024", amount: 1200 }]);
+    renderRelatedList(dispatcher, {
+      kind: "relatedList",
+      title: "Positions",
+      query: "lease:query:items:list",
+      columns: [{ field: "name" }],
+      rowActions: [
+        {
+          kind: "drawer",
+          id: "adjust-rent",
+          label: "actions.adjustRent",
+          screen: "adjust-rent-form",
+        },
+      ],
+    });
+
+    await waitFor(() => expect(rtlScreen.getByTestId("row-item-7")).toBeTruthy());
+    expect(rtlScreen.queryByTestId("action-adjust-rent-item-7")).toBeNull();
+  });
+});

package/src/components/related-list-section.tsx

@@ -1,6 +1,7 @@
 import type {
   EntityDefinition,
   EntityListScreenDefinition,
+  RowActionDrawer,
   RowActionNavigate,
 } from "@cosmicdrift/kumiko-framework/ui-types";
 import { normalizeListColumn } from "@cosmicdrift/kumiko-framework/ui-types";
@@ -53,12 +54,20 @@ export function RelatedListSection({
   featureName,
   translate,
   hideTitle,
+  onOpenDrawer,
 }: {
   readonly section: EditRelatedListSectionViewModel;
   readonly parentId: string;
   readonly featureName: string;
   readonly translate?: Translate;
   readonly hideTitle?: boolean;
+  /** Opens a drawer-kind rowAction (fw#2710). Supplied by the parent
+   *  (ProjectionDetailBody), which owns schema + the actual Drawer render —
+   *  this component only ever invokes the callback. */
+  readonly onOpenDrawer?: (
+    action: RowActionDrawer,
+    initialValues: Readonly<Record<string, unknown>> | undefined,
+  ) => void;
 }): ReactNode {
   const { Banner, Section } = usePrimitives();
   const t = useTranslation();
@@ -121,8 +130,9 @@ export function RelatedListSection({
         dispatcher,
         nav,
         refetch: rowsQuery.refetch,
+        openDrawer: onOpenDrawer,
       }),
-    [section.rowActions, effectiveTranslate, dispatcher, nav, rowsQuery.refetch],
+    [section.rowActions, effectiveTranslate, dispatcher, nav, rowsQuery.refetch, onOpenDrawer],
   );
   const rowActionMode = rowActionModeFor(rowActions);
 

package/src/components/render-edit-types.ts

@@ -2,6 +2,7 @@ import type {
   EntityDefinition,
   EntityEditScreenDefinition,
   IconKey,
+  RowActionDrawer,
 } from "@cosmicdrift/kumiko-framework/ui-types";
 import type {
   FormSnapshot,
@@ -60,6 +61,16 @@ export type RenderEditProps<TValues extends FormValues, TCtx = unknown> = {
    *  same split as `onCopyLink`) — RenderEdit only wires the button, its
    *  busy state and its confirm dialog. */
   readonly actions?: readonly RenderEditAction[];
+  /** Opens a relatedList section row's drawer-kind action (fw#2710).
+   *  RenderEdit has no `schema` to resolve the target actionForm itself —
+   *  the caller (ProjectionDetailBody, which does have schema) supplies the
+   *  opener and owns the actual Drawer state/rendering. Only projectionDetail
+   *  passes this — the boot validator rejects relatedList sections on every
+   *  other screen type that shares this layout. */
+  readonly onRelatedListDrawerAction?: (
+    action: RowActionDrawer,
+    initialValues: Readonly<Record<string, unknown>> | undefined,
+  ) => void;
   /** i18n key for the submit button. Default: "kumiko.actions.save".
    *  Action forms (tier 2.7d) pass their screen.submitLabel here so that
    *  "Save" can be replaced by domain-specific strings ("Approve" /

package/src/components/render-edit.tsx

@@ -210,6 +210,7 @@ export function RenderEdit<TValues extends FormValues, TCtx = unknown>(
     onReload,
     onCopyLink,
     actions,
+    onRelatedListDrawerAction,
     submitLabel,
     labelAppendix,
     fieldAppendix,
@@ -1209,6 +1210,9 @@ export function RenderEdit<TValues extends FormValues, TCtx = unknown>(
                 featureName={featureName}
                 translate={translate}
                 hideTitle={hideSectionTitles}
+                {...(onRelatedListDrawerAction !== undefined && {
+                  onOpenDrawer: onRelatedListDrawerAction,
+                })}
               />
             );
           }