@unciatech/file-manager 0.0.14 → 0.0.16

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import e from"fs";import i from"path";import{execSync as p}from"child_process";import y from"readline";var u=process.argv.slice(2),w=u[0],a=u[1],g=y.createInterface({input:process.stdin,output:process.stdout}),x=o=>new Promise(n=>g.question(o,n)),d=`"use client";
+import e from'fs';import r from'path';import {execSync}from'child_process';import v from'readline';var m=process.argv.slice(2),y=m[0],t=m[1],g=v.createInterface({input:process.stdin,output:process.stdout}),w=n=>new Promise(o=>g.question(n,o)),p=`"use client";
 
 import React, { Suspense } from "react";
 import { FileManager, MockProvider } from "@unciatech/file-manager";
@@ -19,14 +19,14 @@ export default function FileManagerDemo() {
     </div>
   );
 }
-`;async function h(){if(w!=="init"&&(console.log("Usage: npx @unciatech/file-manager init [project-name]"),process.exit(0)),!a){console.log("\u{1F680} Generating <FileManagerDemo /> component in the current project...");let s=process.cwd();e.existsSync(i.join(process.cwd(),"components"))?s=i.join(process.cwd(),"components"):e.existsSync(i.join(process.cwd(),"src","components"))&&(s=i.join(process.cwd(),"src","components"));let c=i.join(s,"FileManagerDemo.tsx");e.existsSync(c)&&(console.error(`\u274C Error: ${c} already exists.`),process.exit(1)),e.writeFileSync(c,d,"utf-8"),console.log(`\u2705 Success! Created ${c}`),console.log(""),console.log("You can now import and render <FileManagerDemo /> anywhere in your application."),console.log("Don't forget to configure your Tailwind CSS content to scan the library for styles!"),process.exit(0)}console.log(`
-\u{1F680} Initializing a new application: ${a}
-`),console.log("Which framework would you like to use?"),console.log("  1) Next.js (App Router, Tailwind v4)"),console.log("  2) Vite (React, Tailwind v4)"),console.log("  3) Cancel");let o=await x(`
-Select an option (1-3): `),n=i.join(process.cwd(),a);e.existsSync(n)&&(console.error(`
-\u274C Error: Directory "${a}" already exists in ${process.cwd()}.`),console.error("   Please choose a different project name or delete the existing directory first."),g.close(),process.exit(1));try{o==="1"?await S(a,n):o==="2"?await F(a,n):(console.log("Canceled."),process.exit(0))}catch(s){console.error(`
-\u274C Scaffolding failed:`,s),process.exit(1)}process.exit(0)}async function S(o,n){console.log(`
-\u{1F4E6} Creating Next.js application (this may take a minute)...`),p(`npx create-next-app@latest ${o} --ts --tailwind --eslint --app --src-dir --import-alias "@/*" --use-npm`,{stdio:"inherit"}),console.log(`
-\u{1F4E6} Installing dependencies (@unciatech/file-manager, tailwindcss-animate)...`),p("npm install @unciatech/file-manager tailwindcss-animate",{cwd:n,stdio:"inherit"});let s=i.join(n,"src","components");e.existsSync(s)||e.mkdirSync(s,{recursive:!0}),e.writeFileSync(i.join(s,"FileManagerDemo.tsx"),d,"utf-8");let c=i.join(n,"src","app","page.tsx");e.writeFileSync(c,`import FileManagerDemo from "@/components/FileManagerDemo";
+`;async function h(){if(y!=="init"&&(console.log("Usage: npx @unciatech/file-manager init [project-name]"),process.exit(0)),!t){console.log("\u{1F680} Generating <FileManagerDemo /> component in the current project...");let i=process.cwd();e.existsSync(r.join(process.cwd(),"components"))?i=r.join(process.cwd(),"components"):e.existsSync(r.join(process.cwd(),"src","components"))&&(i=r.join(process.cwd(),"src","components"));let c=r.join(i,"FileManagerDemo.tsx");e.existsSync(c)&&(console.error(`\u274C Error: ${c} already exists.`),process.exit(1)),e.writeFileSync(c,p,"utf-8"),console.log(`\u2705 Success! Created ${c}`),console.log(""),console.log("You can now import and render <FileManagerDemo /> anywhere in your application."),console.log("Don't forget to configure your Tailwind CSS content to scan the library for styles!"),process.exit(0);}console.log(`
+\u{1F680} Initializing a new application: ${t}
+`),console.log("Which framework would you like to use?"),console.log("  1) Next.js (App Router, Tailwind v4)"),console.log("  2) Vite (React, Tailwind v4)"),console.log("  3) Cancel");let n=await w(`
+Select an option (1-3): `),o=r.join(process.cwd(),t);e.existsSync(o)&&(console.error(`
+\u274C Error: Directory "${t}" already exists in ${process.cwd()}.`),console.error("   Please choose a different project name or delete the existing directory first."),g.close(),process.exit(1));try{n==="1"?await x(t,o):n==="2"?await b(t,o):(console.log("Canceled."),process.exit(0));}catch(i){console.error(`
+\u274C Scaffolding failed:`,i),process.exit(1);}process.exit(0);}async function x(n,o){console.log(`
+\u{1F4E6} Creating Next.js application (this may take a minute)...`),execSync(`npx create-next-app@latest ${n} --ts --tailwind --eslint --app --src-dir --import-alias "@/*" --use-npm`,{stdio:"inherit"}),console.log(`
+\u{1F4E6} Installing dependencies (@unciatech/file-manager, tailwindcss-animate)...`),execSync("npm install @unciatech/file-manager tailwindcss-animate",{cwd:o,stdio:"inherit"});let i=r.join(o,"src","components");e.existsSync(i)||e.mkdirSync(i,{recursive:true}),e.writeFileSync(r.join(i,"FileManagerDemo.tsx"),p,"utf-8");let c=r.join(o,"src","app","page.tsx");e.writeFileSync(c,`import FileManagerDemo from "@/components/FileManagerDemo";
 
 export default function Home() {
   return (
@@ -35,7 +35,7 @@ export default function Home() {
     </main>
   );
 }
-`);let m=i.join(n,"src","app","media","[[...path]]");e.mkdirSync(m,{recursive:!0}),e.writeFileSync(i.join(m,"page.tsx"),`import FileManagerDemo from "@/components/FileManagerDemo";
+`);let l=r.join(o,"src","app","media","[[...path]]");e.mkdirSync(l,{recursive:true}),e.writeFileSync(r.join(l,"page.tsx"),`import FileManagerDemo from "@/components/FileManagerDemo";
 
 export default function MediaPage() {
   return (
@@ -44,14 +44,117 @@ export default function MediaPage() {
     </main>
   );
 }
-`);let r=i.join(n,"src","app","layout.tsx");if(e.existsSync(r)){let t=e.readFileSync(r,"utf8");t.includes("@unciatech/file-manager/styles")||(t=t.replace(/^(import type)/m,`import '@unciatech/file-manager/styles';
-$1`),e.writeFileSync(r,t))}let l=i.join(n,"src","app","globals.css");if(e.existsSync(l)){let t=e.readFileSync(l,"utf8");t.includes("@source")||(t=`@import "tailwindcss";
-@plugin "tailwindcss-animate";
+`);let a=r.join(o,"src","app","layout.tsx");if(e.existsSync(a)){let d=e.readFileSync(a,"utf8");d.includes("@unciatech/file-manager/styles")||(d=d.replace(/^(import type)/m,`import '@unciatech/file-manager/styles';
+$1`),e.writeFileSync(a,d));}let u=r.join(o,"src","app","globals.css");e.writeFileSync(u,`@import 'tailwindcss';
+@import 'tw-animate-css';
 @source "../../node_modules/@unciatech/file-manager/dist";
 
-`+t.replace('@import "tailwindcss";',""),e.writeFileSync(l,t))}f(o)}async function F(o,n){console.log(`
-\u{1F4E6} Creating Vite React application...`),p(`npm create vite@latest ${o} -- --template react-ts`,{stdio:"inherit"}),console.log(`
-\u{1F4E6} Installing dependencies (Tailwind + File Manager)...`),p("npm install",{cwd:n,stdio:"inherit"}),p("npm install tailwindcss @tailwindcss/vite @unciatech/file-manager",{cwd:n,stdio:"inherit"});let s=i.join(n,"vite.config.ts");e.writeFileSync(s,`import { defineConfig } from 'vite'
+/** Dark Mode Variant **/
+@custom-variant dark (&:is(.dark *));
+
+@theme {
+  --font-sans: 'Geist', 'Geist Fallback', ui-sans-serif, system-ui, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji';
+  --font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New', monospace;
+}
+
+/** Colors **/
+:root {
+  --background: var(--color-white);
+  --foreground: var(--color-zinc-950);
+  --card: var(--color-white);
+  --card-foreground: var(--color-zinc-950);
+  --popover: var(--color-white);
+  --popover-foreground: var(--color-zinc-950);
+  --primary: var(--color-blue-500);
+  --primary-foreground: var(--color-white);
+  --secondary: var(--color-zinc-100);
+  --secondary-foreground: var(--color-zinc-900);
+  --muted: var(--color-zinc-100);
+  --muted-foreground: var(--color-zinc-500);
+  --accent: var(--color-zinc-100);
+  --accent-foreground: var(--color-zinc-900);
+  --destructive: var(--color-red-600);
+  --destructive-foreground: var(--color-white);
+  --border: oklch(94% 0.004 286.32);
+  --input: var(--color-zinc-200);
+  --ring: var(--color-zinc-400);
+  --radius: 0.5rem;
+}
+
+.dark {
+  --background: var(--color-zinc-950);
+  --foreground: var(--color-zinc-50);
+  --card: var(--color-zinc-950);
+  --card-foreground: var(--color-zinc-50);
+  --popover: var(--color-zinc-950);
+  --popover-foreground: var(--color-zinc-50);
+  --primary: var(--color-blue-600);
+  --primary-foreground: var(--color-white);
+  --secondary: var(--color-zinc-800);
+  --secondary-foreground: var(--color-zinc-50);
+  --muted: var(--color-zinc-900);
+  --muted-foreground: var(--color-zinc-500);
+  --accent: var(--color-zinc-900);
+  --accent-foreground: var(--color-zinc-50);
+  --destructive: var(--color-red-600);
+  --destructive-foreground: var(--color-white);
+  --border: var(--color-zinc-800);
+  --input: var(--color-zinc-800);
+  --ring: var(--color-zinc-600);
+}
+
+/** Theme Setup **/
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-destructive: var(--destructive);
+  --color-destructive-foreground: var(--destructive-foreground);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+  --radius-xl: calc(var(--radius) + 4px);
+  --radius-lg: var(--radius);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-sm: calc(var(--radius) - 4px);
+}
+
+/** Global Styles **/
+@layer base {
+  * {
+    @apply border-border;
+  }
+  *:focus-visible {
+    @apply outline-ring rounded-xs shadow-none outline-2 outline-offset-3 transition-none!;
+  }
+}
+
+/** Custom Scrollbar **/
+@layer base {
+  ::-webkit-scrollbar { width: 5px; }
+  ::-webkit-scrollbar-track { background: transparent; }
+  ::-webkit-scrollbar-thumb { background: var(--input); border-radius: 5px; }
+  * { scrollbar-width: thin; scrollbar-color: var(--input) transparent; }
+}
+
+/** Smooth scroll **/
+html {
+  scroll-behavior: smooth;
+}
+`),f(n);}async function b(n,o){console.log(`
+\u{1F4E6} Creating Vite React application...`),execSync(`npm create vite@latest ${n} -- --template react-ts`,{stdio:"inherit"}),console.log(`
+\u{1F4E6} Installing dependencies (Tailwind + File Manager)...`),execSync("npm install",{cwd:o,stdio:"inherit"}),execSync("npm install tailwindcss @tailwindcss/vite @unciatech/file-manager",{cwd:o,stdio:"inherit"});let i=r.join(o,"vite.config.ts");e.writeFileSync(i,`import { defineConfig } from 'vite'
 import react from '@vitejs/plugin-react'
 import tailwindcss from '@tailwindcss/vite'
 
@@ -61,9 +164,9 @@ export default defineConfig({
     tailwindcss(),
   ],
 })
