@classytic/labs 0.2.0 → 0.4.0

package/dist/blocks/index.mjs

@@ -1,120 +1,22 @@
 import { coerceArray } from "./authoring.mjs";
-import { LabConfig } from "./lab-config.mjs";
-import { 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 } from "./physics.mjs";
-import { AreaModelBlock, BalanceAlgebraBlock, CircleBlock, ComplexPlaneBlock, ConicBlock, CustomSceneBlock, DerivationBlock, DerivativeExplorerBlock, DomainRangeBlock, FractionBarBlock, GeoTransformBlock, GradientDescentBlock, GraphBlock, GrowingPatternBlock, IntegralExplorerBlock, InteractiveProblemBlock, LimitExplorerBlock, LinearModelBlock, LinearSystemBlock, LinearSystemView, MysteryBucketBlock, NumberLineBlock, PercentBarBlock, PolynomialSolverBlock, RateMachineBlock, RatioShareBlock, ReceiptBlock, SequencePredictBlock, StraightLineBlock, SystemSolveBlock, TriangleTrigBlock, TrigExplorerBlock, TrigSignsBlock, VertexParabolaBlock, mathBlocks, mathComponents } from "./math.mjs";
-import { BatteryBlock, BohrAtomBlock, DilutionBlock, ElectrochemBlock, GasBoxBlock, KineticsBlock, LeChatelierBlock, PeriodicTrendsBlock, ReactionLabBlock, ReactionProfileBlock, SolutionBoxBlock, StoichiometryBlock, TitrationBlock, chemBlocks, chemComponents } from "./chem.mjs";
-import { BjtInsideBlock, BrownoutBlock, CapacitorLeakBlock, CircuitBlock, CircuitBuilderBlock, CircuitLabBlock, CircuitPuzzle, CircuitSceneBlock, CircuitSceneView, CmosInverterBlock, CmosNandBlock, CmosNorBlock, ConductionBlock, DiodeBlock, HallEffectBlock, MosfetInsideBlock, PnJunctionBlock, RCChargingBlock, RNmosNotBlock, SiliconLatticeBlock, TransistorBlock, circuitsBlocks, circuitsComponents } from "./circuits.mjs";
-import { GeometryBoardBlock, IntersectingCirclesBlock, geometryBlocks, geometryComponents } from "./geometry.mjs";
-import { BaseOdometerBlock, BinaryDisplayBlock, BitGrouperBlock, LogicBuilderBlock, LogicGateBlock, PlaceValueDialBlock, ictBlocks, ictComponents } from "./ict.mjs";
-import { AgreementBlock, ArticleLensBlock, PrepositionBlock, SentenceBuilderBlock, TransformBlock, WordMatchBlock, languageBlocks, languageComponents } from "./language.mjs";
-import { EquationBalanceBlock, JournalPosterBlock, StatementSorterBlock, accountingBlocks, accountingComponents } from "./accounting.mjs";
-import { DemandShiftVsMoveBlock, ElasticityRevenueBlock, MarketEquilibriumBlock, economicsBlocks, economicsComponents } from "./economics.mjs";
-import { CentralDogmaBlock, EnzymeRateBlock, GeneticCrossBlock, PhotosynthesisFactorsBlock, PunnettCrossBlock, RespirationBlock, SequenceBlock, SexLinkedCrossBlock, biologyBlocks, biologyComponents } from "./biology.mjs";
-import { CycleBlock, geographyBlocks, geographyComponents } from "./geography.mjs";
-import { ClassifierThresholdBlock, DecisionBoundaryBlock, KMeansBlock, KnnBoundaryBlock, RegressionBlock, mlBlocks, mlComponents } from "./ml.mjs";
-import { ArrangementsBlock, BayesBlock, BinomialBlock, BooleanCircuitBlock, CombinationStudioBlock, CountingSlotsBlock, CountingTreeBlock, ExpectedValueBlock, HypergeometricBlock, KarnaughBlock, LawOfLargeNumbersBlock, MonteCarloBlock, MontyHallBlock, OutcomeBuilderBlock, PascalBlock, RuleCardBlock, SampleSpaceBlock, SelectionBlock, TruthTableBlock, VennBlock, discreteBlocks, discreteComponents } from "./discrete.mjs";
-import { CenterSpreadBlock, GaltonBlock, HistogramBlock, NormalBlock, SamplingBlock, SeriesBlock, ZTableBlock, statisticsBlocks, statisticsComponents } from "./statistics.mjs";
 import { PredictBlock, PredictWidget, lessonBlocks, lessonComponents } from "./lesson.mjs";
