@bettercms-ai/kit 0.1.1 → 1.0.0

package/lib/frames.js

@@ -0,0 +1,214 @@
+import { getIn, isObj } from "./path.js";
+import { cellText, isTableValue, normalizeTable } from "../schema/table.js";
+import { isPrimitive, itemSchemaFor, previewOf } from "./schema.js";
+import { HISTORY_SEGMENT } from "../schema/types.js";
+//#region src/kit/lib/frames.ts
+/**
+* NAVIGATION MODEL — a path resolves to a STACK OF FRAMES (one per breadcrumb). The last frame is what the
+* panel shows. Drillable nodes: object fields (drill mode), array items, slot children (blocks), button fields
+* (the one button screen) and "@history" (a field's versions as a stacked panel).
+*/
+function rootFrame(schema) {
+	return {
+		path: [],
+		kind: "root",
+		title: schema.title,
+		icon: schema.icon,
+		fields: schema.fields,
+		fieldsets: schema.fieldsets,
+		groups: schema.groups
+	};
+}
+/** Resolve `path` into frames. Stops at the first segment that doesn't resolve (returns the valid prefix). */
+function resolveFrames(schema, value, path, resolveSchema) {
+	const frames = [rootFrame(schema)];
+	let fields = schema.fields;
+	let i = 0;
+	while (i < path.length) {
+		const seg = path[i];
+		if (typeof seg !== "string") break;
+		const f = fields.find((x) => x.name === seg);
+		if (!f) break;
+		const here = path.slice(0, i + 1);
+		if (path[i + 1] === "@history") {
+			frames.push({
+				path: [...here, HISTORY_SEGMENT],
+				kind: "history",
+				title: "History",
+				icon: "clock",
+				fields: [f],
+				field: f
+			});
+			i += 2;
+			break;
+		}
+		if (f.type === "object" && f.fields) {
+			frames.push({
+				path: here,
+				kind: "object",
+				title: f.title,
+				icon: f.icon,
+				fields: f.fields,
+				field: f
+			});
+			fields = f.fields;
+			i += 1;
+			continue;
+		}
+		if (f.type === "button") {
+			frames.push({
+				path: here,
+				kind: "button",
+				title: f.title,
+				icon: "click",
+				fields: [f],
+				field: f
+			});
+			i += 1;
+			if (path[i] === "@history") {
+				frames.push({
+					path: [...here, HISTORY_SEGMENT],
+					kind: "history",
+					title: "History",
+					icon: "clock",
+					fields: [f],
+					field: f
+				});
+				i += 1;
+			}
+			break;
+		}
+		if (f.type === "table" && (path[i + 1] === "rows" || path[i + 1] === "columns") && typeof path[i + 2] === "number") {
+			const raw = getIn(value, here);
+			if (!isTableValue(raw)) break;
+			const t = normalizeTable(raw);
+			const idx = path[i + 2];
+			const arrayPath = [...here, path[i + 1]];
+			if (path[i + 1] === "rows") {
+				const row = t.rows[idx];
+				if (!row) break;
+				const group = row.group && !row.footer ? t.rowGroups?.find((g) => g._key === row.group) : void 0;
+				if (group) frames.push({
+					path: here,
+					kind: "tableGroup",
+					title: group.label || "Untitled group",
+					icon: "folder",
+					fields: [],
+					field: f
+				});
+				const first = t.columns[0];
+				const titleAt = (j) => {
+					const r = t.rows[j];
+					return r && first && cellText(first, r, r.cells[first._key]) || "Untitled row";
+				};
+				frames.push({
+					path: [...arrayPath, idx],
+					kind: "tableRow",
+					title: titleAt(idx),
+					icon: "list",
+					fields: [],
+					field: f,
+					item: {
+						arrayPath,
+						index: idx,
+						count: t.rows.length,
+						itemSchema: {
+							name: "row",
+							title: "Row",
+							type: "object"
+						},
+						titleAt
+					}
+				});
+			} else {
+				if (!t.columns[idx]) break;
+				const titleAt = (j) => t.columns[j]?.label || "Untitled column";
+				frames.push({
+					path: [...arrayPath, idx],
+					kind: "tableColumn",
+					title: titleAt(idx),
+					icon: "layout-columns",
+					fields: [],
+					field: f,
+					item: {
+						arrayPath,
+						index: idx,
+						count: t.columns.length,
+						itemSchema: {
+							name: "column",
+							title: "Column",
+							type: "object"
+						},
+						titleAt
+					}
+				});
+			}
+			i += 3;
+			break;
+		}
+		if ((f.type === "array" || f.type === "slot") && typeof path[i + 1] === "number") {
+			const idx = path[i + 1];
+			const list = getIn(value, here);
+			const items = Array.isArray(list) ? list : [];
+			const item = items[idx];
+			if (item === void 0) break;
+			const itemPath = [...here, idx];
+			if (f.type === "array") {
+				const s = itemSchemaFor(f, item);
+				if (!s || isPrimitive(s.type) || !s.fields) break;
+				const pv = previewOf(s, item, idx);
+				frames.push({
+					path: itemPath,
+					kind: "item",
+					title: pv.title,
+					icon: s.icon ?? f.icon,
+					fields: s.fields,
+					field: f,
+					item: {
+						arrayPath: here,
+						index: idx,
+						count: items.length,
+						itemSchema: s
+					}
+				});
+				fields = s.fields;
+			} else {
+				const type = isObj(item) && typeof item._type === "string" ? item._type : "";
+				const block = resolveSchema?.(type);
+				if (!block) break;
+				const pv = previewOf(block, item, idx, block.title);
+				frames.push({
+					path: itemPath,
+					kind: "block",
+					title: pv.empty ? block.title : pv.title,
+					icon: block.icon,
+					fields: block.fields,
+					fieldsets: block.fieldsets,
+					groups: block.groups,
+					field: f,
+					item: {
+						arrayPath: here,
+						index: idx,
+						count: items.length,
+						block,
+						slotField: f
+					}
+				});
+				fields = block.fields;
+			}
+			i += 2;
+			continue;
+		}
+		break;
+	}
+	return {
+		frames,
+		path: frames.length > 1 ? frames[frames.length - 1].path : []
+	};
+}
+/** Can this field be opened as its own frame (drill target)? */
+var isDrillable = (f) => f.type === "object" || f.type === "button";
+//#endregion
+export { isDrillable, resolveFrames, rootFrame };
+
+//# sourceMappingURL=frames.js.map

