@bettercms-ai/kit 0.1.1 → 2.0.0

package/dist/engine/schema-form.d.ts

@@ -0,0 +1,116 @@
+/**
+ * <SchemaForm> — the BetterCMS Block Kit form engine (V2 HEAD 9829bf1 kit/engine/schema-form.tsx). One schema in, one
+ * value out; renders through the shared field chrome; owns validation visibility, per-field undo + history (coalesced
+ * 900ms, 50 steps), the published baseline (changed dots, Reset to published) and the navigation path.
+ *
+ *   <SchemaForm schema={faq} value={v} onChange={setV} variant="panel" />
+ *
+ * `path` is controllable so a canvas can sync selection <-> breadcrumb both ways. Frames (root, drilled object, array
+ * item, slot block, button, history) come from lib/frames `resolveFrames`; the drill-in stage, crumbs and keys
+ * (Esc / Alt+Up/Down) from frame.tsx and breadcrumb.tsx; the layout of each frame from grouping.tsx through field-list.
+ *
+ * The host provides the kit scope (`data-kit-scope`) around the form; the form never declares one of its own, so a
+ * dark host scope is never reset to light inside it.
+ */
+import * as React from "react";
+import type { FieldPath, FieldSchema, TypeSchema } from "../schema/types";
+import { type KitEnv, type KitPeer, type Swatch } from "../context";
+import { type KitIssue } from "../lib/validate";
+import { type KitCrumb } from "./breadcrumb";
+export interface SchemaFormProps {
+    schema: TypeSchema;
+    value: Record<string, unknown>;
+    onChange: (value: Record<string, unknown>) => void;
+    /** controlled navigation path ([] = root). Omit for uncontrolled. */
+    path?: FieldPath;
+    defaultPath?: FieldPath;
+    onPathChange?: (path: FieldPath) => void;
+    /** "panel" = 320–420px inspector; "document" = the wide document editor column */
+    variant?: "panel" | "document";
+    /** resolve a block type (slot children) to its schema */
+    resolveSchema?: (blockType: string) => TypeSchema | undefined;
+    /** blocks offered by "+ Add block" (filtered by each slot's allow list) */
+    blockLibrary?: TypeSchema[];
+    /** the published version: enables changed dots and "Reset to published" */
+    published?: Record<string, unknown>;
+    /**
+     * Component instance (CPO D28): values come from `from` unless a top-level key is in `overridden`. Overridden fields
+     * get an accent dot + "Reset"; inherited ones read muted. `onReset(key)` drops one override.
+     */
+    inherited?: {
+        from: string;
+        overridden: string[];
+        onReset: (key: string) => void;
+    };
+    /** pathKey → teammates in that field ("items.1.answer") */
+    presence?: Record<string, KitPeer | KitPeer[]>;
+    /** pathKey → open comment threads */
+    comments?: Record<string, number>;
+    /** host comment system. When set, the field comment chip opens the host's popover/panel instead of the kit's. */
+    onComment?: KitEnv["onComment"];
+    /** "Open {title}" on a reference: the host opens the referenced entry (e.g. a stacked panel) */
+    onOpenReference?: KitEnv["onOpenReference"];
+    /** D61: the host's Review changes markers (while its History panel is open) */
+    review?: KitEnv["review"];
+    /** the whole form is read-only for the lens (fields with their own `access.edit` still follow `env.can`) */
+    readOnly?: boolean;
+    /** validate everything now (after a publish attempt) */
+    showErrors?: boolean;
+    /** document identity + site context */
+    env?: {
+        docId?: string;
+        docTitle?: string;
+        urlPrefix?: string;
+        isPublished?: boolean;
+        /** the slug is the document's address (KitEnv.slugIsAddress) */
+        slugIsAddress?: boolean;
+        palette?: Swatch[];
+        syncedFrom?: string;
+        /** D58: the host's access check (`useCan` at the host). Omitted → allow-all (staff tools, demos). */
+        can?: KitEnv["can"];
+        /** CPO D39: "tooltip" moves help lines behind the ⓘ (dense hosts) */
+        helpDisplay?: KitEnv["helpDisplay"];
+        /** "quiet" field chrome for meta-forms (see `KitEnv.fieldChrome`) */
+        fieldChrome?: KitEnv["fieldChrome"];
+        /** the host's own controls by path key (see `KitEnv.controls`); keep it stable */
+        controls?: KitEnv["controls"];
+        /** the host's chip summary for collapsed fieldsets (see `KitEnv.sectionSummary`); keep it stable */
+        sectionSummary?: KitEnv["sectionSummary"];
+    };
+    /**
+     * Issues the host computes itself (a live check the schema can't express), merged with the form's own. A host issue on a
+     * path the form already flags is dropped; `live` ones show while typing; `fix` adds one action after the message.
+     */
+    extraIssues?: KitIssue[];
+    /** The host's access check (V2 `KitEnv.can`), the same as `env.can`; `env.can` wins when both are set. */
+    can?: KitEnv["can"];
+    /**
+     * D70 (V2 `KitEnv.hiddenLine`): keep the fields that would leave the form in place as the host's line instead. `why`
+     * says what hid it: "rule" (its condition doesn't hold for the current value) or "access" (the lens can't `view` it).
+     * The schema preview draws its dashed "Hidden for Editor" / "Hidden: …" lines with it. Absent: hidden fields leave the
+     * form, as in every editor. Keep it stable (a new function re-renders the form).
+     */
+    hiddenLine?: (field: FieldSchema, path: FieldPath, why: HiddenWhy) => React.ReactNode;
+    /** own scroll container (default: panel yes, document no) */
+    scroll?: boolean;
+    /** rendered above the breadcrumb (e.g. a block header) */
+    header?: React.ReactNode;
+    /** label of the root crumb (defaults to schema.title) */
+    rootLabel?: string;
+    /**
+     * Host-owned trail (CPO D38): the form stops rendering its own breadcrumb and reports the drill-in crumbs
+     * instead, so a host with its own path header shows ONE breadcrumb. Navigate with `onPathChange`. Called in a
+     * layout effect, so the host header never lags a frame.
+     */
+    onCrumbs?: (crumbs: KitCrumb[]) => void;
+    onIssuesChange?: (issues: KitIssue[]) => void;
+    /** imperative navigation for hosts (e.g. a dialog's Escape: go up one level before closing) */
+    navRef?: React.Ref<{
+        back: () => boolean;
+    }>;
+    className?: string;
+}
+export declare const COALESCE_MS = 900;
+export declare const UNDO_STEPS = 50;
+export type HiddenWhy = "rule" | "access";
+export declare function SchemaForm({ schema: schemaIn, value, onChange, path: controlledPath, defaultPath, onPathChange, variant, resolveSchema: resolveIn, blockLibrary, published, inherited, presence, comments, onComment, onOpenReference, review, readOnly, showErrors, env: envIn, scroll, header, rootLabel, onCrumbs, onIssuesChange, navRef, className, can: canIn, hiddenLine, extraIssues, }: SchemaFormProps): import("react/jsx-runtime").JSX.Element;

