@mdigitalcn/utils 2.0.0

package/dist/types/react/utils/clsx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clsx.d.ts","sourceRoot":"","sources":["../../../../src/react/utils/clsx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,MAAM,GACN,OAAO,GACP,SAAS,GACT,IAAI,GACJ,eAAe,GACf,UAAU,CAAC;AACf,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;AACzE,MAAM,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC;AAEtC,wBAAgB,IAAI,CAAC,GAAG,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,CAYlD;AAmCD,eAAe,IAAI,CAAC"}

package/dist/types/react/utils/createContext.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Creates a type-safe React context with a custom hook.
+ *
+ * @example
+ * const [ThemeProvider, useTheme] = createContext<{ theme: string }>('Theme');
+ *
+ * function App() {
+ *   return (
+ *     <ThemeProvider value={{ theme: 'dark' }}>
+ *       <Child />
+ *     </ThemeProvider>
+ *   );
+ * }
+ *
+ * function Child() {
+ *   const { theme } = useTheme(); // Type-safe!
+ *   return <div>{theme}</div>;
+ * }
+ *
+ * @param displayName - Display name for debugging
+ * @returns Tuple of [Provider, useContext hook]
+ */
+export declare function createContext<T>(displayName: string): [
+    React.Provider<T | undefined>,
+    () => T
+];
+//# sourceMappingURL=createContext.d.ts.map

package/dist/types/react/utils/createContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createContext.d.ts","sourceRoot":"","sources":["../../../../src/react/utils/createContext.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,WAAW,EAAE,MAAM,GAClB;IACD,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC;IAC7B,MAAM,CAAC;CACR,CAeA"}

package/dist/types/react/utils/displayField.d.ts

@@ -0,0 +1,18 @@
+import { ReactNode } from "react";
+/**
+ * Returns a display-safe value for UI rendering, substituting a placeholder
+ * for empty, null, or undefined fields. Numbers are always shown as-is.
+ *
+ * @example
+ * displayField(42)          // 42
+ * displayField(null)        // '-'
+ * displayField(undefined, 'N/A') // 'N/A'
+ * displayField('Hello')     // 'Hello'
+ * displayField('')          // '-'
+ *
+ * @param {string | number | ReactNode | null | undefined} field - The value to display
+ * @param {string | number} [placeholder='-'] - Fallback shown when field is empty/null/undefined
+ * @returns {string | number | ReactNode} The field value or the placeholder
+ */
+export declare const displayField: (field: string | number | ReactNode | null | undefined, placeholder?: string | number) => string | number | ReactNode;
+//# sourceMappingURL=displayField.d.ts.map

package/dist/types/react/utils/displayField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayField.d.ts","sourceRoot":"","sources":["../../../../src/react/utils/displayField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,YAAY,GACvB,OAAO,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,EACrD,cAAa,MAAM,GAAG,MAAY,KACjC,MAAM,GAAG,MAAM,GAAG,SAUpB,CAAC"}

package/dist/types/react/utils/index.d.ts

@@ -0,0 +1,5 @@
+export { clsx } from './clsx.js';
+export type { ClassValue, ClassDictionary, ClassArray } from './clsx.js';
+export { createContext } from './createContext.js';
+export { displayField } from './displayField.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/react/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/react/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/types/string/camelCase.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Converts a string to camelCase.
+ * Handles spaces, hyphens, underscores, and mixed casing.
+ *
+ * @example
+ * camelCase('hello world') // 'helloWorld'
+ * camelCase('foo-bar-baz') // 'fooBarBaz'
+ * camelCase('FOO_BAR') // 'fooBar'
+ * camelCase('some-Mixed_string') // 'someMixedString'
+ * camelCase('') // ''
+ *
+ * @param str - String to convert
+ * @returns camelCase string
+ */
+export declare function camelCase(str: string): string;
+//# sourceMappingURL=camelCase.d.ts.map

package/dist/types/string/camelCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camelCase.d.ts","sourceRoot":"","sources":["../../../src/string/camelCase.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS7C"}

package/dist/types/string/capitalize.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Capitalizes the first letter of a string.
+ *
+ * @example
+ * capitalize('hello') // 'Hello'
+ *
+ * @param str - String to capitalize
+ * @returns Capitalized string
+ */
+export declare function capitalize(str: string): string;
+//# sourceMappingURL=capitalize.d.ts.map

package/dist/types/string/capitalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capitalize.d.ts","sourceRoot":"","sources":["../../../src/string/capitalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG9C"}

