@vielzeug/arsenal 1.0.1

package/dist/object/merge.js

@@ -0,0 +1,27 @@
+import { isUnsafeKey as e } from "../_common/unsafePaths.js";
+import { isPlainObject as t } from "../guards/isPlainObject.js";
+//#region src/object/merge.ts
+function n(r, i, a) {
+	if (!t(i)) return i;
+	let o = { ...r };
+	for (let r of Object.keys(i)) {
+		if (e(r)) continue;
+		let s = i[r], c = o[r];
+		o[r] = Array.isArray(s) && Array.isArray(c) ? a.arrayStrategy === "concat" ? [...c, ...s] : s : t(s) && t(c) ? n(c, s, a) : s;
+	}
+	return o;
+}
+function r(...e) {
+	let t = e[e.length - 1], r = e.length > 0 && typeof t == "object" && !!t && !Array.isArray(t) && "arrayStrategy" in t && Object.keys(t).length === 1 && (t.arrayStrategy === "concat" || t.arrayStrategy === "replace"), i = r ? t : {}, a = r ? e.slice(0, -1) : e;
+	return a.length === 0 ? {} : a.reduce((e, t) => n(e, t, i), {});
+}
+function i(...t) {
+	if (t.length === 0) return {};
+	let n = {};
+	for (let r of t) for (let t of Object.keys(r)) e(t) || (n[t] = r[t]);
+	return n;
+}
+//#endregion
+export { r as deepMerge, i as shallowMerge };
+
+//# sourceMappingURL=merge.js.map

package/dist/object/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","names":[],"sources":["../../src/object/merge.ts"],"sourcesContent":["import type { Obj } from '../types';\n\nimport { isUnsafeKey } from '../_common/unsafePaths';\nimport { isPlainObject } from '../guards/isPlainObject';\n\nexport type DeepMergeOptions = {\n  /** How to handle arrays when both source and target contain one. Default: `'replace'`. */\n  arrayStrategy?: 'concat' | 'replace';\n};\n\ntype DeepMerge<T, U> = T extends Obj\n  ? U extends Obj\n    ? {\n        [K in keyof T | keyof U]: K extends keyof T\n          ? K extends keyof U\n            ? DeepMerge<T[K], U[K]>\n            : T[K]\n          : K extends keyof U\n            ? U[K]\n            : never;\n      }\n    : U\n  : U;\n\ntype Merge<T extends Obj[]> = T extends [infer First, ...infer Rest]\n  ? First extends Obj\n    ? Rest extends Obj[]\n      ? DeepMerge<First, Merge<Rest>>\n      : First\n    : Obj\n  : Obj;\n\nfunction mergeObjects<T extends Obj, U extends Obj>(target: T, source: U, options: DeepMergeOptions): DeepMerge<T, U> {\n  if (!isPlainObject(source)) return source as DeepMerge<T, U>;\n\n  const result = { ...target } as DeepMerge<T, U>;\n\n  for (const key of Object.keys(source)) {\n    // Guard against prototype pollution: skip dangerous keys\n    if (isUnsafeKey(key)) {\n      continue;\n    }\n\n    const sourceValue = source[key];\n    const targetValue = result[key];\n\n    (result as Record<string, unknown>)[key] =\n      Array.isArray(sourceValue) && Array.isArray(targetValue)\n        ? options.arrayStrategy === 'concat'\n          ? [...targetValue, ...sourceValue]\n          : sourceValue\n        : isPlainObject(sourceValue) && isPlainObject(targetValue)\n          ? mergeObjects(targetValue as Obj, sourceValue as Obj, options)\n          : sourceValue;\n  }\n\n  return result;\n}\n\n/**\n * Deeply merges two or more objects. Arrays in source objects **replace** the target array by default.\n * Pass `{ arrayStrategy: 'concat' }` as the last argument to concatenate arrays instead.\n *\n * @example\n * ```ts\n * deepMerge({ a: 1, b: { x: 1 } }, { b: { y: 2 }, c: 3 });\n * // { a: 1, b: { x: 1, y: 2 }, c: 3 }\n *\n * deepMerge({ tags: ['a'] }, { tags: ['b'] });\n * // { tags: ['b'] }  ← arrays replaced\n *\n * deepMerge({ tags: ['a'] }, { tags: ['b'] }, { arrayStrategy: 'concat' });\n * // { tags: ['a', 'b'] }\n * ```\n */\nexport function deepMerge<T extends Obj[]>(...args: [...T] | [...T, DeepMergeOptions]): Merge<T> {\n  const lastArg = args[args.length - 1];\n  const hasOptions =\n    args.length > 0 &&\n    typeof lastArg === 'object' &&\n    lastArg !== null &&\n    !Array.isArray(lastArg) &&\n    'arrayStrategy' in lastArg &&\n    Object.keys(lastArg).length === 1 &&\n    ((lastArg as DeepMergeOptions).arrayStrategy === 'concat' ||\n      (lastArg as DeepMergeOptions).arrayStrategy === 'replace');\n\n  const options: DeepMergeOptions = hasOptions ? (lastArg as DeepMergeOptions) : {};\n  const items = (hasOptions ? args.slice(0, -1) : args) as Obj[];\n\n  if (items.length === 0) return {} as Merge<T>;\n\n  return items.reduce((acc: Obj, obj: Obj) => mergeObjects(acc, obj, options) as Obj, {} as Obj) as unknown as Merge<T>;\n}\n\n/**\n * Shallowly merges two or more objects. Later sources win for duplicate keys.\n * Dangerous keys (`__proto__`, `constructor`, `prototype`) are always skipped.\n *\n * @example\n * ```ts\n * shallowMerge({ a: 1, b: { x: 1 } }, { b: { y: 2 } });\n * // { a: 1, b: { y: 2 } }  ← nested object replaced, not merged\n *\n * shallowMerge(defaults, overrides, extras);\n * ```\n */\nexport function shallowMerge<T extends Obj[]>(...items: [...T]): Merge<T> {\n  if (items.length === 0) return {} as Merge<T>;\n\n  const result: Obj = {};\n\n  for (const item of items) {\n    for (const key of Object.keys(item)) {\n      if (isUnsafeKey(key)) continue;\n\n      result[key] = item[key];\n    }\n  }\n\n  return result as Merge<T>;\n}\n"],"mappings":";;;AAgCA,SAAS,EAA2C,GAAW,GAAW,GAA4C;CACpH,IAAI,CAAC,EAAc,CAAM,GAAG,OAAO;CAEnC,IAAM,IAAS,EAAE,GAAG,EAAO;CAE3B,KAAK,IAAM,KAAO,OAAO,KAAK,CAAM,GAAG;EAErC,IAAI,EAAY,CAAG,GACjB;EAGF,IAAM,IAAc,EAAO,IACrB,IAAc,EAAO;EAE3B,EAAoC,KAClC,MAAM,QAAQ,CAAW,KAAK,MAAM,QAAQ,CAAW,IACnD,EAAQ,kBAAkB,WACxB,CAAC,GAAG,GAAa,GAAG,CAAW,IAC/B,IACF,EAAc,CAAW,KAAK,EAAc,CAAW,IACrD,EAAa,GAAoB,GAAoB,CAAO,IAC5D;CACV;CAEA,OAAO;AACT;AAkBA,SAAgB,EAA2B,GAAG,GAAmD;CAC/F,IAAM,IAAU,EAAK,EAAK,SAAS,IAC7B,IACJ,EAAK,SAAS,KACd,OAAO,KAAY,cACnB,KACA,CAAC,MAAM,QAAQ,CAAO,KACtB,mBAAmB,KACnB,OAAO,KAAK,CAAO,CAAC,CAAC,WAAW,MAC9B,EAA6B,kBAAkB,YAC9C,EAA6B,kBAAkB,YAE9C,IAA4B,IAAc,IAA+B,CAAC,GAC1E,IAAS,IAAa,EAAK,MAAM,GAAG,EAAE,IAAI;CAIhD,OAFI,EAAM,WAAW,IAAU,CAAC,IAEzB,EAAM,QAAQ,GAAU,MAAa,EAAa,GAAK,GAAK,CAAO,GAAU,CAAC,CAAQ;AAC/F;AAcA,SAAgB,EAA8B,GAAG,GAAyB;CACxE,IAAI,EAAM,WAAW,GAAG,OAAO,CAAC;CAEhC,IAAM,IAAc,CAAC;CAErB,KAAK,IAAM,KAAQ,GACjB,KAAK,IAAM,KAAO,OAAO,KAAK,CAAI,GAC5B,EAAY,CAAG,MAEnB,EAAO,KAAO,EAAK;CAIvB,OAAO;AACT"}

package/dist/object/omit.cjs

@@ -0,0 +1,2 @@
+const e=require("../_common/unsafePaths.cjs");function t(t,n){let r=new Set(n),i={};for(let n of Object.keys(t))e.isUnsafeKey(n)||r.has(n)||(i[n]=t[n]);return i}exports.omit=t;
+//# sourceMappingURL=omit.cjs.map

package/dist/object/omit.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"omit.cjs","names":[],"sources":["../../src/object/omit.ts"],"sourcesContent":["import type { Obj } from '../types';\n\nimport { isUnsafeKey } from '../_common/unsafePaths';\n\n/**\n * Creates a new object without the selected keys. Only `obj`'s own enumerable keys are\n * considered; dangerous keys (`__proto__`, `constructor`, `prototype`) are always skipped.\n *\n * @example\n * ```ts\n * omit({ a: 1, b: 2, c: 3 }, ['b']); // { a: 1, c: 3 }\n * ```\n *\n * @param obj - The source object.\n * @param omittedKeys - The keys to exclude.\n * @returns A new object with `omittedKeys` removed.\n */\nexport function omit<T extends Obj, K extends keyof T>(obj: T, omittedKeys: readonly K[]): Omit<T, K> {\n  const blacklist = new Set<PropertyKey>(omittedKeys as readonly PropertyKey[]);\n  const out = {} as Omit<T, K>;\n\n  for (const key of Object.keys(obj) as Array<keyof T>) {\n    if (isUnsafeKey(key as PropertyKey)) continue;\n\n    if (!blacklist.has(key)) {\n      (out as T)[key] = obj[key];\n    }\n  }\n\n  return out;\n}\n"],"mappings":"8CAiBA,SAAgB,EAAuC,EAAQ,EAAuC,CACpG,IAAM,EAAY,IAAI,IAAiB,CAAqC,EACtE,EAAM,CAAC,EAEb,IAAK,IAAM,KAAO,OAAO,KAAK,CAAG,EAC3B,EAAA,YAAY,CAAkB,GAE7B,EAAU,IAAI,CAAG,IACpB,EAAW,GAAO,EAAI,IAI1B,OAAO,CACT"}

package/dist/object/omit.d.ts

@@ -0,0 +1,16 @@
+import type { Obj } from '../types';
+/**
+ * Creates a new object without the selected keys. Only `obj`'s own enumerable keys are
+ * considered; dangerous keys (`__proto__`, `constructor`, `prototype`) are always skipped.
+ *
+ * @example
+ * ```ts
+ * omit({ a: 1, b: 2, c: 3 }, ['b']); // { a: 1, c: 3 }
+ * ```
+ *
+ * @param obj - The source object.
+ * @param omittedKeys - The keys to exclude.
+ * @returns A new object with `omittedKeys` removed.
+ */
+export declare function omit<T extends Obj, K extends keyof T>(obj: T, omittedKeys: readonly K[]): Omit<T, K>;
+//# sourceMappingURL=omit.d.ts.map

package/dist/object/omit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"omit.d.ts","sourceRoot":"","sources":["../../src/object/omit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAIpC;;;;;;;;;;;;GAYG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAapG"}

package/dist/object/omit.js

@@ -0,0 +1,11 @@
+import { isUnsafeKey as e } from "../_common/unsafePaths.js";
+//#region src/object/omit.ts
+function t(t, n) {
+	let r = new Set(n), i = {};
+	for (let n of Object.keys(t)) e(n) || r.has(n) || (i[n] = t[n]);
+	return i;
+}
+//#endregion
+export { t as omit };
+
+//# sourceMappingURL=omit.js.map

package/dist/object/omit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"omit.js","names":[],"sources":["../../src/object/omit.ts"],"sourcesContent":["import type { Obj } from '../types';\n\nimport { isUnsafeKey } from '../_common/unsafePaths';\n\n/**\n * Creates a new object without the selected keys. Only `obj`'s own enumerable keys are\n * considered; dangerous keys (`__proto__`, `constructor`, `prototype`) are always skipped.\n *\n * @example\n * ```ts\n * omit({ a: 1, b: 2, c: 3 }, ['b']); // { a: 1, c: 3 }\n * ```\n *\n * @param obj - The source object.\n * @param omittedKeys - The keys to exclude.\n * @returns A new object with `omittedKeys` removed.\n */\nexport function omit<T extends Obj, K extends keyof T>(obj: T, omittedKeys: readonly K[]): Omit<T, K> {\n  const blacklist = new Set<PropertyKey>(omittedKeys as readonly PropertyKey[]);\n  const out = {} as Omit<T, K>;\n\n  for (const key of Object.keys(obj) as Array<keyof T>) {\n    if (isUnsafeKey(key as PropertyKey)) continue;\n\n    if (!blacklist.has(key)) {\n      (out as T)[key] = obj[key];\n    }\n  }\n\n  return out;\n}\n"],"mappings":";;AAiBA,SAAgB,EAAuC,GAAQ,GAAuC;CACpG,IAAM,IAAY,IAAI,IAAiB,CAAqC,GACtE,IAAM,CAAC;CAEb,KAAK,IAAM,KAAO,OAAO,KAAK,CAAG,GAC3B,EAAY,CAAkB,KAE7B,EAAU,IAAI,CAAG,MACpB,EAAW,KAAO,EAAI;CAI1B,OAAO;AACT"}