package/lib/frames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frames.js","names":[],"sources":["../../src/kit/lib/frames.ts"],"sourcesContent":["/**\n * NAVIGATION MODEL — a path resolves to a STACK OF FRAMES (one per breadcrumb). The last frame is what the\n * panel shows. Drillable nodes: object fields (drill mode), array items, slot children (blocks), button fields\n * (the one button screen) and \"@history\" (a field's versions as a stacked panel).\n */\nimport { HISTORY_SEGMENT, type Crumb, type FieldGroup, type FieldPath, type FieldSchema, type Fieldset, type TypeSchema } from \"../schema/types\";\nimport { cellText, isTableValue, normalizeTable } from \"../schema/table\";\nimport { getIn, isObj } from \"./path\";\nimport { isPrimitive, itemSchemaFor, previewOf } from \"./schema\";\n\nexport interface Frame {\n  path: FieldPath;\n  kind: Crumb[\"kind\"];\n  title: string;\n  icon?: string;\n  fields: FieldSchema[];\n  fieldsets?: Fieldset[];\n  groups?: FieldGroup[];\n  /** the field that owns this frame (object / array / slot / button / history target) */\n  field?: FieldSchema;\n  /** array items and slot children */\n  item?: {\n    arrayPath: FieldPath;\n    index: number;\n    count: number;\n    itemSchema?: FieldSchema;\n    block?: TypeSchema;\n    slotField?: FieldSchema;\n    /** the title of sibling `i` (table rows and columns, whose items have no schema to preview) */\n    titleAt?: (i: number) => string;\n  };\n}\n\nexport function rootFrame(schema: TypeSchema): Frame {\n  return { path: [], kind: \"root\", title: schema.title, icon: schema.icon, fields: schema.fields, fieldsets: schema.fieldsets, groups: schema.groups };\n}\n\n/** Resolve `path` into frames. Stops at the first segment that doesn't resolve (returns the valid prefix). */\nexport function resolveFrames(\n  schema: TypeSchema,\n  value: unknown,\n  path: FieldPath,\n  resolveSchema?: (t: string) => TypeSchema | undefined,\n): { frames: Frame[]; path: FieldPath } {\n  const frames: Frame[] = [rootFrame(schema)];\n  let fields = schema.fields;\n  let i = 0;\n  while (i < path.length) {\n    const seg = path[i];\n    if (typeof seg !== \"string\") break;\n    const f = fields.find((x) => x.name === seg);\n    if (!f) break;\n    const here = path.slice(0, i + 1);\n    if (path[i + 1] === HISTORY_SEGMENT) {\n      frames.push({ path: [...here, HISTORY_SEGMENT], kind: \"history\", title: \"History\", icon: \"clock\", fields: [f], field: f });\n      i += 2;\n      break;\n    }\n    if (f.type === \"object\" && f.fields) {\n      frames.push({ path: here, kind: \"object\", title: f.title, icon: f.icon, fields: f.fields, field: f });\n      fields = f.fields;\n      i += 1;\n      continue;\n    }\n    if (f.type === \"button\") {\n      frames.push({ path: here, kind: \"button\", title: f.title, icon: \"click\", fields: [f], field: f });\n      i += 1;\n      // a button screen is a leaf, except for its own history\n      if (path[i] === HISTORY_SEGMENT) {\n        frames.push({ path: [...here, HISTORY_SEGMENT], kind: \"history\", title: \"History\", icon: \"clock\", fields: [f], field: f });\n        i += 1;\n      }\n      break;\n    }\n    /* D50: a table's rows and columns drill like array items. A row inside a row group gets the group as a crumb\n       (its path is the table field, which resolves back to the frame that shows the table). */\n    if (f.type === \"table\" && (path[i + 1] === \"rows\" || path[i + 1] === \"columns\") && typeof path[i + 2] === \"number\") {\n      const raw = getIn(value, here);\n      if (!isTableValue(raw)) break;\n      const t = normalizeTable(raw);\n      const idx = path[i + 2] as number;\n      const arrayPath = [...here, path[i + 1]];\n      if (path[i + 1] === \"rows\") {\n        const row = t.rows[idx];\n        if (!row) break;\n        const group = row.group && !row.footer ? t.rowGroups?.find((g) => g._key === row.group) : undefined;\n        if (group) frames.push({ path: here, kind: \"tableGroup\", title: group.label || \"Untitled group\", icon: \"folder\", fields: [], field: f });\n        const first = t.columns[0];\n        const titleAt = (j: number) => {\n          const r = t.rows[j];\n          return (r && first && cellText(first, r, r.cells[first._key])) || \"Untitled row\";\n        };\n        frames.push({\n          path: [...arrayPath, idx], kind: \"tableRow\", title: titleAt(idx), icon: \"list\", fields: [], field: f,\n          item: { arrayPath, index: idx, count: t.rows.length, itemSchema: { name: \"row\", title: \"Row\", type: \"object\" }, titleAt },\n        });\n      } else {\n        const col = t.columns[idx];\n        if (!col) break;\n        const titleAt = (j: number) => t.columns[j]?.label || \"Untitled column\";\n        frames.push({\n          path: [...arrayPath, idx], kind: \"tableColumn\", title: titleAt(idx), icon: \"layout-columns\", fields: [], field: f,\n          item: { arrayPath, index: idx, count: t.columns.length, itemSchema: { name: \"column\", title: \"Column\", type: \"object\" }, titleAt },\n        });\n      }\n      i += 3;\n      break;\n    }\n    if ((f.type === \"array\" || f.type === \"slot\") && typeof path[i + 1] === \"number\") {\n      const idx = path[i + 1] as number;\n      const list = getIn(value, here);\n      const items = Array.isArray(list) ? list : [];\n      const item = items[idx];\n      if (item === undefined) break;\n      const itemPath = [...here, idx];\n      if (f.type === \"array\") {\n        const s = itemSchemaFor(f, item);\n        if (!s || isPrimitive(s.type) || !s.fields) break;\n        const pv = previewOf(s, item, idx);\n        frames.push({\n          path: itemPath, kind: \"item\", title: pv.title, icon: s.icon ?? f.icon, fields: s.fields, field: f,\n          item: { arrayPath: here, index: idx, count: items.length, itemSchema: s },\n        });\n        fields = s.fields;\n      } else {\n        const type = isObj(item) && typeof item._type === \"string\" ? item._type : \"\";\n        const block = resolveSchema?.(type);\n        if (!block) break;\n        const pv = previewOf(block, item, idx, block.title);\n        frames.push({\n          path: itemPath, kind: \"block\", title: pv.empty ? block.title : pv.title, icon: block.icon, fields: block.fields,\n          fieldsets: block.fieldsets, groups: block.groups, field: f,\n          item: { arrayPath: here, index: idx, count: items.length, block, slotField: f },\n        });\n        fields = block.fields;\n      }\n      i += 2;\n      continue;\n    }\n    break;\n  }\n  return { frames, path: frames.length > 1 ? frames[frames.length - 1].path : [] };\n}\n\n/** Can this field be opened as its own frame (drill target)? */\nexport const isDrillable = (f: FieldSchema) => f.type === \"object\" || f.type === \"button\";\n"],"mappings":"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"}

