@webiny/website-builder-sdk 0.0.0-unstable.e6f0dc8ca7 → 0.0.0-unstable.eb81deee7e

package/asset/normalize.js

@@ -0,0 +1,106 @@
+function getAssetCategory(mimeType) {
+    if ("string" == typeof mimeType) {
+        if (mimeType.startsWith("image/")) return "image";
+        if (mimeType.startsWith("video/")) return "video";
+    }
+    return "document";
+}
+const isObject = (value)=>"object" == typeof value && null !== value;
+const asNumber = (value)=>"number" != typeof value || Number.isNaN(value) ? void 0 : value;
+const asString = (value)=>"string" == typeof value ? value : void 0;
+function assetImageFromLegacyEdit(edit, dimensions) {
+    const image = {};
+    const width = asNumber(dimensions?.width);
+    const height = asNumber(dimensions?.height);
+    if (void 0 !== width) image.width = width;
+    if (void 0 !== height) image.height = height;
+    if (edit?.crop) image.crop = {
+        top: edit.crop.top ?? 0,
+        left: edit.crop.left ?? 0,
+        bottom: edit.crop.bottom ?? 0,
+        right: edit.crop.right ?? 0
+    };
+    if (edit?.hotspot) image.focalPoint = {
+        x: edit.hotspot.x,
+        y: edit.hotspot.y
+    };
+    if (edit?.alt) image.alt = edit.alt;
+    if (edit?.caption) image.caption = edit.caption;
+    return Object.keys(image).length > 0 ? image : void 0;
+}
+const normalizeAssetImage = (raw)=>{
+    if (!isObject(raw)) return;
+    const image = {};
+    const width = asNumber(raw.width);
+    const height = asNumber(raw.height);
+    if (void 0 !== width) image.width = width;
+    if (void 0 !== height) image.height = height;
+    if (isObject(raw.crop)) image.crop = {
+        top: asNumber(raw.crop.top) ?? 0,
+        left: asNumber(raw.crop.left) ?? 0,
+        bottom: asNumber(raw.crop.bottom) ?? 0,
+        right: asNumber(raw.crop.right) ?? 0
+    };
+    if (isObject(raw.focalPoint)) {
+        const x = asNumber(raw.focalPoint.x);
+        const y = asNumber(raw.focalPoint.y);
+        if (void 0 !== x && void 0 !== y) image.focalPoint = {
+            x,
+            y
+        };
+    }
+    const alt = asString(raw.alt);
+    if (alt) image.alt = alt;
+    const caption = asString(raw.caption);
+    if (caption) image.caption = caption;
+    return Object.keys(image).length > 0 ? image : void 0;
+};
+const buildBase = (raw, mimeType)=>{
+    const src = asString(raw.src) ?? "";
+    return {
+        id: asString(raw.id) ?? "",
+        src,
+        url: asString(raw.url) ?? src,
+        name: asString(raw.name) ?? "",
+        mimeType,
+        size: asNumber(raw.size) ?? 0
+    };
+};
+const syncImageDimensions = (asset)=>{
+    if (!asset.image) return asset;
+    if (void 0 !== asset.image.width) asset.width = asset.image.width;
+    if (void 0 !== asset.image.height) asset.height = asset.image.height;
+    return asset;
+};
+function normalizeToAsset(input) {
+    if (!isObject(input)) return null;
+    const hasTypedSubObject = isObject(input.image) || isObject(input.document) || isObject(input.video);
+    const mimeType = asString(input.mimeType) ?? "";
+    const asset = buildBase(input, mimeType);
+    const category = getAssetCategory(mimeType);
+    if (!hasTypedSubObject) {
+        if ("image" === category) {
+            const image = assetImageFromLegacyEdit(input.edit, {
+                width: asNumber(input.width),
+                height: asNumber(input.height)
+            });
+            if (image) asset.image = image;
+        }
+        return syncImageDimensions(asset);
+    }
+    if ("image" === category) {
+        const image = normalizeAssetImage(input.image);
+        if (image) asset.image = image;
+    } else if ("video" === category) {
+        if (isObject(input.video)) asset.video = {
+            autoplay: "boolean" == typeof input.video.autoplay ? input.video.autoplay : void 0,
+            poster: asString(input.video.poster)
+        };
+    } else if (isObject(input.document)) asset.document = {
+        pages: asNumber(input.document.pages)
+    };
+    return syncImageDimensions(asset);
+}
+export { assetImageFromLegacyEdit, getAssetCategory, normalizeToAsset };
+
+//# sourceMappingURL=normalize.js.map

