@codingfactory/mediables-vue 2.15.0 → 2.17.0

package/dist/types/media.d.ts

@@ -43,6 +43,11 @@ export interface Media {
     deletion_status?: DeletionStatus;
     is_trashed?: boolean;
     purge_after?: string | null;
+    parent_media_uuid?: string | null;
+    album_count?: number;
+    usage_count?: number;
+    variant_count?: number;
+    last_used_at?: string | null;
 }
 /**
  * Lifecycle states from the trash-aware deletion state machine.

package/dist/types/mediaLibraryPicker.d.ts

@@ -2,8 +2,10 @@ import type { VNode } from 'vue';
 import type { StorageAdapter } from './adapter';
 import type { Media } from './media';
 export type MediaKind = 'image' | 'video' | 'audio' | 'document' | (string & {});
-export type MediaSort = 'newest' | 'oldest';
+export type MediaSort = 'newest' | 'oldest' | 'name' | 'largest' | (string & {});
+export type MediaUsageStatus = 'used' | 'not_used';
 export type MediaSelectionMode = 'single' | 'multiple';
+export type MediaLibraryPickerMode = 'picker-single' | 'picker-multi' | 'management';
 export type MediaLibraryUploadBehavior = 'adapter' | 'delegate';
 export type MediaLibraryView = {
     scope: 'library';
@@ -11,11 +13,22 @@ export type MediaLibraryView = {
     scope: 'album';
     albumId: string;
     albumName?: string;
+} | {
+    scope: 'trash';
+} | {
+    scope: 'selection';
+} | {
+    scope: 'unfiled';
 };
 export interface MediaLibraryFilters {
     query?: string;
     kinds?: MediaKind[];
     sort?: MediaSort;
+    created_after?: string;
+    created_before?: string;
+    usage_status?: MediaUsageStatus | null;
+    unfiled_only?: boolean;
+    selected_uuids?: string[];
 }
 export interface MediaUploadTarget {
     type: 'library' | 'album';
@@ -33,10 +46,15 @@ export interface MediaLibraryHttpClient {
     patch?<T>(url: string, body?: unknown, config?: MediaLibraryRequestConfig): Promise<T>;
     delete?<T>(url: string, config?: MediaLibraryRequestConfig): Promise<T>;
 }
+export interface MediaLibraryAlbumEndpoints {
+    list?: string;
+    create?: string;
+}
 export interface MediaLibraryPickerDeps {
     httpClient: MediaLibraryHttpClient;
     uploadAdapter?: StorageAdapter;
     resolveThumbnailUrl?: (media: Media, variant?: 'sm' | 'md' | 'lg') => string | Promise<string>;
+    albumEndpoints?: MediaLibraryAlbumEndpoints;
 }
 export interface MediaSessionPolicy {
     key: string;
@@ -64,6 +82,9 @@ export interface MediaLibraryResponsePagination {
     has_more: boolean;
     per_page: number | null;
     count: number | null;
+    total?: number | null;
+    current_page?: number | null;
+    last_page?: number | null;
 }
 export interface MediaLibraryResponseMeta {
     cursor: string | null;
@@ -174,9 +195,34 @@ export interface MediaLibraryPickerLabels {
     previewNext?: string;
     previewSelect?: string;
     previewDeselect?: string;
+    selectAction?: string;
+    allMedia?: string;
+    unfiled?: string;
+    pageTitle?: string;
+    albumLabel?: string;
+}
+export interface MediaLibraryCapabilities {
+    allowAddToAlbum?: boolean;
+    allowBulkDelete?: boolean;
+    allowCreateGallery?: boolean;
+    allowCreatePost?: boolean;
+    allowImageEdit?: boolean;
+    allowPreview?: boolean;
+    allowVideoEdit?: boolean;
+    allowVisibilityChange?: boolean;
+    allowDownloadZip?: boolean;
+    showRawFileName?: boolean;
 }
+export interface MediaItemFilterResult {
+    allowed: boolean;
+    reason?: string;
+}
+export type MediaItemFilter = (media: Media) => boolean | string | MediaItemFilterResult;
 export interface MediaLibraryPickerProps {
     deps: MediaLibraryPickerDeps;
+    mode?: MediaLibraryPickerMode;
+    capabilities?: MediaLibraryCapabilities;
+    itemFilter?: MediaItemFilter;
     modelValue?: string[];
     defaultSelectedIds?: string[];
     selectionMode?: MediaSelectionMode;
@@ -243,6 +289,8 @@ export interface MediaLibraryPickerSlots {
 export type MediaLibraryPickerTabId = 'upload' | 'media' | 'albums';
 /** Identifier for the management-view tab the user is currently viewing. */
 export type MediaManagementTabId = 'library' | 'trash';
+/** Layout modes supported by the package-owned management shell. */
+export type MediaManagementLayoutMode = 'grid' | 'table';
 /**
  * Payload for the picker `tabs` slot. Hosts get the active tab id, an
  * activate handler, and the resolved labels so they can render any tab
@@ -288,14 +336,38 @@ export interface MediaManagementBulkActionsSlotProps {
     selectedCount: number;
     selectedItemIds: string[];
     selectedItems: Media[];
+    crossPageCount: number;
     isDeleting: boolean;
     onBulkDelete: () => void | Promise<void>;
+    onCreatePost?: () => void;
+    onCreateGallery?: () => void;
+    onAddToAlbum?: () => void;
     clearSelection: () => void;
     labels: {
         deleteButton: string;
+        createPostButton?: string;
+        createGalleryButton?: string;
+        addToAlbumButton?: string;
         selectedCount: (count: number) => string;
     };
 }
+export interface MediaManagementItemActionsSlotProps {
+    media: Media;
+    selected: boolean;
+    canEdit: boolean;
+    onPreview: () => void;
+    onEdit?: () => void;
+    onCreatePost?: () => void;
+    onCreateGallery?: () => void;
+    onAddToAlbum?: () => void;
+    labels: {
+        previewButton: string;
+        editButton: string;
+        createPostButton: string;
+        createGalleryButton: string;
+        addToAlbumButton: string;
+    };
+}
 /**
  * Payload for the management-view `trash-action` slot. Rendered per-row
  * inside the trash grid. Hosts can replace the default Restore button with

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codingfactory/mediables-vue",
-  "version": "2.15.0",
+  "version": "2.17.0",
   "publishConfig": {
     "access": "restricted"
   },