@cosmicdrift/kumiko-headless 0.359.0 → 0.360.0

package/dist/view-model/edit.d.ts

@@ -10,6 +10,8 @@ export type ComputeEditViewModelInput<TValues extends Readonly<Record<string, un
      *  for that verb (create hides them, update shows them read-only); omitted
      *  means no exclusion applies. */
     readonly mode?: EditFormMode;
+    /** The record being edited; omitted on create. */
+    readonly entityId?: string;
 };
 export type EditFormMode = "create" | "update";
 export declare function computeRelatedListSectionViewModel(sectionSpec: EditRelatedListSection, translate: Translate): EditRelatedListSectionViewModel;

package/dist/view-model/edit.js

@@ -220,23 +220,33 @@ function deriveReferenceMultiHints(fieldDef, declaredRefTarget) {
         ...(refMultiple !== undefined && { refMultiple }),
     };
 }
-// file/image: entityType/fieldName travel with the upload POST so the
-// endpoint validates against the right field definition.
-function deriveFileFieldHints(fieldDef, entityName, fieldName) {
-    const isFileType = fieldDef.type === "file" || fieldDef.type === "image" || fieldDef.type === "images";
-    const fileDef = isFileType
-        ? fieldDef
-        : undefined;
-    const imageVariant = fieldDef.type === "image" || fieldDef.type === "images"
-        ? Object.keys(fileDef?.variants ?? {})[0]
-        : undefined;
-    const capture = fieldDef.type === "image" ? fileDef?.capture : undefined;
+function isFileFieldType(fieldDef) {
+    return (fieldDef.type === "file" ||
+        fieldDef.type === "image" ||
+        fieldDef.type === "files" ||
+        fieldDef.type === "images");
+}
+function deriveImageHints(fieldDef, fileDef) {
+    if (fieldDef.type !== "image" && fieldDef.type !== "images")
+        return {};
+    const imageVariant = Object.keys(fileDef.variants ?? {})[0];
     return {
-        ...(fileDef?.accept !== undefined && { accept: fileDef.accept }),
-        ...(fileDef?.maxSize !== undefined && { maxSize: fileDef.maxSize }),
-        ...(isFileType && { entityType: entityName, fieldName }),
         ...(imageVariant !== undefined && { imageVariant }),
-        ...(capture !== undefined && { capture }),
+        ...(fileDef.capture !== undefined && { capture: fileDef.capture }),
+    };
+}
+function deriveFileFieldHints(fieldDef, entityName, fieldName, entityId) {
+    if (!isFileFieldType(fieldDef))
+        return {};
+    const fileDef = fieldDef;
+    return {
+        ...(fileDef.accept !== undefined && { accept: fileDef.accept }),
+        ...(fileDef.maxSize !== undefined && { maxSize: fileDef.maxSize }),
+        ...(fileDef.maxCount !== undefined && { maxCount: fileDef.maxCount }),
+        entityType: entityName,
+        fieldName,
+        ...(entityId !== undefined && { entityId }),
+        ...deriveImageHints(fieldDef, fileDef),
     };
 }
 // Embedded-LIST field (`multiple: true`) — per-cell metadata for a renderer
@@ -316,7 +326,7 @@ function buildExtensionSectionViewModel(sectionSpec, translate) {
 // section/field tree the renderer draws. FieldConditions are evaluated here
 // so the renderer never re-runs them during React render.
 export function computeEditViewModel(input) {
-    const { screen, entity, values, translate, featureName, mode } = input;
+    const { screen, entity, values, translate, featureName, mode, entityId } = input;
     const excludedFields = new Set(mode === undefined ? [] : screen.writeExcludedFields?.[mode]);
     const isHiddenByExclusion = (fieldSpec) => mode === "create" && excludedFields.has(normalizeEditField(fieldSpec).field);
     const sections = screen.layout.sections.map((sectionSpec) => {
@@ -378,7 +388,7 @@ export function computeEditViewModel(input) {
             const dateHints = deriveDateFieldHints(fieldDef);
             const numericHints = deriveNumericFieldHints(fieldDef, resolvedCurrency);
             const referenceHints = deriveReferenceFieldHints(fieldDef, normalized, declaredRefTarget, featureName);
-            const fileHints = deriveFileFieldHints(fieldDef, screen.entity, normalized.field);
+            const fileHints = deriveFileFieldHints(fieldDef, screen.entity, normalized.field, entityId);
             const embeddedListHints = deriveEmbeddedListHints(fieldDef, translate, featureName, screen.entity, normalized.field, resolvedCurrency);
             const view = {
                 field: normalized.field,

package/dist/view-model/types.d.ts

@@ -171,12 +171,17 @@ export type EditFieldViewModel = {
      *  Upload-Endpoint gegen die Field-Def. */
     readonly accept?: readonly string[];
     readonly maxSize?: string;
+    /** Only for `type: "files" | "images"` — upper bound on list length. */
+    readonly maxCount?: number;
     /** Nur bei `type: "file" | "image"` — Entity-Name + Field-Name für den
      *  Upload-POST (`/api/files`), damit der Endpoint maxSize/accept gegen
      *  die richtige Field-Def prüfen kann. */
     readonly entityType?: string;
     readonly fieldName?: string;
-    /** Only for `type: "image"` — the variant name the preview requests
+    /** Record being edited (update mode only). Sent with the upload so the
+     *  FileRef is attached to the record. */
+    readonly entityId?: string;
+    /** Only for `type: "image"` and `"images"` — 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"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-headless",
-  "version": "0.359.0",
+  "version": "0.360.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,8 +36,8 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.359.0",
-    "@cosmicdrift/kumiko-types": "0.359.0",
+    "@cosmicdrift/kumiko-framework": "0.360.0",
+    "@cosmicdrift/kumiko-types": "0.360.0",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3"
   },

package/src/changes.json

@@ -1,4 +1,10 @@
 [
+  {
+    "version": "0.360.0",
+    "type": "improvement",
+    "title": "Edit view model carries entityId and maxCount for file fields",
+    "detail": "ComputeEditViewModelInput has an optional entityId (the record being edited, omitted on create). EditFieldViewModel gains entityId for file, image, files and images fields and maxCount for files and images. The file-field hints now also cover type files, which was missing."
+  },
   {
     "version": "0.357.0",
     "type": "improvement",