@kumwe/studio-media 0.1.0-alpha.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kumwe Studio contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,23 @@
+# `@kumwe/studio-media`
+
+Status: pre-Gate-A foundation alpha. It supplies orchestration primitives, not a production media backend.
+
+Host-neutral media orchestration. Hosts provide authentication, storage, upload, processing, and
+authorization through this package's runtime `MediaProvider`; the package supplies cancellation-safe
+browsing state and deterministic responsive-rendition selection.
+
+Studio artifacts store the protocol's usage-specific `MediaReference`, while `MediaAsset` is the
+host's library projection. URLs are delivery details returned by the receiving host and belong in
+neither persisted contract.
+
+## Upload orchestration
+
+`MediaUploadController` drives the canonical media-upload-session state machine —
+`requested → authorized → transferring → verifying → complete`, with `failed` and `cancelled`
+terminals — over a host-implemented `MediaUploadTransport` (`authorize`, `transfer`, `finalize`,
+and best-effort `abort`). Chunking follows the host's authorized plan, and every emitted snapshot
+conforms to the protocol's `media-upload-session` schema. A file larger than the plan's
+`maximumBytes` fails before any transfer with a `studio.media/upload-too-large` diagnostic;
+transport rejections surface as a generic `studio.media/upload-failed` diagnostic and never leak
+raw error text. `cancel()` aborts in-flight work and requests best-effort server-side
+cancellation, and `retry()` restarts a failed session from authorization under a fresh session id.

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { MediaLibrary, MEDIA_PROVIDER_FAILURE, selectBestRendition, type MediaLibraryListener, type MediaLibraryState, type MediaLibraryStatus, type MediaProvider, type MediaUploadRequest, } from './media-library.js';
+export { MediaUploadController, MEDIA_UPLOAD_FAILURE, MEDIA_UPLOAD_TOO_LARGE, type MediaUploadChunk, type MediaUploadControllerOptions, type MediaUploadListener, type MediaUploadTransport, } from './upload-controller.js';
+export { validateMediaReference } from './validate-media-reference.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { MediaLibrary, MEDIA_PROVIDER_FAILURE, selectBestRendition, } from './media-library.js';
+export { MediaUploadController, MEDIA_UPLOAD_FAILURE, MEDIA_UPLOAD_TOO_LARGE, } from './upload-controller.js';
+export { validateMediaReference } from './validate-media-reference.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,mBAAmB,GAMpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,GAKvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/media-library.d.ts

@@ -0,0 +1,32 @@
+import type { MediaAsset, MediaPage, MediaQuery, MediaRendition, MessageReference } from '@kumwe/studio-protocol';
+export declare const MEDIA_PROVIDER_FAILURE: Readonly<MessageReference>;
+export interface MediaUploadRequest {
+    alt?: string;
+    file: Blob;
+    signal?: AbortSignal;
+}
+export interface MediaProvider {
+    get(assetId: string, signal?: AbortSignal): Promise<MediaAsset | null>;
+    list(query: MediaQuery, signal?: AbortSignal): Promise<MediaPage>;
+    upload(request: MediaUploadRequest): Promise<MediaAsset>;
+}
+export type MediaLibraryStatus = 'error' | 'idle' | 'loading' | 'ready';
+export interface MediaLibraryState {
+    assets: MediaAsset[];
+    error?: MessageReference;
+    nextCursor?: string;
+    query?: MediaQuery;
+    status: MediaLibraryStatus;
+}
+export type MediaLibraryListener = (state: MediaLibraryState) => void;
+export declare class MediaLibrary {
+    #private;
+    constructor(provider: MediaProvider);
+    get state(): MediaLibraryState;
+    dispose(): void;
+    loadNext(): Promise<MediaLibraryState>;
+    search(query: MediaQuery): Promise<MediaLibraryState>;
+    subscribe(listener: MediaLibraryListener): () => void;
+}
+export declare function selectBestRendition(asset: MediaAsset, targetWidth: number): MediaRendition | undefined;
+//# sourceMappingURL=media-library.d.ts.map

