@classytic/labs 0.1.0

package/package.json

@@ -0,0 +1,266 @@
+{
+  "name": "@classytic/labs",
+  "version": "0.1.0",
+  "description": "Interactive learning lab — authorable, domain-organized interactive lessons (math, physics, chemistry, circuits, geometry…) built on the @classytic/stage engine. Per-domain subpaths; lesson blocks + presets creators compose and sell.",
+  "author": "Classytic",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.mts",
+      "default": "./dist/core/index.mjs"
+    },
+    "./physics": {
+      "types": "./dist/physics/index.d.mts",
+      "default": "./dist/physics/index.mjs"
+    },
+    "./math": {
+      "types": "./dist/math/index.d.mts",
+      "default": "./dist/math/index.mjs"
+    },
+    "./chem": {
+      "types": "./dist/chem/index.d.mts",
+      "default": "./dist/chem/index.mjs"
+    },
+    "./circuits": {
+      "types": "./dist/circuits/index.d.mts",
+      "default": "./dist/circuits/index.mjs"
+    },
+    "./geometry": {
+      "types": "./dist/geometry/index.d.mts",
+      "default": "./dist/geometry/index.mjs"
+    },
+    "./language": {
+      "types": "./dist/language/index.d.mts",
+      "default": "./dist/language/index.mjs"
+    },
+    "./ict": {
+      "types": "./dist/ict/index.d.mts",
+      "default": "./dist/ict/index.mjs"
+    },
+    "./commerce": {
+      "types": "./dist/commerce/index.d.mts",
+      "default": "./dist/commerce/index.mjs"
+    },
+    "./biology": {
+      "types": "./dist/biology/index.d.mts",
+      "default": "./dist/biology/index.mjs"
+    },
+    "./geography": {
+      "types": "./dist/geography/index.d.mts",
+      "default": "./dist/geography/index.mjs"
+    },
+    "./discrete": {
+      "types": "./dist/discrete/index.d.mts",
+      "default": "./dist/discrete/index.mjs"
+    },
+    "./statistics": {
+      "types": "./dist/statistics/index.d.mts",
+      "default": "./dist/statistics/index.mjs"
+    },
+    "./ml": {
+      "types": "./dist/ml/index.d.mts",
+      "default": "./dist/ml/index.mjs"
+    },
+    "./catalog": {
+      "types": "./dist/catalog/index.d.mts",
+      "default": "./dist/catalog/index.mjs"
+    },
+    "./kit": {
+      "types": "./dist/kit/index.d.mts",
+      "default": "./dist/kit/index.mjs"
+    },
+    "./blocks": {
+      "types": "./dist/blocks/index.d.mts",
+      "default": "./dist/blocks/index.mjs"
+    },
+    "./blocks/lesson": {
+      "types": "./dist/blocks/lesson.d.mts",
+      "default": "./dist/blocks/lesson.mjs"
+    },
+    "./blocks/math": {
+      "types": "./dist/blocks/math.d.mts",
+      "default": "./dist/blocks/math.mjs"
+    },
+    "./blocks/physics": {
+      "types": "./dist/blocks/physics.d.mts",
+      "default": "./dist/blocks/physics.mjs"
+    },
+    "./blocks/chem": {
+      "types": "./dist/blocks/chem.d.mts",
+      "default": "./dist/blocks/chem.mjs"
+    },
+    "./blocks/circuits": {
+      "types": "./dist/blocks/circuits.d.mts",
+      "default": "./dist/blocks/circuits.mjs"
+    },
+    "./blocks/geometry": {
+      "types": "./dist/blocks/geometry.d.mts",
+      "default": "./dist/blocks/geometry.mjs"
+    },
+    "./blocks/ict": {
+      "types": "./dist/blocks/ict.d.mts",
+      "default": "./dist/blocks/ict.mjs"
+    },
+    "./blocks/language": {
+      "types": "./dist/blocks/language.d.mts",
+      "default": "./dist/blocks/language.mjs"
+    },
+    "./blocks/accounting": {
+      "types": "./dist/blocks/accounting.d.mts",
+      "default": "./dist/blocks/accounting.mjs"
+    },
+    "./blocks/economics": {
+      "types": "./dist/blocks/economics.d.mts",
+      "default": "./dist/blocks/economics.mjs"
+    },
+    "./blocks/biology": {
+      "types": "./dist/blocks/biology.d.mts",
+      "default": "./dist/blocks/biology.mjs"
+    },
+    "./blocks/geography": {
+      "types": "./dist/blocks/geography.d.mts",
+      "default": "./dist/blocks/geography.mjs"
+    },
+    "./blocks/ml": {
+      "types": "./dist/blocks/ml.d.mts",
+      "default": "./dist/blocks/ml.mjs"
+    },
+    "./blocks/discrete": {
+      "types": "./dist/blocks/discrete.d.mts",
+      "default": "./dist/blocks/discrete.mjs"
+    },
+    "./blocks/statistics": {
+      "types": "./dist/blocks/statistics.d.mts",
+      "default": "./dist/blocks/statistics.mjs"
+    },
+    "./schemas": {
+      "types": "./dist/schemas/index.d.mts",
+      "default": "./dist/schemas/index.mjs"
+    },
+    "./styles.css": "./styles.css",
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist",
+    "styles.css",
+    "LICENSE",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/classytic/labs.git"
+  },
+  "homepage": "https://github.com/classytic/labs#readme",
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit",
+    "test:unit": "vitest run tests/core.test.ts tests/catalog.test.ts tests/stage-templates.test.ts",
+    "test:package": "vitest run tests/widgets.test.tsx",
+    "pretest": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "gallery": "npm run build && node tests/gallery/rasterize.mjs",
+    "gallery:svg": "vitest run tests/gallery.test.tsx",
+    "lint": "tsc --noEmit",
+    "verify": "npm run typecheck && npm test",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "release": "npm run build && changeset publish",
+    "push": "classytic-push",
+    "prepublishOnly": "npm run typecheck && npm run build && npm test"
+  },
+  "peerDependencies": {
+    "@classytic/cms": ">=0.2.1",
+    "@classytic/cms-ui": ">=0.3.1",
+    "@classytic/stage": ">=0.1.0",
+    "clsx": ">=2",
+    "katex": ">=0.16",
+    "lucide-react": ">=0.4",
+    "react": ">=19",
+    "react-dom": ">=19",
+    "tailwind-merge": ">=3",
+    "zod": ">=4"
+  },
+  "peerDependenciesMeta": {
+    "lucide-react": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    },
+    "katex": {
+      "optional": true
+    },
+    "@classytic/cms-ui": {
+      "optional": true
+    },
+    "@classytic/cms": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.27.9",
+    "@classytic/cms-ui": "^0.3.1",
+    "@classytic/dev-tools": "^0.2.0",
+    "@classytic/stage": "^0.1.0",
+    "@testing-library/react": "^16.3.2",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "clsx": "^2.1.1",
+    "happy-dom": "^20.0.0",
+    "lucide-react": "^0.563.0",
+    "mafs": "^0.21.0",
+    "playwright": "^1.61.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "tailwind-merge": "^3.5.0",
+    "tsdown": "^0.22.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.0",
+    "zod": "^4.1.0"
+  },
+  "keywords": [
+    "react",
+    "visualization",
+    "interactive",
+    "education",
+    "learning",
+    "math",
+    "calculus",
+    "derivative",
+    "integral",
+    "limit",
+    "gradient-descent",
+    "physics",
+    "chemistry",
+    "equation",
+    "graph",
+    "plot",
+    "symbolic-math",
+    "katex",
+    "canvas",
+    "manim",
+    "desmos",
+    "science"
+  ]
+}

