@webiny/website-builder-sdk 6.6.0-alpha.0 → 6.6.0-alpha.2

package/asset/imageSrcSet.js

@@ -0,0 +1,98 @@
+import { getAssetUrl } from "./deliveryUrl.js";
+const IMAGE_RESIZE_WIDTHS = [
+    128,
+    384,
+    640,
+    750,
+    828,
+    1080,
+    1200,
+    1920,
+    2048,
+    3840
+];
+const parseAspectRatio = (input)=>{
+    if (void 0 === input) return;
+    if ("number" == typeof input) return input > 0 ? input : void 0;
+    const trimmed = input.trim();
+    if (trimmed.includes(":")) {
+        const [w, h] = trimmed.split(":").map(Number);
+        return w > 0 && h > 0 ? w / h : void 0;
+    }
+    const n = Number(trimmed);
+    return n > 0 ? n : void 0;
+};
+const toPx = (cssWidth)=>{
+    if (void 0 === cssWidth) return;
+    if ("number" == typeof cssWidth) return cssWidth > 0 ? cssWidth : void 0;
+    const trimmed = cssWidth.trim();
+    if (trimmed.endsWith("px")) {
+        const n = parseInt(trimmed, 10);
+        return n > 0 ? n : void 0;
+    }
+};
+const resolveWidths = (widths, cssWidth)=>{
+    const px = toPx(cssWidth);
+    if (!px) return [
+        ...widths
+    ];
+    const result = [];
+    for (const w of widths){
+        result.push(w);
+        if (w >= 2 * px) break;
+    }
+    return result.length ? result : [
+        widths[widths.length - 1]
+    ];
+};
+const getImageDimensions = (asset, options = {})=>{
+    const img = asset?.image;
+    const iw = img?.width ?? 0;
+    const ih = img?.height ?? 0;
+    if (!iw || !ih) return {
+        width: 0,
+        height: 0
+    };
+    const crop = img?.crop;
+    const width = crop ? Math.round((1 - (crop.left ?? 0) - (crop.right ?? 0)) * iw) : iw;
+    const height = crop ? Math.round((1 - (crop.top ?? 0) - (crop.bottom ?? 0)) * ih) : ih;
+    const ar = parseAspectRatio(options.aspectRatio);
+    if (ar) return {
+        width,
+        height: Math.round(width / ar)
+    };
+    return {
+        width,
+        height
+    };
+};
+const getImageSrcSet = (asset, options = {})=>{
+    const { widths = IMAGE_RESIZE_WIDTHS, cssWidth, ...urlOptions } = options;
+    const dims = getImageDimensions(asset, {
+        aspectRatio: urlOptions.aspectRatio
+    });
+    if (!asset?.src) return {
+        src: "",
+        srcSet: "",
+        width: dims.width,
+        height: dims.height
+    };
+    const selected = resolveWidths(widths, cssWidth);
+    const srcSet = selected.map((w)=>`${getAssetUrl(asset, {
+            ...urlOptions,
+            width: w
+        })} ${w}w`).join(", ");
+    const src = getAssetUrl(asset, {
+        ...urlOptions,
+        width: selected[selected.length - 1]
+    });
+    return {
+        src,
+        srcSet,
+        width: dims.width,
+        height: dims.height
+    };
+};
+export { IMAGE_RESIZE_WIDTHS, getImageDimensions, getImageSrcSet };
+
+//# sourceMappingURL=imageSrcSet.js.map

