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

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

@@ -0,0 +1,150 @@
+import type { FdoMenuV4Item, FdoMenuV4ItemImage } from "@feedmepos/entity";
+import { type AspectRatio } from "@/api/media";
+/**
+ * Product image lifecycle on top of media-service.
+ *
+ * One entry of `FdoMenuV4Item.images` maps to one media-service image, keyed by
+ * `FdoMenuV4ItemImage._id` (used verbatim as the media `imageId`, so the object key
+ * is `{businessId}/product/{itemId}/{_id}`).
+ */
+export declare const MAX_IMAGE_BYTES: number;
+/**
+ * Sentinel id for a synthetic `FdoMenuV4ItemImage` seeded from the legacy `thumbnail`
+ * field. It never reaches media-service — delete and manage are no-ops for it — so it
+ * only appears on the frontend while the item still has no real `images` array. Once the
+ * first real image is uploaded the legacy entry is purged from the emitted array.
+ */
+export declare const LEGACY_IMAGE_ID = "__legacy__";
+/** media-service reads dimensions off the bytes, which it cannot do for gif. */
+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.
+ */
+export declare function generateImageId(): string;
+/**
+ * The ratios to queue for a newly uploaded image.
+ *
+ * With the `autoGenerateImageAspectRatio` flag off, media-service is asked for the
+ * original and nothing else: no variant is generated, so `imageSet` stays empty and the
+ * Manage panel drops its ratio section. The flag is passed in rather than read here, so
+ * this module keeps out of the `stores/menu` <-> `helper/menu` import cycle.
+ */
+export declare function autoAspectRatios(autoGenerate: boolean): AspectRatio[];
+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<{
+    width: number;
+    height: number;
+}>;
+/** Lets the form wait for in-flight uploads before it saves. */
+export declare function waitForPendingThumbnailUploads(): Promise<void>;
+/**
+ * Uploads one file and returns the entity value to append to `item.images`.
+ *
+ * Bytes go browser -> object storage directly (`upload-intent` + PUT + `confirm`);
+ * the base64 `.create` route would push a 10 MiB upload through the service pods.
+ *
+ * `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.
+ *
+ * `aspectRatios` has no default: it is always derived from the
+ * `autoGenerateImageAspectRatio` flag via `autoAspectRatios`, and a default here would
+ * be a silent way to generate ratios for a business that turned them off.
+ */
+export declare function uploadProductImage(itemId: string, file: File, options: {
+    aspectRatios: AspectRatio[];
+    imageId?: string;
+}): Promise<FdoMenuV4ItemImage>;
+/**
+ * A file the merchant picked before the item it belongs to exists.
+ *
+ * media-service keys an object by its owner (`{businessId}/product/{itemId}/{imageId}`),
+ * so on create there is nowhere to put the bytes until the menu update comes back with
+ * an id. The file waits here, previewed from an object URL, and `flushStagedImages`
+ * uploads the batch once that id is known.
+ *
+ * Staging is also what makes Cancel honest: nothing reaches storage, so an abandoned
+ * form leaves no orphaned objects behind.
+ */
+export interface StagedProductImage {
+    /** Generated up front so the tile has a stable key; reused as the media `imageId`. */
+    _id: string;
+    file: File;
+    /** Object URL for the local preview — release it with `releaseStagedImages`. */
+    previewUrl: string;
+    isDefault: boolean;
+}
+export declare function stageProductImage(file: File, isDefault: boolean): StagedProductImage;
+/** Revokes the preview object URLs; call it once the staged entries are discarded. */
+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[]>;
+/**
+ * Queues generation for ratios the image does not have yet.
+ *
+ * Add-format on an existing image is `.create` with `mode: "append"` and no bytes —
+ * the service reuses the stored original's metadata and queues only the listed
+ * ratios. `confirm` cannot do this: it rejects `width`/`height` <= 0, which is all a
+ * re-confirm would have to offer.
+ *
+ * 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>;
+/** `/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.
+ *
+ * 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 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>;
+/**
+ * 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.
+ *
+ * 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 deleteAspectRatio(itemId: string, image: FdoMenuV4ItemImage, ratio: AspectRatio): Promise<FdoMenuV4ItemImage>;
+/** 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[];
+/**
+ * Mirrors the backend `resolveItemThumbnail` so the raw menu document stays usable
+ * for anything reading it directly (portal's own lists, v3 clients) — overrideMenu
+ * derives the same value, but only on its way out.
+ *
+ * The null vs `[]` distinction is load-bearing: `[]` means the merchant cleared every
+ * image and the thumbnail must go with it, while null means the item predates the
+ * multi-image model and its legacy thumbnail must be left alone.
+ */
+export declare function resolveCoverThumbnail(item: Pick<FdoMenuV4Item, "images" | "thumbnail">): string | null;

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