package/dist/types/string/deburr.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Removes diacritical marks (accents) from a string by converting to ASCII equivalents.
+ *
+ * @example
+ * deburr('café') // 'cafe'
+ * deburr('Crème brûlée') // 'Creme brulee'
+ * deburr('München') // 'Munchen'
+ * deburr('hello') // 'hello'
+ *
+ * @param str - String to deburr
+ * @returns ASCII-safe string
+ */
+export declare function deburr(str: string): string;
+//# sourceMappingURL=deburr.d.ts.map

package/dist/types/string/deburr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deburr.d.ts","sourceRoot":"","sources":["../../../src/string/deburr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI1C"}

package/dist/types/string/escapeHtml.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Escapes HTML special characters to prevent XSS attacks.
+ * Converts &, <, >, ", ' to their HTML entity equivalents.
+ *
+ * @example
+ * escapeHtml('<script>alert("xss")</script>')
+ * // '&lt;script&gt;alert(&quot;xss&quot;)&lt;/script&gt;'
+ *
+ * @example
+ * escapeHtml("it's a <b>test</b> & more")
+ * // "it&#39;s a &lt;b&gt;test&lt;/b&gt; &amp; more"
+ *
+ * @param str - String to escape
+ * @returns Escaped string safe for HTML insertion
+ */
+export declare function escapeHtml(str: string): string;
+//# sourceMappingURL=escapeHtml.d.ts.map

package/dist/types/string/escapeHtml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escapeHtml.d.ts","sourceRoot":"","sources":["../../../src/string/escapeHtml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAY9C"}

package/dist/types/string/escapeRegExp.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Escapes special regex characters in a string so it can be used in `new RegExp()`.
+ *
+ * @example
+ * escapeRegExp('hello.world') // 'hello\\.world'
+ * escapeRegExp('$100 (USD)') // '\\$100 \\(USD\\)'
+ * new RegExp(escapeRegExp(userInput)) // safe to use
+ *
+ * @param str - String to escape
+ * @returns Escaped string safe for RegExp construction
+ */
+export declare function escapeRegExp(str: string): string;
+//# sourceMappingURL=escapeRegExp.d.ts.map

package/dist/types/string/escapeRegExp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escapeRegExp.d.ts","sourceRoot":"","sources":["../../../src/string/escapeRegExp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/types/string/formatBytes.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Formats a byte count into a human-readable string.
+ *
+ * @example
+ * formatBytes(0) // '0 B'
+ * formatBytes(1024) // '1 KB'
+ * formatBytes(1536, 1) // '1.5 KB'
+ * formatBytes(1073741824) // '1 GB'
+ * formatBytes(1234567890, 2) // '1.15 GB'
+ *
+ * @param bytes - Number of bytes
+ * @param decimals - Decimal places (default: 2)
+ * @returns Formatted string (e.g., '1.5 MB')
+ */
+export declare function formatBytes(bytes: number, decimals?: number): string;
+//# sourceMappingURL=formatBytes.d.ts.map

package/dist/types/string/formatBytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatBytes.d.ts","sourceRoot":"","sources":["../../../src/string/formatBytes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAOvE"}

package/dist/types/string/formatDuration.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Formats milliseconds into a human-readable duration string.
+ *
+ * @example
+ * formatDuration(0) // '0s'
+ * formatDuration(5000) // '5s'
+ * formatDuration(65000) // '1m 5s'
+ * formatDuration(3661000) // '1h 1m 1s'
+ * formatDuration(90061000) // '1d 1h 1m 1s'
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Human-readable duration string
+ */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=formatDuration.d.ts.map

package/dist/types/string/formatDuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatDuration.d.ts","sourceRoot":"","sources":["../../../src/string/formatDuration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAejD"}

package/dist/types/string/formatNumber.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Formats a number or numeric string by adding thousands separators
+ * according to the specified locale.
+ *
+ * If the value is not a number, returns the original string.
+ *
+ * @param {number | string} number - Number or string to format.
+ * @param {string} [locale='en-US'] - Locale for formatting (e.g., 'en-US', 'ru-RU').
+ * @returns {string} Formatted string with thousands separators or original value if not a number.
+ *
+ * @example
+ * ```ts
+ * formatNumber(1234567); // "1,234,567"
+ * formatNumber(1234567, 'ru-RU'); // "1 234 567"
+ * formatNumber("987654321"); // "987,654,321"
+ * formatNumber("abc"); // "abc"
+ * ```
+ */
+export declare const formatNumber: (number: number | string, locale?: string) => string;
+//# sourceMappingURL=formatNumber.d.ts.map