package/dist/media-library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-library.d.ts","sourceRoot":"","sources":["../src/media-library.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,UAAU,EACV,cAAc,EACd,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,gBAAgB,CAG5D,CAAC;AAEH,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACvE,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAClE,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC1D;AAED,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAEtE,qBAAa,YAAY;;gBAMJ,QAAQ,EAAE,aAAa;IAI1C,IAAW,KAAK,IAAI,iBAAiB,CAEpC;IAEM,OAAO,IAAI,IAAI;IAKT,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAUtC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAa3D,SAAS,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;CA+C7D;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,GAClB,cAAc,GAAG,SAAS,CAM5B"}

package/dist/media-library.js

@@ -0,0 +1,93 @@
+export const MEDIA_PROVIDER_FAILURE = Object.freeze({
+    defaultMessage: 'The media library could not be loaded.',
+    key: 'studio.media/provider-failed',
+});
+export class MediaLibrary {
+    #listeners = new Set();
+    #provider;
+    #abortController;
+    #state = { assets: [], status: 'idle' };
+    constructor(provider) {
+        this.#provider = provider;
+    }
+    get state() {
+        return structuredClone(this.#state);
+    }
+    dispose() {
+        this.#abortController?.abort();
+        this.#listeners.clear();
+    }
+    async loadNext() {
+        if (this.#state.query === undefined || this.#state.nextCursor === undefined) {
+            return this.state;
+        }
+        return this.#load({ ...this.#state.query, cursor: this.#state.nextCursor }, [
+            ...this.#state.assets,
+        ]);
+    }
+    async search(query) {
+        const normalized = {
+            limit: Math.max(1, Math.min(100, Math.trunc(query.limit))),
+        };
+        if (query.mediaTypes !== undefined) {
+            normalized.mediaTypes = [...query.mediaTypes];
+        }
+        if (query.search !== undefined) {
+            normalized.search = query.search;
+        }
+        return this.#load(normalized, []);
+    }
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        listener(this.state);
+        return () => {
+            this.#listeners.delete(listener);
+        };
+    }
+    async #load(query, existing) {
+        this.#abortController?.abort();
+        const controller = new AbortController();
+        this.#abortController = controller;
+        this.#setState({ assets: existing, query, status: 'loading' });
+        try {
+            const page = await this.#provider.list(query, controller.signal);
+            if (controller.signal.aborted) {
+                return this.state;
+            }
+            const next = {
+                assets: [...existing, ...page.assets],
+                query,
+                status: 'ready',
+            };
+            if (page.nextCursor !== undefined) {
+                next.nextCursor = page.nextCursor;
+            }
+            this.#setState(next);
+        }
+        catch {
+            if (!controller.signal.aborted) {
+                this.#setState({
+                    assets: existing,
+                    error: { ...MEDIA_PROVIDER_FAILURE },
+                    query,
+                    status: 'error',
+                });
+            }
+        }
+        return this.state;
+    }
+    #setState(state) {
+        this.#state = state;
+        for (const listener of this.#listeners) {
+            listener(this.state);
+        }
+    }
+}
+export function selectBestRendition(asset, targetWidth) {
+    if (asset.renditions === undefined || asset.renditions.length === 0) {
+        return undefined;
+    }
+    const ordered = [...asset.renditions].sort((left, right) => left.width - right.width);
+    return ordered.find((rendition) => rendition.width >= targetWidth) ?? ordered.at(-1);
+}
+//# sourceMappingURL=media-library.js.map

package/dist/media-library.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-library.js","sourceRoot":"","sources":["../src/media-library.ts"],"names":[],"mappings":"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"}

package/dist/upload-controller.d.ts

