@buoy-gg/shared-ui 1.7.2

package/lib/typescript/module/ui/gameUI/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Game UI Design System Components
+ * Reusable components following cyberpunk/sci-fi aesthetic
+ */
+export { GameUICollapsibleSection } from "./components/GameUICollapsibleSection";
+export type { GameUICollapsibleSectionProps } from "./components/GameUICollapsibleSection";
+export { GameUIStatusHeader } from "./components/GameUIStatusHeader";
+export type { GameUIStatusHeaderProps } from "./components/GameUIStatusHeader";
+export { GameUICompactStats } from "./components/GameUICompactStats";
+export type { GameUICompactStatsProps, StatCardConfig, } from "./components/GameUICompactStats";
+export { GameUIIssuesList } from "./components/GameUIIssuesList";
+export type { GameUIIssuesListProps, IssueItem, } from "./components/GameUIIssuesList";
+export { useGameUIAlertState, GAME_UI_ALERT_STATES, } from "./hooks/useGameUIAlertState";
+export type { AlertStateType, AlertStateConfig, GameUIStats, } from "./hooks/useGameUIAlertState";
+export { gameUIColors, dialColors, buoyColors } from "./constants/gameUIColors";
+export type { GameUIColorKey, BuoyColorKey } from "./constants/gameUIColors";
+export { macOSColors } from "./constants/macOSDesignSystemColors";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/ui/gameUI/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ui/gameUI/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,YAAY,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AAE3F,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,YAAY,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,YAAY,EACV,uBAAuB,EACvB,cAAc,GACf,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,YAAY,EACV,qBAAqB,EACrB,SAAS,GACV,MAAM,+BAA+B,CAAC;AAKvC,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,WAAW,GACZ,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAChF,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7E,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC"}

package/lib/typescript/module/ui/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./components";
+export { CyberpunkSectionButton } from "./console/CyberpunkSectionButton";
+export * from "./gameUI";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ui/index.ts"],"names":[],"mappings":"AAGA,cAAc,cAAc,CAAC;AAG7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAG1E,cAAc,UAAU,CAAC"}

package/lib/typescript/module/utils/displayValue.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Displays a string regardless the type of the data
+ * Uses minimal SuperJSON to properly serialize complex objects, avoiding [object Object].
+ * @param {unknown} value Value to be stringified
+ * @param {boolean} beautify Formats json to multiline
+ */
+export declare const displayValue: (value: unknown, beautify?: boolean) => string;
+/**
+ * Parses a string that was serialized with displayValue/minimal SuperJSON.
+ * Properly deserializes complex types like Date, RegExp, Map, Set, etc.
+ *
+ * @param value - The string to parse
+ * @returns The deserialized value
+ */
+export declare const parseDisplayValue: (value: string) => any;
+//# sourceMappingURL=displayValue.d.ts.map

package/lib/typescript/module/utils/displayValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayValue.d.ts","sourceRoot":"","sources":["../../../../src/utils/displayValue.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,EAAE,WAAU,OAAe,WAGrE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,QAQ9C,CAAC"}

package/lib/typescript/module/utils/formatting/dataFormatting.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Shared data formatting utilities
+ */
+/**
+ * Format byte size to human-readable format
+ * @param bytes Size in bytes
+ * @returns Formatted size string (e.g., "1.5 KB", "2.3 MB")
+ */
+export declare function formatBytes(bytes: number | undefined | null): string;
+/**
+ * Format duration from milliseconds to human-readable format
+ * @param ms Duration in milliseconds
+ * @returns Formatted duration string (e.g., "500ms", "1.5s", "2m 30s")
+ */
+export declare function formatDuration(ms: number | undefined): string;
+/**
+ * Format a number with thousand separators
+ * @param num The number to format
+ * @returns Formatted number string (e.g., "1,234,567")
+ */
+export declare function formatNumber(num: number): string;
+/**
+ * Truncate a string in the middle with ellipsis
+ * @param str The string to truncate
+ * @param maxLength Maximum length before truncation
+ * @param startChars Number of characters to show at start
+ * @param endChars Number of characters to show at end
+ * @returns Truncated string
+ */
+export declare function truncateMiddle(str: string, maxLength?: number, startChars?: number, endChars?: number): string;
+//# sourceMappingURL=dataFormatting.d.ts.map

package/lib/typescript/module/utils/formatting/dataFormatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataFormatting.d.ts","sourceRoot":"","sources":["../../../../../src/utils/formatting/dataFormatting.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CASpE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAoB7D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,SAAS,GAAE,MAAW,EACtB,UAAU,GAAE,MAAW,EACvB,QAAQ,GAAE,MAAW,GACpB,MAAM,CAOR"}