package/lib/icons.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Icon names in schemas are kebab-case Tabler names ("help-circle", "layout-grid"). Catalog data still
+ * carries lucide-style names ("CircleHelp", "LayoutGrid"); `kitIcon()` resolves both.
+ * The curated set doubles as the icon picker's library (explicit imports keep the bundle small).
+ */
+import { type Icon } from "@tabler/icons-react";
+export declare const KIT_ICONS: Record<string, Icon>;
+export declare function iconKey(name?: string): string | undefined;
+/** Render a schema icon by name. Falls back to `fallback` (default: a neutral square). */
+export declare function KitIcon({ name, className, fallback }: {
+    name?: string;
+    className?: string;
+    fallback?: string;
+}): import("react/jsx-runtime").JSX.Element;
+/** Human label for an icon key: "help-circle" → "Help circle". */
+export declare const iconLabel: (k: string) => string;

package/lib/icons.js

@@ -0,0 +1,172 @@
+import { IconAdjustments, IconAlertTriangle, IconAppWindow, IconArrowRight, IconArrowUpRight, IconAward, IconBadge, IconBolt, IconBook, IconBookmark, IconBox, IconBrandInstagram, IconBrandYoutube, IconBriefcase, IconBuildingStore, IconBulb, IconCalendar, IconCamera, IconCampfire, IconCards, IconCategory, IconChartBar, IconChartPie, IconCheck, IconChefHat, IconCircleCheck, IconClick, IconClipboardList, IconClock, IconCloud, IconCode, IconColumns2, IconColumns3, IconCompass, IconCreditCard, IconCurrencyDollar, IconCursorText, IconDeviceMobile, IconDiamond, IconDownload, IconFeather, IconFile, IconFileText, IconFilter, IconFlag, IconFlame, IconFolder, IconForms, IconGift, IconGlobe, IconHeart, IconHelpCircle, IconHome, IconInfoCircle, IconKey, IconLayoutBottombar, IconLayoutCards, IconLayoutColumns, IconLayoutDashboard, IconLayoutGrid, IconLayoutList, IconLayoutNavbar, IconLayoutSidebar, IconLeaf, IconLibraryPhoto, IconLink, IconList, IconListDetails, IconLock, IconMail, IconMap, IconMapPin, IconMenu2, IconMessage, IconMessage2, IconMoon, IconMountain, IconMovie, IconNews, IconPackage, IconPalette, IconPhoto, IconPlayerPlay, IconPlug, IconPresentation, IconPuzzle, IconQuote, IconRecycle, IconRocket, IconRuler, IconSearch, IconSection, IconSeo, IconSettings, IconShieldCheck, IconShoppingBag, IconShoppingCart, IconSparkles, IconSpeakerphone, IconSquareRoundedPlus, IconStack2, IconStar, IconSun, IconTable, IconTag, IconTags, IconTarget, IconTemplate, IconTent, IconToggleLeft, IconTool, IconTools, IconTruck, IconTypography, IconUser, IconUsers, IconUsersGroup, IconVideo, IconWorld } from "@tabler/icons-react";
+import { jsx } from "react/jsx-runtime";
+//#region src/kit/lib/icons.tsx
+/**
+* Icon names in schemas are kebab-case Tabler names ("help-circle", "layout-grid"). Catalog data still
+* carries lucide-style names ("CircleHelp", "LayoutGrid"); `kitIcon()` resolves both.
+* The curated set doubles as the icon picker's library (explicit imports keep the bundle small).
+*/
+var KIT_ICONS = {
+	"alert-triangle": IconAlertTriangle,
+	"app-window": IconAppWindow,
+	"arrow-right": IconArrowRight,
+	"arrow-up-right": IconArrowUpRight,
+	award: IconAward,
+	badge: IconBadge,
+	bolt: IconBolt,
+	book: IconBook,
+	bookmark: IconBookmark,
+	box: IconBox,
+	instagram: IconBrandInstagram,
+	briefcase: IconBriefcase,
+	store: IconBuildingStore,
+	bulb: IconBulb,
+	calendar: IconCalendar,
+	camera: IconCamera,
+	campfire: IconCampfire,
+	cards: IconCards,
+	"chart-bar": IconChartBar,
+	"chart-pie": IconChartPie,
+	check: IconCheck,
+	"chef-hat": IconChefHat,
+	"circle-check": IconCircleCheck,
+	click: IconClick,
+	clock: IconClock,
+	cloud: IconCloud,
+	code: IconCode,
+	"columns-2": IconColumns2,
+	"columns-3": IconColumns3,
+	compass: IconCompass,
+	"credit-card": IconCreditCard,
+	"currency-dollar": IconCurrencyDollar,
+	"device-mobile": IconDeviceMobile,
+	diamond: IconDiamond,
+	download: IconDownload,
+	feather: IconFeather,
+	file: IconFile,
+	"file-text": IconFileText,
+	filter: IconFilter,
+	flag: IconFlag,
+	flame: IconFlame,
+	forms: IconForms,
+	gift: IconGift,
+	globe: IconGlobe,
+	heart: IconHeart,
+	"help-circle": IconHelpCircle,
+	home: IconHome,
+	"info-circle": IconInfoCircle,
+	key: IconKey,
+	"layout-bottombar": IconLayoutBottombar,
+	"layout-cards": IconLayoutCards,
+	"layout-grid": IconLayoutGrid,
+	"layout-navbar": IconLayoutNavbar,
+	"layout-sidebar": IconLayoutSidebar,
+	"layout-list": IconLayoutList,
+	leaf: IconLeaf,
+	"library-photo": IconLibraryPhoto,
+	link: IconLink,
+	list: IconList,
+	"list-details": IconListDetails,
+	lock: IconLock,
+	mail: IconMail,
+	map: IconMap,
+	"map-pin": IconMapPin,
+	menu: IconMenu2,
+	message: IconMessage,
+	"message-2": IconMessage2,
+	moon: IconMoon,
+	mountain: IconMountain,
+	movie: IconMovie,
+	news: IconNews,
+	package: IconPackage,
+	palette: IconPalette,
+	photo: IconPhoto,
+	"player-play": IconPlayerPlay,
+	plug: IconPlug,
+	presentation: IconPresentation,
+	puzzle: IconPuzzle,
+	quote: IconQuote,
+	recycle: IconRecycle,
+	rocket: IconRocket,
+	ruler: IconRuler,
+	search: IconSearch,
+	seo: IconSeo,
+	settings: IconSettings,
+	"shield-check": IconShieldCheck,
+	"shopping-bag": IconShoppingBag,
+	"shopping-cart": IconShoppingCart,
+	sparkles: IconSparkles,
+	speakerphone: IconSpeakerphone,
+	stack: IconStack2,
+	star: IconStar,
+	sun: IconSun,
+	table: IconTable,
+	tag: IconTag,
+	tags: IconTags,
+	target: IconTarget,
+	template: IconTemplate,
+	tent: IconTent,
+	tool: IconTool,
+	tools: IconTools,
+	truck: IconTruck,
+	typography: IconTypography,
+	user: IconUser,
+	users: IconUsers,
+	"users-group": IconUsersGroup,
+	video: IconVideo,
+	world: IconWorld,
+	"square-plus": IconSquareRoundedPlus,
+	"layout-dashboard": IconLayoutDashboard,
+	adjustments: IconAdjustments,
+	"layout-columns": IconLayoutColumns,
+	section: IconSection,
+	category: IconCategory,
+	toggle: IconToggleLeft,
+	"cursor-text": IconCursorText,
+	youtube: IconBrandYoutube,
+	folder: IconFolder,
+	"clipboard-list": IconClipboardList
+};
+/** lucide-style names used by seed/catalog data → our kebab keys. */
+var ALIASES = {
+	"circle-help": "help-circle",
+	megaphone: "speakerphone",
+	"panel-top": "layout-navbar",
+	"panel-bottom": "layout-bottombar",
+	"layout-template": "template",
+	"bar-chart-3": "chart-bar",
+	"badge-dollar-sign": "currency-dollar",
+	newspaper: "news",
+	"mouse-pointer-click": "click",
+	images: "library-photo",
+	"message-square-text": "message-2",
+	type: "typography",
+	"shield-check": "shield-check",
+	"shopping-bag": "shopping-bag",
+	"columns-2": "columns-2",
+	"layout-grid": "layout-grid",
+	"help-circle": "help-circle",
+	sparkle: "sparkles"
+};
+var kebab = (s) => s.replace(/^Icon/, "").replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/([A-Z])([A-Z][a-z])/g, "$1-$2").replace(/[_\s]+/g, "-").toLowerCase();
+function iconKey(name) {
+	if (!name) return void 0;
+	const k = kebab(name);
+	if (KIT_ICONS[k]) return k;
+	const a = ALIASES[k];
+	return a && KIT_ICONS[a] ? a : void 0;
+}
+/** Render a schema icon by name. Falls back to `fallback` (default: a neutral square). */
+function KitIcon({ name, className, fallback = "box" }) {
+	return /* @__PURE__ */ jsx(KIT_ICONS[iconKey(name) ?? fallback] ?? IconBox, {
+		className,
+		stroke: 1.5,
+		"aria-hidden": true
+	});
+}
+/** Human label for an icon key: "help-circle" → "Help circle". */
+var iconLabel = (k) => (k.charAt(0).toUpperCase() + k.slice(1)).replace(/-/g, " ");
+//#endregion
+export { KIT_ICONS, KitIcon, iconKey, iconLabel };
+
+//# sourceMappingURL=icons.js.map

