@publikit/utils 0.1.1 → 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+## 1.0.0
+
+### Added
+
+- Initial release of `@publikit/utils` as a Publikit L0 foundation package.
+- `cn` for `clsx` + `tailwind-merge` class-name composition.
+- `ClassValue` type export for typed class-name composition.
+- `debounce` with `cancel()` and `flush()` helpers.
+- `getErrorMessage` for safe unknown error extraction.
+- `formatBytes` and `calculateUsagePercentage` formatting utilities.
+- Subpath exports: `@publikit/utils/cn`, `/async`, `/error`, and `/format`.
+- `docs/PUBLISHING.md`.
+- Coverage script.
+
+### Changed
+
+- Package metadata now points to `packages/utils`.
+- README documents the L0 role and headless L2 usage.
+- Test coverage now includes Tailwind conflict merging and additional edge cases.

package/README.md

@@ -4,6 +4,10 @@ Framework-agnostic utility functions for Publikit packages and applications.
 
 - **No React peer dependency** — safe for scripts, edge workers, and non-UI code
 - **Tree-shakeable** — `sideEffects: false`
+- **L0 foundation** — shared helpers for headless L2 packages and consumer apps
+
+See the [package taxonomy](../docs/PACKAGE-TAXONOMY.md) for where L0 utilities
+fit in Publikit.
 
 ## Installation
 
@@ -16,11 +20,21 @@ npm install @publikit/utils
 | Export | Description |
 |--------|-------------|
 | `cn` | Merge Tailwind classes (`clsx` + `tailwind-merge`) |
+| `ClassValue` | Type accepted by `cn` |
 | `debounce` | Debounce function calls |
 | `getErrorMessage` | Extract message from unknown errors |
 | `formatBytes` | Human-readable byte sizes |
 | `calculateUsagePercentage` | Percentage capped at 100 |
 
+Subpath exports are available for focused imports:
+
+```ts
+import { cn } from '@publikit/utils/cn';
+import { debounce } from '@publikit/utils/async';
+import { getErrorMessage } from '@publikit/utils/error';
+import { formatBytes } from '@publikit/utils/format';
+```
+
 ## Usage
 
 ```ts
@@ -32,6 +46,16 @@ const message = getErrorMessage(error, 'Something went wrong');
 const size = formatBytes(1_048_576); // "1 MB"
 ```
 
+## Role in Headless L2 Packages
+
+Headless L2 modules use `cn` to merge consumer-provided `classNames` with
+conditional state classes. Non-Tailwind consumers can ignore that merge behavior
+and style stable `data-slot` attributes instead.
+
+`formatBytes`, `calculateUsagePercentage`, and `getErrorMessage` are app-level
+convenience utilities; they are kept framework-agnostic so they can be reused in
+PHO, scripts, and workers.
+
 ## Related packages
 
 - [`@publikit/hooks`](../hooks) — generic React hooks

package/dist/async.cjs

@@ -0,0 +1,35 @@
+'use strict';
+
+// async.ts
+function debounce(fn, ms) {
+  let timeoutId = null;
+  let lastArgs = null;
+  const debounced = (...args) => {
+    lastArgs = args;
+    if (timeoutId) clearTimeout(timeoutId);
+    timeoutId = setTimeout(() => {
+      timeoutId = null;
+      if (lastArgs) {
+        fn(...lastArgs);
+        lastArgs = null;
+      }
+    }, ms);
+  };
+  debounced.cancel = () => {
+    if (timeoutId) clearTimeout(timeoutId);
+    timeoutId = null;
+    lastArgs = null;
+  };
+  debounced.flush = () => {
+    if (!timeoutId || !lastArgs) return;
+    clearTimeout(timeoutId);
+    timeoutId = null;
+    fn(...lastArgs);
+    lastArgs = null;
+  };
+  return debounced;
+}
+
+exports.debounce = debounce;
+//# sourceMappingURL=async.cjs.map
+//# sourceMappingURL=async.cjs.map

package/dist/async.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../async.ts"],"names":[],"mappings":";;;AAYO,SAAS,QAAA,CACd,IACA,EAAA,EACyB;AACzB,EAAA,IAAI,SAAA,GAAkD,IAAA;AACtD,EAAA,IAAI,QAAA,GAAqB,IAAA;AAEzB,EAAA,MAAM,SAAA,GAAY,IAAI,IAAA,KAAY;AAChC,IAAA,QAAA,GAAW,IAAA;AACX,IAAA,IAAI,SAAA,eAAwB,SAAS,CAAA;AACrC,IAAA,SAAA,GAAY,WAAW,MAAM;AAC3B,MAAA,SAAA,GAAY,IAAA;AACZ,MAAA,IAAI,QAAA,EAAU;AACZ,QAAA,EAAA,CAAG,GAAG,QAAQ,CAAA;AACd,QAAA,QAAA,GAAW,IAAA;AAAA,MACb;AAAA,IACF,GAAG,EAAE,CAAA;AAAA,EACP,CAAA;AAEA,EAAA,SAAA,CAAU,SAAS,MAAM;AACvB,IAAA,IAAI,SAAA,eAAwB,SAAS,CAAA;AACrC,IAAA,SAAA,GAAY,IAAA;AACZ,IAAA,QAAA,GAAW,IAAA;AAAA,EACb,CAAA;AAEA,EAAA,SAAA,CAAU,QAAQ,MAAM;AACtB,IAAA,IAAI,CAAC,SAAA,IAAa,CAAC,QAAA,EAAU;AAC7B,IAAA,YAAA,CAAa,SAAS,CAAA;AACtB,IAAA,SAAA,GAAY,IAAA;AACZ,IAAA,EAAA,CAAG,GAAG,QAAQ,CAAA;AACd,IAAA,QAAA,GAAW,IAAA;AAAA,EACb,CAAA;AAEA,EAAA,OAAO,SAAA;AACT","file":"async.cjs","sourcesContent":["/**\r\n * Debounced function with cancel and flush helpers.\r\n */\r\nexport interface DebouncedFunction<A extends unknown[], R> {\r\n  (...args: A): void;\r\n  cancel(): void;\r\n  flush(): void;\r\n}\r\n\r\n/**\r\n * Debounce a function — only invoke after `ms` milliseconds of inactivity.\r\n */\r\nexport function debounce<A extends unknown[], R>(\r\n  fn: (...args: A) => R,\r\n  ms: number\r\n): DebouncedFunction<A, R> {\r\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\r\n  let lastArgs: A | null = null;\r\n\r\n  const debounced = (...args: A) => {\r\n    lastArgs = args;\r\n    if (timeoutId) clearTimeout(timeoutId);\r\n    timeoutId = setTimeout(() => {\r\n      timeoutId = null;\r\n      if (lastArgs) {\r\n        fn(...lastArgs);\r\n        lastArgs = null;\r\n      }\r\n    }, ms);\r\n  };\r\n\r\n  debounced.cancel = () => {\r\n    if (timeoutId) clearTimeout(timeoutId);\r\n    timeoutId = null;\r\n    lastArgs = null;\r\n  };\r\n\r\n  debounced.flush = () => {\r\n    if (!timeoutId || !lastArgs) return;\r\n    clearTimeout(timeoutId);\r\n    timeoutId = null;\r\n    fn(...lastArgs);\r\n    lastArgs = null;\r\n  };\r\n\r\n  return debounced;\r\n}\r\n"]}

