dsh-theme-endfield 0.0.0-stage → 1.2.2

package/lib/tone.js

@@ -0,0 +1,216 @@
+'use strict';
+/**
+ * Zero-dependency PCM WAV tone synthesizer.
+ *
+ * The audio-notification feature needs four short sounds and must NOT ship
+ * binary audio assets (no licensing question, no repo weight). This module
+ * computes the samples instead: a note is a fundamental plus a few harmonics
+ * under an attack/decay envelope, and the mix is normalized so every slot lands
+ * at the same loudness.
+ *
+ * Output format is deliberately the one the whole stack already proved it can
+ * play (verified end to end with Windows Media.SoundPlayer): RIFF/WAVE,
+ * 16-bit PCM, mono, 44.1 kHz.
+ */
+
+const SAMPLE_RATE = 44100;
+
+/** Equal-temperament pitch of one note name against A4 = 440 Hz. */
+const SEMITONES = { C: -9, 'C#': -8, D: -7, 'D#': -6, E: -5, F: -4, 'F#': -3, G: -2, 'G#': -1, A: 0, 'A#': 1, B: 2 };
+
+/**
+ * Resolve a note name such as `C5`, `F#4` or `A4` to hertz.
+ * @param name - letter, optional `#`, then the octave digit(s).
+ * @returns frequency in hertz.
+ */
+function noteHz(name) {
+  const match = /^([A-G]#?)(-?\d+)$/.exec(String(name));
+  if (match === null) throw new Error(`bad note name: ${name}`);
+  const semitone = SEMITONES[match[1]];
+  const octave = Number(match[2]);
+  return 440 * Math.pow(2, (semitone + (octave - 4) * 12) / 12);
+}
+
+/** Timbre presets: [harmonic multiplier, amplitude] pairs. */
+const TIMBRES = {
+  // Warm chime: fundamental with a soft octave and a faint twelfth.
+  chime: [[1, 1], [2, 0.3], [3, 0.08]],
+  // Bright, more present top end — for the short "received" blip.
+  blip: [[1, 1], [2, 0.42], [3, 0.12]],
+  // Hollow and darker — used where the sound must read as a warning.
+  hollow: [[1, 1], [2, 0.12], [3, 0.3]],
+};
+
+/**
+ * Mix one note into the sample buffer.
+ *
+ * @param data - mono sample buffer, added into (not overwritten).
+ * @param spec - frequency (Hz), start (s), duration (s), gain, timbre, detune
+ *   in cents applied to the whole note, and envelope shape.
+ */
+function addNote(data, spec) {
+  const {
+    freq,
+    start,
+    duration,
+    gain,
+    timbre = 'chime',
+    detuneCents = 0,
+    attack = 0.006,
+    decay = 1.15,
+    curve = 2.2,
+  } = spec;
+  const hz = freq * Math.pow(2, detuneCents / 1200);
+  const from = Math.floor(start * SAMPLE_RATE);
+  const length = Math.floor(duration * SAMPLE_RATE);
+  const attackSamples = Math.max(1, Math.floor(attack * SAMPLE_RATE));
+  const voices = TIMBRES[timbre];
+  if (voices === undefined) throw new Error(`unknown timbre: ${timbre}`);
+  for (let i = 0; i < length; i++) {
+    const cursor = from + i;
+    if (cursor >= data.length) break;
+    const t = i / SAMPLE_RATE;
+    const envelope =
+      (i < attackSamples ? i / attackSamples : 1) *
+      Math.pow(1 - i / length, curve) *
+      Math.exp(-decay * t);
+    let sample = 0;
+    for (const [multiplier, amplitude] of voices) {
+      sample += amplitude * Math.sin(2 * Math.PI * hz * multiplier * t);
+    }
+    data[cursor] += sample * envelope * gain;
+  }
+}
+
+/**
+ * Render a slot definition to a complete WAV file.
+ *
+ * @param slot - `{ duration, peakDbfs, notes: [...] }` where each note uses the
+ *   `addNote` fields plus a `note` name instead of a raw frequency.
+ * @returns the file bytes.
+ */
+function renderWav(slot) {
+  const total = Math.floor(SAMPLE_RATE * slot.duration);
+  const data = new Float64Array(total);
+  for (const note of slot.notes) {
+    addNote(data, Object.assign({}, note, {
+      freq: note.freq === undefined ? noteHz(note.note) : note.freq,
+    }));
+  }
+  let peak = 0;
+  for (let i = 0; i < total; i++) peak = Math.max(peak, Math.abs(data[i]));
+  const target = Math.pow(10, (slot.peakDbfs === undefined ? -2 : slot.peakDbfs) / 20);
+  const scale = peak > 0 ? target / peak : 1;
+  const pcm = Buffer.alloc(total * 2);
+  for (let i = 0; i < total; i++) {
+    let value = Math.round(data[i] * scale * 32767);
+    if (value > 32767) value = 32767;
+    if (value < -32768) value = -32768;
+    pcm.writeInt16LE(value, i * 2);
+  }
+  const header = Buffer.alloc(44);
+  header.write('RIFF', 0, 'ascii');
+  header.writeUInt32LE(36 + pcm.length, 4);
+  header.write('WAVE', 8, 'ascii');
+  header.write('fmt ', 12, 'ascii');
+  header.writeUInt32LE(16, 16);
+  header.writeUInt16LE(1, 20); // PCM
+  header.writeUInt16LE(1, 22); // mono
+  header.writeUInt32LE(SAMPLE_RATE, 24);
+  header.writeUInt32LE(SAMPLE_RATE * 2, 28);
+  header.writeUInt16LE(2, 32);
+  header.writeUInt16LE(16, 34);
+  header.write('data', 36, 'ascii');
+  header.writeUInt32LE(pcm.length, 40);
+  return Buffer.concat([header, pcm]);
+}
+
+/** Parse a WAV buffer far enough to locate its PCM data and format. */
+function parseWav(buffer) {
+  if (buffer.length < 44) return undefined;
+  if (buffer.toString('ascii', 0, 4) !== 'RIFF' || buffer.toString('ascii', 8, 12) !== 'WAVE') return undefined;
+  let offset = 12;
+  let audioFormat = 0;
+  let bitsPerSample = 0;
+  let channels = 0;
+  let sampleRate = 0;
+  let dataOffset = -1;
+  let dataSize = 0;
+  while (offset + 8 <= buffer.length) {
+    const id = buffer.toString('ascii', offset, offset + 4);
+    const chunkSize = buffer.readUInt32LE(offset + 4);
+    const body = offset + 8;
+    /* chunkSize is file-controlled, so every read below is also bounded by the
+       real buffer length: a truncated fmt chunk (declared size past the end of
+       the file) would otherwise throw RangeError out of parseWav — and
+       scaleWavVolume runs it on user-dropped files whenever volume < 100. */
+    if (id === 'fmt ' && chunkSize >= 16 && buffer.length >= body + 16) {
+      audioFormat = buffer.readUInt16LE(body);
+      channels = buffer.readUInt16LE(body + 2);
+      sampleRate = buffer.readUInt32LE(body + 4);
+      bitsPerSample = buffer.readUInt16LE(body + 14);
+      // WAVE_FORMAT_EXTENSIBLE wraps the real format in the first two bytes of
+      // the sub-format GUID.
+      if (audioFormat === 0xfffe && chunkSize >= 40 && buffer.length >= body + 26
+        && buffer.readUInt16LE(body + 24) === 1) audioFormat = 1;
+    } else if (id === 'data') {
+      dataOffset = body;
+      dataSize = Math.min(chunkSize, buffer.length - body);
+    }
+    if (dataOffset >= 0 && bitsPerSample > 0) break;
+    offset = body + chunkSize + (chunkSize % 2);
+  }
+  if (dataOffset < 0 || audioFormat !== 1) return undefined;
+  if (channels <= 0 || sampleRate <= 0) return undefined;
+  return { dataOffset, dataSize, bitsPerSample, channels, sampleRate };
+}
+
+/**
+ * Rescale a PCM WAV's samples by `volume` percent without touching the system
+ * volume. Returns the original buffer when the format is not rescalable, so a
+ * caller can always write the result out.
+ *
+ * @param buffer - the source WAV bytes.
+ * @param volume - 0..100.
+ * @returns scaled WAV bytes (or the input, unchanged, when scaling is a no-op).
+ */
+function scaleWavVolume(buffer, volume) {
+  const gain = volume / 100;
+  if (gain === 1) return buffer;
+  const parsed = parseWav(buffer);
+  if (parsed === undefined) return buffer;
+  const { dataOffset, dataSize, bitsPerSample, channels } = parsed;
+  if (bitsPerSample !== 16 && bitsPerSample !== 8) return buffer;
+  /* Scale EVERY channel. The first version assumed mono and stepped 2 bytes per
+     sample, so on stereo input it scaled only the left channel — volume 50 would
+     have produced a left channel at half level and an untouched right one. The
+     bundled tones are mono, but a user-supplied file need not be, and the whole
+     point of this path is honouring a user's own audio. */
+  const frameBytes = (bitsPerSample / 8) * channels;
+  const out = Buffer.from(buffer);
+  const frames = Math.floor(dataSize / frameBytes);
+  if (bitsPerSample === 16) {
+    for (let frame = 0; frame < frames; frame++) {
+      for (let channel = 0; channel < channels; channel++) {
+        const pos = dataOffset + frame * frameBytes + channel * 2;
+        let value = Math.round(out.readInt16LE(pos) * gain);
+        if (value > 32767) value = 32767;
+        else if (value < -32768) value = -32768;
+        out.writeInt16LE(value, pos);
+      }
+    }
+  } else {
+    for (let frame = 0; frame < frames; frame++) {
+      for (let channel = 0; channel < channels; channel++) {
+        const pos = dataOffset + frame * frameBytes + channel;
+        let value = Math.round((out.readUInt8(pos) - 128) * gain + 128);
+        if (value > 255) value = 255;
+        else if (value < 0) value = 0;
+        out.writeUInt8(value, pos);
+      }
+    }
+  }
+  return out;
+}
+
+module.exports = { SAMPLE_RATE, noteHz, renderWav, scaleWavVolume, parseWav };

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Endfield Theme",
+    "description": "Arknights: Endfield industrial editorial theme for the Harness web UI — cream paper, ink text, signal accents, zero radius."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "终末地主题",
+    "description": "《明日方舟：终末地》工业编辑风主题：奶油纸底、墨黑文字、信号色强调、全直角。"
+  }
+}