@@ -0,0 +1,34 @@
+import { type MediaUploadAcceptedAsset, type MediaUploadPlan, type MediaUploadRequestDescriptor, type MediaUploadSession, type MessageReference } from '@kumwe/studio-protocol';
+export declare const MEDIA_UPLOAD_FAILURE: Readonly<MessageReference>;
+export declare const MEDIA_UPLOAD_TOO_LARGE: Readonly<MessageReference>;
+export interface MediaUploadChunk {
+    data: Blob;
+    offset: number;
+    sessionId: string;
+}
+/**
+ * Host adapter for the upload lifecycle in `docs/contracts/media.md`. The
+ * host owns authorization, custody, verification, and acceptance; Studio
+ * only orchestrates the canonical media-upload-session state machine.
+ */
+export interface MediaUploadTransport {
+    /** Best-effort server-side cancellation; rejections are ignored. */
+    abort(sessionId: string): Promise<void>;
+    authorize(request: MediaUploadRequestDescriptor, signal?: AbortSignal): Promise<MediaUploadPlan>;
+    finalize(sessionId: string, signal?: AbortSignal): Promise<MediaUploadAcceptedAsset>;
+    transfer(chunk: MediaUploadChunk, signal?: AbortSignal): Promise<void>;
+}
+export interface MediaUploadControllerOptions {
+    sessionId?: (request: MediaUploadRequestDescriptor) => string;
+}
+export type MediaUploadListener = (session: MediaUploadSession) => void;
+export declare class MediaUploadController {
+    #private;
+    constructor(transport: MediaUploadTransport, options?: MediaUploadControllerOptions);
+    get session(): MediaUploadSession;
+    cancel(): void;
+    retry(): Promise<MediaUploadSession>;
+    subscribe(listener: MediaUploadListener): () => void;
+    upload(file: Blob, request: Omit<MediaUploadRequestDescriptor, 'byteSize'>): Promise<MediaUploadSession>;
+}
+//# sourceMappingURL=upload-controller.d.ts.map

package/dist/upload-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-controller.d.ts","sourceRoot":"","sources":["../src/upload-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,4BAA4B,EACjC,KAAK,kBAAkB,EAEvB,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,gBAAgB,CAG1D,CAAC;AAEH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,gBAAgB,CAG5D,CAAC;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,SAAS,CAAC,OAAO,EAAE,4BAA4B,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACjG,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACrF,QAAQ,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE;AAED,MAAM,WAAW,4BAA4B;IAC3C,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,MAAM,CAAC;CAC/D;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;AASxE,qBAAa,qBAAqB;;gBAQb,SAAS,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,4BAA4B;IAK1F,IAAW,OAAO,IAAI,kBAAkB,CAKvC;IAEM,MAAM,IAAI,IAAI;IAUR,KAAK,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAS1C,SAAS,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAU9C,MAAM,CACjB,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,IAAI,CAAC,4BAA4B,EAAE,UAAU,CAAC,GACtD,OAAO,CAAC,kBAAkB,CAAC;CAiJ/B"}

package/dist/upload-controller.js

