utilitify-core 1.0.0

package/dist/date/index.d.ts

@@ -0,0 +1,283 @@
+/**
+ * Age calculation result
+ */
+interface AgeResult {
+    years: number;
+    months: number;
+    days: number;
+    totalDays: number;
+    isAdult: boolean;
+    isSenior: boolean;
+}
+/**
+ * Calculate age from date of birth
+ *
+ * @param dob - Date of birth
+ * @param referenceDate - Reference date (default: now)
+ * @returns Age details
+ *
+ * @example
+ * ```typescript
+ * calculateAge('1990-05-15'); // { years: 35, months: 7, days: 26, ... }
+ * calculateAge(new Date('2000-01-01')); // { years: 26, ... }
+ * ```
+ */
+declare function calculateAge(dob: Date | string, referenceDate?: Date): AgeResult;
+/**
+ * Get age in years
+ *
+ * @param dob - Date of birth
+ * @returns Age in years
+ */
+declare function getAgeInYears(dob: Date | string): number;
+/**
+ * Check if person is adult
+ *
+ * @param dob - Date of birth
+ * @param minAge - Minimum adult age (default: 18)
+ * @returns true if adult
+ */
+declare function isAdult(dob: Date | string, minAge?: number): boolean;
+/**
+ * Check if person is minor
+ *
+ * @param dob - Date of birth
+ * @param adultAge - Adult age threshold (default: 18)
+ * @returns true if minor
+ */
+declare function isMinor(dob: Date | string, adultAge?: number): boolean;
+/**
+ * Get age bracket/category
+ *
+ * @param dob - Date of birth
+ * @returns Age bracket name
+ */
+declare function getAgeBracket(dob: Date | string): string;
+/**
+ * Get date of birth required for minimum age
+ *
+ * @param minAge - Minimum age required
+ * @returns Date of birth that would make someone exactly that age today
+ */
+declare function getMinAgeDOB(minAge: number): Date;
+/**
+ * Validate age is within range
+ *
+ * @param dob - Date of birth
+ * @param minAge - Minimum age
+ * @param maxAge - Maximum age
+ * @returns true if age is within range
+ */
+declare function isAgeInRange(dob: Date | string, minAge: number, maxAge: number): boolean;
+
+/**
+ * Format options for dates
+ */
+interface DateFormatOptions {
+    /** Date style */
+    dateStyle?: 'full' | 'long' | 'medium' | 'short';
+    /** Time style */
+    timeStyle?: 'full' | 'long' | 'medium' | 'short';
+    /** Include time */
+    includeTime?: boolean;
+    /** Timezone */
+    timeZone?: string;
+}
+/**
+ * Format date by locale
+ *
+ * @param date - Date to format
+ * @param locale - Locale code (e.g., 'en-US', 'de-DE')
+ * @param options - Format options
+ * @returns Formatted date string
+ *
+ * @example
+ * ```typescript
+ * formatDateByLocale(new Date(), 'en-US'); // 'January 11, 2026'
+ * formatDateByLocale(new Date(), 'de-DE'); // '11. Januar 2026'
+ * ```
+ */
+declare function formatDateByLocale(date: Date | string, locale?: string, options?: DateFormatOptions): string;
+/**
+ * Format relative time (e.g., "2 hours ago", "in 3 days")
+ *
+ * @param date - Date to compare
+ * @param locale - Locale code
+ * @param referenceDate - Reference date (default: now)
+ * @returns Relative time string
+ *
+ * @example
+ * ```typescript
+ * formatRelativeTime(new Date(Date.now() - 3600000)); // '1 hour ago'
+ * formatRelativeTime(new Date(Date.now() + 86400000)); // 'in 1 day'
+ * ```
+ */
+declare function formatRelativeTime(date: Date | string, locale?: string, referenceDate?: Date): string;
+/**
+ * Format date as ISO string (date only)
+ *
+ * @param date - Date to format
+ * @returns ISO date string (YYYY-MM-DD)
+ */
+declare function toISODate(date: Date | string): string;
+/**
+ * Format date to common patterns
+ */
+declare function formatDate(date: Date | string, pattern: string): string;
+
+/**
+ * Check if a value is a valid date
+ *
+ * @param date - Value to check
+ * @returns true if valid date
+ */
+declare function isValidDate(date: unknown): boolean;
+/**
+ * Parse date from various formats
+ *
+ * @param value - Value to parse
+ * @returns Date or null
+ *
+ * @example
+ * ```typescript
+ * parseDate('2024-01-15');           // ISO format
+ * parseDate('15/01/2024');           // DD/MM/YYYY
+ * parseDate('01-15-2024');           // MM-DD-YYYY
+ * parseDate('2024/01/15');           // YYYY/MM/DD
+ * parseDate('2024-01-15T10:30:00Z'); // ISO 8601
+ * ```
+ */
+declare function parseDate(value: unknown): Date | null;
+/**
+ * Check if date is in the past
+ *
+ * @param date - Date to check
+ * @returns true if in the past
+ */
+declare function isInPast(date: Date | string): boolean;
+/**
+ * Check if date is in the future
+ *
+ * @param date - Date to check
+ * @returns true if in the future
+ */
+declare function isInFuture(date: Date | string): boolean;
+/**
+ * Check if date is today
+ *
+ * @param date - Date to check
+ * @returns true if today
+ */
+declare function isToday(date: Date | string): boolean;
+/**
+ * Check if date is a weekend
+ *
+ * @param date - Date to check
+ * @returns true if Saturday or Sunday
+ */
+declare function isWeekend(date: Date | string): boolean;
+/**
+ * Check if date is a weekday
+ *
+ * @param date - Date to check
+ * @returns true if Monday-Friday
+ */
+declare function isWeekday(date: Date | string): boolean;
+/**
+ * Check if year is a leap year
+ *
+ * @param year - Year to check
+ * @returns true if leap year
+ */
+declare function isLeapYear(year: number): boolean;
+/**
+ * Get number of days in a month
+ *
+ * @param year - Year
+ * @param month - Month (1-12)
+ * @returns Number of days
+ */
+declare function getDaysInMonth(year: number, month: number): number;
+/**
+ * Check if date is between two dates
+ *
+ * @param date - Date to check
+ * @param start - Start date
+ * @param end - End date
+ * @param inclusive - Include start and end dates
+ * @returns true if date is between
+ */
+declare function isBetween(date: Date | string, start: Date | string, end: Date | string, inclusive?: boolean): boolean;
+
+/**
+ * Time difference result
+ */
+interface TimeDiff {
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+    totalDays: number;
+    totalHours: number;
+    totalMinutes: number;
+    totalSeconds: number;
+    totalMilliseconds: number;
+    isPast: boolean;
+}
+/**
+ * Calculate difference between two dates
+ *
+ * @param date1 - First date
+ * @param date2 - Second date (default: now)
+ * @returns Time difference
+ */
+declare function getTimeDiff(date1: Date | string, date2?: Date | string): TimeDiff;
+/**
+ * Get difference in specific unit
+ *
+ * @param date1 - First date
+ * @param date2 - Second date
+ * @param unit - Time unit
+ * @returns Difference in specified unit
+ */
+declare function diffIn(date1: Date | string, date2: Date | string, unit: 'years' | 'months' | 'weeks' | 'days' | 'hours' | 'minutes' | 'seconds'): number;
+/**
+ * Add time to date
+ *
+ * @param date - Base date
+ * @param amount - Amount to add
+ * @param unit - Time unit
+ * @returns New date
+ */
+declare function addTime(date: Date | string, amount: number, unit: 'years' | 'months' | 'weeks' | 'days' | 'hours' | 'minutes' | 'seconds'): Date;
+/**
+ * Subtract time from date
+ *
+ * @param date - Base date
+ * @param amount - Amount to subtract
+ * @param unit - Time unit
+ * @returns New date
+ */
+declare function subtractTime(date: Date | string, amount: number, unit: 'years' | 'months' | 'weeks' | 'days' | 'hours' | 'minutes' | 'seconds'): Date;
+/**
+ * Get start of time period
+ *
+ * @param date - Date
+ * @param unit - Time unit
+ * @returns Start of period
+ */
+declare function startOf(date: Date | string, unit: 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute'): Date;
+/**
+ * Get end of time period
+ *
+ * @param date - Date
+ * @param unit - Time unit
+ * @returns End of period
+ */
+declare function endOf(date: Date | string, unit: 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute'): Date;
+
+export { type AgeResult, type DateFormatOptions, type TimeDiff, addTime, calculateAge, diffIn, endOf, formatDate, formatDateByLocale, formatRelativeTime, getAgeBracket, getAgeInYears, getDaysInMonth, getMinAgeDOB, getTimeDiff, isAdult, isAgeInRange, isBetween, isInFuture, isInPast, isLeapYear, isMinor, isToday, isValidDate, isWeekday, isWeekend, parseDate, startOf, subtractTime, toISODate };

package/dist/date/index.js

@@ -0,0 +1,4 @@
+export { addTime, calculateAge, diffIn, endOf, formatDate, formatDateByLocale, formatRelativeTime, getAgeBracket, getAgeInYears, getDaysInMonth, getMinAgeDOB, getTimeDiff, isAdult, isAgeInRange, isBetween, isInFuture, isInPast, isLeapYear, isMinor, isToday, isValidDate, isWeekday, isWeekend, parseDate, startOf, subtractTime, toISODate } from '../chunk-YSCHP26P.js';
+import '../chunk-4CV4JOE5.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/date/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/environment/index.cjs

@@ -0,0 +1,73 @@
+'use strict';
+
+var chunkDSMB6AF6_cjs = require('../chunk-DSMB6AF6.cjs');
+require('../chunk-CZLDE2OZ.cjs');
+
+
+
+Object.defineProperty(exports, "detectClient", {
+  enumerable: true,
+  get: function () { return chunkDSMB6AF6_cjs.detectClient; }
+});
+Object.defineProperty(exports, "getEnv", {
+  enumerable: true,
+  get: function () { return chunkDSMB6AF6_cjs.getEnv; }
+});
+Object.defineProperty(exports, "getEnvBoolean", {
+  enumerable: true,
+  get: function () { return chunkDSMB6AF6_cjs.getEnvBoolean; }
+});
+Object.defineProperty(exports, "getEnvNumber", {
+  enumerable: true,
+  get: function () { return chunkDSMB6AF6_cjs.getEnvNumber; }
+});
+Object.defineProperty(exports, "getRequiredEnv", {
+  enumerable: true,
+  get: function () { return chunkDSMB6AF6_cjs.getRequiredEnv; }
+});
+Object.defineProperty(exports, "getScreenSize", {
+  enumerable: true,
+  get: function () { return chunkDSMB6AF6_cjs.getScreenSize; }
+});
+Object.defineProperty(exports, "isBrowser", {
+  enumerable: true,
+  get: function () { return chunkDSMB6AF6_cjs.isBrowser; }
+});
+Object.defineProperty(exports, "isDevelopment", {
+  enumerable: true,
+  get: function () { return chunkDSMB6AF6_cjs.isDevelopment; }
+});
+Object.defineProperty(exports, "isMobile", {
+  enumerable: true,
+  get: function () { return chunkDSMB6AF6_cjs.isMobile; }
+});
+Object.defineProperty(exports, "isNode", {
+  enumerable: true,
+  get: function () { return chunkDSMB6AF6_cjs.isNode; }
+});
+Object.defineProperty(exports, "isProduction", {
+  enumerable: true,
+  get: function () { return chunkDSMB6AF6_cjs.isProduction; }
+});
+Object.defineProperty(exports, "isTest", {
+  enumerable: true,
+  get: function () { return chunkDSMB6AF6_cjs.isTest; }
+});
+Object.defineProperty(exports, "isTouchDevice", {
+  enumerable: true,
+  get: function () { return chunkDSMB6AF6_cjs.isTouchDevice; }
+});
+Object.defineProperty(exports, "prefersDarkMode", {
+  enumerable: true,
+  get: function () { return chunkDSMB6AF6_cjs.prefersDarkMode; }
+});
+Object.defineProperty(exports, "prefersReducedMotion", {
+  enumerable: true,
+  get: function () { return chunkDSMB6AF6_cjs.prefersReducedMotion; }
+});
+Object.defineProperty(exports, "validateEnv", {
+  enumerable: true,
+  get: function () { return chunkDSMB6AF6_cjs.validateEnv; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/environment/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/environment/index.d.cts

@@ -0,0 +1,127 @@
+/**
+ * Browser/OS detection result
+ */
+interface ClientInfo {
+    browser: {
+        name: string;
+        version: string;
+    };
+    os: {
+        name: string;
+        version: string;
+    };
+    device: 'desktop' | 'mobile' | 'tablet' | 'unknown';
+    isMobile: boolean;
+    isTablet: boolean;
+    isDesktop: boolean;
+}
+/**
+ * Detect browser and OS from user agent
+ *
+ * @param userAgent - User agent string (defaults to navigator.userAgent)
+ * @returns Client information
+ */
+declare function detectClient(userAgent?: string): ClientInfo;
+/**
+ * Check if running in browser
+ */
+declare function isBrowser(): boolean;
+/**
+ * Check if running in Node.js
+ */
+declare function isNode(): boolean;
+/**
+ * Check if running on mobile
+ */
+declare function isMobile(userAgent?: string): boolean;
+/**
+ * Check if touch device
+ */
+declare function isTouchDevice(): boolean;
+/**
+ * Get screen size category
+ */
+declare function getScreenSize(): 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'unknown';
+/**
+ * Check if user prefers dark mode
+ */
+declare function prefersDarkMode(): boolean;
+/**
+ * Check if user prefers reduced motion
+ */
+declare function prefersReducedMotion(): boolean;
+
+/**
+ * Environment variable validation result
+ */
+interface EnvValidationResult {
+    isValid: boolean;
+    missing: string[];
+    invalid: string[];
+    values: Record<string, string>;
+}
+/**
+ * Environment variable schema
+ */
+interface EnvSchema {
+    [key: string]: {
+        required?: boolean;
+        type?: 'string' | 'number' | 'boolean' | 'url' | 'email';
+        pattern?: RegExp;
+        default?: string;
+        transform?: (value: string) => unknown;
+    };
+}
+/**
+ * Get environment variable
+ *
+ * @param key - Variable name
+ * @param defaultValue - Default value if not found
+ * @returns Variable value
+ */
+declare function getEnv(key: string, defaultValue?: string): string | undefined;
+/**
+ * Get required environment variable
+ *
+ * @param key - Variable name
+ * @returns Variable value
+ * @throws Error if not found
+ */
+declare function getRequiredEnv(key: string): string;
+/**
+ * Get environment variable as number
+ *
+ * @param key - Variable name
+ * @param defaultValue - Default value
+ * @returns Parsed number
+ */
+declare function getEnvNumber(key: string, defaultValue?: number): number | undefined;
+/**
+ * Get environment variable as boolean
+ *
+ * @param key - Variable name
+ * @param defaultValue - Default value
+ * @returns Parsed boolean
+ */
+declare function getEnvBoolean(key: string, defaultValue?: boolean): boolean;
+/**
+ * Validate environment variables against schema
+ *
+ * @param schema - Validation schema
+ * @returns Validation result
+ */
+declare function validateEnv(schema: EnvSchema): EnvValidationResult;
+/**
+ * Check if in development mode
+ */
+declare function isDevelopment(): boolean;
+/**
+ * Check if in production mode
+ */
+declare function isProduction(): boolean;
+/**
+ * Check if in test mode
+ */
+declare function isTest(): boolean;
+
+export { type ClientInfo, type EnvSchema, type EnvValidationResult, detectClient, getEnv, getEnvBoolean, getEnvNumber, getRequiredEnv, getScreenSize, isBrowser, isDevelopment, isMobile, isNode, isProduction, isTest, isTouchDevice, prefersDarkMode, prefersReducedMotion, validateEnv };

package/dist/environment/index.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Browser/OS detection result
+ */
+interface ClientInfo {
+    browser: {
+        name: string;
+        version: string;
+    };
+    os: {
+        name: string;
+        version: string;
+    };
+    device: 'desktop' | 'mobile' | 'tablet' | 'unknown';
+    isMobile: boolean;
+    isTablet: boolean;
+    isDesktop: boolean;
+}
+/**
+ * Detect browser and OS from user agent
+ *
+ * @param userAgent - User agent string (defaults to navigator.userAgent)
+ * @returns Client information
+ */
+declare function detectClient(userAgent?: string): ClientInfo;
+/**
+ * Check if running in browser
+ */
+declare function isBrowser(): boolean;
+/**
+ * Check if running in Node.js
+ */
+declare function isNode(): boolean;
+/**
+ * Check if running on mobile
+ */
+declare function isMobile(userAgent?: string): boolean;
+/**
+ * Check if touch device
+ */
+declare function isTouchDevice(): boolean;
+/**
+ * Get screen size category
+ */
+declare function getScreenSize(): 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'unknown';
+/**
+ * Check if user prefers dark mode
+ */
+declare function prefersDarkMode(): boolean;
+/**
+ * Check if user prefers reduced motion
+ */
+declare function prefersReducedMotion(): boolean;
+
+/**
+ * Environment variable validation result
+ */
+interface EnvValidationResult {
+    isValid: boolean;
+    missing: string[];
+    invalid: string[];
+    values: Record<string, string>;
+}
+/**
+ * Environment variable schema
+ */
+interface EnvSchema {
+    [key: string]: {
+        required?: boolean;
+        type?: 'string' | 'number' | 'boolean' | 'url' | 'email';
+        pattern?: RegExp;
+        default?: string;
+        transform?: (value: string) => unknown;
+    };
+}
+/**
+ * Get environment variable
+ *
+ * @param key - Variable name
+ * @param defaultValue - Default value if not found
+ * @returns Variable value
+ */
+declare function getEnv(key: string, defaultValue?: string): string | undefined;
+/**
+ * Get required environment variable
+ *
+ * @param key - Variable name
+ * @returns Variable value
+ * @throws Error if not found
+ */
+declare function getRequiredEnv(key: string): string;
+/**
+ * Get environment variable as number
+ *
+ * @param key - Variable name
+ * @param defaultValue - Default value
+ * @returns Parsed number
+ */
+declare function getEnvNumber(key: string, defaultValue?: number): number | undefined;
+/**
+ * Get environment variable as boolean
+ *
+ * @param key - Variable name
+ * @param defaultValue - Default value
+ * @returns Parsed boolean
+ */
+declare function getEnvBoolean(key: string, defaultValue?: boolean): boolean;
+/**
+ * Validate environment variables against schema
+ *
+ * @param schema - Validation schema
+ * @returns Validation result
+ */
+declare function validateEnv(schema: EnvSchema): EnvValidationResult;
+/**
+ * Check if in development mode
+ */
+declare function isDevelopment(): boolean;
+/**
+ * Check if in production mode
+ */
+declare function isProduction(): boolean;
+/**
+ * Check if in test mode
+ */
+declare function isTest(): boolean;
+
+export { type ClientInfo, type EnvSchema, type EnvValidationResult, detectClient, getEnv, getEnvBoolean, getEnvNumber, getRequiredEnv, getScreenSize, isBrowser, isDevelopment, isMobile, isNode, isProduction, isTest, isTouchDevice, prefersDarkMode, prefersReducedMotion, validateEnv };

package/dist/environment/index.js

@@ -0,0 +1,4 @@
+export { detectClient, getEnv, getEnvBoolean, getEnvNumber, getRequiredEnv, getScreenSize, isBrowser, isDevelopment, isMobile, isNode, isProduction, isTest, isTouchDevice, prefersDarkMode, prefersReducedMotion, validateEnv } from '../chunk-HYADH4ZX.js';
+import '../chunk-4CV4JOE5.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/environment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}