@bettercms-ai/kit 0.1.1 → 2.0.0-next.0

package/dist/testing/corpus.d.ts

@@ -0,0 +1,63 @@
+import type { TypeSchema } from "../schema/types";
+import { type AdapterTarget } from "../adapters/schema";
+import { type Backlog, type CatalogItem, type LossyItem } from "../adapters/lossy";
+export declare const CORPUS: {
+    id: string;
+    schema: TypeSchema;
+    value: Record<string, unknown>;
+}[];
+/**
+ * Every leaf (JSON pointer) where `a` and `b` differ. A missing object or array is read as empty, so a dropped
+ * `{ required, max }` shows as its two leaves, and an undefined key equals an absent one.
+ */
+export declare function leafDiff(a: unknown, b: unknown, path?: string, out?: string[]): string[];
+/**
+ * Round-trips one schema and returns what breaks "equals v2 minus exactly the lossy and catalog paths" (empty = holds).
+ */
+export declare function roundTrip(schema: TypeSchema, target: AdapterTarget): {
+    lossy: LossyItem[];
+    catalog: CatalogItem[];
+    /** a difference no lossy or catalog item names: a silent drop or a wrong mapping */
+    unreported: string[];
+    /** a lossy or catalog item with nothing lost under it: an over-report */
+    overreported: string[];
+};
+/**
+ * entry id → the sorted features, per lane: what prod drops (`lossy`) or what the host sets at seeding (`catalog`).
+ * The lossy summary also names each reported feature's backlog item, and lists the features per backlog item with
+ * their entry counts in both lanes (the generated backend order).
+ */
+export declare function computeLedger(kind: "lossy" | "catalog"): {
+    summary: {
+        fields: {
+            [k: string]: number;
+        };
+        props: {
+            [k: string]: number;
+        };
+    };
+    entries: Record<string, {
+        fields: string[];
+        props: string[];
+    }>;
+} | {
+    summary: {
+        backlog: Record<string, Backlog>;
+        byBacklog: {
+            [k: string]: Record<string, {
+                fields: number;
+                props: number;
+            }>;
+        };
+        fields: {
+            [k: string]: number;
+        };
+        props: {
+            [k: string]: number;
+        };
+    };
+    entries: Record<string, {
+        fields: string[];
+        props: string[];
+    }>;
+};

package/dist/testing/corpus.js

@@ -0,0 +1,129 @@
+import { FEATURES } from "../adapters/lossy.js";
+import { fromTypeSchema, propsToTypeSchema, toTypeSchema } from "../adapters/schema.js";
+import { EXAMPLES } from "../library/examples/index.js";
+import { KIT_LIBRARY } from "../library/entries/index.js";
+//#region src/testing/corpus.ts
+/** The 149 schemas the adapters are held to (KIT_LIBRARY 142 + the 7 core examples) and the leaf diff the round trip uses. */
+var CORPUS = [...KIT_LIBRARY.map((e) => ({
+	id: e.id,
+	schema: e.schema,
+	value: e.value
+})), ...EXAMPLES.map((e) => ({
+	id: e.id,
+	schema: e.schema,
+	value: e.value
+}))];
+var isObj = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+/**
+* Every leaf (JSON pointer) where `a` and `b` differ. A missing object or array is read as empty, so a dropped
+* `{ required, max }` shows as its two leaves, and an undefined key equals an absent one.
+*/
+function leafDiff(a, b, path = "", out = []) {
+	if (isObj(a) || isObj(b)) {
+		if (a !== void 0 && !isObj(a) || b !== void 0 && !isObj(b)) {
+			out.push(path);
+			return out;
+		}
+		const A = a ?? {};
+		const B = b ?? {};
+		for (const k of /* @__PURE__ */ new Set([...Object.keys(A), ...Object.keys(B)])) leafDiff(A[k], B[k], `${path}/${k}`, out);
+		return out;
+	}
+	if (Array.isArray(a) || Array.isArray(b)) {
+		if (a !== void 0 && !Array.isArray(a) || b !== void 0 && !Array.isArray(b)) {
+			out.push(path);
+			return out;
+		}
+		const A = a ?? [];
+		const B = b ?? [];
+		for (let i = 0; i < Math.max(A.length, B.length); i++) leafDiff(A[i], B[i], `${path}/${i}`, out);
+		return out;
+	}
+	if (a !== b) out.push(path);
+	return out;
+}
+var under = (path, root) => path === root || path.startsWith(`${root}/`);
+/**
+* A V2 field with no group sits in the default group (engine/grouping.tsx: `f.group ?? defaultGroup(groups)`). Prop
+* tabs store every top-level prop's tab, so the props lane reads that placement back as an explicit `group`: the same
+* placement, compared as such.
+*/
+function withDefaultGroups(schema) {
+	const d = (schema.groups?.find((g) => g.default) ?? schema.groups?.[0])?.name;
+	return d === void 0 ? schema : {
+		...schema,
+		fields: schema.fields.map((f) => f.group === void 0 ? {
+			...f,
+			group: d
+		} : f)
+	};
+}
+/**
+* Round-trips one schema and returns what breaks "equals v2 minus exactly the lossy and catalog paths" (empty = holds).
+*/
+function roundTrip(schema, target) {
+	const { schema: prod, blockModels, lossy, catalog } = target === "fields" ? fromTypeSchema(schema, "fields") : fromTypeSchema(schema, "props");
+	const back = target === "fields" ? toTypeSchema(prod, { blockModels }) : propsToTypeSchema(prod);
+	const diffs = leafDiff(target === "props" ? withDefaultGroups(schema) : schema, back);
+	const named = [...lossy, ...catalog];
+	return {
+		lossy,
+		catalog,
+		/** a difference no lossy or catalog item names: a silent drop or a wrong mapping */
+		unreported: diffs.filter((d) => !named.some((l) => under(d, l.path))),
+		/** a lossy or catalog item with nothing lost under it: an over-report */
+		overreported: named.filter((l) => !diffs.some((d) => under(d, l.path))).map((l) => `${l.path} (${l.feature})`)
+	};
+}
+/**
+* entry id → the sorted features, per lane: what prod drops (`lossy`) or what the host sets at seeding (`catalog`).
+* The lossy summary also names each reported feature's backlog item, and lists the features per backlog item with
+* their entry counts in both lanes (the generated backend order).
+*/
+function computeLedger(kind) {
+	const entries = {};
+	const summary = {
+		fields: {},
+		props: {}
+	};
+	for (const { id, schema } of CORPUS) {
+		const row = {
+			fields: [],
+			props: []
+		};
+		for (const t of ["fields", "props"]) {
+			row[t] = [...new Set(roundTrip(schema, t)[kind].map((l) => l.feature))].sort();
+			for (const f of row[t]) summary[t][f] = (summary[t][f] ?? 0) + 1;
+		}
+		entries[id] = row;
+	}
+	const sortedCounts = (o) => Object.fromEntries(Object.entries(o).sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])));
+	const counts = {
+		fields: sortedCounts(summary.fields),
+		props: sortedCounts(summary.props)
+	};
+	if (kind === "catalog") return {
+		summary: counts,
+		entries
+	};
+	const reported = [.../* @__PURE__ */ new Set([...Object.keys(counts.fields), ...Object.keys(counts.props)])].sort();
+	const backlog = Object.fromEntries(reported.map((f) => [f, FEATURES[f]?.backlog]));
+	const byBacklog = {};
+	for (const f of reported) (byBacklog[backlog[f]] ??= {})[f] = {
+		fields: summary.fields[f] ?? 0,
+		props: summary.props[f] ?? 0
+	};
+	const sortedByBacklog = Object.fromEntries(Object.keys(byBacklog).sort().map((b) => [b, byBacklog[b]]));
+	return {
+		summary: {
+			...counts,
+			backlog,
+			byBacklog: sortedByBacklog
+		},
+		entries
+	};
+}
+//#endregion
+export { CORPUS, computeLedger, leafDiff, roundTrip };
+
+//# sourceMappingURL=corpus.js.map