package/dist/object/parseJSON.cjs

@@ -0,0 +1,2 @@
+const e=require("../guards/isNil.cjs");function t(t,n={}){let{fallback:r,reviver:i,validator:a}=n;if(e.isNil(t))return r;try{let e=JSON.parse(t,i);return e===void 0||a&&!a(e)?r:e}catch{return r}}exports.parseJSON=t;
+//# sourceMappingURL=parseJSON.cjs.map

package/dist/object/parseJSON.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseJSON.cjs","names":[],"sources":["../../src/object/parseJSON.ts"],"sourcesContent":["import { isNil } from '../guards/isNil';\n\nexport type ParseJSONOptions<T> = {\n  fallback?: T;\n  reviver?: (key: string, value: unknown) => unknown;\n  validator?: (parsed: unknown) => boolean;\n};\n\n/**\n * Parses a JSON string and returns the resulting value.\n * `null` and `undefined` inputs return `fallback` without throwing.\n *\n * @example\n * ```ts\n * parseJSON<Record<string, number>>('{\"a\":1}'); // { a: 1 }\n * parseJSON('bad json', { fallback: {} }); // {}\n * parseJSON(null, { fallback: 0 }); // 0\n *\n * // With a validator — returns fallback when validation fails\n * parseJSON('{\"id\":\"bad\"}', {\n *   validator: (v) => typeof (v as Record<string, unknown>).id === 'number',\n *   fallback: { id: 0 },\n * }); // { id: 0 }\n * ```\n *\n * @template T - The expected type of the parsed JSON.\n * @param json - The JSON string to parse. `null` / `undefined` return `fallback`.\n * @param [options.fallback] - Value to return when parsing fails, input is nullish, or validation fails.\n * @param [options.reviver] - Optional reviver function for `JSON.parse`.\n * @param [options.validator] - Optional predicate; if it returns `false`, `fallback` is returned.\n *\n * @returns The parsed value, or `fallback` on failure.\n */\nexport function parseJSON<T = unknown>(\n  json: string | null | undefined,\n  options: ParseJSONOptions<T> = {},\n): T | undefined {\n  const { fallback, reviver, validator } = options;\n\n  if (isNil(json)) return fallback;\n\n  try {\n    const value = JSON.parse(json, reviver as Parameters<typeof JSON.parse>[1]) as unknown;\n\n    if (value === undefined) return fallback;\n\n    if (validator && !validator(value)) return fallback;\n\n    return value as T | undefined;\n  } catch {\n    return fallback;\n  }\n}\n"],"mappings":"uCAiCA,SAAgB,EACd,EACA,EAA+B,CAAC,EACjB,CACf,GAAM,CAAE,WAAU,UAAS,aAAc,EAEzC,GAAI,EAAA,MAAM,CAAI,EAAG,OAAO,EAExB,GAAI,CACF,IAAM,EAAQ,KAAK,MAAM,EAAM,CAA2C,EAM1E,OAJI,IAAU,IAAA,IAEV,GAAa,CAAC,EAAU,CAAK,EAAU,EAEpC,CACT,MAAQ,CACN,OAAO,CACT,CACF"}

