@socketsecurity/lib 6.0.5 → 6.0.7

package/dist/themes/context.d.ts

@@ -3,7 +3,8 @@
  *   context isolation via AsyncLocalStorage.
  */
 import type { Theme } from './types';
-import { type ThemeName } from './themes';
+import type { ThemeName } from './themes';
+import type * as AsyncHooks from 'node:async_hooks';
 /**
  * Theme change event listener signature.
  */
@@ -19,7 +20,7 @@ export declare function emitThemeChange(theme: Theme): void;
  *
  * @private
  */
-export declare function getAsyncHooks(): typeof import('node:async_hooks');
+export declare function getAsyncHooks(): typeof AsyncHooks;
 /**
  * Get the active theme from context.
  *

package/dist/themes/context.js

@@ -5,7 +5,7 @@ const require_primordials_map_set = require('../primordials/map-set.js');
 const require_themes_themes = require('./themes.js');
 
 //#region src/themes/context.ts
-let _async_hooks;
+let asyncHooks;
 /**
 * Emit theme change event to listeners.
 *
@@ -19,15 +19,14 @@ function emitThemeChange(theme) {
 *
 * @private
 */
-/* @__NO_SIDE_EFFECTS__ */
 function getAsyncHooks() {
-	if (_async_hooks === void 0) _async_hooks = /* @__PURE__ */ require("node:async_hooks");
-	return _async_hooks;
+	if (asyncHooks === void 0) asyncHooks = /*@__PURE__*/ require("node:async_hooks");
+	return asyncHooks;
 }
 /**
 * AsyncLocalStorage for theme context isolation.
 */
