@classytic/labs 0.3.0 → 0.4.0

package/dist/domains/circuits/meter-conversion/manifest.mjs

@@ -0,0 +1,69 @@
+import { defineLab } from "../../../lab-def/define-lab.mjs";
+import { commonLabProps } from "../../../blocks/lab-block.mjs";
+import { authoredActivitySchema } from "../../../schemas/activity-authoring.mjs";
+import { z } from "zod";
+
+//#region src/domains/circuits/meter-conversion/manifest.ts
+var manifest_default = defineLab({
+	id: "meter-conversion",
+	tag: "MeterConversionLab",
+	domain: "circuits",
+	group: "Electric Circuits",
+	title: "Galvanometer into ammeter or voltmeter",
+	description: "One galvanometer becomes an ammeter with a small resistance in parallel or a voltmeter with a large one in series, and the drawing shows why: in one the current reaches a junction and splits, in the other it has nowhere else to go. The shunt is derived from a current divider and the multiplier from a potential divider, so the textbook formulas appear as a consequence rather than a starting point. Also shows the loading error a real voltmeter introduces, which is the reason a potentiometer beats it.",
+	schema: z.object({
+		mode: z.enum(["ammeter", "voltmeter"]).default("ammeter"),
+		coilOhm: z.number().min(1).max(1e3).finite().default(50),
+		fullScaleMilliAmp: z.number().min(.01).max(100).finite().default(2),
+		rangeAmp: z.number().min(.01).max(20).finite().default(10),
+		rangeVolt: z.number().min(.5).max(300).finite().default(150),
+		lockMode: z.boolean().default(false),
+		activity: authoredActivitySchema.optional(),
+		...commonLabProps
+	}),
+	taxonomy: {
+		grades: ["11", "12"],
+		outcomes: [
+			"electric-circuits",
+			"meters",
+			"current-divider",
+			"potential-divider"
+		],
+		durationMinutes: 13,
+		interaction: "explorer",
+		authorability: "moderate",
+		representation: "schematic",
+		prerequisites: ["potential-divider"],
+		related: [
+			"potential-divider",
+			"null-balance",
+			"network-reduction",
+			"circuit-lab"
+		]
+	},
+	experience: {
+		objectives: [
+			"Explain why a shunt goes in parallel and a multiplier in series",
+			"Calculate a shunt from a current divider rather than from a memorised formula",
+			"State why an ammeter ends up with a low resistance and a voltmeter a high one",
+			"Estimate the error a real voltmeter introduces by loading the circuit"
+		],
+		phases: [
+			"predict",
+			"act",
+			"observe",
+			"explain",
+			"transfer"
+		],
+		responses: ["choice"],
+		accessibility: {
+			keyboard: true,
+			textAlternative: true,
+			reducedMotion: true
+		}
+	},
+	loadRuntime: () => import("./runtime.mjs")
+});
+
+//#endregion
+export { manifest_default as default };

package/dist/domains/circuits/meter-conversion/runtime.mjs

@@ -0,0 +1,3 @@
+import { MeterConversionLab } from "../../../circuits/meter-conversion/preset.mjs";
+
+export { MeterConversionLab, MeterConversionLab as default };

package/dist/domains/circuits/network-reduction/activity.mjs

@@ -0,0 +1,3 @@
+import { networkReductionActivity } from "../../../circuits/network-reduction/activity.mjs";
+
+export { networkReductionActivity as activity };

package/dist/domains/circuits/network-reduction/manifest.mjs