package/lib/icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.js","names":[],"sources":["../../src/kit/lib/icons.tsx"],"sourcesContent":["/**\n * Icon names in schemas are kebab-case Tabler names (\"help-circle\", \"layout-grid\"). Catalog data still\n * carries lucide-style names (\"CircleHelp\", \"LayoutGrid\"); `kitIcon()` resolves both.\n * The curated set doubles as the icon picker's library (explicit imports keep the bundle small).\n */\nimport {\n  IconAlertTriangle, IconAppWindow, IconArrowRight, IconArrowUpRight, IconAward, IconBadge, IconBolt, IconBook, IconBookmark,\n  IconBox, IconBrandInstagram, IconBriefcase, IconBuildingStore, IconBulb, IconCalendar, IconCamera, IconCampfire, IconCards,\n  IconChartBar, IconChartPie, IconCheck, IconChefHat, IconCircleCheck, IconClick, IconClock, IconCloud, IconCode, IconColumns2,\n  IconColumns3, IconCompass, IconCreditCard, IconCurrencyDollar, IconDeviceMobile, IconDiamond, IconDownload, IconFeather,\n  IconFile, IconFileText, IconFilter, IconFlag, IconFlame, IconForms, IconGift, IconGlobe, IconHeart, IconHelpCircle, IconHome,\n  IconInfoCircle, IconKey, IconLayoutBottombar, IconLayoutCards, IconLayoutGrid, IconLayoutNavbar, IconLayoutSidebar,\n  IconLayoutList, IconLeaf, IconLibraryPhoto, IconLink, IconList, IconListDetails, IconLock, IconMail, IconMap, IconMapPin,\n  IconMenu2, IconMessage, IconMessage2, IconMoon, IconMountain, IconMovie, IconNews, IconPackage, IconPalette, IconPhoto,\n  IconPlayerPlay, IconPlug, IconPresentation, IconPuzzle, IconQuote, IconRecycle, IconRocket, IconRuler, IconSearch, IconSeo,\n  IconSettings, IconShieldCheck, IconShoppingBag, IconShoppingCart, IconSparkles, IconSpeakerphone, IconStack2, IconStar,\n  IconSun, IconTable, IconTag, IconTags, IconTarget, IconTemplate, IconTent, IconTool, IconTools, IconTruck, IconTypography,\n  IconUser, IconUsers, IconUsersGroup, IconVideo, IconWorld, IconSquareRoundedPlus, IconLayoutDashboard, IconAdjustments,\n  IconLayoutColumns, IconSection, IconCategory, IconToggleLeft, IconCursorText, IconBrandYoutube, IconFolder, IconClipboardList,\n  type Icon,\n} from \"@tabler/icons-react\";\n\nexport const KIT_ICONS: Record<string, Icon> = {\n  \"alert-triangle\": IconAlertTriangle, \"app-window\": IconAppWindow, \"arrow-right\": IconArrowRight, \"arrow-up-right\": IconArrowUpRight,\n  award: IconAward, badge: IconBadge, bolt: IconBolt, book: IconBook, bookmark: IconBookmark, box: IconBox, instagram: IconBrandInstagram,\n  briefcase: IconBriefcase, store: IconBuildingStore, bulb: IconBulb, calendar: IconCalendar, camera: IconCamera, campfire: IconCampfire,\n  cards: IconCards, \"chart-bar\": IconChartBar, \"chart-pie\": IconChartPie, check: IconCheck, \"chef-hat\": IconChefHat,\n  \"circle-check\": IconCircleCheck, click: IconClick, clock: IconClock, cloud: IconCloud, code: IconCode, \"columns-2\": IconColumns2,\n  \"columns-3\": IconColumns3, compass: IconCompass, \"credit-card\": IconCreditCard, \"currency-dollar\": IconCurrencyDollar,\n  \"device-mobile\": IconDeviceMobile, diamond: IconDiamond, download: IconDownload, feather: IconFeather, file: IconFile,\n  \"file-text\": IconFileText, filter: IconFilter, flag: IconFlag, flame: IconFlame, forms: IconForms, gift: IconGift, globe: IconGlobe,\n  heart: IconHeart, \"help-circle\": IconHelpCircle, home: IconHome, \"info-circle\": IconInfoCircle, key: IconKey,\n  \"layout-bottombar\": IconLayoutBottombar, \"layout-cards\": IconLayoutCards, \"layout-grid\": IconLayoutGrid, \"layout-navbar\": IconLayoutNavbar,\n  \"layout-sidebar\": IconLayoutSidebar, \"layout-list\": IconLayoutList, leaf: IconLeaf, \"library-photo\": IconLibraryPhoto, link: IconLink,\n  list: IconList, \"list-details\": IconListDetails, lock: IconLock, mail: IconMail, map: IconMap, \"map-pin\": IconMapPin, menu: IconMenu2,\n  message: IconMessage, \"message-2\": IconMessage2, moon: IconMoon, mountain: IconMountain, movie: IconMovie, news: IconNews,\n  package: IconPackage, palette: IconPalette, photo: IconPhoto, \"player-play\": IconPlayerPlay, plug: IconPlug, presentation: IconPresentation,\n  puzzle: IconPuzzle, quote: IconQuote, recycle: IconRecycle, rocket: IconRocket, ruler: IconRuler, search: IconSearch, seo: IconSeo,\n  settings: IconSettings, \"shield-check\": IconShieldCheck, \"shopping-bag\": IconShoppingBag, \"shopping-cart\": IconShoppingCart,\n  sparkles: IconSparkles, speakerphone: IconSpeakerphone, stack: IconStack2, star: IconStar, sun: IconSun, table: IconTable, tag: IconTag,\n  tags: IconTags, target: IconTarget, template: IconTemplate, tent: IconTent, tool: IconTool, tools: IconTools, truck: IconTruck,\n  typography: IconTypography, user: IconUser, users: IconUsers, \"users-group\": IconUsersGroup, video: IconVideo, world: IconWorld,\n  \"square-plus\": IconSquareRoundedPlus, \"layout-dashboard\": IconLayoutDashboard, adjustments: IconAdjustments,\n  \"layout-columns\": IconLayoutColumns, section: IconSection, category: IconCategory, toggle: IconToggleLeft, \"cursor-text\": IconCursorText,\n  youtube: IconBrandYoutube, folder: IconFolder, \"clipboard-list\": IconClipboardList,\n};\n\n/** lucide-style names used by seed/catalog data → our kebab keys. */\nconst ALIASES: Record<string, string> = {\n  \"circle-help\": \"help-circle\", megaphone: \"speakerphone\", \"panel-top\": \"layout-navbar\", \"panel-bottom\": \"layout-bottombar\",\n  \"layout-template\": \"template\", \"bar-chart-3\": \"chart-bar\", \"badge-dollar-sign\": \"currency-dollar\", newspaper: \"news\",\n  \"mouse-pointer-click\": \"click\", images: \"library-photo\", \"message-square-text\": \"message-2\", type: \"typography\",\n  \"shield-check\": \"shield-check\", \"shopping-bag\": \"shopping-bag\", \"columns-2\": \"columns-2\", \"layout-grid\": \"layout-grid\",\n  \"help-circle\": \"help-circle\", sparkle: \"sparkles\",\n};\n\nconst kebab = (s: string) =>\n  s.replace(/^Icon/, \"\").replace(/([a-z0-9])([A-Z])/g, \"$1-$2\").replace(/([A-Z])([A-Z][a-z])/g, \"$1-$2\").replace(/[_\\s]+/g, \"-\").toLowerCase();\n\nexport function iconKey(name?: string): string | undefined {\n  if (!name) return undefined;\n  const k = kebab(name);\n  if (KIT_ICONS[k]) return k;\n  const a = ALIASES[k];\n  return a && KIT_ICONS[a] ? a : undefined;\n}\n\n/** Render a schema icon by name. Falls back to `fallback` (default: a neutral square). */\nexport function KitIcon({ name, className, fallback = \"box\" }: { name?: string; className?: string; fallback?: string }) {\n  const I = KIT_ICONS[iconKey(name) ?? fallback] ?? IconBox;\n  return <I className={className} stroke={1.5} aria-hidden />;\n}\n\n/** Human label for an icon key: \"help-circle\" → \"Help circle\". */\nexport const iconLabel = (k: string) => (k.charAt(0).toUpperCase() + k.slice(1)).replace(/-/g, \" \");\n"],"mappings":"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"}

