@cosmicdrift/kumiko-renderer 0.386.0 → 0.388.0

package/LICENSE

@@ -1,57 +1,21 @@
-Business Source License 1.1
-
-Parameters
-
-Licensor:             Marc Frost
-
-Licensed Work:        @cosmicdrift/kumiko-framework
-                      The Licensed Work is © 2026 Marc Frost.
-
-Additional Use Grant: 
-You may use the Licensed Work in production for any purpose, including 
-commercially, EXCEPT for the Restricted Use. 
-
-"Restricted Use" is defined as using the Licensed Work to provide a platform 
-or service to third parties that allows them to host, deploy, or run their 
-own applications built with the Licensed Work. This includes, but is not 
-limited to: managed hosting services, software-as-a-service (SaaS) platforms, 
-platform-as-a-service (PaaS), developer platforms, or any multi-tenant 
-managed offering of the Licensed Work.
-
-This restriction does not apply to the Licensor, any entity controlled by, 
-controlling, or under common control with the Licensor ("Affiliates"), or 
-contractors acting on their behalf. The Licensor remains free to use the 
-Licensed Work for any purpose, including for the operation of kumiko.rocks.
-
-Change Date:          2030-05-05
-Change License:       Apache License, Version 2.0
-
-
-Terms
-
-The Licensor hereby grants you the right to copy, modify, create derivative works, 
-redistribute, and make non-production use of the Licensed Work. The Licensor may 
-make an Additional Use Grant, above, permitting limited production use.
-
-Effective on the Change Date, or the fourth anniversary of the first publicly 
-available distribution of the Licensed Work under this License, whichever comes 
-first, this License will convert to the Change License.
-
-This Business Source License governs use of the Licensed Work in all cases, except 
-as to any use that is explicitly granted in the Additional Use Grant above or 
-under the Change License after the Change Date.
-
-If your use of the Licensed Work does not comply with the requirements of this 
-License, you must cease use of the Licensed Work immediately.
-
-All copies of the Licensed Work, and all derivative works thereof, must include 
-this License.
-
-This License does not grant you any right, title, or interest in any trademark, 
-logo, or branding of the Licensor, except as required to comply with this License.
-
-TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON AN 
-“AS IS” BASIS. LICENSOR DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING 
-WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, 
-TITLE, AND NON-INFRINGEMENT. IN NO EVENT WILL LICENSOR BE LIABLE FOR ANY DAMAGES 
-ARISING OUT OF OR RELATED TO THIS LICENSE OR THE USE OF THE LICENSED WORK.
+MIT License
+
+Copyright (c) 2026 Marc Frost
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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