package/lib/typescript/module/utils/formatting/httpFormatting.d.ts

@@ -0,0 +1,34 @@
+/**
+ * HTTP-specific formatting utilities
+ */
+/**
+ * Format HTTP status code with color and meaning
+ * @param status HTTP status code
+ * @returns Object with formatted text, color, and meaning
+ */
+export declare function formatHttpStatus(status: number): {
+    text: string;
+    color: string;
+    meaning: string;
+};
+/**
+ * Get color for HTTP method
+ * @param method HTTP method (GET, POST, etc.)
+ * @returns Color string for the method
+ */
+export declare function getMethodColor(method: string): string;
+/**
+ * Parse URL into components for display
+ * @param url The URL to parse
+ * @returns URL components
+ */
+export interface UrlComponents {
+    protocol: string;
+    host: string;
+    port?: string;
+    pathname: string;
+    search?: string;
+    hash?: string;
+}
+export declare function parseUrl(url: string): UrlComponents | null;
+//# sourceMappingURL=httpFormatting.d.ts.map

package/lib/typescript/module/utils/formatting/httpFormatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpFormatting.d.ts","sourceRoot":"","sources":["../../../../../src/utils/formatting/httpFormatting.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAuFA;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAcrD;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAqB1D"}

package/lib/typescript/module/utils/formatting/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Shared formatting utilities
+ */
+export * from "./dataFormatting";
+export * from "./httpFormatting";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/utils/formatting/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/utils/formatting/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/lib/typescript/module/utils/getSafeAreaInsets.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Pure JS implementation of safe area insets
+ * Detects device type and returns appropriate safe areas
+ *
+ * @returns Object with top, bottom, left, right insets and hasNotch flag
+ */
+export declare const getSafeAreaInsets: () => {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+    hasNotch: boolean;
+};
+//# sourceMappingURL=getSafeAreaInsets.d.ts.map

package/lib/typescript/module/utils/getSafeAreaInsets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSafeAreaInsets.d.ts","sourceRoot":"","sources":["../../../../src/utils/getSafeAreaInsets.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;CA0B7B,CAAC"}

package/lib/typescript/module/utils/index.d.ts

@@ -0,0 +1,9 @@
+export { displayValue, parseDisplayValue } from "./displayValue";
+export { getSafeAreaInsets } from "./getSafeAreaInsets";
+export { safeGetItem, safeSetItem, safeRemoveItem, isPersistentStorageAvailable, useSafeAsyncStorage, } from "./safeAsyncStorage";
+export { persistentStorage, isUsingPersistentStorage, getStorageBackendType, type DevToolsStorage, } from "./persistentStorage";
+export { safeStringify } from "./safeStringify";
+export { getValueType, isPrimitive, isJsonSerializable, isValidJson, getConstructorName, isEmpty, getValueSize, } from "./typeHelpers";
+export { parseValue, formatValue, getTypeColor, truncateText, flattenObject, formatPath, } from "./valueFormatting";
+export { loadOptionalModule, getCachedOptionalModule } from "./loadOptionalModule";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,WAAW,EACX,WAAW,EACX,cAAc,EACd,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,OAAO,EACP,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,UAAU,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/lib/typescript/module/utils/loadOptionalModule.d.ts

@@ -0,0 +1,27 @@
+interface LoadModuleLogger {
+    log?: (...args: unknown[]) => void;
+    warn?: (...args: unknown[]) => void;
+    error?: (...args: unknown[]) => void;
+}
+type LoaderOptions = {
+    logger?: LoadModuleLogger;
+    warnOnceKey?: string;
+    warningMessage?: string;
+    /**
+     * Optional custom loader. Useful when bundlers forbid fully dynamic imports
+     * (e.g. Metro) and a platform specific loader must be provided instead.
+     */
+    loader?: () => unknown | Promise<unknown>;
+};
+/**
+ * Dynamically loads an optional dependency and caches the result. Returns `null`
+ * when the module cannot be imported.
+ */
+export declare function loadOptionalModule<T = unknown>(moduleName: string, options?: LoaderOptions): Promise<T | null>;
+/**
+ * Synchronous getter that returns a previously loaded optional module, or `null`
+ * if it has either not been loaded yet or failed to load.
+ */
+export declare function getCachedOptionalModule<T = unknown>(moduleName: string): T | null;
+export {};
+//# sourceMappingURL=loadOptionalModule.d.ts.map

