@jini-ai/admin 0.3.9 → 0.4.0

package/dist/media/media.module.d.ts

@@ -0,0 +1,83 @@
+/** "External Providers": credentials for outside media generation services belong
+ * beside the media they generate, not beside MCP/webhook plumbing. Last in the list —
+ * an operator reaches for All/Images/Videos far more often than provider credentials,
+ * and the three content tabs read as one group with this one set apart. */
+export declare const mediaModule: {
+    readonly id: "media";
+    readonly requires: {
+        readonly mediaApi: import("../core/module/token.js").AdminPortToken<import("./ports.js").MediaApiPort, "admin.media.api">;
+    };
+    readonly optional: {
+        readonly mediaProviders: import("../core/module/token.js").AdminPortToken<import("./ports.js").MediaProvidersPort, "admin.media.providers">;
+        readonly mediaEvents: import("../core/module/token.js").AdminPortToken<import("./ports.js").MediaEventsPort, "admin.media.events">;
+    };
+    readonly provides: {
+        readonly mediaPicker: import("../core/module/token.js").AdminPortToken<import("../contracts/media-picker.js").MediaPickerPort, "admin.media.picker">;
+    };
+    readonly messages: {
+        readonly media: "Media";
+        readonly all: "All";
+        readonly images: "Images";
+        readonly videos: "Videos";
+        readonly providers: "External Providers";
+        readonly upload: "Upload";
+        readonly title: "Title";
+        readonly alt: "Alt text";
+        readonly save: "Save";
+        readonly cancel: "Cancel";
+        readonly empty: "No media found";
+        readonly loading: "Loading media…";
+        readonly choose: "Choose media";
+        readonly trash: "Trash";
+        readonly purge: "Delete permanently";
+        readonly purgeWarning: "This permanently deletes the file. This cannot be undone.";
+        readonly edit: "Edit metadata";
+        readonly preview: "View larger";
+        readonly replace: "Replace file";
+        readonly unavailable: "Provider service unavailable";
+        readonly untyped: "Some assets have no recorded content type and only appear under All.";
+    };
+    readonly pages: {
+        readonly library: {
+            readonly path: "/media";
+            readonly label: "Media";
+            readonly permissions: readonly ["media.read"];
+            readonly agentReachable: true;
+            readonly nav: {
+                readonly group: "content";
+                readonly icon: "image";
+            };
+            readonly tabs: {
+                readonly all: {
+                    readonly label: "All";
+                    readonly params: {
+                        readonly filter: "all";
+                    };
+                    readonly agentReachable: true;
+                };
+                readonly images: {
+                    readonly label: "Images";
+                    readonly params: {
+                        readonly filter: "images";
+                    };
+                    readonly agentReachable: true;
+                };
+                readonly videos: {
+                    readonly label: "Videos";
+                    readonly params: {
+                        readonly filter: "videos";
+                    };
+                    readonly agentReachable: true;
+                };
+                readonly 'external-providers': {
+                    readonly label: "External Providers";
+                    readonly permissions: readonly ["media.providers"];
+                    readonly optional: {
+                        readonly mediaProviders: import("../core/module/token.js").AdminPortToken<import("./ports.js").MediaProvidersPort, "admin.media.providers">;
+                    };
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=media.module.d.ts.map

package/dist/media/media.module.js

@@ -0,0 +1,43 @@
+import { defineAdminModule } from '../core/module/index.js';
+import { mediaPickerToken } from '../contracts/media-picker.js';
+import { mediaApiToken, mediaProvidersToken, mediaEventsToken } from './ports.js';
+import { mediaMessagesEn } from './messages.en.js';
+/** "External Providers": credentials for outside media generation services belong
+ * beside the media they generate, not beside MCP/webhook plumbing. Last in the list —
+ * an operator reaches for All/Images/Videos far more often than provider credentials,
+ * and the three content tabs read as one group with this one set apart. */
+export const mediaModule = defineAdminModule({
+    id: 'media',
+    requires: { mediaApi: mediaApiToken },
+    optional: { mediaProviders: mediaProvidersToken, mediaEvents: mediaEventsToken },
+    provides: { mediaPicker: mediaPickerToken },
+    messages: mediaMessagesEn,
+    pages: {
+        library: {
+            path: '/media',
+            label: mediaMessagesEn.media,
+            permissions: ['media.read'],
+            agentReachable: true,
+            nav: { group: 'content', icon: 'image' },
+            tabs: {
+                all: { label: mediaMessagesEn.all, params: { filter: 'all' }, agentReachable: true },
+                images: {
+                    label: mediaMessagesEn.images,
+                    params: { filter: 'images' },
+                    agentReachable: true,
+                },
+                videos: {
+                    label: mediaMessagesEn.videos,
+                    params: { filter: 'videos' },
+                    agentReachable: true,
+                },
+                'external-providers': {
+                    label: mediaMessagesEn.providers,
+                    permissions: ['media.providers'],
+                    optional: { mediaProviders: mediaProvidersToken },
+                },
+            },
+        },
+    },
+});
+//# sourceMappingURL=media.module.js.map

package/dist/media/messages.en.d.ts

@@ -0,0 +1,24 @@
+export declare const mediaMessagesEn: {
+    readonly media: "Media";
+    readonly all: "All";
+    readonly images: "Images";
+    readonly videos: "Videos";
+    readonly providers: "External Providers";
+    readonly upload: "Upload";
+    readonly title: "Title";
+    readonly alt: "Alt text";
+    readonly save: "Save";
+    readonly cancel: "Cancel";
+    readonly empty: "No media found";
+    readonly loading: "Loading media…";
+    readonly choose: "Choose media";
+    readonly trash: "Trash";
+    readonly purge: "Delete permanently";
+    readonly purgeWarning: "This permanently deletes the file. This cannot be undone.";
+    readonly edit: "Edit metadata";
+    readonly preview: "View larger";
+    readonly replace: "Replace file";
+    readonly unavailable: "Provider service unavailable";
+    readonly untyped: "Some assets have no recorded content type and only appear under All.";
+};
+//# sourceMappingURL=messages.en.d.ts.map

package/dist/media/messages.en.js

@@ -0,0 +1,24 @@
+export const mediaMessagesEn = {
+    media: 'Media',
+    all: 'All',
+    images: 'Images',
+    videos: 'Videos',
+    providers: 'External Providers',
+    upload: 'Upload',
+    title: 'Title',
+    alt: 'Alt text',
+    save: 'Save',
+    cancel: 'Cancel',
+    empty: 'No media found',
+    loading: 'Loading media…',
+    choose: 'Choose media',
+    trash: 'Trash',
+    purge: 'Delete permanently',
+    purgeWarning: 'This permanently deletes the file. This cannot be undone.',
+    edit: 'Edit metadata',
+    preview: 'View larger',
+    replace: 'Replace file',
+    unavailable: 'Provider service unavailable',
+    untyped: 'Some assets have no recorded content type and only appear under All.',
+};
+//# sourceMappingURL=messages.en.js.map

package/dist/media/models.d.ts

@@ -0,0 +1,72 @@
+import type { MediaAsset as PickerAsset } from '../contracts/media-picker.js';
+export interface MediaAsset extends PickerAsset {
+    /** Optional for hosts without CMS metadata; blank dimensions mean native size, never inferred. */
+    readonly slug?: string;
+    readonly width?: number | null;
+    readonly height?: number | null;
+    readonly cssClass?: string | null;
+    readonly htmlAttributes?: string | null;
+    readonly byteSize?: number;
+    readonly status: 'active' | 'trashed';
+    readonly sha256: string;
+    readonly caption: string;
+    readonly credit: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly version: number;
+}
+export type MediaTabId = 'all' | 'images' | 'videos' | 'external-providers';
+export type MediaContentTabId = Exclude<MediaTabId, 'external-providers'>;
+export type MediaOrderBy = 'created' | 'alphabetical';
+export interface MediaQuery {
+    /** All retains the legacy mixed library; Trash is an explicit status filter. */
+    readonly status?: 'active' | 'trashed';
+    readonly filter?: MediaContentTabId;
+    readonly search?: string;
+    readonly orderBy?: MediaOrderBy;
+}
+export interface UploadInput {
+    readonly filename: string;
+    readonly contentType: string;
+    readonly dataBase64: string;
+}
+export interface MediaMetadataPatch {
+    /** Independent of title; clearing a title must never rewrite a readable reference. */
+    readonly slug?: string;
+    readonly width?: number | null;
+    readonly height?: number | null;
+    readonly cssClass?: string | null;
+    readonly htmlAttributes?: string | null;
+    readonly title?: string;
+    readonly alt?: string;
+    readonly caption?: string;
+    readonly credit?: string;
+}
+export interface MediaRequestOptions {
+    readonly signal?: AbortSignal;
+}
+export interface MediaProvider {
+    readonly id: string;
+    readonly label: string;
+    readonly configured: boolean;
+    readonly baseUrl?: string;
+    readonly model?: string;
+    /** A display-only tail, never recoverable credential material. */
+    readonly apiKeyTail?: string;
+}
+export interface MediaProviderOption {
+    readonly id: string;
+    readonly label: string;
+    readonly defaultBaseUrl?: string;
+    readonly models?: readonly string[];
+}
+/** Only operator-entered keys travel to the host; reads return markers and tails. */
+export interface MediaProviderConfiguration {
+    apiKey?: string;
+    apiKeyConfigured?: boolean;
+    apiKeyTail?: string;
+    baseUrl?: string;
+    model?: string;
+}
+export type MediaProviderConfigurationMap = Record<string, MediaProviderConfiguration>;
+//# sourceMappingURL=models.d.ts.map

package/dist/media/models.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=models.js.map

package/dist/media/ports.d.ts

@@ -0,0 +1,75 @@
+import type { MediaAsset, MediaQuery, UploadInput, MediaMetadataPatch, MediaRequestOptions, MediaProvider, MediaProviderOption, MediaProviderConfigurationMap } from './models.js';
+/** One shared port rather than one per hook — all three hooks read/write the same
+ * resource, and a test double for one is a test double for the resource, not for a single screen.
+ * Every synchronous URL builder goes through its consumer's port uniformly, so a test can
+ * prove a URL came from the injected port rather than the consumer calling the client itself. */
+export interface MediaApiPort {
+    readonly replaceSupported?: boolean;
+    readonly restoreSupported?: boolean;
+    list(required: MediaQuery, optional?: MediaRequestOptions): Promise<readonly MediaAsset[]>;
+    upload(required: UploadInput, optional?: MediaRequestOptions & MediaMetadataPatch): Promise<MediaAsset>;
+    update(required: {
+        id: string;
+        patch: MediaMetadataPatch;
+    }, optional?: MediaRequestOptions): Promise<MediaAsset>;
+    /** Optional: replacement preserves identity and references; never upload then trash. */
+    replace?(required: {
+        id: string;
+        upload: UploadInput;
+    }, optional?: MediaRequestOptions): Promise<MediaAsset>;
+    trash(required: {
+        id: string;
+    }, optional?: MediaRequestOptions): Promise<MediaAsset>;
+    /** Optional reversible recovery. Absence or explicit disable must hide the action. */
+    restore?(required: {
+        id: string;
+    }, optional?: MediaRequestOptions): Promise<MediaAsset>;
+    /** Genuine irreversible purge; requires a previously trashed asset. No undo affordance. */
+    delete(required: {
+        id: string;
+    }, optional?: MediaRequestOptions): Promise<{
+        purged: boolean;
+    }>;
+    originalUrl(required: {
+        id: string;
+        version?: number;
+    }, optional?: Record<string, never>): string;
+}
+export interface MediaProvidersPort {
+    /** Host-owned vendor metadata, available even when the credential service is unreachable. */
+    readonly catalog?: readonly MediaProviderOption[];
+    readonly pinnedProviderIds?: readonly string[];
+    /** One serialized whole-set save. Omission removes an entry; blank keys retain stored keys.
+     * Hosts preserve providers outside their catalog and return only public markers. */
+    saveChanges?(required: {
+        providers: MediaProviderConfigurationMap;
+    }, optional?: MediaRequestOptions): Promise<readonly MediaProvider[]>;
+    /** null leaves local edits untouched, while [] is a real answer that can legitimately
+     * drop stale local markers. Collapsing an unreachable server to [] would make a transient
+     * network blip read as "the server manages nothing" and wipe edits only null protects. */
+    list(required: Record<string, never>, optional?: MediaRequestOptions): Promise<readonly MediaProvider[] | null>;
+    /** Optional endpoint/model configuration, without credential material. */
+    saveSettings?(required: {
+        id: string;
+        baseUrl: string;
+        model: string;
+    }, optional?: MediaRequestOptions): Promise<MediaProvider>;
+    /** Never returns secrets. The server owns credential storage, validation and authorization. */
+    saveCredential(required: {
+        id: string;
+        credential: string;
+    }, optional?: MediaRequestOptions): Promise<MediaProvider>;
+    removeCredential(required: {
+        id: string;
+    }, optional?: MediaRequestOptions): Promise<MediaProvider>;
+}
+export declare const mediaApiToken: import("../core/module/token.js").AdminPortToken<MediaApiPort, "admin.media.api">;
+export declare const mediaProvidersToken: import("../core/module/token.js").AdminPortToken<MediaProvidersPort, "admin.media.providers">;
+/** A host refresh carries no rows; the controller rereads through its own authorized API. */
+export interface MediaEventsPort {
+    subscribe(required: {
+        onRefresh: () => void;
+    }, optional?: Record<string, never>): () => void;
+}
+export declare const mediaEventsToken: import("../core/module/token.js").AdminPortToken<MediaEventsPort, "admin.media.events">;
+//# sourceMappingURL=ports.d.ts.map

package/dist/media/ports.js

@@ -0,0 +1,7 @@
+import { adminPort } from '../core/module/token.js';
+export const mediaApiToken = adminPort({ id: 'admin.media.api' });
+export const mediaProvidersToken = adminPort({
+    id: 'admin.media.providers',
+});
+export const mediaEventsToken = adminPort({ id: 'admin.media.events' });
+//# sourceMappingURL=ports.js.map

package/dist/media/react/components/EditMediaPanel.d.ts

@@ -0,0 +1,3 @@
+import type { EditMediaPanelProps } from '../hooks/EditMediaPanel.hooks.js';
+export declare function EditMediaPanel(props: EditMediaPanelProps, _optional?: Record<string, never>): import("react").JSX.Element;
+//# sourceMappingURL=EditMediaPanel.d.ts.map

package/dist/media/react/components/EditMediaPanel.js

@@ -0,0 +1,10 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { MediaDialog } from './MediaDialog.js';
+import { Button, TextField } from '@jini-ai/ui-kit/react';
+import { useEditMediaPanel } from '../hooks/EditMediaPanel.hooks.js';
+import { UploadButton } from './UploadButton.js';
+export function EditMediaPanel(props, _optional = {}) {
+    const vm = useEditMediaPanel(props);
+    return (_jsx(MediaDialog, { className: "jini-media-edit-dialog", attrs: { 'data-jini-part': 'media.editor', 'data-agent-element': 'media-edit-dialog' }, title: vm.title, open: true, onClose: vm.close, pending: vm.saving, children: _jsxs("section", { className: "jini-media-edit-modal-body", "data-agent-element": "media-edit-panel", children: [_jsx("div", { className: "jini-field-group", children: vm.fieldRows.map(row => _jsx("div", { className: row.className, children: row.fields.map(field => _jsx(TextField, { ...field, disabled: vm.saving }, field.fieldId)) }, row.id)) }), vm.hint && _jsx("p", { className: "jini-field-error", role: "status", children: vm.hint }), vm.copies.map(row => _jsxs("div", { className: "jini-field", "data-jini-part": "media.editor.reference", children: [_jsx("span", { className: "jini-field-label", children: row.label }), _jsxs("div", { className: "jini-field-readonly-row", children: [row.isLink ? _jsx("a", { className: "jini-field-mono jini-field-readonly", href: row.value, target: "_blank", rel: "noreferrer", children: row.value }) : _jsx("code", { className: "jini-field-mono jini-field-readonly", children: row.value }), _jsx(Button, { variant: "ghost", attrs: row.attrs, onPress: row.copy, children: row.buttonLabel })] })] }, row.id)), vm.canReplace && _jsx("div", { className: "jini-media-replace-controls", "data-jini-part": "media.editor.replace", children: _jsx(UploadButton, { multiple: false, label: "Replace file", upload: vm.replace, withAlt: false, disabled: vm.saving }) }), vm.snapshot?.error && _jsx("p", { className: "jini-save-error", role: "alert", children: vm.snapshot.error }), _jsxs("div", { className: "jini-editor-actions", "data-jini-part": "media.actions", children: [_jsx(Button, { attrs: { 'data-jini-part': 'media.editor.save', 'data-agent-element': 'media-edit-save' }, onPress: vm.onSave, pending: vm.saving, children: "Save" }), _jsx(Button, { variant: "secondary", attrs: { 'data-jini-part': 'media.editor.cancel', 'data-agent-element': 'media-edit-cancel' }, onPress: vm.close, disabled: vm.saving, children: "Cancel" })] })] }) }));
+}
+//# sourceMappingURL=EditMediaPanel.js.map

package/dist/media/react/components/MediaCard.d.ts

@@ -0,0 +1,5 @@
+import type { MediaCardProps } from '../hooks/MediaCard.hooks.js';
+/** The lightbox uses the same fallback chain without the grid's metadata and actions. */
+export declare function MediaPreview(props: MediaCardProps, _optional?: Record<string, never>): import("react").JSX.Element;
+export declare function MediaCard(props: MediaCardProps, _optional?: Record<string, never>): import("react").JSX.Element;
+//# sourceMappingURL=MediaCard.d.ts.map

package/dist/media/react/components/MediaCard.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Badge, Button, Menu } from '@jini-ai/ui-kit/react';
+import { useMediaCard } from '../hooks/MediaCard.hooks.js';
+import { EyeIcon, ExpandIcon, DocumentIcon } from './MediaIcons.js';
+function PreviewMarkup(vm, _optional = {}) {
+    return _jsxs(_Fragment, { children: [vm.image ? (vm.imagePreview ? _jsxs(Button, { className: "jini-media-card-expand jini-media-card-expand-fill", variant: "ghost", attrs: vm.previewAttrs, onPress: vm.preview, children: [_jsx("img", { className: "jini-media-card-media", src: vm.src, alt: vm.alt, loading: "lazy", onError: vm.onImageError }), _jsx(ExpandIcon, {})] }) : _jsx("img", { className: "jini-media-card-media", src: vm.src, alt: vm.alt, loading: "lazy", onError: vm.onImageError })) : vm.video ? (_jsx("video", { className: "jini-media-card-media", src: vm.src, controls: true, preload: "metadata", "aria-label": vm.alt, onError: vm.onVideoError })) : (_jsxs("div", { className: "jini-media-card-placeholder", children: [_jsx(DocumentIcon, {}), _jsx("p", { className: "jini-media-card-placeholder-text", children: "Preview not available" }), vm.src && _jsx("a", { className: "jini-media-card-placeholder-link", href: vm.src, target: "_blank", rel: "noreferrer", children: "Download original" })] })), vm.onEdit && _jsxs(Button, { className: "jini-media-card-edit", variant: "ghost", attrs: vm.editAttrs, onPress: vm.onEdit, disabled: vm.busy, children: [_jsx(EyeIcon, {}), _jsx("span", { className: "jini-visually-hidden", children: "Edit metadata" })] }), vm.canPreview && !vm.imagePreview && _jsxs(Button, { className: "jini-media-card-expand", variant: "ghost", attrs: vm.previewAttrs, onPress: vm.preview, children: [_jsx(ExpandIcon, {}), _jsx("span", { className: "jini-visually-hidden", children: "View larger" })] })] });
+}
+/** The lightbox uses the same fallback chain without the grid's metadata and actions. */
+export function MediaPreview(props, _optional = {}) {
+    const vm = useMediaCard(props);
+    return _jsx(PreviewMarkup, { ...vm });
+}
+export function MediaCard(props, _optional = {}) {
+    const vm = useMediaCard(props);
+    return _jsxs("article", { className: "jini-media-card", "data-jini-part": "media.card", "data-media-id": vm.item.id, tabIndex: -1, children: [_jsx("div", { className: "jini-media-card-preview", "data-jini-part": "media.preview.frame", children: _jsx(PreviewMarkup, { ...vm }) }), _jsxs("div", { className: "jini-media-card-body", children: [_jsx("h3", { className: "jini-media-card-title", title: vm.item.title, children: vm.item.title }), _jsxs("div", { className: "jini-media-card-meta", children: [_jsx(Badge, { className: vm.statusClassName, attrs: { 'data-jini-part': 'media.status' }, tone: vm.statusTone, children: vm.statusLabel }), vm.menuItems.length > 0 && _jsx(Menu, { label: vm.menuLabel, attrs: vm.menuAttrs, items: vm.menuItems, disabled: vm.busy })] }), vm.byteSize && _jsx("p", { className: "jini-media-card-size", hidden: true, children: vm.byteSize }), vm.onChoose && _jsx(Button, { attrs: { 'data-jini-part': 'media.choose', 'data-agent-element': `media-choose-${vm.item.id}` }, onPress: vm.onChoose, children: "Choose" })] })] });
+}
+//# sourceMappingURL=MediaCard.js.map

package/dist/media/react/components/MediaDialog.d.ts

@@ -0,0 +1,3 @@
+import type { MediaDialogProps } from '../hooks/MediaDialog.hooks.js';
+export declare function MediaDialog(props: MediaDialogProps, _optional?: Record<string, never>): import("react").JSX.Element | null;
+//# sourceMappingURL=MediaDialog.d.ts.map

package/dist/media/react/components/MediaDialog.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Dialog } from '@jini-ai/ui-kit/react';
+import { useMediaDialog } from '../hooks/MediaDialog.hooks.js';
+export function MediaDialog(props, _optional = {}) {
+    const vm = useMediaDialog(props);
+    return vm.open ? _jsx(Dialog, { ...vm.dialogProps }) : null;
+}
+//# sourceMappingURL=MediaDialog.js.map

package/dist/media/react/components/MediaGrid.d.ts

@@ -0,0 +1,4 @@
+import type { MediaGridProps } from '../hooks/MediaGrid.hooks.js';
+export type { MediaGridProps } from '../hooks/MediaGrid.hooks.js';
+export declare function MediaGrid(props: MediaGridProps, _optional?: Record<string, never>): import("react").JSX.Element;
+//# sourceMappingURL=MediaGrid.d.ts.map

package/dist/media/react/components/MediaGrid.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { MediaCard } from './MediaCard.js';
+import { useMediaGrid } from '../hooks/MediaGrid.hooks.js';
+export function MediaGrid(props, _optional = {}) {
+    const vm = useMediaGrid(props);
+    return (_jsx("div", { className: vm.className, "data-jini-part": "media.grid", ref: vm.gridRef, tabIndex: -1, "aria-label": "Media library", children: vm.actions.length ? (vm.actions.map((action) => (_jsx(MediaCard, { ...action, api: vm.api, ...(vm.busy === undefined ? {} : { busy: vm.busy }) }, action.item.id)))) : (_jsx("div", { className: "jini-card", children: _jsx("div", { className: "jini-empty-state", children: _jsx("p", { className: "jini-empty-state-title", children: vm.emptyLabel ?? 'No media found' }) }) })) }));
+}
+//# sourceMappingURL=MediaGrid.js.map

package/dist/media/react/components/MediaIcons.d.ts

@@ -0,0 +1,14 @@
+/** Small native SVGs travel with the markup; the host chooses their presentation. */
+export declare function DocumentIcon(_required: Record<string, never>, _optional?: Record<string, never>): import("react").JSX.Element;
+export declare function ReloadIcon(_required: Record<string, never>, _optional?: Record<string, never>): import("react").JSX.Element;
+export declare function HiddenEyeIcon(_required: Record<string, never>, _optional?: Record<string, never>): import("react").JSX.Element;
+export declare function EyeIcon(_required: Record<string, never>, _optional?: Record<string, never>): import("react").JSX.Element;
+export declare function ExpandIcon(_required: Record<string, never>, _optional?: Record<string, never>): import("react").JSX.Element;
+export declare function CloseIcon(_required: Record<string, never>, _optional?: Record<string, never>): import("react").JSX.Element;
+export declare function PreviousIcon(_required: Record<string, never>, _optional?: Record<string, never>): import("react").JSX.Element;
+export declare function NextIcon(_required: Record<string, never>, _optional?: Record<string, never>): import("react").JSX.Element;
+export declare function AllIcon(_required: Record<string, never>, _optional?: Record<string, never>): import("react").JSX.Element;
+export declare function ImageIcon(_required: Record<string, never>, _optional?: Record<string, never>): import("react").JSX.Element;
+export declare function VideoIcon(_required: Record<string, never>, _optional?: Record<string, never>): import("react").JSX.Element;
+export declare function CloudIcon(_required: Record<string, never>, _optional?: Record<string, never>): import("react").JSX.Element;
+//# sourceMappingURL=MediaIcons.d.ts.map

package/dist/media/react/components/MediaIcons.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** Small native SVGs travel with the markup; the host chooses their presentation. */
+export function DocumentIcon(_required, _optional = {}) {
+    return _jsxs("svg", { className: "jini-icon", viewBox: "0 0 18 18", fill: "none", stroke: "currentColor", strokeWidth: "1.5", "aria-hidden": "true", children: [_jsx("path", { className: "jini-icon-path", d: "M5 2h6l3 3v11H5V2z", strokeLinejoin: "round" }), _jsx("path", { className: "jini-icon-path", d: "M11 2v3h3", strokeLinejoin: "round" })] });
+}
+export function ReloadIcon(_required, _optional = {}) {
+    return _jsxs("svg", { className: "jini-icon", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.6", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", focusable: "false", children: [_jsx("path", { className: "jini-icon-path", d: "M3 12a9 9 0 0 1 15.9-5.7L21 8" }), _jsx("path", { className: "jini-icon-path", d: "M21 3v5h-5" }), _jsx("path", { className: "jini-icon-path", d: "M21 12a9 9 0 0 1-15.9 5.7L3 16" }), _jsx("path", { className: "jini-icon-path", d: "M3 21v-5h5" })] });
+}
+export function HiddenEyeIcon(_required, _optional = {}) {
+    return _jsx("svg", { className: "jini-icon", viewBox: "0 0 18 18", fill: "none", stroke: "currentColor", strokeWidth: "1.5", "aria-hidden": "true", children: _jsx("path", { className: "jini-icon-path", d: "m2 2 14 14M7 3.8A8 8 0 0 1 9 3.5c4.5 0 7.5 5.5 7.5 5.5a13 13 0 0 1-2.2 2.8M11 14.2a8 8 0 0 1-2 .3C4.5 14.5 1.5 9 1.5 9a13 13 0 0 1 2.2-2.8", strokeLinecap: "round", strokeLinejoin: "round" }) });
+}
+export function EyeIcon(_required, _optional = {}) {
+    return _jsxs("svg", { className: "jini-icon", viewBox: "0 0 18 18", fill: "none", stroke: "currentColor", strokeWidth: "1.5", "aria-hidden": "true", children: [_jsx("path", { className: "jini-icon-path", d: "M1.5 9S4.5 3.5 9 3.5 16.5 9 16.5 9 13.5 14.5 9 14.5 1.5 9 1.5 9Z" }), _jsx("circle", { className: "jini-icon-circle", cx: "9", cy: "9", r: "2.25" })] });
+}
+export function ExpandIcon(_required, _optional = {}) {
+    return _jsx("svg", { className: "jini-icon", viewBox: "0 0 18 18", fill: "none", stroke: "currentColor", strokeWidth: "1.5", "aria-hidden": "true", children: _jsx("path", { className: "jini-icon-path", d: "M6 2H2v4m10-4h4v4M2 12v4h4m10-4v4h-4" }) });
+}
+export function CloseIcon(_required, _optional = {}) {
+    return _jsx("svg", { className: "jini-icon", viewBox: "0 0 18 18", fill: "none", stroke: "currentColor", strokeWidth: "1.5", "aria-hidden": "true", children: _jsx("path", { className: "jini-icon-path", d: "m4 4 10 10M14 4 4 14" }) });
+}
+export function PreviousIcon(_required, _optional = {}) {
+    return _jsx("svg", { className: "jini-icon", viewBox: "0 0 18 18", fill: "none", stroke: "currentColor", strokeWidth: "1.5", "aria-hidden": "true", children: _jsx("path", { className: "jini-icon-path", d: "m11 4-5 5 5 5" }) });
+}
+export function NextIcon(_required, _optional = {}) {
+    return _jsx("svg", { className: "jini-icon", viewBox: "0 0 18 18", fill: "none", stroke: "currentColor", strokeWidth: "1.5", "aria-hidden": "true", children: _jsx("path", { className: "jini-icon-path", d: "m7 4 5 5-5 5" }) });
+}
+export function AllIcon(_required, _optional = {}) {
+    return _jsxs("svg", { className: "jini-icon", width: "16", height: "16", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("rect", { className: "jini-icon-rect", x: "4", y: "4", width: "6.5", height: "6.5", rx: "1.2" }), _jsx("rect", { className: "jini-icon-rect", x: "13.5", y: "4", width: "6.5", height: "6.5", rx: "1.2" }), _jsx("rect", { className: "jini-icon-rect", x: "4", y: "13.5", width: "6.5", height: "6.5", rx: "1.2" }), _jsx("rect", { className: "jini-icon-rect", x: "13.5", y: "13.5", width: "6.5", height: "6.5", rx: "1.2" })] });
+}
+export function ImageIcon(_required, _optional = {}) {
+    return _jsxs("svg", { className: "jini-icon", width: "16", height: "16", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("rect", { className: "jini-icon-rect", x: "3.5", y: "5", width: "17", height: "14", rx: "2" }), _jsx("circle", { className: "jini-icon-circle", cx: "8.5", cy: "9.5", r: "1.5" }), _jsx("path", { className: "jini-icon-path", d: "M20.5 15.5 16 11l-6.5 6.5M3.5 17l3.5-3.5 2.5 2.5" })] });
+}
+export function VideoIcon(_required, _optional = {}) {
+    return _jsxs("svg", { className: "jini-icon", width: "16", height: "16", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("rect", { className: "jini-icon-rect", x: "3.5", y: "5", width: "17", height: "14", rx: "2" }), _jsx("path", { className: "jini-icon-path", d: "M10.25 9.25v5.5l4.5-2.75z" })] });
+}
+export function CloudIcon(_required, _optional = {}) {
+    return _jsx("svg", { className: "jini-icon", width: "16", height: "16", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { className: "jini-icon-path", d: "M7 16h9.5a3.5 3.5 0 0 0 .4-6.98A4.75 4.75 0 0 0 7.7 7.2 3.5 3.5 0 0 0 7 16Z" }) });
+}
+//# sourceMappingURL=MediaIcons.js.map

