docs: rename commands and update API references for v2 surface

Renames `moveCursor` to `move`, `clearSelection` to `unselect`, `mark`/`unmark` to `style`/`unstyle`, and updates all related types, docs, sidebar nav, and README examples to match the new command names. Also adds `AudioManagerHelper` to the API sidebar and simplifies the `delete` call signature in the quick start example.

Author: eoussama

README.md

@@ -22,13 +22,13 @@ pnpm add eo-typewriterjs
 
 ## Why eo-typewriterjs
 
-- **Composable timeline**: chain type, delete, wait, move, select, and call commands in any order
-- **Flexible advance modes**: type by character, word, line, grapheme, or custom chunk size
-- **Rich text support**: apply styles and marks to ranges during playback
-- **Full Unicode**: handles emoji, accented characters, and complex grapheme clusters correctly
-- **Renderer-agnostic**: built-in DOM and string renderers; implement `IRenderer` to target anything
-- **TypeScript-first**: fully typed public API with no `any`
-- **Playback controls**: play, pause, stop, replay, and cancel from any point
+- **Composable timeline**: chain type, delete, wait, move, select, unselect, style, unstyle, and call commands in any order.
+- **Flexible advance modes**: type by character, word, line, grapheme, or custom chunk size.
+- **Rich text support**: apply styles to ranges during playback.
+- **Full Unicode**: handles emoji, accented characters, and complex grapheme clusters correctly.
+- **Renderer-agnostic**: built-in DOM and string renderers; implement `IRenderer` to target anything.
+- **TypeScript-first**: fully typed public API with no `any`.
+- **Playback controls**: play, pause, stop, replay, and cancel from any point.
 
 ## Quick start
 
@@ -47,8 +47,8 @@ tw.timeline
   .type("Hello, ")
   .type("world!", { by: "word", interval: 120 })
   .wait(400)
-  .delete({ amount: 6 })
-  .type("eo-typewriterjs.", { interval: 80 });
+  .delete(6)
+  .type("EO TypewriterJS.");
 
 await tw.play();
 ```

docs/.vitepress/config.ts

@@ -65,11 +65,11 @@ export default defineConfig({
             { text: "type", link: "/guide/commands/type" },
             { text: "wait", link: "/guide/commands/wait" },
             { text: "delete", link: "/guide/commands/delete" },
-            { text: "moveCursor", link: "/guide/commands/move-cursor" },
+            { text: "move", link: "/guide/commands/move" },
             { text: "select", link: "/guide/commands/select" },
-            { text: "clearSelection", link: "/guide/commands/clear-selection" },
-            { text: "mark", link: "/guide/commands/mark" },
-            { text: "unmark", link: "/guide/commands/unmark" },
+            { text: "unselect", link: "/guide/commands/unselect" },
+            { text: "style", link: "/guide/commands/style" },
+            { text: "unstyle", link: "/guide/commands/unstyle" },
             { text: "call", link: "/guide/commands/call" },
           ],
         },
@@ -87,6 +87,10 @@ export default defineConfig({
           text: "Timeline",
           items: [{ text: "TimelineBuilder", link: "/api/classes/TimelineBuilder" }],
         },
+        {
+          text: "Audio",
+          items: [{ text: "AudioManagerHelper", link: "/api/classes/AudioManagerHelper" }],
+        },
         {
           text: "Renderers",
           items: [
@@ -132,17 +136,17 @@ export default defineConfig({
             { text: "TAdvanceUnit", link: "/api/type-aliases/TAdvanceUnit" },
             { text: "TDeleteCommand", link: "/api/type-aliases/TDeleteCommand" },
             { text: "TDeleteOptions", link: "/api/type-aliases/TDeleteOptions" },
-            { text: "TMoveCursorCommand", link: "/api/type-aliases/TMoveCursorCommand" },
-            { text: "TMoveCursorOptions", link: "/api/type-aliases/TMoveCursorOptions" },
+            { text: "TMoveCommand", link: "/api/type-aliases/TMoveCommand" },
+            { text: "TMoveOptions", link: "/api/type-aliases/TMoveOptions" },
             { text: "TSelectCommand", link: "/api/type-aliases/TSelectCommand" },
             { text: "TSelectOptions", link: "/api/type-aliases/TSelectOptions" },
-            { text: "TClearSelectionCommand", link: "/api/type-aliases/TClearSelectionCommand" },
-            { text: "TClearSelectionOptions", link: "/api/type-aliases/TClearSelectionOptions" },
-            { text: "TMarkCommand", link: "/api/type-aliases/TMarkCommand" },
-            { text: "TMarkOptions", link: "/api/type-aliases/TMarkOptions" },
-            { text: "TMarkRange", link: "/api/type-aliases/TMarkRange" },
-            { text: "TUnmarkCommand", link: "/api/type-aliases/TUnmarkCommand" },
-            { text: "TUnmarkOptions", link: "/api/type-aliases/TUnmarkOptions" },
+            { text: "TUnselectCommand", link: "/api/type-aliases/TUnselectCommand" },
+            { text: "TUnselectOptions", link: "/api/type-aliases/TUnselectOptions" },
+            { text: "TStyleCommand", link: "/api/type-aliases/TStyleCommand" },
+            { text: "TStyleOptions", link: "/api/type-aliases/TStyleOptions" },
+            { text: "TStyleRange", link: "/api/type-aliases/TStyleRange" },
+            { text: "TUnstyleCommand", link: "/api/type-aliases/TUnstyleCommand" },
+            { text: "TUnstyleOptions", link: "/api/type-aliases/TUnstyleOptions" },
             { text: "TCallCommand", link: "/api/type-aliases/TCallCommand" },
             { text: "TCallbackFn", link: "/api/type-aliases/TCallbackFn" },
             { text: "TCallbackContext", link: "/api/type-aliases/TCallbackContext" },
@@ -160,11 +164,11 @@ export default defineConfig({
             { text: "TEventKind", link: "/api/type-aliases/TEventKind" },
             { text: "TInsertEvent", link: "/api/type-aliases/TInsertEvent" },
             { text: "TDeleteEvent", link: "/api/type-aliases/TDeleteEvent" },
-            { text: "TMoveCursorEvent", link: "/api/type-aliases/TMoveCursorEvent" },
+            { text: "TMoveEvent", link: "/api/type-aliases/TMoveEvent" },
             { text: "TSelectEvent", link: "/api/type-aliases/TSelectEvent" },
-            { text: "TClearSelectionEvent", link: "/api/type-aliases/TClearSelectionEvent" },
-            { text: "TMarkEvent", link: "/api/type-aliases/TMarkEvent" },
-            { text: "TUnmarkEvent", link: "/api/type-aliases/TUnmarkEvent" },
+            { text: "TUnselectEvent", link: "/api/type-aliases/TUnselectEvent" },
+            { text: "TStyleEvent", link: "/api/type-aliases/TStyleEvent" },
+            { text: "TUnstyleEvent", link: "/api/type-aliases/TUnstyleEvent" },
           ],
         },
         {

docs/guide/commands/delete.md

@@ -121,12 +121,12 @@ await tw.play();
 
 ## Interaction with cursor position
 
-`.delete()` removes text backward from wherever the cursor currently is. Use `.moveCursor()` first to delete from a specific position:
+`.delete()` removes text backward from wherever the cursor currently is. Use `.move()` first to delete from a specific position:
 
 ```ts
 tw.timeline
   .type("Hello World")
