@webiny/website-builder-sdk 0.0.0-unstable.7be00a75a9 → 0.0.0-unstable.7c2def32a7

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/componentLoader/ComponentLoader.d.ts

@@ -0,0 +1,16 @@
+import type { Component, ElementComponent } from "../types.js";
+import type { ApiClient } from "../dataProviders/ApiClient.js";
+import type { ApiConfig } from "../ContentSdk.js";
+/**
+ * Loads a component that a document references but the content client has no registration for.
+ * This is the seam for fetching components per tenant and for caching them. The content client
+ * creates one loader per client and caches nothing itself.
+ */
+export interface ComponentLoader {
+    loadComponent(ref: ElementComponent): Promise<Component | null>;
+}
+export type ComponentLoaderFactoryParams = {
+    apiClient: ApiClient;
+    config: ApiConfig;
+};
+export type ComponentLoaderFactory = (params: ComponentLoaderFactoryParams) => ComponentLoader;

package/componentLoader/RegistryOnlyComponentLoader.d.ts

@@ -0,0 +1,9 @@
+import type { Component } from "../types.js";
+import type { ComponentLoader } from "./ComponentLoader.js";
+/**
+ * The loader used when neither the config nor a framework integration provides one. It loads
+ * nothing, so only components registered with `registerComponent` render.
+ */
+export declare class RegistryOnlyComponentLoader implements ComponentLoader {
+    loadComponent(): Promise<Component | null>;
+}

package/componentLoader/RegistryOnlyComponentLoader.js

@@ -0,0 +1,8 @@
+class RegistryOnlyComponentLoader {
+    async loadComponent() {
+        return null;
+    }
+}
+export { RegistryOnlyComponentLoader };
+
+//# sourceMappingURL=RegistryOnlyComponentLoader.js.map

package/componentLoader/RegistryOnlyComponentLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentLoader/RegistryOnlyComponentLoader.js","sources":["../../src/componentLoader/RegistryOnlyComponentLoader.ts"],"sourcesContent":["import type { Component } from \"~/types.js\";\nimport type { ComponentLoader } from \"./ComponentLoader.js\";\n\n/**\n * The loader used when neither the config nor a framework integration provides one. It loads\n * nothing, so only components registered with `registerComponent` render.\n */\nexport class RegistryOnlyComponentLoader implements ComponentLoader {\n    async loadComponent(): Promise<Component | null> {\n        return null;\n    }\n}\n"],"names":["RegistryOnlyComponentLoader"],"mappings":"AAOO,MAAMA;IACT,MAAM,gBAA2C;QAC7C,OAAO;IACX;AACJ"}

package/componentLoader/createComponentLoader.d.ts

@@ -0,0 +1,7 @@
+import type { ComponentLoader, ComponentLoaderFactory } from "./ComponentLoader.js";
+import type { ComponentLoaderFactoryParams } from "./ComponentLoader.js";
+/**
+ * Create a content client's loader: its own factory if it has one, else the default set with
+ * `setDefaultComponentLoader`, else a loader that loads nothing.
+ */
+export declare function createComponentLoader(factory: ComponentLoaderFactory | undefined, params: ComponentLoaderFactoryParams): ComponentLoader;

package/componentLoader/createComponentLoader.js

@@ -0,0 +1,10 @@
+import { getDefaultComponentLoader } from "./defaultComponentLoader.js";
+import { RegistryOnlyComponentLoader } from "./RegistryOnlyComponentLoader.js";
+function createComponentLoader(factory, params) {
+    const resolved = factory ?? getDefaultComponentLoader();
+    if (!resolved) return new RegistryOnlyComponentLoader();
+    return resolved(params);
+}
+export { createComponentLoader };
+
+//# sourceMappingURL=createComponentLoader.js.map

package/componentLoader/createComponentLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentLoader/createComponentLoader.js","sources":["../../src/componentLoader/createComponentLoader.ts"],"sourcesContent":["import type { ComponentLoader, ComponentLoaderFactory } from \"./ComponentLoader.js\";\nimport type { ComponentLoaderFactoryParams } from \"./ComponentLoader.js\";\nimport { getDefaultComponentLoader } from \"./defaultComponentLoader.js\";\nimport { RegistryOnlyComponentLoader } from \"./RegistryOnlyComponentLoader.js\";\n\n/**\n * Create a content client's loader: its own factory if it has one, else the default set with\n * `setDefaultComponentLoader`, else a loader that loads nothing.\n */\nexport function createComponentLoader(\n    factory: ComponentLoaderFactory | undefined,\n    params: ComponentLoaderFactoryParams\n): ComponentLoader {\n    const resolved = factory ?? getDefaultComponentLoader();\n    if (!resolved) {\n        return new RegistryOnlyComponentLoader();\n    }\n    return resolved(params);\n}\n"],"names":["createComponentLoader","factory","params","resolved","getDefaultComponentLoader","RegistryOnlyComponentLoader"],"mappings":";;AASO,SAASA,sBACZC,OAA2C,EAC3CC,MAAoC;IAEpC,MAAMC,WAAWF,WAAWG;IAC5B,IAAI,CAACD,UACD,OAAO,IAAIE;IAEf,OAAOF,SAASD;AACpB"}

package/componentLoader/defaultComponentLoader.d.ts

@@ -0,0 +1,7 @@
+import type { ComponentLoaderFactory } from "./ComponentLoader.js";
+/**
+ * Set the component loader that content clients use when their config has none. A framework
+ * integration sets it on import, the way it sets the headers provider.
+ */
+export declare const setDefaultComponentLoader: (factory: ComponentLoaderFactory | undefined) => void;
+export declare const getDefaultComponentLoader: () => ComponentLoaderFactory | undefined;

package/componentLoader/defaultComponentLoader.js

@@ -0,0 +1,8 @@
+let defaultComponentLoader;
+const setDefaultComponentLoader = (factory)=>{
+    defaultComponentLoader = factory;
+};
+const getDefaultComponentLoader = ()=>defaultComponentLoader;
+export { getDefaultComponentLoader, setDefaultComponentLoader };
+
+//# sourceMappingURL=defaultComponentLoader.js.map

package/componentLoader/defaultComponentLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentLoader/defaultComponentLoader.js","sources":["../../src/componentLoader/defaultComponentLoader.ts"],"sourcesContent":["import type { ComponentLoaderFactory } from \"./ComponentLoader.js\";\n\nlet defaultComponentLoader: ComponentLoaderFactory | undefined;\n\n/**\n * Set the component loader that content clients use when their config has none. A framework\n * integration sets it on import, the way it sets the headers provider.\n */\nexport const setDefaultComponentLoader = (factory: ComponentLoaderFactory | undefined) => {\n    defaultComponentLoader = factory;\n};\n\nexport const getDefaultComponentLoader = () => defaultComponentLoader;\n"],"names":["defaultComponentLoader","setDefaultComponentLoader","factory","getDefaultComponentLoader"],"mappings":"AAEA,IAAIA;AAMG,MAAMC,4BAA4B,CAACC;IACtCF,yBAAyBE;AAC7B;AAEO,MAAMC,4BAA4B,IAAMH"}

package/componentLoader/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./ComponentLoader.js";
+export * from "./RegistryOnlyComponentLoader.js";
+export * from "./defaultComponentLoader.js";

package/componentLoader/index.js

@@ -0,0 +1,3 @@
+export * from "./ComponentLoader.js";
+export * from "./RegistryOnlyComponentLoader.js";
+export * from "./defaultComponentLoader.js";

package/contentClientState.test.d.ts

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