@@ -0,0 +1,85 @@
+import { defineLab } from "../../../lab-def/define-lab.mjs";
+import { commonLabProps } from "../../../blocks/lab-block.mjs";
+import { authoredActivitySchema } from "../../../schemas/activity-authoring.mjs";
+import { z } from "zod";
+
+//#region src/domains/circuits/network-reduction/manifest.ts
+var manifest_default = defineLab({
+	id: "network-reduction",
+	tag: "NetworkReductionLab",
+	domain: "circuits",
+	group: "Electric Circuits",
+	title: "Reducing a network, one move at a time",
+	description: "Step through the collapse of a resistor or capacitor network into a single equivalent value. Each move lights up the components it is about to combine and says why that move is legal: same current means series, same potential difference means parallel, a dead-end branch sits in no closed loop. The resistor/capacitor switch keeps the SAME drawing, so the ladder that answers 5.6 ohm answers 1.09 microfarad and only the arithmetic swaps. Includes the balanced bridge, where the bridging component can be deleted whatever its value, and the unbalanced one, where series and parallel genuinely run out.",
+	schema: z.object({
+		network: z.enum([
+			"parallel-pair",
+			"series-pair",
+			"series-parallel",
+			"ladder",
+			"dead-end",
+			"balanced-bridge",
+			"unbalanced-bridge"
+		]).default("ladder"),
+		quantity: z.enum(["resistance", "capacitance"]).default("resistance"),
+		/** Values of the first two components, so a lesson can pose its own numbers. */
+		valueA: z.number().min(0).max(1e5).finite().optional(),
+		valueB: z.number().min(0).max(1e5).finite().optional(),
+		startStep: z.number().int().min(0).max(12).default(0),
+		lockNetwork: z.boolean().default(false),
+		lockQuantity: z.boolean().default(false),
+		activity: authoredActivitySchema.optional(),
+		...commonLabProps
+	}),
+	taxonomy: {
+		grades: [
+			"9",
+			"10",
+			"11",
+			"12"
+		],
+		outcomes: [
+			"electric-circuits",
+			"series-and-parallel",
+			"equivalent-resistance",
+			"capacitance",
+			"wheatstone-bridge"
+		],
+		durationMinutes: 14,
+		interaction: "explorer",
+		authorability: "moderate",
+		representation: "schematic",
+		prerequisites: ["circuit-lab"],
+		related: [
+			"circuit-lab",
+			"null-balance",
+			"kirchhoff-laws",
+			"potential-divider"
+		]
+	},
+	experience: {
+		objectives: [
+			"Spot a series junction: a node joining exactly two resistors and nothing else",
+			"Spot a parallel pair: two resistors sharing both ends",
+			"Recognise a branch that carries no current, and say why it carries none",
+			"Recognise a balanced bridge from the ratio of its arms"
+		],
+		phases: [
+			"predict",
+			"act",
+			"observe",
+			"explain",
+			"transfer"
+		],
+		responses: ["choice"],
+		accessibility: {
+			keyboard: true,
+			textAlternative: true,
+			reducedMotion: true
+		}
+	},
+	loadRuntime: () => import("./runtime.mjs")
+});
+
+//#endregion
+export { manifest_default as default };

package/dist/domains/circuits/network-reduction/runtime.mjs

@@ -0,0 +1,3 @@
+import { NetworkReductionLab } from "../../../circuits/network-reduction/preset.mjs";
+
+export { NetworkReductionLab, NetworkReductionLab as default };

package/dist/domains/circuits/null-balance/activity.mjs

@@ -0,0 +1,3 @@
+import { nullBalanceActivity } from "../../../circuits/null-balance/activity.mjs";
+
+export { nullBalanceActivity as activity };

package/dist/domains/circuits/null-balance/manifest.mjs

