@cosmicdrift/kumiko-renderer 0.386.0 → 0.388.0

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,11 +68,11 @@ 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) {
-    if (fieldNames.length === 0)
+function resolveTenantCurrency(needed, query, fallback) {
+    if (!needed)
         return { status: "not-needed" };
     if (query.error) {
         return fallback === undefined
@@ -88,8 +88,14 @@ 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
+// `needed = false` skips the config query entirely; an errored query or a missing value
+// resolves to `fallback` (or `unresolved` without one).
+export function useTenantCurrency(needed, fallback) {
+    const query = useQuery("config:query:values", { keys: [TENANT_CURRENCY_CONFIG_KEY] }, { enabled: needed });
+    return resolveTenantCurrency(needed, query, fallback);
+}
+// 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 +111,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.
@@ -115,8 +121,7 @@ export function useMoneyCurrencyOverrides(fields, tenantFieldNames,
 // `undefined` = no safe last resort (entity-less forms): an unresolvable
 // tenant currency is reported via `unresolved` instead of guessing a code.
 fallback) {
-    const query = useQuery("config:query:values", { keys: [TENANT_CURRENCY_CONFIG_KEY] }, { enabled: tenantFieldNames.length > 0 });
-    const resolution = resolveTenantCurrency(tenantFieldNames, query, fallback);
+    const resolution = useTenantCurrency(tenantFieldNames.length > 0, fallback);
     const resolvedTenantCurrency = resolution.status === "ready" ? resolution.currency : undefined;
     const overrides = useMemo(() => {
         const out = { ...literalCurrencyOverrides(fields) };
@@ -164,7 +169,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>;

package/dist/app/extension-form-submit.js

@@ -1,14 +1,13 @@
 // @runtime client
-// Extension-Form-Submit-Registry — erlaubt einer Extension-Section (z.B.
-// Custom-Fields), beim Submit des umgebenden entityEdit-Forms mitzuschreiben,
-// statt einen eigenen Save-Button zu führen ("composed form, ein Save",
-// Bug-Bash 3 #1). Die Section meldet (a) einen Submit-Handler und (b) ihren
-// dirty-State an die Form; die Form aktiviert ihren Save-Button auch wenn nur
-// eine Section dirty ist und ruft nach dem Entity-Write alle Section-Handler
-// mit der entityId.
+// Extension-Form-Submit-Registry — lets an extension section (e.g.
+// Custom-Fields) write during submission of the surrounding entityEdit form
+// instead of maintaining its own Save button ("composed form, one save").
+// The section reports (a) a submit handler and (b) its dirty state to the form;
+// the form enables its Save button even when only one section is dirty and,
+// after the entity write, calls all section handlers with the entityId.
 //
-// Ohne umgebende Form (Context === null) fällt die Section auf ihren eigenen
-// Save-Button zurück (Standalone-Backward-Compat).
+// Without a surrounding form (Context === null), the section falls back to its
+// own Save button (Standalone-Backward-Compat).
 import { createContext, useContext, useEffect, useId, useMemo, useRef } from "react";
 const ExtensionFormRegistryContext = createContext(null);
 export const ExtensionFormRegistryProvider = ExtensionFormRegistryContext.Provider;
@@ -48,15 +47,15 @@ export function useExtensionFormHost(onStatusChange) {
     }, []);
     return { registry, runAll };
 }
-// Section-Seite: meldet Handler + dirty an die umgebende Form. Returnt true
-// wenn eine composed-Form vorhanden ist (Section blendet dann ihren eigenen
-// Save-Button aus); false = standalone (eigener Save-Button bleibt).
+// Section side: reports the handler and dirty state to the surrounding form.
+// Returns true when a composed form is present, so the section hides its own
+// Save button; false means standalone, so its own Save button remains.
 export function useExtensionFormSubmit(opts) {
     const registry = useContext(ExtensionFormRegistryContext);
     const key = useId();
-    // Handler über ref, damit das Re-Registrieren NICHT an jeder Handler-
-    // Identity hängt (nur an dirty); der Handler liest immer den frischen
-    // Closure-State (pending) zur Aufruf-Zeit.
+    // The ref prevents re-registration whenever the handler identity changes
+    // (only dirty triggers it); the handler always reads the latest closure state
+    // (pending) when invoked.
     const handlerRef = useRef(opts.onSubmit);
     handlerRef.current = opts.onSubmit;
     useEffect(() => {

package/dist/app/extension-sections.d.ts

@@ -1,31 +1,30 @@
 import type { PlatformComponent } from "@cosmicdrift/kumiko-framework/ui-types";
 import { type ComponentType, type ReactNode } from "react";
-/** Extrahiert den `__component`-Namen aus einer PlatformComponent. Liest
- *  react- und native-Branch (die App-Author registriert beide unter dem
- *  gleichen Namen); returnt den ersten gefundenen string. Pure narrowing
- *  via `in` — kein cast, kein assertion. */
+/** Extracts the `__component` name from a PlatformComponent. Reads the
+ *  react and native branches (the app author registers both under the same
+ *  name); returns the first string found. Pure narrowing via `in` — no cast
+ *  or assertion. */
 export declare function extensionSectionName(component: PlatformComponent): string | undefined;
 export type ExtensionSectionProps = {
     readonly entityName: string;
     readonly entityId: string | null;
-    /** Bereits gespeicherte Extension-Werte der Entity (aus der geladenen
-     *  detail-row durchgereicht). `undefined` im Create-Mode oder wenn der
-     *  Host-Screen keine Werte liefert. Erlaubt der Section, den Bestand
-     *  beim Edit anzuzeigen statt write-only zu sein. */
+    /** Previously saved extension values for the entity (passed through from
+     *  the loaded detail row). `undefined` in create mode or when the host
+     *  screen provides no values. Allows the section to display existing
+     *  values while editing instead of being write-only. */
     readonly initialValues?: Readonly<Record<string, unknown>>;
-    /** Nur im List-Header-Slot gesetzt (entityId ist dort null): die screen.id
-     *  der Liste, damit ein Header-Control den per-Screen URL-Filter-State
-     *  (useListUrlState) ansprechen kann — z.B. ein Tag-Filter der die Liste auf
-     *  eine id-Menge narrowed. In entityEdit-Sections undefined. */
+    /** Set only in the list-header slot (`entityId` is null): the list's
+     *  `screen.id`, so a header control can access the per-screen URL filter
+     *  state (`useListUrlState`) — for example, a tag filter that narrows the
+     *  list to a set of IDs. `undefined` in entityEdit sections. */
     readonly screenId?: string;
-    /** Nur im Dashboard-`custom`-Panel gesetzt: der aktuell gewählte Wert des
-     *  Screen-Filters (siehe DashboardFilterDefinition), gemerged wie bei jeder
-     *  anderen Panel-Query. In allen anderen Mount-Orten undefined. Dashboard-
-     *  Panels haben keine Entity — entityName/entityId tragen dort die
-     *  screen.id bzw. null, siehe CustomPanelBody in dashboard-body.tsx. */
+    /** Set only in a Dashboard-`custom` panel: the currently selected value
+     *  of the screen filter (see DashboardFilterDefinition), merged as with any
+     *  other panel query. `undefined` in all other mount locations. Dashboard
+     *  panels have no entity — `entityName`/`entityId` contain the `screen.id`
+     *  and `null`, respectively; see CustomPanelBody in dashboard-body.tsx. */
     readonly filterParams?: Readonly<Record<string, unknown>>;
-    /** Current form values of the host RenderEdit (controlled mode,
-     *  issue #1887/#1888) — same snapshot reference as
+    /** Current form values of the host RenderEdit (controlled mode) — same snapshot reference as
      *  `RenderEditChangeState.values`. Lets the section read the host
      *  form's live state (e.g. for a review step). Only set in
      *  entityEdit sections; undefined in list-header and dashboard
@@ -44,10 +43,12 @@ export type ExtensionSectionProps = {
      *  `snapshot.errors` on the field instead of a collective message.
      *  Undefined outside entityEdit sections. */
     readonly validate?: () => boolean;
-    /** Marks the current host form values as saved after the section wrote
-     *  them itself, so a following navigation does not ask to discard.
+    /** Marks host form values as saved after the section wrote them itself, so
+     *  a following navigation does not ask to discard. Pass the field names the
+     *  section persisted: other host fields keep their unsaved state. Without
+     *  `fields`, every current host value counts as saved.
      *  Undefined outside entityEdit sections and the entityEdit footer slot. */
-    readonly markSaved?: () => void;
+    readonly markSaved?: (fields?: readonly string[]) => void;
     /** Whether the host form has unsaved changes. Only set in the entityEdit
      *  footer slot (`screen.slots.footer`); undefined in all other mounts. */
     readonly hasUnsavedChanges?: boolean;
@@ -73,10 +74,10 @@ export type ExtensionSectionsProviderProps = {
     readonly value: ExtensionSectionsMap;
 };
 export declare function ExtensionSectionsProvider({ children, value, }: ExtensionSectionsProviderProps): ReactNode;
-/** Schaut die Component für einen extension-section-Namen nach. Returnt
- *  undefined wenn weder Provider gemounted noch der Name in der Map
- *  registriert ist — der Caller (RenderEdit) zeigt dann seinen
- *  Placeholder-Banner. `name` ist optional damit Caller den Hook
- *  unkonditional aufrufen können (Rules-of-Hooks), ohne einen Stub-Key
- *  wie `""` reichen zu müssen — analog `useColumnRenderer`. */
+/** Looks up the component for an extension-section name. Returns
+ *  `undefined` when no provider is mounted or the name is not registered in
+ *  the map — the caller (RenderEdit) then displays its placeholder banner.
+ *  `name` is optional so callers can invoke the hook unconditionally
+ *  (Rules-of-Hooks) without supplying a stub key such as `""`, analogous to
+ *  `useColumnRenderer`. */
 export declare function useExtensionSectionComponent(name?: string): ExtensionSectionComponent | undefined;

package/dist/app/extension-sections.js

@@ -1,9 +1,9 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useContext } from "react";
-/** Extrahiert den `__component`-Namen aus einer PlatformComponent. Liest
- *  react- und native-Branch (die App-Author registriert beide unter dem
- *  gleichen Namen); returnt den ersten gefundenen string. Pure narrowing
- *  via `in` — kein cast, kein assertion. */
+/** Extracts the `__component` name from a PlatformComponent. Reads the
+ *  react and native branches (the app author registers both under the same
+ *  name); returns the first string found. Pure narrowing via `in` — no cast
+ *  or assertion. */
 export function extensionSectionName(component) {
     for (const branch of [component.react, component.native]) {
         if (branch !== null && typeof branch === "object" && "__component" in branch) {
@@ -18,12 +18,12 @@ const ExtensionSectionsContext = createContext(undefined);
 export function ExtensionSectionsProvider({ children, value, }) {
     return (_jsx(ExtensionSectionsContext.Provider, { value: value, children: children }));
 }
-/** Schaut die Component für einen extension-section-Namen nach. Returnt
- *  undefined wenn weder Provider gemounted noch der Name in der Map
- *  registriert ist — der Caller (RenderEdit) zeigt dann seinen
- *  Placeholder-Banner. `name` ist optional damit Caller den Hook
- *  unkonditional aufrufen können (Rules-of-Hooks), ohne einen Stub-Key
- *  wie `""` reichen zu müssen — analog `useColumnRenderer`. */
+/** Looks up the component for an extension-section name. Returns
+ *  `undefined` when no provider is mounted or the name is not registered in
+ *  the map — the caller (RenderEdit) then displays its placeholder banner.
+ *  `name` is optional so callers can invoke the hook unconditionally
+ *  (Rules-of-Hooks) without supplying a stub key such as `""`, analogous to
+ *  `useColumnRenderer`. */
 export function useExtensionSectionComponent(name) {
     const map = useContext(ExtensionSectionsContext);
     if (name === undefined || name === "")

package/dist/app/feature-schema.js

@@ -4,10 +4,10 @@
 // file that exports a schema can be imported from the browser bundle
 // without dragging in Node-only framework internals.
 //
-// Types wohnen in `framework/ui-types/app-schema.ts` damit der Server
-// (buildAppSchema, dev-server) sie produzieren kann ohne renderer als
-// Dependency zu ziehen. Hier nur Re-Export + Runtime-Helpers
-// (toAppSchema, isAppSchema) die Client-Code zur Laufzeit braucht.
+// Types live in `framework/ui-types/app-schema.ts` so the server
+// (buildAppSchema, dev-server) can produce them without pulling in
+// renderer as a dependency. Only re-exports and runtime helpers
+// (toAppSchema, isAppSchema) needed by client code at runtime belong here.
 //
 // Typical layout on the feature author's side:
 //
@@ -28,10 +28,10 @@
 //     r.screen(editScreen);
 //     ...
 //   });
-// Normalisiert FeatureSchema → AppSchema. Idempotent für AppSchema.
-// Hebt eine Feature-lokal deklarierte `workspaces`-Liste (Legacy) auf
-// App-Ebene hoch, damit alle Layouts mit der neuen Form arbeiten können
-// ohne dass alte clientSchemas migriert werden müssen.
+// Normalizes FeatureSchema → AppSchema and is idempotent for AppSchema.
+// Promotes a feature-local `workspaces` list (legacy) to the app level
+// so all layouts can use the new form without requiring old clientSchemas
+// to be migrated.
 export function toAppSchema(input) {
     if ("features" in input)
         return input;
@@ -42,9 +42,9 @@ export function toAppSchema(input) {
         ...(workspaces !== undefined && { workspaces }),
     };
 }
-// TypeGuard — Caller die schon zur Laufzeit unterscheiden müssen
-// (selten; meist reicht toAppSchema). Nicht via `"features" in x` inline
-// machen — narrow'd TS dann auf den join-Typ statt die echte Differenz.
+// Type guard for callers that need to distinguish the types at runtime
+// (rare; toAppSchema is usually sufficient). Do not use `"features" in x`
+// inline: TS then narrows to the join type instead of the actual distinction.
 export function isAppSchema(input) {
     return "features" in input;
 }

package/dist/app/form-schema.js

@@ -26,10 +26,10 @@ function isRequiredValueMissing(spec, field, record, unchangedFrom) {
     if (!isRequired)
         return false;
     // Embedded LIST fields get their own EmbeddedListField grid widget
-    // (#1838) — they're fillable, so NO_WIDGET_FIELD_TYPES's "embedded"
+    // — they're fillable, so NO_WIDGET_FIELD_TYPES's "embedded"
     // entry must not exempt them. A statically-`required: true` field
     // with no bound widget is also caught at boot
-    // (validateNoWidgetRequiredField in boot-validator/screens.ts).
+    // (validateNoWidgetRequiredField in boot-validator/screens-forms.ts).
     if (NO_WIDGET_FIELD_TYPES.includes(field.type) && !isEmbeddedListField(field))
         return false;
     if (isPresent(record[spec.field]))

package/dist/app/header-actions-bar.js

@@ -3,7 +3,7 @@ import { RenderEditActionButton } from "../components/render-edit-action-button.
 import { useActionMenuItems } from "../components/use-action-menu-items.js";
 import { useTranslation } from "../i18n.js";
 import { compactHeaderPrimary, orderPlainHeaderActions, primaryHeaderAction, } from "./header-actions.js";
-// Header actions bar (A7): <=2 actions render as plain buttons; >2 with an
+// Header actions bar: <=2 actions render as plain buttons; >2 with an
 // `ActionOverflowMenu` primitive collapse to the primary button plus a menu
 // for the rest — same rule as RowActionsCell for table rows. Owns confirm
 // state for menu items: RenderEditActionButton already owns a per-button
@@ -18,7 +18,7 @@ export function HeaderActionsBar({ actions, Button, Dialog, ActionOverflowMenu,
     if (compact && PageHeader !== undefined) {
         const compactPrimary = compactHeaderPrimary(actions, preferredPrimaryId);
         const overflowActions = actions.filter((a) => a !== compactPrimary?.action);
-        return (_jsxs(_Fragment, { children: [compactPrimary !== undefined && (_jsx(RenderEditActionButton, { action: compactPrimary.action, Button: Button, Dialog: Dialog, iconOnly: compactPrimary.iconOnly, compactLabel: true, onError: onError }, compactPrimary.action.id)), overflowActions.length > 0 && (_jsx(PageHeader, { overflowItems: overflowActions.map(toMenuItem) })), pendingActionDialog] }));
+        return (_jsxs(_Fragment, { children: [compactPrimary !== undefined && (_jsx(RenderEditActionButton, { action: compactPrimary.action, Button: Button, Dialog: Dialog, iconOnly: compactPrimary.iconOnly, onError: onError }, compactPrimary.action.id)), overflowActions.length > 0 && (_jsx(PageHeader, { overflowItems: overflowActions.map(toMenuItem) })), pendingActionDialog] }));
     }
     const maxPlainButtons = collapseAfterPrimary ? 1 : 2;
     if (actions.length <= maxPlainButtons || ActionOverflowMenu === undefined) {

package/dist/app/kumiko-screen.js

@@ -130,9 +130,9 @@ function renderScreenBody({ schema, screen, translate, entityId, onRowClick, onC
             return _jsx(CustomScreenBody, { screenId: screen.id, featureName: schema.featureName });
     }
 }
-// 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).
+// The dashboard panel implementation (StatCard, charts) is platform-specific and
+// comes from the DashboardBody context; renderer/web registers the web
+// implementation in createKumikoApp.
 function DashboardScreenBody({ featureName, screen, translate, }) {
     const { Banner, Text } = usePrimitives();
     const Body = useDashboardBody();
@@ -141,13 +141,11 @@ function DashboardScreenBody({ featureName, screen, translate, }) {
     }
     return (_jsx(Body, { featureName: featureName, screen: screen, ...(translate !== undefined && { translate }) }));
 }
-// Lookup-Body für custom-screens: schaut die Component aus dem
-// CustomScreens-Context (gefüttert von clientFeatures.components in
-// createKumikoApp). Wenn weder Provider gemounted noch screenId
-// registriert ist, fällt es auf einen error-Banner zurück statt leer zu
-// rendern — der Screen ist per URL erreichbar sobald das Server-Feature
-// gemountet ist, unabhängig davon ob ein Client-Plugin existiert
-// (kumiko-framework#2025).
+// Looks up the component from the CustomScreens context, populated by
+// clientFeatures.components in createKumikoApp. If no provider is mounted or
+// the screenId is unregistered, an error banner is rendered instead of an
+// empty screen. The screen remains reachable by URL when the server feature is
+// mounted, even without a client plugin.
 function CustomScreenBody({ screenId, featureName, }) {
     const { Banner, Text } = usePrimitives();
     const Component = useCustomScreenComponent(screenId);

package/dist/app/layout-fields.js

@@ -3,7 +3,7 @@ import { isFieldsEditSection, normalizeEditField, sectionFieldSpecs, } from "@co
 // (and relatedList) sections skipped. Both this and `layoutFieldNames` key
 // off "rendered by the layout" for the same reason: a field the user never
 // sees gets no chance to review/correct a value nor to fix a presence error
-// (search-param merge, #1708; presence schema in form-schema.ts).
+// (search-param merge; presence schema in form-schema.ts).
 export function layoutEditFields(screen) {
     const specs = [];
     for (const section of screen.layout.sections) {

package/dist/app/list-facets.js

@@ -94,7 +94,7 @@ export function normalizeDefaultFilters(defaults) {
 // hand-crafted URL param for an undeclared field never reaches the
 // server). Deliberately NOT gated on the field being a *facet* — entityList
 // passes through any field present in entity.fields, matching its
-// pre-fw#2224 behavior; only the boolean-coercion branch cares about type.
+// earlier behavior; only the boolean-coercion branch cares about type.
 function isFacetI18nKey(label) {
     return !/\s/.test(label) && (label.includes(".") || label.includes(":"));
 }
@@ -119,8 +119,8 @@ export function buildFilterPayload(urlFilters, typeOf) {
     return out;
 }
 // projectionList/relatedList adapter — neither has an entity/i18n convention
-// to derive labels from, so ListFacetSpec carries every label explicitly
-// (fw#2224). Labels may be raw display strings or i18n keys; run them
+// to derive labels from, so ListFacetSpec carries every label explicitly.
+// Labels may be raw display strings or i18n keys; run them
 // through translate like entity facets (passthrough when the key is missing).
 // `featureName` resolves a reference facet's `entity` target the same way
 // ListColumnSpec.refEntity does (same-feature short name, or "feature:entity").

package/dist/app/nav.d.ts

@@ -40,16 +40,16 @@ export type NavApi = {
      *  platform-specific Link-Komponenten (Web: `<a href>`; Native
      *  typically doesn't need this). */
     readonly hrefFor: (target: NavTarget, options?: NavigateOptions) => string;
-    /** Lese-Snapshot der aktuellen Search-Params (Browser: ?key=value-
-     *  Pairs nach dem Pfad). Native-Impls die kein URL-Konzept haben
-     *  liefern ein leeres Object. Wert ist ein Plain-Record (kein Map)
-     *  damit React-Subscribers shallow-compare können. */
+    /** Snapshot of the current search params (browser: `?key=value` pairs
+     * after the path). Native implementations without a URL concept return
+     * an empty object. The value is a plain record, not a Map, so React
+     * subscribers can compare it shallowly. */
     readonly searchParams: Readonly<Record<string, string>>;
-    /** Mergt Updates in die aktuellen Search-Params. Wert `null` löscht
-     *  den Key. Ändert NICHT den Pfad. Plattform-Impls nutzen
-     *  history.replaceState (kein Push) — Sort/Filter-Toggles sollen
-     *  nicht die Back-Navigation fluten. Native-Impls können no-op'en
-     *  wenn das Konzept nicht existiert. */
+    /** Merges updates into the current search params. A `null` value deletes
+     * the key. The path is unchanged. Platform implementations use
+     * `history.replaceState` rather than a push so sort/filter toggles do not
+     * flood back navigation. Native implementations may no-op when the
+     * concept does not exist. */
     readonly setSearchParams: (updates: Readonly<Record<string, string | null>>) => void;
 };
 export declare function parsePath(pathname: string, hasWorkspaces?: boolean): NavRoute | undefined;
@@ -60,7 +60,7 @@ export declare function findDetailForScreen(features: readonly FeatureSchema[],
     readonly screen: FeatureSchema["screens"][number];
 } | undefined;
 /** Non-throwing existence check for findDetailForScreen — lets a caller pick
- *  a different default (fw#2164's row-click fallback) instead of resolving. */
+ *  a different default (row-click fallback) instead of resolving. */
 export declare function hasDetailScreen(features: readonly FeatureSchema[], entity: string): boolean;
 export declare function resolveTarget(features: readonly FeatureSchema[], target: NavTarget): ScreenTarget;
 export type NavProviderProps = {

package/dist/app/nav.js

@@ -1,14 +1,14 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useCallback, useContext, useEffect, useState } from "react";
 import { lastSegment } from "./qn.js";
-// Pfad-Format:
-//   ohne workspaces: `/task-list`, `/task-edit/abc-123`, `/` → undefined
-//   mit workspaces:  `/admin/task-list`, `/admin/task-edit/abc`,
-//                    `/admin` → workspace-only (no screen yet),
-//                    `/` → undefined.
-// Alles nach den ersten 2/3 Segmenten wird ignoriert — kumikos
-// Navigation-Grammatik nested nicht weiter. Nested-Routes wäre eine
-// Spec-Änderung, nicht ein URL-Shape-Unfall.
+// Path format:
+//   without workspaces: `/task-list`, `/task-edit/abc-123`, `/` → undefined
+//   with workspaces:    `/admin/task-list`, `/admin/task-edit/abc`,
+//                       `/admin` → workspace-only (no screen yet),
+//                       `/` → undefined.
+// Everything after the first 2/3 segments is ignored because Kumiko's
+// navigation grammar does not support further nesting. Nested routes would
+// be a spec change, not an accidental URL shape.
 function decodeSegments(segments) {
     try {
         return segments.map((segment) => decodeURIComponent(segment));
@@ -57,7 +57,7 @@ export function formatPath(target) {
     return `/${segments.map((segment) => encodeURIComponent(segment)).join("/")}`;
 }
 // Shared entity→detailFor-screen lookup — resolveTarget's ObjectTarget
-// branch and hasDetailScreen (create-app's row-click default, fw#2164) both
+// branch and hasDetailScreen (create-app's row-click default) both
 // need "is there a detail screen for this entity", one to resolve it, the
 // other to just check before falling back to a different default.
 export function findDetailForScreen(features, entity) {
@@ -70,7 +70,7 @@ export function findDetailForScreen(features, entity) {
     return undefined;
 }
 /** Non-throwing existence check for findDetailForScreen — lets a caller pick
- *  a different default (fw#2164's row-click fallback) instead of resolving. */
+ *  a different default (row-click fallback) instead of resolving. */
 export function hasDetailScreen(features, entity) {
     return findDetailForScreen(features, entity) !== undefined;
 }
@@ -93,9 +93,9 @@ export function resolveTarget(features, target) {
     }
     throw new Error(`resolveTarget: no detail screen for entity "${target.entity}". Add detailFor: "${target.entity}" to the screen that shows it.`);
 }
-// Context + Hook. Default ist `undefined` damit fehlender Provider
-// laut kracht statt ein silent-no-op NavApi mit toten navigate()
-// Aufrufen anzubieten.
+// Context and hook. The default is `undefined` so a missing provider fails
+// loudly instead of exposing a silent no-op NavApi with dead `navigate()`
+// calls.
 const NavContext = createContext(undefined);
 const InitialValuesHandoffContext = createContext(undefined);
 export function NavProvider({ children, value }) {

package/dist/app/projection-detail-body.js

@@ -188,11 +188,11 @@ export function ProjectionDetailBody({ schema, screen, translate, entityId, }) {
         await refetchAfterWrite(detailQuery.refetch);
         setReloadNonce((n) => n + 1);
     }, [detailQuery.refetch]);
-    // Header actions render directly via RenderEditActionButton (fw#2713,
-    // headerActions moved out of RenderEdit's footer) — this component owns
+    // Header actions render directly via RenderEditActionButton
+    // headerActions moved out of RenderEdit's footer — this component owns
     // the failure-surfacing state RenderEdit used to own for them.
     const [actionError, setActionError] = useState(null);
-    // Default edit action (fw#2166): resolved cross-feature over ALL mounted
+    // Default edit action: resolved cross-feature over ALL mounted
     // features, not just this feature's own schema — detailFor itself is
     // resolved cross-feature by the boot-validator (detail-screens.ts), and
     // the motivating case is a projectionDetail whose query belongs to one
@@ -383,7 +383,7 @@ export function ProjectionDetailBody({ schema, screen, translate, entityId, }) {
                 }),
             }) }));
     }
-    // Grouped into the head Card alongside title/status/metrics (fw#2713):
+    // Grouped into the head Card alongside title/status/metrics:
     // these are actions on the record the head shows, not on whichever tab is
     // open, so they must stay in place across tab switches instead of
     // trailing the active tab's content in the card footer.

package/dist/app/projection-detail-shim.d.ts

@@ -1,8 +1,9 @@
 import type { EditLayout, EntityDefinition, EntityEditScreenDefinition, ProjectionDetailScreenDefinition } from "@cosmicdrift/kumiko-framework/ui-types";
-/** Minimale EntityDefinition aus den Layout-Feldern: jedes Feld ein Text-
- *  Feld — computeEditViewModel liest nur `fields[<f>].type`, Text reicht für
- *  eine reine Anzeige (kein Select/Number-spezifisches Rendering nötig). */
+/** Minimal EntityDefinition built from the layout fields: every field is a text
+ *  field — computeEditViewModel only reads `fields[<f>].type`, and text is
+ *  sufficient for display-only rendering (no Select/Number-specific rendering
+ *  is needed). */
 export declare function synthesizeProjectionDetailEntity(layout: EditLayout): Pick<EntityDefinition, "fields">;
-/** Wandelt ein ProjectionDetailScreenDefinition in die EntityEditScreen-Shape
- *  die RenderEdit erwartet — mit jedem Feld hart auf readOnly:true erzwungen. */
+/** Converts a ProjectionDetailScreenDefinition to the EntityEditScreen shape
+ *  expected by RenderEdit, with every field forcibly set to readOnly:true. */
 export declare function synthesizeProjectionDetailScreen(screen: ProjectionDetailScreenDefinition): EntityEditScreenDefinition;