package/dist/object/parseJSON.d.ts

@@ -0,0 +1,32 @@
+export type ParseJSONOptions<T> = {
+    fallback?: T;
+    reviver?: (key: string, value: unknown) => unknown;
+    validator?: (parsed: unknown) => boolean;
+};
+/**
+ * Parses a JSON string and returns the resulting value.
+ * `null` and `undefined` inputs return `fallback` without throwing.
+ *
+ * @example
+ * ```ts
+ * parseJSON<Record<string, number>>('{"a":1}'); // { a: 1 }
+ * parseJSON('bad json', { fallback: {} }); // {}
+ * parseJSON(null, { fallback: 0 }); // 0
+ *
+ * // With a validator — returns fallback when validation fails
+ * parseJSON('{"id":"bad"}', {
+ *   validator: (v) => typeof (v as Record<string, unknown>).id === 'number',
+ *   fallback: { id: 0 },
+ * }); // { id: 0 }
+ * ```
+ *
+ * @template T - The expected type of the parsed JSON.
+ * @param json - The JSON string to parse. `null` / `undefined` return `fallback`.
+ * @param [options.fallback] - Value to return when parsing fails, input is nullish, or validation fails.
+ * @param [options.reviver] - Optional reviver function for `JSON.parse`.
+ * @param [options.validator] - Optional predicate; if it returns `false`, `fallback` is returned.
+ *
+ * @returns The parsed value, or `fallback` on failure.
+ */
+export declare function parseJSON<T = unknown>(json: string | null | undefined, options?: ParseJSONOptions<T>): T | undefined;
+//# sourceMappingURL=parseJSON.d.ts.map

package/dist/object/parseJSON.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseJSON.d.ts","sourceRoot":"","sources":["../../src/object/parseJSON.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;IAChC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACb,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACnD,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;CAC1C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EACnC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,OAAO,GAAE,gBAAgB,CAAC,CAAC,CAAM,GAChC,CAAC,GAAG,SAAS,CAgBf"}

package/dist/object/parseJSON.js

@@ -0,0 +1,16 @@
+import { isNil as e } from "../guards/isNil.js";
+//#region src/object/parseJSON.ts
+function t(t, n = {}) {
+	let { fallback: r, reviver: i, validator: a } = n;
+	if (e(t)) return r;
+	try {
+		let e = JSON.parse(t, i);
+		return e === void 0 || a && !a(e) ? r : e;
+	} catch {
+		return r;
+	}
+}
+//#endregion
+export { t as parseJSON };
+
+//# sourceMappingURL=parseJSON.js.map

package/dist/object/parseJSON.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseJSON.js","names":[],"sources":["../../src/object/parseJSON.ts"],"sourcesContent":["import { isNil } from '../guards/isNil';\n\nexport type ParseJSONOptions<T> = {\n  fallback?: T;\n  reviver?: (key: string, value: unknown) => unknown;\n  validator?: (parsed: unknown) => boolean;\n};\n\n/**\n * Parses a JSON string and returns the resulting value.\n * `null` and `undefined` inputs return `fallback` without throwing.\n *\n * @example\n * ```ts\n * parseJSON<Record<string, number>>('{\"a\":1}'); // { a: 1 }\n * parseJSON('bad json', { fallback: {} }); // {}\n * parseJSON(null, { fallback: 0 }); // 0\n *\n * // With a validator — returns fallback when validation fails\n * parseJSON('{\"id\":\"bad\"}', {\n *   validator: (v) => typeof (v as Record<string, unknown>).id === 'number',\n *   fallback: { id: 0 },\n * }); // { id: 0 }\n * ```\n *\n * @template T - The expected type of the parsed JSON.\n * @param json - The JSON string to parse. `null` / `undefined` return `fallback`.\n * @param [options.fallback] - Value to return when parsing fails, input is nullish, or validation fails.\n * @param [options.reviver] - Optional reviver function for `JSON.parse`.\n * @param [options.validator] - Optional predicate; if it returns `false`, `fallback` is returned.\n *\n * @returns The parsed value, or `fallback` on failure.\n */\nexport function parseJSON<T = unknown>(\n  json: string | null | undefined,\n  options: ParseJSONOptions<T> = {},\n): T | undefined {\n  const { fallback, reviver, validator } = options;\n\n  if (isNil(json)) return fallback;\n\n  try {\n    const value = JSON.parse(json, reviver as Parameters<typeof JSON.parse>[1]) as unknown;\n\n    if (value === undefined) return fallback;\n\n    if (validator && !validator(value)) return fallback;\n\n    return value as T | undefined;\n  } catch {\n    return fallback;\n  }\n}\n"],"mappings":";;AAiCA,SAAgB,EACd,GACA,IAA+B,CAAC,GACjB;CACf,IAAM,EAAE,aAAU,YAAS,iBAAc;CAEzC,IAAI,EAAM,CAAI,GAAG,OAAO;CAExB,IAAI;EACF,IAAM,IAAQ,KAAK,MAAM,GAAM,CAA2C;EAM1E,OAJI,MAAU,KAAA,KAEV,KAAa,CAAC,EAAU,CAAK,IAAU,IAEpC;CACT,QAAQ;EACN,OAAO;CACT;AACF"}

package/dist/object/pick.cjs

@@ -0,0 +1,2 @@
+const e=require("../_common/unsafePaths.cjs");function t(t,n){let r={};for(let i of n)e.isUnsafeKey(i)||Object.hasOwn(t,i)&&(r[i]=t[i]);return r}exports.pick=t;
+//# sourceMappingURL=pick.cjs.map

package/dist/object/pick.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick.cjs","names":[],"sources":["../../src/object/pick.ts"],"sourcesContent":["import type { Obj } from '../types';\n\nimport { isUnsafeKey } from '../_common/unsafePaths';\n\n/**\n * Creates a new object containing only selected keys. Only `obj`'s own enumerable keys are\n * considered — inherited properties (e.g. `toString`) are never picked, and dangerous keys\n * (`__proto__`, `constructor`, `prototype`) are always skipped.\n *\n * @example\n * ```ts\n * pick({ a: 1, b: 2, c: 3 }, ['a', 'c']); // { a: 1, c: 3 }\n * ```\n *\n * @param obj - The source object.\n * @param selectedKeys - The keys to keep.\n * @returns A new object containing only `selectedKeys` that exist as own properties of `obj`.\n */\nexport function pick<T extends Obj, K extends keyof T>(obj: T, selectedKeys: readonly K[]): Pick<T, K> {\n  const out = {} as Pick<T, K>;\n\n  for (const key of selectedKeys) {\n    if (isUnsafeKey(key as PropertyKey)) continue;\n\n    if (Object.hasOwn(obj, key)) {\n      out[key] = obj[key];\n    }\n  }\n\n  return out;\n}\n"],"mappings":"8CAkBA,SAAgB,EAAuC,EAAQ,EAAwC,CACrG,IAAM,EAAM,CAAC,EAEb,IAAK,IAAM,KAAO,EACZ,EAAA,YAAY,CAAkB,GAE9B,OAAO,OAAO,EAAK,CAAG,IACxB,EAAI,GAAO,EAAI,IAInB,OAAO,CACT"}

package/dist/object/pick.d.ts

@@ -0,0 +1,17 @@
+import type { Obj } from '../types';
+/**
+ * Creates a new object containing only selected keys. Only `obj`'s own enumerable keys are
+ * considered — inherited properties (e.g. `toString`) are never picked, and dangerous keys
+ * (`__proto__`, `constructor`, `prototype`) are always skipped.
+ *
+ * @example
+ * ```ts
+ * pick({ a: 1, b: 2, c: 3 }, ['a', 'c']); // { a: 1, c: 3 }
+ * ```
+ *
+ * @param obj - The source object.
+ * @param selectedKeys - The keys to keep.
+ * @returns A new object containing only `selectedKeys` that exist as own properties of `obj`.
+ */
+export declare function pick<T extends Obj, K extends keyof T>(obj: T, selectedKeys: readonly K[]): Pick<T, K>;
+//# sourceMappingURL=pick.d.ts.map