package/asset/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset/normalize.js","sources":["../../src/asset/normalize.ts"],"sourcesContent":["import type { Asset, AssetCategory, AssetImage } from \"./types.js\";\n\nexport function getAssetCategory(mimeType?: string | null): AssetCategory {\n    if (typeof mimeType === \"string\") {\n        if (mimeType.startsWith(\"image/\")) {\n            return \"image\";\n        }\n        if (mimeType.startsWith(\"video/\")) {\n            return \"video\";\n        }\n    }\n    return \"document\";\n}\n\nconst isObject = (value: unknown): value is Record<string, unknown> => {\n    return typeof value === \"object\" && value !== null;\n};\n\nconst asNumber = (value: unknown): number | undefined => {\n    return typeof value === \"number\" && !Number.isNaN(value) ? value : undefined;\n};\n\nconst asString = (value: unknown): string | undefined => {\n    return typeof value === \"string\" ? value : undefined;\n};\n\ninterface LegacyImageEdit {\n    crop?: { top: number; left: number; bottom: number; right: number };\n    hotspot?: { x: number; y: number; width?: number; height?: number };\n    alt?: string;\n    caption?: string;\n}\n\nexport function assetImageFromLegacyEdit(\n    edit?: LegacyImageEdit | null,\n    dimensions?: { width?: number | null; height?: number | null }\n): AssetImage | undefined {\n    const image: AssetImage = {};\n\n    const width = asNumber(dimensions?.width);\n    const height = asNumber(dimensions?.height);\n    if (width !== undefined) {\n        image.width = width;\n    }\n    if (height !== undefined) {\n        image.height = height;\n    }\n\n    if (edit?.crop) {\n        image.crop = {\n            top: edit.crop.top ?? 0,\n            left: edit.crop.left ?? 0,\n            bottom: edit.crop.bottom ?? 0,\n            right: edit.crop.right ?? 0\n        };\n    }\n    if (edit?.hotspot) {\n        image.focalPoint = { x: edit.hotspot.x, y: edit.hotspot.y };\n    }\n    if (edit?.alt) {\n        image.alt = edit.alt;\n    }\n    if (edit?.caption) {\n        image.caption = edit.caption;\n    }\n\n    return Object.keys(image).length > 0 ? image : undefined;\n}\n\nconst normalizeAssetImage = (raw: unknown): AssetImage | undefined => {\n    if (!isObject(raw)) {\n        return undefined;\n    }\n    const image: AssetImage = {};\n    const width = asNumber(raw.width);\n    const height = asNumber(raw.height);\n    if (width !== undefined) {\n        image.width = width;\n    }\n    if (height !== undefined) {\n        image.height = height;\n    }\n    if (isObject(raw.crop)) {\n        image.crop = {\n            top: asNumber(raw.crop.top) ?? 0,\n            left: asNumber(raw.crop.left) ?? 0,\n            bottom: asNumber(raw.crop.bottom) ?? 0,\n            right: asNumber(raw.crop.right) ?? 0\n        };\n    }\n    if (isObject(raw.focalPoint)) {\n        const x = asNumber(raw.focalPoint.x);\n        const y = asNumber(raw.focalPoint.y);\n        if (x !== undefined && y !== undefined) {\n            image.focalPoint = { x, y };\n        }\n    }\n    const alt = asString(raw.alt);\n    if (alt) {\n        image.alt = alt;\n    }\n    const caption = asString(raw.caption);\n    if (caption) {\n        image.caption = caption;\n    }\n    return Object.keys(image).length > 0 ? image : undefined;\n};\n\nconst buildBase = (raw: Record<string, unknown>, mimeType: string): Asset => {\n    const src = asString(raw.src) ?? \"\";\n    return {\n        id: asString(raw.id) ?? \"\",\n        src,\n        url: asString(raw.url) ?? src,\n        name: asString(raw.name) ?? \"\",\n        mimeType,\n        size: asNumber(raw.size) ?? 0\n    };\n};\n\n/**\n * Keeps the image dimensions in both places: `image.width`/`image.height` for current code,\n * and the root `width`/`height` that 6.4 frontends read.\n */\nconst syncImageDimensions = (asset: Asset): Asset => {\n    if (!asset.image) {\n        return asset;\n    }\n    if (asset.image.width !== undefined) {\n        asset.width = asset.image.width;\n    }\n    if (asset.image.height !== undefined) {\n        asset.height = asset.image.height;\n    }\n    return asset;\n};\n\nexport function normalizeToAsset(input: unknown): Asset | null {\n    if (!isObject(input)) {\n        return null;\n    }\n\n    const hasTypedSubObject =\n        isObject(input.image) || isObject(input.document) || isObject(input.video);\n\n    const mimeType = asString(input.mimeType) ?? \"\";\n    const asset = buildBase(input, mimeType);\n    const category = getAssetCategory(mimeType);\n\n    if (!hasTypedSubObject) {\n        if (category === \"image\") {\n            const image = assetImageFromLegacyEdit(input.edit as LegacyImageEdit | undefined, {\n                width: asNumber(input.width),\n                height: asNumber(input.height)\n            });\n            if (image) {\n                asset.image = image;\n            }\n        }\n        return syncImageDimensions(asset);\n    }\n\n    if (category === \"image\") {\n        const image = normalizeAssetImage(input.image);\n        if (image) {\n            asset.image = image;\n        }\n    } else if (category === \"video\") {\n        if (isObject(input.video)) {\n            asset.video = {\n                autoplay:\n                    typeof input.video.autoplay === \"boolean\" ? input.video.autoplay : undefined,\n                poster: asString(input.video.poster)\n            };\n        }\n    } else if (isObject(input.document)) {\n        asset.document = { pages: asNumber(input.document.pages) };\n    }\n    return syncImageDimensions(asset);\n}\n"],"names":["getAssetCategory","mimeType","isObject","value","asNumber","Number","undefined","asString","assetImageFromLegacyEdit","edit","dimensions","image","width","height","Object","normalizeAssetImage","raw","x","y","alt","caption","buildBase","src","syncImageDimensions","asset","normalizeToAsset","input","hasTypedSubObject","category"],"mappings":"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"}

package/asset/normalize.test.d.ts

@@ -0,0 +1 @@
+export {};

package/asset/normalize.test.js