package/asset/imageSrcSet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset/imageSrcSet.js","sources":["../../src/asset/imageSrcSet.ts"],"sourcesContent":["/**\n * Framework-agnostic responsive-image helpers built on {@link getAssetUrl}.\n *\n * Every renderer (Next.js, React, Vue, Nuxt — and any future Angular / React Native\n * / vanilla adapter) needs the same three things from a `Asset`: a width\n * ladder, a `srcSet` with the per-usage crop/focal/format baked into each width, and\n * the delivered image's intrinsic (cropped) dimensions for layout-shift-free\n * rendering. Keeping that logic here — instead of re-deriving it per framework —\n * makes each renderer a thin adapter over the one delivery-URL contract.\n */\nimport type { Asset } from \"./types.js\";\nimport { getAssetUrl, type AssetUrlOptions } from \"./deliveryUrl.js\";\n\n/**\n * Canonical delivery-width ladder. Kept in lockstep with the server's resize ladder\n * (`imageResizeWidths` in `@webiny/api-file-manager`) so every width a renderer\n * requests snaps to a cached variant instead of forcing a fresh transform.\n */\nexport const IMAGE_RESIZE_WIDTHS = [128, 384, 640, 750, 828, 1080, 1200, 1920, 2048, 3840] as const;\n\n/** Parse an aspect ratio given as a number, a `\"w:h\"` string, or a decimal string. */\nconst parseAspectRatio = (input: number | string | undefined): number | undefined => {\n    if (input === undefined) {\n        return undefined;\n    }\n    if (typeof input === \"number\") {\n        return input > 0 ? input : undefined;\n    }\n    const trimmed = input.trim();\n    if (trimmed.includes(\":\")) {\n        const [w, h] = trimmed.split(\":\").map(Number);\n        return w > 0 && h > 0 ? w / h : undefined;\n    }\n    const n = Number(trimmed);\n    return n > 0 ? n : undefined;\n};\n\n/** Resolve a fixed CSS width to pixels, or `undefined` for fluid widths (`%`, `vw`, …). */\nconst toPx = (cssWidth: number | string | undefined): number | undefined => {\n    if (cssWidth === undefined) {\n        return undefined;\n    }\n    if (typeof cssWidth === \"number\") {\n        return cssWidth > 0 ? cssWidth : undefined;\n    }\n    const trimmed = cssWidth.trim();\n    if (trimmed.endsWith(\"px\")) {\n        const n = parseInt(trimmed, 10);\n        return n > 0 ? n : undefined;\n    }\n    return undefined;\n};\n\n/**\n * Trim the ladder to the smallest set that still covers a fixed CSS width, including\n * one step past `2×` for high-DPR screens. Fluid widths use the full ladder.\n */\nconst resolveWidths = (\n    widths: readonly number[],\n    cssWidth: number | string | undefined\n): number[] => {\n    const px = toPx(cssWidth);\n    if (!px) {\n        return [...widths];\n    }\n    const result: number[] = [];\n    for (const w of widths) {\n        result.push(w);\n        if (w >= px * 2) {\n            break;\n        }\n    }\n    return result.length ? result : [widths[widths.length - 1]];\n};\n\nexport interface ImageDimensions {\n    /** Delivered (cropped) width in pixels, or `0` when the intrinsic size is unknown. */\n    width: number;\n    /** Delivered (cropped) height in pixels, or `0` when the intrinsic size is unknown. */\n    height: number;\n}\n\n/**\n * The intrinsic dimensions of the *delivered* image — i.e. after the per-usage crop\n * (and an optional target aspect ratio) are applied. Renderers pass these to their\n * layout primitive (e.g. `next/image`'s `width`/`height`) so the box reserves the\n * right space and the page doesn't shift as the image loads. Returns `0`/`0` when the\n * asset's intrinsic size is unknown.\n */\nexport const getImageDimensions = (\n    asset: Pick<Asset, \"image\"> | null | undefined,\n    options: { aspectRatio?: number | string } = {}\n): ImageDimensions => {\n    const img = asset?.image;\n    const iw = img?.width ?? 0;\n    const ih = img?.height ?? 0;\n    if (!iw || !ih) {\n        return { width: 0, height: 0 };\n    }\n    const crop = img?.crop;\n    const width = crop ? Math.round((1 - (crop.left ?? 0) - (crop.right ?? 0)) * iw) : iw;\n    const height = crop ? Math.round((1 - (crop.top ?? 0) - (crop.bottom ?? 0)) * ih) : ih;\n\n    const ar = parseAspectRatio(options.aspectRatio);\n    if (ar) {\n        // Framed to a fixed ratio server-side: keep the cropped width, derive height.\n        return { width, height: Math.round(width / ar) };\n    }\n    return { width, height };\n};\n\nexport interface ImageSrcSetOptions extends Omit<AssetUrlOptions, \"width\"> {\n    /** Widths to emit. Defaults to {@link IMAGE_RESIZE_WIDTHS}, trimmed by `cssWidth`. */\n    widths?: readonly number[];\n    /**\n     * A fixed CSS width for the rendered image (`\"320px\"` or `320`). When set, the\n     * ladder is trimmed to the smallest set that still covers it (incl. high-DPR);\n     * fluid widths (`%`, `vw`, unset) use the full ladder.\n     */\n    cssWidth?: number | string;\n}\n\nexport interface ImageSrcSet {\n    /** Single-URL fallback for clients that ignore `srcSet` (the largest emitted width). */\n    src: string;\n    /** `\"<url> 128w, <url> 384w, …\"` — crop/focal/format baked into every width. */\n    srcSet: string;\n    /** Delivered (cropped) intrinsic dimensions; `0` when unknown. */\n    width: number;\n    height: number;\n}\n\n/**\n * Build the responsive descriptor for an asset: a `srcSet` across the width ladder\n * (each entry a delivery URL with the per-usage crop/focal/format baked in), a\n * single-URL `src` fallback, and the delivered dimensions. Framework-agnostic — hand\n * `src`/`srcSet` to any `<img>`-like primitive. Returns empty strings for a missing\n * asset.\n */\nexport const getImageSrcSet = (\n    asset: (Pick<Asset, \"src\" | \"image\"> & { src?: string }) | null | undefined,\n    options: ImageSrcSetOptions = {}\n): ImageSrcSet => {\n    const { widths = IMAGE_RESIZE_WIDTHS, cssWidth, ...urlOptions } = options;\n    const dims = getImageDimensions(asset, { aspectRatio: urlOptions.aspectRatio });\n\n    if (!asset?.src) {\n        return { src: \"\", srcSet: \"\", width: dims.width, height: dims.height };\n    }\n\n    const selected = resolveWidths(widths, cssWidth);\n    const srcSet = selected\n        .map(w => `${getAssetUrl(asset, { ...urlOptions, width: w })} ${w}w`)\n        .join(\", \");\n    const src = getAssetUrl(asset, { ...urlOptions, width: selected[selected.length - 1] });\n\n    return { src, srcSet, width: dims.width, height: dims.height };\n};\n"],"names":["IMAGE_RESIZE_WIDTHS","parseAspectRatio","input","undefined","trimmed","w","h","Number","n","toPx","cssWidth","parseInt","resolveWidths","widths","px","result","getImageDimensions","asset","options","img","iw","ih","crop","width","Math","height","ar","getImageSrcSet","urlOptions","dims","selected","srcSet","getAssetUrl","src"],"mappings":"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"}