package/dist/object/pick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick.d.ts","sourceRoot":"","sources":["../../src/object/pick.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAIpC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAYrG"}

package/dist/object/pick.js

@@ -0,0 +1,11 @@
+import { isUnsafeKey as e } from "../_common/unsafePaths.js";
+//#region src/object/pick.ts
+function t(t, n) {
+	let r = {};
+	for (let i of n) e(i) || Object.hasOwn(t, i) && (r[i] = t[i]);
+	return r;
+}
+//#endregion
+export { t as pick };
+
+//# sourceMappingURL=pick.js.map

package/dist/object/pick.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick.js","names":[],"sources":["../../src/object/pick.ts"],"sourcesContent":["import type { Obj } from '../types';\n\nimport { isUnsafeKey } from '../_common/unsafePaths';\n\n/**\n * Creates a new object containing only selected keys. Only `obj`'s own enumerable keys are\n * considered — inherited properties (e.g. `toString`) are never picked, and dangerous keys\n * (`__proto__`, `constructor`, `prototype`) are always skipped.\n *\n * @example\n * ```ts\n * pick({ a: 1, b: 2, c: 3 }, ['a', 'c']); // { a: 1, c: 3 }\n * ```\n *\n * @param obj - The source object.\n * @param selectedKeys - The keys to keep.\n * @returns A new object containing only `selectedKeys` that exist as own properties of `obj`.\n */\nexport function pick<T extends Obj, K extends keyof T>(obj: T, selectedKeys: readonly K[]): Pick<T, K> {\n  const out = {} as Pick<T, K>;\n\n  for (const key of selectedKeys) {\n    if (isUnsafeKey(key as PropertyKey)) continue;\n\n    if (Object.hasOwn(obj, key)) {\n      out[key] = obj[key];\n    }\n  }\n\n  return out;\n}\n"],"mappings":";;AAkBA,SAAgB,EAAuC,GAAQ,GAAwC;CACrG,IAAM,IAAM,CAAC;CAEb,KAAK,IAAM,KAAO,GACZ,EAAY,CAAkB,KAE9B,OAAO,OAAO,GAAK,CAAG,MACxB,EAAI,KAAO,EAAI;CAInB,OAAO;AACT"}

package/dist/object/prune.cjs

@@ -0,0 +1,2 @@
+const e=require("../guards/isString.cjs"),t=require("../_common/unsafePaths.cjs"),n=require("../array/filterMap.cjs"),r=require("../guards/isNil.cjs"),i=require("../guards/isPlainObject.cjs"),a=require("../guards/isEmpty.cjs");function o(s){if(!r.isNil(s)){if(e.isString(s)){let e=s.trim();return e===``?void 0:e}if(Array.isArray(s)){let e=n.filterMap(s,e=>{let t=o(e);return a.isEmpty(t)?void 0:t});return e.length===0?void 0:e}if(i.isPlainObject(s)){let e={};for(let[n,r]of Object.entries(s)){if(t.isUnsafeKey(n))continue;let i=o(r);a.isEmpty(i)||(e[n]=i)}return Object.keys(e).length===0?void 0:e}return s}}exports.prune=o;
+//# sourceMappingURL=prune.cjs.map

package/dist/object/prune.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune.cjs","names":[],"sources":["../../src/object/prune.ts"],"sourcesContent":["import { isUnsafeKey } from '../_common/unsafePaths';\nimport { filterMap } from '../array/filterMap';\nimport { isEmpty } from '../guards/isEmpty';\nimport { isNil } from '../guards/isNil';\nimport { isPlainObject } from '../guards/isPlainObject';\nimport { isString } from '../guards/isString';\n\n/**\n * Removes all nullable and empty values from strings, arrays, or objects.\n *\n * - For strings: trims whitespace and returns `undefined` if the result is empty.\n * - For arrays: recursively removes `null`, `undefined`, empty strings, and empty objects/arrays.\n * - For objects: recursively removes properties whose pruned value is empty. Dangerous keys\n *   (`__proto__`, `constructor`, `prototype`) are always skipped.\n * - For any other type: returns the value unchanged.\n *\n * @example\n * ```ts\n * prune('  hello  '); // 'hello'\n * prune('   ');       // undefined\n * prune([1, null, '', 2, undefined, 3]); // [1, 2, 3]\n * prune({ a: 1, b: null, c: '', d: 2 }); // { a: 1, d: 2 }\n * prune({ a: { b: null, c: '' }, d: 1 }); // { d: 1 }\n * ```\n *\n * @param value - The value to prune.\n * @returns The pruned value, or `undefined` if the result would be empty.\n */\nexport function prune(value: string): string | undefined;\nexport function prune<T>(value: T[]): Array<NonNullable<T>> | undefined;\nexport function prune<T extends Record<string, unknown>>(value: T): Partial<T> | undefined;\nexport function prune<T>(value: T): T | undefined;\nexport function prune<T>(value: T): T | undefined {\n  if (isNil(value)) return undefined;\n\n  if (isString(value)) {\n    const trimmed = value.trim();\n\n    return (trimmed === '' ? undefined : trimmed) as T | undefined;\n  }\n\n  if (Array.isArray(value)) {\n    const cleaned = filterMap(value as unknown[], (item) => {\n      const pruned = prune(item);\n\n      return isEmpty(pruned) ? undefined : (pruned as unknown);\n    });\n\n    return (cleaned.length === 0 ? undefined : cleaned) as T | undefined;\n  }\n\n  if (isPlainObject(value)) {\n    const cleaned: Record<string, unknown> = {};\n\n    for (const [key, val] of Object.entries(value)) {\n      if (isUnsafeKey(key)) continue;\n\n      const cleanedValue = prune(val);\n\n      if (!isEmpty(cleanedValue)) {\n        cleaned[key] = cleanedValue;\n      }\n    }\n\n    return (Object.keys(cleaned).length === 0 ? undefined : cleaned) as T | undefined;\n  }\n\n  return value;\n}\n"],"mappings":"mOAgCA,SAAgB,EAAS,EAAyB,CAC5C,MAAA,MAAM,CAAK,EAEf,IAAI,EAAA,SAAS,CAAK,EAAG,CACnB,IAAM,EAAU,EAAM,KAAK,EAE3B,OAAQ,IAAY,GAAK,IAAA,GAAY,CACvC,CAEA,GAAI,MAAM,QAAQ,CAAK,EAAG,CACxB,IAAM,EAAU,EAAA,UAAU,EAAqB,GAAS,CACtD,IAAM,EAAS,EAAM,CAAI,EAEzB,OAAO,EAAA,QAAQ,CAAM,EAAI,IAAA,GAAa,CACxC,CAAC,EAED,OAAQ,EAAQ,SAAW,EAAI,IAAA,GAAY,CAC7C,CAEA,GAAI,EAAA,cAAc,CAAK,EAAG,CACxB,IAAM,EAAmC,CAAC,EAE1C,IAAK,GAAM,CAAC,EAAK,KAAQ,OAAO,QAAQ,CAAK,EAAG,CAC9C,GAAI,EAAA,YAAY,CAAG,EAAG,SAEtB,IAAM,EAAe,EAAM,CAAG,EAEzB,EAAA,QAAQ,CAAY,IACvB,EAAQ,GAAO,EAEnB,CAEA,OAAQ,OAAO,KAAK,CAAO,CAAC,CAAC,SAAW,EAAI,IAAA,GAAY,CAC1D,CAEA,OAAO,CA5BP,CA6BF"}

package/dist/object/prune.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Removes all nullable and empty values from strings, arrays, or objects.
+ *
+ * - For strings: trims whitespace and returns `undefined` if the result is empty.
+ * - For arrays: recursively removes `null`, `undefined`, empty strings, and empty objects/arrays.
+ * - For objects: recursively removes properties whose pruned value is empty. Dangerous keys
+ *   (`__proto__`, `constructor`, `prototype`) are always skipped.
+ * - For any other type: returns the value unchanged.
+ *
+ * @example
+ * ```ts
+ * prune('  hello  '); // 'hello'
+ * prune('   ');       // undefined
+ * prune([1, null, '', 2, undefined, 3]); // [1, 2, 3]
+ * prune({ a: 1, b: null, c: '', d: 2 }); // { a: 1, d: 2 }
+ * prune({ a: { b: null, c: '' }, d: 1 }); // { d: 1 }
+ * ```
+ *
+ * @param value - The value to prune.
+ * @returns The pruned value, or `undefined` if the result would be empty.
+ */
+export declare function prune(value: string): string | undefined;
+export declare function prune<T>(value: T[]): Array<NonNullable<T>> | undefined;
+export declare function prune<T extends Record<string, unknown>>(value: T): Partial<T> | undefined;
+export declare function prune<T>(value: T): T | undefined;
+//# sourceMappingURL=prune.d.ts.map

