@classytic/labs 0.6.0 → 0.7.0

package/dist/domains/ml/model-complexity/scene.mjs

@@ -1,17 +1,25 @@
 'use client';
 
 import { HUE } from "../../../kit/figure/figure.mjs";
-import { useShell } from "../../../kit/shell/context.mjs";
+import { useShellMeta } from "../../../kit/shell/context.mjs";
 import { useLabView } from "../../../runtime/use-lab-view.mjs";
+import { stageLabelBox } from "../../../kit/diagram/label-placement.mjs";
 import { useAsking, useEarned } from "../../../kit/shell/earned.mjs";
 import { degreeName, fmtMse, modelComplexityModel } from "./model.mjs";
-import { Axes, Dot, Grid, Label, Polyline, Stage } from "@classytic/stage";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { Stage } from "@classytic/stage/view";
+import { Axes, Dot, Grid, Label, Polyline } from "@classytic/stage/primitives";
 
 //#region src/domains/ml/model-complexity/scene.tsx
 function ModelComplexityScene() {
-	const { state, reading: r } = useLabView(modelComplexityModel), committed = useEarned(), shell = useShell(), asking = useAsking(shell.meta.question?.id ?? ""), earned = committed && !asking;
-	const titleSize = 12, xw = r.xLabel.length * titleSize * .56, yw = r.yLabel.length * titleSize * .56, keepClear = [{
+	const { state, reading: r } = useLabView(modelComplexityModel), committed = useEarned(), meta = useShellMeta(), asking = useAsking(meta.question?.id ?? ""), earned = committed && !asking;
+	const titleWidth = (text) => stageLabelBox(text, {
+		x: 0,
+		y: 0
+	}, {
+		size: 12,
+		pad: 0
+	}).halfWidth * 2, xw = titleWidth(r.xLabel), yw = titleWidth(r.yLabel), keepClear = [{
 		x: r.view.xMax,
 		y: r.view.yMin,
 		dx: -xw / 2,

package/dist/domains/ml/multi-head-attention/multi-head-attention-diagram.mjs

@@ -3,7 +3,6 @@
 import { FigText } from "../../../kit/figure/text.mjs";
 import { Figure, HUE, STROKE, tint } from "../../../kit/figure/figure.mjs";
 import { FigureAction } from "../../../kit/figure/action.mjs";
-import "../../../kit/figure/index.mjs";
 import { useEarned } from "../../../kit/shell/earned.mjs";
 import { ROLE } from "../../../deep-learning/visuals/attention-roles.mjs";
 import { jsx, jsxs } from "react/jsx-runtime";

package/dist/domains/ml/multi-head-attention/scene.mjs

@@ -1,10 +1,10 @@
 'use client';
 
 import { useMarkDrawn } from "../../../runtime/drawn-controls.mjs";
-import { useNarrow } from "../../../kit/figure/narrow.mjs";
-import { useShell } from "../../../kit/shell/context.mjs";
+import { useShellMeta } from "../../../kit/shell/context.mjs";
 import { useControl } from "../../../runtime/use-control.mjs";
 import { useLabView } from "../../../runtime/use-lab-view.mjs";
+import { useNarrow } from "../../../kit/figure/narrow.mjs";
 import { useAsking, useEarned } from "../../../kit/shell/earned.mjs";
 import { multiHeadAttentionModel } from "./model.mjs";
 import { MultiHeadAttentionDiagram } from "./multi-head-attention-diagram.mjs";
@@ -16,7 +16,7 @@ function MultiHeadAttentionScene() {
 	const { state, reading: r, act } = useLabView(multiHeadAttentionModel);
 	const query = useControl(multiHeadAttentionModel, "query"), head = useControl(multiHeadAttentionModel, "head");
 	useMarkDrawn(useControl(multiHeadAttentionModel, "headFocus"));
-	const committed = useEarned(), shell = useShell(), asking = useAsking(shell.meta.question?.id ?? ""), reveal = committed && !asking;
+	const committed = useEarned(), meta = useShellMeta(), asking = useAsking(meta.question?.id ?? ""), reveal = committed && !asking;
 	const rowControl = (index) => ({
 		...head,
 		value: state.enabled[index],
@@ -37,7 +37,7 @@ function MultiHeadAttentionScene() {
 			queryControl: query,
 			headControl: rowControl,
 			reveal,
-			concealSelection: asking && shell.meta.sequence.current.phase !== "predict",
+			concealSelection: asking && meta.sequence.current.phase !== "predict",
 			winners: r.winners,
 			percentages: r.percentages,
 			comparison: r.comparison

package/dist/domains/ml/multimodal-alignment/scene.mjs

@@ -1,11 +1,11 @@
 'use client';
 
+import { textWidth } from "../../../kit/figure/text-metrics.mjs";
 import { FigText } from "../../../kit/figure/text.mjs";
 import { Figure, HUE, STROKE, tint } from "../../../kit/figure/figure.mjs";
-import { FigureAction } from "../../../kit/figure/action.mjs";
-import "../../../kit/figure/index.mjs";
 import { useControl } from "../../../runtime/use-control.mjs";
 import { useLabView } from "../../../runtime/use-lab-view.mjs";
+import { FigureAction } from "../../../kit/figure/action.mjs";
 import { useEarned } from "../../../kit/shell/earned.mjs";
 import { multimodalAlignmentModel } from "./model.mjs";
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -37,7 +37,7 @@ function ImageCard({ item, x, y }) {
 		baseline: "middle",
 		size: "note",
 		halo: false,
-		fit: text.length * 5.6 > 44 ? 44 : undefined,
+		fit: textWidth(text, { role: "note" }) > 44 ? 44 : undefined,
 		children: text
 	})] });
 }
@@ -148,7 +148,7 @@ function MultimodalAlignmentScene() {
 						baseline: "middle",
 						size: "note",
 						halo: false,
-						fit: nameOf(word).length * 5.6 > 50 ? 50 : undefined,
+						fit: textWidth(nameOf(word), { role: "note" }) > 50 ? 50 : undefined,
 						children: nameOf(word)
 					})]
 				});