package/lib/path.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Immutable path helpers. A path addresses any value inside a document/block:
+ *   ["items", 1, "answer"]  ·  ["tabs", 0, "content", 2, "heading"]  ·  ["title", "@history"]
+ * Writes share structure (only the spine is copied), so callers can diff top-level keys by identity.
+ */
+import type { FieldPath } from "../schema/types";
+type Obj = Record<string, unknown>;
+export declare const isObj: (v: unknown) => v is Obj;
+export declare function getIn(root: unknown, path: FieldPath): unknown;
+export declare function setIn<T>(root: T, path: FieldPath, value: unknown): T;
+/** "items.1.answer" — stable string key for maps (issues, presence, comments, history). */
+export declare const pathKey: (p: FieldPath) => string;
+/**
+ * The key of a frame (AnimatePresence key, `data-frame-body`, scroll memory, crumb key): "root" for the root frame,
+ * else the path key. V2 used `pathKey(p) || "root"`, which collides when a root field is itself named `root`; that one
+ * case gets ".root", which no field path can produce (kit deviation, identical output for every other path).
+ */
+export declare const frameKeyOf: (p: FieldPath) => string;
+export declare const pathEq: (a: FieldPath, b: FieldPath) => boolean;
+/** `prefix` is an ancestor of (or equal to) `p`. */
+export declare const isPrefix: (prefix: FieldPath, p: FieldPath) => boolean;
+export declare const keyStartsWith: (key: string, prefix: string) => boolean;
+export declare const same: (a: unknown, b: unknown) => boolean;
+export declare const newKey: () => string;
+/** Give every object item a `_key` (stable identity for drag and layout animation). Returns the same array when nothing changed. */
+export declare function ensureKeys<T>(items: T[]): T[];
+/** A stable React/dnd id for an item (objects use `_key`, primitives their index). */
+export declare const itemId: (it: unknown, i: number) => string;
+export {};

