@mikestools/usefilesystem 0.0.1

package/README.md

@@ -0,0 +1,187 @@
+# @mikestools/usefilesystem
+
+Vue 3 composables for in-memory virtual filesystem and ZIP archive operations.
+
+## Features
+
+- **Virtual Filesystem** - In-memory filesystem with familiar Node.js-like API
+- **ZIP Archives** - Create and extract ZIP files using native browser compression
+- **Reactive State** - Vue 3 composables with reactive stats and progress tracking
+- **Zero Dependencies** - Uses native browser APIs (CompressionStream/DecompressionStream)
+- **TypeScript** - Full type safety with exported types
+- **Glob Search** - Find files with patterns like `**/*.ts`
+- **File Watchers** - Subscribe to create, modify, delete events
+
+## Installation
+
+```bash
+npm install @mikestools/usefilesystem
+```
+
+## Quick Start
+
+```typescript
+import { useFileSystem, useZip } from '@mikestools/usefilesystem'
+
+const fs = useFileSystem()
+
+// Write files - directories auto-created
+fs.writeFile('/src/index.ts', 'export const version = "1.0.0"')
+fs.writeFile('/readme.md', '# My Project')
+
+// Reactive stats
+console.log(fs.fileCount.value)  // 2
+console.log(fs.totalSize.value)  // bytes
+
+// Export as ZIP
+const zip = useZip()
+await zip.download(
+  fs.getAllFiles().map(f => ({ path: f.path, content: f.content })),
+  'project.zip'
+)
+```
+
+## useFileSystem
+
+In-memory virtual filesystem with reactive stats.
+
+```typescript
+const fs = useFileSystem()
+
+// File operations
+fs.writeFile('/path/to/file.txt', 'content')
+fs.appendFile('/path/to/file.txt', 'more content')
+const content = fs.readFile('/path/to/file.txt')
+const binary = fs.readFile('/image.png', { encoding: 'binary' })
+fs.remove('/path/to/file.txt')
+fs.copy('/source.txt', '/dest.txt')
+fs.move('/old.txt', '/new.txt')
+
+// Directory operations
+fs.mkdir('/a/b/c')  // Creates all parent directories
+fs.rmdir('/empty')  // Removes empty directory
+fs.rmdirRecursive('/folder')  // Removes with contents
+const entries = fs.list('/src', { recursive: true })
+
+// Search
+const tsFiles = fs.find('/src/**/*.ts')
+const jsonFiles = fs.findByExtension('.json')
+
+// Metadata
+const meta = fs.stat('/file.txt')  // { name, path, size, mimeType, createdAt, modifiedAt }
+fs.exists('/path')
+fs.isFile('/path')
+fs.isDirectory('/path')
+
+// Reactive stats
+console.log(fs.stats.value)  // { totalFiles, totalDirectories, totalSize }
+console.log(fs.fileCount.value)
+console.log(fs.totalSize.value)
+
+// Watchers
+const unsubscribe = fs.watch((event, path, type) => {
+  console.log(`${event} ${type}: ${path}`)
+})
+
+// Serialization
+const json = fs.toJSON()
+fs.fromJSON(json)
+fs.clear()
+```
+
+## useZip
+
+ZIP archive operations with reactive state.
+
+```typescript
+const zip = useZip()
+
+// Create ZIP
+const blob = await zip.create([
+  { path: 'readme.txt', content: 'Hello!' },
+  { path: 'data/config.json', content: '{}' }
+])
+
+// Download ZIP
+await zip.download(files, 'archive.zip')
+
+// Extract ZIP
+const entries = await zip.extract(zipBlob)
+const filtered = await zip.extract(zipBlob, {
+  filter: entry => entry.path.endsWith('.txt')
+})
+
+// Extract single file
+const content = await zip.extractSingle(zipBlob, 'readme.txt')
+
+// List without extracting
+const metadata = await zip.list(zipBlob)
+
+// Reactive state
+console.log(zip.isProcessing.value)  // boolean
+console.log(zip.progress.value)      // 0-100
+console.log(zip.error.value)         // string | undefined
+
+// Compression utilities
+const compressed = await zip.compress(data)
+const decompressed = await zip.decompress(data)
+const checksum = zip.computeCrc32(data)
+```
+
+## Standalone Functions
+
+Core functions are also available without Vue:
+
+```typescript
+import {
+  createFileSystem,
+  createZip,
+  extractZip,
+  listZip,
+  compress,
+  decompress,
+  computeCrc32,
+  downloadBlob,
+  downloadAsZip
+} from '@mikestools/usefilesystem'
+
+// Pure filesystem (no Vue reactivity)
+const fs = createFileSystem()
+
+// Direct ZIP operations
+const blob = await createZip([{ path: 'file.txt', content: 'Hello' }])
+const entries = await extractZip(blob)
+```
+
+## Types
+
+All types are exported:
+
+```typescript
+import type {
+  VirtualFile,
+  FileMetadata,
+  DirectoryMetadata,
+  DirectoryEntry,
+  FileSystemStats,
+  FileSystemWatcher,
+  StorageAdapter,
+  ZipEntry,
+  ZipEntryMetadata,
+  ZipInput,
+  CreateZipOptions,
+  ExtractZipOptions
+} from '@mikestools/usefilesystem'
+```
+
+## Browser Support
+
+Requires browsers with support for:
+- CompressionStream/DecompressionStream (Chrome 80+, Firefox 113+, Safari 16.4+)
+- TextEncoder/TextDecoder
+- Blob, ArrayBuffer, Uint8Array
+
+## License
+
+MIT
+

package/dist/index.d.ts