-`);let m=i.join(n,"src","index.css");e.writeFileSync(m,`@import "tailwindcss";
+`);let l=r.join(o,"src","index.css");e.writeFileSync(l,`@import "tailwindcss";
 @source "../../node_modules/@unciatech/file-manager/dist";
-`);let r=i.join(n,"src","components");e.existsSync(r)||e.mkdirSync(r,{recursive:!0}),e.writeFileSync(i.join(r,"FileManagerDemo.tsx"),d,"utf-8");let l=i.join(n,"src","App.tsx");e.writeFileSync(l,`import FileManagerDemo from "./components/FileManagerDemo";
+`);let a=r.join(o,"src","components");e.existsSync(a)||e.mkdirSync(a,{recursive:true}),e.writeFileSync(r.join(a,"FileManagerDemo.tsx"),p,"utf-8");let u=r.join(o,"src","App.tsx");e.writeFileSync(u,`import FileManagerDemo from "./components/FileManagerDemo";
 
 function App() {
   return (
@@ -74,8 +177,8 @@ function App() {
 }
 
 export default App;
-`),f(o,"npm run dev")}function f(o,n="npm run dev"){console.log(`
+`),f(n,"npm run dev");}function f(n,o="npm run dev"){console.log(`
 =========================================`),console.log("\u{1F389} Your Media Library application is ready!"),console.log("========================================="),console.log(`
-Next steps:`),console.log(`  cd ${o}`),console.log(`  ${n}`),console.log(`
+Next steps:`),console.log(`  cd ${n}`),console.log(`  ${o}`),console.log(`
 Enjoy building! \u{1F5C2}\uFE0F
-`)}h();
+`);}h();