package/dist/object/prune.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune.d.ts","sourceRoot":"","sources":["../../src/object/prune.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AACzD,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;AACxE,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;AAC3F,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC"}

package/dist/object/prune.js

@@ -0,0 +1,36 @@
+import { isString as e } from "../guards/isString.js";
+import { isUnsafeKey as t } from "../_common/unsafePaths.js";
+import { filterMap as n } from "../array/filterMap.js";
+import { isNil as r } from "../guards/isNil.js";
+import { isPlainObject as i } from "../guards/isPlainObject.js";
+import { isEmpty as a } from "../guards/isEmpty.js";
+//#region src/object/prune.ts
+function o(s) {
+	if (!r(s)) {
+		if (e(s)) {
+			let e = s.trim();
+			return e === "" ? void 0 : e;
+		}
+		if (Array.isArray(s)) {
+			let e = n(s, (e) => {
+				let t = o(e);
+				return a(t) ? void 0 : t;
+			});
+			return e.length === 0 ? void 0 : e;
+		}
+		if (i(s)) {
+			let e = {};
+			for (let [n, r] of Object.entries(s)) {
+				if (t(n)) continue;
+				let i = o(r);
+				a(i) || (e[n] = i);
+			}
+			return Object.keys(e).length === 0 ? void 0 : e;
+		}
+		return s;
+	}
+}
+//#endregion
+export { o as prune };
+
+//# sourceMappingURL=prune.js.map

package/dist/object/prune.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune.js","names":[],"sources":["../../src/object/prune.ts"],"sourcesContent":["import { isUnsafeKey } from '../_common/unsafePaths';\nimport { filterMap } from '../array/filterMap';\nimport { isEmpty } from '../guards/isEmpty';\nimport { isNil } from '../guards/isNil';\nimport { isPlainObject } from '../guards/isPlainObject';\nimport { isString } from '../guards/isString';\n\n/**\n * Removes all nullable and empty values from strings, arrays, or objects.\n *\n * - For strings: trims whitespace and returns `undefined` if the result is empty.\n * - For arrays: recursively removes `null`, `undefined`, empty strings, and empty objects/arrays.\n * - For objects: recursively removes properties whose pruned value is empty. Dangerous keys\n *   (`__proto__`, `constructor`, `prototype`) are always skipped.\n * - For any other type: returns the value unchanged.\n *\n * @example\n * ```ts\n * prune('  hello  '); // 'hello'\n * prune('   ');       // undefined\n * prune([1, null, '', 2, undefined, 3]); // [1, 2, 3]\n * prune({ a: 1, b: null, c: '', d: 2 }); // { a: 1, d: 2 }\n * prune({ a: { b: null, c: '' }, d: 1 }); // { d: 1 }\n * ```\n *\n * @param value - The value to prune.\n * @returns The pruned value, or `undefined` if the result would be empty.\n */\nexport function prune(value: string): string | undefined;\nexport function prune<T>(value: T[]): Array<NonNullable<T>> | undefined;\nexport function prune<T extends Record<string, unknown>>(value: T): Partial<T> | undefined;\nexport function prune<T>(value: T): T | undefined;\nexport function prune<T>(value: T): T | undefined {\n  if (isNil(value)) return undefined;\n\n  if (isString(value)) {\n    const trimmed = value.trim();\n\n    return (trimmed === '' ? undefined : trimmed) as T | undefined;\n  }\n\n  if (Array.isArray(value)) {\n    const cleaned = filterMap(value as unknown[], (item) => {\n      const pruned = prune(item);\n\n      return isEmpty(pruned) ? undefined : (pruned as unknown);\n    });\n\n    return (cleaned.length === 0 ? undefined : cleaned) as T | undefined;\n  }\n\n  if (isPlainObject(value)) {\n    const cleaned: Record<string, unknown> = {};\n\n    for (const [key, val] of Object.entries(value)) {\n      if (isUnsafeKey(key)) continue;\n\n      const cleanedValue = prune(val);\n\n      if (!isEmpty(cleanedValue)) {\n        cleaned[key] = cleanedValue;\n      }\n    }\n\n    return (Object.keys(cleaned).length === 0 ? undefined : cleaned) as T | undefined;\n  }\n\n  return value;\n}\n"],"mappings":";;;;;;;AAgCA,SAAgB,EAAS,GAAyB;CAC5C,OAAM,CAAK,GAEf;MAAI,EAAS,CAAK,GAAG;GACnB,IAAM,IAAU,EAAM,KAAK;GAE3B,OAAQ,MAAY,KAAK,KAAA,IAAY;EACvC;EAEA,IAAI,MAAM,QAAQ,CAAK,GAAG;GACxB,IAAM,IAAU,EAAU,IAAqB,MAAS;IACtD,IAAM,IAAS,EAAM,CAAI;IAEzB,OAAO,EAAQ,CAAM,IAAI,KAAA,IAAa;GACxC,CAAC;GAED,OAAQ,EAAQ,WAAW,IAAI,KAAA,IAAY;EAC7C;EAEA,IAAI,EAAc,CAAK,GAAG;GACxB,IAAM,IAAmC,CAAC;GAE1C,KAAK,IAAM,CAAC,GAAK,MAAQ,OAAO,QAAQ,CAAK,GAAG;IAC9C,IAAI,EAAY,CAAG,GAAG;IAEtB,IAAM,IAAe,EAAM,CAAG;IAE9B,AAAK,EAAQ,CAAY,MACvB,EAAQ,KAAO;GAEnB;GAEA,OAAQ,OAAO,KAAK,CAAO,CAAC,CAAC,WAAW,IAAI,KAAA,IAAY;EAC1D;EAEA,OAAO;CA5BP;AA6BF"}

package/dist/random/draw.cjs

@@ -0,0 +1,2 @@
+const e=require("../_common/_secureRandomIndex.cjs"),t=require("./random.cjs");function n(e){if(e.length!==0)return e[t.random(0,e.length-1)]}function r(t,n){let r=Math.max(0,Math.min(t.length,Math.floor(n)));if(r===0)return[];if(r===t.length)return[...t];let i=[...t];for(let t=i.length-1;t>0;t--){let n=e.secureRandomIndex(t+1),r=i[t];i[t]=i[n],i[n]=r}return i.slice(0,r)}exports.draw=n,exports.drawMany=r;
+//# sourceMappingURL=draw.cjs.map