package/lib/typescript/module/utils/loadOptionalModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadOptionalModule.d.ts","sourceRoot":"","sources":["../../../../src/utils/loadOptionalModule.ts"],"names":[],"mappings":"AACA,UAAU,gBAAgB;IACxB,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACtC;AAUD,KAAK,aAAa,GAAG;IACnB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3C,CAAC;AAMF;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAClD,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAsCnB;AA8CD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAKjF"}

package/lib/typescript/module/utils/minimalSuperJSON.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Minimal SuperJSON implementation for DevTools
+ * Handles serialization/deserialization of special JavaScript types
+ * Zero dependencies, ~250 LOC
+ *
+ * Supports: Date, RegExp, Set, Map, Error, BigInt, undefined, NaN, Infinity, -0, URL, TypedArrays
+ */
+type TypeAnnotation = 'undefined' | 'bigint' | 'Date' | 'Error' | 'regexp' | 'set' | 'map' | 'number' | 'URL' | ['typed-array', string];
+export interface SuperJSONResult {
+    json: any;
+    meta?: {
+        values?: Record<string, TypeAnnotation>;
+    };
+}
+export declare function serialize(object: any): SuperJSONResult;
+export declare function deserialize<T = unknown>(payload: SuperJSONResult): T;
+export {};
+//# sourceMappingURL=minimalSuperJSON.d.ts.map

package/lib/typescript/module/utils/minimalSuperJSON.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimalSuperJSON.d.ts","sourceRoot":"","sources":["../../../../src/utils/minimalSuperJSON.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0EH,KAAK,cAAc,GACf,WAAW,GACX,QAAQ,GACR,MAAM,GACN,OAAO,GACP,QAAQ,GACR,KAAK,GACL,KAAK,GACL,QAAQ,GACR,KAAK,GACL,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;AA+T5B,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,GAAG,CAAC;IACV,IAAI,CAAC,EAAE;QACL,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;KACzC,CAAC;CACH;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,GAAG,GAAG,eAAe,CAYtD;AAED,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,CAAC,CAyBpE"}

package/lib/typescript/module/utils/persistentStorage.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Persistent Storage for React Buoy DevTools
+ *
+ * This module provides a storage abstraction that persists independently of AsyncStorage.
+ * When expo-file-system is available, it uses file-based storage that survives
+ * AsyncStorage.clear() calls (e.g., during logout flows).
+ *
+ * Fallback hierarchy:
+ * 1. FileSystem (expo-file-system) - persistent, survives AsyncStorage.clear()
+ * 2. AsyncStorage - standard React Native storage
+ * 3. Memory - in-memory fallback when nothing else works
+ */
+export interface DevToolsStorage {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    getAllKeys(): Promise<string[]>;
+    multiGet(keys: string[]): Promise<[string, string | null][]>;
+    multiRemove(keys: string[]): Promise<void>;
+    clear(): Promise<void>;
+}
+type StorageBackend = "filesystem" | "asyncstorage" | "localstorage" | "memory";
+/**
+ * Persistent storage for React Buoy DevTools
+ *
+ * Uses FileSystem when available (survives AsyncStorage.clear()),
+ * falls back to AsyncStorage, then localStorage (web), then memory.
+ *
+ * Same API as AsyncStorage for easy migration.
+ */
+export declare const persistentStorage: DevToolsStorage;
+/**
+ * Check if persistent storage (FileSystem) is being used
+ */
+export declare function isUsingPersistentStorage(): Promise<boolean>;
+/**
+ * Get the current storage backend type
+ */
+export declare function getStorageBackendType(): Promise<StorageBackend>;
+/**
+ * Force re-initialization of storage (useful for testing)
+ */
+export declare function resetStorageInit(): void;
+export {};
+//# sourceMappingURL=persistentStorage.d.ts.map

package/lib/typescript/module/utils/persistentStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistentStorage.d.ts","sourceRoot":"","sources":["../../../../src/utils/persistentStorage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA2CH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7D,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAGD,KAAK,cAAc,GAAG,YAAY,GAAG,cAAc,GAAG,cAAc,GAAG,QAAQ,CAAC;AAmjBhF;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAmC/B,CAAC;AAEF;;GAEG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,OAAO,CAAC,CAGjE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,cAAc,CAAC,CAGrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC"}