@@ -0,0 +1,69 @@
+import { defineLab } from "../../../lab-def/define-lab.mjs";
+import { commonLabProps } from "../../../blocks/lab-block.mjs";
+import { authoredActivitySchema } from "../../../schemas/activity-authoring.mjs";
+import { z } from "zod";
+
+//#region src/domains/circuits/null-balance/manifest.ts
+var manifest_default = defineLab({
+	id: "null-balance",
+	tag: "NullBalanceLab",
+	domain: "circuits",
+	group: "Electric Circuits",
+	title: "Null methods: potentiometer and Wheatstone bridge",
+	description: "Balance a centre-zero galvanometer to exactly zero and read the measurement off the setting that did it. Covers the potentiometer (Cambridge 9702) and the Wheatstone and metre bridges (other boards).",
+	schema: z.object({
+		method: z.enum(["potentiometer", "bridge"]).default("potentiometer"),
+		driverEmfV: z.number().min(.5).max(12).default(2),
+		testEmfV: z.number().min(.1).max(12).default(1.5),
+		pOhm: z.number().min(1).max(100).default(10),
+		qOhm: z.number().min(1).max(100).default(20),
+		rOhm: z.number().min(1).max(100).default(15),
+		sOhm: z.number().min(1).max(100).default(24),
+		activity: authoredActivitySchema.optional(),
+		...commonLabProps
+	}),
+	taxonomy: {
+		grades: ["11", "12"],
+		outcomes: [
+			"electric-circuits",
+			"potentiometer",
+			"wheatstone-bridge",
+			"emf",
+			"null-method"
+		],
+		durationMinutes: 15,
+		interaction: "explorer",
+		authorability: "moderate",
+		representation: "schematic",
+		prerequisites: ["potential-divider"],
+		related: [
+			"potential-divider",
+			"kirchhoff-laws",
+			"circuit-builder"
+		]
+	},
+	experience: {
+		objectives: [
+			"Explain why no current flows in the detector branch at balance",
+			"Use the potential gradient to turn a balance length into an e.m.f.",
+			"State why a null method beats a voltmeter for measuring e.m.f."
+		],
+		phases: [
+			"predict",
+			"act",
+			"observe",
+			"explain",
+			"transfer"
+		],
+		responses: ["choice"],
+		accessibility: {
+			keyboard: true,
+			textAlternative: true,
+			reducedMotion: true
+		}
+	},
+	loadRuntime: () => import("./runtime.mjs")
+});
+
+//#endregion
+export { manifest_default as default };

package/dist/domains/circuits/null-balance/runtime.mjs

@@ -0,0 +1,3 @@
+import { NullBalanceLab } from "../../../circuits/null-balance/preset.mjs";
+
+export { NullBalanceLab, NullBalanceLab as default };

package/dist/domains/circuits/potential-divider/manifest.mjs

@@ -0,0 +1,69 @@
+import { defineLab } from "../../../lab-def/define-lab.mjs";
+import { commonLabProps } from "../../../blocks/lab-block.mjs";
+import { z } from "zod";
+
+//#region src/domains/circuits/potential-divider/manifest.ts
+var manifest_default = defineLab({
+	id: "potential-divider",
+	domain: "circuits",
+	group: "Circuits",
+	title: "Potential Divider (Voltage Division & Sensor Circuit)",
+	tag: "PotentialDividerLab",
+	description: "Explore voltage division ratio V_out = V_in * (R2 / (R1 + R2)) across fixed resistors, LDR light sensors, thermistors, and potentiometers. Visualizes real-time potential gradients and digital voltmeter readouts.",
+	schema: z.object({
+		supplyV: z.number().finite().min(1).max(24).optional().describe("supply voltage in volts"),
+		r1Ohm: z.number().finite().min(100).max(1e5).optional().describe("resistance R1 in ohms"),
+		r2Ohm: z.number().finite().min(100).max(1e5).optional().describe("resistance R2 in ohms"),
+		mode: z.enum([
+			"fixed",
+			"ldr",
+			"thermistor",
+			"wiper"
+		]).optional().describe("divider circuit mode"),
+		sensorPos: z.enum(["top", "bottom"]).optional().describe("which arm holds the sensor; decides which way the output moves"),
+		...commonLabProps
+	}),
+	taxonomy: {
+		grades: [
+			"10",
+			"11",
+			"12"
+		],
+		outcomes: [
+			"potential-divider",
+			"ldr",
+			"thermistor",
+			"potentiometer",
+			"sensor-circuits"
+		],
+		durationMinutes: 12,
+		interaction: "explorer",
+		authorability: "moderate",
+		representation: "schematic",
+		related: ["rc-charging", "kirchhoff-laws"]
+	},
+	experience: {
+		objectives: [
+			"Calculate output voltage using the potential divider formula",
+			"Explain how an LDR or thermistor circuit acts as an automatic light or temperature sensor",
+			"Predict the output voltage swing of a continuous potentiometer wiper"
+		],
+		phases: [
+			"predict",
+			"act",
+			"observe",
+			"explain",
+			"transfer"
+		],
+		responses: ["choice"],
+		accessibility: {
+			keyboard: true,
+			textAlternative: true,
+			reducedMotion: true
+		}
+	},
+	loadRuntime: () => import("./runtime.mjs")
+});
+
+//#endregion
+export { manifest_default as default };

