@cosmicdrift/kumiko-renderer 0.334.0 → 0.336.0

package/dist/hooks/use-reference-lookup.d.ts

@@ -6,6 +6,13 @@ export declare function referenceLookupSource(refFeature: string, refEntity: str
     readonly queryQn: string;
     readonly labelKey: string;
 };
+export declare function referenceOptionSource(field: {
+    readonly refLabelField?: string;
+    readonly refOptionsQuery?: string;
+}, refFeature: string, refEntity: string): {
+    readonly queryQn: string;
+    readonly labelKey: string;
+};
 /** Empty while the query loads (or fails), so callers fall back to the raw id.
  *  `featureName` is the reference's target feature, not the screen's. */
 export declare function useReferenceLookup(featureName: string, refEntity: string, labelField: string): {

package/dist/hooks/use-reference-lookup.js

@@ -34,6 +34,16 @@ export function referenceLookupSource(refFeature, refEntity, labelField) {
         labelKey: labelField,
     };
 }
+// Where a reference field's option rows come from, and which of their keys
+// holds the display text — the entity's own list handler plus `refLabelField`
+// by default, or an author-supplied handler whose rows carry `label`
+// (fw#2780), for targets with no readable column of their own.
+export function referenceOptionSource(field, refFeature, refEntity) {
+    if (field.refOptionsQuery !== undefined) {
+        return { queryQn: field.refOptionsQuery, labelKey: "label" };
+    }
+    return referenceLookupSource(refFeature, refEntity, field.refLabelField ?? "id");
+}
 /** Empty while the query loads (or fails), so callers fall back to the raw id.
  *  `featureName` is the reference's target feature, not the screen's. */
 export function useReferenceLookup(featureName, refEntity, labelField) {

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/i18n.js

@@ -65,7 +65,8 @@ export function useLocale() {
     }
     // Subscribe + current locale-snapshot. Wir brauchen den Rückgabewert
     // selbst nicht — wichtig ist nur der re-render-trigger.
-    useSyncExternalStore(ctx.resolver.subscribe, () => ctx.resolver.locale(), () => ctx.resolver.locale());
+    const getLocaleSnapshot = () => ctx.resolver.locale();
+    useSyncExternalStore(ctx.resolver.subscribe, getLocaleSnapshot, getLocaleSnapshot);
     return ctx.resolver;
 }
 /** `t("key", params)` resolves in this order:
@@ -83,7 +84,8 @@ export function useTranslation() {
     // Re-Render bei Sprach-Wechsel. `ctx.resolver.subscribe` ist bereits
     // eine stable-reference aus dem Resolver, daher hier keine eigene
     // Memoization der Subscribe-Callback nötig.
-    const locale = useSyncExternalStore(ctx.resolver.subscribe, () => ctx.resolver.locale(), () => ctx.resolver.locale());
+    const getLocaleSnapshot = () => ctx.resolver.locale();
+    const locale = useSyncExternalStore(ctx.resolver.subscribe, getLocaleSnapshot, getLocaleSnapshot);
     // `t` MUSS referenz-stabil sein solange sich Resolver/Bundles/Locale
     // nicht ändern — Consumer nutzen `t` regelmäßig in useEffect-Deps
     // (z.B. um Queries neu zu laden wenn sich die Sprache ändert). Ein neu
@@ -132,7 +134,8 @@ function bundleLocaleTiers(locale, fallbackLocale, formality) {
  *  Used by DataTable FormatCell so plain tables without a provider do not crash. */
 export function useOptionalLocale() {
     const ctx = useContext(LocaleContext);
-    useSyncExternalStore((onStoreChange) => (ctx ? ctx.resolver.subscribe(onStoreChange) : () => { }), () => (ctx ? ctx.resolver.locale() : "en"), () => (ctx ? ctx.resolver.locale() : "en"));
+    const getLocaleSnapshot = () => (ctx ? ctx.resolver.locale() : "en");
+    useSyncExternalStore((onStoreChange) => (ctx ? ctx.resolver.subscribe(onStoreChange) : () => { }), getLocaleSnapshot, getLocaleSnapshot);
     return ctx === undefined ? undefined : ctx.resolver.locale();
 }
 /** Non-throwing time-zone read — "UTC" outside LocaleProvider, matching
@@ -144,7 +147,8 @@ export function useOptionalTimeZone() {
 /** Non-throwing translate — undefined outside LocaleProvider. */
 export function useOptionalTranslation() {
     const ctx = useContext(LocaleContext);
-    const locale = useSyncExternalStore((onStoreChange) => (ctx ? ctx.resolver.subscribe(onStoreChange) : () => { }), () => (ctx ? ctx.resolver.locale() : "en"), () => (ctx ? ctx.resolver.locale() : "en"));
+    const getLocaleSnapshot = () => (ctx ? ctx.resolver.locale() : "en");
+    const locale = useSyncExternalStore((onStoreChange) => (ctx ? ctx.resolver.subscribe(onStoreChange) : () => { }), getLocaleSnapshot, getLocaleSnapshot);
     const formality = useContext(FormalityContext);
     const t = useCallback((key, params) => ctx === undefined ? key : translateWithFallbacks(ctx, locale, formality, key, params), [ctx, locale, formality]);
     return ctx === undefined ? undefined : t;

package/dist/index.d.ts

@@ -35,6 +35,7 @@ export { dispatcherErrorText, WriteFailedError } from "./app/write-failed-error.
 export { RelatedListSection } from "./components/related-list-section.js";
 export type { RenderEditAction, RenderEditChangeState, RenderEditControls, RenderEditProps, } from "./components/render-edit.js";
 export { RenderEdit } from "./components/render-edit.js";
+export { needsActionConfirm } from "./components/render-edit-action-button.js";
 export type { RenderFieldProps } from "./components/render-field.js";
 export { RenderField } from "./components/render-field.js";
 export type { RenderListProps } from "./components/render-list.js";
@@ -60,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";
@@ -68,8 +70,10 @@ 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";
 export { sortByAccessor } from "./sort-by-accessor.js";
 export type { LiveEvent, LiveEventSubscriber, LiveEventsProviderProps } from "./sse/live-events.js";

package/dist/index.js

@@ -29,6 +29,7 @@ export { VariableChips } from "./app/variable-chips.js";
 export { dispatcherErrorText, WriteFailedError } from "./app/write-failed-error.js";
 export { RelatedListSection } from "./components/related-list-section.js";
 export { RenderEdit } from "./components/render-edit.js";
+export { needsActionConfirm } from "./components/render-edit-action-button.js";
 export { RenderField } from "./components/render-field.js";
 export { RenderList } from "./components/render-list.js";
 export { DispatcherProvider, useDispatcher, useDispatcherStatus, useOptionalDispatcher, } from "./context/dispatcher-context.js";
@@ -43,13 +44,15 @@ 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";
 export { LiveEventsProvider, useLiveEvents } from "./sse/live-events.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-
@@ -957,6 +967,10 @@ export type GridProps = {
     /** One full-width row per child, separated by hairlines — the field rows of
      *  a `settings-list` section. Wins over `columns`/`flow`. */
     readonly list?: boolean;
+    /** Id of the element naming this grid (a Field label). Turns the grid into
+     *  a `role="group"` so a Field whose control is a set of inputs (checkbox
+     *  group) still gives screen readers a group name. */
+    readonly ariaLabelledBy?: string;
 };
 /** Width class of a field cell inside a `flow` grid: sized by what the field holds. */
 export type FieldCellWidth = "text" | "number" | "money" | "date" | "timestamp" | "select" | "full" | "toggle";
@@ -1095,9 +1109,9 @@ export type CardSlots = {
     readonly header?: ReactNode;
     readonly title?: ReactNode;
     readonly subtitle?: ReactNode;
-    /** Free-form block content left of `headerActions`, below title/subtitle —
-     *  for a host-supplied header (projectionDetail `slots.header`) that must
-     *  share the action row instead of pushing actions into a row of their own. */
+    /** Free-form block content in its own full-width row below the
+     *  title/subtitle/`headerActions` row, within the same header block — for a
+     *  host-supplied header (projectionDetail `slots.header`). */
     readonly headerContent?: ReactNode;
     /** Rechtsbündiger Header-Slot (Range-Umschalter, Filter, Badge …). */
     readonly headerActions?: ReactNode;
@@ -1149,12 +1163,13 @@ export type ProgressProps = {
     readonly testId?: string;
 };
 /** Wizard step overview — numbered chips, one per step label, with the
- *  active step highlighted. With `onStepSelect`, completed steps (index
- *  below `currentIndex`) become buttons for going back; forward jumps stay
- *  impossible because step-jump validation is a separate concern
- *  (kumiko-framework#1966). Implementations render a
+ *  active step highlighted. With `onStepSelect`, completed steps become
+ *  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 = {
@@ -1162,6 +1177,13 @@ export type StepBarProps = {
     readonly currentIndex: number;
     readonly compactLabel: string;
     readonly onStepSelect?: (index: number) => void;
+    /** Explicit done state per step index. Absent: a step is done when its
+     *  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; 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
      *  labels fit a phone and whose done steps must stay tappable. */

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/session/session-ended.d.ts

@@ -0,0 +1,16 @@
+import type { Dispatcher, DispatcherError } from "@cosmicdrift/kumiko-headless";
+import { type ReactNode } from "react";
+export declare const SESSION_ENDED_ERROR_CODES: readonly ["session_invalid", "invalid_token", "missing_token", "unauthenticated"];
+export declare function isSessionEndedError(error: Pick<DispatcherError, "code" | "httpStatus">): boolean;
+export type SessionEndedSignal = {
+    notify(): void;
+    subscribe(listener: () => void): () => void;
+};
+export declare function createSessionEndedSignal(): SessionEndedSignal;
+export declare function withSessionEndedDetection(dispatcher: Dispatcher, signal: SessionEndedSignal): Dispatcher;
+export type SessionEndedSignalProviderProps = {
+    readonly signal: SessionEndedSignal;
+    readonly children: ReactNode;
+};
+export declare function SessionEndedSignalProvider({ signal, children, }: SessionEndedSignalProviderProps): ReactNode;
+export declare function useSessionEndedSignal(): SessionEndedSignal | undefined;

package/dist/session/session-ended.js

@@ -0,0 +1,73 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+// Only auth-layer 401s end a session. Handlers never throw 401 otherwise and
+// 403 means "authenticated but not allowed", which must not log the user out.
+export const SESSION_ENDED_ERROR_CODES = [
+    "session_invalid",
+    "invalid_token",
+    "missing_token",
+    "unauthenticated",
+];
+export function isSessionEndedError(error) {
+    return (error.httpStatus === 401 &&
+        SESSION_ENDED_ERROR_CODES.some((sessionEndedCode) => sessionEndedCode === error.code));
+}
+function isSessionEndedThrow(thrown) {
+    if (typeof thrown !== "object" || thrown === null)
+        return false;
+    if (!("code" in thrown) || !("httpStatus" in thrown))
+        return false;
+    const { code, httpStatus } = thrown;
+    return typeof code === "string" && typeof httpStatus === "number"
+        ? isSessionEndedError({ code, httpStatus })
+        : false;
+}
+export function createSessionEndedSignal() {
+    const listeners = new Set();
+    return {
+        notify() {
+            for (const listener of [...listeners])
+                listener();
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+    };
+}
+export function withSessionEndedDetection(dispatcher, signal) {
+    async function detect(pending) {
+        const result = await pending;
+        if (!result.isSuccess && result.error !== undefined && isSessionEndedError(result.error)) {
+            signal.notify();
+        }
+        return result;
+    }
+    return {
+        write: (type, payload, opts) => detect(dispatcher.write(type, payload, opts)),
+        query: (type, payload, opts) => detect(dispatcher.query(type, payload, opts)),
+        batch: (commands, opts) => detect(dispatcher.batch(commands, opts)),
+        async *stream(type, payload, opts) {
+            try {
+                yield* dispatcher.stream(type, payload, opts);
+            }
+            catch (thrown) {
+                if (isSessionEndedThrow(thrown))
+                    signal.notify();
+                throw thrown;
+            }
+        },
+        statusStore: dispatcher.statusStore,
+        pendingWrites: () => dispatcher.pendingWrites(),
+        pendingFiles: () => dispatcher.pendingFiles(),
+    };
+}
+const SessionEndedSignalContext = createContext(undefined);
+export function SessionEndedSignalProvider({ signal, children, }) {
+    return _jsx(SessionEndedSignalContext, { value: signal, children: children });
+}
+export function useSessionEndedSignal() {
+    return useContext(SessionEndedSignalContext);
+}

package/dist/sort-by-accessor.d.ts

@@ -1,5 +1,9 @@
 import type { DataTableSort } from "./primitives.js";
+type SortValue = string | number | null;
 /** Sorts `rows` by a `DataTableSort` against a field->accessor map. Unknown
  *  field or `sort === null` returns `rows` unchanged (no-op, not an error —
- *  callers pass whatever the DataTable reports). */
-export declare function sortByAccessor<TRow>(rows: readonly TRow[], sort: DataTableSort | null, accessors: Readonly<Record<string, (row: TRow) => string | number>>): readonly TRow[];
+ *  callers pass whatever the DataTable reports). `null` values sort last in
+ *  both directions; strings compare locale-aware with numeric collation, so
+ *  numeric strings (Postgres numeric/bigint) order by value. */
+export declare function sortByAccessor<TRow>(rows: readonly TRow[], sort: DataTableSort | null, accessors: Readonly<Record<string, (row: TRow) => SortValue>>, locale?: string): readonly TRow[];
+export {};

package/dist/sort-by-accessor.js

@@ -1,16 +1,26 @@
+function compareNonNull(a, b, collator) {
+    if (typeof a === "number" && typeof b === "number")
+        return a - b;
+    return collator.compare(String(a), String(b));
+}
 /** Sorts `rows` by a `DataTableSort` against a field->accessor map. Unknown
  *  field or `sort === null` returns `rows` unchanged (no-op, not an error —
- *  callers pass whatever the DataTable reports). */
-export function sortByAccessor(rows, sort, accessors) {
+ *  callers pass whatever the DataTable reports). `null` values sort last in
+ *  both directions; strings compare locale-aware with numeric collation, so
+ *  numeric strings (Postgres numeric/bigint) order by value. */
+export function sortByAccessor(rows, sort, accessors, locale) {
     if (sort === null)
         return rows;
     const accessor = accessors[sort.field];
     if (accessor === undefined)
         return rows;
     const factor = sort.dir === "asc" ? 1 : -1;
+    const collator = new Intl.Collator(locale, { numeric: true, sensitivity: "base" });
     return [...rows].sort((a, b) => {
         const av = accessor(a);
         const bv = accessor(b);
-        return av < bv ? -factor : av > bv ? factor : 0;
+        if (av === null || bv === null)
+            return av === bv ? 0 : av === null ? 1 : -1;
+        return factor * compareNonNull(av, bv, collator);
     });
 }

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.334.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.334.0",
-    "@cosmicdrift/kumiko-headless": "0.334.0",
-    "@cosmicdrift/kumiko-types": "0.334.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.334.0"
+    "@cosmicdrift/kumiko-locale-de": "0.336.0"
   },
   "repository": {
     "type": "git",

package/src/changes.json

@@ -1,4 +1,58 @@
 [
+  {
+    "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",
+    "title": "secretMint reveal and confirm render as one screen form with the translated screen title; new RenderEdit props leadContent and i18nScreenId"
+  },
+  {
+    "version": "0.335.0",
+    "type": "fix",
+    "title": "Router paths encode and decode each segment, so entity ids with slashes or spaces round-trip"
+  },
+  {
+    "version": "0.335.0",
+    "type": "fix",
+    "title": "Icon-only list and edit action buttons set a hover title"
+  },
+  {
+    "version": "0.335.0",
+    "type": "fix",
+    "title": "Secret delete confirmation, grouped-field conditions, scoped valid flag, tenant currency in reference-create dialog",
+    "detail": "Renderer review fixes. Deleting a secret on a secretsEdit screen now asks for confirmation first (new `config.secrets.deleteConfirm` key) and the delete button is disabled while a save or delete is running. The multiSelect checkbox group is exposed as a labelled group (`GridProps.ariaLabelledBy`). The inline reference-create dialog seeds `currency: { kind: \"tenant\" }` money fields from the tenant currency. Fields declared only inside a section `groups` entry now get their `visible`/`readOnly`/`required` conditions registered. `onChange`'s `valid` ignores issues on hidden fields and outside the `fields` scope, like submit does (shared `relevantFieldIssues` helper). Copy-link in the form footer keeps a 44px touch target on narrow viewports. A free-text sibling-field number unit longer than 8 characters is no longer rendered as a suffix."
+  },
+  {
+    "version": "0.335.0",
+    "type": "fix",
+    "title": "Scoped validation matches exact paths, root refine issues are visible, tabs keep the active tab by id, update redirects use the saved FK, related list sorting handles numeric strings, nulls and locales",
+    "detail": "Form and list fixes. A scoped `validate()` entry such as `address.city` no longer reports sibling issues like `address.zip`. Root-level `.refine()` issues now show as a banner in `RenderEdit` instead of blocking submit silently. In tabs mode the active tab follows its id when a field change hides an earlier tab, and an explicit subtitle override is kept. An entityEdit update redirect with `idFrom` reads the saved projection, so a changed parent FK redirects to the new parent. A row-extractor key missing from the row no longer wipes the target field's default. `relatedList` client-side sorting orders numeric strings by value, puts empty values last and compares text locale-aware. A reference list facet warns in dev when the lookup hits its row cap."
+  },
+  {
+    "version": "0.335.0",
+    "type": "fix",
+    "title": "writeForm section shows the error banner for issues no rendered field can display",
+    "detail": "A writeForm section keeps its error banner when the server reports an issue no rendered field can show (`version`, `id`, a root-level refine, a hidden field), instead of failing the save without any visible message."
+  },
+  {
+    "version": "0.335.0",
+    "type": "breaking",
+    "title": "Wizard editing an existing record shows data-based done state and allows jumping to any step; delete record actions leave the screen",
+    "detail": "Update-mode wizards compute done per step from the record (valid, non-empty fields, or passed via Next) and make every non-current step a jump target; forward jumps run the current step's validate gate. `ExtensionSectionProps.reportStepComplete` lets extension steps report completeness. `StepBar` gets `doneSteps` and `selectableSteps`. A writeHandler record action with `redirect`, or a delete of the shown record, navigates away (returnTo, redirect, listScreenId, entity list) instead of refetching.",
+    "migration": "Extension wizard steps in an entityEdit that edits an existing record should call `reportStepComplete(true)` (usually from an effect) once they hold their data, otherwise the step bar shows them as not done until the user passes them with Next. This also applies to singleton wizards (e.g. a company-setup wizard), whose steps now show done by data and are all jump targets; tests that assumed back-only chips must be updated. A delete writeHandler action on a projectionDetail or entityEdit now navigates away after success (returnTo, else listScreenId or the entity's list) instead of refetching into \"record not found\"; set `redirect` to choose another target. List row actions are unchanged."
+  },
   {
     "version": "0.333.0",
     "type": "improvement",