package/lib/path.js

@@ -0,0 +1,64 @@
+//#region src/kit/lib/path.ts
+var isObj = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+function getIn(root, path) {
+	let cur = root;
+	for (const seg of path) {
+		if (cur == null) return void 0;
+		if (typeof seg === "number") cur = Array.isArray(cur) ? cur[seg] : void 0;
+		else cur = isObj(cur) ? cur[seg] : void 0;
+	}
+	return cur;
+}
+function setIn(root, path, value) {
+	if (path.length === 0) return value;
+	const [head, ...rest] = path;
+	if (typeof head === "number") {
+		const arr = Array.isArray(root) ? root.slice() : [];
+		arr[head] = setIn(arr[head], rest, value);
+		return arr;
+	}
+	const obj = isObj(root) ? { ...root } : {};
+	obj[head] = setIn(obj[head], rest, value);
+	return obj;
+}
+/** "items.1.answer" — stable string key for maps (issues, presence, comments, history). */
+var pathKey = (p) => p.join(".");
+/**
+* The key of a frame (AnimatePresence key, `data-frame-body`, scroll memory, crumb key): "root" for the root frame,
+* else the path key. V2 used `pathKey(p) || "root"`, which collides when a root field is itself named `root`; that one
+* case gets ".root", which no field path can produce (kit deviation, identical output for every other path).
+*/
+var frameKeyOf = (p) => p.length === 0 ? "root" : p.length === 1 && p[0] === "root" ? ".root" : pathKey(p);
+var pathEq = (a, b) => a.length === b.length && a.every((s, i) => s === b[i]);
+var keyStartsWith = (key, prefix) => prefix === "" || key === prefix || key.startsWith(`${prefix}.`);
+var same = (a, b) => {
+	if (a === b) return true;
+	try {
+		return JSON.stringify(a ?? null) === JSON.stringify(b ?? null);
+	} catch {
+		return false;
+	}
+};
+var seq = 0;
+var newKey = () => `k${Date.now().toString(36).slice(-4)}${(seq++).toString(36)}${Math.random().toString(36).slice(2, 5)}`;
+/** Give every object item a `_key` (stable identity for drag and layout animation). Returns the same array when nothing changed. */
+function ensureKeys(items) {
+	let changed = false;
+	const out = items.map((it) => {
+		if (isObj(it) && typeof it._key !== "string") {
+			changed = true;
+			return {
+				_key: newKey(),
+				...it
+			};
+		}
+		return it;
+	});
+	return changed ? out : items;
+}
+/** A stable React/dnd id for an item (objects use `_key`, primitives their index). */
+var itemId = (it, i) => isObj(it) && typeof it._key === "string" ? it._key : `i${i}`;
+//#endregion
+export { ensureKeys, frameKeyOf, getIn, isObj, itemId, keyStartsWith, newKey, pathEq, pathKey, same, setIn };
+
+//# sourceMappingURL=path.js.map

