@mdxui/do 4.0.1 → 4.0.8

package/dist/{chunk-Y52IEYVM.js → chunk-JPZ6RZJE.js}

@@ -1,10 +1,12 @@
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
 
-// src/lib/utils.ts
+// src/utils/cn.ts
 function cn(...inputs) {
   return twMerge(clsx(inputs));
 }
+
+// src/utils/format.ts
 function formatSemanticId(ns, type, id) {
   return `${ns}/${type}/${id}`;
 }
@@ -65,7 +67,7 @@ function formatBytes(bytes) {
   const k = 1024;
   const sizes = ["B", "KB", "MB", "GB", "TB"];
   const i = Math.floor(Math.log(bytes) / Math.log(k));
-  return `${formatDecimal(bytes / Math.pow(k, i))} ${sizes[i]}`;
+  return `${formatDecimal(bytes / k ** i)} ${sizes[i]}`;
 }
 function formatDuration(ms) {
   if (ms < 1e3) return `${ms}ms`;
@@ -83,49 +85,80 @@ function capitalize(text) {
 function camelToTitle(text) {
   return text.replace(/([A-Z])/g, " $1").replace(/^./, (str) => str.toUpperCase()).trim();
 }
-function generateId(prefix) {
-  const id = Math.random().toString(36).substring(2, 15);
-  return prefix ? `${prefix}_${id}` : id;
-}
-function debounce(fn, delay) {
-  let timeoutId;
-  return (...args) => {
-    clearTimeout(timeoutId);
-    timeoutId = setTimeout(() => fn(...args), delay);
-  };
-}
-function groupBy(array, keyFn) {
-  return array.reduce((acc, item) => {
-    const key = keyFn(item);
-    if (!acc[key]) acc[key] = [];
-    acc[key].push(item);
-    return acc;
-  }, {});
-}
-async function retryWithBackoff(fn, config = {}) {
-  const { maxRetries = 3, backoffMultiplier = 1e3, signal, onRetry } = config;
-  let lastError;
-  for (let attempt = 0; attempt < maxRetries; attempt++) {
-    if (signal?.aborted) {
-      throw lastError ?? new Error("Retry cancelled");
-    }
-    try {
-      return await fn();
-    } catch (error) {
-      lastError = error instanceof Error ? error : new Error("Retry failed");
-      if (attempt < maxRetries - 1) {
-        onRetry?.(lastError, attempt + 1);
-        const delay = Math.pow(2, attempt) * backoffMultiplier;
-        await new Promise((resolve) => setTimeout(resolve, delay));
-        if (signal?.aborted) {
-          throw lastError ?? new Error("Retry cancelled");
-        }
-      }
-    }
+
+// src/utils/errors.ts
+var APIError = class _APIError extends Error {
+  constructor(code, message, status, details) {
+    super(message);
+    this.code = code;
+    this.status = status;
+    this.details = details;
+    this.name = "APIError";
+    Object.setPrototypeOf(this, _APIError.prototype);
+  }
+  /**
+   * Create an APIError from a fetch Response
+   *
+   * @param response - The Response object from fetch
+   * @param body - Optional response body text (if already read)
+   * @returns An APIError with HTTP status information
+   *
+   * @example
+   * ```typescript
+   * const response = await fetch('/api/things')
+   * if (!response.ok) {
+   *   throw APIError.fromResponse(response, await response.text())
+   * }
+   * ```
+   */
+  static fromResponse(response, body) {
+    return new _APIError(`HTTP_${response.status}`, body || response.statusText, response.status);
+  }
+  /**
+   * Type guard to check if an error is an APIError
+   */
+  static isAPIError(error) {
+    return error instanceof _APIError;
+  }
+};
+var NetworkError = class _NetworkError extends Error {
+  constructor(message, cause) {
+    super(message);
+    this.cause = cause;
+    this.name = "NetworkError";
+    Object.setPrototypeOf(this, _NetworkError.prototype);
   }
-  throw lastError;
+};
+var ValidationError = class _ValidationError extends Error {
+  constructor(message, fields) {
+    super(message);
+    this.fields = fields;
+    this.name = "ValidationError";
+    Object.setPrototypeOf(this, _ValidationError.prototype);
+  }
+};
+var SyncError = class _SyncError extends Error {
+  constructor(message, operation, recoverable) {
+    super(message);
+    this.operation = operation;
+    this.recoverable = recoverable;
+    this.name = "SyncError";
+    Object.setPrototypeOf(this, _SyncError.prototype);
+  }
+};
+function isAPIError(error) {
+  return error instanceof APIError;
+}
+function isNetworkError(error) {
+  return error instanceof NetworkError;
+}
+function isValidationError(error) {
+  return error instanceof ValidationError;
+}
+function isSyncError(error) {
+  return error instanceof SyncError;
 }
 
-export { camelToTitle, capitalize, cn, debounce, formatBytes, formatDate, formatDateTime, formatDuration, formatNumber, formatRelativeTime, formatSemanticId, generateId, groupBy, parseSemanticId, retryWithBackoff, truncate };
-//# sourceMappingURL=chunk-Y52IEYVM.js.map
-//# sourceMappingURL=chunk-Y52IEYVM.js.map
+export { APIError, NetworkError, SyncError, ValidationError, camelToTitle, capitalize, cn, formatBytes, formatDate, formatDateTime, formatDuration, formatNumber, formatRelativeTime, formatSemanticId, isAPIError, isNetworkError, isSyncError, isValidationError, parseSemanticId, truncate };
+//# sourceMappingURL=chunk-JPZ6RZJE.js.map
+//# sourceMappingURL=chunk-JPZ6RZJE.js.map

package/dist/chunk-JPZ6RZJE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/cn.ts","../src/utils/format.ts","../src/utils/errors.ts"],"names":[],"mappings":"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","file":"chunk-JPZ6RZJE.js","sourcesContent":["/**\n * Class name merging utility\n *\n * Combines clsx with tailwind-merge for intelligent class name handling.\n *\n * @module\n */\n\nimport { clsx, type ClassValue } from 'clsx'\nimport { twMerge } from 'tailwind-merge'\n\n/**\n * Merge class names with Tailwind CSS support\n *\n * Uses clsx for conditional classes and tailwind-merge to handle\n * Tailwind CSS class conflicts intelligently.\n *\n * @example\n * ```typescript\n * cn('px-4 py-2', 'bg-blue-500', condition && 'opacity-50')\n * // => 'px-4 py-2 bg-blue-500 opacity-50' (if condition is true)\n *\n * cn('px-2', 'px-4')\n * // => 'px-4' (tailwind-merge resolves conflicts)\n * ```\n */\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs))\n}\n","/**\n * Formatting Utilities\n *\n * Pure functions for formatting dates, numbers, strings, and semantic IDs.\n *\n * @module\n */\n\n/**\n * Format a semantic ID (ns/type/id)\n */\nexport function formatSemanticId(ns: string, type: string, id: string): string {\n  return `${ns}/${type}/${id}`\n}\n\n/**\n * Parse a semantic ID into components\n * Format: type/namespace/id where namespace can contain slashes\n * @throws Error if the semantic ID format is invalid\n */\nexport function parseSemanticId(semanticId: string): { type: string; namespace: string; id: string } {\n  const parts = semanticId.split('/')\n  if (parts.length < 3) {\n    throw new Error(`Invalid semantic ID format: ${semanticId}`)\n  }\n\n  // Format is type/namespace.../id\n  // Type is first, id is last, namespace is everything in between\n  const type = parts[0]\n  const id = parts[parts.length - 1]\n  const namespace = parts.slice(1, -1).join('/')\n\n  return { type, namespace, id }\n}\n\n/**\n * Format a date for display\n */\nexport function formatDate(date: Date | string, options?: Intl.DateTimeFormatOptions): string {\n  const d = typeof date === 'string' ? new Date(date) : date\n  return d.toLocaleDateString(undefined, options ?? {\n    year: 'numeric',\n    month: 'short',\n    day: 'numeric',\n  })\n}\n\n/**\n * Format a date and time for display\n */\nexport function formatDateTime(date: Date | string, options?: Intl.DateTimeFormatOptions): string {\n  const d = typeof date === 'string' ? new Date(date) : date\n  return d.toLocaleString(undefined, options ?? {\n    year: 'numeric',\n    month: 'short',\n    day: 'numeric',\n    hour: '2-digit',\n    minute: '2-digit',\n  })\n}\n\n/**\n * Format a relative time (e.g., \"2 hours ago\")\n */\nexport function formatRelativeTime(date: Date | string): string {\n  const d = typeof date === 'string' ? new Date(date) : date\n  const now = new Date()\n  const diffMs = now.getTime() - d.getTime()\n  const diffSec = Math.floor(diffMs / 1000)\n  const diffMin = Math.floor(diffSec / 60)\n  const diffHour = Math.floor(diffMin / 60)\n  const diffDay = Math.floor(diffHour / 24)\n\n  if (diffSec < 60) return `${diffSec} ${diffSec === 1 ? 'second' : 'seconds'} ago`\n  if (diffMin < 60) return `${diffMin} ${diffMin === 1 ? 'minute' : 'minutes'} ago`\n  if (diffHour < 24) return `${diffHour} ${diffHour === 1 ? 'hour' : 'hours'} ago`\n  if (diffDay < 7) return `${diffDay} ${diffDay === 1 ? 'day' : 'days'} ago`\n  return formatDate(d)\n}\n\n/**\n * Format a decimal, removing trailing .0 for whole numbers\n */\nfunction formatDecimal(value: number, decimals: number = 1): string {\n  const fixed = value.toFixed(decimals)\n  // Remove trailing .0 for whole numbers\n  return fixed.endsWith('.0') ? fixed.slice(0, -2) : fixed\n}\n\n/**\n * Format a number with abbreviation (1K, 1M, etc.)\n */\nexport function formatNumber(num: number): string {\n  if (num < 0) return `-${formatNumber(-num)}`\n  if (num >= 1_000_000) return `${formatDecimal(num / 1_000_000)}M`\n  if (num >= 1_000) return `${formatDecimal(num / 1_000)}K`\n  return num.toString()\n}\n\n/**\n * Format bytes to human-readable string\n */\nexport function formatBytes(bytes: number): string {\n  if (bytes === 0) return '0 B'\n  const k = 1024\n  const sizes = ['B', 'KB', 'MB', 'GB', 'TB']\n  const i = Math.floor(Math.log(bytes) / Math.log(k))\n  return `${formatDecimal(bytes / k ** i)} ${sizes[i]}`\n}\n\n/**\n * Format duration in milliseconds to human-readable string\n */\nexport function formatDuration(ms: number): string {\n  if (ms < 1000) return `${ms}ms`\n  if (ms < 60_000) return `${formatDecimal(ms / 1000)}s`\n  if (ms < 3_600_000) return `${Math.floor(ms / 60_000)}m ${Math.floor((ms % 60_000) / 1000)}s`\n  return `${Math.floor(ms / 3_600_000)}h ${Math.floor((ms % 3_600_000) / 60_000)}m`\n}\n\n/**\n * Truncate text with ellipsis\n */\nexport function truncate(text: string, maxLength: number, suffix: string = '...'): string {\n  if (text.length <= maxLength) return text\n  return text.slice(0, maxLength) + suffix\n}\n\n/**\n * Capitalize first letter\n */\nexport function capitalize(text: string): string {\n  return text.charAt(0).toUpperCase() + text.slice(1)\n}\n\n/**\n * Convert camelCase to Title Case\n */\nexport function camelToTitle(text: string): string {\n  return text\n    .replace(/([A-Z])/g, ' $1')\n    .replace(/^./, (str) => str.toUpperCase())\n    .trim()\n}\n","/**\n * Standardized error classes for @mdxui/do\n *\n * These classes provide consistent error handling across the package:\n * - APIError: HTTP/RPC errors from the backend\n * - NetworkError: Connection/fetch failures\n * - ValidationError: Input validation errors\n * - SyncError: Real-time sync errors\n *\n * @example\n * ```typescript\n * import { APIError, NetworkError, isAPIError } from '@mdxui/do'\n *\n * try {\n *   const response = await fetch(url)\n *   if (!response.ok) {\n *     throw APIError.fromResponse(response)\n *   }\n * } catch (error) {\n *   if (isAPIError(error)) {\n *     console.log(`API error ${error.code}: ${error.message}`)\n *     if (error.status === 401) {\n *       // Handle auth error\n *     }\n *   } else if (isNetworkError(error)) {\n *     console.log('Network unavailable, will retry...')\n *   }\n * }\n * ```\n */\n\n/**\n * API error from HTTP/RPC calls\n *\n * Provides structured error information including:\n * - code: Machine-readable error code (e.g., 'HTTP_404', 'VALIDATION_ERROR')\n * - message: Human-readable error message\n * - status: HTTP status code (when applicable)\n * - details: Additional error details from the server\n */\nexport class APIError extends Error {\n  constructor(\n    public readonly code: string,\n    message: string,\n    public readonly status?: number,\n    public readonly details?: Record<string, unknown>\n  ) {\n    super(message)\n    this.name = 'APIError'\n    // Maintain proper prototype chain for instanceof checks\n    Object.setPrototypeOf(this, APIError.prototype)\n  }\n\n  /**\n   * Create an APIError from a fetch Response\n   *\n   * @param response - The Response object from fetch\n   * @param body - Optional response body text (if already read)\n   * @returns An APIError with HTTP status information\n   *\n   * @example\n   * ```typescript\n   * const response = await fetch('/api/things')\n   * if (!response.ok) {\n   *   throw APIError.fromResponse(response, await response.text())\n   * }\n   * ```\n   */\n  static fromResponse(response: Response, body?: string): APIError {\n    return new APIError(`HTTP_${response.status}`, body || response.statusText, response.status)\n  }\n\n  /**\n   * Type guard to check if an error is an APIError\n   */\n  static isAPIError(error: unknown): error is APIError {\n    return error instanceof APIError\n  }\n}\n\n/**\n * Network-level error (connection failures, timeouts, etc.)\n *\n * Use for errors that occur before an HTTP response is received:\n * - DNS resolution failures\n * - Connection refused\n * - Request timeouts\n * - CORS errors\n */\nexport class NetworkError extends Error {\n  constructor(\n    message: string,\n    public readonly cause?: Error\n  ) {\n    super(message)\n    this.name = 'NetworkError'\n    Object.setPrototypeOf(this, NetworkError.prototype)\n  }\n}\n\n/**\n * Validation error with field-level details\n *\n * Use when input data fails validation checks.\n * The fields property maps field names to arrays of error messages.\n *\n * @example\n * ```typescript\n * throw new ValidationError('Invalid input', {\n *   email: ['Invalid email format'],\n *   name: ['Name is required', 'Name must be at least 2 characters'],\n * })\n * ```\n */\nexport class ValidationError extends Error {\n  constructor(\n    message: string,\n    public readonly fields: Record<string, string[]>\n  ) {\n    super(message)\n    this.name = 'ValidationError'\n    Object.setPrototypeOf(this, ValidationError.prototype)\n  }\n}\n\n/**\n * Real-time sync error\n *\n * Use for errors in the sync protocol (WebSocket, EventSource, etc.).\n * The operation property indicates what sync operation failed.\n * The recoverable property indicates whether the client should retry.\n *\n * @example\n * ```typescript\n * // Recoverable connection error - client should retry\n * throw new SyncError('WebSocket disconnected', 'connect', true)\n *\n * // Non-recoverable push error - user intervention needed\n * throw new SyncError('Conflict: record modified by another user', 'push', false)\n * ```\n */\nexport class SyncError extends Error {\n  constructor(\n    message: string,\n    public readonly operation: 'push' | 'pull' | 'connect',\n    public readonly recoverable: boolean\n  ) {\n    super(message)\n    this.name = 'SyncError'\n    Object.setPrototypeOf(this, SyncError.prototype)\n  }\n}\n\n/**\n * Type guard to check if an error is an APIError\n */\nexport function isAPIError(error: unknown): error is APIError {\n  return error instanceof APIError\n}\n\n/**\n * Type guard to check if an error is a NetworkError\n */\nexport function isNetworkError(error: unknown): error is NetworkError {\n  return error instanceof NetworkError\n}\n\n/**\n * Type guard to check if an error is a ValidationError\n */\nexport function isValidationError(error: unknown): error is ValidationError {\n  return error instanceof ValidationError\n}\n\n/**\n * Type guard to check if an error is a SyncError\n */\nexport function isSyncError(error: unknown): error is SyncError {\n  return error instanceof SyncError\n}\n"]}