package/dist/random/draw.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"draw.cjs","names":[],"sources":["../../src/random/draw.ts"],"sourcesContent":["import { secureRandomIndex } from '../_common/_secureRandomIndex';\nimport { random } from './random';\n\n/**\n * Picks a single random item from an array.\n * Returns `undefined` if the array is empty.\n *\n * @example\n * ```ts\n * draw([1, 2, 3]); // e.g. 2\n * draw([]);         // undefined\n * ```\n */\nexport function draw<T>(array: T[]): T | undefined {\n  if (array.length === 0) return undefined;\n\n  return array[random(0, array.length - 1)];\n}\n\n/**\n * Picks up to `n` unique random items from an array using a cryptographically\n * random shuffle (Fisher-Yates via `crypto.getRandomValues`).\n * Returns a new array; does not mutate the input.\n *\n * @example\n * ```ts\n * drawMany([1, 2, 3, 4, 5], 3); // e.g. [4, 1, 3]\n * drawMany([1, 2], 10);          // [1, 2] (clamped to array length)\n * ```\n */\nexport function drawMany<T>(array: T[], n: number): T[] {\n  const count = Math.max(0, Math.min(array.length, Math.floor(n)));\n\n  if (count === 0) return [];\n\n  if (count === array.length) return [...array];\n\n  const copy = [...array];\n\n  for (let index = copy.length - 1; index > 0; index--) {\n    const randomIndex = secureRandomIndex(index + 1);\n    const temp = copy[index];\n\n    copy[index] = copy[randomIndex]!;\n    copy[randomIndex] = temp!;\n  }\n\n  return copy.slice(0, count);\n}\n"],"mappings":"+EAaA,SAAgB,EAAQ,EAA2B,CAC7C,KAAM,SAAW,EAErB,OAAO,EAAM,EAAA,OAAO,EAAG,EAAM,OAAS,CAAC,EACzC,CAaA,SAAgB,EAAY,EAAY,EAAgB,CACtD,IAAM,EAAQ,KAAK,IAAI,EAAG,KAAK,IAAI,EAAM,OAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,EAE/D,GAAI,IAAU,EAAG,MAAO,CAAC,EAEzB,GAAI,IAAU,EAAM,OAAQ,MAAO,CAAC,GAAG,CAAK,EAE5C,IAAM,EAAO,CAAC,GAAG,CAAK,EAEtB,IAAK,IAAI,EAAQ,EAAK,OAAS,EAAG,EAAQ,EAAG,IAAS,CACpD,IAAM,EAAc,EAAA,kBAAkB,EAAQ,CAAC,EACzC,EAAO,EAAK,GAElB,EAAK,GAAS,EAAK,GACnB,EAAK,GAAe,CACtB,CAEA,OAAO,EAAK,MAAM,EAAG,CAAK,CAC5B"}

package/dist/random/draw.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Picks a single random item from an array.
+ * Returns `undefined` if the array is empty.
+ *
+ * @example
+ * ```ts
+ * draw([1, 2, 3]); // e.g. 2
+ * draw([]);         // undefined
+ * ```
+ */
+export declare function draw<T>(array: T[]): T | undefined;
+/**
+ * Picks up to `n` unique random items from an array using a cryptographically
+ * random shuffle (Fisher-Yates via `crypto.getRandomValues`).
+ * Returns a new array; does not mutate the input.
+ *
+ * @example
+ * ```ts
+ * drawMany([1, 2, 3, 4, 5], 3); // e.g. [4, 1, 3]
+ * drawMany([1, 2], 10);          // [1, 2] (clamped to array length)
+ * ```
+ */
+export declare function drawMany<T>(array: T[], n: number): T[];
+//# sourceMappingURL=draw.d.ts.map

package/dist/random/draw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draw.d.ts","sourceRoot":"","sources":["../../src/random/draw.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAIjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAkBtD"}

package/dist/random/draw.js

@@ -0,0 +1,21 @@
+import { secureRandomIndex as e } from "../_common/_secureRandomIndex.js";
+import { random as t } from "./random.js";
+//#region src/random/draw.ts
+function n(e) {
+	if (e.length !== 0) return e[t(0, e.length - 1)];
+}
+function r(t, n) {
+	let r = Math.max(0, Math.min(t.length, Math.floor(n)));
+	if (r === 0) return [];
+	if (r === t.length) return [...t];
+	let i = [...t];
+	for (let t = i.length - 1; t > 0; t--) {
+		let n = e(t + 1), r = i[t];
+		i[t] = i[n], i[n] = r;
+	}
+	return i.slice(0, r);
+}
+//#endregion
+export { n as draw, r as drawMany };
+
+//# sourceMappingURL=draw.js.map

package/dist/random/draw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draw.js","names":[],"sources":["../../src/random/draw.ts"],"sourcesContent":["import { secureRandomIndex } from '../_common/_secureRandomIndex';\nimport { random } from './random';\n\n/**\n * Picks a single random item from an array.\n * Returns `undefined` if the array is empty.\n *\n * @example\n * ```ts\n * draw([1, 2, 3]); // e.g. 2\n * draw([]);         // undefined\n * ```\n */\nexport function draw<T>(array: T[]): T | undefined {\n  if (array.length === 0) return undefined;\n\n  return array[random(0, array.length - 1)];\n}\n\n/**\n * Picks up to `n` unique random items from an array using a cryptographically\n * random shuffle (Fisher-Yates via `crypto.getRandomValues`).\n * Returns a new array; does not mutate the input.\n *\n * @example\n * ```ts\n * drawMany([1, 2, 3, 4, 5], 3); // e.g. [4, 1, 3]\n * drawMany([1, 2], 10);          // [1, 2] (clamped to array length)\n * ```\n */\nexport function drawMany<T>(array: T[], n: number): T[] {\n  const count = Math.max(0, Math.min(array.length, Math.floor(n)));\n\n  if (count === 0) return [];\n\n  if (count === array.length) return [...array];\n\n  const copy = [...array];\n\n  for (let index = copy.length - 1; index > 0; index--) {\n    const randomIndex = secureRandomIndex(index + 1);\n    const temp = copy[index];\n\n    copy[index] = copy[randomIndex]!;\n    copy[randomIndex] = temp!;\n  }\n\n  return copy.slice(0, count);\n}\n"],"mappings":";;;AAaA,SAAgB,EAAQ,GAA2B;CAC7C,MAAM,WAAW,GAErB,OAAO,EAAM,EAAO,GAAG,EAAM,SAAS,CAAC;AACzC;AAaA,SAAgB,EAAY,GAAY,GAAgB;CACtD,IAAM,IAAQ,KAAK,IAAI,GAAG,KAAK,IAAI,EAAM,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC;CAE/D,IAAI,MAAU,GAAG,OAAO,CAAC;CAEzB,IAAI,MAAU,EAAM,QAAQ,OAAO,CAAC,GAAG,CAAK;CAE5C,IAAM,IAAO,CAAC,GAAG,CAAK;CAEtB,KAAK,IAAI,IAAQ,EAAK,SAAS,GAAG,IAAQ,GAAG,KAAS;EACpD,IAAM,IAAc,EAAkB,IAAQ,CAAC,GACzC,IAAO,EAAK;EAGlB,AADA,EAAK,KAAS,EAAK,IACnB,EAAK,KAAe;CACtB;CAEA,OAAO,EAAK,MAAM,GAAG,CAAK;AAC5B"}

package/dist/random/index.d.ts

@@ -0,0 +1,5 @@
+export * from './draw';
+export * from './random';
+export * from './shuffle';
+export * from './uuid';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/random/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC"}

package/dist/random/random.cjs

@@ -0,0 +1,2 @@
+const e=require("../errors.cjs"),t=require("../_common/_secureRandomIndex.cjs");function n(n,r){if(n>r)throw new e.ArsenalValidationError(`random: minimum value must not be greater than maximum value`);return t.secureRandomIndex(r-n+1)+n}exports.random=n;
+//# sourceMappingURL=random.cjs.map

package/dist/random/random.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.cjs","names":[],"sources":["../../src/random/random.ts"],"sourcesContent":["import { secureRandomIndex } from '../_common/_secureRandomIndex';\nimport { ArsenalValidationError } from '../errors';\n\n/**\n * Generates a random integer between two values, inclusive.\n *\n * @example\n * ```ts\n * random(1, 10); // a random integer between 1 and 10\n * ```\n *\n * @param min - The minimum value.\n * @param max - The maximum value.\n * @returns A random integer between min and max.\n */\nexport function random(min: number, max: number): number {\n  if (min > max) throw new ArsenalValidationError('random: minimum value must not be greater than maximum value');\n\n  return secureRandomIndex(max - min + 1) + min;\n}\n"],"mappings":"gFAeA,SAAgB,EAAO,EAAa,EAAqB,CACvD,GAAI,EAAM,EAAK,MAAM,IAAI,EAAA,uBAAuB,8DAA8D,EAE9G,OAAO,EAAA,kBAAkB,EAAM,EAAM,CAAC,EAAI,CAC5C"}

package/dist/random/random.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Generates a random integer between two values, inclusive.
+ *
+ * @example
+ * ```ts
+ * random(1, 10); // a random integer between 1 and 10
+ * ```
+ *
+ * @param min - The minimum value.
+ * @param max - The maximum value.
+ * @returns A random integer between min and max.
+ */
+export declare function random(min: number, max: number): number;
+//# sourceMappingURL=random.d.ts.map

package/dist/random/random.d.ts.map

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

package/dist/random/random.js

