Deep rename Text to Speech V2 and fix accordion empty-state behavior - PR_26130_025-text-to-speech-v2-deep-rename-and-accordion-state

Author: DavidQ

docs/dev/reports/PR_26130_025-text-to-speech-v2-deep-rename-and-accordion-state.md

@@ -0,0 +1,40 @@
+# PR_26130_025-text-to-speech-v2-deep-rename-and-accordion-state
+
+## Scope
+
+Updated Text to Speech V2 and direct Workspace Manager/tool references for the canonical `text2speech-V2` spelling, playback gating, scroll behavior, last-item delete behavior, and accordion height behavior.
+
+## Changes
+
+- Renamed Text to Speech V2 direct code, CSS, DOM ids, test selectors, tool ids, schema ids, logs, sample wiring, and workspace/tool references from `text2speach` to `text2speech`.
+- Added explicit legacy compatibility for the old `text2speach-V2` tool path, schema path, sample JSON path, workspace toolState key, and tool id alias so existing links/session state migrate visibly instead of silently failing.
+- Disabled Speak, Pause, Resume, and Stop until a valid named speech item is selected and text/voice options are present.
+- Added internal scrolling for Output Summary content and summary pre blocks.
+- Allowed deleting the last Named Sentence, leaves a safe empty runtime state, and blocks copy/export/save through schema validation until a new schema-valid item is added.
+- Centered Add, Duplicate, and Delete actions.
+- Updated Text to Speech V2 accordions so open accordions share available vertical space and closed accordions collapse in normal and fullscreen modes.
+- Kept Workspace Manager V2 Text to Speech tile availability based on normal repo/game selection and selected-game launch purpose.
+
+## Legacy Migration Notes
+
+Preserved compatibility only for required direct Text to Speech V2 references:
+
+- `/tools/text2speach-V2/index.html` redirects to `/tools/text2speech-V2/index.html` while preserving query string and hash.
+- `/tools/schemas/tools/text2speach-V2.schema.json` remains as an alias file whose `$id` points to `tools/schemas/tools/text2speech-V2.schema.json`.
+- `/samples/phase-19/1903/sample.1903.text2speach-V2.json` remains as an alias payload matching the canonical `sample.1903.text2speech-V2.json`.
+- `workspace.tools.text2speach-V2` session state migrates to `workspace.tools.text2speech-V2` with a status log entry.
+- `root.tools.text2speach-V2` workspace payloads migrate to `root.tools.text2speech-V2` during Workspace Manager context normalization and report the migration in status.
+- Tool registry alias maps `text2speach-V2` to `text2speech-V2`.
+
+## Validation
+
+- `node --check tools/text2speech-V2/js/TextToSpeechToolApp.js` passed.
+- `node --check tools/workspace-manager-v2/js/services/WorkspaceManagerV2ContextService.js` passed.
+- `node --check tools/toolRegistry.js` passed.
+- `node --check tests/playwright/tools/WorkspaceManagerV2.spec.mjs` passed.
+- `npm run test:workspace-v2` passed: 35 tests passed.
+- `git diff --check` passed with line-ending normalization warnings only.
+
+## Skipped
+
+- Full samples smoke test skipped because the BUILD request explicitly said not to run it.

samples/metadata/samples.index.metadata.json