package/lib/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","names":[],"sources":["../../src/kit/lib/path.ts"],"sourcesContent":["/**\n * Immutable path helpers. A path addresses any value inside a document/block:\n *   [\"items\", 1, \"answer\"]  ·  [\"tabs\", 0, \"content\", 2, \"heading\"]  ·  [\"title\", \"@history\"]\n * Writes share structure (only the spine is copied), so callers can diff top-level keys by identity.\n */\nimport type { FieldPath } from \"../schema/types\";\n\ntype Obj = Record<string, unknown>;\n\nexport const isObj = (v: unknown): v is Obj => !!v && typeof v === \"object\" && !Array.isArray(v);\n\nexport function getIn(root: unknown, path: FieldPath): unknown {\n  let cur: unknown = root;\n  for (const seg of path) {\n    if (cur == null) return undefined;\n    if (typeof seg === \"number\") cur = Array.isArray(cur) ? cur[seg] : undefined;\n    else cur = isObj(cur) ? cur[seg] : undefined;\n  }\n  return cur;\n}\n\nexport function setIn<T>(root: T, path: FieldPath, value: unknown): T {\n  if (path.length === 0) return value as T;\n  const [head, ...rest] = path;\n  if (typeof head === \"number\") {\n    const arr = Array.isArray(root) ? root.slice() : [];\n    arr[head] = setIn(arr[head], rest, value);\n    return arr as unknown as T;\n  }\n  const obj: Obj = isObj(root) ? { ...root } : {};\n  obj[head] = setIn(obj[head], rest, value);\n  return obj as T;\n}\n\n/** \"items.1.answer\" — stable string key for maps (issues, presence, comments, history). */\nexport const pathKey = (p: FieldPath) => p.join(\".\");\n/**\n * The key of a frame (AnimatePresence key, `data-frame-body`, scroll memory, crumb key): \"root\" for the root frame,\n * else the path key. V2 used `pathKey(p) || \"root\"`, which collides when a root field is itself named `root`; that one\n * case gets \".root\", which no field path can produce (kit deviation, identical output for every other path).\n */\nexport const frameKeyOf = (p: FieldPath) => (p.length === 0 ? \"root\" : p.length === 1 && p[0] === \"root\" ? \".root\" : pathKey(p));\nexport const pathEq = (a: FieldPath, b: FieldPath) => a.length === b.length && a.every((s, i) => s === b[i]);\n/** `prefix` is an ancestor of (or equal to) `p`. */\nexport const isPrefix = (prefix: FieldPath, p: FieldPath) => prefix.length <= p.length && prefix.every((s, i) => s === p[i]);\nexport const keyStartsWith = (key: string, prefix: string) => prefix === \"\" || key === prefix || key.startsWith(`${prefix}.`);\n\nexport const same = (a: unknown, b: unknown) => {\n  if (a === b) return true;\n  try {\n    return JSON.stringify(a ?? null) === JSON.stringify(b ?? null);\n  } catch {\n    return false;\n  }\n};\n\nlet seq = 0;\nexport const newKey = () => `k${Date.now().toString(36).slice(-4)}${(seq++).toString(36)}${Math.random().toString(36).slice(2, 5)}`;\n\n/** Give every object item a `_key` (stable identity for drag and layout animation). Returns the same array when nothing changed. */\nexport function ensureKeys<T>(items: T[]): T[] {\n  let changed = false;\n  const out = items.map((it) => {\n    if (isObj(it) && typeof it._key !== \"string\") {\n      changed = true;\n      return { _key: newKey(), ...it } as T;\n    }\n    return it;\n  });\n  return changed ? out : items;\n}\n\n/** A stable React/dnd id for an item (objects use `_key`, primitives their index). */\nexport const itemId = (it: unknown, i: number) => (isObj(it) && typeof it._key === \"string\" ? it._key : `i${i}`);\n"],"mappings":";AASA,IAAa,SAAS,MAAyB,CAAC,CAAC,KAAK,OAAO,MAAM,YAAY,CAAC,MAAM,QAAQ,EAAE;AAEhG,SAAgB,MAAM,MAAe,MAA0B;CAC7D,IAAI,MAAe;AACnB,MAAK,MAAM,OAAO,MAAM;AACtB,MAAI,OAAO,KAAM,QAAO,KAAA;AACxB,MAAI,OAAO,QAAQ,SAAU,OAAM,MAAM,QAAQ,IAAI,GAAG,IAAI,OAAO,KAAA;MAC9D,OAAM,MAAM,IAAI,GAAG,IAAI,OAAO,KAAA;;AAErC,QAAO;;AAGT,SAAgB,MAAS,MAAS,MAAiB,OAAmB;AACpE,KAAI,KAAK,WAAW,EAAG,QAAO;CAC9B,MAAM,CAAC,MAAM,GAAG,QAAQ;AACxB,KAAI,OAAO,SAAS,UAAU;EAC5B,MAAM,MAAM,MAAM,QAAQ,KAAK,GAAG,KAAK,OAAO,GAAG,EAAE;AACnD,MAAI,QAAQ,MAAM,IAAI,OAAO,MAAM,MAAM;AACzC,SAAO;;CAET,MAAM,MAAW,MAAM,KAAK,GAAG,EAAE,GAAG,MAAM,GAAG,EAAE;AAC/C,KAAI,QAAQ,MAAM,IAAI,OAAO,MAAM,MAAM;AACzC,QAAO;;;AAIT,IAAa,WAAW,MAAiB,EAAE,KAAK,IAAI;;;;;;AAMpD,IAAa,cAAc,MAAkB,EAAE,WAAW,IAAI,SAAS,EAAE,WAAW,KAAK,EAAE,OAAO,SAAS,UAAU,QAAQ,EAAE;AAC/H,IAAa,UAAU,GAAc,MAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,MAAM,EAAE,GAAG;AAG5G,IAAa,iBAAiB,KAAa,WAAmB,WAAW,MAAM,QAAQ,UAAU,IAAI,WAAW,GAAG,OAAO,GAAG;AAE7H,IAAa,QAAQ,GAAY,MAAe;AAC9C,KAAI,MAAM,EAAG,QAAO;AACpB,KAAI;AACF,SAAO,KAAK,UAAU,KAAK,KAAK,KAAK,KAAK,UAAU,KAAK,KAAK;SACxD;AACN,SAAO;;;AAIX,IAAI,MAAM;AACV,IAAa,eAAe,IAAI,KAAK,KAAK,CAAC,SAAS,GAAG,CAAC,MAAM,GAAG,IAAI,OAAO,SAAS,GAAG,GAAG,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE;;AAGjI,SAAgB,WAAc,OAAiB;CAC7C,IAAI,UAAU;CACd,MAAM,MAAM,MAAM,KAAK,OAAO;AAC5B,MAAI,MAAM,GAAG,IAAI,OAAO,GAAG,SAAS,UAAU;AAC5C,aAAU;AACV,UAAO;IAAE,MAAM,QAAQ;IAAE,GAAG;IAAI;;AAElC,SAAO;GACP;AACF,QAAO,UAAU,MAAM;;;AAIzB,IAAa,UAAU,IAAa,MAAe,MAAM,GAAG,IAAI,OAAO,GAAG,SAAS,WAAW,GAAG,OAAO,IAAI"}