package/dist/media/react/components/MediaLightbox.d.ts

@@ -0,0 +1,5 @@
+import type { MediaLightboxProps } from '../hooks/MediaLightbox.hooks.js';
+/** One shared dialog for the grid: mounting N real dialogs to show at most one open
+ * at a time buys nothing and costs N DOM subtrees. */
+export declare function MediaLightbox(props: MediaLightboxProps, _optional?: Record<string, never>): import("react").JSX.Element;
+//# sourceMappingURL=MediaLightbox.d.ts.map

package/dist/media/react/components/MediaLightbox.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { MediaDialog } from './MediaDialog.js';
+import { useMediaLightbox } from '../hooks/MediaLightbox.hooks.js';
+import { CloseIcon, PreviousIcon, NextIcon } from './MediaIcons.js';
+import { MediaPreview } from './MediaCard.js';
+/** One shared dialog for the grid: mounting N real dialogs to show at most one open
+ * at a time buys nothing and costs N DOM subtrees. */
+export function MediaLightbox(props, _optional = {}) {
+    const vm = useMediaLightbox(props);
+    return (_jsxs(MediaDialog, { className: "jini-media-lightbox", dialogRef: vm.dialogRef, attrs: { 'data-jini-part': 'media.lightbox', 'data-jini-size': 'large' }, title: vm.title, open: vm.open, onClose: vm.onClose, children: [_jsxs("div", { className: "jini-media-lightbox-header", children: [_jsx("span", { className: "jini-media-lightbox-title", "aria-hidden": "true", children: vm.item?.title }), _jsx("span", { className: "jini-media-lightbox-counter", children: vm.position }), _jsxs("button", { type: "button", className: "jini-media-lightbox-close", ref: vm.closeRef, "data-jini-part": "media.lightbox.close", "data-agent-element": "media-lightbox-close", "data-jini-autofocus": true, onClick: vm.onClose, children: [_jsx(CloseIcon, {}), _jsx("span", { className: "jini-visually-hidden", children: "Close" })] })] }), _jsxs("div", { className: "jini-media-lightbox-stage", children: [vm.hasPrev && _jsxs("button", { type: "button", className: "jini-media-lightbox-nav jini-media-lightbox-nav-prev", "data-jini-part": "media.lightbox.previous", "data-agent-element": "media-lightbox-prev", onClick: vm.previous, children: [_jsx(PreviousIcon, {}), _jsx("span", { className: "jini-visually-hidden", children: "Previous" })] }), _jsx("div", { className: "jini-media-lightbox-media", children: vm.item && _jsx(MediaPreview, { item: vm.item, api: vm.api }, vm.item.id) }), vm.hasNext && _jsxs("button", { type: "button", className: "jini-media-lightbox-nav jini-media-lightbox-nav-next", "data-jini-part": "media.lightbox.next", "data-agent-element": "media-lightbox-next", onClick: vm.next, children: [_jsx(NextIcon, {}), _jsx("span", { className: "jini-visually-hidden", children: "Next" })] })] })] }));
+}
+//# sourceMappingURL=MediaLightbox.js.map