package/dist/testing/corpus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"corpus.js","names":[],"sources":["../../src/testing/corpus.ts"],"sourcesContent":["/** The 149 schemas the adapters are held to (KIT_LIBRARY 142 + the 7 core examples) and the leaf diff the round trip uses. */\nimport { KIT_LIBRARY } from \"../library/entries\";\nimport { EXAMPLES } from \"../library/examples\";\nimport type { TypeSchema } from \"../schema/types\";\nimport { fromTypeSchema, propsToTypeSchema, toTypeSchema, type AdapterTarget } from \"../adapters/schema\";\nimport { FEATURES, type Backlog, type CatalogItem, type LossyFeature, type LossyItem } from \"../adapters/lossy\";\n\nexport const CORPUS: { id: string; schema: TypeSchema; value: Record<string, unknown> }[] = [\n  ...KIT_LIBRARY.map((e) => ({ id: e.id, schema: e.schema, value: e.value })),\n  ...EXAMPLES.map((e) => ({ id: e.id, schema: e.schema, value: e.value })),\n];\n\ntype Obj = Record<string, unknown>;\nconst isObj = (v: unknown): v is Obj => !!v && typeof v === \"object\" && !Array.isArray(v);\n\n/**\n * Every leaf (JSON pointer) where `a` and `b` differ. A missing object or array is read as empty, so a dropped\n * `{ required, max }` shows as its two leaves, and an undefined key equals an absent one.\n */\nexport function leafDiff(a: unknown, b: unknown, path = \"\", out: string[] = []): string[] {\n  if (isObj(a) || isObj(b)) {\n    if ((a !== undefined && !isObj(a)) || (b !== undefined && !isObj(b))) {\n      out.push(path);\n      return out;\n    }\n    const A = (a ?? {}) as Obj;\n    const B = (b ?? {}) as Obj;\n    for (const k of new Set([...Object.keys(A), ...Object.keys(B)])) leafDiff(A[k], B[k], `${path}/${k}`, out);\n    return out;\n  }\n  if (Array.isArray(a) || Array.isArray(b)) {\n    if ((a !== undefined && !Array.isArray(a)) || (b !== undefined && !Array.isArray(b))) {\n      out.push(path);\n      return out;\n    }\n    const A = (a ?? []) as unknown[];\n    const B = (b ?? []) as unknown[];\n    for (let i = 0; i < Math.max(A.length, B.length); i++) leafDiff(A[i], B[i], `${path}/${i}`, out);\n    return out;\n  }\n  if (a !== b) out.push(path);\n  return out;\n}\n\nconst under = (path: string, root: string) => path === root || path.startsWith(`${root}/`);\n\n/**\n * A V2 field with no group sits in the default group (engine/grouping.tsx: `f.group ?? defaultGroup(groups)`). Prop\n * tabs store every top-level prop's tab, so the props lane reads that placement back as an explicit `group`: the same\n * placement, compared as such.\n */\nfunction withDefaultGroups(schema: TypeSchema): TypeSchema {\n  const d = (schema.groups?.find((g) => g.default) ?? schema.groups?.[0])?.name;\n  return d === undefined ? schema : { ...schema, fields: schema.fields.map((f) => (f.group === undefined ? { ...f, group: d } : f)) };\n}\n\n/**\n * Round-trips one schema and returns what breaks \"equals v2 minus exactly the lossy and catalog paths\" (empty = holds).\n */\nexport function roundTrip(schema: TypeSchema, target: AdapterTarget) {\n  const { schema: prod, blockModels, lossy, catalog } = target === \"fields\" ? fromTypeSchema(schema, \"fields\") : fromTypeSchema(schema, \"props\");\n  const back =\n    target === \"fields\"\n      ? toTypeSchema(prod as Parameters<typeof toTypeSchema>[0], { blockModels })\n      : propsToTypeSchema(prod as Parameters<typeof propsToTypeSchema>[0]);\n  const diffs = leafDiff(target === \"props\" ? withDefaultGroups(schema) : schema, back);\n  const named: (LossyItem | CatalogItem)[] = [...lossy, ...catalog];\n  return {\n    lossy,\n    catalog,\n    /** a difference no lossy or catalog item names: a silent drop or a wrong mapping */\n    unreported: diffs.filter((d) => !named.some((l) => under(d, l.path))),\n    /** a lossy or catalog item with nothing lost under it: an over-report */\n    overreported: named.filter((l) => !diffs.some((d) => under(d, l.path))).map((l) => `${l.path} (${l.feature})`),\n  };\n}\n\n/**\n * entry id → the sorted features, per lane: what prod drops (`lossy`) or what the host sets at seeding (`catalog`).\n * The lossy summary also names each reported feature's backlog item, and lists the features per backlog item with\n * their entry counts in both lanes (the generated backend order).\n */\nexport function computeLedger(kind: \"lossy\" | \"catalog\") {\n  const entries: Record<string, { fields: string[]; props: string[] }> = {};\n  const summary = { fields: {} as Record<string, number>, props: {} as Record<string, number> };\n  for (const { id, schema } of CORPUS) {\n    const row = { fields: [] as string[], props: [] as string[] };\n    for (const t of [\"fields\", \"props\"] as const) {\n      row[t] = [...new Set((roundTrip(schema, t)[kind] as { feature: string }[]).map((l) => l.feature))].sort();\n      for (const f of row[t]) summary[t][f] = (summary[t][f] ?? 0) + 1;\n    }\n    entries[id] = row;\n  }\n  const sortedCounts = (o: Record<string, number>) =>\n    Object.fromEntries(Object.entries(o).sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])));\n  const counts = { fields: sortedCounts(summary.fields), props: sortedCounts(summary.props) };\n  if (kind === \"catalog\") return { summary: counts, entries };\n  const reported = [...new Set([...Object.keys(counts.fields), ...Object.keys(counts.props)])].sort() as LossyFeature[];\n  const backlog = Object.fromEntries(reported.map((f) => [f, FEATURES[f]?.backlog])) as Record<string, Backlog>;\n  const byBacklog: Record<string, Record<string, { fields: number; props: number }>> = {};\n  for (const f of reported) (byBacklog[backlog[f]] ??= {})[f] = { fields: summary.fields[f] ?? 0, props: summary.props[f] ?? 0 };\n  const sortedByBacklog = Object.fromEntries(Object.keys(byBacklog).sort().map((b) => [b, byBacklog[b]]));\n  return { summary: { ...counts, backlog, byBacklog: sortedByBacklog }, entries };\n}\n"],"mappings":"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"}

