@classytic/labs 0.1.0 → 0.2.0

package/dist/blocks/ml.d.mts

@@ -1,6 +1,8 @@
 import { RegressionLab } from "../ml/regression/preset.mjs";
 import { KMeansLab } from "../ml/kmeans/preset.mjs";
 import { ClassifierThresholdLab } from "../ml/classifier/preset.mjs";
+import { DecisionBoundaryLab } from "../ml/boundary/preset.mjs";
+import { KNNBoundaryLab } from "../ml/knn/preset.mjs";
 import { z } from "zod";
 
 //#region src/blocks/ml.d.ts
@@ -40,6 +42,27 @@ declare const ClassifierThresholdBlock: import("@classytic/cms-ui/contract").Cms
   title: z.ZodOptional<z.ZodString>;
   prompt: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>>;
+declare const DecisionBoundaryBlock: import("@classytic/cms-ui/contract").CmsBlock<z.ZodObject<{
+  dataset: z.ZodDefault<z.ZodEnum<{
+    xor: "xor";
+    separable: "separable";
+    overlap: "overlap";
+  }>>;
+  seed: z.ZodDefault<z.ZodNumber>;
+  title: z.ZodOptional<z.ZodString>;
+  prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const KnnBoundaryBlock: import("@classytic/cms-ui/contract").CmsBlock<z.ZodObject<{
+  dataset: z.ZodDefault<z.ZodEnum<{
+    xor: "xor";
+    blobs: "blobs";
+    circles: "circles";
+  }>>;
+  k: z.ZodDefault<z.ZodNumber>;
+  seed: z.ZodDefault<z.ZodNumber>;
+  title: z.ZodOptional<z.ZodString>;
+  prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
 /** This domain's block specs + tag→component render map. */
 declare const mlBlocks: readonly [import("@classytic/cms-ui/contract").CmsBlock<z.ZodObject<{
   data: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -74,11 +97,32 @@ declare const mlBlocks: readonly [import("@classytic/cms-ui/contract").CmsBlock<
   span: z.ZodDefault<z.ZodNumber>;
   title: z.ZodOptional<z.ZodString>;
   prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>, import("@classytic/cms-ui/contract").CmsBlock<z.ZodObject<{
+  dataset: z.ZodDefault<z.ZodEnum<{
+    xor: "xor";
+    separable: "separable";
+    overlap: "overlap";
+  }>>;
+  seed: z.ZodDefault<z.ZodNumber>;
+  title: z.ZodOptional<z.ZodString>;
+  prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>, import("@classytic/cms-ui/contract").CmsBlock<z.ZodObject<{
+  dataset: z.ZodDefault<z.ZodEnum<{
+    xor: "xor";
+    blobs: "blobs";
+    circles: "circles";
+  }>>;
+  k: z.ZodDefault<z.ZodNumber>;
+  seed: z.ZodDefault<z.ZodNumber>;
+  title: z.ZodOptional<z.ZodString>;
+  prompt: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>>];
 declare const mlComponents: {
   readonly Regression: typeof RegressionLab;
   readonly KMeans: typeof KMeansLab;
   readonly ClassifierThreshold: typeof ClassifierThresholdLab;
+  readonly DecisionBoundary: typeof DecisionBoundaryLab;
+  readonly KnnBoundary: typeof KNNBoundaryLab;
 };
 //#endregion
-export { ClassifierThresholdBlock, KMeansBlock, RegressionBlock, mlBlocks, mlComponents };
+export { ClassifierThresholdBlock, DecisionBoundaryBlock, KMeansBlock, KnnBoundaryBlock, RegressionBlock, mlBlocks, mlComponents };

package/dist/blocks/ml.mjs

@@ -1,6 +1,8 @@
 import { RegressionLab } from "../ml/regression/preset.mjs";
 import { KMeansLab } from "../ml/kmeans/preset.mjs";
 import { ClassifierThresholdLab } from "../ml/classifier/preset.mjs";
+import { DecisionBoundaryLab } from "../ml/boundary/preset.mjs";
+import { KNNBoundaryLab } from "../ml/knn/preset.mjs";
 import { LabConfig } from "./lab-config.mjs";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { z } from "zod";
@@ -8,10 +10,10 @@ import { defineBlock } from "@classytic/cms-ui/contract";
 
 //#region src/blocks/ml.tsx
 /**
-* @classytic/labs/blocks — machine-learning / data-analytics lab block specs.
+* @classytic/labs/blocks, machine-learning / data-analytics lab block specs.
 *
 * `defineBlock` editor adapters for the ML labs. REFERENCE for the schema-driven
-* authoring panel: the editor config is just `<LabConfig schema={…}>` — one
+* authoring panel: the editor config is just `<LabConfig schema={…}>`, one
 * Zod-driven panel renders every prop, so there's no hand-built ConfigRow list to
 * maintain. Hoist each block's schema to a const so it backs BOTH `defineBlock`
 * and the panel. One domain per file; exported at `@classytic/labs/blocks/ml`.
@@ -110,7 +112,7 @@ const ClassifierThresholdBlock = defineBlock({
 	tag: "ClassifierThreshold",
 	void: true,
 	label: "Classification threshold (precision/recall)",
-	description: "The precision–recall trade-off, draggable: positive and negative examples overlap on a score axis; slide the threshold and the 2×2 confusion matrix + precision/recall/accuracy/F1 update live — pushing precision up costs recall. Author the two score sets.",
+	description: "The precision–recall trade-off, draggable: positive and negative examples overlap on a score axis; slide the threshold and the 2×2 confusion matrix + precision/recall/accuracy/F1 update live, pushing precision up costs recall. Author the two score sets.",
 	category: "interactive",
 	schema: classifierSchema,
 	Component: ({ attributes, mode, updateAttributes }) => {
@@ -130,17 +132,89 @@ const ClassifierThresholdBlock = defineBlock({
 		}), widget] });
 	}
 });
+const boundarySchema = z.object({
+	dataset: z.enum([
+		"separable",
+		"overlap",
+		"xor"
+	]).default("separable"),
+	seed: z.number().int().default(11),
+	title: z.string().optional(),
+	prompt: z.string().optional()
+});
+const DecisionBoundaryBlock = defineBlock({
+	key: "decision-boundary",
+	tag: "DecisionBoundary",
+	void: true,
+	label: "Linear decision boundary (perceptron)",
+	description: "A linear classifier you can see think: drag the boundary’s two handles to split two classes by hand (misclassified points get a red ring, accuracy updates live), then hit train and watch a perceptron nudge the line into place itself. The honest twist: the XOR dataset can’t be split by any straight line. Author the dataset + seed.",
+	category: "interactive",
+	schema: boundarySchema,
+	Component: ({ attributes, mode, updateAttributes }) => {
+		const widget = /* @__PURE__ */ jsx(DecisionBoundaryLab, {
+			dataset: attributes.dataset,
+			seed: attributes.seed,
+			title: attributes.title,
+			prompt: attributes.prompt
+		});
+		if (mode !== "editing" || !updateAttributes) return widget;
+		return /* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx(LabConfig, {
+			schema: boundarySchema,
+			value: attributes,
+			onChange: updateAttributes
+		}), widget] });
+	}
+});
+const knnSchema = z.object({
+	dataset: z.enum([
+		"blobs",
+		"xor",
+		"circles"
+	]).default("circles"),
+	k: z.number().int().min(1).max(15).default(5),
+	seed: z.number().int().default(7),
+	title: z.string().optional(),
+	prompt: z.string().optional()
+});
+const KnnBoundaryBlock = defineBlock({
+	key: "knn",
+	tag: "KnnBoundary",
+	void: true,
+	label: "k-nearest neighbours boundary",
+	description: "The answer to “a line can’t split XOR”: k-NN paints the whole plane by majority vote of each point’s k closest labelled neighbours, carving a curvy boundary that shrugs off XOR and concentric rings. Drag the test point to see its neighbours vote; slide k to feel overfit (k=1, jagged) vs oversmooth (big k). Author the dataset + k.",
+	category: "interactive",
+	schema: knnSchema,
+	Component: ({ attributes, mode, updateAttributes }) => {
+		const widget = /* @__PURE__ */ jsx(KNNBoundaryLab, {
+			dataset: attributes.dataset,
+			k: attributes.k,
+			seed: attributes.seed,
+			title: attributes.title,
+			prompt: attributes.prompt
+		});
+		if (mode !== "editing" || !updateAttributes) return widget;
+		return /* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx(LabConfig, {
+			schema: knnSchema,
+			value: attributes,
+			onChange: updateAttributes
+		}), widget] });
+	}
+});
 /** This domain's block specs + tag→component render map. */
 const mlBlocks = [
 	RegressionBlock,
 	KMeansBlock,
-	ClassifierThresholdBlock
+	ClassifierThresholdBlock,
+	DecisionBoundaryBlock,
+	KnnBoundaryBlock
 ];
 const mlComponents = {
 	Regression: RegressionLab,
 	KMeans: KMeansLab,
-	ClassifierThreshold: ClassifierThresholdLab
+	ClassifierThreshold: ClassifierThresholdLab,
+	DecisionBoundary: DecisionBoundaryLab,
+	KnnBoundary: KNNBoundaryLab
 };
 
 //#endregion
-export { ClassifierThresholdBlock, KMeansBlock, RegressionBlock, mlBlocks, mlComponents };
+export { ClassifierThresholdBlock, DecisionBoundaryBlock, KMeansBlock, KnnBoundaryBlock, RegressionBlock, mlBlocks, mlComponents };

package/dist/blocks/physics.d.mts

@@ -58,9 +58,9 @@ declare const VectorBoardBlock: import("@classytic/cms-ui/contract").CmsBlock<z.
     drag: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strip>>>;
   combine: z.ZodDefault<z.ZodEnum<{
-    none: "none";
     sum: "sum";
     diff: "diff";
+    none: "none";
   }>>;
   goalX: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
   goalY: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
@@ -152,6 +152,11 @@ declare const EntropyBlock: LabBlock;
 declare const TemperatureScalesBlock: LabBlock;
 declare const WaterDensityBlock: LabBlock;
 declare const EfficiencyBlock: LabBlock;
+declare const ElectricFieldBlock: LabBlock;
+declare const ElectricFluxBlock: LabBlock;
+declare const GaussLawBlock: LabBlock;
+declare const WorkEnergyBlock: LabBlock;
+declare const WorkPotentialBlock: LabBlock;
 declare const physicsBlocks: readonly [import("@classytic/cms-ui/contract").CmsBlock<z.ZodObject<{
   targetMeters: z.ZodOptional<z.ZodNumber>;
   g: z.ZodOptional<z.ZodNumber>;
@@ -176,9 +181,9 @@ declare const physicsBlocks: readonly [import("@classytic/cms-ui/contract").CmsB
     drag: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strip>>>;
   combine: z.ZodDefault<z.ZodEnum<{
-    none: "none";
     sum: "sum";
     diff: "diff";
+    none: "none";
   }>>;
   goalX: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
   goalY: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
@@ -240,7 +245,7 @@ declare const physicsBlocks: readonly [import("@classytic/cms-ui/contract").CmsB
   showCenterOfMass: z.ZodDefault<z.ZodBoolean>;
   title: z.ZodOptional<z.ZodString>;
   prompt: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>>, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock];
+}, z.core.$strip>>, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock, LabBlock];
 declare const physicsComponents: {
   VectorBoard: typeof VectorBoardView;
   VectorTypes: typeof VectorTypesLab;
@@ -256,4 +261,4 @@ declare const physicsComponents: {
   GravityDrop: typeof GravityDrop;
 };
 //#endregion
-export { AtwoodBlock, BulletWallsBlock, CarnotBlock, CircularMotionBlock, CollisionTrackBlock, DopplerBlock, EfficiencyBlock, EnergySkateBlock, EntropyBlock, GasProcessBlock, GravitationBlock, GravityDropBlock, HeatTransferBlock, HeatingCurveBlock, ImpulseBlock, KeplerBlock, LeverBlock, LeverPuzzle, LorentzBlock, MagnetismBlock, OpticsBlock, OrbitLabBlock, ProjectileLabBlock, RainRelativeBlock, RampForcesBlock, RippleTankBlock, RiverBoatBlock, SimpleHarmonicBlock, StoppingDistanceBlock, StringReflectionBlock, TemperatureScalesBlock, TerminalVelocityBlock, ThermalExpansionBlock, VectorBoardBlock, VectorTypesBlock, WaterDensityBlock, WaveBlock, physicsBlocks, physicsComponents };
+export { AtwoodBlock, BulletWallsBlock, CarnotBlock, CircularMotionBlock, CollisionTrackBlock, DopplerBlock, EfficiencyBlock, ElectricFieldBlock, ElectricFluxBlock, EnergySkateBlock, EntropyBlock, GasProcessBlock, GaussLawBlock, GravitationBlock, GravityDropBlock, HeatTransferBlock, HeatingCurveBlock, ImpulseBlock, KeplerBlock, LeverBlock, LeverPuzzle, LorentzBlock, MagnetismBlock, OpticsBlock, OrbitLabBlock, ProjectileLabBlock, RainRelativeBlock, RampForcesBlock, RippleTankBlock, RiverBoatBlock, SimpleHarmonicBlock, StoppingDistanceBlock, StringReflectionBlock, TemperatureScalesBlock, TerminalVelocityBlock, ThermalExpansionBlock, VectorBoardBlock, VectorTypesBlock, WaterDensityBlock, WaveBlock, WorkEnergyBlock, WorkPotentialBlock, physicsBlocks, physicsComponents };

package/dist/blocks/physics.mjs

@@ -23,7 +23,12 @@ import { RippleTankLab } from "../physics/waves/ripple.mjs";
 import { DopplerLab } from "../physics/waves/doppler.mjs";
 import { StringReflectionLab } from "../physics/waves/string.mjs";
 import { MagnetismLab } from "../physics/magnetism/preset.mjs";
+import { ElectricFieldLab } from "../physics/electric-field/preset.mjs";
+import { ElectricFluxLab } from "../physics/electric-flux/preset.mjs";
+import { GaussLab } from "../physics/gauss-law/preset.mjs";
+import { WorkPotentialLab } from "../physics/work-potential/preset.mjs";
 import { LorentzForceLab } from "../physics/lorentz/preset.mjs";
+import { WorkEnergyLab } from "../physics/work-energy/preset.mjs";
 import { HeatingCurveLab } from "../physics/thermal/preset.mjs";
 import { HeatTransferLab } from "../physics/heat-transfer/preset.mjs";
 import { ThermalExpansionLab } from "../physics/expansion/preset.mjs";
@@ -46,7 +51,7 @@ const ProjectileLabBlock = defineBlock({
 	key: "projectile-lab",
 	void: true,
 	label: "Projectile lab",
-	description: "Interactive projectile motion — tune angle & speed, hit a target.",
+	description: "Interactive projectile motion, tune angle & speed, hit a target.",
 	category: "interactive",
 	schema: z.object({
 		targetMeters: z.number().optional(),
@@ -61,7 +66,7 @@ const OrbitLabBlock = defineBlock({
 	key: "orbit-lab",
 	void: true,
 	label: "Orbit lab",
-	description: "Interactive orbit — launch a satellite: crash, orbit, or escape.",
+	description: "Interactive orbit, launch a satellite: crash, orbit, or escape.",
 	category: "interactive",
 	schema: z.object({}),
 	Component: () => /* @__PURE__ */ jsx(OrbitLab, {})
@@ -70,7 +75,7 @@ const GravityDropBlock = defineBlock({
 	key: "gravity-drop",
 	void: true,
 	label: "Gravity drop",
-	description: "Drop balls on three worlds — compare how gravity changes the fall.",
+	description: "Drop balls on three worlds, compare how gravity changes the fall.",
 	category: "interactive",
 	schema: z.object({ height: z.number().optional() }),
 	Component: ({ attributes }) => /* @__PURE__ */ jsx(GravityDrop, { height: attributes.height })
@@ -79,7 +84,7 @@ const RiverBoatBlock = defineBlock({
 	key: "river-boat",
 	void: true,
 	label: "River crossing (vectors)",
-	description: "Boat-and-river vector problem — step through tip-to-tail addition + component resolution.",
+	description: "Boat-and-river vector problem, step through tip-to-tail addition + component resolution.",
 	category: "interactive",
 	schema: z.object({
 		boatSpeed: z.number().optional(),
@@ -158,7 +163,7 @@ const OpticsBlock = defineBlock({
 	schema: z.object({}),
 	Component: ({ mode }) => mode === "editing" ? /* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx(ConfigPanel, { children: /* @__PURE__ */ jsx("span", {
 		style: { opacity: .7 },
-		children: "No settings — drag the source, aim, or mirrors in the lesson."
+		children: "No settings, drag the source, aim, or mirrors in the lesson."
 	}) }), /* @__PURE__ */ jsx(OpticsLab, {})] }) : /* @__PURE__ */ jsx(OpticsLab, {})
 });
 const LeverBlock = defineBlock({
@@ -166,7 +171,7 @@ const LeverBlock = defineBlock({
 	tag: "Lever",
 	void: true,
 	label: "Lever (balance the torque)",
-	description: "A known weight at a distance vs an unknown — set the unknown so turning effects match.",
+	description: "A known weight at a distance vs an unknown, set the unknown so turning effects match.",
 	category: "interactive",
 	schema: z.object({
 		knownWeight: z.number().default(4),
@@ -382,7 +387,7 @@ const RainRelativeBlock = defineBlock({
 	tag: "RainRelative",
 	void: true,
 	label: "Rain on a moving car (relative velocity)",
-	description: "Animated rain that slants as the car speeds up — apparent velocity V_rain − V_car, with a live triangle + angle.",
+	description: "Animated rain that slants as the car speeds up, apparent velocity V_rain − V_car, with a live triangle + angle.",
 	category: "interactive",
 	schema: z.object({
 		maxSpeed: z.number().default(10),
@@ -525,7 +530,7 @@ const RampForcesBlock = defineBlock({
 				})
 			}),
 			/* @__PURE__ */ jsx(ConfigRow, {
-				label: "controls — e.g. { \"hide\": [\"mass\"], \"lock\": [\"angle\"] }",
+				label: "controls: e.g. { \"hide\": [\"mass\"], \"lock\": [\"angle\"] }",
 				children: /* @__PURE__ */ jsx(JsonArea, {
 					value: attributes.controls ?? {},
 					onChange: (v) => updateAttributes({ controls: v }),
@@ -637,7 +642,7 @@ const stringSchema = z.object({
 });
 const StringReflectionBlock = wlab("string-reflection", "Reflection & standing waves on a string", "A pulse reflects (fixed end inverts, free end upright); a continuous wave + its reflection lock into a standing wave at the resonant harmonics fₙ=n·c/2L.", stringSchema, (a) => /* @__PURE__ */ jsx(StringReflectionLab, { ...a }));
 const magnetismSchema = z.object({ ...common });
-const MagnetismBlock = wlab("magnetism", "Magnetism — field lines & compass", "Drag a bar magnet (or switch to a current-carrying wire); the field lines retrace live and a draggable compass needle aligns to the field.", magnetismSchema, (a) => /* @__PURE__ */ jsx(MagnetismLab, { ...a }));
+const MagnetismBlock = wlab("magnetism", "Magnetism, field lines & compass", "Drag a bar magnet (or switch to a current-carrying wire); the field lines retrace live and a draggable compass needle aligns to the field.", magnetismSchema, (a) => /* @__PURE__ */ jsx(MagnetismLab, { ...a }));
 const lorentzSchema = z.object({
 	charge: z.union([z.literal(1), z.literal(-1)]).optional(),
 	fieldOut: z.boolean().optional(),
@@ -653,7 +658,7 @@ const impulseSchema = z.object({
 	crackForce: z.number().optional(),
 	...common
 });
-const ImpulseBlock = wlab("impulse", "Impulse — catch the egg (J = F·Δt = Δp)", "Same ball, same speed → fixed impulse. Stretch the contact time and the force–time pulse morphs from a tall spike to a low bump with EQUAL shaded area, so the peak force plummets. A fragile egg cracks above its force limit — the number behind airbags, crumple zones and bending your knees.", impulseSchema, (a) => /* @__PURE__ */ jsx(ImpulseLab, { ...a }));
+const ImpulseBlock = wlab("impulse", "Impulse, catch the egg (J = F·Δt = Δp)", "Same ball, same speed → fixed impulse. Stretch the contact time and the force–time pulse morphs from a tall spike to a low bump with EQUAL shaded area, so the peak force plummets. A fragile egg cracks above its force limit, the number behind airbags, crumple zones and bending your knees.", impulseSchema, (a) => /* @__PURE__ */ jsx(ImpulseLab, { ...a }));
 const bulletWallsSchema = z.object({
 	speed: z.number().optional(),
 	toughness: z.number().optional(),
@@ -673,7 +678,7 @@ const circularSchema = z.object({
 	controlConfig: ccSchema,
 	...common
 });
-const CircularMotionBlock = wlab("circular-motion", "Circular motion — centripetal force & cut the string", "A ball whirls on a string: velocity stays tangent while the tension (centripetal force F = mv²/r) points to the centre, bending the path without changing speed. Cut the string and it flies off along the TANGENT — not radially outward — killing the classic misconception. Live F, ω and period.", circularSchema, (a) => /* @__PURE__ */ jsx(CircularMotionLab, { ...a }));
+const CircularMotionBlock = wlab("circular-motion", "Circular motion, centripetal force & cut the string", "A ball whirls on a string: velocity stays tangent while the tension (centripetal force F = mv²/r) points to the centre, bending the path without changing speed. Cut the string and it flies off along the TANGENT, not radially outward, killing the classic misconception. Live F, ω and period.", circularSchema, (a) => /* @__PURE__ */ jsx(CircularMotionLab, { ...a }));
 const energySkateSchema = z.object({
 	startHeight: z.number().optional(),
 	friction: z.boolean().optional(),
@@ -681,7 +686,7 @@ const energySkateSchema = z.object({
 	controlConfig: ccSchema,
 	...common
 });
-const EnergySkateBlock = wlab("energy-skate", "Energy skate park — KE ⇄ PE (+ heat)", "A skater released on a ramp: potential, kinetic and thermal bars always sum to the same total. Friction off → it returns to the same height forever; friction on → the heat bar grows and every peak is lower. Energy conservation and conversion, animated (the LOL bar chart).", energySkateSchema, (a) => /* @__PURE__ */ jsx(EnergySkateLab, { ...a }));
+const EnergySkateBlock = wlab("energy-skate", "Energy skate park, KE ⇄ PE (+ heat)", "A skater released on a ramp: potential, kinetic and thermal bars always sum to the same total. Friction off → it returns to the same height forever; friction on → the heat bar grows and every peak is lower. Energy conservation and conversion, animated (the LOL bar chart).", energySkateSchema, (a) => /* @__PURE__ */ jsx(EnergySkateLab, { ...a }));
 const shmSchema = z.object({
 	mode: z.enum(["spring", "pendulum"]).optional(),
 	k: z.number().optional(),
@@ -691,13 +696,13 @@ const shmSchema = z.object({
 	controlConfig: ccSchema,
 	...common
 });
-const SimpleHarmonicBlock = wlab("shm", "Simple harmonic motion — spring & pendulum", "One a = −ω²x kernel, two skins. A restoring force ∝ displacement gives x(t) = A·cos(ωt), and a pen traces it out as a SINE — the bridge to the waves lessons. Spring: ω=√(k/m). Pendulum: ω=√(g/L), with the period independent of mass and amplitude. Live ω/T/f and a PE⇄KE energy split.", shmSchema, (a) => /* @__PURE__ */ jsx(SimpleHarmonicLab, { ...a }), "SimpleHarmonic");
+const SimpleHarmonicBlock = wlab("shm", "Simple harmonic motion, spring & pendulum", "One a = −ω²x kernel, two skins. A restoring force ∝ displacement gives x(t) = A·cos(ωt), and a pen traces it out as a SINE, the bridge to the waves lessons. Spring: ω=√(k/m). Pendulum: ω=√(g/L), with the period independent of mass and amplitude. Live ω/T/f and a PE⇄KE energy split.", shmSchema, (a) => /* @__PURE__ */ jsx(SimpleHarmonicLab, { ...a }), "SimpleHarmonic");
 const atwoodSchema = z.object({
 	m1: z.number().optional(),
 	m2: z.number().optional(),
 	...common
 });
-const AtwoodBlock = wlab("atwood", "Atwood machine — two masses over a pulley", "Two masses share one rope over a pulley. Only the difference in weight drives the system while the total mass resists it: a = (m₁−m₂)g/(m₁+m₂), tension T = 2m₁m₂g/(m₁+m₂). Equal masses balance; a tiny difference on big masses gives a slow, measurable a — how Atwood weighed gravity. Predict which side falls, then release.", atwoodSchema, (a) => /* @__PURE__ */ jsx(AtwoodLab, { ...a }));
+const AtwoodBlock = wlab("atwood", "Atwood machine, two masses over a pulley", "Two masses share one rope over a pulley. Only the difference in weight drives the system while the total mass resists it: a = (m₁−m₂)g/(m₁+m₂), tension T = 2m₁m₂g/(m₁+m₂). Equal masses balance; a tiny difference on big masses gives a slow, measurable a, how Atwood weighed gravity. Predict which side falls, then release.", atwoodSchema, (a) => /* @__PURE__ */ jsx(AtwoodLab, { ...a }));
 const terminalSchema = z.object({
 	mass: z.number().optional(),
 	drag: z.number().optional(),
@@ -705,7 +710,7 @@ const terminalSchema = z.object({
 	controlConfig: ccSchema,
 	...common
 });
-const TerminalVelocityBlock = wlab("terminal-velocity", "Terminal velocity — the skydiver (air drag)", "A fall with air resistance: drag grows with speed (∝v²) until it balances gravity, so the speed levels off at v_t = √(mg/b). The weight arrow stays fixed while the drag arrow rises to meet it and the v–t curve flattens onto its asymptote (exact tanh solution). Pop the parachute and v_t collapses to a survivable speed.", terminalSchema, (a) => /* @__PURE__ */ jsx(TerminalVelocityLab, { ...a }));
+const TerminalVelocityBlock = wlab("terminal-velocity", "Terminal velocity, the skydiver (air drag)", "A fall with air resistance: drag grows with speed (∝v²) until it balances gravity, so the speed levels off at v_t = √(mg/b). The weight arrow stays fixed while the drag arrow rises to meet it and the v–t curve flattens onto its asymptote (exact tanh solution). Pop the parachute and v_t collapses to a survivable speed.", terminalSchema, (a) => /* @__PURE__ */ jsx(TerminalVelocityLab, { ...a }));
 const keplerSchema = z.object({
 	semiMajor: z.number().optional(),
 	eccentricity: z.number().optional(),
@@ -713,13 +718,13 @@ const keplerSchema = z.object({
 	controlConfig: ccSchema,
 	...common
 });
-const KeplerBlock = wlab("kepler", "Kepler’s laws — orbits & equal areas", "A planet on a true ellipse with the star at a focus (Kepler 1). Solving Kepler’s equation makes it genuinely speed up at perihelion, and the equal-time wedges it sweeps come out equal in area (Kepler 2) — fat-and-short near the star, thin-and-long far out. Stretch the orbit and the period grows as T² ∝ a³ (Kepler 3).", keplerSchema, (a) => /* @__PURE__ */ jsx(KeplerLab, { ...a }));
+const KeplerBlock = wlab("kepler", "Kepler’s laws, orbits & equal areas", "A planet on a true ellipse with the star at a focus (Kepler 1). Solving Kepler’s equation makes it genuinely speed up at perihelion, and the equal-time wedges it sweeps come out equal in area (Kepler 2), fat-and-short near the star, thin-and-long far out. Stretch the orbit and the period grows as T² ∝ a³ (Kepler 3).", keplerSchema, (a) => /* @__PURE__ */ jsx(KeplerLab, { ...a }));
 const gravitationSchema = z.object({
 	planetMass: z.number().optional(),
 	satMass: z.number().optional(),
 	...common
 });
-const GravitationBlock = wlab("gravitation", "Universal gravitation — the inverse-square law", "Newton’s F = G·M·m / r². Drag the satellite and the pull tracks 1/r²: double the distance and the force drops to a quarter (not a half). A live F–r curve marks your spot on the steep fall-off; the same law thins weight with altitude (g = GM/r²) and sets orbital speed v = √(GM/r).", gravitationSchema, (a) => /* @__PURE__ */ jsx(GravitationLab, { ...a }));
+const GravitationBlock = wlab("gravitation", "Universal gravitation, the inverse-square law", "Newton’s F = G·M·m / r². Drag the satellite and the pull tracks 1/r²: double the distance and the force drops to a quarter (not a half). A live F–r curve marks your spot on the steep fall-off; the same law thins weight with altitude (g = GM/r²) and sets orbital speed v = √(GM/r).", gravitationSchema, (a) => /* @__PURE__ */ jsx(GravitationLab, { ...a }));
 const heatTransferSchema = z.object({
 	mode: z.enum([
 		"conduction",
@@ -729,7 +734,7 @@ const heatTransferSchema = z.object({
 	controlConfig: ccSchema,
 	...common
 });
-const HeatTransferBlock = wlab("heat-transfer", "Heat transfer — conduction / convection / radiation", "The three ways heat moves, each with its rate law and animation. Author a survey (all three) OR a focused lesson: set mode + controlConfig.hide=['mechanism'] to show conduction (or convection / radiation) on its own.", heatTransferSchema, (a) => /* @__PURE__ */ jsx(HeatTransferLab, { ...a }));
+const HeatTransferBlock = wlab("heat-transfer", "Heat transfer, conduction / convection / radiation", "The three ways heat moves, each with its rate law and animation. Author a survey (all three) OR a focused lesson: set mode + controlConfig.hide=['mechanism'] to show conduction (or convection / radiation) on its own.", heatTransferSchema, (a) => /* @__PURE__ */ jsx(HeatTransferLab, { ...a }));
 const thermalExpansionSchema = z.object({
 	mode: z.enum([
 		"length",
@@ -740,7 +745,7 @@ const thermalExpansionSchema = z.object({
 	controlConfig: ccSchema,
 	...common
 });
-const ThermalExpansionBlock = wlab("thermal-expansion", "Thermal expansion — length / area / volume / bimetallic", "Heat a solid and it grows: ΔL=αLΔT, ΔA=2αAΔT, ΔV=3αVΔT, plus a bimetallic-strip thermostat. Author one case (e.g. mode:'area', controlConfig.hide=['what expands']) or the full set.", thermalExpansionSchema, (a) => /* @__PURE__ */ jsx(ThermalExpansionLab, { ...a }));
+const ThermalExpansionBlock = wlab("thermal-expansion", "Thermal expansion, length / area / volume / bimetallic", "Heat a solid and it grows: ΔL=αLΔT, ΔA=2αAΔT, ΔV=3αVΔT, plus a bimetallic-strip thermostat. Author one case (e.g. mode:'area', controlConfig.hide=['what expands']) or the full set.", thermalExpansionSchema, (a) => /* @__PURE__ */ jsx(ThermalExpansionLab, { ...a }));
 const heatingCurveSchema = z.object({
 	substance: z.enum(["water", "ethanol"]).optional().describe("preset to start from"),
 	substanceName: z.string().optional().describe("custom substance name (overrides the preset)"),
@@ -755,7 +760,7 @@ const heatingCurveSchema = z.object({
 	power: z.number().optional().describe("initial heating power, W (negative cools)"),
 	...common
 });
-const HeatingCurveBlock = wlab("heating-curve", "Heating curve — q=mcΔθ runs + latent plateaus", "Pour heat into ice and watch temperature climb in steps: sloped runs where a phase warms (q=mcΔθ) and flat plateaus where it melts/boils (q=mL). Burner + beaker + thermometer beside the live curve. AUTHOR the model: pick a preset OR declare a custom substance (specific + latent heats, melt/boil points) and the starting mass/power.", heatingCurveSchema, (a) => /* @__PURE__ */ jsx(HeatingCurveLab, { ...a }));
+const HeatingCurveBlock = wlab("heating-curve", "Heating curve, q=mcΔθ runs + latent plateaus", "Pour heat into ice and watch temperature climb in steps: sloped runs where a phase warms (q=mcΔθ) and flat plateaus where it melts/boils (q=mL). Burner + beaker + thermometer beside the live curve. AUTHOR the model: pick a preset OR declare a custom substance (specific + latent heats, melt/boil points) and the starting mass/power.", heatingCurveSchema, (a) => /* @__PURE__ */ jsx(HeatingCurveLab, { ...a }));
 const gasProcessSchema = z.object({
 	kind: z.enum([
 		"isothermal",
@@ -769,7 +774,7 @@ const gasProcessSchema = z.object({
 	volumeL: z.number().optional().describe("initial volume, L"),
 	...common
 });
-const GasProcessBlock = wlab("gas-process", "Gas processes — work = area under P–V", "Expand/compress an ideal gas isothermally, adiabatically, isobarically or isochorically. The shaded area under the P–V curve is the work; the first law ΔU = Q − W balances every term. A faint reference isotherm shows the adiabatic falling steeper.", gasProcessSchema, (a) => /* @__PURE__ */ jsx(GasProcessLab, { ...a }));
+const GasProcessBlock = wlab("gas-process", "Gas processes, work = area under P–V", "Expand/compress an ideal gas isothermally, adiabatically, isobarically or isochorically. The shaded area under the P–V curve is the work; the first law ΔU = Q − W balances every term. A faint reference isotherm shows the adiabatic falling steeper.", gasProcessSchema, (a) => /* @__PURE__ */ jsx(GasProcessLab, { ...a }));
 const carnotSchema = z.object({
 	hotK: z.number().optional().describe("hot reservoir temperature, K"),
 	coldK: z.number().optional().describe("cold reservoir temperature, K"),
@@ -777,19 +782,19 @@ const carnotSchema = z.object({
 	expansionRatio: z.number().optional().describe("isothermal expansion V₂/V₁"),
 	...common
 });
-const CarnotBlock = wlab("carnot", "Carnot cycle — P–V loop + T–S rectangle", "The most efficient heat engine, shown as a P–V loop (enclosed area = net work) and the same cycle as a T–S rectangle (heat in at Th, out at Tc). Efficiency η = 1 − Tc/Th, with the entropy bookkeeping ΔS = Qh/Th = Qc/Tc → net 0.", carnotSchema, (a) => /* @__PURE__ */ jsx(CarnotCycleLab, { ...a }));
+const CarnotBlock = wlab("carnot", "Carnot cycle, P–V loop + T–S rectangle", "The most efficient heat engine, shown as a P–V loop (enclosed area = net work) and the same cycle as a T–S rectangle (heat in at Th, out at Tc). Efficiency η = 1 − Tc/Th, with the entropy bookkeeping ΔS = Qh/Th = Qc/Tc → net 0.", carnotSchema, (a) => /* @__PURE__ */ jsx(CarnotCycleLab, { ...a }));
 const entropySchema = z.object({
 	mode: z.enum(["heat", "expansion"]).optional(),
 	...common
 });
-const EntropyBlock = wlab("entropy", "Entropy & the 2nd law — the one-way arrow", "Why heat flows hot→cold (ΔS_total = Q/Tc − Q/Th > 0) and a gas spreads into a vacuum (ΔS = nR·ln Vf/Vi). The total entropy of the universe always increases. Two modes: heat flow and free expansion.", entropySchema, (a) => /* @__PURE__ */ jsx(EntropyLab, { ...a }));
+const EntropyBlock = wlab("entropy", "Entropy & the 2nd law, the one-way arrow", "Why heat flows hot→cold (ΔS_total = Q/Tc − Q/Th > 0) and a gas spreads into a vacuum (ΔS = nR·ln Vf/Vi). The total entropy of the universe always increases. Two modes: heat flow and free expansion.", entropySchema, (a) => /* @__PURE__ */ jsx(EntropyLab, { ...a }));
 const tempScalesSchema = z.object({ ...common });
-const TemperatureScalesBlock = wlab("temperature-scales", "Temperature scales — °C / °F / K", "One mercury column read against Celsius, Fahrenheit and Kelvin at once (F = 9⁄5·C + 32, K = C + 273.15). Fixed points marked; jump to absolute zero, ice, body, boiling. Shows why Kelvin starts at absolute zero.", tempScalesSchema, (a) => /* @__PURE__ */ jsx(TemperatureScalesLab, { ...a }));
+const TemperatureScalesBlock = wlab("temperature-scales", "Temperature scales, °C / °F / K", "One mercury column read against Celsius, Fahrenheit and Kelvin at once (F = 9⁄5·C + 32, K = C + 273.15). Fixed points marked; jump to absolute zero, ice, body, boiling. Shows why Kelvin starts at absolute zero.", tempScalesSchema, (a) => /* @__PURE__ */ jsx(TemperatureScalesLab, { ...a }));
 const waterDensitySchema = z.object({
 	mode: z.enum(["anomaly", "lake"]).optional(),
 	...common
 });
-const WaterDensityBlock = wlab("water-density", "Water’s 4 °C anomaly — why ice floats", "Water is densest at 4 °C and expands again toward freezing, so ice floats. Drag the temperature on the density curve, or switch to the lake view to see why a pond freezes top-down (4 °C water and fish survive below the ice).", waterDensitySchema, (a) => /* @__PURE__ */ jsx(WaterDensityLab, { ...a }));
+const WaterDensityBlock = wlab("water-density", "Water’s 4 °C anomaly, why ice floats", "Water is densest at 4 °C and expands again toward freezing, so ice floats. Drag the temperature on the density curve, or switch to the lake view to see why a pond freezes top-down (4 °C water and fish survive below the ice).", waterDensitySchema, (a) => /* @__PURE__ */ jsx(WaterDensityLab, { ...a }));
 const efficiencySchema = z.object({
 	device: z.enum([
 		"incandescent",
@@ -809,7 +814,44 @@ const efficiencySchema = z.object({
 	})).optional().describe("author your own energy breakdown"),
 	...common
 });
-const EfficiencyBlock = wlab("efficiency", "Efficiency — input→output ratio (Sankey)", "Efficiency as the fraction of energy that comes out useful: η = useful ÷ input, drawn as a Sankey energy flow that splits into a useful stream and wasted heat. Compare real devices (incandescent vs LED, engine vs motor) or AUTHOR your own breakdown via the streams field.", efficiencySchema, (a) => /* @__PURE__ */ jsx(EfficiencyLab, { ...a }));
+const EfficiencyBlock = wlab("efficiency", "Efficiency, input→output ratio (Sankey)", "Efficiency as the fraction of energy that comes out useful: η = useful ÷ input, drawn as a Sankey energy flow that splits into a useful stream and wasted heat. Compare real devices (incandescent vs LED, engine vs motor) or AUTHOR your own breakdown via the streams field.", efficiencySchema, (a) => /* @__PURE__ */ jsx(EfficiencyLab, { ...a }));
+const electricFieldSchema = z.object({
+	title: z.string().optional(),
+	prompt: z.string().optional(),
+	objectives: z.array(z.string()).optional()
+});
+const ElectricFieldBlock = wlab("electric-field", "Electric field, charges & the force F = qE", "Drag two charges and flip their signs; field lines retrace live, flowing out of + into −. Drop a test charge anywhere and a force arrow F = qE appears, toward + or away depending on its sign. Like charges repel, opposites attract.", electricFieldSchema, (a) => /* @__PURE__ */ jsx(ElectricFieldLab, { ...a }));
+const electricFluxSchema = z.object({
+	field: z.number().optional().describe("field strength in vacuum (arbitrary units)"),
+	area: z.number().optional().describe("area: length of the flat window, scene units"),
+	angleDeg: z.number().optional().describe("initial angle between the area normal and the field, degrees"),
+	height: z.number().optional(),
+	activity: z.string().optional(),
+	title: z.string().optional(),
+	prompt: z.string().optional()
+});
+const ElectricFluxBlock = wlab("electric-flux", "Electric flux Φ = E·A·cosθ (line-counting)", "Flux made literal: how many field lines thread your area. Rotate the area (edge-on Φ = 0, face-on Φ = E·A), resize it, or change the medium (permittivity εr weakens E). The lines that pass through light up: that count is the flux.", electricFluxSchema, (a) => /* @__PURE__ */ jsx(ElectricFluxLab, { ...a }));
+const gaussSchema = z.object({
+	height: z.number().optional(),
+	activity: z.string().optional(),
+	title: z.string().optional(),
+	prompt: z.string().optional()
+});
+const GaussLawBlock = wlab("gauss-law", "Gauss’s law, flux depends only on charge inside", "A Gaussian loop (drag its centre, drag the rim to resize) sits in the field of two charges. Green markers show field leaving, red show field entering. The net flux Φ = Q/ε₀ depends only on the charge ENCLOSED, not the loop’s size or shape, and a charge outside adds zero.", gaussSchema, (a) => /* @__PURE__ */ jsx(GaussLab, { ...a }), "GaussLaw");
+const workEnergySchema = z.object({
+	mode: z.enum(["spring", "constant"]).optional(),
+	title: z.string().optional(),
+	prompt: z.string().optional(),
+	objectives: z.array(z.string()).optional()
+});
+const WorkEnergyBlock = wlab("work-energy", "Work done = area under the force–distance graph", "Work made visible as the AREA under the force–distance graph. A spring (F = kx) gives a triangle so W = ½kx², a constant force gives a rectangle so W = Fx. Drag the distance and the shaded area (the work) grows with it; the equation updates live.", workEnergySchema, (a) => /* @__PURE__ */ jsx(WorkEnergyLab, { ...a }));
+const workPotentialSchema = z.object({
+	height: z.number().optional(),
+	activity: z.string().optional(),
+	title: z.string().optional(),
+	prompt: z.string().optional()
+});
+const WorkPotentialBlock = wlab("work-potential", "Potential & work, equipotentials and W = qΔV", "Electric potential made visible through equipotential rings (V = kQ/r) with field lines at right angles. Drag points A and B: the work to move a charge A → B is W = qΔV and depends only on the endpoints, never the path. Slide a point around a ring (same V) and the work is zero.", workPotentialSchema, (a) => /* @__PURE__ */ jsx(WorkPotentialLab, { ...a }));
 const physicsBlocks = [
 	ProjectileLabBlock,
 	OrbitLabBlock,
@@ -846,7 +888,12 @@ const physicsBlocks = [
 	EntropyBlock,
 	TemperatureScalesBlock,
 	WaterDensityBlock,
-	EfficiencyBlock
+	EfficiencyBlock,
+	ElectricFieldBlock,
+	ElectricFluxBlock,
+	GaussLawBlock,
+	WorkEnergyBlock,
+	WorkPotentialBlock
 ];
 const physicsComponents = {
 	...buildComponents(physicsBlocks),
@@ -865,4 +912,4 @@ const physicsComponents = {
 };
 
 //#endregion
-export { AtwoodBlock, BulletWallsBlock, CarnotBlock, CircularMotionBlock, CollisionTrackBlock, DopplerBlock, EfficiencyBlock, EnergySkateBlock, EntropyBlock, GasProcessBlock, GravitationBlock, GravityDropBlock, HeatTransferBlock, HeatingCurveBlock, ImpulseBlock, KeplerBlock, LeverBlock, LeverPuzzle, LorentzBlock, MagnetismBlock, OpticsBlock, OrbitLabBlock, ProjectileLabBlock, RainRelativeBlock, RampForcesBlock, RippleTankBlock, RiverBoatBlock, SimpleHarmonicBlock, StoppingDistanceBlock, StringReflectionBlock, TemperatureScalesBlock, TerminalVelocityBlock, ThermalExpansionBlock, VectorBoardBlock, VectorTypesBlock, WaterDensityBlock, WaveBlock, physicsBlocks, physicsComponents };
+export { AtwoodBlock, BulletWallsBlock, CarnotBlock, CircularMotionBlock, CollisionTrackBlock, DopplerBlock, EfficiencyBlock, ElectricFieldBlock, ElectricFluxBlock, EnergySkateBlock, EntropyBlock, GasProcessBlock, GaussLawBlock, GravitationBlock, GravityDropBlock, HeatTransferBlock, HeatingCurveBlock, ImpulseBlock, KeplerBlock, LeverBlock, LeverPuzzle, LorentzBlock, MagnetismBlock, OpticsBlock, OrbitLabBlock, ProjectileLabBlock, RainRelativeBlock, RampForcesBlock, RippleTankBlock, RiverBoatBlock, SimpleHarmonicBlock, StoppingDistanceBlock, StringReflectionBlock, TemperatureScalesBlock, TerminalVelocityBlock, ThermalExpansionBlock, VectorBoardBlock, VectorTypesBlock, WaterDensityBlock, WaveBlock, WorkEnergyBlock, WorkPotentialBlock, physicsBlocks, physicsComponents };

package/dist/blocks/statistics.mjs

@@ -65,7 +65,7 @@ const galtonSchema = z.object({
 	showCurve: z.boolean().optional(),
 	...common
 });
-const GaltonBlock = lab("galton", "GaltonBoard", "Galton board (central limit theorem)", "Balls bounce through pegs (each a coin-flip) and pile into a bell curve hugging the theoretical normal — the CLT made visible.", galtonSchema, (a) => /* @__PURE__ */ jsx(GaltonBoardLab, { ...a }));
+const GaltonBlock = lab("galton", "GaltonBoard", "Galton board (central limit theorem)", "Balls bounce through pegs (each a coin-flip) and pile into a bell curve hugging the theoretical normal, the CLT made visible.", galtonSchema, (a) => /* @__PURE__ */ jsx(GaltonBoardLab, { ...a }));
 const histoSchema = z.object({
 	data: z.array(z.number()).optional(),
 	bins: z.number().optional(),

package/dist/build/CircuitEditor.d.mts

@@ -0,0 +1,14 @@
+import { CircuitDoc } from "./contract.mjs";
+import { ReactNode } from "react";
+
+//#region src/build/CircuitEditor.d.ts
+interface CircuitEditorProps {
+  value: CircuitDoc;
+  onChange: (doc: CircuitDoc) => void;
+}
+declare function CircuitEditor({
+  value,
+  onChange
+}: CircuitEditorProps): ReactNode;
+//#endregion
+export { CircuitEditor, CircuitEditorProps };