-import { LabGallery } from "./lab-gallery.mjs";
+import { LabConfig } from "./lab-config.mjs";
+import { parseAuthoredAttrs, parseAuthoredValue } from "../lab-def/attrs.mjs";
+import { manifestComponents } from "../domains/render.mjs";
+import { manifestBlocks } from "../domains/blocks.mjs";
+import { labCatalog } from "./catalog.mjs";
+import { lazyLabBlocks } from "./lazy.mjs";
 
 //#region src/blocks/index.tsx
 /** Every lab block, pass to `<CmsBlockEditor blocks={labsBlocks}>` (slash menu). */
-const labsBlocks = [
-	...lessonBlocks,
-	...languageBlocks,
-	...physicsBlocks,
-	...mathBlocks,
-	...chemBlocks,
-	...circuitsBlocks,
-	...geometryBlocks,
-	...ictBlocks,
-	...accountingBlocks,
-	...economicsBlocks,
-	...biologyBlocks,
-	...geographyBlocks,
-	...mlBlocks,
-	...discreteBlocks,
-	...statisticsBlocks
-];
+const labsBlocks = [...manifestBlocks, ...lessonBlocks];
 /** MDX render map, merge into the host's `blockComponents` (tag → component).
 *  Tags match each block's `tag` so editor + player render the same component.
 *  Tags are unique across domains, so spread order is irrelevant. */
 const labsComponents = {
 	...lessonComponents,
-	...languageComponents,
-	...physicsComponents,
-	...mathComponents,
-	...chemComponents,
-	...circuitsComponents,
-	...geometryComponents,
-	...ictComponents,
-	...accountingComponents,
-	...economicsComponents,
-	...biologyComponents,
-	...geographyComponents,
-	...mlComponents,
-	...discreteComponents,
-	...statisticsComponents
+	...manifestComponents
 };
-/** Every lab tagged with its subject group, for `<LabGallery blocks={labGalleryItems}>`. */
-const labGalleryItems = [
-	...mathBlocks.map((b) => ({
-		...b,
-		group: "Math"
-	})),
-	...physicsBlocks.map((b) => ({
-		...b,
-		group: "Physics"
-	})),
-	...chemBlocks.map((b) => ({
-		...b,
-		group: "Chemistry"
-	})),
-	...biologyBlocks.map((b) => ({
-		...b,
-		group: "Biology"
-	})),
-	...circuitsBlocks.map((b) => ({
-		...b,
-		group: "Circuits"
-	})),
-	...geometryBlocks.map((b) => ({
-		...b,
-		group: "Geometry"
-	})),
-	...discreteBlocks.map((b) => ({
-		...b,
-		group: "Discrete"
-	})),
-	...statisticsBlocks.map((b) => ({
-		...b,
-		group: "Statistics"
-	})),
-	...ictBlocks.map((b) => ({
-		...b,
-		group: "ICT"
-	})),
-	...languageBlocks.map((b) => ({
-		...b,
-		group: "Language"
-	})),
-	...accountingBlocks.map((b) => ({
-		...b,
-		group: "Accounting"
-	})),
-	...economicsBlocks.map((b) => ({
-		...b,
-		group: "Economics"
-	})),
-	...geographyBlocks.map((b) => ({
-		...b,
-		group: "Geography"
-	})),
-	...mlBlocks.map((b) => ({
-		...b,
-		group: "Machine learning"
-	}))
-];
 
 //#endregion
