@feedmepos/mf-menu 0.32.63-dev.1 → 0.32.63-dev.3

package/dist/{app-Deov1985.js → app-CqdVluGs.js}

@@ -1,5 +1,5 @@
 import { defineStore as r } from "pinia";
-import { E as a, G as s, H as l } from "./index.vue_vue_type_script_setup_true_lang-Nl505vPi.js";
+import { J as a, K as s, L as l } from "./index.vue_vue_type_script_setup_true_lang-qgDBinUn.js";
 const u = {
   async read() {
     return a(await s().get("/public-setting"));

package/dist/app.js

@@ -1,4 +1,4 @@
-import { F as e, i as r, j as o, o as t, r as i, u as p } from "./app-4yWs09Fr.js";
+import { F as e, i as r, j as o, o as t, r as i, u as p } from "./app-BcGgfvbE.js";
 export {
   e as FmApp,
   r as i18nMessages,

package/dist/apps/mf-menu/src/api/media.d.ts

@@ -113,10 +113,11 @@ export declare const mediaService: {
      * Which of the two modes runs is decided by the field that is filled:
      * - `base64` overwrites the variant with the merchant's own bytes, synchronously
      * - `instruction` queues an AI re-edit, so the ratio drops back to `pending`
+     *   (with `regenerateFromOrigin`, it re-derives from the original instead of the
+     *   current variant, discarding previous variant edits)
      *
-     * Sending neither is how the panel asks for a plain "generate this again". The
-     * integration guide only spells out the two named modes, so a 400 here means the
-     * service declined an instruction-less regenerate, not that the caller is malformed.
+     * Callers must send exactly one of `base64` or `instruction`; the service rejects an
+     * update request that contains neither with `400 INVALID_PARAM`.
      *
      * Unlike an upload these bytes do pass through the service pod — there is no
      * variant-level `upload-intent` — so callers must send a cropped, re-encoded image
@@ -131,6 +132,12 @@ export declare const mediaService: {
         aspectRatio: AspectRatio;
         base64?: string;
         instruction?: string;
+        /**
+         * Instruction-mode modifier: re-derive from the original instead of the current
+         * variant. Sent only when true — the service reads the mode off which key is
+         * present, and an omitted flag is the same as `false`.
+         */
+        regenerateFromOrigin?: boolean;
     }): Promise<void>;
     listImages(refIds: string[]): Promise<MediaImage[]>;
     getGenerationTask(taskId: string): Promise<GenerationTask>;

package/dist/apps/mf-menu/src/app.d.ts

@@ -977,6 +977,7 @@ export declare const i18nMessages: {
                                 label: string;
                                 placeholder: string;
                                 duplicate_warning: string;
+                                duplicate_hint: string;
                             };
                             name: {
                                 label: string;
@@ -1981,6 +1982,10 @@ export declare const i18nMessages: {
                     original: string;
                     custom_sizing: string;
                     custom_image_hint: string;
+                    remove_ratio: {
+                        title: string;
+                        message: string;
+                    };
                     required: string;
                     cover_photo: string;
                     set_as_cover: string;
@@ -1988,7 +1993,6 @@ export declare const i18nMessages: {
                 };
                 purpose: {
                     menu_grid: string;
-                    kiosk_grid: string;
                 };
                 status: {
                     pending: string;
@@ -2012,6 +2016,9 @@ export declare const i18nMessages: {
                     title: string;
                     message: string;
                 };
+                preview: {
+                    title: string;
+                };
                 replace: {
                     title: string;
                     action: string;
@@ -2026,8 +2033,11 @@ export declare const i18nMessages: {
                     action: string;
                     hint: string;
                     instruction: string;
-                    instruction_required: string;
                     instruction_placeholder: string;
+                    base: string;
+                    base_current: string;
+                    base_original: string;
+                    base_original_sublabel: string;
                     queued: string;
                 };
             };
@@ -3004,6 +3014,7 @@ export declare const i18nMessages: {
                                 label: string;
                                 placeholder: string;
                                 duplicate_warning: string;
+                                duplicate_hint: string;
                             };
                             name: {
                                 label: string;
@@ -4006,6 +4017,10 @@ export declare const i18nMessages: {
                     original: string;
                     custom_sizing: string;
                     custom_image_hint: string;
+                    remove_ratio: {
+                        title: string;
+                        message: string;
+                    };
                     required: string;
                     cover_photo: string;
                     set_as_cover: string;
@@ -4013,7 +4028,6 @@ export declare const i18nMessages: {
                 };
                 purpose: {
                     menu_grid: string;
-                    kiosk_grid: string;
                 };
                 status: {
                     pending: string;
@@ -4037,6 +4051,9 @@ export declare const i18nMessages: {
                     title: string;
                     message: string;
                 };
+                preview: {
+                    title: string;
+                };
                 replace: {
                     title: string;
                     action: string;
@@ -4051,8 +4068,11 @@ export declare const i18nMessages: {
                     action: string;
                     hint: string;
                     instruction: string;
-                    instruction_required: string;
                     instruction_placeholder: string;
+                    base: string;
+                    base_current: string;
+                    base_original: string;
+                    base_original_sublabel: string;
                     queued: string;
                 };
             };
@@ -5029,6 +5049,7 @@ export declare const i18nMessages: {
                                 label: string;
                                 placeholder: string;
                                 duplicate_warning: string;
+                                duplicate_hint: string;
                             };
                             name: {
                                 label: string;
@@ -6032,6 +6053,10 @@ export declare const i18nMessages: {
                     original: string;
                     custom_sizing: string;
                     custom_image_hint: string;
+                    remove_ratio: {
+                        title: string;
+                        message: string;
+                    };
                     required: string;
                     cover_photo: string;
                     set_as_cover: string;
@@ -6039,7 +6064,6 @@ export declare const i18nMessages: {
                 };
                 purpose: {
                     menu_grid: string;
-                    kiosk_grid: string;
                 };
                 status: {
                     pending: string;
@@ -6063,6 +6087,9 @@ export declare const i18nMessages: {
                     title: string;
                     message: string;
                 };
+                preview: {
+                    title: string;
+                };
                 replace: {
                     title: string;
                     action: string;
@@ -6077,8 +6104,11 @@ export declare const i18nMessages: {
                     action: string;
                     hint: string;
                     instruction: string;
-                    instruction_required: string;
                     instruction_placeholder: string;
+                    base: string;
+                    base_current: string;
+                    base_original: string;
+                    base_original_sublabel: string;
                     queued: string;
                 };
             };
@@ -7055,6 +7085,7 @@ export declare const i18nMessages: {
                                 label: string;
                                 placeholder: string;
                                 duplicate_warning: string;
+                                duplicate_hint: string;
                             };
                             name: {
                                 label: string;
@@ -8057,6 +8088,10 @@ export declare const i18nMessages: {
                     original: string;
                     custom_sizing: string;
                     custom_image_hint: string;
+                    remove_ratio: {
+                        title: string;
+                        message: string;
+                    };
                     required: string;
                     cover_photo: string;
                     set_as_cover: string;
@@ -8064,7 +8099,6 @@ export declare const i18nMessages: {
                 };
                 purpose: {
                     menu_grid: string;
-                    kiosk_grid: string;
                 };
                 status: {
                     pending: string;
@@ -8088,6 +8122,9 @@ export declare const i18nMessages: {
                     title: string;
                     message: string;
                 };
+                preview: {
+                    title: string;
+                };
                 replace: {
                     title: string;
                     action: string;
@@ -8102,8 +8139,11 @@ export declare const i18nMessages: {
                     action: string;
                     hint: string;
                     instruction: string;
-                    instruction_required: string;
                     instruction_placeholder: string;
+                    base: string;
+                    base_current: string;
+                    base_original: string;
+                    base_original_sublabel: string;
                     queued: string;
                 };
             };
@@ -9080,6 +9120,7 @@ export declare const i18nMessages: {
                                 label: string;
                                 placeholder: string;
                                 duplicate_warning: string;
+                                duplicate_hint: string;
                             };
                             name: {
                                 label: string;
@@ -10071,6 +10112,10 @@ export declare const i18nMessages: {
                     original: string;
                     custom_sizing: string;
                     custom_image_hint: string;
+                    remove_ratio: {
+                        title: string;
+                        message: string;
+                    };
                     required: string;
                     cover_photo: string;
                     set_as_cover: string;
@@ -10078,7 +10123,6 @@ export declare const i18nMessages: {
                 };
                 purpose: {
                     menu_grid: string;
-                    kiosk_grid: string;
                 };
                 status: {
                     pending: string;
@@ -10102,6 +10146,9 @@ export declare const i18nMessages: {
                     title: string;
                     message: string;
                 };
+                preview: {
+                    title: string;
+                };
                 replace: {
                     title: string;
                     action: string;
@@ -10116,8 +10163,11 @@ export declare const i18nMessages: {
                     action: string;
                     hint: string;
                     instruction: string;
-                    instruction_required: string;
                     instruction_placeholder: string;
+                    base: string;
+                    base_current: string;
+                    base_original: string;
+                    base_original_sublabel: string;
                     queued: string;
                 };
             };

package/dist/apps/mf-menu/src/components/feature/TreeEditor/composable/productImages.d.ts

@@ -21,11 +21,13 @@ export declare const ACCEPTED_IMAGE_TYPES: string[];
  * `{timestamp}_{4 random chars}`, e.g. `2026_07_27T06_54_00_000Z_argb`.
  *
  * The entity documents this as a raw ISO datetime, but the separators are flattened to
- * underscores the same way menu doc ids are (`item_2026_05_12T07_11_30_037Z_1c4gzj…`).
- * This id is used verbatim as the media object key segment and shows up in the image
- * URL path, and `:` there has to be percent-encoded to be safe — every id that already
- * travels in a path in this system avoids it. Only the image id is built this way; the
- * item id it is nested under is whatever the menu service issued.
+ * underscores because the id is used verbatim as a media object-key segment and shows
+ * up in the image URL path, where a `:` would have to be percent-encoded. Flattening is
+ * a choice for the image id only — menu doc ids keep their ISO colons and dashes
+ * (`item_2026-08-08T03:00:00.000Z_abc123`, minted by the menu engine's generateDocId),
+ * and the item id reaches media-service as a refId with its colons stripped separately
+ * by `normalizeMediaRefId`. The item id this id is nested under is whatever the menu
+ * service issued.
  */
 export declare function generateImageId(): string;
 /**
@@ -41,12 +43,12 @@ export declare function validateImageFile(file: File): string | null;
 /** Converts Remy's base64 result into an uploadable file without re-encoding it. */
 export declare function dataUrlToFile(dataUrl: string, fileName?: string): Promise<File>;
 /** `confirm` needs the real pixel size, and only the browser has it before upload. */
-export declare function readImageDimensions(file: File): Promise<{
+export declare function readImageDimensions(file: File, unreadableMessage?: string): Promise<{
     width: number;
     height: number;
 }>;
 /** Lets the form wait for in-flight uploads before it saves. */
-export declare function waitForPendingThumbnailUploads(): Promise<void>;
+export declare function waitForPendingImageUploads(): Promise<void>;
 /**
  * Uploads one file and returns the entity value to append to `item.images`.
  *
@@ -55,8 +57,8 @@ export declare function waitForPendingThumbnailUploads(): Promise<void>;
  *
  * `imageSet` values are left null on purpose: the ratio images media-service
  * generates are reachable at `{url}?aspect_ratio={ratio}`, so there is nothing to
- * store. A value is only ever written when a merchant substitutes a different photo
- * for one ratio — the "replace image" flow, which is not built yet.
+ * store. A value is written only when a merchant substitutes their own photo for one
+ * ratio — `replaceAspectRatioImage` stamps the variant URL as the custom marker.
  *
  * `aspectRatios` has no default: it is always derived from the
  * `autoGenerateImageAspectRatio` flag via `autoAspectRatios`, and a default here would
@@ -65,6 +67,7 @@ export declare function waitForPendingThumbnailUploads(): Promise<void>;
 export declare function uploadProductImage(itemId: string, file: File, options: {
     aspectRatios: AspectRatio[];
     imageId?: string;
+    unreadableMessage?: string;
 }): Promise<FdoMenuV4ItemImage>;
 /**
  * A file the merchant picked before the item it belongs to exists.
@@ -92,7 +95,7 @@ export declare function releaseStagedImages(staged: StagedProductImage[]): void;
  * Uploads every staged file against the now-known item id, in the order they were
  * picked so the gallery matches what the merchant saw while filling the form.
  */
-export declare function flushStagedImages(itemId: string, staged: StagedProductImage[], aspectRatios: AspectRatio[]): Promise<FdoMenuV4ItemImage[]>;
+export declare function flushStagedImages(itemId: string, staged: StagedProductImage[], aspectRatios: AspectRatio[], unreadableMessage?: string): Promise<FdoMenuV4ItemImage[]>;
 /**
  * Queues generation for ratios the image does not have yet.
  *
@@ -104,40 +107,83 @@ export declare function flushStagedImages(itemId: string, staged: StagedProductI
  * Note the failure shape differs from `confirm`: a single ratio that fails to queue
  * (e.g. `409 TASK_IN_PROGRESS` for a ratio already generating) fails the whole call.
  */
-export declare function generateAspectRatios(itemId: string, image: FdoMenuV4ItemImage, aspectRatios: AspectRatio[]): Promise<FdoMenuV4ItemImage>;
+export declare function generateAspectRatios(itemId: string, image: FdoMenuV4ItemImage, aspectRatios: AspectRatio[], options?: {
+    includeExisting?: boolean;
+}): Promise<FdoMenuV4ItemImage>;
 /** `/images/update` carries its bytes inline, so the file has to become a data URL. */
 export declare function readFileAsDataUrl(file: File): Promise<string>;
 /**
- * Substitutes the merchant's own photo for one generated ratio.
+ * Substitutes the merchant's own photo for one generated ratio and marks it custom.
+ *
+ * The variant keeps its URL and only the bytes behind it are rewritten, so the only
+ * difference between the input image and the returned one is `imageSet[ratio]`: it
+ * now carries the variant URL as a marker meaning "not derived from the original".
+ * That URL is the same `{url}?aspect_ratio={ratio}` the consumer would compose
+ * anyway — the value exists to be checked for null, not to point somewhere else. The
+ * caller persists the returned image to save the marker.
  *
- * Nothing about the entity changes: the variant keeps its URL and only the bytes
- * behind it are rewritten, so `imageSet` is untouched and the caller has nothing new
- * to save. What the caller does have to do is bust its own image cache — the URL is
- * "always latest" at the edge, but a browser that already fetched it will not know.
+ * The caller also has to bust its own image cache — the URL is "always latest" at the
+ * edge, but a browser that already fetched it will not know.
  *
  * The file is expected to be cropped to `ratio` and re-encoded by the dialog: these
  * bytes travel through the service pod (no variant-level upload-intent exists), and a
  * variant is supposed to be exactly its ratio.
  */
-export declare function replaceAspectRatioImage(itemId: string, image: FdoMenuV4ItemImage, ratio: AspectRatio, file: File): Promise<void>;
+export declare function replaceAspectRatioImage(itemId: string, image: FdoMenuV4ItemImage, ratio: AspectRatio, file: File): Promise<FdoMenuV4ItemImage>;
+/**
+ * Fallback instruction sent when the merchant regenerates without typing anything.
+ *
+ * `/images/update` takes exactly one of `base64` or `instruction`, and sending neither
+ * is rejected with 400 INVALID_PARAM — there is no "just roll the dice again" mode, so
+ * an empty box has to resolve to a real instruction rather than being omitted.
+ */
+export declare const DEFAULT_REGENERATE_INSTRUCTION = "regenerate";
 /**
  * Asks for one ratio to be generated again, saying what to change.
  *
- * The instruction is required, not a nicety: `/images/update` takes exactly one of
- * `base64` or `instruction`, and sending neither is rejected with 400 INVALID_PARAM —
- * there is no "just roll the dice again" mode to fall back to.
+ * The instruction is optional: an empty one falls back to
+ * `DEFAULT_REGENERATE_INSTRUCTION` so the merchant can redo the ratio without typing
+ * anything.
+ *
+ * With `regenerateFromOrigin`, the ratio is re-derived from the original instead of
+ * the current variant, discarding previous variant edits. Per product rule this must
+ * only be used while `imageSet[ratio]` is null — a ratio holding a custom URL must
+ * never be re-derived from the original, or the merchant's own photo is silently
+ * thrown away.
  *
  * Queued, not immediate: the ratio goes back to `pending` for ~40s and its URL keeps
  * serving the old image until the new one lands, so there is nothing to roll back.
  */
-export declare function regenerateAspectRatio(itemId: string, image: FdoMenuV4ItemImage, ratio: AspectRatio, instruction: string): Promise<void>;
+export declare function regenerateAspectRatio(itemId: string, image: FdoMenuV4ItemImage, ratio: AspectRatio, instruction: string, regenerateFromOrigin?: boolean): Promise<void>;
 export declare function deleteAspectRatio(itemId: string, image: FdoMenuV4ItemImage, ratio: AspectRatio): Promise<FdoMenuV4ItemImage>;
+export interface ProductImageReference {
+    itemId: string;
+    imageId: string;
+}
+/** Deletes individual originals after their menu references have been saved. */
+export declare function deleteProductImages(images: ProductImageReference[]): Promise<void>;
 /** Deletes the whole image, original included (`aspectRatios: null`). */
 export declare function deleteProductImage(itemId: string, imageId: string): Promise<void>;
 /** Deletes every image an item owns; used when the product itself is removed. */
 export declare function deleteAllProductImages(itemIds: string[]): Promise<void>;
 /** Enforces the single-cover rule: setting one clears the flag on every other image. */
 export declare function setCoverImage(images: FdoMenuV4ItemImage[], imageId: string, isCover: boolean): FdoMenuV4ItemImage[];
+/**
+ * Finds original images that disappeared from the menu document.
+ *
+ * Media deletion must run only after the corresponding menu write succeeds. This keeps
+ * Cancel/Discard safe: the draft can omit an image without making the saved document
+ * point at a deleted original.
+ */
+export declare function getRemovedProductImages(previousItems: FdoMenuV4Item[], nextItems: FdoMenuV4Item[]): ProductImageReference[];
+/**
+ * Finds originals that exist only in an unsaved draft.
+ *
+ * Reversing `getRemovedProductImages` is intentional: the draft is treated as the
+ * previous state and the persisted document as the next state. These are the objects
+ * that must be discarded when a form is cancelled.
+ */
+export declare function getAddedProductImages(draftItems: FdoMenuV4Item[], persistedItems: FdoMenuV4Item[]): ProductImageReference[];
 /**
  * Mirrors the backend `resolveItemThumbnail` so the raw menu document stays usable
  * for anything reading it directly (portal's own lists, v3 clients) — overrideMenu

package/dist/apps/mf-menu/src/components/feature/TreeEditor/image/ManageImageDrawer.vue.d.ts

@@ -1,16 +1,31 @@
-import type { FdoMenuV4ItemImage } from "@feedmepos/entity";
+import type { FdoMenuV4Item, FdoMenuV4ItemImage } from "@feedmepos/entity";
 declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
     modelValue: boolean;
     itemId: string;
     image: FdoMenuV4ItemImage | null;
     disabled?: boolean | undefined;
+    /**
+     * Catalog override mode: the panel stays fully visible — ratio rows and their large
+     * previews are readable — but every media-service action (generate all, add format,
+     * replace, regenerate, remove) is disabled. Only the cover toggle and Update work.
+     */
+    coverOnly?: boolean | undefined;
     /**
      * Whether turning the cover off is allowed. False when this is the only image, so the
      * gallery can never be left without a cover to resolve a thumbnail from. The parent
      * also promotes a survivor when a multi-image cover is cleared, so this only guards
-     * the no-candidate case.
+     * the no-candidate case. Ignored in `coverOnly` mode, where clearing the override
+     * cover always means falling back to the base gallery's cover — the inherited gallery
+     * belongs to the base item, which keeps its own cover invariant.
      */
     canClearCover?: boolean | undefined;
+    /**
+     * The module's items, so the panel can show the union of custom aspect ratios across
+     * every product image. Add-format is menu-wide: a ratio added anywhere appears on
+     * every image's panel, even before that image has generated it. Comes from whichever
+     * store the host context edits (global `menuStore` or TreeEditor's `menuV2`).
+     */
+    menuItems?: FdoMenuV4Item[] | undefined;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (open: boolean) => void;
     "update:image": (image: FdoMenuV4ItemImage) => void;
@@ -19,13 +34,28 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     itemId: string;
     image: FdoMenuV4ItemImage | null;
     disabled?: boolean | undefined;
+    /**
+     * Catalog override mode: the panel stays fully visible — ratio rows and their large
+     * previews are readable — but every media-service action (generate all, add format,
+     * replace, regenerate, remove) is disabled. Only the cover toggle and Update work.
+     */
+    coverOnly?: boolean | undefined;
     /**
      * Whether turning the cover off is allowed. False when this is the only image, so the
      * gallery can never be left without a cover to resolve a thumbnail from. The parent
      * also promotes a survivor when a multi-image cover is cleared, so this only guards
-     * the no-candidate case.
+     * the no-candidate case. Ignored in `coverOnly` mode, where clearing the override
+     * cover always means falling back to the base gallery's cover — the inherited gallery
+     * belongs to the base item, which keeps its own cover invariant.
      */
     canClearCover?: boolean | undefined;
+    /**
+     * The module's items, so the panel can show the union of custom aspect ratios across
+     * every product image. Add-format is menu-wide: a ratio added anywhere appears on
+     * every image's panel, even before that image has generated it. Comes from whichever
+     * store the host context edits (global `menuStore` or TreeEditor's `menuV2`).
+     */
+    menuItems?: FdoMenuV4Item[] | undefined;
 }>>> & Readonly<{
     "onUpdate:modelValue"?: ((open: boolean) => any) | undefined;
     "onUpdate:image"?: ((image: FdoMenuV4ItemImage) => any) | undefined;

package/dist/apps/mf-menu/src/components/feature/TreeEditor/image/ProductImageField.vue.d.ts

@@ -1,4 +1,4 @@
-import type { FdoMenuV4ItemImage } from "@feedmepos/entity";
+import type { FdoMenuV4Item, FdoMenuV4ItemImage } from "@feedmepos/entity";
 import { type StagedProductImage } from "@/components/feature/TreeEditor/composable/productImages";
 declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
     itemId: string;
@@ -11,6 +11,12 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
      */
     staged?: StagedProductImage[] | null | undefined;
     disabled?: boolean | undefined;
+    /**
+     * Catalog override mode: clicking an image opens the Manage panel like Main Catalog,
+     * but the panel's media-service actions are disabled — only the cover toggle is
+     * editable. Clearing the override cover falls back to the base gallery's cover.
+     */
+    coverOnly?: boolean | undefined;
     /**
      * Legacy single-image URL from the `thumbnail` field. When set and modelValue is
      * null (the item predates multi-image), a synthetic read-only tile is shown so the
@@ -18,10 +24,18 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
      * media-service and is dropped from the emitted array the moment a real image lands.
      */
     legacyThumbnail?: string | null | undefined;
+    /**
+     * The module's items, forwarded to the Manage panel so it shows the union of custom
+     * aspect ratios across every product image. Sourced from whichever store the host
+     * context edits (global `menuStore` or TreeEditor's `menuV2`).
+     */
+    menuItems?: FdoMenuV4Item[] | undefined;
 }>, {
     staged: null;
     disabled: boolean;
+    coverOnly: boolean;
     legacyThumbnail: null;
+    menuItems: () => never[];
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (images: FdoMenuV4ItemImage[]) => void;
     "update:staged": (staged: StagedProductImage[]) => void;
@@ -36,6 +50,12 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
      */
     staged?: StagedProductImage[] | null | undefined;
     disabled?: boolean | undefined;
+    /**
+     * Catalog override mode: clicking an image opens the Manage panel like Main Catalog,
+     * but the panel's media-service actions are disabled — only the cover toggle is
+     * editable. Clearing the override cover falls back to the base gallery's cover.
+     */
+    coverOnly?: boolean | undefined;
     /**
      * Legacy single-image URL from the `thumbnail` field. When set and modelValue is
      * null (the item predates multi-image), a synthetic read-only tile is shown so the
@@ -43,15 +63,25 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
      * media-service and is dropped from the emitted array the moment a real image lands.
      */
     legacyThumbnail?: string | null | undefined;
+    /**
+     * The module's items, forwarded to the Manage panel so it shows the union of custom
+     * aspect ratios across every product image. Sourced from whichever store the host
+     * context edits (global `menuStore` or TreeEditor's `menuV2`).
+     */
+    menuItems?: FdoMenuV4Item[] | undefined;
 }>, {
     staged: null;
     disabled: boolean;
+    coverOnly: boolean;
     legacyThumbnail: null;
+    menuItems: () => never[];
 }>>> & Readonly<{
     "onUpdate:modelValue"?: ((images: FdoMenuV4ItemImage[]) => any) | undefined;
     "onUpdate:staged"?: ((staged: StagedProductImage[]) => any) | undefined;
 }>, {
     disabled: boolean;
+    coverOnly: boolean;
+    menuItems: FdoMenuV4Item[];
     staged: StagedProductImage[] | null;
     legacyThumbnail: string | null;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/apps/mf-menu/src/components/feature/TreeEditor/image/RegenerateImageDialog.vue.d.ts

@@ -1,9 +1,19 @@
 declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
     /** Display label of the ratio being regenerated, e.g. `16:9`. */
     ratioLabel: string;
+    /**
+     * Whether "regenerate from the original" is offered. True only while
+     * `imageSet[ratio]` is null (the ratio is AI-derived), never for a custom image.
+     */
+    canRegenerateFromOrigin: boolean;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
     /** Display label of the ratio being regenerated, e.g. `16:9`. */
     ratioLabel: string;
+    /**
+     * Whether "regenerate from the original" is offered. True only while
+     * `imageSet[ratio]` is null (the ratio is AI-derived), never for a custom image.
+     */
+    canRegenerateFromOrigin: boolean;
 }>>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 export default _default;
 type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;

package/dist/apps/mf-menu/src/helper/menuImport.d.ts

@@ -3,6 +3,28 @@ import { FdoCustomAttribute, FdoDinero } from "@feedmepos/core/entity";
 import { FdoMenuV4, FdoMenuV4Item, FdoMenuV4VariantGroup, FdoItemOverriderV4, FdoMenuV4Catalog, FdoItemVariant } from "@feedmepos/entity";
 import { type ExportAddonGroupRow, type ExportMenuDataRow, type GroupedAddon, type GroupedItem, type itemsLinkWithGroup } from "@/helper/import-export-utils";
 import type { GroupItem } from "@/manager/menu/group";
+export declare const fileMap: {
+    _id: string;
+    code: string;
+    name: string;
+    name2: string;
+    description: string;
+    variantKey: string;
+    variantName: string;
+    category: string;
+    subCategories: string;
+    orderFrom: string;
+    perXUnit: string;
+    unit: string;
+    openPrice: string;
+    price: string;
+    trackingCost: string;
+    minPrice: string;
+    groupByParent: string;
+    takeawayName: string;
+    takeawayPrice: string;
+    index: string;
+};
 export declare function normalizeCatalogOverrideAdditionalCategories(item: Pick<FdoMenuV4Item, "category" | "additionalCategories">, itemOverride: Pick<FdoItemOverriderV4, "additionalCategories"> | undefined, categoryId: FdoMenuV4Item["category"]): FdoItemOverriderV4["additionalCategories"];
 export declare class MenuImport {
     menu: FdoMenuV4;

package/dist/apps/mf-menu/src/manager/menu/itemOverrider.d.ts

@@ -0,0 +1,17 @@
+import type { FdoItemOverriderV4, FdoMenuV4Item } from "@feedmepos/entity";
+export type FdoMenuV4ItemWithCoverImage = FdoMenuV4Item & {
+    /** Catalog/scheduler override field: the selected entry in `images`. */
+    image?: string | null;
+};
+/**
+ * Serializes a menu item into the override-document schema.
+ *
+ * Catalog overrides store the selected gallery entry id in the singular `image` field.
+ * The full gallery belongs to the base item and must not be copied into an override
+ * document: the overrider schema carries only a singular `image`, not the multi-image
+ * array, so sending `images` through the `as` cast would be silently stripped
+ * server-side and pinned stale in the override doc — the same trap the shelfLife
+ * fields fell into. `thumbnail` is dropped here too; overrideMenu derives the same
+ * value on its way out.
+ */
+export declare function itemToOverrider(item: Partial<FdoMenuV4ItemWithCoverImage>): FdoItemOverriderV4[];