package/dist/testing/test-form.d.ts

@@ -0,0 +1,11 @@
+import type { FieldSchema } from "../schema/types";
+import type { ControlProps } from "../types";
+import { type SchemaFormProps } from "../engine/schema-form";
+/** A controlled SchemaForm over `fields`, with the latest value readable from `onValue`. */
+export declare function TestForm({ fields, initial, onValue, ...rest }: Omit<SchemaFormProps, "schema" | "value" | "onChange"> & {
+    fields: FieldSchema[];
+    initial?: Record<string, unknown>;
+    onValue?: (v: Record<string, unknown>) => void;
+}): import("react/jsx-runtime").JSX.Element;
+/** A plain input standing in for a real control: it sets an aria-describedby id of its own, which the shell keeps. */
+export declare function TestInput({ id, value, onChange, invalid, readOnly }: ControlProps): import("react/jsx-runtime").JSX.Element;

package/dist/testing/test-form.js

@@ -0,0 +1,38 @@
+import { SchemaForm } from "../engine/schema-form.js";
+import * as React from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/testing/test-form.tsx
+/** A controlled SchemaForm over `fields`, with the latest value readable from `onValue`. */
+function TestForm({ fields, initial = {}, onValue, ...rest }) {
+	const [value, setValue] = React.useState(initial);
+	const schema = React.useMemo(() => ({
+		name: "doc",
+		title: "Doc",
+		kind: "entry",
+		fields
+	}), [fields]);
+	return /* @__PURE__ */ jsx(SchemaForm, {
+		schema,
+		value,
+		onChange: (v) => {
+			setValue(v);
+			onValue?.(v);
+		},
+		...rest
+	});
+}
+/** A plain input standing in for a real control: it sets an aria-describedby id of its own, which the shell keeps. */
+function TestInput({ id, value, onChange, invalid, readOnly }) {
+	return /* @__PURE__ */ jsx("input", {
+		id,
+		"aria-describedby": "own-id",
+		"aria-invalid": invalid || void 0,
+		readOnly,
+		value: typeof value === "string" ? value : "",
+		onChange: (e) => onChange(e.target.value)
+	});
+}
+//#endregion
+export { TestForm, TestInput };
+
+//# sourceMappingURL=test-form.js.map

