@seshuk/payload-media-preview 1.0.0

package/dist/translations/locales/ko.js

@@ -0,0 +1,11 @@
+export const ko = {
+    '@seshuk/payload-media-preview': {
+        close: '닫기',
+        label: '미리보기',
+        open: '열기',
+        titleAudio: '오디오 미리보기',
+        titleDocument: '문서 미리보기',
+        titleImage: '이미지 미리보기',
+        titleVideo: '비디오 미리보기'
+    }
+};

package/dist/translations/locales/lt.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const lt: PluginDefaultTranslationsObject;

package/dist/translations/locales/lt.js

@@ -0,0 +1,11 @@
+export const lt = {
+    '@seshuk/payload-media-preview': {
+        close: 'Uždaryti',
+        label: 'Peržiūra',
+        open: 'Atidaryti',
+        titleAudio: 'Garso peržiūra',
+        titleDocument: 'Dokumento peržiūra',
+        titleImage: 'Vaizdo peržiūra',
+        titleVideo: 'Video peržiūra'
+    }
+};

package/dist/translations/locales/lv.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const lv: PluginDefaultTranslationsObject;

package/dist/translations/locales/lv.js

@@ -0,0 +1,11 @@
+export const lv = {
+    '@seshuk/payload-media-preview': {
+        close: 'Aizvērt',
+        label: 'Priekšskatījums',
+        open: 'Atvērt',
+        titleAudio: 'Audio priekšskatījums',
+        titleDocument: 'Dokumenta priekšskatījums',
+        titleImage: 'Attēla priekšskatījums',
+        titleVideo: 'Video priekšskatījums'
+    }
+};

package/dist/translations/locales/my.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const my: PluginDefaultTranslationsObject;

package/dist/translations/locales/my.js

@@ -0,0 +1,11 @@
+export const my = {
+    '@seshuk/payload-media-preview': {
+        close: 'ပိတ်မည်',
+        label: 'အစမ်းကြည့်ရှုခြင်း',
+        open: 'ဖွင့်မည်',
+        titleAudio: 'အသံ အကြိုကြည့်ရှုခြင်း',
+        titleDocument: 'စာရွက်စာတမ်း အကြိုကြည့်ရှုခြင်း',
+        titleImage: 'ပုံ အကြိုကြည့်ရှုခြင်း',
+        titleVideo: 'ဗီဒီယို အကြိုကြည့်ရှုခြင်း'
+    }
+};

package/dist/translations/locales/nb.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const nb: PluginDefaultTranslationsObject;

package/dist/translations/locales/nb.js

@@ -0,0 +1,11 @@
+export const nb = {
+    '@seshuk/payload-media-preview': {
+        close: 'Lukk',
+        label: 'Forhåndsvisning',
+        open: 'Åpne',
+        titleAudio: 'Lydforhåndsvisning',
+        titleDocument: 'Dokumentforhåndsvisning',
+        titleImage: 'Bildeforhåndsvisning',
+        titleVideo: 'Videoforhåndsvisning'
+    }
+};

package/dist/translations/locales/nl.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const nl: PluginDefaultTranslationsObject;

package/dist/translations/locales/nl.js

@@ -0,0 +1,11 @@
+export const nl = {
+    '@seshuk/payload-media-preview': {
+        close: 'Sluiten',
+        label: 'Voorbeeld',
+        open: 'Openen',
+        titleAudio: 'Audio preview',
+        titleDocument: 'Document preview',
+        titleImage: 'Afbeelding preview',
+        titleVideo: 'Video preview'
+    }
+};

package/dist/translations/locales/pl.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const pl: PluginDefaultTranslationsObject;

package/dist/translations/locales/pl.js

@@ -0,0 +1,11 @@
+export const pl = {
+    '@seshuk/payload-media-preview': {
+        close: 'Zamknij',
+        label: 'Podgląd',
+        open: 'Otwórz',
+        titleAudio: 'Podgląd audio',
+        titleDocument: 'Podgląd dokumentu',
+        titleImage: 'Podgląd obrazu',
+        titleVideo: 'Podgląd wideo'
+    }
+};

package/dist/translations/locales/pt.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const pt: PluginDefaultTranslationsObject;

package/dist/translations/locales/pt.js

