@bloomneo/appkit 1.2.9

package/dist/util/defaults.js

@@ -0,0 +1,193 @@
+/**
+ * Smart defaults and environment validation for utilities
+ * @module @bloomneo/appkit/util
+ * @file src/util/defaults.ts
+ *
+ * @llm-rule WHEN: App startup - need to configure utility behavior and performance settings
+ * @llm-rule AVOID: Calling multiple times - expensive environment parsing, use lazy loading in get()
+ * @llm-rule NOTE: Called once at startup, cached globally for performance like other modules
+ */
+/**
+ * Gets smart defaults using VOILA_UTIL_* environment variables
+ * @llm-rule WHEN: App startup to get production-ready utility configuration
+ * @llm-rule AVOID: Calling repeatedly - expensive validation, cache the result
+ * @llm-rule NOTE: Called once at startup, cached globally for performance
+ */
+export function getSmartDefaults() {
+    validateEnvironment();
+    const nodeEnv = process.env.NODE_ENV || 'development';
+    const isDevelopment = nodeEnv === 'development';
+    const isProduction = nodeEnv === 'production';
+    const isTest = nodeEnv === 'test';
+    return {
+        version: process.env.npm_package_version || '1.0.0',
+        // Cache configuration with direct environment access
+        cache: {
+            enabled: process.env.VOILA_UTIL_CACHE !== 'false' && !isTest,
+            maxSize: parseInt(process.env.VOILA_UTIL_CACHE_SIZE || '1000'),
+            ttl: parseInt(process.env.VOILA_UTIL_CACHE_TTL || '300000'), // 5 minutes
+        },
+        // Performance optimization settings
+        performance: {
+            enabled: process.env.VOILA_UTIL_PERFORMANCE !== 'false',
+            memoization: process.env.VOILA_UTIL_MEMOIZATION !== 'false' && !isTest,
+            largeArrayThreshold: parseInt(process.env.VOILA_UTIL_ARRAY_THRESHOLD || '10000'),
+            chunkSizeLimit: parseInt(process.env.VOILA_UTIL_CHUNK_LIMIT || '100000'),
+        },
+        // Debug configuration - enabled in development
+        debug: {
+            enabled: process.env.VOILA_UTIL_DEBUG === 'true' || isDevelopment,
+            logOperations: process.env.VOILA_UTIL_LOG_OPS === 'true' || isDevelopment,
+            trackPerformance: process.env.VOILA_UTIL_TRACK_PERF === 'true' || isDevelopment,
+        },
+        // Slugify configuration with locale support
+        slugify: {
+            lowercase: process.env.VOILA_UTIL_SLUGIFY_LOWERCASE !== 'false',
+            strict: process.env.VOILA_UTIL_SLUGIFY_STRICT === 'true',
+            locale: process.env.VOILA_UTIL_LOCALE || 'en',
+            replacement: process.env.VOILA_UTIL_SLUGIFY_REPLACEMENT || '-',
+        },
+        // Format configuration for locale-aware formatting
+        format: {
+            locale: process.env.VOILA_UTIL_LOCALE || 'en-US',
+            currency: process.env.VOILA_UTIL_CURRENCY || 'USD',
+            dateFormat: process.env.VOILA_UTIL_DATE_FORMAT || 'YYYY-MM-DD',
+            numberPrecision: parseInt(process.env.VOILA_UTIL_NUMBER_PRECISION || '2'),
+        },
+        // Environment information
+        environment: {
+            isDevelopment,
+            isProduction,
+            isTest,
+            nodeEnv,
+        },
+    };
+}
+/**
+ * Validates environment variables for utility configuration
+ * @llm-rule WHEN: App startup to ensure proper utility environment configuration
+ * @llm-rule AVOID: Skipping validation - improper config causes performance issues
+ * @llm-rule NOTE: Validates cache sizes, performance thresholds, and locale settings
+ */
+function validateEnvironment() {
+    const nodeEnv = process.env.NODE_ENV || 'development';
+    // Validate cache configuration
+    const cacheSize = process.env.VOILA_UTIL_CACHE_SIZE;
+    if (cacheSize) {
+        const cacheSizeNum = parseInt(cacheSize);
+        if (isNaN(cacheSizeNum) || cacheSizeNum <= 0) {
+            throw new Error(`Invalid VOILA_UTIL_CACHE_SIZE: "${cacheSize}". Must be a positive number.`);
+        }
+        if (cacheSizeNum > 100000) {
+            console.warn(`[VoilaJSX AppKit] Large cache size: ${cacheSizeNum}. This may impact memory usage.`);
+        }
+    }
+    // Validate cache TTL
+    const cacheTTL = process.env.VOILA_UTIL_CACHE_TTL;
+    if (cacheTTL) {
+        const cacheTTLNum = parseInt(cacheTTL);
+        if (isNaN(cacheTTLNum) || cacheTTLNum <= 0) {
+            throw new Error(`Invalid VOILA_UTIL_CACHE_TTL: "${cacheTTL}". Must be a positive number (milliseconds).`);
+        }
+    }
+    // Validate array threshold
+    const arrayThreshold = process.env.VOILA_UTIL_ARRAY_THRESHOLD;
+    if (arrayThreshold) {
+        const thresholdNum = parseInt(arrayThreshold);
+        if (isNaN(thresholdNum) || thresholdNum <= 0) {
+            throw new Error(`Invalid VOILA_UTIL_ARRAY_THRESHOLD: "${arrayThreshold}". Must be a positive number.`);
+        }
+    }
+    // Validate chunk size limit
+    const chunkLimit = process.env.VOILA_UTIL_CHUNK_LIMIT;
+    if (chunkLimit) {
+        const chunkLimitNum = parseInt(chunkLimit);
+        if (isNaN(chunkLimitNum) || chunkLimitNum <= 0) {
+            throw new Error(`Invalid VOILA_UTIL_CHUNK_LIMIT: "${chunkLimit}". Must be a positive number.`);
+        }
+    }
+    // Validate number precision
+    const numberPrecision = process.env.VOILA_UTIL_NUMBER_PRECISION;
+    if (numberPrecision) {
+        const precisionNum = parseInt(numberPrecision);
+        if (isNaN(precisionNum) || precisionNum < 0 || precisionNum > 20) {
+            throw new Error(`Invalid VOILA_UTIL_NUMBER_PRECISION: "${numberPrecision}". Must be between 0 and 20.`);
+        }
+    }
+    // Validate locale if provided
+    const locale = process.env.VOILA_UTIL_LOCALE;
+    if (locale && !isValidLocale(locale)) {
+        console.warn(`[VoilaJSX AppKit] Invalid locale: "${locale}". Using default 'en-US'.`);
+    }
+    // Validate currency if provided
+    const currency = process.env.VOILA_UTIL_CURRENCY;
+    if (currency && !isValidCurrency(currency)) {
+        console.warn(`[VoilaJSX AppKit] Invalid currency: "${currency}". Using default 'USD'.`);
+    }
+    // Validate slugify replacement
+    const replacement = process.env.VOILA_UTIL_SLUGIFY_REPLACEMENT;
+    if (replacement && replacement.length > 5) {
+        console.warn(`[VoilaJSX AppKit] Long slugify replacement: "${replacement}". Consider using shorter replacement.`);
+    }
+    // Production-specific warnings
+    if (nodeEnv === 'production') {
+        if (process.env.VOILA_UTIL_DEBUG === 'true') {
+            console.warn('[VoilaJSX AppKit] Debug mode enabled in production. This may impact performance.');
+        }
+        if (process.env.VOILA_UTIL_LOG_OPS === 'true') {
+            console.warn('[VoilaJSX AppKit] Operation logging enabled in production. This may impact performance.');
+        }
+    }
+    // Validate NODE_ENV
+    if (nodeEnv && !['development', 'production', 'test', 'staging'].includes(nodeEnv)) {
+        console.warn(`[VoilaJSX AppKit] Unusual NODE_ENV: "${nodeEnv}". ` +
+            `Expected: development, production, test, or staging`);
+    }
+}
+/**
+ * Validates locale format using basic pattern matching
+ * @llm-rule WHEN: Validating user-provided locale settings
+ * @llm-rule AVOID: Complex locale validation - basic pattern matching is sufficient
+ */
+function isValidLocale(locale) {
+    // Basic locale pattern: language[-Country]
+    const localePattern = /^[a-z]{2}(-[A-Z]{2})?$/;
+    return localePattern.test(locale);
+}
+/**
+ * Validates currency code format (ISO 4217)
+ * @llm-rule WHEN: Validating user-provided currency settings
+ * @llm-rule AVOID: Full ISO 4217 validation - basic pattern matching is sufficient
+ */
+function isValidCurrency(currency) {
+    // Basic currency pattern: 3 uppercase letters
+    const currencyPattern = /^[A-Z]{3}$/;
+    return currencyPattern.test(currency);
+}
+/**
+ * Creates utility error with helpful context
+ * @llm-rule WHEN: Creating errors in utility functions for better debugging
+ * @llm-rule AVOID: Using generic Error objects - utility errors need context
+ */
+export function createUtilityError(message, operation, input) {
+    const error = new Error(message);
+    if (operation) {
+        error.operation = operation;
+    }
+    if (input !== undefined) {
+        error.input = input;
+    }
+    return error;
+}
+/**
+ * Default configuration constants for reference
+ */
+export const DEFAULT_CACHE_SIZE = 1000;
+export const DEFAULT_CACHE_TTL = 300000; // 5 minutes
+export const DEFAULT_ARRAY_THRESHOLD = 10000;
+export const DEFAULT_CHUNK_LIMIT = 100000;
+export const DEFAULT_NUMBER_PRECISION = 2;
+export const DEFAULT_LOCALE = 'en-US';
+export const DEFAULT_CURRENCY = 'USD';
+export const DEFAULT_SLUGIFY_REPLACEMENT = '-';
+//# sourceMappingURL=defaults.js.map

