docs: rewrite README with why section, updated quick start, and docs links

Author: eoussama

README.md

@@ -3,7 +3,7 @@
       <img src="https://raw.githubusercontent.com/eoussama/eo-typewriterjs/refs/heads/master/assets/logo.svg" alt="Logo" width="200px">
       <h1 align="center">eo-typewriterjs</h1>
     </a>
-    <p align="center">Advanced typewriter-style text animation utility for JavaScript, with timeline playback, cursor movement, selection, deletion, and renderer-agnostic text styling.</p>
+    <p align="center">Build rich typewriter animations with a composable timeline, full Unicode support, and a renderer-agnostic architecture that works in the browser and on the server.</p>
     <p align="center">
         <img src="https://img.shields.io/github/release/EOussama/typewriterjs.svg">
         <img src="https://img.shields.io/github/downloads/EOussama/typewriterjs/latest/total.svg">
@@ -20,53 +20,73 @@
 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
+
 ## Quick start
 
 ```ts
 import { createTypewriter, domRenderer } from "eo-typewriterjs";
 
 
 
-const element = document.getElementById("output");
+const el = document.getElementById("output")!;
 
-if (element === null) {
-  throw new Error("Missing #output element");
-}
-
-const typewriter = createTypewriter({
-  renderer: domRenderer(element),
+const tw = createTypewriter({
+  renderer: domRenderer(el),
 });
 
-typewriter.timeline
-  .type("Hello ")
-  .type("world!", { style: "accent" })
-  .mark("highlight", { from: 6, to: 12 });
+tw.timeline
+  .type("Hello, ")
+  .type("world!", { by: "word", interval: 120 })
+  .wait(400)
+  .delete({ amount: 6 })
+  .type("eo-typewriterjs.", { interval: 80 });
 
-await typewriter.play();
+await tw.play();
 ```
 
-## Common commands
+## Documentation
 
-```bash
-pnpm dev
-pnpm build
-pnpm test
-pnpm lint
-pnpm sandbox
-pnpm docs:dev
-pnpm docs:build
-```
+Full documentation, guides, and the API reference are available on the docs site.
 
-## Documentation
+- [Docs site](https://ouss.es/eo-typewriterjs/)
+- [Getting started](https://ouss.es/eo-typewriterjs/guide/getting-started)
+- [Core concepts](https://ouss.es/eo-typewriterjs/guide/core-concepts)
+- [Timeline](https://ouss.es/eo-typewriterjs/guide/timeline)
+- [Renderers](https://ouss.es/eo-typewriterjs/guide/renderers)
+- [Recipes](https://ouss.es/eo-typewriterjs/guide/recipes)
+- [API reference](https://ouss.es/eo-typewriterjs/api/)
 
-Full documentation is available at the [docs site](https://eoussama.github.io/eo-typewriterjs/).
+## Sandbox
 
-- [Getting Started](https://eoussama.github.io/eo-typewriterjs/guide/getting-started)
-- [Core Concepts](https://eoussama.github.io/eo-typewriterjs/guide/core-concepts)
-- [Timeline & Commands](https://eoussama.github.io/eo-typewriterjs/guide/timeline)
-- [Renderers](https://eoussama.github.io/eo-typewriterjs/guide/renderers)
-- [Recipes](https://eoussama.github.io/eo-typewriterjs/guide/recipes)
-- [API Reference](https://eoussama.github.io/eo-typewriterjs/api/)
+Try the library live in the interactive [sandbox](https://ouss.es/eo-typewriterjs/sandbox/), write timelines, run them, and see output in real time without any setup.
+
+## Testing
+
+The library is covered by two test layers:
+
+- **Unit tests** (`pnpm test`): Vitest suite covering core logic, reducers, renderers, and edge cases.
+- **End-to-end tests** (`pnpm e2e`): Playwright suite running real playback scenarios in a browser harness, including typing flows, waiting, multiline output, cursor movement, selection, editing, and callbacks.
+
+## Development
+
+```bash
+pnpm dev           # start dev server
+pnpm build         # build the library
+pnpm test          # run unit tests
+pnpm e2e           # run end-to-end tests
+pnpm lint          # lint
+pnpm sandbox       # start the sandbox
+pnpm docs:dev      # start the docs site
+```
 
 ## License