@cosmicdrift/kumiko-renderer 0.374.0 → 0.378.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,11 +1,11 @@
 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";
 import { isPlainObject, propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
 import { Fragment, useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { withDerivedValues } from "../components/form-derivation-patch.js";
 import { QueryOptionLabel, resolveOptionsQueryPayload, } from "../components/query-options-select.js";
 import { extractCreatedId, extractIdField } from "../components/reference-create-dialog.js";
 import { RenderEdit, resolveRecordTitle, } from "../components/render-edit.js";
@@ -14,6 +14,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 +25,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 +191,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 +1449,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;
@@ -2549,6 +2550,7 @@ function ActionFormBody({ schema, screen, translate, entityId, initialOverrides,
         handoffValues,
         loadedValues,
     ]);
+    const derivedInitial = useMemo(() => withDerivedValues(initial, screen.derive !== undefined ? screen : undefined), [initial, screen]);
     const t = useTranslation();
     const effectiveTranslate = translate ?? t;
     const summary = useMemo(() => resolveActionFormSummary(screen.summary, initialOverrides, effectiveTranslate, locale), [screen.summary, initialOverrides, effectiveTranslate, locale]);
@@ -2573,13 +2575,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;
@@ -2649,7 +2652,7 @@ function ActionFormBody({ schema, screen, translate, entityId, initialOverrides,
     if (loadState !== undefined && loadState.status !== "ready") {
         return (_jsx(ActionFormLoadStatus, { state: loadState, screenId: screen.id, translate: effectiveTranslate }));
     }
-    return (_jsx(RenderEdit, { screen: synthScreen, entity: synthEntity, featureName: schema.featureName, initial: initial, 
+    return (_jsx(RenderEdit, { screen: synthScreen, entity: synthEntity, featureName: schema.featureName, initial: derivedInitial, ...(screen.derive !== undefined && { formDerivation: screen }), 
         // Extension-Sections im actionForm sehen die initialen Form-Values
         // (inkl. searchParams-Prefill, z.B. ?incidentId=…) als initialValues
         // — anders als im entityEdit gibt es hier keinen record, aus dem

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/form-derivation-patch.d.ts

@@ -0,0 +1,8 @@
+import type { FormDerivationScreen } from "@cosmicdrift/kumiko-framework/ui-types";
+/** The derived values that differ from the current form values, or undefined
+ *  when everything is already up to date. A derived value that no longer
+ *  resolves is reported as `undefined`. */
+export declare function changedDerivedValues(values: unknown, screen: FormDerivationScreen): Record<string, unknown> | undefined;
+/** `values` with every derived field already resolved, so the form's baseline
+ *  matches what the live recomputation would produce and starts out clean. */
+export declare function withDerivedValues<TValues extends Record<string, unknown>>(values: TValues, screen: FormDerivationScreen | undefined): TValues;

package/dist/components/form-derivation-patch.js

@@ -0,0 +1,24 @@
+import { applyFormDerivations, isUnchangedValue } from "@cosmicdrift/kumiko-framework/ui-types";
+import { isPlainObject } from "@cosmicdrift/kumiko-types/type-guards";
+/** The derived values that differ from the current form values, or undefined
+ *  when everything is already up to date. A derived value that no longer
+ *  resolves is reported as `undefined`. */
+export function changedDerivedValues(values, screen) {
+    const next = applyFormDerivations(values, screen);
+    if (!isPlainObject(values) || !isPlainObject(next))
+        return undefined;
+    const patch = {};
+    for (const target of Object.keys(screen.derive ?? {})) {
+        if (!isUnchangedValue(values[target], next[target]))
+            patch[target] = next[target];
+    }
+    return Object.keys(patch).length === 0 ? undefined : patch;
+}
+/** `values` with every derived field already resolved, so the form's baseline
+ *  matches what the live recomputation would produce and starts out clean. */
+export function withDerivedValues(values, screen) {
+    if (screen === undefined)
+        return values;
+    const patch = changedDerivedValues(values, screen);
+    return patch === undefined ? values : { ...values, ...patch };
+}

package/dist/components/form-screen-layout.d.ts

@@ -0,0 +1,13 @@
+import type { ReactNode } from "react";
+import { type FormWidth } from "../primitives.tsx";
+export type FormScreenLayoutProps = {
+    readonly children: ReactNode;
+    readonly description?: ReactNode;
+    readonly actions?: ReactNode;
+    readonly secondaryActions?: ReactNode;
+    readonly onSubmit?: () => void;
+    readonly width?: FormWidth;
+    readonly testId?: string;
+};
+/** For custom screens: the standard form screen layout; fill it with `Section` (title, icon, subtitle). */
+export declare function FormScreenLayout({ children, description, actions, secondaryActions, onSubmit, width, testId, }: FormScreenLayoutProps): ReactNode;

package/dist/components/form-screen-layout.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { usePrimitives } from "../primitives.js";
+const FORM_SCREEN_LAYOUT_PROPS = {
+    screenForm: true,
+    fillHeight: true,
+    stickyActions: true,
+};
+const NOOP = () => { };
+/** For custom screens: the standard form screen layout; fill it with `Section` (title, icon, subtitle). */
+export function FormScreenLayout({ children, description, actions, secondaryActions, onSubmit = NOOP, width, testId, }) {
+    const { Form } = usePrimitives();
+    return (_jsx(Form, { onSubmit: onSubmit, ...FORM_SCREEN_LAYOUT_PROPS, ...(description !== undefined && { subtitle: description }), ...(actions !== undefined && { actions }), ...(secondaryActions !== undefined && { secondaryActions }), ...(width !== undefined && { width }), ...(testId !== undefined && { testId }), children: children }));
+}

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 { ActionFormFooterAction, EntityDefinition, EntityEditScreenDefinition, FormDerivationScreen, IconKey, RowAction, RowActionDrawer } from "@cosmicdrift/kumiko-framework/ui-types";
 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;
@@ -204,6 +204,9 @@ export type RenderEditProps<TValues extends FormValues, TCtx = unknown> = {
      *  `disabled`, which locks the whole form. For a gate the host owns, e.g.
      *  an acknowledgement checkbox in `leadContent`. */
     readonly submitBlocked?: boolean;
+    /** actionForm `derive`: derived fields are recomputed into the form state on every
+     *  change and render read-only. */
+    readonly formDerivation?: FormDerivationScreen;
     /** Show the unsaved-changes footer (count, Discard, "Save changes") even
      *  without an entity id or a screen-height form — for hosts that edit an
      *  existing server-side record through `customSubmit` (configEdit, also when

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";