@cosmicdrift/kumiko-renderer 0.385.0 → 0.387.0

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
@@ -73,10 +72,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,7 +26,7 @@ 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).

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

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;

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

@@ -1,29 +1,30 @@
-// Shim für ProjectionDetail-Renderer (analog zu projection-list-shim.ts /
+// Shim for the ProjectionDetail renderer (analogous to projection-list-shim.ts /
 // config-edit-shim.ts).
 //
-// RenderEdit verlangt ein `entity: EntityDefinition` + ein
-// `screen: EntityEditScreenDefinition`-Pair, nutzt davon aber nur
-// `entity.fields` (Feld-Typ für den Input-Renderer) und `screen.layout`
-// (welche Felder in welchen Sections). Ein projectionDetail-Screen ist
-// query-getrieben und hat KEINE Entity — die zwei Helper hier shapen den
-// Input ad-hoc um, damit RenderEdit reused werden kann.
+// RenderEdit requires an `entity: EntityDefinition` +
+// `screen: EntityEditScreenDefinition` pair, but only uses
+// `entity.fields` (field type for the input renderer) and `screen.layout`
+// (which fields belong in which sections). A projectionDetail screen is
+// query-driven and has NO Entity — these two helpers shape the input ad hoc
+// so RenderEdit can be reused.
 //
-// Der strukturelle Read-Only-Beweis liegt in synthesizeProjectionDetailScreen:
-// JEDES Feld wird hart auf readOnly:true gesetzt (nicht nur was der Author im
-// Layout gesetzt hat) — hasEditableSection() liest genau dieses Flag und
-// blendet den Save-Button aus, wenn kein Feld editierbar ist. Der Author kann
-// diese Garantie nicht versehentlich umgehen.
+// The structural read-only guarantee is established in
+// synthesizeProjectionDetailScreen: EVERY field is forced to readOnly:true
+// (not just fields the author marked in the layout) — hasEditableSection()
+// reads exactly this flag and hides the Save button when no field is
+// editable. The author cannot accidentally bypass this guarantee.
 //
-// Selbe Schulden-Reservation wie bei den anderen Shims: greift RenderEdit
-// künftig auf weitere EntityDefinition-Felder (transitions, idType) zu, oder
-// cross-referenziert ein Boot-Validator die schema.entities-Map, brechen die
-// Type-Lies hier silent — dann ist Zeit für eine echte RenderProjectionDetail-
-// Komponente.
+// Same debt reservation as in the other shims: if RenderEdit later accesses
+// additional EntityDefinition fields (transitions, idType), or a boot
+// validator cross-references the schema.entities map, these type lies will
+// fail silently — then it is time for a real RenderProjectionDetail
+// component.
 import { isFieldsEditSection, normalizeEditField, PROJECTION_DETAIL_ENTITY as PROJECTION_DETAIL_PSEUDO_ENTITY, sectionFieldSpecs, } from "@cosmicdrift/kumiko-framework/ui-types";
 import { SYNTHESIZED_FIELD_PII_REASON } from "./projection-list-shim.js";