@@ -0,0 +1,263 @@
+import { describe, expect, it } from "vitest";
+import { assetImageFromLegacyEdit, getAssetCategory, normalizeToAsset } from "./normalize.js";
+import { resolveAssetImage } from "../image/geometry.js";
+describe("getAssetCategory", ()=>{
+    it("buckets by MIME prefix", ()=>{
+        expect(getAssetCategory("image/jpeg")).toBe("image");
+        expect(getAssetCategory("image/svg+xml")).toBe("image");
+        expect(getAssetCategory("video/mp4")).toBe("video");
+    });
+    it("treats everything else as a document", ()=>{
+        expect(getAssetCategory("application/pdf")).toBe("document");
+        expect(getAssetCategory("application/zip")).toBe("document");
+        expect(getAssetCategory("")).toBe("document");
+        expect(getAssetCategory(void 0)).toBe("document");
+        expect(getAssetCategory(null)).toBe("document");
+    });
+});
+describe("assetImageFromLegacyEdit", ()=>{
+    it("maps hotspot -> focalPoint and keeps crop/alt/caption", ()=>{
+        const image = assetImageFromLegacyEdit({
+            crop: {
+                top: 0.1,
+                left: 0,
+                bottom: 0.1,
+                right: 0
+            },
+            hotspot: {
+                x: 0.3,
+                y: 0.7,
+                width: 0.5,
+                height: 0.5
+            },
+            alt: "A cat",
+            caption: "Meow"
+        }, {
+            width: 800,
+            height: 600
+        });
+        expect(image).toEqual({
+            width: 800,
+            height: 600,
+            crop: {
+                top: 0.1,
+                left: 0,
+                bottom: 0.1,
+                right: 0
+            },
+            focalPoint: {
+                x: 0.3,
+                y: 0.7
+            },
+            alt: "A cat",
+            caption: "Meow"
+        });
+    });
+    it("returns undefined when there is nothing to store", ()=>{
+        expect(assetImageFromLegacyEdit(void 0, {})).toBeUndefined();
+        expect(assetImageFromLegacyEdit(null, {
+            width: null,
+            height: void 0
+        })).toBeUndefined();
+    });
+    it("keeps dimensions even without an edit", ()=>{
+        expect(assetImageFromLegacyEdit(void 0, {
+            width: 100,
+            height: 50
+        })).toEqual({
+            width: 100,
+            height: 50
+        });
+    });
+});
+describe("normalizeToAsset — legacy Website Builder image value", ()=>{
+    const legacy = {
+        id: "file-1",
+        name: "cat.jpg",
+        size: 1234,
+        mimeType: "image/jpeg",
+        src: "https://cdn/x/cat.jpg",
+        width: 800,
+        height: 600,
+        edit: {
+            crop: {
+                top: 0.1,
+                left: 0.1,
+                bottom: 0.1,
+                right: 0.1
+            },
+            hotspot: {
+                x: 0.25,
+                y: 0.75,
+                width: 1,
+                height: 1
+            },
+            alt: "A cat"
+        }
+    };
+    it("keeps mimeType, maps edit -> image, and mirrors dimensions at the root", ()=>{
+        const asset = normalizeToAsset(legacy);
+        expect(asset).toEqual({
+            id: "file-1",
+            src: "https://cdn/x/cat.jpg",
+            url: "https://cdn/x/cat.jpg",
+            name: "cat.jpg",
+            mimeType: "image/jpeg",
+            size: 1234,
+            width: 800,
+            height: 600,
+            image: {
+                width: 800,
+                height: 600,
+                crop: {
+                    top: 0.1,
+                    left: 0.1,
+                    bottom: 0.1,
+                    right: 0.1
+                },
+                focalPoint: {
+                    x: 0.25,
+                    y: 0.75
+                },
+                alt: "A cat"
+            }
+        });
+    });
+    it("handles a legacy value with no edit (dimensions only)", ()=>{
+        const asset = normalizeToAsset({
+            ...legacy,
+            edit: void 0
+        });
+        expect(asset?.image).toEqual({
+            width: 800,
+            height: 600
+        });
+    });
+    it("upgrades a flat 6.4 file value (mimeType + top-level dims, no edit)", ()=>{
+        const asset = normalizeToAsset({
+            id: "f",
+            src: "https://cdn/x.jpg",
+            name: "x.jpg",
+            mimeType: "image/jpeg",
+            size: 10,
+            width: 800,
+            height: 600
+        });
+        expect(asset).toEqual({
+            id: "f",
+            src: "https://cdn/x.jpg",
+            url: "https://cdn/x.jpg",
+            name: "x.jpg",
+            mimeType: "image/jpeg",
+            size: 10,
+            width: 800,
+            height: 600,
+            image: {
+                width: 800,
+                height: 600
+            }
+        });
+    });
+    it("does not attach image data for a non-image legacy value", ()=>{
+        const asset = normalizeToAsset({
+            ...legacy,
+            mimeType: "application/pdf",
+            edit: void 0,
+            width: void 0,
+            height: void 0
+        });
+        expect(asset?.mimeType).toBe("application/pdf");
+        expect(asset?.width).toBeUndefined();
+        expect(asset?.image).toBeUndefined();
+    });
+});
+describe("normalizeToAsset — already-unified asset", ()=>{
+    it("is idempotent for a well-formed image asset", ()=>{
+        const asset = {
+            id: "f2",
+            src: "https://cdn/y/pic.png",
+            url: "https://cdn/y/pic.png",
+            name: "pic.png",
+            mimeType: "image/png",
+            size: 9,
+            width: 400,
+            height: 300,
+            image: {
+                width: 400,
+                height: 300,
+                crop: {
+                    top: 0,
+                    left: 0.2,
+                    bottom: 0,
+                    right: 0.2
+                },
+                focalPoint: {
+                    x: 0.5,
+                    y: 0.5
+                },
+                alt: "Pic"
+            }
+        };
+        expect(normalizeToAsset(asset)).toEqual(asset);
+    });
+    it("preserves video data", ()=>{
+        const asset = normalizeToAsset({
+            id: "v1",
+            src: "https://cdn/v/clip.mp4",
+            name: "clip.mp4",
+            mimeType: "video/mp4",
+            size: 42,
+            video: {
+                autoplay: true,
+                poster: "https://cdn/v/poster.jpg"
+            }
+        });
+        expect(asset?.video).toEqual({
+            autoplay: true,
+            poster: "https://cdn/v/poster.jpg"
+        });
+    });
+    it("returns null for invalid input", ()=>{
+        expect(normalizeToAsset(null)).toBeNull();
+        expect(normalizeToAsset(void 0)).toBeNull();
+        expect(normalizeToAsset("nope")).toBeNull();
+        expect(normalizeToAsset(42)).toBeNull();
+    });
+});
+describe("resolveAssetImage", ()=>{
+    it("prefers override per property, falling back to base", ()=>{
+        const merged = resolveAssetImage({
+            crop: {
+                top: 0.1,
+                left: 0,
+                bottom: 0,
+                right: 0
+            }
+        }, {
+            crop: {
+                top: 0.5,
+                left: 0,
+                bottom: 0,
+                right: 0
+            },
+            focalPoint: {
+                x: 0.2,
+                y: 0.2
+            },
+            alt: "base"
+        });
+        expect(merged.crop).toEqual({
+            top: 0.1,
+            left: 0,
+            bottom: 0,
+            right: 0
+        });
+        expect(merged.focalPoint).toEqual({
+            x: 0.2,
+            y: 0.2
+        });
+        expect(merged.alt).toBe("base");
+    });
+});
+
+//# sourceMappingURL=normalize.test.js.map