package/dist/async.d.cts

@@ -0,0 +1,14 @@
+/**
+ * Debounced function with cancel and flush helpers.
+ */
+interface DebouncedFunction<A extends unknown[], R> {
+    (...args: A): void;
+    cancel(): void;
+    flush(): void;
+}
+/**
+ * Debounce a function — only invoke after `ms` milliseconds of inactivity.
+ */
+declare function debounce<A extends unknown[], R>(fn: (...args: A) => R, ms: number): DebouncedFunction<A, R>;
+
+export { type DebouncedFunction, debounce };

package/dist/async.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Debounced function with cancel and flush helpers.
+ */
+interface DebouncedFunction<A extends unknown[], R> {
+    (...args: A): void;
+    cancel(): void;
+    flush(): void;
+}
+/**
+ * Debounce a function — only invoke after `ms` milliseconds of inactivity.
+ */
+declare function debounce<A extends unknown[], R>(fn: (...args: A) => R, ms: number): DebouncedFunction<A, R>;
+
+export { type DebouncedFunction, debounce };

package/dist/async.js

@@ -0,0 +1,33 @@
+// async.ts
+function debounce(fn, ms) {
+  let timeoutId = null;
+  let lastArgs = null;
+  const debounced = (...args) => {
+    lastArgs = args;
+    if (timeoutId) clearTimeout(timeoutId);
+    timeoutId = setTimeout(() => {
+      timeoutId = null;
+      if (lastArgs) {
+        fn(...lastArgs);
+        lastArgs = null;
+      }
+    }, ms);
+  };
+  debounced.cancel = () => {
+    if (timeoutId) clearTimeout(timeoutId);
+    timeoutId = null;
+    lastArgs = null;
+  };
+  debounced.flush = () => {
+    if (!timeoutId || !lastArgs) return;
+    clearTimeout(timeoutId);
+    timeoutId = null;
+    fn(...lastArgs);
+    lastArgs = null;
+  };
+  return debounced;
+}
+
+export { debounce };
+//# sourceMappingURL=async.js.map
+//# sourceMappingURL=async.js.map

package/dist/async.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../async.ts"],"names":[],"mappings":";AAYO,SAAS,QAAA,CACd,IACA,EAAA,EACyB;AACzB,EAAA,IAAI,SAAA,GAAkD,IAAA;AACtD,EAAA,IAAI,QAAA,GAAqB,IAAA;AAEzB,EAAA,MAAM,SAAA,GAAY,IAAI,IAAA,KAAY;AAChC,IAAA,QAAA,GAAW,IAAA;AACX,IAAA,IAAI,SAAA,eAAwB,SAAS,CAAA;AACrC,IAAA,SAAA,GAAY,WAAW,MAAM;AAC3B,MAAA,SAAA,GAAY,IAAA;AACZ,MAAA,IAAI,QAAA,EAAU;AACZ,QAAA,EAAA,CAAG,GAAG,QAAQ,CAAA;AACd,QAAA,QAAA,GAAW,IAAA;AAAA,MACb;AAAA,IACF,GAAG,EAAE,CAAA;AAAA,EACP,CAAA;AAEA,EAAA,SAAA,CAAU,SAAS,MAAM;AACvB,IAAA,IAAI,SAAA,eAAwB,SAAS,CAAA;AACrC,IAAA,SAAA,GAAY,IAAA;AACZ,IAAA,QAAA,GAAW,IAAA;AAAA,EACb,CAAA;AAEA,EAAA,SAAA,CAAU,QAAQ,MAAM;AACtB,IAAA,IAAI,CAAC,SAAA,IAAa,CAAC,QAAA,EAAU;AAC7B,IAAA,YAAA,CAAa,SAAS,CAAA;AACtB,IAAA,SAAA,GAAY,IAAA;AACZ,IAAA,EAAA,CAAG,GAAG,QAAQ,CAAA;AACd,IAAA,QAAA,GAAW,IAAA;AAAA,EACb,CAAA;AAEA,EAAA,OAAO,SAAA;AACT","file":"async.js","sourcesContent":["/**\r\n * Debounced function with cancel and flush helpers.\r\n */\r\nexport interface DebouncedFunction<A extends unknown[], R> {\r\n  (...args: A): void;\r\n  cancel(): void;\r\n  flush(): void;\r\n}\r\n\r\n/**\r\n * Debounce a function — only invoke after `ms` milliseconds of inactivity.\r\n */\r\nexport function debounce<A extends unknown[], R>(\r\n  fn: (...args: A) => R,\r\n  ms: number\r\n): DebouncedFunction<A, R> {\r\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\r\n  let lastArgs: A | null = null;\r\n\r\n  const debounced = (...args: A) => {\r\n    lastArgs = args;\r\n    if (timeoutId) clearTimeout(timeoutId);\r\n    timeoutId = setTimeout(() => {\r\n      timeoutId = null;\r\n      if (lastArgs) {\r\n        fn(...lastArgs);\r\n        lastArgs = null;\r\n      }\r\n    }, ms);\r\n  };\r\n\r\n  debounced.cancel = () => {\r\n    if (timeoutId) clearTimeout(timeoutId);\r\n    timeoutId = null;\r\n    lastArgs = null;\r\n  };\r\n\r\n  debounced.flush = () => {\r\n    if (!timeoutId || !lastArgs) return;\r\n    clearTimeout(timeoutId);\r\n    timeoutId = null;\r\n    fn(...lastArgs);\r\n    lastArgs = null;\r\n  };\r\n\r\n  return debounced;\r\n}\r\n"]}

package/dist/cn.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+var clsx = require('clsx');
+var tailwindMerge = require('tailwind-merge');
+
+// cn.ts
+function cn(...inputs) {
+  return tailwindMerge.twMerge(clsx.clsx(inputs));
+}
+
+exports.cn = cn;
+//# sourceMappingURL=cn.cjs.map
+//# sourceMappingURL=cn.cjs.map