@@ -0,0 +1,17 @@
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    /** Ratios already on the image, so we can reject a duplicate before confirming. */
+    existingRatios: string[];
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    /** Ratios already on the image, so we can reject a duplicate before confirming. */
+    existingRatios: string[];
+}>>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

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

@@ -1,3 +1,18 @@
 import "vue-advanced-cropper/dist/style.css";
-declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    /** Ratio key the crop must produce, e.g. `16x9`. */
+    ratio: string;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    /** Ratio key the crop must produce, e.g. `16x9`. */
+    ratio: string;
+}>>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

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

@@ -0,0 +1,42 @@
+import type { 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;
+    /**
+     * 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.
+     */
+    canClearCover?: boolean | undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (open: boolean) => void;
+    "update:image": (image: FdoMenuV4ItemImage) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    modelValue: boolean;
+    itemId: string;
+    image: FdoMenuV4ItemImage | null;
+    disabled?: 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.
+     */
+    canClearCover?: boolean | undefined;
+}>>> & Readonly<{
+    "onUpdate:modelValue"?: ((open: boolean) => any) | undefined;
+    "onUpdate:image"?: ((image: FdoMenuV4ItemImage) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

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

@@ -0,0 +1,75 @@
+import type { 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;
+    /** null means the item predates multi-image; [] means every image was removed. */
+    modelValue: FdoMenuV4ItemImage[] | null | undefined;
+    /**
+     * Files held back until the item exists. Passing an array (even an empty one) is
+     * what opts a form into staging; leaving it null means the parent cannot flush, so
+     * an itemless upload is refused rather than silently dropped.
+     */
+    staged?: StagedProductImage[] | null | undefined;
+    disabled?: 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
+     * merchant can see — and replace — the existing photo. The tile never reaches
+     * media-service and is dropped from the emitted array the moment a real image lands.
+     */
+    legacyThumbnail?: string | null | undefined;
+}>, {
+    staged: null;
+    disabled: boolean;
+    legacyThumbnail: null;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (images: FdoMenuV4ItemImage[]) => void;
+    "update:staged": (staged: StagedProductImage[]) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    itemId: string;
+    /** null means the item predates multi-image; [] means every image was removed. */
+    modelValue: FdoMenuV4ItemImage[] | null | undefined;
+    /**
+     * Files held back until the item exists. Passing an array (even an empty one) is
+     * what opts a form into staging; leaving it null means the parent cannot flush, so
+     * an itemless upload is refused rather than silently dropped.
+     */
+    staged?: StagedProductImage[] | null | undefined;
+    disabled?: 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
+     * merchant can see — and replace — the existing photo. The tile never reaches
+     * media-service and is dropped from the emitted array the moment a real image lands.
+     */
+    legacyThumbnail?: string | null | undefined;
+}>, {
+    staged: null;
+    disabled: boolean;
+    legacyThumbnail: null;
+}>>> & Readonly<{
+    "onUpdate:modelValue"?: ((images: FdoMenuV4ItemImage[]) => any) | undefined;
+    "onUpdate:staged"?: ((staged: StagedProductImage[]) => any) | undefined;
+}>, {
+    disabled: boolean;
+    staged: StagedProductImage[] | null;
+    legacyThumbnail: string | null;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};

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

@@ -0,0 +1,17 @@
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    /** Display label of the ratio being regenerated, e.g. `16:9`. */
+    ratioLabel: string;
+}>>, {}, {}, {}, {}, 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;
+}>>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/apps/mf-menu/src/components/feature/TreeEditor/item/ProductDetail.vue.d.ts