@@ -0,0 +1,425 @@
+import { ComputedRef } from 'vue';
+import { Ref } from 'vue';
+
+/**
+ * Compresses data using DEFLATE (native CompressionStream).
+ */
+export declare function compress(data: Uint8Array): Promise<Uint8Array>;
+
+/**
+ * Computes CRC-32 checksum for data.
+ */
+export declare function computeCrc32(data: Uint8Array): number;
+
+/**
+ * Options for copying files.
+ */
+export declare interface CopyOptions {
+    readonly overwrite?: boolean;
+}
+
+/**
+ * Creates an in-memory virtual filesystem with a familiar API.
+ *
+ * @example
+ * ```ts
+ * const filesystem = createFileSystem()
+ *
+ * // Write files
+ * filesystem.writeFile('/readme.txt', 'Hello World!')
+ * filesystem.writeFile('/src/index.ts', 'export const foo = 42')
+ *
+ * // Read files
+ * const content = filesystem.readFile('/readme.txt')
+ *
+ * // Directory operations
+ * filesystem.mkdir('/config')
+ * filesystem.list('/src')
+ *
+ * // Copy, move, delete
+ * filesystem.copy('/readme.txt', '/docs/readme.txt')
+ * filesystem.move('/old.txt', '/new.txt')
+ * filesystem.remove('/temp.txt')
+ * ```
+ */
+export declare function createFileSystem(): {
+    writeFile: (path: string, content: string | Uint8Array, options?: WriteFileOptions) => FileSystemResult;
+    appendFile: (path: string, content: string | Uint8Array) => FileSystemResult;
+    readFile: {
+        (path: string, options?: {
+            encoding: "utf8";
+        }): string | undefined;
+        (path: string, options: {
+            encoding: "binary";
+        }): Uint8Array | undefined;
+    };
+    stat: (path: string) => FileMetadata | undefined;
+    exists: (path: string) => boolean;
+    isFile: (path: string) => boolean;
+    isDirectory: (path: string) => boolean;
+    remove: (path: string) => FileSystemResult;
+    copy: (source: string, destination: string, options?: CopyOptions) => FileSystemResult;
+    move: (source: string, destination: string, options?: MoveOptions) => FileSystemResult;
+    rename: (oldPath: string, newPath: string) => FileSystemResult;
+    mkdir: (path: string) => FileSystemResult;
+    rmdir: (path: string) => FileSystemResult;
+    rmdirRecursive: (path: string) => FileSystemResult;
+    list: (path: string, options?: ListOptions) => readonly DirectoryEntry[];
+    statDirectory: (path: string) => DirectoryMetadata | undefined;
+    getAllFiles: () => readonly VirtualFile[];
+    getAllPaths: () => readonly string[];
+    getStats: () => FileSystemStats;
+    clear: () => void;
+    find: (pattern: string) => readonly string[];
+    findByExtension: (extension: string) => readonly string[];
+    watch: (callback: FileSystemWatcher) => () => void;
+    toJSON: () => Record<string, {
+        content: string;
+        mimeType: string;
+    }>;
+    fromJSON: (data: Record<string, {
+        content: string;
+        mimeType: string;
+    }>) => void;
+};
+
+/**
+ * Creates a ZIP archive from files.
+ *
+ * @example
+ * ```ts
+ * const zipBlob = await createZip([
+ *   { path: 'readme.txt', content: 'Hello World!' },
+ *   { path: 'data/config.json', content: JSON.stringify({ enabled: true }) },
+ *   { path: 'images/logo.png', content: pngBytes }
+ * ])
+ * ```
+ */
+export declare function createZip(files: readonly ZipInput[], options?: CreateZipOptions): Promise<Blob>;
+
+/**
+ * Options for creating a ZIP archive.
+ */
+export declare interface CreateZipOptions extends ZipCompressionOptions {
+    /** Comment to include in the ZIP archive */
+    readonly comment?: string;
+}
+
+/**
+ * Decompresses DEFLATE data (native DecompressionStream).
+ */
+export declare function decompress(data: Uint8Array): Promise<Uint8Array>;
+
+/**
+ * Directory entry for listing.
+ */
+export declare interface DirectoryEntry {
+    readonly name: string;
+    readonly path: string;
+    readonly type: 'file' | 'directory';
+    readonly size?: number;
+}
+
+/**
+ * Represents directory metadata.
+ */
+export declare interface DirectoryMetadata {
+    readonly name: string;
+    readonly path: string;
+    readonly createdAt: number;
+}
+
+/**
+ * Downloads data as a ZIP file.
+ */
+export declare function downloadAsZip(files: readonly ZipInput[], fileName: string, options?: CreateZipOptions): Promise<void>;
+
+/**
+ * Downloads a blob as a file.
+ */
+export declare function downloadBlob(blob: Blob, fileName: string): void;
+
+/**
+ * Extracts a single file from a ZIP archive.
+ */
+export declare function extractFile(zipData: Uint8Array | Blob, filePath: string): Promise<Uint8Array | undefined>;
+
+/**
+ * Extracts all files from a ZIP archive.
+ *
+ * @example
+ * ```ts
+ * const entries = await extractZip(zipBlob)
+ * for (const entry of entries) {
+ *   console.log(entry.path, entry.content.length)
+ * }
+ * ```
+ */
+export declare function extractZip(zipData: Uint8Array | Blob, options?: ExtractZipOptions): Promise<readonly ZipEntry[]>;
+
+/**
+ * Options for extracting from a ZIP archive.
+ */
+export declare interface ExtractZipOptions {
+    /** Filter function to select which entries to extract */
+    readonly filter?: (entry: ZipEntryMetadata) => boolean;
+}
+
+/**
+ * Represents file metadata without content.
+ */
+export declare interface FileMetadata {
+    readonly name: string;
+    readonly path: string;
+    readonly size: number;
+    readonly mimeType: string;
+    readonly createdAt: number;
+    readonly modifiedAt: number;
+}
+
+/**
+ * Type for the filesystem instance.
+ */
+declare type FileSystem_2 = ReturnType<typeof createFileSystem>;
+export { FileSystem_2 as FileSystem }
+
+/**
+ * Result of a filesystem operation.
+ */
+export declare interface FileSystemResult<T = void> {
+    readonly success: boolean;
+    readonly data?: T;
+    readonly error?: string;
+}
+
+/**
+ * Filesystem statistics.
+ */
+export declare interface FileSystemStats {
+    readonly totalFiles: number;
+    readonly totalDirectories: number;
+    readonly totalSize: number;
+}
+
+/**
+ * Watcher callback for filesystem changes.
+ */
+export declare type FileSystemWatcher = (event: 'create' | 'modify' | 'delete', path: string, type: 'file' | 'directory') => void;
+
+/**
+ * Options for listing directory contents.
+ */
+export declare interface ListOptions {
+    readonly recursive?: boolean;
+    readonly filesOnly?: boolean;
+    readonly directoriesOnly?: boolean;
+}
+
+/**
+ * Reads entries from a ZIP archive without extracting content.
+ */
+export declare function listZip(zipData: Uint8Array | Blob): Promise<readonly ZipEntryMetadata[]>;
+
+/**
+ * Options for moving files.
+ */
+export declare interface MoveOptions {
+    readonly overwrite?: boolean;
+}
+
+/**
+ * Options for reading a file.
+ */
+export declare interface ReadFileOptions {
+    readonly encoding?: 'utf8' | 'binary';
+}
+
+/**
+ * Storage adapter interface for persistence.
+ */
+export declare interface StorageAdapter {
+    save(key: string, data: Uint8Array): Promise<void>;
+    load(key: string): Promise<Uint8Array | undefined>;
+    remove(key: string): Promise<void>;
+    list(): Promise<readonly string[]>;
+    clear(): Promise<void>;
+}
+
+/**
+ * Vue composable wrapper for the virtual filesystem with reactivity.
+ *
+ * @example
+ * ```ts
+ * const filesystem = useFileSystem()
+ *
+ * // Reactive stats
+ * console.log(filesystem.fileCount.value)
+ * console.log(filesystem.totalSize.value)
+ *
+ * // All filesystem operations available
+ * filesystem.writeFile('/readme.txt', 'Hello!')
+ * ```
+ */
+export declare function useFileSystem(options?: UseFileSystemOptions): UseFileSystemReturn;
+
+/**
+ * Options for the useFileSystem composable.
+ */
+export declare interface UseFileSystemOptions {
+    readonly adapter?: StorageAdapter;
+    readonly autoPersist?: boolean;
+}
+
+/**
+ * Return type for useFileSystem composable.
+ */
+export declare interface UseFileSystemReturn extends FileSystem_2 {
+    /** Reactive filesystem stats */
+    readonly stats: ComputedRef<FileSystemStats>;
+    /** Reactive file count */
+    readonly fileCount: ComputedRef<number>;
+    /** Reactive total size in bytes */
+    readonly totalSize: ComputedRef<number>;
+    /** Persist to storage adapter */
+    persist: () => Promise<void>;
+    /** Restore from storage adapter */
+    restore: () => Promise<void>;
+}
+
+/**
+ * Vue composable for ZIP operations with reactive state.
+ *
+ * @example
+ * ```ts
+ * const zip = useZip()
+ *
+ * // Create and download a ZIP
+ * await zip.download([
+ *   { path: 'readme.txt', content: 'Hello!' },
+ *   { path: 'data.json', content: JSON.stringify({ foo: 'bar' }) }
+ * ], 'archive.zip')
+ *
+ * // Extract a ZIP file
+ * const entries = await zip.extract(zipBlob)
+ * for (const entry of entries) {
+ *   console.log(entry.path, new TextDecoder().decode(entry.content))
+ * }
+ *
+ * // Check processing state
+ * if (zip.isProcessing.value) {
+ *   console.log(`Progress: ${zip.progress.value}%`)
+ * }
+ * ```
+ */
+export declare function useZip(): UseZipReturn;
+
+/**
+ * Return type for useZip composable.
+ */
+export declare interface UseZipReturn {
+    /** Current operation state */
+    readonly state: ComputedRef<ZipOperationState>;
+    /** Whether an operation is in progress */
+    readonly isProcessing: Ref<boolean>;
+    /** Progress percentage (0-100) */
+    readonly progress: Ref<number>;
+    /** Last error message */
+    readonly error: Ref<string | undefined>;
+    /** Create a ZIP archive from files */
+    create: (files: readonly ZipInput[], options?: CreateZipOptions) => Promise<Blob>;
+    /** Extract all files from a ZIP archive */
+    extract: (zipData: Uint8Array | Blob, options?: ExtractZipOptions) => Promise<readonly ZipEntry[]>;
+    /** Extract a single file from a ZIP archive */
+    extractSingle: (zipData: Uint8Array | Blob, filePath: string) => Promise<Uint8Array | undefined>;
+    /** List entries in a ZIP archive without extracting */
+    list: (zipData: Uint8Array | Blob) => Promise<readonly ZipEntryMetadata[]>;
+    /** Download a ZIP archive */
+    download: (files: readonly ZipInput[], fileName: string, options?: CreateZipOptions) => Promise<void>;
+    /** Download a blob as a file */
+    downloadBlob: (blob: Blob, fileName: string) => void;
+    /** Compress data using DEFLATE */
+    compress: (data: Uint8Array) => Promise<Uint8Array>;
+    /** Decompress DEFLATE data */
+    decompress: (data: Uint8Array) => Promise<Uint8Array>;
+    /** Compute CRC-32 checksum */
+    computeCrc32: (data: Uint8Array) => number;
+    /** Reset error state */
+    clearError: () => void;
+}
+
+/**
+ * Represents a complete file with content.
+ */
+export declare interface VirtualFile extends FileMetadata {
+    readonly content: Uint8Array;
+}
+
+/**
+ * Options for writing a file.
+ */
+export declare interface WriteFileOptions {
+    readonly mimeType?: string;
+    readonly overwrite?: boolean;
+}
+
+/**
+ * Options for ZIP compression.
+ */
+export declare interface ZipCompressionOptions {
+    /** Compression level: 'none' stores files, 'fast'/'default' uses deflate */
+    readonly level?: 'none' | 'fast' | 'default';
+}
+
+/**
+ * Represents an entry in a ZIP archive.
+ */
+export declare interface ZipEntry {
+    readonly path: string;
+    readonly content: Uint8Array;
+    readonly compressedSize: number;
+    readonly uncompressedSize: number;
+    readonly compressionMethod: 'store' | 'deflate';
+    readonly crc32: number;
+    readonly modifiedAt: Date;
+    readonly isDirectory: boolean;
+}
+
+/**
+ * Metadata for a ZIP entry (without content).
+ */
+export declare interface ZipEntryMetadata {
+    readonly path: string;
+    readonly compressedSize: number;
+    readonly uncompressedSize: number;
+    readonly compressionMethod: 'store' | 'deflate';
+    readonly isDirectory: boolean;
+    readonly modifiedAt: Date;
+}
+
+/**
+ * Input for adding files to a ZIP archive.
+ */
+export declare interface ZipInput {
+    readonly path: string;
+    readonly content: Uint8Array | string;
+}
+
+/**
+ * State for ZIP operations.
+ */
+export declare interface ZipOperationState {
+    readonly isProcessing: boolean;
+    readonly progress: number;
+    readonly error: string | undefined;
+}
+
+/**
+ * Result of a ZIP operation.
+ */
+export declare interface ZipResult<T = void> {
+    readonly success: boolean;
+    readonly data?: T;
+    readonly error?: string;
+}
+
+export { }