package/dist/cn.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../cn.ts"],"names":["twMerge","clsx"],"mappings":";;;;;;AAQO,SAAS,MAAM,MAAA,EAA8B;AAClD,EAAA,OAAOA,qBAAA,CAAQC,SAAA,CAAK,MAAM,CAAC,CAAA;AAC7B","file":"cn.cjs","sourcesContent":["import { clsx, type ClassValue } from 'clsx';\r\nimport { twMerge } from 'tailwind-merge';\r\n\r\nexport type { ClassValue } from 'clsx';\r\n\r\n/**\r\n * Merge Tailwind CSS class names with conflict resolution.\r\n */\r\nexport function cn(...inputs: ClassValue[]): string {\r\n  return twMerge(clsx(inputs));\r\n}\r\n"]}

package/dist/cn.d.cts

@@ -0,0 +1,9 @@
+import { ClassValue } from 'clsx';
+export { ClassValue } from 'clsx';
+
+/**
+ * Merge Tailwind CSS class names with conflict resolution.
+ */
+declare function cn(...inputs: ClassValue[]): string;
+
+export { cn };

package/dist/cn.d.ts

@@ -0,0 +1,9 @@
+import { ClassValue } from 'clsx';
+export { ClassValue } from 'clsx';
+
+/**
+ * Merge Tailwind CSS class names with conflict resolution.
+ */
+declare function cn(...inputs: ClassValue[]): string;
+
+export { cn };

package/dist/cn.js

@@ -0,0 +1,11 @@
+import { clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+
+// cn.ts
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+
+export { cn };
+//# sourceMappingURL=cn.js.map
+//# sourceMappingURL=cn.js.map

package/dist/cn.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../cn.ts"],"names":[],"mappings":";;;;AAQO,SAAS,MAAM,MAAA,EAA8B;AAClD,EAAA,OAAO,OAAA,CAAQ,IAAA,CAAK,MAAM,CAAC,CAAA;AAC7B","file":"cn.js","sourcesContent":["import { clsx, type ClassValue } from 'clsx';\r\nimport { twMerge } from 'tailwind-merge';\r\n\r\nexport type { ClassValue } from 'clsx';\r\n\r\n/**\r\n * Merge Tailwind CSS class names with conflict resolution.\r\n */\r\nexport function cn(...inputs: ClassValue[]): string {\r\n  return twMerge(clsx(inputs));\r\n}\r\n"]}

package/dist/error.cjs

@@ -0,0 +1,22 @@
+'use strict';
+
+// error.ts
+function getErrorMessage(error, defaultMessage) {
+  if (error instanceof Error && error.message) {
+    return error.message;
+  }
+  if (typeof error === "string" && error.trim()) {
+    return error;
+  }
+  if (error && typeof error === "object" && "message" in error) {
+    const message = error.message;
+    if (typeof message === "string" && message.trim()) {
+      return message;
+    }
+  }
+  return defaultMessage;
+}
+
+exports.getErrorMessage = getErrorMessage;
+//# sourceMappingURL=error.cjs.map
+//# sourceMappingURL=error.cjs.map

package/dist/error.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../error.ts"],"names":[],"mappings":";;;AAGO,SAAS,eAAA,CAAgB,OAAgB,cAAA,EAAgC;AAC9E,EAAA,IAAI,KAAA,YAAiB,KAAA,IAAS,KAAA,CAAM,OAAA,EAAS;AAC3C,IAAA,OAAO,KAAA,CAAM,OAAA;AAAA,EACf;AAEA,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,CAAM,MAAK,EAAG;AAC7C,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,IAAI,KAAA,IAAS,OAAO,KAAA,KAAU,QAAA,IAAY,aAAa,KAAA,EAAO;AAC5D,IAAA,MAAM,UAAW,KAAA,CAA+B,OAAA;AAChD,IAAA,IAAI,OAAO,OAAA,KAAY,QAAA,IAAY,OAAA,CAAQ,MAAK,EAAG;AACjD,MAAA,OAAO,OAAA;AAAA,IACT;AAAA,EACF;AAEA,EAAA,OAAO,cAAA;AACT","file":"error.cjs","sourcesContent":["/**\r\n * Extract a human-readable message from an unknown error value.\r\n */\r\nexport function getErrorMessage(error: unknown, defaultMessage: string): string {\r\n  if (error instanceof Error && error.message) {\r\n    return error.message;\r\n  }\r\n\r\n  if (typeof error === 'string' && error.trim()) {\r\n    return error;\r\n  }\r\n\r\n  if (error && typeof error === 'object' && 'message' in error) {\r\n    const message = (error as { message: unknown }).message;\r\n    if (typeof message === 'string' && message.trim()) {\r\n      return message;\r\n    }\r\n  }\r\n\r\n  return defaultMessage;\r\n}\r\n"]}

package/dist/error.d.cts

@@ -0,0 +1,6 @@
+/**
+ * Extract a human-readable message from an unknown error value.
+ */
+declare function getErrorMessage(error: unknown, defaultMessage: string): string;
+
+export { getErrorMessage };

package/dist/error.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Extract a human-readable message from an unknown error value.
+ */
+declare function getErrorMessage(error: unknown, defaultMessage: string): string;
+
+export { getErrorMessage };

package/dist/error.js

@@ -0,0 +1,20 @@
+// error.ts
+function getErrorMessage(error, defaultMessage) {
+  if (error instanceof Error && error.message) {
+    return error.message;
+  }
+  if (typeof error === "string" && error.trim()) {
+    return error;
+  }
+  if (error && typeof error === "object" && "message" in error) {
+    const message = error.message;
+    if (typeof message === "string" && message.trim()) {
+      return message;
+    }
+  }
+  return defaultMessage;
+}
+
+export { getErrorMessage };
+//# sourceMappingURL=error.js.map
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../error.ts"],"names":[],"mappings":";AAGO,SAAS,eAAA,CAAgB,OAAgB,cAAA,EAAgC;AAC9E,EAAA,IAAI,KAAA,YAAiB,KAAA,IAAS,KAAA,CAAM,OAAA,EAAS;AAC3C,IAAA,OAAO,KAAA,CAAM,OAAA;AAAA,EACf;AAEA,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,CAAM,MAAK,EAAG;AAC7C,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,IAAI,KAAA,IAAS,OAAO,KAAA,KAAU,QAAA,IAAY,aAAa,KAAA,EAAO;AAC5D,IAAA,MAAM,UAAW,KAAA,CAA+B,OAAA;AAChD,IAAA,IAAI,OAAO,OAAA,KAAY,QAAA,IAAY,OAAA,CAAQ,MAAK,EAAG;AACjD,MAAA,OAAO,OAAA;AAAA,IACT;AAAA,EACF;AAEA,EAAA,OAAO,cAAA;AACT","file":"error.js","sourcesContent":["/**\r\n * Extract a human-readable message from an unknown error value.\r\n */\r\nexport function getErrorMessage(error: unknown, defaultMessage: string): string {\r\n  if (error instanceof Error && error.message) {\r\n    return error.message;\r\n  }\r\n\r\n  if (typeof error === 'string' && error.trim()) {\r\n    return error;\r\n  }\r\n\r\n  if (error && typeof error === 'object' && 'message' in error) {\r\n    const message = (error as { message: unknown }).message;\r\n    if (typeof message === 'string' && message.trim()) {\r\n      return message;\r\n    }\r\n  }\r\n\r\n  return defaultMessage;\r\n}\r\n"]}

package/dist/format.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+// format.ts
+function formatBytes(bytes) {
+  if (!Number.isFinite(bytes) || bytes <= 0) {
+    return "0 B";
+  }
+  const k = 1024;
+  const sizes = ["B", "KB", "MB", "GB", "TB"];
+  const i = Math.min(
+    Math.floor(Math.log(bytes) / Math.log(k)),
+    sizes.length - 1
+  );
+  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(2))} ${sizes[i]}`;
+}
+function calculateUsagePercentage(current, limit) {
+  if (!Number.isFinite(current) || !Number.isFinite(limit) || limit <= 0) {
+    return 0;
+  }
+  if (current <= 0) {
+    return 0;
+  }
+  return Math.min(100, Math.round(current / limit * 100));
+}
+
+exports.calculateUsagePercentage = calculateUsagePercentage;
+exports.formatBytes = formatBytes;
+//# sourceMappingURL=format.cjs.map
+//# sourceMappingURL=format.cjs.map

package/dist/format.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../format.ts"],"names":[],"mappings":";;;AAGO,SAAS,YAAY,KAAA,EAAuB;AACjD,EAAA,IAAI,CAAC,MAAA,CAAO,QAAA,CAAS,KAAK,CAAA,IAAK,SAAS,CAAA,EAAG;AACzC,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,CAAA,GAAI,IAAA;AACV,EAAA,MAAM,QAAQ,CAAC,GAAA,EAAK,IAAA,EAAM,IAAA,EAAM,MAAM,IAAI,CAAA;AAC1C,EAAA,MAAM,IAAI,IAAA,CAAK,GAAA;AAAA,IACb,IAAA,CAAK,MAAM,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA,GAAI,IAAA,CAAK,GAAA,CAAI,CAAC,CAAC,CAAA;AAAA,IACxC,MAAM,MAAA,GAAS;AAAA,GACjB;AACA,EAAA,OAAO,CAAA,EAAG,UAAA,CAAA,CAAY,KAAA,GAAQ,IAAA,CAAK,IAAI,CAAA,EAAG,CAAC,CAAA,EAAG,OAAA,CAAQ,CAAC,CAAC,CAAC,CAAA,CAAA,EAAI,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA;AACvE;AAKO,SAAS,wBAAA,CAAyB,SAAiB,KAAA,EAAuB;AAC/E,EAAA,IAAI,CAAC,MAAA,CAAO,QAAA,CAAS,OAAO,CAAA,IAAK,CAAC,MAAA,CAAO,QAAA,CAAS,KAAK,CAAA,IAAK,KAAA,IAAS,CAAA,EAAG;AACtE,IAAA,OAAO,CAAA;AAAA,EACT;AAEA,EAAA,IAAI,WAAW,CAAA,EAAG;AAChB,IAAA,OAAO,CAAA;AAAA,EACT;AAEA,EAAA,OAAO,IAAA,CAAK,IAAI,GAAA,EAAK,IAAA,CAAK,MAAO,OAAA,GAAU,KAAA,GAAS,GAAG,CAAC,CAAA;AAC1D","file":"format.cjs","sourcesContent":["/**\r\n * Format a byte count as a human-readable string.\r\n */\r\nexport function formatBytes(bytes: number): string {\r\n  if (!Number.isFinite(bytes) || bytes <= 0) {\r\n    return '0 B';\r\n  }\r\n\r\n  const k = 1024;\r\n  const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];\r\n  const i = Math.min(\r\n    Math.floor(Math.log(bytes) / Math.log(k)),\r\n    sizes.length - 1\r\n  );\r\n  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(2))} ${sizes[i]}`;\r\n}\r\n\r\n/**\r\n * Calculate usage percentage capped at 100.\r\n */\r\nexport function calculateUsagePercentage(current: number, limit: number): number {\r\n  if (!Number.isFinite(current) || !Number.isFinite(limit) || limit <= 0) {\r\n    return 0;\r\n  }\r\n\r\n  if (current <= 0) {\r\n    return 0;\r\n  }\r\n\r\n  return Math.min(100, Math.round((current / limit) * 100));\r\n}\r\n"]}

