@cosmicdrift/kumiko-renderer 0.385.0 → 0.387.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.
@@ -251,7 +251,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/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.

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

@@ -5,8 +5,8 @@ import { useMemo } from "react";
 import { rendererWarn } from "../dev-console.js";
 import { useQuery } from "../hooks/use-query.js";
 // `defaultCurrency` is entityEdit-only — it enables the `{amount, currency}`
-// write shape (fw#1923); config-edit's plain-number contract needs bare `0`.
-// `moneyCurrencyOverrides` (fw#2933) replaces `defaultCurrency` per field name
+// write shape; config-edit's plain-number contract needs bare `0`.
+// `moneyCurrencyOverrides` replaces `defaultCurrency` per field name
 // — used for a `money` field that declares `currency: { kind: "tenant" }`, so
 // its empty initial value carries the tenant's own currency instead of the
 // entity-wide default.
@@ -51,7 +51,7 @@ export function buildInitialValues(fields, defaultCurrency, moneyCurrencyOverrid
     return out;
 }
 // A `money` field opts a currently-empty value into the tenant-settings
-// bundle's per-tenant currency (fw#2933) via `currency: { kind: "tenant" }`
+// bundle's per-tenant currency via `currency: { kind: "tenant" }`
 // on its FieldDefinition. Read structurally — renderer only depends on the
 // client-safe FieldDefinition subset, not the concrete MoneyFieldDef/
 // MoneyCurrencySource types, same idiom as the other field-shape narrowings
@@ -68,7 +68,7 @@ export function tenantCurrencyMoneyFieldNames(fields) {
 }
 // Resolves what a tenant-declared money field's currency should be, from the
 // same `config:query:values` query ConfigEditBody already uses. Never falls
