@kumwe/studio-media 0.1.0-alpha.10

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,31 @@
+# `@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.
+
+`StudioMediaFieldController` provides the reusable browse/search/page/select/replace and
+paste/drop/upload workflow, including progress, cancel/retry, alternative text, decorative mode,
+caption, focal point, rendition intent, and orphan recovery. Inject a `MediaProvider` and, for
+host-authorized chunked uploads, a `MediaUploadTransport`. Dynamic host bindings are read-only.
+
+The controller's observable value contains only the stable `MediaReference`; asset projections,
+bytes, paths, delivery URLs, credentials, and upload grants never enter the artifact.
+
+## 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/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,9 @@
+# Third-party notices
+
+<!-- Generated by scripts/generate-third-party-notices.mjs. Do not edit by hand. -->
+
+Package: `@kumwe/studio-media`
+
+Production closure SHA-256: `4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945`
+
+This package has no third-party runtime dependencies.

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+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 { evaluateUploadPolicy, planFromPolicy, type MediaUploadPolicy, type MediaUploadPolicyDecision, } from './upload-policy.js';
+export { validateMediaReference } from './validate-media-reference.js';
+export { StudioMediaFieldController, type StudioMediaFieldListener, type StudioMediaFieldOptions, type StudioMediaFieldState, type StudioMediaFieldStatus, } from './media-field.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,EACL,oBAAoB,EACpB,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,GAC/B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EACL,0BAA0B,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { MediaLibrary, MEDIA_PROVIDER_FAILURE, selectBestRendition, } from './media-library.js';
+export { MediaUploadController, MEDIA_UPLOAD_FAILURE, MEDIA_UPLOAD_TOO_LARGE, } from './upload-controller.js';
+export { evaluateUploadPolicy, planFromPolicy, } from './upload-policy.js';
+export { validateMediaReference } from './validate-media-reference.js';
+export { StudioMediaFieldController, } from './media-field.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,EACL,oBAAoB,EACpB,cAAc,GAGf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EACL,0BAA0B,GAK3B,MAAM,kBAAkB,CAAC"}

package/dist/media-field.d.ts

@@ -0,0 +1,56 @@
+import { type FieldBinding, type MediaAsset, type MediaReference, type MediaRenditionIntent, type MediaUploadSession, type StudioDiagnostic } from '@kumwe/studio-protocol';
+import { type MediaLibraryState, type MediaProvider } from './media-library.js';
+import { type MediaUploadTransport } from './upload-controller.js';
+export interface StudioMediaFieldOptions {
+    binding?: FieldBinding;
+    mediaTypes?: string[];
+    onChange?: (state: StudioMediaFieldState) => void;
+    provider: MediaProvider;
+    readOnly?: boolean;
+    uploadTransport?: MediaUploadTransport;
+    usage: `${string}/${string}`;
+    value?: MediaReference;
+}
+export type StudioMediaFieldStatus = 'browsing' | 'empty' | 'error' | 'orphaned' | 'ready' | 'uploading';
+export interface StudioMediaFieldState {
+    asset?: MediaAsset;
+    diagnostics: StudioDiagnostic[];
+    library: MediaLibraryState;
+    readOnly: boolean;
+    status: StudioMediaFieldStatus;
+    upload?: MediaUploadSession;
+    value?: MediaReference;
+}
+export type StudioMediaFieldListener = (state: StudioMediaFieldState) => void;
+/**
+ * Host-neutral media-field state machine. It coordinates the complete author
+ * journey while persisting only a canonical MediaReference — never bytes,
+ * delivery URLs, upload grants, Editor state, or catalogue projections.
+ */
+export declare class StudioMediaFieldController {
+    #private;
+    constructor(options: StudioMediaFieldOptions);
+    get state(): StudioMediaFieldState;
+    cancelUpload(): void;
+    clear(): void;
+    dispose(): void;
+    drop(files: FileList | readonly File[]): Promise<StudioMediaFieldState>;
+    loadNext(): Promise<StudioMediaFieldState>;
+    open(): Promise<StudioMediaFieldState>;
+    paste(items: DataTransferItemList | readonly DataTransferItem[]): Promise<StudioMediaFieldState>;
+    resolve(): Promise<StudioMediaFieldState>;
+    retryUpload(): Promise<StudioMediaFieldState>;
+    search(search: string): Promise<StudioMediaFieldState>;
+    select(asset: MediaAsset): void;
+    setAltText(altText: string): void;
+    setCaption(caption: string | undefined): void;
+    setDecorative(decorative: boolean): void;
+    setFocalPoint(point: {
+        x: number;
+        y: number;
+    } | undefined): void;
+    setRenditionIntent(intent: MediaRenditionIntent | undefined): void;
+    subscribe(listener: StudioMediaFieldListener): () => void;
+    upload(file: File): Promise<StudioMediaFieldState>;
+}
+//# sourceMappingURL=media-field.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media-field.d.ts","sourceRoot":"","sources":["../src/media-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAgB,KAAK,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAAyB,KAAK,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG1F,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAClD,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,KAAK,EAAE,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,MAAM,sBAAsB,GAChC,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;AAEtE,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAE9E;;;;GAIG;AACH,qBAAa,0BAA0B;;gBAelB,OAAO,EAAE,uBAAuB;IAkCnD,IAAW,KAAK,IAAI,qBAAqB,CAWxC;IAEM,YAAY,IAAI,IAAI;IAKpB,KAAK,IAAI,IAAI;IAQb,OAAO,IAAI,IAAI;IAKT,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,IAAI,EAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIvE,QAAQ,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAM1C,IAAI,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAItC,KAAK,CAChB,KAAK,EAAE,oBAAoB,GAAG,SAAS,gBAAgB,EAAE,GACxD,OAAO,CAAC,qBAAqB,CAAC;IAQpB,OAAO,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAqBzC,WAAW,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAQ7C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAU5D,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAqB/B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAajC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAa7C,aAAa,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI;IAexC,aAAa,CAAC,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,GAAG,IAAI;IAWhE,kBAAkB,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,GAAG,IAAI;IAWlE,SAAS,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,IAAI;IAQnD,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,qBAAqB,CAAC;CA6DhE"}

