@cosmicdrift/kumiko-renderer 0.374.0 → 0.377.0

package/README.md

@@ -1,6 +1,6 @@
 # @cosmicdrift/kumiko-renderer
 
-Platform-agnostic React renderer for Kumiko screens: primitives contract, hooks, `KumikoScreen`, navigation and SSE abstractions. No DOM, no `EventSource`, no `react-dom`.
+React renderer for Kumiko screens: primitives contract, hooks, `KumikoScreen`, navigation and SSE abstractions. The root entry has no DOM and no `EventSource`; the subpaths add the web bindings (`/web`), UI logic (`/headless`) and the HTTP dispatcher (`/live`).
 
 ## Install
 
@@ -8,6 +8,6 @@ Platform-agnostic React renderer for Kumiko screens: primitives contract, hooks,
 bun add @cosmicdrift/kumiko-renderer
 ```
 
-Pair it with `@cosmicdrift/kumiko-renderer-web` for the browser.
+Import the browser bindings from `@cosmicdrift/kumiko-renderer/web`.
 
 Documentation: https://kumiko.rocks

package/dist/app/action-form-support.d.ts

@@ -1,6 +1,6 @@
-import type { ActionFormLoad } from "@cosmicdrift/kumiko-framework/ui-types";
-import type { DispatcherError, Translate } from "@cosmicdrift/kumiko-headless";
+import type { ActionFormLoad, ActionFormSuccessFact } from "@cosmicdrift/kumiko-framework/ui-types";
 import { type ReactNode } from "react";
+import type { DispatcherError, Translate } from "../headless/index.ts";
 /** Record id of a `load` form: the route path id, else the drawer prefill `id`
  *  (the clicked row), else the URL `id` param. Only the id is read from these
  *  sources, never another value. */
@@ -42,10 +42,17 @@ export type ResolvedSuccessLink = {
     readonly href: string;
     readonly onPress: () => void;
 };
+export type ResolvedSuccessFact = {
+    readonly key: string;
+    readonly label: string;
+    readonly lines: readonly string[];
+};
 export type ActionFormSuccessState = {
     readonly text: string;
     readonly links: readonly ResolvedSuccessLink[];
+    readonly facts: readonly ResolvedSuccessFact[];
 };
+export declare function resolveSuccessFacts(facts: readonly ActionFormSuccessFact[] | undefined, data: unknown, translate: (key: string) => string, locale: string): readonly ResolvedSuccessFact[];
 export declare function ActionFormSuccessBanner({ success, }: {
     readonly success: ActionFormSuccessState;
 }): ReactNode;

package/dist/app/action-form-support.js

@@ -68,7 +68,29 @@ export function ActionFormLoadStatus({ state, screenId, translate, }) {
             return (_jsxs(Banner, { padded: true, variant: "error", testId: "kumiko-screen-action-form-missing-id", children: ["Screen ", _jsx(Text, { variant: "code", children: screenId }), " (actionForm with load) needs a record id in the path or the clicked row."] }));
     }
 }
+function factLine(entry, locale) {
+    if (typeof entry === "number")
+        return entry.toLocaleString(locale);
+    if (typeof entry === "string")
+        return entry;
+    if (typeof entry === "object" && entry !== null && "label" in entry) {
+        return typeof entry.label === "string" ? entry.label : undefined;
+    }
+    return undefined;
+}
+export function resolveSuccessFacts(facts, data, translate, locale) {
+    const resolved = [];
+    (facts ?? []).forEach((fact, index) => {
+        const value = propertyOf(data, fact.field);
+        const entries = Array.isArray(value) ? value : [value];
+        const lines = entries.flatMap((entry) => factLine(entry, locale) ?? []);
+        if (lines.length > 0) {
+            resolved.push({ key: String(index), label: translate(fact.label), lines });
+        }
+    });
+    return resolved;
+}
 export function ActionFormSuccessBanner({ success, }) {
-    const { Banner, Link } = usePrimitives();
-    return (_jsxs(Banner, { variant: "info", testId: "action-form-success", children: [success.text, success.links.map((link) => (_jsx(Link, { href: link.href, onPress: link.onPress, className: "ml-2 underline", testId: `action-form-success-link-${link.key}`, children: link.label }, link.key)))] }));
+    const { Banner, Link, Text } = usePrimitives();
+    return (_jsxs(Banner, { variant: "info", testId: "action-form-success", children: [success.text, success.facts.map((fact) => (_jsxs(Text, { testId: `action-form-success-fact-${fact.key}`, children: [fact.label, ": ", fact.lines.join(", ")] }, fact.key))), success.links.map((link) => (_jsx(Link, { href: link.href, onPress: link.onPress, className: "ml-2 underline", testId: `action-form-success-link-${link.key}`, children: link.label }, link.key)))] }));
 }

package/dist/app/client-actions.d.ts

@@ -1,6 +1,6 @@
 import type { RowActionClientAction } from "@cosmicdrift/kumiko-framework/ui-types";
-import type { Translate } from "@cosmicdrift/kumiko-headless";
 import { type ReactNode } from "react";
+import type { Translate } from "../headless/index.ts";
 export type ClientActionOutcome = {
     readonly ok: true;
 }
@@ -16,7 +16,7 @@ export type ActionNotice = {
     readonly text: string;
 };
 /** Shows the outcome of a client action. The platform layer provides it
- *  (renderer-web: a toast); without one a failure is thrown to the action
+ *  (renderer/web: a toast); without one a failure is thrown to the action
  *  host's own error surface and a success stays silent. */
 export type ActionNotifier = (notice: ActionNotice) => void;
 export type ClientActionRuntime = {

package/dist/app/column-renderers.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 // Column-Renderer-Map: client-side Lookup für ListColumn-Spalten die im
 // Schema einen PlatformComponent-Renderer (`{ react: { __component: "Name" } }`)
-// statt einer String-Funktion angeben. createKumikoApp im renderer-web sammelt
+// statt einer String-Funktion angeben. createKumikoApp im renderer/web sammelt
 // alle clientFeatures.columnRenderers und mountet den Provider; der DataTable-
 // Cell-Renderer schlägt den Component über `useColumnRenderer(name)` nach.
 //

package/dist/app/config-edit-shim.js

@@ -12,8 +12,8 @@
 // zukünftiger Boot-Validator die schema.entities-Map cross-referenziert,
 // brechen die Type-Lies hier silent. Dann ist Zeit für eine echte
 // RenderConfigEdit-Komponente die direkt fields nimmt.
-import { I18N_KEY_PARAM } from "@cosmicdrift/kumiko-headless";
 import * as z from "zod";
+import { I18N_KEY_PARAM } from "../headless/index.js";
 const CONFIG_EDIT_PSEUDO_ENTITY = "__config-edit__";
 /** Baut eine minimale EntityDefinition aus den Inline-Fields des
  *  ConfigEdit-Screens. RenderEdit + computeEditViewModel iterieren

package/dist/app/content-preview.js

@@ -1,11 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-// Read-only render of a content editor's format with the collection's
-// example variableSchema values substituted in for `{{name}}` — reuses the
-// same registered editor the collection edits with (readOnly), so "rich"
-// renders formatted HTML and "plain"/"markdown" render as text through the
-// exact same component, no separate render path per format.
-import { escapeHtmlAttr } from "@cosmicdrift/kumiko-headless";
 import { useId } from "react";
+import { escapeHtmlAttr } from "../headless/index.js";
 import { useContentEditor } from "./content-editors.js";
 const VARIABLE_PATTERN = /\{\{\s*(\w+)\s*\}\}/g;
 const noop = () => { };

package/dist/app/custom-screens.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 // Custom-Screen-Components-Map: client-side Lookup für Screens vom Typ
 // `custom`. KumikoScreen schaut hier nach `screen.id` (oder qn) und
-// rendert die passende Component. createKumikoApp im renderer-web sammelt
+// rendert die passende Component. createKumikoApp im renderer/web sammelt
 // alle clientFeatures.components und mountet den Provider; Tests die
 // einzelne Custom-Screens prüfen wollen, mounten den Provider direkt.
 import { createContext, useContext } from "react";

package/dist/app/dashboard-body.d.ts

@@ -1,6 +1,6 @@
 import type { DashboardScreenDefinition } from "@cosmicdrift/kumiko-framework/ui-types";
-import type { Translate } from "@cosmicdrift/kumiko-headless";
 import { type ComponentType, type ReactNode } from "react";
+import type { Translate } from "../headless/index.ts";
 export type DashboardBodyProps = {
     readonly featureName: string;
     readonly screen: DashboardScreenDefinition;

package/dist/app/entity-list-expanded-row.d.ts

@@ -1,6 +1,6 @@
 import type { RowActionDrawer } from "@cosmicdrift/kumiko-framework/ui-types";
-import type { EditRelatedListSectionViewModel, ListRowViewModel, Translate } from "@cosmicdrift/kumiko-headless";
 import { type ReactNode } from "react";
+import type { EditRelatedListSectionViewModel, ListRowViewModel, Translate } from "../headless/index.ts";
 export declare function EntityListExpandedRow({ section, row, featureName, translate, expansionNonce, openDrawer, onAfterWrite, onSubListInvalidated, }: {
     readonly section: EditRelatedListSectionViewModel;
     readonly row: ListRowViewModel;

package/dist/app/form-schema.d.ts

@@ -1,6 +1,6 @@
 import type { EntityDefinition, EntityEditScreenDefinition } from "@cosmicdrift/kumiko-framework/ui-types";
-import { type EditFormMode } from "@cosmicdrift/kumiko-headless";
 import * as z from "zod";
+import { type EditFormMode } from "../headless/index.ts";
 export declare function isPresent(value: unknown): boolean;
 export declare const REQUIRED_FIELD_I18N_KEY = "kumiko.validation.required";
 export declare const OPTION_NOT_AVAILABLE_I18N_KEY = "kumiko.validation.optionNotAvailable";

package/dist/app/form-schema.js

@@ -1,6 +1,6 @@
 import { evalFieldCondition, findUnavailableSelectOptions, isUnchangedValue, NO_WIDGET_FIELD_TYPES, } from "@cosmicdrift/kumiko-framework/ui-types";
-import { I18N_KEY_PARAM } from "@cosmicdrift/kumiko-headless";
 import * as z from "zod";
+import { I18N_KEY_PARAM } from "../headless/index.js";
 import { layoutEditFields } from "./layout-fields.js";
 // `required` means "has a value", not "is truthy" — `false` and `0` count
 // as present, only the actually-empty representations don't.
@@ -103,7 +103,7 @@ export function buildFormSchema(entity, screen, verb, unchangedFrom) {
                 code: "custom",
                 path: [spec.field],
                 message: `"${spec.field}" is required.`,
-                // I18N_KEY_PARAM override, see packages/headless/src/form/zod-bridge.ts.
+                // I18N_KEY_PARAM override, see packages/renderer/src/headless/form/zod-bridge.ts.
                 params: { [I18N_KEY_PARAM]: REQUIRED_FIELD_I18N_KEY },
             });
         }

package/dist/app/kumiko-screen.d.ts

@@ -1,6 +1,6 @@
 import type { ScreenDefinition } from "@cosmicdrift/kumiko-framework/ui-types";
-import type { FormValues, ListRowViewModel, Translate } from "@cosmicdrift/kumiko-headless";
 import { type ReactNode } from "react";
+import type { FormValues, ListRowViewModel, Translate } from "../headless/index.ts";
 import { type ListSort } from "../hooks/use-list-url-state.ts";
 import type { FeatureSchema } from "./feature-schema.ts";
 import { qualifyScreenId } from "./qualify-screen-id.ts";

package/dist/app/kumiko-screen.js

@@ -1,6 +1,5 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { evalFieldCondition, isRecordLocked, isWriteFormEditSection, metricField, parseRefTarget, } from "@cosmicdrift/kumiko-framework/ui-types";
-import { applyFormatSpec, buildOptionLabels, computeRelatedListSectionViewModel, fieldLabelKey, fieldOptionLabelKey, isSafeHref, } from "@cosmicdrift/kumiko-headless";
 import { resolveActionIcon } from "@cosmicdrift/kumiko-types/action-icon";
 import { TENANT_CURRENCY_CONFIG_KEY } from "@cosmicdrift/kumiko-types/fields";
 import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
@@ -14,6 +13,7 @@ import { useDispatcher, useOptionalDispatcher } from "../context/dispatcher-cont
 import { useIsEmbeddedScreen } from "../context/embedded-screen-context.js";
 import { useUserRoles } from "../context/user-roles-context.js";
 import { useOptionalCurrentUser } from "../current-user.js";
+import { applyFormatSpec, buildOptionLabels, computeRelatedListSectionViewModel, fieldLabelKey, fieldOptionLabelKey, isSafeHref, } from "../headless/index.js";
 import { REFERENCE_LIST_LOOKUP_LIMIT } from "../hooks/reference-limits.js";
 import { PAGE_SIZE_OPTIONS, useListUrlState } from "../hooks/use-list-url-state.js";
 import { useQuery } from "../hooks/use-query.js";
@@ -24,7 +24,7 @@ import { PageHeaderSlotAvailableProvider, usePageHeaderCompact, usePageHeaderSlo
 import { statusToneForOptionTone, statusToneForValue, usePrimitives, } from "../primitives.js";
 import { screenFillsHeight } from "../screen-fills-height.js";
 import { actionFormSubmittableFields, synthesizeActionFormEntity, synthesizeActionFormScreen, } from "./action-form-shim.js";
-import { ActionFormLoadStatus, ActionFormSuccessBanner, isSecretFormField, resolveActionFormRecordId, useActionFormLoad, } from "./action-form-support.js";
+import { ActionFormLoadStatus, ActionFormSuccessBanner, isSecretFormField, resolveActionFormRecordId, resolveSuccessFacts, useActionFormLoad, } from "./action-form-support.js";
 import { useAppFeatures } from "./app-features-context.js";
 import { useClientActionRuntime } from "./client-actions.js";
 import { buildConfigEditSchema, synthesizeConfigEditEntity, synthesizeConfigEditScreen, } from "./config-edit-shim.js";
@@ -190,12 +190,12 @@ function renderScreenBody({ schema, screen, translate, entityId, onRowClick, onC
 }
 // Injection-Body für dashboard-Screens: die Panel-Implementierung (StatCard,
 // Charts) ist plattform-spezifisch und kommt aus dem DashboardBody-Context
-// (renderer-web registriert die Web-Variante in createKumikoApp).
+// (renderer/web registriert die Web-Variante in createKumikoApp).
 function DashboardScreenBody({ featureName, screen, translate, }) {
     const { Banner, Text } = usePrimitives();
     const Body = useDashboardBody();
     if (Body === undefined) {
-        return (_jsxs(Banner, { padded: true, variant: "info", testId: "kumiko-screen-dashboard-placeholder", children: ["Dashboard screen ", _jsx(Text, { variant: "code", children: screen.id }), " \u2014 kein Dashboard-Body registriert (createKumikoApp aus ", _jsx(Text, { variant: "code", children: "kumiko-renderer-web" }), " wired ihn automatisch)."] }));
+        return (_jsxs(Banner, { padded: true, variant: "info", testId: "kumiko-screen-dashboard-placeholder", children: ["Dashboard screen ", _jsx(Text, { variant: "code", children: screen.id }), " \u2014 no dashboard body registered (createKumikoApp from ", _jsx(Text, { variant: "code", children: "kumiko-renderer/web" }), " wires it automatically)."] }));
     }
     return (_jsx(Body, { featureName: featureName, screen: screen, ...(translate !== undefined && { translate }) }));
 }
@@ -1448,7 +1448,7 @@ function EntityListBody({ schema, screen, entity, translate, onRowClick, }) {
     const runNavigate = useCallback((action, row) => {
         if (action.entity !== undefined) {
             // Entity-Targets (fw#2228) lösen sich erst in der NavApi-Impl gegen
-            // ALLE Features auf (resolveTarget in renderer-web/nav.tsx) — dieses
+            // ALLE Features auf (resolveTarget in renderer/web/nav.tsx) — dieses
             // Package kennt nur `schema` (das eine aufrufende Feature) und kann
             // detailFor cross-feature nicht selbst nachschlagen.
             const explicit = action.entityId !== undefined ? String(row.values[action.entityId] ?? "") : undefined;
@@ -2573,13 +2573,14 @@ function ActionFormBody({ schema, screen, translate, entityId, initialOverrides,
             return;
         }
         if (screen.redirect === undefined) {
-            const hasSuccessLinks = (screen.successLinks?.length ?? 0) > 0;
+            const hasSuccessLinks = (screen.successLinks?.length ?? 0) > 0 || (screen.successFacts?.length ?? 0) > 0;
             const publish = (text) => {
                 if (successSequence.current !== sequence)
                     return;
                 setSuccess({
                     text,
                     links: resolveSuccessLinks(screen.successLinks, result.data, schema, appFeatures, nav, effectiveTranslate),
+                    facts: resolveSuccessFacts(screen.successFacts, result.data, effectiveTranslate, locale),
                 });
             };
             const messageKey = screen.successMessage;

package/dist/app/list-empty-content.d.ts

@@ -1,6 +1,6 @@
 import type { ListEmptyStateSpec } from "@cosmicdrift/kumiko-framework/ui-types";
-import type { Translate } from "@cosmicdrift/kumiko-headless";
 import type { ListEmptyStateContent } from "../components/list-empty-state.tsx";
+import type { Translate } from "../headless/index.ts";
 import { buildRecordActions } from "./row-actions.ts";
 type ActionBindings = Pick<Parameters<typeof buildRecordActions>[0], "nav" | "host" | "dispatcher" | "openDrawer" | "onWriteSuccess" | "clientActions">;
 export declare function useListEmptyContent(spec: ListEmptyStateSpec | undefined, translate: Translate, bindings: ActionBindings): ListEmptyStateContent | undefined;

package/dist/app/list-facets.d.ts

@@ -1,5 +1,5 @@
 import type { EntityListFacetConfig, ListFacetSpec } from "@cosmicdrift/kumiko-framework/ui-types";
-import type { Translate } from "@cosmicdrift/kumiko-headless";
+import type { Translate } from "../headless/index.ts";
 import type { DataTableFacet, DataTableFacetChip } from "../primitives.tsx";
 export type ResolvedFacetSpec = {
     readonly field: string;

package/dist/app/nav.js

@@ -76,7 +76,7 @@ export function hasDetailScreen(features, entity) {
 }
 // Resolves a NavTarget to the ScreenTarget form navigate/replace/hrefFor
 // operate on. Pure — no context, no I/O — so callers can use it outside
-// React too (see resolve-at-NavApi-build alternative in renderer-web).
+// React too (see resolve-at-NavApi-build alternative in renderer/web).
 export function resolveTarget(features, target) {
     if ("screenId" in target)
         return target;
@@ -151,7 +151,7 @@ export function useOptionalNav() {
 export function useNav() {
     const api = useContext(NavContext);
     if (api === undefined) {
-        throw new Error("useNav: no <NavProvider> mounted above this component. Plattform-Packages (z.B. @cosmicdrift/kumiko-renderer-web) liefern eine Default-Impl über createKumikoApp.");
+        throw new Error("useNav: no <NavProvider> mounted above this component. Plattform-Packages (z.B. @cosmicdrift/kumiko-renderer/web) liefern eine Default-Impl über createKumikoApp.");
     }
     return api;
 }

package/dist/app/query-state-banners.d.ts

@@ -1,5 +1,5 @@
-import type { DispatcherError, Translate } from "@cosmicdrift/kumiko-headless";
 import type { ReactNode } from "react";
+import type { DispatcherError, Translate } from "../headless/index.ts";
 export declare function QueryLoadingBanner(): ReactNode;
 export declare function QueryErrorBanner({ error, translate, onRetry, }: {
     readonly error: DispatcherError;

package/dist/app/reference-link.d.ts

@@ -1,4 +1,4 @@
-import type { CellLink } from "@cosmicdrift/kumiko-headless";
+import type { CellLink } from "../headless/index.ts";
 /** Link to a referenced record's detail screen, or undefined when there is no
  *  navigation, the user may not open that screen, or no detail screen exists. */
 export type ReferenceLinkResolver = (refEntity: string, id: string) => CellLink | undefined;

package/dist/app/row-actions.d.ts

@@ -1,7 +1,7 @@
 import type { EntityEditScreenDefinition, RelatedListToolbarAction, RowAction, RowActionClientAction, RowActionDrawer, RowActionNavigate, RowActionWriteHandler, RowFieldExtractor, ToolbarAction } from "@cosmicdrift/kumiko-framework/ui-types";
-import type { Dispatcher, ListRowViewModel, Translate } from "@cosmicdrift/kumiko-headless";
 import type { RenderEditAction } from "../components/render-edit-types.ts";
 import type { ToolbarActionButton } from "../components/render-list.tsx";
+import type { Dispatcher, ListRowViewModel, Translate } from "../headless/index.ts";
 import type { DataTableRowAction } from "../primitives.tsx";
 import { type ClientActionRuntime } from "./client-actions.tsx";
 import type { NavApi } from "./nav.tsx";

package/dist/app/secret-mint-body.d.ts

@@ -1,6 +1,6 @@
 import type { SecretMintScreenDefinition } from "@cosmicdrift/kumiko-framework/ui-types";
-import type { Translate } from "@cosmicdrift/kumiko-headless";
 import { type ReactNode } from "react";
+import type { Translate } from "../headless/index.ts";
 import type { FeatureSchema } from "./feature-schema.ts";
 export type SecretMintBodyProps = {
     readonly schema: FeatureSchema;

package/dist/app/secrets-edit-body.d.ts

@@ -1,6 +1,6 @@
 import type { SecretsEditScreenDefinition } from "@cosmicdrift/kumiko-framework/ui-types";
-import type { Translate } from "@cosmicdrift/kumiko-headless";
 import { type ReactNode } from "react";
+import type { Translate } from "../headless/index.ts";
 export type SecretsEditBodyProps = {
     readonly screen: SecretsEditScreenDefinition;
     readonly translate?: Translate;

package/dist/app/use-record-actions.d.ts

@@ -1,6 +1,6 @@
 import type { RowAction } from "@cosmicdrift/kumiko-framework/ui-types";
-import type { Translate } from "@cosmicdrift/kumiko-headless";
 import type { RenderEditAction } from "../components/render-edit-types.ts";
+import type { Translate } from "../headless/index.ts";
 /** Header actions on a record shown by a screen that has no drawer host
  *  (dashboards): writeHandler, navigate and clientAction, `onWriteSuccess` after a success. */
 export declare function useRecordActions(options: {

package/dist/app/write-failed-error.d.ts

@@ -1,4 +1,4 @@
-import type { DispatcherError } from "@cosmicdrift/kumiko-headless";
+import type { DispatcherError } from "../headless/index.ts";
 export declare class WriteFailedError extends Error {
     readonly dispatcherError: DispatcherError;
     constructor(error: DispatcherError, message: string);

package/dist/components/availability-options-select.d.ts

@@ -1,6 +1,6 @@
-import type { EditFieldViewModel } from "@cosmicdrift/kumiko-headless";
 import type { OptionsQueryPayload } from "@cosmicdrift/kumiko-types/fields";
 import { type ReactNode } from "react";
+import type { EditFieldViewModel } from "../headless/index.ts";
 export type SelectOptionEntry = {
     readonly value: string;
     readonly label: string;

package/dist/components/embedded-list-field.d.ts

@@ -1,5 +1,5 @@
-import type { EditFieldViewModel, FieldIssue } from "@cosmicdrift/kumiko-headless";
 import { type ReactNode } from "react";
+import type { EditFieldViewModel, FieldIssue } from "../headless/index.ts";
 export type EmbeddedListFieldProps = {
     readonly field: EditFieldViewModel;
     readonly id: string;

package/dist/components/embedded-list-field.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { computeDerivedCellValue, currencyDecimals, groupEmbeddedListIssues, roundDerivedCellValue, sumEmbeddedListColumn, } from "@cosmicdrift/kumiko-headless";
 import { useState } from "react";
+import { computeDerivedCellValue, currencyDecimals, groupEmbeddedListIssues, roundDerivedCellValue, sumEmbeddedListColumn, } from "../headless/index.js";
 import { REFERENCE_COMBOBOX_LIMIT } from "../hooks/reference-limits.js";
 import { useQuery } from "../hooks/use-query.js";
 import { referenceOptionSource } from "../hooks/use-reference-lookup.js";

package/dist/components/file-list-field.d.ts

@@ -1,5 +1,5 @@
-import type { EditFieldViewModel } from "@cosmicdrift/kumiko-headless";
 import type { ReactNode } from "react";
+import type { EditFieldViewModel } from "../headless/index.ts";
 export type FileListFieldProps = {
     readonly field: EditFieldViewModel;
     readonly id: string;

package/dist/components/grid-cell-for-field.d.ts

@@ -1,5 +1,5 @@
-import type { EditFieldViewModel, FieldIssue } from "@cosmicdrift/kumiko-headless";
 import type { ReactNode } from "react";
+import type { EditFieldViewModel, FieldIssue } from "../headless/index.ts";
 import type { FieldCellWidth, FieldProps, usePrimitives } from "../primitives.tsx";
 export type GridCellForFieldProps = {
     readonly field: EditFieldViewModel;

package/dist/components/multi-select-checkboxes.d.ts

@@ -1,5 +1,5 @@
-import type { EditFieldViewModel } from "@cosmicdrift/kumiko-headless";
 import type { ReactNode } from "react";
+import type { EditFieldViewModel } from "../headless/index.ts";
 export type MultiSelectCheckboxOption = {
     readonly value: string;
     readonly label: string;

package/dist/components/multi-select-checkboxes.js

@@ -5,7 +5,7 @@ import { usePrimitives } from "../primitives.js";
 // as a visible checkbox plus a select-all toggle, built purely from the
 // platform-neutral Primitives contract (Grid/GridCell/Field/Input kind
 // "boolean", the same primitive `case "boolean"` uses in render-field.tsx).
-// No renderer-web import here — this file must stay usable from Expo too.
+// No renderer/web import here — this file must stay usable from Expo too.
 export function MultiSelectCheckboxes({ field, id, options, value, onChange, }) {
     const { Grid, GridCell, Field, Input, Button } = usePrimitives();
     const t = useTranslation();

package/dist/components/query-options-select.d.ts

@@ -1,6 +1,6 @@
-import type { EditFieldViewModel } from "@cosmicdrift/kumiko-headless";
 import { type OptionsQueryPayload } from "@cosmicdrift/kumiko-types/fields";
 import { type ReactNode } from "react";
+import type { EditFieldViewModel } from "../headless/index.ts";
 type ResolvedOptionsQueryPayload = Readonly<Record<string, string | number | boolean>>;
 export declare function resolveOptionsQueryPayload(payload: OptionsQueryPayload, row: Readonly<Record<string, unknown>>): ResolvedOptionsQueryPayload;
 type QueryOptionsSelectProps = {

package/dist/components/related-list-section.d.ts

@@ -1,6 +1,6 @@
 import type { RowActionDrawer } from "@cosmicdrift/kumiko-framework/ui-types";
-import type { EditRelatedListSectionViewModel, Translate } from "@cosmicdrift/kumiko-headless";
 import { type ReactNode } from "react";
+import type { EditRelatedListSectionViewModel, Translate } from "../headless/index.ts";
 export declare function RelatedListSection({ section, parentId, record, featureName, translate, hideTitle, grow, onOpenDrawer, actions, embedded, onAfterWrite, refreshToken, }: {
     readonly section: EditRelatedListSectionViewModel;
     readonly parentId: string;

package/dist/components/render-edit-logic.d.ts

@@ -1,4 +1,4 @@
-import type { DispatcherError, EditFieldViewModel, EditSectionViewModel, SubmitResult } from "@cosmicdrift/kumiko-headless";
+import type { DispatcherError, EditFieldViewModel, EditSectionViewModel, SubmitResult } from "../headless/index.ts";
 export declare function hasEditableSection(sections: readonly EditSectionViewModel[]): boolean;
 export declare function resolveExtensionEntityId(entityIdProp: string | null | undefined, vmId: string | null): string | null;
 export declare function shouldNotifyCaller(result: SubmitResult<unknown>, extensionsPersisted: boolean): boolean;

package/dist/components/render-edit-types.d.ts

@@ -1,7 +1,7 @@
 import type { ActionFormFooterAction, EntityDefinition, EntityEditScreenDefinition, IconKey, RowAction, RowActionDrawer } from "@cosmicdrift/kumiko-framework/ui-types";
-import type { DispatcherError, FormSnapshot, FormValues, SubmitResult, Translate } from "@cosmicdrift/kumiko-headless";
 import type { ReactNode } from "react";
 import type * as z from "zod";
+import type { DispatcherError, FormSnapshot, FormValues, SubmitResult, Translate } from "../headless/index.ts";
 export type RenderEditProps<TValues extends FormValues, TCtx = unknown> = {
     readonly screen: EntityEditScreenDefinition;
     /** Screen id used for the `screen:<id>.title`/`.subtitle` lookups and as the
@@ -59,7 +59,7 @@ export type RenderEditProps<TValues extends FormValues, TCtx = unknown> = {
     /** Copy-link action (issue #912) — only set in update mode (create mode
      *  has no entity id yet, hence no permalink). The callback is already fully
      *  bound (URL building + clipboard happen outside, in
-     *  `@cosmicdrift/kumiko-renderer-web`'s RoutedScreen — this platform-neutral
+     *  `@cosmicdrift/kumiko-renderer/web`'s RoutedScreen — this platform-neutral
      *  package must not touch `navigator`/`window`, see
      *  guard-renderer-boundaries). undefined = no button. */
     readonly onCopyLink?: () => Promise<void> | void;

package/dist/components/render-edit.d.ts

@@ -1,4 +1,4 @@
-import type { FormValues } from "@cosmicdrift/kumiko-headless";
+import type { FormValues } from "../headless/index.ts";
 import type { RenderEditProps } from "./render-edit-types.ts";
 export type { RenderEditAction, RenderEditChangeState, RenderEditControls, RenderEditProps, } from "./render-edit-types.ts";
 import { type ReactNode } from "react";

package/dist/components/render-edit.js

@@ -1,7 +1,7 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { evalFieldCondition, isFieldsEditSection, normalizeEditField, PROJECTION_DETAIL_ENTITY, sectionFieldSpecs, } from "@cosmicdrift/kumiko-framework/ui-types";
-import { computeEditViewModel, groupIssuesByPath, relevantFieldIssues, zodErrorToFieldIssues, } from "@cosmicdrift/kumiko-headless";
 import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
+import { computeEditViewModel, groupIssuesByPath, relevantFieldIssues, zodErrorToFieldIssues, } from "../headless/index.js";
 import { RenderEditActionButton } from "./render-edit-action-button.js";
 import { AllFieldsRequiredProvider } from "./render-field.js";
 import { useActionMenuItems } from "./use-action-menu-items.js";
@@ -1075,6 +1075,7 @@ export function RenderEdit(props) {
     wizardBackRef.current = isWizard ? handleWizardBack : () => { };
     // Screen forms (entityEdit/actionForm filling the shell height) drop the card;
     // the title then lives in the shell header when the shell offers a slot.
+    const rootIssues = snapshot.errors[ROOT_ISSUE_PATH] ?? [];
     const isScreenForm = fillScreenHeight === true && hideSectionTitles !== true && !insideDrawer;
     const titleInShell = PageHeader !== undefined &&
         pageHeaderSlotAvailable &&
@@ -1480,7 +1481,8 @@ export function RenderEdit(props) {
                                     onReload();
                                     setFormError(null);
                                     setExtraDeleteIssues([]);
-                                }, testId: "render-edit-form-error-reload", children: translate("kumiko.actions.reload") })) : undefined, children: [_jsx(Text, { testId: "render-edit-form-error-key", children: translate(formError.i18nKey, formError.i18nParams) }), extraDeleteIssues.map((issue) => (_jsx(Text, { testId: "render-edit-form-error-extra", children: translate(issue.i18nKey, issue.params) }, `${issue.path}:${issue.i18nKey}`)))] })), (snapshot.errors[ROOT_ISSUE_PATH] ?? []).map((issue) => (_jsx(Banner, { variant: "error", testId: "render-edit-root-issue", children: _jsx(Text, { children: translate(issue.i18nKey, issue.params) }) }, issue.i18nKey))), extensionErrorKey !== null && (_jsx(Banner, { variant: "error", testId: "render-edit-extension-error", children: _jsx(Text, { testId: "render-edit-extension-error-key", children: translate(extensionErrorKey) }) })), actionError !== null && (_jsx(Banner, { variant: "error", testId: "render-edit-action-error", children: actionError })), onDelete !== undefined && (_jsx(Dialog, { open: confirmDeleteOpen, onOpenChange: setConfirmDeleteOpen, title: translate("kumiko.actions.delete-confirm"), confirmLabel: translate("kumiko.actions.delete"), variant: "danger", onConfirm: async () => {
+                                }, testId: "render-edit-form-error-reload", children: translate("kumiko.actions.reload") })) : undefined, children: [_jsx(Text, { testId: "render-edit-form-error-key", children: translate(formError.i18nKey, formError.i18nParams) }), rootIssues.map((issue) => (_jsx(Text, { testId: "render-edit-form-error-root", children: translate(issue.i18nKey, issue.params) }, `${issue.path}:${issue.i18nKey}`))), extraDeleteIssues.map((issue) => (_jsx(Text, { testId: "render-edit-form-error-extra", children: translate(issue.i18nKey, issue.params) }, `${issue.path}:${issue.i18nKey}`)))] })), formError === null &&
+                            rootIssues.map((issue) => (_jsx(Banner, { variant: "error", testId: "render-edit-root-issue", children: _jsx(Text, { children: translate(issue.i18nKey, issue.params) }) }, issue.i18nKey))), extensionErrorKey !== null && (_jsx(Banner, { variant: "error", testId: "render-edit-extension-error", children: _jsx(Text, { testId: "render-edit-extension-error-key", children: translate(extensionErrorKey) }) })), actionError !== null && (_jsx(Banner, { variant: "error", testId: "render-edit-action-error", children: actionError })), onDelete !== undefined && (_jsx(Dialog, { open: confirmDeleteOpen, onOpenChange: setConfirmDeleteOpen, title: translate("kumiko.actions.delete-confirm"), confirmLabel: translate("kumiko.actions.delete"), variant: "danger", onConfirm: async () => {
                                 const rejection = await onDelete();
                                 // A rejected delete (e.g. a preDelete hook) carries its reason in
                                 // the field issues; the top-level key is only "validation failed".

package/dist/components/render-field.d.ts

@@ -1,5 +1,5 @@
-import { type EditFieldViewModel, type FieldIssue } from "@cosmicdrift/kumiko-headless";
 import { type ReactNode } from "react";
+import { type EditFieldViewModel, type FieldIssue } from "../headless/index.ts";
 import { type FieldProps } from "../primitives.tsx";
 export type RenderFieldProps = {
     readonly field: EditFieldViewModel;

package/dist/components/render-field.js

@@ -1,6 +1,5 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { isFormatSpec, SYSTEM_REFERENCE_LABELS, } from "@cosmicdrift/kumiko-framework/ui-types";
-import { applyFormatSpec, currencyDecimals, EMPTY_VALUE_PLACEHOLDER, } from "@cosmicdrift/kumiko-headless";
 import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
 import { createContext, Fragment, useCallback, useContext, useEffect, useMemo, useRef, useState, } from "react";
 import { useAppFeatures } from "../app/app-features-context.js";
@@ -12,6 +11,7 @@ import { evalRowExtractor } from "../app/row-actions.js";
 import { screenAccessAllows } from "../app/screen-access.js";
 import { useOptionalDispatcher } from "../context/dispatcher-context.js";
 import { useUserRoles } from "../context/user-roles-context.js";
+import { applyFormatSpec, currencyDecimals, EMPTY_VALUE_PLACEHOLDER, } from "../headless/index.js";
 import { REFERENCE_COMBOBOX_LIMIT } from "../hooks/reference-limits.js";
 import { useQuery } from "../hooks/use-query.js";
 import { referenceOptionSource } from "../hooks/use-reference-lookup.js";
@@ -494,6 +494,9 @@ function renderInput({ field, id, hasError, onChange, Input, appLocale, Banner,
             if (field.type === "text" && field.format === "password") {
                 return (_jsx(Input, { kind: "password", ...common, value: stringValue(field.value), onChange: (v) => onChange(v) }));
             }
+            if (field.type === "text" && field.format === "month") {
+                return (_jsx(Input, { kind: "month", ...common, value: stringValue(field.value), onChange: (v) => onChange(v) }));
+            }
             // text + unknown scalar type → text input. If TextFieldDef.multiline
             // is set (the view-model carries it), the renderer switches to
             // textarea. longText always renders a textarea — that's the point of

package/dist/components/render-list.d.ts

@@ -1,6 +1,6 @@
 import type { EntityDefinition, EntityListScreenDefinition, IconKey } from "@cosmicdrift/kumiko-framework/ui-types";
-import type { ListRowViewModel, Translate } from "@cosmicdrift/kumiko-headless";
 import { type ReactNode } from "react";
+import type { ListRowViewModel, Translate } from "../headless/index.ts";
 import type { ListSort } from "../hooks/use-list-url-state.ts";
 import { type DataTableDateRangeFacet, type DataTableFacet, type DataTableProps, type DataTableRowAction, type DataTableRowActionMode, type DataTableRowGrouping } from "../primitives.tsx";
 import { type ListEmptyStateContent } from "./list-empty-state.tsx";

package/dist/components/render-list.js

@@ -1,8 +1,8 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { computeListViewModel, EMPTY_VALUE_PLACEHOLDER } from "@cosmicdrift/kumiko-headless";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { extensionSectionName, useExtensionSectionComponent } from "../app/extension-sections.js";
 import { useReferenceLinkResolver } from "../app/reference-link.js";
+import { computeListViewModel, EMPTY_VALUE_PLACEHOLDER } from "../headless/index.js";
 import { useReferenceLookup } from "../hooks/use-reference-lookup.js";
 import { useTranslation } from "../i18n.js";
 import { usePageHeaderCompact, usePageHeaderSlotAvailable } from "../page-header-slot.js";
@@ -104,7 +104,7 @@ export function RenderList(props) {
             const labelField = col.refLabelField ?? "id";
             const refEntity = col.refEntity ?? "";
             // Only a row the user can see is linkable: resolved by the server
-            // eagerload or by the lookup query. A multi-reference stays text.
+            // eagerload or by the lookup query. A multi-reference links per entry via linkItemsFor.
             const linkFor = (value, row) => {
                 if (value === null || value === undefined || value === "" || Array.isArray(value)) {
                     return undefined;
@@ -118,6 +118,22 @@ export function RenderList(props) {
                     map?.has(id);
                 return resolved === true ? resolveReferenceLink(refEntity, id) : undefined;
             };
+            const linkItemsFor = (value, row) => {
+                if (!Array.isArray(value) || value.length === 0)
+                    return undefined;
+                const eagerloaded = eagerloadedRef(row, col.field);
+                const eagerById = new Map(Array.isArray(eagerloaded) ? eagerloaded.map((r) => [String(r["id"]), r]) : []);
+                return value.map((v) => {
+                    const id = String(v);
+                    const target = eagerById.get(id);
+                    const label = String(target?.[labelField] ?? map?.get(id) ?? id);
+                    // Only a row the user can see is linkable: server eagerload or lookup query.
+                    const link = target !== undefined || map?.has(id) === true
+                        ? resolveReferenceLink(refEntity, id)
+                        : undefined;
+                    return { id, label, ...(link !== undefined && { link }) };
+                });
+            };
             const renderer = (value, row) => {
                 // Tier 2.7e Server-Eagerload: wenn der Server _refs mit-
                 // schickt, lesen wir den Display-Wert direkt aus der
@@ -142,7 +158,7 @@ export function RenderList(props) {
                 const idStr = String(value);
                 return map?.get(idStr) ?? idStr;
             };
-            return { ...col, renderer, linkFor };
+            return { ...col, renderer, linkFor, linkItemsFor };
         });
     }, [vm.columns, referenceColumns, referenceLookups, resolveReferenceLink]);
     const enrichedVm = useMemo(() => ({
@@ -190,7 +206,7 @@ export function RenderList(props) {
     // Wenn weder onCreate noch ein Override gegeben ist, fällt die
     // DataTable auf den DataTable-Default zurück (`kumiko.list.no-entries`).
     const composedEmptyState = emptyState ??
-        (onCreate !== undefined || emptyContent !== undefined || narrowed ? (_jsx(ListEmptyStateBody, { content: emptyContent, narrowed: narrowed, translate: translate, createButton: onCreate !== undefined && !narrowed ? (_jsx(Button, { variant: "primary", icon: "plus", onClick: onCreate, testId: "render-list-empty-create", children: effectiveCreateLabel })) : undefined })) : undefined);
+        (onCreate !== undefined || emptyContent !== undefined || narrowed ? (_jsx(ListEmptyStateBody, { content: emptyContent, narrowed: narrowed, translate: translate, createButton: onCreate !== undefined && !narrowed && !createInPageHeader ? (_jsx(Button, { variant: "primary", icon: "plus", onClick: onCreate, testId: "render-list-empty-create", children: effectiveCreateLabel })) : undefined })) : undefined);
     // Title-Resolution: ein konventioneller i18n-Key `screen:<id>.title`.
     // Wenn das Bundle den Key kennt, schöner Titel; sonst kommt der
     // screenId selber raus (kein "Untitled"-Fallback — der App-Dev sieht