package/styles.css

@@ -0,0 +1,267 @@
+/**
+ * @classytic/labs — theme tokens + control-UI kit CSS.
+ *
+ * Import once in your app's global CSS (after `@import "tailwindcss";`):
+ *   @import "@classytic/labs/styles.css";
+ *
+ * Ships NO precompiled utility CSS — `@source` lets YOUR build scan the package
+ * for Tailwind classes. The `:root` tokens are overridable defaults. The
+ * `.lab-*` control kit consumes the HOST's shadcn tokens (--foreground/--border/
+ * --primary/--muted/--success…) with literal fallbacks, so it adopts your theme
+ * + dark mode automatically — override those in your own globals.css.
+ */
+
+@source "./dist/**/*.mjs";
+
+:root {
+  /* Legacy canvas compatibility tokens (used by widgets not yet migrated to stage). */
+  --sciviz-stage: oklch(0.16 0.02 255);
+  --sciviz-grid: oklch(0.55 0.02 255 / 0.5);
+  --sciviz-axis: oklch(0.7 0.02 255);
+  --sciviz-accent: oklch(0.72 0.15 250);
+  --sciviz-accent-2: oklch(0.78 0.16 50);
+  --sciviz-good: oklch(0.72 0.17 150);
+  /* Previously referenced in code with only inline fallbacks — define them so
+     legacy widgets theme correctly until migrated to stage. DEPRECATED. */
+  --sciviz-text: oklch(0.92 0.01 255);
+  --sciviz-text-dim: oklch(0.7 0.02 255);
+  --sciviz-warn: oklch(0.82 0.16 85);
+}
+
+/* ── Control-UI kit ─────────────────────────────────────────────────────────
+   Shipped (not runtime-injected). Consumes host shadcn tokens; fallbacks keep
+   it usable standalone. Override via your globals.css like any shadcn component. */
+.lab-bar { display: flex; align-items: center; gap: 13px; flex-wrap: wrap; padding: 12px 2px 2px; font-size: 14px; color: var(--foreground, currentColor); }
+.lab-bar .sep { opacity: .6; }
+.lab-stepper { display: inline-flex; align-items: center; border: 1.5px solid var(--border, color-mix(in oklab, currentColor 28%, transparent)); border-radius: 11px; overflow: hidden; background: var(--muted, color-mix(in oklab, currentColor 6%, transparent)); }
+.lab-stepper button { width: 32px; height: 32px; border: 0; background: transparent; color: inherit; font-size: 18px; font-weight: 700; line-height: 1; cursor: pointer; transition: background .12s; display: flex; align-items: center; justify-content: center; }
+.lab-stepper button:hover { background: color-mix(in oklab, var(--primary, oklch(0.59 0.22 261)) 18%, transparent); }
+.lab-stepper button:active { background: color-mix(in oklab, var(--primary, oklch(0.59 0.22 261)) 32%, transparent); }
+.lab-stepper b { min-width: 30px; text-align: center; font-size: 16px; font-weight: 800; padding: 0 4px; font-variant-numeric: tabular-nums; }
+.lab-btn { padding: 9px 22px; border-radius: 999px; border: 0; background: var(--primary, oklch(0.59 0.22 261)); color: var(--primary-foreground, #fff); font-weight: 700; font-size: 14px; cursor: pointer; transition: transform .1s, filter .12s; }
+.lab-btn:hover:not(:disabled) { filter: brightness(1.07); }
+.lab-btn:active:not(:disabled) { transform: translateY(1px); }
+.lab-btn:disabled { opacity: .45; cursor: not-allowed; }
+.lab-pill { font-weight: 700; padding: 5px 13px; border-radius: 999px; font-size: 13px; }
+.lab-pill[data-state="ok"] { color: var(--success, oklch(0.62 0.17 150)); background: color-mix(in oklab, var(--success, oklch(0.62 0.17 150)) 15%, transparent); }
+.lab-pill[data-state="no"] { color: var(--muted-foreground, color-mix(in oklab, currentColor 60%, transparent)); background: var(--muted, color-mix(in oklab, currentColor 8%, transparent)); }
+.lab-chip { padding: 10px 14px; border-radius: 10px; border: 1.5px solid var(--border, color-mix(in oklab, currentColor 28%, transparent)); background: transparent; color: inherit; font-size: 14px; font-weight: 600; cursor: pointer; transition: background .12s, border-color .12s; }
+.lab-chip:hover { border-color: var(--primary, oklch(0.59 0.22 261)); }
+.lab-chip[data-sel="true"] { border-color: var(--primary, oklch(0.59 0.22 261)); background: color-mix(in oklab, var(--primary, oklch(0.59 0.22 261)) 14%, transparent); }
+.lab-slider { -webkit-appearance: none; appearance: none; height: 6px; border-radius: 999px; background: var(--muted, color-mix(in oklab, currentColor 18%, transparent)); outline: none; cursor: pointer; }
+.lab-slider::-webkit-slider-thumb { -webkit-appearance: none; width: 18px; height: 18px; border-radius: 50%; background: var(--primary, oklch(0.59 0.22 261)); border: 2px solid var(--background, #fff); box-shadow: 0 1px 3px rgba(0, 0, 0, .3); cursor: pointer; }
+.lab-slider::-moz-range-thumb { width: 18px; height: 18px; border-radius: 50%; background: var(--primary, oklch(0.59 0.22 261)); border: 2px solid var(--background, #fff); cursor: pointer; }
+.lab-slider:focus-visible { outline: 2px solid var(--primary, oklch(0.59 0.22 261)); outline-offset: 3px; }
+
+/* ── pedagogy kit (objectives / hints / misconception) ──────────────────────── */
+.lab-objectives { margin: 0 0 12px; padding: 8px 12px; border-radius: 10px; border: 1px solid var(--border, color-mix(in oklab, currentColor 18%, transparent)); background: color-mix(in oklab, var(--primary, oklch(0.59 0.22 261)) 6%, transparent); }
+.lab-objectives-h { font-size: 11px; font-weight: 700; letter-spacing: .04em; text-transform: uppercase; color: var(--muted-foreground, color-mix(in oklab, currentColor 60%, transparent)); }
+.lab-objectives ul { margin: 4px 0 0; padding-left: 18px; }
+.lab-objectives li { font-size: 13.5px; color: var(--foreground, currentColor); margin: 1px 0; }
+.lab-hints { margin-top: 12px; display: flex; flex-direction: column; gap: 6px; align-items: flex-start; }
+.lab-hint { margin: 0; font-size: 13.5px; color: var(--foreground, currentColor); padding: 7px 11px; border-radius: 9px; background: color-mix(in oklab, var(--warning, oklch(0.8 0.16 85)) 16%, transparent); max-width: 60ch; }
+.lab-hint-btn { align-self: flex-start; padding: 6px 14px; border-radius: 999px; border: 1.5px dashed var(--border, color-mix(in oklab, currentColor 30%, transparent)); background: transparent; color: var(--muted-foreground, color-mix(in oklab, currentColor 60%, transparent)); font-size: 13px; font-weight: 600; cursor: pointer; transition: border-color .12s, color .12s; }
+.lab-hint-btn:hover { border-color: var(--primary, oklch(0.59 0.22 261)); color: var(--foreground, currentColor); }
+.lab-misconception { font-size: 13.5px; font-weight: 600; padding: 5px 12px; border-radius: 999px; color: var(--warning-foreground, oklch(0.45 0.13 75)); background: color-mix(in oklab, var(--warning, oklch(0.8 0.16 85)) 22%, transparent); }
+
+/* shared "Show answer" escape hatch (kit/pedagogy RevealSolution) */
+.lab-reveal-btn { align-self: flex-start; padding: 5px 12px; border-radius: 999px; border: 1.5px dashed var(--border, color-mix(in oklab, currentColor 30%, transparent)); background: transparent; color: var(--muted-foreground, color-mix(in oklab, currentColor 60%, transparent)); font-size: 12.5px; font-weight: 600; cursor: pointer; transition: border-color .12s, color .12s; }
+.lab-reveal-btn:hover { border-color: var(--warning, oklch(0.8 0.16 85)); color: var(--foreground, currentColor); }
+.lab-solution { margin-top: 8px; max-width: 64ch; padding: 8px 12px; border-radius: 10px; border: 1px solid color-mix(in oklab, var(--warning, oklch(0.8 0.16 85)) 45%, transparent); background: color-mix(in oklab, var(--warning, oklch(0.8 0.16 85)) 12%, transparent); }
+.lab-solution-h { display: flex; align-items: center; gap: 6px; font-size: 11px; font-weight: 800; letter-spacing: .04em; text-transform: uppercase; color: var(--warning-foreground, oklch(0.45 0.13 75)); }
+.lab-solution-body { margin-top: 4px; font-size: 14px; font-weight: 600; color: var(--foreground, currentColor); }
+.lab-solution-note { margin: 4px 0 0; font-size: 11px; opacity: .7; }
+
+/* ── Challenge: the shared predict / classify / explain activity (kit/pedagogy) ── */
+.lab-challenge { display: flex; flex-direction: column; gap: 12px; max-width: 64ch; padding: 12px 14px; border-radius: 12px; border: 1px solid var(--border, color-mix(in oklab, currentColor 14%, transparent)); background: color-mix(in oklab, var(--primary, oklch(0.59 0.22 261)) 5%, transparent); }
+.lab-challenge-h { font-size: 11px; font-weight: 800; letter-spacing: .05em; text-transform: uppercase; color: var(--muted-foreground, color-mix(in oklab, currentColor 60%, transparent)); }
+.lab-challenge-count { font-variant-numeric: tabular-nums; }
+.lab-challenge-q { display: flex; flex-direction: column; gap: 7px; align-items: flex-start; }
+.lab-challenge-prompt { font-size: 14px; font-weight: 600; color: var(--foreground, currentColor); }
+.lab-choices { display: flex; flex-wrap: wrap; gap: 8px; }
+.lab-choice { padding: 7px 14px; border-radius: 999px; border: 1.5px solid var(--border, color-mix(in oklab, currentColor 22%, transparent)); background: var(--card, transparent); color: var(--foreground, currentColor); font-size: 13.5px; font-weight: 600; cursor: pointer; transition: border-color .12s, background .12s, color .12s; }
+.lab-choice:hover { border-color: var(--primary, oklch(0.59 0.22 261)); }
+.lab-choice[data-picked] { border-color: var(--primary, oklch(0.59 0.22 261)); background: color-mix(in oklab, var(--primary, oklch(0.59 0.22 261)) 12%, transparent); }
+.lab-choice[data-tone="correct"] { border-color: var(--success, oklch(0.62 0.17 150)); background: color-mix(in oklab, var(--success, oklch(0.62 0.17 150)) 16%, transparent); color: var(--success, oklch(0.62 0.17 150)); }
+.lab-choice[data-tone="wrong"] { border-color: var(--destructive, oklch(0.58 0.22 27)); background: color-mix(in oklab, var(--destructive, oklch(0.58 0.22 27)) 14%, transparent); color: var(--destructive, oklch(0.58 0.22 27)); }
+
+/* AskBox — typed-answer + Check (engine + representation plug-ins) */
+.lab-ask-row { display: flex; flex-wrap: wrap; gap: 8px; align-items: center; }
+.lab-input { padding: 7px 11px; border-radius: 9px; border: 1.5px solid var(--border, color-mix(in oklab, currentColor 22%, transparent)); background: var(--card, transparent); color: var(--foreground, currentColor); font-size: 14px; min-width: 140px; font-variant-numeric: tabular-nums; }
+.lab-input:focus { outline: none; border-color: var(--primary, oklch(0.59 0.22 261)); }
+
+/* ── Lab frame — the shared layout shell every lab composes into ──────────────
+   ONE consistent grid: header (title + one-line prompt) → figure-dominant body
+   (+ optional narrow aside) → a single controls bar → a quiet footer. Replaces
+   the per-lab inline-styled layouts that made labs look like different products.
+   All spacing/type/colour from tokens; objectives collapse (reveal-on-action). */
+.lab-frame { display: flex; flex-direction: column; gap: 16px; color: var(--foreground, currentColor); }
+.lab-frame-head { display: flex; flex-direction: column; gap: 3px; }
+.lab-title { margin: 0; font-size: 18px; font-weight: 750; letter-spacing: -0.01em; color: var(--foreground, currentColor); }
+.lab-prompt { margin: 0; font-size: 14px; line-height: 1.45; color: var(--muted-foreground, color-mix(in oklab, currentColor 58%, transparent)); }
+.lab-body { display: grid; grid-template-columns: minmax(0, 1fr); gap: 20px; align-items: start; }
+.lab-body[data-aside="true"] { grid-template-columns: minmax(0, 1.25fr) minmax(220px, 0.75fr); }
+@media (max-width: 680px) { .lab-body[data-aside="true"] { grid-template-columns: minmax(0, 1fr); } }
+.lab-figure { min-width: 0; }
+.lab-aside { display: flex; flex-direction: column; gap: 12px; min-width: 0; }
+/* one tidy responsive grid — fields align in columns instead of ragged wrapping */
+.lab-controls { display: grid; grid-template-columns: repeat(auto-fit, minmax(185px, 1fr)); gap: 14px 20px; align-items: end; padding: 14px 16px; border-radius: 14px; border: 1px solid var(--border, color-mix(in oklab, currentColor 12%, transparent)); background: var(--muted, color-mix(in oklab, currentColor 4%, transparent)); }
+/* actions/status (anything that isn't a labelled Field) sit left in their cell, never stretched,
+   and align to the SAME bottom baseline as the labelled fields so a mixed control bar reads as one row */
+.lab-controls > :not(.lab-field) { justify-self: start; align-self: end; }
+/* a Field's inline chip-group row wraps inside its cell instead of overflowing onto the next control */
+.lab-field-row { flex-wrap: wrap; }
+.lab-foot { display: flex; flex-direction: column; gap: 8px; align-items: flex-start; }
+
+/* a labelled control: small caps label, then control + value on one row, filling its cell */
+.lab-field { display: flex; flex-direction: column; gap: 5px; min-width: 0; }
+.lab-field-label { font-size: 11px; font-weight: 700; letter-spacing: .03em; text-transform: uppercase; color: var(--muted-foreground, color-mix(in oklab, currentColor 55%, transparent)); }
+.lab-field-row { display: inline-flex; align-items: center; gap: 9px; }
+/* inside a Field the row fills the cell so the slider can grow and the value pins right */
+.lab-field > .lab-field-row { display: flex; width: 100%; }
+.lab-field-val { font-size: 14px; font-weight: 800; font-variant-numeric: tabular-nums; min-width: 3.4em; text-align: right; }
+.lab-field > .lab-field-row > .lab-field-val { margin-left: auto; }
+.lab-field .lab-slider { flex: 1 1 auto; width: auto; min-width: 60px; }
+/* creator-locked control: visible but frozen (the interactive subtree is `inert`) */
+.lab-locked-wrap { display: contents; }
+.lab-field[data-locked="true"] .lab-field-row { opacity: .62; }
+.lab-field-lock { display: inline-block; width: .82em; height: .82em; margin-left: .3em; vertical-align: -.05em; opacity: .7; }
+
+/* highlighted readout — replaces ad-hoc inline-styled boxes */
+.lab-callout { padding: 10px 14px; border-radius: 12px; font-size: 14px; line-height: 1.55; border: 1px solid var(--border, color-mix(in oklab, currentColor 12%, transparent)); background: color-mix(in oklab, var(--primary, oklch(0.59 0.22 261)) 6%, transparent); }
+.lab-callout[data-tone="result"] { border-color: color-mix(in oklab, var(--success, oklch(0.62 0.17 150)) 38%, transparent); background: color-mix(in oklab, var(--success, oklch(0.62 0.17 150)) 10%, transparent); }
+.lab-callout-big { display: block; margin-top: 2px; font-size: 22px; font-weight: 800; font-variant-numeric: tabular-nums; color: var(--success, oklch(0.62 0.17 150)); }
+
+/* goals — a collapsed disclosure, NOT an upfront wall of text */
+.lab-goals { font-size: 13px; }
+.lab-goals > summary { cursor: pointer; font-size: 11px; font-weight: 700; letter-spacing: .04em; text-transform: uppercase; color: var(--muted-foreground, color-mix(in oklab, currentColor 52%, transparent)); list-style: none; user-select: none; }
+.lab-goals > summary::-webkit-details-marker { display: none; }
+.lab-goals > summary::before { content: "▸ "; }
+.lab-goals[open] > summary::before { content: "▾ "; }
+.lab-goals ul { margin: 6px 0 0; padding-left: 18px; }
+.lab-goals li { margin: 2px 0; color: var(--foreground, currentColor); }
+
+/* ── Play-gate for hand-driven sim labs (press-to-start + off-screen pause) ──── */
+.lab-playwrap { position: relative; }
+/* one small play/pause toggle, top-right — never covers the figure */
+.lab-play-toggle { position: absolute; top: 10px; right: 10px; z-index: 2; display: inline-flex; align-items: center; gap: 6px; min-width: 34px; height: 32px; padding: 0 12px; border-radius: 999px; border: 1px solid var(--border, color-mix(in oklab, currentColor 22%, transparent)); background: color-mix(in oklab, var(--background, #fff) 88%, transparent); color: var(--foreground, currentColor); cursor: pointer; font-size: 13px; font-weight: 700; box-shadow: 0 1px 4px rgba(0, 0, 0, .14); transition: filter .12s, transform .1s; }
+.lab-play-toggle:hover { filter: brightness(1.05); }
+.lab-play-toggle:active { transform: translateY(1px); }
+.lab-play-toggle[data-playing="false"] { background: var(--primary, oklch(0.59 0.22 261)); color: #fff; border-color: transparent; }
+
+/* ── In-lab stepper (teach one idea at a time) ──────────────────────────────── */
+.lab-step-caption { margin: 0 0 14px; font-size: 17px; line-height: 1.5; font-weight: 600; color: var(--foreground, currentColor); max-width: 62ch; }
+.lab-stepnav { display: flex; align-items: center; gap: 14px; }
+.lab-btn-ghost { background: transparent; color: var(--foreground, currentColor); border: 1.5px solid var(--border, color-mix(in oklab, currentColor 24%, transparent)); }
+.lab-btn-ghost:hover:not(:disabled) { filter: none; background: var(--muted, color-mix(in oklab, currentColor 7%, transparent)); }
+.lab-dots { display: inline-flex; gap: 7px; }
+.lab-dot { width: 8px; height: 8px; border-radius: 999px; background: var(--border, color-mix(in oklab, currentColor 22%, transparent)); transition: background .2s; }
+.lab-dot[data-on="true"] { background: var(--primary, oklch(0.59 0.22 261)); }
+
+/* ── Language labs ───────────────────────────────────────────────────────────
+   Part-of-speech colours (Montessori-inspired, overridable). Tuned dark enough
+   for white tile text in both light + dark themes. Plus the .lang-* DOM kit. */
+:root {
+  --lang-pos-noun: oklch(0.50 0.13 264);
+  --lang-pos-verb: oklch(0.53 0.20 25);
+  --lang-pos-article: oklch(0.52 0.13 150);
+  --lang-pos-adjective: oklch(0.55 0.13 60);
+  --lang-pos-preposition: oklch(0.52 0.13 235);
+  --lang-pos-pronoun: oklch(0.52 0.18 300);
+  --lang-pos-conjunction: oklch(0.55 0.18 350);
+  --lang-pos-adverb: oklch(0.52 0.12 195);
+  --lang-pos-other: oklch(0.50 0.02 260);
+}
+
+.lang-lab { position: relative; }
+.lang-title { font-weight: 600; margin: 0 0 2px; color: var(--foreground, currentColor); }
+.lang-hint { font-size: 13px; opacity: .72; margin: 0 0 10px; }
+.lang-prompt { font-size: 19px; font-weight: 600; margin: 0 0 12px; color: var(--foreground, currentColor); }
+
+/* POS-coloured word tile */
+.lang-tile { display: inline-flex; flex-direction: column; align-items: center; gap: 1px; padding: 8px 14px; border: 0; border-radius: 12px; background: var(--pos, var(--lang-pos-other)); color: #fff; font-weight: 700; font-size: 16px; line-height: 1.15; cursor: pointer; box-shadow: 0 1px 2px rgba(0,0,0,.18); transition: transform .1s, filter .12s, box-shadow .12s; }
+.lang-tile:hover { filter: brightness(1.08); }
+.lang-tile:active { transform: translateY(1px); }
+.lang-tile:focus-visible { outline: 2px solid var(--ring, var(--primary, oklch(0.59 0.22 261))); outline-offset: 2px; }
+.lang-tile[data-sel="true"] { box-shadow: 0 0 0 3px color-mix(in oklab, var(--pos) 55%, transparent); }
+.lang-tile[data-dim="true"] { opacity: .4; }
+.lang-tile-text { font-size: 16px; }
+.lang-tile-gloss { font-size: 11px; font-weight: 600; opacity: .82; }
+
+/* the line being built + the bank */
+.lang-line { display: flex; flex-wrap: wrap; gap: 8px; align-items: center; min-height: 56px; padding: 12px; border-radius: 14px; border: 2px dashed var(--border, color-mix(in oklab, currentColor 28%, transparent)); background: var(--muted, color-mix(in oklab, currentColor 5%, transparent)); transition: border-color .15s, background .15s; }
+.lang-line[data-state="ok"] { border-style: solid; border-color: var(--success, oklch(0.62 0.17 150)); background: color-mix(in oklab, var(--success, oklch(0.62 0.17 150)) 10%, transparent); }
+.lang-line[data-state="no"] { border-color: var(--destructive, oklch(0.58 0.22 25)); }
+.lang-line-empty { font-size: 13px; opacity: .55; }
+.lang-bank { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 12px; }
+
+/* speaker button */
+.lang-speak { display: inline-flex; align-items: center; justify-content: center; width: 26px; height: 26px; margin-inline-start: 2px; border: 0; border-radius: 999px; background: color-mix(in oklab, currentColor 12%, transparent); color: inherit; font-size: 13px; cursor: pointer; transition: background .12s; }
+.lang-speak:hover { background: color-mix(in oklab, var(--primary, oklch(0.59 0.22 261)) 22%, transparent); }
+
+/* matching grid */
+.lang-match { display: grid; grid-template-columns: 1fr 1fr; gap: 10px 28px; max-width: 520px; }
+.lang-col { display: flex; flex-direction: column; gap: 8px; }
+.lang-match-row { position: relative; display: flex; align-items: center; }
+.lang-match-row .lang-match-cell { flex: 1; padding-right: 38px; }
+.lang-match-row .lang-speak { position: absolute; right: 8px; top: 50%; transform: translateY(-50%); margin: 0; }
+.lang-match-cell { display: flex; align-items: center; justify-content: center; gap: 6px; position: relative; padding: 12px 14px; border: 1.5px solid var(--border, color-mix(in oklab, currentColor 28%, transparent)); border-radius: 12px; background: var(--card, var(--background, transparent)); color: var(--foreground, inherit); font-size: 15px; font-weight: 600; cursor: pointer; transition: border-color .12s, background .12s, transform .1s; }
+.lang-match-cell:hover:not(:disabled) { border-color: var(--primary, oklch(0.59 0.22 261)); }
+.lang-match-cell[data-state="sel"] { border-color: var(--primary, oklch(0.59 0.22 261)); background: color-mix(in oklab, var(--primary, oklch(0.59 0.22 261)) 12%, transparent); }
+.lang-match-cell[data-state="ok"] { border-color: var(--success, oklch(0.62 0.17 150)); background: color-mix(in oklab, var(--success, oklch(0.62 0.17 150)) 14%, transparent); cursor: default; }
+.lang-match-cell[data-state="no"] { border-color: var(--destructive, oklch(0.58 0.22 25)); background: color-mix(in oklab, var(--destructive, oklch(0.58 0.22 25)) 12%, transparent); animation: lang-shake .42s; }
+.lang-match-cell:disabled { cursor: default; }
+.lang-cell-sub { font-size: 11px; opacity: .6; font-weight: 500; }
+.lang-cell-icon { font-size: 36px; line-height: 1; }
+@keyframes lang-shake { 0%,100% { transform: translateX(0); } 25% { transform: translateX(-4px); } 75% { transform: translateX(4px); } }
+
+/* river current — wave streaks drift downstream; period (28px) == dash period so the loop is seamless */
+.lab-river-wave { animation-name: stage-river-drift; animation-timing-function: linear; animation-iteration-count: infinite; will-change: transform; }
+@keyframes stage-river-drift { from { transform: translateX(0); } to { transform: translateX(28px); } }
+@media (prefers-reduced-motion: reduce) { .lab-river-wave { animation: none; } }
+
+/* boolean-circuit — a live wire (carrying a 1) shows current flowing source→device */
+.lc-wire-live { stroke-dasharray: 7 9; animation: lc-flow .55s linear infinite; }
+@keyframes lc-flow { to { stroke-dashoffset: -16; } }
+@media (prefers-reduced-motion: reduce) { .lc-wire-live { animation: none; stroke-dasharray: none; } }
+
+/* annotation kit — a Spotlight ring pulses outward to draw the eye */
+.lab-pulse { animation: lab-pulse 1.5s ease-out infinite; }
+@keyframes lab-pulse { 0% { transform: scale(.55); opacity: .75; } 100% { transform: scale(1.9); opacity: 0; } }
+@media (prefers-reduced-motion: reduce) { .lab-pulse { animation: none; } }
+
+/* choice-based grammar labs (ArticleLens, Agreement) */
+.lang-sentence { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; font-size: 22px; font-weight: 600; color: var(--foreground, currentColor); margin: 6px 0 16px; }
+.lang-blank { display: inline-flex; align-items: center; justify-content: center; min-width: 52px; padding: 2px 12px; border-radius: 10px; border: 2px dashed var(--border, color-mix(in oklab, currentColor 30%, transparent)); background: var(--muted, color-mix(in oklab, currentColor 5%, transparent)); font-weight: 800; }
+.lang-blank[data-state="ok"] { border-style: solid; border-color: var(--success, oklch(0.62 0.17 150)); color: var(--success, oklch(0.62 0.17 150)); background: color-mix(in oklab, var(--success, oklch(0.62 0.17 150)) 12%, transparent); }
+.lang-blank[data-state="no"] { border-style: solid; border-color: var(--destructive, oklch(0.58 0.22 25)); color: var(--destructive, oklch(0.58 0.22 25)); }
+.lang-noun, .lang-subject { font-weight: 700; }
+.lang-subject[data-ok="true"] { color: var(--lang-pos-pronoun); }
+.lang-link { color: var(--success, oklch(0.62 0.17 150)); font-weight: 800; }
+.lang-choices { display: flex; flex-wrap: wrap; gap: 10px; }
+.lang-choice { padding: 10px 20px; border-radius: 12px; border: 1.5px solid var(--border, color-mix(in oklab, currentColor 28%, transparent)); background: var(--card, var(--background, transparent)); color: var(--foreground, inherit); font-size: 17px; font-weight: 700; cursor: pointer; transition: border-color .12s, background .12s, transform .1s; }
+.lang-choice:hover:not(:disabled) { border-color: var(--primary, oklch(0.59 0.22 261)); }
+.lang-choice[data-state="ok"] { border-color: var(--success, oklch(0.62 0.17 150)); background: color-mix(in oklab, var(--success, oklch(0.62 0.17 150)) 16%, transparent); }
+.lang-choice[data-state="no"] { border-color: var(--destructive, oklch(0.58 0.22 25)); background: color-mix(in oklab, var(--destructive, oklch(0.58 0.22 25)) 12%, transparent); animation: lang-shake .42s; }
+.lang-choice:disabled:not([data-state="ok"]) { opacity: .5; cursor: default; }
+.lang-why { font-size: 14px; font-weight: 600; margin: 12px 0 0; }
+.lang-why[data-state="ok"] { color: var(--success, oklch(0.62 0.17 150)); }
+.lang-why[data-state="no"] { color: var(--muted-foreground, color-mix(in oklab, currentColor 55%, transparent)); }
+
+/* transform lab: read-only source row + arrow */
+.lang-from { display: flex; flex-wrap: wrap; gap: 8px; align-items: center; opacity: .85; }
+.lang-from .lang-tile { filter: saturate(.7); cursor: default; }
+.lang-arrow { font-size: 22px; font-weight: 800; color: var(--muted-foreground, color-mix(in oklab, currentColor 55%, transparent)); margin: 4px 0; text-align: center; width: 100%; }
+
+/* preposition scene — emoji figure positioned vs a landmark (data-driven) */
+.lang-scene { display: flex; justify-content: center; padding: 4px 0 10px; }
+.lang-prepscene { position: relative; width: 240px; height: 172px; overflow: hidden; border-radius: 12px; border: 1px solid var(--border, color-mix(in oklab, currentColor 18%, transparent)); background: color-mix(in oklab, currentColor 3%, transparent); }
+.lang-preplandmark { position: absolute; left: 50%; top: 56%; transform: translate(-50%, -50%); font-size: 62px; line-height: 1; }
+.lang-prepfig { position: absolute; font-size: 38px; line-height: 1; filter: drop-shadow(0 1px 1.5px rgba(0,0,0,0.3)); }
+
+/* vector types reference grid */
+.lang-typegrid { display: grid; grid-template-columns: repeat(auto-fill, minmax(180px, 1fr)); gap: 12px; }
+.lang-typecard { border: 1px solid var(--border, color-mix(in oklab, currentColor 18%, transparent)); border-radius: 12px; padding: 6px 8px 10px; background: var(--card, transparent); min-width: 0; }
+.lang-typecard svg { width: 100%; height: auto; max-width: 100%; }
+.lang-typename { font-weight: 700; font-size: 14px; margin: 4px 0 0; color: var(--foreground, currentColor); }
+.lang-typecap { font-size: 12px; opacity: .72; margin: 1px 0 0; }