package/asset/imageSrcSet.test.d.ts

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

package/asset/imageSrcSet.test.js

@@ -0,0 +1,103 @@
+import { describe, expect, it } from "vitest";
+import { IMAGE_RESIZE_WIDTHS, getImageDimensions, getImageSrcSet } from "./imageSrcSet.js";
+const asset = (image)=>({
+        id: "f",
+        src: "https://cdn/x/pic.jpg",
+        name: "pic.jpg",
+        type: "image/jpeg",
+        size: 1,
+        image: {
+            width: 800,
+            height: 600,
+            ...image
+        }
+    });
+describe("getImageDimensions", ()=>{
+    it("returns intrinsic dimensions when there is no crop", ()=>{
+        expect(getImageDimensions(asset())).toEqual({
+            width: 800,
+            height: 600
+        });
+    });
+    it("shrinks by the crop insets", ()=>{
+        expect(getImageDimensions(asset({
+            crop: {
+                top: 0.1,
+                left: 0.25,
+                bottom: 0.1,
+                right: 0.25
+            }
+        }))).toEqual({
+            width: 400,
+            height: 480
+        });
+    });
+    it("derives height from a target aspect ratio", ()=>{
+        expect(getImageDimensions(asset({
+            crop: {
+                top: 0,
+                left: 0.25,
+                bottom: 0,
+                right: 0.25
+            }
+        }), {
+            aspectRatio: "16:9"
+        })).toEqual({
+            width: 400,
+            height: 225
+        });
+    });
+    it("returns 0/0 when the intrinsic size is unknown", ()=>{
+        expect(getImageDimensions({
+            image: {}
+        })).toEqual({
+            width: 0,
+            height: 0
+        });
+        expect(getImageDimensions(null)).toEqual({
+            width: 0,
+            height: 0
+        });
+    });
+});
+describe("getImageSrcSet", ()=>{
+    it("emits the full ladder with crop + format baked into every width", ()=>{
+        const { srcSet, width, height } = getImageSrcSet(asset({
+            crop: {
+                top: 0.1,
+                left: 0,
+                bottom: 0,
+                right: 0
+            }
+        }), {
+            format: "auto"
+        });
+        const entries = srcSet.split(", ");
+        expect(entries).toHaveLength(IMAGE_RESIZE_WIDTHS.length);
+        expect(entries[0]).toBe("https://cdn/x/pic.jpg?crop=0.1,0,0,0&width=128&format=auto 128w");
+        expect(width).toBe(800);
+        expect(height).toBe(540);
+    });
+    it("trims the ladder to a fixed CSS width (incl. 2x DPR)", ()=>{
+        const { srcSet, src } = getImageSrcSet(asset(), {
+            cssWidth: "300px"
+        });
+        const widths = srcSet.split(", ").map((e)=>Number(e.match(/width=(\d+)/)[1]));
+        expect(widths).toEqual([
+            128,
+            384,
+            640
+        ]);
+        expect(src).toBe("https://cdn/x/pic.jpg?width=640");
+    });
+    it("returns empty strings for a missing asset", ()=>{
+        expect(getImageSrcSet(null)).toEqual({
+            src: "",
+            srcSet: "",
+            width: 0,
+            height: 0
+        });
+    });
+});
+
+//# sourceMappingURL=imageSrcSet.test.js.map

