@cosmicdrift/kumiko-renderer 0.335.0 → 0.336.0

package/dist/app/extension-sections.d.ts

@@ -57,9 +57,9 @@ export type ExtensionSectionProps = {
     };
     /** Only set for extension steps of a `layout.mode: "wizard"` entityEdit
      *  editing an existing record (update mode); undefined everywhere else.
-     *  Call it (typically from an effect) with whether the step already holds
-     *  its data, so the step bar shows the step as done. Repeated calls with
-     *  the same value are cheap. */
+     *  Report through `useReportStepComplete(reportStepComplete, complete)`
+     *  (`null` while the step's data loads) with whether the step already holds
+     *  its data, so the step bar shows the step as done. */
     readonly reportStepComplete?: (complete: boolean) => void;
 };
 export type ExtensionSectionComponent = ComponentType<ExtensionSectionProps>;

package/dist/components/render-edit.js

@@ -14,7 +14,7 @@ import { useForm } from "../hooks/use-form.js";
 import { useTranslation } from "../i18n.js";
 import { useInsideDrawer } from "../inside-drawer.js";
 import { usePageHeaderCompact, usePageHeaderSlotAvailable } from "../page-header-slot.js";
-import { STICKY_PRIMARY_ACTION_PROP, shouldRenderActionsIconOnly, usePrimitives, } from "../primitives.js";
+import { FOOTER_ACTION_ROLE_PROP, NARROW_LABEL_PROP, STICKY_PRIMARY_ACTION_PROP, shouldRenderActionsIconOnly, usePrimitives, } from "../primitives.js";
 import { GridCellForField } from "./grid-cell-for-field.js";
 import { RelatedListSection } from "./related-list-section.js";
 import { filterEditSections, hasEditableSection, hasIssueWithoutRenderedField, resolveExtensionEntityId, shouldNotifyCaller, } from "./render-edit-logic.js";