package/dist/media/react/components/MediaPicker.d.ts

@@ -0,0 +1,3 @@
+import type { MediaPickerProps } from '../hooks/MediaPicker.hooks.js';
+export declare function MediaPicker(props: MediaPickerProps, _optional?: Record<string, never>): import("react").JSX.Element;
+//# sourceMappingURL=MediaPicker.d.ts.map

package/dist/media/react/components/MediaPicker.js

@@ -0,0 +1,10 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { MediaDialog } from './MediaDialog.js';
+import { Button, TextField } from '@jini-ai/ui-kit/react';
+import { useMediaPicker } from '../hooks/MediaPicker.hooks.js';
+import { MediaGrid } from './MediaGrid.js';
+export function MediaPicker(props, _optional = {}) {
+    const vm = useMediaPicker(props);
+    return (_jsxs(MediaDialog, { className: "jini-media-picker-dialog", attrs: { 'data-jini-part': 'media.picker' }, title: "Choose media", open: true, onClose: vm.onClose, children: [_jsx(TextField, { attrs: { 'data-jini-part': 'media.picker.search' }, label: "Search media", value: vm.search, onValueChange: vm.onSearch }), vm.snapshot?.error && _jsxs("div", { className: "jini-notice jini-notice-error", children: [_jsx("p", { className: "jini-notice-text", role: "alert", children: vm.snapshot.error }), _jsx(Button, { onPress: vm.onRetry, children: "Retry" })] }), vm.loading ? (_jsx("p", { className: "jini-notice", role: "status", children: "Loading media\u2026" })) : (_jsx(MediaGrid, { actions: vm.actions, api: vm.api })), _jsx(Button, { attrs: { 'data-jini-part': 'media.picker.cancel', 'data-jini-autofocus': true }, onPress: vm.onClose, children: "Cancel" })] }));
+}
+//# sourceMappingURL=MediaPicker.js.map