package/dist/util/defaults.js.map

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

package/dist/util/index.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Ultra-simple utilities that just work
+ * @module @bloomneo/appkit/util
+ * @file src/util/index.ts
+ *
+ * @llm-rule WHEN: Building apps that need common utility functions (get, chunk, slugify, debounce, etc.)
+ * @llm-rule AVOID: Manual utility implementation - this provides tested, optimized functions with edge cases handled
+ * @llm-rule NOTE: Common pattern - utilclass.get() → util.get() → util.chunk() → util.slugify()
+ * @llm-rule NOTE: 12 essential utilities: get, isEmpty, slugify, chunk, debounce, pick, unique, clamp, formatBytes, truncate, sleep, uuid
+ */
+import { UtilClass } from './util.js';
+import { type UtilConfig } from './defaults.js';
+/**
+ * Get utility instance - the only function you need to learn
+ * Environment variables parsed once for performance
+ * @llm-rule WHEN: Starting any utility operation - this is your main entry point
+ * @llm-rule AVOID: Calling new UtilClass() directly - always use this function
+ * @llm-rule NOTE: Typical flow - get() → util.get() → util.chunk() → util.slugify()
+ */
+declare function get(overrides?: Partial<UtilConfig>): UtilClass;
+/**
+ * Reset global instance (useful for testing or config changes)
+ * @llm-rule WHEN: Testing utility logic with different configurations
+ * @llm-rule AVOID: Using in production - only for tests and development
+ */
+declare function reset(newConfig?: Partial<UtilConfig>): UtilClass;
+/**
+ * Clear the cached utility instance
+ * @llm-rule WHEN: Testing or when you need to reload environment variables
+ * @llm-rule AVOID: Using in production - only for tests and development
+ */
+declare function clearCache(): void;
+/**
+ * Get current utility configuration for inspection
+ * @llm-rule WHEN: Debugging utility behavior or documenting utility configuration
+ * @llm-rule AVOID: Using for runtime utility decisions - use get() instead
+ */
+declare function getConfig(): UtilConfig;
+/**
+ * Check if running in development mode (affects utility logging)
+ * @llm-rule WHEN: Need to conditionally add debug information to utility operations
+ * @llm-rule AVOID: Manual NODE_ENV checks - use this for consistency
+ */
+declare function isDevelopment(): boolean;
+/**
+ * Check if running in production mode (affects utility performance optimizations)
+ * @llm-rule WHEN: Need to conditionally enable performance optimizations
+ * @llm-rule AVOID: Manual NODE_ENV checks - use this for consistency
+ */
+declare function isProduction(): boolean;
+/**
+ * Get utility status for health checks and monitoring
+ * @llm-rule WHEN: Building health check endpoints or utility monitoring
+ * @llm-rule AVOID: Exposing internal utility details - this only shows availability
+ */
+declare function getStatus(): {
+    cacheEnabled: boolean;
+    performance: boolean;
+    environment: string;
+    version: string;
+};
+/**
+ * Quick utility setup helper for common patterns
+ * @llm-rule WHEN: Setting up utilities with custom configuration quickly
+ * @llm-rule AVOID: Using without understanding - review configuration for your needs
+ * @llm-rule NOTE: Returns utility instance with optimized settings for common use cases
+ */
+declare function quickSetup(options?: {
+    performance?: boolean;
+    cache?: boolean;
+    debug?: boolean;
+}): UtilClass;
+/**
+ * Validate utility configuration at startup
+ * @llm-rule WHEN: App startup to ensure utility config is valid
+ * @llm-rule AVOID: Using in request handlers - expensive validation
+ * @llm-rule NOTE: Validates performance settings and cache configuration
+ */
+declare function validateConfig(): void;
+/**
+ * Single utility export with enhanced functionality
+ */
+export declare const utilClass: {
+    readonly get: typeof get;
+    readonly reset: typeof reset;
+    readonly clearCache: typeof clearCache;
+    readonly getConfig: typeof getConfig;
+    readonly isDevelopment: typeof isDevelopment;
+    readonly isProduction: typeof isProduction;
+    readonly quickSetup: typeof quickSetup;
+    readonly validateConfig: typeof validateConfig;
+    readonly getStatus: typeof getStatus;
+};
+export type { UtilConfig } from './defaults.js';
+export type { GetOptions, ChunkOptions, TruncateOptions, DebounceOptions, FormatBytesOptions, SlugifyOptions, } from './util.js';
+export { UtilClass } from './util.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/util/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAKlE;;;;;;GAMG;AACH,iBAAS,GAAG,CAAC,SAAS,GAAE,OAAO,CAAC,UAAU,CAAM,GAAG,SAAS,CAS3D;AAED;;;;GAIG;AACH,iBAAS,KAAK,CAAC,SAAS,GAAE,OAAO,CAAC,UAAU,CAAM,GAAG,SAAS,CAK7D;AAED;;;;GAIG;AACH,iBAAS,UAAU,IAAI,IAAI,CAE1B;AAED;;;;GAIG;AACH,iBAAS,SAAS,IAAI,UAAU,CAG/B;AAED;;;;GAIG;AACH,iBAAS,aAAa,IAAI,OAAO,CAGhC;AAED;;;;GAIG;AACH,iBAAS,YAAY,IAAI,OAAO,CAG/B;AAED;;;;GAIG;AACH,iBAAS,SAAS,IAAI;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CASA;AAED;;;;;GAKG;AACH,iBAAS,UAAU,CAAC,OAAO,GAAE;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACZ,GAAG,SAAS,CA6BjB;AAED;;;;;GAKG;AACH,iBAAS,cAAc,IAAI,IAAI,CAkB9B;AAED;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;CAiBZ,CAAC;AAGX,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,YAAY,EACV,UAAU,EACV,YAAY,EACZ,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,cAAc,GACf,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/util/index.js

