@bettercms-ai/kit 0.1.1 → 2.0.0

package/dist/lib/icons.js

@@ -0,0 +1,173 @@
+import { jsx } from "react/jsx-runtime";
+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";
+//#region src/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" }) {
+	const I = KIT_ICONS[iconKey(name) ?? fallback] ?? IconBox;
+	return /* @__PURE__ */ jsx(I, {
+		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/dist/lib/icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.js","names":[],"sources":["../../src/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/dist/lib/input-modality.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Keyboard-only focus rings (D29, founder rule "never a dark box after a mouse click", DESIGN.md 3.7).
+ *
+ * `:focus-visible` alone isn't enough: Base UI returns focus to a trigger programmatically when a menu or popover
+ * closes, and Chrome/Safari can paint the ring there even though the user only ever used the mouse. We record the
+ * last input modality on <html data-input-modality> and the stylesheet suppresses rings while it is "pointer".
+ */
+export declare const NAV_KEYS: ReadonlySet<string>;
+export type InputModality = "pointer" | "keyboard";
+/** Starts tracking; returns a function that stops it. Safe to call during SSR (no-op). */
+export declare function trackInputModality(): () => void;

package/dist/lib/input-modality.js

@@ -0,0 +1,47 @@
+//#region src/lib/input-modality.ts
+/**
+* Keyboard-only focus rings (D29, founder rule "never a dark box after a mouse click", DESIGN.md 3.7).
+*
+* `:focus-visible` alone isn't enough: Base UI returns focus to a trigger programmatically when a menu or popover
+* closes, and Chrome/Safari can paint the ring there even though the user only ever used the mouse. We record the
+* last input modality on <html data-input-modality> and the stylesheet suppresses rings while it is "pointer".
+*/
+var NAV_KEYS = /* @__PURE__ */ new Set([
+	"Tab",
+	"ArrowUp",
+	"ArrowDown",
+	"ArrowLeft",
+	"ArrowRight",
+	"Enter",
+	" ",
+	"Escape",
+	"Home",
+	"End",
+	"PageUp",
+	"PageDown",
+	"F6"
+]);
+/** Starts tracking; returns a function that stops it. Safe to call during SSR (no-op). */
+function trackInputModality() {
+	if (typeof document === "undefined") return () => {};
+	const root = document.documentElement;
+	const set = (m) => {
+		if (root.dataset.inputModality !== m) root.dataset.inputModality = m;
+	};
+	set("pointer");
+	const onPointer = () => set("pointer");
+	const onKey = (e) => {
+		if (e.metaKey || e.ctrlKey || e.altKey) return;
+		if (NAV_KEYS.has(e.key)) set("keyboard");
+	};
+	window.addEventListener("pointerdown", onPointer, true);
+	window.addEventListener("keydown", onKey, true);
+	return () => {
+		window.removeEventListener("pointerdown", onPointer, true);
+		window.removeEventListener("keydown", onKey, true);
+	};
+}
+//#endregion
+export { NAV_KEYS, trackInputModality };
+
+//# sourceMappingURL=input-modality.js.map

package/dist/lib/input-modality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-modality.js","names":[],"sources":["../../src/lib/input-modality.ts"],"sourcesContent":["/**\n * Keyboard-only focus rings (D29, founder rule \"never a dark box after a mouse click\", DESIGN.md 3.7).\n *\n * `:focus-visible` alone isn't enough: Base UI returns focus to a trigger programmatically when a menu or popover\n * closes, and Chrome/Safari can paint the ring there even though the user only ever used the mouse. We record the\n * last input modality on <html data-input-modality> and the stylesheet suppresses rings while it is \"pointer\".\n */\nexport const NAV_KEYS: ReadonlySet<string> = new Set([\n  \"Tab\",\n  \"ArrowUp\",\n  \"ArrowDown\",\n  \"ArrowLeft\",\n  \"ArrowRight\",\n  \"Enter\",\n  \" \",\n  \"Escape\",\n  \"Home\",\n  \"End\",\n  \"PageUp\",\n  \"PageDown\",\n  \"F6\",\n]);\n\nexport type InputModality = \"pointer\" | \"keyboard\";\n\n/** Starts tracking; returns a function that stops it. Safe to call during SSR (no-op). */\nexport function trackInputModality(): () => void {\n  if (typeof document === \"undefined\") return () => {};\n  const root = document.documentElement;\n  const set = (m: InputModality) => {\n    if (root.dataset.inputModality !== m) root.dataset.inputModality = m;\n  };\n  set(\"pointer\");\n  const onPointer = () => set(\"pointer\");\n  const onKey = (e: KeyboardEvent) => {\n    if (e.metaKey || e.ctrlKey || e.altKey) return;\n    if (NAV_KEYS.has(e.key)) set(\"keyboard\");\n  };\n  window.addEventListener(\"pointerdown\", onPointer, true);\n  window.addEventListener(\"keydown\", onKey, true);\n  return () => {\n    window.removeEventListener(\"pointerdown\", onPointer, true);\n    window.removeEventListener(\"keydown\", onKey, true);\n  };\n}\n"],"mappings":";;;;;;;;AAOA,IAAa,2BAAgC,IAAI,IAAI;CACnD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;AAKD,SAAgB,qBAAiC;CAC/C,IAAI,OAAO,aAAa,aAAa,aAAa,CAAC;CACnD,MAAM,OAAO,SAAS;CACtB,MAAM,OAAO,MAAqB;EAChC,IAAI,KAAK,QAAQ,kBAAkB,GAAG,KAAK,QAAQ,gBAAgB;CACrE;CACA,IAAI,SAAS;CACb,MAAM,kBAAkB,IAAI,SAAS;CACrC,MAAM,SAAS,MAAqB;EAClC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ;EACxC,IAAI,SAAS,IAAI,EAAE,GAAG,GAAG,IAAI,UAAU;CACzC;CACA,OAAO,iBAAiB,eAAe,WAAW,IAAI;CACtD,OAAO,iBAAiB,WAAW,OAAO,IAAI;CAC9C,aAAa;EACX,OAAO,oBAAoB,eAAe,WAAW,IAAI;EACzD,OAAO,oBAAoB,WAAW,OAAO,IAAI;CACnD;AACF"}

package/dist/lib/key-event.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The lower-cased key of a keyboard event, or `null` when the event carries none.
+ *
+ * The kit's copy of `src/lib/keyEvent.ts` (the kit imports only itself). Chrome's autofill, password
+ * managers, some IME compositions and extension-made events dispatch `keydown` with no `key`, and
+ * `e.key.toLowerCase()` threw a TypeError on each of them. A handler reads the key through this and
+ * treats `null` as "not my shortcut".
+ */
+export declare function eventKey(event: {
+    key?: unknown;
+}): string | null;

package/dist/lib/key-event.js

@@ -0,0 +1,16 @@
+//#region src/lib/key-event.ts
+/**
+* The lower-cased key of a keyboard event, or `null` when the event carries none.
+*
+* The kit's copy of `src/lib/keyEvent.ts` (the kit imports only itself). Chrome's autofill, password
+* managers, some IME compositions and extension-made events dispatch `keydown` with no `key`, and
+* `e.key.toLowerCase()` threw a TypeError on each of them. A handler reads the key through this and
+* treats `null` as "not my shortcut".
+*/
+function eventKey(event) {
+	return typeof event.key === "string" ? event.key.toLowerCase() : null;
+}
+//#endregion
+export { eventKey };
+
+//# sourceMappingURL=key-event.js.map

package/dist/lib/key-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-event.js","names":[],"sources":["../../src/lib/key-event.ts"],"sourcesContent":["/**\n * The lower-cased key of a keyboard event, or `null` when the event carries none.\n *\n * The kit's copy of `src/lib/keyEvent.ts` (the kit imports only itself). Chrome's autofill, password\n * managers, some IME compositions and extension-made events dispatch `keydown` with no `key`, and\n * `e.key.toLowerCase()` threw a TypeError on each of them. A handler reads the key through this and\n * treats `null` as \"not my shortcut\".\n */\nexport function eventKey(event: { key?: unknown }): string | null {\n  return typeof event.key === \"string\" ? event.key.toLowerCase() : null;\n}\n"],"mappings":";;;;;;;;;AAQA,SAAgB,SAAS,OAAyC;CAChE,OAAO,OAAO,MAAM,QAAQ,WAAW,MAAM,IAAI,YAAY,IAAI;AACnE"}

package/dist/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/dist/lib/path.js

@@ -0,0 +1,66 @@
+//#region src/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]);
+/** `prefix` is an ancestor of (or equal to) `p`. */
+var isPrefix = (prefix, p) => prefix.length <= p.length && prefix.every((s, i) => s === p[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, isPrefix, itemId, keyStartsWith, newKey, pathEq, pathKey, same, setIn };
+
+//# sourceMappingURL=path.js.map

package/dist/lib/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","names":[],"sources":["../../src/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,CAAC;AAE/F,SAAgB,MAAM,MAAe,MAA0B;CAC7D,IAAI,MAAe;CACnB,KAAK,MAAM,OAAO,MAAM;EACtB,IAAI,OAAO,MAAM,OAAO,KAAA;EACxB,IAAI,OAAO,QAAQ,UAAU,MAAM,MAAM,QAAQ,GAAG,IAAI,IAAI,OAAO,KAAA;OAC9D,MAAM,MAAM,GAAG,IAAI,IAAI,OAAO,KAAA;CACrC;CACA,OAAO;AACT;AAEA,SAAgB,MAAS,MAAS,MAAiB,OAAmB;CACpE,IAAI,KAAK,WAAW,GAAG,OAAO;CAC9B,MAAM,CAAC,MAAM,GAAG,QAAQ;CACxB,IAAI,OAAO,SAAS,UAAU;EAC5B,MAAM,MAAM,MAAM,QAAQ,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC;EAClD,IAAI,QAAQ,MAAM,IAAI,OAAO,MAAM,KAAK;EACxC,OAAO;CACT;CACA,MAAM,MAAW,MAAM,IAAI,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;CAC9C,IAAI,QAAQ,MAAM,IAAI,OAAO,MAAM,KAAK;CACxC,OAAO;AACT;;AAGA,IAAa,WAAW,MAAiB,EAAE,KAAK,GAAG;;;;;;AAMnD,IAAa,cAAc,MAAkB,EAAE,WAAW,IAAI,SAAS,EAAE,WAAW,KAAK,EAAE,OAAO,SAAS,UAAU,QAAQ,CAAC;AAC9H,IAAa,UAAU,GAAc,MAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,MAAM,EAAE,EAAE;;AAE3G,IAAa,YAAY,QAAmB,MAAiB,OAAO,UAAU,EAAE,UAAU,OAAO,OAAO,GAAG,MAAM,MAAM,EAAE,EAAE;AAC3H,IAAa,iBAAiB,KAAa,WAAmB,WAAW,MAAM,QAAQ,UAAU,IAAI,WAAW,GAAG,OAAO,EAAE;AAE5H,IAAa,QAAQ,GAAY,MAAe;CAC9C,IAAI,MAAM,GAAG,OAAO;CACpB,IAAI;EACF,OAAO,KAAK,UAAU,KAAK,IAAI,MAAM,KAAK,UAAU,KAAK,IAAI;CAC/D,QAAQ;EACN,OAAO;CACT;AACF;AAEA,IAAI,MAAM;AACV,IAAa,eAAe,IAAI,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,MAAA,CAAO,SAAS,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC;;AAGhI,SAAgB,WAAc,OAAiB;CAC7C,IAAI,UAAU;CACd,MAAM,MAAM,MAAM,KAAK,OAAO;EAC5B,IAAI,MAAM,EAAE,KAAK,OAAO,GAAG,SAAS,UAAU;GAC5C,UAAU;GACV,OAAO;IAAE,MAAM,OAAO;IAAG,GAAG;GAAG;EACjC;EACA,OAAO;CACT,CAAC;CACD,OAAO,UAAU,MAAM;AACzB;;AAGA,IAAa,UAAU,IAAa,MAAe,MAAM,EAAE,KAAK,OAAO,GAAG,SAAS,WAAW,GAAG,OAAO,IAAI"}

package/dist/lib/schema.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 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;
+/**
+ * What a condition can read beyond the fields beside it (V2 kit lib/schema.ts CondCtx): the object that holds them
+ * (`parent`), the top of the component or CMS item (`root`) and its variant. Callers that don't pass it get the sibling
+ * rules only; a `_variant` rule that can't be read then counts as met (the field shows), never as a silent hide.
+ */
+export interface CondCtx {
+    parent?: unknown;
+    root?: unknown;
+    /** the component's variant id, its first variant when the value has none */
+    variant?: string;
+}
+/** The condition context for fields under `basePath` of a form (the nearest slot child is the component's root). V2 condCtx. */
+export declare function condCtx(form: {
+    schema: TypeSchema;
+    getAt: (p: (string | number)[]) => unknown;
+    resolveSchema?: (t: string) => TypeSchema | undefined;
+}, basePath: (string | number)[]): CondCtx;
+/** `hidden: true` hides; a Condition SHOWS the field only while its rules hold (types.ts contract). A rule it can't read
+ *  here (a `_variant` or scoped rule with no context) holds, so the field shows. V2 isHidden. */
+export declare function isHidden(f: FieldSchema, parent: unknown, ctx?: CondCtx): 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, the component props envelope `{ content: { version, content: blocks }, html }`, and the field
+ * envelope `{ format, value: blocks, html }`.
+ *
+ * 🔴 An html string's words are DECODED: a row titled by `<p>Advisors &amp; specialists</p>` read "Advisors &amp;
+ * specialists" in the dock (marby-astro QA, 2026-10-22).
+ */
+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;
+/**
+ * How one slot child reads as a row (SlotField): its block's preview (the block's title while it has no text), the
+ * variant chip its `_variant` names, and the line under it (block title · settings, else description, else "Block i of n").
+ */
+export declare function slotRowOf(block: TypeSchema | undefined, item: unknown, index: number, count: number, slotSettings?: FieldSchema[]): {
+    preview: Preview;
+    chip?: string;
+    extra: string;
+};
+/** "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;