-// back to "EUR" while the query is genuinely still in flight (fw#2933) — a
+// back to "EUR" while the query is genuinely still in flight — a
 // screen with no tenant-declared money field, or a query that errored or
 // returned no value for the key, resolves immediately instead of blocking.
 function resolveTenantCurrency(fieldNames, query, fallback) {
@@ -88,8 +88,8 @@ function resolveTenantCurrency(fieldNames, query, fallback) {
         ? { status: "unresolved" }
         : { status: "ready", currency: fallback };
 }
-// A money field naming a fixed ISO code (`currency: { kind: "literal", code }`,
-// fw#2839) resolves with no query at all. Read structurally, same idiom as
+// A money field naming a fixed ISO code (`currency: { kind: "literal", code }`)
+// resolves with no query at all. Read structurally, same idiom as
 // tenantCurrencyMoneyFieldNames above.
 export function literalCurrencyOverrides(fields) {
     const out = {};
@@ -105,9 +105,9 @@ export function literalCurrencyOverrides(fields) {
     return out;
 }
 // Per-field currency for the money fields that declare their own source: a
-// literal code resolves synchronously (fw#2839), a `{ kind: "tenant" }` field
+// literal code resolves synchronously, a `{ kind: "tenant" }` field
 // needs the tenant-settings config query and makes the caller hold the form
-// until it lands (fw#2933) — seeding the fallback meanwhile would render, and
+// until it lands — seeding the fallback meanwhile would render, and
 // on a fast click submit, the wrong currency. Callers pass the tenant field
 // names themselves because an edit form only needs the fetch for fields the
 // record has no stored value for.
@@ -164,7 +164,7 @@ function warnPrefillParam(message) {
     rendererWarn(`[kumiko] ${message}`);
 }
 // An actionForm has no entity and thus no defaultCurrency, so a bare-number
-// prefill would stay a number the handler's zod schema rejects (fw#2763).
+// prefill would stay a number the handler's zod schema rejects.
 function coerceMoneyValue(raw, fieldName, defaultCurrency) {
     if (raw === null || raw === undefined)
         return undefined;

package/dist/app/entity-edit-screen.js

@@ -52,7 +52,7 @@ function EntityEditCreateBody({ schema, screen, entity, translate, onSaved, }) {
     // returnTo would fight that.
     const returnTarget = screen.singleton === true ? undefined : returnTargetParam;
     const entityDefaultCurrency = entity.defaultCurrency ?? "EUR";
-    // A money field declaring `currency: { kind: "tenant" }` (fw#2933) resolves
+    // A money field declaring `currency: { kind: "tenant" }` resolves
     // its empty-value currency from the tenant-settings config key instead of
     // entityDefaultCurrency — `enabled` keeps the query a no-op for entities
     // without any such field.
@@ -117,7 +117,7 @@ function EntityEditCreateBody({ schema, screen, entity, translate, onSaved, }) {
         }
     }, [nav, screen.redirect, schema, appFeatures, navigateToList, onSaved, returnTarget]);
     // Never seed a tenant-declared money field with entityDefaultCurrency while
-    // its real tenant currency is still in flight (fw#2933) — wait instead.
+    // its real tenant currency is still in flight — wait instead.
     if (currencyLoading) {
         return _jsx(QueryLoadingBanner, {});
     }
@@ -172,7 +172,7 @@ function EntityEditUpdateForm({ schema, screen, entity, entityId, record, onRelo
     // error and the user reloads.
     const recordVersion = versionOf(record);
     const entityDefaultCurrency = entity.defaultCurrency ?? "EUR";
-    // A money field declaring `currency: { kind: "tenant" }` (fw#2933) resolves
+    // A money field declaring `currency: { kind: "tenant" }` resolves
     // its empty-value currency from the tenant-settings config key instead of
     // entityDefaultCurrency — `enabled` keeps the query a no-op for entities
     // without any such field. A record's own stored value (below) always wins
@@ -333,7 +333,7 @@ function EntityEditUpdateForm({ schema, screen, entity, entityId, record, onRelo
         return undefined;
     }, [dispatcher, deleteCommand, entityId, navigateToList, onDeleted, returnTarget, nav]);
     // Never seed a tenant-declared money field with entityDefaultCurrency while
-    // its real tenant currency is still in flight (fw#2933) — wait instead. A
+    // its real tenant currency is still in flight — wait instead. A
     // stored (non-empty) value is unaffected — it never reaches this branch's
     // fallback because `initial` above already prefers `record[name]`.
     if (currencyLoading) {

package/dist/app/entity-list-screen.js

@@ -298,7 +298,7 @@ function EntityListBody({ schema, screen, entity, translate, onRowClick, }) {
     // drift apart.
     const runNavigate = useCallback((action, row) => {
         if (action.entity !== undefined) {
-            // Entity targets (fw#2228) only resolve in the NavApi implementation
+            // Entity targets only resolve in the NavApi implementation
             // against ALL features (resolveTarget in renderer/web/nav.tsx); this
             // package only knows `schema` (the one calling feature) and cannot look up
             // detailFor across features itself.
@@ -499,8 +499,8 @@ function EntityListBody({ schema, screen, entity, translate, onRowClick, }) {
     // the entity has searchable fields (dead toolbar slot otherwise — the
     // server search index has nothing to filter). Gated on
     // schema.searchAdapterMissing !== true regardless of source (explicit or
-    // auto) — a search bar the server can't serve would 422 at request-time
-    // (#2032); matches the boot-time check in api/server.ts (#2051).
+    // auto) — a search bar the server can't serve would 422 at request-time;
+    // matches the boot-time check in api/server.ts.
     const searchable = schema.searchAdapterMissing !== true &&
         (screen.searchable ??
             Object.values(entity.fields).some((f) => "searchable" in f && f.searchable === true));

package/dist/app/extension-form-submit.d.ts

@@ -3,7 +3,7 @@ export type ExtensionSubmitContext = {
 };
 export type ExtensionSubmitResult = {
     readonly isSuccess: boolean;
-    /** i18n-Key für die Fehlermeldung, die die Form als Banner zeigt. */
+    /** i18n key for the error message that the form displays as a banner. */
     readonly errorKey?: string;
 };
 export type ExtensionFormSubmitHandler = (ctx: ExtensionSubmitContext) => Promise<ExtensionSubmitResult>;