@@ -0,0 +1,165 @@
+/**
+ * Ultra-simple utilities that just work
+ * @module @bloomneo/appkit/util
+ * @file src/util/index.ts
+ *
+ * @llm-rule WHEN: Building apps that need common utility functions (get, chunk, slugify, debounce, etc.)
+ * @llm-rule AVOID: Manual utility implementation - this provides tested, optimized functions with edge cases handled
+ * @llm-rule NOTE: Common pattern - utilclass.get() → util.get() → util.chunk() → util.slugify()
+ * @llm-rule NOTE: 12 essential utilities: get, isEmpty, slugify, chunk, debounce, pick, unique, clamp, formatBytes, truncate, sleep, uuid
+ */
+import { UtilClass } from './util.js';
+import { getSmartDefaults } from './defaults.js';
+// Global utility instance for performance
+let globalUtility = null;
+/**
+ * Get utility instance - the only function you need to learn
+ * Environment variables parsed once for performance
+ * @llm-rule WHEN: Starting any utility operation - this is your main entry point
+ * @llm-rule AVOID: Calling new UtilClass() directly - always use this function
+ * @llm-rule NOTE: Typical flow - get() → util.get() → util.chunk() → util.slugify()
+ */
+function get(overrides = {}) {
+    // Lazy initialization - parse environment once
+    if (!globalUtility) {
+        const defaults = getSmartDefaults();
+        const config = { ...defaults, ...overrides };
+        globalUtility = new UtilClass(config);
+    }
+    return globalUtility;
+}
+/**
+ * Reset global instance (useful for testing or config changes)
+ * @llm-rule WHEN: Testing utility logic with different configurations
+ * @llm-rule AVOID: Using in production - only for tests and development
+ */
+function reset(newConfig = {}) {
+    const defaults = getSmartDefaults();
+    const config = { ...defaults, ...newConfig };
+    globalUtility = new UtilClass(config);
+    return globalUtility;
+}
+/**
+ * Clear the cached utility instance
+ * @llm-rule WHEN: Testing or when you need to reload environment variables
+ * @llm-rule AVOID: Using in production - only for tests and development
+ */
+function clearCache() {
+    globalUtility = null;
+}
+/**
+ * Get current utility configuration for inspection
+ * @llm-rule WHEN: Debugging utility behavior or documenting utility configuration
+ * @llm-rule AVOID: Using for runtime utility decisions - use get() instead
+ */
+function getConfig() {
+    const util = get();
+    return util.config;
+}
+/**
+ * Check if running in development mode (affects utility logging)
+ * @llm-rule WHEN: Need to conditionally add debug information to utility operations
+ * @llm-rule AVOID: Manual NODE_ENV checks - use this for consistency
+ */
+function isDevelopment() {
+    const config = getConfig();
+    return config.environment.isDevelopment;
+}
+/**
+ * Check if running in production mode (affects utility performance optimizations)
+ * @llm-rule WHEN: Need to conditionally enable performance optimizations
+ * @llm-rule AVOID: Manual NODE_ENV checks - use this for consistency
+ */
+function isProduction() {
+    const config = getConfig();
+    return config.environment.isProduction;
+}
+/**
+ * Get utility status for health checks and monitoring
+ * @llm-rule WHEN: Building health check endpoints or utility monitoring
+ * @llm-rule AVOID: Exposing internal utility details - this only shows availability
+ */
+function getStatus() {
+    const config = getConfig();
+    return {
+        cacheEnabled: config.cache.enabled,
+        performance: config.performance.enabled,
+        environment: config.environment.nodeEnv,
+        version: config.version,
+    };
+}
+/**
+ * Quick utility setup helper for common patterns
+ * @llm-rule WHEN: Setting up utilities with custom configuration quickly
+ * @llm-rule AVOID: Using without understanding - review configuration for your needs
+ * @llm-rule NOTE: Returns utility instance with optimized settings for common use cases
+ */
+function quickSetup(options = {}) {
+    const config = {};
+    if (options.performance !== undefined) {
+        config.performance = {
+            enabled: options.performance,
+            memoization: options.performance,
+            largeArrayThreshold: 10000,
+            chunkSizeLimit: 100000
+        };
+    }
+    if (options.cache !== undefined) {
+        config.cache = {
+            enabled: options.cache,
+            maxSize: 1000,
+            ttl: 300000
+        };
+    }
+    if (options.debug !== undefined) {
+        config.debug = {
+            enabled: options.debug,
+            logOperations: options.debug,
+            trackPerformance: options.debug
+        };
+    }
+    return get(config);
+}
+/**
+ * Validate utility configuration at startup
+ * @llm-rule WHEN: App startup to ensure utility config is valid
+ * @llm-rule AVOID: Using in request handlers - expensive validation
+ * @llm-rule NOTE: Validates performance settings and cache configuration
+ */
+function validateConfig() {
+    try {
+        const config = getConfig();
+        // Basic validation
+        if (!config.version) {
+            throw new Error('Utility version is required');
+        }
+        if (!config.environment.nodeEnv) {
+            throw new Error('NODE_ENV is required');
+        }
+        console.log('✅ Utility configuration validation passed');
+    }
+    catch (error) {
+        console.error('❌ Utility configuration validation failed:', error.message);
+        throw error;
+    }
+}
+/**
+ * Single utility export with enhanced functionality
+ */
+export const utilClass = {
+    // Core method
+    get,
+    // Utility methods
+    reset,
+    clearCache,
+    getConfig,
+    // Environment helpers
+    isDevelopment,
+    isProduction,
+    // Utility helpers
+    quickSetup,
+    validateConfig,
+    getStatus,
+};
+export { UtilClass } from './util.js';
+//# sourceMappingURL=index.js.map