package/dist/domains/circuits/potential-divider/runtime.mjs

@@ -0,0 +1,5 @@
+'use client';
+
+import { PotentialDividerLab } from "../../../circuits/potential-divider/preset.mjs";
+
+export { PotentialDividerLab as default };

package/dist/domains/data/design-records/manifest.mjs

@@ -0,0 +1,54 @@
+import { defineLab } from "../../../lab-def/define-lab.mjs";
+import { commonLabProps } from "../../../blocks/lab-block.mjs";
+import { z } from "zod";
+
+//#region src/domains/data/design-records/manifest.ts
+var manifest_default = defineLab({
+	id: "design-records",
+	domain: "data",
+	group: "Data modeling",
+	title: "Repair the records",
+	description: "Reshape repeated order records into customer and order entities so conflicting updates become impossible.",
+	schema: z.object({ ...commonLabProps }),
+	taxonomy: {
+		grades: [
+			"9",
+			"10",
+			"11",
+			"12"
+		],
+		outcomes: [
+			"data-modeling",
+			"entities",
+			"relationships",
+			"normalization",
+			"update-anomaly"
+		],
+		durationMinutes: 7,
+		interaction: "guided",
+		authorability: "simple"
+	},
+	experience: {
+		objectives: [
+			"Identify a repeated fact and update anomaly",
+			"Separate entities by responsibility",
+			"Read a key as a relationship between records"
+		],
+		phases: [
+			"predict",
+			"act",
+			"observe",
+			"explain"
+		],
+		responses: [],
+		accessibility: {
+			keyboard: true,
+			textAlternative: true,
+			reducedMotion: true
+		}
+	},
+	loadRuntime: () => import("./runtime.mjs")
+});
+
+//#endregion
+export { manifest_default as default };

package/dist/domains/data/design-records/runtime.mjs

@@ -0,0 +1,3 @@
+import { DesignRecordsLab } from "../../../data/foundation/design-records.mjs";
+
+export { DesignRecordsLab as default };

package/dist/domains/data/dirty-data/manifest.mjs

@@ -0,0 +1,53 @@
+import { defineLab } from "../../../lab-def/define-lab.mjs";
+import { commonLabProps } from "../../../blocks/lab-block.mjs";
+import { z } from "zod";
+
+//#region src/domains/data/dirty-data/manifest.ts
+var manifest_default = defineLab({
+	id: "dirty-data",
+	domain: "data",
+	group: "Data foundations",
+	title: "Find the false confidence",
+	description: "Remove records leaked from practice into the test set and distinguish a flattering score from an honest evaluation.",
+	schema: z.object({ ...commonLabProps }),
+	taxonomy: {
+		grades: [
+			"9",
+			"10",
+			"11",
+			"12"
+		],
+		outcomes: [
+			"data-quality",
+			"evaluation",
+			"data-leakage",
+			"train-test-split"
+		],
+		durationMinutes: 6,
+		interaction: "guided",
+		authorability: "simple"
+	},
+	experience: {
+		objectives: [
+			"Recognize train-test contamination",
+			"Explain why familiar test records inflate accuracy",
+			"Require independent evidence for evaluation"
+		],
+		phases: [
+			"predict",
+			"act",
+			"observe",
+			"explain"
+		],
+		responses: [],
+		accessibility: {
+			keyboard: true,
+			textAlternative: true,
+			reducedMotion: true
+		}
+	},
+	loadRuntime: () => import("./runtime.mjs")
+});
+
+//#endregion
+export { manifest_default as default };