package/asset/normalize.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset/normalize.test.js","sources":["../../src/asset/normalize.test.ts"],"sourcesContent":["import { describe, it, expect } from \"vitest\";\nimport { assetImageFromLegacyEdit, getAssetCategory, normalizeToAsset } from \"./normalize.js\";\nimport { resolveAssetImage } from \"../image/geometry.js\";\n\ndescribe(\"getAssetCategory\", () => {\n    it(\"buckets by MIME prefix\", () => {\n        expect(getAssetCategory(\"image/jpeg\")).toBe(\"image\");\n        expect(getAssetCategory(\"image/svg+xml\")).toBe(\"image\");\n        expect(getAssetCategory(\"video/mp4\")).toBe(\"video\");\n    });\n\n    it(\"treats everything else as a document\", () => {\n        expect(getAssetCategory(\"application/pdf\")).toBe(\"document\");\n        expect(getAssetCategory(\"application/zip\")).toBe(\"document\");\n        expect(getAssetCategory(\"\")).toBe(\"document\");\n        expect(getAssetCategory(undefined)).toBe(\"document\");\n        expect(getAssetCategory(null)).toBe(\"document\");\n    });\n});\n\ndescribe(\"assetImageFromLegacyEdit\", () => {\n    it(\"maps hotspot -> focalPoint and keeps crop/alt/caption\", () => {\n        const image = assetImageFromLegacyEdit(\n            {\n                crop: { top: 0.1, left: 0, bottom: 0.1, right: 0 },\n                hotspot: { x: 0.3, y: 0.7, width: 0.5, height: 0.5 },\n                alt: \"A cat\",\n                caption: \"Meow\"\n            },\n            { width: 800, height: 600 }\n        );\n        expect(image).toEqual({\n            width: 800,\n            height: 600,\n            crop: { top: 0.1, left: 0, bottom: 0.1, right: 0 },\n            focalPoint: { x: 0.3, y: 0.7 },\n            alt: \"A cat\",\n            caption: \"Meow\"\n        });\n    });\n\n    it(\"returns undefined when there is nothing to store\", () => {\n        expect(assetImageFromLegacyEdit(undefined, {})).toBeUndefined();\n        expect(assetImageFromLegacyEdit(null, { width: null, height: undefined })).toBeUndefined();\n    });\n\n    it(\"keeps dimensions even without an edit\", () => {\n        expect(assetImageFromLegacyEdit(undefined, { width: 100, height: 50 })).toEqual({\n            width: 100,\n            height: 50\n        });\n    });\n});\n\ndescribe(\"normalizeToAsset — legacy Website Builder image value\", () => {\n    const legacy = {\n        id: \"file-1\",\n        name: \"cat.jpg\",\n        size: 1234,\n        mimeType: \"image/jpeg\",\n        src: \"https://cdn/x/cat.jpg\",\n        width: 800,\n        height: 600,\n        edit: {\n            crop: { top: 0.1, left: 0.1, bottom: 0.1, right: 0.1 },\n            hotspot: { x: 0.25, y: 0.75, width: 1, height: 1 },\n            alt: \"A cat\"\n        }\n    };\n\n    it(\"keeps mimeType, maps edit -> image, and mirrors dimensions at the root\", () => {\n        const asset = normalizeToAsset(legacy);\n        expect(asset).toEqual({\n            id: \"file-1\",\n            src: \"https://cdn/x/cat.jpg\",\n            url: \"https://cdn/x/cat.jpg\",\n            name: \"cat.jpg\",\n            mimeType: \"image/jpeg\",\n            size: 1234,\n            width: 800,\n            height: 600,\n            image: {\n                width: 800,\n                height: 600,\n                crop: { top: 0.1, left: 0.1, bottom: 0.1, right: 0.1 },\n                focalPoint: { x: 0.25, y: 0.75 },\n                alt: \"A cat\"\n            }\n        });\n    });\n\n    it(\"handles a legacy value with no edit (dimensions only)\", () => {\n        const asset = normalizeToAsset({ ...legacy, edit: undefined });\n        expect(asset?.image).toEqual({ width: 800, height: 600 });\n    });\n\n    it(\"upgrades a flat 6.4 file value (mimeType + top-level dims, no edit)\", () => {\n        // The shape released 6.x versions store: flat, no image sub-object.\n        const asset = normalizeToAsset({\n            id: \"f\",\n            src: \"https://cdn/x.jpg\",\n            name: \"x.jpg\",\n            mimeType: \"image/jpeg\",\n            size: 10,\n            width: 800,\n            height: 600\n        });\n        expect(asset).toEqual({\n            id: \"f\",\n            src: \"https://cdn/x.jpg\",\n            url: \"https://cdn/x.jpg\",\n            name: \"x.jpg\",\n            mimeType: \"image/jpeg\",\n            size: 10,\n            width: 800,\n            height: 600,\n            image: { width: 800, height: 600 }\n        });\n    });\n\n    it(\"does not attach image data for a non-image legacy value\", () => {\n        const asset = normalizeToAsset({\n            ...legacy,\n            mimeType: \"application/pdf\",\n            edit: undefined,\n            width: undefined,\n            height: undefined\n        });\n        expect(asset?.mimeType).toBe(\"application/pdf\");\n        expect(asset?.width).toBeUndefined();\n        expect(asset?.image).toBeUndefined();\n    });\n});\n\ndescribe(\"normalizeToAsset — already-unified asset\", () => {\n    it(\"is idempotent for a well-formed image asset\", () => {\n        const asset = {\n            id: \"f2\",\n            src: \"https://cdn/y/pic.png\",\n            url: \"https://cdn/y/pic.png\",\n            name: \"pic.png\",\n            mimeType: \"image/png\",\n            size: 9,\n            width: 400,\n            height: 300,\n            image: {\n                width: 400,\n                height: 300,\n                crop: { top: 0, left: 0.2, bottom: 0, right: 0.2 },\n                focalPoint: { x: 0.5, y: 0.5 },\n                alt: \"Pic\"\n            }\n        };\n        expect(normalizeToAsset(asset)).toEqual(asset);\n    });\n\n    it(\"preserves video data\", () => {\n        const asset = normalizeToAsset({\n            id: \"v1\",\n            src: \"https://cdn/v/clip.mp4\",\n            name: \"clip.mp4\",\n            mimeType: \"video/mp4\",\n            size: 42,\n            video: { autoplay: true, poster: \"https://cdn/v/poster.jpg\" }\n        });\n        expect(asset?.video).toEqual({ autoplay: true, poster: \"https://cdn/v/poster.jpg\" });\n    });\n\n    it(\"returns null for invalid input\", () => {\n        expect(normalizeToAsset(null)).toBeNull();\n        expect(normalizeToAsset(undefined)).toBeNull();\n        expect(normalizeToAsset(\"nope\")).toBeNull();\n        expect(normalizeToAsset(42)).toBeNull();\n    });\n});\n\ndescribe(\"resolveAssetImage\", () => {\n    it(\"prefers override per property, falling back to base\", () => {\n        const merged = resolveAssetImage(\n            { crop: { top: 0.1, left: 0, bottom: 0, right: 0 } },\n            {\n                crop: { top: 0.5, left: 0, bottom: 0, right: 0 },\n                focalPoint: { x: 0.2, y: 0.2 },\n                alt: \"base\"\n            }\n        );\n        expect(merged.crop).toEqual({ top: 0.1, left: 0, bottom: 0, right: 0 });\n        expect(merged.focalPoint).toEqual({ x: 0.2, y: 0.2 });\n        expect(merged.alt).toBe(\"base\");\n    });\n});\n"],"names":["describe","it","expect","getAssetCategory","undefined","image","assetImageFromLegacyEdit","legacy","asset","normalizeToAsset","merged","resolveAssetImage"],"mappings":"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"}