package/dist/format.d.cts

@@ -0,0 +1,10 @@
+/**
+ * Format a byte count as a human-readable string.
+ */
+declare function formatBytes(bytes: number): string;
+/**
+ * Calculate usage percentage capped at 100.
+ */
+declare function calculateUsagePercentage(current: number, limit: number): number;
+
+export { calculateUsagePercentage, formatBytes };

package/dist/format.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Format a byte count as a human-readable string.
+ */
+declare function formatBytes(bytes: number): string;
+/**
+ * Calculate usage percentage capped at 100.
+ */
+declare function calculateUsagePercentage(current: number, limit: number): number;
+
+export { calculateUsagePercentage, formatBytes };

package/dist/format.js

@@ -0,0 +1,26 @@
+// format.ts
+function formatBytes(bytes) {
+  if (!Number.isFinite(bytes) || bytes <= 0) {
+    return "0 B";
+  }
+  const k = 1024;
+  const sizes = ["B", "KB", "MB", "GB", "TB"];
+  const i = Math.min(
+    Math.floor(Math.log(bytes) / Math.log(k)),
+    sizes.length - 1
+  );
+  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(2))} ${sizes[i]}`;
+}
+function calculateUsagePercentage(current, limit) {
+  if (!Number.isFinite(current) || !Number.isFinite(limit) || limit <= 0) {
+    return 0;
+  }
+  if (current <= 0) {
+    return 0;
+  }
+  return Math.min(100, Math.round(current / limit * 100));
+}
+
+export { calculateUsagePercentage, formatBytes };
+//# sourceMappingURL=format.js.map
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../format.ts"],"names":[],"mappings":";AAGO,SAAS,YAAY,KAAA,EAAuB;AACjD,EAAA,IAAI,CAAC,MAAA,CAAO,QAAA,CAAS,KAAK,CAAA,IAAK,SAAS,CAAA,EAAG;AACzC,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,CAAA,GAAI,IAAA;AACV,EAAA,MAAM,QAAQ,CAAC,GAAA,EAAK,IAAA,EAAM,IAAA,EAAM,MAAM,IAAI,CAAA;AAC1C,EAAA,MAAM,IAAI,IAAA,CAAK,GAAA;AAAA,IACb,IAAA,CAAK,MAAM,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA,GAAI,IAAA,CAAK,GAAA,CAAI,CAAC,CAAC,CAAA;AAAA,IACxC,MAAM,MAAA,GAAS;AAAA,GACjB;AACA,EAAA,OAAO,CAAA,EAAG,UAAA,CAAA,CAAY,KAAA,GAAQ,IAAA,CAAK,IAAI,CAAA,EAAG,CAAC,CAAA,EAAG,OAAA,CAAQ,CAAC,CAAC,CAAC,CAAA,CAAA,EAAI,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA;AACvE;AAKO,SAAS,wBAAA,CAAyB,SAAiB,KAAA,EAAuB;AAC/E,EAAA,IAAI,CAAC,MAAA,CAAO,QAAA,CAAS,OAAO,CAAA,IAAK,CAAC,MAAA,CAAO,QAAA,CAAS,KAAK,CAAA,IAAK,KAAA,IAAS,CAAA,EAAG;AACtE,IAAA,OAAO,CAAA;AAAA,EACT;AAEA,EAAA,IAAI,WAAW,CAAA,EAAG;AAChB,IAAA,OAAO,CAAA;AAAA,EACT;AAEA,EAAA,OAAO,IAAA,CAAK,IAAI,GAAA,EAAK,IAAA,CAAK,MAAO,OAAA,GAAU,KAAA,GAAS,GAAG,CAAC,CAAA;AAC1D","file":"format.js","sourcesContent":["/**\r\n * Format a byte count as a human-readable string.\r\n */\r\nexport function formatBytes(bytes: number): string {\r\n  if (!Number.isFinite(bytes) || bytes <= 0) {\r\n    return '0 B';\r\n  }\r\n\r\n  const k = 1024;\r\n  const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];\r\n  const i = Math.min(\r\n    Math.floor(Math.log(bytes) / Math.log(k)),\r\n    sizes.length - 1\r\n  );\r\n  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(2))} ${sizes[i]}`;\r\n}\r\n\r\n/**\r\n * Calculate usage percentage capped at 100.\r\n */\r\nexport function calculateUsagePercentage(current: number, limit: number): number {\r\n  if (!Number.isFinite(current) || !Number.isFinite(limit) || limit <= 0) {\r\n    return 0;\r\n  }\r\n\r\n  if (current <= 0) {\r\n    return 0;\r\n  }\r\n\r\n  return Math.min(100, Math.round((current / limit) * 100));\r\n}\r\n"]}

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../cn.ts","../async.ts","../error.ts","../format.ts"],"names":["twMerge","clsx"],"mappings":";;;;;;AAMO,SAAS,MAAM,MAAA,EAA8B;AAClD,EAAA,OAAOA,qBAAA,CAAQC,SAAA,CAAK,MAAM,CAAC,CAAA;AAC7B;;;ACIO,SAAS,QAAA,CACd,IACA,EAAA,EACyB;AACzB,EAAA,IAAI,SAAA,GAAkD,IAAA;AACtD,EAAA,IAAI,QAAA,GAAqB,IAAA;AAEzB,EAAA,MAAM,SAAA,GAAY,IAAI,IAAA,KAAY;AAChC,IAAA,QAAA,GAAW,IAAA;AACX,IAAA,IAAI,SAAA,eAAwB,SAAS,CAAA;AACrC,IAAA,SAAA,GAAY,WAAW,MAAM;AAC3B,MAAA,SAAA,GAAY,IAAA;AACZ,MAAA,IAAI,QAAA,EAAU;AACZ,QAAA,EAAA,CAAG,GAAG,QAAQ,CAAA;AACd,QAAA,QAAA,GAAW,IAAA;AAAA,MACb;AAAA,IACF,GAAG,EAAE,CAAA;AAAA,EACP,CAAA;AAEA,EAAA,SAAA,CAAU,SAAS,MAAM;AACvB,IAAA,IAAI,SAAA,eAAwB,SAAS,CAAA;AACrC,IAAA,SAAA,GAAY,IAAA;AACZ,IAAA,QAAA,GAAW,IAAA;AAAA,EACb,CAAA;AAEA,EAAA,SAAA,CAAU,QAAQ,MAAM;AACtB,IAAA,IAAI,CAAC,SAAA,IAAa,CAAC,QAAA,EAAU;AAC7B,IAAA,YAAA,CAAa,SAAS,CAAA;AACtB,IAAA,SAAA,GAAY,IAAA;AACZ,IAAA,EAAA,CAAG,GAAG,QAAQ,CAAA;AACd,IAAA,QAAA,GAAW,IAAA;AAAA,EACb,CAAA;AAEA,EAAA,OAAO,SAAA;AACT;;;AC3CO,SAAS,eAAA,CAAgB,OAAgB,cAAA,EAAgC;AAC9E,EAAA,IAAI,KAAA,YAAiB,KAAA,IAAS,KAAA,CAAM,OAAA,EAAS;AAC3C,IAAA,OAAO,KAAA,CAAM,OAAA;AAAA,EACf;AAEA,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,CAAM,MAAK,EAAG;AAC7C,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,IAAI,KAAA,IAAS,OAAO,KAAA,KAAU,QAAA,IAAY,aAAa,KAAA,EAAO;AAC5D,IAAA,MAAM,UAAW,KAAA,CAA+B,OAAA;AAChD,IAAA,IAAI,OAAO,OAAA,KAAY,QAAA,IAAY,OAAA,CAAQ,MAAK,EAAG;AACjD,MAAA,OAAO,OAAA;AAAA,IACT;AAAA,EACF;AAEA,EAAA,OAAO,cAAA;AACT;;;ACjBO,SAAS,YAAY,KAAA,EAAuB;AACjD,EAAA,IAAI,CAAC,MAAA,CAAO,QAAA,CAAS,KAAK,CAAA,IAAK,SAAS,CAAA,EAAG;AACzC,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,CAAA,GAAI,IAAA;AACV,EAAA,MAAM,QAAQ,CAAC,GAAA,EAAK,IAAA,EAAM,IAAA,EAAM,MAAM,IAAI,CAAA;AAC1C,EAAA,MAAM,IAAI,IAAA,CAAK,GAAA;AAAA,IACb,IAAA,CAAK,MAAM,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA,GAAI,IAAA,CAAK,GAAA,CAAI,CAAC,CAAC,CAAA;AAAA,IACxC,MAAM,MAAA,GAAS;AAAA,GACjB;AACA,EAAA,OAAO,CAAA,EAAG,UAAA,CAAA,CAAY,KAAA,GAAQ,IAAA,CAAK,IAAI,CAAA,EAAG,CAAC,CAAA,EAAG,OAAA,CAAQ,CAAC,CAAC,CAAC,CAAA,CAAA,EAAI,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA;AACvE;AAKO,SAAS,wBAAA,CAAyB,SAAiB,KAAA,EAAuB;AAC/E,EAAA,IAAI,CAAC,MAAA,CAAO,QAAA,CAAS,OAAO,CAAA,IAAK,CAAC,MAAA,CAAO,QAAA,CAAS,KAAK,CAAA,IAAK,KAAA,IAAS,CAAA,EAAG;AACtE,IAAA,OAAO,CAAA;AAAA,EACT;AAEA,EAAA,IAAI,WAAW,CAAA,EAAG;AAChB,IAAA,OAAO,CAAA;AAAA,EACT;AAEA,EAAA,OAAO,IAAA,CAAK,IAAI,GAAA,EAAK,IAAA,CAAK,MAAO,OAAA,GAAU,KAAA,GAAS,GAAG,CAAC,CAAA;AAC1D","file":"index.cjs","sourcesContent":["import { clsx, type ClassValue } from 'clsx';\r\nimport { twMerge } from 'tailwind-merge';\r\n\r\n/**\r\n * Merge Tailwind CSS class names with conflict resolution.\r\n */\r\nexport function cn(...inputs: ClassValue[]): string {\r\n  return twMerge(clsx(inputs));\r\n}\r\n","/**\r\n * Debounced function with cancel and flush helpers.\r\n */\r\nexport interface DebouncedFunction<A extends unknown[], R> {\r\n  (...args: A): void;\r\n  cancel(): void;\r\n  flush(): void;\r\n}\r\n\r\n/**\r\n * Debounce a function — only invoke after `ms` milliseconds of inactivity.\r\n */\r\nexport function debounce<A extends unknown[], R>(\r\n  fn: (...args: A) => R,\r\n  ms: number\r\n): DebouncedFunction<A, R> {\r\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\r\n  let lastArgs: A | null = null;\r\n\r\n  const debounced = (...args: A) => {\r\n    lastArgs = args;\r\n    if (timeoutId) clearTimeout(timeoutId);\r\n    timeoutId = setTimeout(() => {\r\n      timeoutId = null;\r\n      if (lastArgs) {\r\n        fn(...lastArgs);\r\n        lastArgs = null;\r\n      }\r\n    }, ms);\r\n  };\r\n\r\n  debounced.cancel = () => {\r\n    if (timeoutId) clearTimeout(timeoutId);\r\n    timeoutId = null;\r\n    lastArgs = null;\r\n  };\r\n\r\n  debounced.flush = () => {\r\n    if (!timeoutId || !lastArgs) return;\r\n    clearTimeout(timeoutId);\r\n    timeoutId = null;\r\n    fn(...lastArgs);\r\n    lastArgs = null;\r\n  };\r\n\r\n  return debounced;\r\n}\r\n","/**\r\n * Extract a human-readable message from an unknown error value.\r\n */\r\nexport function getErrorMessage(error: unknown, defaultMessage: string): string {\r\n  if (error instanceof Error && error.message) {\r\n    return error.message;\r\n  }\r\n\r\n  if (typeof error === 'string' && error.trim()) {\r\n    return error;\r\n  }\r\n\r\n  if (error && typeof error === 'object' && 'message' in error) {\r\n    const message = (error as { message: unknown }).message;\r\n    if (typeof message === 'string' && message.trim()) {\r\n      return message;\r\n    }\r\n  }\r\n\r\n  return defaultMessage;\r\n}\r\n","/**\r\n * Format a byte count as a human-readable string.\r\n */\r\nexport function formatBytes(bytes: number): string {\r\n  if (!Number.isFinite(bytes) || bytes <= 0) {\r\n    return '0 B';\r\n  }\r\n\r\n  const k = 1024;\r\n  const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];\r\n  const i = Math.min(\r\n    Math.floor(Math.log(bytes) / Math.log(k)),\r\n    sizes.length - 1\r\n  );\r\n  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(2))} ${sizes[i]}`;\r\n}\r\n\r\n/**\r\n * Calculate usage percentage capped at 100.\r\n */\r\nexport function calculateUsagePercentage(current: number, limit: number): number {\r\n  if (!Number.isFinite(current) || !Number.isFinite(limit) || limit <= 0) {\r\n    return 0;\r\n  }\r\n\r\n  if (current <= 0) {\r\n    return 0;\r\n  }\r\n\r\n  return Math.min(100, Math.round((current / limit) * 100));\r\n}\r\n"]}
+{"version":3,"sources":["../cn.ts","../async.ts","../error.ts","../format.ts"],"names":["twMerge","clsx"],"mappings":"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","file":"index.cjs","sourcesContent":["import { clsx, type ClassValue } from 'clsx';\r\nimport { twMerge } from 'tailwind-merge';\r\n\r\nexport type { ClassValue } from 'clsx';\r\n\r\n/**\r\n * Merge Tailwind CSS class names with conflict resolution.\r\n */\r\nexport function cn(...inputs: ClassValue[]): string {\r\n  return twMerge(clsx(inputs));\r\n}\r\n","/**\r\n * Debounced function with cancel and flush helpers.\r\n */\r\nexport interface DebouncedFunction<A extends unknown[], R> {\r\n  (...args: A): void;\r\n  cancel(): void;\r\n  flush(): void;\r\n}\r\n\r\n/**\r\n * Debounce a function — only invoke after `ms` milliseconds of inactivity.\r\n */\r\nexport function debounce<A extends unknown[], R>(\r\n  fn: (...args: A) => R,\r\n  ms: number\r\n): DebouncedFunction<A, R> {\r\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\r\n  let lastArgs: A | null = null;\r\n\r\n  const debounced = (...args: A) => {\r\n    lastArgs = args;\r\n    if (timeoutId) clearTimeout(timeoutId);\r\n    timeoutId = setTimeout(() => {\r\n      timeoutId = null;\r\n      if (lastArgs) {\r\n        fn(...lastArgs);\r\n        lastArgs = null;\r\n      }\r\n    }, ms);\r\n  };\r\n\r\n  debounced.cancel = () => {\r\n    if (timeoutId) clearTimeout(timeoutId);\r\n    timeoutId = null;\r\n    lastArgs = null;\r\n  };\r\n\r\n  debounced.flush = () => {\r\n    if (!timeoutId || !lastArgs) return;\r\n    clearTimeout(timeoutId);\r\n    timeoutId = null;\r\n    fn(...lastArgs);\r\n    lastArgs = null;\r\n  };\r\n\r\n  return debounced;\r\n}\r\n","/**\r\n * Extract a human-readable message from an unknown error value.\r\n */\r\nexport function getErrorMessage(error: unknown, defaultMessage: string): string {\r\n  if (error instanceof Error && error.message) {\r\n    return error.message;\r\n  }\r\n\r\n  if (typeof error === 'string' && error.trim()) {\r\n    return error;\r\n  }\r\n\r\n  if (error && typeof error === 'object' && 'message' in error) {\r\n    const message = (error as { message: unknown }).message;\r\n    if (typeof message === 'string' && message.trim()) {\r\n      return message;\r\n    }\r\n  }\r\n\r\n  return defaultMessage;\r\n}\r\n","/**\r\n * Format a byte count as a human-readable string.\r\n */\r\nexport function formatBytes(bytes: number): string {\r\n  if (!Number.isFinite(bytes) || bytes <= 0) {\r\n    return '0 B';\r\n  }\r\n\r\n  const k = 1024;\r\n  const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];\r\n  const i = Math.min(\r\n    Math.floor(Math.log(bytes) / Math.log(k)),\r\n    sizes.length - 1\r\n  );\r\n  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(2))} ${sizes[i]}`;\r\n}\r\n\r\n/**\r\n * Calculate usage percentage capped at 100.\r\n */\r\nexport function calculateUsagePercentage(current: number, limit: number): number {\r\n  if (!Number.isFinite(current) || !Number.isFinite(limit) || limit <= 0) {\r\n    return 0;\r\n  }\r\n\r\n  if (current <= 0) {\r\n    return 0;\r\n  }\r\n\r\n  return Math.min(100, Math.round((current / limit) * 100));\r\n}\r\n"]}