-export { AgreementBlock, AreaModelBlock, ArrangementsBlock, ArticleLensBlock, AtwoodBlock, BalanceAlgebraBlock, BaseOdometerBlock, BatteryBlock, BayesBlock, BinaryDisplayBlock, BinomialBlock, BitGrouperBlock, BjtInsideBlock, BohrAtomBlock, BooleanCircuitBlock, BrownoutBlock, BulletWallsBlock, CapacitorLeakBlock, CarnotBlock, CenterSpreadBlock, CentralDogmaBlock, CircleBlock, CircuitBlock, CircuitBuilderBlock, CircuitLabBlock, CircuitPuzzle, CircuitSceneBlock, CircuitSceneView, CircularMotionBlock, ClassifierThresholdBlock, CmosInverterBlock, CmosNandBlock, CmosNorBlock, CollisionTrackBlock, CombinationStudioBlock, ComplexPlaneBlock, ConductionBlock, ConicBlock, CountingSlotsBlock, CountingTreeBlock, CustomSceneBlock, CycleBlock, DecisionBoundaryBlock, DemandShiftVsMoveBlock, DerivationBlock, DerivativeExplorerBlock, DilutionBlock, DiodeBlock, DomainRangeBlock, DopplerBlock, EfficiencyBlock, ElasticityRevenueBlock, ElectricFieldBlock, ElectricFluxBlock, ElectrochemBlock, EnergySkateBlock, EntropyBlock, EnzymeRateBlock, EquationBalanceBlock, ExpectedValueBlock, FractionBarBlock, GaltonBlock, GasBoxBlock, GasProcessBlock, GaussLawBlock, GeneticCrossBlock, GeoTransformBlock, GeometryBoardBlock, GradientDescentBlock, GraphBlock, GravitationBlock, GravityDropBlock, GrowingPatternBlock, HallEffectBlock, HeatTransferBlock, HeatingCurveBlock, HistogramBlock, HypergeometricBlock, ImpulseBlock, IntegralExplorerBlock, InteractiveProblemBlock, IntersectingCirclesBlock, JournalPosterBlock, KMeansBlock, KarnaughBlock, KeplerBlock, KineticsBlock, KnnBoundaryBlock, LabConfig, LabGallery, LawOfLargeNumbersBlock, LeChatelierBlock, LeverBlock, LeverPuzzle, LimitExplorerBlock, LinearModelBlock, LinearSystemBlock, LinearSystemView, LogicBuilderBlock, LogicGateBlock, LorentzBlock, MagnetismBlock, MarketEquilibriumBlock, MonteCarloBlock, MontyHallBlock, MosfetInsideBlock, MysteryBucketBlock, NormalBlock, NumberLineBlock, OpticsBlock, OrbitLabBlock, OutcomeBuilderBlock, PascalBlock, PercentBarBlock, PeriodicTrendsBlock, PhotosynthesisFactorsBlock, PlaceValueDialBlock, PnJunctionBlock, PolynomialSolverBlock, PredictBlock, PredictWidget, PrepositionBlock, ProjectileLabBlock, PunnettCrossBlock, RCChargingBlock, RNmosNotBlock, RainRelativeBlock, RampForcesBlock, RateMachineBlock, RatioShareBlock, ReactionLabBlock, ReactionProfileBlock, ReceiptBlock, RegressionBlock, RespirationBlock, RippleTankBlock, RiverBoatBlock, RuleCardBlock, SampleSpaceBlock, SamplingBlock, SelectionBlock, SentenceBuilderBlock, SequenceBlock, SequencePredictBlock, SeriesBlock, SexLinkedCrossBlock, SiliconLatticeBlock, SimpleHarmonicBlock, SolutionBoxBlock, StatementSorterBlock, StoichiometryBlock, StoppingDistanceBlock, StraightLineBlock, StringReflectionBlock, SystemSolveBlock, TemperatureScalesBlock, TerminalVelocityBlock, ThermalExpansionBlock, TitrationBlock, TransformBlock, TransistorBlock, TriangleTrigBlock, TrigExplorerBlock, TrigSignsBlock, TruthTableBlock, VectorBoardBlock, VectorTypesBlock, VennBlock, VertexParabolaBlock, WaterDensityBlock, WaveBlock, WordMatchBlock, WorkEnergyBlock, WorkPotentialBlock, ZTableBlock, accountingBlocks, accountingComponents, biologyBlocks, biologyComponents, chemBlocks, chemComponents, circuitsBlocks, circuitsComponents, coerceArray, discreteBlocks, discreteComponents, economicsBlocks, economicsComponents, geographyBlocks, geographyComponents, geometryBlocks, geometryComponents, ictBlocks, ictComponents, labGalleryItems, labsBlocks, labsComponents, languageBlocks, languageComponents, lessonBlocks, lessonComponents, mathBlocks, mathComponents, mlBlocks, mlComponents, physicsBlocks, physicsComponents, statisticsBlocks, statisticsComponents };
+export { LabConfig, PredictBlock, PredictWidget, coerceArray, labCatalog, labsBlocks, labsComponents, lazyLabBlocks, lessonBlocks, lessonComponents, parseAuthoredAttrs, parseAuthoredValue };