package/asset/types.d.ts

@@ -0,0 +1,2 @@
+export type { Asset, AssetImage, AssetCrop, AssetFocalPoint, AssetDocument, AssetVideo } from "@webiny/sdk";
+export type AssetCategory = "image" | "document" | "video";

package/constants.js

@@ -1,9 +1,10 @@
-export const StyleSettings = {
-  Layout: "layout",
-  Visibility: "visibility",
-  Background: "background",
-  MarginPadding: "marginPadding",
-  Border: "border"
+const StyleSettings = {
+    Layout: "layout",
+    Visibility: "visibility",
+    Background: "background",
+    MarginPadding: "marginPadding",
+    Border: "border"
 };
+export { StyleSettings };
 
 //# sourceMappingURL=constants.js.map

package/constants.js.map

@@ -1 +1 @@
-{"version":3,"names":["StyleSettings","Layout","Visibility","Background","MarginPadding","Border"],"sources":["constants.ts"],"sourcesContent":["export const StyleSettings = {\n    Layout: \"layout\",\n    Visibility: \"visibility\",\n    Background: \"background\",\n    MarginPadding: \"marginPadding\",\n    Border: \"border\"\n};\n"],"mappings":"AAAA,OAAO,MAAMA,aAAa,GAAG;EACzBC,MAAM,EAAE,QAAQ;EAChBC,UAAU,EAAE,YAAY;EACxBC,UAAU,EAAE,YAAY;EACxBC,aAAa,EAAE,eAAe;EAC9BC,MAAM,EAAE;AACZ,CAAC","ignoreList":[]}
+{"version":3,"file":"constants.js","sources":["../src/constants.ts"],"sourcesContent":["export const StyleSettings = {\n    Layout: \"layout\",\n    Visibility: \"visibility\",\n    Background: \"background\",\n    MarginPadding: \"marginPadding\",\n    Border: \"border\"\n};\n"],"names":["StyleSettings"],"mappings":"AAAO,MAAMA,gBAAgB;IACzB,QAAQ;IACR,YAAY;IACZ,YAAY;IACZ,eAAe;IACf,QAAQ;AACZ"}

package/contentEntry/ContentEntryBindingsResolver.d.ts

@@ -0,0 +1,30 @@
+import type { ResolvedElement } from "../types.js";
+import type { IBindingsResolver, ResolveElementParams } from "../BindingsResolver.js";
+/**
+ * Decorator for `IBindingsResolver` that resolves `contentEntry` inputs.
+ *
+ * The inner resolver evaluates binding expressions against the document state,
+ * producing raw values (`{ id, modelId }` references or query params). This
+ * decorator then replaces those raw values with pre-resolved CMS entries from
+ * a supplied map, or (on the client) triggers async resolution via the
+ * `contentEntryCache` singleton.
+ *
+ * **Server path**: `resolveContentEntries()` pre-fetches all entries, builds
+ * the `resolvedEntries` map, and passes it here. The decorator synchronously
+ * swaps raw values for resolved entries during render.
+ *
+ * **Client path (editor preview)**: `resolvedEntries` may be empty. The
+ * decorator falls back to `contentEntryCache.resolve()` which kicks off an
+ * async fetch; the mobx-observable cache triggers re-render when it lands.
+ */
+export declare class ContentEntryBindingsResolver implements IBindingsResolver {
+    private readonly inner;
+    private readonly resolvedEntries;
+    constructor(inner: IBindingsResolver, resolvedEntries?: ReadonlyMap<string, unknown>);
+    resolveElement(params: ResolveElementParams): ResolvedElement[];
+    /**
+     * Walk the input AST and replace raw content-entry values with resolved
+     * entries from the map or the module-level cache.
+     */
+    private enrichContentEntryInputs;
+}

package/contentEntry/ContentEntryBindingsResolver.js

@@ -0,0 +1,45 @@
+import { contentEntryCache } from "./ContentEntryCache.js";
+import { environment } from "../Environment.js";
+class ContentEntryBindingsResolver {
+    constructor(inner, resolvedEntries = new Map()){
+        this.inner = inner;
+        this.resolvedEntries = resolvedEntries;
+    }
+    resolveElement(params) {
+        const results = this.inner.resolveElement(params);
+        for (const instance of results)this.enrichContentEntryInputs(params.element.id, params.inputAst, instance.inputs);
+        return results;
+    }
+    enrichContentEntryInputs(elementId, ast, inputs) {
+        for (const node of ast){
+            if ("contentEntry" === node.input.type) {
+                const key = `${elementId}:${node.name}`;
+                const rawValue = inputs[node.name];
+                const list = node.input.list ?? false;
+                if (this.resolvedEntries.has(key)) {
+                    inputs[node.name] = this.resolvedEntries.get(key);
+                    continue;
+                }
+                if (contentEntryCache.has(key)) {
+                    inputs[node.name] = contentEntryCache.get(key);
+                    continue;
+                }
+                if (environment.isClient() && contentEntryCache.getLoader()) {
+                    const cacheKey = `${key}:${JSON.stringify(rawValue ?? null)}`;
+                    contentEntryCache.resolve(cacheKey, rawValue, list);
+                    const cached = contentEntryCache.get(cacheKey);
+                    if (void 0 !== cached) inputs[node.name] = cached;
+                }
+            }
+            if (node.children.length > 0) {
+                const value = inputs[node.name];
+                if (node.list && Array.isArray(value)) {
+                    for (const item of value)if ("object" == typeof item && null !== item) this.enrichContentEntryInputs(elementId, node.children, item);
+                } else if ("object" == typeof value && null !== value && !Array.isArray(value)) this.enrichContentEntryInputs(elementId, node.children, value);
+            }
+        }
+    }
+}
+export { ContentEntryBindingsResolver };
+
+//# sourceMappingURL=ContentEntryBindingsResolver.js.map

package/contentEntry/ContentEntryBindingsResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contentEntry/ContentEntryBindingsResolver.js","sources":["../../src/contentEntry/ContentEntryBindingsResolver.ts"],"sourcesContent":["import type { ResolvedElement } from \"~/types.js\";\nimport type { IBindingsResolver, ResolveElementParams } from \"~/BindingsResolver.js\";\nimport type { InputAstNode } from \"~/ComponentManifestToAstConverter.js\";\nimport { contentEntryCache } from \"./ContentEntryCache.js\";\nimport { environment } from \"~/Environment.js\";\n\n/**\n * Decorator for `IBindingsResolver` that resolves `contentEntry` inputs.\n *\n * The inner resolver evaluates binding expressions against the document state,\n * producing raw values (`{ id, modelId }` references or query params). This\n * decorator then replaces those raw values with pre-resolved CMS entries from\n * a supplied map, or (on the client) triggers async resolution via the\n * `contentEntryCache` singleton.\n *\n * **Server path**: `resolveContentEntries()` pre-fetches all entries, builds\n * the `resolvedEntries` map, and passes it here. The decorator synchronously\n * swaps raw values for resolved entries during render.\n *\n * **Client path (editor preview)**: `resolvedEntries` may be empty. The\n * decorator falls back to `contentEntryCache.resolve()` which kicks off an\n * async fetch; the mobx-observable cache triggers re-render when it lands.\n */\nexport class ContentEntryBindingsResolver implements IBindingsResolver {\n    constructor(\n        private readonly inner: IBindingsResolver,\n        private readonly resolvedEntries: ReadonlyMap<string, unknown> = new Map()\n    ) {}\n\n    resolveElement(params: ResolveElementParams): ResolvedElement[] {\n        const results = this.inner.resolveElement(params);\n\n        for (const instance of results) {\n            this.enrichContentEntryInputs(params.element.id, params.inputAst, instance.inputs);\n        }\n\n        return results;\n    }\n\n    /**\n     * Walk the input AST and replace raw content-entry values with resolved\n     * entries from the map or the module-level cache.\n     */\n    private enrichContentEntryInputs(\n        elementId: string,\n        ast: InputAstNode[],\n        inputs: Record<string, any>\n    ): void {\n        for (const node of ast) {\n            if (node.input.type === \"contentEntry\") {\n                const key = `${elementId}:${node.name}`;\n                const rawValue = inputs[node.name];\n                const list = node.input.list ?? false;\n\n                // 1. Pre-resolved entries map (seeded by server pre-pass).\n                if (this.resolvedEntries.has(key)) {\n                    inputs[node.name] = this.resolvedEntries.get(key);\n                    continue;\n                }\n\n                // 2. Module-level cache (populated by previous renders or\n                //    async resolves on the client).\n                if (contentEntryCache.has(key)) {\n                    inputs[node.name] = contentEntryCache.get(key);\n                    continue;\n                }\n\n                // 3. Client-side async resolution: trigger a background fetch.\n                //    The observable cache write will cause a re-render.\n                if (environment.isClient() && contentEntryCache.getLoader()) {\n                    const cacheKey = `${key}:${JSON.stringify(rawValue ?? null)}`;\n                    contentEntryCache.resolve(cacheKey, rawValue, list);\n                    const cached = contentEntryCache.get(cacheKey);\n                    if (cached !== undefined) {\n                        inputs[node.name] = cached;\n                    }\n                }\n            }\n\n            // Recurse into children (object / object-list nodes).\n            if (node.children.length > 0) {\n                const value = inputs[node.name];\n                if (node.list && Array.isArray(value)) {\n                    for (const item of value) {\n                        if (typeof item === \"object\" && item !== null) {\n                            this.enrichContentEntryInputs(elementId, node.children, item);\n                        }\n                    }\n                } else if (typeof value === \"object\" && value !== null && !Array.isArray(value)) {\n                    this.enrichContentEntryInputs(elementId, node.children, value);\n                }\n            }\n        }\n    }\n}\n"],"names":["ContentEntryBindingsResolver","inner","resolvedEntries","Map","params","results","instance","elementId","ast","inputs","node","key","rawValue","list","contentEntryCache","environment","cacheKey","JSON","cached","undefined","value","Array","item"],"mappings":";;AAuBO,MAAMA;IACT,YACqBC,KAAwB,EACxBC,kBAAgD,IAAIC,KAAK,CAC5E;aAFmBF,KAAK,GAALA;aACAC,eAAe,GAAfA;IAClB;IAEH,eAAeE,MAA4B,EAAqB;QAC5D,MAAMC,UAAU,IAAI,CAAC,KAAK,CAAC,cAAc,CAACD;QAE1C,KAAK,MAAME,YAAYD,QACnB,IAAI,CAAC,wBAAwB,CAACD,OAAO,OAAO,CAAC,EAAE,EAAEA,OAAO,QAAQ,EAAEE,SAAS,MAAM;QAGrF,OAAOD;IACX;IAMQ,yBACJE,SAAiB,EACjBC,GAAmB,EACnBC,MAA2B,EACvB;QACJ,KAAK,MAAMC,QAAQF,IAAK;YACpB,IAAIE,AAAoB,mBAApBA,KAAK,KAAK,CAAC,IAAI,EAAqB;gBACpC,MAAMC,MAAM,GAAGJ,UAAU,CAAC,EAAEG,KAAK,IAAI,EAAE;gBACvC,MAAME,WAAWH,MAAM,CAACC,KAAK,IAAI,CAAC;gBAClC,MAAMG,OAAOH,KAAK,KAAK,CAAC,IAAI,IAAI;gBAGhC,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAACC,MAAM;oBAC/BF,MAAM,CAACC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAACC;oBAC7C;gBACJ;gBAIA,IAAIG,kBAAkB,GAAG,CAACH,MAAM;oBAC5BF,MAAM,CAACC,KAAK,IAAI,CAAC,GAAGI,kBAAkB,GAAG,CAACH;oBAC1C;gBACJ;gBAIA,IAAII,YAAY,QAAQ,MAAMD,kBAAkB,SAAS,IAAI;oBACzD,MAAME,WAAW,GAAGL,IAAI,CAAC,EAAEM,KAAK,SAAS,CAACL,YAAY,OAAO;oBAC7DE,kBAAkB,OAAO,CAACE,UAAUJ,UAAUC;oBAC9C,MAAMK,SAASJ,kBAAkB,GAAG,CAACE;oBACrC,IAAIE,AAAWC,WAAXD,QACAT,MAAM,CAACC,KAAK,IAAI,CAAC,GAAGQ;gBAE5B;YACJ;YAGA,IAAIR,KAAK,QAAQ,CAAC,MAAM,GAAG,GAAG;gBAC1B,MAAMU,QAAQX,MAAM,CAACC,KAAK,IAAI,CAAC;gBAC/B,IAAIA,KAAK,IAAI,IAAIW,MAAM,OAAO,CAACD,QAC3B;oBAAA,KAAK,MAAME,QAAQF,MACf,IAAI,AAAgB,YAAhB,OAAOE,QAAqBA,AAAS,SAATA,MAC5B,IAAI,CAAC,wBAAwB,CAACf,WAAWG,KAAK,QAAQ,EAAEY;gBAEhE,OACG,IAAI,AAAiB,YAAjB,OAAOF,SAAsBA,AAAU,SAAVA,SAAkB,CAACC,MAAM,OAAO,CAACD,QACrE,IAAI,CAAC,wBAAwB,CAACb,WAAWG,KAAK,QAAQ,EAAEU;YAEhE;QACJ;IACJ;AACJ"}