package/dist/engine/schema-form.js

@@ -0,0 +1,462 @@
+import { cn } from "../lib/cn.js";
+import { DEFAULT_ENV, FormProvider, KitEnvProvider, fieldAccessOf, useForm, useKitEnv, visibleSchema } from "../context.js";
+import { getIn, isObj, keyStartsWith, pathEq, pathKey, same, setIn } from "../lib/path.js";
+import { condCtx, isHidden } from "../lib/schema.js";
+import { collectIssues } from "../lib/validate.js";
+import { FieldList, FieldSection } from "./grouping.js";
+import { ButtonScreen } from "../controls/button.js";
+import { FieldList as FieldList$1 } from "./field-list.js";
+import { RowsHostContext } from "./array.js";
+import { resolveFrames } from "../lib/frames.js";
+import { FrameCrumbs, crumbSignature, framesToCrumbs } from "./breadcrumb.js";
+import { FrameSlotsProvider, FrameStage, useFrameNavigation } from "./frame.js";
+import { TableFrame } from "../controls/table/table.js";
+import { KitField, NestedForm } from "./kit-field.js";
+import * as React from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/engine/schema-form.tsx
+/**
+* <SchemaForm> — the BetterCMS Block Kit form engine (V2 HEAD 9829bf1 kit/engine/schema-form.tsx). One schema in, one
+* value out; renders through the shared field chrome; owns validation visibility, per-field undo + history (coalesced
+* 900ms, 50 steps), the published baseline (changed dots, Reset to published) and the navigation path.
+*
+*   <SchemaForm schema={faq} value={v} onChange={setV} variant="panel" />
+*
+* `path` is controllable so a canvas can sync selection <-> breadcrumb both ways. Frames (root, drilled object, array
+* item, slot block, button, history) come from lib/frames `resolveFrames`; the drill-in stage, crumbs and keys
+* (Esc / Alt+Up/Down) from frame.tsx and breadcrumb.tsx; the layout of each frame from grouping.tsx through field-list.
+*
+* The host provides the kit scope (`data-kit-scope`) around the form; the form never declares one of its own, so a
+* dark host scope is never reset to light inside it.
+*/
+var COALESCE_MS = 900;
+var UNDO_STEPS = 50;
+var HISTORY_ENTRIES = 30;
+var buttonLabel = (v) => ({ label: isObj(v) && typeof v.label === "string" ? v.label : void 0 });
+var FRAME_SLOTS = {
+	get FieldList() {
+		return FieldList$1;
+	},
+	get FieldSection() {
+		return FieldSection;
+	},
+	get TableFrame() {
+		return TableFrame;
+	},
+	get ButtonScreen() {
+		return ButtonScreen;
+	},
+	normLink: buttonLabel
+};
+var ROWS_HOST = { get NestedForm() {
+	return NestedForm;
+} };
+/** Drop archived fields at every depth (V2 registry: "What a form renders: archived fields left out (their values stay
+*  stored)"). Same object back when nothing is archived, so a form with none renders exactly as before. */
+function liveFields(fields) {
+	let changed = false;
+	const out = [];
+	for (const f of fields) {
+		if (f.archived) {
+			changed = true;
+			continue;
+		}
+		let g = f;
+		if (f.fields) {
+			const n = liveFields(f.fields);
+			if (n !== f.fields) g = {
+				...g,
+				fields: n
+			};
+		}
+		if (Array.isArray(f.of)) {
+			const n = liveFields(f.of);
+			if (n !== f.of) g = {
+				...g,
+				of: n
+			};
+		}
+		if (f.slotSettings) {
+			const n = liveFields(f.slotSettings);
+			if (n !== f.slotSettings) g = {
+				...g,
+				slotSettings: n
+			};
+		}
+		if (g !== f) changed = true;
+		out.push(g);
+	}
+	return changed ? out : fields;
+}
+function liveSchema(schema) {
+	const fields = liveFields(schema.fields);
+	return fields === schema.fields ? schema : {
+		...schema,
+		fields
+	};
+}
+var GHOST = "__ghost";
+var HiddenLineCtx = React.createContext(void 0);
+/** A stand-in that keeps a hidden field's place: no value rules, no condition, nothing to validate or drill into. */
+function ghostOf(f, why) {
+	return {
+		name: f.name,
+		title: f.title,
+		type: f.type === "object" || f.type === "array" || f.type === "slot" ? "string" : f.type,
+		fieldset: f.fieldset,
+		group: f.group,
+		readOnly: true,
+		[GHOST]: {
+			why,
+			field: f
+		}
+	};
+}
+/** `visibleSchema`, except that a field the lens can't view stays as a ghost (top level and inside objects). */
+function lensGhosts(schema, can) {
+	const walk = (fields) => fields.map((f) => {
+		const a = fieldAccessOf(f);
+		if (a?.view && !can(a.view)) return ghostOf(f, "access");
+		return f.type === "object" && f.fields ? {
+			...f,
+			fields: walk(f.fields)
+		} : f;
+	});
+	return {
+		...schema,
+		fields: walk(schema.fields)
+	};
+}
+/** The frame's field list with condition-hidden fields kept as ghosts, every ghost drawn by the host's line. */
+function GhostFieldList(props) {
+	const form = useForm();
+	const line = React.useContext(HiddenLineCtx);
+	const raw = form.getAt(props.basePath);
+	const parent = isObj(raw) ? raw : {};
+	const cc = condCtx(form, props.basePath);
+	const fields = props.fields.map((f) => f[GHOST] || f.hidden === true || !isHidden(f, parent, cc) ? f : ghostOf(f, "rule"));
+	return /* @__PURE__ */ jsx(FieldList, {
+		...props,
+		fields,
+		renderField: (f, path, p) => {
+			const g = f[GHOST];
+			return g ? /* @__PURE__ */ jsx("div", {
+				"data-field-key": pathKey(path),
+				"data-ghost": g.why,
+				children: line(g.field, path, g.why)
+			}) : /* @__PURE__ */ jsx(KitField, {
+				field: f,
+				path,
+				parent: p
+			});
+		}
+	});
+}
+var GHOST_SLOTS = {
+	get FieldList() {
+		return GhostFieldList;
+	},
+	get FieldSection() {
+		return FieldSection;
+	},
+	get TableFrame() {
+		return TableFrame;
+	},
+	get ButtonScreen() {
+		return ButtonScreen;
+	},
+	normLink: buttonLabel
+};
+function SchemaForm({ schema: schemaIn, value, onChange, path: controlledPath, defaultPath, onPathChange, variant = "panel", resolveSchema: resolveIn, blockLibrary, published, inherited, presence, comments, onComment, onOpenReference, review, readOnly, showErrors = false, env: envIn, scroll, header, rootLabel, onCrumbs, onIssuesChange, navRef, className, can: canIn, hiddenLine, extraIssues }) {
+	const outerCan = useKitEnv().can;
+	const can = envIn?.can ?? canIn ?? outerCan;
+	const schema = React.useMemo(() => {
+		const live = liveSchema(schemaIn);
+		return hiddenLine ? lensGhosts(live, can) : visibleSchema(live, can);
+	}, [
+		schemaIn,
+		can,
+		hiddenLine
+	]);
+	const resolveSchema = React.useMemo(() => resolveIn ? (t) => {
+		const s = resolveIn(t);
+		return s && visibleSchema(liveSchema(s), can);
+	} : void 0, [resolveIn, can]);
+	const docId = envIn?.docId ?? schema.name;
+	const ownScroll = scroll ?? variant === "panel";
+	const valueRef = React.useRef(value);
+	valueRef.current = value;
+	const [baseline, setBaseline] = React.useState(value);
+	const stacks = React.useRef(/* @__PURE__ */ new Map());
+	const log = React.useRef(/* @__PURE__ */ new Map());
+	const memory = React.useRef(/* @__PURE__ */ new Map());
+	const [aiKeys, setAiKeys] = React.useState(() => /* @__PURE__ */ new Set());
+	const [touched, setTouched] = React.useState(() => /* @__PURE__ */ new Set());
+	const editing = React.useRef(/* @__PURE__ */ new Set());
+	const [, bump] = React.useReducer((x) => x + 1, 0);
+	React.useEffect(() => {
+		setBaseline(valueRef.current);
+		stacks.current.clear();
+		log.current.clear();
+		memory.current.clear();
+		setTouched(/* @__PURE__ */ new Set());
+		setAiKeys(/* @__PURE__ */ new Set());
+	}, [docId]);
+	const [innerPath, setInnerPath] = React.useState(defaultPath ?? []);
+	const rawPath = controlledPath ?? innerPath;
+	const { frames, path } = React.useMemo(() => resolveFrames(schema, value, rawPath, resolveSchema), [
+		schema,
+		value,
+		rawPath,
+		resolveSchema
+	]);
+	const navigate = React.useCallback((p) => {
+		if (controlledPath === void 0) setInnerPath(p);
+		onPathChange?.(p);
+	}, [controlledPath, onPathChange]);
+	React.useEffect(() => {
+		if (!pathEq(path, rawPath)) navigate(path);
+	}, [
+		path,
+		rawPath,
+		navigate
+	]);
+	const lastDoc = React.useRef(docId);
+	React.useEffect(() => {
+		if (lastDoc.current === docId) return;
+		lastDoc.current = docId;
+		if (controlledPath === void 0) setInnerPath([]);
+	}, [docId]);
+	const setAt = React.useCallback((p, v, opts) => {
+		const prev = getIn(valueRef.current, p);
+		if (same(prev, v)) return;
+		const key = pathKey(p);
+		if (opts?.record !== false) {
+			const now = Date.now();
+			const st = stacks.current.get(key) ?? {
+				path: p,
+				values: [],
+				at: 0
+			};
+			if (!st.values.length || now - st.at > 900) st.values = [...st.values, prev].slice(-50);
+			st.at = now;
+			stacks.current.set(key, st);
+			const h = log.current.get(key) ?? [];
+			const entry = {
+				value: v,
+				at: now,
+				by: "You",
+				label: opts?.label
+			};
+			log.current.set(key, h.length && now - h[0].at < 900 && !opts?.label ? [entry, ...h.slice(1)] : [entry, ...h].slice(0, HISTORY_ENTRIES));
+			editing.current.add(key);
+		}
+		const next = setIn(valueRef.current, p, v);
+		valueRef.current = next;
+		onChange(next);
+	}, [onChange]);
+	const issueList = React.useMemo(() => {
+		const own = collectIssues(schema.fields, value, [], resolveSchema);
+		return extraIssues?.length ? [...own, ...extraIssues.filter((x) => !own.some((o) => o.key === x.key))] : own;
+	}, [
+		schema,
+		value,
+		resolveSchema,
+		extraIssues
+	]);
+	const issues = React.useMemo(() => new Map(issueList.map((i) => [i.key, i])), [issueList]);
+	React.useEffect(() => onIssuesChange?.(issueList), [issueList, onIssuesChange]);
+	const isVisible = React.useCallback((i) => showErrors || !!i.live || touched.has(i.key) || i.kind === "rule" && !editing.current.has(i.key), [showErrors, touched]);
+	const api = {
+		schema,
+		value,
+		setAt,
+		getAt: (p) => getIn(value, p),
+		baselineAt: (p) => getIn(baseline, p),
+		publishedAt: (p) => getIn(published, p),
+		hasPublished: !!published,
+		inherited: inherited ? {
+			from: inherited.from,
+			isOverridden: (k) => inherited.overridden.includes(k),
+			reset: inherited.onReset
+		} : void 0,
+		path,
+		navigate,
+		canNavigate: true,
+		resolveSchema,
+		blockLibrary,
+		issues,
+		visibleIssue: (k) => {
+			const i = issues.get(k);
+			return i && isVisible(i) ? i : void 0;
+		},
+		rollup: (prefix) => {
+			const pk = pathKey(prefix);
+			let errors = 0;
+			let warnings = 0;
+			for (const i of issueList) if (keyStartsWith(i.key, pk) && isVisible(i)) i.level === "error" ? errors++ : warnings++;
+			return {
+				errors,
+				warnings
+			};
+		},
+		touch: (k) => {
+			editing.current.delete(k);
+			if (!touched.has(k)) setTouched((s) => new Set(s).add(k));
+		},
+		showAllErrors: showErrors,
+		canUndo: (k) => !!stacks.current.get(k)?.values.length,
+		undo: (k) => {
+			const st = stacks.current.get(k);
+			if (!st?.values.length) return;
+			const prev = st.values[st.values.length - 1];
+			st.values = st.values.slice(0, -1);
+			st.at = 0;
+			const next = setIn(valueRef.current, st.path, prev);
+			valueRef.current = next;
+			onChange(next);
+			bump();
+		},
+		history: (k) => log.current.get(k) ?? [],
+		aiKeys,
+		markAi: (k, on) => setAiKeys((s) => {
+			const n = new Set(s);
+			if (on) n.add(k);
+			else n.delete(k);
+			return n;
+		}),
+		memory: memory.current
+	};
+	const normPresence = React.useMemo(() => {
+		const out = {};
+		for (const [k, v] of Object.entries(presence ?? {})) out[k] = Array.isArray(v) ? v : [v];
+		return out;
+	}, [presence]);
+	const env = React.useMemo(() => ({
+		...DEFAULT_ENV,
+		variant,
+		docId,
+		docTitle: envIn?.docTitle,
+		urlPrefix: envIn?.urlPrefix,
+		isPublished: envIn?.isPublished ?? (published ? true : void 0),
+		slugIsAddress: envIn?.slugIsAddress,
+		palette: envIn?.palette ?? DEFAULT_ENV.palette,
+		readOnly: !!readOnly,
+		can,
+		presence: normPresence,
+		comments: comments ?? {},
+		onComment,
+		onOpenReference,
+		syncedFrom: envIn?.syncedFrom,
+		helpDisplay: envIn?.helpDisplay,
+		review,
+		fieldChrome: envIn?.fieldChrome,
+		controls: envIn?.controls,
+		sectionSummary: envIn?.sectionSummary
+	}), [
+		variant,
+		docId,
+		envIn?.docTitle,
+		envIn?.urlPrefix,
+		envIn?.isPublished,
+		envIn?.slugIsAddress,
+		envIn?.palette,
+		envIn?.syncedFrom,
+		envIn?.helpDisplay,
+		envIn?.fieldChrome,
+		envIn?.controls,
+		envIn?.sectionSummary,
+		published,
+		readOnly,
+		can,
+		normPresence,
+		comments,
+		onComment,
+		onOpenReference,
+		review
+	]);
+	React.useImperativeHandle(navRef, () => ({ back: () => {
+		if (frames.length < 2) return false;
+		navigate(frames[frames.length - 2].path);
+		return true;
+	} }), [frames, navigate]);
+	const root = React.useRef(null);
+	const scroller = React.useRef(null);
+	const nav = useFrameNavigation({
+		frames,
+		navigate,
+		root,
+		scroller
+	});
+	const crumbs = framesToCrumbs(frames, schema, api.rollup, rootLabel);
+	const crumbSig = crumbSignature(crumbs);
+	const onCrumbsRef = React.useRef(onCrumbs);
+	onCrumbsRef.current = onCrumbs;
+	React.useLayoutEffect(() => {
+		onCrumbsRef.current?.(crumbs);
+	}, [crumbSig]);
+	const syncedNote = envIn?.syncedFrom ? /* @__PURE__ */ jsxs("p", {
+		className: "mb-5 flex items-start gap-2 rounded-kit-lg bg-kit-info-soft px-3 py-2 text-kit-xs text-kit-info-fg",
+		children: [/* @__PURE__ */ jsx("span", {
+			className: "mt-0.5 size-1.5 shrink-0 rounded-full bg-kit-info",
+			"aria-hidden": true
+		}), /* @__PURE__ */ jsxs("span", { children: [
+			"Synced from ",
+			/* @__PURE__ */ jsx("span", {
+				className: "font-medium",
+				children: envIn.syncedFrom
+			}),
+			". Changes here apply on every page that uses it."
+		] })]
+	}) : null;
+	const body = /* @__PURE__ */ jsx(FrameStage, {
+		review: !!review,
+		frames,
+		frameKey: nav.frameKey,
+		dir: nav.dir,
+		rootLabel: rootLabel ?? schema.title,
+		variant,
+		before: syncedNote
+	});
+	return /* @__PURE__ */ jsx(KitEnvProvider, {
+		value: env,
+		children: /* @__PURE__ */ jsx(FormProvider, {
+			value: api,
+			children: /* @__PURE__ */ jsx(HiddenLineCtx.Provider, {
+				value: hiddenLine,
+				children: /* @__PURE__ */ jsx(FrameSlotsProvider, {
+					value: hiddenLine ? GHOST_SLOTS : FRAME_SLOTS,
+					children: /* @__PURE__ */ jsx(RowsHostContext.Provider, {
+						value: ROWS_HOST,
+						children: /* @__PURE__ */ jsxs("div", {
+							ref: root,
+							onKeyDown: nav.onKeyDown,
+							className: cn("flex min-h-0 min-w-0 flex-col", ownScroll && "h-full", className),
+							"data-kit-form": schema.name,
+							children: [
+								header,
+								onCrumbs ? null : /* @__PURE__ */ jsx(FrameCrumbs, {
+									crumbs,
+									onNavigate: navigate,
+									variant
+								}),
+								ownScroll ? /* @__PURE__ */ jsx("div", {
+									ref: scroller,
+									className: "@container min-h-0 flex-1 overflow-y-auto overscroll-contain",
+									children: body
+								}) : /* @__PURE__ */ jsx("div", {
+									className: "@container",
+									children: body
+								})
+							]
+						})
+					})
+				})
+			})
+		})
+	});
+}
+//#endregion
+export { COALESCE_MS, SchemaForm, UNDO_STEPS };
+
+//# sourceMappingURL=schema-form.js.map

