@cosmicdrift/kumiko-renderer 0.386.0 → 0.388.0

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;

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

@@ -1,18 +1,17 @@
-// Shim für ProjectionList-Renderer (analog action-form-shim.ts / config-edit-shim.ts).
+// Shim for the ProjectionList renderer (analogous to action-form-shim.ts / config-edit-shim.ts).
 //
-// RenderList + computeListViewModel verlangen ein `entity: EntityDefinition` +
-// ein `screen: EntityListScreenDefinition`-Pair, nutzen davon aber nur
-// `entity.fields` (Spalten-Typ/Label) und die List-Felder des Screens
-// (columns/rowActions/…). Ein projectionList-Screen ist query-getrieben und hat
-// KEINE Entity — die zwei Helper hier shapen den Input ad-hoc um, damit die
-// bestehende List-Maschinerie reused werden kann. Die Query selbst wird NICHT
-// hierüber aufgelöst (der Body nimmt `screen.query` direkt).
+// RenderList + computeListViewModel require an `entity: EntityDefinition` +
+// `screen: EntityListScreenDefinition` pair, but only use `entity.fields`
+// (column type/label) and the screen's list fields (columns/rowActions/…). A
+// projectionList screen is query-driven and has NO entity, so these two helpers
+// reshape the input ad hoc to reuse the existing list machinery. The query is
+// NOT resolved here (the body reads `screen.query` directly).
 //
-// Selbe Schulden-Reservation wie bei den anderen Shims: greift die List-
-// Maschinerie künftig auf weitere EntityDefinition-Felder (transitions, idType,
-// derivedFields) oder cross-referenziert ein Boot-Validator die schema.entities-
-// Map, brechen die Type-Lies hier silent — dann ist Zeit für eine echte
-// query-native ListView-Komponente.
+// This preserves the same debt reservation as the other shims: if the list
+// machinery later accesses additional EntityDefinition fields (transitions,
+// idType, derivedFields), or a boot validator cross-references the
+// schema.entities map, these type lies will fail silently. At that point, a
+// query-native ListView component is needed.
 import { normalizeListColumn } from "@cosmicdrift/kumiko-framework/ui-types";
 const PROJECTION_PSEUDO_ENTITY = "__projection__";
 // Satisfies the text-field PII stance of the entity field type; these synthesized
@@ -20,7 +19,7 @@ const PROJECTION_PSEUDO_ENTITY = "__projection__";
 export 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,