package/dist/index.d.cts

@@ -1,35 +1,5 @@
-import { ClassValue } from 'clsx';
-
-/**
- * Merge Tailwind CSS class names with conflict resolution.
- */
-declare function cn(...inputs: ClassValue[]): string;
-
-/**
- * Debounced function with cancel and flush helpers.
- */
-interface DebouncedFunction<A extends unknown[], R> {
-    (...args: A): void;
-    cancel(): void;
-    flush(): void;
-}
-/**
- * Debounce a function — only invoke after `ms` milliseconds of inactivity.
- */
-declare function debounce<A extends unknown[], R>(fn: (...args: A) => R, ms: number): DebouncedFunction<A, R>;
-
-/**
- * Extract a human-readable message from an unknown error value.
- */
-declare function getErrorMessage(error: unknown, defaultMessage: string): string;
-
-/**
- * Format a byte count as a human-readable string.
- */
-declare function formatBytes(bytes: number): string;
-/**
- * Calculate usage percentage capped at 100.
- */
-declare function calculateUsagePercentage(current: number, limit: number): number;
-
-export { type DebouncedFunction, calculateUsagePercentage, cn, debounce, formatBytes, getErrorMessage };
+export { cn } from './cn.cjs';
+export { DebouncedFunction, debounce } from './async.cjs';
+export { getErrorMessage } from './error.cjs';
+export { calculateUsagePercentage, formatBytes } from './format.cjs';
+export { ClassValue } from 'clsx';