@@ -0,0 +1,11 @@
+export const pt = {
+    '@seshuk/payload-media-preview': {
+        close: 'Fechar',
+        label: 'Visualização',
+        open: 'Abrir',
+        titleAudio: 'Pré-visualização de áudio',
+        titleDocument: 'Pré-visualização de documento',
+        titleImage: 'Pré-visualização de imagem',
+        titleVideo: 'Pré-visualização de vídeo'
+    }
+};

package/dist/translations/locales/ro.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const ro: PluginDefaultTranslationsObject;

package/dist/translations/locales/ro.js

@@ -0,0 +1,11 @@
+export const ro = {
+    '@seshuk/payload-media-preview': {
+        close: 'Închide',
+        label: 'Previzualizare',
+        open: 'Deschide',
+        titleAudio: 'Previzualizare audio',
+        titleDocument: 'Previzualizare document',
+        titleImage: 'Previzualizare imagine',
+        titleVideo: 'Previzualizare video'
+    }
+};

package/dist/translations/locales/rs.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const rs: PluginDefaultTranslationsObject;

package/dist/translations/locales/rs.js

@@ -0,0 +1,11 @@
+export const rs = {
+    '@seshuk/payload-media-preview': {
+        close: 'Затвори',
+        label: 'Преглед',
+        open: 'Отвори',
+        titleAudio: 'Преглед аудиа',
+        titleDocument: 'Преглед документа',
+        titleImage: 'Преглед слике',
+        titleVideo: 'Преглед видеа'
+    }
+};

package/dist/translations/locales/rsLatin.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const rsLatin: PluginDefaultTranslationsObject;

package/dist/translations/locales/rsLatin.js

@@ -0,0 +1,11 @@
+export const rsLatin = {
+    '@seshuk/payload-media-preview': {
+        close: 'Zatvori',
+        label: 'Pregled',
+        open: 'Otvori',
+        titleAudio: 'Pregled audia',
+        titleDocument: 'Pregled dokumenta',
+        titleImage: 'Pregled slike',
+        titleVideo: 'Pregled videa'
+    }
+};

package/dist/translations/locales/ru.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const ru: PluginDefaultTranslationsObject;

package/dist/translations/locales/ru.js

@@ -0,0 +1,11 @@
+export const ru = {
+    '@seshuk/payload-media-preview': {
+        close: 'Закрыть',
+        label: 'Предпросмотр',
+        open: 'Открыть',
+        titleAudio: 'Предпросмотр аудио',
+        titleDocument: 'Предпросмотр документа',
+        titleImage: 'Предпросмотр изображения',
+        titleVideo: 'Предпросмотр видео'
+    }
+};

package/dist/translations/locales/sk.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const sk: PluginDefaultTranslationsObject;

package/dist/translations/locales/sk.js

@@ -0,0 +1,11 @@
+export const sk = {
+    '@seshuk/payload-media-preview': {
+        close: 'Zavrieť',
+        label: 'Náhľad',
+        open: 'Otvoriť',
+        titleAudio: 'Náhľad audia',
+        titleDocument: 'Náhľad dokumentu',
+        titleImage: 'Náhľad obrázka',
+        titleVideo: 'Náhľad videa'
+    }
+};

package/dist/translations/locales/sl.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const sl: PluginDefaultTranslationsObject;

package/dist/translations/locales/sl.js

@@ -0,0 +1,11 @@
+export const sl = {
+    '@seshuk/payload-media-preview': {
+        close: 'Zapri',
+        label: 'Predogled',
+        open: 'Odpri',
+        titleAudio: 'Predogled zvoka',
+        titleDocument: 'Predogled dokumenta',
+        titleImage: 'Predogled slike',
+        titleVideo: 'Predogled videa'
+    }
+};

package/dist/translations/locales/sv.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const sv: PluginDefaultTranslationsObject;

package/dist/translations/locales/sv.js

@@ -0,0 +1,11 @@
+export const sv = {
+    '@seshuk/payload-media-preview': {
+        close: 'Stäng',
+        label: 'Förhandsgranskning',
+        open: 'Öppna',
+        titleAudio: 'Ljudförhandsgranskning',
+        titleDocument: 'Dokumentförhandsgranskning',
+        titleImage: 'Bildförhandsgranskning',
+        titleVideo: 'Videoförhandsgranskning'
+    }
+};

package/dist/translations/locales/ta.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const ta: PluginDefaultTranslationsObject;

package/dist/translations/locales/ta.js