package/dist/media-field.js

@@ -0,0 +1,301 @@
+import { STUDIO_CONTRACT_VERSION, } from '@kumwe/studio-protocol';
+import { MediaLibrary } from './media-library.js';
+import { MediaUploadController } from './upload-controller.js';
+import { validateMediaReference } from './validate-media-reference.js';
+/**
+ * Host-neutral media-field state machine. It coordinates the complete author
+ * journey while persisting only a canonical MediaReference — never bytes,
+ * delivery URLs, upload grants, Editor state, or catalogue projections.
+ */
+export class StudioMediaFieldController {
+    #library;
+    #listeners = new Set();
+    #mediaTypes;
+    #onChange;
+    #provider;
+    #readOnly;
+    #upload;
+    #usage;
+    #asset;
+    #libraryState = { assets: [], status: 'idle' };
+    #status;
+    #uploadState;
+    #value;
+    constructor(options) {
+        this.#provider = options.provider;
+        this.#usage = options.usage;
+        this.#mediaTypes = options.mediaTypes === undefined ? undefined : [...options.mediaTypes];
+        this.#onChange = options.onChange;
+        this.#readOnly =
+            options.readOnly === true ||
+                (options.binding !== undefined && options.binding.source.kind !== 'static-value');
+        this.#value = options.value === undefined ? undefined : structuredClone(options.value);
+        this.#upload =
+            options.uploadTransport === undefined
+                ? undefined
+                : new MediaUploadController(options.uploadTransport);
+        this.#status = this.#value === undefined ? 'empty' : 'browsing';
+        this.#library = new MediaLibrary(options.provider);
+        this.#library.subscribe((library) => {
+            this.#libraryState = library;
+            if (library.status === 'error')
+                this.#status = 'error';
+            this.#emit(false);
+        });
+        if (this.#upload !== undefined) {
+            this.#upload.subscribe((upload) => {
+                this.#uploadState = upload;
+                this.#status =
+                    upload.state === 'failed'
+                        ? 'error'
+                        : upload.state === 'complete'
+                            ? 'browsing'
+                            : 'uploading';
+                this.#emit(false);
+            });
+        }
+    }
+    get state() {
+        const state = {
+            diagnostics: this.#value === undefined ? [] : validateMediaReference(this.#value),
+            library: structuredClone(this.#libraryState),
+            readOnly: this.#readOnly,
+            status: this.#status,
+        };
+        if (this.#asset !== undefined)
+            state.asset = structuredClone(this.#asset);
+        if (this.#uploadState !== undefined)
+            state.upload = structuredClone(this.#uploadState);
+        if (this.#value !== undefined)
+            state.value = structuredClone(this.#value);
+        return state;
+    }
+    cancelUpload() {
+        this.#assertMutable();
+        this.#upload?.cancel();
+    }
+    clear() {
+        this.#assertMutable();
+        this.#asset = undefined;
+        this.#value = undefined;
+        this.#status = 'empty';
+        this.#emit(true);
+    }
+    dispose() {
+        this.#library.dispose();
+        this.#listeners.clear();
+    }
+    async drop(files) {
+        return this.#uploadFiles([...files]);
+    }
+    async loadNext() {
+        this.#status = 'browsing';
+        await this.#library.loadNext();
+        return this.state;
+    }
+    async open() {
+        return this.search('');
+    }
+    async paste(items) {
+        const files = [...items]
+            .filter((item) => item.kind === 'file')
+            .map((item) => item.getAsFile())
+            .filter((file) => file !== null);
+        return this.#uploadFiles(files);
+    }
+    async resolve() {
+        if (this.#value === undefined)
+            return this.state;
+        this.#status = 'browsing';
+        this.#emit(false);
+        try {
+            const asset = await this.#provider.get(this.#value.assetId);
+            if (asset === null) {
+                this.#asset = undefined;
+                this.#status = 'orphaned';
+            }
+            else {
+                this.#asset = asset;
+                this.#status =
+                    asset.state === 'rejected' || asset.state === 'quarantined' ? 'error' : 'ready';
+            }
+        }
+        catch {
+            this.#status = 'error';
+        }
+        this.#emit(false);
+        return this.state;
+    }
+    async retryUpload() {
+        this.#assertMutable();
+        if (this.#upload === undefined)
+            throw new Error('This media field has no upload transport.');
+        const result = await this.#upload.retry();
+        await this.#acceptCompletedUpload(result);
+        return this.state;
+    }
+    async search(search) {
+        this.#status = 'browsing';
+        await this.#library.search({
+            limit: 40,
+            ...(this.#mediaTypes === undefined ? {} : { mediaTypes: this.#mediaTypes }),
+            ...(search.trim().length === 0 ? {} : { search: search.trim().slice(0, 500) }),
+        });
+        return this.state;
+    }
+    select(asset) {
+        this.#assertMutable();
+        this.#asset = structuredClone(asset);
+        const alt = asset.metadata.altText?.trim();
+        this.#value = {
+            accessibility: {
+                altText: alt === undefined || alt.length === 0 ? asset.filename : alt,
+                ...(asset.metadata.caption === undefined ? {} : { caption: asset.metadata.caption }),
+                mode: 'informative',
+            },
+            assetId: asset.id,
+            assetRevision: asset.revision,
+            contractVersion: STUDIO_CONTRACT_VERSION,
+            kind: 'media-reference',
+            usage: this.#usage,
+        };
+        this.#status =
+            asset.state === 'ready' ? 'ready' : asset.state === 'processing' ? 'uploading' : 'error';
+        this.#emit(true);
+    }
+    setAltText(altText) {
+        this.#assertMutable();
+        const value = this.#requireValue();
+        const caption = value.accessibility.mode === 'informative' ? value.accessibility.caption : undefined;
+        value.accessibility = {
+            altText: altText.trim().slice(0, 5_000),
+            ...(caption === undefined ? {} : { caption }),
+            mode: 'informative',
+        };
+        this.#emit(true);
+    }
+    setCaption(caption) {
+        this.#assertMutable();
+        const value = this.#requireValue();
+        if (value.accessibility.mode !== 'informative')
+            return;
+        value.accessibility = {
+            ...value.accessibility,
+            ...(caption === undefined || caption.length === 0
+                ? {}
+                : { caption: caption.slice(0, 20_000) }),
+        };
+        this.#emit(true);
+    }
+    setDecorative(decorative) {
+        this.#assertMutable();
+        const value = this.#requireValue();
+        if (decorative) {
+            value.accessibility = { mode: 'decorative' };
+        }
+        else {
+            const metadataAlt = this.#asset?.metadata.altText?.trim() ?? '';
+            const filename = this.#asset?.filename ?? '';
+            const suggested = metadataAlt.length > 0 ? metadataAlt : filename.length > 0 ? filename : 'Media';
+            value.accessibility = { altText: suggested, mode: 'informative' };
+        }
+        this.#emit(true);
+    }
+    setFocalPoint(point) {
+        this.#assertMutable();
+        const value = this.#requireValue();
+        if (point === undefined) {
+            delete value.focalPoint;
+        }
+        else {
+            value.focalPoint = { x: clampUnit(point.x), y: clampUnit(point.y) };
+        }
+        this.#emit(true);
+    }
+    setRenditionIntent(intent) {
+        this.#assertMutable();
+        const value = this.#requireValue();
+        if (intent === undefined) {
+            delete value.renditionIntent;
+        }
+        else {
+            value.renditionIntent = structuredClone(intent);
+        }
+        this.#emit(true);
+    }
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        listener(this.state);
+        return () => {
+            this.#listeners.delete(listener);
+        };
+    }
+    async upload(file) {
+        return this.#uploadFiles([file]);
+    }
+    #assertMutable() {
+        if (this.#readOnly)
+            throw new Error('Dynamic and read-only media fields cannot be mutated.');
+    }
+    async #acceptCompletedUpload(session) {
+        if (session.state !== 'complete' || session.asset === undefined)
+            return;
+        const asset = await this.#provider.get(session.asset.id);
+        if (asset === null) {
+            this.#value = {
+                accessibility: { altText: session.request.filename, mode: 'informative' },
+                assetId: session.asset.id,
+                assetRevision: session.asset.revision,
+                contractVersion: STUDIO_CONTRACT_VERSION,
+                kind: 'media-reference',
+                usage: this.#usage,
+            };
+            this.#asset = undefined;
+            this.#status = 'orphaned';
+            this.#emit(true);
+            return;
+        }
+        this.select(asset);
+    }
+    #emit(changed) {
+        const state = this.state;
+        if (changed)
+            this.#onChange?.(state);
+        for (const listener of this.#listeners)
+            listener(state);
+    }
+    #requireValue() {
+        if (this.#value === undefined)
+            throw new Error('Select media before editing its usage.');
+        return this.#value;
+    }
+    async #uploadFiles(files) {
+        this.#assertMutable();
+        const file = files[0];
+        if (file === undefined)
+            return this.state;
+        if (this.#mediaTypes !== undefined && !this.#mediaTypes.includes(file.type)) {
+            throw new TypeError(`Media type "${file.type}" is not accepted by this field.`);
+        }
+        this.#status = 'uploading';
+        this.#emit(false);
+        if (this.#upload === undefined) {
+            const asset = await this.#provider.upload({ alt: file.name, file });
+            this.select(asset);
+            return this.state;
+        }
+        const result = await this.#upload.upload(file, {
+            filename: file.name,
+            mediaType: file.type || 'application/octet-stream',
+            purpose: this.#usage,
+        });
+        await this.#acceptCompletedUpload(result);
+        return this.state;
+    }
+}
+function clampUnit(value) {
+    if (!Number.isFinite(value))
+        throw new TypeError('Focal coordinates must be finite numbers.');
+    return Math.max(0, Math.min(1, value));
+}
+//# sourceMappingURL=media-field.js.map