package/asset/imageSrcSet.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset/imageSrcSet.test.js","sources":["../../src/asset/imageSrcSet.test.ts"],"sourcesContent":["import { describe, it, expect } from \"vitest\";\nimport { IMAGE_RESIZE_WIDTHS, getImageDimensions, getImageSrcSet } from \"./imageSrcSet.js\";\n\nconst asset = (image?: any) => ({\n    id: \"f\",\n    src: \"https://cdn/x/pic.jpg\",\n    name: \"pic.jpg\",\n    type: \"image/jpeg\",\n    size: 1,\n    image: { width: 800, height: 600, ...image }\n});\n\ndescribe(\"getImageDimensions\", () => {\n    it(\"returns intrinsic dimensions when there is no crop\", () => {\n        expect(getImageDimensions(asset())).toEqual({ width: 800, height: 600 });\n    });\n\n    it(\"shrinks by the crop insets\", () => {\n        expect(\n            getImageDimensions(asset({ crop: { top: 0.1, left: 0.25, bottom: 0.1, right: 0.25 } }))\n        ).toEqual({ width: 400, height: 480 });\n    });\n\n    it(\"derives height from a target aspect ratio\", () => {\n        // Cropped width 400 @ 16:9 -> height 225.\n        expect(\n            getImageDimensions(asset({ crop: { top: 0, left: 0.25, bottom: 0, right: 0.25 } }), {\n                aspectRatio: \"16:9\"\n            })\n        ).toEqual({ width: 400, height: 225 });\n    });\n\n    it(\"returns 0/0 when the intrinsic size is unknown\", () => {\n        expect(getImageDimensions({ image: {} })).toEqual({ width: 0, height: 0 });\n        expect(getImageDimensions(null)).toEqual({ width: 0, height: 0 });\n    });\n});\n\ndescribe(\"getImageSrcSet\", () => {\n    it(\"emits the full ladder with crop + format baked into every width\", () => {\n        const { srcSet, width, height } = getImageSrcSet(\n            asset({ crop: { top: 0.1, left: 0, bottom: 0, right: 0 } }),\n            { format: \"auto\" }\n        );\n        const entries = srcSet.split(\", \");\n        expect(entries).toHaveLength(IMAGE_RESIZE_WIDTHS.length);\n        expect(entries[0]).toBe(\"https://cdn/x/pic.jpg?crop=0.1,0,0,0&width=128&format=auto 128w\");\n        expect(width).toBe(800);\n        expect(height).toBe(540);\n    });\n\n    it(\"trims the ladder to a fixed CSS width (incl. 2x DPR)\", () => {\n        const { srcSet, src } = getImageSrcSet(asset(), { cssWidth: \"300px\" });\n        const widths = srcSet.split(\", \").map(e => Number(e.match(/width=(\\d+)/)![1]));\n        // Smallest set covering 300px up to 2x (600) -> 128, 384, 640.\n        expect(widths).toEqual([128, 384, 640]);\n        // `src` fallback is the largest emitted width.\n        expect(src).toBe(\"https://cdn/x/pic.jpg?width=640\");\n    });\n\n    it(\"returns empty strings for a missing asset\", () => {\n        expect(getImageSrcSet(null)).toEqual({ src: \"\", srcSet: \"\", width: 0, height: 0 });\n    });\n});\n"],"names":["asset","image","describe","it","expect","getImageDimensions","srcSet","width","height","getImageSrcSet","entries","IMAGE_RESIZE_WIDTHS","src","widths","e","Number"],"mappings":";;AAGA,MAAMA,QAAQ,CAACC,QAAiB;QAC5B,IAAI;QACJ,KAAK;QACL,MAAM;QACN,MAAM;QACN,MAAM;QACN,OAAO;YAAE,OAAO;YAAK,QAAQ;YAAK,GAAGA,KAAK;QAAC;IAC/C;AAEAC,SAAS,sBAAsB;IAC3BC,GAAG,sDAAsD;QACrDC,OAAOC,mBAAmBL,UAAU,OAAO,CAAC;YAAE,OAAO;YAAK,QAAQ;QAAI;IAC1E;IAEAG,GAAG,8BAA8B;QAC7BC,OACIC,mBAAmBL,MAAM;YAAE,MAAM;gBAAE,KAAK;gBAAK,MAAM;gBAAM,QAAQ;gBAAK,OAAO;YAAK;QAAE,KACtF,OAAO,CAAC;YAAE,OAAO;YAAK,QAAQ;QAAI;IACxC;IAEAG,GAAG,6CAA6C;QAE5CC,OACIC,mBAAmBL,MAAM;YAAE,MAAM;gBAAE,KAAK;gBAAG,MAAM;gBAAM,QAAQ;gBAAG,OAAO;YAAK;QAAE,IAAI;YAChF,aAAa;QACjB,IACF,OAAO,CAAC;YAAE,OAAO;YAAK,QAAQ;QAAI;IACxC;IAEAG,GAAG,kDAAkD;QACjDC,OAAOC,mBAAmB;YAAE,OAAO,CAAC;QAAE,IAAI,OAAO,CAAC;YAAE,OAAO;YAAG,QAAQ;QAAE;QACxED,OAAOC,mBAAmB,OAAO,OAAO,CAAC;YAAE,OAAO;YAAG,QAAQ;QAAE;IACnE;AACJ;AAEAH,SAAS,kBAAkB;IACvBC,GAAG,mEAAmE;QAClE,MAAM,EAAEG,MAAM,EAAEC,KAAK,EAAEC,MAAM,EAAE,GAAGC,eAC9BT,MAAM;YAAE,MAAM;gBAAE,KAAK;gBAAK,MAAM;gBAAG,QAAQ;gBAAG,OAAO;YAAE;QAAE,IACzD;YAAE,QAAQ;QAAO;QAErB,MAAMU,UAAUJ,OAAO,KAAK,CAAC;QAC7BF,OAAOM,SAAS,YAAY,CAACC,oBAAoB,MAAM;QACvDP,OAAOM,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC;QACxBN,OAAOG,OAAO,IAAI,CAAC;QACnBH,OAAOI,QAAQ,IAAI,CAAC;IACxB;IAEAL,GAAG,wDAAwD;QACvD,MAAM,EAAEG,MAAM,EAAEM,GAAG,EAAE,GAAGH,eAAeT,SAAS;YAAE,UAAU;QAAQ;QACpE,MAAMa,SAASP,OAAO,KAAK,CAAC,MAAM,GAAG,CAACQ,CAAAA,IAAKC,OAAOD,EAAE,KAAK,CAAC,cAAe,CAAC,EAAE;QAE5EV,OAAOS,QAAQ,OAAO,CAAC;YAAC;YAAK;YAAK;SAAI;QAEtCT,OAAOQ,KAAK,IAAI,CAAC;IACrB;IAEAT,GAAG,6CAA6C;QAC5CC,OAAOK,eAAe,OAAO,OAAO,CAAC;YAAE,KAAK;YAAI,QAAQ;YAAI,OAAO;YAAG,QAAQ;QAAE;IACpF;AACJ"}