package/dist/domains/data/dirty-data/runtime.mjs

@@ -0,0 +1,3 @@
+import { DirtyDataLab } from "../../../data/foundation/dirty-data.mjs";
+
+export { DirtyDataLab as default };

package/dist/domains/databases/b-plus-range/manifest.mjs

@@ -0,0 +1,48 @@
+import { defineLab } from "../../../lab-def/define-lab.mjs";
+import { commonLabProps } from "../../../blocks/lab-block.mjs";
+import { z } from "zod";
+
+//#region src/domains/databases/b-plus-range/manifest.ts
+var manifest_default = defineLab({
+	id: "b-plus-range",
+	domain: "databases",
+	group: "Database foundations",
+	title: "Walk the index pages",
+	description: "Open a B+ tree root page, seek to the first matching leaf, then follow linked leaves through an ordered range.",
+	schema: z.object({ ...commonLabProps }),
+	taxonomy: {
+		grades: ["11", "12"],
+		outcomes: [
+			"b-plus-tree",
+			"index-pages",
+			"range-query",
+			"leaf-links"
+		],
+		durationMinutes: 8,
+		interaction: "guided",
+		authorability: "simple"
+	},
+	experience: {
+		objectives: [
+			"Distinguish index pages from generic binary-tree nodes",
+			"Seek through separators to a starting leaf",
+			"Explain why linked leaves support ordered range scans"
+		],
+		phases: [
+			"act",
+			"observe",
+			"explain",
+			"transfer"
+		],
+		responses: [],
+		accessibility: {
+			keyboard: true,
+			textAlternative: true,
+			reducedMotion: true
+		}
+	},
+	loadRuntime: () => import("./runtime.mjs")
+});
+
+//#endregion
+export { manifest_default as default };

package/dist/domains/databases/b-plus-range/runtime.mjs

@@ -0,0 +1,3 @@
+import { BPlusRangeLab } from "../../../databases/foundation/b-plus-range.mjs";
+
+export { BPlusRangeLab as default };

package/dist/domains/databases/index-detective/manifest.mjs

@@ -0,0 +1,54 @@
+import { defineLab } from "../../../lab-def/define-lab.mjs";
+import { commonLabProps } from "../../../blocks/lab-block.mjs";
+import { z } from "zod";
+
+//#region src/domains/databases/index-detective/manifest.ts
+var manifest_default = defineLab({
+	id: "index-detective",
+	domain: "databases",
+	group: "Database foundations",
+	title: "Choose an access path",
+	description: "Compare a full scan, sorted access path, and hash lookup by stepping through every examined location.",
+	schema: z.object({ ...commonLabProps }),
+	taxonomy: {
+		grades: [
+			"10",
+			"11",
+			"12"
+		],
+		outcomes: [
+			"database-indexes",
+			"full-scan",
+			"binary-search",
+			"hash-index",
+			"query-cost"
+		],
+		durationMinutes: 8,
+		interaction: "guided",
+		authorability: "simple"
+	},
+	experience: {
+		objectives: [
+			"Measure lookup cost as examined locations",
+			"Compare scan, sorted, and hash access paths",
+			"Recognize that hash indexes do not support ordered range traversal"
+		],
+		phases: [
+			"predict",
+			"act",
+			"observe",
+			"explain",
+			"transfer"
+		],
+		responses: [],
+		accessibility: {
+			keyboard: true,
+			textAlternative: true,
+			reducedMotion: true
+		}
+	},
+	loadRuntime: () => import("./runtime.mjs")
+});
+
+//#endregion
+export { manifest_default as default };