package/dist/blocks/lab-block.mjs

@@ -1,6 +1,5 @@
 'use client';
 
-import { LabConfig } from "./lab-config.mjs";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { z } from "zod";
 import { defineBlock } from "@classytic/cms-ui/contract";
@@ -25,50 +24,23 @@ import { defineBlock } from "@classytic/cms-ui/contract";
 const commonLabProps = {
 	title: z.string().optional(),
 	prompt: z.string().optional(),
+	mission: z.string().optional().describe("the learner-facing mission; overrides prompt when set"),
 	objectives: z.array(z.string()).optional(),
 	hints: z.array(z.string()).optional(),
-	controlId: z.string().optional()
+	controlId: z.string().optional(),
+	/**
+	* Narrow a multi-mode lab to the one setup this lesson is about: hide or lock named controls.
+	* A teacher covering Boyle's law locks temperature so the class varies pressure and volume and
+	* nothing else, out of the same lab that elsewhere teaches all three.
+	*
+	* Applied by LabRuntime around every lab, so it works whether or not the component declares the
+	* prop. Before it lived here, 18 of 296 labs could be focused this way.
+	*/
+	controlConfig: z.object({
+		hide: z.array(z.string()).optional(),
+		lock: z.array(z.string()).optional()
+	}).optional().describe("hide or lock named controls to focus the lab on one idea")
 };