package/dist/media/react/components/MediaPurgeDialog.d.ts

@@ -0,0 +1,4 @@
+import type { MediaPurgeDialogProps } from '../hooks/MediaPurgeDialog.hooks.js';
+/** Views are overridable; ui-kit owns cancel-first focus and pending/agent guards. */
+export declare function MediaPurgeDialog(props: MediaPurgeDialogProps, _optional?: Record<string, never>): import("react").JSX.Element;
+//# sourceMappingURL=MediaPurgeDialog.d.ts.map

package/dist/media/react/components/MediaPurgeDialog.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { ConfirmDialog } from '@jini-ai/ui-kit/react';
+import { useMediaPurgeDialog } from '../hooks/MediaPurgeDialog.hooks.js';
+/** Views are overridable; ui-kit owns cancel-first focus and pending/agent guards. */
+export function MediaPurgeDialog(props, _optional = {}) {
+    const vm = useMediaPurgeDialog(props);
+    return _jsx(ConfirmDialog, { open: props.open, pending: props.pending, title: "Delete permanently?", agentHandle: "media-purge", confirmLabel: "Delete permanently", tone: "danger", agentMayConfirm: false, consequence: vm.consequence, actionAccessibleNames: vm.actionAccessibleNames, attrs: { 'data-jini-part': 'media.purge', 'data-agent-element': 'media-purge' }, onCancel: props.onCancel, onConfirm: props.onConfirm });
+}
+//# sourceMappingURL=MediaPurgeDialog.js.map