package/dist/index.d.ts

@@ -1,35 +1,5 @@
-import { ClassValue } from 'clsx';
-
-/**
- * Merge Tailwind CSS class names with conflict resolution.
- */
-declare function cn(...inputs: ClassValue[]): string;
-
-/**
- * Debounced function with cancel and flush helpers.
- */
-interface DebouncedFunction<A extends unknown[], R> {
-    (...args: A): void;
-    cancel(): void;
-    flush(): void;
-}
-/**
- * Debounce a function — only invoke after `ms` milliseconds of inactivity.
- */
-declare function debounce<A extends unknown[], R>(fn: (...args: A) => R, ms: number): DebouncedFunction<A, R>;
-
-/**
- * Extract a human-readable message from an unknown error value.
- */
-declare function getErrorMessage(error: unknown, defaultMessage: string): string;
-
-/**
- * Format a byte count as a human-readable string.
- */
-declare function formatBytes(bytes: number): string;
-/**
- * Calculate usage percentage capped at 100.
- */
-declare function calculateUsagePercentage(current: number, limit: number): number;
-
-export { type DebouncedFunction, calculateUsagePercentage, cn, debounce, formatBytes, getErrorMessage };
+export { cn } from './cn.js';
+export { DebouncedFunction, debounce } from './async.js';
+export { getErrorMessage } from './error.js';
+export { calculateUsagePercentage, formatBytes } from './format.js';
+export { ClassValue } from 'clsx';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../cn.ts","../async.ts","../error.ts","../format.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { clsx, type ClassValue } from 'clsx';\r\nimport { twMerge } from 'tailwind-merge';\r\n\r\n/**\r\n * Merge Tailwind CSS class names with conflict resolution.\r\n */\r\nexport function cn(...inputs: ClassValue[]): string {\r\n  return twMerge(clsx(inputs));\r\n}\r\n","/**\r\n * Debounced function with cancel and flush helpers.\r\n */\r\nexport interface DebouncedFunction<A extends unknown[], R> {\r\n  (...args: A): void;\r\n  cancel(): void;\r\n  flush(): void;\r\n}\r\n\r\n/**\r\n * Debounce a function — only invoke after `ms` milliseconds of inactivity.\r\n */\r\nexport function debounce<A extends unknown[], R>(\r\n  fn: (...args: A) => R,\r\n  ms: number\r\n): DebouncedFunction<A, R> {\r\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\r\n  let lastArgs: A | null = null;\r\n\r\n  const debounced = (...args: A) => {\r\n    lastArgs = args;\r\n    if (timeoutId) clearTimeout(timeoutId);\r\n    timeoutId = setTimeout(() => {\r\n      timeoutId = null;\r\n      if (lastArgs) {\r\n        fn(...lastArgs);\r\n        lastArgs = null;\r\n      }\r\n    }, ms);\r\n  };\r\n\r\n  debounced.cancel = () => {\r\n    if (timeoutId) clearTimeout(timeoutId);\r\n    timeoutId = null;\r\n    lastArgs = null;\r\n  };\r\n\r\n  debounced.flush = () => {\r\n    if (!timeoutId || !lastArgs) return;\r\n    clearTimeout(timeoutId);\r\n    timeoutId = null;\r\n    fn(...lastArgs);\r\n    lastArgs = null;\r\n  };\r\n\r\n  return debounced;\r\n}\r\n","/**\r\n * Extract a human-readable message from an unknown error value.\r\n */\r\nexport function getErrorMessage(error: unknown, defaultMessage: string): string {\r\n  if (error instanceof Error && error.message) {\r\n    return error.message;\r\n  }\r\n\r\n  if (typeof error === 'string' && error.trim()) {\r\n    return error;\r\n  }\r\n\r\n  if (error && typeof error === 'object' && 'message' in error) {\r\n    const message = (error as { message: unknown }).message;\r\n    if (typeof message === 'string' && message.trim()) {\r\n      return message;\r\n    }\r\n  }\r\n\r\n  return defaultMessage;\r\n}\r\n","/**\r\n * Format a byte count as a human-readable string.\r\n */\r\nexport function formatBytes(bytes: number): string {\r\n  if (!Number.isFinite(bytes) || bytes <= 0) {\r\n    return '0 B';\r\n  }\r\n\r\n  const k = 1024;\r\n  const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];\r\n  const i = Math.min(\r\n    Math.floor(Math.log(bytes) / Math.log(k)),\r\n    sizes.length - 1\r\n  );\r\n  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(2))} ${sizes[i]}`;\r\n}\r\n\r\n/**\r\n * Calculate usage percentage capped at 100.\r\n */\r\nexport function calculateUsagePercentage(current: number, limit: number): number {\r\n  if (!Number.isFinite(current) || !Number.isFinite(limit) || limit <= 0) {\r\n    return 0;\r\n  }\r\n\r\n  if (current <= 0) {\r\n    return 0;\r\n  }\r\n\r\n  return Math.min(100, Math.round((current / limit) * 100));\r\n}\r\n"]}
+{"version":3,"sources":["../cn.ts","../async.ts","../error.ts","../format.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { clsx, type ClassValue } from 'clsx';\r\nimport { twMerge } from 'tailwind-merge';\r\n\r\nexport type { ClassValue } from 'clsx';\r\n\r\n/**\r\n * Merge Tailwind CSS class names with conflict resolution.\r\n */\r\nexport function cn(...inputs: ClassValue[]): string {\r\n  return twMerge(clsx(inputs));\r\n}\r\n","/**\r\n * Debounced function with cancel and flush helpers.\r\n */\r\nexport interface DebouncedFunction<A extends unknown[], R> {\r\n  (...args: A): void;\r\n  cancel(): void;\r\n  flush(): void;\r\n}\r\n\r\n/**\r\n * Debounce a function — only invoke after `ms` milliseconds of inactivity.\r\n */\r\nexport function debounce<A extends unknown[], R>(\r\n  fn: (...args: A) => R,\r\n  ms: number\r\n): DebouncedFunction<A, R> {\r\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\r\n  let lastArgs: A | null = null;\r\n\r\n  const debounced = (...args: A) => {\r\n    lastArgs = args;\r\n    if (timeoutId) clearTimeout(timeoutId);\r\n    timeoutId = setTimeout(() => {\r\n      timeoutId = null;\r\n      if (lastArgs) {\r\n        fn(...lastArgs);\r\n        lastArgs = null;\r\n      }\r\n    }, ms);\r\n  };\r\n\r\n  debounced.cancel = () => {\r\n    if (timeoutId) clearTimeout(timeoutId);\r\n    timeoutId = null;\r\n    lastArgs = null;\r\n  };\r\n\r\n  debounced.flush = () => {\r\n    if (!timeoutId || !lastArgs) return;\r\n    clearTimeout(timeoutId);\r\n    timeoutId = null;\r\n    fn(...lastArgs);\r\n    lastArgs = null;\r\n  };\r\n\r\n  return debounced;\r\n}\r\n","/**\r\n * Extract a human-readable message from an unknown error value.\r\n */\r\nexport function getErrorMessage(error: unknown, defaultMessage: string): string {\r\n  if (error instanceof Error && error.message) {\r\n    return error.message;\r\n  }\r\n\r\n  if (typeof error === 'string' && error.trim()) {\r\n    return error;\r\n  }\r\n\r\n  if (error && typeof error === 'object' && 'message' in error) {\r\n    const message = (error as { message: unknown }).message;\r\n    if (typeof message === 'string' && message.trim()) {\r\n      return message;\r\n    }\r\n  }\r\n\r\n  return defaultMessage;\r\n}\r\n","/**\r\n * Format a byte count as a human-readable string.\r\n */\r\nexport function formatBytes(bytes: number): string {\r\n  if (!Number.isFinite(bytes) || bytes <= 0) {\r\n    return '0 B';\r\n  }\r\n\r\n  const k = 1024;\r\n  const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];\r\n  const i = Math.min(\r\n    Math.floor(Math.log(bytes) / Math.log(k)),\r\n    sizes.length - 1\r\n  );\r\n  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(2))} ${sizes[i]}`;\r\n}\r\n\r\n/**\r\n * Calculate usage percentage capped at 100.\r\n */\r\nexport function calculateUsagePercentage(current: number, limit: number): number {\r\n  if (!Number.isFinite(current) || !Number.isFinite(limit) || limit <= 0) {\r\n    return 0;\r\n  }\r\n\r\n  if (current <= 0) {\r\n    return 0;\r\n  }\r\n\r\n  return Math.min(100, Math.round((current / limit) * 100));\r\n}\r\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@publikit/utils",
-  "version": "0.1.1",
+  "version": "1.0.0",
   "description": "Framework-agnostic utility functions for Publikit packages and applications",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -11,11 +11,32 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./cn": {