@@ -0,0 +1,11 @@
+export const ta = {
+    '@seshuk/payload-media-preview': {
+        close: 'மூடு',
+        label: 'முன்னோட்டம்',
+        open: 'திற',
+        titleAudio: 'ஆடியோ முன்னோட்டம்',
+        titleDocument: 'ஆவண முன்னோட்டம்',
+        titleImage: 'படம் முன்னோட்டம்',
+        titleVideo: 'வீடியோ முன்னோட்டம்'
+    }
+};

package/dist/translations/locales/th.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const th: PluginDefaultTranslationsObject;

package/dist/translations/locales/th.js

@@ -0,0 +1,11 @@
+export const th = {
+    '@seshuk/payload-media-preview': {
+        close: 'ปิด',
+        label: 'ตัวอย่าง',
+        open: 'เปิด',
+        titleAudio: 'ดูตัวอย่างเสียง',
+        titleDocument: 'ดูตัวอย่างเอกสาร',
+        titleImage: 'ดูตัวอย่างรูปภาพ',
+        titleVideo: 'ดูตัวอย่างวิดีโอ'
+    }
+};

package/dist/translations/locales/tr.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const tr: PluginDefaultTranslationsObject;

package/dist/translations/locales/tr.js

@@ -0,0 +1,11 @@
+export const tr = {
+    '@seshuk/payload-media-preview': {
+        close: 'Kapat',
+        label: 'Önizleme',
+        open: 'Aç',
+        titleAudio: 'Ses önizleme',
+        titleDocument: 'Belge önizleme',
+        titleImage: 'Resim önizleme',
+        titleVideo: 'Video önizleme'
+    }
+};

package/dist/translations/locales/uk.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const uk: PluginDefaultTranslationsObject;

package/dist/translations/locales/uk.js

@@ -0,0 +1,11 @@
+export const uk = {
+    '@seshuk/payload-media-preview': {
+        close: 'Закрити',
+        label: 'Попередній перегляд',
+        open: 'Відкрити',
+        titleAudio: 'Попередній перегляд аудіо',
+        titleDocument: 'Попередній перегляд документа',
+        titleImage: 'Попередній перегляд зображення',
+        titleVideo: 'Попередній перегляд відео'
+    }
+};

package/dist/translations/locales/vi.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const vi: PluginDefaultTranslationsObject;

package/dist/translations/locales/vi.js

@@ -0,0 +1,11 @@
+export const vi = {
+    '@seshuk/payload-media-preview': {
+        close: 'Đóng',
+        label: 'Xem trước',
+        open: 'Mở',
+        titleAudio: 'Xem trước âm thanh',
+        titleDocument: 'Xem trước tài liệu',
+        titleImage: 'Xem trước hình ảnh',
+        titleVideo: 'Xem trước video'
+    }
+};

package/dist/translations/locales/zh.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const zh: PluginDefaultTranslationsObject;

package/dist/translations/locales/zh.js

@@ -0,0 +1,11 @@
+export const zh = {
+    '@seshuk/payload-media-preview': {
+        close: '关闭',
+        label: '预览',
+        open: '打开',
+        titleAudio: '音频预览',
+        titleDocument: '文档预览',
+        titleImage: '图片预览',
+        titleVideo: '视频预览'
+    }
+};

package/dist/translations/locales/zhTw.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const zhTw: PluginDefaultTranslationsObject;

package/dist/translations/locales/zhTw.js

@@ -0,0 +1,11 @@
+export const zhTw = {
+    '@seshuk/payload-media-preview': {
+        close: '關閉',
+        label: '預覽',
+        open: '開啟',
+        titleAudio: '音訊預覽',
+        titleDocument: '文件預覽',
+        titleImage: '圖片預覽',
+        titleVideo: '影片預覽'
+    }
+};

package/dist/translations/types.d.ts

@@ -0,0 +1,11 @@
+export type PluginDefaultTranslationsObject = {
+    '@seshuk/payload-media-preview': {
+        close: string;
+        label: string;
+        open: string;
+        titleAudio: string;
+        titleDocument: string;
+        titleImage: string;
+        titleVideo: string;
+    };
+};

package/dist/translations/types.js

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

package/dist/types.d.ts