package/dist/media/react/components/UploadButton.d.ts

@@ -0,0 +1,3 @@
+import type { UploadButtonProps } from '../hooks/UploadButton.hooks.js';
+export declare function UploadButton(props: UploadButtonProps, _optional?: Record<string, never>): import("react").JSX.Element;
+//# sourceMappingURL=UploadButton.d.ts.map

package/dist/media/react/components/UploadButton.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button, TextField } from '@jini-ai/ui-kit/react';
+import { useUploadButton } from '../hooks/UploadButton.hooks.js';
+export function UploadButton(props, _optional = {}) {
+    const vm = useUploadButton(props);
+    return (_jsxs("div", { className: "jini-toolbar jini-media-upload", "data-jini-part": "media.upload", "data-agent-element": vm.handles.toolbar, onDragOver: vm.onDragOver, onDrop: vm.onDrop, children: [_jsx(Button, { variant: "secondary", onPress: vm.onPress, disabled: vm.disabled, children: vm.chooseLabel }), _jsx("span", { className: "jini-media-upload-filename", "aria-live": "polite", children: vm.selectedFileName }), vm.withAlt && _jsx(TextField, { attrs: { 'data-jini-part': 'media.upload.alt', 'data-agent-element': vm.handles.alt }, className: "jini-media-upload-alt", placeholder: "Alt text (optional)", label: vm.altLabel, value: vm.alt, onValueChange: vm.setAlt }), _jsx("input", { className: "jini-media-upload-file", "data-jini-part": "media.upload.file", "data-agent-element": vm.handles.file, accept: "image/jpeg,image/png,image/webp,image/gif,image/avif,video/mp4,video/webm", ref: vm.inputRef, "aria-label": "File to upload", type: "file", hidden: true, multiple: vm.multiple, onChange: vm.onFile, disabled: vm.disabled }), _jsx(Button, { attrs: { 'data-jini-part': 'media.upload.button', 'data-agent-element': vm.handles.submit }, onPress: vm.onUpload, disabled: vm.uploadDisabled, children: vm.label }), _jsx("p", { className: "jini-media-success", role: "status", "aria-live": "polite", "aria-atomic": "true", children: vm.success }), vm.error && _jsx("p", { className: "jini-notice jini-notice-error", role: "alert", children: vm.error })] }));
+}
+//# sourceMappingURL=UploadButton.js.map