+      "types": "./dist/cn.d.ts",
+      "import": "./dist/cn.js",
+      "require": "./dist/cn.cjs"
+    },
+    "./async": {
+      "types": "./dist/async.d.ts",
+      "import": "./dist/async.js",
+      "require": "./dist/async.cjs"
+    },
+    "./error": {
+      "types": "./dist/error.d.ts",
+      "import": "./dist/error.js",
+      "require": "./dist/error.cjs"
+    },
+    "./format": {
+      "types": "./dist/format.d.ts",
+      "import": "./dist/format.js",
+      "require": "./dist/format.cjs"
     }
   },
   "files": [
     "dist",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "sideEffects": false,
@@ -25,7 +46,8 @@
     "clean": "rimraf dist",
     "prepublishOnly": "npm run clean && npm run build",
     "typecheck": "tsc --noEmit",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage"
   },
   "keywords": [
     "utilities",
@@ -39,9 +61,9 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/pirimera/publikit.git",
-    "directory": "utils"
+    "directory": "packages/utils"
   },
-  "homepage": "https://github.com/pirimera/publikit/tree/main/utils#readme",
+  "homepage": "https://github.com/pirimera/publikit/tree/main/packages/utils#readme",
   "bugs": {
     "url": "https://github.com/pirimera/publikit/issues"
   },
@@ -59,6 +81,7 @@
     "rimraf": "^5.0.0",
     "tsup": "^8.0.0",
     "typescript": "^5.8.3",
+    "@vitest/coverage-v8": "^4.0.18",
     "vitest": "^4.0.18"
   }
 }