@@ -0,0 +1,130 @@
+import type { Plugin, UIField, UploadCollectionSlug } from 'payload';
+export type VideoViewerProps = {
+    autoPlay?: boolean;
+    className?: string;
+    controls?: boolean;
+    loop?: boolean;
+    mimeType?: string;
+    muted?: boolean;
+    preload?: 'auto' | 'metadata' | 'none';
+    src: string;
+    title?: string;
+};
+export type AudioViewerProps = {
+    autoPlay?: boolean;
+    className?: string;
+    controls?: boolean;
+    loop?: boolean;
+    mimeType?: string;
+    muted?: boolean;
+    preload?: 'auto' | 'metadata' | 'none';
+    src: string;
+    title?: string;
+};
+export type ImageViewerProps = {
+    alt?: string;
+    className?: string;
+    src: string;
+};
+export type IframeViewerProps = {
+    allow?: string;
+    allowFullScreen?: boolean;
+    className?: string;
+    loading?: 'eager' | 'lazy';
+    src: string;
+    title?: string;
+};
+export type MediaPreviewAdapterResolveArgs = {
+    doc: Record<string, unknown>;
+    mimeType?: string;
+    url?: string;
+};
+/** Returned by `resolve()` to render the adapter's component inside a modal. */
+export type MediaPreviewAdapterInlineResult = {
+    mode: 'inline';
+    props: Record<string, unknown>;
+};
+/** Returned by `resolve()` to open a URL in a new browser tab. */
+export type MediaPreviewAdapterNewTabResult = {
+    mode: 'newTab';
+    url: string;
+};
+export type MediaPreviewAdapterResolveResult = MediaPreviewAdapterInlineResult | MediaPreviewAdapterNewTabResult;
+/** Adapters are tried in order — first non-null `resolve()` result wins. */
+export type MediaPreviewAdapter = {
+    /**
+     * Import path for the viewer component (e.g. `'my-pkg/client#Player'`).
+     * Only needed when `resolve()` can return `mode: 'inline'`.
+     */
+    Component?: string;
+    name: string;
+    /**
+     * Decide how to preview a document.
+     *
+     * - Return `{ mode: 'inline', props }` to render `Component` in a modal.
+     * - Return `{ mode: 'newTab', url }` to open a link in a new tab.
+     * - Return `null` to skip this adapter.
+     */
+    resolve: (args: MediaPreviewAdapterResolveArgs) => MediaPreviewAdapterResolveResult | null;
+};
+export type InsertPosition = 'first' | 'last' | {
+    after: string;
+    before?: never;
+} | {
+    after?: never;
+    before: string;
+};
+export type MediaPreviewContentType = 'audio' | 'document' | 'image' | 'video';
+export type MediaPreviewContentModeType = 'inline' | 'newTab';
+/** `'auto'` adapts to context and device, `'fullscreen'` always uses a modal. */
+export type MediaPreviewMode = 'auto' | 'fullscreen';
+/**
+ * Controls how each content type is opened.
+ *
+ * - `'inline'` — show content in a modal preview.
+ * - `'newTab'` — open content in a new browser tab.
+ *
+ * @default 'inline' for all content types
+ */
+export type MediaPreviewContentMode = Record<MediaPreviewContentType, MediaPreviewContentModeType>;
+export type MediaPreviewFieldConfig = {
+    /** Payload UI field overrides (`name` and `type` cannot be changed). */
+    overrides?: Partial<Omit<UIField, 'name' | 'type'>>;
+    /** @default 'last' */
+    position?: InsertPosition;
+};
+export type MediaPreviewCollectionConfig = {
+    /** Overrides global adapters when set. */
+    adapters?: MediaPreviewAdapter[];
+    contentMode?: Partial<MediaPreviewContentMode>;
+    /**
+     * Controls field injection into the collection.
+     *
+     * - Omit or pass `{}` to inject with defaults.
+     * - Pass `{ position, overrides }` to customize the injected field.
+     * - Set to `false` to skip injection (for manual placement via `mediaPreviewField()`).
+     */
+    field?: false | MediaPreviewFieldConfig;
+    /**
+     * Preview display mode.
+     *
+     * - `'auto'` — popup in cell (desktop), fullscreen in field and on mobile.
+     * - `'fullscreen'` — always fullscreen modal.
+     * @default 'auto'
+     */
+    mode?: MediaPreviewMode;
+};
+export type MediaPreviewPluginConfig = {
+    /** Adapters available to all collections. */
+    adapters?: MediaPreviewAdapter[];
+    /** Use `true` for defaults or an object for fine-tuning. */
+    collections: Partial<Record<UploadCollectionSlug, MediaPreviewCollectionConfig | true>>;
+    /** @default true */
+    enabled?: boolean;
+};
+export type MediaPreviewPlugin = (pluginConfig: MediaPreviewPluginConfig) => Plugin;
+export type MediaPreviewFieldProps = {
+    adapterNames?: string[];
+    contentMode?: Partial<MediaPreviewContentMode>;
+    mode?: MediaPreviewMode;
+};