-const { AsyncLocalStorage } = /* @__PURE__ */ getAsyncHooks();
+const { AsyncLocalStorage } = getAsyncHooks();
 const themeStorage = new AsyncLocalStorage();
 /**
 * Fallback theme for global context.

package/dist/themes/themes.js

@@ -8,8 +8,6 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 * designed for focus and elegance.
 */
 const SOCKET_THEME = {
-	name: "socket",
-	displayName: "Socket Security",
 	colors: {
 		primary: [
 			140,
@@ -26,6 +24,7 @@ const SOCKET_THEME = {
 		link: "cyanBright",
 		prompt: "primary"
 	},
+	displayName: "Socket Security",
 	effects: {
 		spinner: {
 			color: "primary",
@@ -41,15 +40,14 @@ const SOCKET_THEME = {
 	meta: {
 		description: "Signature theme with refined violet and subtle shimmer",
 		version: "1.0.0"
-	}
+	},
+	name: "socket"
 };
 /**
 * Sunset — Vibrant twilight gradient. Warm sunset palette with orange and
 * purple/pink tones.
 */
 const SUNSET_THEME = {
-	name: "sunset",
-	displayName: "Sunset",
 	colors: {
 		primary: [
 			255,
@@ -71,6 +69,7 @@ const SUNSET_THEME = {
 		link: "primary",
 		prompt: "primary"
 	},
+	displayName: "Sunset",
 	effects: {
 		spinner: {
 			color: "primary",
@@ -94,15 +93,14 @@ const SUNSET_THEME = {
 	meta: {
 		description: "Warm sunset theme with purple-to-orange gradient",
 		version: "2.0.0"
-	}
+	},
+	name: "sunset"
 };
 /**
 * Terracotta — Solid warmth. Rich terracotta and ember tones for grounded
 * confidence.
 */
 const TERRACOTTA_THEME = {
-	name: "terracotta",
-	displayName: "Terracotta",
 	colors: {
 		primary: [
 			255,
@@ -124,6 +122,7 @@ const TERRACOTTA_THEME = {
 		link: "secondary",
 		prompt: "primary"
 	},
+	displayName: "Terracotta",
 	effects: {
 		spinner: {
 			color: "primary",
@@ -139,14 +138,13 @@ const TERRACOTTA_THEME = {
 	meta: {
 		description: "Solid theme with rich terracotta and ember warmth",
 		version: "1.0.0"
-	}
+	},
+	name: "terracotta"
 };
 /**
 * Lush — Steel elegance. Python-inspired steel blue with golden accents.
 */
 const LUSH_THEME = {
-	name: "lush",
-	displayName: "Lush",
 	colors: {
 		primary: [
 			70,
@@ -168,6 +166,7 @@ const LUSH_THEME = {
 		link: "cyanBright",
 		prompt: "primary"
 	},
+	displayName: "Lush",
 	effects: { spinner: {
 		color: "primary",
 		style: "dots"
@@ -175,15 +174,14 @@ const LUSH_THEME = {
 	meta: {
 		description: "Elegant theme with steel blue and golden harmony",
 		version: "1.0.0"
-	}
+	},
+	name: "lush"
 };
 /**
 * Ultra — Premium intensity. Prismatic shimmer for deep analysis, where
 * complexity meets elegance.
 */
 const ULTRA_THEME = {
-	name: "ultra",
-	displayName: "Ultra",
 	colors: {
 		primary: [
 			140,
@@ -200,6 +198,7 @@ const ULTRA_THEME = {
 		link: "cyanBright",
 		prompt: "primary"
 	},
+	displayName: "Ultra",
 	effects: {
 		spinner: {
 			color: "inherit",
@@ -215,7 +214,8 @@ const ULTRA_THEME = {
 	meta: {
 		description: "Premium theme with prismatic shimmer for deep analysis",
 		version: "1.0.0"
-	}
+	},
+	name: "ultra"
 };
 /**
 * Theme registry — Curated palette collection.

package/dist/themes/types.d.ts

@@ -75,7 +75,7 @@ export type ThemeEffects = {
          * Animation style.
          */
         style?: SpinnerStyle | string | undefined;
-    };
+    } | undefined;
     /**
      * Shimmer configuration.
      */
@@ -96,7 +96,7 @@ export type ThemeEffects = {
          * Speed (steps per frame)
          */
         speed?: number | undefined;
-    };
+    } | undefined;
     /**
      * Pulse configuration.
      */
@@ -105,7 +105,7 @@ export type ThemeEffects = {
          * Speed (milliseconds)
          */
         speed?: number | undefined;
-    };
+    } | undefined;
 };
 /**
  * Theme metadata — descriptive information.

package/dist/url/parse.js

@@ -19,7 +19,6 @@ const UrlCtor = URL;
 *   createRelativeUrl('/api/test', { base: 'https://example.com' }) // 'https://example.com/api/test'
 *   ```
 */
-/* @__NO_SIDE_EFFECTS__ */
 function createRelativeUrl(path, options) {
 	const { base = "" } = {
 		__proto__: null,
@@ -42,7 +41,6 @@ function createRelativeUrl(path, options) {
 *   parseUrl('invalid') // undefined
 *   ```
 */
-/* @__NO_SIDE_EFFECTS__ */
 function parseUrl(value) {
 	try {
 		return new UrlCtor(value);

package/dist/url/predicates.js

@@ -18,9 +18,8 @@ const require_url_parse = require('./parse.js');
 *   isUrl(null) // false
 *   ```
 */
-/* @__NO_SIDE_EFFECTS__ */
 function isUrl(value) {
-	return (typeof value === "string" && value !== "" || value !== null && typeof value === "object") && !!/* @__PURE__ */ require_url_parse.parseUrl(value);
+	return (typeof value === "string" && value !== "" || value !== null && typeof value === "object") && !!require_url_parse.parseUrl(value);
 }
 
 //#endregion

package/dist/url/search-params.js

@@ -20,7 +20,6 @@ const BooleanCtor = Boolean;
 *   urlSearchParamsAsArray(null) // []
 *   ```
 */
-/* @__NO_SIDE_EFFECTS__ */
 function urlSearchParamsAsArray(value) {
 	return typeof value === "string" ? value.trim().split(/, */).map((v) => v.trim()).filter(BooleanCtor) : [];
 }
@@ -34,7 +33,6 @@ function urlSearchParamsAsArray(value) {
 *   urlSearchParamsAsBoolean(null) // false
 *   ```
 */
-/* @__NO_SIDE_EFFECTS__ */
 function urlSearchParamsAsBoolean(value, options) {
 	const { defaultValue = false } = {
 		__proto__: null,
@@ -44,7 +42,7 @@ function urlSearchParamsAsBoolean(value, options) {
 		const trimmed = value.trim();
 		if (trimmed === "") return !!defaultValue;
 		const lowered = trimmed.toLowerCase();
-		return lowered === "1" || lowered === "true" || lowered === "yes" || lowered === "on";
+		return lowered === "1" || lowered === "on" || lowered === "true" || lowered === "yes";
 	}
 	if (value === null || value === void 0) return !!defaultValue;
 	return !!value;
@@ -59,7 +57,6 @@ function urlSearchParamsAsBoolean(value, options) {
 *   urlSearchParamsAsNumber(params, 'other') // 0
 *   ```
 */
-/* @__NO_SIDE_EFFECTS__ */
 function urlSearchParamsAsNumber(params, key, options) {
 	const { defaultValue = 0 } = {
 		__proto__: null,
@@ -84,7 +81,6 @@ function urlSearchParamsAsNumber(params, key, options) {
 *   urlSearchParamsAsString(params, 'other') // ''
 *   ```
 */
-/* @__NO_SIDE_EFFECTS__ */
 function urlSearchParamsAsString(params, key, options) {
 	const { defaultValue = "" } = {
 		__proto__: null,
@@ -105,12 +101,11 @@ function urlSearchParamsAsString(params, key, options) {
 *   urlSearchParamsGetArray(params, 'tags') // ['a', 'b', 'c']
 *   ```
 */
-/* @__NO_SIDE_EFFECTS__ */
 function urlSearchParamsGetArray(params, key) {
 	if (params && typeof params.getAll === "function") {
 		const values = params.getAll(key);
 		const firstValue = values[0];
-		if (values.length === 1 && firstValue && firstValue.includes(",")) return /* @__PURE__ */ urlSearchParamsAsArray(firstValue);
+		if (values.length === 1 && firstValue && firstValue.includes(",")) return urlSearchParamsAsArray(firstValue);
 		return values;
 	}
 	return [];
@@ -125,7 +120,6 @@ function urlSearchParamsGetArray(params, key) {
 *   urlSearchParamsGetBoolean(params, 'other') // false
 *   ```
 */
-/* @__NO_SIDE_EFFECTS__ */
 function urlSearchParamsGetBoolean(params, key, options) {
 	const { defaultValue = false } = {
 		__proto__: null,
@@ -133,7 +127,7 @@ function urlSearchParamsGetBoolean(params, key, options) {
 	};
 	if (params && typeof params.get === "function") {
 		const value = params.get(key);
-		return value !== null ? /* @__PURE__ */ urlSearchParamsAsBoolean(value, { defaultValue }) : defaultValue;
+		return value !== null ? urlSearchParamsAsBoolean(value, { defaultValue }) : defaultValue;
 	}
 	return defaultValue;
 }

package/dist/url/types.d.ts

@@ -4,17 +4,17 @@
  *   types, no runtime side effects.
  */
 export interface CreateRelativeUrlOptions {
-    base?: string;
+    base?: string | undefined;
 }
 export interface UrlSearchParamsAsBooleanOptions {
-    defaultValue?: boolean;
+    defaultValue?: boolean | undefined;
 }
 export interface UrlSearchParamsAsNumberOptions {
-    defaultValue?: number;
+    defaultValue?: number | undefined;
 }
 export interface UrlSearchParamsAsStringOptions {
-    defaultValue?: string;
+    defaultValue?: string | undefined;
 }
 export interface UrlSearchParamsGetBooleanOptions {
-    defaultValue?: boolean;
+    defaultValue?: boolean | undefined;
 }

package/dist/versions/_internal.js

@@ -15,20 +15,20 @@ const require_smol_versions = require('../smol/versions.js');
 *   shape (`{major, minor, patch}`) which only `semver.parse` exposes — those
 *   leaves use `getSemver()` directly instead of going through `impl`.
 */
-const _semver = require("../external/semver");
+const semver = require("../external/semver");
 /**
 * The vendored `semver` JS implementation. Always available — used directly by
 * the leaves that need the parsed `{major, minor, patch}` shape (which
 * smol-versions doesn't expose).
 */
 function getSemver() {
-	return _semver;
+	return semver;
 }
 /**
 * Resolved version implementation: smol-versions on the smol Node binary,
 * otherwise the vendored `semver`. Bound once at module load.
 */
-const impl = /* @__PURE__ */ require_smol_versions.getSmolVersions() ?? _semver;
+const impl = require_smol_versions.getSmolVersions() ?? semver;
 
 //#endregion
 exports.getSemver = getSemver;

package/dist/words/article.js

@@ -16,7 +16,6 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 *   determineArticle('banana') // 'a'
 *   ```
 */
-/* @__NO_SIDE_EFFECTS__ */
 function determineArticle(word) {
 	return /^[aeiou]/i.test(word) ? "an" : "a";
 }

package/dist/words/capitalize.js

@@ -17,7 +17,6 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 *   capitalize('') // ''
 *   ```
 */
-/* @__NO_SIDE_EFFECTS__ */
 function capitalize(word) {
 	if (word.length === 0) return word;
 	const [first, ...rest] = [...word];

package/dist/words/pluralize.d.ts

@@ -1,8 +1,15 @@
 /**
- * @file Simple count-based pluralization helper — appends a trailing `'s'` when
- *   the count is anything other than 1.
+ * @file Count-based pluralization. Two modes:
+ *
+ *   - Default: appends a trailing `'s'` when the count is anything other than 1.
+ *     Zero-cost; no Intl dependency on the hot path.
+ *   - Dictionary: when `options.forms` is given, selects from a caller-supplied
+ *     dictionary of forms keyed by plural category. Honors locale + cardinal /
+ *     ordinal via `Intl.PluralRules`. Required `plural` acts as the fallback
+ *     for any category not explicitly listed.
  */
 import type { PluralizeOptions } from './types';
+export declare function getRules(locale: string, type: Intl.PluralRuleType): Intl.PluralRules;
 /**
  * Pluralize a word based on count.
  *
@@ -11,6 +18,21 @@ import type { PluralizeOptions } from './types';
  *   pluralize('file') // 'file'
  *   pluralize('file', { count: 3 }) // 'files'
  *   pluralize('file', { count: 0 }) // 'files'
+ *
+ *   // Dictionary mode for irregulars.
+ *   pluralize('child', {
+ *   count: 3,
+ *   forms: { singular: 'child', plural: 'children' },
+ *   }) // 'children'
+ *
+ *   // Locale + cardinal/ordinal. `singular` here covers CLDR's `one`
+ *   // category (the count===1 ordinal suffix); `two`/`few` map directly;
+ *   // `plural` is the fallback for everything else.
+ *   pluralize('place', {
+ *   count: 2,
+ *   type: 'ordinal',
+ *   forms: { singular: 'st', two: 'nd', few: 'rd', plural: 'th' },
+ *   }) // 'nd'
  *   ```
  */
 export declare function pluralize(word: string, options?: PluralizeOptions | undefined): string;

package/dist/words/pluralize.js

@@ -1,9 +1,38 @@
 "use strict";
 /* Socket Lib - Built with rolldown */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_intl = require('../primordials/intl.js');
 
 //#region src/words/pluralize.ts
 /**
+* @file Count-based pluralization. Two modes:
+*
+*   - Default: appends a trailing `'s'` when the count is anything other than 1.
+*     Zero-cost; no Intl dependency on the hot path.
+*   - Dictionary: when `options.forms` is given, selects from a caller-supplied
+*     dictionary of forms keyed by plural category. Honors locale + cardinal /
+*     ordinal via `Intl.PluralRules`. Required `plural` acts as the fallback
+*     for any category not explicitly listed.
+*/
+const CLDR_TO_FIELD = {
+	few: "few",
+	many: "many",
+	one: "singular",
+	other: "plural",
+	two: "two",
+	zero: "zero"
+};
+const RULES_CACHE = /* @__PURE__ */ new Map();
+function getRules(locale, type) {
+	const key = `${locale}:${type}`;
+	let r = RULES_CACHE.get(key);
+	if (!r) {
+		r = new require_primordials_intl.IntlPluralRules(locale, { type });
+		RULES_CACHE.set(key, r);
+	}
+	return r;
+}
+/**
 * Pluralize a word based on count.
 *
 * @example
@@ -11,16 +40,32 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 *   pluralize('file') // 'file'
 *   pluralize('file', { count: 3 }) // 'files'
 *   pluralize('file', { count: 0 }) // 'files'
+*
+*   // Dictionary mode for irregulars.
+*   pluralize('child', {
+*   count: 3,
+*   forms: { singular: 'child', plural: 'children' },
+*   }) // 'children'
+*
+*   // Locale + cardinal/ordinal. `singular` here covers CLDR's `one`
+*   // category (the count===1 ordinal suffix); `two`/`few` map directly;
+*   // `plural` is the fallback for everything else.
+*   pluralize('place', {
+*   count: 2,
+*   type: 'ordinal',
+*   forms: { singular: 'st', two: 'nd', few: 'rd', plural: 'th' },
+*   }) // 'nd'
 *   ```
 */
-/* @__NO_SIDE_EFFECTS__ */
 function pluralize(word, options) {
-	const { count = 1 } = {
+	const { count = 1, forms, locale = "en-US", type = "cardinal" } = {
 		__proto__: null,
 		...options
 	};
+	if (forms) return forms[CLDR_TO_FIELD[getRules(locale, type).select(count)]] ?? forms.plural;
 	return count === 1 ? word : `${word}s`;
 }
 
 //#endregion
+exports.getRules = getRules;
 exports.pluralize = pluralize;

package/dist/words/types.d.ts

@@ -1,7 +1,30 @@
 /**
  * @file Public type surface for `words/*` modules — the `PluralizeOptions`
- *   record. Pure types, no runtime side effects.
+ *   record and its `PluralForms` companion. Pure types, no runtime side
+ *   effects.
  */
+/**
+ * Count-aware forms for {@link pluralize}. `singular` covers the CLDR `one`
+ * category; `plural` covers the required `other` category and is the fallback
+ * when a count's category isn't explicitly listed. The remaining four
+ * (`zero`/`two`/`few`/`many`) are optional and default to `plural` when omitted
+ * — only languages like Arabic, Russian, or Welsh exercise them.
+ *
+ * Plural-category reference:
+ * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/PluralRules/select
+ * https://cldr.unicode.org/index/cldr-spec/plural-rules.
+ */
+export interface PluralForms {
+    singular?: string | undefined;
+    plural: string;
+    zero?: string | undefined;
+    two?: string | undefined;
+    few?: string | undefined;
+    many?: string | undefined;
+}
 export interface PluralizeOptions {
-    count?: number;
+    count?: number | undefined;
+    forms?: PluralForms | undefined;
+    locale?: string | undefined;
+    type?: Intl.PluralRuleType | undefined;
 }