@classytic/stage 0.1.0 → 0.2.0

package/dist/sim/particles.d.mts

@@ -28,14 +28,14 @@ interface ParticlesState {
   py: number[];
   vx: number[];
   vy: number[];
-  /** 0 or 1 — two populations (for diffusion / colour). */
+  /** 0 or 1, two populations (for diffusion / colour). */
   group: number[];
   tSec: number;
   /** Mean kinetic energy ∝ temperature. */
   temp: number;
   /** Smoothed pressure (wall-collision momentum per unit time per unit perimeter). */
   pressure: number;
-  /** Mixing index 0 (separated) → 1 (uniform) — fraction-based, for diffusion. */
+  /** Mixing index 0 (separated) → 1 (uniform), fraction-based, for diffusion. */
   mixed: number;
 }
 declare const ParticlesCore: SimCore<ParticlesState, ParticlesParams>;

package/dist/sim/rate.d.mts

@@ -8,7 +8,7 @@ interface RateParams {
   value0?: number;
   /** Asymptote the value relaxes toward. Default 0 (pure decay). */
   target?: number;
-  /** Time constant τ (seconds) — the e-folding time. Default 1. */
+  /** Time constant τ (seconds), the e-folding time. Default 1. */
   tau?: number;
   /** Stop after this many seconds (essentially relaxed) so it doesn't run forever. Default ∞. */
   maxTime?: number;
@@ -21,15 +21,15 @@ interface RateState {
   tau: number;
   /** Seconds elapsed on this core's timeline. */
   tSec: number;
-  /** Rolling history of `value`, oldest-first — for the curve. */
+  /** Rolling history of `value`, oldest-first, for the curve. */
   samples: number[];
   cap: number;
   maxTime: number;
-  /** True once tSec ≥ maxTime — the runtime stops the loop. */
+  /** True once tSec ≥ maxTime, the runtime stops the loop. */
   done: boolean;
 }
 declare const RateCore: SimCore<RateState, RateParams>;
-/** τ from a half-life (and back) — t½ = τ·ln2. */
+/** τ from a half-life (and back), t½ = τ·ln2. */
 declare const halfLifeToTau: (halfLife: number) => number;
 declare const tauToHalfLife: (tau: number) => number;
 //#endregion

package/dist/sim/rate.mjs

@@ -31,7 +31,7 @@ const RateCore = {
 		};
 	}
 };
-/** τ from a half-life (and back) — t½ = τ·ln2. */
+/** τ from a half-life (and back), t½ = τ·ln2. */
 const halfLifeToTau = (halfLife) => halfLife / Math.LN2;
 const tauToHalfLife = (tau) => tau * Math.LN2;
 

package/dist/sim/registry.d.mts

@@ -1,7 +1,7 @@
 import { SimCore } from "./types.mjs";
 
 //#region src/sim/registry.d.ts
-/** A core with its specifics erased — the runtime reads state fields by name. */
+/** A core with its specifics erased, the runtime reads state fields by name. */
 type AnySim = SimCore<Record<string, unknown>, Record<string, unknown>>;
 declare function registerSim<S extends Record<string, unknown>, P>(name: string, core: SimCore<S, P>): void;
 declare function getSim(name: string): AnySim | undefined;

package/dist/sim/sampler.d.mts

