@riverbankcms/sdk 0.152.0 → 0.153.0

package/dist/_dts/media-core/src/media.d.ts

@@ -0,0 +1,406 @@
+import { z } from 'zod';
+import { type MediaTypeDiscriminant } from './mediaKinds';
+export { mediaIdentifierSchema } from './mediaIdentifierSchema';
+export type { MediaIdentifier } from './identifiers';
+export { mediaTypeDiscriminants, type MediaTypeDiscriminant } from './mediaKinds';
+export declare const mediaPosterSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    tag: z.ZodLiteral<"media">;
+    identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+}, z.core.$strict>, z.ZodObject<{
+    tag: z.ZodLiteral<"external-src">;
+    src: z.ZodString;
+}, z.core.$strict>], "tag">;
+declare const mediaUsageShape: {
+    purpose: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    alt: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    poster: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        tag: z.ZodLiteral<"media">;
+        identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    }, z.core.$strict>, z.ZodObject<{
+        tag: z.ZodLiteral<"external-src">;
+        src: z.ZodString;
+    }, z.core.$strict>], "tag">>;
+    transform: z.ZodOptional<z.ZodObject<{
+        aspectCrops: z.ZodOptional<z.ZodPipe<z.ZodTransform<object | undefined, unknown>, z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodObject<{
+            aspect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+            rect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>>;
+            hotspot: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                radius: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            rotation: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>>;
+        }, z.core.$strip>>>>>;
+        rect: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        hotspot: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            radius: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        rotation: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>;
+    }, z.core.$strip>>;
+};
+declare const mediaBaseSchema: z.ZodObject<{
+    identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    assetId: z.ZodOptional<z.ZodNever>;
+    id: z.ZodOptional<z.ZodNever>;
+    src: z.ZodOptional<z.ZodNever>;
+    storageBucket: z.ZodOptional<z.ZodNever>;
+    storagePath: z.ZodOptional<z.ZodNever>;
+    mimeType: z.ZodOptional<z.ZodNever>;
+    purpose: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    alt: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    poster: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        tag: z.ZodLiteral<"media">;
+        identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    }, z.core.$strict>, z.ZodObject<{
+        tag: z.ZodLiteral<"external-src">;
+        src: z.ZodString;
+    }, z.core.$strict>], "tag">>;
+    transform: z.ZodOptional<z.ZodObject<{
+        aspectCrops: z.ZodOptional<z.ZodPipe<z.ZodTransform<object | undefined, unknown>, z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodObject<{
+            aspect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+            rect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>>;
+            hotspot: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                radius: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            rotation: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>>;
+        }, z.core.$strip>>>>>;
+        rect: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        hotspot: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            radius: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        rotation: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export declare const imageMediaSchema: z.ZodObject<{
+    identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    assetId: z.ZodOptional<z.ZodNever>;
+    id: z.ZodOptional<z.ZodNever>;
+    src: z.ZodOptional<z.ZodNever>;
+    storageBucket: z.ZodOptional<z.ZodNever>;
+    storagePath: z.ZodOptional<z.ZodNever>;
+    mimeType: z.ZodOptional<z.ZodNever>;
+    purpose: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    alt: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    poster: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        tag: z.ZodLiteral<"media">;
+        identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    }, z.core.$strict>, z.ZodObject<{
+        tag: z.ZodLiteral<"external-src">;
+        src: z.ZodString;
+    }, z.core.$strict>], "tag">>;
+    transform: z.ZodOptional<z.ZodObject<{
+        aspectCrops: z.ZodOptional<z.ZodPipe<z.ZodTransform<object | undefined, unknown>, z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodObject<{
+            aspect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+            rect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>>;
+            hotspot: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                radius: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            rotation: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>>;
+        }, z.core.$strip>>>>>;
+        rect: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        hotspot: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            radius: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        rotation: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>;
+    }, z.core.$strip>>;
+    type: z.ZodLiteral<"image">;
+}, z.core.$strict>;
+export declare const videoMediaSchema: z.ZodObject<{
+    identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    assetId: z.ZodOptional<z.ZodNever>;
+    id: z.ZodOptional<z.ZodNever>;
+    src: z.ZodOptional<z.ZodNever>;
+    storageBucket: z.ZodOptional<z.ZodNever>;
+    storagePath: z.ZodOptional<z.ZodNever>;
+    mimeType: z.ZodOptional<z.ZodNever>;
+    purpose: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    alt: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    poster: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        tag: z.ZodLiteral<"media">;
+        identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    }, z.core.$strict>, z.ZodObject<{
+        tag: z.ZodLiteral<"external-src">;
+        src: z.ZodString;
+    }, z.core.$strict>], "tag">>;
+    transform: z.ZodOptional<z.ZodObject<{
+        aspectCrops: z.ZodOptional<z.ZodPipe<z.ZodTransform<object | undefined, unknown>, z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodObject<{
+            aspect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+            rect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>>;
+            hotspot: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                radius: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            rotation: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>>;
+        }, z.core.$strip>>>>>;
+        rect: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        hotspot: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            radius: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        rotation: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>;
+    }, z.core.$strip>>;
+    type: z.ZodLiteral<"video">;
+}, z.core.$strict>;
+type ManagedMediaFields = z.infer<typeof mediaBaseSchema>;
+export type MediaOfType<TType extends MediaTypeDiscriminant> = ManagedMediaFields & {
+    type: TType;
+};
+export type Media = {
+    [TType in MediaTypeDiscriminant]: MediaOfType<TType>;
+}[MediaTypeDiscriminant];
+export declare const mediaSchema: z.ZodType<Media>;
+export declare const persistableMediaSchema: z.ZodType<Media, unknown, z.core.$ZodTypeInternals<Media, unknown>>;
+export declare const externalMediaSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        image: "image";
+        video: "video";
+        audio: "audio";
+        document: "document";
+        spreadsheet: "spreadsheet";
+        archive: "archive";
+    }>;
+    src: z.ZodString;
+    identifier: z.ZodOptional<z.ZodNever>;
+    assetId: z.ZodOptional<z.ZodNever>;
+    id: z.ZodOptional<z.ZodNever>;
+    storageBucket: z.ZodOptional<z.ZodNever>;
+    storagePath: z.ZodOptional<z.ZodNever>;
+    mimeType: z.ZodOptional<z.ZodNever>;
+    purpose: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    alt: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    poster: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        tag: z.ZodLiteral<"media">;
+        identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    }, z.core.$strict>, z.ZodObject<{
+        tag: z.ZodLiteral<"external-src">;
+        src: z.ZodString;
+    }, z.core.$strict>], "tag">>;
+    transform: z.ZodOptional<z.ZodObject<{
+        aspectCrops: z.ZodOptional<z.ZodPipe<z.ZodTransform<object | undefined, unknown>, z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodObject<{
+            aspect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+            rect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>>;
+            hotspot: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                radius: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            rotation: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>>;
+        }, z.core.$strip>>>>>;
+        rect: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        hotspot: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            radius: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        rotation: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export type PersistableMedia = Media;
+export type ExternalMedia = z.infer<typeof externalMediaSchema>;
+export type MediaPoster = z.infer<typeof mediaPosterSchema>;
+export type MediaUsage = z.infer<z.ZodObject<typeof mediaUsageShape>>;
+export declare const assetMediaSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        image: "image";
+        video: "video";
+        audio: "audio";
+        document: "document";
+        spreadsheet: "spreadsheet";
+        archive: "archive";
+    }>;
+    asset: z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../core/src/index").MediaAssetId, string>>;
+        identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+        storageBucket: z.ZodString;
+        storagePath: z.ZodString;
+        mimeType: z.ZodString;
+        filename: z.ZodOptional<z.ZodString>;
+        width: z.ZodNullable<z.ZodNumber>;
+        height: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    identifier: z.ZodOptional<z.ZodNever>;
+    assetId: z.ZodOptional<z.ZodNever>;
+    id: z.ZodOptional<z.ZodNever>;
+    src: z.ZodOptional<z.ZodNever>;
+    storageBucket: z.ZodOptional<z.ZodNever>;
+    storagePath: z.ZodOptional<z.ZodNever>;
+    mimeType: z.ZodOptional<z.ZodNever>;
+    purpose: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    alt: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    poster: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        tag: z.ZodLiteral<"media">;
+        identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    }, z.core.$strict>, z.ZodObject<{
+        tag: z.ZodLiteral<"external-src">;
+        src: z.ZodString;
+    }, z.core.$strict>], "tag">>;
+    transform: z.ZodOptional<z.ZodObject<{
+        aspectCrops: z.ZodOptional<z.ZodPipe<z.ZodTransform<object | undefined, unknown>, z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodObject<{
+            aspect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+            rect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>>;
+            hotspot: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                radius: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            rotation: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>>;
+        }, z.core.$strip>>>>>;
+        rect: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        hotspot: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            radius: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        rotation: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export declare const runtimeMediaSchema: z.ZodUnion<readonly [z.ZodType<Media, unknown, z.core.$ZodTypeInternals<Media, unknown>>, z.ZodObject<{
+    type: z.ZodEnum<{
+        image: "image";
+        video: "video";
+        audio: "audio";
+        document: "document";
+        spreadsheet: "spreadsheet";
+        archive: "archive";
+    }>;
+    src: z.ZodString;
+    identifier: z.ZodOptional<z.ZodNever>;
+    assetId: z.ZodOptional<z.ZodNever>;
+    id: z.ZodOptional<z.ZodNever>;
+    storageBucket: z.ZodOptional<z.ZodNever>;
+    storagePath: z.ZodOptional<z.ZodNever>;
+    mimeType: z.ZodOptional<z.ZodNever>;
+    purpose: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    alt: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    poster: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        tag: z.ZodLiteral<"media">;
+        identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    }, z.core.$strict>, z.ZodObject<{
+        tag: z.ZodLiteral<"external-src">;
+        src: z.ZodString;
+    }, z.core.$strict>], "tag">>;
+    transform: z.ZodOptional<z.ZodObject<{
+        aspectCrops: z.ZodOptional<z.ZodPipe<z.ZodTransform<object | undefined, unknown>, z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodObject<{
+            aspect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+            rect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>>;
+            hotspot: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                radius: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            rotation: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>>;
+        }, z.core.$strip>>>>>;
+        rect: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        hotspot: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            radius: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        rotation: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>;
+    }, z.core.$strip>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodEnum<{
+        image: "image";
+        video: "video";
+        audio: "audio";
+        document: "document";
+        spreadsheet: "spreadsheet";
+        archive: "archive";
+    }>;
+    asset: z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../core/src/index").MediaAssetId, string>>;
+        identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+        storageBucket: z.ZodString;
+        storagePath: z.ZodString;
+        mimeType: z.ZodString;
+        filename: z.ZodOptional<z.ZodString>;
+        width: z.ZodNullable<z.ZodNumber>;
+        height: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    identifier: z.ZodOptional<z.ZodNever>;
+    assetId: z.ZodOptional<z.ZodNever>;
+    id: z.ZodOptional<z.ZodNever>;
+    src: z.ZodOptional<z.ZodNever>;
+    storageBucket: z.ZodOptional<z.ZodNever>;
+    storagePath: z.ZodOptional<z.ZodNever>;
+    mimeType: z.ZodOptional<z.ZodNever>;
+    purpose: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    alt: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    poster: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        tag: z.ZodLiteral<"media">;
+        identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    }, z.core.$strict>, z.ZodObject<{
+        tag: z.ZodLiteral<"external-src">;
+        src: z.ZodString;
+    }, z.core.$strict>], "tag">>;
+    transform: z.ZodOptional<z.ZodObject<{
+        aspectCrops: z.ZodOptional<z.ZodPipe<z.ZodTransform<object | undefined, unknown>, z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodObject<{
+            aspect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodString>>;
+            rect: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>>;
+            hotspot: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                radius: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            rotation: z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>>;
+        }, z.core.$strip>>>>>;
+        rect: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        hotspot: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            radius: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        rotation: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>]>>;
+    }, z.core.$strip>>;
+}, z.core.$strict>]>;
+export type AssetMedia = z.infer<typeof assetMediaSchema>;
+export type RuntimeMedia = z.infer<typeof runtimeMediaSchema>;
+export type RuntimeMediaOfType<TType extends MediaTypeDiscriminant> = MediaOfType<TType> | (ExternalMedia & {
+    type: TType;
+}) | (AssetMedia & {
+    type: TType;
+});