@@ -0,0 +1,196 @@
+import { STUDIO_CONTRACT_VERSION, } from '@kumwe/studio-protocol';
+export const MEDIA_UPLOAD_FAILURE = Object.freeze({
+    defaultMessage: 'The upload could not be completed.',
+    key: 'studio.media/upload-failed',
+});
+export const MEDIA_UPLOAD_TOO_LARGE = Object.freeze({
+    defaultMessage: 'The file is larger than the host allows for this upload.',
+    key: 'studio.media/upload-too-large',
+});
+const ACTIVE_STATES = new Set([
+    'authorized',
+    'requested',
+    'transferring',
+    'verifying',
+]);
+export class MediaUploadController {
+    #listeners = new Set();
+    #sessionId;
+    #transport;
+    #abortController;
+    #file;
+    #session;
+    constructor(transport, options) {
+        this.#transport = transport;
+        this.#sessionId = options?.sessionId ?? (() => crypto.randomUUID());
+    }
+    get session() {
+        if (this.#session === undefined) {
+            throw new Error('No upload session has been started.');
+        }
+        return structuredClone(this.#session);
+    }
+    cancel() {
+        const current = this.#session;
+        if (current === undefined || !ACTIVE_STATES.has(current.state)) {
+            return;
+        }
+        this.#abortController?.abort();
+        this.#setSession({ ...structuredClone(current), state: 'cancelled' });
+        void this.#transport.abort(current.id).catch(() => undefined);
+    }
+    async retry() {
+        const current = this.#session;
+        const file = this.#file;
+        if (current?.state !== 'failed' || file === undefined) {
+            throw new Error('Only a failed upload session can be retried.');
+        }
+        return this.#run(file, structuredClone(current.request));
+    }
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        if (this.#session !== undefined) {
+            listener(this.session);
+        }
+        return () => {
+            this.#listeners.delete(listener);
+        };
+    }
+    async upload(file, request) {
+        if (this.#session !== undefined && ACTIVE_STATES.has(this.#session.state)) {
+            throw new Error('An upload session is already in progress.');
+        }
+        if (file.size < 1) {
+            throw new Error('Cannot upload an empty file.');
+        }
+        const descriptor = {
+            byteSize: file.size,
+            filename: request.filename,
+            mediaType: request.mediaType,
+            purpose: request.purpose,
+        };
+        if (request.checksum !== undefined) {
+            descriptor.checksum = request.checksum;
+        }
+        this.#file = file;
+        return this.#run(file, descriptor);
+    }
+    #fail() {
+        const current = this.#session;
+        if (current === undefined) {
+            return;
+        }
+        const failed = {
+            contractVersion: current.contractVersion,
+            failure: {
+                code: 'studio.media/upload-failed',
+                message: { ...MEDIA_UPLOAD_FAILURE },
+                severity: 'error',
+            },
+            id: current.id,
+            kind: 'media-upload-session',
+            progress: { ...current.progress },
+            request: { ...current.request },
+            state: 'failed',
+        };
+        if (current.plan !== undefined) {
+            failed.plan = { ...current.plan };
+        }
+        this.#setSession(failed);
+    }
+    async #run(file, request) {
+        const controller = new AbortController();
+        this.#abortController = controller;
+        const totalBytes = request.byteSize;
+        const base = {
+            contractVersion: STUDIO_CONTRACT_VERSION,
+            id: this.#sessionId(request),
+            kind: 'media-upload-session',
+            request,
+        };
+        this.#setSession({
+            ...base,
+            progress: { totalBytes, transferredBytes: 0 },
+            state: 'requested',
+        });
+        try {
+            const plan = await this.#transport.authorize(request, controller.signal);
+            if (controller.signal.aborted) {
+                return this.session;
+            }
+            if (totalBytes > plan.maximumBytes) {
+                this.#setSession({
+                    ...base,
+                    failure: {
+                        code: 'studio.media/upload-too-large',
+                        message: { ...MEDIA_UPLOAD_TOO_LARGE },
+                        parameters: { byteSize: totalBytes, maximumBytes: plan.maximumBytes },
+                        severity: 'error',
+                    },
+                    plan,
+                    progress: { totalBytes, transferredBytes: 0 },
+                    state: 'failed',
+                });
+                return this.session;
+            }
+            this.#setSession({
+                ...base,
+                plan,
+                progress: { totalBytes, transferredBytes: 0 },
+                state: 'authorized',
+            });
+            this.#setSession({
+                ...base,
+                plan,
+                progress: { totalBytes, transferredBytes: 0 },
+                state: 'transferring',
+            });
+            const chunkBytes = Math.max(1, plan.chunkBytes ?? totalBytes);
+            let transferredBytes = 0;
+            while (transferredBytes < totalBytes) {
+                const data = file.slice(transferredBytes, Math.min(transferredBytes + chunkBytes, totalBytes));
+                await this.#transport.transfer({ data, offset: transferredBytes, sessionId: base.id }, controller.signal);
+                if (controller.signal.aborted) {
+                    return this.session;
+                }
+                transferredBytes = Math.min(transferredBytes + data.size, totalBytes);
+                this.#setSession({
+                    ...base,
+                    plan,
+                    progress: { totalBytes, transferredBytes },
+                    state: 'transferring',
+                });
+            }
+            this.#setSession({
+                ...base,
+                plan,
+                progress: { totalBytes, transferredBytes: totalBytes },
+                state: 'verifying',
+            });
+            const asset = await this.#transport.finalize(base.id, controller.signal);
+            if (controller.signal.aborted) {
+                return this.session;
+            }
+            this.#setSession({
+                ...base,
+                asset,
+                plan,
+                progress: { totalBytes, transferredBytes: totalBytes },
+                state: 'complete',
+            });
+        }
+        catch {
+            if (!controller.signal.aborted) {
+                this.#fail();
+            }
+        }
+        return this.session;
+    }
+    #setSession(session) {
+        this.#session = session;
+        for (const listener of this.#listeners) {
+            listener(this.session);
+        }
+    }
+}
+//# sourceMappingURL=upload-controller.js.map