package/dist/usefilesystem.js

@@ -0,0 +1,573 @@
+import { shallowRef as ue, computed as N, ref as _ } from "vue";
+function fe() {
+  const n = {
+    name: "",
+    path: "/",
+    createdAt: Date.now(),
+    files: /* @__PURE__ */ new Map(),
+    directories: /* @__PURE__ */ new Map()
+  }, o = /* @__PURE__ */ new Set();
+  function s(e, t, i) {
+    for (const r of o)
+      r(e, t, i);
+  }
+  function c(e) {
+    const t = e.split(/[/\\]/).filter((r) => r.length > 0 && r !== "."), i = [];
+    for (const r of t)
+      r === ".." ? i.pop() : i.push(r);
+    return "/" + i.join("/");
+  }
+  function l(e) {
+    const t = c(e);
+    return { segments: t.split("/").filter((r) => r.length > 0), normalized: t };
+  }
+  function f(e) {
+    const { segments: t } = l(e);
+    if (t.length === 0)
+      return { parentPath: "/", name: "" };
+    const i = t[t.length - 1] ?? "";
+    return { parentPath: "/" + t.slice(0, -1).join("/"), name: i };
+  }
+  function u(e, t = !1) {
+    const { segments: i } = l(e);
+    let r = n;
+    for (const a of i) {
+      let d = r.directories.get(a);
+      if (!d) {
+        if (!t)
+          return;
+        d = {
+          name: a,
+          path: r.path === "/" ? `/${a}` : `${r.path}/${a}`,
+          createdAt: Date.now(),
+          files: /* @__PURE__ */ new Map(),
+          directories: /* @__PURE__ */ new Map()
+        }, r.directories.set(a, d), s("create", d.path, "directory");
+      }
+      r = d;
+    }
+    return r;
+  }
+  function w(e) {
+    return new TextEncoder().encode(e);
+  }
+  function A(e) {
+    return new TextDecoder().decode(e);
+  }
+  function h(e) {
+    const t = e.split(".").pop()?.toLowerCase() ?? "";
+    return {
+      txt: "text/plain",
+      html: "text/html",
+      htm: "text/html",
+      css: "text/css",
+      js: "text/javascript",
+      mjs: "text/javascript",
+      ts: "text/typescript",
+      tsx: "text/typescript",
+      json: "application/json",
+      xml: "application/xml",
+      csv: "text/csv",
+      md: "text/markdown",
+      yaml: "text/yaml",
+      yml: "text/yaml",
+      png: "image/png",
+      jpg: "image/jpeg",
+      jpeg: "image/jpeg",
+      gif: "image/gif",
+      svg: "image/svg+xml",
+      webp: "image/webp",
+      ico: "image/x-icon",
+      pdf: "application/pdf",
+      zip: "application/zip",
+      gz: "application/gzip",
+      tar: "application/x-tar",
+      woff: "font/woff",
+      woff2: "font/woff2",
+      ttf: "font/ttf",
+      otf: "font/otf",
+      mp3: "audio/mpeg",
+      wav: "audio/wav",
+      mp4: "video/mp4",
+      webm: "video/webm"
+    }[t] ?? "application/octet-stream";
+  }
+  function x(e) {
+    return new Uint8Array(e);
+  }
+  function p(e, t, i = {}) {
+    const { parentPath: r, name: a } = f(e), { normalized: d } = l(e);
+    if (!a)
+      return { success: !1, error: "Invalid file path: no filename specified" };
+    const S = u(r, !0);
+    if (!S)
+      return { success: !1, error: `Failed to create parent directory: ${r}` };
+    const E = S.files.get(a);
+    if (E && i.overwrite === !1)
+      return { success: !1, error: `File already exists: ${d}` };
+    const $ = typeof t == "string" ? w(t) : x(t), H = Date.now(), ae = {
+      name: a,
+      path: d,
+      content: $,
+      size: $.length,
+      mimeType: i.mimeType ?? h(a),
+      createdAt: E?.createdAt ?? H,
+      modifiedAt: H
+    };
+    return S.files.set(a, ae), s(E ? "modify" : "create", d, "file"), { success: !0 };
+  }
+  function m(e, t) {
+    const i = y(e, { encoding: "binary" }), r = typeof t == "string" ? w(t) : t;
+    if (i === void 0)
+      return p(e, r);
+    const a = i, d = new Uint8Array(a.length + r.length);
+    return d.set(a, 0), d.set(r, a.length), p(e, d);
+  }
+  function y(e, t = {}) {
+    const { parentPath: i, name: r } = f(e), d = u(i)?.files.get(r);
+    return d ? (t.encoding ?? "utf8") === "binary" ? x(d.content) : A(d.content) : void 0;
+  }
+  function T(e) {
+    const { parentPath: t, name: i } = f(e), a = u(t)?.files.get(i);
+    if (a)
+      return {
+        name: a.name,
+        path: a.path,
+        size: a.size,
+        mimeType: a.mimeType,
+        createdAt: a.createdAt,
+        modifiedAt: a.modifiedAt
+      };
+  }
+  function U(e) {
+    return T(e) !== void 0 || b(e);
+  }
+  function v(e) {
+    return T(e) !== void 0;
+  }
+  function b(e) {
+    return u(e) !== void 0;
+  }
+  function O(e) {
+    const { parentPath: t, name: i } = f(e), { normalized: r } = l(e), a = u(t);
+    return a ? a.files.has(i) ? (a.files.delete(i), s("delete", r, "file"), { success: !0 }) : { success: !1, error: `File not found: ${r}` } : { success: !1, error: `Parent directory not found: ${t}` };
+  }
+  function z(e, t, i = {}) {
+    const r = y(e, { encoding: "binary" });
+    if (r === void 0)
+      return { success: !1, error: `Source file not found: ${e}` };
+    const a = T(e);
+    return p(t, r, {
+      mimeType: a?.mimeType,
+      overwrite: i.overwrite
+    });
+  }
+  function B(e, t, i = {}) {
+    const r = z(e, t, { overwrite: i.overwrite });
+    return r.success ? O(e) : r;
+  }
+  function C(e, t) {
+    return B(e, t, { overwrite: !1 });
+  }
+  function R(e) {
+    return u(e, !0) ? { success: !0 } : { success: !1, error: `Failed to create directory: ${e}` };
+  }
+  function L(e) {
+    const { parentPath: t, name: i } = f(e), { normalized: r } = l(e);
+    if (r === "/")
+      return { success: !1, error: "Cannot remove root directory" };
+    const a = u(t);
+    if (!a)
+      return { success: !1, error: `Parent directory not found: ${t}` };
+    const d = a.directories.get(i);
+    return d ? d.files.size > 0 || d.directories.size > 0 ? { success: !1, error: `Directory not empty: ${r}` } : (a.directories.delete(i), s("delete", r, "directory"), { success: !0 }) : { success: !1, error: `Directory not found: ${r}` };
+  }
+  function D(e) {
+    const { parentPath: t, name: i } = f(e), { normalized: r } = l(e);
+    if (r === "/")
+      return { success: !1, error: "Cannot remove root directory" };
+    const a = u(t);
+    return a ? a.directories.get(i) ? (a.directories.delete(i), s("delete", r, "directory"), { success: !0 }) : { success: !1, error: `Directory not found: ${r}` } : { success: !1, error: `Parent directory not found: ${t}` };
+  }
+  function F(e, t = {}) {
+    const { recursive: i = !1, filesOnly: r = !1, directoriesOnly: a = !1 } = t, d = e === "/" || e === "" ? n : u(e);
+    if (!d)
+      return [];
+    const S = [];
+    if (!a)
+      for (const E of d.files.values())
+        S.push({
+          name: E.name,
+          path: E.path,
+          type: "file",
+          size: E.size
+        });
+    if (!r) {
+      for (const E of d.directories.values())
+        if (S.push({
+          name: E.name,
+          path: E.path,
+          type: "directory"
+        }), i) {
+          const $ = F(E.path, t);
+          S.push(...$);
+        }
+    }
+    return S;
+  }
+  function g(e) {
+    const t = u(e);
+    if (t)
+      return {
+        name: t.name,
+        path: t.path,
+        createdAt: t.createdAt
+      };
+  }
+  function P() {
+    const e = [];
+    function t(i) {
+      for (const r of i.files.values())
+        e.push(r);
+      for (const r of i.directories.values())
+        t(r);
+    }
+    return t(n), e;
+  }
+  function I() {
+    return P().map((e) => e.path);
+  }
+  function ne() {
+    let e = 0, t = 0, i = 0;
+    function r(a) {
+      for (const d of a.files.values())
+        e++, i += d.size;
+      for (const d of a.directories.values())
+        t++, r(d);
+    }
+    return r(n), { totalFiles: e, totalDirectories: t, totalSize: i };
+  }
+  function W() {
+    n.files.clear(), n.directories.clear(), s("delete", "/", "directory");
+  }
+  function re(e) {
+    const t = I(), i = e.replace(/\./g, "\\.").replace(/\*\*/g, "<<<GLOBSTAR>>>").replace(/\*/g, "[^/]*").replace(/<<<GLOBSTAR>>>/g, ".*"), r = new RegExp(`^${i}$`);
+    return t.filter((a) => r.test(a));
+  }
+  function oe(e) {
+    const t = e.startsWith(".") ? e : `.${e}`;
+    return I().filter((i) => i.endsWith(t));
+  }
+  function se(e) {
+    return o.add(e), () => {
+      o.delete(e);
+    };
+  }
+  function ie() {
+    const e = {};
+    for (const t of P()) {
+      const i = btoa(
+        Array.from(t.content, (r) => String.fromCharCode(r)).join("")
+      );
+      e[t.path] = {
+        content: i,
+        mimeType: t.mimeType
+      };
+    }
+    return e;
+  }
+  function ce(e) {
+    W();
+    for (const [t, { content: i, mimeType: r }] of Object.entries(e)) {
+      const a = atob(i), d = Uint8Array.from(a, (S) => S.charCodeAt(0));
+      p(t, d, { mimeType: r });
+    }
+  }
+  return {
+    // File operations
+    writeFile: p,
+    appendFile: m,
+    readFile: y,
+    stat: T,
+    exists: U,
+    isFile: v,
+    isDirectory: b,
+    remove: O,
+    copy: z,
+    move: B,
+    rename: C,
+    // Directory operations
+    mkdir: R,
+    rmdir: L,
+    rmdirRecursive: D,
+    list: F,
+    statDirectory: g,
+    // Bulk operations
+    getAllFiles: P,
+    getAllPaths: I,
+    getStats: ne,
+    clear: W,
+    // Search
+    find: re,
+    findByExtension: oe,
+    // Watchers
+    watch: se,
+    // Serialization
+    toJSON: ie,
+    fromJSON: ce
+  };
+}
+function he(n = {}) {
+  const { adapter: o, autoPersist: s = !1 } = n, c = fe(), l = ue(0);
+  function f() {
+    l.value++, s && o && h();
+  }
+  c.watch(() => {
+    f();
+  });
+  const u = N(() => (l.value, c.getStats())), w = N(() => u.value.totalFiles), A = N(() => u.value.totalSize);
+  async function h() {
+    if (!o)
+      throw new Error("No storage adapter configured");
+    const p = c.toJSON(), m = new TextEncoder().encode(JSON.stringify(p));
+    await o.save("filesystem", m);
+  }
+  async function x() {
+    if (!o)
+      throw new Error("No storage adapter configured");
+    const p = await o.load("filesystem");
+    if (p) {
+      const m = JSON.parse(new TextDecoder().decode(p));
+      c.fromJSON(m), f();
+    }
+  }
+  return {
+    ...c,
+    stats: u,
+    fileCount: w,
+    totalSize: A,
+    persist: h,
+    restore: x
+  };
+}
+const Y = 67324752, G = 33639248, q = 101010256, le = 0, M = 8, de = (function() {
+  const o = new Uint32Array(256);
+  for (let s = 0; s < 256; s++) {
+    let c = s;
+    for (let l = 0; l < 8; l++)
+      c = c & 1 ? 3988292384 ^ c >>> 1 : c >>> 1;
+    o[s] = c;
+  }
+  return o;
+})();
+function K(n) {
+  let o = 4294967295;
+  for (let s = 0; s < n.length; s++) {
+    const c = n[s] ?? 0, l = (o ^ c) & 255;
+    o = o >>> 8 ^ (de[l] ?? 0);
+  }
+  return ~o >>> 0;
+}
+function j(n) {
+  const o = new ArrayBuffer(n.byteLength);
+  return new Uint8Array(o).set(n), o;
+}
+function V(n) {
+  return new TextEncoder().encode(n);
+}
+function Q(n) {
+  return new TextDecoder().decode(n);
+}
+async function X(n) {
+  const s = new Blob([j(n)]).stream().pipeThrough(new CompressionStream("deflate-raw")), c = await new Response(s).blob();
+  return new Uint8Array(await c.arrayBuffer());
+}
+async function ee(n) {
+  const s = new Blob([j(n)]).stream().pipeThrough(new DecompressionStream("deflate-raw")), c = await new Response(s).blob();
+  return new Uint8Array(await c.arrayBuffer());
+}
+function me(n) {
+  const o = n.getHours(), s = n.getMinutes(), c = Math.floor(n.getSeconds() / 2), l = o << 11 | s << 5 | c, f = n.getFullYear() - 1980, u = n.getMonth() + 1, w = n.getDate(), A = f << 9 | u << 5 | w;
+  return { time: l, date: A };
+}
+function Z(n, o) {
+  const s = (n & 31) * 2, c = n >> 5 & 63, l = n >> 11 & 31, f = o & 31, u = (o >> 5 & 15) - 1, w = (o >> 9 & 127) + 1980;
+  return new Date(w, u, f, l, c, s);
+}
+async function J(n, o = {}) {
+  const { level: s = "default", comment: c = "" } = o, l = s !== "none", f = [], u = [];
+  let w = 0;
+  const h = me(/* @__PURE__ */ new Date());
+  for (const U of n) {
+    const v = V(U.path), b = typeof U.content == "string" ? V(U.content) : U.content, O = K(b), z = b.length, B = l ? await X(b) : b, C = B.length, R = l ? M : le, L = new ArrayBuffer(30), D = new DataView(L);
+    D.setUint32(0, Y, !0), D.setUint16(4, 20, !0), D.setUint16(6, 0, !0), D.setUint16(8, R, !0), D.setUint16(10, h.time, !0), D.setUint16(12, h.date, !0), D.setUint32(14, O, !0), D.setUint32(18, C, !0), D.setUint32(22, z, !0), D.setUint16(26, v.length, !0), D.setUint16(28, 0, !0), f.push(new Uint8Array(L), v, B);
+    const F = new ArrayBuffer(46), g = new DataView(F);
+    g.setUint32(0, G, !0), g.setUint16(4, 20, !0), g.setUint16(6, 20, !0), g.setUint16(8, 0, !0), g.setUint16(10, R, !0), g.setUint16(12, h.time, !0), g.setUint16(14, h.date, !0), g.setUint32(16, O, !0), g.setUint32(20, C, !0), g.setUint32(24, z, !0), g.setUint16(28, v.length, !0), g.setUint16(30, 0, !0), g.setUint16(32, 0, !0), g.setUint16(34, 0, !0), g.setUint16(36, 0, !0), g.setUint32(38, 0, !0), g.setUint32(42, w, !0);
+    const P = new Uint8Array(46 + v.length);
+    P.set(new Uint8Array(F), 0), P.set(v, 46), u.push(P), w += 30 + v.length + C;
+  }
+  const x = u.reduce((U, v) => U + v.length, 0), p = V(c), m = new ArrayBuffer(22), y = new DataView(m);
+  y.setUint32(0, q, !0), y.setUint16(4, 0, !0), y.setUint16(6, 0, !0), y.setUint16(8, n.length, !0), y.setUint16(10, n.length, !0), y.setUint32(12, x, !0), y.setUint32(16, w, !0), y.setUint16(20, p.length, !0);
+  const T = [
+    ...f.map((U) => j(U)),
+    ...u.map((U) => j(U)),
+    m,
+    j(p)
+  ];
+  return new Blob(T, { type: "application/zip" });
+}
+async function pe(n) {
+  const o = n instanceof Blob ? new Uint8Array(await n.arrayBuffer()) : n, s = [], c = ge(o);
+  if (!c)
+    throw new Error("Invalid ZIP file: end of central directory not found");
+  const l = new DataView(o.buffer, o.byteOffset, o.byteLength);
+  let f = c.centralDirectoryOffset;
+  for (let u = 0; u < c.entryCount; u++) {
+    if (l.getUint32(f, !0) !== G)
+      throw new Error("Invalid ZIP file: invalid central directory entry");
+    const A = l.getUint16(f + 10, !0), h = l.getUint16(f + 12, !0), x = l.getUint16(f + 14, !0), p = l.getUint32(f + 20, !0), m = l.getUint32(f + 24, !0), y = l.getUint16(f + 28, !0), T = l.getUint16(f + 30, !0), U = l.getUint16(f + 32, !0), v = o.slice(f + 46, f + 46 + y), b = Q(v);
+    s.push({
+      path: b,
+      compressedSize: p,
+      uncompressedSize: m,
+      compressionMethod: A === M ? "deflate" : "store",
+      isDirectory: b.endsWith("/"),
+      modifiedAt: Z(h, x)
+    }), f += 46 + y + T + U;
+  }
+  return s;
+}
+async function te(n, o = {}) {
+  const { filter: s } = o, c = n instanceof Blob ? new Uint8Array(await n.arrayBuffer()) : n, l = [], f = new DataView(c.buffer, c.byteOffset, c.byteLength);
+  let u = 0;
+  for (; u < c.length - 4; ) {
+    const w = f.getUint32(u, !0);
+    if (w === Y) {
+      const A = f.getUint16(u + 8, !0), h = f.getUint16(u + 10, !0), x = f.getUint16(u + 12, !0), p = f.getUint32(u + 14, !0), m = f.getUint32(u + 18, !0), y = f.getUint32(u + 22, !0), T = f.getUint16(u + 26, !0), U = f.getUint16(u + 28, !0), v = c.slice(u + 30, u + 30 + T), b = Q(v), O = u + 30 + T + U, z = c.slice(O, O + m), B = b.endsWith("/"), C = A === M ? "deflate" : "store";
+      if (s) {
+        const L = {
+          path: b,
+          compressedSize: m,
+          uncompressedSize: y,
+          compressionMethod: C,
+          isDirectory: B,
+          modifiedAt: Z(h, x)
+        };
+        if (!s(L)) {
+          u = O + m;
+          continue;
+        }
+      }
+      let R;
+      B ? R = new Uint8Array(0) : A === M ? R = await ee(z) : R = new Uint8Array(z), l.push({
+        path: b,
+        content: R,
+        compressedSize: m,
+        uncompressedSize: y,
+        compressionMethod: C,
+        crc32: p,
+        modifiedAt: Z(h, x),
+        isDirectory: B
+      }), u = O + m;
+    } else {
+      if (w === G)
+        break;
+      u++;
+    }
+  }
+  return l;
+}
+async function ye(n, o) {
+  const s = await te(n, {
+    filter: (c) => c.path === o
+  });
+  return s.length > 0 ? s[0]?.content : void 0;
+}
+function ge(n) {
+  const o = new DataView(n.buffer, n.byteOffset, n.byteLength);
+  for (let s = n.length - 22; s >= 0; s--)
+    if (o.getUint32(s, !0) === q)
+      return {
+        entryCount: o.getUint16(s + 10, !0),
+        centralDirectorySize: o.getUint32(s + 12, !0),
+        centralDirectoryOffset: o.getUint32(s + 16, !0)
+      };
+}
+function k(n, o) {
+  const s = URL.createObjectURL(n), c = document.createElement("a");
+  c.href = s, c.download = o, document.body.appendChild(c), c.click(), document.body.removeChild(c), URL.revokeObjectURL(s);
+}
+async function Ue(n, o, s = {}) {
+  const c = await J(n, s);
+  k(c, o);
+}
+function ve() {
+  const n = _(!1), o = _(0), s = _(void 0), c = N(() => ({
+    isProcessing: n.value,
+    progress: o.value,
+    error: s.value
+  }));
+  async function l(p) {
+    n.value = !0, o.value = 0, s.value = void 0;
+    try {
+      const m = await p();
+      return o.value = 100, m;
+    } catch (m) {
+      const y = m instanceof Error ? m.message : "Unknown error";
+      throw s.value = y, m;
+    } finally {
+      n.value = !1;
+    }
+  }
+  async function f(p, m = {}) {
+    return l(() => J(p, m));
+  }
+  async function u(p, m = {}) {
+    return l(() => te(p, m));
+  }
+  async function w(p, m) {
+    return l(() => ye(p, m));
+  }
+  async function A(p) {
+    return l(() => pe(p));
+  }
+  async function h(p, m, y = {}) {
+    return l(async () => {
+      const T = await J(p, y);
+      k(T, m);
+    });
+  }
+  function x() {
+    s.value = void 0;
+  }
+  return {
+    state: c,
+    isProcessing: n,
+    progress: o,
+    error: s,
+    create: f,
+    extract: u,
+    extractSingle: w,
+    list: A,
+    download: h,
+    downloadBlob: k,
+    compress: X,
+    decompress: ee,
+    computeCrc32: K,
+    clearError: x
+  };
+}
+export {
+  X as compress,
+  K as computeCrc32,
+  fe as createFileSystem,
+  J as createZip,
+  ee as decompress,
+  Ue as downloadAsZip,
+  k as downloadBlob,
+  ye as extractFile,
+  te as extractZip,
+  pe as listZip,
+  he as useFileSystem,
+  ve as useZip
+};