@@ -0,0 +1,11 @@
+import { ArsenalValidationError as e } from "../errors.js";
+import { secureRandomIndex as t } from "../_common/_secureRandomIndex.js";
+//#region src/random/random.ts
+function n(n, r) {
+	if (n > r) throw new e("random: minimum value must not be greater than maximum value");
+	return t(r - n + 1) + n;
+}
+//#endregion
+export { n as random };
+
+//# sourceMappingURL=random.js.map

package/dist/random/random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.js","names":[],"sources":["../../src/random/random.ts"],"sourcesContent":["import { secureRandomIndex } from '../_common/_secureRandomIndex';\nimport { ArsenalValidationError } from '../errors';\n\n/**\n * Generates a random integer between two values, inclusive.\n *\n * @example\n * ```ts\n * random(1, 10); // a random integer between 1 and 10\n * ```\n *\n * @param min - The minimum value.\n * @param max - The maximum value.\n * @returns A random integer between min and max.\n */\nexport function random(min: number, max: number): number {\n  if (min > max) throw new ArsenalValidationError('random: minimum value must not be greater than maximum value');\n\n  return secureRandomIndex(max - min + 1) + min;\n}\n"],"mappings":";;;AAeA,SAAgB,EAAO,GAAa,GAAqB;CACvD,IAAI,IAAM,GAAK,MAAM,IAAI,EAAuB,8DAA8D;CAE9G,OAAO,EAAkB,IAAM,IAAM,CAAC,IAAI;AAC5C"}

package/dist/random/shuffle.cjs

@@ -0,0 +1,2 @@
+const e=require("../_common/_secureRandomIndex.cjs");function t(t){let n=[...t];for(let t=n.length-1;t>0;t--){let r=e.secureRandomIndex(t+1);[n[t],n[r]]=[n[r],n[t]]}return n}exports.shuffle=t;
+//# sourceMappingURL=shuffle.cjs.map

package/dist/random/shuffle.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shuffle.cjs","names":[],"sources":["../../src/random/shuffle.ts"],"sourcesContent":["import { secureRandomIndex } from '../_common/_secureRandomIndex';\n\n/**\n * Returns a new randomly-shuffled copy of the array using Fisher-Yates\n * with `crypto.getRandomValues`. Does not mutate the input.\n *\n * @example\n * ```ts\n * const arr = [1, 2, 3, 4];\n * shuffle(arr); // e.g. [3, 1, 4, 2]\n * ```\n */\nexport function shuffle<T>(array: T[]): T[] {\n  const result = [...array];\n\n  for (let i = result.length - 1; i > 0; i--) {\n    const j = secureRandomIndex(i + 1);\n\n    [result[i], result[j]] = [result[j], result[i]];\n  }\n\n  return result;\n}\n"],"mappings":"qDAYA,SAAgB,EAAW,EAAiB,CAC1C,IAAM,EAAS,CAAC,GAAG,CAAK,EAExB,IAAK,IAAI,EAAI,EAAO,OAAS,EAAG,EAAI,EAAG,IAAK,CAC1C,IAAM,EAAI,EAAA,kBAAkB,EAAI,CAAC,EAEjC,CAAC,EAAO,GAAI,EAAO,IAAM,CAAC,EAAO,GAAI,EAAO,EAAE,CAChD,CAEA,OAAO,CACT"}

package/dist/random/shuffle.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Returns a new randomly-shuffled copy of the array using Fisher-Yates
+ * with `crypto.getRandomValues`. Does not mutate the input.
+ *
+ * @example
+ * ```ts
+ * const arr = [1, 2, 3, 4];
+ * shuffle(arr); // e.g. [3, 1, 4, 2]
+ * ```
+ */
+export declare function shuffle<T>(array: T[]): T[];
+//# sourceMappingURL=shuffle.d.ts.map

package/dist/random/shuffle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shuffle.d.ts","sourceRoot":"","sources":["../../src/random/shuffle.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAU1C"}

package/dist/random/shuffle.js

@@ -0,0 +1,14 @@
+import { secureRandomIndex as e } from "../_common/_secureRandomIndex.js";
+//#region src/random/shuffle.ts
+function t(t) {
+	let n = [...t];
+	for (let t = n.length - 1; t > 0; t--) {
+		let r = e(t + 1);
+		[n[t], n[r]] = [n[r], n[t]];
+	}
+	return n;
+}
+//#endregion
+export { t as shuffle };
+
+//# sourceMappingURL=shuffle.js.map

package/dist/random/shuffle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shuffle.js","names":[],"sources":["../../src/random/shuffle.ts"],"sourcesContent":["import { secureRandomIndex } from '../_common/_secureRandomIndex';\n\n/**\n * Returns a new randomly-shuffled copy of the array using Fisher-Yates\n * with `crypto.getRandomValues`. Does not mutate the input.\n *\n * @example\n * ```ts\n * const arr = [1, 2, 3, 4];\n * shuffle(arr); // e.g. [3, 1, 4, 2]\n * ```\n */\nexport function shuffle<T>(array: T[]): T[] {\n  const result = [...array];\n\n  for (let i = result.length - 1; i > 0; i--) {\n    const j = secureRandomIndex(i + 1);\n\n    [result[i], result[j]] = [result[j], result[i]];\n  }\n\n  return result;\n}\n"],"mappings":";;AAYA,SAAgB,EAAW,GAAiB;CAC1C,IAAM,IAAS,CAAC,GAAG,CAAK;CAExB,KAAK,IAAI,IAAI,EAAO,SAAS,GAAG,IAAI,GAAG,KAAK;EAC1C,IAAM,IAAI,EAAkB,IAAI,CAAC;EAEjC,CAAC,EAAO,IAAI,EAAO,MAAM,CAAC,EAAO,IAAI,EAAO,EAAE;CAChD;CAEA,OAAO;AACT"}

package/dist/random/uuid.cjs

@@ -0,0 +1,2 @@
+function e(){return crypto.randomUUID()}exports.uuid=e;
+//# sourceMappingURL=uuid.cjs.map

package/dist/random/uuid.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.cjs","names":[],"sources":["../../src/random/uuid.ts"],"sourcesContent":["/**\n * Generates a unique identifier.\n *\n * @example\n * ```ts\n * uuid(); // a unique identifier, e.g., '22a746d0-08be-4aff-bbc2-4deddf0914e0'\n * ```\n *\n * @returns A unique identifier.\n */\nexport function uuid(): string {\n  return crypto.randomUUID();\n}\n"],"mappings":"AAUA,SAAgB,GAAe,CAC7B,OAAO,OAAO,WAAW,CAC3B"}

package/dist/random/uuid.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Generates a unique identifier.
+ *
+ * @example
+ * ```ts
+ * uuid(); // a unique identifier, e.g., '22a746d0-08be-4aff-bbc2-4deddf0914e0'
+ * ```
+ *
+ * @returns A unique identifier.
+ */
+export declare function uuid(): string;
+//# sourceMappingURL=uuid.d.ts.map

package/dist/random/uuid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../src/random/uuid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,IAAI,IAAI,MAAM,CAE7B"}

package/dist/random/uuid.js

@@ -0,0 +1,8 @@
+//#region src/random/uuid.ts
+function e() {
+	return crypto.randomUUID();
+}
+//#endregion
+export { e as uuid };
+
+//# sourceMappingURL=uuid.js.map

package/dist/random/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","names":[],"sources":["../../src/random/uuid.ts"],"sourcesContent":["/**\n * Generates a unique identifier.\n *\n * @example\n * ```ts\n * uuid(); // a unique identifier, e.g., '22a746d0-08be-4aff-bbc2-4deddf0914e0'\n * ```\n *\n * @returns A unique identifier.\n */\nexport function uuid(): string {\n  return crypto.randomUUID();\n}\n"],"mappings":";AAUA,SAAgB,IAAe;CAC7B,OAAO,OAAO,WAAW;AAC3B"}

package/dist/string/_caseUtils.cjs

@@ -0,0 +1,2 @@
+var e=/(\p{Ll})(\p{Lu}|\p{N})|(\p{Lu}|\p{N})(\p{Lu}\p{Ll})|(\p{N})(\p{L})/gu;function t(e){return e.replace(/[.*+?^${}()|[\]\\/-]/g,`\\$&`)}function n(n,r=` `){let i=t(r);return n.trim().replace(e,`$1$3$5${r}$2$4$6`).replace(/[^\p{L}\p{N}]+/gu,r).replace(RegExp(`^(?:${i})+|(?:${i})+$`,`g`),``)}exports.normalizeCase=n;
+//# sourceMappingURL=_caseUtils.cjs.map