@@ -1,4 +1,4 @@
-{
+{
   "$schema": "../../tools/schemas/samples/sample.tool-payload.schema.json",
   "version": 1,
   "phases": [
@@ -3453,11 +3453,11 @@
       "preview": "/samples/phase-19/1903/assets/images/preview.svg",
       "classValues": [],
       "engineClassesUsed": [],
-      "toolHints": ["text2speach-V2"],
+      "toolHints": ["text2speech-V2"],
       "roundtripToolPresets": [
         {
-          "toolId": "text2speach-V2",
-          "presetPath": "/samples/phase-19/1903/sample.1903.text2speach-V2.json"
+          "toolId": "text2speech-V2",
+          "presetPath": "/samples/phase-19/1903/sample.1903.text2speech-V2.json"
         }
       ]
     }

samples/phase-19/1903/README.md

@@ -1,14 +1,14 @@
-<!-- SAMPLE_LOCAL_CONTRACT_README -->
+<!-- SAMPLE_LOCAL_CONTRACT_README -->
 # Sample 1903 - Text to Speech V2 JSON Source
 
 Sample-local contract for `samples/phase-19/1903`.
 
 ## Implementation Location
 
 - Entrypoint: `samples/phase-19/1903/index.html`
-- Sample payload: `samples/phase-19/1903/sample.1903.text2speach-V2.json`
-- The payload is a Text to Speech V2 root array of named speech items and validates against `tools/schemas/tools/text2speach-V2.schema.json`.
-- The sample launches `/tools/text2speach-V2/index.html` with `samplePresetPath` pointing at the sample JSON.
+- Sample payload: `samples/phase-19/1903/sample.1903.text2speech-V2.json`
+- The payload is a Text to Speech V2 root array of named speech items and validates against `tools/schemas/tools/text2speech-V2.schema.json`.
+- The sample launches `/tools/text2speech-V2/index.html` with `samplePresetPath` pointing at the sample JSON.
 
 ## Discovery Contract
 

samples/phase-19/1903/main.js

@@ -1,12 +1,12 @@
-/*
+/*
 Toolbox Aid
 David Quesenberry
 05/11/2026
 main.js
 */
 
-const TEXT_TO_SPEECH_PATH = "/tools/text2speach-V2/index.html";
-const TEXT_TO_SPEECH_SAMPLE_PRESET_PATH = "/samples/phase-19/1903/sample.1903.text2speach-V2.json";
+const TEXT_TO_SPEECH_PATH = "/tools/text2speech-V2/index.html";
+const TEXT_TO_SPEECH_SAMPLE_PRESET_PATH = "/samples/phase-19/1903/sample.1903.text2speech-V2.json";
 
 function buildTextToSpeechHref() {
   const params = new URLSearchParams({

samples/phase-19/1903/sample.1903.text2speach-V2.json

@@ -0,0 +1,47 @@
+[
+  {
+    "id": "narrator-welcome",
+    "name": "Narrator welcome",
+    "text": "Welcome to Toolbox Aid. This is the default Text to Speech V2 sample line for previewing narration, prompts, and menu feedback.",
+    "gender": "any",
+    "language": "en-US",
+    "voice": "mock-google-us-english",
+    "voiceAge": "any",
+    "volume": 1,
+    "rate": 1,
+    "pitch": 1,
+    "queueMode": "replace",
+    "characterPreset": "narrator",
+    "ssmlLikePreset": "normal"
+  },
+  {
+    "id": "hero-ready",
+    "name": "Hero ready",
+    "text": "Systems ready. The hero prompt is queued for an upbeat menu confirmation.",
+    "gender": "male-preferred",
+    "language": "en-GB",
+    "voice": "mock-google-uk-english-male",
+    "voiceAge": "teen",
+    "volume": 1,
+    "rate": 1.2,
+    "pitch": 1.4,
+    "queueMode": "append",
+    "characterPreset": "dramatic",
+    "ssmlLikePreset": "normal"
+  },
+  {
+    "id": "alert-warning",
+    "name": "Alert warning",
+    "text": "Warning. Incoming hazard detected. Please confirm the next action.",
+    "gender": "female-preferred",
+    "language": "en-US",
+    "voice": "mock-microsoft-zira",
+    "voiceAge": "adult",
+    "volume": 0.9,
+    "rate": 1.3,
+    "pitch": 0.9,
+    "queueMode": "replace",
+    "characterPreset": "alert",
+    "ssmlLikePreset": "normal"
+  }
+]

src/engine/audio/TextToSpeechDefaults.js

@@ -1,5 +1,5 @@
-const TEXT_TO_SPEECH_TOOL_ID = "text2speach-V2";
-const TEXT_TO_SPEECH_SCHEMA_ID = "tools/schemas/tools/text2speach-V2.schema.json";
+const TEXT_TO_SPEECH_TOOL_ID = "text2speech-V2";
+const TEXT_TO_SPEECH_SCHEMA_ID = "tools/schemas/tools/text2speech-V2.schema.json";
 const TEXT_TO_SPEECH_DISPLAY_NAME = "Text to Speech V2";
 
 const TEXT_TO_SPEECH_LANGUAGE_OPTIONS = Object.freeze([