package/dist/media-field.js.map

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

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/upload-policy.d.ts

@@ -0,0 +1,35 @@
+import type { MediaUploadPlan, MediaUploadRequestDescriptor, StudioDiagnostic } from '@kumwe/studio-protocol';
+/**
+ * The host-declared upload policy: the bounded upload plan the host grants
+ * (`MediaUploadPlan`) plus the declared media types it accepts. This is the
+ * policy shape the canonical vectors in `schemas/vectors/media/` fix; the
+ * host remains authoritative and re-verifies everything server-side.
+ */
+export interface MediaUploadPolicy {
+    acceptedMediaTypes: readonly string[];
+    chunkBytes?: number;
+    maximumBytes: number;
+    resumable: boolean;
+}
+export type MediaUploadPolicyDecision = {
+    failure: StudioDiagnostic;
+    outcome: 'rejected';
+} | {
+    outcome: 'accepted';
+    plan: MediaUploadPlan;
+};
+/** The deterministic upload plan a policy grants, independent of any request. */
+export declare function planFromPolicy(policy: MediaUploadPolicy): MediaUploadPlan;
+/**
+ * Evaluates one upload request against a host-declared policy, in the fixed
+ * order filename, media type, size. Rejections use the closed media failure
+ * vocabulary: an oversize request fails with `studio.media/upload-too-large`
+ * carrying the byte counts only as machine-readable diagnostic parameters
+ * (the exact diagnostic `MediaUploadController` raises at the same boundary),
+ * and every other violation fails with the generic
+ * `studio.media/upload-failed` — user-facing messages never echo the raw
+ * size, media type, or filename. The canonical corpus in
+ * `schemas/vectors/media/` replays this decision.
+ */
+export declare function evaluateUploadPolicy(policy: MediaUploadPolicy, request: MediaUploadRequestDescriptor): MediaUploadPolicyDecision;
+//# sourceMappingURL=upload-policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upload-policy.d.ts","sourceRoot":"","sources":["../src/upload-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,4BAA4B,EAC5B,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAGhC;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,yBAAyB,GACjC;IAAE,OAAO,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,GAClD;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AAEnD,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,eAAe,CASzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,4BAA4B,GACpC,yBAAyB,CA4B3B"}