package/dist/testing/test-form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-form.js","names":[],"sources":["../../src/testing/test-form.tsx"],"sourcesContent":["import * as React from \"react\";\nimport type { FieldSchema } from \"../schema/types\";\nimport type { ControlProps } from \"../types\";\nimport { SchemaForm, type SchemaFormProps } from \"../engine/schema-form\";\n\n/** A controlled SchemaForm over `fields`, with the latest value readable from `onValue`. */\nexport function TestForm({\n  fields,\n  initial = {},\n  onValue,\n  ...rest\n}: Omit<SchemaFormProps, \"schema\" | \"value\" | \"onChange\"> & {\n  fields: FieldSchema[];\n  initial?: Record<string, unknown>;\n  onValue?: (v: Record<string, unknown>) => void;\n}) {\n  const [value, setValue] = React.useState(initial);\n  const schema = React.useMemo(() => ({ name: \"doc\", title: \"Doc\", kind: \"entry\" as const, fields }), [fields]);\n  return (\n    <SchemaForm\n      schema={schema}\n      value={value}\n      onChange={(v) => {\n        setValue(v);\n        onValue?.(v);\n      }}\n      {...rest}\n    />\n  );\n}\n\n/** A plain input standing in for a real control: it sets an aria-describedby id of its own, which the shell keeps. */\nexport function TestInput({ id, value, onChange, invalid, readOnly }: ControlProps) {\n  return (\n    <input\n      id={id}\n      aria-describedby=\"own-id\"\n      aria-invalid={invalid || undefined}\n      readOnly={readOnly}\n      value={typeof value === \"string\" ? value : \"\"}\n      onChange={(e) => onChange(e.target.value)}\n    />\n  );\n}\n"],"mappings":";;;;;AAMA,SAAgB,SAAS,EACvB,QACA,UAAU,CAAC,GACX,SACA,GAAG,QAKF;CACD,MAAM,CAAC,OAAO,YAAY,MAAM,SAAS,OAAO;CAChD,MAAM,SAAS,MAAM,eAAe;EAAE,MAAM;EAAO,OAAO;EAAO,MAAM;EAAkB;CAAO,IAAI,CAAC,MAAM,CAAC;CAC5G,OACE,oBAAC,YAAD;EACU;EACD;EACP,WAAW,MAAM;GACf,SAAS,CAAC;GACV,UAAU,CAAC;EACb;EACA,GAAI;CACL,CAAA;AAEL;;AAGA,SAAgB,UAAU,EAAE,IAAI,OAAO,UAAU,SAAS,YAA0B;CAClF,OACE,oBAAC,SAAD;EACM;EACJ,oBAAiB;EACjB,gBAAc,WAAW,KAAA;EACf;EACV,OAAO,OAAO,UAAU,WAAW,QAAQ;EAC3C,WAAW,MAAM,SAAS,EAAE,OAAO,KAAK;CACzC,CAAA;AAEL"}

package/dist/theme.css