package/dist/types/string/formatNumber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatNumber.d.ts","sourceRoot":"","sources":["../../../src/string/formatNumber.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,YAAY,GACvB,QAAQ,MAAM,GAAG,MAAM,EACvB,SAAQ,MAAgB,KACvB,MAQF,CAAC"}

package/dist/types/string/htmlToText.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Converts an HTML string into plain text by removing all HTML tags,
+ * normalizing whitespace, and trimming extra spaces.
+ *
+ * If the input is empty or falsy, returns an empty string.
+ *
+ * @param {string} html - The HTML string to convert.
+ * @returns {string} The plain text result.
+ *
+ * @example
+ * const html = `
+ *   <h1>Добро пожаловать в <b>MBank</b></h1>
+ *   <p>Первый цифровой <a href="https://mbank.example">банк</a> в стране.</p>
+ *   <ul>
+ *     <li>Онлайн-операции</li>
+ *     <li>Мобильное приложение</li>
+ *     <li>Безопасные переводы</li>
+ *   </ul>
+ * `;
+ *
+ * const text = htmlToText(html);
+ * console.log(text);
+ * // Output:
+ * // "Добро пожаловать в MBank Первый цифровой банк в стране. Онлайн-операции Мобильное приложение Безопасные переводы"
+ *
+
+ */
+export declare function htmlToText(html: string): string;
+//# sourceMappingURL=htmlToText.d.ts.map

package/dist/types/string/htmlToText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"htmlToText.d.ts","sourceRoot":"","sources":["../../../src/string/htmlToText.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO/C"}

package/dist/types/string/index.d.ts

@@ -0,0 +1,20 @@
+export { capitalize } from './capitalize.js';
+export { camelCase } from './camelCase.js';
+export { deburr } from './deburr.js';
+export { escapeHtml } from './escapeHtml.js';
+export { escapeRegExp } from './escapeRegExp.js';
+export { formatBytes } from './formatBytes.js';
+export { formatDuration } from './formatDuration.js';
+export { formatNumber } from './formatNumber.js';
+export { htmlToText } from './htmlToText.js';
+export { kebabCase } from './kebabCase.js';
+export { maskString } from './maskString.js';
+export { pascalCase } from './pascalCase.js';
+export { pluralize } from './pluralize.js';
+export { slugify } from './slugify.js';
+export { snakeCase } from './snakeCase.js';
+export { startCase } from './startCase.js';
+export { template } from './template.js';
+export { truncateString } from './truncateString.js';
+export { words } from './words.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/string/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/string/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/types/string/kebabCase.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Converts a string to kebab-case.
+ * Handles spaces, underscores, camelCase, and PascalCase.
+ *
+ * @example
+ * kebabCase('helloWorld') // 'hello-world'
+ * kebabCase('FOO_BAR') // 'foo-bar'
+ * kebabCase('some string here') // 'some-string-here'
+ * kebabCase('PascalCase') // 'pascal-case'
+ * kebabCase('') // ''
+ *
+ * @param str - String to convert
+ * @returns kebab-case string
+ */
+export declare function kebabCase(str: string): string;
+//# sourceMappingURL=kebabCase.d.ts.map

package/dist/types/string/kebabCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kebabCase.d.ts","sourceRoot":"","sources":["../../../src/string/kebabCase.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/types/string/maskString.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Masks a portion of a string, revealing only start and end characters.
+ * Useful for credit cards, phone numbers, emails, API keys.
+ *
+ * @example
+ * maskString('1234567890', 4, 2) // '1234****90'
+ * maskString('hello@example.com', 2, 4) // 'he***********e.com'
+ * maskString('secret', 0, 0) // '******'
+ * maskString('ab', 1, 1, '#') // 'ab' (nothing to mask)
+ *
+ * @param str - String to mask
+ * @param visibleStart - Number of visible chars at start
+ * @param visibleEnd - Number of visible chars at end
+ * @param maskChar - Character used for masking (default: '*')
+ * @returns Masked string
+ */
+export declare function maskString(str: string, visibleStart: number, visibleEnd: number, maskChar?: string): string;
+//# sourceMappingURL=maskString.d.ts.map

package/dist/types/string/maskString.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maskString.d.ts","sourceRoot":"","sources":["../../../src/string/maskString.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,MAAY,GACrB,MAAM,CAMR"}

package/dist/types/string/pascalCase.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Converts a string to PascalCase.
+ *
+ * @example
+ * pascalCase('hello world') // 'HelloWorld'
+ * pascalCase('foo-bar-baz') // 'FooBarBaz'
+ * pascalCase('some_snake_case') // 'SomeSnakeCase'
+ * pascalCase('') // ''
+ *
+ * @param str - String to convert
+ * @returns PascalCase string
+ */
+export declare function pascalCase(str: string): string;
+//# sourceMappingURL=pascalCase.d.ts.map