package/dist/file-manager-4KJI2OA3.d.mts

@@ -0,0 +1,194 @@
+type FileUploadInput = {
+    file: File;
+    metadata: Partial<FileMetaData>;
+    videoSource?: VideoSource;
+};
+interface IFileManagerProvider {
+    getFolder(folderId: FolderId): Promise<Folder | null>;
+    getFolders(folderId: FolderId, page?: number, limit?: number, query?: string): Promise<{
+        folders: Folder[];
+        pagination: PaginationInfo;
+    }>;
+    getTags(): Promise<string[]>;
+    getFiles(folderId: FolderId, fileTypes?: FileType[] | null, page?: number, limit?: number, query?: string): Promise<{
+        files: FileMetaData[];
+        pagination: PaginationInfo;
+    }>;
+    /**
+     * Get files and folders separately (folders always come first)
+     * Folders are returned for the current page, followed by files
+     */
+    getItems(folderId: FolderId, fileTypes?: FileType[], page?: number, limit?: number, query?: string): Promise<{
+        folders: Folder[];
+        files: FileMetaData[];
+        pagination: PaginationInfo;
+    }>;
+    createFolder(name: string, parentId?: FolderId): Promise<Folder>;
+    uploadFiles(files: FileUploadInput[], folderId?: FolderId): Promise<FileMetaData[]>;
+    renameFolder(folderId: FolderId, newName: string): Promise<Folder>;
+    moveFiles(fileIds: EntityId[], newFolderId: FolderId): Promise<FileMetaData[]>;
+    moveFolders(folderIds: FolderId[], newParentId: FolderId): Promise<Folder[]>;
+    updateFileMetaData(fileId: EntityId, metaData: Partial<FileMetaData>): Promise<FileMetaData>;
+    deleteFiles(fileIds: EntityId[]): Promise<void>;
+    deleteFolders(folderIds: FolderId[]): Promise<void>;
+    findFiles(searchQuery: string): Promise<FileMetaData[]>;
+    findFolders(searchQuery: string): Promise<Folder[]>;
+}
+
+declare const MODE: {
+    readonly PAGE: "page";
+    readonly MODAL: "modal";
+};
+type Mode = (typeof MODE)[keyof typeof MODE];
+declare const FILE_TYPE: {
+    readonly IMAGE: "images";
+    readonly VIDEO: "videos";
+    readonly AUDIO: "audios";
+    readonly FILE: "files";
+};
+type FileType = (typeof FILE_TYPE)[keyof typeof FILE_TYPE];
+declare const SELECTION_MODE: {
+    readonly SINGLE: "single";
+    readonly MULTIPLE: "multiple";
+};
+type SelectionMode = (typeof SELECTION_MODE)[keyof typeof SELECTION_MODE];
+declare const VIEW_MODE: {
+    readonly GRID: "grid";
+    readonly LIST: "list";
+};
+type ViewMode = (typeof VIEW_MODE)[keyof typeof VIEW_MODE];
+declare const VIDEO_SOURCE: {
+    readonly LOCAL: "local";
+    readonly REMOTE: "remote";
+    readonly YOUTUBE: "youtube";
+    readonly VIMEO: "vimeo";
+};
+type VideoSource = (typeof VIDEO_SOURCE)[keyof typeof VIDEO_SOURCE];
+interface MetaDataType {
+    /** Video or Audio duration in seconds. */
+    duration?: number;
+    /** Provider source for video content (e.g., 'local', 'youtube'). */
+    videoSource?: VideoSource;
+    /** Audio bitrate in kbps. */
+    bitrate?: number;
+    /** Total number of pages for document file types. */
+    pageCount?: number;
+    /** Original creator or author of the document. */
+    author?: string;
+    /** General description text used across multiple asset types. */
+    description?: string;
+}
+type EntityId = string | number;
+type FolderId = string | number | null;
+interface Folder {
+    id: FolderId;
+    name: string;
+    pathId: number;
+    path: string;
+    parent?: Folder | null;
+    folderCount?: number;
+    parentId: FolderId;
+    folderPath?: string;
+    color?: string;
+    fileCount?: number;
+    createdAt: Date;
+    updatedAt: Date;
+    tags?: string[];
+}
+interface FormatDetails {
+    ext: string;
+    url: string;
+    hash: string;
+    mime: string;
+    name: string;
+    path: string | null;
+    size: number;
+    width: number;
+    height: number;
+}
+/**
+ * Core interface representing a File entity in the file manager.
+ * Supports various formats (images, videos, audio, documents) via common fields
+ * and nested metadata structures.
+ */
+interface FileMetaData {
+    /** Unique identifier for the file. */
+    id: EntityId;
+    /** Human-readable name of the file (including extension). */
+    name: string;
+    /** ID of the folder containing this file. Null represents the root directory. */
+    folderId: FolderId;
+    /** Path representation of the file's location (e.g., "/1/156"). */
+    folderPath?: string;
+    /** Size of the file in bytes. */
+    size: number;
+    /** Direct URL path to access or download the full asset. */
+    url: string;
+    /** URL to an optimized, lightweight thumbnail or preview of the asset. */
+    previewUrl?: string;
+    /** Content-Type HTTP header representation (e.g., "image/jpeg"). */
+    mime: string;
+    /** File extension including the dot (e.g., ".jpg"). */
+    ext?: string;
+    /** Content hash for deduplication and cache busting. */
+    hash?: string;
+    /** Accessible alt text for images to display when images are disabled. */
+    alternativeText?: string;
+    /** Caption text commonly used in images and videos. */
+    caption?: string;
+    /** Intrinsic width in pixels for image/video assets. */
+    width?: number;
+    /** Intrinsic height in pixels for image/video assets. */
+    height?: number;
+    /** Collection of generated optimized formats for images. */
+    formats?: Record<string, FormatDetails>;
+    /** Dynamic metadata payload containing properties specific to the asset type. */
+    metaData: MetaDataType;
+    /** Timestamp of file creation. */
+    createdAt: Date;
+    /** Timestamp of last file modification. */
+    updatedAt: Date;
+    /** Categorization tags for sorting and discovery. */
+    tags?: string[];
+}
+interface PaginationInfo {
+    currentPage: number;
+    totalPages: number;
+    totalFiles: number;
+    filesPerPage: number;
+}
+interface FileManagerPageProps {
+    allowedFileTypes: FileType[];
+    viewMode: ViewMode;
+    initialFolderId?: FolderId;
+    provider: IFileManagerProvider;
+    basePath?: string;
+}
+interface FileManagerModalProps {
+    open: boolean;
+    onClose: () => void;
+    onFilesSelected: (files: FileMetaData[]) => void;
+    fileSelectionMode?: SelectionMode;
+    allowedFileTypes: FileType[];
+    acceptedFileTypes?: FileType[];
+    viewMode?: ViewMode;
+    initialFolderId?: FolderId;
+    provider: IFileManagerProvider;
+    basePath?: string;
+}
+interface FileManagerRootProps {
+    mode: Mode;
+    selectionMode: SelectionMode;
+    allowedFileTypes: FileType[];
+    viewMode: ViewMode;
+    initialFolderId?: FolderId;
+    acceptedFileTypesForModal?: FileType[];
+    provider: IFileManagerProvider;
+    basePath?: string;
+    onFilesSelected?: (files: FileMetaData[]) => void;
+    onClose?: () => void;
+    maxUploadFiles?: number;
+    maxUploadSize?: number;
+}
+
+export type { EntityId as E, FolderId as F, IFileManagerProvider as I, Mode as M, PaginationInfo as P, SelectionMode as S, ViewMode as V, Folder as a, FileType as b, FileMetaData as c, FileUploadInput as d, FileManagerPageProps as e, FileManagerModalProps as f, FileManagerRootProps as g };

