@workos/quickstudy 0.2.1 → 0.3.0

package/README.md

@@ -231,6 +231,27 @@ quickstudy export <run-id> --out ./site
 npx gh-pages -d site        # or push ./site to any static host
 ```
 
+### Embedding the viewers
+
+A host that renders exported bundles in its own UI can use this UI's transcript and
+diff viewers directly instead of copying them:
+
+```tsx
+import { DiffViewer, TranscriptViewer } from "@workos/quickstudy/ui/viewers";
+import "@workos/quickstudy/ui/viewers.css";
+
+// Fetch data/runs/<run>/attempts/<id>.transcript.txt yourself (the bundle lazy-loads it
+// the same way), then render it; `lines` highlights and scrolls to a cited range.
+<div className="my-theme"><TranscriptViewer text={text} lines={[21, 60]} /></div>
+```
+
+The components import React only (an optional peer dependency). Every rule in
+`viewers.css` is scoped under the components' root class `.quickstudy-viewer`, so importing
+it restyles nothing else in the host. It reads the theme through custom properties the host sets on a wrapping element: `--surface`, `--bg`,
+`--line`, `--muted`, `--accent`, `--green`, `--amber`, `--amber-bg`, `--green-bg`,
+`--red-bg`, `--gray-bg` and `--mono`. Turn parsing, roles, collapsing and the `L<n>`
+anchors are exactly what this UI shows, so evidence links carry over unchanged.
+
 ## Development
 
 Run the CLI from source as `bun src/cli.ts <cmd>` (what `quickstudy` is,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workos/quickstudy",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "An open-source, company-agnostic eval harness for measuring whether coding agents can complete real integration tasks, across an agent x feature x framework x surface matrix.",
   "license": "MIT",
   "type": "module",
@@ -9,7 +9,9 @@
   },
   "exports": {
     ".": "./src/index.ts",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./ui/viewers": "./ui/src/viewers.ts",
+    "./ui/viewers.css": "./ui/src/components/viewers.css"
   },
   "files": [
     "src",
@@ -17,7 +19,11 @@
     "images",
     "examples",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "ui/src/viewers.ts",
+    "ui/src/components/TranscriptViewer.tsx",
+    "ui/src/components/DiffViewer.tsx",
+    "ui/src/components/viewers.css"
   ],
   "engines": {
     "bun": ">=1.1"
@@ -49,5 +55,13 @@
     "react-dom": "^19.3.0",
     "typescript": "^7.0.2",
     "vite": "^8.3.0"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
   }
 }

package/src/build-info.generated.ts

@@ -9,7 +9,7 @@ export const EMBEDDED_BUILD_INFO: {
   // (the `x-release-please-version` marker anchors the replacement). It is
   // restored as-is after a binary build (scripts/build-binary.ts), so the
   // committed source `--version` stays in lockstep with package.json.
-  version: "0.2.1", // x-release-please-version
+  version: "0.3.0", // x-release-please-version
   revision: null,
   dirty: null,
   sourceHash: null,