package/dist/domains/ml/next-token/scene.mjs

@@ -3,12 +3,11 @@
 import { FigText } from "../../../kit/figure/text.mjs";
 import { Figure, HUE } from "../../../kit/figure/figure.mjs";
 import { GripKey, GripKeyRow } from "../../../kit/figure/grip.mjs";
-import { FigureAction } from "../../../kit/figure/action.mjs";
-import { FigureValueControl } from "../../../kit/figure/value-control.mjs";
-import "../../../kit/figure/index.mjs";
-import { useShell } from "../../../kit/shell/context.mjs";
+import { useShellMeta } from "../../../kit/shell/context.mjs";
 import { useControl } from "../../../runtime/use-control.mjs";
 import { useLabView } from "../../../runtime/use-lab-view.mjs";
+import { FigureAction } from "../../../kit/figure/action.mjs";
+import { FigureValueControl } from "../../../kit/figure/value-control.mjs";
 import { useAsking, useEarned } from "../../../kit/shell/earned.mjs";
 import { nextTokenModel } from "./model.mjs";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
@@ -19,7 +18,7 @@ const BAND = 84;
 function NextTokenScene() {
 	const { state, scenario, reading: r } = useLabView(nextTokenModel);
 	const next = useControl(nextTokenModel, "next"), order = useControl(nextTokenModel, "order"), temperature = useControl(nextTokenModel, "temperature"), mostLikely = useControl(nextTokenModel, "mostLikely"), clear = useControl(nextTokenModel, "clear");
-	const committed = useEarned(), shell = useShell(), asking = useAsking(shell.meta.question?.id ?? ""), probability = shell.meta.question?.id === "probability", reveal = committed && !asking;
+	const committed = useEarned(), meta = useShellMeta(), asking = useAsking(meta.question?.id ?? ""), probability = meta.question?.id === "probability", reveal = committed && !asking;
 	const bars = reveal ? r.options.length : 1;
 	const top = 40;
 	const band = top + bars * 28 + 8;

package/dist/domains/ml/overfit-gap/overfit-gap-diagram.mjs

@@ -1,10 +1,10 @@
 'use client';
 
 import { FigText } from "../../../kit/figure/text.mjs";
-import { fmt } from "../../../kit/figure/format.mjs";
+import { fmt } from "../../../model/format.mjs";
+import "../../../kit/figure/format.mjs";
 import { Figure, HUE, STROKE } from "../../../kit/figure/figure.mjs";
 import { Legend } from "../../../kit/figure/legend.mjs";
-import "../../../kit/figure/index.mjs";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/domains/ml/overfit-gap/overfit-gap-diagram.tsx

package/dist/domains/ml/overfit-gap/scene.mjs

@@ -1,11 +1,10 @@
 'use client';
 
 import { GripKey } from "../../../kit/figure/grip.mjs";
-import { FigureValueControl } from "../../../kit/figure/value-control.mjs";
-import "../../../kit/figure/index.mjs";
-import { useShell } from "../../../kit/shell/context.mjs";
+import { useShellMeta } from "../../../kit/shell/context.mjs";
 import { useControl } from "../../../runtime/use-control.mjs";
 import { useLabView } from "../../../runtime/use-lab-view.mjs";
+import { FigureValueControl } from "../../../kit/figure/value-control.mjs";
 import { useAsking, useEarned } from "../../../kit/shell/earned.mjs";
 import { overfitGapModel } from "./model.mjs";
 import { OverfitGapDiagram } from "./overfit-gap-diagram.mjs";
@@ -16,7 +15,7 @@ const loss3 = (v) => v == null || !Number.isFinite(v) ? "n/a" : v.toFixed(3);
 function OverfitGapScene() {
 	const { scenario: s, reading: r, playing, play, pause, act } = useLabView(overfitGapModel);
 	const dropout = useControl(overfitGapModel, "dropout"), decay = useControl(overfitGapModel, "weightDecay"), baseline = useControl(overfitGapModel, "baseline"), train = useControl(overfitGapModel, "train"), step = useControl(overfitGapModel, "step"), reset = useControl(overfitGapModel, "resetCurrent");
-	const earned = useEarned(), shell = useShell(), asking = useAsking(shell.meta.question?.id ?? ""), reveal = earned && !asking;
+	const earned = useEarned(), meta = useShellMeta(), asking = useAsking(meta.question?.id ?? ""), reveal = earned && !asking;
 	const stop = () => {
 		pause();
 		act("stop-training");

package/dist/domains/ml/pixel-filter/convolution-diagram.mjs

@@ -3,7 +3,6 @@
 import { FigText } from "../../../kit/figure/text.mjs";
 import { Figure, HUE, STROKE, tint } from "../../../kit/figure/figure.mjs";
 import { FigureAction } from "../../../kit/figure/action.mjs";
-import "../../../kit/figure/index.mjs";
 import { jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/domains/ml/pixel-filter/convolution-diagram.tsx

package/dist/domains/ml/pixel-filter/pixel-window-diagram.mjs

@@ -3,7 +3,6 @@
 import { FigText } from "../../../kit/figure/text.mjs";
 import { Figure, HUE, STROKE, tint } from "../../../kit/figure/figure.mjs";
 import { FigureAction } from "../../../kit/figure/action.mjs";
-import "../../../kit/figure/index.mjs";
 import { jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/domains/ml/pixel-filter/pixel-window-diagram.tsx

package/dist/domains/ml/pixel-filter/scene.mjs

@@ -1,6 +1,6 @@
 'use client';
 
-import { useShell } from "../../../kit/shell/context.mjs";
+import { useShellMeta } from "../../../kit/shell/context.mjs";
 import { useControl } from "../../../runtime/use-control.mjs";
 import { useLabView } from "../../../runtime/use-lab-view.mjs";
 import { useAsking, useEarned } from "../../../kit/shell/earned.mjs";
@@ -13,7 +13,7 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 function PixelFilterScene() {
 	const { scenario: s, reading: r } = useLabView(pixelFilterModel);
 	const windowRow = useControl(pixelFilterModel, "windowRow"), windowCol = useControl(pixelFilterModel, "windowCol"), filter = useControl(pixelFilterModel, "filter");
-	const earned = useEarned(), shell = useShell(), asking = useAsking(shell.meta.question?.id ?? "");
+	const earned = useEarned(), meta = useShellMeta(), asking = useAsking(meta.question?.id ?? "");
 	const reveal = earned && !asking;
 	return /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsxs("div", {
 		className: "lab-playwrap",

package/dist/domains/ml/position-signals/scene.mjs

@@ -3,10 +3,9 @@
 import { FigText } from "../../../kit/figure/text.mjs";
 import { Figure, HUE, STROKE, tint } from "../../../kit/figure/figure.mjs";
 import { GripButton } from "../../../kit/figure/grip.mjs";
-import { FigureAction } from "../../../kit/figure/action.mjs";
-import "../../../kit/figure/index.mjs";
 import { useControl } from "../../../runtime/use-control.mjs";
 import { useLabView } from "../../../runtime/use-lab-view.mjs";
+import { FigureAction } from "../../../kit/figure/action.mjs";
 import { useEarned } from "../../../kit/shell/earned.mjs";
 import { positionSignalsModel } from "./model.mjs";
 import { jsx, jsxs } from "react/jsx-runtime";

package/dist/domains/ml/query-key-value/model.d.mts

@@ -65,8 +65,8 @@ declare const params: z.ZodObject<{
     value: z.ZodString;
     vector: z.ZodArray<z.ZodNumber>;
     icon: z.ZodOptional<z.ZodEnum<{
-      time: "time";
       place: "place";
+      time: "time";
       appearance: "appearance";
     }>>;
   }, z.core.$strip>>>;
@@ -101,8 +101,8 @@ export declare const queryKeyValueModel: LabModel<z.ZodObject<{
     value: z.ZodString;
     vector: z.ZodArray<z.ZodNumber>;
     icon: z.ZodOptional<z.ZodEnum<{
-      time: "time";
       place: "place";
+      time: "time";
       appearance: "appearance";
     }>>;
   }, z.core.$strip>>>;

package/dist/domains/ml/query-key-value/query-key-value-diagram.mjs

@@ -3,7 +3,6 @@
 import { FigText } from "../../../kit/figure/text.mjs";
 import { Figure, HUE, STROKE, tint } from "../../../kit/figure/figure.mjs";
 import { FigureAction } from "../../../kit/figure/action.mjs";
-import "../../../kit/figure/index.mjs";
 import { ROLE } from "../../../deep-learning/visuals/attention-roles.mjs";
 import { jsx, jsxs } from "react/jsx-runtime";
 

package/dist/domains/ml/query-key-value/scene.mjs

@@ -1,11 +1,10 @@
 'use client';
 
 import { FigText } from "../../../kit/figure/text.mjs";
-import { FigureValueControl } from "../../../kit/figure/value-control.mjs";
-import "../../../kit/figure/index.mjs";
-import { useShell } from "../../../kit/shell/context.mjs";
+import { useShellMeta } from "../../../kit/shell/context.mjs";
 import { useControl } from "../../../runtime/use-control.mjs";
 import { useLabView } from "../../../runtime/use-lab-view.mjs";
+import { FigureValueControl } from "../../../kit/figure/value-control.mjs";
 import { useAsking, useEarned } from "../../../kit/shell/earned.mjs";
 import { queryKeyValueModel } from "./model.mjs";
 import { QueryKeyValueDiagram } from "./query-key-value-diagram.mjs";
@@ -15,7 +14,7 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 function QueryKeyValueScene() {
 	const { scenario: s, state, reading: r, act } = useLabView(queryKeyValueModel);
 	const query = useControl(queryKeyValueModel, "query"), key = useControl(queryKeyValueModel, "key"), inspect = useControl(queryKeyValueModel, "inspect");
-	const earned = useEarned(), shell = useShell(), asking = useAsking(shell.meta.question?.id ?? "");
+	const earned = useEarned(), meta = useShellMeta(), asking = useAsking(meta.question?.id ?? "");
 	const reveal = earned && !asking;
 	const component = (index) => ({
 		...query,

package/dist/domains/ml/regression/activity.mjs

@@ -3,9 +3,9 @@ import { defineActivity } from "../../../runtime/activity.mjs";
 import { regressionModel } from "./model.mjs";
 
 //#region src/domains/ml/regression/activity.ts
-const slopeQuestion = (answer) => ({
+const slopeQuestion = (answer, presentation = "regression") => ({
 	id: "slope-sign",
-	prompt: "Before you fit the line, looking at the cloud of points, will the best-fit line slope up or down?",
+	prompt: presentation === "best-fit" ? "Looking at the cloud of points, does its trend slope up or down?" : "Before you fit the line, looking at the cloud of points, will the best-fit line slope up or down?",
 	choices: [{
 		value: "up",
 		label: "slope up (positive)"
@@ -14,7 +14,7 @@ const slopeQuestion = (answer) => ({
 		label: "slope down (negative)"
 	}],
 	answer,
-	explain: "Least squares follows the overall trend of the cloud: as x increases the points drift the same way, so the best-fit slope picks up that direction."
+	explain: presentation === "best-fit" ? "Follow the overall trend of the cloud: compare the points at the left with those at the right. The line follows that direction." : "Least squares follows the overall trend of the cloud: as x increases the points drift the same way, so the best-fit slope picks up that direction."
 });
 /** Answers follow the actual fitted line, frozen when a typed check opens. */
 function regressionActivityFor(reading) {
@@ -40,14 +40,18 @@ function regressionActivityFor(reading) {
 			kind: "numeric",
 			id: "prediction",
 			...r.byHand.prediction,
-			explain: "A prediction is the line’s height at that x: multiply x by the slope, then add the intercept."
+			explain: "A prediction is the line’s height at that x: multiply x by the slope, then add the intercept." + (s.presentation === "best-fit" ? " This check uses the rounded coefficients printed in the question. The plotted prediction uses the unrounded line, so its final digit can differ." : "")
 		}] : []];
 		const base = labActivity({
-			title: "Least squares: drag the line, watch the error",
+			title: s.presentation === "best-fit" ? "Place a line through the data" : "Least squares: drag the line, watch the error",
 			objectives: [],
-			lead: "Drag either endpoint and watch the residual squares change, or press Descend to fit the line.",
+			lead: s.presentation === "best-fit" ? "Drag either endpoint so the line follows the middle of the points. Compare the fit across the whole cloud." : "Drag either endpoint and watch the residual squares change, or press Descend to fit the line.",
 			goal: "fitted",
-			controls: [
+			controls: s.presentation === "best-fit" ? [
+				"endpoint",
+				"end",
+				"resetLine"
+			] : [
 				"endpoint",
 				"end",
 				"learningRate",
@@ -56,7 +60,7 @@ function regressionActivityFor(reading) {
 				"reveal",
 				"resetLine"
 			],
-			observations: [slopeQuestion(r.slopeSign)]
+			observations: [slopeQuestion(r.slopeSign, s.presentation)]
 		});
 		return {
 			...base,

package/dist/domains/ml/regression/manifest.mjs

@@ -7,7 +7,7 @@ var manifest_default = defineLab({
 	domain: "ml",
 	group: "Machine learning",
 	title: "Linear regression / gradient descent",
-	description: "Least squares made hands-on: drag the line’s ends and each point grows a square of its squared error while the MSE (or MAE) updates live; press Descend to watch gradient descent fit it automatically (a learning-rate slider warns near the data’s own divergence edge). Can fit by MAE instead (least absolute deviations), mark and ask for predictions at chosen x values, and grade against relative or absolute error goals. Uses a named points dataset or inline data, with labelled axes and units.",
+	description: "Least squares made hands-on: drag the line’s ends and each point grows a square of its squared error while the MSE (or MAE) updates live; press Descend to watch gradient descent fit it automatically (a learning-rate slider warns near the data’s own divergence edge). The best-fit presentation keeps manual endpoint placement and predictions, hiding error metrics, residual squares and automated fitting; its goal still compares with a computer reference. Can fit by MAE instead (least absolute deviations), mark and ask for predictions at chosen x values, and grade against relative or absolute error goals. Uses a named points dataset or inline data, with labelled axes and units.",
 	model: regressionModel,
 	examples: [
 		{
@@ -532,6 +532,39 @@ var manifest_default = defineLab({
 					pct: 5
 				}
 			}
+		},
+		{
+			name: "manual-best-fit-and-prediction",
+			props: {
+				presentation: "best-fit",
+				data: [
+					{
+						x: 0,
+						y: 1
+					},
+					{
+						x: 5,
+						y: 5
+					},
+					{
+						x: 10,
+						y: 11
+					}
+				],
+				xRange: [0, 10],
+				yRange: [0, 12],
+				m0: 0,
+				b0: 6,
+				goal: {
+					kind: "near-best",
+					tol: .5
+				},
+				predictAt: [4],
+				askPrediction: {
+					x: 4,
+					relTol: .01
+				}
+			}
 		}
 	],
 	taxonomy: {

package/dist/domains/ml/regression/model.d.mts

@@ -37,6 +37,10 @@ declare const params: z.ZodObject<{
     x: z.ZodNumber;
     y: z.ZodNumber;
   }, z.core.$strip>>>;
+  presentation: z.ZodDefault<z.ZodEnum<{
+    regression: "regression";
+    "best-fit": "best-fit";
+  }>>;
   showSquares: z.ZodDefault<z.ZodBoolean>;
   showLine: z.ZodDefault<z.ZodBoolean>;
   learnRate: z.ZodDefault<z.ZodNumber>;
@@ -131,6 +135,10 @@ export declare const regressionModel: LabModel<z.ZodObject<{
     x: z.ZodNumber;
     y: z.ZodNumber;
   }, z.core.$strip>>>;
+  presentation: z.ZodDefault<z.ZodEnum<{
+    regression: "regression";
+    "best-fit": "best-fit";
+  }>>;
   showSquares: z.ZodDefault<z.ZodBoolean>;
   showLine: z.ZodDefault<z.ZodBoolean>;
   learnRate: z.ZodDefault<z.ZodNumber>;

package/dist/domains/ml/regression/model.mjs

@@ -50,6 +50,7 @@ const goalSchema = z.discriminatedUnion("kind", [
 const params = z.object({
 	dataset: z.string().optional().describe(`a points dataset (${mlDatasetIds("points").join(", ")}); inline props override it`),
 	data: z.array(point).min(3).max(80).optional().describe("inline points; overrides the dataset"),
+	presentation: z.enum(["regression", "best-fit"]).default("regression").describe("regression shows errors and automated fitting; best-fit keeps manual endpoints and line predictions without error metrics"),
 	showSquares: z.boolean().default(true).describe("Draw residual squares"),
 	showLine: z.boolean().default(true).describe("Show the fitted line and its controls; false is an ungraded supplied scatter diagram"),
 	learnRate: z.number().finite().min(.001).max(.04).default(.006).describe("Box-unit descent learning rate"),
@@ -244,7 +245,7 @@ function read(s, st) {
 		prediction: {
 			answer: prediction,
 			tolerance: tolerance(prediction, s.askPrediction?.relTol ?? .01),
-			prompt: `Use the line ${equationText(fine)} to predict y at x = ${s.askPrediction?.x}${s.setup.x.unit ? " " + s.setup.x.unit : ""}.`
+			prompt: `${s.presentation === "best-fit" ? "Use the rounded coefficients in" : "Use the line"} ${equationText(fine)} to predict y at x = ${s.askPrediction?.x}${s.setup.x.unit ? " " + s.setup.x.unit : ""}.`
 		}
 	};
 	const points = s.points.map((p) => ({
@@ -281,7 +282,7 @@ function read(s, st) {
 			};
 		}),
 		zone: s.fitBy === "mae" ? "safe" : regression.rateZone(st.rate, s.limit),
-		goal: goalText(s.task, s.fitBy, s.setup.y.unit),
+		goal: s.presentation === "best-fit" ? s.task.kind === "near-best" ? `Goal: keep the line within ${s.task.tol}${s.setup.y.unit ? ` ${s.setup.y.unit}` : ""} of the computer reference across the data.` : "Goal: adjust the line to match the computer fitting reference." : goalText(s.task, s.fitBy, s.setup.y.unit),
 		metricName: st.metric === "mse" ? "MSE" : "MAE",
 		errorUnit: s.setup.y.unit ? st.metric === "mae" ? s.setup.y.unit : s.setup.y.unit + "²" : undefined,
 		score: {
@@ -306,6 +307,7 @@ const regressionModel = defineLabModel({
 		if (spans.some((v, i) => !(v > 0) || !Number.isFinite(v) || !(v / 1e4 > 0) || setup[i === 0 ? "x" : "y"].range[0] + v / 1e4 === setup[i === 0 ? "x" : "y"].range[0])) return refuse("invalid-range", "Use finite increasing plotting ranges with representable handle steps.");
 		if (!p.showLine && (p.goal || p.askMse || p.askPrediction || p.predictAt != null)) return refuse("scatter-only-fit", "A supplied scatter diagram has no line, fitting goal or line-prediction checks. Omit those props or show the line.");
 		if (p.askMse && points.length > 12) return refuse("invalid-mse-check", "Use at most 12 points for a by-hand MSE.");
+		if (p.presentation === "best-fit" && p.askMse) return refuse("best-fit-error-check", "Use the regression presentation for an MSE calculation. Best-fit presentation teaches manual line placement and predictions.");
 		const predictions = p.predictAt == null ? [] : Array.isArray(p.predictAt) ? p.predictAt : [p.predictAt];
 		if ([...predictions, ...p.askPrediction ? [p.askPrediction.x] : []].some((x) => x < setup.x.range[0] || x > setup.x.range[1])) return refuse("invalid-prediction", "Place each prediction x inside the plotting range.");
 		const defaultStart = regression.lineFromFrame({
@@ -342,11 +344,11 @@ const regressionModel = defineLabModel({
 			lad
 		].every((line) => finite(s, line)) || !Number.isFinite(s.limit) || s.limit <= 0 || boxPoints.some((p) => !Number.isFinite(p.x) || !Number.isFinite(p.y))) return refuse("invalid-fit", "Reduce data/range/starting-line magnitudes so fitting and frame-scaled descent remain finite.");
 		if (holding(s, start)) return s;
-		if (holding(s, optimum)) return {
+		if (holding(s, optimum) && s.presentation === "regression") return {
 			...s,
 			proof: { kind: "reveal" }
 		};
-		const criterionBest = s.task.kind.startsWith("mae") ? lad : ls;
+		const criterionBest = holding(s, optimum) ? optimum : s.task.kind.startsWith("mae") ? lad : ls;
 		if (!holding(s, criterionBest)) return refuse("goal-unreachable", "The requested error is below the best achievable line. Relax the goal or change the data.");
 		const [lo, hi] = setup.y.range;
 		const step = (hi - lo) / 1e4;
@@ -373,7 +375,7 @@ const regressionModel = defineLabModel({
 				}
 			};
 		}
-		return refuse("unsupported-goal", "This cross-criterion goal has no proved plot-bounded handle witness. Match fitBy to the requested error criterion, widen the y range, or relax the goal.");
+		return refuse("unsupported-goal", "This goal has no proved plot-bounded handle witness. Match fitBy to the requested error criterion, widen the y range, or relax the goal.");
 	},
 	initial,
 	controls: (c) => ({
@@ -403,7 +405,7 @@ const regressionModel = defineLabModel({
 		}),
 		learningRate: c.number({
 			label: "learning rate",
-			when: (s) => s.showLine,
+			when: (s) => s.showLine && s.presentation === "regression",
 			get: (st) => st.rate,
 			range: () => [.001, .04],
 			step: .001,
@@ -415,7 +417,7 @@ const regressionModel = defineLabModel({
 		}),
 		metric: c.choice({
 			label: "error readout",
-			when: (s) => s.showLine,
+			when: (s) => s.showLine && s.presentation === "regression",
 			options: () => [{
 				value: "mse",
 				label: "MSE"
@@ -430,7 +432,7 @@ const regressionModel = defineLabModel({
 			})
 		}),
 		descend: c.action({
-			when: (s) => s.showLine,
+			when: (s) => s.showLine && s.presentation === "regression",
 			label: (_s, st) => st.running ? "Pause" : "Descend",
 			run: (_s, st) => ({
 				...st,
@@ -440,7 +442,7 @@ const regressionModel = defineLabModel({
 		}),
 		reveal: c.action({
 			label: "Reveal best fit",
-			when: (s) => s.showLine,
+			when: (s) => s.showLine && s.presentation === "regression",
 			run: (s, st) => ({
 				...st,
 				line: s.optimum,
@@ -513,7 +515,7 @@ const regressionModel = defineLabModel({
 	},
 	settled: (_s, st) => !st.running,
 	describe: (s, st, r) => !s.showLine ? `Supplied scatter diagram: ${s.points.length} paired observations of ${s.setup.y.title || "y"} against ${s.setup.x.title || "x"}. No fitted line or assessed response.` : [
-		`line ${r.equation} ${st.revealed ? "revealed" : st.descended ? "descended for " + st.iter + " steps" : "dragged by hand"}, ${s.fitBy === "mae" ? "MAE" : "MSE"} ${loss(s, st.line).toFixed(3)} against the ${s.fitBy === "mae" ? "least-absolute-deviation" : "least-squares"} ${loss(s, s.optimum).toFixed(3)}`,
+		s.presentation === "best-fit" ? `line ${r.equation} placed by hand; ${r.held ? "matches" : "not yet matching"} the computer fitting reference` : `line ${r.equation} ${st.revealed ? "revealed" : st.descended ? "descended for " + st.iter + " steps" : "dragged by hand"}, ${s.fitBy === "mae" ? "MAE" : "MSE"} ${loss(s, st.line).toFixed(3)} against the ${s.fitBy === "mae" ? "least-absolute-deviation" : "least-squares"} ${loss(s, s.optimum).toFixed(3)}`,
 		s.askMse && st.typed.mse ? "typed MSE " + st.typed.mse : "",
 		s.askPrediction && st.typed.prediction ? `typed prediction at x = ${s.askPrediction.x}: ${st.typed.prediction}` : "",
 		r.score.max ? `${r.score.raw} of ${r.score.max} question${r.score.max === 1 ? "" : "s"} right first time` : ""

package/dist/domains/ml/regression/runtime.mjs

@@ -2,7 +2,6 @@
 
 import { HUE, STROKE } from "../../../kit/figure/figure.mjs";
 import { Stat, StatList } from "../../../kit/frame.mjs";
-import "../../../kit/figure/index.mjs";
 import { useLab } from "../../../runtime/use-lab.mjs";
 import { lessonQuestions } from "../../../kit/lesson-questions.mjs";
 import { AuthoredActivityRuntime } from "../../../kit/authored-activity-runtime.mjs";
@@ -19,7 +18,7 @@ function RegressionLab(props) {
 	const asked = lessonQuestions({
 		questions: props.questions,
 		ask: props.ask
-	}, reading && lab.session?.scenario.showLine ? { predict: slopeQuestion(reading.slopeSign) } : undefined);
+	}, reading && lab.session?.scenario.showLine ? { predict: slopeQuestion(reading.slopeSign, lab.session.scenario.presentation) } : undefined);
 	const total = asked.predictions.length + asked.questions.length + (props.askMse ? 1 : 0) + (props.askPrediction ? 1 : 0);
 	return /* @__PURE__ */ jsx(AuthoredActivityRuntime, {
 		lab,
@@ -32,24 +31,24 @@ function RegressionLab(props) {
 			"resetLine"
 		],
 		layout: "stack",
-		sceneLabel: lab.session?.scenario.showLine ? "Scatter plot, residual squares and fitted line" : "Supplied scatter plot of paired observations",
+		sceneLabel: lab.session?.scenario.showLine ? lab.session.scenario.presentation === "best-fit" ? "Scatter plot and manually placed line of best fit" : "Scatter plot, residual squares and fitted line" : "Supplied scatter plot of paired observations",
 		concealEvidence: true,
-		status: ({ scenario: s, state: st, reading: r }) => s.showLine ? `${r.status} · ${r.metricName} ${fmtLoss(r.shown)}${r.errorUnit ? ` ${r.errorUnit}` : ""} · step ${st.iter}` : `${s.points.length} supplied observations`,
+		status: ({ scenario: s, state: st, reading: r }) => s.showLine ? s.presentation === "best-fit" ? r.held ? "Line matches the computer reference" : "Adjust the line through the points" : `${r.status} · ${r.metricName} ${fmtLoss(r.shown)}${r.errorUnit ? ` ${r.errorUnit}` : ""} · step ${st.iter}` : `${s.points.length} supplied observations`,
 		evidence: ({ scenario: s, state: st, reading: r }) => s.showLine ? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsxs(StatList, { children: [
-			/* @__PURE__ */ jsx(Stat, {
+			s.presentation === "regression" && /* @__PURE__ */ jsx(Stat, {
 				label: r.metricName,
 				value: fmtLoss(r.shown),
 				tone: r.held ? "good" : undefined
 			}),
-			/* @__PURE__ */ jsx(Stat, {
+			s.presentation === "regression" && /* @__PURE__ */ jsx(Stat, {
 				label: `${s.fitBy === "mae" ? "least-absolute-deviation" : "least-squares"} line ${r.metricName}`,
 				value: fmtLoss(r.optimum)
 			}),
 			r.predictions.map((p) => /* @__PURE__ */ jsx(Stat, {
-				label: `prediction at x = ${unit(p.x, s.setup.x.unit)}`,
+				label: `${s.presentation === "best-fit" ? "unrounded-line prediction" : "prediction"} at x = ${unit(p.x, s.setup.x.unit)}`,
 				value: p.hidden ? "?" : unit(p.value, s.setup.y.unit)
 			}, p.x))
-		] }), st.history.length > 1 ? /* @__PURE__ */ jsx("svg", {
+		] }), s.presentation === "regression" && st.history.length > 1 ? /* @__PURE__ */ jsx("svg", {
 			className: "ml-loss-history",
 			viewBox: "0 0 240 44",
 			width: "100%",
@@ -64,7 +63,11 @@ function RegressionLab(props) {
 				vectorEffect: "non-scaling-stroke"
 			})
 		}) : null] }) : null,
-		observation: ({ scenario: s, state: st, reading: r }) => !s.showLine ? "Each dot pairs one horizontal value with its vertical value. Describe the observed pattern without assuming that correlation proves cause." : [
+		observation: ({ scenario: s, state: st, reading: r }) => !s.showLine ? "Each dot pairs one horizontal value with its vertical value. Describe the observed pattern without assuming that correlation proves cause." : s.presentation === "best-fit" ? [
+			r.held ? "The line reaches the computer reference check. Compare how it follows the points across the whole data range." : "Drag either endpoint to change the line. Compare the points on both sides and near both ends.",
+			st.error ?? "",
+			r.goal
+		].filter(Boolean).join(" ") : [
 			r.held ? s.fitBy === "mae" ? "The line meets the fitting goal. Least absolute deviations counts every miss by its size, not its square." : "The line meets the fitting goal. Least squares chooses the line with the smallest total squared error." : st.running ? "Gradient descent follows the loss downhill; an excessive learning rate can overshoot instead of settling." : "Drag either endpoint and watch every residual square change, or run gradient descent to minimize them together.",
 			r.zone !== "safe" ? `${r.zone === "diverge" ? "Past" : "Close to"} the edge: on this data descent diverges above ${s.limit.toFixed(3)}.` : "",
 			st.error ?? "",