@@ -1107,7 +1107,8 @@ export function RenderEdit(props) {
                 ? 1
                 : 0;
     const isSettingsList = screen.layout.variant === "settings-list" && hideSectionTitles !== true;
-    const formActions = (_jsxs(_Fragment, { children: [showWizardBack && (_jsx(Button, { type: "button", variant: "secondary", icon: "chevron-left", onClick: handleWizardBack, testId: "render-edit-wizard-back", children: translate("kumiko.actions.back") })), footerSlot !== undefined && (_jsx(EditSlotMount, { slot: footerSlot, slotName: "footer", screenId: screen.id, entityName: vm.entityName, entityId: resolveExtensionEntityId(entityIdProp, vm.id), values: snapshot.values, hasUnsavedChanges: hasUnsavedInput, wizardStep: isWizard ? { index: currentStep, isLast: isLastWizardStep } : undefined, ...(screen.slots?.footerPrimary === true && { [STICKY_PRIMARY_ACTION_PROP]: true }) })), isWizard && !isLastWizardStep && showsSubmit && !isCreateMode && (_jsx(Button, { type: "button", variant: "ghost", disabled: isSubmitting || disabled, onClick: () => void handleSubmit({ saveNow: true }), testId: "render-edit-wizard-save-close", [STICKY_PRIMARY_ACTION_PROP]: true, children: translate("kumiko.wizard.save-and-close") })), showWizardNext && (_jsx(Button, { type: "submit", variant: "primary", iconEnd: "chevron-right", testId: "render-edit-wizard-next", children: nextStepTitle !== undefined
+    const formActions = (_jsxs(_Fragment, { children: [showWizardBack && (_jsx(Button, { type: "button", variant: "secondary", icon: "chevron-left", onClick: handleWizardBack, testId: "render-edit-wizard-back", [FOOTER_ACTION_ROLE_PROP]: "back", children: translate("kumiko.actions.back") })), footerSlot !== undefined && (_jsx(EditSlotMount, { slot: footerSlot, slotName: "footer", screenId: screen.id, entityName: vm.entityName, entityId: resolveExtensionEntityId(entityIdProp, vm.id), values: snapshot.values, hasUnsavedChanges: hasUnsavedInput, wizardStep: isWizard ? { index: currentStep, isLast: isLastWizardStep } : undefined, ...(screen.slots?.footerPrimary === true && { [STICKY_PRIMARY_ACTION_PROP]: true }) })), isWizard && !isLastWizardStep && showsSubmit && !isCreateMode && (_jsx(Button, { type: "button", variant: "ghost", disabled: isSubmitting || disabled, onClick: () => void handleSubmit({ saveNow: true }), testId: "render-edit-wizard-save-close", [STICKY_PRIMARY_ACTION_PROP]: true, children: translate("kumiko.wizard.save-and-close") })), showWizardNext && (_jsx(Button, { type: "submit", variant: "primary", iconEnd: "chevron-right", testId: "render-edit-wizard-next", [FOOTER_ACTION_ROLE_PROP]: "primary",
+                [NARROW_LABEL_PROP]: translate("kumiko.actions.next"), children: nextStepTitle !== undefined
                     ? translate("kumiko.wizard.next-with-title", { title: nextStepTitle })
                     : translate("kumiko.actions.next") })), showSubmit &&
                 footerActions?.map((action) => (_jsx(Button, { type: "button", variant: action.variant ?? "secondary", ...(action.icon !== undefined && { icon: action.icon }), disabled: isSubmitting || disabled, onClick: () => {

package/dist/hooks/use-report-step-complete.d.ts

@@ -0,0 +1,2 @@
+import type { ExtensionSectionProps } from "../app/extension-sections.js";
+export declare function useReportStepComplete(reportStepComplete: ExtensionSectionProps["reportStepComplete"], complete: boolean | null): void;

package/dist/hooks/use-report-step-complete.js

@@ -0,0 +1,13 @@
+import { useEffect } from "react";
+// Lets an extension wizard step report whether it already holds its data
+// without a raw useEffect in app code (the no-raw-hooks guard forbids those).
+// `complete === null` means the step's data is still loading: nothing is
+// reported, so a loading step never flashes "not done" over a passed-via-Next
+// state. Outside update-mode wizards `reportStepComplete` is undefined and the
+// hook does nothing.
+export function useReportStepComplete(reportStepComplete, complete) {
+    useEffect(() => {
+        if (reportStepComplete !== undefined && complete !== null)
+            reportStepComplete(complete);
+    }, [reportStepComplete, complete]);
+}

package/dist/index.d.ts

@@ -61,6 +61,7 @@ export type { UseMutationResult } from "./hooks/use-mutation.js";
 export { useMutation } from "./hooks/use-mutation.js";
 export type { UseQueryOptions, UseQueryResult } from "./hooks/use-query.js";
 export { entityFromQueryType, useQuery } from "./hooks/use-query.js";
+export { useReportStepComplete } from "./hooks/use-report-step-complete.js";
 export { useStore, useStoreSelector } from "./hooks/use-store.js";
 export type { StreamStatus, UseStreamHandlerOptions, UseStreamHandlerResult, } from "./hooks/use-stream-handler.js";
 export { useStreamHandler } from "./hooks/use-stream-handler.js";
@@ -69,8 +70,8 @@ export { createStaticLocaleResolver, FormalityProvider, LocaleProvider, mergeTra
 export { kumikoDefaultTranslations } from "./i18n-defaults.js";
 export { InsideDrawerProvider, useInsideDrawer } from "./inside-drawer.js";
 export { PageHeaderCompactProvider, PageHeaderSlotAvailableProvider, usePageHeaderCompact, usePageHeaderSlotAvailable, } from "./page-header-slot.js";
-export type { ActionMenuItemSpec, ActionOverflowMenuProps, AppPrimitives, BannerProps, ButtonProps, CardOptions, CardProps, CardSlots, CopyButtonProps, CorePrimitives, DataTableDateRangeFacet, DataTableFacet, DataTableFacetChip, DataTableProps, DataTableRowAction, DataTableRowActionMode, DataTableRowGrouping, DataTableSort, DataTableSortDir, DialogProps, DrawerProps, EmbeddedListCellType, EmbeddedListColumn, EmbeddedListInputProps, EmbeddedListTotal, FieldCellWidth, FieldProps, FillContainerProps, FormProps, FormSectionNavItem, FormWidth, GridCellProps, GridProps, HeadingProps, InputProps, JsonViewProps, LightboxProps, LinkProps, MetricBandProps, MetricProps, ModalProps, PageHeaderProps, PrimitivesProviderProps, PrimitivesRegistry, ProgressProps, ProgressTone, PromoPanelAction, PromoPanelProps, RuntimeRenderer, SecretRevealProps, SecretRevealValue, SectionProps, ShareButtonProps, StatusBadgeProps, StatusTone, StepBarProps, StickyActionBarProps, StickyPrimaryActionMarker, TabsProps, TextProps, TrailingInputAction, WizardStepGroupProps, } from "./primitives.js";
-export { PrimitivesProvider, STICKY_PRIMARY_ACTION_PROP, shouldRenderActionsIconOnly, statusToneForOptionTone, statusToneForValue, usePrimitives, } from "./primitives.js";
+export type { ActionMenuItemSpec, ActionOverflowMenuProps, AppPrimitives, BannerProps, ButtonProps, CardOptions, CardProps, CardSlots, CopyButtonProps, CorePrimitives, DataTableDateRangeFacet, DataTableFacet, DataTableFacetChip, DataTableProps, DataTableRowAction, DataTableRowActionMode, DataTableRowGrouping, DataTableSort, DataTableSortDir, DialogProps, DrawerProps, EmbeddedListCellType, EmbeddedListColumn, EmbeddedListInputProps, EmbeddedListTotal, FieldCellWidth, FieldProps, FillContainerProps, FooterActionMarker, FooterActionRole, FormProps, FormSectionNavItem, FormWidth, GridCellProps, GridProps, HeadingProps, InputProps, JsonViewProps, LightboxProps, LinkProps, MetricBandProps, MetricProps, ModalProps, PageHeaderProps, PrimitivesProviderProps, PrimitivesRegistry, ProgressProps, ProgressTone, PromoPanelAction, PromoPanelProps, RuntimeRenderer, SecretRevealProps, SecretRevealValue, SectionProps, ShareButtonProps, StatusBadgeProps, StatusTone, StepBarProps, StickyActionBarProps, StickyPrimaryActionMarker, TabsProps, TextProps, TrailingInputAction, WizardStepGroupProps, } from "./primitives.js";
+export { FOOTER_ACTION_ROLE_PROP, NARROW_LABEL_PROP, PrimitivesProvider, STICKY_PRIMARY_ACTION_PROP, shouldRenderActionsIconOnly, statusToneForOptionTone, statusToneForValue, usePrimitives, } from "./primitives.js";
 export type { SessionEndedSignal, SessionEndedSignalProviderProps, } from "./session/session-ended.js";
 export { createSessionEndedSignal, isSessionEndedError, SESSION_ENDED_ERROR_CODES, SessionEndedSignalProvider, useSessionEndedSignal, withSessionEndedDetection, } from "./session/session-ended.js";
 export { buildWhatsAppShareUrl } from "./share-links.js";

package/dist/index.js

@@ -44,13 +44,14 @@ export { useForm } from "./hooks/use-form.js";
 export { useListUrlState } from "./hooks/use-list-url-state.js";
 export { useMutation } from "./hooks/use-mutation.js";
 export { entityFromQueryType, useQuery } from "./hooks/use-query.js";
+export { useReportStepComplete } from "./hooks/use-report-step-complete.js";
 export { useStore, useStoreSelector } from "./hooks/use-store.js";
 export { useStreamHandler } from "./hooks/use-stream-handler.js";
 export { createStaticLocaleResolver, FormalityProvider, LocaleProvider, mergeTranslations, translationsByLocaleFromKeys, useFormality, useLocale, useOptionalLocale, useOptionalTranslation, useTranslation, } from "./i18n.js";
 export { kumikoDefaultTranslations } from "./i18n-defaults.js";
 export { InsideDrawerProvider, useInsideDrawer } from "./inside-drawer.js";
 export { PageHeaderCompactProvider, PageHeaderSlotAvailableProvider, usePageHeaderCompact, usePageHeaderSlotAvailable, } from "./page-header-slot.js";
-export { PrimitivesProvider, STICKY_PRIMARY_ACTION_PROP, shouldRenderActionsIconOnly, statusToneForOptionTone, statusToneForValue, usePrimitives, } from "./primitives.js";
+export { FOOTER_ACTION_ROLE_PROP, NARROW_LABEL_PROP, PrimitivesProvider, STICKY_PRIMARY_ACTION_PROP, shouldRenderActionsIconOnly, statusToneForOptionTone, statusToneForValue, usePrimitives, } from "./primitives.js";
 export { createSessionEndedSignal, isSessionEndedError, SESSION_ENDED_ERROR_CODES, SessionEndedSignalProvider, useSessionEndedSignal, withSessionEndedDetection, } from "./session/session-ended.js";
 export { buildWhatsAppShareUrl } from "./share-links.js";
 export { sortByAccessor } from "./sort-by-accessor.js";

package/dist/primitives.d.ts

@@ -14,6 +14,16 @@ export type DataAttributes = Readonly<Record<`data-${string}`, string>>;
  *  split can't inspect (see `ScreenSlots.footerPrimary`). */
 export declare const STICKY_PRIMARY_ACTION_PROP: "kumikoStickyPrimaryAction";
 export type StickyPrimaryActionMarker = Partial<Record<typeof STICKY_PRIMARY_ACTION_PROP, boolean>>;
+export type FooterActionRole = "back" | "primary";
+/** Tells the pinned phone footer which node is Back and which is the primary
+ *  action, for buttons that are not `type="submit"` (e.g. the wizard Back). */
+export declare const FOOTER_ACTION_ROLE_PROP: "kumikoFooterActionRole";
+/** Short label a footer action uses instead of its children below `sm`. */
+export declare const NARROW_LABEL_PROP: "kumikoNarrowLabel";
+export type FooterActionMarker = {
+    readonly [FOOTER_ACTION_ROLE_PROP]?: FooterActionRole;
+    readonly [NARROW_LABEL_PROP]?: string;
+};
 /** 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-
@@ -1157,7 +1167,9 @@ export type ProgressProps = {
  *  buttons (every non-current step with `selectableSteps: "all"`); the caller
  *  owns the validation gate for forward jumps. Implementations render a
  *  narrow-viewport fallback showing `compactLabel` instead (caller
- *  supplies it pre-translated, e.g. "Step 2 of 5 · Industry") — which of
+ *  supplies it pre-translated, e.g. "Step 2 of 5 · Industry"). With
+ *  `onStepSelect` and `selectableSteps: "all"` that fallback is a dropdown
+ *  listing all steps so narrow viewports can jump too — which of
  *  the two is visible is a responsive layout choice owned by the
  *  implementation, not this contract. */
 export type StepBarProps = {
@@ -1169,7 +1181,8 @@ export type StepBarProps = {
      *  index is below `currentIndex`. The current step is never done. */
     readonly doneSteps?: readonly boolean[];
     /** "done" (default): only done steps are jump targets. "all": every
-     *  non-current step is, when `onStepSelect` is set. */
+     *  non-current step is, when `onStepSelect` is set; the compact label then
+     *  becomes a step picker. */
     readonly selectableSteps?: "done" | "all";
     /** "label" (default) swaps the step row for `compactLabel` on narrow
      *  viewports; "steps" keeps the row there too — for short wizards whose

package/dist/primitives.js

@@ -6,6 +6,11 @@ import { createContext, useContext, } from "react";
  *  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";
+/** Tells the pinned phone footer which node is Back and which is the primary
+ *  action, for buttons that are not `type="submit"` (e.g. the wizard Back). */
+export const FOOTER_ACTION_ROLE_PROP = "kumikoFooterActionRole";
+/** Short label a footer action uses instead of its children below `sm`. */
+export const NARROW_LABEL_PROP = "kumikoNarrowLabel";
 /** Teil-C action-icon collapse rule: a group of more than two actions where
  *  every member carries an icon renders icon-only instead of wall-to-wall
  *  text buttons; any icon-less member keeps the whole group on text so it

package/dist/sse/live-events.d.ts

@@ -4,8 +4,8 @@ export type LiveEvent = {
     readonly data: {
         readonly id: string;
         readonly aggregateType: string;
+        readonly eventType: string;
         readonly version: number;
-        readonly payload: unknown;
         readonly createdAt: string;
     };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer",
-  "version": "0.335.0",
+  "version": "0.336.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.335.0",
-    "@cosmicdrift/kumiko-headless": "0.335.0",
-    "@cosmicdrift/kumiko-types": "0.335.0",
+    "@cosmicdrift/kumiko-framework": "0.336.0",
+    "@cosmicdrift/kumiko-headless": "0.336.0",
+    "@cosmicdrift/kumiko-types": "0.336.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.335.0"
+    "@cosmicdrift/kumiko-locale-de": "0.336.0"
   },
   "repository": {
     "type": "git",

package/src/changes.json

@@ -1,4 +1,18 @@
 [
+  {
+    "version": "0.336.0",
+    "type": "breaking",
+    "title": "LiveEvent data has no payload, it carries eventType",
+    "detail": "`LiveEvent.data` is now `{ id, aggregateType, eventType, version, createdAt }`. The server sends signals only, so consumers refetch through a query.",
+    "migration": "Replace reads of `event.data.payload` with a query refetch. `useQuery({ live: true })` already does this and needs no change."
+  },
+  {
+    "version": "0.336.0",
+    "type": "improvement",
+    "title": "useReportStepComplete reports an extension wizard step's completeness without a raw useEffect",
+    "detail": "`useReportStepComplete(props.reportStepComplete, complete)` with `complete: boolean | null`. `null` reports nothing (data loading), a boolean is reported whenever it changes. Outside update-mode wizards `reportStepComplete` is undefined and the hook does nothing.",
+    "migration": "Extension steps that call `reportStepComplete` from a `useEffect` should switch to `useReportStepComplete(reportStepComplete, complete)`; app repos need this to pass the no-raw-hooks guard."
+  },
   {
     "version": "0.335.0",
     "type": "fix",