package/asset/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./types.js";
+export * from "./normalize.js";
+export * from "./geometry.js";
+export * from "./deliveryUrl.js";
+export * from "./imageSrcSet.js";

package/asset/index.js

@@ -0,0 +1,5 @@
+export * from "./types.js";
+export * from "./normalize.js";
+export * from "./geometry.js";
+export * from "./deliveryUrl.js";
+export * from "./imageSrcSet.js";

package/asset/normalize.d.ts

@@ -0,0 +1,24 @@
+import type { Asset, AssetCategory, AssetImage } from "./types.js";
+export declare function getAssetCategory(type?: string | null): AssetCategory;
+interface LegacyImageEdit {
+    crop?: {
+        top: number;
+        left: number;
+        bottom: number;
+        right: number;
+    };
+    hotspot?: {
+        x: number;
+        y: number;
+        width?: number;
+        height?: number;
+    };
+    alt?: string;
+    caption?: string;
+}
+export declare function assetImageFromLegacyEdit(edit?: LegacyImageEdit | null, dimensions?: {
+    width?: number | null;
+    height?: number | null;
+}): AssetImage | undefined;
+export declare function normalizeToAsset(input: unknown): Asset | null;
+export {};

package/asset/normalize.js

@@ -0,0 +1,102 @@
+function getAssetCategory(type) {
+    if ("string" == typeof type) {
+        if (type.startsWith("image/")) return "image";
+        if (type.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, type)=>{
+    const src = asString(raw.src) ?? "";
+    return {
+        id: asString(raw.id) ?? "",
+        src,
+        url: asString(raw.url) ?? src,
+        name: asString(raw.name) ?? "",
+        type,
+        size: asNumber(raw.size) ?? 0
+    };
+};
+function normalizeToAsset(input) {
+    if (!isObject(input)) return null;
+    const hasTypedSubObject = isObject(input.image) || isObject(input.document) || isObject(input.video);
+    if (!hasTypedSubObject) {
+        const type = asString(input.mimeType) ?? asString(input.type) ?? "";
+        const asset = buildBase(input, type);
+        if ("image" === getAssetCategory(type)) {
+            const image = assetImageFromLegacyEdit(input.edit, {
+                width: asNumber(input.width),
+                height: asNumber(input.height)
+            });
+            if (image) asset.image = image;
+        }
+        return asset;
+    }
+    const type = asString(input.type) ?? asString(input.mimeType) ?? "";
+    const asset = buildBase(input, type);
+    const category = getAssetCategory(type);
+    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 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(type?: string | null): AssetCategory {\n    if (typeof type === \"string\") {\n        if (type.startsWith(\"image/\")) {\n            return \"image\";\n        }\n        if (type.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>, type: 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        type,\n        size: asNumber(raw.size) ?? 0\n    };\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    if (!hasTypedSubObject) {\n        const type = asString(input.mimeType) ?? asString(input.type) ?? \"\";\n        const asset = buildBase(input, type);\n        if (getAssetCategory(type) === \"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 asset;\n    }\n\n    const type = asString(input.type) ?? asString(input.mimeType) ?? \"\";\n    const asset = buildBase(input, type);\n    const category = getAssetCategory(type);\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 asset;\n}\n"],"names":["getAssetCategory","type","isObject","value","asNumber","Number","undefined","asString","assetImageFromLegacyEdit","edit","dimensions","image","width","height","Object","normalizeAssetImage","raw","x","y","alt","caption","buildBase","src","normalizeToAsset","input","hasTypedSubObject","asset","category"],"mappings":"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"}

package/asset/normalize.test.d.ts

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

package/asset/normalize.test.js

@@ -0,0 +1,256 @@
+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("upgrades mimeType -> type and edit -> image", ()=>{
+        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",
+            type: "image/jpeg",
+            size: 1234,
+            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 an original flat WB file value (type + top-level dims, no edit)", ()=>{
+        const asset = normalizeToAsset({
+            id: "f",
+            src: "https://cdn/x.jpg",
+            name: "x.jpg",
+            type: "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",
+            type: "image/jpeg",
+            size: 10,
+            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?.type).toBe("application/pdf");
+        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",
+            type: "image/png",
+            size: 9,
+            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",
+            type: "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