@@ -0,0 +1,345 @@
+/* @bettercms-ai/kit utility names for a Tailwind v4 app: `@import "@bettercms-ai/kit/theme.css"` after tailwindcss.
+   "inline reference" registers bg-kit-surface, text-kit-fg, rounded-kit-md… without emitting variables: the values live in tokens.css. */
+@theme inline reference {
+  --color-kit-app: var(--kit-app);
+  --color-kit-surface: var(--kit-surface);
+  /* V2 styles/index.css:635 --color-surface-raised: the kit's bg-kit-surface-raised (floating block toolbars) */
+  --color-kit-surface-raised: var(--kit-surface-raised);
+  --color-kit-subtle: var(--kit-subtle);
+  --color-kit-subtle-2: var(--kit-subtle-2);
+  --color-kit-shimmer-highlight: var(--kit-shimmer-highlight);
+  --color-kit-site-paper: var(--kit-site-paper);
+  --color-kit-well: var(--kit-well);
+  --color-kit-muted: var(--kit-muted);
+  --color-kit-hover: var(--kit-hover);
+  --color-kit-selected: var(--kit-selected);
+  --color-kit-inverse: var(--kit-inverse);
+  --color-kit-inverse-hover: var(--kit-inverse-hover);
+  --color-kit-overlay: var(--kit-overlay);
+  --color-kit-media-handle: var(--kit-media-handle);
+  --color-kit-media-handle-ring: var(--kit-media-handle-ring);
+  --color-kit-media-scrim: var(--kit-media-scrim);
+  --color-kit-rail: var(--kit-rail);
+  --color-kit-control-checked: var(--kit-control-checked);
+  --color-kit-on-scrim: var(--kit-on-scrim);
+  --color-kit-on-scrim-2: var(--kit-on-scrim-2);
+  --color-kit-on-scrim-hover: var(--kit-on-scrim-hover);
+  --color-kit-on-scrim-active: var(--kit-on-scrim-active);
+  --color-kit-scrim-strong: var(--kit-scrim-strong);
+  /* S2k (V2 styles/index.css, cited per role in :root below) */
+  --color-kit-scrim: var(--kit-scrim);
+  --color-kit-floating-line: var(--kit-floating-line);
+  --color-kit-editor-tray-line: var(--editor-tray-line);
+  --color-kit-tray-line: var(--kit-tray-line);
+  --color-kit-ink-bg: var(--kit-ink-bg);
+  --color-kit-ink-fg: var(--kit-ink-fg);
+  --color-kit-ink-fg-2: var(--kit-ink-fg-2);
+  --color-kit-ink-fg-3: var(--kit-ink-fg-3);
+  --color-kit-ink-hover: var(--kit-ink-hover);
+  --color-kit-ink-active: var(--kit-ink-active);
+  --color-kit-ink-line: var(--kit-ink-line);
+  --color-kit-ink-button: var(--kit-ink-button);
+  --color-kit-ink-button-fg: var(--kit-ink-button-fg);
+  --color-kit-ink-danger-fg: var(--kit-ink-danger-fg);
+  --color-kit-ink-danger-fg-hover: var(--kit-ink-danger-fg-hover);
+  --color-kit-avatar-on: var(--kit-avatar-on);
+  --color-kit-code-fg: var(--kit-code-fg);
+  --color-kit-preview-paper: var(--kit-preview-paper);
+  --color-kit-preview-ink: var(--kit-preview-ink);
+  --color-kit-preview-primary: var(--kit-preview-primary);
+  --color-kit-preview-primary-on: var(--kit-preview-primary-on);
+  --color-kit-preview-contrast: var(--kit-preview-contrast);
+  --color-kit-preview-contrast-on: var(--kit-preview-contrast-on);
+  --color-kit-preview-outline: var(--kit-preview-outline);
+  --shadow-kit-button-primary: var(--kit-shadow-button-primary);
+  --shadow-kit-sheet-b: var(--kit-shadow-sheet-b);
+  --color-kit-segment-thumb: var(--kit-segment-thumb);
+  --color-kit-progress-fill: var(--kit-progress-fill);
+  --color-kit-paper: var(--kit-paper);
+  --color-kit-paper-ink: var(--kit-paper-ink);
+  --color-kit-site-paper-line: var(--kit-site-paper-line);
+  --color-kit-media-well: var(--kit-media-well);
+  --color-kit-media-backdrop: var(--kit-media-backdrop);
+  --color-kit-media-control: var(--kit-media-control);
+  --color-kit-media-control-fg: var(--kit-media-control-fg);
+  --color-kit-disabled-bg: var(--kit-disabled-bg);
+  --color-kit-disabled-fg: var(--kit-disabled-fg);
+  --color-kit-constraint-bg: var(--kit-constraint-bg);
+  --color-kit-constraint-fg: var(--kit-constraint-fg);
+  --shadow-kit-sheet-r: var(--kit-shadow-sheet-r);
+  --color-kit-checker-a: var(--kit-checker-a);
+  --color-kit-checker-b: var(--kit-checker-b);
+  --color-kit-fg: var(--kit-fg);
+  --color-kit-fg-2: var(--kit-fg-2);
+  --color-kit-fg-3: var(--kit-fg-3);
+  --color-kit-fg-4: var(--kit-fg-4);
+  --color-kit-fg-inverse: var(--kit-fg-inverse);
+  --color-kit-line: var(--kit-line);
+  --color-kit-line-strong: var(--kit-line-strong);
+  --color-kit-line-subtle: var(--kit-line-subtle);
+  --color-kit-field-border: var(--kit-field-border);
+  --color-kit-focus-ring: var(--kit-focus-ring);
+  --color-kit-accent: var(--kit-accent);
+  --color-kit-accent-hover: var(--kit-accent-hover);
+  --color-kit-accent-soft: var(--kit-accent-soft);
+  --color-kit-accent-soft-2: var(--kit-accent-soft-2);
+  --color-kit-accent-softer: var(--kit-accent-softer);
+  --color-kit-accent-line: var(--kit-accent-line);
+  --color-kit-accent-fg: var(--kit-accent-fg);
+  --color-kit-accent-on: var(--kit-accent-on);
+  --color-kit-success: var(--kit-success);
+  --color-kit-success-soft: var(--kit-success-soft);
+  --color-kit-success-softer: var(--kit-success-softer);
+  --color-kit-success-line: var(--kit-success-line);
+  --color-kit-success-fg: var(--kit-success-fg);
+  --color-kit-success-on: var(--kit-success-on);
+  --color-kit-warning: var(--kit-warning);
+  --color-kit-warning-soft: var(--kit-warning-soft);
+  --color-kit-warning-softer: var(--kit-warning-softer);
+  --color-kit-warning-line: var(--kit-warning-line);
+  --color-kit-warning-fg: var(--kit-warning-fg);
+  --color-kit-warning-on: var(--kit-warning-on);
+  --color-kit-danger: var(--kit-danger);
+  --color-kit-danger-soft: var(--kit-danger-soft);
+  --color-kit-danger-softer: var(--kit-danger-softer);
+  --color-kit-danger-line: var(--kit-danger-line);
+  --color-kit-danger-fg: var(--kit-danger-fg);
+  --color-kit-danger-on: var(--kit-danger-on);
+  --color-kit-info: var(--kit-info);
+  --color-kit-info-soft: var(--kit-info-soft);
+  --color-kit-info-softer: var(--kit-info-softer);
+  --color-kit-info-line: var(--kit-info-line);
+  --color-kit-info-fg: var(--kit-info-fg);
+  --color-kit-info-on: var(--kit-info-on);
+  --color-kit-canvas: var(--kit-canvas);
+  --color-kit-code: var(--kit-code);
+  --color-kit-control-bg: var(--kit-control-bg);
+  --color-kit-field-bg: var(--kit-field-bg);
+  --color-kit-field-border-hover: var(--kit-field-border-hover);
+  --color-kit-field-border-focus: var(--kit-field-border-focus);
+  --color-kit-switch-off: var(--kit-switch-off);
+  --color-kit-control-thumb: var(--kit-control-thumb);
+  --color-kit-swatch-ring: var(--kit-swatch-ring);
+  --color-kit-on-inverse-2: var(--kit-on-inverse-2);
+  --color-kit-canvas-select: var(--kit-canvas-select);
+  --color-kit-canvas-select-on: var(--kit-canvas-select-on);
+  --color-kit-canvas-select-soft: var(--kit-canvas-select-soft);
+  --color-kit-canvas-accent-soft: var(--kit-canvas-accent-soft);
+  --color-kit-canvas-frame-ring: var(--kit-canvas-frame-ring);
+  --color-kit-syntax-keyword: var(--kit-syntax-keyword);
+  --color-kit-syntax-string: var(--kit-syntax-string);
+  --color-kit-syntax-number: var(--kit-syntax-number);
+  --color-kit-syntax-property: var(--kit-syntax-property);
+  --color-kit-syntax-comment: var(--kit-syntax-comment);
+  --color-kit-syntax-punct: var(--kit-syntax-punct);
+  --color-kit-tag-sky-bg: var(--kit-tag-sky-bg);
+  --color-kit-tag-sky-hover: var(--kit-tag-sky-hover);
+  --color-kit-tag-sky-fg: var(--kit-tag-sky-fg);
+  --color-kit-tag-sky-line: var(--kit-tag-sky-line);
+  --color-kit-tag-lavender-bg: var(--kit-tag-lavender-bg);
+  --color-kit-tag-lavender-hover: var(--kit-tag-lavender-hover);
+  --color-kit-tag-lavender-fg: var(--kit-tag-lavender-fg);
+  --color-kit-tag-lavender-line: var(--kit-tag-lavender-line);
+  --color-kit-tag-mint-bg: var(--kit-tag-mint-bg);
+  --color-kit-tag-mint-hover: var(--kit-tag-mint-hover);
+  --color-kit-tag-mint-fg: var(--kit-tag-mint-fg);
+  --color-kit-tag-mint-line: var(--kit-tag-mint-line);
+  --color-kit-tag-sand-bg: var(--kit-tag-sand-bg);
+  --color-kit-tag-sand-hover: var(--kit-tag-sand-hover);
+  --color-kit-tag-sand-fg: var(--kit-tag-sand-fg);
+  --color-kit-tag-sand-line: var(--kit-tag-sand-line);
+  --color-kit-tag-butter-bg: var(--kit-tag-butter-bg);
+  --color-kit-tag-butter-hover: var(--kit-tag-butter-hover);
+  --color-kit-tag-butter-fg: var(--kit-tag-butter-fg);
+  --color-kit-tag-butter-line: var(--kit-tag-butter-line);
+  --color-kit-tag-coral-bg: var(--kit-tag-coral-bg);
+  --color-kit-tag-coral-hover: var(--kit-tag-coral-hover);
+  --color-kit-tag-coral-fg: var(--kit-tag-coral-fg);
+  --color-kit-tag-coral-line: var(--kit-tag-coral-line);
+  --color-kit-tag-slate-bg: var(--kit-tag-slate-bg);
+  --color-kit-tag-slate-hover: var(--kit-tag-slate-hover);
+  --color-kit-tag-slate-fg: var(--kit-tag-slate-fg);
+  --color-kit-tag-slate-line: var(--kit-tag-slate-line);
+  --color-kit-tag-teal-bg: var(--kit-tag-teal-bg);
+  --color-kit-tag-teal-hover: var(--kit-tag-teal-hover);
+  --color-kit-tag-teal-fg: var(--kit-tag-teal-fg);
+  --color-kit-tag-teal-line: var(--kit-tag-teal-line);
+  --color-kit-tag-rose-bg: var(--kit-tag-rose-bg);
+  --color-kit-tag-rose-hover: var(--kit-tag-rose-hover);
+  --color-kit-tag-rose-fg: var(--kit-tag-rose-fg);
+  --color-kit-tag-rose-line: var(--kit-tag-rose-line);
+  --color-kit-type-text-bg: var(--kit-type-text-bg);
+  --color-kit-type-text-fg: var(--kit-type-text-fg);
+  --color-kit-type-text-line: var(--kit-type-text-line);
+  --color-kit-type-number-bg: var(--kit-type-number-bg);
+  --color-kit-type-number-fg: var(--kit-type-number-fg);
+  --color-kit-type-number-line: var(--kit-type-number-line);
+  --color-kit-type-choice-bg: var(--kit-type-choice-bg);
+  --color-kit-type-choice-fg: var(--kit-type-choice-fg);
+  --color-kit-type-choice-line: var(--kit-type-choice-line);
+  --color-kit-type-date-bg: var(--kit-type-date-bg);
+  --color-kit-type-date-fg: var(--kit-type-date-fg);
+  --color-kit-type-date-line: var(--kit-type-date-line);
+  --color-kit-type-media-bg: var(--kit-type-media-bg);
+  --color-kit-type-media-fg: var(--kit-type-media-fg);
+  --color-kit-type-media-line: var(--kit-type-media-line);
+  --color-kit-type-reference-bg: var(--kit-type-reference-bg);
+  --color-kit-type-reference-fg: var(--kit-type-reference-fg);
+  --color-kit-type-reference-line: var(--kit-type-reference-line);
+  --color-kit-type-structure-bg: var(--kit-type-structure-bg);
+  --color-kit-type-structure-fg: var(--kit-type-structure-fg);
+  --color-kit-type-structure-line: var(--kit-type-structure-line);
+  --color-kit-type-advanced-bg: var(--kit-type-advanced-bg);
+  --color-kit-type-advanced-fg: var(--kit-type-advanced-fg);
+  --color-kit-type-advanced-line: var(--kit-type-advanced-line);
+  --color-kit-type-off-bg: var(--kit-type-off-bg);
+  --color-kit-type-off-fg: var(--kit-type-off-fg);
+  --color-kit-type-off-line: var(--kit-type-off-line);
+  --color-kit-desk: var(--kit-desk);
+  --color-kit-desk-card: var(--kit-desk-card);
+  --color-kit-row-selected-ring: var(--kit-row-selected-ring);
+  --color-kit-row-selected-edge: var(--kit-row-selected-edge);
+  --color-kit-row-selected-hover: var(--kit-row-selected-hover);
+  --color-kit-drop-zone-line: var(--kit-drop-zone-line);
+  --color-kit-drop-target-line: var(--kit-drop-target-line);
+  --color-kit-health-good: var(--kit-health-good);
+  --color-kit-health-tidy: var(--kit-health-tidy);
+  --color-kit-health-bad: var(--kit-health-bad);
+  --color-kit-review-safe-bg: var(--kit-review-safe-bg);
+  --color-kit-review-safe-fg: var(--kit-review-safe-fg);
+  --color-kit-review-check-bg: var(--kit-review-check-bg);
+  --color-kit-review-check-fg: var(--kit-review-check-fg);
+  --color-kit-review-breaking-bg: var(--kit-review-breaking-bg);
+  --color-kit-review-breaking-fg: var(--kit-review-breaking-fg);
+
+  --radius-kit-xs: var(--kit-radius-xs);
+  --radius-kit-sm: var(--kit-radius-sm);
+  --radius-kit-md: var(--kit-radius-md);
+  --radius-kit-lg: var(--kit-radius-lg);
+  --radius-kit-xl: var(--kit-radius-xl);
+  --radius-kit-2xl: var(--kit-radius-2xl);
+
+  --shadow-kit-xs: var(--kit-shadow-xs);
+  --shadow-kit-sm: var(--kit-shadow-sm);
+  --shadow-kit-md: var(--kit-shadow-md);
+  --shadow-kit-lg: var(--kit-shadow-lg);
+  --shadow-kit-xl: var(--kit-shadow-xl);
+  --shadow-kit-canvas-frame: var(--kit-shadow-canvas-frame);
+  --shadow-kit-device: var(--kit-shadow-device);
+  --shadow-kit-field: var(--kit-shadow-field);
+  --shadow-kit-ring-field: var(--kit-ring-field);
+
+  --text-kit-2xs: var(--kit-text-2xs);
+  --text-kit-2xs--line-height: var(--kit-text-2xs--line-height);
+  --text-kit-xs: var(--kit-text-xs);
+  --text-kit-xs--line-height: var(--kit-text-xs--line-height);
+  --text-kit-sm: var(--kit-text-sm);
+  --text-kit-sm--line-height: var(--kit-text-sm--line-height);
+  --text-kit-base: var(--kit-text-base);
+  --text-kit-base--line-height: var(--kit-text-base--line-height);
+  --text-kit-md: var(--kit-text-md);
+  --text-kit-md--line-height: var(--kit-text-md--line-height);
+  --text-kit-lg: var(--kit-text-lg);
+  --text-kit-lg--line-height: var(--kit-text-lg--line-height);
+  --text-kit-xl: var(--kit-text-xl);
+  --text-kit-xl--line-height: var(--kit-text-xl--line-height);
+  --text-kit-2xl: var(--kit-text-2xl);
+  --text-kit-2xl--line-height: var(--kit-text-2xl--line-height);
+  --text-kit-3xl: var(--kit-text-3xl);
+  --text-kit-3xl--line-height: var(--kit-text-3xl--line-height);
+
+  --font-kit-sans: var(--kit-font-sans);
+  --font-kit-mono: var(--kit-font-mono);
+
+  --ease-kit-out-soft: var(--kit-ease-out-soft);
+  --ease-kit-spring: var(--kit-ease-spring);
+  --animate-kit-fade-in: kit-fade-in 160ms var(--kit-ease-out-soft);
+  --animate-kit-pop-in: kit-pop-in 180ms var(--kit-ease-out-soft);
+  --animate-kit-slide-up: kit-slide-up 220ms var(--kit-ease-out-soft);
+  /* The floating inspector's exit (V2 x 16 + fade). Its hide timer is FLOATING_INSPECTOR_EXIT_MS (= --motion-duration-fast). */
+  --animate-kit-sheet-out-r: kit-sheet-out-r var(--motion-duration-fast) var(--kit-ease-out-soft) forwards;
+  --animate-kit-pulse-dot: kit-pulse-dot 1.8s ease-in-out infinite; /* V2 index.css:931 */
+}
+
+/* Kit surface and interaction utilities (moved from the dashboard sheet with the tokens; the kit's ui/ files use them). */
+/* V2 floating surfaces (demo index.css:979-993) as utilities, for canvas chrome drawn over the site.
+   .glass: the block toolbar, its menus and field popovers (add `border` for the hairline).
+   .glass-ink: ink bars and chips, dark in both themes; --shadow-ink lifts it off the page in dark.
+   .kit-ink-pill: the small ink chip ("Drop to swap", drag readouts): .glass-ink + 6px radius, 12/16 medium. */
+@utility glass {
+  background-color: var(--kit-surface);
+  border-color: var(--kit-line);
+  box-shadow: 0 1px 2px rgb(16 16 16 / 0.04), 0 8px 24px -6px rgb(16 16 16 / 0.12);
+  &:is(.dark *) {
+    background-color: var(--kit-surface-raised);
+    border-color: var(--kit-line-strong);
+    box-shadow: inset 0 1px 0 oklch(1 0 0 / 0.04), 0 12px 32px -8px oklch(0.12 0.01 286 / 0.5);
+  }
+}
+@utility glass-ink {
+  background-color: var(--ink-bg);
+  color: var(--ink-fg);
+  box-shadow: var(--shadow-ink);
+}
+/* V2 .glass-strong (index.css:988-996): the selection bubble, slash panel and image toolbar */
+@utility glass-strong {
+  background-color: var(--kit-surface);
+  border-color: var(--kit-line);
+  box-shadow: 0 1px 2px rgb(16 16 16 / 0.05), 0 16px 40px -8px rgb(16 16 16 / 0.18);
+  &:is(.dark *) {
+    background-color: var(--kit-surface-raised);
+    border-color: var(--kit-line-strong);
+    box-shadow: inset 0 1px 0 oklch(1 0 0 / 0.05), 0 16px 40px -8px oklch(0.12 0.01 286 / 0.58);
+  }
+}
+/* V2 .bg-tray (index.css:1019): action tray, solid surface + gradient, no blur (D21) */
+@utility bg-tray {
+  background-color: var(--kit-surface);
+  background-image: var(--kit-tray-gradient);
+}
+/* V2 .btn-solid (index.css:1017): solid disabled buttons take the solid disabled pair in dark */
+@utility btn-solid {
+  &:is(.dark *):disabled {
+    background-color: var(--kit-disabled-bg);
+    color: var(--kit-disabled-fg);
+    opacity: 1;
+    box-shadow: none;
+  }
+}
+/* V2 .skeleton (index.css:1024) */
+/* A small control's hit area grown to the floor without moving anything: 40px with a mouse,
+   44px on touch (ui-polish #8). The inset follows the control's own size, `--hit-size` (24px when
+   unset): `hit-area [--hit-size:16px]` on a 16px icon. Never on two neighbours whose grown areas
+   would overlap; a control already at the floor gets no inset (the min(0px, …) clamp). */
+@utility hit-area {
+  position: relative;
+  &::before {
+    content: "";
+    position: absolute;
+    inset: min(0px, calc((var(--hit-size, 24px) - 40px) / 2));
+  }
+  @media (pointer: coarse) {
+    &::before { inset: min(0px, calc((var(--hit-size, 24px) - 44px) / 2)); }
+  }
+}
+
+@utility skeleton {
+  background: linear-gradient(90deg, var(--kit-skeleton) 0, var(--kit-skeleton-shine) 40%, var(--kit-skeleton) 80%);
+  background-size: 800px 100%;
+  animation: kit-shimmer 1.6s linear infinite;
+}
+@utility kit-ink-pill {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.5rem;
+  border-radius: var(--kit-radius-md);
+  padding: 0.25rem 0.625rem;
+  font-size: var(--kit-text-xs);
+  line-height: var(--kit-text-xs--line-height);
+  font-weight: 500;
+  white-space: nowrap;
+  background-color: var(--ink-bg);
+  color: var(--ink-fg);
+  box-shadow: var(--shadow-ink);
+}
+