@cosmicdrift/kumiko-headless 0.190.0 → 0.192.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-headless",
-  "version": "0.190.0",
+  "version": "0.192.0",
   "description": "Headless UI logic for Kumiko — Dispatcher contract, Form-Controller, View-Model, Nav-Resolver. Plattform- und React-frei; jeder Renderer (renderer, renderer-web, renderer-native, …) komponiert darauf.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -36,7 +36,7 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.190.0",
+    "@cosmicdrift/kumiko-framework": "0.192.0",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3"
   },

package/src/view-model/__tests__/edit.test.ts

@@ -549,4 +549,48 @@ describe("computeEditViewModel — embedded-list cells (#1835)", () => {
     const field = asFields(vm.sections[0]).fields[0];
     expect(field?.embeddedListCurrency).toBeUndefined();
   });
+
+  test("imageVariant is the FIRST variant declared on the field def", () => {
+    const entity = {
+      fields: {
+        avatar: {
+          type: "image",
+          variants: {
+            profile: { fit: "cover", size: { width: 512, height: 512 }, format: "webp" },
+            big: { fit: "cover", size: { width: 1024, height: 1024 }, format: "webp" },
+          },
+        },
+      },
+    } as unknown as EntityDefinition;
+
+    const vm = computeEditViewModel({
+      screen: editScreen({ sections: [{ title: "x", fields: ["avatar"] }] }),
+      entity,
+      values: {},
+      translate,
+      featureName: "orders",
+    });
+
+    const field = asFields(vm.sections[0]).fields[0];
+    expect(field?.imageVariant).toBe("profile");
+  });
+
+  test("imageVariant is undefined for an image field without variants", () => {
+    const entity = {
+      fields: {
+        avatar: { type: "image" },
+      },
+    } as unknown as EntityDefinition;
+
+    const vm = computeEditViewModel({
+      screen: editScreen({ sections: [{ title: "x", fields: ["avatar"] }] }),
+      entity,
+      values: {},
+      translate,
+      featureName: "orders",
+    });
+
+    const field = asFields(vm.sections[0]).fields[0];
+    expect(field?.imageVariant).toBeUndefined();
+  });
 });

package/src/view-model/edit.ts

@@ -170,8 +170,14 @@ export function computeEditViewModel<
       // importing it just for one fallback string.
       const resolvedCurrency = entity.defaultCurrency ?? "EUR";
       const fileDef = isFileType
-        ? (fieldDef as unknown as { accept?: readonly string[]; maxSize?: string })
+        ? (fieldDef as unknown as {
+            accept?: readonly string[];
+            maxSize?: string;
+            variants?: Readonly<Record<string, unknown>>;
+          })
         : undefined;
+      const imageVariant =
+        fieldDef.type === "image" ? Object.keys(fileDef?.variants ?? {})[0] : undefined;
       // Embedded-LIST field (`multiple: true`) — per-cell metadata for a
       // renderer to draw one row per array item (invoice-positions-style
       // table). A plain (non-list) embedded field emits none of this; the
@@ -261,6 +267,7 @@ export function computeEditViewModel<
         ...(fileDef?.accept !== undefined && { accept: fileDef.accept }),
         ...(fileDef?.maxSize !== undefined && { maxSize: fileDef.maxSize }),
         ...(isFileType && { entityType: screen.entity, fieldName: normalized.field }),
+        ...(imageVariant !== undefined && { imageVariant }),
         ...(normalized.icon !== undefined && { icon: normalized.icon }),
         ...(embeddedListCells !== undefined && { embeddedListCells }),
         ...(embeddedListDef?.minItems !== undefined && {

package/src/view-model/types.ts

@@ -181,6 +181,13 @@ export type EditFieldViewModel = {
    *  die richtige Field-Def prüfen kann. */
   readonly entityType?: string;
   readonly fieldName?: string;
+  /** Only for `type: "image"` — the variant name the preview requests
+   *  (`/api/files/:id/variant/:name`) instead of the original. The FIRST
+   *  variant declared on the field def wins; a spec may legitimately carry
+   *  neither `size` nor `maxEdge` (format-/blur-only), so "the smallest one"
+   *  is not a rule that always has an answer. Absent when the field declares
+   *  no variants — the preview then loads the original. */
+  readonly imageVariant?: string;
   /** Prefix-icon key from `EditFieldSpec.icon`, passed through unchanged
    *  (no i18n — it's a symbolic key, not a display string). The renderer
    *  resolves it against the FIELD_ICONS registry; unknown keys silently