-  .moveCursor(5) // cursor is now at index 5 (between "Hello" and " ")
+  .move(5) // cursor is now at index 5 (between "Hello" and " ")
   .delete(5, { by: "char", interval: 60 }); // removes "Hello"
 
 await tw.play();
@@ -140,7 +140,7 @@ If the targeted cursor has an active selection when `.delete()` fires, the entir
 ```ts
 tw.timeline
   .type("Hello World")
-  .moveCursor(6)
+  .move(6)
   .select(5) // selects "World"
   .delete(1); // deletes the selection in one step
 

docs/guide/commands/index.md

@@ -9,11 +9,11 @@ Commands are the building blocks of a typewriter animation. They are scheduled o
 | [Type](/guide/commands/type) | `.type(text, options?)` | ✅ yes | ✅ yes — inserts text |
 | [Wait](/guide/commands/wait) | `.wait(duration)` | ✅ yes | ❌ no |
 | [Delete](/guide/commands/delete) | `.delete(count, options?)` | ✅ yes | ✅ yes — removes text |
-| [Move Cursor](/guide/commands/move-cursor) | `.moveCursor(index, options?)` | ❌ instant | ❌ no |
+| [Move](/guide/commands/move) | `.move(index, options?)` | ❌ instant | ❌ no |
 | [Select](/guide/commands/select) | `.select(count, options?)` | ❌ instant | ❌ no |
-| [Clear Selection](/guide/commands/clear-selection) | `.clearSelection(options?)` | ❌ instant | ❌ no |
-| [Mark](/guide/commands/mark) | `.mark(style, range, options?)` | ❌ instant | ✅ yes — applies style |
-| [Unmark](/guide/commands/unmark) | `.unmark(range, options?)` | ❌ instant | ✅ yes — removes style |
+| [Unselect](/guide/commands/unselect) | `.unselect(options?)` | ❌ instant | ❌ no |
+| [Style](/guide/commands/style) | `.style(style, range, options?)` | ❌ instant | ✅ yes — applies style |
+| [Unstyle](/guide/commands/unstyle) | `.unstyle(range, options?)` | ❌ instant | ✅ yes — removes style |
 | [Call](/guide/commands/call) | `.call(fn, options?)` | ❌ instant | ❌ no |
 
 ## Shared options
@@ -86,9 +86,9 @@ The `callback` function receives a `TCallbackContext`:
 - [type](/guide/commands/type)
 - [wait](/guide/commands/wait)
 - [delete](/guide/commands/delete)
-- [moveCursor](/guide/commands/move-cursor)
+- [move](/guide/commands/move)
 - [select](/guide/commands/select)
-- [clearSelection](/guide/commands/clear-selection)
-- [mark](/guide/commands/mark)
-- [unmark](/guide/commands/unmark)
+- [unselect](/guide/commands/unselect)
+- [style](/guide/commands/style)
+- [unstyle](/guide/commands/unstyle)
 - [call](/guide/commands/call)

docs/guide/commands/move-cursor.md docs/guide/commands/move.mddocs/guide/commands/move-cursor.md renamed to docs/guide/commands/move.md

@@ -1,17 +1,17 @@
-# `.moveCursor()` — reposition the cursor
+# `.move()` — reposition the cursor
 
 Teleports the cursor to a given absolute document index instantly.
 
 ```ts