@@ -28,11 +28,11 @@ export declare function ActionFormBody({ schema, screen, translate, entityId, in
     readonly translate?: Translate;
     /** Record id from the route path; the source of the `load` query's id. */
     readonly entityId?: string;
-    /** Row-drawer usage (RowAction kind:"drawer", fw#2710): prefill extracted
+    /** Row-drawer usage (RowAction kind:"drawer"): prefill extracted
      *  from the clicked row, applied on top of searchParams through the same
      *  renderableFields/sensitive gates (see mergeSearchParamsIntoInitial). */
     readonly initialOverrides?: Readonly<Record<string, unknown>>;
-    /** Drawer-hosted usage (toolbarAction kind:"drawer", fw#2225): called
+    /** Drawer-hosted usage (toolbarAction kind:"drawer"): called
      *  instead of the redirect-based navigation on successful submit, so the
      *  host closes the drawer + refetches its list regardless of whether
      *  `screen.redirect` is set — a full-page redirect would navigate away

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

@@ -112,7 +112,7 @@ export function ActionFormBody({ schema, screen, translate, entityId, initialOve
     // A drawer-hosted form is not a navigation target, so it never takes a handoff.
     const handoffValues = onSuccess === undefined ? pendingHandoff : undefined;
     // This screen has no entity, so a money field here declares its own currency
-    // source (fw#2839, boot-enforced) — without one the form would seed a bare
+    // source (boot-enforced) — without one the form would seed a bare
     // `0` the handler's schema rejects. When a tenant-declared field's config
     // query errors or holds no value there is no entity default to use, and
     // submitting a guessed currency would mis-book the amount — block instead.
@@ -129,6 +129,7 @@ export function ActionFormBody({ schema, screen, translate, entityId, initialOve
         })
         : undefined, loadableFieldNames);
     const loadedValues = loadState?.status === "ready" ? loadState.values : undefined;
+    const refetchLoadedValues = loadState?.status === "ready" ? loadState.refetch : undefined;
     const initial = useMemo(() => {
         // With `load` the loaded record is the only source of values: a crafted link
         // or a row's params must not seed fields the record would otherwise own.
@@ -204,8 +205,14 @@ export function ActionFormBody({ schema, screen, translate, entityId, initialOve
             else if (hasSuccessLinks || screen.resetOnSuccess === true) {
                 publish(effectiveTranslate("kumiko.actionForm.success"));
             }
-            if (screen.resetOnSuccess === true)
-                setFormEpoch((epoch) => epoch + 1);
+            if (screen.resetOnSuccess === true) {
+                // A loaded record is stale after the write: reseed the form from the fresh one.
+                const remountForm = () => setFormEpoch((epoch) => epoch + 1);
+                if (refetchLoadedValues === undefined)
+                    remountForm();
+                else
+                    void refetchLoadedValues().finally(remountForm);
+            }
         }
         // Without a redirect the form stays put; returnTo only replaces an existing
         // navigation, and never one to a record screen (see redirectTargetsRecord).
@@ -227,6 +234,7 @@ export function ActionFormBody({ schema, screen, translate, entityId, initialOve
         dispatcher,
         locale,
         effectiveTranslate,
+        refetchLoadedValues,
     ]);
     // The success box disappears with the next edit; a submit clears it itself.
     const handleDirtyChange = useCallback((dirty) => {
@@ -251,7 +259,7 @@ export function ActionFormBody({ schema, screen, translate, entityId, initialOve
         return () => navigateToReturnOr(nav, returnTarget, () => nav.navigate({ screenId: lastSegment(target) }));
     }, [nav, screen.redirect, screen.cancelTarget, onCancelOverride, returnTarget]);
     // Rendering the form before a tenant-declared currency lands would show the
-    // fallback and, on a fast click, submit it (fw#2933) — hold instead.
+    // fallback and, on a fast click, submit it — hold instead.
     if (currencyLoading) {
         return _jsx(QueryLoadingBanner, {});
     }

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

@@ -1,16 +1,16 @@
 import type { ActionFormScreenDefinition, EntityDefinition, EntityEditScreenDefinition, FieldDefinition, SecretMintConfirmStep, SecretMintScreenDefinition } from "@cosmicdrift/kumiko-framework/ui-types";
-/** Baut eine minimale EntityDefinition aus den Inline-Fields eines
- *  ActionForm- oder SecretMint-Screens. RenderEdit + computeEditViewModel
- *  iterieren über entity.fields zur Render-Zeit; alle weiteren
- *  EntityDefinition-Felder bleiben undefined. */
+/** Builds a minimal EntityDefinition from the inline fields of an
+ *  ActionForm or SecretMint screen. RenderEdit and computeEditViewModel
+ *  iterate over entity.fields at render time; all other EntityDefinition
+ *  fields remain undefined. */
 export declare function synthesizeActionFormEntity(fields: Readonly<Record<string, FieldDefinition>>): EntityDefinition;
 /** Fields the form may seed and submit. An excluded field the layout does not show
  *  would otherwise reach the payload through its `default`, and the handler rejects it. */
 export declare function actionFormSubmittableFields(screen: ActionFormScreenDefinition): Readonly<Record<string, FieldDefinition>>;
-/** Wandelt ein ActionFormScreenDefinition oder SecretMintScreenDefinition in
- *  die EntityEditScreen-Shape die RenderEdit erwartet. type wird auf
- *  "entityEdit" gesetzt damit der Type-Constraint hält; entity wird auf den
- *  Pseudo-Namen gepinnt — RenderEdit liest das Feld nicht. */
+/** Converts an ActionFormScreenDefinition or SecretMintScreenDefinition to
+ *  the EntityEditScreen shape expected by RenderEdit. `type` is set to
+ *  "entityEdit" to satisfy the type constraint, and `entity` is pinned to
+ *  the pseudo-name because RenderEdit does not read that field. */
 export declare function synthesizeActionFormScreen(screen: ActionFormScreenDefinition | SecretMintScreenDefinition): EntityEditScreenDefinition;
 /** Separate id (`${screen.id}:confirm`) keeps this confirm-form screen from
  *  colliding with the mint-form screen's draft key. */

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

@@ -1,24 +1,22 @@
-// Shim für ActionForm-Renderer (Tier 2.7d).
+// Shim for ActionForm rendering.
 //
-// RenderEdit verlangt heute eine `entity: EntityDefinition` + ein
-// `screen: EntityEditScreenDefinition` Pair, nutzt aber intern nur
-// `entity.fields` und `screen.layout`. ActionForm-Screens haben weder
-// eine Entity-Reference noch sind sie type: "entityEdit" — die zwei
-// Helper hier shapen den Daten-Input ad-hoc um, damit RenderEdit
-// reused werden kann ohne den Stack zu duplizieren.
+// RenderEdit currently requires an `entity: EntityDefinition` and a
+// `screen: EntityEditScreenDefinition` pair, but internally uses only
+// `entity.fields` and `screen.layout`. ActionForm screens have neither an
+// entity reference nor `type: "entityEdit"`; these helpers reshape the input
+// so RenderEdit can be reused without duplicating the rendering stack.
 //
-// Schulden-Flag: Sobald RenderEdit auf entity.transitions / idType /
-// defaultCurrency / softDelete zugreift, oder ein zukünftiger Boot-
-// Validator die schema.entities-Map cross-referenziert, brechen die
-// Type-Lies hier silent. Dann ist es Zeit für eine echte
-// RenderActionForm-Komponente, die `fields` direkt als Input nimmt.
-// Der Boot-Validator kennt actionForm bereits eigenständig (kein
-// entity-Lookup), also ist der Server-Pfad davon nicht betroffen.
+// This workaround becomes invalid if RenderEdit starts reading
+// entity.transitions, idType, defaultCurrency, or softDelete, or if a future
+// boot validator cross-references the schema.entities map. At that point,
+// RenderActionForm should accept `fields` directly. The boot validator already
+// handles actionForm independently without an entity lookup, so the server path
+// is unaffected.
 import { ACTION_FORM_PSEUDO_ENTITY, isFieldsEditSection, normalizeEditField, sectionFieldSpecs, } from "@cosmicdrift/kumiko-framework/ui-types";
-/** Baut eine minimale EntityDefinition aus den Inline-Fields eines
- *  ActionForm- oder SecretMint-Screens. RenderEdit + computeEditViewModel
- *  iterieren über entity.fields zur Render-Zeit; alle weiteren
- *  EntityDefinition-Felder bleiben undefined. */
+/** Builds a minimal EntityDefinition from the inline fields of an
+ *  ActionForm or SecretMint screen. RenderEdit and computeEditViewModel
+ *  iterate over entity.fields at render time; all other EntityDefinition
+ *  fields remain undefined. */
 export function synthesizeActionFormEntity(fields) {
     return { fields };
 }
@@ -68,10 +66,10 @@ export function actionFormSubmittableFields(screen) {
         : []));
     return Object.fromEntries(Object.entries(screen.fields).filter(([name]) => inLayout.has(name) || !excluded.includes(name)));
 }