package/dist/usefilesystem.umd.cjs

@@ -0,0 +1 @@
+(function(w,E){typeof exports=="object"&&typeof module<"u"?E(exports,require("vue")):typeof define=="function"&&define.amd?define(["exports","vue"],E):(w=typeof globalThis<"u"?globalThis:w||self,E(w.usefilesystem={},w.Vue))})(this,(function(w,E){"use strict";function K(){const n={name:"",path:"/",createdAt:Date.now(),files:new Map,directories:new Map},o=new Set;function s(e,t,i){for(const r of o)r(e,t,i)}function c(e){const t=e.split(/[/\\]/).filter(r=>r.length>0&&r!=="."),i=[];for(const r of t)r===".."?i.pop():i.push(r);return"/"+i.join("/")}function l(e){const t=c(e);return{segments:t.split("/").filter(r=>r.length>0),normalized:t}}function f(e){const{segments:t}=l(e);if(t.length===0)return{parentPath:"/",name:""};const i=t[t.length-1]??"";return{parentPath:"/"+t.slice(0,-1).join("/"),name:i}}function u(e,t=!1){const{segments:i}=l(e);let r=n;for(const a of i){let d=r.directories.get(a);if(!d){if(!t)return;d={name:a,path:r.path==="/"?`/${a}`:`${r.path}/${a}`,createdAt:Date.now(),files:new Map,directories:new Map},r.directories.set(a,d),s("create",d.path,"directory")}r=d}return r}function h(e){return new TextEncoder().encode(e)}function T(e){return new TextDecoder().decode(e)}function U(e){const t=e.split(".").pop()?.toLowerCase()??"";return{txt:"text/plain",html:"text/html",htm:"text/html",css:"text/css",js:"text/javascript",mjs:"text/javascript",ts:"text/typescript",tsx:"text/typescript",json:"application/json",xml:"application/xml",csv:"text/csv",md:"text/markdown",yaml:"text/yaml",yml:"text/yaml",png:"image/png",jpg:"image/jpeg",jpeg:"image/jpeg",gif:"image/gif",svg:"image/svg+xml",webp:"image/webp",ico:"image/x-icon",pdf:"application/pdf",zip:"application/zip",gz:"application/gzip",tar:"application/x-tar",woff:"font/woff",woff2:"font/woff2",ttf:"font/ttf",otf:"font/otf",mp3:"audio/mpeg",wav:"audio/wav",mp4:"video/mp4",webm:"video/webm"}[t]??"application/octet-stream"}function S(e){return new Uint8Array(e)}function p(e,t,i={}){const{parentPath:r,name:a}=f(e),{normalized:d}=l(e);if(!a)return{success:!1,error:"Invalid file path: no filename specified"};const O=u(r,!0);if(!O)return{success:!1,error:`Failed to create parent directory: ${r}`};const B=O.files.get(a);if(B&&i.overwrite===!1)return{success:!1,error:`File already exists: ${d}`};const _=typeof t=="string"?h(t):S(t),oe=Date.now(),he={name:a,path:d,content:_,size:_.length,mimeType:i.mimeType??U(a),createdAt:B?.createdAt??oe,modifiedAt:oe};return O.files.set(a,he),s(B?"modify":"create",d,"file"),{success:!0}}function m(e,t){const i=y(e,{encoding:"binary"}),r=typeof t=="string"?h(t):t;if(i===void 0)return p(e,r);const a=i,d=new Uint8Array(a.length+r.length);return d.set(a,0),d.set(r,a.length),p(e,d)}function y(e,t={}){const{parentPath:i,name:r}=f(e),d=u(i)?.files.get(r);return d?(t.encoding??"utf8")==="binary"?S(d.content):T(d.content):void 0}function D(e){const{parentPath:t,name:i}=f(e),a=u(t)?.files.get(i);if(a)return{name:a.name,path:a.path,size:a.size,mimeType:a.mimeType,createdAt:a.createdAt,modifiedAt:a.modifiedAt}}function v(e){return D(e)!==void 0||A(e)}function b(e){return D(e)!==void 0}function A(e){return u(e)!==void 0}function C(e){const{parentPath:t,name:i}=f(e),{normalized:r}=l(e),a=u(t);return a?a.files.has(i)?(a.files.delete(i),s("delete",r,"file"),{success:!0}):{success:!1,error:`File not found: ${r}`}:{success:!1,error:`Parent directory not found: ${t}`}}function z(e,t,i={}){const r=y(e,{encoding:"binary"});if(r===void 0)return{success:!1,error:`Source file not found: ${e}`};const a=D(e);return p(t,r,{mimeType:a?.mimeType,overwrite:i.overwrite})}function P(e,t,i={}){const r=z(e,t,{overwrite:i.overwrite});return r.success?C(e):r}function F(e,t){return P(e,t,{overwrite:!1})}function R(e){return u(e,!0)?{success:!0}:{success:!1,error:`Failed to create directory: ${e}`}}function j(e){const{parentPath:t,name:i}=f(e),{normalized:r}=l(e);if(r==="/")return{success:!1,error:"Cannot remove root directory"};const a=u(t);if(!a)return{success:!1,error:`Parent directory not found: ${t}`};const d=a.directories.get(i);return d?d.files.size>0||d.directories.size>0?{success:!1,error:`Directory not empty: ${r}`}:(a.directories.delete(i),s("delete",r,"directory"),{success:!0}):{success:!1,error:`Directory not found: ${r}`}}function x(e){const{parentPath:t,name:i}=f(e),{normalized:r}=l(e);if(r==="/")return{success:!1,error:"Cannot remove root directory"};const a=u(t);return a?a.directories.get(i)?(a.directories.delete(i),s("delete",r,"directory"),{success:!0}):{success:!1,error:`Directory not found: ${r}`}:{success:!1,error:`Parent directory not found: ${t}`}}function M(e,t={}){const{recursive:i=!1,filesOnly:r=!1,directoriesOnly:a=!1}=t,d=e==="/"||e===""?n:u(e);if(!d)return[];const O=[];if(!a)for(const B of d.files.values())O.push({name:B.name,path:B.path,type:"file",size:B.size});if(!r){for(const B of d.directories.values())if(O.push({name:B.name,path:B.path,type:"directory"}),i){const _=M(B.path,t);O.push(..._)}}return O}function g(e){const t=u(e);if(t)return{name:t.name,path:t.path,createdAt:t.createdAt}}function L(){const e=[];function t(i){for(const r of i.files.values())e.push(r);for(const r of i.directories.values())t(r)}return t(n),e}function q(){return L().map(e=>e.path)}function de(){let e=0,t=0,i=0;function r(a){for(const d of a.files.values())e++,i+=d.size;for(const d of a.directories.values())t++,r(d)}return r(n),{totalFiles:e,totalDirectories:t,totalSize:i}}function re(){n.files.clear(),n.directories.clear(),s("delete","/","directory")}function me(e){const t=q(),i=e.replace(/\./g,"\\.").replace(/\*\*/g,"<<<GLOBSTAR>>>").replace(/\*/g,"[^/]*").replace(/<<<GLOBSTAR>>>/g,".*"),r=new RegExp(`^${i}$`);return t.filter(a=>r.test(a))}function pe(e){const t=e.startsWith(".")?e:`.${e}`;return q().filter(i=>i.endsWith(t))}function ye(e){return o.add(e),()=>{o.delete(e)}}function ge(){const e={};for(const t of L()){const i=btoa(Array.from(t.content,r=>String.fromCharCode(r)).join(""));e[t.path]={content:i,mimeType:t.mimeType}}return e}function we(e){re();for(const[t,{content:i,mimeType:r}]of Object.entries(e)){const a=atob(i),d=Uint8Array.from(a,O=>O.charCodeAt(0));p(t,d,{mimeType:r})}}return{writeFile:p,appendFile:m,readFile:y,stat:D,exists:v,isFile:b,isDirectory:A,remove:C,copy:z,move:P,rename:F,mkdir:R,rmdir:j,rmdirRecursive:x,list:M,statDirectory:g,getAllFiles:L,getAllPaths:q,getStats:de,clear:re,find:me,findByExtension:pe,watch:ye,toJSON:ge,fromJSON:we}}function se(n={}){const{adapter:o,autoPersist:s=!1}=n,c=K(),l=E.shallowRef(0);function f(){l.value++,s&&o&&U()}c.watch(()=>{f()});const u=E.computed(()=>(l.value,c.getStats())),h=E.computed(()=>u.value.totalFiles),T=E.computed(()=>u.value.totalSize);async function U(){if(!o)throw new Error("No storage adapter configured");const p=c.toJSON(),m=new TextEncoder().encode(JSON.stringify(p));await o.save("filesystem",m)}async function S(){if(!o)throw new Error("No storage adapter configured");const p=await o.load("filesystem");if(p){const m=JSON.parse(new TextDecoder().decode(p));c.fromJSON(m),f()}}return{...c,stats:u,fileCount:h,totalSize:T,persist:U,restore:S}}const Q=67324752,V=33639248,X=101010256,ie=0,N=8,ce=(function(){const o=new Uint32Array(256);for(let s=0;s<256;s++){let c=s;for(let l=0;l<8;l++)c=c&1?3988292384^c>>>1:c>>>1;o[s]=c}return o})();function J(n){let o=4294967295;for(let s=0;s<n.length;s++){const c=n[s]??0,l=(o^c)&255;o=o>>>8^(ce[l]??0)}return~o>>>0}function $(n){const o=new ArrayBuffer(n.byteLength);return new Uint8Array(o).set(n),o}function k(n){return new TextEncoder().encode(n)}function ee(n){return new TextDecoder().decode(n)}async function G(n){const s=new Blob([$(n)]).stream().pipeThrough(new CompressionStream("deflate-raw")),c=await new Response(s).blob();return new Uint8Array(await c.arrayBuffer())}async function W(n){const s=new Blob([$(n)]).stream().pipeThrough(new DecompressionStream("deflate-raw")),c=await new Response(s).blob();return new Uint8Array(await c.arrayBuffer())}function ae(n){const o=n.getHours(),s=n.getMinutes(),c=Math.floor(n.getSeconds()/2),l=o<<11|s<<5|c,f=n.getFullYear()-1980,u=n.getMonth()+1,h=n.getDate(),T=f<<9|u<<5|h;return{time:l,date:T}}function H(n,o){const s=(n&31)*2,c=n>>5&63,l=n>>11&31,f=o&31,u=(o>>5&15)-1,h=(o>>9&127)+1980;return new Date(h,u,f,l,c,s)}async function I(n,o={}){const{level:s="default",comment:c=""}=o,l=s!=="none",f=[],u=[];let h=0;const U=ae(new Date);for(const v of n){const b=k(v.path),A=typeof v.content=="string"?k(v.content):v.content,C=J(A),z=A.length,P=l?await G(A):A,F=P.length,R=l?N:ie,j=new ArrayBuffer(30),x=new DataView(j);x.setUint32(0,Q,!0),x.setUint16(4,20,!0),x.setUint16(6,0,!0),x.setUint16(8,R,!0),x.setUint16(10,U.time,!0),x.setUint16(12,U.date,!0),x.setUint32(14,C,!0),x.setUint32(18,F,!0),x.setUint32(22,z,!0),x.setUint16(26,b.length,!0),x.setUint16(28,0,!0),f.push(new Uint8Array(j),b,P);const M=new ArrayBuffer(46),g=new DataView(M);g.setUint32(0,V,!0),g.setUint16(4,20,!0),g.setUint16(6,20,!0),g.setUint16(8,0,!0),g.setUint16(10,R,!0),g.setUint16(12,U.time,!0),g.setUint16(14,U.date,!0),g.setUint32(16,C,!0),g.setUint32(20,F,!0),g.setUint32(24,z,!0),g.setUint16(28,b.length,!0),g.setUint16(30,0,!0),g.setUint16(32,0,!0),g.setUint16(34,0,!0),g.setUint16(36,0,!0),g.setUint32(38,0,!0),g.setUint32(42,h,!0);const L=new Uint8Array(46+b.length);L.set(new Uint8Array(M),0),L.set(b,46),u.push(L),h+=30+b.length+F}const S=u.reduce((v,b)=>v+b.length,0),p=k(c),m=new ArrayBuffer(22),y=new DataView(m);y.setUint32(0,X,!0),y.setUint16(4,0,!0),y.setUint16(6,0,!0),y.setUint16(8,n.length,!0),y.setUint16(10,n.length,!0),y.setUint32(12,S,!0),y.setUint32(16,h,!0),y.setUint16(20,p.length,!0);const D=[...f.map(v=>$(v)),...u.map(v=>$(v)),m,$(p)];return new Blob(D,{type:"application/zip"})}async function te(n){const o=n instanceof Blob?new Uint8Array(await n.arrayBuffer()):n,s=[],c=ue(o);if(!c)throw new Error("Invalid ZIP file: end of central directory not found");const l=new DataView(o.buffer,o.byteOffset,o.byteLength);let f=c.centralDirectoryOffset;for(let u=0;u<c.entryCount;u++){if(l.getUint32(f,!0)!==V)throw new Error("Invalid ZIP file: invalid central directory entry");const T=l.getUint16(f+10,!0),U=l.getUint16(f+12,!0),S=l.getUint16(f+14,!0),p=l.getUint32(f+20,!0),m=l.getUint32(f+24,!0),y=l.getUint16(f+28,!0),D=l.getUint16(f+30,!0),v=l.getUint16(f+32,!0),b=o.slice(f+46,f+46+y),A=ee(b);s.push({path:A,compressedSize:p,uncompressedSize:m,compressionMethod:T===N?"deflate":"store",isDirectory:A.endsWith("/"),modifiedAt:H(U,S)}),f+=46+y+D+v}return s}async function Y(n,o={}){const{filter:s}=o,c=n instanceof Blob?new Uint8Array(await n.arrayBuffer()):n,l=[],f=new DataView(c.buffer,c.byteOffset,c.byteLength);let u=0;for(;u<c.length-4;){const h=f.getUint32(u,!0);if(h===Q){const T=f.getUint16(u+8,!0),U=f.getUint16(u+10,!0),S=f.getUint16(u+12,!0),p=f.getUint32(u+14,!0),m=f.getUint32(u+18,!0),y=f.getUint32(u+22,!0),D=f.getUint16(u+26,!0),v=f.getUint16(u+28,!0),b=c.slice(u+30,u+30+D),A=ee(b),C=u+30+D+v,z=c.slice(C,C+m),P=A.endsWith("/"),F=T===N?"deflate":"store";if(s){const j={path:A,compressedSize:m,uncompressedSize:y,compressionMethod:F,isDirectory:P,modifiedAt:H(U,S)};if(!s(j)){u=C+m;continue}}let R;P?R=new Uint8Array(0):T===N?R=await W(z):R=new Uint8Array(z),l.push({path:A,content:R,compressedSize:m,uncompressedSize:y,compressionMethod:F,crc32:p,modifiedAt:H(U,S),isDirectory:P}),u=C+m}else{if(h===V)break;u++}}return l}async function ne(n,o){const s=await Y(n,{filter:c=>c.path===o});return s.length>0?s[0]?.content:void 0}function ue(n){const o=new DataView(n.buffer,n.byteOffset,n.byteLength);for(let s=n.length-22;s>=0;s--)if(o.getUint32(s,!0)===X)return{entryCount:o.getUint16(s+10,!0),centralDirectorySize:o.getUint32(s+12,!0),centralDirectoryOffset:o.getUint32(s+16,!0)}}function Z(n,o){const s=URL.createObjectURL(n),c=document.createElement("a");c.href=s,c.download=o,document.body.appendChild(c),c.click(),document.body.removeChild(c),URL.revokeObjectURL(s)}async function fe(n,o,s={}){const c=await I(n,s);Z(c,o)}function le(){const n=E.ref(!1),o=E.ref(0),s=E.ref(void 0),c=E.computed(()=>({isProcessing:n.value,progress:o.value,error:s.value}));async function l(p){n.value=!0,o.value=0,s.value=void 0;try{const m=await p();return o.value=100,m}catch(m){const y=m instanceof Error?m.message:"Unknown error";throw s.value=y,m}finally{n.value=!1}}async function f(p,m={}){return l(()=>I(p,m))}async function u(p,m={}){return l(()=>Y(p,m))}async function h(p,m){return l(()=>ne(p,m))}async function T(p){return l(()=>te(p))}async function U(p,m,y={}){return l(async()=>{const D=await I(p,y);Z(D,m)})}function S(){s.value=void 0}return{state:c,isProcessing:n,progress:o,error:s,create:f,extract:u,extractSingle:h,list:T,download:U,downloadBlob:Z,compress:G,decompress:W,computeCrc32:J,clearError:S}}w.compress=G,w.computeCrc32=J,w.createFileSystem=K,w.createZip=I,w.decompress=W,w.downloadAsZip=fe,w.downloadBlob=Z,w.extractFile=ne,w.extractZip=Y,w.listZip=te,w.useFileSystem=se,w.useZip=le,Object.defineProperty(w,Symbol.toStringTag,{value:"Module"})}));