package/dist/types.js

@@ -0,0 +1,2 @@
+// Internal props
+export { };

package/dist/utils/insertField.d.ts

@@ -0,0 +1,3 @@
+import type { InsertPosition } from '@/types.js';
+import type { Field } from 'payload';
+export declare const insertField: (fields: Field[], position: InsertPosition, fieldToInsert: Field) => Field[];

package/dist/utils/insertField.js

@@ -0,0 +1,97 @@
+export const insertField = (fields, position, fieldToInsert)=>{
+    if (position === 'first') {
+        return [
+            fieldToInsert,
+            ...fields
+        ];
+    }
+    if (position === 'last') {
+        return [
+            ...fields,
+            fieldToInsert
+        ];
+    }
+    if ('after' in position && position.after) {
+        return insertFieldByPath(fields, position.after, fieldToInsert, 'after');
+    }
+    if ('before' in position && position.before) {
+        return insertFieldByPath(fields, position.before, fieldToInsert, 'before');
+    }
+    return fields;
+};
+const insertFieldByPath = (fields, targetPath, fieldToInsert, placement)=>{
+    const pathParts = targetPath.split('.');
+    const [currentPart, ...remainingParts] = pathParts;
+    if (remainingParts.length === 0) {
+        const targetIndex = fields.findIndex((f)=>'name' in f && f.name === currentPart);
+        if (targetIndex !== -1) {
+            const insertIndex = placement === 'before' ? targetIndex : targetIndex + 1;
+            return [
+                ...fields.slice(0, insertIndex),
+                fieldToInsert,
+                ...fields.slice(insertIndex)
+            ];
+        }
+        return fields;
+    }
+    return fields.map((field)=>{
+        if ('name' in field && field.name === currentPart) {
+            const remainingPath = remainingParts.join('.');
+            if ('fields' in field && Array.isArray(field.fields)) {
+                return {
+                    ...field,
+                    fields: insertFieldByPath(field.fields, remainingPath, fieldToInsert, placement)
+                };
+            }
+            if ('tabs' in field && Array.isArray(field.tabs)) {
+                const tabIndex = parseInt(remainingParts[0]);
+                if (!isNaN(tabIndex) && field.tabs[tabIndex]) {
+                    const tabRemainingPath = remainingParts.slice(1).join('.');
+                    const updatedTabs = [
+                        ...field.tabs
+                    ];
+                    if ('fields' in updatedTabs[tabIndex] && Array.isArray(updatedTabs[tabIndex].fields)) {
+                        updatedTabs[tabIndex] = {
+                            ...updatedTabs[tabIndex],
+                            fields: insertFieldByPath(updatedTabs[tabIndex].fields, tabRemainingPath, fieldToInsert, placement)
+                        };
+                    }
+                    return {
+                        ...field,
+                        tabs: updatedTabs
+                    };
+                }
+            }
+        }
+        if ('fields' in field && Array.isArray(field.fields)) {
+            const updatedFields = insertFieldByPath(field.fields, targetPath, fieldToInsert, placement);
+            if (updatedFields !== field.fields) {
+                return {
+                    ...field,
+                    fields: updatedFields
+                };
+            }
+        }
+        if ('tabs' in field && Array.isArray(field.tabs)) {
+            const updatedTabs = field.tabs.map((tab)=>{
+                if ('fields' in tab && Array.isArray(tab.fields)) {
+                    const updatedFields = insertFieldByPath(tab.fields, targetPath, fieldToInsert, placement);
+                    if (updatedFields !== tab.fields) {
+                        return {
+                            ...tab,
+                            fields: updatedFields
+                        };
+                    }
+                }
+                return tab;
+            });
+            if (JSON.stringify(updatedTabs) !== JSON.stringify(field.tabs)) {
+                return {
+                    ...field,
+                    tabs: updatedTabs
+                };
+            }
+        }
+        return field;
+    });
+};