package/dist/_dts/media-core/src/mediaIdentifierSchema.d.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+/** Strict stored-reference admission delegates the canonical identifier decision. */
+export declare const mediaIdentifierSchema: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;

package/dist/_dts/media-core/src/mediaKinds.d.ts

@@ -0,0 +1,2 @@
+export declare const mediaTypeDiscriminants: readonly ["image", "video", "audio", "document", "spreadsheet", "archive"];
+export type MediaTypeDiscriminant = (typeof mediaTypeDiscriminants)[number];

package/dist/_dts/media-core/src/mediaUsageProjection.d.ts

@@ -104,7 +104,19 @@ export type ProductFileDownloadMediaUsageLocation = Readonly<{
     productId: string;
     productTitle: string;
 }>;
-export type MediaUsageLocationProjection = PageBlockMediaUsageLocation | EntrySlotBlockMediaUsageLocation | SurfaceSlotBlockMediaUsageLocation | ContentEntryMediaUsageLocation | ProductFileDownloadMediaUsageLocation;
+export type NewsletterTemplateMediaUsageLocation = Readonly<{
+    kind: 'newsletterTemplate';
+    siteId: string;
+    templateId: string;
+    templateName: string;
+}>;
+export type NewsletterCampaignMediaUsageLocation = Readonly<{
+    kind: 'newsletterCampaign';
+    siteId: string;
+    campaignId: string;
+    campaignName: string;
+}>;
+export type MediaUsageLocationProjection = PageBlockMediaUsageLocation | EntrySlotBlockMediaUsageLocation | SurfaceSlotBlockMediaUsageLocation | ContentEntryMediaUsageLocation | ProductFileDownloadMediaUsageLocation | NewsletterTemplateMediaUsageLocation | NewsletterCampaignMediaUsageLocation;
 export type MediaUsageCheckItemProjection = Readonly<{
     assetId: string;
     filename: string | null;

package/dist/_dts/media-core/src/mediaWriteNormalizer.d.ts

@@ -8,11 +8,7 @@ export type NormalizeMediaReferencesForWriteCoreOptions = Readonly<{
     value: unknown;
     resolveMediaAssetsById: (assetIds: readonly string[]) => Promise<readonly MediaIdentifierResolutionRecord[]>;
 }>;
-/**
- * Normalizes CMS media objects to identifier-only persistence. Infrastructure
- * concerns stay behind callbacks so this core workflow can run outside the
- * dashboard app.
- *
- * @mutates options.value (and nested objects) in-place.
+/** Projects explicit write candidates; stored reads never use this conversion.
+ * @mutates options.value in-place only after classification, lookup and validation succeed.
  */
 export declare function normalizeMediaReferencesForWriteCore(options: NormalizeMediaReferencesForWriteCoreOptions): Promise<void>;

package/dist/_dts/media-core/src/portableMediaReferences.d.ts

@@ -1,36 +1,23 @@
-type PortableMediaReferenceSource = 'media-field' | 'rich-text-image';
+import type { MediaIdentifier } from './identifiers';
+import { type ManagedMediaResolution } from './renderableMediaAsset';
 export type PortableMediaReference = Readonly<{
-    kind: 'assetId';
-    assetId: string;
-    location: string;
-    source: PortableMediaReferenceSource;
-} | {
     kind: 'identifier';
-    identifier: string;
+    identifier: MediaIdentifier;
     location: string;
-    source: PortableMediaReferenceSource;
+    source: 'media-field' | 'rich-text-image' | 'media-poster';
 }>;
 export type PortableMediaReferenceSummary = Readonly<{
     references: PortableMediaReference[];
-    assetIds: string[];
-    identifiers: string[];
+    identifiers: MediaIdentifier[];
 }>;
 type PortableMediaLookupAsset = Readonly<{
     id: string;
-    identifier?: string | null;
+    identifier: MediaIdentifier;
 }>;
 type PortableMediaLookup<TAsset extends PortableMediaLookupAsset> = Readonly<{
-    byId: Map<string, TAsset>;
-    byIdentifier: Map<string, TAsset>;
-}>;
-export type PortableMediaResolution<TAsset extends PortableMediaLookupAsset> = Readonly<{
-    kind: 'resolved';
-    reference: PortableMediaReference;
-    asset: TAsset;
-} | {
-    kind: 'missing';
-    reference: PortableMediaReference;
+    byIdentifier: ReadonlyMap<MediaIdentifier, TAsset>;
 }>;
+export type PortableMediaResolution<TAsset extends PortableMediaLookupAsset> = ManagedMediaResolution<PortableMediaReference, TAsset>;
 export declare function summarizePortableMediaReferences(references: readonly PortableMediaReference[]): PortableMediaReferenceSummary;
 export declare function collectPortableMediaReferencesFromContent(content: unknown): PortableMediaReferenceSummary;
 export declare function buildPortableMediaLookup<TAsset extends PortableMediaLookupAsset>(assets: readonly TAsset[]): PortableMediaLookup<TAsset>;

package/dist/_dts/media-core/src/renderableMediaAsset.d.ts

@@ -1,18 +1,32 @@
 import type { MediaAssetId } from '../../core/src/index';
-export type RenderableMediaAsset = Readonly<{
-    id: MediaAssetId;
-    identifier?: string | null;
-    storageBucket?: string;
-    storagePath?: string;
-    width?: number | null;
-    height?: number | null;
-    mimeType?: string;
-}>;
+import type { MediaIdentifier } from './identifiers';
+import type { RenderableMediaAsset } from './renderableMediaAssetAdmission';
+export type { RenderableMediaAsset } from './renderableMediaAssetAdmission';
 export type RenderableMediaAssetIndex = Readonly<{
-    byId: ReadonlyMap<string, RenderableMediaAsset>;
-    byIdentifier: ReadonlyMap<string, RenderableMediaAsset>;
+    byId: ReadonlyMap<MediaAssetId, RenderableMediaAsset>;
+    byIdentifier: ReadonlyMap<MediaIdentifier, RenderableMediaAsset>;
 }>;
-export declare function buildRenderableMediaAssetIndex(assets: readonly RenderableMediaAsset[] | undefined): RenderableMediaAssetIndex | undefined;
-export declare function attachRenderableMediaAssetFields<TMedia extends Readonly<Record<string, unknown>>>(media: TMedia, asset: RenderableMediaAsset): TMedia & RenderableMediaAsset & Readonly<{
-    assetId: MediaAssetId;
+/** Shared identifier indexing for admitted site-scoped projections. */
+export declare function buildMediaIdentifierIndex<TAsset extends Readonly<{
+    identifier: MediaIdentifier;
+}>>(assets: readonly TAsset[]): ReadonlyMap<MediaIdentifier, TAsset>;
+/** Index already admitted projections, including runtime registration updates. */
+export declare function indexRenderableMediaAssets(assets: readonly RenderableMediaAsset[]): (RenderableMediaAssetIndex & Readonly<{
+    assets: readonly RenderableMediaAsset[];
+}>) | undefined;
+export type ManagedMediaResolution<TReference extends Readonly<{
+    identifier: MediaIdentifier;
+}>, TAsset = RenderableMediaAsset> = Readonly<{
+    kind: 'resolved';
+    reference: TReference;
+    asset: TAsset;
+}> | Readonly<{
+    kind: 'missing';
+    reference: TReference;
 }>;
+/** A portable reference never uses an incidental UUID, URL or storage snapshot for identity. */
+export declare function resolveManagedMediaReference<TReference extends Readonly<{
+    identifier: MediaIdentifier;
+}>, TAsset = RenderableMediaAsset>(reference: TReference, index: Readonly<{
+    byIdentifier: ReadonlyMap<MediaIdentifier, TAsset>;
+}> | undefined): ManagedMediaResolution<TReference, TAsset>;

package/dist/_dts/media-core/src/renderableMediaAssetAdmission.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import { indexRenderableMediaAssets } from './renderableMediaAsset';
+export declare const renderableMediaAssetSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../core/src/index").MediaAssetId, string>>;
+    identifier: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../blocks/src/index").MediaIdentifier, string>>;
+    storageBucket: z.ZodString;
+    storagePath: z.ZodString;
+    mimeType: z.ZodString;
+    filename: z.ZodOptional<z.ZodString>;
+    width: z.ZodNullable<z.ZodNumber>;
+    height: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type RenderableMediaAsset = Readonly<z.infer<typeof renderableMediaAssetSchema>>;
+/** Admission precedes the identifier-only runtime resolution decision. */
+export declare function buildRenderableMediaAssetIndex(assets: readonly unknown[] | undefined): ReturnType<typeof indexRenderableMediaAssets>;

package/dist/_dts/media-editor/src/CropDialog.d.ts

@@ -1,7 +1,10 @@
 import { type TransformRect } from '../../media-core/src/index';
-import type { MediaHotspot, MediaValue } from './types';
+import type { MediaHotspot } from './types';
+import type { EditorMediaState } from './editorMediaState';
 export type CropDialogProps = {
-    value: MediaValue | undefined;
+    editingSlot: string;
+    state: EditorMediaState;
+    siteId: string;
     open: boolean;
     onOpenChange: (open: boolean) => void;
     aspect?: number;
@@ -10,4 +13,4 @@ export type CropDialogProps = {
     mode?: 'dialog' | 'inline';
     onSubmit: (rect: TransformRect | undefined, hotspot: MediaHotspot | undefined, rotation: 0 | 90 | 180 | 270 | undefined) => void;
 };
-export declare const CropDialog: ({ value, open, onOpenChange, aspect, minSourceWidth, minSourceHeight, mode, onSubmit, }: CropDialogProps) => import("react").JSX.Element | null;
+export declare function CropDialog(props: CropDialogProps): import("react").JSX.Element | null;

package/dist/_dts/media-editor/src/MediaEditor.d.ts

@@ -7,6 +7,7 @@ import { type CropDialogProps } from './CropDialog';
 import { type MediaPickerDialogProps, type MediaPickerPolicy } from './MediaPickerDialog';
 import type { MediaValue, PersistableMediaValue } from './types';
 export type MediaEditorProps = {
+    editingSlot: string;
     value: MediaValue | undefined;
     onChange: (next: PersistableMediaValue | undefined) => void;
     allowedKinds?: readonly MediaKind[];
@@ -39,5 +40,5 @@ type MediaEditorComponents = {
     MediaPickerDialog: ComponentType<MediaPickerDialogProps>;
     CropDialog: ComponentType<CropDialogProps>;
 };
-export declare const MediaEditor: ({ value, onChange, allowedKinds, previewAspectRatio, minSourceWidth, minSourceHeight, showAltInput, cropEditorMode, cropEditorAutoOpen, mediaPickerAutoOpen, onMediaPickerOpenChange, mediaPickerDialogMaxWidth, mediaPickerPolicy, showPreview, showActionOverlay, onEditDetails, fullWidth, previewVariant, showRemoveAction, previewMaxWidth, preventPreviewUpscale, onUploadComplete, uploadIntent, videoPrepIntent, videoSelectionIntent, components, }: MediaEditorProps) => import("react").JSX.Element;
+export declare const MediaEditor: ({ editingSlot, value, onChange, allowedKinds, previewAspectRatio, minSourceWidth, minSourceHeight, showAltInput, cropEditorMode, cropEditorAutoOpen, mediaPickerAutoOpen, onMediaPickerOpenChange, mediaPickerDialogMaxWidth, mediaPickerPolicy, showPreview, showActionOverlay, onEditDetails, fullWidth, previewVariant, showRemoveAction, previewMaxWidth, preventPreviewUpscale, onUploadComplete, uploadIntent, videoPrepIntent, videoSelectionIntent, components, }: MediaEditorProps) => import("react").JSX.Element;
 export {};

package/dist/_dts/media-editor/src/MediaPreview.d.ts

@@ -1,6 +1,6 @@
-import type { MediaValue } from './types';
+import type { EditorMediaState } from './editorMediaState';
 export type MediaPreviewProps = {
-    value: MediaValue | undefined;
+    state: EditorMediaState;
     previewAspectRatio?: number;
     onReplace: () => void;
     onEditCrop: () => void;
@@ -13,4 +13,4 @@ export type MediaPreviewProps = {
     previewMaxWidth?: 'xs' | 'sm' | 'md' | 'none';
     preventUpscale?: boolean;
 };
-export declare const MediaPreview: ({ value, previewAspectRatio, onReplace, onEditCrop, onEditDetails, onRemove, fullWidth, variant, showRemoveAction, showActionOverlay, previewMaxWidth, preventUpscale, }: MediaPreviewProps) => import("react").JSX.Element;
+export declare const MediaPreview: ({ state, previewAspectRatio, onReplace, onEditCrop, onEditDetails, onRemove, fullWidth, variant, showRemoveAction, showActionOverlay, previewMaxWidth, preventUpscale, }: MediaPreviewProps) => import("react").JSX.Element;

package/dist/_dts/media-editor/src/cropEditorSource.d.ts

@@ -1,10 +1,8 @@
+import { type RenderableMediaAsset } from '../../media-core/src/index';
 import type { ImageOrientationMode } from '../../media-react/src/index';
-import type { MediaValue } from './types';
-export type CropEditorSource = {
-    kind: 'ready';
+export type CropEditorSource = Readonly<{
     imageUrl: string;
     orientationMode: ImageOrientationMode;
-} | {
-    kind: 'missingAssetId';
-};
-export declare function resolveCropEditorSource(value: MediaValue | undefined): CropEditorSource | null;
+}>;
+/** Original asset source: per-use cropping and rotation belong to the cropper. */
+export declare function resolveCropEditorSource(asset: RenderableMediaAsset): CropEditorSource;