@@ -8,7 +8,7 @@ interface SamplerParams {
   perStep?: number;
   /** PRNG seed. Default 1. */
   seed?: number;
-  /** Stop drawing once `n` reaches this — a converged sim shouldn't run forever. Default ∞. */
+  /** Stop drawing once `n` reaches this, a converged sim shouldn't run forever. Default ∞. */
   maxDraws?: number;
   /** History ring-buffer capacity for the headline estimate p[0]. Default 240. */
   trace?: number;
@@ -20,7 +20,7 @@ interface SamplerState {
    * Current PRNG state (advances every draw). Deliberately NOT named `seed`: the
    * Scene runtime merges the SimDecl `params` (which carries the initial `seed`)
    * onto the state each frame, so an evolving field sharing a param name would be
-   * clobbered back to its initial value — freezing the RNG. Keep evolving state
+   * clobbered back to its initial value, freezing the RNG. Keep evolving state
    * fields disjoint from param names.
    */
   rng: number;
@@ -30,16 +30,16 @@ interface SamplerState {
   counts: number[];
   /** Running frequency estimate per outcome (counts / n). */
   p: number[];
-  /** True (normalized) probabilities — for convergence comparison. */
+  /** True (normalized) probabilities, for convergence comparison. */
   p0: number[];
   /** Index of the most recent draw (-1 before the first). */
   last: number;
-  /** Rolling history of p[0], oldest-first — for an LLN convergence plot. */
+  /** Rolling history of p[0], oldest-first, for an LLN convergence plot. */
   samples: number[];
   cap: number;
   /** Draw cap; step() becomes a no-op once n reaches it. */
   maxDraws: number;
-  /** True once n ≥ maxDraws — the runtime stops the loop. */
+  /** True once n ≥ maxDraws, the runtime stops the loop. */
   done: boolean;
 }
 declare const SamplerCore: SimCore<SamplerState, SamplerParams>;

package/dist/sim/thermal.d.mts

@@ -21,10 +21,10 @@ interface Substance {
   /** Liquid colour token (for the skin). */
   color: string;
 }
-/** Real water — the canonical example (note: latent vaporisation ≫ everything,
+/** Real water, the canonical example (note: latent vaporisation ≫ everything,
  *  so the boiling plateau dwarfs the rest, which is exactly the lesson). */
 declare const WATER: Substance;
-/** Ethanol — lower boiling point, smaller latent heats; a contrasting curve. */
+/** Ethanol, lower boiling point, smaller latent heats; a contrasting curve. */
 declare const ETHANOL: Substance;
 type Phase = 'solid' | 'melting' | 'liquid' | 'boiling' | 'gas';
 /** One run of the energy ladder. `kind:'heat'` is a sloped temperature rise
@@ -58,7 +58,7 @@ interface ThermalState {
   powerW: number;
   tStart: number;
   tMax: number;
-  /** The full energy ladder — the heating curve, as data. */
+  /** The full energy ladder, the heating curve, as data. */
   segs: ThermalSeg[];
   /** Total heat to walk the whole ladder, J. */
   totalJ: number;

package/dist/sim/thermal.mjs

@@ -1,6 +1,6 @@
 //#region src/sim/thermal.ts
 const clamp01 = (v) => Math.max(0, Math.min(1, v));
-/** Real water — the canonical example (note: latent vaporisation ≫ everything,
+/** Real water, the canonical example (note: latent vaporisation ≫ everything,
 *  so the boiling plateau dwarfs the rest, which is exactly the lesson). */
 const WATER = {
 	name: "Water",
@@ -16,7 +16,7 @@ const WATER = {
 	tBoil: 100,
 	color: "var(--stage-accent, #3b82f6)"
 };
-/** Ethanol — lower boiling point, smaller latent heats; a contrasting curve. */
+/** Ethanol, lower boiling point, smaller latent heats; a contrasting curve. */
 const ETHANOL = {
 	name: "Ethanol",
 	solidName: "solid",

package/dist/sim/types.d.mts

@@ -1,12 +1,12 @@
 //#region src/sim/types.d.ts
 /**
- * Sim cores — the "physics engine" half of a lab: pure, time-stepped simulators
+ * Sim cores, the "physics engine" half of a lab: pure, time-stepped simulators
  * with NO React and NO pixels. A core is `reset(params) → state`, then
  * `step(state, dt) → state` once per frame. Because a core is a pure function of
  * (params, elapsed time), a lab built on one is deterministic: it replays
  * identically under a Remotion fixed-frame clock (→ video) and is unit-testable
  * with no DOM. Rendering (glyphs) READS the returned state; drawing never lives
- * in here. Live controls write their target fields onto `state` between steps —
+ * in here. Live controls write their target fields onto `state` between steps ,
  * so a core's mutable inputs (e.g. `volts`, `mode`) live IN its state, which is
  * also why those fields are readable by name from a binding.
  */

package/dist/sim/wave.d.mts

@@ -22,9 +22,9 @@ interface WaveState {
   tSec: number;
   /** Instantaneous signed voltage; sign = current direction. */
   v: number;
-  /** ∫v·dt — accumulated charge displacement; what flow position (electrons / water) reads. */
+  /** ∫v·dt, accumulated charge displacement; what flow position (electrons / water) reads. */
   charge: number;
-  /** Rolling history of `v`, oldest-first, length ≤ `cap` — for the live trace. */
+  /** Rolling history of `v`, oldest-first, length ≤ `cap`, for the live trace. */
   samples: number[];
   /** Fixed capacity of `samples`. */
   cap: number;

package/dist/sim/wave.mjs

@@ -2,9 +2,9 @@ import { oscillate } from "../core/motion.mjs";
 
 //#region src/sim/wave.ts
 /**
-* `wave` — the AC/DC signal source. One core drives a whole scene: a DC source
+* `wave`, the AC/DC signal source. One core drives a whole scene: a DC source
 * holds a steady voltage; an AC source oscillates. Either way it exposes the
-* instantaneous voltage `v` (signed — sign IS current direction) plus a rolling
+* instantaneous voltage `v` (signed, sign IS current direction) plus a rolling
 * `samples` buffer for a live scrolling trace. The SAME `v` can skin many ways at
 * once (a lamp's brightness, electrons in a wire, water sloshing in a pipe), which
 * is the point: sim ≠ render, so one signal feeds every visual metaphor in sync.

package/dist/steps/index.d.mts

@@ -1,7 +1,7 @@
 import { ReactNode } from "react";
 
 //#region src/steps/index.d.ts
-/** One step in the sequence — identity + gating only. Its TITLE, PROSE, and the
+/** One step in the sequence, identity + gating only. Its TITLE, PROSE, and the
  *  interactive itself live in the authored Section block, not here. */
 interface StepSpec {
   id: string;

package/dist/steps/index.mjs

@@ -5,14 +5,14 @@ import { createContext, createElement, useContext, useMemo, useRef, useSyncExter
 
 //#region src/steps/index.ts
 /**
-* Step progress + gating — the runtime that turns an ordered sequence of lesson
+* Step progress + gating, the runtime that turns an ordered sequence of lesson
 * STEPS into "unlock the next when this one is solved" + aggregated completion.
 *
-* ONE SOURCE OF TRUTH for the step sequence is the authored content itself — the
+* ONE SOURCE OF TRUTH for the step sequence is the authored content itself, the
 * @classytic/cms-ui `Section`/`Step` blocks a creator orders in the editor
 * (serialized in the MDX). This engine deliberately does NOT model an authored
 * "LessonDoc": that would be a SECOND, competing definition of the same steps
-* (and creators never hand-write one — they build Section blocks). The host's
+* (and creators never hand-write one, they build Section blocks). The host's
 * Section player derives a `StepSpec[]` from the section order, wraps each
 * section's interactive in `<StepScope id>`, and reads `useStepProgress` to gate
 * reveal. Each lab's `useLearner().report` flows into step completion AND

package/dist/thermo/index.d.mts

@@ -1,6 +1,6 @@
 //#region src/thermo/index.d.ts
 /**
- * `thermo` — ideal-gas thermodynamic processes, as a PURE kernel (like `field`:
+ * `thermo`, ideal-gas thermodynamic processes, as a PURE kernel (like `field`:
  * no React, no pixels, no time-stepping). A lab drives it with a slider/progress
  * fraction; the kernel returns the full P–V path of a quasi-static process plus the
  * first-law bookkeeping along it (work, heat, internal energy, entropy).

package/dist/thermo/index.mjs

@@ -1,6 +1,6 @@
 //#region src/thermo/index.ts
 /**
-* `thermo` — ideal-gas thermodynamic processes, as a PURE kernel (like `field`:
+* `thermo`, ideal-gas thermodynamic processes, as a PURE kernel (like `field`:
 * no React, no pixels, no time-stepping). A lab drives it with a slider/progress
 * fraction; the kernel returns the full P–V path of a quasi-static process plus the
 * first-law bookkeeping along it (work, heat, internal energy, entropy).

package/dist/view/Stage.mjs

@@ -8,10 +8,10 @@ import { jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/view/Stage.tsx
 /**
-* <Stage> — the SVG root. SSR-safe: builds a CoordinateSystem from explicit
+* <Stage>, the SVG root. SSR-safe: builds a CoordinateSystem from explicit
 * width/height/aspectRatio (or a default) so children render on first paint;
 * after mount a ResizeObserver swaps in the measured width. There is ONE content
-* group with no transform — every primitive self-positions via coords.toPx().
+* group with no transform, every primitive self-positions via coords.toPx().
 * A pixel-space overlay group hosts selection halos/handles (builder phase).
 */
 const DEFAULT_VIEW = {

package/dist/view/useInView.mjs

@@ -4,7 +4,7 @@ import { useEffect, useRef, useState } from "react";
 
 //#region src/view/useInView.ts
 /**
-* useInView — pause work when a lab scrolls off-screen. Sim labs drive an
+* useInView, pause work when a lab scrolls off-screen. Sim labs drive an
 * unbounded requestAnimationFrame loop; without this, every sim on a page runs
 * forever even when nobody can see it (and a gallery of labs pins the CPU). Gate
 * `useFrameLoop({ running: inView })` on this. SSR-safe; if IntersectionObserver

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/stage",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Domain-neutral visual primitive engine for the web. Declarative SVG diagram/math primitives, draggable handles, a math↔pixel coordinate system, a motion core + energy effect defs, theming, pure sim cores, and a small kit of neutral glyph primitives. Reactive, web-native, agent-drivable. The render foundation under @classytic/labs (subject-matter glyphs live there); canvas + 3D subpaths later.",
   "author": "Classytic",
   "license": "MIT",
@@ -60,6 +60,10 @@
       "types": "./dist/field/index.d.mts",
       "default": "./dist/field/index.mjs"
     },
+    "./circuit": {
+      "types": "./dist/circuit/index.d.mts",
+      "default": "./dist/circuit/index.mjs"
+    },
     "./thermo": {
       "types": "./dist/thermo/index.d.mts",
       "default": "./dist/thermo/index.mjs"
@@ -68,9 +72,9 @@
       "types": "./dist/chem/index.d.mts",
       "default": "./dist/chem/index.mjs"
     },
-    "./lesson": {
-      "types": "./dist/lesson/index.d.mts",
-      "default": "./dist/lesson/index.mjs"
+    "./steps": {
+      "types": "./dist/steps/index.d.mts",
+      "default": "./dist/steps/index.mjs"
     },
     "./styles.css": "./styles.css",
     "./package.json": "./package.json"

package/styles.css

@@ -49,6 +49,19 @@
   --stage-wire: var(--stage-metal);
   --stage-live: var(--stage-good);
   --stage-charge: var(--stage-accent);
+
+  /* Categorical series palette: 8 distinct, theme-aware hues for group / series
+     colours (K-map loops, distributions, selection groups, arrangement letters).
+     Labs import these via kit/palette instead of hardcoding hex arrays that
+     ignore dark mode. cat-1/2/3 align with accent / accent-2 / good. */
+  --stage-cat-1: oklch(0.59 0.20 261);
+  --stage-cat-2: oklch(0.63 0.17 45);
+  --stage-cat-3: oklch(0.58 0.16 150);
+  --stage-cat-4: oklch(0.55 0.20 300);
+  --stage-cat-5: oklch(0.62 0.12 200);
+  --stage-cat-6: oklch(0.60 0.21 18);
+  --stage-cat-7: oklch(0.70 0.15 92);
+  --stage-cat-8: oklch(0.60 0.20 332);
 }
 
 .dark {
@@ -67,4 +80,14 @@
   --stage-pan: oklch(0.83 0.02 255);
   --stage-weight-2: var(--brand-2, oklch(0.74 0.15 50));
   --stage-liquid: oklch(0.7 0.13 220 / 0.6);
+
+  /* Brighter categorical hues for the dark card surface. */
+  --stage-cat-1: oklch(0.72 0.17 261);
+  --stage-cat-2: oklch(0.78 0.15 52);
+  --stage-cat-3: oklch(0.72 0.17 150);
+  --stage-cat-4: oklch(0.71 0.18 300);
+  --stage-cat-5: oklch(0.76 0.12 200);
+  --stage-cat-6: oklch(0.73 0.18 22);
+  --stage-cat-7: oklch(0.83 0.16 92);
+  --stage-cat-8: oklch(0.75 0.18 332);
 }