@classytic/labs 0.2.0 → 0.3.0

package/dist/domains/activity-map.d.mts

@@ -0,0 +1,9 @@
+import { CompiledAuthoredActivity } from "../kit/activity-authoring.mjs";
+
+//#region src/domains/activity-map.d.ts
+type ActivityPlanLoader = () => Promise<{
+  activity: CompiledAuthoredActivity;
+}>;
+declare const activityPlanLoaders: Record<string, ActivityPlanLoader>;
+//#endregion
+export { ActivityPlanLoader, activityPlanLoaders };

package/dist/domains/activity-map.mjs

@@ -0,0 +1,33 @@
+//#region src/domains/activity-map.ts
+const activityPlanLoaders = {
+	"atomic-orbital": () => import("./chem/atomic-orbital/activity.mjs"),
+	"bloch-sphere": () => import("./physics/bloch-sphere/activity.mjs"),
+	"cell-energy": () => import("./biology/cell-energy/activity.mjs"),
+	"cell-system": () => import("./biology/cell-system/activity.mjs"),
+	"crystal-lattice": () => import("./chem/crystal-lattice/activity.mjs"),
+	"double-slit": () => import("./physics/double-slit/activity.mjs"),
+	"fission-chain": () => import("./physics/fission-chain/activity.mjs"),
+	"geometry-foundations": () => import("./math/geometry-foundations/activity.mjs"),
+	"length-contraction": () => import("./physics/length-contraction/activity.mjs"),
+	"lorentz-transformation": () => import("./physics/lorentz-transformation/activity.mjs"),
+	"measurement": () => import("./math/measurement/activity.mjs"),
+	"meiosis-explorer": () => import("./biology/meiosis-explorer/activity.mjs"),
+	"membrane-transport": () => import("./biology/membrane-transport/activity.mjs"),
+	"mitosis-explorer": () => import("./biology/mitosis-explorer/activity.mjs"),
+	"molecular-geometry": () => import("./chem/molecular-geometry/activity.mjs"),
+	"muon-survival": () => import("./physics/muon-survival/activity.mjs"),
+	"nuclear-binding-energy": () => import("./physics/nuclear-binding-energy/activity.mjs"),
+	"orbital-overlap": () => import("./chem/orbital-overlap/activity.mjs"),
+	"photoelectric-effect": () => import("./physics/photoelectric-effect/activity.mjs"),
+	"quantum-gates": () => import("./physics/quantum-gates/activity.mjs"),
+	"relativity-light-clock": () => import("./physics/relativity-light-clock/activity.mjs"),
+	"relativity-simultaneity": () => import("./physics/relativity-simultaneity/activity.mjs"),
+	"spatial-lorentz": () => import("./physics/spatial-lorentz/activity.mjs"),
+	"stereochemistry": () => import("./chem/stereochemistry/activity.mjs"),
+	"uncertainty-wave-packet": () => import("./physics/uncertainty-wave-packet/activity.mjs"),
+	"xray-attenuation": () => import("./physics/xray-attenuation/activity.mjs"),
+	"xray-tube-spectrum": () => import("./physics/xray-tube-spectrum/activity.mjs")
+};
+
+//#endregion
+export { activityPlanLoaders };

package/dist/domains/biology/cell-energy/activity.mjs

@@ -0,0 +1,3 @@
+import { cellEnergyActivity } from "../../../biology/cell-energy/activity.mjs";
+
+export { cellEnergyActivity as activity };

package/dist/domains/biology/cell-energy/manifest.mjs

