demowalk 1.0.0 → 1.0.2

package/README.md

@@ -63,7 +63,7 @@ The engine, starter templates and setup CLI live in this package; journeys
 
 | Required | Why |
 |---|---|
-| Node 18+ and `tsx` | runs the pipeline |
+| Node 18+ | runs the pipeline (demowalk ships its own `tsx` runner) |
 | `@playwright/test` + Chromium | the capture engine (peer dependency) |
 | ffmpeg on the machine | narration conversion + stitching |
 | **macOS** (for now) | narration uses the built-in `say`; download a natural voice once via System Settings → Accessibility → Spoken Content → Manage Voices (e.g. "Tom (Enhanced)") |
@@ -76,15 +76,12 @@ journeys easier to author or redaction richer when present.
 ## Quick start
 
 ```bash
-# 0. ffmpeg (once per machine — check first: `ffmpeg -version`).
-#    The 2-minute static build beats compiling via brew:
-curl -L "https://evermeet.cx/ffmpeg/getrelease/ffmpeg/zip" -o /tmp/ffmpeg.zip \
-  && unzip -o /tmp/ffmpeg.zip -d /tmp \
-  && sudo mv /tmp/ffmpeg /usr/local/bin/ffmpeg \
-  && sudo xattr -d com.apple.quarantine /usr/local/bin/ffmpeg 2>/dev/null; ffmpeg -version
+# 0. ffmpeg (once per machine — check first: `ffmpeg -version`):
+brew install ffmpeg
+#    (no Homebrew, or brew starts compiling from source? see
+#     "ffmpeg without Homebrew" at the end of this README)
 
 # 1. in your app's repo:
-npm install --save-dev tsx
 npm install --save-dev demowalk
 #    (straight from GitHub instead: npm i -D demowalk@github:360solutions-dev/demowalk
 #     from a local clone: npm i -D --install-links file:../demowalk
@@ -195,6 +192,22 @@ The full frame-styling contract lives in
 In a host repo: `npm run demo:update` (set up by `demowalk-init`). Journeys
 and config stay untouched; only the engine updates.
 
+## ffmpeg without Homebrew
+
+If you don't use Homebrew — or `brew install ffmpeg` starts compiling from
+source (it does on machines with outdated Command Line Tools) — the static
+build installs in about two minutes:
+
+```bash
+curl -L "https://evermeet.cx/ffmpeg/getrelease/ffmpeg/zip" -o /tmp/ffmpeg.zip \
+  && unzip -o /tmp/ffmpeg.zip -d /tmp \
+  && sudo mv /tmp/ffmpeg /usr/local/bin/ffmpeg \
+  && sudo xattr -d com.apple.quarantine /usr/local/bin/ffmpeg 2>/dev/null; ffmpeg -version
+```
+
+(The `xattr` line clears macOS's quarantine flag on the downloaded binary so
+it can run.)
+
 ## Contributing
 
 PRs welcome — see [CONTRIBUTING.md](./CONTRIBUTING.md) for setup, code

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "demowalk",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Self-regenerating product demo videos: Playwright walks your live app, every frame is branded and redacted, narration is voiced, ffmpeg stitches the MP4. One command, always up to date.",
   "keywords": [
     "demo",
@@ -49,7 +49,8 @@
     "@playwright/test": ">=1.40.0"
   },
   "dependencies": {
-    "sharp": "^0.35.5"
+    "sharp": "^0.35.5",
+    "tsx": "^4.19.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.49.0",

package/scripts/init.mjs

@@ -39,8 +39,9 @@ pkg.scripts["demo:update"] = spec.startsWith("file:")
 fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
 console.log("✓ scripts: demo:video, demo:update");
 
-if (!pkg.devDependencies?.tsx && !pkg.dependencies?.tsx) {
-  console.log("⚠ tsx is not installed — run: npm install --save-dev tsx");
+// tsx ships as a demowalk dependency, so its bin is normally already linked.
+if (!fs.existsSync(path.join(hostRoot, "node_modules", ".bin", "tsx"))) {
+  console.log("⚠ tsx bin not found — run `npm install` (it comes with demowalk)");
 }
 
 // 1.5 AUTO-WIRE demo.config.ts when the host follows the common e2e