package/contentEntry/ContentEntryCache.d.ts

@@ -0,0 +1,46 @@
+import { type ContentEntryLoader, type ResolvedContentEntry } from "./resolveContentEntry.js";
+type RawValue = unknown | unknown[] | null | undefined;
+/**
+ * SDK-level mobx cache for resolved content-entry inputs. Mirrors the CMS
+ * `RefCache` pattern: a singleton observable store that both the server
+ * pre-pass (`resolveAutoLoad`) and the editor preview path can seed / read.
+ *
+ * - **Server / SSR**: `resolveAutoLoad` calls `set(key, resolved)` for every
+ *   entry it pre-resolves. `BindingsResolver.resolveSingleInstance` reads via
+ *   `get(key)` synchronously during render — no React context needed.
+ *
+ * - **Editor preview**: `resolve(key, input, value, loader)` triggers an async
+ *   fetch whose result is written inside a mobx action, so `observer`
+ *   components re-render once it lands. Keyed by a signature of the raw value,
+ *   so when the editor changes the selection/query the key changes and the
+ *   entry is re-resolved.
+ */
+declare class ContentEntryCacheImpl {
+    private cache;
+    private loader;
+    constructor();
+    get(key: string): ResolvedContentEntry | undefined;
+    has(key: string): boolean;
+    set(key: string, value: ResolvedContentEntry): void;
+    /**
+     * Register the CMS data loader that `resolve()` will use for async fetches.
+     * Called once during initialisation (e.g. by `resolveAutoLoad`). The loader
+     * is **not** mobx-observable — it's a plain service reference.
+     */
+    setLoader(loader: ContentEntryLoader): void;
+    /**
+     * Return the registered loader, if any.
+     */
+    getLoader(): ContentEntryLoader | undefined;
+    /**
+     * Lazily resolve `value` under `key`. Idempotent and safe to call during
+     * render: the observable write happens later, inside an action.
+     *
+     * Uses the loader registered via `setLoader()`. If no loader is registered,
+     * the call is a no-op (the raw value will be used instead).
+     */
+    resolve(key: string, value: RawValue, list: boolean): void;
+    clear(): void;
+}
+export declare const contentEntryCache: ContentEntryCacheImpl;
+export {};