-/** 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 function synthesizeProjectionDetailEntity(layout) {
     const fields = {};
     for (const section of layout.sections) {
@@ -39,8 +40,8 @@ export function synthesizeProjectionDetailEntity(layout) {
     }
     return { 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 function synthesizeProjectionDetailScreen(screen) {
     const forceReadOnly = (spec) => ({ ...normalizeEditField(spec), readOnly: true });
     const sections = screen.layout.sections.map((section) => {

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

@@ -27,7 +27,7 @@ import { buildListQueryPayload, pageSizeOptionsFor } from "./screen-shared.js";
 // (instead of being derived from an entity) — cross-feature capable.
 // search/sort/pagination reuse the same URL-state + buildListQueryPayload
 // wiring as EntityListBody; which of them are actually offered is derived
-// from the query handler's Zod schema at buildAppSchema time (fw#2165), not
+// from the query handler's Zod schema at buildAppSchema time, not
 // declared here. Pages-mode pagination only — infinite-scroll accumulation
 // isn't wired for projectionList.
 export function ProjectionListBody({ schema, screen, translate, onRowClick, }) {
@@ -49,7 +49,7 @@ export function ProjectionListBody({ schema, screen, translate, onRowClick, }) {
         return findEditScreenFor(detailFor, appFeatures, userRoles);
     }, [appFeatures, screen.detailFor, userRoles]);
     // searchable/sortable/paginated are derived at buildAppSchema time from the
-    // query handler's Zod schema (fw#2165) — not authored on the screen.
+    // query handler's Zod schema — not authored on the screen.
     const searchable = screen.searchable ?? false;
     const sortable = screen.sortable ?? false;
     const paginated = screen.paginated ?? false;
@@ -72,7 +72,7 @@ export function ProjectionListBody({ schema, screen, translate, onRowClick, }) {
     // Pages-mode only (see header comment) — an author-set pagination:
     // "infinite" on a paginated projectionList is silently a no-op today.
     const usePager = paginated && (screen.pagination ?? "pages") === "pages";
-    // Facets (fw#2224) — a projectionList has no entity, so screen.facets is
+    // Facets — a projectionList has no entity, so screen.facets is
     // the only field inventory; resolveProjectionFacetSpecs reshapes +
     // translates its explicit labels into the same ResolvedFacetSpec the
     // entityList adapter produces, so both feed the same
@@ -82,7 +82,7 @@ export function ProjectionListBody({ schema, screen, translate, onRowClick, }) {
     const handleProjectionFacetOptions = useCallback((field, options) => setProjectionReferenceFacetOptions((prev) => prev[field] === options ? prev : { ...prev, [field]: options }), []);
     const resolvedFacetSpecs = useMemo(() => mergeReferenceFacetOptions(facetSpecs, projectionReferenceFacetOptions), [facetSpecs, projectionReferenceFacetOptions]);
     const filterPayload = useMemo(() => buildFilterPayload(urlState.filters, (field) => facetSpecs.find((spec) => spec.field === field)?.type), [urlState.filters, facetSpecs]);
-    // dateRange facets (fw#3104) bypass `filters` entirely — their two bounds
+    // dateRange facets bypass `filters` entirely — their two bounds
     // become the top-level query params the facet declares, resolved from a
     // calendar date to an instant in the viewer's zone.
     const timeZone = useOptionalTimeZone();
@@ -101,7 +101,7 @@ export function ProjectionListBody({ schema, screen, translate, onRowClick, }) {
         // Gated on screen.filter/screen.facets being declared (not just on
         // urlState/filterPayload happening to carry a value) — same rule as
         // activeSearch/activeSort above: a stale URL must not smuggle a param
-        // the bound query's Zod schema doesn't accept (fw#2165 pattern).
+        // the bound query's Zod schema doesn't accept.
         if (screen.filter !== undefined) {
             payload["filter"] = screen.filter;
         }
@@ -131,8 +131,8 @@ export function ProjectionListBody({ schema, screen, translate, onRowClick, }) {
     const handleDateRangeChange = useCallback((field, bound, value) => {
         urlState.setDateRange(field, clampDateRange(readDateRange(urlState.filters, field), bound, value));
     }, [urlState.setDateRange, urlState.filters]);
-    // Entity-Targets (fw#2228) — see EntityListBody.runNavigate for why the
-    // resolution happens in the NavApi impl. Unlike there: NO row["id"]
+    // Entity targets: see EntityListBody.runNavigate for why the resolution happens
+    // in the NavApi impl. Unlike there: NO row["id"]
     // fallback — projectionList rows come from an arbitrary query projection
     // with no guaranteed "id" field. The boot validator therefore enforces an
     // explicit entityId for projectionList entity targets. Same helper
@@ -198,8 +198,8 @@ export function ProjectionListBody({ schema, screen, translate, onRowClick, }) {
     // A failed refetch keeps the last good data on screen.
     const refetchErrorBanner = rowsQuery.error ? (_jsx(QueryErrorBanner, { error: rowsQuery.error, translate: effectiveTranslate, onRetry: rowsQuery.refetch })) : null;
     // rowsQuery.data is typed as PagedRows but the query handler is free to
-    // return anything at runtime (fw#2216: a bare array silently rendered an
-    // empty table instead of surfacing the mismatch), so the shape is checked.
+    // return anything at runtime (a bare array silently rendered an empty
+    // table instead of surfacing the mismatch), so the shape is checked.
     if (rowsQuery.data !== null && !Array.isArray(rowsQuery.data.rows)) {
         return (_jsxs(Banner, { padded: true, variant: "error", testId: "kumiko-screen-projection-list-bad-shape", children: ["Screen ", _jsx(Text, { variant: "code", children: screen.id }), " query", " ", _jsx(Text, { variant: "code", children: screen.query }), " did not return a PagedRows envelope; a projectionList query must return ", _jsx(Text, { variant: "code", children: "{ rows, nextCursor }" }), "."] }));
     }
@@ -213,7 +213,7 @@ export function ProjectionListBody({ schema, screen, translate, onRowClick, }) {
             : undefined;
     // Same pager-construction as EntityListBody: no Pager UI until the
     // server-provided `total` arrives (guards pagination="pages" without
-    // totalCount support, see fw#2165 report on solon's leaseOverviewHandler).
+    // totalCount support).
     const total = rowsQuery.data?.total;
     const pager = usePager && total !== undefined
         ? {

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

@@ -2,14 +2,14 @@ import type { EntityDefinition, EntityListScreenDefinition, ListColumnSpec, Proj
 export declare const SYNTHESIZED_FIELD_PII_REASON = "synthesized display field, not stored entity data";
 /** Minimal EntityDefinition from the column list: every field is a text
  *  field. `sortable` applies to all columns — buildAppSchema derives it from
- *  the query's Zod schema (`screen.sortable`, fw#2165); the query itself has
+ *  the query's Zod schema (`screen.sortable`); the query itself has
  *  no per-field server-sort guarantee, so a column opts out with
  *  `sortable: false` when the handler cannot order by it.
  *  computeListViewModel only reads `fields[<col>].type` — text is enough,
  *  presentation comes from the column renderer + explicit label. */
 export declare function synthesizeProjectionEntity(columns: readonly ListColumnSpec[], sortable: boolean): Pick<EntityDefinition, "fields">;
-/** Wandelt ein ProjectionListScreenDefinition in die EntityListScreen-Shape die
- *  RenderList erwartet. `type` = "entityList" + Pseudo-Entity halten den Type-
- *  Constraint; RenderList branched nicht auf `type` und liest `entity` nur für
- *  Fehlermeldungen. Die List-Felder werden 1:1 durchgereicht. */
+/** Converts a ProjectionListScreenDefinition to the EntityListScreen shape
+ *  expected by RenderList. `type` = "entityList" plus a pseudo-entity satisfy
+ *  the type constraint; RenderList does not branch on `type` and reads `entity`
+ *  only for error messages. The list fields are passed through unchanged. */
 export declare function synthesizeProjectionScreen(screen: ProjectionListScreenDefinition): EntityListScreenDefinition;