@humanjs/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gonzalo Muñoz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,15 @@
+# @humanjs/core
+
+The core of [HumanJS](https://humanjs.dev): personality system, timing math, types, and the plugin contract.
+
+> Most users don't install this package directly. Install [`@humanjs/playwright`](https://www.npmjs.com/package/@humanjs/playwright) instead, which depends on this.
+
+## Install
+
+```bash
+pnpm add @humanjs/core
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,285 @@
+'use strict';
+
+// src/presets/careful.ts
+var careful = {
+  name: "careful",
+  speed: 1,
+  mouse: {
+    curvature: 0.4,
+    travelTimeMs: 450,
+    travelTimeJitter: 0.15,
+    overshootProbability: 0.05,
+    misclickProbability: 0.01
+  },
+  typing: {
+    baseDelayMs: 140,
+    delayJitter: 0.3,
+    typoProbability: 0.02,
+    typoCorrectionProbability: 0.95,
+    thinkPauseProbability: 0.08,
+    thinkPauseMeanMs: 400
+  },
+  reading: {
+    wpm: 220,
+    jitter: 0.2
+  },
+  dwell: {
+    preClickMs: 120,
+    preClickJitter: 0.3,
+    postActionMs: 90,
+    postActionJitter: 0.3
+  }
+};
+
+// src/presets/distracted.ts
+var distracted = {
+  name: "distracted",
+  speed: 1.3,
+  mouse: {
+    curvature: 0.6,
+    travelTimeMs: 600,
+    travelTimeJitter: 0.35,
+    overshootProbability: 0.15,
+    misclickProbability: 0.05
+  },
+  typing: {
+    baseDelayMs: 180,
+    delayJitter: 0.5,
+    typoProbability: 0.06,
+    typoCorrectionProbability: 0.7,
+    thinkPauseProbability: 0.18,
+    thinkPauseMeanMs: 700
+  },
+  reading: {
+    wpm: 180,
+    jitter: 0.4
+  },
+  dwell: {
+    preClickMs: 200,
+    preClickJitter: 0.5,
+    postActionMs: 250,
+    postActionJitter: 0.5
+  }
+};
+
+// src/presets/fast.ts
+var fast = {
+  name: "fast",
+  speed: 0.5,
+  mouse: {
+    curvature: 0.25,
+    travelTimeMs: 250,
+    travelTimeJitter: 0.1,
+    overshootProbability: 0.03,
+    misclickProbability: 5e-3
+  },
+  typing: {
+    baseDelayMs: 60,
+    delayJitter: 0.25,
+    typoProbability: 0.015,
+    typoCorrectionProbability: 0.9,
+    thinkPauseProbability: 0.02,
+    thinkPauseMeanMs: 150
+  },
+  reading: {
+    wpm: 350,
+    jitter: 0.15
+  },
+  dwell: {
+    preClickMs: 50,
+    preClickJitter: 0.25,
+    postActionMs: 40,
+    postActionJitter: 0.25
+  }
+};
+
+// src/presets/precise.ts
+var precise = {
+  name: "precise",
+  speed: 1,
+  mouse: {
+    curvature: 0.2,
+    travelTimeMs: 380,
+    travelTimeJitter: 0.05,
+    overshootProbability: 5e-3,
+    misclickProbability: 1e-3
+  },
+  typing: {
+    baseDelayMs: 110,
+    delayJitter: 0.1,
+    typoProbability: 3e-3,
+    typoCorrectionProbability: 0.99,
+    thinkPauseProbability: 0.03,
+    thinkPauseMeanMs: 200
+  },
+  reading: {
+    wpm: 250,
+    jitter: 0.08
+  },
+  dwell: {
+    preClickMs: 80,
+    preClickJitter: 0.1,
+    postActionMs: 60,
+    postActionJitter: 0.1
+  }
+};
+
+// src/resolve.ts
+var presets = {
+  careful,
+  distracted,
+  fast,
+  precise
+};
+function resolvePersonality(config) {
+  if (typeof config === "string") {
+    return presets[config];
+  }
+  if ("extends" in config) {
+    const base = presets[config.extends];
+    return {
+      name: config.name ?? base.name,
+      speed: config.speed ?? base.speed,
+      mouse: { ...base.mouse, ...config.mouse },
+      typing: { ...base.typing, ...config.typing },
+      reading: { ...base.reading, ...config.reading },
+      dwell: { ...base.dwell, ...config.dwell }
+    };
+  }
+  return config;
+}
+
+// src/blend.ts
+function blend(a, b, ratio) {
+  const personalityA = resolvePersonality(a);
+  const personalityB = resolvePersonality(b);
+  const t = clamp(ratio, 0, 1);
+  return {
+    name: `${personalityA.name}+${personalityB.name}@${t.toFixed(2)}`,
+    speed: lerp(personalityA.speed, personalityB.speed, t),
+    mouse: {
+      curvature: lerp(personalityA.mouse.curvature, personalityB.mouse.curvature, t),
+      travelTimeMs: lerp(personalityA.mouse.travelTimeMs, personalityB.mouse.travelTimeMs, t),
+      travelTimeJitter: lerp(
+        personalityA.mouse.travelTimeJitter,
+        personalityB.mouse.travelTimeJitter,
+        t
+      ),
+      overshootProbability: lerp(
+        personalityA.mouse.overshootProbability,
+        personalityB.mouse.overshootProbability,
+        t
+      ),
+      misclickProbability: lerp(
+        personalityA.mouse.misclickProbability,
+        personalityB.mouse.misclickProbability,
+        t
+      )
+    },
+    typing: {
+      baseDelayMs: lerp(personalityA.typing.baseDelayMs, personalityB.typing.baseDelayMs, t),
+      delayJitter: lerp(personalityA.typing.delayJitter, personalityB.typing.delayJitter, t),
+      typoProbability: lerp(
+        personalityA.typing.typoProbability,
+        personalityB.typing.typoProbability,
+        t
+      ),
+      typoCorrectionProbability: lerp(
+        personalityA.typing.typoCorrectionProbability,
+        personalityB.typing.typoCorrectionProbability,
+        t
+      ),
+      thinkPauseProbability: lerp(
+        personalityA.typing.thinkPauseProbability,
+        personalityB.typing.thinkPauseProbability,
+        t
+      ),
+      thinkPauseMeanMs: lerp(
+        personalityA.typing.thinkPauseMeanMs,
+        personalityB.typing.thinkPauseMeanMs,
+        t
+      )
+    },
+    reading: {
+      wpm: lerp(personalityA.reading.wpm, personalityB.reading.wpm, t),
+      jitter: lerp(personalityA.reading.jitter, personalityB.reading.jitter, t)
+    },
+    dwell: {
+      preClickMs: lerp(personalityA.dwell.preClickMs, personalityB.dwell.preClickMs, t),
+      preClickJitter: lerp(personalityA.dwell.preClickJitter, personalityB.dwell.preClickJitter, t),
+      postActionMs: lerp(personalityA.dwell.postActionMs, personalityB.dwell.postActionMs, t),
+      postActionJitter: lerp(
+        personalityA.dwell.postActionJitter,
+        personalityB.dwell.postActionJitter,
+        t
+      )
+    }
+  };
+}
+function lerp(a, b, t) {
+  return a + (b - a) * t;
+}
+function clamp(value, min, max) {
+  return value < min ? min : value > max ? max : value;
+}
+
+// src/rng.ts
+function createRng(seed) {
+  let state = resolveSeed(seed);
+  const next = () => {
+    state = state + 1831565813 | 0;
+    let t = Math.imul(state ^ state >>> 15, 1 | state);
+    t = t + Math.imul(t ^ t >>> 7, 61 | t) ^ t;
+    return ((t ^ t >>> 14) >>> 0) / 4294967296;
+  };
+  return {
+    next,
+    nextInt(min, max) {
+      return Math.floor(next() * (max - min)) + min;
+    },
+    nextFloat(min, max) {
+      return next() * (max - min) + min;
+    },
+    chance(p) {
+      const clamped = p < 0 ? 0 : p > 1 ? 1 : p;
+      return next() < clamped;
+    },
+    nextGaussian(mean = 0, stdDev = 1) {
+      const u1 = next() || Number.MIN_VALUE;
+      const u2 = next();
+      const z = Math.sqrt(-2 * Math.log(u1)) * Math.cos(2 * Math.PI * u2);
+      return mean + z * stdDev;
+    }
+  };
+}
+function resolveSeed(seed) {
+  if (seed === void 0) {
+    return (Date.now() ^ Math.random() * 4294967296) >>> 0;
+  }
+  if (typeof seed === "number") {
+    return seed >>> 0;
+  }
+  return hashString(seed);
+}
+function hashString(s) {
+  let h = 2166136261;
+  for (let i = 0; i < s.length; i++) {
+    h ^= s.charCodeAt(i);
+    h = Math.imul(h, 16777619);
+  }
+  return h >>> 0;
+}
+
+// src/index.ts
+var VERSION = "0.0.0";
+
+exports.VERSION = VERSION;
+exports.blend = blend;
+exports.careful = careful;
+exports.createRng = createRng;
+exports.distracted = distracted;
+exports.fast = fast;
+exports.precise = precise;
+exports.resolvePersonality = resolvePersonality;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/presets/careful.ts","../src/presets/distracted.ts","../src/presets/fast.ts","../src/presets/precise.ts","../src/resolve.ts","../src/blend.ts","../src/rng.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { Personality } from '../personality.js';\n\n/**\n * Slow, precise, few mistakes. Longer dwell on important fields.\n * The default personality when none is specified.\n */\nexport const careful: Personality = {\n  name: 'careful',\n  speed: 1.0,\n  mouse: {\n    curvature: 0.4,\n    travelTimeMs: 450,\n    travelTimeJitter: 0.15,\n    overshootProbability: 0.05,\n    misclickProbability: 0.01,\n  },\n  typing: {\n    baseDelayMs: 140,\n    delayJitter: 0.3,\n    typoProbability: 0.02,\n    typoCorrectionProbability: 0.95,\n    thinkPauseProbability: 0.08,\n    thinkPauseMeanMs: 400,\n  },\n  reading: {\n    wpm: 220,\n    jitter: 0.2,\n  },\n  dwell: {\n    preClickMs: 120,\n    preClickJitter: 0.3,\n    postActionMs: 90,\n    postActionJitter: 0.3,\n  },\n};\n","import type { Personality } from '../personality.js';\n\n/**\n * Scrolls back, retypes, hovers off, occasional misclicks.\n * Useful for stress-testing flows that assume perfect input.\n */\nexport const distracted: Personality = {\n  name: 'distracted',\n  speed: 1.3,\n  mouse: {\n    curvature: 0.6,\n    travelTimeMs: 600,\n    travelTimeJitter: 0.35,\n    overshootProbability: 0.15,\n    misclickProbability: 0.05,\n  },\n  typing: {\n    baseDelayMs: 180,\n    delayJitter: 0.5,\n    typoProbability: 0.06,\n    typoCorrectionProbability: 0.7,\n    thinkPauseProbability: 0.18,\n    thinkPauseMeanMs: 700,\n  },\n  reading: {\n    wpm: 180,\n    jitter: 0.4,\n  },\n  dwell: {\n    preClickMs: 200,\n    preClickJitter: 0.5,\n    postActionMs: 250,\n    postActionJitter: 0.5,\n  },\n};\n","import type { Personality } from '../personality.js';\n\n/**\n * Quick but still natural. Fewer pauses, lower typo rate, shorter dwell.\n * Good for sessions where the user \"knows the app\".\n */\nexport const fast: Personality = {\n  name: 'fast',\n  speed: 0.5,\n  mouse: {\n    curvature: 0.25,\n    travelTimeMs: 250,\n    travelTimeJitter: 0.1,\n    overshootProbability: 0.03,\n    misclickProbability: 0.005,\n  },\n  typing: {\n    baseDelayMs: 60,\n    delayJitter: 0.25,\n    typoProbability: 0.015,\n    typoCorrectionProbability: 0.9,\n    thinkPauseProbability: 0.02,\n    thinkPauseMeanMs: 150,\n  },\n  reading: {\n    wpm: 350,\n    jitter: 0.15,\n  },\n  dwell: {\n    preClickMs: 50,\n    preClickJitter: 0.25,\n    postActionMs: 40,\n    postActionJitter: 0.25,\n  },\n};\n","import type { Personality } from '../personality.js';\n\n/**\n * Minimal noise, smooth motion, near-zero mistakes.\n * Closer to \"expert user\" than \"average user\".\n */\nexport const precise: Personality = {\n  name: 'precise',\n  speed: 1.0,\n  mouse: {\n    curvature: 0.2,\n    travelTimeMs: 380,\n    travelTimeJitter: 0.05,\n    overshootProbability: 0.005,\n    misclickProbability: 0.001,\n  },\n  typing: {\n    baseDelayMs: 110,\n    delayJitter: 0.1,\n    typoProbability: 0.003,\n    typoCorrectionProbability: 0.99,\n    thinkPauseProbability: 0.03,\n    thinkPauseMeanMs: 200,\n  },\n  reading: {\n    wpm: 250,\n    jitter: 0.08,\n  },\n  dwell: {\n    preClickMs: 80,\n    preClickJitter: 0.1,\n    postActionMs: 60,\n    postActionJitter: 0.1,\n  },\n};\n","import type {\n  DwellProfile,\n  MouseProfile,\n  Personality,\n  ReadingProfile,\n  TypingProfile,\n} from './personality.js';\nimport { careful, distracted, fast, precise } from './presets/index.js';\n\n/** Names of the four built-in personality presets. */\nexport type PresetName = 'careful' | 'distracted' | 'fast' | 'precise';\n\nconst presets: Record<PresetName, Personality> = {\n  careful,\n  distracted,\n  fast,\n  precise,\n};\n\n/**\n * A preset extended with partial overrides at the top level and on any\n * facet. Unspecified fields fall through to the base preset.\n */\nexport interface PersonalityExtension {\n  readonly extends: PresetName;\n  readonly name?: string;\n  readonly speed?: number;\n  readonly mouse?: Partial<MouseProfile>;\n  readonly typing?: Partial<TypingProfile>;\n  readonly reading?: Partial<ReadingProfile>;\n  readonly dwell?: Partial<DwellProfile>;\n}\n\n/**\n * Anything that can be passed where a personality is expected.\n * - A preset name (`'careful'`, `'fast'`, …)\n * - A preset + partial overrides via `{ extends: 'careful', … }`\n * - A fully built `Personality` (community packages, results of `blend()`)\n */\nexport type PersonalityConfig = PresetName | PersonalityExtension | Personality;\n\n/**\n * Resolves any `PersonalityConfig` into a flat `Personality`.\n *\n * Never mutates the base preset — overrides produce a fresh object. The\n * returned `Personality` is safe to share, snapshot, and pass to\n * `createHuman()` or `blend()`.\n */\nexport function resolvePersonality(config: PersonalityConfig): Personality {\n  if (typeof config === 'string') {\n    return presets[config];\n  }\n  if ('extends' in config) {\n    const base = presets[config.extends];\n    return {\n      name: config.name ?? base.name,\n      speed: config.speed ?? base.speed,\n      mouse: { ...base.mouse, ...config.mouse },\n      typing: { ...base.typing, ...config.typing },\n      reading: { ...base.reading, ...config.reading },\n      dwell: { ...base.dwell, ...config.dwell },\n    };\n  }\n  return config;\n}\n","import type { Personality } from './personality.js';\nimport { type PersonalityConfig, resolvePersonality } from './resolve.js';\n\n/**\n * Composes two personalities into a new one by linearly interpolating\n * every numeric field at the given ratio.\n *\n * Both inputs are first resolved (so preset names, extensions, and full\n * personalities are all accepted). Then every numeric field — top-level\n * `speed` plus every field on every facet — is interpolated as\n * `a + (b - a) * ratio`. The base presets are never mutated.\n *\n * @param a - First personality. The result equals `a` at `ratio = 0`.\n * @param b - Second personality. The result equals `b` at `ratio = 1`.\n * @param ratio - How much of `b` to mix in, from 0 to 1.\n *   `0` returns pure `a`, `1` returns pure `b`, `0.5` is the midpoint.\n *   Clamped if out of range.\n *\n * @example Two-way blend\n * ```ts\n * // 70% careful + 30% distracted\n * const mostlyCareful = blend('careful', 'distracted', 0.3);\n * ```\n *\n * @example Three-way blend via composition\n * ```ts\n * // Equal mix of three: (2/3) × (0.5·careful + 0.5·fast) + (1/3) × distracted\n * const even = blend(blend('careful', 'fast', 0.5), 'distracted', 1 / 3);\n * ```\n */\nexport function blend(a: PersonalityConfig, b: PersonalityConfig, ratio: number): Personality {\n  const personalityA = resolvePersonality(a);\n  const personalityB = resolvePersonality(b);\n  const t = clamp(ratio, 0, 1);\n\n  return {\n    name: `${personalityA.name}+${personalityB.name}@${t.toFixed(2)}`,\n    speed: lerp(personalityA.speed, personalityB.speed, t),\n    mouse: {\n      curvature: lerp(personalityA.mouse.curvature, personalityB.mouse.curvature, t),\n      travelTimeMs: lerp(personalityA.mouse.travelTimeMs, personalityB.mouse.travelTimeMs, t),\n      travelTimeJitter: lerp(\n        personalityA.mouse.travelTimeJitter,\n        personalityB.mouse.travelTimeJitter,\n        t,\n      ),\n      overshootProbability: lerp(\n        personalityA.mouse.overshootProbability,\n        personalityB.mouse.overshootProbability,\n        t,\n      ),\n      misclickProbability: lerp(\n        personalityA.mouse.misclickProbability,\n        personalityB.mouse.misclickProbability,\n        t,\n      ),\n    },\n    typing: {\n      baseDelayMs: lerp(personalityA.typing.baseDelayMs, personalityB.typing.baseDelayMs, t),\n      delayJitter: lerp(personalityA.typing.delayJitter, personalityB.typing.delayJitter, t),\n      typoProbability: lerp(\n        personalityA.typing.typoProbability,\n        personalityB.typing.typoProbability,\n        t,\n      ),\n      typoCorrectionProbability: lerp(\n        personalityA.typing.typoCorrectionProbability,\n        personalityB.typing.typoCorrectionProbability,\n        t,\n      ),\n      thinkPauseProbability: lerp(\n        personalityA.typing.thinkPauseProbability,\n        personalityB.typing.thinkPauseProbability,\n        t,\n      ),\n      thinkPauseMeanMs: lerp(\n        personalityA.typing.thinkPauseMeanMs,\n        personalityB.typing.thinkPauseMeanMs,\n        t,\n      ),\n    },\n    reading: {\n      wpm: lerp(personalityA.reading.wpm, personalityB.reading.wpm, t),\n      jitter: lerp(personalityA.reading.jitter, personalityB.reading.jitter, t),\n    },\n    dwell: {\n      preClickMs: lerp(personalityA.dwell.preClickMs, personalityB.dwell.preClickMs, t),\n      preClickJitter: lerp(personalityA.dwell.preClickJitter, personalityB.dwell.preClickJitter, t),\n      postActionMs: lerp(personalityA.dwell.postActionMs, personalityB.dwell.postActionMs, t),\n      postActionJitter: lerp(\n        personalityA.dwell.postActionJitter,\n        personalityB.dwell.postActionJitter,\n        t,\n      ),\n    },\n  };\n}\n\n/**\n * Linear interpolation between two numbers. Returns `a` at `t = 0`,\n * `b` at `t = 1`, and a proportional mix in between.\n */\nfunction lerp(a: number, b: number, t: number): number {\n  return a + (b - a) * t;\n}\n\n/** Clamps `value` to the inclusive range `[min, max]`. */\nfunction clamp(value: number, min: number, max: number): number {\n  return value < min ? min : value > max ? max : value;\n}\n","/**\n * Seedable pseudo-random number generator used throughout HumanJS.\n *\n * Implementations must be deterministic given a seed: `createRng('foo')`\n * followed by N calls to `next()` always produces the same sequence on\n * any platform. This is what makes humanization snapshot-testable.\n */\nexport interface Rng {\n  /** Returns a uniform float in [0, 1). */\n  next(): number;\n  /** Returns a uniform integer in [min, max). */\n  nextInt(min: number, max: number): number;\n  /** Returns a uniform float in [min, max). */\n  nextFloat(min: number, max: number): number;\n  /** Returns true with probability `p`. Clamped to [0, 1]. */\n  chance(p: number): boolean;\n  /**\n   * Returns a Gaussian-distributed sample via the Box-Muller transform.\n   * Defaults: mean = 0, standard deviation = 1.\n   */\n  nextGaussian(mean?: number, stdDev?: number): number;\n}\n\n/**\n * Creates a seedable PRNG. Identical seeds produce identical sequences\n * on every run and every platform.\n *\n * Algorithm: mulberry32 — a 32-bit, 2^32-period generator with strong\n * statistical properties for the timing distributions HumanJS produces.\n * Not suitable for cryptographic use.\n *\n * @param seed - String (hashed via FNV-1a), number (used directly), or\n *   undefined (system-time-based; sessions become non-reproducible).\n */\nexport function createRng(seed?: string | number): Rng {\n  let state = resolveSeed(seed);\n\n  const next = (): number => {\n    state = (state + 0x6d2b79f5) | 0;\n    let t = Math.imul(state ^ (state >>> 15), 1 | state);\n    t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;\n    return ((t ^ (t >>> 14)) >>> 0) / 0x100000000;\n  };\n\n  return {\n    next,\n    nextInt(min, max) {\n      return Math.floor(next() * (max - min)) + min;\n    },\n    nextFloat(min, max) {\n      return next() * (max - min) + min;\n    },\n    chance(p) {\n      const clamped = p < 0 ? 0 : p > 1 ? 1 : p;\n      return next() < clamped;\n    },\n    nextGaussian(mean = 0, stdDev = 1) {\n      const u1 = next() || Number.MIN_VALUE;\n      const u2 = next();\n      const z = Math.sqrt(-2 * Math.log(u1)) * Math.cos(2 * Math.PI * u2);\n      return mean + z * stdDev;\n    },\n  };\n}\n\n/**\n * Normalizes any seed input to a 32-bit unsigned integer — the state shape\n * mulberry32 requires. Numbers (including negative or fractional ones) are\n * coerced via `>>> 0`; strings hash to a uint32 via FNV-1a; undefined\n * derives a non-reproducible seed from system time.\n */\nfunction resolveSeed(seed: string | number | undefined): number {\n  if (seed === undefined) {\n    return (Date.now() ^ (Math.random() * 0x100000000)) >>> 0;\n  }\n  if (typeof seed === 'number') {\n    return seed >>> 0;\n  }\n  return hashString(seed);\n}\n\nfunction hashString(s: string): number {\n  let h = 0x811c9dc5;\n  for (let i = 0; i < s.length; i++) {\n    h ^= s.charCodeAt(i);\n    h = Math.imul(h, 0x01000193);\n  }\n  return h >>> 0;\n}\n","export const VERSION = '0.0.0';\n\nexport { blend } from './blend.js';\nexport type {\n  DwellProfile,\n  MouseProfile,\n  Personality,\n  ReadingProfile,\n  TypingProfile,\n} from './personality.js';\nexport type {\n  ActionResult,\n  ActionType,\n  HumanAction,\n  HumanPlugin,\n  KnownActionType,\n  PluginContext,\n} from './plugin.js';\nexport { careful, distracted, fast, precise } from './presets/index.js';\nexport type {\n  PersonalityConfig,\n  PersonalityExtension,\n  PresetName,\n} from './resolve.js';\nexport { resolvePersonality } from './resolve.js';\nexport type { Rng } from './rng.js';\nexport { createRng } from './rng.js';\n"]}

package/dist/index.d.cts

@@ -0,0 +1,278 @@
+/**
+ * A complete personality profile describing how a humanized session behaves.
+ *
+ * Personalities are pure data — they describe the rhythm and shape of
+ * humanization without owning any random state. Randomness is supplied
+ * per-session by the host, seeded deterministically when needed.
+ *
+ * Built-in presets and community packages should both satisfy this shape.
+ * Community packages are encouraged to publish as `@anything/personality-*`.
+ */
+interface Personality {
+    /** Identifier used in logs and observability events. */
+    readonly name: string;
+    /**
+     * Overall tempo multiplier applied on top of per-facet timings.
+     * 1.0 = base, < 1.0 = faster, > 1.0 = slower.
+     */
+    readonly speed: number;
+    readonly mouse: MouseProfile;
+    readonly typing: TypingProfile;
+    readonly reading: ReadingProfile;
+    readonly dwell: DwellProfile;
+}
+/** Parameters that shape mouse movement and click behavior. */
+interface MouseProfile {
+    /** Bezier curvature factor: 0 = straight line, 1 = exaggerated curves. */
+    readonly curvature: number;
+    /** Mean travel time in ms per 1000px of distance. */
+    readonly travelTimeMs: number;
+    /** Random variation in travel time as a fraction of the mean (0..1). */
+    readonly travelTimeJitter: number;
+    /** Probability of overshooting a target and correcting (0..1). */
+    readonly overshootProbability: number;
+    /** Probability of clicking slightly off-target and correcting (0..1). */
+    readonly misclickProbability: number;
+}
+/** Parameters that shape keystroke timing and typing errors. */
+interface TypingProfile {
+    /** Mean ms between keystrokes. */
+    readonly baseDelayMs: number;
+    /** Random variation as a fraction of the mean (0..1). */
+    readonly delayJitter: number;
+    /** Probability of a typo per character (0..1). */
+    readonly typoProbability: number;
+    /**
+     * Probability of correcting a typo with backspace once one occurs (0..1).
+     * Lower values leave more uncorrected typos in the output.
+     */
+    readonly typoCorrectionProbability: number;
+    /** Probability of pausing mid-word as if thinking (0..1). */
+    readonly thinkPauseProbability: number;
+    /** Mean duration of a think-pause in ms. */
+    readonly thinkPauseMeanMs: number;
+}
+/** Parameters that shape reading dwell time. */
+interface ReadingProfile {
+    /** Reading speed in words per minute. */
+    readonly wpm: number;
+    /** Random variation in reading time as a fraction of base (0..1). */
+    readonly jitter: number;
+}
+/** Parameters that shape micro-pauses around actions. */
+interface DwellProfile {
+    /** Pause in ms after hovering, before clicking. */
+    readonly preClickMs: number;
+    /** Random jitter on pre-click pause as a fraction (0..1). */
+    readonly preClickJitter: number;
+    /** Pause in ms after an action completes. */
+    readonly postActionMs: number;
+    /** Random jitter on post-action pause as a fraction (0..1). */
+    readonly postActionJitter: number;
+}
+
+/** Names of the four built-in personality presets. */
+type PresetName = 'careful' | 'distracted' | 'fast' | 'precise';
+/**
+ * A preset extended with partial overrides at the top level and on any
+ * facet. Unspecified fields fall through to the base preset.
+ */
+interface PersonalityExtension {
+    readonly extends: PresetName;
+    readonly name?: string;
+    readonly speed?: number;
+    readonly mouse?: Partial<MouseProfile>;
+    readonly typing?: Partial<TypingProfile>;
+    readonly reading?: Partial<ReadingProfile>;
+    readonly dwell?: Partial<DwellProfile>;
+}
+/**
+ * Anything that can be passed where a personality is expected.
+ * - A preset name (`'careful'`, `'fast'`, …)
+ * - A preset + partial overrides via `{ extends: 'careful', … }`
+ * - A fully built `Personality` (community packages, results of `blend()`)
+ */
+type PersonalityConfig = PresetName | PersonalityExtension | Personality;
+/**
+ * Resolves any `PersonalityConfig` into a flat `Personality`.
+ *
+ * Never mutates the base preset — overrides produce a fresh object. The
+ * returned `Personality` is safe to share, snapshot, and pass to
+ * `createHuman()` or `blend()`.
+ */
+declare function resolvePersonality(config: PersonalityConfig): Personality;
+
+/**
+ * Composes two personalities into a new one by linearly interpolating
+ * every numeric field at the given ratio.
+ *
+ * Both inputs are first resolved (so preset names, extensions, and full
+ * personalities are all accepted). Then every numeric field — top-level
+ * `speed` plus every field on every facet — is interpolated as
+ * `a + (b - a) * ratio`. The base presets are never mutated.
+ *
+ * @param a - First personality. The result equals `a` at `ratio = 0`.
+ * @param b - Second personality. The result equals `b` at `ratio = 1`.
+ * @param ratio - How much of `b` to mix in, from 0 to 1.
+ *   `0` returns pure `a`, `1` returns pure `b`, `0.5` is the midpoint.
+ *   Clamped if out of range.
+ *
+ * @example Two-way blend
+ * ```ts
+ * // 70% careful + 30% distracted
+ * const mostlyCareful = blend('careful', 'distracted', 0.3);
+ * ```
+ *
+ * @example Three-way blend via composition
+ * ```ts
+ * // Equal mix of three: (2/3) × (0.5·careful + 0.5·fast) + (1/3) × distracted
+ * const even = blend(blend('careful', 'fast', 0.5), 'distracted', 1 / 3);
+ * ```
+ */
+declare function blend(a: PersonalityConfig, b: PersonalityConfig, ratio: number): Personality;
+
+/**
+ * Seedable pseudo-random number generator used throughout HumanJS.
+ *
+ * Implementations must be deterministic given a seed: `createRng('foo')`
+ * followed by N calls to `next()` always produces the same sequence on
+ * any platform. This is what makes humanization snapshot-testable.
+ */
+interface Rng {
+    /** Returns a uniform float in [0, 1). */
+    next(): number;
+    /** Returns a uniform integer in [min, max). */
+    nextInt(min: number, max: number): number;
+    /** Returns a uniform float in [min, max). */
+    nextFloat(min: number, max: number): number;
+    /** Returns true with probability `p`. Clamped to [0, 1]. */
+    chance(p: number): boolean;
+    /**
+     * Returns a Gaussian-distributed sample via the Box-Muller transform.
+     * Defaults: mean = 0, standard deviation = 1.
+     */
+    nextGaussian(mean?: number, stdDev?: number): number;
+}
+/**
+ * Creates a seedable PRNG. Identical seeds produce identical sequences
+ * on every run and every platform.
+ *
+ * Algorithm: mulberry32 — a 32-bit, 2^32-period generator with strong
+ * statistical properties for the timing distributions HumanJS produces.
+ * Not suitable for cryptographic use.
+ *
+ * @param seed - String (hashed via FNV-1a), number (used directly), or
+ *   undefined (system-time-based; sessions become non-reproducible).
+ */
+declare function createRng(seed?: string | number): Rng;
+
+/**
+ * Contract for plugins that extend a humanized session.
+ *
+ * Plugins are plain objects with optional lifecycle hooks. The host
+ * (an adapter such as `@humanjs/playwright`) invokes hooks at the
+ * appropriate moments — before/after each action and on error.
+ *
+ * Hooks can be sync or async. Hosts await each hook in registration order.
+ * Hooks are observation-only in v1; they cannot transform actions.
+ *
+ * @example A logger plugin
+ * ```ts
+ * const logger: HumanPlugin = {
+ *   name: 'logger',
+ *   beforeAction: (action) => console.log(`[${action.type}] starting`),
+ *   afterAction: (action, result) =>
+ *     console.log(`[${action.type}] took ${result.durationMs}ms`),
+ * };
+ * ```
+ */
+interface HumanPlugin {
+    /** Unique identifier used in logs and observability events. */
+    readonly name: string;
+    /** Called once when the plugin is installed on a session. */
+    install?(context: PluginContext): void | Promise<void>;
+    /** Called immediately before every action. */
+    beforeAction?(action: HumanAction): void | Promise<void>;
+    /** Called immediately after an action completes successfully. */
+    afterAction?(action: HumanAction, result: ActionResult): void | Promise<void>;
+    /**
+     * Called when an action throws. The plugin should not re-throw —
+     * the host re-throws after notifying every plugin.
+     */
+    onError?(action: HumanAction, error: unknown): void | Promise<void>;
+}
+/**
+ * Runtime context provided to a plugin's `install` hook.
+ *
+ * Contains the resolved personality and the session's seeded RNG so
+ * plugins can produce deterministic output (e.g. logging fixtures).
+ */
+interface PluginContext {
+    /** The resolved personality this session is using. */
+    readonly personality: Personality;
+    /** The session's seeded RNG. Calling it consumes the shared sequence. */
+    readonly rng: Rng;
+}
+/**
+ * Action types HumanJS adapters are known to emit.
+ *
+ * Plugins can switch on these names for type-safe handling and get IDE
+ * autocomplete on them — but `HumanAction.type` is intentionally widened
+ * to accept any string so adapters can introduce custom or experimental
+ * action types without a core release.
+ */
+type KnownActionType = 'click' | 'drag' | 'goto' | 'hover' | 'paste' | 'read' | 'rightClick' | 'scroll' | 'shortcut' | 'type';
+/**
+ * Loose action-type string: known names autocomplete in IDEs while any
+ * other string still typechecks. Implemented with the `(string & {})`
+ * idiom — TypeScript surfaces the literal members for completion but
+ * widens the type to `string` for assignability.
+ */
+type ActionType = KnownActionType | (string & {});
+/**
+ * A humanized action a plugin can observe.
+ *
+ * Plugins should treat unknown action types defensively — different
+ * adapters emit different sets, and new types can be added at any time.
+ */
+interface HumanAction {
+    /** Action discriminator. Known values autocomplete; any string is accepted. */
+    readonly type: ActionType;
+    /** Action-specific parameters. Shape varies by `type`. */
+    readonly params?: Readonly<Record<string, unknown>>;
+}
+/** Outcome of a completed action, passed to `afterAction`. */
+interface ActionResult {
+    /** Echo of the originating action's `type`. */
+    readonly type: ActionType;
+    /** Wall-clock duration in milliseconds. */
+    readonly durationMs: number;
+}
+
+/**
+ * Slow, precise, few mistakes. Longer dwell on important fields.
+ * The default personality when none is specified.
+ */
+declare const careful: Personality;
+
+/**
+ * Scrolls back, retypes, hovers off, occasional misclicks.
+ * Useful for stress-testing flows that assume perfect input.
+ */
+declare const distracted: Personality;
+
+/**
+ * Quick but still natural. Fewer pauses, lower typo rate, shorter dwell.
+ * Good for sessions where the user "knows the app".
+ */
+declare const fast: Personality;
+
+/**
+ * Minimal noise, smooth motion, near-zero mistakes.
+ * Closer to "expert user" than "average user".
+ */
+declare const precise: Personality;
+
+declare const VERSION = "0.0.0";
+
+export { type ActionResult, type ActionType, type DwellProfile, type HumanAction, type HumanPlugin, type KnownActionType, type MouseProfile, type Personality, type PersonalityConfig, type PersonalityExtension, type PluginContext, type PresetName, type ReadingProfile, type Rng, type TypingProfile, VERSION, blend, careful, createRng, distracted, fast, precise, resolvePersonality };

package/dist/index.d.ts

@@ -0,0 +1,278 @@
+/**
+ * A complete personality profile describing how a humanized session behaves.
+ *
+ * Personalities are pure data — they describe the rhythm and shape of
+ * humanization without owning any random state. Randomness is supplied
+ * per-session by the host, seeded deterministically when needed.
+ *
+ * Built-in presets and community packages should both satisfy this shape.
+ * Community packages are encouraged to publish as `@anything/personality-*`.
+ */
+interface Personality {
+    /** Identifier used in logs and observability events. */
+    readonly name: string;
+    /**
+     * Overall tempo multiplier applied on top of per-facet timings.
+     * 1.0 = base, < 1.0 = faster, > 1.0 = slower.
+     */
+    readonly speed: number;
+    readonly mouse: MouseProfile;
+    readonly typing: TypingProfile;
+    readonly reading: ReadingProfile;
+    readonly dwell: DwellProfile;
+}
+/** Parameters that shape mouse movement and click behavior. */
+interface MouseProfile {
+    /** Bezier curvature factor: 0 = straight line, 1 = exaggerated curves. */
+    readonly curvature: number;
+    /** Mean travel time in ms per 1000px of distance. */
+    readonly travelTimeMs: number;
+    /** Random variation in travel time as a fraction of the mean (0..1). */
+    readonly travelTimeJitter: number;
+    /** Probability of overshooting a target and correcting (0..1). */
+    readonly overshootProbability: number;
+    /** Probability of clicking slightly off-target and correcting (0..1). */
+    readonly misclickProbability: number;
+}
+/** Parameters that shape keystroke timing and typing errors. */
+interface TypingProfile {
+    /** Mean ms between keystrokes. */
+    readonly baseDelayMs: number;
+    /** Random variation as a fraction of the mean (0..1). */
+    readonly delayJitter: number;
+    /** Probability of a typo per character (0..1). */
+    readonly typoProbability: number;
+    /**
+     * Probability of correcting a typo with backspace once one occurs (0..1).
+     * Lower values leave more uncorrected typos in the output.
+     */
+    readonly typoCorrectionProbability: number;
+    /** Probability of pausing mid-word as if thinking (0..1). */
+    readonly thinkPauseProbability: number;
+    /** Mean duration of a think-pause in ms. */
+    readonly thinkPauseMeanMs: number;
+}
+/** Parameters that shape reading dwell time. */
+interface ReadingProfile {
+    /** Reading speed in words per minute. */
+    readonly wpm: number;
+    /** Random variation in reading time as a fraction of base (0..1). */
+    readonly jitter: number;
+}
+/** Parameters that shape micro-pauses around actions. */
+interface DwellProfile {
+    /** Pause in ms after hovering, before clicking. */
+    readonly preClickMs: number;
+    /** Random jitter on pre-click pause as a fraction (0..1). */
+    readonly preClickJitter: number;
+    /** Pause in ms after an action completes. */
+    readonly postActionMs: number;
+    /** Random jitter on post-action pause as a fraction (0..1). */
+    readonly postActionJitter: number;
+}
+
+/** Names of the four built-in personality presets. */
+type PresetName = 'careful' | 'distracted' | 'fast' | 'precise';
+/**
+ * A preset extended with partial overrides at the top level and on any
+ * facet. Unspecified fields fall through to the base preset.
+ */
+interface PersonalityExtension {
+    readonly extends: PresetName;
+    readonly name?: string;
+    readonly speed?: number;
+    readonly mouse?: Partial<MouseProfile>;
+    readonly typing?: Partial<TypingProfile>;
+    readonly reading?: Partial<ReadingProfile>;
+    readonly dwell?: Partial<DwellProfile>;
+}
+/**
+ * Anything that can be passed where a personality is expected.
+ * - A preset name (`'careful'`, `'fast'`, …)
+ * - A preset + partial overrides via `{ extends: 'careful', … }`
+ * - A fully built `Personality` (community packages, results of `blend()`)
+ */
+type PersonalityConfig = PresetName | PersonalityExtension | Personality;
+/**
+ * Resolves any `PersonalityConfig` into a flat `Personality`.
+ *
+ * Never mutates the base preset — overrides produce a fresh object. The
+ * returned `Personality` is safe to share, snapshot, and pass to
+ * `createHuman()` or `blend()`.
+ */
+declare function resolvePersonality(config: PersonalityConfig): Personality;
+
+/**
+ * Composes two personalities into a new one by linearly interpolating
+ * every numeric field at the given ratio.
+ *
+ * Both inputs are first resolved (so preset names, extensions, and full
+ * personalities are all accepted). Then every numeric field — top-level
+ * `speed` plus every field on every facet — is interpolated as
+ * `a + (b - a) * ratio`. The base presets are never mutated.
+ *
+ * @param a - First personality. The result equals `a` at `ratio = 0`.
+ * @param b - Second personality. The result equals `b` at `ratio = 1`.
+ * @param ratio - How much of `b` to mix in, from 0 to 1.
+ *   `0` returns pure `a`, `1` returns pure `b`, `0.5` is the midpoint.
+ *   Clamped if out of range.
+ *
+ * @example Two-way blend
+ * ```ts
+ * // 70% careful + 30% distracted
+ * const mostlyCareful = blend('careful', 'distracted', 0.3);
+ * ```
+ *
+ * @example Three-way blend via composition
+ * ```ts
+ * // Equal mix of three: (2/3) × (0.5·careful + 0.5·fast) + (1/3) × distracted
+ * const even = blend(blend('careful', 'fast', 0.5), 'distracted', 1 / 3);
+ * ```
+ */
+declare function blend(a: PersonalityConfig, b: PersonalityConfig, ratio: number): Personality;
+
+/**
+ * Seedable pseudo-random number generator used throughout HumanJS.
+ *
+ * Implementations must be deterministic given a seed: `createRng('foo')`
+ * followed by N calls to `next()` always produces the same sequence on
+ * any platform. This is what makes humanization snapshot-testable.
+ */
+interface Rng {
+    /** Returns a uniform float in [0, 1). */
+    next(): number;
+    /** Returns a uniform integer in [min, max). */
+    nextInt(min: number, max: number): number;
+    /** Returns a uniform float in [min, max). */
+    nextFloat(min: number, max: number): number;
+    /** Returns true with probability `p`. Clamped to [0, 1]. */
+    chance(p: number): boolean;
+    /**
+     * Returns a Gaussian-distributed sample via the Box-Muller transform.
+     * Defaults: mean = 0, standard deviation = 1.
+     */
+    nextGaussian(mean?: number, stdDev?: number): number;
+}
+/**
+ * Creates a seedable PRNG. Identical seeds produce identical sequences
+ * on every run and every platform.
+ *
+ * Algorithm: mulberry32 — a 32-bit, 2^32-period generator with strong
+ * statistical properties for the timing distributions HumanJS produces.
+ * Not suitable for cryptographic use.
+ *
+ * @param seed - String (hashed via FNV-1a), number (used directly), or
+ *   undefined (system-time-based; sessions become non-reproducible).
+ */
+declare function createRng(seed?: string | number): Rng;
+
+/**
+ * Contract for plugins that extend a humanized session.
+ *
+ * Plugins are plain objects with optional lifecycle hooks. The host
+ * (an adapter such as `@humanjs/playwright`) invokes hooks at the
+ * appropriate moments — before/after each action and on error.
+ *
+ * Hooks can be sync or async. Hosts await each hook in registration order.
+ * Hooks are observation-only in v1; they cannot transform actions.
+ *
+ * @example A logger plugin
+ * ```ts
+ * const logger: HumanPlugin = {
+ *   name: 'logger',
+ *   beforeAction: (action) => console.log(`[${action.type}] starting`),
+ *   afterAction: (action, result) =>
+ *     console.log(`[${action.type}] took ${result.durationMs}ms`),
+ * };
+ * ```
+ */
+interface HumanPlugin {
+    /** Unique identifier used in logs and observability events. */
+    readonly name: string;
+    /** Called once when the plugin is installed on a session. */
+    install?(context: PluginContext): void | Promise<void>;
+    /** Called immediately before every action. */
+    beforeAction?(action: HumanAction): void | Promise<void>;
+    /** Called immediately after an action completes successfully. */
+    afterAction?(action: HumanAction, result: ActionResult): void | Promise<void>;
+    /**
+     * Called when an action throws. The plugin should not re-throw —
+     * the host re-throws after notifying every plugin.
+     */
+    onError?(action: HumanAction, error: unknown): void | Promise<void>;
+}
+/**
+ * Runtime context provided to a plugin's `install` hook.
+ *
+ * Contains the resolved personality and the session's seeded RNG so
+ * plugins can produce deterministic output (e.g. logging fixtures).
+ */
+interface PluginContext {
+    /** The resolved personality this session is using. */
+    readonly personality: Personality;
+    /** The session's seeded RNG. Calling it consumes the shared sequence. */
+    readonly rng: Rng;
+}
+/**
+ * Action types HumanJS adapters are known to emit.
+ *
+ * Plugins can switch on these names for type-safe handling and get IDE
+ * autocomplete on them — but `HumanAction.type` is intentionally widened
+ * to accept any string so adapters can introduce custom or experimental
+ * action types without a core release.
+ */
+type KnownActionType = 'click' | 'drag' | 'goto' | 'hover' | 'paste' | 'read' | 'rightClick' | 'scroll' | 'shortcut' | 'type';
+/**
+ * Loose action-type string: known names autocomplete in IDEs while any
+ * other string still typechecks. Implemented with the `(string & {})`
+ * idiom — TypeScript surfaces the literal members for completion but
+ * widens the type to `string` for assignability.
+ */
+type ActionType = KnownActionType | (string & {});
+/**
+ * A humanized action a plugin can observe.
+ *
+ * Plugins should treat unknown action types defensively — different
+ * adapters emit different sets, and new types can be added at any time.
+ */
+interface HumanAction {
+    /** Action discriminator. Known values autocomplete; any string is accepted. */
+    readonly type: ActionType;
+    /** Action-specific parameters. Shape varies by `type`. */
+    readonly params?: Readonly<Record<string, unknown>>;
+}
+/** Outcome of a completed action, passed to `afterAction`. */
+interface ActionResult {
+    /** Echo of the originating action's `type`. */
+    readonly type: ActionType;
+    /** Wall-clock duration in milliseconds. */
+    readonly durationMs: number;
+}
+
+/**
+ * Slow, precise, few mistakes. Longer dwell on important fields.
+ * The default personality when none is specified.
+ */
+declare const careful: Personality;
+
+/**
+ * Scrolls back, retypes, hovers off, occasional misclicks.
+ * Useful for stress-testing flows that assume perfect input.
+ */
+declare const distracted: Personality;
+
+/**
+ * Quick but still natural. Fewer pauses, lower typo rate, shorter dwell.
+ * Good for sessions where the user "knows the app".
+ */
+declare const fast: Personality;
+
+/**
+ * Minimal noise, smooth motion, near-zero mistakes.
+ * Closer to "expert user" than "average user".
+ */
+declare const precise: Personality;
+
+declare const VERSION = "0.0.0";
+
+export { type ActionResult, type ActionType, type DwellProfile, type HumanAction, type HumanPlugin, type KnownActionType, type MouseProfile, type Personality, type PersonalityConfig, type PersonalityExtension, type PluginContext, type PresetName, type ReadingProfile, type Rng, type TypingProfile, VERSION, blend, careful, createRng, distracted, fast, precise, resolvePersonality };

package/dist/index.js

@@ -0,0 +1,276 @@
+// src/presets/careful.ts
+var careful = {
+  name: "careful",
+  speed: 1,
+  mouse: {
+    curvature: 0.4,
+    travelTimeMs: 450,
+    travelTimeJitter: 0.15,
+    overshootProbability: 0.05,
+    misclickProbability: 0.01
+  },
+  typing: {
+    baseDelayMs: 140,
+    delayJitter: 0.3,
+    typoProbability: 0.02,
+    typoCorrectionProbability: 0.95,
+    thinkPauseProbability: 0.08,
+    thinkPauseMeanMs: 400
+  },
+  reading: {
+    wpm: 220,
+    jitter: 0.2
+  },
+  dwell: {
+    preClickMs: 120,
+    preClickJitter: 0.3,
+    postActionMs: 90,
+    postActionJitter: 0.3
+  }
+};
+
+// src/presets/distracted.ts
+var distracted = {
+  name: "distracted",
+  speed: 1.3,
+  mouse: {
+    curvature: 0.6,
+    travelTimeMs: 600,
+    travelTimeJitter: 0.35,
+    overshootProbability: 0.15,
+    misclickProbability: 0.05
+  },
+  typing: {
+    baseDelayMs: 180,
+    delayJitter: 0.5,
+    typoProbability: 0.06,
+    typoCorrectionProbability: 0.7,
+    thinkPauseProbability: 0.18,
+    thinkPauseMeanMs: 700
+  },
+  reading: {
+    wpm: 180,
+    jitter: 0.4
+  },
+  dwell: {
+    preClickMs: 200,
+    preClickJitter: 0.5,
+    postActionMs: 250,
+    postActionJitter: 0.5
+  }
+};
+
+// src/presets/fast.ts
+var fast = {
+  name: "fast",
+  speed: 0.5,
+  mouse: {
+    curvature: 0.25,
+    travelTimeMs: 250,
+    travelTimeJitter: 0.1,
+    overshootProbability: 0.03,
+    misclickProbability: 5e-3
+  },
+  typing: {
+    baseDelayMs: 60,
+    delayJitter: 0.25,
+    typoProbability: 0.015,
+    typoCorrectionProbability: 0.9,
+    thinkPauseProbability: 0.02,
+    thinkPauseMeanMs: 150
+  },
+  reading: {
+    wpm: 350,
+    jitter: 0.15
+  },
+  dwell: {
+    preClickMs: 50,
+    preClickJitter: 0.25,
+    postActionMs: 40,
+    postActionJitter: 0.25
+  }
+};
+
+// src/presets/precise.ts
+var precise = {
+  name: "precise",
+  speed: 1,
+  mouse: {
+    curvature: 0.2,
+    travelTimeMs: 380,
+    travelTimeJitter: 0.05,
+    overshootProbability: 5e-3,
+    misclickProbability: 1e-3
+  },
+  typing: {
+    baseDelayMs: 110,
+    delayJitter: 0.1,
+    typoProbability: 3e-3,
+    typoCorrectionProbability: 0.99,
+    thinkPauseProbability: 0.03,
+    thinkPauseMeanMs: 200
+  },
+  reading: {
+    wpm: 250,
+    jitter: 0.08
+  },
+  dwell: {
+    preClickMs: 80,
+    preClickJitter: 0.1,
+    postActionMs: 60,
+    postActionJitter: 0.1
+  }
+};
+
+// src/resolve.ts
+var presets = {
+  careful,
+  distracted,
+  fast,
+  precise
+};
+function resolvePersonality(config) {
+  if (typeof config === "string") {
+    return presets[config];
+  }
+  if ("extends" in config) {
+    const base = presets[config.extends];
+    return {
+      name: config.name ?? base.name,
+      speed: config.speed ?? base.speed,
+      mouse: { ...base.mouse, ...config.mouse },
+      typing: { ...base.typing, ...config.typing },
+      reading: { ...base.reading, ...config.reading },
+      dwell: { ...base.dwell, ...config.dwell }
+    };
+  }
+  return config;
+}
+
+// src/blend.ts
+function blend(a, b, ratio) {
+  const personalityA = resolvePersonality(a);
+  const personalityB = resolvePersonality(b);
+  const t = clamp(ratio, 0, 1);
+  return {
+    name: `${personalityA.name}+${personalityB.name}@${t.toFixed(2)}`,
+    speed: lerp(personalityA.speed, personalityB.speed, t),
+    mouse: {
+      curvature: lerp(personalityA.mouse.curvature, personalityB.mouse.curvature, t),
+      travelTimeMs: lerp(personalityA.mouse.travelTimeMs, personalityB.mouse.travelTimeMs, t),
+      travelTimeJitter: lerp(
+        personalityA.mouse.travelTimeJitter,
+        personalityB.mouse.travelTimeJitter,
+        t
+      ),
+      overshootProbability: lerp(
+        personalityA.mouse.overshootProbability,
+        personalityB.mouse.overshootProbability,
+        t
+      ),
+      misclickProbability: lerp(
+        personalityA.mouse.misclickProbability,
+        personalityB.mouse.misclickProbability,
+        t
+      )
+    },
+    typing: {
+      baseDelayMs: lerp(personalityA.typing.baseDelayMs, personalityB.typing.baseDelayMs, t),
+      delayJitter: lerp(personalityA.typing.delayJitter, personalityB.typing.delayJitter, t),
+      typoProbability: lerp(
+        personalityA.typing.typoProbability,
+        personalityB.typing.typoProbability,
+        t
+      ),
+      typoCorrectionProbability: lerp(
+        personalityA.typing.typoCorrectionProbability,
+        personalityB.typing.typoCorrectionProbability,
+        t
+      ),
+      thinkPauseProbability: lerp(
+        personalityA.typing.thinkPauseProbability,
+        personalityB.typing.thinkPauseProbability,
+        t
+      ),
+      thinkPauseMeanMs: lerp(
+        personalityA.typing.thinkPauseMeanMs,
+        personalityB.typing.thinkPauseMeanMs,
+        t
+      )
+    },
+    reading: {
+      wpm: lerp(personalityA.reading.wpm, personalityB.reading.wpm, t),
+      jitter: lerp(personalityA.reading.jitter, personalityB.reading.jitter, t)
+    },
+    dwell: {
+      preClickMs: lerp(personalityA.dwell.preClickMs, personalityB.dwell.preClickMs, t),
+      preClickJitter: lerp(personalityA.dwell.preClickJitter, personalityB.dwell.preClickJitter, t),
+      postActionMs: lerp(personalityA.dwell.postActionMs, personalityB.dwell.postActionMs, t),
+      postActionJitter: lerp(
+        personalityA.dwell.postActionJitter,
+        personalityB.dwell.postActionJitter,
+        t
+      )
+    }
+  };
+}
+function lerp(a, b, t) {
+  return a + (b - a) * t;
+}
+function clamp(value, min, max) {
+  return value < min ? min : value > max ? max : value;
+}
+
+// src/rng.ts
+function createRng(seed) {
+  let state = resolveSeed(seed);
+  const next = () => {
+    state = state + 1831565813 | 0;
+    let t = Math.imul(state ^ state >>> 15, 1 | state);
+    t = t + Math.imul(t ^ t >>> 7, 61 | t) ^ t;
+    return ((t ^ t >>> 14) >>> 0) / 4294967296;
+  };
+  return {
+    next,
+    nextInt(min, max) {
+      return Math.floor(next() * (max - min)) + min;
+    },
+    nextFloat(min, max) {
+      return next() * (max - min) + min;
+    },
+    chance(p) {
+      const clamped = p < 0 ? 0 : p > 1 ? 1 : p;
+      return next() < clamped;
+    },
+    nextGaussian(mean = 0, stdDev = 1) {
+      const u1 = next() || Number.MIN_VALUE;
+      const u2 = next();
+      const z = Math.sqrt(-2 * Math.log(u1)) * Math.cos(2 * Math.PI * u2);
+      return mean + z * stdDev;
+    }
+  };
+}
+function resolveSeed(seed) {
+  if (seed === void 0) {
+    return (Date.now() ^ Math.random() * 4294967296) >>> 0;
+  }
+  if (typeof seed === "number") {
+    return seed >>> 0;
+  }
+  return hashString(seed);
+}
+function hashString(s) {
+  let h = 2166136261;
+  for (let i = 0; i < s.length; i++) {
+    h ^= s.charCodeAt(i);
+    h = Math.imul(h, 16777619);
+  }
+  return h >>> 0;
+}
+
+// src/index.ts
+var VERSION = "0.0.0";
+
+export { VERSION, blend, careful, createRng, distracted, fast, precise, resolvePersonality };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/presets/careful.ts","../src/presets/distracted.ts","../src/presets/fast.ts","../src/presets/precise.ts","../src/resolve.ts","../src/blend.ts","../src/rng.ts","../src/index.ts"],"names":[],"mappings":";AAMO,IAAM,OAAA,GAAuB;AAAA,EAClC,IAAA,EAAM,SAAA;AAAA,EACN,KAAA,EAAO,CAAA;AAAA,EACP,KAAA,EAAO;AAAA,IACL,SAAA,EAAW,GAAA;AAAA,IACX,YAAA,EAAc,GAAA;AAAA,IACd,gBAAA,EAAkB,IAAA;AAAA,IAClB,oBAAA,EAAsB,IAAA;AAAA,IACtB,mBAAA,EAAqB;AAAA,GACvB;AAAA,EACA,MAAA,EAAQ;AAAA,IACN,WAAA,EAAa,GAAA;AAAA,IACb,WAAA,EAAa,GAAA;AAAA,IACb,eAAA,EAAiB,IAAA;AAAA,IACjB,yBAAA,EAA2B,IAAA;AAAA,IAC3B,qBAAA,EAAuB,IAAA;AAAA,IACvB,gBAAA,EAAkB;AAAA,GACpB;AAAA,EACA,OAAA,EAAS;AAAA,IACP,GAAA,EAAK,GAAA;AAAA,IACL,MAAA,EAAQ;AAAA,GACV;AAAA,EACA,KAAA,EAAO;AAAA,IACL,UAAA,EAAY,GAAA;AAAA,IACZ,cAAA,EAAgB,GAAA;AAAA,IAChB,YAAA,EAAc,EAAA;AAAA,IACd,gBAAA,EAAkB;AAAA;AAEtB;;;AC5BO,IAAM,UAAA,GAA0B;AAAA,EACrC,IAAA,EAAM,YAAA;AAAA,EACN,KAAA,EAAO,GAAA;AAAA,EACP,KAAA,EAAO;AAAA,IACL,SAAA,EAAW,GAAA;AAAA,IACX,YAAA,EAAc,GAAA;AAAA,IACd,gBAAA,EAAkB,IAAA;AAAA,IAClB,oBAAA,EAAsB,IAAA;AAAA,IACtB,mBAAA,EAAqB;AAAA,GACvB;AAAA,EACA,MAAA,EAAQ;AAAA,IACN,WAAA,EAAa,GAAA;AAAA,IACb,WAAA,EAAa,GAAA;AAAA,IACb,eAAA,EAAiB,IAAA;AAAA,IACjB,yBAAA,EAA2B,GAAA;AAAA,IAC3B,qBAAA,EAAuB,IAAA;AAAA,IACvB,gBAAA,EAAkB;AAAA,GACpB;AAAA,EACA,OAAA,EAAS;AAAA,IACP,GAAA,EAAK,GAAA;AAAA,IACL,MAAA,EAAQ;AAAA,GACV;AAAA,EACA,KAAA,EAAO;AAAA,IACL,UAAA,EAAY,GAAA;AAAA,IACZ,cAAA,EAAgB,GAAA;AAAA,IAChB,YAAA,EAAc,GAAA;AAAA,IACd,gBAAA,EAAkB;AAAA;AAEtB;;;AC5BO,IAAM,IAAA,GAAoB;AAAA,EAC/B,IAAA,EAAM,MAAA;AAAA,EACN,KAAA,EAAO,GAAA;AAAA,EACP,KAAA,EAAO;AAAA,IACL,SAAA,EAAW,IAAA;AAAA,IACX,YAAA,EAAc,GAAA;AAAA,IACd,gBAAA,EAAkB,GAAA;AAAA,IAClB,oBAAA,EAAsB,IAAA;AAAA,IACtB,mBAAA,EAAqB;AAAA,GACvB;AAAA,EACA,MAAA,EAAQ;AAAA,IACN,WAAA,EAAa,EAAA;AAAA,IACb,WAAA,EAAa,IAAA;AAAA,IACb,eAAA,EAAiB,KAAA;AAAA,IACjB,yBAAA,EAA2B,GAAA;AAAA,IAC3B,qBAAA,EAAuB,IAAA;AAAA,IACvB,gBAAA,EAAkB;AAAA,GACpB;AAAA,EACA,OAAA,EAAS;AAAA,IACP,GAAA,EAAK,GAAA;AAAA,IACL,MAAA,EAAQ;AAAA,GACV;AAAA,EACA,KAAA,EAAO;AAAA,IACL,UAAA,EAAY,EAAA;AAAA,IACZ,cAAA,EAAgB,IAAA;AAAA,IAChB,YAAA,EAAc,EAAA;AAAA,IACd,gBAAA,EAAkB;AAAA;AAEtB;;;AC5BO,IAAM,OAAA,GAAuB;AAAA,EAClC,IAAA,EAAM,SAAA;AAAA,EACN,KAAA,EAAO,CAAA;AAAA,EACP,KAAA,EAAO;AAAA,IACL,SAAA,EAAW,GAAA;AAAA,IACX,YAAA,EAAc,GAAA;AAAA,IACd,gBAAA,EAAkB,IAAA;AAAA,IAClB,oBAAA,EAAsB,IAAA;AAAA,IACtB,mBAAA,EAAqB;AAAA,GACvB;AAAA,EACA,MAAA,EAAQ;AAAA,IACN,WAAA,EAAa,GAAA;AAAA,IACb,WAAA,EAAa,GAAA;AAAA,IACb,eAAA,EAAiB,IAAA;AAAA,IACjB,yBAAA,EAA2B,IAAA;AAAA,IAC3B,qBAAA,EAAuB,IAAA;AAAA,IACvB,gBAAA,EAAkB;AAAA,GACpB;AAAA,EACA,OAAA,EAAS;AAAA,IACP,GAAA,EAAK,GAAA;AAAA,IACL,MAAA,EAAQ;AAAA,GACV;AAAA,EACA,KAAA,EAAO;AAAA,IACL,UAAA,EAAY,EAAA;AAAA,IACZ,cAAA,EAAgB,GAAA;AAAA,IAChB,YAAA,EAAc,EAAA;AAAA,IACd,gBAAA,EAAkB;AAAA;AAEtB;;;ACtBA,IAAM,OAAA,GAA2C;AAAA,EAC/C,OAAA;AAAA,EACA,UAAA;AAAA,EACA,IAAA;AAAA,EACA;AACF,CAAA;AA+BO,SAAS,mBAAmB,MAAA,EAAwC;AACzE,EAAA,IAAI,OAAO,WAAW,QAAA,EAAU;AAC9B,IAAA,OAAO,QAAQ,MAAM,CAAA;AAAA,EACvB;AACA,EAAA,IAAI,aAAa,MAAA,EAAQ;AACvB,IAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,MAAA,CAAO,OAAO,CAAA;AACnC,IAAA,OAAO;AAAA,MACL,IAAA,EAAM,MAAA,CAAO,IAAA,IAAQ,IAAA,CAAK,IAAA;AAAA,MAC1B,KAAA,EAAO,MAAA,CAAO,KAAA,IAAS,IAAA,CAAK,KAAA;AAAA,MAC5B,OAAO,EAAE,GAAG,KAAK,KAAA,EAAO,GAAG,OAAO,KAAA,EAAM;AAAA,MACxC,QAAQ,EAAE,GAAG,KAAK,MAAA,EAAQ,GAAG,OAAO,MAAA,EAAO;AAAA,MAC3C,SAAS,EAAE,GAAG,KAAK,OAAA,EAAS,GAAG,OAAO,OAAA,EAAQ;AAAA,MAC9C,OAAO,EAAE,GAAG,KAAK,KAAA,EAAO,GAAG,OAAO,KAAA;AAAM,KAC1C;AAAA,EACF;AACA,EAAA,OAAO,MAAA;AACT;;;AClCO,SAAS,KAAA,CAAM,CAAA,EAAsB,CAAA,EAAsB,KAAA,EAA4B;AAC5F,EAAA,MAAM,YAAA,GAAe,mBAAmB,CAAC,CAAA;AACzC,EAAA,MAAM,YAAA,GAAe,mBAAmB,CAAC,CAAA;AACzC,EAAA,MAAM,CAAA,GAAI,KAAA,CAAM,KAAA,EAAO,CAAA,EAAG,CAAC,CAAA;AAE3B,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,CAAA,EAAG,YAAA,CAAa,IAAI,CAAA,CAAA,EAAI,YAAA,CAAa,IAAI,CAAA,CAAA,EAAI,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,CAAA,CAAA;AAAA,IAC/D,OAAO,IAAA,CAAK,YAAA,CAAa,KAAA,EAAO,YAAA,CAAa,OAAO,CAAC,CAAA;AAAA,IACrD,KAAA,EAAO;AAAA,MACL,SAAA,EAAW,KAAK,YAAA,CAAa,KAAA,CAAM,WAAW,YAAA,CAAa,KAAA,CAAM,WAAW,CAAC,CAAA;AAAA,MAC7E,YAAA,EAAc,KAAK,YAAA,CAAa,KAAA,CAAM,cAAc,YAAA,CAAa,KAAA,CAAM,cAAc,CAAC,CAAA;AAAA,MACtF,gBAAA,EAAkB,IAAA;AAAA,QAChB,aAAa,KAAA,CAAM,gBAAA;AAAA,QACnB,aAAa,KAAA,CAAM,gBAAA;AAAA,QACnB;AAAA,OACF;AAAA,MACA,oBAAA,EAAsB,IAAA;AAAA,QACpB,aAAa,KAAA,CAAM,oBAAA;AAAA,QACnB,aAAa,KAAA,CAAM,oBAAA;AAAA,QACnB;AAAA,OACF;AAAA,MACA,mBAAA,EAAqB,IAAA;AAAA,QACnB,aAAa,KAAA,CAAM,mBAAA;AAAA,QACnB,aAAa,KAAA,CAAM,mBAAA;AAAA,QACnB;AAAA;AACF,KACF;AAAA,IACA,MAAA,EAAQ;AAAA,MACN,WAAA,EAAa,KAAK,YAAA,CAAa,MAAA,CAAO,aAAa,YAAA,CAAa,MAAA,CAAO,aAAa,CAAC,CAAA;AAAA,MACrF,WAAA,EAAa,KAAK,YAAA,CAAa,MAAA,CAAO,aAAa,YAAA,CAAa,MAAA,CAAO,aAAa,CAAC,CAAA;AAAA,MACrF,eAAA,EAAiB,IAAA;AAAA,QACf,aAAa,MAAA,CAAO,eAAA;AAAA,QACpB,aAAa,MAAA,CAAO,eAAA;AAAA,QACpB;AAAA,OACF;AAAA,MACA,yBAAA,EAA2B,IAAA;AAAA,QACzB,aAAa,MAAA,CAAO,yBAAA;AAAA,QACpB,aAAa,MAAA,CAAO,yBAAA;AAAA,QACpB;AAAA,OACF;AAAA,MACA,qBAAA,EAAuB,IAAA;AAAA,QACrB,aAAa,MAAA,CAAO,qBAAA;AAAA,QACpB,aAAa,MAAA,CAAO,qBAAA;AAAA,QACpB;AAAA,OACF;AAAA,MACA,gBAAA,EAAkB,IAAA;AAAA,QAChB,aAAa,MAAA,CAAO,gBAAA;AAAA,QACpB,aAAa,MAAA,CAAO,gBAAA;AAAA,QACpB;AAAA;AACF,KACF;AAAA,IACA,OAAA,EAAS;AAAA,MACP,GAAA,EAAK,KAAK,YAAA,CAAa,OAAA,CAAQ,KAAK,YAAA,CAAa,OAAA,CAAQ,KAAK,CAAC,CAAA;AAAA,MAC/D,MAAA,EAAQ,KAAK,YAAA,CAAa,OAAA,CAAQ,QAAQ,YAAA,CAAa,OAAA,CAAQ,QAAQ,CAAC;AAAA,KAC1E;AAAA,IACA,KAAA,EAAO;AAAA,MACL,UAAA,EAAY,KAAK,YAAA,CAAa,KAAA,CAAM,YAAY,YAAA,CAAa,KAAA,CAAM,YAAY,CAAC,CAAA;AAAA,MAChF,cAAA,EAAgB,KAAK,YAAA,CAAa,KAAA,CAAM,gBAAgB,YAAA,CAAa,KAAA,CAAM,gBAAgB,CAAC,CAAA;AAAA,MAC5F,YAAA,EAAc,KAAK,YAAA,CAAa,KAAA,CAAM,cAAc,YAAA,CAAa,KAAA,CAAM,cAAc,CAAC,CAAA;AAAA,MACtF,gBAAA,EAAkB,IAAA;AAAA,QAChB,aAAa,KAAA,CAAM,gBAAA;AAAA,QACnB,aAAa,KAAA,CAAM,gBAAA;AAAA,QACnB;AAAA;AACF;AACF,GACF;AACF;AAMA,SAAS,IAAA,CAAK,CAAA,EAAW,CAAA,EAAW,CAAA,EAAmB;AACrD,EAAA,OAAO,CAAA,GAAA,CAAK,IAAI,CAAA,IAAK,CAAA;AACvB;AAGA,SAAS,KAAA,CAAM,KAAA,EAAe,GAAA,EAAa,GAAA,EAAqB;AAC9D,EAAA,OAAO,KAAA,GAAQ,GAAA,GAAM,GAAA,GAAM,KAAA,GAAQ,MAAM,GAAA,GAAM,KAAA;AACjD;;;AC3EO,SAAS,UAAU,IAAA,EAA6B;AACrD,EAAA,IAAI,KAAA,GAAQ,YAAY,IAAI,CAAA;AAE5B,EAAA,MAAM,OAAO,MAAc;AACzB,IAAA,KAAA,GAAS,QAAQ,UAAA,GAAc,CAAA;AAC/B,IAAA,IAAI,IAAI,IAAA,CAAK,IAAA,CAAK,QAAS,KAAA,KAAU,EAAA,EAAK,IAAI,KAAK,CAAA;AACnD,IAAA,CAAA,GAAK,CAAA,GAAI,KAAK,IAAA,CAAK,CAAA,GAAK,MAAM,CAAA,EAAI,EAAA,GAAK,CAAC,CAAA,GAAK,CAAA;AAC7C,IAAA,OAAA,CAAA,CAAS,CAAA,GAAK,CAAA,KAAM,EAAA,MAAS,CAAA,IAAK,UAAA;AAAA,EACpC,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,IAAA;AAAA,IACA,OAAA,CAAQ,KAAK,GAAA,EAAK;AAChB,MAAA,OAAO,KAAK,KAAA,CAAM,IAAA,EAAK,IAAK,GAAA,GAAM,IAAI,CAAA,GAAI,GAAA;AAAA,IAC5C,CAAA;AAAA,IACA,SAAA,CAAU,KAAK,GAAA,EAAK;AAClB,MAAA,OAAO,IAAA,EAAK,IAAK,GAAA,GAAM,GAAA,CAAA,GAAO,GAAA;AAAA,IAChC,CAAA;AAAA,IACA,OAAO,CAAA,EAAG;AACR,MAAA,MAAM,UAAU,CAAA,GAAI,CAAA,GAAI,CAAA,GAAI,CAAA,GAAI,IAAI,CAAA,GAAI,CAAA;AACxC,MAAA,OAAO,MAAK,GAAI,OAAA;AAAA,IAClB,CAAA;AAAA,IACA,YAAA,CAAa,IAAA,GAAO,CAAA,EAAG,MAAA,GAAS,CAAA,EAAG;AACjC,MAAA,MAAM,EAAA,GAAK,IAAA,EAAK,IAAK,MAAA,CAAO,SAAA;AAC5B,MAAA,MAAM,KAAK,IAAA,EAAK;AAChB,MAAA,MAAM,CAAA,GAAI,IAAA,CAAK,IAAA,CAAK,EAAA,GAAK,KAAK,GAAA,CAAI,EAAE,CAAC,CAAA,GAAI,IAAA,CAAK,GAAA,CAAI,CAAA,GAAI,IAAA,CAAK,KAAK,EAAE,CAAA;AAClE,MAAA,OAAO,OAAO,CAAA,GAAI,MAAA;AAAA,IACpB;AAAA,GACF;AACF;AAQA,SAAS,YAAY,IAAA,EAA2C;AAC9D,EAAA,IAAI,SAAS,MAAA,EAAW;AACtB,IAAA,OAAA,CAAQ,KAAK,GAAA,EAAI,GAAK,IAAA,CAAK,MAAA,KAAW,UAAA,MAAkB,CAAA;AAAA,EAC1D;AACA,EAAA,IAAI,OAAO,SAAS,QAAA,EAAU;AAC5B,IAAA,OAAO,IAAA,KAAS,CAAA;AAAA,EAClB;AACA,EAAA,OAAO,WAAW,IAAI,CAAA;AACxB;AAEA,SAAS,WAAW,CAAA,EAAmB;AACrC,EAAA,IAAI,CAAA,GAAI,UAAA;AACR,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,CAAA,CAAE,QAAQ,CAAA,EAAA,EAAK;AACjC,IAAA,CAAA,IAAK,CAAA,CAAE,WAAW,CAAC,CAAA;AACnB,IAAA,CAAA,GAAI,IAAA,CAAK,IAAA,CAAK,CAAA,EAAG,QAAU,CAAA;AAAA,EAC7B;AACA,EAAA,OAAO,CAAA,KAAM,CAAA;AACf;;;ACxFO,IAAM,OAAA,GAAU","file":"index.js","sourcesContent":["import type { Personality } from '../personality.js';\n\n/**\n * Slow, precise, few mistakes. Longer dwell on important fields.\n * The default personality when none is specified.\n */\nexport const careful: Personality = {\n  name: 'careful',\n  speed: 1.0,\n  mouse: {\n    curvature: 0.4,\n    travelTimeMs: 450,\n    travelTimeJitter: 0.15,\n    overshootProbability: 0.05,\n    misclickProbability: 0.01,\n  },\n  typing: {\n    baseDelayMs: 140,\n    delayJitter: 0.3,\n    typoProbability: 0.02,\n    typoCorrectionProbability: 0.95,\n    thinkPauseProbability: 0.08,\n    thinkPauseMeanMs: 400,\n  },\n  reading: {\n    wpm: 220,\n    jitter: 0.2,\n  },\n  dwell: {\n    preClickMs: 120,\n    preClickJitter: 0.3,\n    postActionMs: 90,\n    postActionJitter: 0.3,\n  },\n};\n","import type { Personality } from '../personality.js';\n\n/**\n * Scrolls back, retypes, hovers off, occasional misclicks.\n * Useful for stress-testing flows that assume perfect input.\n */\nexport const distracted: Personality = {\n  name: 'distracted',\n  speed: 1.3,\n  mouse: {\n    curvature: 0.6,\n    travelTimeMs: 600,\n    travelTimeJitter: 0.35,\n    overshootProbability: 0.15,\n    misclickProbability: 0.05,\n  },\n  typing: {\n    baseDelayMs: 180,\n    delayJitter: 0.5,\n    typoProbability: 0.06,\n    typoCorrectionProbability: 0.7,\n    thinkPauseProbability: 0.18,\n    thinkPauseMeanMs: 700,\n  },\n  reading: {\n    wpm: 180,\n    jitter: 0.4,\n  },\n  dwell: {\n    preClickMs: 200,\n    preClickJitter: 0.5,\n    postActionMs: 250,\n    postActionJitter: 0.5,\n  },\n};\n","import type { Personality } from '../personality.js';\n\n/**\n * Quick but still natural. Fewer pauses, lower typo rate, shorter dwell.\n * Good for sessions where the user \"knows the app\".\n */\nexport const fast: Personality = {\n  name: 'fast',\n  speed: 0.5,\n  mouse: {\n    curvature: 0.25,\n    travelTimeMs: 250,\n    travelTimeJitter: 0.1,\n    overshootProbability: 0.03,\n    misclickProbability: 0.005,\n  },\n  typing: {\n    baseDelayMs: 60,\n    delayJitter: 0.25,\n    typoProbability: 0.015,\n    typoCorrectionProbability: 0.9,\n    thinkPauseProbability: 0.02,\n    thinkPauseMeanMs: 150,\n  },\n  reading: {\n    wpm: 350,\n    jitter: 0.15,\n  },\n  dwell: {\n    preClickMs: 50,\n    preClickJitter: 0.25,\n    postActionMs: 40,\n    postActionJitter: 0.25,\n  },\n};\n","import type { Personality } from '../personality.js';\n\n/**\n * Minimal noise, smooth motion, near-zero mistakes.\n * Closer to \"expert user\" than \"average user\".\n */\nexport const precise: Personality = {\n  name: 'precise',\n  speed: 1.0,\n  mouse: {\n    curvature: 0.2,\n    travelTimeMs: 380,\n    travelTimeJitter: 0.05,\n    overshootProbability: 0.005,\n    misclickProbability: 0.001,\n  },\n  typing: {\n    baseDelayMs: 110,\n    delayJitter: 0.1,\n    typoProbability: 0.003,\n    typoCorrectionProbability: 0.99,\n    thinkPauseProbability: 0.03,\n    thinkPauseMeanMs: 200,\n  },\n  reading: {\n    wpm: 250,\n    jitter: 0.08,\n  },\n  dwell: {\n    preClickMs: 80,\n    preClickJitter: 0.1,\n    postActionMs: 60,\n    postActionJitter: 0.1,\n  },\n};\n","import type {\n  DwellProfile,\n  MouseProfile,\n  Personality,\n  ReadingProfile,\n  TypingProfile,\n} from './personality.js';\nimport { careful, distracted, fast, precise } from './presets/index.js';\n\n/** Names of the four built-in personality presets. */\nexport type PresetName = 'careful' | 'distracted' | 'fast' | 'precise';\n\nconst presets: Record<PresetName, Personality> = {\n  careful,\n  distracted,\n  fast,\n  precise,\n};\n\n/**\n * A preset extended with partial overrides at the top level and on any\n * facet. Unspecified fields fall through to the base preset.\n */\nexport interface PersonalityExtension {\n  readonly extends: PresetName;\n  readonly name?: string;\n  readonly speed?: number;\n  readonly mouse?: Partial<MouseProfile>;\n  readonly typing?: Partial<TypingProfile>;\n  readonly reading?: Partial<ReadingProfile>;\n  readonly dwell?: Partial<DwellProfile>;\n}\n\n/**\n * Anything that can be passed where a personality is expected.\n * - A preset name (`'careful'`, `'fast'`, …)\n * - A preset + partial overrides via `{ extends: 'careful', … }`\n * - A fully built `Personality` (community packages, results of `blend()`)\n */\nexport type PersonalityConfig = PresetName | PersonalityExtension | Personality;\n\n/**\n * Resolves any `PersonalityConfig` into a flat `Personality`.\n *\n * Never mutates the base preset — overrides produce a fresh object. The\n * returned `Personality` is safe to share, snapshot, and pass to\n * `createHuman()` or `blend()`.\n */\nexport function resolvePersonality(config: PersonalityConfig): Personality {\n  if (typeof config === 'string') {\n    return presets[config];\n  }\n  if ('extends' in config) {\n    const base = presets[config.extends];\n    return {\n      name: config.name ?? base.name,\n      speed: config.speed ?? base.speed,\n      mouse: { ...base.mouse, ...config.mouse },\n      typing: { ...base.typing, ...config.typing },\n      reading: { ...base.reading, ...config.reading },\n      dwell: { ...base.dwell, ...config.dwell },\n    };\n  }\n  return config;\n}\n","import type { Personality } from './personality.js';\nimport { type PersonalityConfig, resolvePersonality } from './resolve.js';\n\n/**\n * Composes two personalities into a new one by linearly interpolating\n * every numeric field at the given ratio.\n *\n * Both inputs are first resolved (so preset names, extensions, and full\n * personalities are all accepted). Then every numeric field — top-level\n * `speed` plus every field on every facet — is interpolated as\n * `a + (b - a) * ratio`. The base presets are never mutated.\n *\n * @param a - First personality. The result equals `a` at `ratio = 0`.\n * @param b - Second personality. The result equals `b` at `ratio = 1`.\n * @param ratio - How much of `b` to mix in, from 0 to 1.\n *   `0` returns pure `a`, `1` returns pure `b`, `0.5` is the midpoint.\n *   Clamped if out of range.\n *\n * @example Two-way blend\n * ```ts\n * // 70% careful + 30% distracted\n * const mostlyCareful = blend('careful', 'distracted', 0.3);\n * ```\n *\n * @example Three-way blend via composition\n * ```ts\n * // Equal mix of three: (2/3) × (0.5·careful + 0.5·fast) + (1/3) × distracted\n * const even = blend(blend('careful', 'fast', 0.5), 'distracted', 1 / 3);\n * ```\n */\nexport function blend(a: PersonalityConfig, b: PersonalityConfig, ratio: number): Personality {\n  const personalityA = resolvePersonality(a);\n  const personalityB = resolvePersonality(b);\n  const t = clamp(ratio, 0, 1);\n\n  return {\n    name: `${personalityA.name}+${personalityB.name}@${t.toFixed(2)}`,\n    speed: lerp(personalityA.speed, personalityB.speed, t),\n    mouse: {\n      curvature: lerp(personalityA.mouse.curvature, personalityB.mouse.curvature, t),\n      travelTimeMs: lerp(personalityA.mouse.travelTimeMs, personalityB.mouse.travelTimeMs, t),\n      travelTimeJitter: lerp(\n        personalityA.mouse.travelTimeJitter,\n        personalityB.mouse.travelTimeJitter,\n        t,\n      ),\n      overshootProbability: lerp(\n        personalityA.mouse.overshootProbability,\n        personalityB.mouse.overshootProbability,\n        t,\n      ),\n      misclickProbability: lerp(\n        personalityA.mouse.misclickProbability,\n        personalityB.mouse.misclickProbability,\n        t,\n      ),\n    },\n    typing: {\n      baseDelayMs: lerp(personalityA.typing.baseDelayMs, personalityB.typing.baseDelayMs, t),\n      delayJitter: lerp(personalityA.typing.delayJitter, personalityB.typing.delayJitter, t),\n      typoProbability: lerp(\n        personalityA.typing.typoProbability,\n        personalityB.typing.typoProbability,\n        t,\n      ),\n      typoCorrectionProbability: lerp(\n        personalityA.typing.typoCorrectionProbability,\n        personalityB.typing.typoCorrectionProbability,\n        t,\n      ),\n      thinkPauseProbability: lerp(\n        personalityA.typing.thinkPauseProbability,\n        personalityB.typing.thinkPauseProbability,\n        t,\n      ),\n      thinkPauseMeanMs: lerp(\n        personalityA.typing.thinkPauseMeanMs,\n        personalityB.typing.thinkPauseMeanMs,\n        t,\n      ),\n    },\n    reading: {\n      wpm: lerp(personalityA.reading.wpm, personalityB.reading.wpm, t),\n      jitter: lerp(personalityA.reading.jitter, personalityB.reading.jitter, t),\n    },\n    dwell: {\n      preClickMs: lerp(personalityA.dwell.preClickMs, personalityB.dwell.preClickMs, t),\n      preClickJitter: lerp(personalityA.dwell.preClickJitter, personalityB.dwell.preClickJitter, t),\n      postActionMs: lerp(personalityA.dwell.postActionMs, personalityB.dwell.postActionMs, t),\n      postActionJitter: lerp(\n        personalityA.dwell.postActionJitter,\n        personalityB.dwell.postActionJitter,\n        t,\n      ),\n    },\n  };\n}\n\n/**\n * Linear interpolation between two numbers. Returns `a` at `t = 0`,\n * `b` at `t = 1`, and a proportional mix in between.\n */\nfunction lerp(a: number, b: number, t: number): number {\n  return a + (b - a) * t;\n}\n\n/** Clamps `value` to the inclusive range `[min, max]`. */\nfunction clamp(value: number, min: number, max: number): number {\n  return value < min ? min : value > max ? max : value;\n}\n","/**\n * Seedable pseudo-random number generator used throughout HumanJS.\n *\n * Implementations must be deterministic given a seed: `createRng('foo')`\n * followed by N calls to `next()` always produces the same sequence on\n * any platform. This is what makes humanization snapshot-testable.\n */\nexport interface Rng {\n  /** Returns a uniform float in [0, 1). */\n  next(): number;\n  /** Returns a uniform integer in [min, max). */\n  nextInt(min: number, max: number): number;\n  /** Returns a uniform float in [min, max). */\n  nextFloat(min: number, max: number): number;\n  /** Returns true with probability `p`. Clamped to [0, 1]. */\n  chance(p: number): boolean;\n  /**\n   * Returns a Gaussian-distributed sample via the Box-Muller transform.\n   * Defaults: mean = 0, standard deviation = 1.\n   */\n  nextGaussian(mean?: number, stdDev?: number): number;\n}\n\n/**\n * Creates a seedable PRNG. Identical seeds produce identical sequences\n * on every run and every platform.\n *\n * Algorithm: mulberry32 — a 32-bit, 2^32-period generator with strong\n * statistical properties for the timing distributions HumanJS produces.\n * Not suitable for cryptographic use.\n *\n * @param seed - String (hashed via FNV-1a), number (used directly), or\n *   undefined (system-time-based; sessions become non-reproducible).\n */\nexport function createRng(seed?: string | number): Rng {\n  let state = resolveSeed(seed);\n\n  const next = (): number => {\n    state = (state + 0x6d2b79f5) | 0;\n    let t = Math.imul(state ^ (state >>> 15), 1 | state);\n    t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;\n    return ((t ^ (t >>> 14)) >>> 0) / 0x100000000;\n  };\n\n  return {\n    next,\n    nextInt(min, max) {\n      return Math.floor(next() * (max - min)) + min;\n    },\n    nextFloat(min, max) {\n      return next() * (max - min) + min;\n    },\n    chance(p) {\n      const clamped = p < 0 ? 0 : p > 1 ? 1 : p;\n      return next() < clamped;\n    },\n    nextGaussian(mean = 0, stdDev = 1) {\n      const u1 = next() || Number.MIN_VALUE;\n      const u2 = next();\n      const z = Math.sqrt(-2 * Math.log(u1)) * Math.cos(2 * Math.PI * u2);\n      return mean + z * stdDev;\n    },\n  };\n}\n\n/**\n * Normalizes any seed input to a 32-bit unsigned integer — the state shape\n * mulberry32 requires. Numbers (including negative or fractional ones) are\n * coerced via `>>> 0`; strings hash to a uint32 via FNV-1a; undefined\n * derives a non-reproducible seed from system time.\n */\nfunction resolveSeed(seed: string | number | undefined): number {\n  if (seed === undefined) {\n    return (Date.now() ^ (Math.random() * 0x100000000)) >>> 0;\n  }\n  if (typeof seed === 'number') {\n    return seed >>> 0;\n  }\n  return hashString(seed);\n}\n\nfunction hashString(s: string): number {\n  let h = 0x811c9dc5;\n  for (let i = 0; i < s.length; i++) {\n    h ^= s.charCodeAt(i);\n    h = Math.imul(h, 0x01000193);\n  }\n  return h >>> 0;\n}\n","export const VERSION = '0.0.0';\n\nexport { blend } from './blend.js';\nexport type {\n  DwellProfile,\n  MouseProfile,\n  Personality,\n  ReadingProfile,\n  TypingProfile,\n} from './personality.js';\nexport type {\n  ActionResult,\n  ActionType,\n  HumanAction,\n  HumanPlugin,\n  KnownActionType,\n  PluginContext,\n} from './plugin.js';\nexport { careful, distracted, fast, precise } from './presets/index.js';\nexport type {\n  PersonalityConfig,\n  PersonalityExtension,\n  PresetName,\n} from './resolve.js';\nexport { resolvePersonality } from './resolve.js';\nexport type { Rng } from './rng.js';\nexport { createRng } from './rng.js';\n"]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@humanjs/core",
+  "version": "0.1.0",
+  "description": "Personality system, timing math, types, and plugin contract for HumanJS.",
+  "keywords": [
+    "humanjs",
+    "humanize",
+    "playwright",
+    "browser-automation"
+  ],
+  "author": "Gonzalo Muñoz <toti@eventurex.com.ar>",
+  "license": "MIT",
+  "homepage": "https://humanjs.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/totigm/humanjs.git",
+    "directory": "packages/core"
+  },
+  "bugs": "https://github.com/totigm/humanjs/issues",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check .",
+    "clean": "rm -rf dist .turbo"
+  }
+}