@glissade/sfx 0.5.0-pre.2 → 0.5.0-pre.3

package/dist/index.d.ts

@@ -118,5 +118,39 @@ interface SfxClipOptions {
  * re-evaluation out of order never drifts. Mirrors buildNarrationClips.
  */
 declare function buildSfxClips(hits: readonly SfxHit[], source: SfxSource, opts?: SfxClipOptions): AudioClip[];
+/** One keystroke to sonify — the structural shape both the typewriter's
+ * `EditMark` and a monotonic `RevealMark` satisfy. `kind` lets a backspace
+ * take a different sample; absent, it's treated as an insert. */
+interface KeystrokeMark {
+  time: number;
+  grapheme: string;
+  kind?: 'insert' | 'delete';
+}
+interface KeystrokeOptions extends SfxClipOptions {
+  /** voice for inserts (a typed char); default 'type' */
+  insertVoice?: string;
+  /** voice for deletes (a backspace); default = insertVoice */
+  deleteVoice?: string;
+  /**
+   * Round-robin pool for inserts (overrides insertVoice) — a real keyboard
+   * foley pack rotates several keypress recordings so the typing doesn't sound
+   * looped. The per-keystroke pick is index-seeded (deterministic).
+   */
+  insertVoices?: readonly string[];
+  /** round-robin pool for deletes (overrides deleteVoice; default = the insert pool) */
+  deleteVoices?: readonly string[];
+  /** graphemes to NOT click; default whitespace (space, tab, newline) */
+  skip?: (grapheme: string) => boolean;
+}
+/**
+ * One AudioClip per keystroke, placed at its time — the SFX side of the
+ * typewriter, the analogue of buildNarrationClips. Consumes the typewriter's
+ * `marks` (insert + delete) or a monotonic `revealSchedule` (inserts only).
+ * Char-class policy lives HERE: whitespace is skipped by default, a backspace
+ * can take a distinct voice, and a multi-sample pool round-robins (index-seeded)
+ * for non-looping foley. The marks stay neutral data; everything is a pure
+ * function of position.
+ */
+declare function keystrokeClips(marks: readonly KeystrokeMark[], source: SfxSource, opts?: KeystrokeOptions): AudioClip[];
 //#endregion
-export { PRESETS, SFX_PRESETS, SfxClipOptions, SfxError, SfxHit, SfxPreset, SfxSamplePack, SfxSource, SfxVoiceRef, SfxWaveform, SfxrParams, buildSfxClips, encodeWavMono, hashStr, renderSfxAssets, renderSfxr, samplePackSource, sfxFileName, sfxrSource };
+export { KeystrokeMark, KeystrokeOptions, PRESETS, SFX_PRESETS, SfxClipOptions, SfxError, SfxHit, SfxPreset, SfxSamplePack, SfxSource, SfxVoiceRef, SfxWaveform, SfxrParams, buildSfxClips, encodeWavMono, hashStr, keystrokeClips, renderSfxAssets, renderSfxr, samplePackSource, sfxFileName, sfxrSource };

package/dist/index.js

@@ -289,5 +289,33 @@ function buildSfxClips(hits, source, opts = {}) {
 		return clip;
 	});
 }
+const isWhitespace = (g) => /^\s+$/.test(g);
+/**
+* One AudioClip per keystroke, placed at its time — the SFX side of the
+* typewriter, the analogue of buildNarrationClips. Consumes the typewriter's
+* `marks` (insert + delete) or a monotonic `revealSchedule` (inserts only).
+* Char-class policy lives HERE: whitespace is skipped by default, a backspace
+* can take a distinct voice, and a multi-sample pool round-robins (index-seeded)
+* for non-looping foley. The marks stay neutral data; everything is a pure
+* function of position.
+*/
+function keystrokeClips(marks, source, opts = {}) {
+	const insertPool = opts.insertVoices ?? [opts.insertVoice ?? "type"];
+	const deletePool = opts.deleteVoices ?? (opts.deleteVoice ? [opts.deleteVoice] : insertPool);
+	const skip = opts.skip ?? isWhitespace;
+	const seed = opts.seed ?? 0;
+	return buildSfxClips(marks.filter((m) => !skip(m.grapheme)).map((m, index) => {
+		const pool = m.kind === "delete" ? deletePool : insertPool;
+		let voice = pool[0];
+		if (pool.length > 1) {
+			const r = random((seed ^ hashStr("keystroke") ^ Math.imul(index + 1, 2246822507)) >>> 0)();
+			voice = pool[Math.min(pool.length - 1, Math.floor(r * pool.length))];
+		}
+		return {
+			voice,
+			at: m.time
+		};
+	}), source, opts);
+}
 //#endregion
-export { PRESETS, SFX_PRESETS, SfxError, buildSfxClips, encodeWavMono, hashStr, renderSfxAssets, renderSfxr, samplePackSource, sfxFileName, sfxrSource };
+export { PRESETS, SFX_PRESETS, SfxError, buildSfxClips, encodeWavMono, hashStr, keystrokeClips, renderSfxAssets, renderSfxr, samplePackSource, sfxFileName, sfxrSource };

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "@glissade/sfx",
-  "version": "0.5.0-pre.2",
+  "version": "0.5.0-pre.3",
   "description": "glissade sound effects: a clean-room procedural (sfxr-style) synth, license-checked sample packs, and deterministic index-seeded variation — committed WAVs feed the same offline FFmpeg mix as narration and music.",
   "license": "Apache-2.0",
   "type": "module",
   "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -15,7 +18,7 @@
     "dist"
   ],
   "dependencies": {
-    "@glissade/core": "0.5.0-pre.2"
+    "@glissade/core": "0.5.0-pre.3"
   },
   "repository": {
     "type": "git",