@@ -37,10 +36,10 @@ export function synthesizeProjectionEntity(columns, sortable) {
     }
     return { 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 function synthesizeProjectionScreen(screen) {
     return {
         id: screen.id,

package/dist/app/qn.js

@@ -1,21 +1,19 @@
-// Qualified-Name-Helper. Kumiko's Registry stempelt beim Boot den
-// Feature-Prefix auf jede Screen/Nav/Workspace-id ein:
+// Qualified-name helper. At boot, Kumiko's Registry adds the feature prefix to every Screen/Nav/Workspace ID:
 //
 //   r.screen({ id: "task-list", ... })
 //     → registry-stored.id === "tasks:screen:task-list"
-//     → schema.screens (ans Browser) hat id === "tasks:screen:task-list"
+//     → schema.screens (sent to the browser) has id === "tasks:screen:task-list"
 //
-// Der Renderer arbeitet aber mit Short-Form ids — formatPath schreibt
-// sie 1:1 in die URL, parsePath liest sie 1:1 raus. Beim Übergang von
-// Schema (QN-Form) → nav.navigate (Short-Form) muss der Prefix weg,
-// sonst landet die URL doppelt-qualifiziert
-// ("/tasks:screen:task-list" + Re-Lookup → "tasks:screen:tasks:screen:
+// The renderer uses short-form IDs: formatPath writes them to the URL unchanged,
+// and parsePath reads them back unchanged. When converting from the schema (QN form)
+// to nav.navigate (short form), the prefix must be removed; otherwise the URL becomes
+// doubly qualified
+// ("/tasks:screen:task-list" + re-lookup → "tasks:screen:tasks:screen:
 // task-list" → 404).
 //
-// `lastSegment` ist die Inverse von qualifyScreenId/Nav/Workspace —
-// nimmt den letzten ":"-getrennten Teil. Robust gegen Strings ohne
-// ":" (returnt sie unverändert, damit App-Author-Code mit Short-Form-
-// ids in eigenen Stellen weiter passt).
+// `lastSegment` is the inverse of qualifyScreenId/Nav/Workspace: it takes the final
+// ":"-separated part. Strings without ":" are returned unchanged so app-author code
+// using short-form IDs continues to work.
 export function lastSegment(qn) {
     const idx = qn.lastIndexOf(":");
     return idx < 0 ? qn : qn.slice(idx + 1);

package/dist/app/qualify-screen-id.js

@@ -7,7 +7,7 @@ export function qualifyScreenId(featureName, screenId) {
 // Inverse of qualifyScreenId. A short id ("task-list") has no feature
 // segment and returns undefined — callers need that to tell "this redirect
 // names a feature" apart from "this redirect is feature-less, resolve by
-// short id alone" (fw#2485).
+// short id alone".
 export function featureNameFromQualifiedScreenId(id) {
     const parts = id.split(":");
     return parts.length === 3 && parts[1] === "screen" ? parts[0] : undefined;

package/dist/app/screen-access.js

@@ -1,7 +1,7 @@
 import { isUiAccessGranted } from "@cosmicdrift/kumiko-framework/ui-types";
 import { findDetailForScreen } from "./nav.js";
 import { lastSegment } from "./qn.js";
-// Shared UI-visibility predicate for the screen-render path (#1203 — nav
+// Shared UI-visibility predicate for the screen-render path — nav
 // filtering via filterByAccess in workspace-shell.tsx hid role-gated
 // screens from the menu, but a direct URL/screenQn hit reached
 // KumikoScreen unchecked). Public name kept as an alias of the shared
@@ -9,7 +9,7 @@ import { lastSegment } from "./qn.js";
 export { isUiAccessGranted as screenAccessAllows };
 // A navigate target (metric click) declares no access rule of its own — the
 // destination screen already does, so the jump is offered exactly when the
-// user may open where it lands (solon#424). No second copy of the rule to
+// user may open where it lands. No second copy of the rule to
 // drift from the screen's own.
 export function navigateTargetAllows(navigate, appFeatures, userRoles) {
     const { screen, entity } = navigate;

package/dist/app/screen-shared.js

@@ -166,7 +166,7 @@ export function entityQueryCommand(featureName, entity, verb) {
 // search/sort/sortDirection/limit + offset/totalCount for pager mode OR
 // cursor for infinite scroll. Shared by EntityListBody and
 // ProjectionListBody so the two branches can't drift on this shape
-// (fw#2165) — entity-only additions (screen.filter, faceted filters) are
+// — entity-only additions (screen.filter, faceted filters) are
 // layered on top by the caller instead of living in here.
 export function buildListQueryPayload(state) {
     const payload = { limit: state.limit };

package/dist/app/secret-mint-body.js

@@ -40,10 +40,10 @@ function isBlank(value) {
 // Mint form → one-time reveal → optional confirm → done. The revealed values
 // live ONLY in this component's `revealed` state — never in the URL, a query
 // cache, or nav — the write-handler's success payload is the only place the
-// secret ever exists (fw#2548). onSubmit copies exclusively the fields
+// secret ever exists. onSubmit copies exclusively the fields
 // declared in `screen.reveal.fields` out of that payload (a whitelist, never
 // the payload as a whole) so an unrelated field (e.g. an internal "id") can
-// never leak into the reveal. `screen.confirm` (fw#2838, e.g. TOTP enroll:
+// never leak into the reveal. `screen.confirm` (e.g. TOTP enroll:
 // scan the code, then enter one) works the same way for its own carried
 // mint-payload fields — those live only in `carriedRef`, never in React state
 // that gets rendered, never in the confirm form's own values.
@@ -63,7 +63,7 @@ export function SecretMintBody({ schema, screen, translate }) {
         urlPrefillFields: screen.urlPrefillFields,
         renderableFields: layoutFieldNames(synthScreen),
         // A mint form has no entity either, so its money fields name their own
-        // currency source (fw#2839, fw#2933).
+        // currency source.
         ...(mintCurrencyOverrides !== undefined && {
             moneyCurrencyOverrides: mintCurrencyOverrides,
         }),
@@ -188,7 +188,7 @@ export function SecretMintBody({ schema, screen, translate }) {
         // submit state) across phases.
         if (confirm !== undefined && confirmEntity !== undefined && confirmScreen !== undefined) {
             // Hold until a tenant-declared currency lands, else the form would seed (and
-            // on a fast click submit) the fallback currency (fw#2933).
+            // on a fast click submit) the fallback currency.
             if (confirmCurrencyLoading) {
                 return _jsx(QueryLoadingBanner, {});
             }

package/dist/app/write-failed-error.js

@@ -1,8 +1,8 @@
-// dispatcher.write wirft bei Server-Fehlern NICHT — es returnt
-// { isSuccess: false, error }. Action-Wiring das das Result verwirft,
-// macht Fehler unsichtbar ("Klick tut nichts"-Prod-Bug 2026-06-07).
-// Diese Klasse trägt den strukturierten DispatcherError dahin, wo eine
-// UI ihn anzeigen kann (Toast mit docsUrl).
+// dispatcher.write does NOT throw on server errors; it returns
+// { isSuccess: false, error }. Action wiring that discards the result
+// makes failures invisible ("click does nothing" in production).
+// This class carries the structured DispatcherError to a layer that can
+// display it in the UI, such as a toast with docsUrl.
 export class WriteFailedError extends Error {
     dispatcherError;
     constructor(error, message) {
@@ -11,8 +11,9 @@ export class WriteFailedError extends Error {
         this.dispatcherError = error;
     }
 }
-// i18nKey gewinnt wenn das Bundle ihn kennt (translate returnt den Key
-// unverändert wenn nicht — Renderer-Convention), sonst message, zuletzt code.
+// i18nKey takes precedence when the bundle knows it (translate returns
+// the key unchanged when it does not, per the renderer convention),
+// followed by message and then code.
 export function dispatcherErrorText(error, translate) {
     const translated = translate(error.i18nKey, error.i18nParams);
     if (translated !== error.i18nKey)

package/dist/components/edit-mounts.d.ts

@@ -10,7 +10,7 @@ export declare function ExtensionSectionMount({ section, entityName: hostEntityN
     readonly values?: Readonly<Record<string, unknown>>;
     readonly patch?: (partial: Readonly<Record<string, unknown>>) => void;
     readonly validate?: () => boolean;
-    readonly markSaved?: () => void;
+    readonly markSaved?: (fields?: readonly string[]) => void;
     readonly hideTitle?: boolean;
     /** section.actions, already resolved into buttons by the caller. */
     readonly actions?: ReactNode;
@@ -24,7 +24,7 @@ export declare function EditSlotMount({ slot, slotName, screenId, entityName, en
     readonly entityName: string;
     readonly entityId: string | null;
     readonly values: Readonly<Record<string, unknown>>;
-    readonly markSaved?: () => void;
+    readonly markSaved?: (fields?: readonly string[]) => void;
     readonly hasUnsavedChanges?: boolean;
     readonly wizardStep?: {
         readonly index: number;

package/dist/components/embedded-list-field.js

@@ -71,11 +71,11 @@ function coerceCellValue(column, text, currency) {
             // (renderCellControl's MoneyInput, which scales by the same
             // currencyDecimals) — a hardcoded ×100 here diverged for zero-/three-
             // decimal currencies (JPY, BHD, ...), landing a pasted value 100x off
-            // from the same value typed by hand (kumiko-framework#1972).
+            // from the same value typed by hand.
             // parseLocaleAwareDecimal handles both "1.234,56" (de) and
             // "1,234.56" (en-US) thousands/decimal conventions — a naive
-            // `replace(",", ".")` mangled DE-locale pastes with thousands
-            // separators into NaN (kumiko-framework#1838).
+            // `replace(",", ".")` mangled German-locale pastes with thousands
+            // separators into NaN.
             if (text.trim() === "")
                 return undefined;
             const n = parseLocaleAwareDecimal(text);
@@ -169,7 +169,7 @@ function EmbeddedListFieldInner({ field, id, onChange, allIssues, featureName, }
             };
         }
         return {
-            field: entry.from.join("+"),
+            field: `${entry.from.join("+")}:${entry.label}`,
             label: t(entry.label),
             value: entry.from.reduce((sum, name) => sum + sumEmbeddedListColumn(rows, name), 0),
             money: entry.from.every((name) => cells.find((c) => c.field === name)?.type === "money"),
@@ -259,7 +259,7 @@ function EmbeddedListFieldInner({ field, id, onChange, allIssues, featureName, }
                 const coerced = coerceCellValue(column, text, field.embeddedListCurrency ?? "EUR");
                 // Also covers an unparseable money paste (e.g. mangled thousands
                 // separators) — the cell must stay unchanged instead of silently
-                // clearing to undefined (kumiko-framework#1838).
+                // clearing to undefined.
                 const isUnmatchedOrUnparseable = (column.type === "select" || column.type === "reference" || column.type === "money") &&
                     coerced === undefined &&
                     text.trim() !== "";

package/dist/components/grid-cell-for-field.d.ts

@@ -7,7 +7,7 @@ export type GridCellForFieldProps = {
     readonly issues: readonly FieldIssue[] | undefined;
     readonly onChange: (value: unknown) => void;
     readonly GridCell: ReturnType<typeof usePrimitives>["GridCell"];
-    /** Tier 2.7e-3: passed through so Reference fields can build the correct
+    /** Passed through so Reference fields can build the correct
      *  lookup query QN (`<feature>:query:<refEntity>:list`). */
     readonly featureName: string;
     readonly labelAppendix?: ReactNode;

package/dist/components/reference-create-dialog.js

@@ -8,7 +8,7 @@ import { usePrimitives } from "../primitives.js";
 import { RenderEdit } from "./render-edit.js";
 // Hosts a target entity's create-form inside a bare Modal so a reference
 // field can create a missing record without leaving the current form
-// (kumiko-framework#1681) — same create wiring as EntityEditCreateBody
+// — same create wiring as EntityEditCreateBody
 // (kumiko-screen.tsx), but reports the new id back via a callback instead
 // of navigating to the entity's list screen.
 function entityWriteCommand(featureName, entity) {
@@ -17,7 +17,7 @@ function entityWriteCommand(featureName, entity) {
 // The create handler's success payload is `{ kind: "save", id, ... }`
 // (see event-store-executor-write.ts) but RenderEdit's onSubmit only
 // types it as `unknown` — narrow defensively instead of casting through it.
-// `field` is author-declared (ActionFormRedirect.idFrom, fw#2670), never
+// `field` is author-declared (ActionFormRedirect.idFrom), never
 // user input; the own-property check keeps a prototype key like
 // "constructor" from resolving to anything.
 export function extractIdField(data, field) {
@@ -36,7 +36,7 @@ export function ReferenceCreateDialog({ open, onClose, onCreated, featureName, s
     const t = useTranslation();
     const entityDefaultCurrency = entity.defaultCurrency ?? "EUR";
     const tenantCurrencyFieldNames = useMemo(() => (open ? tenantCurrencyMoneyFieldNames(entity.fields) : []), [open, entity.fields]);
-    // Same tenant-currency resolution as the entityEdit create screen (fw#2933),
+    // Same tenant-currency resolution as the entityEdit create screen,
     // so a `currency: { kind: "tenant" }` field seeds identically via this dialog.
     const { overrides: moneyCurrencyOverrides, loading: currencyLoading } = useMoneyCurrencyOverrides(entity.fields, tenantCurrencyFieldNames, entityDefaultCurrency);
     const initial = useMemo(() => buildInitialValues(entity.fields, entityDefaultCurrency, moneyCurrencyOverrides), [entity.fields, entityDefaultCurrency, moneyCurrencyOverrides]);

package/dist/components/related-list-section.d.ts

@@ -13,7 +13,7 @@ export declare function RelatedListSection({ section, parentId, record, featureN
     readonly hideTitle?: boolean;
     /** Under a fixed-height screen the tab panel chain stretches so the count footer sits at the bottom. */
     readonly grow?: boolean;
-    /** Opens a drawer-kind rowAction (fw#2710). Supplied by the parent
+    /** Opens a drawer-kind rowAction. Supplied by the parent
      *  (ProjectionDetailBody), which owns schema + the actual Drawer render —
      *  this component only ever invokes the callback. */
     readonly onOpenDrawer?: (action: RowActionDrawer, initialValues: Readonly<Record<string, unknown>> | undefined) => void;

package/dist/components/related-list-section.js

@@ -22,8 +22,21 @@ import { usePrimitives, } from "../primitives.js";
 import { sortByAccessor } from "../sort-by-accessor.js";
 import { RenderEditActionButton } from "./render-edit-action-button.js";
 import { RenderList } from "./render-list.js";
+// Keyed on the type, not on key presence: most factories omit `sortable`
+// from the definition, so `"sortable" in field` would drop the column flag.
+const NON_SORTABLE_FIELD_TYPES = new Set([
+    "longText",
+    "multiSelect",
+    "embedded",
+    "jsonb",
+    "tz",
+    "file",
+    "image",
+    "files",
+    "images",
+]);
 function isSortableCapable(field) {
-    return "sortable" in field;
+    return !NON_SORTABLE_FIELD_TYPES.has(field.type);
 }
 const RELATED_LIST_PSEUDO_ENTITY = "__related-list__";
 // Minimal EntityDefinition from the section's own columns — same shape as
@@ -338,7 +351,7 @@ export function RelatedListSection({ section, parentId, record, featureName, tra
     // A truncated fetch means `sortedRows` is a sort of a partial set, not of
     // the full related-row set — the client-side sort above (or even plain
     // unsorted display) would silently claim "these are the top N" when they
-    // are really just "the first N in the server's own order" (fw#2722 review).
+    // are really just "the first N in the server's own order".
     // `nextCursor` is exactly how the paged envelope marks that: non-null means
     // more rows exist server-side beyond what was fetched.
     // A handler that omits `nextCursor` (or reports a `total` the fetched rows

package/dist/components/render-edit-action-button.d.ts

@@ -10,15 +10,13 @@ export declare function RenderEditActionConfirmDialog({ action, open, onOpenChan
     readonly onConfirm: () => void | Promise<void>;
     readonly Dialog: ReturnType<typeof usePrimitives>["Dialog"];
 }): ReactNode;
-export declare function RenderEditActionButton({ action, iconOnly, hideIcon, compactLabel, Button, Dialog, onError, }: {
+export declare function RenderEditActionButton({ action, iconOnly, hideIcon, Button, Dialog, onError, }: {
     readonly action: RenderEditAction;
     /** Group-level collapse (see `shouldRenderActionsIconOnly`) — only takes
      *  effect when this action actually resolved an icon. */
     readonly iconOnly?: boolean;
     /** Record-header actions are text-only; the icon still shows when collapsed to icon-only. */
     readonly hideIcon?: boolean;
-    /** Short labelled button for a phone header, where a bare icon would hide what the action does. */
-    readonly compactLabel?: boolean;
     readonly Button: ReturnType<typeof usePrimitives>["Button"];
     readonly Dialog: ReturnType<typeof usePrimitives>["Dialog"];
     readonly onError: (notice: ErrorNotice | null) => void;

package/dist/components/render-edit-action-button.js

@@ -15,7 +15,7 @@ export function RenderEditActionConfirmDialog({ action, open, onOpenChange, onCo
 // render-list.tsx's ToolbarActionView (each RenderEditAction is
 // independently bound by the caller, there is no shared trigger pipeline
 // to hook into like the built-in onDelete/onSubmit paths have).
-export function RenderEditActionButton({ action, iconOnly = false, hideIcon = false, compactLabel = false, Button, Dialog, onError, }) {
+export function RenderEditActionButton({ action, iconOnly = false, hideIcon = false, Button, Dialog, onError, }) {
     const [busy, setBusy] = useState(false);
     const [confirmOpen, setConfirmOpen] = useState(false);
     const trigger = async () => {
@@ -33,7 +33,7 @@ export function RenderEditActionButton({ action, iconOnly = false, hideIcon = fa
     };
     const variant = action.style ?? "secondary";
     const showIconOnly = iconOnly && action.icon !== undefined;
-    return (_jsxs(_Fragment, { children: [_jsx(Button, { type: "button", variant: variant, loading: busy, ...(action.icon !== undefined && (!hideIcon || showIconOnly) && { icon: action.icon }), ...(compactLabel && !showIconOnly && { size: "sm" }), ...(showIconOnly && {
+    return (_jsxs(_Fragment, { children: [_jsx(Button, { type: "button", variant: variant, loading: busy, ...(action.icon !== undefined && (!hideIcon || showIconOnly) && { icon: action.icon }), ...(showIconOnly && {
                     size: "icon",
                     ariaLabel: action.label,
                     title: action.label,

package/dist/components/render-edit-logic.js

@@ -1,6 +1,6 @@
 // Hides the Save button when no field is editable and no extension section
 // contributes to the composed form submit. Extensions that persist via their
-// own dispatcher writes must not opt in (fw#2359).
+// own dispatcher writes must not opt in.
 // Explicit-positive per kind (653/1), not `s.kind !== "fields"` — a future
 // third EditSectionViewModel member would otherwise default to "editable"
 // without anyone deciding that on purpose.

package/dist/components/render-edit-types.d.ts

@@ -56,7 +56,7 @@ export type RenderEditProps<TValues extends FormValues, TCtx = unknown> = {
     /** Fires when the form gains or loses unsaved input (field changes or a
      *  dirty extension section). Lets a host such as a drawer guard closing. */
     readonly onDirtyChange?: (dirty: boolean) => void;
-    /** Copy-link action (issue #912) — only set in update mode (create mode
+    /** Copy-link action — only set in update mode (create mode
      *  has no entity id yet, hence no permalink). The callback is already fully
      *  bound (URL building + clipboard happen outside, in
      *  `@cosmicdrift/kumiko-renderer/web`'s RoutedScreen — this platform-neutral
@@ -74,7 +74,7 @@ export type RenderEditProps<TValues extends FormValues, TCtx = unknown> = {
      *  header menu (drawer, card form, shell without a header slot) they fall
      *  back to buttons next to `actions`. */
     readonly menuActions?: readonly RenderEditAction[];
-    /** Opens a relatedList section row's drawer-kind action (fw#2710).
+    /** Opens a relatedList section row's drawer-kind action.
      *  RenderEdit has no `schema` to resolve the target actionForm itself —
      *  the caller (ProjectionDetailBody, which does have schema) supplies the
      *  opener and owns the actual Drawer state/rendering. Only projectionDetail
@@ -117,7 +117,7 @@ export type RenderEditProps<TValues extends FormValues, TCtx = unknown> = {
     /** Edit-mode "changed" markers also for screens without an entity id
      *  (configEdit loads its values from a query, not a record). */
     readonly markChangedFields?: boolean;
-    /** Controlled mode (issue #1887): fires on every values-snapshot change
+    /** Controlled mode: fires on every values-snapshot change
      *  (typing, `patch(...)` from outside) with the current values. `changes`
      *  is the delta against the initial values — same semantics as
      *  `payloadMode: "changes"` — so a caller never overwrites unseen fields.
@@ -134,7 +134,7 @@ export type RenderEditProps<TValues extends FormValues, TCtx = unknown> = {
      *  happens, so a caller patching dependent fields from inside `onChange`
      *  never has to guard against `controls` being undefined. */
     readonly onChange?: (state: RenderEditChangeState<TValues>) => void;
-    /** Controlled mode (issue #1887): called once after mount, hands the
+    /** Controlled mode: called once after mount, hands the
      *  caller `patch`/`validate`/`getValues` bound to this RenderEdit
      *  instance — addressable from outside without a remount. `patch` merges
      *  only the given keys (existing `controller.setValues` semantics),
@@ -153,7 +153,7 @@ export type RenderEditProps<TValues extends FormValues, TCtx = unknown> = {
      *  validation scope (the underlying `useForm` controller is mount-lived);
      *  rendering and `controls.validate()` do stay reactive to later changes. */
     readonly fields?: readonly string[];
-    /** Locked state (issue #1896): every rendered field and the submit button
+    /** Locked state: every rendered field and the submit button
      *  go visibly inactive, no write possible. For cases where input becomes
      *  moot — e.g. Solon's editor pointing at an existing record instead of
      *  creating a new one. Extension sections are out of scope: RenderEdit has
@@ -177,7 +177,7 @@ export type RenderEditProps<TValues extends FormValues, TCtx = unknown> = {
     /** "form" (default) — every field renders as its Input widget, disabled
      *  when `field.readOnly`, unchanged behavior. "text" renders a
      *  `field.readOnly` field as plain text instead of a disabled Input
-     *  (ProjectionDetailBody's read view, fw#2245) — editable fields are
+     *  (ProjectionDetailBody's read view) — editable fields are
      *  unaffected either way, so this only changes forms that already have
      *  readOnly fields. */
     readonly valueDisplay?: "form" | "text";