package/dist/upload-policy.js

@@ -0,0 +1,71 @@
+import { MEDIA_UPLOAD_FAILURE, MEDIA_UPLOAD_TOO_LARGE } from './upload-controller.js';
+/** The deterministic upload plan a policy grants, independent of any request. */
+export function planFromPolicy(policy) {
+    const plan = {
+        maximumBytes: policy.maximumBytes,
+        resumable: policy.resumable,
+    };
+    if (policy.chunkBytes !== undefined) {
+        plan.chunkBytes = policy.chunkBytes;
+    }
+    return plan;
+}
+/**
+ * Evaluates one upload request against a host-declared policy, in the fixed
+ * order filename, media type, size. Rejections use the closed media failure
+ * vocabulary: an oversize request fails with `studio.media/upload-too-large`
+ * carrying the byte counts only as machine-readable diagnostic parameters
+ * (the exact diagnostic `MediaUploadController` raises at the same boundary),
+ * and every other violation fails with the generic
+ * `studio.media/upload-failed` — user-facing messages never echo the raw
+ * size, media type, or filename. The canonical corpus in
+ * `schemas/vectors/media/` replays this decision.
+ */
+export function evaluateUploadPolicy(policy, request) {
+    if (!isCanonicalFilename(request.filename) ||
+        !policy.acceptedMediaTypes.includes(request.mediaType) ||
+        !Number.isInteger(request.byteSize) ||
+        request.byteSize < 1) {
+        return {
+            failure: {
+                code: 'studio.media/upload-failed',
+                message: { ...MEDIA_UPLOAD_FAILURE },
+                severity: 'error',
+            },
+            outcome: 'rejected',
+        };
+    }
+    if (request.byteSize > policy.maximumBytes) {
+        return {
+            failure: {
+                code: 'studio.media/upload-too-large',
+                message: { ...MEDIA_UPLOAD_TOO_LARGE },
+                parameters: { byteSize: request.byteSize, maximumBytes: policy.maximumBytes },
+                severity: 'error',
+            },
+            outcome: 'rejected',
+        };
+    }
+    return { outcome: 'accepted', plan: planFromPolicy(policy) };
+}
+/**
+ * Mirrors the filename rule of `media-upload-session.schema.json`: one to 255
+ * code points, no C0 control characters, no DEL, and no path separators —
+ * per the media contract, filenames are display metadata, never storage
+ * paths.
+ */
+function isCanonicalFilename(filename) {
+    let length = 0;
+    for (const character of filename) {
+        length += 1;
+        if (length > 255) {
+            return false;
+        }
+        const codePoint = character.codePointAt(0) ?? 0;
+        if (codePoint <= 0x1f || codePoint === 0x7f || character === '/' || character === '\\') {
+            return false;
+        }
+    }
+    return length >= 1;
+}
+//# sourceMappingURL=upload-policy.js.map

