@dereekb/util 13.4.2 → 13.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/util",
-  "version": "13.4.2",
+  "version": "13.5.1",
   "exports": {
     "./test": {
       "module": "./test/index.esm.js",

package/src/lib/contact/phone.d.ts

@@ -24,7 +24,7 @@ export type PhoneExtensionNumber = string;
 export type E164PhoneNumber = `+${PhoneNumber}`;
 /**
  * Regular expression for validating E.164 phone numbers.
- * Validates numbers that start with a + followed by 2-15 digits.
+ * Validates numbers that start with a + followed by 7-15 digits.
  * The first digit after the + must be 1-9 (not 0).
  *
  * Requires the + to be provided.
@@ -50,7 +50,7 @@ export type E164PhoneNumberWithExtension = `+${PhoneNumber}#${PhoneExtensionNumb
 export type E164PhoneNumberWithOptionalExtension = E164PhoneNumber | E164PhoneNumberWithExtension;
 /**
  * Regular expression for validating E.164 phone numbers with an optional extension.
- * Validates numbers in the format +number or +number#extension.
+ * Validates numbers with 7-15 digits in the format +number or +number#extension.
  * The extension part is 1-6 digits following a # character.
  *
  * Requires the + to be provided.
@@ -58,7 +58,7 @@ export type E164PhoneNumberWithOptionalExtension = E164PhoneNumber | E164PhoneNu
 export declare const E164PHONE_NUMBER_WITH_OPTIONAL_EXTENSION_REGEX: RegExp;
 /**
  * Regular expression for validating E.164 phone numbers that must include an extension.
- * Validates numbers strictly in the format +number#extension.
+ * Validates numbers with 7-15 digits strictly in the format +number#extension.
  * The extension part is 1-6 digits following a # character.
  *
  * Requires the + to be provided and the extension part.
@@ -116,3 +116,24 @@ export declare function e164PhoneNumberExtensionPair(input: PhoneNumber | E164Ph
  * @returns A formatted phone number string with optional extension
  */
 export declare function e164PhoneNumberFromE164PhoneNumberExtensionPair(input: E164PhoneNumberExtensionPair): E164PhoneNumberWithOptionalExtension;
+/**
+ * Attempts to convert a raw phone number string into a valid {@link E164PhoneNumber}.
+ *
+ * Strips common formatting characters (parentheses, hyphens, spaces, dots), then checks
+ * if the result is already valid E.164. If not, prepends the given country code and
+ * validates again.
+ *
+ * @param input - A raw phone number string, possibly with formatting (e.g. `'(720)6620850'`, `'720-662-0850'`)
+ * @param defaultCountryCode - The country calling code to prepend if the number lacks one (default: `'1'` for US/Canada)
+ * @returns The corrected {@link E164PhoneNumber}, or `undefined` if the input cannot be converted
+ *
+ * @example
+ * ```typescript
+ * tryConvertToE164PhoneNumber('(720)6620850');       // '+17206620850'
+ * tryConvertToE164PhoneNumber('720-662-0850');        // '+17206620850'
+ * tryConvertToE164PhoneNumber('+17206620850');        // '+17206620850'
+ * tryConvertToE164PhoneNumber('7206620850', '44');    // '+447206620850'
+ * tryConvertToE164PhoneNumber('abc');                 // undefined
+ * ```
+ */
+export declare function tryConvertToE164PhoneNumber(input: string, defaultCountryCode?: string): Maybe<E164PhoneNumber>;

package/src/lib/string/html.d.ts

@@ -5,6 +5,57 @@ import { type PrimativeValue } from '../type';
  * Represents a single CSS Class
  */
 export type CssClass = string;
+/**
+ * The name portion of a CSS token, without the leading `--` prefix.
+ *
+ * @example
+ * ```ts
+ * const name: CssTokenName = 'dbx-primary-color';
+ * ```
+ */
+export type CssTokenName = string;
+/**
+ * Represents a CSS custom property token (CSS variable).
+ *
+ * @example
+ * ```ts
+ * const token: CssToken = '--dbx-primary-color';
+ * ```
+ */
+export type CssToken<T extends CssTokenName = CssTokenName> = `--${T}`;
+/**
+ * A CSS token wrapped in a var() call.
+ *
+ * @example
+ * ```ts
+ * const tokenVar: CssTokenVar = 'var(--dbx-primary-color)';
+ * ```
+ */
+export type CssTokenVar<T extends CssToken = CssToken> = `var(${T})`;
+/**
+ * Converts a CSS token into a var() string.
+ *
+ * @example
+ * ```ts
+ * cssTokenVar('--dbx-primary-color'); // 'var(--dbx-primary-color)'
+ * ```
+ *
+ * @param cssToken - the CSS token to convert
+ * @returns the var() string
+ */
+export declare function cssTokenVar<T extends CssToken>(cssToken: T): CssTokenVar<T>;
+/**
+ * @deprecated Use {@link CssToken} instead.
+ */
+export type CssVariable = CssToken;
+/**
+ * @deprecated Use {@link CssTokenVar} instead.
+ */
+export type CssVariableVar<T extends CssToken = CssToken> = CssTokenVar<T>;
+/**
+ * @deprecated Use {@link cssTokenVar} instead.
+ */
+export declare const cssVariableVar: typeof cssTokenVar;
 /**
  * Represents a single CSS Style
  */

package/test/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@dereekb/util/test",
-  "version": "13.4.2",
+  "version": "13.5.1",
   "peerDependencies": {
-    "@dereekb/util": "13.4.2",
+    "@dereekb/util": "13.5.1",
     "make-error": "^1.3.0"
   },
   "exports": {