package/dist/string/_caseUtils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_caseUtils.cjs","names":[],"sources":["../../src/string/_caseUtils.ts"],"sourcesContent":["/**\n * Shared regex pattern for splitting words in case conversion utilities.\n * Module-private (underscore-prefixed file is not barrel-exported).\n * Used only with String.prototype.replace — which always resets lastIndex.\n * Uses Unicode property escapes (`\\p{Ll}`/`\\p{Lu}`/`\\p{N}`) instead of `[a-z]`/`[A-Z]` so\n * accented and non-Latin letters (e.g. `café`, `日本語`) are treated as letters, not stripped.\n */\nconst CASE_SPLIT_PATTERN = /(\\p{Ll})(\\p{Lu}|\\p{N})|(\\p{Lu}|\\p{N})(\\p{Lu}\\p{Ll})|(\\p{N})(\\p{L})/gu;\n\n/** Escapes all regex metacharacters in a string (per MDN spec). */\nfunction escapeRegex(str: string): string {\n  return str.replace(/[.*+?^${}()|[\\]\\\\/-]/g, '\\\\$&');\n}\n\n/**\n * Normalizes a string by splitting on word boundaries and removing special characters\n *\n * @param str - The string to normalize\n * @param separator - The separator to use for splitting (default: space)\n * @returns The normalized string\n */\nexport function normalizeCase(str: string, separator = ' '): string {\n  const escapedSep = escapeRegex(separator);\n\n  return str\n    .trim()\n    .replace(CASE_SPLIT_PATTERN, `$1$3$5${separator}$2$4$6`)\n    .replace(/[^\\p{L}\\p{N}]+/gu, separator)\n    .replace(new RegExp(`^(?:${escapedSep})+|(?:${escapedSep})+$`, 'g'), '');\n}\n"],"mappings":"AAOA,IAAM,EAAqB,uEAG3B,SAAS,EAAY,EAAqB,CACxC,OAAO,EAAI,QAAQ,wBAAyB,MAAM,CACpD,CASA,SAAgB,EAAc,EAAa,EAAY,IAAa,CAClE,IAAM,EAAa,EAAY,CAAS,EAExC,OAAO,EACJ,KAAK,CAAC,CACN,QAAQ,EAAoB,SAAS,EAAU,OAAO,CAAC,CACvD,QAAQ,mBAAoB,CAAS,CAAC,CACtC,QAAY,OAAO,OAAO,EAAW,QAAQ,EAAW,KAAM,GAAG,EAAG,EAAE,CAC3E"}

package/dist/string/_caseUtils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Normalizes a string by splitting on word boundaries and removing special characters
+ *
+ * @param str - The string to normalize
+ * @param separator - The separator to use for splitting (default: space)
+ * @returns The normalized string
+ */
+export declare function normalizeCase(str: string, separator?: string): string;
+//# sourceMappingURL=_caseUtils.d.ts.map

package/dist/string/_caseUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_caseUtils.d.ts","sourceRoot":"","sources":["../../src/string/_caseUtils.ts"],"names":[],"mappings":"AAcA;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAQlE"}

package/dist/string/_caseUtils.js

@@ -0,0 +1,13 @@
+//#region src/string/_caseUtils.ts
+var e = /(\p{Ll})(\p{Lu}|\p{N})|(\p{Lu}|\p{N})(\p{Lu}\p{Ll})|(\p{N})(\p{L})/gu;
+function t(e) {
+	return e.replace(/[.*+?^${}()|[\]\\/-]/g, "\\$&");
+}
+function n(n, r = " ") {
+	let i = t(r);
+	return n.trim().replace(e, `$1$3$5${r}$2$4$6`).replace(/[^\p{L}\p{N}]+/gu, r).replace(RegExp(`^(?:${i})+|(?:${i})+$`, "g"), "");
+}
+//#endregion
+export { n as normalizeCase };
+
+//# sourceMappingURL=_caseUtils.js.map

package/dist/string/_caseUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_caseUtils.js","names":[],"sources":["../../src/string/_caseUtils.ts"],"sourcesContent":["/**\n * Shared regex pattern for splitting words in case conversion utilities.\n * Module-private (underscore-prefixed file is not barrel-exported).\n * Used only with String.prototype.replace — which always resets lastIndex.\n * Uses Unicode property escapes (`\\p{Ll}`/`\\p{Lu}`/`\\p{N}`) instead of `[a-z]`/`[A-Z]` so\n * accented and non-Latin letters (e.g. `café`, `日本語`) are treated as letters, not stripped.\n */\nconst CASE_SPLIT_PATTERN = /(\\p{Ll})(\\p{Lu}|\\p{N})|(\\p{Lu}|\\p{N})(\\p{Lu}\\p{Ll})|(\\p{N})(\\p{L})/gu;\n\n/** Escapes all regex metacharacters in a string (per MDN spec). */\nfunction escapeRegex(str: string): string {\n  return str.replace(/[.*+?^${}()|[\\]\\\\/-]/g, '\\\\$&');\n}\n\n/**\n * Normalizes a string by splitting on word boundaries and removing special characters\n *\n * @param str - The string to normalize\n * @param separator - The separator to use for splitting (default: space)\n * @returns The normalized string\n */\nexport function normalizeCase(str: string, separator = ' '): string {\n  const escapedSep = escapeRegex(separator);\n\n  return str\n    .trim()\n    .replace(CASE_SPLIT_PATTERN, `$1$3$5${separator}$2$4$6`)\n    .replace(/[^\\p{L}\\p{N}]+/gu, separator)\n    .replace(new RegExp(`^(?:${escapedSep})+|(?:${escapedSep})+$`, 'g'), '');\n}\n"],"mappings":";AAOA,IAAM,IAAqB;AAG3B,SAAS,EAAY,GAAqB;CACxC,OAAO,EAAI,QAAQ,yBAAyB,MAAM;AACpD;AASA,SAAgB,EAAc,GAAa,IAAY,KAAa;CAClE,IAAM,IAAa,EAAY,CAAS;CAExC,OAAO,EACJ,KAAK,CAAC,CACN,QAAQ,GAAoB,SAAS,EAAU,OAAO,CAAC,CACvD,QAAQ,oBAAoB,CAAS,CAAC,CACtC,QAAY,OAAO,OAAO,EAAW,QAAQ,EAAW,MAAM,GAAG,GAAG,EAAE;AAC3E"}

package/dist/string/camelCase.cjs

@@ -0,0 +1,2 @@
+const e=require("./_caseUtils.cjs");function t(t){return e.normalizeCase(t,` `).replace(/[^\p{L}\p{N}]+(.)/gu,(e,t)=>t.toUpperCase()).replace(/^./,e=>e.toLowerCase())}exports.camelCase=t;
+//# sourceMappingURL=camelCase.cjs.map

package/dist/string/camelCase.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"camelCase.cjs","names":[],"sources":["../../src/string/camelCase.ts"],"sourcesContent":["import { normalizeCase } from './_caseUtils';\n\n/**\n * Converts a string to camel case.\n *\n * @example\n * ```ts\n * const text = 'hello world';\n * camelCase(text); // 'helloWorld'\n * ```\n *\n * @param str - The string to convert.\n * @returns The converted string.\n */\nexport function camelCase(str: string): string {\n  return normalizeCase(str, ' ')\n    .replace(/[^\\p{L}\\p{N}]+(.)/gu, (_, char) => char.toUpperCase())\n    .replace(/^./, (char) => char.toLowerCase());\n}\n"],"mappings":"oCAcA,SAAgB,EAAU,EAAqB,CAC7C,OAAO,EAAA,cAAc,EAAK,GAAG,CAAC,CAC3B,QAAQ,uBAAwB,EAAG,IAAS,EAAK,YAAY,CAAC,CAAC,CAC/D,QAAQ,KAAO,GAAS,EAAK,YAAY,CAAC,CAC/C"}

package/dist/string/camelCase.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Converts a string to camel case.
+ *
+ * @example
+ * ```ts
+ * const text = 'hello world';
+ * camelCase(text); // 'helloWorld'
+ * ```
+ *
+ * @param str - The string to convert.
+ * @returns The converted string.
+ */
+export declare function camelCase(str: string): string;
+//# sourceMappingURL=camelCase.d.ts.map

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

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