-tw.timeline.moveCursor(index: number, options?: TMoveCursorOptions): TimelineBuilder
+tw.timeline.move(index: number, options?: TMoveOptions): TimelineBuilder
 ```
 
-`.moveCursor()` is an **instant command**. It produces a single event at the current timeline clock position and does **not** advance the clock. Commands after it start at the same timestamp.
+`.move()` is an **instant command**. It produces a single event at the current timeline clock position and does **not** advance the clock. Commands after it start at the same timestamp.
 
 ## Options
 
 ```ts
-type TMoveCursorOptions = {
+type TMoveOptions = {
   cursor?: TCursorSelector; // default: "main"
   before?: TCallbackHook;
   after?: TCallbackHook;
@@ -30,7 +30,7 @@ type TMoveCursorOptions = {
 
 - `index` is an **absolute** character index into the document text (`0` = before the first character, `text.length` = after the last character).
 - `index` is **clamped** to `[0, document.text.length]` — values outside this range are silently clamped, not rejected.
-- The cursor's current **selection is cleared** when `.moveCursor()` fires.
+- The cursor's current **selection is cleared** when `.move()` fires.
 - The move is invisible — no visual transition occurs, the cursor jumps immediately.
 - Subsequent `.type()` calls insert at the new cursor position.
 - Subsequent `.delete()` calls remove backward from the new cursor position.
@@ -44,7 +44,7 @@ type TMoveCursorOptions = {
 tw.timeline
   .type("world", { by: "char", interval: 80 })
   .wait(400)
-  .moveCursor(0)
+  .move(0)
   .type("Hello ", { by: "char", interval: 80 });
 
 await tw.play();
@@ -56,7 +56,7 @@ await tw.play();
 ```ts
 tw.timeline
   .type("Helloworld", { by: "char", interval: 80 })
-  .moveCursor(5)
+  .move(5)
   .type(" ");
 
 await tw.play();
@@ -69,7 +69,7 @@ await tw.play();
 tw.timeline
   .type("Hello World", { by: "char", interval: 80 })
   .wait(600)
-  .moveCursor(6) // position before "World"
+  .move(6) // position before "World"
   .delete(5, { by: "char", interval: 60 }) // remove "World"
   .type("TypewriterJS", { by: "char", interval: 80 });
 
@@ -82,35 +82,35 @@ await tw.play();
 ```ts
 tw.timeline
   .type("Hello", { cursor: ["a", "b"] })
-  .moveCursor(0, { cursor: "a" }) // move only cursor "a"
+  .move(0, { cursor: "a" }) // move only cursor "a"
   .type(">> ", { cursor: "a" }); // cursor "a" prepends
 
 await tw.play();
 ```
 
 ## Interaction with selections
 
-`.moveCursor()` always clears the selection of the targeted cursor. This is the standard way to deselect after a `.select()` command:
+`.move()` always clears the selection of the targeted cursor. This is the standard way to deselect after a `.select()` command:
 
 ```ts
 tw.timeline
   .type("Hello World")
-  .moveCursor(6)
+  .move(6)
   .select(5) // selects "World"
-  .mark("highlight", "selection") // style the selection
-  .moveCursor(11); // deselect — cursor goes to end
+  .style("highlight", "selection") // style the selection
+  .move(11); // deselect — cursor goes to end
 
 await tw.play();
 ```
 
 ## Clock behavior
 
-Because `.moveCursor()` does not advance the clock, any timed command that follows starts at the same timestamp as if the move were not there:
+Because `.move()` does not advance the clock, any timed command that follows starts at the same timestamp as if the move were not there:
 
 ```ts
 tw.timeline
   .type("Hello", { interval: 80 }) // ends at 5 × 80 = 400 ms
-  .moveCursor(0) // no clock change — still at 400 ms
+  .move(0) // no clock change — still at 400 ms
   .type(">> ", { interval: 80 }); // starts at 400 ms
 
 await tw.play();
@@ -123,12 +123,12 @@ await tw.play();
 - **`index < 0`** — clamped to `0`.
 - **`index > text.length`** — clamped to `text.length`.
 - **Calling on an empty document** — clamped to `0`; effectively a no-op.
-- **Consecutive `.moveCursor()` calls** — each fires at the same timestamp and replaces the previous cursor position; only the last one has an observable effect on subsequent commands.
+- **Consecutive `.move()` calls** — each fires at the same timestamp and replaces the previous cursor position; only the last one has an observable effect on subsequent commands.
 
 ## Type reference
 
-- [`TMoveCursorOptions`](/api/type-aliases/TMoveCursorOptions)
-- [`TMoveCursorCommand`](/api/type-aliases/TMoveCursorCommand)
+- [`TMoveOptions`](/api/type-aliases/TMoveOptions)
+- [`TMoveCommand`](/api/type-aliases/TMoveCommand)
 - [`TCursorSelector`](/api/type-aliases/TCursorSelector)
 - [`TCallbackHook`](/api/type-aliases/TCallbackHook)
 - [`TAudioCommandOverride`](/api/type-aliases/TAudioCommandOverride)

docs/guide/commands/select.md

@@ -34,7 +34,7 @@ type TSelectOptions = {
 - A negative `count` selects **backward** from the cursor's current position.
 - The selection is **relative** to the cursor — it extends `count` units in the chosen direction from wherever the cursor currently sits.
 - The selection is stored on the cursor state and consumed by the DOM renderer to render a visual highlight.
-- The selection is **cleared** by any subsequent `.type()`, `.delete()`, or `.moveCursor()` command targeting the same cursor.
+- The selection is **cleared** by any subsequent `.type()`, `.delete()`, or `.move()` command targeting the same cursor.
 - Selections do **not** prevent the cursor from continuing to type — they are metadata describing a range, not a lock.
 
 ## Advance modes (`by`)
@@ -55,7 +55,7 @@ A selection exists from the moment `.select()` fires until one of these clears i
 
 1. `.type()` targeting the same cursor
 2. `.delete()` targeting the same cursor
-3. `.moveCursor()` targeting the same cursor
+3. `.move()` targeting the same cursor
 4. Another `.select()` targeting the same cursor (replaces the previous selection)
 
 ## Examples
@@ -66,7 +66,7 @@ A selection exists from the moment `.select()` fires until one of these clears i
 tw.timeline
   .type("Hello World", { by: "char", interval: 80 })
   .wait(600)
-  .moveCursor(6)
+  .move(6)
   .select(5); // selects "World"
 
 await tw.play();
@@ -85,15 +85,15 @@ await tw.play();
 // "World" appears highlighted
 ```
 
-### Select then apply a mark
+### Select then apply a style
 
 ```ts
 tw.timeline
   .type("Hello World", { by: "char", interval: 80 })
-  .moveCursor(6)
+  .move(6)
   .select(5) // selects "World"
-  .mark("highlight", "selection") // applies style to selection range
-  .moveCursor(11); // clear selection, move to end
+  .style("highlight", "selection") // applies style to selection range
+  .move(11); // clear selection, move to end
 
 await tw.play();
 // "World" permanently carries the "highlight" class
@@ -105,7 +105,7 @@ await tw.play();
 tw.timeline
   .type("one two three", { by: "word", interval: 150 })
   .wait(400)
-  .moveCursor(4)
+  .move(4)
   .select(2, { by: "word" }); // selects "two three"
 
 await tw.play();
@@ -116,7 +116,7 @@ await tw.play();
 ```ts
 tw.timeline
   .type("Hello World", { by: "char", interval: 80 })
-  .moveCursor(6)
+  .move(6)
   .select(5) // selects "World"
   .type("TypewriterJS"); // replaces selection
 
@@ -129,7 +129,7 @@ await tw.play();
 ```ts
 tw.timeline
   .type("Hello World", { by: "char", interval: 80 })
-  .moveCursor(6)
+  .move(6)
   .select(5) // selects "World"
   .delete(1); // deletes the selection in one step
 
@@ -145,7 +145,7 @@ Use the `cursor` option to create selections on specific cursors:
 tw.timeline
   .type("ABCDE", { cursor: ["a", "b"] })
   .select(3, { cursor: "a" }) // only cursor "a" creates a selection
-  .mark("highlight", "selection", { cursor: "a" });
+  .style("highlight", "selection", { cursor: "a" });
 
 await tw.play();
 // "CDE" is highlighted (cursor "a" was at position 2 after typing 5 chars,