@socketsecurity/lib 6.0.5 → 6.0.6

package/dist/url/search-params.js

@@ -20,7 +20,7 @@ const BooleanCtor = Boolean;
 *   urlSearchParamsAsArray(null) // []
 *   ```
 */
-/* @__NO_SIDE_EFFECTS__ */
+/*@__NO_SIDE_EFFECTS__*/
 function urlSearchParamsAsArray(value) {
 	return typeof value === "string" ? value.trim().split(/, */).map((v) => v.trim()).filter(BooleanCtor) : [];
 }
@@ -34,7 +34,7 @@ function urlSearchParamsAsArray(value) {
 *   urlSearchParamsAsBoolean(null) // false
 *   ```
 */
-/* @__NO_SIDE_EFFECTS__ */
+/*@__NO_SIDE_EFFECTS__*/
 function urlSearchParamsAsBoolean(value, options) {
 	const { defaultValue = false } = {
 		__proto__: null,
@@ -59,7 +59,7 @@ function urlSearchParamsAsBoolean(value, options) {
 *   urlSearchParamsAsNumber(params, 'other') // 0
 *   ```
 */
-/* @__NO_SIDE_EFFECTS__ */
+/*@__NO_SIDE_EFFECTS__*/
 function urlSearchParamsAsNumber(params, key, options) {
 	const { defaultValue = 0 } = {
 		__proto__: null,
@@ -84,7 +84,7 @@ function urlSearchParamsAsNumber(params, key, options) {
 *   urlSearchParamsAsString(params, 'other') // ''
 *   ```
 */
-/* @__NO_SIDE_EFFECTS__ */
+/*@__NO_SIDE_EFFECTS__*/
 function urlSearchParamsAsString(params, key, options) {
 	const { defaultValue = "" } = {
 		__proto__: null,
@@ -105,7 +105,7 @@ function urlSearchParamsAsString(params, key, options) {
 *   urlSearchParamsGetArray(params, 'tags') // ['a', 'b', 'c']
 *   ```
 */
-/* @__NO_SIDE_EFFECTS__ */
+/*@__NO_SIDE_EFFECTS__*/
 function urlSearchParamsGetArray(params, key) {
 	if (params && typeof params.getAll === "function") {
 		const values = params.getAll(key);
@@ -125,7 +125,7 @@ function urlSearchParamsGetArray(params, key) {
 *   urlSearchParamsGetBoolean(params, 'other') // false
 *   ```
 */
-/* @__NO_SIDE_EFFECTS__ */
+/*@__NO_SIDE_EFFECTS__*/
 function urlSearchParamsGetBoolean(params, key, options) {
 	const { defaultValue = false } = {
 		__proto__: null,

package/dist/words/article.js

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

package/dist/words/capitalize.js

@@ -17,7 +17,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 *   capitalize('') // ''
 *   ```
 */
-/* @__NO_SIDE_EFFECTS__ */
+/*@__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

@@ -3,6 +3,24 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 //#region src/words/pluralize.ts
+const CLDR_TO_FIELD = {
+	one: "singular",
+	other: "plural",
+	zero: "zero",
+	two: "two",
+	few: "few",
+	many: "many"
+};
+const RULES_CACHE = /* @__PURE__ */ new Map();
+function getRules(locale, type) {
+	const key = `${locale}:${type}`;
+	let r = RULES_CACHE.get(key);
+	if (!r) {
+		r = new Intl.PluralRules(locale, { type });
+		RULES_CACHE.set(key, r);
+	}
+	return r;
+}
 /**
 * Pluralize a word based on count.
 *
@@ -11,16 +29,33 @@ 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__ */
+/*@__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;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@socketsecurity/lib",
-  "version": "6.0.5",
+  "version": "6.0.6",
   "description": "Core utilities and infrastructure for Socket.dev security tools",
   "keywords": [
     "Socket.dev",
@@ -20,6 +20,7 @@
     "url": "git+https://github.com/SocketDev/socket-lib.git"
   },
   "bin": {
+    "prim": "./dist/bin/prim.cjs",
     "socket-lib": "./dist/bin/socket-lib.js"
   },
   "files": [
@@ -1064,6 +1065,11 @@
       "types": "./dist/external-tools/from-download.d.ts",
       "default": "./dist/external-tools/from-download.js"
     },
+    "./external-tools/from-pip-venv": {
+      "source": "./src/external-tools/from-pip-venv.ts",
+      "types": "./dist/external-tools/from-pip-venv.d.ts",
+      "default": "./dist/external-tools/from-pip-venv.js"
+    },
     "./external-tools/janus/asset-names": {
       "source": "./src/external-tools/janus/asset-names.ts",
       "types": "./dist/external-tools/janus/asset-names.d.ts",
@@ -1199,6 +1205,31 @@
       "types": "./dist/external-tools/sbt/types.d.ts",
       "default": "./dist/external-tools/sbt/types.js"
     },
+    "./external-tools/skillspector/from-dlx": {
+      "source": "./src/external-tools/skillspector/from-dlx.ts",
+      "types": "./dist/external-tools/skillspector/from-dlx.d.ts",
+      "default": "./dist/external-tools/skillspector/from-dlx.js"
+    },
+    "./external-tools/skillspector/from-path": {
+      "source": "./src/external-tools/skillspector/from-path.ts",
+      "types": "./dist/external-tools/skillspector/from-path.d.ts",
+      "default": "./dist/external-tools/skillspector/from-path.js"
+    },
+    "./external-tools/skillspector/from-vfs": {
+      "source": "./src/external-tools/skillspector/from-vfs.ts",
+      "types": "./dist/external-tools/skillspector/from-vfs.d.ts",
+      "default": "./dist/external-tools/skillspector/from-vfs.js"
+    },
+    "./external-tools/skillspector/resolve": {
+      "source": "./src/external-tools/skillspector/resolve.ts",
+      "types": "./dist/external-tools/skillspector/resolve.d.ts",
+      "default": "./dist/external-tools/skillspector/resolve.js"
+    },
+    "./external-tools/skillspector/types": {
+      "source": "./src/external-tools/skillspector/types.ts",
+      "types": "./dist/external-tools/skillspector/types.d.ts",
+      "default": "./dist/external-tools/skillspector/types.js"
+    },
     "./external-tools/synp/asset-names": {
       "source": "./src/external-tools/synp/asset-names.ts",
       "types": "./dist/external-tools/synp/asset-names.d.ts",
@@ -2799,13 +2830,14 @@
     "@npmcli/arborist": "9.1.4",
     "@npmcli/package-json": "7.0.0",
     "@npmcli/promise-spawn": "8.0.3",
+    "@redwoodjs/agent-ci": "0.16.2",
     "@sinclair/typebox": "0.34.49",
     "@socketregistry/is-unicode-supported": "1.0.5",
     "@socketregistry/packageurl-js": "npm:@socketregistry/packageurl-js@1.4.2",
     "@socketregistry/packageurl-js-stable": "npm:@socketregistry/packageurl-js@1.4.2",
     "@socketregistry/yocto-spinner": "1.0.25",
     "@socketsecurity/lib": "npm:@socketsecurity/lib@6.0.4",
-    "@socketsecurity/lib-stable": "npm:@socketsecurity/lib@6.0.4",
+    "@socketsecurity/lib-stable": "npm:@socketsecurity/lib@6.0.5",
     "@socketsecurity/sdk": "npm:@socketsecurity/sdk@4.0.1",
     "@socketsecurity/sdk-stable": "npm:@socketsecurity/sdk@4.0.1",
     "@types/node": "24.9.2",
@@ -2837,7 +2869,7 @@
     "pacote": "21.5.0",
     "picomatch": "4.0.4",
     "pony-cause": "2.1.11",
-    "rolldown": "1.0.2",
+    "rolldown": "1.0.3",
     "semver": "7.7.2",
     "shell-quote": "1.8.4",
     "signal-exit": "4.1.0",
@@ -2871,6 +2903,13 @@
     "npm": ">=11.16.0",
     "pnpm": ">=11.4.0"
   },
+  "allowScripts": {
+    "cpu-features": false,
+    "esbuild": true,
+    "protobufjs": false,
+    "rolldown": true,
+    "ssh2": false
+  },
   "scripts": {
     "build": "node scripts/build/cli.mts",
     "check": "node scripts/check.mts",
@@ -2888,6 +2927,7 @@
     "update": "node scripts/update.mts",
     "lockstep": "node scripts/lockstep.mts",
     "lockstep:emit-schema": "node scripts/lockstep-emit-schema.mts",
-    "setup-security-tools": "node .claude/hooks/setup-security-tools/install.mts"
+    "setup-security-tools": "node .claude/hooks/fleet/setup-security-tools/install.mts",
+    "ci:local": "agent-ci run --all"
   }
 }