package/lib/typescript/module/utils/safeAsyncStorage.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Read a value from persistent storage (FileSystem > AsyncStorage > Memory)
+ *
+ * @deprecated Use `persistentStorage.getItem()` directly for new code
+ */
+export declare function safeGetItem(key: string): Promise<string | null>;
+/**
+ * Persist a value to storage (FileSystem > AsyncStorage > Memory)
+ *
+ * @deprecated Use `persistentStorage.setItem()` directly for new code
+ */
+export declare function safeSetItem(key: string, value: string): Promise<void>;
+/**
+ * Remove an item from storage
+ *
+ * @deprecated Use `persistentStorage.removeItem()` directly for new code
+ */
+export declare function safeRemoveItem(key: string): Promise<void>;
+/**
+ * Check if persistent storage (FileSystem) is being used
+ * Returns true if FileSystem storage is available and working
+ */
+export declare function isPersistentStorageAvailable(): Promise<boolean>;
+/**
+ * React hook exposing storage APIs backed by persistent storage
+ *
+ * @deprecated Use `persistentStorage` directly for new code
+ */
+export declare function useSafeAsyncStorage(): {
+    getItem: typeof safeGetItem;
+    setItem: typeof safeSetItem;
+    removeItem: typeof safeRemoveItem;
+    isPersistent: boolean;
+};
+//# sourceMappingURL=safeAsyncStorage.d.ts.map

package/lib/typescript/module/utils/safeAsyncStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeAsyncStorage.d.ts","sourceRoot":"","sources":["../../../../src/utils/safeAsyncStorage.ts"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAErE;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/D;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,OAAO,CAAC,CAErE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB;;;;;EAiBlC"}

package/lib/typescript/module/utils/safeStringify.d.ts

@@ -0,0 +1,49 @@
+import { JsonValue } from "../types/types";
+/**
+ * Safely stringifies objects with circular references by:
+ * 1. Pre-processing to detect and temporarily replace circular references
+ * 2. Handling special JS types that JSON.stringify can't serialize
+ * 3. Restoring original object structure after stringification
+ * 4. Inspired by fast-safe-stringify with additional type handling
+ */
+interface SafeStringifyOptions {
+    depthLimit?: number;
+    edgesLimit?: number;
+}
+/**
+ * Safely stringifies objects with circular references and special JavaScript types
+ *
+ * This function provides comprehensive JSON serialization that handles:
+ * - Circular references (replaced with "[Circular]")
+ * - Special JavaScript types (Date, RegExp, Error, Map, Set, etc.)
+ * - Non-serializable values (undefined, functions, symbols, BigInt)
+ * - Depth and edge limits to prevent infinite recursion
+ * - Restoration of original object structure after processing
+ *
+ * @param obj - The object/value to stringify
+ * @param space - Number of spaces for pretty-printing (optional)
+ * @param options - Configuration options for limits
+ * @param options.depthLimit - Maximum depth to traverse (default: unlimited)
+ * @param options.edgesLimit - Maximum edges per object (default: unlimited)
+ *
+ * @returns JSON string representation of the object
+ *
+ * @example
+ * ```typescript
+ * const obj = { name: "test" };
+ * obj.self = obj; // circular reference
+ *
+ * const result = safeStringify(obj, 2);
+ * // Returns: '{\n  "name": "test",\n  "self": "[Circular]"\n}'
+ *
+ * // With limits
+ * const limited = safeStringify(deepObject, 2, { depthLimit: 5 });
+ * ```
+ *
+ * @performance Uses pre-processing approach to handle circular references efficiently
+ * @performance Includes object restoration to maintain original structure integrity
+ * @performance Optimized for arrays and objects with separate handling paths
+ */
+export declare function safeStringify(obj: JsonValue, space?: number, options?: SafeStringifyOptions): string;
+export {};
+//# sourceMappingURL=safeStringify.d.ts.map

package/lib/typescript/module/utils/safeStringify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeStringify.d.ts","sourceRoot":"","sources":["../../../../src/utils/safeStringify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAW3C;;;;;;GAMG;AAEH,UAAU,oBAAoB;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,SAAS,EACd,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB,GACjC,MAAM,CAuNR"}

package/lib/typescript/module/utils/time/formatRelativeTime.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Formats a timestamp as relative time (e.g., "1s ago", "5m ago", "2h ago")
+ * @param timestamp - The timestamp to format (Date object or number in milliseconds)
+ * @param currentTime - Current time in milliseconds (defaults to Date.now())
+ * @returns Formatted relative time string
+ */
+export declare function formatRelativeTime(timestamp: Date | number, currentTime?: number): string;
+//# sourceMappingURL=formatRelativeTime.d.ts.map