package/dist/file-manager-4KJI2OA3.d.ts

@@ -0,0 +1,194 @@
+type FileUploadInput = {
+    file: File;
+    metadata: Partial<FileMetaData>;
+    videoSource?: VideoSource;
+};
+interface IFileManagerProvider {
+    getFolder(folderId: FolderId): Promise<Folder | null>;
+    getFolders(folderId: FolderId, page?: number, limit?: number, query?: string): Promise<{
+        folders: Folder[];
+        pagination: PaginationInfo;
+    }>;
+    getTags(): Promise<string[]>;
+    getFiles(folderId: FolderId, fileTypes?: FileType[] | null, page?: number, limit?: number, query?: string): Promise<{
+        files: FileMetaData[];
+        pagination: PaginationInfo;
+    }>;
+    /**
+     * Get files and folders separately (folders always come first)
+     * Folders are returned for the current page, followed by files
+     */
+    getItems(folderId: FolderId, fileTypes?: FileType[], page?: number, limit?: number, query?: string): Promise<{
+        folders: Folder[];
+        files: FileMetaData[];
+        pagination: PaginationInfo;
+    }>;
+    createFolder(name: string, parentId?: FolderId): Promise<Folder>;
+    uploadFiles(files: FileUploadInput[], folderId?: FolderId): Promise<FileMetaData[]>;
+    renameFolder(folderId: FolderId, newName: string): Promise<Folder>;
+    moveFiles(fileIds: EntityId[], newFolderId: FolderId): Promise<FileMetaData[]>;
+    moveFolders(folderIds: FolderId[], newParentId: FolderId): Promise<Folder[]>;
+    updateFileMetaData(fileId: EntityId, metaData: Partial<FileMetaData>): Promise<FileMetaData>;
+    deleteFiles(fileIds: EntityId[]): Promise<void>;
+    deleteFolders(folderIds: FolderId[]): Promise<void>;
+    findFiles(searchQuery: string): Promise<FileMetaData[]>;
+    findFolders(searchQuery: string): Promise<Folder[]>;
+}
+
+declare const MODE: {
+    readonly PAGE: "page";
+    readonly MODAL: "modal";
+};
+type Mode = (typeof MODE)[keyof typeof MODE];
+declare const FILE_TYPE: {
+    readonly IMAGE: "images";
+    readonly VIDEO: "videos";
+    readonly AUDIO: "audios";
+    readonly FILE: "files";
+};
+type FileType = (typeof FILE_TYPE)[keyof typeof FILE_TYPE];
+declare const SELECTION_MODE: {
+    readonly SINGLE: "single";
+    readonly MULTIPLE: "multiple";
+};
+type SelectionMode = (typeof SELECTION_MODE)[keyof typeof SELECTION_MODE];
+declare const VIEW_MODE: {
+    readonly GRID: "grid";
+    readonly LIST: "list";
+};
+type ViewMode = (typeof VIEW_MODE)[keyof typeof VIEW_MODE];
+declare const VIDEO_SOURCE: {
+    readonly LOCAL: "local";
+    readonly REMOTE: "remote";
+    readonly YOUTUBE: "youtube";
+    readonly VIMEO: "vimeo";
+};
+type VideoSource = (typeof VIDEO_SOURCE)[keyof typeof VIDEO_SOURCE];
+interface MetaDataType {
+    /** Video or Audio duration in seconds. */
+    duration?: number;
+    /** Provider source for video content (e.g., 'local', 'youtube'). */
+    videoSource?: VideoSource;
+    /** Audio bitrate in kbps. */
+    bitrate?: number;
+    /** Total number of pages for document file types. */
+    pageCount?: number;
+    /** Original creator or author of the document. */
+    author?: string;
+    /** General description text used across multiple asset types. */
+    description?: string;
+}
+type EntityId = string | number;
+type FolderId = string | number | null;
+interface Folder {
+    id: FolderId;
+    name: string;
+    pathId: number;
+    path: string;
+    parent?: Folder | null;
+    folderCount?: number;
+    parentId: FolderId;
+    folderPath?: string;
+    color?: string;
+    fileCount?: number;
+    createdAt: Date;
+    updatedAt: Date;
+    tags?: string[];
+}
+interface FormatDetails {
+    ext: string;
+    url: string;
+    hash: string;
+    mime: string;
+    name: string;
+    path: string | null;
+    size: number;
+    width: number;
+    height: number;
+}
+/**
+ * Core interface representing a File entity in the file manager.
+ * Supports various formats (images, videos, audio, documents) via common fields
+ * and nested metadata structures.
+ */
+interface FileMetaData {
+    /** Unique identifier for the file. */
+    id: EntityId;
+    /** Human-readable name of the file (including extension). */
+    name: string;
+    /** ID of the folder containing this file. Null represents the root directory. */
+    folderId: FolderId;
+    /** Path representation of the file's location (e.g., "/1/156"). */
+    folderPath?: string;
+    /** Size of the file in bytes. */
+    size: number;
+    /** Direct URL path to access or download the full asset. */
+    url: string;
+    /** URL to an optimized, lightweight thumbnail or preview of the asset. */
+    previewUrl?: string;
+    /** Content-Type HTTP header representation (e.g., "image/jpeg"). */
+    mime: string;
+    /** File extension including the dot (e.g., ".jpg"). */
+    ext?: string;
+    /** Content hash for deduplication and cache busting. */
+    hash?: string;
+    /** Accessible alt text for images to display when images are disabled. */
+    alternativeText?: string;
+    /** Caption text commonly used in images and videos. */
+    caption?: string;
+    /** Intrinsic width in pixels for image/video assets. */
+    width?: number;
+    /** Intrinsic height in pixels for image/video assets. */
+    height?: number;
+    /** Collection of generated optimized formats for images. */
+    formats?: Record<string, FormatDetails>;
+    /** Dynamic metadata payload containing properties specific to the asset type. */
+    metaData: MetaDataType;
+    /** Timestamp of file creation. */
+    createdAt: Date;
+    /** Timestamp of last file modification. */
+    updatedAt: Date;
+    /** Categorization tags for sorting and discovery. */
+    tags?: string[];
+}
+interface PaginationInfo {
+    currentPage: number;
+    totalPages: number;
+    totalFiles: number;
+    filesPerPage: number;
+}
+interface FileManagerPageProps {
+    allowedFileTypes: FileType[];
+    viewMode: ViewMode;
+    initialFolderId?: FolderId;
+    provider: IFileManagerProvider;
+    basePath?: string;
+}
+interface FileManagerModalProps {
+    open: boolean;
+    onClose: () => void;
+    onFilesSelected: (files: FileMetaData[]) => void;
+    fileSelectionMode?: SelectionMode;
+    allowedFileTypes: FileType[];
+    acceptedFileTypes?: FileType[];
+    viewMode?: ViewMode;
+    initialFolderId?: FolderId;
+    provider: IFileManagerProvider;
+    basePath?: string;
+}
+interface FileManagerRootProps {
+    mode: Mode;
+    selectionMode: SelectionMode;
+    allowedFileTypes: FileType[];
+    viewMode: ViewMode;
+    initialFolderId?: FolderId;
+    acceptedFileTypesForModal?: FileType[];
+    provider: IFileManagerProvider;
+    basePath?: string;
+    onFilesSelected?: (files: FileMetaData[]) => void;
+    onClose?: () => void;
+    maxUploadFiles?: number;
+    maxUploadSize?: number;
+}
+
+export type { EntityId as E, FolderId as F, IFileManagerProvider as I, Mode as M, PaginationInfo as P, SelectionMode as S, ViewMode as V, Folder as a, FileType as b, FileMetaData as c, FileUploadInput as d, FileManagerPageProps as e, FileManagerModalProps as f, FileManagerRootProps as g };