-/** PascalCase MDX tag from a kebab key, mirrors `defineBlock`'s default, for building a components map. */
-const pascalTag = (key) => key.split("-").map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("");
-function labBlock({ key, label, description, schema, Component, tag, omit }) {
-	const block = defineBlock({
-		key,
-		void: true,
-		...tag ? { tag } : {},
-		label,
-		description,
-		category: "interactive",
-		schema,
-		Component: ({ attributes, mode, updateAttributes }) => {
-			const widget = Component(attributes);
-			if (mode !== "editing" || !updateAttributes) return widget;
-			return /* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx(LabConfig, {
-				schema,
-				value: attributes,
-				onChange: updateAttributes,
-				omit
-			}), widget] });
-		}
-	});
-	return Object.assign(block, {
-		tag: tag ?? pascalTag(key),
-		lab: Component
-	});
-}
-/**
-* Derive the tag→component MDX render map from a domain's blocks, ONE source of truth.
-* Only `labBlock`-created blocks carry `.lab`; bespoke `defineBlock` blocks (custom editor
-* UI) are merged into the map by hand alongside this.
-*/
-function buildComponents(blocks) {
-	const map = {};
-	for (const b of blocks) {
-		const lb = b;
-		if (typeof lb.tag === "string" && typeof lb.lab === "function") map[lb.tag] = lb.lab;
-	}
-	return map;
-}
 
 //#endregion
-export { buildComponents, commonLabProps, labBlock };
+export { commonLabProps };

package/dist/blocks/lab-config.d.mts

@@ -1,6 +1,5 @@
 import { ReactNode } from "react";
 import { z } from "zod";
-
 //#region src/blocks/lab-config.d.ts
 interface LabConfigProps {
   schema: z.ZodType;
@@ -12,12 +11,6 @@ interface LabConfigProps {
   /** Internal: nested objects render without re-wrapping in a ConfigPanel. */
   flat?: boolean;
 }
-declare function LabConfig({
-  schema,
-  value,
-  onChange,
-  omit,
-  flat
-}: LabConfigProps): ReactNode;
+declare function LabConfig({ schema, value, onChange, omit, flat }: LabConfigProps): ReactNode;
 //#endregion
 export { LabConfig, LabConfigProps };

package/dist/blocks/lab-config.mjs

@@ -1,7 +1,8 @@
 'use client';
 
 import { ChipToggle, ConfigPanel, ConfigRow, JsonArea, NumField, RowsEditor, TagsField, TextField } from "./authoring.mjs";
-import { Fragment, jsx } from "react/jsx-runtime";
+import { useId } from "react";
+import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
 import { z } from "zod";
 
 //#region src/blocks/lab-config.tsx
@@ -42,7 +43,7 @@ function elementOf(arr) {
 	const a = arr;
 	return a.element ?? a.def?.element ?? a.def?.type ?? null;
 }
-const GROW_KEYS = new Set([
+const GROW_KEYS = /* @__PURE__ */ new Set([
 	"name",
 	"label",
 	"prompt",
@@ -81,7 +82,52 @@ function columnsFor(obj) {
 	}
 	return cols.length ? cols : null;
 }
+/** The `.describe()` text of a field, looking through optional/default wrappers. */
+function hintOf(field, base) {
+	return field.description ?? base.description;
+}
+/** Best-effort min/max (+ int step) off a ZodNumber, across zod versions. */
+function numConstraints(base) {
+	const out = {};
+	try {
+		const b = base;
+		if (typeof b.minValue === "number") out.min = b.minValue;
+		if (typeof b.maxValue === "number") out.max = b.maxValue;
+		const checks = b.def?.checks ?? b._def?.checks ?? [];
+		for (const c of checks) {
+			const kind = c?.kind ?? c?.check ?? c?.format;
+			if (kind === "int" || kind === "safeint") out.step = 1;
+		}
+	} catch {}
+	return out;
+}
 /** A blank record matching a ZodObject (for RowsEditor's "+ row"). */
+/**
+* The `.default(...)` a field carries, if any.
+*
+* Used to seed the raw-JSON fallback. A block inserts with NO attributes, so a nested-array prop
+* would otherwise open as `[]` and the author has to type the whole structure from memory. The
+* schema already holds a worked example: showing it is the difference between an editable
+* starting point and a blank box.
+*/
+function defaultOf(field) {
+	let s = field;
+	for (let i = 0; i < 8; i++) {
+		if (s instanceof z.ZodDefault) {
+			const get = s.def.defaultValue;
+			try {
+				return typeof get === "function" ? get() : get;
+			} catch {
+				return;
+			}
+		}
+		if (s instanceof z.ZodOptional || s instanceof z.ZodNullable) {
+			s = s.unwrap();
+			continue;
+		}
+		break;
+	}
+}
 function blankFor(obj) {
 	const r = {};
 	for (const [k, f] of Object.entries(obj.shape)) {
@@ -91,60 +137,85 @@ function blankFor(obj) {
 	return r;
 }
 function LabConfig({ schema, value, onChange, omit = [], flat = false }) {
+	const uid = useId();
 	if (!(schema instanceof z.ZodObject)) return /* @__PURE__ */ jsx(JsonArea, {
 		value,
 		onChange: (v) => onChange(v)
 	});
 	const shape = schema.shape;
 	const set = (k, v) => onChange({ [k]: v });
+	const parsed = schema.safeParse(value ?? {});
+	const errors = {};
+	if (!parsed.success) for (const issue of parsed.error.issues) {
+		const k = String(issue.path[0] ?? "");
+		if (k && !(k in errors)) errors[k] = issue.message;
+	}
 	const rows = Object.entries(shape).filter(([k]) => !omit.includes(k)).map(([key, field]) => {
 		const base = baseOf(field);
 		const cur = value?.[key];
-		if (base instanceof z.ZodString) return /* @__PURE__ */ jsx(ConfigRow, {
+		const err = errors[key];
+		const hint = hintOf(field, base);
+		const errId = err ? `${uid}-${key}-err` : void 0;
+		const rowProps = {
 			label: key,
+			hint,
+			error: err,
+			errorId: errId
+		};
+		if (base instanceof z.ZodString) return /* @__PURE__ */ jsx(ConfigRow, {
+			...rowProps,
 			children: /* @__PURE__ */ jsx(TextField, {
 				value: cur ?? "",
 				onChange: (v) => set(key, v),
-				className: "flex-1"
-			})
-		}, key);
-		if (base instanceof z.ZodNumber) return /* @__PURE__ */ jsx(ConfigRow, {
-			label: key,
-			children: /* @__PURE__ */ jsx(NumField, {
-				value: cur ?? 0,
-				onChange: (v) => set(key, v)
+				className: "flex-1",
+				invalid: !!err,
+				describedBy: errId
 			})
 		}, key);
+		if (base instanceof z.ZodNumber) {
+			const c = numConstraints(base);
+			return /* @__PURE__ */ jsx(ConfigRow, {
+				...rowProps,
+				children: /* @__PURE__ */ jsx(NumField, {
+					value: cur ?? 0,
+					onChange: (v) => set(key, v),
+					invalid: !!err,
+					describedBy: errId,
+					min: c.min,
+					max: c.max,
+					step: c.step
+				})
+			}, key);
+		}
 		if (base instanceof z.ZodBoolean) return /* @__PURE__ */ jsx(ConfigRow, {
-			label: key,
+			...rowProps,
 			children: /* @__PURE__ */ jsx(ChipToggle, {
 				active: !!cur,
 				onClick: () => set(key, !cur),
 				children: key
 			})
 		}, key);
-		if (base instanceof z.ZodEnum) return /* @__PURE__ */ jsx(ConfigRow, {
-			label: key,
-			children: /* @__PURE__ */ jsx("span", {
-				style: {
-					display: "inline-flex",
-					gap: 6,
-					flexWrap: "wrap"
-				},
-				children: (base.options ?? []).map((o) => /* @__PURE__ */ jsx(ChipToggle, {
-					active: cur === o,
-					onClick: () => set(key, o),
-					children: o
-				}, o))
-			})
-		}, key);
+		if (base instanceof z.ZodEnum) {
+			const opts = base.options ?? [];
+			return /* @__PURE__ */ jsx(ConfigRow, {
+				...rowProps,
+				children: /* @__PURE__ */ jsx("span", {
+					className: "lab-config-options",
+					children: opts.map((o) => /* @__PURE__ */ jsx(ChipToggle, {
+						active: cur === o,
+						onClick: () => set(key, o),
+						children: o
+					}, o))
+				})
+			}, key);
+		}
 		if (base instanceof z.ZodArray) {
 			const el = elementOf(base);
 			const elBase = el ? baseOf(el) : null;
 			if (elBase instanceof z.ZodObject) {
 				const cols = columnsFor(elBase);
 				if (cols) return /* @__PURE__ */ jsx(ConfigRow, {
-					label: key,
+					...rowProps,
 					children: /* @__PURE__ */ jsx(RowsEditor, {
 						rows: Array.isArray(cur) ? cur : [],
 						columns: cols,
@@ -155,7 +226,7 @@ function LabConfig({ schema, value, onChange, omit = [], flat = false }) {
 				}, key);
 			}
 			if (elBase instanceof z.ZodString) return /* @__PURE__ */ jsx(ConfigRow, {
-				label: key,
+				...rowProps,
 				children: /* @__PURE__ */ jsx(TagsField, {
 					value: Array.isArray(cur) ? cur : [],
 					onChange: (v) => set(key, v),
@@ -164,14 +235,17 @@ function LabConfig({ schema, value, onChange, omit = [], flat = false }) {
 			}, key);
 			return /* @__PURE__ */ jsx(ConfigRow, {
 				label: `${key} (advanced)`,
+				hint,
+				error: err,
+				errorId: errId,
 				children: /* @__PURE__ */ jsx(JsonArea, {
-					value: cur ?? [],
+					value: cur ?? defaultOf(field) ?? [],
 					onChange: (v) => set(key, v)
 				})
 			}, key);
 		}
 		if (base instanceof z.ZodObject) return /* @__PURE__ */ jsx(ConfigRow, {
-			label: key,
+			...rowProps,
 			children: /* @__PURE__ */ jsx("span", {
 				className: "w-full rounded-md border border-border/60 bg-background/40 p-1.5",
 				children: /* @__PURE__ */ jsx(LabConfig, {
@@ -187,13 +261,16 @@ function LabConfig({ schema, value, onChange, omit = [], flat = false }) {
 		}, key);
 		return /* @__PURE__ */ jsx(ConfigRow, {
 			label: `${key} (advanced)`,
+			hint,
+			error: err,
+			errorId: errId,
 			children: /* @__PURE__ */ jsx(JsonArea, {
 				value: cur ?? null,
 				onChange: (v) => set(key, v)
 			})
 		}, key);
 	});
-	return flat ? /* @__PURE__ */ jsx(Fragment, { children: rows }) : /* @__PURE__ */ jsx(ConfigPanel, { children: rows });
+	return flat ? /* @__PURE__ */ jsx(Fragment$1, { children: rows }) : /* @__PURE__ */ jsx(ConfigPanel, { children: rows });
 }
 
 //#endregion

package/dist/blocks/lazy-resolve.d.mts

@@ -0,0 +1,16 @@
+import { LabDomain } from "./catalog.mjs";
+import { ReactNode } from "react";
+//#region src/blocks/lazy-resolve.d.ts
+interface LazyLabProps {
+  domain?: LabDomain;
+  blockKey: string;
+  fallback?: ReactNode;
+  attributes: Record<string, unknown>;
+  mode?: string;
+  updateAttributes?: (patch: Record<string, unknown>) => void;
+  children?: ReactNode;
+}
+/** Resolve exclusively through the per-lab manifest registry. */
+declare function LazyLab({ blockKey, attributes }: LazyLabProps): ReactNode;
+//#endregion
+export { LazyLab, LazyLabProps };

package/dist/blocks/lazy-resolve.mjs

@@ -0,0 +1,24 @@
+'use client';
+
+import { manifestComponentsByKey } from "../domains/render.mjs";
+import { createElement } from "react";
+import { jsxs } from "react/jsx-runtime";
+
+//#region src/blocks/lazy-resolve.tsx
+/** Resolve exclusively through the per-lab manifest registry. */
+function LazyLab({ blockKey, attributes }) {
+	const Component = manifestComponentsByKey[blockKey];
+	if (Component) return createElement(Component, attributes);
+	return /* @__PURE__ */ jsxs("div", {
+		role: "alert",
+		className: "lab-load-error",
+		children: [
+			"Unknown lab “",
+			blockKey,
+			"”. Regenerate the manifest registry."
+		]
+	});
+}
+
+//#endregion
+export { LazyLab };

package/dist/blocks/lazy.d.mts

@@ -0,0 +1,8 @@
+import { LabCatalogEntry, LabDomain, labCatalog } from "./catalog.mjs";
+import { LazyLab, LazyLabProps } from "./lazy-resolve.mjs";
+import { CmsBlock } from "@classytic/cms-ui/contract";
+//#region src/blocks/lazy.d.ts
+/** Every real-schema lab block for compatibility with aggregate editors. */
+declare const lazyLabBlocks: readonly CmsBlock[];
+//#endregion
+export { type LabCatalogEntry, type LabDomain, LazyLab, type LazyLabProps, labCatalog, lazyLabBlocks };

package/dist/blocks/lazy.mjs

@@ -0,0 +1,12 @@
+'use client';
+
+import { manifestBlocks } from "../domains/blocks.mjs";
+import { labCatalog } from "./catalog.mjs";
+import { LazyLab } from "./lazy-resolve.mjs";
+
+//#region src/blocks/lazy.tsx
+/** Every real-schema lab block for compatibility with aggregate editors. */
+const lazyLabBlocks = manifestBlocks;
+
+//#endregion
+export { LazyLab, labCatalog, lazyLabBlocks };

package/dist/blocks/lesson.d.mts

@@ -1,18 +1,12 @@
 import { ReactNode } from "react";
 import { z } from "zod";
-
 //#region src/blocks/lesson.d.ts
 interface Choice {
   label: string;
   correct: boolean;
 }
 /** Render a predict-first question and report completion when answered correctly. */
-declare function PredictWidget({
-  prompt,
-  choices,
-  explain,
-  title
-}: {
+declare function PredictWidget({ prompt, choices, explain, title }: {
   prompt?: string;
   choices?: Choice[];
   explain?: string;

package/dist/blocks/lesson.mjs

@@ -10,7 +10,7 @@ import { defineBlock } from "@classytic/cms-ui/contract";
 /**
 * @classytic/labs/blocks, lesson / pedagogy blocks (domain-neutral).
 *
-* `PredictBlock` is the missing primitive that lets a CREATOR, not a developer , 
+* `PredictBlock` is the missing primitive that lets a CREATOR, not a developer ,
 * author a predict-first lesson: a multiple-choice question the learner commits to
 * before the reveal. A correct pick shows the "why" and reports completion through
 * the learner/step seam, so dropping one between or after any lab turns a sequence
@@ -32,17 +32,18 @@ const DEFAULT_CHOICES = [{
 function PredictWidget({ prompt, choices, explain, title }) {
 	const list = Array.isArray(choices) && choices.length ? choices : DEFAULT_CHOICES;
 	const answerIdx = Math.max(0, list.findIndex((c) => c.correct));
+	const q = {
+		id: "q",
+		prompt: prompt ?? "What do you predict?",
+		choices: list.map((c, i) => ({
+			value: String(i),
+			label: c.label
+		})),
+		answer: String(answerIdx),
+		explain
+	};
 	return /* @__PURE__ */ jsx(PredictRunner, {
-		q: {
-			id: "q",
-			prompt: prompt ?? "What do you predict?",
-			choices: list.map((c, i) => ({
-				value: String(i),
-				label: c.label
-			})),
-			answer: String(answerIdx),
-			explain
-		},
+		q,
 		title
 	});
 }

package/dist/blocks/resolve.d.mts

@@ -0,0 +1,2 @@
+import { LazyLab, LazyLabProps } from "./lazy-resolve.mjs";
+export { LazyLab, type LazyLabProps };

package/dist/blocks/resolve.mjs

@@ -0,0 +1,5 @@
+'use client';
+
+import { LazyLab } from "./lazy-resolve.mjs";
+
+export { LazyLab };

package/dist/build/CircuitEditor.d.mts

@@ -1,14 +1,10 @@
 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;
+declare function CircuitEditor({ value, onChange }: CircuitEditorProps): ReactNode;
 //#endregion
 export { CircuitEditor, CircuitEditorProps };