-/** Wandelt ein ActionFormScreenDefinition oder SecretMintScreenDefinition in
- *  die EntityEditScreen-Shape die RenderEdit erwartet. type wird auf
- *  "entityEdit" gesetzt damit der Type-Constraint hält; entity wird auf den
- *  Pseudo-Namen gepinnt — RenderEdit liest das Feld nicht. */
+/** Converts an ActionFormScreenDefinition or SecretMintScreenDefinition to
+ *  the EntityEditScreen shape expected by RenderEdit. `type` is set to
+ *  "entityEdit" to satisfy the type constraint, and `entity` is pinned to
+ *  the pseudo-name because RenderEdit does not read that field. */
 export function synthesizeActionFormScreen(screen) {
     return {
         id: screen.id,

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

@@ -21,6 +21,7 @@ export type ActionFormLoadState = {
 } | {
     readonly status: "ready";
     readonly values: Readonly<Record<string, unknown>>;
+    readonly refetch: () => Promise<void>;
 };
 /** A sensitive, writeOnly or password field never takes a value from a loaded
  *  record: the form must not echo a secret back into an input. */

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

@@ -53,7 +53,7 @@ export function useActionFormLoad(load, recordId, fieldNames) {
         return { status: "loading" };
     if (query.data === null)
         return { status: "missing-record" };
-    return { status: "ready", values };
+    return { status: "ready", values, refetch: query.refetch };
 }
 /** Banner for every `load` state that is not "ready". */
 export function ActionFormLoadStatus({ state, screenId, translate, }) {

package/dist/app/app-features-context.js

@@ -2,10 +2,10 @@ import { jsx as _jsx } from "react/jsx-runtime";
 // Cross-feature schema access for components that need to resolve a
 // screen owned by a DIFFERENT feature than the one they're rendering
 // under — e.g. a reference field opening the target entity's create
-// screen (kumiko-framework#1681). `createKumikoApp` provides the full
-// `app.features` list; components elsewhere in the render tree default
-// to an empty list (no cross-feature schema known, e.g. outside
-// createKumikoApp or in isolated tests).
+// screen. `createKumikoApp` provides the full `app.features` list;
+// components elsewhere in the render tree default to an empty list (no
+// cross-feature schema known, e.g. outside `createKumikoApp` or in
+// isolated tests).
 import { createContext, useContext } from "react";
 const AppFeaturesContext = createContext([]);
 export function AppFeaturesProvider({ features, children }) {

package/dist/app/column-renderers.d.ts

@@ -17,14 +17,12 @@ export type ColumnRenderersProviderProps = {
     readonly value: ColumnRenderersMap;
 };
 export declare function ColumnRenderersProvider({ children, value, }: ColumnRenderersProviderProps): ReactNode;
-/** Schaut die Component für einen Renderer-Key nach. Returnt undefined
- *  wenn `name` leer/undefined ist (Caller hat keinen __component-Renderer)
- *  oder weder Provider gemounted noch der Key in der Map ist. Der Caller
- *  (DataTable.renderCell) loggt dann eine Warnung und fällt auf den
- *  Default-Type-Renderer zurück.
+/** Looks up the component for a renderer key. Returns undefined when `name` is
+ *  empty/undefined (the caller has no __component renderer), or when no provider
+ *  is mounted or the key is absent from the map. The caller (DataTable.renderCell)
+ *  then logs a warning and falls back to the default type renderer.
  *
- *  `name` ist optional damit Caller den Hook unkonditional aufrufen
- *  können — Rules-of-Hooks verbieten einen Function-Branch der den Hook
- *  überspringt. So bleibt der Aufruf eine einzige Zeile, ohne dass der
- *  Caller einen Stub-Key wie `""` reichen muss. */
+ *  `name` is optional so callers can invoke the hook unconditionally—Rules of
+ *  Hooks prohibit a function branch that skips the hook. This keeps the call to
+ *  a single line without requiring the caller to provide a stub key such as `""`. */
 export declare function useColumnRenderer(name?: string): ColumnRendererComponent | undefined;

package/dist/app/column-renderers.js

@@ -1,29 +1,26 @@
 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
-// alle clientFeatures.columnRenderers und mountet den Provider; der DataTable-
-// Cell-Renderer schlägt den Component über `useColumnRenderer(name)` nach.
+// Column-Renderer-Map: client-side lookup for ListColumn columns that specify a
+// PlatformComponent renderer (`{ react: { __component: "Name" } }`) in the schema
+// instead of a string function. createKumikoApp in renderer/web collects all
+// clientFeatures.columnRenderers and mounts the provider; the DataTable cell
+// renderer looks up the component through `useColumnRenderer(name)`.
 //
-// Analog zu CustomScreensProvider — der Renderer-Web-Bootstrap mounted beide
-// Provider an derselben Stelle. Schemas selbst bleiben serializable: der
-// Component wird nur per String-Key referenziert, die Map liegt allein
-// client-seitig.
+// Like CustomScreensProvider, the renderer web bootstrap mounts both providers
+// at the same location. Schemas remain serializable: the component is referenced
+// only by string key, while the map exists solely on the client.
 import { createContext, useContext } from "react";
 const ColumnRenderersContext = createContext(undefined);
 export function ColumnRenderersProvider({ children, value, }) {
     return (_jsx(ColumnRenderersContext.Provider, { value: value, children: children }));
 }
-/** Schaut die Component für einen Renderer-Key nach. Returnt undefined
- *  wenn `name` leer/undefined ist (Caller hat keinen __component-Renderer)
- *  oder weder Provider gemounted noch der Key in der Map ist. Der Caller
- *  (DataTable.renderCell) loggt dann eine Warnung und fällt auf den
- *  Default-Type-Renderer zurück.
+/** Looks up the component for a renderer key. Returns undefined when `name` is
+ *  empty/undefined (the caller has no __component renderer), or when no provider
+ *  is mounted or the key is absent from the map. The caller (DataTable.renderCell)
+ *  then logs a warning and falls back to the default type renderer.
  *
- *  `name` ist optional damit Caller den Hook unkonditional aufrufen
- *  können — Rules-of-Hooks verbieten einen Function-Branch der den Hook
- *  überspringt. So bleibt der Aufruf eine einzige Zeile, ohne dass der
- *  Caller einen Stub-Key wie `""` reichen muss. */
+ *  `name` is optional so callers can invoke the hook unconditionally—Rules of
+ *  Hooks prohibit a function branch that skips the hook. This keeps the call to
+ *  a single line without requiring the caller to provide a stub key such as `""`. */
 export function useColumnRenderer(name) {
     const map = useContext(ColumnRenderersContext);
     if (name === undefined || name === "")

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

@@ -15,7 +15,7 @@ import { buildInitialValues } from "./entity-edit-prefill.js";
 import { layoutEditFields } from "./layout-fields.js";
 import { QueryErrorBanner, QueryLoadingBanner } from "./query-state-banners.js";
 // A money-typed config-edit field renders through RenderField's entityEdit
-// `{amount, currency}` payload shape (render-field.tsx, #1923), but
+// `{amount, currency}` payload shape (render-field.tsx), but
 // `ConfigKeyType` (write-helpers.ts validateType) only ever knows
 // number/boolean/text/select — a config value is always a bare scalar.
 // Unwrap back to the amount before it hits config:write:set.
@@ -97,8 +97,12 @@ export function ConfigEditBody({ schema, screen, translate, }) {
     // Detail load: config:query:values returns ALL keys of the tenant.
     // We map them via screen.configKeys from short to qualified name onto our
     // form field values.
-    const valuesQuery = useQuery("config:query:values", {});
-    const cascadeQuery = useQuery("config:query:cascade", {});
+    const valuesQuery = useQuery("config:query:values", {
+        scope: screen.scope,
+    });
+    const cascadeQuery = useQuery("config:query:cascade", {
+        scope: screen.scope,
+    });
     const secretKeys = screen.secretKeys;
     const secretsQuery = useQuery("secrets:query:list", {}, { enabled: secretKeys !== undefined });
     const synthEntity = useMemo(() => synthesizeConfigEditEntity(screen.fields), [screen.fields]);

package/dist/app/config-edit-shim.d.ts

@@ -1,14 +1,13 @@
 import type { ConfigEditScreenDefinition, EntityDefinition, EntityEditScreenDefinition } from "@cosmicdrift/kumiko-framework/ui-types";
 import * as z from "zod";
-/** Baut eine minimale EntityDefinition aus den Inline-Fields des
- *  ConfigEdit-Screens. RenderEdit + computeEditViewModel iterieren
- *  über entity.fields zur Render-Zeit; alle weiteren EntityDefinition-
- *  Felder bleiben undefined. */
+/** Builds a minimal EntityDefinition from the ConfigEdit screen's inline
+ *  fields. RenderEdit + computeEditViewModel iterate over entity.fields
+ *  at render time; all other EntityDefinition fields remain undefined. */
 export declare function synthesizeConfigEditEntity(fields: ConfigEditScreenDefinition["fields"]): EntityDefinition;
-/** Wandelt ein ConfigEditScreenDefinition in die EntityEditScreen-
- *  Shape die RenderEdit erwartet. type wird auf "entityEdit" gesetzt
- *  damit der Type-Constraint hält; entity wird auf den Pseudo-Namen
- *  gepinnt — RenderEdit liest das Feld nicht. */
+/** Converts a ConfigEditScreenDefinition to the EntityEditScreen shape
+ *  expected by RenderEdit. `type` is set to "entityEdit" to satisfy the
+ *  type constraint; `entity` is pinned to the pseudo-name — RenderEdit
+ *  does not read this field. */
 export declare function synthesizeConfigEditScreen(screen: ConfigEditScreenDefinition): EntityEditScreenDefinition;
 /** Client-side range check for number keys with declared bounds, so an
  *  out-of-range value surfaces on its field instead of as the server's

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

@@ -1,31 +1,29 @@
-// Shim für ConfigEdit-Renderer (analog zu action-form-shim.ts).
+// Shim for the ConfigEdit renderer (analogous to action-form-shim.ts).
 //
-// RenderEdit verlangt eine `entity: EntityDefinition` + ein
-// `screen: EntityEditScreenDefinition` Pair, nutzt aber intern nur
-// `entity.fields` und `screen.layout` für das Rendern. ConfigEdit-
-// Screens haben weder eine Entity-Reference noch sind sie
-// type: "entityEdit" — die zwei Helper hier shapen den Daten-Input
-// ad-hoc um, damit RenderEdit reused werden kann.
+// RenderEdit requires an `entity: EntityDefinition` +
+// `screen: EntityEditScreenDefinition` pair, but internally uses only
+// `entity.fields` and `screen.layout` for rendering. ConfigEdit screens
+// have neither an entity reference nor `type: "entityEdit"` — these two
+// helpers reshape the data input ad hoc so RenderEdit can be reused.
 //
-// Selbe Schulden-Reservation wie bei action-form-shim: sobald RenderEdit
-// auf entity.transitions / idType / softDelete zugreift, oder ein
-// 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.
+// The same debt reservation as in action-form-shim applies: if RenderEdit
+// starts accessing entity.transitions / idType / softDelete, or a future
+// boot validator cross-references the schema.entities map, these type lies
+// will fail silently. At that point, a real RenderConfigEdit component
+// that takes fields directly is needed.
 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
- *  über entity.fields zur Render-Zeit; alle weiteren EntityDefinition-
- *  Felder bleiben undefined. */
+/** Builds a minimal EntityDefinition from the ConfigEdit screen's inline
+ *  fields. RenderEdit + computeEditViewModel iterate over entity.fields
+ *  at render time; all other EntityDefinition fields remain undefined. */
 export function synthesizeConfigEditEntity(fields) {
     return { fields };
 }
-/** Wandelt ein ConfigEditScreenDefinition in die EntityEditScreen-
- *  Shape die RenderEdit erwartet. type wird auf "entityEdit" gesetzt
- *  damit der Type-Constraint hält; entity wird auf den Pseudo-Namen
- *  gepinnt — RenderEdit liest das Feld nicht. */
+/** Converts a ConfigEditScreenDefinition to the EntityEditScreen shape
+ *  expected by RenderEdit. `type` is set to "entityEdit" to satisfy the
+ *  type constraint; `entity` is pinned to the pseudo-name — RenderEdit
+ *  does not read this field. */
 export function synthesizeConfigEditScreen(screen) {
     return {
         id: screen.id,

package/dist/app/custom-screens.d.ts

@@ -5,7 +5,7 @@ export type CustomScreensProviderProps = {
     readonly value: CustomScreensMap;
 };
 export declare function CustomScreensProvider({ children, value }: CustomScreensProviderProps): ReactNode;
-/** Schaut die Component für ein Custom-Screen nach. Returnt undefined
- *  wenn weder Provider gemounted noch screenId in der Map ist — der
- *  Caller (KumikoScreen) zeigt dann seinen Placeholder-Banner. */
+/** Looks up the component for a custom screen. Returns undefined
+ *  when neither a provider is mounted nor screenId is in the map—the
+ *  caller (KumikoScreen) then displays its placeholder banner. */
 export declare function useCustomScreenComponent(screenId: string): ComponentType | undefined;

package/dist/app/custom-screens.js

@@ -1,17 +1,17 @@
 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
-// alle clientFeatures.components und mountet den Provider; Tests die
-// einzelne Custom-Screens prüfen wollen, mounten den Provider direkt.
+// Custom-screen component map: client-side lookup for screens of type
+// `custom`. KumikoScreen looks up `screen.id` (or qn) here and renders
+// the matching component. createKumikoApp in renderer/web collects all
+// clientFeatures.components and mounts the provider; tests that check
+// individual custom screens mount the provider directly.
 import { createContext, useContext } from "react";
 const CustomScreensContext = createContext(undefined);
 export function CustomScreensProvider({ children, value }) {
     return _jsx(CustomScreensContext.Provider, { value: value, children: children });
 }
-/** Schaut die Component für ein Custom-Screen nach. Returnt undefined
- *  wenn weder Provider gemounted noch screenId in der Map ist — der
- *  Caller (KumikoScreen) zeigt dann seinen Placeholder-Banner. */
+/** Looks up the component for a custom screen. Returns undefined
+ *  when neither a provider is mounted nor screenId is in the map—the
+ *  caller (KumikoScreen) then displays its placeholder banner. */
 export function useCustomScreenComponent(screenId) {
     const map = useContext(CustomScreensContext);
     if (map === undefined)

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

@@ -11,6 +11,6 @@ export type DashboardBodyProviderProps = {
     readonly value: ComponentType<DashboardBodyProps>;
 };
 export declare function DashboardBodyProvider({ children, value }: DashboardBodyProviderProps): ReactNode;
-/** Undefined wenn kein Platform-Package einen Dashboard-Body registriert
- *  hat — KumikoScreen zeigt dann seinen Placeholder-Banner. */
+/** Undefined when no platform package has registered a dashboard body;
+ * KumikoScreen then displays its placeholder banner. */
 export declare function useDashboardBody(): ComponentType<DashboardBodyProps> | undefined;

package/dist/app/dashboard-body.js

@@ -4,8 +4,8 @@ const DashboardBodyContext = createContext(undefined);
 export function DashboardBodyProvider({ children, value }) {
     return _jsx(DashboardBodyContext.Provider, { value: value, children: children });
 }
-/** Undefined wenn kein Platform-Package einen Dashboard-Body registriert
- *  hat — KumikoScreen zeigt dann seinen Placeholder-Banner. */
+/** Undefined when no platform package has registered a dashboard body;
+ * KumikoScreen then displays its placeholder banner. */
 export function useDashboardBody() {
     return useContext(DashboardBodyContext);
 }

package/dist/app/entity-edit-prefill.d.ts

@@ -2,6 +2,17 @@ import type { FormValues } from "../headless/index.ts";
 export declare function versionOf(record: Readonly<Record<string, unknown>>): number;
 export declare function buildInitialValues(fields: Readonly<Record<string, unknown>>, defaultCurrency?: string, moneyCurrencyOverrides?: Readonly<Record<string, string>>): FormValues;
 export declare function tenantCurrencyMoneyFieldNames(fields: Readonly<Record<string, unknown>>): readonly string[];
+export type TenantCurrencyResolution = {
+    readonly status: "not-needed";
+} | {
+    readonly status: "loading";
+} | {
+    readonly status: "unresolved";
+} | {
+    readonly status: "ready";
+    readonly currency: string;
+};
+export declare function useTenantCurrency(needed: boolean, fallback: string | undefined): TenantCurrencyResolution;
 export declare function literalCurrencyOverrides(fields: Readonly<Record<string, unknown>>): Readonly<Record<string, string>>;
 export declare function useMoneyCurrencyOverrides(fields: Readonly<Record<string, unknown>>, tenantFieldNames: readonly string[], fallback: string | undefined): {
     readonly overrides: Readonly<Record<string, string>> | undefined;