package/dist/upload-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-policy.js","sourceRoot":"","sources":["../src/upload-policy.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAmBtF,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAC,MAAyB;IACtD,MAAM,IAAI,GAAoB;QAC5B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC;IACF,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACtC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAyB,EACzB,OAAqC;IAErC,IACE,CAAC,mBAAmB,CAAC,OAAO,CAAC,QAAQ,CAAC;QACtC,CAAC,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC;QACtD,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC;QACnC,OAAO,CAAC,QAAQ,GAAG,CAAC,EACpB,CAAC;QACD,OAAO;YACL,OAAO,EAAE;gBACP,IAAI,EAAE,4BAA4B;gBAClC,OAAO,EAAE,EAAE,GAAG,oBAAoB,EAAE;gBACpC,QAAQ,EAAE,OAAO;aAClB;YACD,OAAO,EAAE,UAAU;SACpB,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;QAC3C,OAAO;YACL,OAAO,EAAE;gBACP,IAAI,EAAE,+BAA+B;gBACrC,OAAO,EAAE,EAAE,GAAG,sBAAsB,EAAE;gBACtC,UAAU,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE;gBAC7E,QAAQ,EAAE,OAAO;aAClB;YACD,OAAO,EAAE,UAAU;SACpB,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,SAAS,mBAAmB,CAAC,QAAgB;IAC3C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;QACjC,MAAM,IAAI,CAAC,CAAC;QACZ,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;YACjB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,SAAS,IAAI,IAAI,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvF,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,MAAM,IAAI,CAAC,CAAC;AACrB,CAAC"}

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,41 @@
+{
+  "name": "@kumwe/studio-media",
+  "version": "0.1.0-alpha.10",
+  "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",
+    "THIRD_PARTY_NOTICES.md",
+    "third-party-licenses",
+    "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.10"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=24.0.0"
+  }
+}