@cosmicdrift/kumiko-renderer 0.34.1 → 0.35.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer",
-  "version": "0.34.1",
+  "version": "0.35.0",
   "description": "Platform-agnostic React renderer for Kumiko screens. Contains the shared logic — primitives-contract, hooks, KumikoScreen, navigation & SSE abstractions — that any platform-specific renderer (web, native) composes. No DOM, no EventSource, no react-dom.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",

package/src/app/extension-sections.tsx

@@ -29,6 +29,11 @@ export function extensionSectionName(component: PlatformComponent): string | und
 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. */
+  readonly initialValues?: Readonly<Record<string, unknown>>;
 };
 
 export type ExtensionSectionComponent = ComponentType<ExtensionSectionProps>;

package/src/app/kumiko-screen.tsx

@@ -421,6 +421,15 @@ function EntityEditUpdateForm({
     return out as FormValues;
   }, [entity.fields, record]);
 
+  // Extension-Werte (z.B. customFields-jsonb) an extension-sections geben,
+  // damit sie beim Edit den Bestand zeigen statt write-only zu sein.
+  const extensionInitialValues = useMemo((): Readonly<Record<string, unknown>> | undefined => {
+    const cf = record["customFields"];
+    return cf !== null && typeof cf === "object" && !Array.isArray(cf)
+      ? (cf as Record<string, unknown>)
+      : undefined;
+  }, [record]);
+
   const writeCommand = entityWriteCommand(schema.featureName, screen.entity, "update");
   const deleteCommand = entityWriteCommand(schema.featureName, screen.entity, "delete");
   const buildPayload = useMemo(
@@ -456,6 +465,9 @@ function EntityEditUpdateForm({
       // Update-Form lässt `id` bewusst aus den Form-values, daher braucht
       // die Section die id explizit — sonst create-mode trotz Edit.
       entityId={entityId}
+      // customFields-Bestand an die extension-section, damit sie beim Edit
+      // die gespeicherten Werte zeigt (nicht write-only).
+      extensionInitialValues={extensionInitialValues}
       writeCommand={writeCommand}
       payloadMode="changes"
       buildPayload={buildPayload}
@@ -687,6 +699,7 @@ function EntityListBody({
           const targetIsEntityEdit = schema.screens.some(
             (s) => s.type === "entityEdit" && lastSegment(s.id) === action.screen,
           );
+          const actionVisible = action.visible;
           return {
             id: action.id,
             label: effectiveTranslate(action.label),
@@ -721,14 +734,15 @@ function EntityListBody({
                 nav.setSearchParams(stringified);
               }
             },
-            ...(action.visible !== undefined && {
-              isVisible: (row: ListRowViewModel) => evalFieldCondition(action.visible!, row.values),
+            ...(actionVisible !== undefined && {
+              isVisible: (row: ListRowViewModel) => evalFieldCondition(actionVisible, row.values),
             }),
           };
         }
         if (dispatcher === undefined) return null;
         if (action.kind !== "writeHandler" && action.kind !== undefined) return null;
         const writeAction = action as RowActionWriteHandler;
+        const writeActionVisible = writeAction.visible;
         return {
           id: writeAction.id,
           label: effectiveTranslate(writeAction.label),
@@ -757,8 +771,8 @@ function EntityListBody({
             }
           },
           isVisible:
-            writeAction.visible !== undefined
-              ? (row: ListRowViewModel) => evalFieldCondition(writeAction.visible!, row.values)
+            writeActionVisible !== undefined
+              ? (row: ListRowViewModel) => evalFieldCondition(writeActionVisible, row.values)
               : undefined,
         };
       })

package/src/components/render-edit.tsx

@@ -42,6 +42,10 @@ export type RenderEditProps<TValues extends FormValues, TCtx = unknown> = {
    *  die Section bliebe dann fälschlich im create-mode. Weglassen
    *  (undefined) = create-mode / kein extension-Kontext (vm.id-Fallback). */
   readonly entityId?: string | null;
+  /** Bereits gespeicherte Extension-Werte (z.B. `record.customFields`) für
+   *  extension-section-Mounts. Erlaubt der Section, den Bestand beim Edit
+   *  anzuzeigen. Nur der Update-Body liefert das. */
+  readonly extensionInitialValues?: Readonly<Record<string, unknown>>;
   /** Standard single-write Submit-Pfad. Ignoriert wenn `customSubmit`
    *  gesetzt ist (configEdit-Screens dispatchen mehrere Writes pro
    *  Submit, da macht writeCommand keinen Sinn). */
@@ -118,10 +122,12 @@ function ExtensionSectionMount({
   section,
   entityName,
   entityId,
+  initialValues,
 }: {
   readonly section: EditExtensionSectionViewModel;
   readonly entityName: string;
   readonly entityId: string | null;
+  readonly initialValues?: Readonly<Record<string, unknown>>;
 }): ReactNode {
   const { Banner, Section, Text } = usePrimitives();
   const name = extensionSectionName(section.component);
@@ -145,7 +151,7 @@ function ExtensionSectionMount({
   }
   return (
     <Section title={section.title} testId={`section-extension-${section.title}`}>
-      <Component entityName={entityName} entityId={entityId} />
+      <Component entityName={entityName} entityId={entityId} initialValues={initialValues} />
     </Section>
   );
 }
@@ -171,6 +177,7 @@ export function RenderEdit<TValues extends FormValues, TCtx = unknown>(
     submitLabel,
     fieldAppendix,
     entityId: entityIdProp,
+    extensionInitialValues,
   } = props;
   const { customSubmit } = props;
   // Translate-Fallback: wenn der Caller keine Translate-Fn übergibt,
@@ -331,6 +338,7 @@ export function RenderEdit<TValues extends FormValues, TCtx = unknown>(
               section={section}
               entityName={vm.entityName}
               entityId={entityIdProp !== undefined ? entityIdProp : vm.id}
+              initialValues={extensionInitialValues}
             />
           );
         }

package/src/components/render-list.tsx

@@ -6,6 +6,8 @@ import type {
 import type {
   ListColumnViewModel,
   ListRowViewModel,
+  ListViewModel,
+  RuntimeRenderer,
   Translate,
 } from "@cosmicdrift/kumiko-headless";
 import { computeListViewModel } from "@cosmicdrift/kumiko-headless";
@@ -185,7 +187,7 @@ export function RenderList(props: RenderListProps): ReactNode {
       return { ...prev, [field]: map };
     });
   }, []);
-  const enrichedColumns = useMemo(() => {
+  const enrichedColumns = useMemo((): readonly ListColumnViewModel[] => {
     if (referenceColumns.length === 0) return vm.columns;
     return vm.columns.map((col: ListColumnViewModel) => {
       if (col.type !== "reference") return col;
@@ -194,7 +196,10 @@ export function RenderList(props: RenderListProps): ReactNode {
       if (col.renderer !== undefined) return col;
       const map = referenceLookups[col.field];
       const labelField = col.refLabelField ?? "id";
-      const renderer = (value: unknown, row?: Readonly<Record<string, unknown>>): string => {
+      const renderer: RuntimeRenderer = (
+        value: unknown,
+        row?: Readonly<Record<string, unknown>>,
+      ): string => {
         // Tier 2.7e Server-Eagerload: wenn der Server _refs mit-
         // schickt, lesen wir den Display-Wert direkt aus der
         // resolved Row — kein Roundtrip durch die Bridge-Map nötig
@@ -221,7 +226,13 @@ export function RenderList(props: RenderListProps): ReactNode {
       return { ...col, renderer };
     });
   }, [vm.columns, referenceColumns, referenceLookups]);
-  const enrichedVm = useMemo(() => ({ ...vm, columns: enrichedColumns }), [vm, enrichedColumns]);
+  const enrichedVm = useMemo(
+    (): Omit<ListViewModel, "columns"> & { columns: readonly ListColumnViewModel[] } => ({
+      ...vm,
+      columns: enrichedColumns,
+    }),
+    [vm, enrichedColumns],
+  );
 
   // i18n-Defaults für Toolbar/Empty-State Strings — Caller kann jeden
   // einzeln per Prop überschreiben, sonst kommen die Framework-Bundles

package/src/index.ts

@@ -97,6 +97,7 @@ export type {
   InputProps,
   PrimitivesProviderProps,
   PrimitivesRegistry,
+  RuntimeRenderer,
   SectionProps,
   TextProps,
 } from "./primitives";

package/src/primitives.tsx

@@ -38,6 +38,7 @@ import type {
   FieldIssue,
   ListColumnViewModel,
   ListRowViewModel,
+  RuntimeRenderer,
 } from "@cosmicdrift/kumiko-headless";
 import {
   type ComponentType,
@@ -47,6 +48,8 @@ import {
   useContext,
 } from "react";
 
+export type { RuntimeRenderer };
+
 // ---- Prop-Types (die Primitive-Contract-Oberfläche) ----
 
 /** Standard-Button. `loading` zeigt einen Spinner statt der Children