package/lib/typescript/module/utils/time/formatRelativeTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatRelativeTime.d.ts","sourceRoot":"","sources":["../../../../../src/utils/time/formatRelativeTime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,IAAI,GAAG,MAAM,EACxB,WAAW,GAAE,MAAmB,GAC/B,MAAM,CA0BR"}

package/lib/typescript/module/utils/time/index.d.ts

@@ -0,0 +1,2 @@
+export { formatRelativeTime } from './formatRelativeTime';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/utils/time/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/utils/time/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/lib/typescript/module/utils/typeHelpers.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Type detection and validation utilities
+ */
+/**
+ * Detects the type of a value with more granular type checking
+ * @param value - The value to check
+ * @returns A string representing the specific type
+ */
+export declare const getValueType: (value: unknown) => string;
+/**
+ * Checks if a value is a primitive type
+ * @param value - The value to check
+ * @returns True if the value is primitive
+ */
+export declare const isPrimitive: (value: unknown) => boolean;
+/**
+ * Checks if a value is a valid JSON serializable value
+ * @param value - The value to check
+ * @returns True if the value can be JSON serialized
+ */
+export declare const isJsonSerializable: (value: unknown) => boolean;
+/**
+ * Checks if a string represents a valid JSON value
+ * @param str - The string to test
+ * @returns True if the string is valid JSON
+ */
+export declare const isValidJson: (str: string) => boolean;
+/**
+ * Safely gets the constructor name of a value
+ * @param value - The value to check
+ * @returns The constructor name or type string
+ */
+export declare const getConstructorName: (value: unknown) => string;
+/**
+ * Checks if a value is an empty object or array
+ * @param value - The value to check
+ * @returns True if the value is empty
+ */
+export declare const isEmpty: (value: unknown) => boolean;
+/**
+ * Gets a human-readable size description for objects and arrays
+ * @param value - The value to get size for
+ * @returns A human-readable size string
+ */
+export declare const getValueSize: (value: unknown) => string;
+/**
+ * Type guard to check if a value is an object (not null, not array)
+ * @param value - The value to check
+ * @returns True if value is a plain object
+ */
+export declare const isPlainObject: (value: unknown) => value is Record<string, unknown>;
+//# sourceMappingURL=typeHelpers.d.ts.map

package/lib/typescript/module/utils/typeHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeHelpers.d.ts","sourceRoot":"","sources":["../../../../src/utils/typeHelpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,MAiB7C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,OAW5C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,OAOnD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,KAAG,OAOzC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,MASnD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,OAAO,KAAG,OAMxC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,MAwB7C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAO7E,CAAC"}

package/lib/typescript/module/utils/valueFormatting.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Safely parses a value that might be a JSON string
+ * @param value - The value to parse
+ * @returns The parsed value or original value if parsing fails
+ */
+export declare const parseValue: (value: unknown) => unknown;
+/**
+ * Formats a value for display with appropriate type representation
+ * @param value - The value to format
+ * @returns A string representation of the value
+ */
+export declare const formatValue: (value: unknown) => string;
+/**
+ * Gets the color for a value based on its type
+ * @param value - The value to get color for
+ * @returns The color string for the value type
+ */
+export declare const getTypeColor: (value: unknown) => string;
+/**
+ * Truncates text to a specified length with ellipsis
+ * @param text - The text to truncate
+ * @param maxLength - Maximum length before truncation
+ * @returns Truncated text with ellipsis if needed
+ */
+export declare const truncateText: (text: string, maxLength: number) => string;
+/**
+ * Flattens a nested object into a flat structure with dot notation paths
+ * @param obj - The object to flatten
+ * @param prefix - The prefix for the current level
+ * @returns A flat object with dot notation keys
+ */
+export declare const flattenObject: (obj: unknown, prefix?: string) => Record<string, unknown>;
+/**
+ * Creates a readable path from an array of segments (for diff viewers)
+ * @param pathSegments - Array of path segments
+ * @returns A readable path string
+ */
+export declare const formatPath: (pathSegments: (string | number)[]) => string;
+//# sourceMappingURL=valueFormatting.d.ts.map

package/lib/typescript/module/utils/valueFormatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"valueFormatting.d.ts","sourceRoot":"","sources":["../../../../src/utils/valueFormatting.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,OAAO,KAAG,OAU3C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,MAe5C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,MAqB7C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,WAAW,MAAM,KAAG,MAG9D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,KAAK,OAAO,EACZ,eAAW,KACV,MAAM,CAAC,MAAM,EAAE,OAAO,CAkCxB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,cAAc,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAG,MAY9D,CAAC"}