package/dist/upload-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-controller.js","sourceRoot":"","sources":["../src/upload-controller.ts"],"names":[],"mappings":"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"}

package/dist/validate-media-reference.d.ts

@@ -0,0 +1,8 @@
+import type { MediaReference, StudioDiagnostic } from '@kumwe/studio-protocol';
+/**
+ * Semantic validation the media-reference schema cannot express: a
+ * rectangle crop uses normalized coordinates and MUST remain inside the
+ * source bounds. Schema validation is assumed to have passed already.
+ */
+export declare function validateMediaReference(reference: MediaReference): StudioDiagnostic[];
+//# sourceMappingURL=validate-media-reference.d.ts.map

package/dist/validate-media-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-media-reference.d.ts","sourceRoot":"","sources":["../src/validate-media-reference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/E;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,cAAc,GAAG,gBAAgB,EAAE,CAiBpF"}

package/dist/validate-media-reference.js

@@ -0,0 +1,24 @@
+/**
+ * Semantic validation the media-reference schema cannot express: a
+ * rectangle crop uses normalized coordinates and MUST remain inside the
+ * source bounds. Schema validation is assumed to have passed already.
+ */
+export function validateMediaReference(reference) {
+    const diagnostics = [];
+    const crop = reference.cropIntent;
+    if (crop?.mode === 'rectangle') {
+        if (crop.x + crop.width > 1 || crop.y + crop.height > 1) {
+            diagnostics.push({
+                code: 'studio.media/crop-out-of-bounds',
+                location: { artifactId: reference.assetId },
+                message: {
+                    defaultMessage: 'The crop rectangle extends beyond the source media bounds.',
+                    key: 'studio.media/crop-out-of-bounds',
+                },
+                severity: 'error',
+            });
+        }
+    }
+    return diagnostics;
+}
+//# sourceMappingURL=validate-media-reference.js.map

package/dist/validate-media-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-media-reference.js","sourceRoot":"","sources":["../src/validate-media-reference.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAyB;IAC9D,MAAM,WAAW,GAAuB,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC;IAClC,IAAI,IAAI,EAAE,IAAI,KAAK,WAAW,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxD,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,iCAAiC;gBACvC,QAAQ,EAAE,EAAE,UAAU,EAAE,SAAS,CAAC,OAAO,EAAE;gBAC3C,OAAO,EAAE;oBACP,cAAc,EAAE,4DAA4D;oBAC5E,GAAG,EAAE,iCAAiC;iBACvC;gBACD,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@kumwe/studio-media",
+  "version": "0.1.0-alpha.2",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kumwe/studio.git",
+    "directory": "packages/media"
+  },
+  "homepage": "https://github.com/kumwe/studio/tree/main/packages/media#readme",
+  "bugs": "https://github.com/kumwe/studio/issues",
+  "description": "Host-neutral media browsing, upload orchestration, and rendition selection.",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "LICENSE",
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@kumwe/studio-protocol": "0.1.0-alpha.2"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=24.0.0"
+  }
+}