@@ -1,5 +1,4 @@
-import type { FdoMenuV4Item } from "@feedmepos/entity";
-import type { ThumbnailUploadResult } from "../composable/thumbnailUpload";
+import type { FdoMenuV4Item, FdoMenuV4ItemImage } from "@feedmepos/entity";
 import type { IFdtoMenuV4ItemTracking } from "@/components/feature/TreeEditor/item/ItemForm.vue";
 interface Props {
     isOverride: boolean;
@@ -9,11 +8,9 @@ interface Props {
     fallback: FdoMenuV4Item | undefined;
 }
 declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<Props>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:form": (key: keyof FdoMenuV4Item | keyof IFdtoMenuV4ItemTracking, value: string | number | boolean | Record<string, any> | string[] | Record<string, string> | import("@feedmepos/entity").FdoDinero | Record<string, import("@feedmepos/entity").FdoDinero> | Record<string, Record<string, import("@feedmepos/entity").FdoDinero>> | import("@feedmepos/entity").FdoItemVariant | import("@feedmepos/entity").FdoMenuItemAdditionalCategory[] | import("@feedmepos/entity").FdtoV4Tax[] | import("@feedmepos/entity").FdoItemPrintSetting | import("@feedmepos/entity").FdoInventoryBinding[] | import("@feedmepos/entity").FdoMenuItemTakeawayConfig | import("@feedmepos/entity").FdoMenuItemServeDelayConfig | import("@feedmepos/entity").FdoMenuV4ItemImage[] | import("@feedmepos/entity").FdoMenuItemOrderQuantity | import("@feedmepos/entity").FdoGroupOverriderV4[] | null | undefined) => void;
-    "thumbnail-uploaded": (result: ThumbnailUploadResult) => void;
+    "update:form": (key: keyof FdoMenuV4Item | keyof IFdtoMenuV4ItemTracking, value: string | number | boolean | Record<string, any> | string[] | Record<string, string> | import("@feedmepos/entity").FdoDinero | Record<string, import("@feedmepos/entity").FdoDinero> | Record<string, Record<string, import("@feedmepos/entity").FdoDinero>> | import("@feedmepos/entity").FdoItemVariant | import("@feedmepos/entity").FdoMenuItemAdditionalCategory[] | import("@feedmepos/entity").FdtoV4Tax[] | import("@feedmepos/entity").FdoItemPrintSetting | import("@feedmepos/entity").FdoInventoryBinding[] | import("@feedmepos/entity").FdoMenuItemTakeawayConfig | import("@feedmepos/entity").FdoMenuItemServeDelayConfig | FdoMenuV4ItemImage[] | import("@feedmepos/entity").FdoMenuItemOrderQuantity | import("@feedmepos/entity").FdoGroupOverriderV4[] | null | undefined) => void;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<Props>>> & Readonly<{
-    "onThumbnail-uploaded"?: ((result: ThumbnailUploadResult) => any) | undefined;
-    "onUpdate:form"?: ((key: keyof FdoMenuV4Item | keyof IFdtoMenuV4ItemTracking, value: string | number | boolean | Record<string, any> | string[] | Record<string, string> | import("@feedmepos/entity").FdoDinero | Record<string, import("@feedmepos/entity").FdoDinero> | Record<string, Record<string, import("@feedmepos/entity").FdoDinero>> | import("@feedmepos/entity").FdoItemVariant | import("@feedmepos/entity").FdoMenuItemAdditionalCategory[] | import("@feedmepos/entity").FdtoV4Tax[] | import("@feedmepos/entity").FdoItemPrintSetting | import("@feedmepos/entity").FdoInventoryBinding[] | import("@feedmepos/entity").FdoMenuItemTakeawayConfig | import("@feedmepos/entity").FdoMenuItemServeDelayConfig | import("@feedmepos/entity").FdoMenuV4ItemImage[] | import("@feedmepos/entity").FdoMenuItemOrderQuantity | import("@feedmepos/entity").FdoGroupOverriderV4[] | null | undefined) => any) | undefined;
+    "onUpdate:form"?: ((key: keyof FdoMenuV4Item | keyof IFdtoMenuV4ItemTracking, value: string | number | boolean | Record<string, any> | string[] | Record<string, string> | import("@feedmepos/entity").FdoDinero | Record<string, import("@feedmepos/entity").FdoDinero> | Record<string, Record<string, import("@feedmepos/entity").FdoDinero>> | import("@feedmepos/entity").FdoItemVariant | import("@feedmepos/entity").FdoMenuItemAdditionalCategory[] | import("@feedmepos/entity").FdtoV4Tax[] | import("@feedmepos/entity").FdoItemPrintSetting | import("@feedmepos/entity").FdoInventoryBinding[] | import("@feedmepos/entity").FdoMenuItemTakeawayConfig | import("@feedmepos/entity").FdoMenuItemServeDelayConfig | FdoMenuV4ItemImage[] | import("@feedmepos/entity").FdoMenuItemOrderQuantity | import("@feedmepos/entity").FdoGroupOverriderV4[] | null | undefined) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 export default _default;
 type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;

package/dist/apps/mf-menu/src/components/feature/TreeEditor/store/menuV2.d.ts

@@ -96,5 +96,5 @@ interface MenuStoreType {
     $dispose: () => void;
     $reinitialize: () => void;
 }
-export declare const useMenuStore: import("pinia").StoreDefinition<"mf-menu-store-v2", Pick<MenuStoreType, "state" | "mergedMenu" | "workerIsComputing" | "mergedMenuChangeId">, Pick<MenuStoreType, "groups" | "items" | "categories" | "cookingGuide" | "serveSequence" | "rules" | "version" | "isV4" | "catalogs" | "currentCatalog" | "schedulers" | "currentScheduler" | "catalogOptions" | "subcategories" | "sortedItems" | "itemCodeMap" | "categorizedItems" | "categorizedRawMenuItems" | "variants" | "takeaways" | "printDepartments" | "units" | "recipes" | "skus" | "taxSetting" | "canUndoHistory" | "canRedoHistory">, Pick<MenuStoreType, "readMenu" | "readRestaurants" | "selectCatalog" | "selectScheduler" | "selectCategory" | "setRestaurantAttrParams" | "updateMenu" | "updateMenuSetting" | "encodeTax" | "decodeTax" | "getSelectedTax" | "mapVariant" | "$dispose" | "setMenu" | "computeMergedMenu" | "undoHistory" | "redoHistory" | "$reinitialize">>;
+export declare const useMenuStore: import("pinia").StoreDefinition<"mf-menu-store-v2", Pick<MenuStoreType, "state" | "mergedMenu" | "workerIsComputing" | "mergedMenuChangeId">, Pick<MenuStoreType, "groups" | "cookingGuide" | "serveSequence" | "items" | "rules" | "version" | "isV4" | "catalogs" | "currentCatalog" | "schedulers" | "currentScheduler" | "catalogOptions" | "categories" | "subcategories" | "sortedItems" | "itemCodeMap" | "categorizedItems" | "categorizedRawMenuItems" | "variants" | "takeaways" | "printDepartments" | "units" | "recipes" | "skus" | "taxSetting" | "canUndoHistory" | "canRedoHistory">, Pick<MenuStoreType, "readMenu" | "readRestaurants" | "selectCatalog" | "selectScheduler" | "selectCategory" | "setRestaurantAttrParams" | "updateMenu" | "updateMenuSetting" | "encodeTax" | "decodeTax" | "getSelectedTax" | "mapVariant" | "$dispose" | "setMenu" | "computeMergedMenu" | "undoHistory" | "redoHistory" | "$reinitialize">>;
 export {};

package/dist/apps/mf-menu/src/composable/remyImageTarget.d.ts

@@ -0,0 +1,5 @@
+export declare function createRemyImageTargetId(scope: string): string;
+export declare function activateRemyImageTarget(targetId: string): void;
+/** Returns true exactly once for the field that initiated the current edit. */
+export declare function consumeRemyImageTarget(targetId: string): boolean;
+export declare function clearRemyImageTarget(targetId: string): void;

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

@@ -3,6 +3,7 @@ import { type FdoItemOverriderV4, type FdoItemVariant, FdoMenuV4Category, FdoMen
 import { F_OPERATION_TYPE, type UpdateMenuModuleRequest } from "@feedmepos/menu/manager";
 import { useCoreStore } from "@feedmepos/mf-common";
 import { type UseLoadingReturn } from "~shared/composable/loading";
+import { type StagedProductImage } from "@/components/feature/TreeEditor/composable/productImages";
 import type { CheckboxOption } from "@/types/global";
 export interface PickerOption {
     label: string;
@@ -15,7 +16,19 @@ export interface PickerGroup {
 }
 export declare const useMenuLoader: (useLoading: UseLoadingReturn) => {
     updateMenu: (req: UpdateMenuModuleRequest | UpdateMenuModuleRequest[], name: string, isDelete?: boolean, performValidate?: boolean) => Promise<void>;
-    saveMenuWithThumbnail: (data: FdoMenuV4Item, operation: typeof F_OPERATION_TYPE.update | typeof F_OPERATION_TYPE.create, path: string, image?: File | null, performValidate?: boolean) => Promise<void>;
+    /**
+     * Saves the item, then attaches the images that were staged while filling the form.
+     *
+     * The upload has to come second: media-service keys an image by the item it belongs
+     * to (`{businessId}/product/{itemId}/{imageId}`), and on create that id only exists
+     * once the menu update has been applied. An item edited in place already has one, so
+     * its field uploads as it goes and nothing is left staged by the time we get here.
+     *
+     * Note what happens when nothing was staged: the second update is skipped entirely.
+     * Writing `images: []` would tell the backend the merchant cleared the gallery, and
+     * cost every legacy item its thumbnail.
+     */
+    saveMenuWithImages: (data: FdoMenuV4Item, operation: typeof F_OPERATION_TYPE.update | typeof F_OPERATION_TYPE.create, staged?: StagedProductImage[] | null, performValidate?: boolean) => Promise<void>;
     checkMenuIsLoading: () => boolean;
 };
 export declare function generateItemThumbnailUrl(path: string): string;

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

@@ -28,6 +28,7 @@ interface MenuState {
         supportedLocales: string[];
         showTakeawayAvailability: TakeawayChannels;
         showMemberPriceSettings: boolean;
+        autoGenerateImageAspectRatio: boolean;
     };
     nextSchedulerPublish: FdoPublishMenuMeta["nextSchedulePublish"];
 }

package/dist/apps/mf-menu/src/types/rule.d.ts

@@ -11,6 +11,8 @@ export type ItemRules = BaseRules & {
     category: boolean;
     description: boolean;
     thumbnail: boolean;
+    /** Whether the multi-image product gallery can be edited in the current scope. */
+    images: boolean;
     orderFrom: boolean;
     orderFromNone: boolean;
     orderFromActiveOnly: boolean;

package/dist/apps/mf-menu/src/views/Catalog/Edit/AddProductPopup/Form.vue.d.ts

@@ -1,4 +1,5 @@
 import { FdoMenuV4Item } from "@feedmepos/entity";
+import { type StagedProductImage } from "@/components/feature/TreeEditor/composable/productImages";
 interface Props {
     initialForm?: Partial<FdoMenuV4Item>;
     categoryId?: string | null;
@@ -7,10 +8,10 @@ interface Props {
 }
 declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<Props>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:show": (value: boolean) => void;
-    "submit:form": (form: FdoMenuV4Item, thumbnail?: File | null | undefined) => void;
+    "submit:form": (form: FdoMenuV4Item, staged?: StagedProductImage[] | null | undefined) => void;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<Props>>> & Readonly<{
     "onUpdate:show"?: ((value: boolean) => any) | undefined;
-    "onSubmit:form"?: ((form: FdoMenuV4Item, thumbnail?: File | null | undefined) => any) | undefined;
+    "onSubmit:form"?: ((form: FdoMenuV4Item, staged?: StagedProductImage[] | null | undefined) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>, {
     trigger?(_: {
         trigger: () => void;

package/dist/apps/mf-menu/src/views/Catalog/Edit/AddProductPopup/ProductDetail.vue.d.ts

@@ -1,4 +1,5 @@
-import type { FdoMenuV4Item } from "@feedmepos/entity";
+import type { FdoMenuV4Item, FdoMenuV4ItemImage } from "@feedmepos/entity";
+import { type StagedProductImage } from "@/components/feature/TreeEditor/composable/productImages";
 import type { IFdtoMenuV4ItemTracking } from "@/components/feature/TreeEditor/item/ItemForm.vue";
 interface Props {
     isOverride: boolean;
@@ -6,16 +7,15 @@ interface Props {
     isCreate: boolean;
     form: Partial<FdoMenuV4Item>;
     fallback: FdoMenuV4Item | undefined;
-    thumbnail: File | null | undefined;
+    /** Files picked before the item exists; the parent uploads them after save. */
+    staged: StagedProductImage[];
 }
 declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<Props>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:form": (key: keyof FdoMenuV4Item | keyof IFdtoMenuV4ItemTracking, value: string | number | boolean | Record<string, any> | string[] | Record<string, string> | import("@feedmepos/entity").FdoDinero | Record<string, import("@feedmepos/entity").FdoDinero> | Record<string, Record<string, import("@feedmepos/entity").FdoDinero>> | import("@feedmepos/entity").FdoItemVariant | import("@feedmepos/entity").FdoMenuItemAdditionalCategory[] | import("@feedmepos/entity").FdtoV4Tax[] | import("@feedmepos/entity").FdoItemPrintSetting | import("@feedmepos/entity").FdoInventoryBinding[] | import("@feedmepos/entity").FdoMenuItemTakeawayConfig | import("@feedmepos/entity").FdoMenuItemServeDelayConfig | import("@feedmepos/entity").FdoMenuV4ItemImage[] | import("@feedmepos/entity").FdoMenuItemOrderQuantity | import("@feedmepos/entity").FdoGroupOverriderV4[] | null | undefined) => void;
-    "update:thumbnail": (file: File | null) => void;
-    "reset:thumbnail": () => void;
+    "update:form": (key: keyof FdoMenuV4Item | keyof IFdtoMenuV4ItemTracking, value: string | number | boolean | Record<string, any> | string[] | Record<string, string> | import("@feedmepos/entity").FdoDinero | Record<string, import("@feedmepos/entity").FdoDinero> | Record<string, Record<string, import("@feedmepos/entity").FdoDinero>> | import("@feedmepos/entity").FdoItemVariant | import("@feedmepos/entity").FdoMenuItemAdditionalCategory[] | import("@feedmepos/entity").FdtoV4Tax[] | import("@feedmepos/entity").FdoItemPrintSetting | import("@feedmepos/entity").FdoInventoryBinding[] | import("@feedmepos/entity").FdoMenuItemTakeawayConfig | import("@feedmepos/entity").FdoMenuItemServeDelayConfig | FdoMenuV4ItemImage[] | import("@feedmepos/entity").FdoMenuItemOrderQuantity | import("@feedmepos/entity").FdoGroupOverriderV4[] | null | undefined) => void;
+    "update:staged": (staged: StagedProductImage[]) => void;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<Props>>> & Readonly<{
-    "onUpdate:form"?: ((key: keyof FdoMenuV4Item | keyof IFdtoMenuV4ItemTracking, value: string | number | boolean | Record<string, any> | string[] | Record<string, string> | import("@feedmepos/entity").FdoDinero | Record<string, import("@feedmepos/entity").FdoDinero> | Record<string, Record<string, import("@feedmepos/entity").FdoDinero>> | import("@feedmepos/entity").FdoItemVariant | import("@feedmepos/entity").FdoMenuItemAdditionalCategory[] | import("@feedmepos/entity").FdtoV4Tax[] | import("@feedmepos/entity").FdoItemPrintSetting | import("@feedmepos/entity").FdoInventoryBinding[] | import("@feedmepos/entity").FdoMenuItemTakeawayConfig | import("@feedmepos/entity").FdoMenuItemServeDelayConfig | import("@feedmepos/entity").FdoMenuV4ItemImage[] | import("@feedmepos/entity").FdoMenuItemOrderQuantity | import("@feedmepos/entity").FdoGroupOverriderV4[] | null | undefined) => any) | undefined;
-    "onUpdate:thumbnail"?: ((file: File | null) => any) | undefined;
-    "onReset:thumbnail"?: (() => any) | undefined;
+    "onUpdate:staged"?: ((staged: StagedProductImage[]) => any) | undefined;
+    "onUpdate:form"?: ((key: keyof FdoMenuV4Item | keyof IFdtoMenuV4ItemTracking, value: string | number | boolean | Record<string, any> | string[] | Record<string, string> | import("@feedmepos/entity").FdoDinero | Record<string, import("@feedmepos/entity").FdoDinero> | Record<string, Record<string, import("@feedmepos/entity").FdoDinero>> | import("@feedmepos/entity").FdoItemVariant | import("@feedmepos/entity").FdoMenuItemAdditionalCategory[] | import("@feedmepos/entity").FdtoV4Tax[] | import("@feedmepos/entity").FdoItemPrintSetting | import("@feedmepos/entity").FdoInventoryBinding[] | import("@feedmepos/entity").FdoMenuItemTakeawayConfig | import("@feedmepos/entity").FdoMenuItemServeDelayConfig | FdoMenuV4ItemImage[] | import("@feedmepos/entity").FdoMenuItemOrderQuantity | import("@feedmepos/entity").FdoGroupOverriderV4[] | null | undefined) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 export default _default;
 type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;