utilitify-core 1.0.0

package/dist/form/index.cjs

@@ -0,0 +1,81 @@
+'use strict';
+
+var chunkZLMPRPCY_cjs = require('../chunk-ZLMPRPCY.cjs');
+require('../chunk-CZLDE2OZ.cjs');
+
+
+
+Object.defineProperty(exports, "createErrorMessages", {
+  enumerable: true,
+  get: function () { return chunkZLMPRPCY_cjs.createErrorMessages; }
+});
+Object.defineProperty(exports, "errors", {
+  enumerable: true,
+  get: function () { return chunkZLMPRPCY_cjs.errors; }
+});
+Object.defineProperty(exports, "formatMessage", {
+  enumerable: true,
+  get: function () { return chunkZLMPRPCY_cjs.formatMessage; }
+});
+Object.defineProperty(exports, "formatValidationResult", {
+  enumerable: true,
+  get: function () { return chunkZLMPRPCY_cjs.formatValidationResult; }
+});
+Object.defineProperty(exports, "inRange", {
+  enumerable: true,
+  get: function () { return chunkZLMPRPCY_cjs.inRange; }
+});
+Object.defineProperty(exports, "isEmpty", {
+  enumerable: true,
+  get: function () { return chunkZLMPRPCY_cjs.isEmpty; }
+});
+Object.defineProperty(exports, "isPresent", {
+  enumerable: true,
+  get: function () { return chunkZLMPRPCY_cjs.isPresent; }
+});
+Object.defineProperty(exports, "matchesPattern", {
+  enumerable: true,
+  get: function () { return chunkZLMPRPCY_cjs.matchesPattern; }
+});
+Object.defineProperty(exports, "maxLength", {
+  enumerable: true,
+  get: function () { return chunkZLMPRPCY_cjs.maxLength; }
+});
+Object.defineProperty(exports, "minLength", {
+  enumerable: true,
+  get: function () { return chunkZLMPRPCY_cjs.minLength; }
+});
+Object.defineProperty(exports, "mustMatch", {
+  enumerable: true,
+  get: function () { return chunkZLMPRPCY_cjs.mustMatch; }
+});
+Object.defineProperty(exports, "oneOf", {
+  enumerable: true,
+  get: function () { return chunkZLMPRPCY_cjs.oneOf; }
+});
+Object.defineProperty(exports, "requireAllOrNone", {
+  enumerable: true,
+  get: function () { return chunkZLMPRPCY_cjs.requireAllOrNone; }
+});
+Object.defineProperty(exports, "requireOneOf", {
+  enumerable: true,
+  get: function () { return chunkZLMPRPCY_cjs.requireOneOf; }
+});
+Object.defineProperty(exports, "required", {
+  enumerable: true,
+  get: function () { return chunkZLMPRPCY_cjs.required; }
+});
+Object.defineProperty(exports, "requiredIf", {
+  enumerable: true,
+  get: function () { return chunkZLMPRPCY_cjs.requiredIf; }
+});
+Object.defineProperty(exports, "requiredUnless", {
+  enumerable: true,
+  get: function () { return chunkZLMPRPCY_cjs.requiredUnless; }
+});
+Object.defineProperty(exports, "validateConditional", {
+  enumerable: true,
+  get: function () { return chunkZLMPRPCY_cjs.validateConditional; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/form/index.cjs.map

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

package/dist/form/index.d.cts

@@ -0,0 +1,227 @@
+import { I as IValidationError } from '../common-CBDYNJeh.cjs';
+
+/**
+ * Check if field is required and present
+ *
+ * @param value - Value to check
+ * @param fieldName - Field name for error
+ * @returns Validation error or null
+ */
+declare function required(value: unknown, fieldName: string): IValidationError | null;
+/**
+ * Check if value meets minimum length
+ *
+ * @param value - Value to check
+ * @param min - Minimum length
+ * @param fieldName - Field name for error
+ * @returns Validation error or null
+ */
+declare function minLength(value: string | unknown[], min: number, fieldName: string): IValidationError | null;
+/**
+ * Check if value meets maximum length
+ *
+ * @param value - Value to check
+ * @param max - Maximum length
+ * @param fieldName - Field name for error
+ * @returns Validation error or null
+ */
+declare function maxLength(value: string | unknown[], max: number, fieldName: string): IValidationError | null;
+/**
+ * Check if value is within range
+ *
+ * @param value - Value to check
+ * @param min - Minimum value
+ * @param max - Maximum value
+ * @param fieldName - Field name for error
+ * @returns Validation error or null
+ */
+declare function inRange(value: number, min: number, max: number, fieldName: string): IValidationError | null;
+/**
+ * Check if value matches pattern
+ *
+ * @param value - Value to check
+ * @param pattern - RegExp pattern
+ * @param fieldName - Field name for error
+ * @param message - Custom error message
+ * @returns Validation error or null
+ */
+declare function matchesPattern(value: string, pattern: RegExp, fieldName: string, message?: string): IValidationError | null;
+/**
+ * Check if value is one of allowed values
+ *
+ * @param value - Value to check
+ * @param allowedValues - Allowed values
+ * @param fieldName - Field name for error
+ * @returns Validation error or null
+ */
+declare function oneOf(value: unknown, allowedValues: unknown[], fieldName: string): IValidationError | null;
+/**
+ * Helper to check if value is present (truthy)
+ */
+declare function isPresent(value: unknown): boolean;
+/**
+ * Helper to check if value is empty
+ */
+declare function isEmpty(value: unknown): boolean;
+
+/**
+ * Conditional validation rule
+ */
+interface ConditionalRule<T> {
+    /** Field to check */
+    when: keyof T;
+    /** Condition to check */
+    is: unknown | ((value: unknown) => boolean);
+    /** Validation to run if condition is true */
+    then: (value: unknown, data: T) => IValidationError | null;
+    /** Validation to run if condition is false */
+    otherwise?: (value: unknown, data: T) => IValidationError | null;
+}
+/**
+ * Run conditional validation
+ *
+ * @param data - Full data object
+ * @param rule - Conditional rule
+ * @param value - Value being validated
+ * @returns Validation error or null
+ */
+declare function validateConditional<T extends object>(data: T, rule: ConditionalRule<T>, value: unknown): IValidationError | null;
+/**
+ * Require field if another field is present
+ *
+ * @param data - Full data object
+ * @param field - Field to validate
+ * @param dependsOn - Field this depends on
+ * @returns Validation error or null
+ */
+declare function requiredIf<T extends object>(data: T, field: keyof T, dependsOn: keyof T): IValidationError | null;
+/**
+ * Require field unless another field is present
+ *
+ * @param data - Full data object
+ * @param field - Field to validate
+ * @param unlessField - Field that makes this optional
+ * @returns Validation error or null
+ */
+declare function requiredUnless<T extends object>(data: T, field: keyof T, unlessField: keyof T): IValidationError | null;
+/**
+ * Require at least one of the specified fields
+ *
+ * @param data - Full data object
+ * @param fields - Fields to check
+ * @returns Validation error or null
+ */
+declare function requireOneOf<T extends object>(data: T, fields: (keyof T)[]): IValidationError | null;
+/**
+ * Require all or none of the specified fields
+ *
+ * @param data - Full data object
+ * @param fields - Fields to check
+ * @returns Validation error or null
+ */
+declare function requireAllOrNone<T extends object>(data: T, fields: (keyof T)[]): IValidationError | null;
+/**
+ * Field must match another field
+ *
+ * @param data - Full data object
+ * @param field - Field to validate
+ * @param matchField - Field to match
+ * @returns Validation error or null
+ */
+declare function mustMatch<T extends object>(data: T, field: keyof T, matchField: keyof T): IValidationError | null;
+
+/**
+ * Error message templates
+ */
+interface ErrorMessages {
+    required?: string;
+    minLength?: string;
+    maxLength?: string;
+    pattern?: string;
+    email?: string;
+    phone?: string;
+    url?: string;
+    numeric?: string;
+    alpha?: string;
+    alphanumeric?: string;
+    [key: string]: string | undefined;
+}
+/**
+ * Generate error message from template
+ *
+ * @param template - Message template
+ * @param params - Template parameters
+ * @returns Formatted message
+ */
+declare function formatMessage(template: string, params: Record<string, unknown>): string;
+/**
+ * Create error message generator
+ *
+ * @param customMessages - Custom message templates
+ * @returns Error message generator function
+ */
+declare function createErrorMessages(customMessages?: ErrorMessages): {
+    /**
+     * Get error message for code
+     */
+    getMessage(code: string, params?: Record<string, unknown>): string;
+    /**
+     * Create validation error
+     */
+    createError(field: string, code: string, params?: Record<string, unknown>): IValidationError;
+    /**
+     * Format multiple errors as object
+     */
+    formatErrors(errors: IValidationError[]): Record<string, string[]>;
+    /**
+     * Get first error for each field
+     */
+    getFirstErrors(errors: IValidationError[]): Record<string, string>;
+    /**
+     * Check if field has errors
+     */
+    hasError(errors: IValidationError[], field: string): boolean;
+    /**
+     * Get errors for specific field
+     */
+    getFieldErrors(errors: IValidationError[], field: string): string[];
+};
+/**
+ * Default error generator
+ */
+declare const errors: {
+    /**
+     * Get error message for code
+     */
+    getMessage(code: string, params?: Record<string, unknown>): string;
+    /**
+     * Create validation error
+     */
+    createError(field: string, code: string, params?: Record<string, unknown>): IValidationError;
+    /**
+     * Format multiple errors as object
+     */
+    formatErrors(errors: IValidationError[]): Record<string, string[]>;
+    /**
+     * Get first error for each field
+     */
+    getFirstErrors(errors: IValidationError[]): Record<string, string>;
+    /**
+     * Check if field has errors
+     */
+    hasError(errors: IValidationError[], field: string): boolean;
+    /**
+     * Get errors for specific field
+     */
+    getFieldErrors(errors: IValidationError[], field: string): string[];
+};
+/**
+ * Format validation result for display
+ *
+ * @param errors - Validation errors
+ * @param format - Output format
+ * @returns Formatted errors
+ */
+declare function formatValidationResult(validationErrors: IValidationError[], format?: 'object' | 'array' | 'flat'): Record<string, string[]> | IValidationError[] | string[];
+
+export { type ConditionalRule, type ErrorMessages, createErrorMessages, errors, formatMessage, formatValidationResult, inRange, isEmpty, isPresent, matchesPattern, maxLength, minLength, mustMatch, oneOf, requireAllOrNone, requireOneOf, required, requiredIf, requiredUnless, validateConditional };

package/dist/form/index.d.ts

@@ -0,0 +1,227 @@
+import { I as IValidationError } from '../common-CBDYNJeh.js';
+
+/**
+ * Check if field is required and present
+ *
+ * @param value - Value to check
+ * @param fieldName - Field name for error
+ * @returns Validation error or null
+ */
+declare function required(value: unknown, fieldName: string): IValidationError | null;
+/**
+ * Check if value meets minimum length
+ *
+ * @param value - Value to check
+ * @param min - Minimum length
+ * @param fieldName - Field name for error
+ * @returns Validation error or null
+ */
+declare function minLength(value: string | unknown[], min: number, fieldName: string): IValidationError | null;
+/**
+ * Check if value meets maximum length
+ *
+ * @param value - Value to check
+ * @param max - Maximum length
+ * @param fieldName - Field name for error
+ * @returns Validation error or null
+ */
+declare function maxLength(value: string | unknown[], max: number, fieldName: string): IValidationError | null;
+/**
+ * Check if value is within range
+ *
+ * @param value - Value to check
+ * @param min - Minimum value
+ * @param max - Maximum value
+ * @param fieldName - Field name for error
+ * @returns Validation error or null
+ */
+declare function inRange(value: number, min: number, max: number, fieldName: string): IValidationError | null;
+/**
+ * Check if value matches pattern
+ *
+ * @param value - Value to check
+ * @param pattern - RegExp pattern
+ * @param fieldName - Field name for error
+ * @param message - Custom error message
+ * @returns Validation error or null
+ */
+declare function matchesPattern(value: string, pattern: RegExp, fieldName: string, message?: string): IValidationError | null;
+/**
+ * Check if value is one of allowed values
+ *
+ * @param value - Value to check
+ * @param allowedValues - Allowed values
+ * @param fieldName - Field name for error
+ * @returns Validation error or null
+ */
+declare function oneOf(value: unknown, allowedValues: unknown[], fieldName: string): IValidationError | null;
+/**
+ * Helper to check if value is present (truthy)
+ */
+declare function isPresent(value: unknown): boolean;
+/**
+ * Helper to check if value is empty
+ */
+declare function isEmpty(value: unknown): boolean;
+
+/**
+ * Conditional validation rule
+ */
+interface ConditionalRule<T> {
+    /** Field to check */
+    when: keyof T;
+    /** Condition to check */
+    is: unknown | ((value: unknown) => boolean);
+    /** Validation to run if condition is true */
+    then: (value: unknown, data: T) => IValidationError | null;
+    /** Validation to run if condition is false */
+    otherwise?: (value: unknown, data: T) => IValidationError | null;
+}
+/**
+ * Run conditional validation
+ *
+ * @param data - Full data object
+ * @param rule - Conditional rule
+ * @param value - Value being validated
+ * @returns Validation error or null
+ */
+declare function validateConditional<T extends object>(data: T, rule: ConditionalRule<T>, value: unknown): IValidationError | null;
+/**
+ * Require field if another field is present
+ *
+ * @param data - Full data object
+ * @param field - Field to validate
+ * @param dependsOn - Field this depends on
+ * @returns Validation error or null
+ */
+declare function requiredIf<T extends object>(data: T, field: keyof T, dependsOn: keyof T): IValidationError | null;
+/**
+ * Require field unless another field is present
+ *
+ * @param data - Full data object
+ * @param field - Field to validate
+ * @param unlessField - Field that makes this optional
+ * @returns Validation error or null
+ */
+declare function requiredUnless<T extends object>(data: T, field: keyof T, unlessField: keyof T): IValidationError | null;
+/**
+ * Require at least one of the specified fields
+ *
+ * @param data - Full data object
+ * @param fields - Fields to check
+ * @returns Validation error or null
+ */
+declare function requireOneOf<T extends object>(data: T, fields: (keyof T)[]): IValidationError | null;
+/**
+ * Require all or none of the specified fields
+ *
+ * @param data - Full data object
+ * @param fields - Fields to check
+ * @returns Validation error or null
+ */
+declare function requireAllOrNone<T extends object>(data: T, fields: (keyof T)[]): IValidationError | null;
+/**
+ * Field must match another field
+ *
+ * @param data - Full data object
+ * @param field - Field to validate
+ * @param matchField - Field to match
+ * @returns Validation error or null
+ */
+declare function mustMatch<T extends object>(data: T, field: keyof T, matchField: keyof T): IValidationError | null;
+
+/**
+ * Error message templates
+ */
+interface ErrorMessages {
+    required?: string;
+    minLength?: string;
+    maxLength?: string;
+    pattern?: string;
+    email?: string;
+    phone?: string;
+    url?: string;
+    numeric?: string;
+    alpha?: string;
+    alphanumeric?: string;
+    [key: string]: string | undefined;
+}
+/**
+ * Generate error message from template
+ *
+ * @param template - Message template
+ * @param params - Template parameters
+ * @returns Formatted message
+ */
+declare function formatMessage(template: string, params: Record<string, unknown>): string;
+/**
+ * Create error message generator
+ *
+ * @param customMessages - Custom message templates
+ * @returns Error message generator function
+ */
+declare function createErrorMessages(customMessages?: ErrorMessages): {
+    /**
+     * Get error message for code
+     */
+    getMessage(code: string, params?: Record<string, unknown>): string;
+    /**
+     * Create validation error
+     */
+    createError(field: string, code: string, params?: Record<string, unknown>): IValidationError;
+    /**
+     * Format multiple errors as object
+     */
+    formatErrors(errors: IValidationError[]): Record<string, string[]>;
+    /**
+     * Get first error for each field
+     */
+    getFirstErrors(errors: IValidationError[]): Record<string, string>;
+    /**
+     * Check if field has errors
+     */
+    hasError(errors: IValidationError[], field: string): boolean;
+    /**
+     * Get errors for specific field
+     */
+    getFieldErrors(errors: IValidationError[], field: string): string[];
+};
+/**
+ * Default error generator
+ */
+declare const errors: {
+    /**
+     * Get error message for code
+     */
+    getMessage(code: string, params?: Record<string, unknown>): string;
+    /**
+     * Create validation error
+     */
+    createError(field: string, code: string, params?: Record<string, unknown>): IValidationError;
+    /**
+     * Format multiple errors as object
+     */
+    formatErrors(errors: IValidationError[]): Record<string, string[]>;
+    /**
+     * Get first error for each field
+     */
+    getFirstErrors(errors: IValidationError[]): Record<string, string>;
+    /**
+     * Check if field has errors
+     */
+    hasError(errors: IValidationError[], field: string): boolean;
+    /**
+     * Get errors for specific field
+     */
+    getFieldErrors(errors: IValidationError[], field: string): string[];
+};
+/**
+ * Format validation result for display
+ *
+ * @param errors - Validation errors
+ * @param format - Output format
+ * @returns Formatted errors
+ */
+declare function formatValidationResult(validationErrors: IValidationError[], format?: 'object' | 'array' | 'flat'): Record<string, string[]> | IValidationError[] | string[];
+
+export { type ConditionalRule, type ErrorMessages, createErrorMessages, errors, formatMessage, formatValidationResult, inRange, isEmpty, isPresent, matchesPattern, maxLength, minLength, mustMatch, oneOf, requireAllOrNone, requireOneOf, required, requiredIf, requiredUnless, validateConditional };

package/dist/form/index.js

@@ -0,0 +1,4 @@
+export { createErrorMessages, errors, formatMessage, formatValidationResult, inRange, isEmpty, isPresent, matchesPattern, maxLength, minLength, mustMatch, oneOf, requireAllOrNone, requireOneOf, required, requiredIf, requiredUnless, validateConditional } from '../chunk-JBN7C5WE.js';
+import '../chunk-4CV4JOE5.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/form/index.js.map

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

package/dist/i18n.cjs

@@ -0,0 +1,37 @@
+'use strict';
+
+var chunkG4GYQGTW_cjs = require('./chunk-G4GYQGTW.cjs');
+require('./chunk-CZLDE2OZ.cjs');
+
+
+
+Object.defineProperty(exports, "addLocale", {
+  enumerable: true,
+  get: function () { return chunkG4GYQGTW_cjs.addLocale; }
+});
+Object.defineProperty(exports, "getAvailableLocales", {
+  enumerable: true,
+  get: function () { return chunkG4GYQGTW_cjs.getAvailableLocales; }
+});
+Object.defineProperty(exports, "getLocale", {
+  enumerable: true,
+  get: function () { return chunkG4GYQGTW_cjs.getLocale; }
+});
+Object.defineProperty(exports, "getMessage", {
+  enumerable: true,
+  get: function () { return chunkG4GYQGTW_cjs.getMessage; }
+});
+Object.defineProperty(exports, "setCustomMessages", {
+  enumerable: true,
+  get: function () { return chunkG4GYQGTW_cjs.setCustomMessages; }
+});
+Object.defineProperty(exports, "setLocale", {
+  enumerable: true,
+  get: function () { return chunkG4GYQGTW_cjs.setLocale; }
+});
+Object.defineProperty(exports, "withLocalization", {
+  enumerable: true,
+  get: function () { return chunkG4GYQGTW_cjs.withLocalization; }
+});
+//# sourceMappingURL=i18n.cjs.map
+//# sourceMappingURL=i18n.cjs.map

package/dist/i18n.cjs.map

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

package/dist/i18n.d.cts

@@ -0,0 +1,102 @@
+/**
+ * Internationalization (i18n) module for Utilitify
+ * Provides multi-language error message support
+ *
+ * @packageDocumentation
+ * @since 1.0.0
+ */
+/**
+ * Supported locales
+ */
+type Locale = 'en' | 'es' | 'fr' | 'de' | 'ar' | 'zh' | 'ur' | 'hi';
+/**
+ * Error message templates
+ */
+interface MessageTemplates {
+    required: string;
+    invalid: string;
+    tooShort: string;
+    tooLong: string;
+    emailInvalid: string;
+    emailDisposable: string;
+    emailDomainBlocked: string;
+    phoneInvalid: string;
+    phoneTooShort: string;
+    phoneTooLong: string;
+    phoneMobileOnly: string;
+    passwordTooWeak: string;
+    passwordNoUppercase: string;
+    passwordNoLowercase: string;
+    passwordNoNumber: string;
+    passwordNoSymbol: string;
+    passwordCommonPattern: string;
+    nameInvalid: string;
+    nameContainsNumbers: string;
+    usernameReserved: string;
+    usernameInvalidChars: string;
+    urlInvalid: string;
+    urlDangerous: string;
+    cardInvalid: string;
+    cardExpired: string;
+    cardCvvInvalid: string;
+}
+/**
+ * Set the current locale
+ *
+ * @param locale - Locale to set
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * import { setLocale } from 'utilitify/i18n';
+ * setLocale('es'); // Switch to Spanish
+ * ```
+ */
+declare function setLocale(locale: Locale): void;
+/**
+ * Get the current locale
+ */
+declare function getLocale(): Locale;
+/**
+ * Get a translated message
+ *
+ * @param key - Message key
+ * @param params - Parameters to interpolate
+ * @returns Translated message
+ * @since 1.0.0
+ */
+declare function getMessage(key: keyof MessageTemplates, params?: Record<string, string | number>): string;
+/**
+ * Set custom messages
+ *
+ * @param messages - Custom message overrides
+ * @since 1.0.0
+ */
+declare function setCustomMessages(messages: Partial<MessageTemplates>): void;
+/**
+ * Add a new locale
+ *
+ * @param locale - Locale code
+ * @param messages - Message templates
+ * @since 1.0.0
+ */
+declare function addLocale(locale: string, messages: MessageTemplates): void;
+/**
+ * Get all available locales
+ */
+declare function getAvailableLocales(): Locale[];
+/**
+ * Create a localized validator wrapper
+ *
+ * @param validator - Original validator function
+ * @returns Localized validator
+ * @since 1.0.0
+ */
+declare function withLocalization<T extends (...args: unknown[]) => {
+    errors: Array<{
+        code: string;
+        message: string;
+    }>;
+}>(validator: T): T;
+
+export { type Locale, type MessageTemplates, addLocale, getAvailableLocales, getLocale, getMessage, setCustomMessages, setLocale, withLocalization };