package/dist/types/string/pascalCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pascalCase.d.ts","sourceRoot":"","sources":["../../../src/string/pascalCase.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI9C"}

package/dist/types/string/pluralize.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Returns singular or plural form based on count.
+ *
+ * @example
+ * pluralize(0, 'item') // '0 items'
+ * pluralize(1, 'item') // '1 item'
+ * pluralize(5, 'item') // '5 items'
+ * pluralize(2, 'child', 'children') // '2 children'
+ * pluralize(1, 'person', 'people') // '1 person'
+ *
+ * @param count - The number
+ * @param singular - Singular form
+ * @param plural - Plural form (default: singular + 's')
+ * @returns Formatted count + word
+ */
+export declare function pluralize(count: number, singular: string, plural?: string): string;
+//# sourceMappingURL=pluralize.d.ts.map

package/dist/types/string/pluralize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluralize.d.ts","sourceRoot":"","sources":["../../../src/string/pluralize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAGlF"}

package/dist/types/string/slugify.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Converts a string to a URL-friendly slug.
+ * Lowercases, replaces non-alphanumeric chars with hyphens, trims hyphens.
+ *
+ * @example
+ * slugify('Hello World!') // 'hello-world'
+ * slugify('  Crème Brûlée ') // 'cr-me-br-l-e'
+ * slugify('foo---bar') // 'foo-bar'
+ * slugify('') // ''
+ *
+ * @param str - String to slugify
+ * @returns URL-safe slug
+ */
+export declare function slugify(str: string): string;
+//# sourceMappingURL=slugify.d.ts.map

package/dist/types/string/slugify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.d.ts","sourceRoot":"","sources":["../../../src/string/slugify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO3C"}

package/dist/types/string/snakeCase.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Converts a string to snake_case.
+ * Handles spaces, hyphens, camelCase, and PascalCase.
+ *
+ * @example
+ * snakeCase('helloWorld') // 'hello_world'
+ * snakeCase('foo-bar-baz') // 'foo_bar_baz'
+ * snakeCase('Some String Here') // 'some_string_here'
+ * snakeCase('PascalCase') // 'pascal_case'
+ * snakeCase('') // ''
+ *
+ * @param str - String to convert
+ * @returns snake_case string
+ */
+export declare function snakeCase(str: string): string;
+//# sourceMappingURL=snakeCase.d.ts.map

package/dist/types/string/snakeCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snakeCase.d.ts","sourceRoot":"","sources":["../../../src/string/snakeCase.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/types/string/startCase.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Converts a string to Start Case (each word capitalized, separated by spaces).
+ *
+ * @example
+ * startCase('hello world') // 'Hello World'
+ * startCase('fooBarBaz') // 'Foo Bar Baz'
+ * startCase('some_snake_case') // 'Some Snake Case'
+ * startCase('') // ''
+ *
+ * @param str - String to convert
+ * @returns Start Case string
+ */
+export declare function startCase(str: string): string;
+//# sourceMappingURL=startCase.d.ts.map

package/dist/types/string/startCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startCase.d.ts","sourceRoot":"","sources":["../../../src/string/startCase.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI7C"}

package/dist/types/string/template.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Simple string template interpolation using `{{key}}` placeholders.
+ *
+ * @example
+ * template('Hello, {{name}}!', { name: 'World' }) // 'Hello, World!'
+ * template('{{a}} + {{b}} = {{c}}', { a: 1, b: 2, c: 3 }) // '1 + 2 = 3'
+ * template('Hi <name>', { name: 'Ray' }, /<(.+?)>/g) // 'Hi Ray'
+ *
+ * @param str - Template string
+ * @param data - Object with replacement values
+ * @param regex - Custom pattern (default: /\{\{(.+?)\}\}/g)
+ * @returns Interpolated string
+ */
+export declare function template(str: string, data: Record<string, any>, regex?: RegExp): string;
+//# sourceMappingURL=template.d.ts.map

package/dist/types/string/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../src/string/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,KAAK,GAAE,MAAyB,GAC/B,MAAM,CAKR"}

package/dist/types/string/truncateString.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Truncates a string to a specified maximum length and adds an ellipsis (`...`) if truncated.
+ *
+ * @example
+ * truncateString("Hello, world!", 5) // "Hello..."
+ * truncateString("Short", 10)        // "Short"
+ *
+ * @param str - The string to truncate
+ * @param maxLength - Maximum length of the returned string
+ * @returns The truncated string with ellipsis if needed, otherwise the original string
+ */
+export declare function truncateString(str: string, maxLength: number): string;
+//# sourceMappingURL=truncateString.d.ts.map