package/contentEntry/ContentEntryCache.js

@@ -0,0 +1,50 @@
+import { makeAutoObservable, runInAction } from "mobx";
+import { resolveContentEntryValue } from "./resolveContentEntry.js";
+const pending = new Set();
+class ContentEntryCacheImpl {
+    constructor(){
+        this.cache = new Map();
+        makeAutoObservable(this, {
+            setLoader: false,
+            getLoader: false
+        });
+    }
+    get(key) {
+        return this.cache.get(key);
+    }
+    has(key) {
+        return this.cache.has(key);
+    }
+    set(key, value) {
+        runInAction(()=>{
+            this.cache.set(key, value);
+        });
+    }
+    setLoader(loader) {
+        this.loader = loader;
+    }
+    getLoader() {
+        return this.loader;
+    }
+    resolve(key, value, list) {
+        if (this.cache.has(key) || pending.has(key) || !this.loader) return;
+        pending.add(key);
+        resolveContentEntryValue(value, list, this.loader).then((resolved)=>{
+            runInAction(()=>{
+                this.cache.set(key, resolved);
+            });
+            pending.delete(key);
+        }).catch(()=>{
+            pending.delete(key);
+        });
+    }
+    clear() {
+        runInAction(()=>{
+            this.cache.clear();
+        });
+    }
+}
+const contentEntryCache = new ContentEntryCacheImpl();
+export { contentEntryCache };
+
+//# sourceMappingURL=ContentEntryCache.js.map