package/dist/domains/databases/index-detective/runtime.mjs

@@ -0,0 +1,3 @@
+import { IndexDetectiveLab } from "../../../databases/foundation/index-detective.mjs";
+
+export { IndexDetectiveLab as default };

package/dist/domains/databases/query-plan/manifest.mjs

@@ -0,0 +1,49 @@
+import { defineLab } from "../../../lab-def/define-lab.mjs";
+import { commonLabProps } from "../../../blocks/lab-block.mjs";
+import { z } from "zod";
+
+//#region src/domains/databases/query-plan/manifest.ts
+var manifest_default = defineLab({
+	id: "query-plan",
+	domain: "databases",
+	group: "Database foundations",
+	title: "Filter before the join",
+	description: "Run two equivalent query plans and compare how operator order changes intermediate rows and total work.",
+	schema: z.object({ ...commonLabProps }),
+	taxonomy: {
+		grades: ["11", "12"],
+		outcomes: [
+			"query-planning",
+			"join-order",
+			"predicate-pushdown",
+			"intermediate-results"
+		],
+		durationMinutes: 8,
+		interaction: "guided",
+		authorability: "simple"
+	},
+	experience: {
+		objectives: [
+			"Read a query as physical operators",
+			"Compare equivalent plans by intermediate work",
+			"Explain why early filtering can reduce a join"
+		],
+		phases: [
+			"predict",
+			"act",
+			"observe",
+			"explain",
+			"transfer"
+		],
+		responses: [],
+		accessibility: {
+			keyboard: true,
+			textAlternative: true,
+			reducedMotion: true
+		}
+	},
+	loadRuntime: () => import("./runtime.mjs")
+});
+
+//#endregion
+export { manifest_default as default };

package/dist/domains/databases/query-plan/runtime.mjs

@@ -0,0 +1,3 @@
+import { QueryPlanLab } from "../../../databases/foundation/query-plan.mjs";
+
+export { QueryPlanLab as default };

package/dist/domains/databases/range-query/manifest.mjs

@@ -0,0 +1,53 @@
+import { defineLab } from "../../../lab-def/define-lab.mjs";
+import { commonLabProps } from "../../../blocks/lab-block.mjs";
+import { z } from "zod";
+
+//#region src/domains/databases/range-query/manifest.ts
+var manifest_default = defineLab({
+	id: "range-query",
+	domain: "databases",
+	group: "Database foundations",
+	title: "Find a whole range",
+	description: "Compare scan, sorted, and hash access paths for a range query and see why neighboring index entries matter.",
+	schema: z.object({ ...commonLabProps }),
+	taxonomy: {
+		grades: [
+			"10",
+			"11",
+			"12"
+		],
+		outcomes: [
+			"range-query",
+			"sorted-index",
+			"hash-index",
+			"access-paths"
+		],
+		durationMinutes: 7,
+		interaction: "guided",
+		authorability: "simple"
+	},
+	experience: {
+		objectives: [
+			"Distinguish exact lookup from range retrieval",
+			"Explain why sorted indexes preserve neighborhood",
+			"Choose an access path for a workload rather than by headline speed"
+		],
+		phases: [
+			"predict",
+			"act",
+			"observe",
+			"explain",
+			"transfer"
+		],
+		responses: [],
+		accessibility: {
+			keyboard: true,
+			textAlternative: true,
+			reducedMotion: true
+		}
+	},
+	loadRuntime: () => import("./runtime.mjs")
+});
+
+//#endregion
+export { manifest_default as default };

package/dist/domains/databases/range-query/runtime.mjs

@@ -0,0 +1,3 @@
+import { RangeQueryLab } from "../../../databases/foundation/range-query.mjs";
+
+export { RangeQueryLab as default };