package/dist/types/string/truncateString.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncateString.d.ts","sourceRoot":"","sources":["../../../src/string/truncateString.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKrE"}

package/dist/types/string/words.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Splits a string into an array of words.
+ * Handles spaces, hyphens, underscores, camelCase, and PascalCase boundaries.
+ *
+ * @example
+ * words('helloWorld') // ['hello', 'world']
+ * words('foo-bar_baz') // ['foo', 'bar', 'baz']
+ * words('FOO_BAR') // ['foo', 'bar']
+ * words('PascalCase') // ['pascal', 'case']
+ * words('') // []
+ *
+ * @param str - String to split
+ * @returns Array of lowercase words
+ */
+export declare function words(str: string): string[];
+//# sourceMappingURL=words.d.ts.map

package/dist/types/string/words.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"words.d.ts","sourceRoot":"","sources":["../../../src/string/words.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAU3C"}

package/dist/types/types/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Core TypeScript utility types
+ */
+/** A predicate function that returns a boolean */
+export type Predicate<T> = (value: T) => boolean;
+/** A function that transforms a value from type T to type U */
+export type Transformer<T, U> = (value: T) => U;
+/** A comparator function for sorting */
+export type Comparator<T> = (a: T, b: T) => number;
+/** A reducer function that accumulates a value */
+export type Reducer<T, U> = (accumulator: U, value: T) => U;
+/** Curried function with 2 parameters */
+export type Curried2<A, B, R> = {
+    (a: A): (b: B) => R;
+    (a: A, b: B): R;
+};
+/** Curried function with 3 parameters */
+export type Curried3<A, B, C, R> = {
+    (a: A): Curried2<B, C, R>;
+    (a: A, b: B): (c: C) => R;
+    (a: A, b: B, c: C): R;
+};
+/** Curried function with 4 parameters */
+export type Curried4<A, B, C, D, R> = {
+    (a: A): Curried3<B, C, D, R>;
+    (a: A, b: B): Curried2<C, D, R>;
+    (a: A, b: B, c: C): (d: D) => R;
+    (a: A, b: B, c: C, d: D): R;
+};
+/** Deep readonly type — makes all nested properties readonly */
+export type DeepReadonly<T> = {
+    readonly [P in keyof T]: T[P] extends object ? DeepReadonly<T[P]> : T[P];
+};
+/** Deep partial type — makes all nested properties optional */
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+/** Nullish type helper */
+export type Nullish = null | undefined;
+/** Make specific keys required */
+export type RequireKeys<T, K extends keyof T> = T & Required<Pick<T, K>>;
+/** Make specific keys optional */
+export type OptionalKeys<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/validation/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Validation utilities for file handling and data validation
+ */
+export { validateFileSize } from './validateFileSizeByType.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/types/validation/validateFileSizeByType.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Validates the size of a file based on its type/category.
+ * Returns an object indicating whether the file is valid and an optional error message.
+ *
+ * By default, supports three categories: 'image', 'video', 'document'.
+ * You can provide a custom category resolver to extend support for other types.
+ *
+ * @param {File} file - The file to validate.
+ * @param {Record<string, number>} sizeLimits - Maximum allowed sizes for each category in MB.
+ * @param {(file: File) => string} [resolveCategory] - Optional function to determine the file's category.
+ * @returns {{ isValid: boolean; errorMessage?: string }} Result of the validation.
+ *
+ * @example
+ * const sizeLimits = { image: 5, video: 50, document: 10 };
+ * const result = validateFileSize(fileInput.files[0], sizeLimits);
+ * if (!result.isValid) {
+ *   console.error(result.errorMessage);
+ * }
+ *
+ * @example
+ * // Custom category resolver
+ * const result = validateFileSize(file, { audio: 10, other: 5 }, file => {
+ *   if (file.type.startsWith('audio/')) return 'audio';
+ *   return 'other';
+ * });
+ */
+export declare function validateFileSize(file: File, sizeLimits: Record<string, number>, resolveCategory?: (file: File) => string, error?: string): {
+    isValid: boolean;
+    errorMessage?: string;
+    size?: string;
+};
+//# sourceMappingURL=validateFileSizeByType.d.ts.map

package/dist/types/validation/validateFileSizeByType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateFileSizeByType.d.ts","sourceRoot":"","sources":["../../../src/validation/validateFileSizeByType.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,EACxC,KAAK,CAAC,EAAE,MAAM,GACb;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAwB5D"}