package/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "@mikestools/usefilesystem",
+  "version": "0.0.1",
+  "description": "Vue 3 composables for in-memory virtual filesystem and ZIP archive operations",
+  "type": "module",
+  "main": "./dist/usefilesystem.umd.cjs",
+  "module": "./dist/usefilesystem.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/usefilesystem.js",
+      "require": "./dist/usefilesystem.umd.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "vue",
+    "vue3",
+    "composables",
+    "composition-api",
+    "typescript",
+    "filesystem",
+    "virtual-filesystem",
+    "zip",
+    "archive",
+    "compression",
+    "deflate",
+    "in-memory"
+  ],
+  "author": "mikesaintsg",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mikesaintsg/usefilesystem.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mikesaintsg/usefilesystem/issues"
+  },
+  "homepage": "https://github.com/mikesaintsg/usefilesystem#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "peerDependencies": {
+    "vue": "^3.3.0"
+  },
+  "scripts": {
+    "dev": "vite --config configs/vite.showcase.config.ts",
+    "build": "npm run clean dist && vite build && npm run show",
+    "build:showcase": "vite build --config configs/vite.showcase.config.ts",
+    "check": "npm run decache && vue-tsc",
+    "check:showcase": "npm run decache && vue-tsc -p configs/tsconfig.showcase.json",
+    "test": "npm run decache && vitest run --no-cache",
+    "format": "npm run decache && eslint . --fix",
+    "show": "npm run build:showcase && npm run copy dist/showcase/index.html showcase.html && npm run clean dist/showcase",
+    "clean": "node -e \"try{require('fs').rmSync(process.argv[1],{recursive:true,force:true});console.log(`Deleted: ${process.argv[1]}`)}catch(e){throw e}\"",
+    "copy": "node -e \"try{require('fs').cpSync(process.argv[1],process.argv[2],{force:true});console.log(`Copied: ${process.argv[1]} to ${process.argv[2]}`)}catch(e){throw e}\"",
+    "decache": "node -e \"const fs=require('fs');['.eslintcache','node_modules/.vite','node_modules/.vitest','node_modules/.cache'].forEach(p=>{try{fs.rmSync(p,{recursive:true,force:true});console.log(`Cleared: ${p}`)}catch(e){}})\"",
+    "prepublishOnly": "npm run check && npm run format && npm test && npm run show && npm run build"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@mikestools/usebootstrap": "^0.0.5",
+    "@mikestools/usetable": "^0.0.1",
+    "@mikestools/usetools": "^0.0.10",
+    "@popperjs/core": "^2.11.8",
+    "@types/bootstrap": "^5.2.10",
+    "@types/node": "^24.10.1",
+    "@vitejs/plugin-vue": "^6.0.2",
+    "@vitest/eslint-plugin": "^1.5.1",
+    "@vue/test-utils": "^2.4.6",
+    "bootstrap": "^5.3.8",
+    "bootstrap-icons": "^1.13.1",
+    "eslint": "^9.39.1",
+    "eslint-plugin-vue": "^10.6.2",
+    "globals": "^16.5.0",
+    "happy-dom": "^20.0.11",
+    "jiti": "^2.6.1",
+    "sass": "^1.94.2",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.48.1",
+    "vite": "^7.2.6",
+    "vite-plugin-dts": "^4.5.4",
+    "vite-plugin-singlefile": "^2.3.0",
+    "vite-svg-loader": "^5.1.0",
+    "vitest": "^4.0.15",
+    "vue-tsc": "^3.1.6"
+  }
+}