package/dist/engine/schema-form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-form.js","names":[],"sources":["../../src/engine/schema-form.tsx"],"sourcesContent":["/**\n * <SchemaForm> — the BetterCMS Block Kit form engine (V2 HEAD 9829bf1 kit/engine/schema-form.tsx). One schema in, one\n * value out; renders through the shared field chrome; owns validation visibility, per-field undo + history (coalesced\n * 900ms, 50 steps), the published baseline (changed dots, Reset to published) and the navigation path.\n *\n *   <SchemaForm schema={faq} value={v} onChange={setV} variant=\"panel\" />\n *\n * `path` is controllable so a canvas can sync selection <-> breadcrumb both ways. Frames (root, drilled object, array\n * item, slot block, button, history) come from lib/frames `resolveFrames`; the drill-in stage, crumbs and keys\n * (Esc / Alt+Up/Down) from frame.tsx and breadcrumb.tsx; the layout of each frame from grouping.tsx through field-list.\n *\n * The host provides the kit scope (`data-kit-scope`) around the form; the form never declares one of its own, so a\n * dark host scope is never reset to light inside it.\n */\nimport * as React from \"react\";\nimport { cn } from \"../lib/cn\";\nimport type { FieldPath, FieldSchema, TypeSchema } from \"../schema/types\";\nimport { DEFAULT_ENV, fieldAccessOf, FormProvider, KitEnvProvider, useForm, useKitEnv, visibleSchema, type FormApi, type HistoryEntry, type KitEnv, type KitPeer, type Swatch } from \"../context\";\nimport { resolveFrames } from \"../lib/frames\";\nimport { getIn, isObj, keyStartsWith, pathEq, pathKey, same, setIn } from \"../lib/path\";\nimport { condCtx, isHidden } from \"../lib/schema\";\nimport { collectIssues, type KitIssue } from \"../lib/validate\";\nimport { RowsHostContext } from \"./array\";\nimport { crumbSignature, FrameCrumbs, framesToCrumbs, type KitCrumb } from \"./breadcrumb\";\nimport { FieldList, type FieldListProps } from \"./field-list\";\nimport { FrameSlotsProvider, FrameStage, useFrameNavigation, type FrameSlots } from \"./frame\";\nimport { FieldList as GroupedFieldList, FieldSection } from \"./grouping\";\nimport { KitField, NestedForm } from \"./kit-field\";\nimport { TableFrame } from \"../controls/table/table\";\nimport { ButtonScreen } from \"../controls/button\";\n\nexport interface SchemaFormProps {\n  schema: TypeSchema;\n  value: Record<string, unknown>;\n  onChange: (value: Record<string, unknown>) => void;\n  /** controlled navigation path ([] = root). Omit for uncontrolled. */\n  path?: FieldPath;\n  defaultPath?: FieldPath;\n  onPathChange?: (path: FieldPath) => void;\n  /** \"panel\" = 320–420px inspector; \"document\" = the wide document editor column */\n  variant?: \"panel\" | \"document\";\n  /** resolve a block type (slot children) to its schema */\n  resolveSchema?: (blockType: string) => TypeSchema | undefined;\n  /** blocks offered by \"+ Add block\" (filtered by each slot's allow list) */\n  blockLibrary?: TypeSchema[];\n  /** the published version: enables changed dots and \"Reset to published\" */\n  published?: Record<string, unknown>;\n  /**\n   * Component instance (CPO D28): values come from `from` unless a top-level key is in `overridden`. Overridden fields\n   * get an accent dot + \"Reset\"; inherited ones read muted. `onReset(key)` drops one override.\n   */\n  inherited?: { from: string; overridden: string[]; onReset: (key: string) => void };\n  /** pathKey → teammates in that field (\"items.1.answer\") */\n  presence?: Record<string, KitPeer | KitPeer[]>;\n  /** pathKey → open comment threads */\n  comments?: Record<string, number>;\n  /** host comment system. When set, the field comment chip opens the host's popover/panel instead of the kit's. */\n  onComment?: KitEnv[\"onComment\"];\n  /** \"Open {title}\" on a reference: the host opens the referenced entry (e.g. a stacked panel) */\n  onOpenReference?: KitEnv[\"onOpenReference\"];\n  /** D61: the host's Review changes markers (while its History panel is open) */\n  review?: KitEnv[\"review\"];\n  /** the whole form is read-only for the lens (fields with their own `access.edit` still follow `env.can`) */\n  readOnly?: boolean;\n  /** validate everything now (after a publish attempt) */\n  showErrors?: boolean;\n  /** document identity + site context */\n  env?: {\n    docId?: string;\n    docTitle?: string;\n    urlPrefix?: string;\n    isPublished?: boolean;\n    /** the slug is the document's address (KitEnv.slugIsAddress) */\n    slugIsAddress?: boolean;\n    palette?: Swatch[];\n    syncedFrom?: string;\n    /** D58: the host's access check (`useCan` at the host). Omitted → allow-all (staff tools, demos). */\n    can?: KitEnv[\"can\"];\n    /** CPO D39: \"tooltip\" moves help lines behind the ⓘ (dense hosts) */\n    helpDisplay?: KitEnv[\"helpDisplay\"];\n    /** \"quiet\" field chrome for meta-forms (see `KitEnv.fieldChrome`) */\n    fieldChrome?: KitEnv[\"fieldChrome\"];\n    /** the host's own controls by path key (see `KitEnv.controls`); keep it stable */\n    controls?: KitEnv[\"controls\"];\n    /** the host's chip summary for collapsed fieldsets (see `KitEnv.sectionSummary`); keep it stable */\n    sectionSummary?: KitEnv[\"sectionSummary\"];\n  };\n  /**\n   * Issues the host computes itself (a live check the schema can't express), merged with the form's own. A host issue on a\n   * path the form already flags is dropped; `live` ones show while typing; `fix` adds one action after the message.\n   */\n  extraIssues?: KitIssue[];\n  /** The host's access check (V2 `KitEnv.can`), the same as `env.can`; `env.can` wins when both are set. */\n  can?: KitEnv[\"can\"];\n  /**\n   * D70 (V2 `KitEnv.hiddenLine`): keep the fields that would leave the form in place as the host's line instead. `why`\n   * says what hid it: \"rule\" (its condition doesn't hold for the current value) or \"access\" (the lens can't `view` it).\n   * The schema preview draws its dashed \"Hidden for Editor\" / \"Hidden: …\" lines with it. Absent: hidden fields leave the\n   * form, as in every editor. Keep it stable (a new function re-renders the form).\n   */\n  hiddenLine?: (field: FieldSchema, path: FieldPath, why: HiddenWhy) => React.ReactNode;\n  /** own scroll container (default: panel yes, document no) */\n  scroll?: boolean;\n  /** rendered above the breadcrumb (e.g. a block header) */\n  header?: React.ReactNode;\n  /** label of the root crumb (defaults to schema.title) */\n  rootLabel?: string;\n  /**\n   * Host-owned trail (CPO D38): the form stops rendering its own breadcrumb and reports the drill-in crumbs\n   * instead, so a host with its own path header shows ONE breadcrumb. Navigate with `onPathChange`. Called in a\n   * layout effect, so the host header never lags a frame.\n   */\n  onCrumbs?: (crumbs: KitCrumb[]) => void;\n  onIssuesChange?: (issues: KitIssue[]) => void;\n  /** imperative navigation for hosts (e.g. a dialog's Escape: go up one level before closing) */\n  navRef?: React.Ref<{ back: () => boolean }>;\n  className?: string;\n}\n\nexport const COALESCE_MS = 900;\nexport const UNDO_STEPS = 50;\nconst HISTORY_ENTRIES = 30;\n\n/* The frame pieces other lanes own, handed to frame.tsx (which never imports them directly). ButtonScreen (link\n   control) and TableFrame (table control) arrive with the controls lanes; until then the header title reads the\n   button's label the way V2's `normLink(v).label` does.\n   The getters read the imports at render, not at module evaluation: kit-field → array / field-list → schema-form →\n   kit-field is a cycle, and an eager read would hit the TDZ the day one of them becomes a const or memo(). */\nconst buttonLabel = (v: unknown) => ({ label: isObj(v) && typeof v.label === \"string\" ? v.label : undefined });\nconst FRAME_SLOTS: FrameSlots = {\n  get FieldList() {\n    return FieldList;\n  },\n  get FieldSection() {\n    return FieldSection;\n  },\n  get TableFrame() {\n    return TableFrame;\n  },\n  get ButtonScreen() {\n    return ButtonScreen;\n  },\n  normLink: buttonLabel,\n};\nconst ROWS_HOST = {\n  get NestedForm() {\n    return NestedForm;\n  },\n};\n\n/* ── archived fields leave every form ───────────────────────────────── */\n/** Drop archived fields at every depth (V2 registry: \"What a form renders: archived fields left out (their values stay\n *  stored)\"). Same object back when nothing is archived, so a form with none renders exactly as before. */\nfunction liveFields(fields: FieldSchema[]): FieldSchema[] {\n  let changed = false;\n  const out: FieldSchema[] = [];\n  for (const f of fields) {\n    if (f.archived) {\n      changed = true;\n      continue;\n    }\n    let g = f;\n    if (f.fields) {\n      const n = liveFields(f.fields);\n      if (n !== f.fields) g = { ...g, fields: n };\n    }\n    if (Array.isArray(f.of)) {\n      const n = liveFields(f.of);\n      if (n !== f.of) g = { ...g, of: n };\n    }\n    if (f.slotSettings) {\n      const n = liveFields(f.slotSettings);\n      if (n !== f.slotSettings) g = { ...g, slotSettings: n };\n    }\n    if (g !== f) changed = true;\n    out.push(g);\n  }\n  return changed ? out : fields;\n}\nfunction liveSchema(schema: TypeSchema): TypeSchema {\n  const fields = liveFields(schema.fields);\n  return fields === schema.fields ? schema : { ...schema, fields };\n}\n\n/* ── hiddenLine: hidden fields kept in place as the host's line ──────── */\nexport type HiddenWhy = \"rule\" | \"access\";\nconst GHOST = \"__ghost\";\ntype Ghost = { why: HiddenWhy; field: FieldSchema };\ntype GhostField = FieldSchema & { [GHOST]?: Ghost };\nconst HiddenLineCtx = React.createContext<SchemaFormProps[\"hiddenLine\"]>(undefined);\n\n/** A stand-in that keeps a hidden field's place: no value rules, no condition, nothing to validate or drill into. */\nfunction ghostOf(f: FieldSchema, why: HiddenWhy): GhostField {\n  return { name: f.name, title: f.title, type: f.type === \"object\" || f.type === \"array\" || f.type === \"slot\" ? \"string\" : f.type, fieldset: f.fieldset, group: f.group, readOnly: true, [GHOST]: { why, field: f } };\n}\n\n/** `visibleSchema`, except that a field the lens can't view stays as a ghost (top level and inside objects). */\nfunction lensGhosts(schema: TypeSchema, can: KitEnv[\"can\"]): TypeSchema {\n  const walk = (fields: FieldSchema[]): FieldSchema[] =>\n    fields.map((f) => {\n      const a = fieldAccessOf(f);\n      if (a?.view && !can(a.view)) return ghostOf(f, \"access\");\n      return f.type === \"object\" && f.fields ? { ...f, fields: walk(f.fields) } : f;\n    });\n  return { ...schema, fields: walk(schema.fields) };\n}\n\n/** The frame's field list with condition-hidden fields kept as ghosts, every ghost drawn by the host's line. */\nfunction GhostFieldList(props: FieldListProps) {\n  const form = useForm()!;\n  const line = React.useContext(HiddenLineCtx)!;\n  const raw = form.getAt(props.basePath);\n  const parent = isObj(raw) ? raw : {};\n  const cc = condCtx(form, props.basePath);\n  const fields = props.fields.map((f) => ((f as GhostField)[GHOST] || f.hidden === true || !isHidden(f, parent, cc) ? f : ghostOf(f, \"rule\")));\n  return (\n    <GroupedFieldList\n      {...props}\n      fields={fields}\n      renderField={(f, path, p) => {\n        const g = (f as GhostField)[GHOST];\n        return g ? (\n          <div data-field-key={pathKey(path)} data-ghost={g.why}>\n            {line(g.field, path, g.why)}\n          </div>\n        ) : (\n          <KitField field={f} path={path} parent={p} />\n        );\n      }}\n    />\n  );\n}\nconst GHOST_SLOTS: FrameSlots = {\n  get FieldList() {\n    return GhostFieldList;\n  },\n  get FieldSection() {\n    return FieldSection;\n  },\n  get TableFrame() {\n    return TableFrame;\n  },\n  get ButtonScreen() {\n    return ButtonScreen;\n  },\n  normLink: buttonLabel,\n};\n\nexport function SchemaForm({\n  schema: schemaIn,\n  value,\n  onChange,\n  path: controlledPath,\n  defaultPath,\n  onPathChange,\n  variant = \"panel\",\n  resolveSchema: resolveIn,\n  blockLibrary,\n  published,\n  inherited,\n  presence,\n  comments,\n  onComment,\n  onOpenReference,\n  review,\n  readOnly,\n  showErrors = false,\n  env: envIn,\n  scroll,\n  header,\n  rootLabel,\n  onCrumbs,\n  onIssuesChange,\n  navRef,\n  className,\n  can: canIn,\n  hiddenLine,\n  extraIssues,\n}: SchemaFormProps) {\n  const outerCan = useKitEnv().can;\n  const can = envIn?.can ?? canIn ?? outerCan; // a nested form (dialog object, article block) inherits its host form's check\n  /* D58: fields the lens can't view are dropped from the schema here, once: not rendered, not validated (with\n     `hiddenLine`, they stay as ghosts: a place and a line, still nothing to validate) */\n  const schema = React.useMemo(() => {\n    const live = liveSchema(schemaIn);\n    return hiddenLine ? lensGhosts(live, can) : visibleSchema(live, can);\n  }, [schemaIn, can, hiddenLine]);\n  const resolveSchema = React.useMemo(\n    () =>\n      resolveIn\n        ? (t: string) => {\n            const s = resolveIn(t);\n            return s && visibleSchema(liveSchema(s), can);\n          }\n        : undefined,\n    [resolveIn, can],\n  );\n  const docId = envIn?.docId ?? schema.name;\n  const ownScroll = scroll ?? variant === \"panel\";\n\n  /* value + baseline */\n  const valueRef = React.useRef(value);\n  valueRef.current = value;\n  const [baseline, setBaseline] = React.useState(value);\n  const stacks = React.useRef(new Map<string, { path: FieldPath; values: unknown[]; at: number }>());\n  const log = React.useRef(new Map<string, HistoryEntry[]>());\n  const memory = React.useRef(new Map<string, unknown>());\n  const [aiKeys, setAiKeys] = React.useState<Set<string>>(() => new Set());\n  const [touched, setTouched] = React.useState<Set<string>>(() => new Set());\n  const editing = React.useRef(new Set<string>());\n  const [, bump] = React.useReducer((x: number) => x + 1, 0);\n  React.useEffect(() => {\n    setBaseline(valueRef.current);\n    stacks.current.clear();\n    log.current.clear();\n    memory.current.clear();\n    setTouched(new Set());\n    setAiKeys(new Set());\n  }, [docId]);\n\n  /* navigation */\n  const [innerPath, setInnerPath] = React.useState<FieldPath>(defaultPath ?? []);\n  const rawPath = controlledPath ?? innerPath;\n  const { frames, path } = React.useMemo(() => resolveFrames(schema, value, rawPath, resolveSchema), [schema, value, rawPath, resolveSchema]);\n  const navigate = React.useCallback(\n    (p: FieldPath) => {\n      if (controlledPath === undefined) setInnerPath(p);\n      onPathChange?.(p);\n    },\n    [controlledPath, onPathChange],\n  );\n  /* a path that no longer resolves (a removed item, a hidden field) settles on the deepest frame that does */\n  React.useEffect(() => {\n    if (!pathEq(path, rawPath)) navigate(path);\n  }, [path, rawPath, navigate]);\n  /* V2: a new document starts at its root (an uncontrolled path never carries the last document's drill or history).\n     Skips the mount run so `defaultPath` survives. */\n  const lastDoc = React.useRef(docId);\n  React.useEffect(() => {\n    if (lastDoc.current === docId) return;\n    lastDoc.current = docId;\n    if (controlledPath === undefined) setInnerPath([]);\n  }, [docId]); // eslint-disable-line react-hooks/exhaustive-deps\n\n  /* writes */\n  const setAt = React.useCallback<FormApi[\"setAt\"]>(\n    (p, v, opts) => {\n      const prev = getIn(valueRef.current, p);\n      if (same(prev, v)) return;\n      const key = pathKey(p);\n      if (opts?.record !== false) {\n        const now = Date.now();\n        const st = stacks.current.get(key) ?? { path: p, values: [], at: 0 };\n        if (!st.values.length || now - st.at > COALESCE_MS) st.values = [...st.values, prev].slice(-UNDO_STEPS);\n        st.at = now;\n        stacks.current.set(key, st);\n        const h = log.current.get(key) ?? [];\n        const entry: HistoryEntry = { value: v, at: now, by: \"You\", label: opts?.label };\n        log.current.set(key, h.length && now - h[0].at < COALESCE_MS && !opts?.label ? [entry, ...h.slice(1)] : [entry, ...h].slice(0, HISTORY_ENTRIES));\n        editing.current.add(key);\n      }\n      const next = setIn(valueRef.current, p, v);\n      valueRef.current = next;\n      onChange(next);\n    },\n    [onChange],\n  );\n\n  /* validation */\n  const issueList = React.useMemo(() => {\n    const own = collectIssues(schema.fields, value, [], resolveSchema);\n    return extraIssues?.length ? [...own, ...extraIssues.filter((x) => !own.some((o) => o.key === x.key))] : own;\n  }, [schema, value, resolveSchema, extraIssues]);\n  const issues = React.useMemo(() => new Map(issueList.map((i) => [i.key, i])), [issueList]);\n  React.useEffect(() => onIssuesChange?.(issueList), [issueList, onIssuesChange]);\n  const isVisible = React.useCallback(\n    (i: KitIssue) => showErrors || !!i.live || touched.has(i.key) || (i.kind === \"rule\" && !editing.current.has(i.key)),\n    [showErrors, touched],\n  );\n\n  const api: FormApi = {\n    schema,\n    value,\n    setAt,\n    getAt: (p) => getIn(value, p),\n    baselineAt: (p) => getIn(baseline, p),\n    publishedAt: (p) => getIn(published, p),\n    hasPublished: !!published,\n    inherited: inherited ? { from: inherited.from, isOverridden: (k) => inherited.overridden.includes(k), reset: inherited.onReset } : undefined,\n    path,\n    navigate,\n    canNavigate: true,\n    resolveSchema,\n    blockLibrary,\n    issues,\n    visibleIssue: (k) => {\n      const i = issues.get(k);\n      return i && isVisible(i) ? i : undefined;\n    },\n    rollup: (prefix) => {\n      const pk = pathKey(prefix);\n      let errors = 0;\n      let warnings = 0;\n      for (const i of issueList) if (keyStartsWith(i.key, pk) && isVisible(i)) i.level === \"error\" ? errors++ : warnings++;\n      return { errors, warnings };\n    },\n    touch: (k) => {\n      editing.current.delete(k);\n      if (!touched.has(k)) setTouched((s) => new Set(s).add(k));\n    },\n    showAllErrors: showErrors,\n    canUndo: (k) => !!stacks.current.get(k)?.values.length,\n    undo: (k) => {\n      const st = stacks.current.get(k);\n      if (!st?.values.length) return;\n      const prev = st.values[st.values.length - 1];\n      st.values = st.values.slice(0, -1);\n      st.at = 0;\n      const next = setIn(valueRef.current, st.path, prev);\n      valueRef.current = next;\n      onChange(next);\n      bump();\n    },\n    history: (k) => log.current.get(k) ?? [],\n    aiKeys,\n    markAi: (k, on) =>\n      setAiKeys((s) => {\n        const n = new Set(s);\n        if (on) n.add(k);\n        else n.delete(k);\n        return n;\n      }),\n    memory: memory.current,\n  };\n\n  const normPresence = React.useMemo(() => {\n    const out: Record<string, KitPeer[]> = {};\n    for (const [k, v] of Object.entries(presence ?? {})) out[k] = Array.isArray(v) ? v : [v];\n    return out;\n  }, [presence]);\n  const env: KitEnv = React.useMemo(\n    () => ({\n      ...DEFAULT_ENV,\n      variant,\n      docId,\n      docTitle: envIn?.docTitle,\n      urlPrefix: envIn?.urlPrefix,\n      /* a published copy proves \"live\"; its absence proves nothing (the dock has none), so it stays unknown */\n      isPublished: envIn?.isPublished ?? (published ? true : undefined),\n      slugIsAddress: envIn?.slugIsAddress,\n      palette: envIn?.palette ?? DEFAULT_ENV.palette,\n      readOnly: !!readOnly,\n      can,\n      presence: normPresence,\n      comments: comments ?? {},\n      onComment,\n      onOpenReference,\n      syncedFrom: envIn?.syncedFrom,\n      helpDisplay: envIn?.helpDisplay,\n      review,\n      fieldChrome: envIn?.fieldChrome,\n      controls: envIn?.controls,\n      sectionSummary: envIn?.sectionSummary,\n    }),\n    [variant, docId, envIn?.docTitle, envIn?.urlPrefix, envIn?.isPublished, envIn?.slugIsAddress, envIn?.palette, envIn?.syncedFrom, envIn?.helpDisplay, envIn?.fieldChrome, envIn?.controls, envIn?.sectionSummary, published, readOnly, can, normPresence, comments, onComment, onOpenReference, review],\n  );\n\n  React.useImperativeHandle(\n    navRef,\n    () => ({\n      back: () => {\n        if (frames.length < 2) return false;\n        navigate(frames[frames.length - 2].path);\n        return true;\n      },\n    }),\n    [frames, navigate],\n  );\n\n  /* drill-in stage: direction-aware slide, scroll memory, focus on the entering frame, Esc / Alt+Up/Down */\n  const root = React.useRef<HTMLDivElement>(null);\n  const scroller = React.useRef<HTMLDivElement>(null);\n  const nav = useFrameNavigation({ frames, navigate, root, scroller });\n\n  const crumbs = framesToCrumbs(frames, schema, api.rollup, rootLabel);\n  const crumbSig = crumbSignature(crumbs);\n  const onCrumbsRef = React.useRef(onCrumbs);\n  onCrumbsRef.current = onCrumbs;\n  React.useLayoutEffect(() => {\n    onCrumbsRef.current?.(crumbs);\n  }, [crumbSig]); // eslint-disable-line react-hooks/exhaustive-deps\n\n  const syncedNote = envIn?.syncedFrom ? (\n    <p className=\"mb-5 flex items-start gap-2 rounded-kit-lg bg-kit-info-soft px-3 py-2 text-kit-xs text-kit-info-fg\">\n      <span className=\"mt-0.5 size-1.5 shrink-0 rounded-full bg-kit-info\" aria-hidden />\n      <span>\n        Synced from <span className=\"font-medium\">{envIn.syncedFrom}</span>. Changes here apply on every page that uses it.\n      </span>\n    </p>\n  ) : null;\n  const body = <FrameStage review={!!review} frames={frames} frameKey={nav.frameKey} dir={nav.dir} rootLabel={rootLabel ?? schema.title} variant={variant} before={syncedNote} />;\n\n  return (\n    <KitEnvProvider value={env}>\n      <FormProvider value={api}>\n        <HiddenLineCtx.Provider value={hiddenLine}>\n        <FrameSlotsProvider value={hiddenLine ? GHOST_SLOTS : FRAME_SLOTS}>\n          <RowsHostContext.Provider value={ROWS_HOST}>\n            <div ref={root} onKeyDown={nav.onKeyDown} className={cn(\"flex min-h-0 min-w-0 flex-col\", ownScroll && \"h-full\", className)} data-kit-form={schema.name}>\n              {header}\n              {onCrumbs ? null : <FrameCrumbs crumbs={crumbs} onNavigate={navigate} variant={variant} />}\n              {ownScroll ? (\n                <div ref={scroller} className=\"@container min-h-0 flex-1 overflow-y-auto overscroll-contain\">\n                  {body}\n                </div>\n              ) : (\n                <div className=\"@container\">{body}</div>\n              )}\n            </div>\n          </RowsHostContext.Provider>\n        </FrameSlotsProvider>\n        </HiddenLineCtx.Provider>\n      </FormProvider>\n    </KitEnvProvider>\n  );\n}\n"],"mappings":"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"}

package/dist/engine/slot.d.ts

@@ -0,0 +1,13 @@
+import type { FieldPath, FieldSchema, TypeSchema } from "../schema/types";
+export declare function SlotField({ field, path }: {
+    field: FieldSchema;
+    path: FieldPath;
+}): import("react/jsx-runtime").JSX.Element;
+/** Blocks this slot accepts: its allow list resolved through `resolveSchema`, else the whole block library. */
+export declare function useAvailableBlocks(field: FieldSchema): TypeSchema[];
+export declare function BlockPicker({ blocks, onPick, disabled, label }: {
+    blocks: TypeSchema[];
+    onPick: (b: TypeSchema) => void;
+    disabled?: boolean;
+    label?: string;
+}): import("react/jsx-runtime").JSX.Element;