package/package.json

@@ -1,6 +1,113 @@
 {
   "name": "dsh-theme-endfield",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.2.2",
+  "description": "DeepSeek Harness web theme: the industrial editorial look of the Arknights: Endfield official site — cream paper, ink text, signal-yellow accents, zero radius. Settings persist through the DSH volatile Config + configForms transport (0.2.0-rc.2 and 0.1.7+), with a ctx.settingsScope fallback for older hosts.",
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "plugin",
+    "theme",
+    "endfield",
+    "arknights",
+    "client"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ymh0000123/dsh-theme-endfield.git"
+  },
+  "homepage": "https://github.com/ymh0000123/dsh-theme-endfield#readme",
+  "bugs": {
+    "url": "https://github.com/ymh0000123/dsh-theme-endfield/issues"
+  },
+  "main": "index.js",
+  "scripts": {
+    "check": "node scripts/build-host.js --check && node scripts/build-client.js --check && node scripts/build-contour-worker.js --check && node check.js",
+    "selftest": "node selftest.js",
+    "sound:build": "node scripts/build-sounds.js",
+    "sound:check": "node scripts/build-sounds.js --check",
+    "test:audio": "node test/audio-notify.test.js",
+    "test:audio-watch": "node test/audio-attention-watch.test.js && node test/host-no-inject.test.js",
+    "test:contour": "node test/contour-render.test.js",
+    "test:settings": "node test/settings-rows.test.js && node test/settings-durable-hold.test.js && node test/settings-config-forms.test.js && node test/settings-config-fallback.test.js && node test/settings-namespace.test.js && node test/settings-off.test.js && node test/settings-locale.test.js",
+    "test:font": "node test/font-scope.test.js",
+    "test:thunder": "node test/thunder-edges.test.js && node test/thunder-shot.js && node test/thunder-dismiss.test.js",
+    "test:palette": "node test/palette-contrast.test.js && node test/palette-switch.test.js",
+    "test:menu": "node test/menu-surface.test.js dark && node test/menu-surface.test.js light",
+    "test:selector": "node test/selector-guard.test.js && node test/preset-chip.test.js",
+    "test:buttons": "node test/settings-buttons.test.js && node test/hover-check.js",
+    "test:balance": "node test/balance-window.test.js && node test/balance-capsule.test.js && node test/credit-capsule.test.js",
+    "test:live": "node test/live-check.js",
+    "test:specks": "node test/contour-specks.test.js",
+    "test:watermark": "node test/watermark-stacking.test.js",
+    "test:smoothness": "node test/contour-smoothness.test.js",
+    "test:cusps": "node test/contour-cusps.test.js",
+    "test:a11y": "node test/contour-a11y.test.js",
+    "test:coverage": "node test/contour-coverage.test.js",
+    "test:perf": "node test/contour-perf.test.js",
+    "test:loader": "node test/loader-performance.test.js && node test/loader-late-prefs.test.js",
+    "test": "node check.js && node selftest.js && node test/font-scope.test.js && node test/palette-contrast.test.js && node test/palette-switch.test.js && node test/menu-surface.test.js dark && node test/menu-surface.test.js light && node test/settings-buttons.test.js && node test/hover-check.js && node test/selector-guard.test.js && node test/preset-chip.test.js && node test/balance-window.test.js && node test/balance-capsule.test.js && node test/credit-capsule.test.js && node test/settings-rows.test.js && node test/settings-durable-hold.test.js && node test/settings-config-forms.test.js && node test/settings-config-fallback.test.js && node test/settings-namespace.test.js && node test/settings-off.test.js && node test/settings-locale.test.js && node test/audio-notify.test.js && node test/audio-attention-watch.test.js && node test/host-no-inject.test.js && node scripts/build-sounds.js --check && node test/thunder-edges.test.js && node test/thunder-shot.js && node test/thunder-dismiss.test.js && node test/contour-render.test.js && node test/loader-performance.test.js && node test/loader-late-prefs.test.js && node test/contour-specks.test.js && node test/watermark-stacking.test.js && node test/contour-smoothness.test.js && node test/contour-cusps.test.js && node test/contour-a11y.test.js && node test/contour-coverage.test.js && node test/contour-perf.test.js && node test/contour-density.test.js && node test/contour-bounds.test.js && node scripts/build-host.js --check && node scripts/build-client.js --check && node scripts/build-contour-worker.js --check && node test/worker-eol.test.js && node test/contour-worker.test.js && node test/theme-sheet-refresh.test.js && node test/titlebar-probe.test.js && node test/corner-shape.test.js && node test/glass.test.js && node test/contour-trail.test.js && node test/contour-trail-browser.test.js && node test/scroll-anim.test.js && node test/contour-loop-reentry.test.js",
+    "test:ci": "node check.js && node selftest.js && node test/font-scope.test.js && node test/palette-contrast.test.js && node test/palette-switch.test.js && node test/menu-surface.test.js dark && node test/menu-surface.test.js light && node test/settings-buttons.test.js && node test/hover-check.js && node test/selector-guard.test.js && node test/preset-chip.test.js && node test/balance-window.test.js && node test/balance-capsule.test.js && node test/credit-capsule.test.js && node test/settings-rows.test.js && node test/settings-durable-hold.test.js && node test/settings-config-forms.test.js && node test/settings-config-fallback.test.js && node test/settings-namespace.test.js && node test/settings-off.test.js && node test/settings-locale.test.js && node test/audio-notify.test.js && node test/audio-attention-watch.test.js && node test/host-no-inject.test.js && node scripts/build-sounds.js --check && node test/thunder-edges.test.js && node test/thunder-shot.js && node test/thunder-dismiss.test.js && node test/contour-render.test.js && node test/loader-performance.test.js && node test/loader-late-prefs.test.js && node test/contour-specks.test.js && node test/watermark-stacking.test.js && node test/contour-smoothness.test.js && node test/contour-cusps.test.js && node test/contour-a11y.test.js && node test/contour-bounds.test.js && node scripts/build-host.js --check && node scripts/build-client.js --check && node scripts/build-contour-worker.js --check && node test/worker-eol.test.js && node test/contour-worker.test.js && node test/theme-sheet-refresh.test.js && node test/titlebar-probe.test.js && node test/corner-shape.test.js && node test/glass.test.js && node test/contour-trail.test.js && node test/contour-trail-browser.test.js && node test/scroll-anim.test.js && node test/contour-loop-reentry.test.js",
+    "shots": "node test/shoot.js",
+    "shots:verify": "node test/shoot.js && node test/verify-shots.js",
+    "test:bounds": "node test/contour-bounds.test.js",
+    "build:host": "node scripts/build-host.js",
+    "check:host": "node scripts/build-host.js --check",
+    "build:client": "node scripts/build-client.js",
+    "check:client": "node scripts/build-client.js --check",
+    "build:worker": "node scripts/build-contour-worker.js",
+    "check:worker": "node scripts/build-contour-worker.js --check",
+    "test:worker": "node scripts/build-host.js --check && node scripts/build-client.js --check && node scripts/build-contour-worker.js --check && node test/worker-eol.test.js && node test/contour-worker.test.js",
+    "test:glass": "node test/glass.test.js",
+    "test:sheet": "node test/theme-sheet-refresh.test.js",
+    "test:corners": "node test/corner-shape.test.js",
+    "test:trail": "node test/contour-trail.test.js",
+    "test:trail-browser": "node test/contour-trail-browser.test.js",
+    "test:scroll": "node test/scroll-anim.test.js"
+  },
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-theme",
+        "@deepseek-ai/dsh-client-ui-renderer",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-api-session-controller"
+      ]
+    }
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "cordis.patch.yml",
+    "locale",
+    "README.md",
+    "docs",
+    "lib",
+    "sounds",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    }
+  }
+}