package/lib/schema.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Schema helpers — pure functions the engine uses to decide HOW a field is edited and WHAT a row shows.
+ */
+import type { FieldSchema, OpenMode, SchemaType, TypeSchema } from "../schema/types";
+export declare const isPrimitive: (t: SchemaType) => boolean;
+/** Types whose value is plain text (counters, AI rewrite, copy/paste as text). */
+export declare const isTextual: (t: SchemaType) => t is "string" | "text" | "richtext" | "slug" | "email" | "url";
+export declare const itemSchemas: (f: FieldSchema) => FieldSchema[];
+export declare const slotAllow: (f: FieldSchema) => string[] | undefined;
+export declare const itemSchemaFor: (f: FieldSchema, item: unknown) => FieldSchema | undefined;
+/** An array whose single item type is a primitive (tags, gallery, references, list of strings). */
+export declare const primitiveItem: (f: FieldSchema) => FieldSchema | undefined;
+export declare const isSmallObject: (fields?: FieldSchema[]) => boolean;
+/** How an object field / array item opens (CPO D8: inline for ≤3 primitives, else drill). */
+export declare function objectOpenMode(f: FieldSchema): OpenMode;
+/**
+ * CPO D43 — one rule for rows: an item of ≤3 simple fields (text, number, switch, select, colour, icon, url, email,
+ * date, rating, slug) EXPANDS inline under its row; anything bigger, nested or rich DRILLS into its own frame.
+ * `openMode` on the array still wins (developer override). Several item types → drill (they rarely share a shape).
+ */
+export declare function itemOpenMode(arrayField: FieldSchema): OpenMode;
+export declare function emptyFor(f: FieldSchema): unknown;
+export declare const initialFor: (f: FieldSchema) => unknown;
+export declare function objectInitial(fields: FieldSchema[]): Record<string, unknown>;
+/** A new array item for `itemSchema` (stamped with `_key` and, when the array allows several types, `_type`). */
+export declare function newItem(arrayField: FieldSchema, itemSchema: FieldSchema): unknown;
+export declare function newBlock(block: TypeSchema, settings?: FieldSchema[]): Record<string, unknown>;
+export declare function structuredCloneSafe<T>(v: T): T;
+/** `hidden: true` hides; a Condition SHOWS the field only when the sibling matches (types.ts contract). */
+export declare function isHidden(f: FieldSchema, parent: unknown): boolean;
+/**
+ * A value as one line of text. Stored rich text reads as its words in every shape production keeps: an html string,
+ * Portable Text blocks, and the component props envelope `{ content: { version, content: blocks }, html }`.
+ */
+export declare const plainText: (v: unknown) => string;
+export declare function isEmptyValue(v: unknown): boolean;
+export declare const imageUrl: (v: unknown) => string | undefined;
+/** Singular noun for an array's items: itemNoun → item title → field title minus "s". */
+export declare function itemNoun(f: FieldSchema): string;
+export interface Preview {
+    title: string;
+    subtitle?: string;
+    media?: string;
+    icon?: string;
+    empty: boolean;
+}
+export declare function previewOf(itemSchema: FieldSchema | TypeSchema | undefined, item: unknown, index: number, fallbackTitle?: string): Preview;
+/** "Cast iron · 4 items" — one-line summary of an object for collapsed rows and fieldset headers. */
+export declare function summarize(fields: FieldSchema[], v: unknown, max?: number): string;