@cosmicdrift/kumiko-renderer 0.422.0 → 0.424.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -151,7 +151,7 @@ export function ActionFormBody({ schema, screen, translate, entityId, initialOve
151
151
  searchParams: nav.searchParams,
152
152
  })
153
153
  : undefined;
154
- const loadState = useActionFormLoad(screen.load, loadRecordId, loadableFieldNames, screen.summary?.paramsFromLoad, initialOverrides);
154
+ const loadState = useActionFormLoad(screen.load, loadRecordId, loadableFieldNames, screen.summary?.paramsFromLoad, initialOverrides ?? handoffValues);
155
155
  // What an aiAssist query gets besides its chip params: the same context the form loads with.
156
156
  const aiAssistPayload = useMemo(() => screen.load === undefined
157
157
  ? (initialOverrides ?? {})
@@ -64,5 +64,5 @@ export function ActionFormPreviewPanel({ preview, fields, values, translate, loc
64
64
  }
65
65
  if (query.data === null)
66
66
  return query.loading ? _jsx(QueryLoadingBanner, {}) : null;
67
- return (_jsx(Banner, { variant: "hint", testId: "action-form-preview", ...(preview.title !== undefined && { title: translate(preview.title) }), children: _jsxs(Grid, { columns: 1, children: [_jsx(ActionFormFacts, { facts: facts, testIdPrefix: "action-form-preview-fact" }), preview.list !== undefined && _jsx(DataTable, { columns: columns, rows: rows })] }) }));
67
+ return (_jsx(Banner, { variant: "hint", testId: "action-form-preview", ...(preview.title !== undefined && { title: translate(preview.title) }), children: _jsxs(Grid, { columns: 1, children: [_jsx(ActionFormFacts, { facts: facts, testIdPrefix: "action-form-preview-fact" }), preview.list !== undefined && (rows.length > 0 || facts.length === 0) && (_jsx(DataTable, { columns: columns, rows: rows }))] }) }));
68
68
  }
@@ -0,0 +1,9 @@
1
+ import { type ReactNode } from "react";
2
+ /** Short screen id of the app's start page, for components that sit outside
3
+ * the screen resolution (the "page not available" state offers it as the way
4
+ * back). `createKumikoApp` mounts it; `undefined` = no known start page. */
5
+ export declare function HomeScreenProvider({ homeScreenId, children, }: {
6
+ readonly homeScreenId: string | undefined;
7
+ readonly children: ReactNode;
8
+ }): ReactNode;
9
+ export declare function useHomeScreenId(): string | undefined;
@@ -0,0 +1,12 @@
1
+ import { jsx as _jsx } from "react/jsx-runtime";
2
+ import { createContext, useContext } from "react";
3
+ const HomeScreenContext = createContext(undefined);
4
+ /** Short screen id of the app's start page, for components that sit outside
5
+ * the screen resolution (the "page not available" state offers it as the way
6
+ * back). `createKumikoApp` mounts it; `undefined` = no known start page. */
7
+ export function HomeScreenProvider({ homeScreenId, children, }) {
8
+ return _jsx(HomeScreenContext.Provider, { value: homeScreenId, children: children });
9
+ }
10
+ export function useHomeScreenId() {
11
+ return useContext(HomeScreenContext);
12
+ }
@@ -6,7 +6,9 @@ import type { ResolvedSuccessItem, ResolvedSuccessLink } from "./action-form-sup
6
6
  import type { FeatureSchema } from "./feature-schema.ts";
7
7
  import { type NavApi, type ScreenTarget } from "./nav.tsx";
8
8
  /** Empty state for a screen QN that is not in the schema (feature disabled for
9
- * the tenant, stale link, miswired screen). The QN only goes to the console. */
9
+ * the tenant, stale link, miswired screen). The QN only goes to the console.
10
+ * The way back is the explicit `homeScreenId` or else the app's start page from
11
+ * `HomeScreenProvider`. */
10
12
  export declare function ScreenMissingState({ screenQn, homeScreenId, testId, }: {
11
13
  readonly screenQn: string;
12
14
  readonly homeScreenId?: string;
@@ -1,4 +1,4 @@
1
- import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
1
+ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
2
  import { parseRefTarget } from "@cosmicdrift/kumiko-framework/ui-types";
3
3
  import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
4
4
  import { useCallback, useEffect, useMemo } from "react";
@@ -11,28 +11,41 @@ import { referenceLookupSource, referenceRowsByIdsPayload } from "../hooks/use-r
11
11
  import { useTranslation } from "../i18n.js";
12
12
  import { usePrimitives } from "../primitives.js";
13
13
  import { ISO_DATE_PATTERN, isMoneyValue } from "./entity-edit-prefill.js";
14
+ import { useHomeScreenId } from "./home-screen-context.js";
14
15
  import { useNav } from "./nav.js";
15
16
  import { lastSegment, toKebab } from "./qn.js";
16
17
  import { featureNameFromQualifiedScreenId } from "./qualify-screen-id.js";
17
18
  import { navigateToReturn, navigateWithReturnTo, useReturnHost } from "./return-to.js";
19
+ // Own component so useNav only runs when a start page is known: KumikoScreen
20
+ // can render this state without a NavProvider.
18
21
  function ScreenMissingHomeButton({ homeScreenId, testId, }) {
19
22
  const { Button } = usePrimitives();
20
23
  const t = useTranslation();
21
24
  const nav = useNav();
22
- return (_jsx(Button, { variant: "secondary", onClick: () => nav.navigate({ screenId: homeScreenId }), testId: testId, children: t("kumiko.screen-missing.home") }));
25
+ return (_jsx(Button, { variant: "primary", onClick: () => nav.navigate({ screenId: homeScreenId }), testId: testId, children: t("kumiko.screen-missing.home") }));
26
+ }
27
+ // EmptyState is an optional primitive: a custom registry without it keeps the
28
+ // plain card, so no page loses its title and way out.
29
+ function NotAvailableState({ icon, title, description, actions, testId, }) {
30
+ const { EmptyState, Card, Text } = usePrimitives();
31
+ if (EmptyState !== undefined) {
32
+ return (_jsx(EmptyState, { icon: icon, title: title, description: description, actions: actions, testId: testId }));
33
+ }
34
+ return (_jsxs(Card, { options: { padded: true }, testId: testId, children: [_jsx(Text, { testId: `${testId}-title`, children: title }), description, actions] }));
23
35
  }
24
36
  /** Empty state for a screen QN that is not in the schema (feature disabled for
25
- * the tenant, stale link, miswired screen). The QN only goes to the console. */
37
+ * the tenant, stale link, miswired screen). The QN only goes to the console.
38
+ * The way back is the explicit `homeScreenId` or else the app's start page from
39
+ * `HomeScreenProvider`. */
26
40
  export function ScreenMissingState({ screenQn, homeScreenId, testId = "kumiko-screen-not-found", }) {
27
- const { Card, Text } = usePrimitives();
41
+ const { Text } = usePrimitives();
28
42
  const t = useTranslation();
43
+ const providedHomeScreenId = useHomeScreenId();
44
+ const homeTarget = homeScreenId ?? providedHomeScreenId;
29
45
  useEffect(() => {
30
46
  rendererWarn(`[kumiko] screen "${screenQn}" is not in the schema (feature disabled, stale link or miswired screen).`);
31
47
  }, [screenQn]);
32
- return (_jsx(Card, { options: { padded: true }, slots: {
33
- title: _jsx(Text, { testId: `${testId}-title`, children: t("kumiko.screen-missing.title") }),
34
- subtitle: _jsx(Text, { variant: "muted", children: t("kumiko.screen-missing.hint") }),
35
- }, testId: testId, children: homeScreenId !== undefined ? (_jsx(ScreenMissingHomeButton, { homeScreenId: homeScreenId, testId: `${testId}-home` })) : null }));
48
+ return (_jsx(NotAvailableState, { icon: "unavailable", title: t("kumiko.screen-missing.title"), description: _jsxs(_Fragment, { children: [_jsx(Text, { variant: "muted", children: t("kumiko.screen-missing.hint") }), _jsx(Text, { variant: "muted", children: t("kumiko.screen-missing.contact") })] }), actions: homeTarget !== undefined ? (_jsx(ScreenMissingHomeButton, { homeScreenId: homeTarget, testId: `${testId}-home` })) : undefined, testId: testId }));
36
49
  }
37
50
  export function ScreenAccessDeniedBanner({ screenQn, testId, }) {
38
51
  const { Banner } = usePrimitives();
@@ -61,8 +74,8 @@ export function findEntityListScreen(schema, entityName) {
61
74
  // instead of a bare error banner. Composed from shared primitives so web and
62
75
  // native render it alike.
63
76
  export function RecordNotFoundState({ translate, onBack, }) {
64
- const { Card, Text, Button } = usePrimitives();
65
- return (_jsxs(Card, { options: { padded: true }, testId: "kumiko-screen-record-missing", children: [_jsx(Text, { testId: "kumiko-screen-record-missing-title", children: translate("kumiko.record.not-found.title") }), _jsx(Text, { variant: "muted", children: translate("kumiko.record.not-found.hint") }), onBack !== undefined && (_jsx(Button, { variant: "secondary", onClick: onBack, testId: "kumiko-screen-record-missing-back", children: translate("kumiko.record.not-found.back") }))] }));
77
+ const { Text, Button } = usePrimitives();
78
+ return (_jsx(NotAvailableState, { icon: "not-found", title: translate("kumiko.record.not-found.title"), description: _jsx(Text, { variant: "muted", children: translate("kumiko.record.not-found.hint") }), actions: onBack !== undefined ? (_jsx(Button, { variant: "secondary", onClick: onBack, testId: "kumiko-screen-record-missing-back", children: translate("kumiko.record.not-found.back") })) : undefined, testId: "kumiko-screen-record-missing" }));
66
79
  }
67
80
  export function useNavigateToListAfter(schema, entityName) {
68
81
  const nav = useNav();
@@ -226,11 +239,18 @@ function findRedirectTargetScreen(redirect, schema, appFeatures) {
226
239
  : schema.screens;
227
240
  return searchSpace.find((s) => lastSegment(s.id) === targetId);
228
241
  }
242
+ // A custom screen reads its record from the route only when the redirect names the id field.
243
+ function redirectCarriesId(redirect, target) {
244
+ if (target === undefined)
245
+ return false;
246
+ if (target.type === "entityEdit" || target.type === "projectionDetail")
247
+ return true;
248
+ return target.type === "custom" && typeof redirect !== "string" && redirect.idFrom !== undefined;
249
+ }
229
250
  // A redirect to a record screen ("show the result") is a deliberate forward
230
251
  // navigation and keeps precedence over returnTo.
231
252
  function redirectTargetsRecord(redirect, schema, appFeatures) {
232
- const target = findRedirectTargetScreen(redirect, schema, appFeatures);
233
- return (target !== undefined && (target.type === "entityEdit" || target.type === "projectionDetail"));
253
+ return redirectCarriesId(redirect, findRedirectTargetScreen(redirect, schema, appFeatures));
234
254
  }
235
255
  // Type-guard form narrows `returnTarget` for the caller's subsequent
236
256
  // navigateToReturn(nav, returnTarget) call.
@@ -252,7 +272,7 @@ export function resolveRedirectTarget(redirect, submittedData, schema, appFeatur
252
272
  const idField = typeof redirect === "string" ? "id" : (redirect.idFrom ?? "id");
253
273
  const targetId = lastSegment(redirectScreen);
254
274
  const target = findRedirectTargetScreen(redirect, schema, appFeatures);
255
- const carriesId = target !== undefined && (target.type === "entityEdit" || target.type === "projectionDetail");
275
+ const carriesId = redirectCarriesId(redirect, target);
256
276
  const searchParams = redirectSearchParams(redirect, submittedData);
257
277
  if (!carriesId)
258
278
  return { screenId: targetId, entityId: undefined, tab: undefined, searchParams };
@@ -294,9 +314,10 @@ export function navigateToRedirectTarget(nav, target) {
294
314
  nav.navigate(navTarget, { searchParams });
295
315
  }
296
316
  // Links of the success box. Targets resolve like `redirect`; a link whose target
297
- // needs a record id (entityEdit, projectionDetail) but whose payload field holds
298
- // no string id is dropped instead of navigating to an id-less record screen.
299
- // A link without idFrom to a non-record screen always navigates id-less.
317
+ // needs a record id (entityEdit, projectionDetail, or custom with an explicit
318
+ // idFrom) but whose payload field holds no string id is dropped instead of
319
+ // navigating to an id-less record screen. A link without idFrom to a custom or
320
+ // other non-record screen always navigates id-less.
300
321
  export function resolveSuccessLinks(links, data, schema, appFeatures, nav, translate) {
301
322
  const resolved = [];
302
323
  (links ?? []).forEach((link, index) => {
@@ -58,7 +58,10 @@ function createFieldCellRenderer(model, section, columns, flows, facts) {
58
58
  model.setFieldUntyped(field.field, v);
59
59
  clearErrorsAndValidate(field.field);
60
60
  }, ...(props.actionFormScreenQn !== undefined && {
61
- onSuggest: (value) => form.controller.seedField(field.field, value),
61
+ onSuggest: (value) => {
62
+ form.controller.seedField(field.field, value);
63
+ form.clearErrorsOnInput(field.field);
64
+ },
62
65
  }), GridCell: GridCell, featureName: props.featureName, ...appendixCellProps(props, field, snapshot.values, state.primitives.StatusBadge), allIssues: snapshot.errors, valueDisplay: props.valueDisplay, row: snapshot.values, ...(disabled && { fillDisabled: true }), ...(props.hideSectionTitles !== true &&
63
66
  section.title !== undefined && { sectionTitle: section.title }), ...(showsChangedMarker && field.field in snapshot.changes && { changed: true }) }, field.field));
64
67
  };
@@ -243,9 +243,10 @@ export const kumikoDefaultTranslations = {
243
243
  "kumiko.widget.loading": "Loading…",
244
244
  "kumiko.widget.error.title": "Couldn't load.",
245
245
  "kumiko.screen-missing.title": "This page is not available",
246
- "kumiko.screen-missing.hint": "It is not enabled for your account or no longer exists.",
246
+ "kumiko.screen-missing.hint": "Either it is not enabled for your account or it no longer exists.",
247
247
  "kumiko.screen-access-denied.title": "You do not have access to this page.",
248
248
  "kumiko.screen-missing.home": "Go to start page",
249
+ "kumiko.screen-missing.contact": "If you need it, ask the person who manages accounts for your organization.",
249
250
  "kumiko.screen-error.title": "This screen failed to render.",
250
251
  "kumiko.error.reference": "Error ID: {id}",
251
252
  "kumiko.error.copyReference": "Copy",
package/dist/index.d.ts CHANGED
@@ -27,6 +27,7 @@ export { ExtensionSectionsProvider, extensionSectionName, useExtensionSectionCom
27
27
  export type { AppSchema, FeatureSchema, QualifiedContentCollection, WorkspaceSchema, } from "./app/feature-schema.ts";
28
28
  export { isAppSchema, toAppSchema } from "./app/feature-schema.ts";
29
29
  export { HeaderActionsBar } from "./app/header-actions-bar.tsx";
30
+ export { HomeScreenProvider, useHomeScreenId } from "./app/home-screen-context.tsx";
30
31
  export type { KumikoScreenProps } from "./app/kumiko-screen.tsx";
31
32
  export { KumikoScreen, qualifyNavId, qualifyScreenId } from "./app/kumiko-screen.tsx";
32
33
  export type { DateRangeBound, DateRangeValue, ResolvedDateRangeFacet } from "./app/list-facets.ts";
@@ -94,7 +95,7 @@ export { InsideDrawerProvider, useInsideDrawer } from "./inside-drawer.ts";
94
95
  export { hasUnsavedInput, registerUnsavedInputSource, requestLeave, setLeaveConfirmer, useUnsavedInputSource, } from "./leave-guard.ts";
95
96
  export { LeaveGuardDialog } from "./leave-guard-dialog.tsx";
96
97
  export { PageHeaderCompactProvider, PageHeaderSlotAvailableProvider, usePageHeaderCompact, usePageHeaderSlotAvailable, } from "./page-header-slot.ts";
97
- export type { ActionMenuItemSpec, ActionOverflowMenuProps, AppPrimitives, BannerProps, BulkRowOutcome, ButtonProps, CardOptions, CardProps, CardSlots, CopyButtonProps, CorePrimitives, DataTableBulk, DataTableBulkAction, DataTableDateRangeFacet, DataTableFacet, DataTableFacetChip, DataTableProps, DataTableRowAction, DataTableRowActionMode, DataTableSort, DataTableSortDir, DialogProps, DrawerProps, EmbeddedListCellType, EmbeddedListColumn, EmbeddedListInputProps, EmbeddedListTotal, FieldCellWidth, FieldProps, FileValueListProps, FillContainerProps, FooterActionMarker, FooterActionRole, FormProps, FormSectionNavItem, FormWidth, GridCellProps, GridProps, HeadingProps, InputEndAction, InputFillAction, InputProps, JsonViewProps, LightboxImage, LightboxProps, LinkProps, MetricBandProps, MetricProps, ModalProps, PageHeaderProps, PhotoGridProps, PickedFile, PrimitivesProviderProps, PrimitivesRegistry, ProgressProps, ProgressTone, PromoPanelAction, PromoPanelProps, RecordBreadcrumbProps, RecordStepsProps, RecordSummaryProps, RuntimeRenderer, SecretRevealProps, SecretRevealValue, SectionProps, ShareButtonProps, StatusBadgeProps, StatusTone, StepBarProps, StepListProps, StickyActionBarProps, StickyPrimaryActionMarker, TabsProps, TextProps, TrailingInputAction, WizardStepGroupProps, } from "./primitives.tsx";
98
+ export type { ActionMenuItemSpec, ActionOverflowMenuProps, AppPrimitives, BannerProps, BulkRowOutcome, ButtonProps, CardOptions, CardProps, CardSlots, CopyButtonProps, CorePrimitives, DataTableBulk, DataTableBulkAction, DataTableDateRangeFacet, DataTableFacet, DataTableFacetChip, DataTableProps, DataTableRowAction, DataTableRowActionMode, DataTableSort, DataTableSortDir, DialogProps, DrawerProps, EmbeddedListCellType, EmbeddedListColumn, EmbeddedListInputProps, EmbeddedListTotal, EmptyStateIcon, EmptyStateProps, FieldCellWidth, FieldProps, FileValueListProps, FillContainerProps, FooterActionMarker, FooterActionRole, FormProps, FormSectionNavItem, FormWidth, GridCellProps, GridProps, HeadingProps, InputEndAction, InputFillAction, InputProps, JsonViewProps, LightboxImage, LightboxProps, LinkProps, MetricBandProps, MetricProps, ModalProps, PageHeaderProps, PhotoGridProps, PickedFile, PrimitivesProviderProps, PrimitivesRegistry, ProgressProps, ProgressTone, PromoPanelAction, PromoPanelProps, RecordBreadcrumbProps, RecordStepsProps, RecordSummaryProps, RuntimeRenderer, SecretRevealProps, SecretRevealValue, SectionProps, ShareButtonProps, StatusBadgeProps, StatusTone, StepBarProps, StepListProps, StickyActionBarProps, StickyPrimaryActionMarker, TabsProps, TextProps, TrailingInputAction, WizardStepGroupProps, } from "./primitives.tsx";
98
99
  export { FOOTER_ACTION_ROLE_PROP, NARROW_LABEL_PROP, PrimitivesProvider, STICKY_PRIMARY_ACTION_PROP, shouldRenderActionsIconOnly, statusToneForOptionTone, statusToneForValue, useOptionalPrimitives, usePrimitives, } from "./primitives.tsx";
99
100
  export type { SessionEndedSignal, SessionEndedSignalProviderProps, } from "./session/session-ended.tsx";
100
101
  export { createSessionEndedSignal, isSessionEndedError, SESSION_ENDED_ERROR_CODES, SessionEndedSignalProvider, useSessionEndedSignal, withSessionEndedDetection, } from "./session/session-ended.tsx";
package/dist/index.js CHANGED
@@ -26,6 +26,7 @@ export { ExtensionFormRegistryProvider, useExtensionFormSubmit, } from "./app/ex
26
26
  export { ExtensionSectionsProvider, extensionSectionName, useExtensionSectionComponent, } from "./app/extension-sections.js";
27
27
  export { isAppSchema, toAppSchema } from "./app/feature-schema.js";
28
28
  export { HeaderActionsBar } from "./app/header-actions-bar.js";
29
+ export { HomeScreenProvider, useHomeScreenId } from "./app/home-screen-context.js";
29
30
  export { KumikoScreen, qualifyNavId, qualifyScreenId } from "./app/kumiko-screen.js";
30
31
  export { buildDateRangePayload, clampDateRange, readDateRange, resolveDateRangeFacets, } from "./app/list-facets.js";
31
32
  export { formatPath, hasDetailScreen, NavProvider, parsePath, resolveTarget, useNav, useNavigateWithInitialValues, useOptionalNav, } from "./app/nav.js";
@@ -80,3 +80,15 @@ export type PromoPanelProps = {
80
80
  readonly action?: PromoPanelAction;
81
81
  readonly testId?: string;
82
82
  };
83
+ /** Semantic picture of an `EmptyState`; each platform maps it to its own icon, so
84
+ * platform-neutral code never imports an icon library. */
85
+ export type EmptyStateIcon = "unavailable" | "not-found";
86
+ /** Calm centered "nothing here" page: icon in a soft circle, title, one explanation and
87
+ * the way out as `actions`. */
88
+ export type EmptyStateProps = {
89
+ readonly icon: EmptyStateIcon;
90
+ readonly title: string;
91
+ readonly description?: ReactNode;
92
+ readonly actions?: ReactNode;
93
+ readonly testId?: string;
94
+ };
@@ -1391,8 +1391,8 @@ export type ActionOverflowMenuProps = {
1391
1391
  readonly triggerLabel?: string;
1392
1392
  readonly testId?: string;
1393
1393
  };
1394
- import type { CopyButtonProps, PromoPanelProps, SecretRevealProps, ShareButtonProps, StickyActionBarProps } from "./primitives-share-types.ts";
1395
- export type { CopyButtonProps, PromoPanelAction, PromoPanelProps, SecretRevealProps, SecretRevealValue, ShareButtonProps, StickyActionBarProps, } from "./primitives-share-types.ts";
1394
+ import type { CopyButtonProps, EmptyStateProps, PromoPanelProps, SecretRevealProps, ShareButtonProps, StickyActionBarProps } from "./primitives-share-types.ts";
1395
+ export type { CopyButtonProps, EmptyStateIcon, EmptyStateProps, PromoPanelAction, PromoPanelProps, SecretRevealProps, SecretRevealValue, ShareButtonProps, StickyActionBarProps, } from "./primitives-share-types.ts";
1396
1396
  export type CorePrimitives = {
1397
1397
  readonly Button: ComponentType<ButtonProps>;
1398
1398
  readonly Banner: ComponentType<BannerProps>;
@@ -1488,6 +1488,9 @@ export type CorePrimitives = {
1488
1488
  readonly ShareButton?: ComponentType<ShareButtonProps>;
1489
1489
  /** Optional — additive rollout, see StickyActionBar. */
1490
1490
  readonly PromoPanel?: ComponentType<PromoPanelProps>;
1491
+ /** Optional — additive rollout, see StickyActionBar. Without it the
1492
+ * "not available" states fall back to a Card. */
1493
+ readonly EmptyState?: ComponentType<EmptyStateProps>;
1491
1494
  };
1492
1495
  /** Extension point for app-owned primitives. Developers extend this
1493
1496
  * interface through TypeScript module augmentation:
@@ -3,7 +3,7 @@ import { isOpenToAllGranted } from "@cosmicdrift/kumiko-framework/ui-types";
3
3
  import { createContext, useContext, useEffect, useMemo, useRef, useState, } from "react";
4
4
  import { createRoot } from "react-dom/client";
5
5
  import { rendererError, rendererWarn } from "../../dev-console.js";
6
- import { AppFeaturesProvider, BasePathProvider, ClientActionsProvider, ColumnRenderersProvider, ContentEditorsProvider, ContentPreviewsProvider, CustomScreensProvider, createSessionEndedSignal, DashboardBodyProvider, DispatcherProvider, DraftStorageProvider, ErrorBoundary, ExtensionSectionsProvider, hasDetailScreen, KumikoScreen, kumikoDefaultTranslations, LeaveGuardDialog, LiveEventsProvider, LocaleProvider, mergeTranslations, NavProvider, navigateWithReturnTo, PrimitivesProvider, qualifyScreenId, ScreenMissingState, SessionEndedSignalProvider, TokensProvider, toAppSchema, translationsByLocaleFromKeys, useBasePath, useNav, usePrimitives, useTranslation, withSessionEndedDetection, } from "../../index.js";
6
+ import { AppFeaturesProvider, BasePathProvider, ClientActionsProvider, ColumnRenderersProvider, ContentEditorsProvider, ContentPreviewsProvider, CustomScreensProvider, createSessionEndedSignal, DashboardBodyProvider, DispatcherProvider, DraftStorageProvider, ErrorBoundary, ExtensionSectionsProvider, HomeScreenProvider, hasDetailScreen, KumikoScreen, kumikoDefaultTranslations, LeaveGuardDialog, LiveEventsProvider, LocaleProvider, mergeTranslations, NavProvider, navigateWithReturnTo, PrimitivesProvider, qualifyScreenId, ScreenMissingState, SessionEndedSignalProvider, TokensProvider, toAppSchema, translationsByLocaleFromKeys, useBasePath, useNav, usePrimitives, useTranslation, withSessionEndedDetection, } from "../../index.js";
7
7
  import { createLiveDispatcher } from "../../live/index.js";
8
8
  import { lastSegment } from "../layout/nav-tree.js";
9
9
  import { ScreenFocus } from "../layout/screen-focus.js";
@@ -384,7 +384,9 @@ function BrowserNavBoot({ app, fallbackQn, useNavApi, hasWorkspaces, translate,
384
384
  const navApi = useNavApi({ hasWorkspaces, features: app.features });
385
385
  const Shell = shell;
386
386
  const screen = (_jsx(RoutedScreen, { app: app, fallbackQn: fallbackQn, ...(translate !== undefined && { translate }), ...(onRowClick !== undefined && { onRowClick }) }));
387
- return (_jsx(NavProvider, { value: navApi, children: Shell !== undefined ? _jsx(Shell, { schema: app, children: screen }) : screen }));
387
+ return (_jsx(NavProvider, { value: navApi, children: _jsx(HomeScreenProvider, { homeScreenId: findOwnerFeature(app.features, fallbackQn) !== undefined
388
+ ? lastSegment(fallbackQn)
389
+ : undefined, children: Shell !== undefined ? _jsx(Shell, { schema: app, children: screen }) : screen }) }));
388
390
  }
389
391
  // Finds the feature that owns a fully qualified ScreenQn.
390
392
  // Returns undefined if the screen isn't declared in any feature schema —
@@ -519,8 +521,7 @@ function RoutedScreen({ app, fallbackQn, translate, onRowClick, }) {
519
521
  };
520
522
  }, [nav]);
521
523
  if (feature === undefined || activeScreen === undefined) {
522
- const landingExists = findOwnerFeature(app.features, fallbackQn) !== undefined;
523
- return (_jsx(ScreenMissingState, { ...(landingExists && { homeScreenId: lastSegment(fallbackQn) }), screenQn: nav.route?.screenId ?? qn }));
524
+ return _jsx(ScreenMissingState, { screenQn: nav.route?.screenId ?? qn });
524
525
  }
525
526
  // KumikoScreen takes a single-feature schema: the feature owning the active screen.
526
527
  const schemaForScreen = feature;
@@ -17,7 +17,7 @@ export function EditorFooter({ testIdPrefix, actionTestIds = DEFAULT_ACTION_TEST
17
17
  const t = useTranslation();
18
18
  const { Banner, Button, Text } = usePrimitives();
19
19
  const tone = message === null ? null : FOOTER_TONE[message.tone];
20
- return (_jsxs("div", { className: "flex items-center gap-4 border-t bg-background px-6 py-3", "data-testid": `${testIdPrefix}-footer`, children: [_jsxs("div", { className: "min-w-0 flex-1 text-sm", children: [saveError !== null ? (_jsx(Banner, { variant: "error", testId: `${testIdPrefix}-save-error`, children: saveError })) : (_jsx("span", { className: cn(tone === null ? "text-muted-foreground" : tone.text), "data-testid": `${testIdPrefix}-footer-message`, "data-tone": message?.tone, children: message === null
20
+ return (_jsxs("div", { className: "flex flex-wrap items-center gap-x-4 gap-y-2 border-t bg-background px-6 py-3", "data-testid": `${testIdPrefix}-footer`, children: [_jsxs("div", { className: "min-w-0 basis-full text-sm sm:flex-1 sm:basis-0", children: [saveError !== null ? (_jsx(Banner, { variant: "error", testId: `${testIdPrefix}-save-error`, children: saveError })) : (_jsx("span", { className: cn(tone === null ? "text-muted-foreground" : tone.text), "data-testid": `${testIdPrefix}-footer-message`, "data-tone": message?.tone, children: message === null
21
21
  ? (pendingMessage ?? t("kumiko.editor.noChanges"))
22
- : `${tone?.glyph ?? ""} ${message.text}` })), modifiedAt !== null && (_jsxs(_Fragment, { children: [" ", _jsx(Text, { variant: "muted", testId: `${testIdPrefix}-saved-at`, children: t("kumiko.editor.savedAt", { when: formatRelativeWhen(modifiedAt) }) })] }))] }), _jsxs("div", { className: "flex shrink-0 items-center gap-3", children: [_jsx(Button, { variant: "ghost", disabled: !dirty, onClick: onDiscard, testId: actionTestIds.discard, children: t("kumiko.editor.discard") }), _jsx(Button, { variant: onPublish === undefined ? "primary" : "secondary", disabled: !canSave, loading: busy, onClick: onSave, testId: actionTestIds.save, children: saveLabel ?? t("kumiko.actions.save") }), onPublish !== undefined && (_jsx(Button, { disabled: canPublish !== true, onClick: onPublish, testId: actionTestIds.publish, children: t("kumiko.editor.publish") }))] })] }));
22
+ : `${tone?.glyph ?? ""} ${message.text}` })), modifiedAt !== null && (_jsxs(_Fragment, { children: [" ", _jsx(Text, { variant: "muted", testId: `${testIdPrefix}-saved-at`, children: t("kumiko.editor.savedAt", { when: formatRelativeWhen(modifiedAt) }) })] }))] }), _jsxs("div", { className: "ml-auto flex shrink-0 items-center gap-3", children: [_jsx(Button, { variant: "ghost", disabled: !dirty, onClick: onDiscard, testId: actionTestIds.discard, children: t("kumiko.editor.discard") }), _jsx(Button, { variant: onPublish === undefined ? "primary" : "secondary", disabled: !canSave, loading: busy, onClick: onSave, testId: actionTestIds.save, children: saveLabel ?? t("kumiko.actions.save") }), onPublish !== undefined && (_jsx(Button, { disabled: canPublish !== true, onClick: onPublish, testId: actionTestIds.publish, children: t("kumiko.editor.publish") }))] })] }));
23
23
  }
@@ -13,9 +13,9 @@ export function EditorInfoBar({ tone, testId, origin, controls, links, overlays,
13
13
  return (_jsxs(_Fragment, { children: [_jsxs("div", { className: cn("flex items-start gap-4 border-b px-6 py-2 text-sm", INFO_BAR_TONE[tone]), "data-testid": testId, "data-variant": tone === "warn" ? "warn" : undefined, children: [_jsxs("span", { className: "min-w-0 flex-1", children: [origin, " ", children] }), controls !== undefined && (_jsx("div", { className: "flex shrink-0 items-center gap-2", children: controls })), links !== undefined && _jsx("div", { className: "flex shrink-0 items-center gap-4", children: links })] }), overlays] }));
14
14
  }
15
15
  export function EditorBody({ left, center, right, testId, }) {
16
- const centerColumn = (_jsx("div", { className: "flex min-h-0 min-w-0 flex-col overflow-hidden bg-muted", children: center }));
16
+ const centerColumn = (_jsx("div", { className: "flex min-h-[70svh] min-w-0 flex-col overflow-hidden bg-muted md:min-h-0", children: center }));
17
17
  if (left === undefined) {
18
- return (_jsxs("div", { className: "grid min-h-0 flex-1 grid-cols-[minmax(0,1fr)_280px]", "data-testid": testId, children: [centerColumn, _jsx("aside", { className: "min-h-0 overflow-y-auto border-l bg-background", children: right })] }));
18
+ return (_jsxs("div", { className: "grid min-h-0 flex-1 grid-cols-1 grid-rows-[auto_auto] content-start overflow-y-auto md:grid-cols-[minmax(0,1fr)_280px] md:grid-rows-1 md:overflow-y-visible", "data-testid": testId, children: [centerColumn, _jsx("aside", { className: "border-t bg-background md:min-h-0 md:overflow-y-auto md:border-t-0 md:border-l", children: right })] }));
19
19
  }
20
20
  // Three columns leave a narrow window (1024px beside the app sidebar) too little room for the
21
21
  // page: there both rails share the left column, one below the other, and the center keeps its width.
@@ -29,7 +29,8 @@ export declare function EditorHeader({ title, status, actions, testIds, children
29
29
  readonly title: string;
30
30
  /** Badge next to the title, e.g. the stored version's state. */
31
31
  readonly status?: ReactNode;
32
- readonly actions: EditorSaveActions;
32
+ /** Without it the header has no save buttons and the footer carries them alone. */
33
+ readonly actions?: EditorSaveActions;
33
34
  readonly testIds?: EditorHeaderTestIds;
34
35
  /** View controls left of the save actions (mode or kind switch). */
35
36
  readonly children: ReactNode;
@@ -25,6 +25,6 @@ export function EditorHeader({ title, status, actions, testIds = DEFAULT_HEADER_
25
25
  const { Button, PageHeader } = usePrimitives();
26
26
  if (PageHeader === undefined)
27
27
  return null;
28
- const { onPublish } = actions;
29
- return (_jsx(PageHeader, { title: title, status: status, actions: _jsxs("span", { className: "flex items-center gap-2 [&_button]:px-2.5 [&_button]:text-sm", children: [children, _jsxs("span", { className: "hidden items-center gap-2 xl:flex", children: [_jsx(Button, { variant: onPublish === undefined ? "primary" : "secondary", size: "sm", disabled: !actions.canSave, loading: actions.busy, onClick: actions.onSave, testId: testIds.save, children: actions.saveLabel ?? t("kumiko.actions.save") }), onPublish !== undefined && (_jsx(Button, { size: "sm", disabled: actions.canPublish !== true, onClick: onPublish, testId: testIds.publish, children: t("kumiko.editor.publish") }))] })] }) }));
28
+ const onPublish = actions?.onPublish;
29
+ return (_jsx(PageHeader, { title: title, status: status, actions: _jsxs("span", { className: "flex items-center gap-2 [&_button]:px-2.5 [&_button]:text-sm", children: [children, actions !== undefined && (_jsxs("span", { className: "hidden items-center gap-2 xl:flex", children: [_jsx(Button, { variant: onPublish === undefined ? "primary" : "secondary", size: "sm", disabled: !actions.canSave, loading: actions.busy, onClick: actions.onSave, testId: testIds.save, children: actions.saveLabel ?? t("kumiko.actions.save") }), onPublish !== undefined && (_jsx(Button, { size: "sm", disabled: actions.canPublish !== true, onClick: onPublish, testId: testIds.publish, children: t("kumiko.editor.publish") }))] }))] }) }));
30
30
  }
@@ -10,10 +10,5 @@ export function EditorWorkbench({ testId, title, status, info, controls, banners
10
10
  const t = useTranslation();
11
11
  const [mode, setMode] = useState("edit");
12
12
  const editing = mode === "edit";
13
- return (_jsxs(EditorFrame, { testId: testId, children: [_jsx(EditorHeader, { title: title, status: status, actions: {
14
- busy: save.busy,
15
- canSave: save.canSave,
16
- onSave: save.onSave,
17
- ...(save.saveLabel !== undefined && { saveLabel: save.saveLabel }),
18
- }, children: _jsx(EditorModeSwitch, { testIdPrefix: testId, mode: mode, onMode: setMode }) }), _jsx(EditorInfoBar, { tone: "muted", testId: `${testId}-info`, controls: controls, children: editing ? info.edit : info.preview }), banners, _jsx(EditorBody, { testId: `${testId}-${mode}`, center: editing ? edit : preview, right: editing ? rail.edit : rail.preview, ...(rail.left !== undefined && { left: rail.left }) }), _jsx(EditorFooter, { testIdPrefix: testId, message: save.dirty ? { tone: "warn", text: t("kumiko.editor.unsavedChanges") } : null, saveError: save.saveError, modifiedAt: save.modifiedAt ?? null, dirty: save.dirty, busy: save.busy, canSave: save.canSave, onDiscard: save.onDiscard, onSave: save.onSave, ...(save.saveLabel !== undefined && { saveLabel: save.saveLabel }) })] }));
13
+ return (_jsxs(EditorFrame, { testId: testId, children: [_jsx(EditorHeader, { title: title, status: status, children: _jsx(EditorModeSwitch, { testIdPrefix: testId, mode: mode, onMode: setMode }) }), _jsx(EditorInfoBar, { tone: "muted", testId: `${testId}-info`, controls: controls, children: editing ? info.edit : info.preview }), banners, _jsx(EditorBody, { testId: `${testId}-${mode}`, center: editing ? edit : preview, right: editing ? rail.edit : rail.preview, ...(rail.left !== undefined && { left: rail.left }) }), _jsx(EditorFooter, { testIdPrefix: testId, message: save.dirty ? { tone: "warn", text: t("kumiko.editor.unsavedChanges") } : null, saveError: save.saveError, modifiedAt: save.modifiedAt ?? null, dirty: save.dirty, busy: save.busy, canSave: save.canSave, onDiscard: save.onDiscard, onSave: save.onSave, ...(save.saveLabel !== undefined && { saveLabel: save.saveLabel }) })] }));
19
14
  }
@@ -30,8 +30,8 @@ export type DefaultAppShellProps = {
30
30
  /** Footer slot at the bottom of the sidebar — profile row, help link,
31
31
  * or plan banner. */
32
32
  readonly sidebarFooter?: ReactNode;
33
- /** Top-level nav QNs the focus rail shows as tiles; the others sit behind a
34
- * "More" tile that opens the full sidebar. Unset: every top-level entry. */
33
+ /** Nav QNs (any depth) the focus rail shows as tiles, in this order; unlisted
34
+ * top-level entries sit behind a "More" tile that opens the full sidebar. Unset: every top-level entry. */
35
35
  readonly focusRailNavQns?: readonly string[];
36
36
  /** Viewport-fit shell. true → fixed viewport height (`h-svh`); content
37
37
  * scrolls inside instead of the whole page. Defaults to true — `fill={false}`
@@ -8,7 +8,7 @@ export type FocusRailProps = {
8
8
  readonly roles: readonly string[];
9
9
  };
10
10
  readonly allowedNavQns?: ReadonlySet<string>;
11
- /** Top-level nav QNs that get a rail tile; the rest sit behind a "More" tile. Unset: all of them. */
11
+ /** Nav QNs (any depth) that get a rail tile, in this order; unlisted top-level nodes sit behind "More". Unset: all top-level nodes. */
12
12
  readonly railNavQns?: readonly string[];
13
13
  /** The sidebar footer (e.g. the sidebar UserMenu), pinned to the bottom of the rail. */
14
14
  readonly footer?: ReactNode;
@@ -13,6 +13,16 @@ import { resolveParentScreenId } from "./shell-breadcrumb.js";
13
13
  import { useDispatchTarget } from "./target-resolver-stub.js";
14
14
  const NAV_ICON_LOOKUP = NAV_ICONS;
15
15
  const RAIL_TILE_CLASS = "flex size-10 shrink-0 items-center justify-center rounded-md border-0 bg-transparent p-0 text-sidebar-muted outline-hidden transition-colors hover:bg-sidebar-accent/60 hover:text-sidebar-accent-foreground focus-visible:ring-2 focus-visible:ring-sidebar-ring data-[active=true]:bg-sidebar-accent data-[active=true]:text-sidebar-accent-foreground";
16
+ function findNavNode(nodes, qualifiedName) {
17
+ for (const node of nodes) {
18
+ if (node.qualifiedName === qualifiedName)
19
+ return node;
20
+ const nested = findNavNode(node.children, qualifiedName);
21
+ if (nested !== undefined)
22
+ return nested;
23
+ }
24
+ return undefined;
25
+ }
16
26
  function RailGlyph({ node, label }) {
17
27
  const Icon = node.icon !== undefined && Object.hasOwn(NAV_ICONS, node.icon)
18
28
  ? NAV_ICON_LOOKUP[node.icon]
@@ -54,8 +64,20 @@ export function FocusRail({ brand, schema, user, allowedNavQns, railNavQns, foot
54
64
  }, [schema, user, allowedNavQns]);
55
65
  const activeScreenId = useActiveScreenId(tree, schema);
56
66
  const isActive = (node) => activeScreenId !== undefined && treeContainsScreen([node], activeScreenId);
57
- const shown = railNavQns === undefined ? tree : tree.filter((n) => railNavQns.includes(n.qualifiedName));
67
+ // Listed entries can sit inside a group (listed or not), so the lookup walks the whole
68
+ // tree; entries without a match (e.g. hidden by role) are skipped.
69
+ const shown = railNavQns === undefined
70
+ ? tree
71
+ : [...new Set(railNavQns)].flatMap((qn) => {
72
+ const node = findNavNode(tree, qn);
73
+ return node === undefined ? [] : [node];
74
+ });
58
75
  const hidden = tree.filter((node) => !shown.includes(node));
76
+ // A shown tile nested in another shown tile owns the highlight; the outer one stays plain.
77
+ const isTileActive = (node) => isActive(node) &&
78
+ !shown.some((other) => other !== node &&
79
+ isActive(other) &&
80
+ findNavNode(node.children, other.qualifiedName) !== undefined);
59
81
  const moreLabel = t("kumiko.focusRail.more");
60
- return (_jsxs("div", { "data-kumiko-layout": "focus-rail", "data-focus-rail": "", className: "group/focus-rail flex h-full flex-col items-center px-2 py-3", children: [brand, _jsx("nav", { className: "flex flex-col items-center gap-1", children: shown.map((node) => (_jsx(RailTile, { node: node, active: isActive(node) }, node.qualifiedName))) }), _jsxs("div", { className: "mt-auto flex w-full flex-col items-center gap-1", children: [hidden.length > 0 && (_jsx("button", { type: "button", title: moreLabel, "aria-label": moreLabel, "data-active": hidden.some(isActive), className: RAIL_TILE_CLASS, onClick: () => setOpen(true), children: _jsx(MoreHorizontal, { "aria-hidden": "true", className: "size-[18px]" }) })), footer !== undefined && (_jsx("div", { "data-kumiko-layout": "focus-rail-footer", className: "w-full", children: footer }))] })] }));
82
+ return (_jsxs("div", { "data-kumiko-layout": "focus-rail", "data-focus-rail": "", className: "group/focus-rail flex h-full flex-col items-center px-2 py-3", children: [brand, _jsx("nav", { className: "flex flex-col items-center gap-1", children: shown.map((node) => (_jsx(RailTile, { node: node, active: isTileActive(node) }, node.qualifiedName))) }), _jsxs("div", { className: "mt-auto flex w-full flex-col items-center gap-1", children: [hidden.length > 0 && (_jsx("button", { type: "button", title: moreLabel, "aria-label": moreLabel, "data-active": hidden.some(isActive) && !shown.some(isActive), className: RAIL_TILE_CLASS, onClick: () => setOpen(true), children: _jsx(MoreHorizontal, { "aria-hidden": "true", className: "size-[18px]" }) })), footer !== undefined && (_jsx("div", { "data-kumiko-layout": "focus-rail-footer", className: "w-full", children: footer }))] })] }));
61
83
  }
@@ -26,8 +26,8 @@ export type WorkspaceShellProps = {
26
26
  * build information. It stays at the bottom via `mt-auto` (see
27
27
  * Sidebar.footer). Symmetric with DefaultAppShell.sidebarFooter. */
28
28
  readonly sidebarFooter?: ReactNode;
29
- /** Top-level nav QNs the focus rail shows as tiles; the others sit behind a
30
- * "More" tile that opens the full sidebar. Unset: every top-level entry. */
29
+ /** Nav QNs (any depth) the focus rail shows as tiles, in this order; unlisted
30
+ * top-level entries sit behind a "More" tile that opens the full sidebar. Unset: every top-level entry. */
31
31
  readonly focusRailNavQns?: readonly string[];
32
32
  /** Runtime badge slot per nav leaf (bare nav id), same as DefaultAppShell. */
33
33
  readonly navBadges?: ReadonlyMap<string, ReactNode>;
@@ -0,0 +1,3 @@
1
+ import type { ReactNode } from "react";
2
+ import type { EmptyStateProps } from "../../index.ts";
3
+ export declare function DefaultEmptyState({ icon, title, description, actions, testId, }: EmptyStateProps): ReactNode;
@@ -0,0 +1,10 @@
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { FileQuestion, Lock } from "lucide-react";
3
+ const ICONS = {
4
+ unavailable: Lock,
5
+ "not-found": FileQuestion,
6
+ };
7
+ export function DefaultEmptyState({ icon, title, description, actions, testId, }) {
8
+ const Icon = ICONS[icon];
9
+ return (_jsxs("div", { "data-testid": testId, className: "mx-auto flex max-w-md flex-col items-center gap-3 px-6 py-16 text-center", children: [_jsx("div", { className: "rounded-full bg-muted p-3 text-muted-foreground", children: _jsx(Icon, { className: "size-6", "aria-hidden": "true" }) }), _jsx("h2", { "data-testid": testId !== undefined ? `${testId}-title` : undefined, className: "text-lg font-semibold", children: title }), description !== undefined && (_jsx("div", { className: "flex flex-col gap-1 text-sm text-muted-foreground", children: description })), actions !== undefined && (_jsx("div", { className: "mt-2 flex flex-wrap items-center justify-center gap-2", children: actions }))] }));
10
+ }
@@ -9,6 +9,7 @@ import { applyFormatSpec } from "../../headless/index.js";
9
9
  import { DefaultDialog } from "./dialog.js";
10
10
  import { DefaultDrawer } from "./drawer.js";
11
11
  import { EmbeddedListInput } from "./embedded-list-input.js";
12
+ import { DefaultEmptyState } from "./empty-state.js";
12
13
  import { FileValueList } from "./file-value-list.js";
13
14
  import { DefaultJsonView } from "./json-view.js";
14
15
  import { DefaultLightbox } from "./lightbox.js";
@@ -88,4 +89,5 @@ export const defaultPrimitives = {
88
89
  CopyButton,
89
90
  ShareButton,
90
91
  PromoPanel,
92
+ EmptyState: DefaultEmptyState,
91
93
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cosmicdrift/kumiko-renderer",
3
- "version": "0.422.0",
3
+ "version": "0.424.1",
4
4
  "description": "React renderer for Kumiko screens. The root export holds the platform-agnostic logic (primitives contract, hooks, KumikoScreen, navigation and SSE abstractions); ./headless the DOM-free UI logic, ./live the HTTP dispatcher, ./web the browser bindings (HTML primitives, history navigation, EventSource live events, createKumikoApp).",
5
5
  "license": "MIT",
6
6
  "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -48,8 +48,8 @@
48
48
  }
49
49
  },
50
50
  "dependencies": {
51
- "@cosmicdrift/kumiko-framework": "0.422.0",
52
- "@cosmicdrift/kumiko-types": "0.422.0",
51
+ "@cosmicdrift/kumiko-framework": "0.424.1",
52
+ "@cosmicdrift/kumiko-types": "0.424.1",
53
53
  "@types/qrcode": "^1.5.6",
54
54
  "class-variance-authority": "^0.7.1",
55
55
  "clsx": "^2.1.1",
@@ -79,8 +79,8 @@
79
79
  }
80
80
  },
81
81
  "devDependencies": {
82
- "@cosmicdrift/kumiko-locale-de": "0.422.0",
83
- "@cosmicdrift/kumiko-testing": "0.422.0",
82
+ "@cosmicdrift/kumiko-locale-de": "0.424.1",
83
+ "@cosmicdrift/kumiko-testing": "0.424.1",
84
84
  "@tailwindcss/cli": "^4.3.3",
85
85
  "@testing-library/react": "^16.3.3",
86
86
  "@testing-library/user-event": "^14.6.8",
package/src/changes.json CHANGED
@@ -1,4 +1,34 @@
1
1
  [
2
+ {
3
+ "version": "0.424.1",
4
+ "type": "fix",
5
+ "title": "focus rail shows listed entries that sit inside a group",
6
+ "detail": "`focusRailNavQns` only matched top-level nav nodes, so a listed entry below a group was missing from the rail. The rail now finds listed entries at any depth and shows them in list order. When a listed entry nests in another listed tile, only the inner one is marked active, and \"More\" stays plain when a shown nested tile holds the active screen."
7
+ },
8
+ {
9
+ "version": "0.424.1",
10
+ "type": "fix",
11
+ "title": "actionForm load.passPrefill passes handoff values",
12
+ "detail": "An actionForm with `load` takes its values only from the load query. `passPrefill` sent the drawer's prefill values there but not the values of a navigation handoff (`useNavigateWithInitialValues`), so a form opened from an assistant step lost the step's values. The handoff values now travel in the load payload the same way; the query's schema must accept them."
13
+ },
14
+ {
15
+ "version": "0.424.0",
16
+ "type": "fix",
17
+ "title": "Action-form preview hides an empty list next to facts",
18
+ "detail": "`preview.list` renders only when it has rows or the preview has no `facts`, so a preview with facts and an empty list (for example a contract PDF with no rent steps) no longer shows a dashed \"No entries yet.\" box. `EditorWorkbench` no longer renders save buttons in the page header (they were a second copy of the footer's, shown from 1280px up); `EditorHeader` takes `actions` as optional."
19
+ },
20
+ {
21
+ "version": "0.424.0",
22
+ "type": "fix",
23
+ "title": "Seeding the default row of a required optionsQuery select clears its required error",
24
+ "detail": "Seeding the suggestion (`row.default`) into an empty select now clears that field's issues the same way a typed value does, so a submit before the options query had loaded no longer leaves \"required\" next to a filled field."
25
+ },
26
+ {
27
+ "version": "0.423.0",
28
+ "type": "improvement",
29
+ "title": "The \"page not available\" and \"record not found\" pages are a calm empty state with a way back",
30
+ "detail": "New optional primitive `EmptyState` (`icon` \"unavailable\" or \"not-found\", `title`, `description`, `actions`) renders a centered page with an icon in a soft circle; custom primitive sets without it keep the plain card. \"This page is not available\" now always offers a primary \"Go to start page\" button (start page from the new `HomeScreenProvider`, mounted by `createKumikoApp`, so drawers and `KumikoScreen` get it too) and a line telling the user whom to ask (new i18n key `kumiko.screen-missing.contact`, en/de/fr/es/it). The \"record not found\" page uses the same look."
31
+ },
2
32
  {
3
33
  "version": "0.422.0",
4
34
  "type": "improvement",