package/dist/util/index.js.map

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

package/dist/util/util.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Core utility class with 12 essential JavaScript functions
+ * @module @bloomneo/appkit/util
+ * @file src/util/util.ts
+ *
+ * @llm-rule WHEN: Building apps that need common utility functions (get, chunk, slugify, debounce, etc.)
+ * @llm-rule AVOID: Using directly - always get instance via utilClass.get()
+ * @llm-rule NOTE: Provides 12 essential utilities: get, isEmpty, slugify, chunk, debounce, pick, unique, clamp, formatBytes, truncate, sleep, uuid
+ */
+import type { UtilConfig } from './defaults.js';
+export interface GetOptions {
+    strict?: boolean;
+    throwOnMissing?: boolean;
+}
+export interface ChunkOptions {
+    fillIncomplete?: boolean;
+    fillValue?: any;
+}
+export interface TruncateOptions {
+    length: number;
+    suffix?: string;
+    separator?: string;
+    preserveWords?: boolean;
+}
+export interface DebounceOptions {
+    leading?: boolean;
+    trailing?: boolean;
+    maxWait?: number;
+}
+export interface FormatBytesOptions {
+    decimals?: number;
+    binary?: boolean;
+    unitSeparator?: string;
+}
+export interface SlugifyOptions {
+    replacement?: string;
+    lowercase?: boolean;
+    strict?: boolean;
+    locale?: string;
+}
+/**
+ * Utility class with 12 essential JavaScript functions
+ */
+export declare class UtilClass {
+    config: UtilConfig;
+    private memoCache;
+    private debounceCache;
+    constructor(config: UtilConfig);
+    /**
+     * Safe property access with dot notation and array indexing
+     * @llm-rule WHEN: Accessing nested object properties safely to prevent "Cannot read property of undefined" errors
+     * @llm-rule AVOID: Direct property access on potentially undefined objects - always use this for nested access
+     * @llm-rule NOTE: Supports array indexing, optional chaining syntax, and type-safe defaults
+     */
+    get<T = any>(obj: any, path: string, defaultValue?: T, options?: GetOptions): T;
+    /**
+     * Universal empty check for all JavaScript values
+     * @llm-rule WHEN: Validating if any value is truly empty (null, undefined, {}, [], "", whitespace-only strings)
+     * @llm-rule AVOID: Manual empty checks like !value - this handles all edge cases properly
+     * @llm-rule NOTE: Returns true for null, undefined, {}, [], "", "   ", false for 0 and false
+     */
+    isEmpty(value: any): boolean;
+    /**
+     * Convert text to URL-safe slugs
+     * @llm-rule WHEN: Creating URLs, filenames, or IDs from user text input
+     * @llm-rule AVOID: Manual string replacement - this handles unicode, special characters, and edge cases
+     * @llm-rule NOTE: Converts "Hello World! 123" to "hello-world-123", handles accents and special characters
+     */
+    slugify(text: string, options?: SlugifyOptions): string;
+    /**
+     * Split array into smaller chunks of specified size
+     * @llm-rule WHEN: Processing large arrays in batches, creating pagination, or organizing data into grids
+     * @llm-rule AVOID: Manual array slicing - this handles edge cases and provides consistent behavior
+     * @llm-rule NOTE: chunk([1,2,3,4,5], 2) returns [[1,2], [3,4], [5]], handles empty arrays safely
+     */
+    chunk<T>(array: T[], size: number, options?: ChunkOptions): T[][];
+    /**
+     * Debounce function calls to prevent excessive execution
+     * @llm-rule WHEN: Handling user input events (search, resize, scroll) to optimize performance
+     * @llm-rule AVOID: Manual setTimeout management - this handles cleanup and edge cases properly
+     * @llm-rule NOTE: Delays function execution until after specified wait period, cancels previous calls
+     */
+    debounce<T extends (...args: any[]) => any>(func: T, wait: number, options?: DebounceOptions): T & {
+        cancel: () => void;
+        flush: () => any;
+    };
+    /**
+     * Extract specific properties from an object
+     * @llm-rule WHEN: Cleaning API responses, extracting specific data, or creating object subsets
+     * @llm-rule AVOID: Manual property extraction - this handles nested keys and edge cases
+     * @llm-rule NOTE: pick(user, ['id', 'name', 'email']) returns object with only specified properties
+     */
+    pick<T extends object, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+    /**
+     * Remove duplicate values from array
+     * @llm-rule WHEN: Cleaning arrays with duplicate values, creating unique lists
+     * @llm-rule AVOID: Manual duplicate removal - this is optimized and handles all value types
+     * @llm-rule NOTE: Uses Set for performance, handles primitives and object references
+     */
+    unique<T>(array: T[]): T[];
+    /**
+     * Constrain number within specified bounds
+     * @llm-rule WHEN: Validating user input, constraining values for UI controls (volume, opacity, progress)
+     * @llm-rule AVOID: Manual min/max checking - this handles edge cases and type conversion
+     * @llm-rule NOTE: clamp(150, 0, 100) returns 100, clamp(-10, 0, 100) returns 0
+     */
+    clamp(value: number, min: number, max: number): number;
+    /**
+     * Format byte sizes in human-readable format
+     * @llm-rule WHEN: Displaying file sizes, memory usage, or data transfer amounts
+     * @llm-rule AVOID: Manual byte formatting - this handles all units and edge cases properly
+     * @llm-rule NOTE: formatBytes(1024) returns "1 KB", formatBytes(0) returns "0 Bytes"
+     */
+    formatBytes(bytes: number, options?: FormatBytesOptions): string;
+    /**
+     * Truncate text with intelligent word boundary detection
+     * @llm-rule WHEN: Displaying text previews, card descriptions, or mobile content
+     * @llm-rule AVOID: Simple string.slice() - this preserves words and handles edge cases
+     * @llm-rule NOTE: truncate("Hello World", 8) returns "Hello...", respects word boundaries
+     */
+    truncate(text: string, options: TruncateOptions): string;
+    /**
+     * Promise-based sleep function for async delays
+     * @llm-rule WHEN: Adding delays in async functions, rate limiting, or animation timing
+     * @llm-rule AVOID: setTimeout in async/await contexts - this provides clean Promise-based delays
+     * @llm-rule NOTE: await sleep(1000) pauses execution for 1 second without blocking the event loop
+     */
+    sleep(ms: number): Promise<void>;
+    /**
+     * Generate RFC4122 version 4 UUID
+     * @llm-rule WHEN: Creating unique identifiers for sessions, temporary keys, or object IDs
+     * @llm-rule AVOID: Manual ID generation - this provides cryptographically secure UUIDs
+     * @llm-rule NOTE: Returns standard UUID format: "f47ac10b-58cc-4372-a567-0e02b2c3d479"
+     */
+    uuid(): string;
+    /**
+     * Parse object path with dot notation and array indexing
+     */
+    private parsePath;
+    /**
+     * Setup automatic cache cleanup
+     */
+    private setupCacheCleanup;
+}
+//# sourceMappingURL=util.d.ts.map

package/dist/util/util.d.ts.map

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