@fgv/ts-res-ui-components 5.0.0-10

package/lib/utils/zipLoader/types.d.ts

@@ -0,0 +1,139 @@
+import { Result } from '@fgv/ts-utils';
+import { Config } from '@fgv/ts-res';
+import { ImportedDirectory, ImportedFile, ProcessedResources } from '../../types';
+/**
+ * ZIP manifest metadata structure
+ */
+export interface ZipManifest {
+    timestamp: string;
+    input?: {
+        type: 'file' | 'directory';
+        originalPath: string;
+        archivePath: string;
+    };
+    config?: {
+        type: 'file';
+        originalPath: string;
+        archivePath: string;
+    };
+}
+/**
+ * Options for creating ZIP archives
+ */
+export interface ZipArchiveOptions {
+    /** Output directory for the ZIP file */
+    outputDir?: string;
+    /** Custom filename (without extension) */
+    filename?: string;
+    /** Compression level (0-9) */
+    compressionLevel?: number;
+    /** Include configuration file */
+    includeConfig?: boolean;
+    /** Custom configuration to include */
+    config?: Config.Model.ISystemConfiguration;
+}
+/**
+ * Result of ZIP archive creation
+ */
+export interface ZipArchiveResult {
+    /** Path to the created ZIP file */
+    filePath: string;
+    /** Size of the ZIP file in bytes */
+    fileSize: number;
+    /** Generated manifest */
+    manifest: ZipManifest;
+    /** Timestamp when created */
+    timestamp: string;
+}
+/**
+ * Options for loading ZIP archives
+ */
+export interface ZipLoadOptions {
+    /** Whether to auto-apply configuration found in ZIP */
+    autoApplyConfig?: boolean;
+    /** Whether to auto-process resources after loading */
+    autoProcessResources?: boolean;
+    /** Custom configuration to use instead of ZIP config */
+    overrideConfig?: Config.Model.ISystemConfiguration;
+}
+/**
+ * Result of ZIP loading operation
+ */
+export interface ZipLoadResult {
+    /** Manifest from the ZIP */
+    manifest: ZipManifest | null;
+    /** Configuration found in ZIP */
+    config: Config.Model.ISystemConfiguration | null;
+    /** Loaded files */
+    files: ImportedFile[];
+    /** Loaded directory structure */
+    directory: ImportedDirectory | null;
+    /** File tree for direct processing */
+    fileTree?: any;
+    /** Processed resources if auto-processing was enabled */
+    processedResources: ProcessedResources | null;
+}
+/**
+ * ZIP loading progress stages
+ */
+export type ZipLoadingStage = 'reading-file' | 'parsing-zip' | 'loading-manifest' | 'loading-config' | 'extracting-files' | 'processing-resources' | 'complete';
+/**
+ * Progress callback for ZIP operations
+ */
+export interface ZipProgressCallback {
+    (stage: ZipLoadingStage, progress: number, message?: string): void;
+}
+/**
+ * ZIP builder interface (Node.js environment)
+ */
+export interface IZipBuilder {
+    /**
+     * Create ZIP from files
+     */
+    createFromFiles(files: ImportedFile[], options?: ZipArchiveOptions): Promise<Result<ZipArchiveResult>>;
+    /**
+     * Create ZIP from directory
+     */
+    createFromDirectory(directory: ImportedDirectory, options?: ZipArchiveOptions): Promise<Result<ZipArchiveResult>>;
+    /**
+     * Create ZIP from file system path
+     */
+    createFromPath(path: string, options?: ZipArchiveOptions): Promise<Result<ZipArchiveResult>>;
+}
+/**
+ * ZIP loader interface (Browser environment)
+ */
+export interface IZipLoader {
+    /**
+     * Load ZIP from File object
+     */
+    loadFromFile(file: File, options?: ZipLoadOptions, onProgress?: ZipProgressCallback): Promise<Result<ZipLoadResult>>;
+    /**
+     * Load ZIP from ArrayBuffer
+     */
+    loadFromBuffer(buffer: ArrayBuffer, options?: ZipLoadOptions, onProgress?: ZipProgressCallback): Promise<Result<ZipLoadResult>>;
+    /**
+     * Load ZIP from URL
+     */
+    loadFromUrl(url: string, options?: ZipLoadOptions, onProgress?: ZipProgressCallback): Promise<Result<ZipLoadResult>>;
+}
+/**
+ * File item within a ZIP archive
+ */
+export interface ZipFileItem {
+    name: string;
+    path: string;
+    size: number;
+    isDirectory: boolean;
+    lastModified?: Date;
+    content?: string | ArrayBuffer;
+}
+/**
+ * ZIP file tree representation
+ */
+export interface ZipFileTree {
+    files: Map<string, ZipFileItem>;
+    directories: Set<string>;
+    root: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/utils/zipLoader/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/zipLoader/types.ts"],"names":[],"mappings":"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"}

package/lib/utils/zipLoader/types.js

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

package/lib/utils/zipLoader/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/zipLoader/types.ts"],"names":[],"mappings":"","sourcesContent":["import { Result } from '@fgv/ts-utils';\nimport { Config } from '@fgv/ts-res';\nimport { ImportedDirectory, ImportedFile, ProcessedResources } from '../../types';\n\n/**\n * ZIP manifest metadata structure\n */\nexport interface ZipManifest {\n  timestamp: string;\n  input?: {\n    type: 'file' | 'directory';\n    originalPath: string;\n    archivePath: string;\n  };\n  config?: {\n    type: 'file';\n    originalPath: string;\n    archivePath: string;\n  };\n}\n\n/**\n * Options for creating ZIP archives\n */\nexport interface ZipArchiveOptions {\n  /** Output directory for the ZIP file */\n  outputDir?: string;\n  /** Custom filename (without extension) */\n  filename?: string;\n  /** Compression level (0-9) */\n  compressionLevel?: number;\n  /** Include configuration file */\n  includeConfig?: boolean;\n  /** Custom configuration to include */\n  config?: Config.Model.ISystemConfiguration;\n}\n\n/**\n * Result of ZIP archive creation\n */\nexport interface ZipArchiveResult {\n  /** Path to the created ZIP file */\n  filePath: string;\n  /** Size of the ZIP file in bytes */\n  fileSize: number;\n  /** Generated manifest */\n  manifest: ZipManifest;\n  /** Timestamp when created */\n  timestamp: string;\n}\n\n/**\n * Options for loading ZIP archives\n */\nexport interface ZipLoadOptions {\n  /** Whether to auto-apply configuration found in ZIP */\n  autoApplyConfig?: boolean;\n  /** Whether to auto-process resources after loading */\n  autoProcessResources?: boolean;\n  /** Custom configuration to use instead of ZIP config */\n  overrideConfig?: Config.Model.ISystemConfiguration;\n}\n\n/**\n * Result of ZIP loading operation\n */\nexport interface ZipLoadResult {\n  /** Manifest from the ZIP */\n  manifest: ZipManifest | null;\n  /** Configuration found in ZIP */\n  config: Config.Model.ISystemConfiguration | null;\n  /** Loaded files */\n  files: ImportedFile[];\n  /** Loaded directory structure */\n  directory: ImportedDirectory | null;\n  /** File tree for direct processing */\n  fileTree?: any; // FileTree.FileTree from ts-utils\n  /** Processed resources if auto-processing was enabled */\n  processedResources: ProcessedResources | null;\n}\n\n/**\n * ZIP loading progress stages\n */\nexport type ZipLoadingStage =\n  | 'reading-file'\n  | 'parsing-zip'\n  | 'loading-manifest'\n  | 'loading-config'\n  | 'extracting-files'\n  | 'processing-resources'\n  | 'complete';\n\n/**\n * Progress callback for ZIP operations\n */\nexport interface ZipProgressCallback {\n  (stage: ZipLoadingStage, progress: number, message?: string): void;\n}\n\n/**\n * ZIP builder interface (Node.js environment)\n */\nexport interface IZipBuilder {\n  /**\n   * Create ZIP from files\n   */\n  createFromFiles(files: ImportedFile[], options?: ZipArchiveOptions): Promise<Result<ZipArchiveResult>>;\n\n  /**\n   * Create ZIP from directory\n   */\n  createFromDirectory(\n    directory: ImportedDirectory,\n    options?: ZipArchiveOptions\n  ): Promise<Result<ZipArchiveResult>>;\n\n  /**\n   * Create ZIP from file system path\n   */\n  createFromPath(path: string, options?: ZipArchiveOptions): Promise<Result<ZipArchiveResult>>;\n}\n\n/**\n * ZIP loader interface (Browser environment)\n */\nexport interface IZipLoader {\n  /**\n   * Load ZIP from File object\n   */\n  loadFromFile(\n    file: File,\n    options?: ZipLoadOptions,\n    onProgress?: ZipProgressCallback\n  ): Promise<Result<ZipLoadResult>>;\n\n  /**\n   * Load ZIP from ArrayBuffer\n   */\n  loadFromBuffer(\n    buffer: ArrayBuffer,\n    options?: ZipLoadOptions,\n    onProgress?: ZipProgressCallback\n  ): Promise<Result<ZipLoadResult>>;\n\n  /**\n   * Load ZIP from URL\n   */\n  loadFromUrl(\n    url: string,\n    options?: ZipLoadOptions,\n    onProgress?: ZipProgressCallback\n  ): Promise<Result<ZipLoadResult>>;\n}\n\n/**\n * File item within a ZIP archive\n */\nexport interface ZipFileItem {\n  name: string;\n  path: string;\n  size: number;\n  isDirectory: boolean;\n  lastModified?: Date;\n  content?: string | ArrayBuffer;\n}\n\n/**\n * ZIP file tree representation\n */\nexport interface ZipFileTree {\n  files: Map<string, ZipFileItem>;\n  directories: Set<string>;\n  root: string;\n}\n"]}

package/lib/utils/zipLoader/zipUtils.d.ts

@@ -0,0 +1,53 @@
+import { Result } from '@fgv/ts-utils';
+import { Config } from '@fgv/ts-res';
+import { ZipManifest, ZipFileTree } from './types';
+import { ImportedDirectory, ImportedFile } from '../../types';
+/**
+ * Generate a timestamp-based filename for ZIP archives
+ */
+export declare function generateZipFilename(customName?: string): string;
+/**
+ * Create a ZIP manifest object
+ */
+export declare function createManifest(inputType: 'file' | 'directory', originalPath: string, archivePath: string, configPath?: string): ZipManifest;
+/**
+ * Parse and validate a ZIP manifest
+ */
+export declare function parseManifest(manifestData: string): Result<ZipManifest>;
+/**
+ * Parse and validate configuration JSON
+ */
+export declare function parseConfiguration(configData: string): Result<Config.Model.ISystemConfiguration>;
+/**
+ * Convert ZIP file tree to ImportedFiles array
+ */
+export declare function zipTreeToFiles(tree: ZipFileTree): ImportedFile[];
+/**
+ * Convert ZIP file tree to ImportedDirectory structure
+ */
+export declare function zipTreeToDirectory(tree: ZipFileTree): ImportedDirectory | null;
+/**
+ * Normalize path separators for cross-platform compatibility
+ */
+export declare function normalizePath(path: string): string;
+/**
+ * Extract directory name from a file path
+ */
+export declare function getDirectoryName(path: string): string;
+/**
+ * Create a safe filename by removing invalid characters
+ */
+export declare function sanitizeFilename(filename: string): string;
+/**
+ * Format file size in human readable format
+ */
+export declare function formatFileSize(bytes: number): string;
+/**
+ * Validate ZIP file extension
+ */
+export declare function isZipFile(filename: string): boolean;
+/**
+ * Extract base name from filename (without extension)
+ */
+export declare function getBaseName(filename: string): string;
+//# sourceMappingURL=zipUtils.d.ts.map

package/lib/utils/zipLoader/zipUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zipUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/zipLoader/zipUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAiB,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAe,WAAW,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE9D;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,GAAG,WAAW,EAC/B,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,WAAW,CAmBb;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAiCvE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAchG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,EAAE,CAehE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,iBAAiB,GAAG,IAAI,CA6D9E;AA4BD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQpD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIpD"}

package/lib/utils/zipLoader/zipUtils.js

@@ -0,0 +1,229 @@
+import { succeed, fail } from '@fgv/ts-utils';
+/**
+ * Generate a timestamp-based filename for ZIP archives
+ */
+export function generateZipFilename(customName) {
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-').replace('T', '_').slice(0, -5);
+    return customName ? `${customName}-${timestamp}.zip` : `ts-res-bundle-${timestamp}.zip`;
+}
+/**
+ * Create a ZIP manifest object
+ */
+export function createManifest(inputType, originalPath, archivePath, configPath) {
+    const manifest = {
+        timestamp: new Date().toISOString(),
+        input: {
+            type: inputType,
+            originalPath,
+            archivePath
+        }
+    };
+    if (configPath) {
+        manifest.config = {
+            type: 'file',
+            originalPath: configPath,
+            archivePath: 'config.json'
+        };
+    }
+    return manifest;
+}
+/**
+ * Parse and validate a ZIP manifest
+ */
+export function parseManifest(manifestData) {
+    try {
+        const parsed = JSON.parse(manifestData);
+        // Basic validation
+        if (!parsed.timestamp || typeof parsed.timestamp !== 'string') {
+            return fail('Invalid manifest: missing or invalid timestamp');
+        }
+        // Validate input section if present
+        if (parsed.input) {
+            if (!parsed.input.type || !['file', 'directory'].includes(parsed.input.type)) {
+                return fail('Invalid manifest: invalid input type');
+            }
+            if (!parsed.input.originalPath || !parsed.input.archivePath) {
+                return fail('Invalid manifest: missing input paths');
+            }
+        }
+        // Validate config section if present
+        if (parsed.config) {
+            if (parsed.config.type !== 'file') {
+                return fail('Invalid manifest: invalid config type');
+            }
+            if (!parsed.config.originalPath || !parsed.config.archivePath) {
+                return fail('Invalid manifest: missing config paths');
+            }
+        }
+        return succeed(parsed);
+    }
+    catch (error) {
+        return fail(`Failed to parse manifest: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Parse and validate configuration JSON
+ */
+export function parseConfiguration(configData) {
+    try {
+        const parsed = JSON.parse(configData);
+        // Basic validation - check for expected properties
+        if (typeof parsed !== 'object' || parsed === null) {
+            return fail('Invalid configuration: not an object');
+        }
+        // More detailed validation could be added here using ts-res validators
+        return succeed(parsed);
+    }
+    catch (error) {
+        return fail(`Failed to parse configuration: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Convert ZIP file tree to ImportedFiles array
+ */
+export function zipTreeToFiles(tree) {
+    const files = [];
+    for (const [path, item] of Array.from(tree.files.entries())) {
+        if (!item.isDirectory && item.content && typeof item.content === 'string') {
+            files.push({
+                name: item.name,
+                path: path,
+                content: item.content,
+                type: getFileType(item.name)
+            });
+        }
+    }
+    return files;
+}
+/**
+ * Convert ZIP file tree to ImportedDirectory structure
+ */
+export function zipTreeToDirectory(tree) {
+    if (tree.files.size === 0) {
+        return null;
+    }
+    // Build directory structure
+    const directories = new Map();
+    const rootDir = {
+        name: tree.root || 'root',
+        files: [],
+        subdirectories: []
+    };
+    directories.set('', rootDir);
+    // Process all paths to build directory structure
+    for (const [path, item] of Array.from(tree.files.entries())) {
+        const pathParts = path.split('/').filter((part) => part.length > 0);
+        if (pathParts.length === 0)
+            continue;
+        // Ensure all parent directories exist
+        let currentPath = '';
+        for (let i = 0; i < pathParts.length - 1; i++) {
+            const parentPath = currentPath;
+            currentPath = currentPath ? `${currentPath}/${pathParts[i]}` : pathParts[i];
+            if (!directories.has(currentPath)) {
+                const newDir = {
+                    name: pathParts[i],
+                    files: [],
+                    subdirectories: []
+                };
+                directories.set(currentPath, newDir);
+                // Add to parent directory
+                const parentDir = directories.get(parentPath);
+                if (parentDir) {
+                    parentDir.subdirectories = parentDir.subdirectories || [];
+                    parentDir.subdirectories.push(newDir);
+                }
+            }
+        }
+        // Add file to its parent directory
+        if (!item.isDirectory && item.content && typeof item.content === 'string') {
+            const fileName = pathParts[pathParts.length - 1];
+            const parentPath = pathParts.length > 1 ? pathParts.slice(0, -1).join('/') : '';
+            const parentDir = directories.get(parentPath);
+            if (parentDir) {
+                parentDir.files.push({
+                    name: fileName,
+                    path: path,
+                    content: item.content,
+                    type: getFileType(fileName)
+                });
+            }
+        }
+    }
+    return rootDir;
+}
+/**
+ * Get file type based on extension
+ */
+function getFileType(filename) {
+    const ext = filename.toLowerCase().split('.').pop();
+    switch (ext) {
+        case 'json':
+            return 'application/json';
+        case 'yaml':
+        case 'yml':
+            return 'application/yaml';
+        case 'xml':
+            return 'application/xml';
+        case 'txt':
+            return 'text/plain';
+        case 'md':
+            return 'text/markdown';
+        case 'js':
+            return 'application/javascript';
+        case 'ts':
+            return 'application/typescript';
+        default:
+            return 'application/octet-stream';
+    }
+}
+/**
+ * Normalize path separators for cross-platform compatibility
+ */
+export function normalizePath(path) {
+    return path.replace(/\\/g, '/').replace(/\/+/g, '/');
+}
+/**
+ * Extract directory name from a file path
+ */
+export function getDirectoryName(path) {
+    const normalized = normalizePath(path);
+    const parts = normalized.split('/');
+    return parts[parts.length - 1] || 'archive';
+}
+/**
+ * Create a safe filename by removing invalid characters
+ */
+export function sanitizeFilename(filename) {
+    return filename
+        .replace(/[<>:"/\\|?*]/g, '_')
+        .replace(/\s+/g, '_')
+        .replace(/_+/g, '_')
+        .trim();
+}
+/**
+ * Format file size in human readable format
+ */
+export function formatFileSize(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const sizes = ['B', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(1024));
+    const size = bytes / Math.pow(1024, i);
+    return `${size.toFixed(i === 0 ? 0 : 1)} ${sizes[i]}`;
+}
+/**
+ * Validate ZIP file extension
+ */
+export function isZipFile(filename) {
+    return filename.toLowerCase().endsWith('.zip');
+}
+/**
+ * Extract base name from filename (without extension)
+ */
+export function getBaseName(filename) {
+    const name = filename.split('/').pop() || filename;
+    const dotIndex = name.lastIndexOf('.');
+    return dotIndex > 0 ? name.substring(0, dotIndex) : name;
+}
+//# sourceMappingURL=zipUtils.js.map

package/lib/utils/zipLoader/zipUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zipUtils.js","sourceRoot":"","sources":["../../../src/utils/zipLoader/zipUtils.ts"],"names":[],"mappings":"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","sourcesContent":["import { Result, succeed, fail } from '@fgv/ts-utils';\nimport { Config } from '@fgv/ts-res';\nimport { ZipManifest, ZipFileItem, ZipFileTree } from './types';\nimport { ImportedDirectory, ImportedFile } from '../../types';\n\n/**\n * Generate a timestamp-based filename for ZIP archives\n */\nexport function generateZipFilename(customName?: string): string {\n  const timestamp = new Date().toISOString().replace(/[:.]/g, '-').replace('T', '_').slice(0, -5);\n  return customName ? `${customName}-${timestamp}.zip` : `ts-res-bundle-${timestamp}.zip`;\n}\n\n/**\n * Create a ZIP manifest object\n */\nexport function createManifest(\n  inputType: 'file' | 'directory',\n  originalPath: string,\n  archivePath: string,\n  configPath?: string\n): ZipManifest {\n  const manifest: ZipManifest = {\n    timestamp: new Date().toISOString(),\n    input: {\n      type: inputType,\n      originalPath,\n      archivePath\n    }\n  };\n\n  if (configPath) {\n    manifest.config = {\n      type: 'file',\n      originalPath: configPath,\n      archivePath: 'config.json'\n    };\n  }\n\n  return manifest;\n}\n\n/**\n * Parse and validate a ZIP manifest\n */\nexport function parseManifest(manifestData: string): Result<ZipManifest> {\n  try {\n    const parsed = JSON.parse(manifestData);\n\n    // Basic validation\n    if (!parsed.timestamp || typeof parsed.timestamp !== 'string') {\n      return fail('Invalid manifest: missing or invalid timestamp');\n    }\n\n    // Validate input section if present\n    if (parsed.input) {\n      if (!parsed.input.type || !['file', 'directory'].includes(parsed.input.type)) {\n        return fail('Invalid manifest: invalid input type');\n      }\n      if (!parsed.input.originalPath || !parsed.input.archivePath) {\n        return fail('Invalid manifest: missing input paths');\n      }\n    }\n\n    // Validate config section if present\n    if (parsed.config) {\n      if (parsed.config.type !== 'file') {\n        return fail('Invalid manifest: invalid config type');\n      }\n      if (!parsed.config.originalPath || !parsed.config.archivePath) {\n        return fail('Invalid manifest: missing config paths');\n      }\n    }\n\n    return succeed(parsed as ZipManifest);\n  } catch (error) {\n    return fail(`Failed to parse manifest: ${error instanceof Error ? error.message : String(error)}`);\n  }\n}\n\n/**\n * Parse and validate configuration JSON\n */\nexport function parseConfiguration(configData: string): Result<Config.Model.ISystemConfiguration> {\n  try {\n    const parsed = JSON.parse(configData);\n\n    // Basic validation - check for expected properties\n    if (typeof parsed !== 'object' || parsed === null) {\n      return fail('Invalid configuration: not an object');\n    }\n\n    // More detailed validation could be added here using ts-res validators\n    return succeed(parsed as Config.Model.ISystemConfiguration);\n  } catch (error) {\n    return fail(`Failed to parse configuration: ${error instanceof Error ? error.message : String(error)}`);\n  }\n}\n\n/**\n * Convert ZIP file tree to ImportedFiles array\n */\nexport function zipTreeToFiles(tree: ZipFileTree): ImportedFile[] {\n  const files: ImportedFile[] = [];\n\n  for (const [path, item] of Array.from(tree.files.entries())) {\n    if (!item.isDirectory && item.content && typeof item.content === 'string') {\n      files.push({\n        name: item.name,\n        path: path,\n        content: item.content,\n        type: getFileType(item.name)\n      });\n    }\n  }\n\n  return files;\n}\n\n/**\n * Convert ZIP file tree to ImportedDirectory structure\n */\nexport function zipTreeToDirectory(tree: ZipFileTree): ImportedDirectory | null {\n  if (tree.files.size === 0) {\n    return null;\n  }\n\n  // Build directory structure\n  const directories = new Map<string, ImportedDirectory>();\n  const rootDir: ImportedDirectory = {\n    name: tree.root || 'root',\n    files: [],\n    subdirectories: []\n  };\n  directories.set('', rootDir);\n\n  // Process all paths to build directory structure\n  for (const [path, item] of Array.from(tree.files.entries())) {\n    const pathParts = path.split('/').filter((part: string) => part.length > 0);\n\n    if (pathParts.length === 0) continue;\n\n    // Ensure all parent directories exist\n    let currentPath = '';\n    for (let i = 0; i < pathParts.length - 1; i++) {\n      const parentPath = currentPath;\n      currentPath = currentPath ? `${currentPath}/${pathParts[i]}` : pathParts[i];\n\n      if (!directories.has(currentPath)) {\n        const newDir: ImportedDirectory = {\n          name: pathParts[i],\n          files: [],\n          subdirectories: []\n        };\n        directories.set(currentPath, newDir);\n\n        // Add to parent directory\n        const parentDir = directories.get(parentPath);\n        if (parentDir) {\n          parentDir.subdirectories = parentDir.subdirectories || [];\n          parentDir.subdirectories.push(newDir);\n        }\n      }\n    }\n\n    // Add file to its parent directory\n    if (!item.isDirectory && item.content && typeof item.content === 'string') {\n      const fileName = pathParts[pathParts.length - 1];\n      const parentPath = pathParts.length > 1 ? pathParts.slice(0, -1).join('/') : '';\n      const parentDir = directories.get(parentPath);\n\n      if (parentDir) {\n        parentDir.files.push({\n          name: fileName,\n          path: path,\n          content: item.content,\n          type: getFileType(fileName)\n        });\n      }\n    }\n  }\n\n  return rootDir;\n}\n\n/**\n * Get file type based on extension\n */\nfunction getFileType(filename: string): string {\n  const ext = filename.toLowerCase().split('.').pop();\n  switch (ext) {\n    case 'json':\n      return 'application/json';\n    case 'yaml':\n    case 'yml':\n      return 'application/yaml';\n    case 'xml':\n      return 'application/xml';\n    case 'txt':\n      return 'text/plain';\n    case 'md':\n      return 'text/markdown';\n    case 'js':\n      return 'application/javascript';\n    case 'ts':\n      return 'application/typescript';\n    default:\n      return 'application/octet-stream';\n  }\n}\n\n/**\n * Normalize path separators for cross-platform compatibility\n */\nexport function normalizePath(path: string): string {\n  return path.replace(/\\\\/g, '/').replace(/\\/+/g, '/');\n}\n\n/**\n * Extract directory name from a file path\n */\nexport function getDirectoryName(path: string): string {\n  const normalized = normalizePath(path);\n  const parts = normalized.split('/');\n  return parts[parts.length - 1] || 'archive';\n}\n\n/**\n * Create a safe filename by removing invalid characters\n */\nexport function sanitizeFilename(filename: string): string {\n  return filename\n    .replace(/[<>:\"/\\\\|?*]/g, '_')\n    .replace(/\\s+/g, '_')\n    .replace(/_+/g, '_')\n    .trim();\n}\n\n/**\n * Format file size in human readable format\n */\nexport function formatFileSize(bytes: number): string {\n  if (bytes === 0) return '0 B';\n\n  const sizes = ['B', 'KB', 'MB', 'GB'];\n  const i = Math.floor(Math.log(bytes) / Math.log(1024));\n  const size = bytes / Math.pow(1024, i);\n\n  return `${size.toFixed(i === 0 ? 0 : 1)} ${sizes[i]}`;\n}\n\n/**\n * Validate ZIP file extension\n */\nexport function isZipFile(filename: string): boolean {\n  return filename.toLowerCase().endsWith('.zip');\n}\n\n/**\n * Extract base name from filename (without extension)\n */\nexport function getBaseName(filename: string): string {\n  const name = filename.split('/').pop() || filename;\n  const dotIndex = name.lastIndexOf('.');\n  return dotIndex > 0 ? name.substring(0, dotIndex) : name;\n}\n"]}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@fgv/ts-res-ui-components",
+  "version": "5.0.0-10",
+  "description": "Reusable React components for ts-res resource visualization and management",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "sideEffects": false,
+  "keywords": [
+    "typescript",
+    "react",
+    "components",
+    "ts-res",
+    "resource-management",
+    "ui"
+  ],
+  "author": "Erik Fortune",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/ErikFortune/fgv/issues"
+  },
+  "homepage": "https://github.com/ErikFortune/fgv/tree/main/libraries/ts-res-ui-components#readme",
+  "dependencies": {
+    "@heroicons/react": "~2.2.0",
+    "jszip": "~3.10.1",
+    "tslib": "^2.8.1",
+    "json-edit-react": "~1.28.2",
+    "@fgv/ts-res": "5.0.0-10",
+    "@fgv/ts-utils": "5.0.0-10",
+    "@fgv/ts-json": "5.0.0-10",
+    "@fgv/ts-json-base": "5.0.0-10"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "~19.1.8",
+    "@types/react-dom": "~19.1.6",
+    "react": "~19.1.0",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^20.14.9",
+    "@typescript-eslint/eslint-plugin": "^7.14.1",
+    "@typescript-eslint/parser": "^7.14.1",
+    "eslint": "^8.57.0",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-node": "^11.1.0",
+    "eslint-plugin-promise": "^6.2.0",
+    "eslint-plugin-react": "^7.34.0",
+    "eslint-plugin-react-hooks": "^4.6.0",
+    "jest": "^29.7.0",
+    "react-dom": "~19.1.0",
+    "rimraf": "^5.0.7",
+    "ts-jest": "^29.4.0",
+    "typescript": "^5.7.3",
+    "@rushstack/heft": "~0.74.0",
+    "@rushstack/heft-web-rig": "~0.29.0",
+    "@rushstack/eslint-config": "~4.4.0",
+    "@rushstack/heft-jest-plugin": "~0.16.9",
+    "@fgv/ts-utils-jest": "5.0.0-10"
+  },
+  "scripts": {
+    "build": "heft build --clean",
+    "clean": "heft clean",
+    "test": "heft test --clean",
+    "lint": "eslint src --ext .ts,.tsx",
+    "fixlint": "eslint src --ext .ts,.tsx --fix",
+    "coverage": "jest --coverage"
+  }
+}

package/rush-logs/ts-res-ui-components.build.cache.log

@@ -0,0 +1,3 @@
+Caching build output folders: lib, lib-commonjs, temp, .rush/temp/operation/build
+Successfully set cache entry.
+Cache key: 03c8b056281d9db0a97d8a6e25eea798a160d393

package/rush-logs/ts-res-ui-components.build.log

@@ -0,0 +1,9 @@
+Invoking: heft build --clean 
+ ---- build started ---- 
+[build:set-browserslist-ignore-old-data-env-var] Setting environment variable BROWSERSLIST_IGNORE_OLD_DATA=1
+[build:sass] Starting...
+[build:sass] No SCSS files to process.
+[build:typescript] Using TypeScript version 5.8.3
+[build:webpack] No Webpack configuration found
+ ---- build finished (9.286s) ---- 
+-------------------- Finished (9.291s) --------------------