@cosmicdrift/kumiko-renderer 0.315.0 → 0.317.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer",
-  "version": "0.315.0",
+  "version": "0.317.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,9 +15,9 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.315.0",
-    "@cosmicdrift/kumiko-headless": "0.315.0",
-    "@cosmicdrift/kumiko-types": "0.315.0",
+    "@cosmicdrift/kumiko-framework": "0.317.0",
+    "@cosmicdrift/kumiko-headless": "0.317.0",
+    "@cosmicdrift/kumiko-types": "0.317.0",
     "react": "^19.2.6",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3"
@@ -28,7 +28,7 @@
     "@types/react-dom": "^19.2.3",
     "jsdom": "^29.1.1",
     "react-dom": "^19.2.6",
-    "@cosmicdrift/kumiko-locale-de": "0.315.0"
+    "@cosmicdrift/kumiko-locale-de": "0.317.0"
   },
   "repository": {
     "type": "git",

package/src/changes.json

@@ -1,4 +1,11 @@
 [
+  {
+    "version": "0.316.0",
+    "type": "fix",
+    "title": "An app footer-slot action can opt into the wizard's sticky primary group",
+    "detail": "fw#1918 pinned the primary action into a sticky footer on mobile by checking\neach form-action element's `type === \"submit\"` prop. An app's\n`screen.slots.footer` renders through EditSlotMount, which never carries\n`type=\"submit\"` (its button is opaque app code), so that slot always landed\nin the non-sticky secondary group even on a wizard's last step — regressing\napps like offlot-app whose wizard-final \"Publish\" action lives in the footer\nslot. `ScreenSlots.footerPrimary?: boolean` now marks that slot as the\nsticky-primary action; `FormFooter` in kumiko-renderer-web recognizes it via\nthe shared `STICKY_PRIMARY_ACTION_PROP` marker exported from kumiko-renderer.\nBuilt-in submit buttons are unaffected.",
+    "migration": "Additive — no action needed unless a footer-slot action must become the\nsticky primary action on mobile. Set `slots.footerPrimary: true` next to\nthat screen's `slots.footer` registration to opt in."
+  },
   {
     "version": "0.310.0",
     "type": "improvement",

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

@@ -1212,8 +1212,8 @@ describe("RelatedListSection — search + facets (fw#2740)", () => {
       },
       { timeout: 2000 },
     );
-    await waitFor(() => expect(rtlScreen.getByTestId("row-r1")).toBeTruthy());
-    expect(rtlScreen.queryByTestId("row-r2")).toBeNull();
+    await waitFor(() => expect(rtlScreen.queryByTestId("row-r2")).toBeNull());
+    expect(rtlScreen.getByTestId("row-r1")).toBeTruthy();
   });
 
   test("without searchable, RenderList shows no search input and no payload ever carries a search key", async () => {
@@ -1266,8 +1266,8 @@ describe("RelatedListSection — search + facets (fw#2740)", () => {
       },
       { timeout: 2000 },
     );
-    await waitFor(() => expect(rtlScreen.getByTestId("row-r1")).toBeTruthy());
-    expect(rtlScreen.queryByTestId("row-r2")).toBeNull();
+    await waitFor(() => expect(rtlScreen.queryByTestId("row-r2")).toBeNull());
+    expect(rtlScreen.getByTestId("row-r1")).toBeTruthy();
   });
 
   const statusSection: EditRelatedListSectionViewModel = {
@@ -1463,8 +1463,8 @@ describe("RelatedListSection — parentFilter", () => {
     );
     const last = payloads[payloads.length - 1];
     expect(last?.["filter"]).toEqual({ field: "parentId", op: "eq", value: "order-1" });
-    await waitFor(() => expect(rtlScreen.getByTestId("row-r1")).toBeTruthy());
-    expect(rtlScreen.queryByTestId("row-r2")).toBeNull();
+    await waitFor(() => expect(rtlScreen.queryByTestId("row-r2")).toBeNull());
+    expect(rtlScreen.getByTestId("row-r1")).toBeTruthy();
   });
 
   test("selecting a facet leaves payload.filter unchanged and adds payload.filters", async () => {

package/src/components/render-edit.tsx

@@ -37,7 +37,12 @@ import { useDraftStorage } from "../context/draft-storage-context";
 import { formatWhen } from "../format-when";
 import { useForm } from "../hooks/use-form";
 import { useTranslation } from "../i18n";
-import { shouldRenderActionsIconOnly, usePrimitives } from "../primitives";
+import {
+  STICKY_PRIMARY_ACTION_PROP,
+  type StickyPrimaryActionMarker,
+  shouldRenderActionsIconOnly,
+  usePrimitives,
+} from "../primitives";
 import { GridCellForField } from "./grid-cell-for-field";
 import { RelatedListSection } from "./related-list-section";
 import {
@@ -253,7 +258,7 @@ function EditSlotMount({
   readonly values: Readonly<Record<string, unknown>>;
   readonly hasUnsavedChanges?: boolean;
   readonly wizardStep?: { readonly index: number; readonly isLast: boolean };
-}): ReactNode {
+} & StickyPrimaryActionMarker): ReactNode {
   const name = extensionSectionName(slot);
   const Component = useExtensionSectionComponent(name);
   useEffect(() => {
@@ -1199,6 +1204,7 @@ export function RenderEdit<TValues extends FormValues, TCtx = unknown>(
           values={snapshot.values}
           hasUnsavedChanges={snapshot.isDirty || extensionDirty}
           wizardStep={isWizard ? { index: currentStep, isLast: isLastWizardStep } : undefined}
+          {...(screen.slots?.footerPrimary === true && { [STICKY_PRIMARY_ACTION_PROP]: true })}
         />
       )}
       {isWizard && !isLastWizardStep && (

package/src/index.ts

@@ -231,12 +231,14 @@ export type {
   StatusBadgeProps,
   StatusTone,
   StepBarProps,
+  StickyPrimaryActionMarker,
   TabsProps,
   TextProps,
   WizardStepGroupProps,
 } from "./primitives";
 export {
   PrimitivesProvider,
+  STICKY_PRIMARY_ACTION_PROP,
   shouldRenderActionsIconOnly,
   statusToneForValue,
   usePrimitives,

package/src/primitives.tsx

@@ -66,6 +66,15 @@ export type { RuntimeRenderer };
  *  element; native impls ignore it (precedent: `className`). */
 export type DataAttributes = Readonly<Record<`data-${string}`, string>>;
 
+/** Structural marker a top-level `actions` node can carry so DefaultForm's
+ *  sticky-footer split (fw#1918) treats it as the pinned primary action even
+ *  though it isn't a `Button` with `type="submit"` — e.g. RenderEdit's
+ *  footer-slot mount, whose actual rendered button is opaque app code the
+ *  split can't inspect (see `ScreenSlots.footerPrimary`). */
+export const STICKY_PRIMARY_ACTION_PROP = "kumikoStickyPrimaryAction" as const;
+
+export type StickyPrimaryActionMarker = Partial<Record<typeof STICKY_PRIMARY_ACTION_PROP, boolean>>;
+
 /** Standard-Button. `loading` zeigt einen Spinner statt der Children
  *  und sollte mit `disabled` kombiniert werden, wenn die Action wirklich
  *  blockiert bis das Loading durch ist (z.B. async submit). Native-