@@ -0,0 +1,65 @@
+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/biology/cell-energy/manifest.ts
+var manifest_default = defineLab({
+	id: "cell-energy",
+	tag: "CellEnergyLab",
+	domain: "biology",
+	group: "Cell biology",
+	title: "Cell energy and ATP budget",
+	description: "Connect membrane delivery of glucose and oxygen to mitochondrial ATP production and ATP-consuming cellular work.",
+	schema: z.object({
+		glucose: z.number().min(0).max(10).default(6),
+		oxygen: z.number().min(0).max(10).default(6),
+		demand: z.number().min(0).max(10).default(5),
+		fermentation: z.boolean().default(true),
+		activity: authoredActivitySchema.optional(),
+		...commonLabProps
+	}),
+	taxonomy: {
+		grades: [
+			"10",
+			"11",
+			"12"
+		],
+		outcomes: [
+			"biology",
+			"respiration",
+			"mitochondria",
+			"ATP",
+			"fermentation"
+		],
+		durationMinutes: 20,
+		interaction: "guided",
+		authorability: "moderate",
+		prerequisites: ["membrane-transport", "respiration"],
+		related: ["membrane-transport", "respiration"]
+	},
+	experience: {
+		objectives: [
+			"Connect glucose and oxygen delivery to mitochondrial ATP production",
+			"Identify the limiting respiratory input",
+			"Relate ATP supply to active cellular work"
+		],
+		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/biology/cell-energy/runtime.mjs

@@ -0,0 +1,3 @@
+import { CellEnergyLab } from "../../../biology/cell-energy/preset.mjs";
+
+export { CellEnergyLab, CellEnergyLab as default };

package/dist/domains/biology/cell-system/activity.mjs

@@ -0,0 +1,3 @@
+import { cellSystemActivity } from "../../../biology/cell-system/activity.mjs";
+
+export { cellSystemActivity as activity };

package/dist/domains/biology/cell-system/manifest.mjs

@@ -0,0 +1,81 @@
+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/biology/cell-system/manifest.ts
+var manifest_default = defineLab({
+	id: "cell-system",
+	tag: "CellSystemLab",
+	domain: "biology",
+	group: "Cell biology",
+	title: "Cell systems and protein secretion",
+	description: "Trace a secreted protein through nucleus, ribosome, rough ER, Golgi, vesicle, and membrane; diagnose organelle failures.",
+	schema: z.object({
+		step: z.enum([
+			"nucleus",
+			"ribosome",
+			"rough-er",
+			"golgi",
+			"vesicle",
+			"membrane"
+		]).default("nucleus"),
+		failure: z.enum([
+			"none",
+			"nucleus",
+			"ribosome",
+			"rough-er",
+			"golgi",
+			"vesicle"
+		]).default("none"),
+		activity: authoredActivitySchema.optional(),
+		...commonLabProps
+	}),
+	taxonomy: {
+		grades: [
+			"10",
+			"11",
+			"12"
+		],
+		outcomes: [
+			"biology",
+			"cell",
+			"organelles",
+			"protein-synthesis",
+			"secretion"
+		],
+		durationMinutes: 22,
+		interaction: "guided",
+		authorability: "moderate",
+		prerequisites: ["central-dogma", "membrane-transport"],
+		related: [
+			"central-dogma",
+			"membrane-transport",
+			"cell-energy"
+		]
+	},
+	experience: {
+		objectives: [
+			"Trace information and cargo through organelles",
+			"Explain why secretion follows an ordered route",
+			"Diagnose organelle failure from downstream evidence"
+		],
+		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/biology/cell-system/runtime.mjs

@@ -0,0 +1,3 @@
+import { CellSystemLab } from "../../../biology/cell-system/preset.mjs";
+
+export { CellSystemLab, CellSystemLab as default };

package/dist/domains/biology/central-dogma/manifest.mjs

@@ -0,0 +1,51 @@
+import { defineLab } from "../../../lab-def/define-lab.mjs";
+import { commonLabProps } from "../../../blocks/lab-block.mjs";
+import { z } from "zod";
+
+//#region src/domains/biology/central-dogma/manifest.ts
+var manifest_default = defineLab({
+	id: "central-dogma",
+	domain: "biology",
+	group: "Biology",
+	title: "Central dogma (DNA → mRNA → protein)",
+	description: "The whole flow in one tool: transcribe the DNA template into mRNA (T→U), then translate each 3-base codon into an amino acid. Translation unlocks only once the mRNA is correct, so the dependency is felt. Reuses the genetic-code core.",
+	schema: z.object({
+		dna: z.array(z.string().regex(/^[ATGC]$/)).min(3).max(60).refine((bases) => bases.length % 3 === 0, "DNA length must contain complete codons").optional(),
+		...commonLabProps
+	}),
+	taxonomy: {
+		grades: ["11", "12"],
+		outcomes: [
+			"biology",
+			"molecular-genetics",
+			"central-dogma"
+		],
+		durationMinutes: 15,
+		interaction: "build",
+		authorability: "moderate"
+	},
+	experience: {
+		objectives: [
+			"Transcribe a DNA template into complementary mRNA",
+			"Translate completed mRNA codons into an amino-acid sequence",
+			"Explain why ribosomes read mRNA rather than DNA directly"
+		],
+		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/biology/central-dogma/runtime.mjs

@@ -0,0 +1,5 @@
+'use client';
+
+import { CentralDogmaLab } from "../../../biology/sequence/central-dogma.mjs";
+
+export { CentralDogmaLab as default };

package/dist/domains/biology/enzyme-rate/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/biology/enzyme-rate/manifest.ts
+var manifest_default = defineLab({
+	id: "enzyme-rate",
+	domain: "biology",
+	group: "Biology",
+	title: "Enzyme rate (optimum & denaturation)",
+	description: "Drag temperature (or pH); the rate climbs to an optimum then crashes as the lock-and-key active site is mangled, irreversibly for temperature (cooling won't fix it), reversibly for pH. The bell is built from plotted points.",
+	schema: z.object({
+		factor: z.enum(["temperature", "pH"]).default("temperature"),
+		optimum: z.number().finite().min(.1).max(100).default(40),
+		factorMin: z.number().finite().min(0).max(90).default(0),
+		factorMax: z.number().finite().min(1).max(120).default(80),
+		...commonLabProps
+	}).superRefine((props, context) => {
+		if (props.factorMin >= props.optimum || props.optimum >= props.factorMax) context.addIssue({
+			code: "custom",
+			path: ["optimum"],
+			message: "The optimum must sit strictly inside the factor range"
+		});
+		if (props.factor === "pH" && props.factorMax > 14) context.addIssue({
+			code: "custom",
+			path: ["factorMax"],
+			message: "pH cannot exceed 14"
+		});
+	}),
+	taxonomy: {
+		grades: [
+			"9",
+			"10",
+			"11"
+		],
+		outcomes: [
+			"biology",
+			"enzymes",
+			"denaturation"
+		],
+		durationMinutes: 12,
+		interaction: "explorer",
+		authorability: "moderate"
+	},
+	experience: {
+		objectives: [
+			"Predict how enzyme rate changes around an optimum",
+			"Compare reversible pH disruption with irreversible thermal denaturation",
+			"Explain why cooling a denatured enzyme does not restore its active site"
+		],
+		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/biology/enzyme-rate/runtime.mjs

@@ -0,0 +1,5 @@
+'use client';
+
+import { EnzymeRateLab } from "../../../biology/enzyme-rate/preset.mjs";
+
+export { EnzymeRateLab as default };

package/dist/domains/biology/genetic-cross/manifest.mjs

@@ -0,0 +1,132 @@
+import { defineLab } from "../../../lab-def/define-lab.mjs";
+import { commonLabProps } from "../../../blocks/lab-block.mjs";
+import { z } from "zod";
+
+//#region src/domains/biology/genetic-cross/manifest.ts
+const symbol = z.string().trim().min(1).max(6);
+const safeColor = z.string().regex(/^(#[0-9a-fA-F]{3,8}|var\(--[a-z0-9-]+\))$/);
+const model = z.object({
+	trait: z.string().trim().min(1).max(50).optional(),
+	alleles: z.array(z.object({
+		symbol,
+		rank: z.number().finite().min(-100).max(100),
+		trait: z.string().trim().min(1).max(50)
+	})).min(2).max(6),
+	blends: z.array(z.object({
+		pair: z.tuple([symbol, symbol]),
+		label: z.string().trim().min(1).max(50),
+		color: safeColor.optional()
+	})).max(12).optional(),
+	colors: z.record(z.string().trim().min(1).max(50), safeColor).optional()
+});
+var manifest_default = defineLab({
+	id: "genetic-cross",
+	domain: "biology",
+	group: "Biology",
+	title: "Genetic cross (dominance / codominance / blood groups)",
+	description: "The general cross tool: pick a pattern, simple dominance, ABO blood groups (multiple alleles + codominance → AB), or incomplete dominance (red × white → pink), or author your own allele model. Gametes drop onto the 2×2 grid; genotype + phenotype ratios read off as tally bars. Predict-before-reveal.",
+	schema: z.object({
+		preset: z.enum([
+			"monohybrid",
+			"blood-type",
+			"incomplete",
+			"dihybrid",
+			"custom"
+		]).default("blood-type"),
+		spec: model.optional(),
+		parent1: z.array(symbol).length(2).optional(),
+		parent2: z.array(symbol).length(2).optional(),
+		predictFirst: z.literal(true).default(true),
+		...commonLabProps
+	}).superRefine((props, context) => {
+		if (props.preset === "custom" && !props.spec) context.addIssue({
+			code: "custom",
+			path: ["spec"],
+			message: "Custom crosses require an allele model"
+		});
+		if (props.preset === "dihybrid" && (props.parent1 || props.parent2)) context.addIssue({
+			code: "custom",
+			path: ["parent1"],
+			message: "Dihybrid parent overrides are not supported by this authoring shape"
+		});
+		const allowed = {
+			monohybrid: ["A", "a"],
+			"blood-type": [
+				"A",
+				"B",
+				"O"
+			],
+			incomplete: ["R", "W"]
+		}[props.preset];
+		if (allowed) for (const key of ["parent1", "parent2"]) props[key]?.forEach((value, index) => {
+			if (!allowed.includes(value)) context.addIssue({
+				code: "custom",
+				path: [key, index],
+				message: `Parent alleles for ${props.preset} must be one of ${allowed.join(", ")}`
+			});
+		});
+		if (props.spec) {
+			const symbols = props.spec.alleles.map((allele) => allele.symbol);
+			if (new Set(symbols).size !== symbols.length) context.addIssue({
+				code: "custom",
+				path: ["spec", "alleles"],
+				message: "Allele symbols must be unique"
+			});
+			props.spec.blends?.forEach((blend, index) => blend.pair.forEach((value, pairIndex) => {
+				if (!symbols.includes(value)) context.addIssue({
+					code: "custom",
+					path: [
+						"spec",
+						"blends",
+						index,
+						"pair",
+						pairIndex
+					],
+					message: "Blend pairs must reference declared alleles"
+				});
+			}));
+			for (const key of ["parent1", "parent2"]) props[key]?.forEach((value, index) => {
+				if (!symbols.includes(value)) context.addIssue({
+					code: "custom",
+					path: [key, index],
+					message: "Parent alleles must exist in the custom model"
+				});
+			});
+		}
+	}),
+	taxonomy: {
+		grades: ["11", "12"],
+		outcomes: [
+			"biology",
+			"genetics",
+			"codominance"
+		],
+		durationMinutes: 15,
+		interaction: "predict",
+		authorability: "advanced"
+	},
+	experience: {
+		objectives: [
+			"Predict phenotype ratios before revealing a genetic cross",
+			"Compare dominance, codominance, incomplete dominance, and independent assortment",
+			"Explain offspring ratios by tracing equally likely gamete combinations"
+		],
+		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/biology/genetic-cross/runtime.mjs

@@ -0,0 +1,24 @@
+'use client';
+
+import { CROSS_PRESETS, DIHYBRID_LOCI } from "../../../biology/genetic-cross/core.mjs";
+import { GeneticCrossLab } from "../../../biology/genetic-cross/preset.mjs";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/domains/biology/genetic-cross/runtime.tsx
+function GeneticCross(a) {
+	const preset = a.preset ?? "blood-type";
+	const dihybrid = preset === "dihybrid";
+	return /* @__PURE__ */ jsx(GeneticCrossLab, {
+		spec: dihybrid ? void 0 : preset === "custom" ? a.spec : CROSS_PRESETS[preset],
+		loci: dihybrid ? DIHYBRID_LOCI : void 0,
+		parent1: a.parent1,
+		parent2: a.parent2,
+		predictFirst: a.predictFirst,
+		title: a.title,
+		prompt: a.prompt,
+		objectives: a.objectives
+	});
+}
+
+//#endregion
+export { GeneticCross as default };

package/dist/domains/biology/meiosis-explorer/activity.mjs

@@ -0,0 +1,3 @@
+import { meiosisExplorerActivity } from "../../../biology/cell-division/meiosis-activity.mjs";
+
+export { meiosisExplorerActivity as activity };

package/dist/domains/biology/meiosis-explorer/manifest.mjs

@@ -0,0 +1,71 @@
+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/biology/meiosis-explorer/manifest.ts
+var manifest_default = defineLab({
+	id: "meiosis-explorer",
+	tag: "MeiosisExplorerLab",
+	domain: "biology",
+	group: "Cell biology",
+	title: "Meiosis inheritance explorer",
+	description: "Track homolog pairing, crossing over, independent orientation, and two divisions into four haploid products.",
+	schema: z.object({
+		checkpoint: z.enum([
+			"pairing",
+			"crossing-over",
+			"metaphase-i",
+			"anaphase-i",
+			"metaphase-ii",
+			"products"
+		]).default("pairing"),
+		crossover: z.boolean().default(true),
+		orientation: z.enum(["maternal-left", "paternal-left"]).default("maternal-left"),
+		activity: authoredActivitySchema.optional(),
+		...commonLabProps
+	}),
+	taxonomy: {
+		grades: [
+			"10",
+			"11",
+			"12"
+		],
+		outcomes: [
+			"biology",
+			"cell-division",
+			"meiosis",
+			"inheritance",
+			"variation"
+		],
+		durationMinutes: 20,
+		interaction: "guided",
+		authorability: "moderate",
+		prerequisites: ["mitosis-explorer"],
+		related: ["mitosis-explorer", "punnett-cross"]
+	},
+	experience: {
+		objectives: [
+			"Distinguish homologs from sister chromatids",
+			"Connect crossing over to recombinant chromatids",
+			"Connect independent assortment to product combinations"
+		],
+		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/biology/meiosis-explorer/runtime.mjs

@@ -0,0 +1,3 @@
+import { MeiosisExplorerLab } from "../../../biology/cell-division/meiosis-preset.mjs";
+
+export { MeiosisExplorerLab, MeiosisExplorerLab as default };

package/dist/domains/biology/membrane-transport/activity.mjs

@@ -0,0 +1,3 @@
+import { membraneTransportActivity } from "../../../biology/membrane-transport/activity.mjs";
+
+export { membraneTransportActivity as activity };

package/dist/domains/biology/membrane-transport/manifest.mjs

@@ -0,0 +1,73 @@
+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/biology/membrane-transport/manifest.ts
+var manifest_default = defineLab({
+	id: "membrane-transport",
+	tag: "MembraneTransportLab",
+	domain: "biology",
+	group: "Cell biology",
+	title: "Cell membrane transport",
+	description: "Compare diffusion, facilitated diffusion, osmosis, and active transport across one membrane model.",
+	schema: z.object({
+		mode: z.enum([
+			"diffusion",
+			"facilitated",
+			"osmosis",
+			"active"
+		]).default("diffusion"),
+		outside: z.number().min(0).max(10).default(8),
+		inside: z.number().min(0).max(10).default(2),
+		permeability: z.number().min(0).max(1).default(.8),
+		atp: z.boolean().default(true),
+		activity: authoredActivitySchema.optional(),
+		...commonLabProps
+	}),
+	taxonomy: {
+		grades: [
+			"9",
+			"10",
+			"11",
+			"12"
+		],
+		outcomes: [
+			"biology",
+			"cell",
+			"membrane",
+			"diffusion",
+			"osmosis",
+			"active-transport"
+		],
+		durationMinutes: 18,
+		interaction: "guided",
+		authorability: "moderate",
+		prerequisites: [],
+		related: ["mitosis-explorer"]
+	},
+	experience: {
+		objectives: [
+			"Use concentration gradients to predict net movement",
+			"Distinguish channels from pumps",
+			"Explain osmosis as net water movement"
+		],
+		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/biology/membrane-transport/runtime.mjs

@@ -0,0 +1,3 @@
+import { MembraneTransportLab } from "../../../biology/membrane-transport/preset.mjs";
+
+export { MembraneTransportLab, MembraneTransportLab as default };

package/dist/domains/biology/mitosis-explorer/activity.mjs

@@ -0,0 +1,3 @@
+import { mitosisExplorerActivity } from "../../../biology/cell-division/activity.mjs";
+
+export { mitosisExplorerActivity as activity };