package/contentEntry/ContentEntryCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contentEntry/ContentEntryCache.js","sources":["../../src/contentEntry/ContentEntryCache.ts"],"sourcesContent":["import { makeAutoObservable, runInAction } from \"mobx\";\nimport {\n    resolveContentEntryValue,\n    type ContentEntryLoader,\n    type ResolvedContentEntry\n} from \"./resolveContentEntry.js\";\n\ntype RawValue = unknown | unknown[] | null | undefined;\n\n// Non-observable dedupe set (kept out of the observable class so touching it\n// during render never counts as a mobx mutation-in-render).\nconst pending = new Set<string>();\n\n/**\n * SDK-level mobx cache for resolved content-entry inputs. Mirrors the CMS\n * `RefCache` pattern: a singleton observable store that both the server\n * pre-pass (`resolveAutoLoad`) and the editor preview path can seed / read.\n *\n * - **Server / SSR**: `resolveAutoLoad` calls `set(key, resolved)` for every\n *   entry it pre-resolves. `BindingsResolver.resolveSingleInstance` reads via\n *   `get(key)` synchronously during render — no React context needed.\n *\n * - **Editor preview**: `resolve(key, input, value, loader)` triggers an async\n *   fetch whose result is written inside a mobx action, so `observer`\n *   components re-render once it lands. Keyed by a signature of the raw value,\n *   so when the editor changes the selection/query the key changes and the\n *   entry is re-resolved.\n */\nclass ContentEntryCacheImpl {\n    private cache = new Map<string, ResolvedContentEntry>();\n    private loader: ContentEntryLoader | undefined;\n\n    constructor() {\n        makeAutoObservable(this, {\n            // The loader is a plain service reference, not an observable value.\n            setLoader: false,\n            getLoader: false\n        });\n    }\n\n    get(key: string): ResolvedContentEntry | undefined {\n        return this.cache.get(key);\n    }\n\n    has(key: string): boolean {\n        return this.cache.has(key);\n    }\n\n    set(key: string, value: ResolvedContentEntry): void {\n        runInAction(() => {\n            this.cache.set(key, value);\n        });\n    }\n\n    /**\n     * Register the CMS data loader that `resolve()` will use for async fetches.\n     * Called once during initialisation (e.g. by `resolveAutoLoad`). The loader\n     * is **not** mobx-observable — it's a plain service reference.\n     */\n    setLoader(loader: ContentEntryLoader): void {\n        this.loader = loader;\n    }\n\n    /**\n     * Return the registered loader, if any.\n     */\n    getLoader(): ContentEntryLoader | undefined {\n        return this.loader;\n    }\n\n    /**\n     * Lazily resolve `value` under `key`. Idempotent and safe to call during\n     * render: the observable write happens later, inside an action.\n     *\n     * Uses the loader registered via `setLoader()`. If no loader is registered,\n     * the call is a no-op (the raw value will be used instead).\n     */\n    resolve(key: string, value: RawValue, list: boolean): void {\n        if (this.cache.has(key) || pending.has(key) || !this.loader) {\n            return;\n        }\n        pending.add(key);\n        resolveContentEntryValue(value as any, list, this.loader)\n            .then(resolved => {\n                runInAction(() => {\n                    this.cache.set(key, resolved);\n                });\n                pending.delete(key);\n            })\n            .catch(() => {\n                pending.delete(key);\n            });\n    }\n\n    clear(): void {\n        runInAction(() => {\n            this.cache.clear();\n        });\n    }\n}\n\nexport const contentEntryCache = new ContentEntryCacheImpl();\n"],"names":["pending","Set","ContentEntryCacheImpl","Map","makeAutoObservable","key","value","runInAction","loader","list","resolveContentEntryValue","resolved","contentEntryCache"],"mappings":";;AAWA,MAAMA,UAAU,IAAIC;AAiBpB,MAAMC;IAIF,aAAc;aAHN,KAAK,GAAG,IAAIC;QAIhBC,mBAAmB,IAAI,EAAE;YAErB,WAAW;YACX,WAAW;QACf;IACJ;IAEA,IAAIC,GAAW,EAAoC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAACA;IAC1B;IAEA,IAAIA,GAAW,EAAW;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAACA;IAC1B;IAEA,IAAIA,GAAW,EAAEC,KAA2B,EAAQ;QAChDC,YAAY;YACR,IAAI,CAAC,KAAK,CAAC,GAAG,CAACF,KAAKC;QACxB;IACJ;IAOA,UAAUE,MAA0B,EAAQ;QACxC,IAAI,CAAC,MAAM,GAAGA;IAClB;IAKA,YAA4C;QACxC,OAAO,IAAI,CAAC,MAAM;IACtB;IASA,QAAQH,GAAW,EAAEC,KAAe,EAAEG,IAAa,EAAQ;QACvD,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAACJ,QAAQL,QAAQ,GAAG,CAACK,QAAQ,CAAC,IAAI,CAAC,MAAM,EACvD;QAEJL,QAAQ,GAAG,CAACK;QACZK,yBAAyBJ,OAAcG,MAAM,IAAI,CAAC,MAAM,EACnD,IAAI,CAACE,CAAAA;YACFJ,YAAY;gBACR,IAAI,CAAC,KAAK,CAAC,GAAG,CAACF,KAAKM;YACxB;YACAX,QAAQ,MAAM,CAACK;QACnB,GACC,KAAK,CAAC;YACHL,QAAQ,MAAM,CAACK;QACnB;IACR;IAEA,QAAc;QACVE,YAAY;YACR,IAAI,CAAC,KAAK,CAAC,KAAK;QACpB;IACJ;AACJ;AAEO,MAAMK,oBAAoB,IAAIV"}