@bettercms-ai/kit 1.0.0 → 2.0.0

package/dist/lib/frames.js.map

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

@@ -0,0 +1,10 @@
+/**
+ * Is this image field an ICON? The image control draws one 32px row for it instead of a picture card, the field shell
+ * gives it no second label, and the field lists gather two or more into one "Icons" group. One rule for all three, so
+ * they never disagree.
+ *
+ * Only `svgOnly`, which the schema adapter sets from the import's `media: "icon"` stamp (and nothing else sets). An SVG
+ * alone is not an icon: a site's SVG logo keeps its picture, alt text and details.
+ */
+import type { FieldSchema } from "../schema/types";
+export declare function isIconImage(field: FieldSchema, _value?: unknown): boolean;

package/dist/lib/icon-image.js

@@ -0,0 +1,8 @@
+//#region src/lib/icon-image.ts
+function isIconImage(field, _value) {
+	return field.type === "image" && field.svgOnly === true;
+}
+//#endregion
+export { isIconImage };
+
+//# sourceMappingURL=icon-image.js.map

package/dist/lib/icon-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-image.js","names":[],"sources":["../../src/lib/icon-image.ts"],"sourcesContent":["/**\n * Is this image field an ICON? The image control draws one 32px row for it instead of a picture card, the field shell\n * gives it no second label, and the field lists gather two or more into one \"Icons\" group. One rule for all three, so\n * they never disagree.\n *\n * Only `svgOnly`, which the schema adapter sets from the import's `media: \"icon\"` stamp (and nothing else sets). An SVG\n * alone is not an icon: a site's SVG logo keeps its picture, alt text and details.\n */\nimport type { FieldSchema } from \"../schema/types\";\n\nexport function isIconImage(field: FieldSchema, _value?: unknown): boolean {\n  return field.type === \"image\" && field.svgOnly === true;\n}\n"],"mappings":";AAUA,SAAgB,YAAY,OAAoB,QAA2B;CACzE,OAAO,MAAM,SAAS,WAAW,MAAM,YAAY;AACrD"}

package/{lib → dist/lib}/icons.js

@@ -1,6 +1,6 @@
-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
+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.
@@ -158,7 +158,8 @@ function iconKey(name) {
 }
 /** 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, {
+	const I = KIT_ICONS[iconKey(name) ?? fallback] ?? IconBox;
+	return /* @__PURE__ */ jsx(I, {
 		className,
 		stroke: 1.5,
 		"aria-hidden": true

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/{lib → dist/lib}/path.js

@@ -1,4 +1,4 @@
-//#region src/kit/lib/path.ts
+//#region src/lib/path.ts
 var isObj = (v) => !!v && typeof v === "object" && !Array.isArray(v);
 function getIn(root, path) {
 	let cur = root;
@@ -30,6 +30,8 @@ var pathKey = (p) => p.join(".");
 */
 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;
@@ -59,6 +61,6 @@ function ensureKeys(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 };
+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/{lib → dist/lib}/schema.d.ts

@@ -26,11 +26,33 @@ export declare function objectInitial(fields: FieldSchema[]): Record<string, unk
 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;
+/**
+ * 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, and the component props envelope `{ content: { version, content: blocks }, html }`.
+ * 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;
@@ -45,5 +67,14 @@ export interface Preview {
     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;

package/{lib → dist/lib}/schema.js

@@ -1,7 +1,7 @@
-import { getIn, isObj, newKey } from "./path.js";
 import { cellValue, isEmptyCell, isTableValue, tableSummary } from "../schema/table.js";
-//#region src/kit/lib/schema.ts
-var PRIMITIVES = new Set([
+import { getIn, isObj, newKey } from "./path.js";
+//#region src/lib/schema.ts
+var PRIMITIVES = /* @__PURE__ */ new Set([
 	"string",
 	"text",
 	"richtext",
@@ -33,7 +33,7 @@ var isPrimitive = (t) => PRIMITIVES.has(t);
 /** Types whose value is plain text (counters, AI rewrite, copy/paste as text). */
 var isTextual = (t) => t === "string" || t === "text" || t === "richtext" || t === "slug" || t === "url" || t === "email";
 /** Types that are cheap to show inline inside a small object (no heavy surfaces). */
-var INLINE_OK = new Set([
+var INLINE_OK = /* @__PURE__ */ new Set([
 	"string",
 	"number",
 	"boolean",
@@ -131,24 +131,99 @@ function structuredCloneSafe(v) {
 		return JSON.parse(JSON.stringify(v));
 	}
 }
-/** `hidden: true` hides; a Condition SHOWS the field only when the sibling matches (types.ts contract). */
-function isHidden(f, parent) {
+/** The condition context for fields under `basePath` of a form (the nearest slot child is the component's root). V2 condCtx. */
+function condCtx(form, basePath) {
+	const up = (p) => {
+		const q = [...p];
+		while (q.length && typeof q[q.length - 1] === "number") q.pop();
+		q.pop();
+		return q;
+	};
+	let rootPath = [];
+	let rootSchema = form.schema;
+	for (let i = basePath.length; i > 0; i--) {
+		const v = form.getAt(basePath.slice(0, i));
+		if (isObj(v) && typeof v._type === "string" && typeof basePath[i - 1] === "number") {
+			rootPath = basePath.slice(0, i);
+			rootSchema = form.resolveSchema?.(v._type);
+			break;
+		}
+	}
+	const root = form.getAt(rootPath);
+	const own = isObj(root) && typeof root._variant === "string" ? root._variant : void 0;
+	return {
+		parent: basePath.length > rootPath.length ? form.getAt(up(basePath)) : void 0,
+		root,
+		variant: own ?? rootSchema?.variants?.[0]?.id
+	};
+}
+var num = (v) => typeof v === "number" ? v : typeof v === "string" && v.trim() !== "" && !Number.isNaN(Number(v)) ? Number(v) : typeof v === "string" && !Number.isNaN(Date.parse(v)) ? Date.parse(v) : NaN;
+/** One rule (V2 ruleHolds): true when it holds, null when it can't be read here (no context). */
+function ruleHolds(c, siblings, ctx) {
+	let v;
+	if (c.field === "_variant" && !c.scope) {
+		if (isObj(siblings) && typeof siblings._variant === "string") v = siblings._variant;
+		else if (ctx) v = ctx.variant;
+		else return null;
+	} else if (c.scope) {
+		if (!ctx) return null;
+		const from = c.scope === "root" ? ctx.root : ctx.parent;
+		v = c.field === "_variant" ? ctx.variant : isObj(from) ? from[c.field] : void 0;
+	} else v = isObj(siblings) ? siblings[c.field] : void 0;
+	const op = c.op ?? (c.notEmpty ? "notEmpty" : c.equals !== void 0 ? Array.isArray(c.equals) ? "in" : "is" : null);
+	const target = c.op ? c.value : c.equals;
+	const list = Array.isArray(target) ? target : [target];
+	const has = (x) => list.some((y) => y === x || Array.isArray(x) && x.includes(y));
+	switch (op) {
+		case "notEmpty": return !isEmptyValue(v);
+		case "empty": return isEmptyValue(v);
+		case "is":
+		case "in": return has(v);
+		case "isNot":
+		case "notIn": return !has(v);
+		case "gt": return num(v) > num(target);
+		case "lt": return num(v) < num(target);
+		default: return true;
+	}
+}
+/** `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. */
+function isHidden(f, parent, ctx) {
 	if (f.hidden === true) return true;
 	if (!f.hidden) return false;
 	const c = f.hidden;
-	const sib = isObj(parent) ? parent[c.field] : void 0;
-	if (c.notEmpty) return isEmptyValue(sib);
-	if (c.equals !== void 0) return !(Array.isArray(c.equals) ? c.equals : [c.equals]).includes(sib);
-	return false;
+	const met = [c, ...c.also ?? []].map((r) => ruleHolds(r, parent, ctx) ?? true);
+	return !(c.match === "any" ? met.some(Boolean) : met.every(Boolean));
 }
 /** Portable Text blocks' text, one block per space; "" when the array holds no blocks (a list of items). */
 var blocksText = (v) => v.map((b) => isObj(b) && Array.isArray(b.children) ? b.children.map((c) => isObj(c) && typeof c.text === "string" ? c.text : "").join("") : "").filter(Boolean).join(" ").replace(/\s+/g, " ").trim();
+var NAMED_ENTITIES = {
+	amp: "&",
+	lt: "<",
+	gt: ">",
+	quot: "\"",
+	apos: "'",
+	nbsp: " "
+};
+/**
+* Markup's character references as the characters they stand for, AFTER the tags are gone (so a decoded `&lt;b&gt;`
+* stays words). Named ones a rich text editor writes, and every numeric one; anything else is left as written.
+*/
+var decodeEntities = (s) => s.replace(/&(#x[0-9a-f]+|#\d+|[a-z]+);/gi, (whole, ref) => {
+	if (ref[0] !== "#") return NAMED_ENTITIES[ref.toLowerCase()] ?? whole;
+	const code = ref[1] === "x" || ref[1] === "X" ? parseInt(ref.slice(2), 16) : parseInt(ref.slice(1), 10);
+	return Number.isFinite(code) && code > 0 && code <= 1114111 ? String.fromCodePoint(code) : whole;
+});
 /**
 * 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 }`.
+* 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).
 */
 var plainText = (v) => {
-	if (typeof v === "string") return v.replace(/<[^>]*>/g, " ").replace(/&nbsp;/g, " ").replace(/\s+/g, " ").trim();
+	if (typeof v === "string") return decodeEntities(v.replace(/<[^>]*>/g, " ")).replace(/\s+/g, " ").trim();
 	if (typeof v === "number") return String(v);
 	if (Array.isArray(v)) return blocksText(v);
 	if (isObj(v)) {
@@ -160,6 +235,10 @@ var plainText = (v) => {
 			const t = plainText(v.content);
 			if (t) return t;
 		}
+		if (Array.isArray(v.value)) {
+			const t = blocksText(v.value);
+			if (t) return t;
+		}
 		if (typeof v.html === "string") return plainText(v.html);
 	}
 	return "";
@@ -254,6 +333,24 @@ function previewOf(itemSchema, item, index, fallbackTitle) {
 		empty
 	};
 }
+/**
+* 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").
+*/
+function slotRowOf(block, item, index, count, slotSettings) {
+	const pv = previewOf(block, item, index, block?.title ?? "Block");
+	const variant = block?.variants?.find((v) => isObj(item) && v.id === item._variant)?.name;
+	const settings = slotSettings && isObj(item) ? summarize(slotSettings, item._settings, 2) : "";
+	return {
+		preview: {
+			...pv,
+			title: pv.empty ? block?.title ?? "Unknown block" : pv.title,
+			icon: block?.icon ?? "box"
+		},
+		chip: variant,
+		extra: [pv.empty ? void 0 : block?.title, settings].filter(Boolean).join(" · ") || block?.description || `Block ${index + 1} of ${count}`
+	};
+}
 /** "Cast iron · 4 items" — one-line summary of an object for collapsed rows and fieldset headers. */
 function summarize(fields, v, max = 2) {
 	if (!isObj(v)) return "";
@@ -282,6 +379,6 @@ function summarize(fields, v, max = 2) {
 }
 var itemNounSafe = (f) => f.type === "array" || f.type === "slot" ? itemNoun(f) : "item";
 //#endregion
-export { initialFor, isEmptyValue, isHidden, isPrimitive, isTextual, itemNoun, itemOpenMode, itemSchemaFor, itemSchemas, newBlock, newItem, objectOpenMode, plainText, previewOf, primitiveItem, slotAllow, summarize };
+export { condCtx, emptyFor, imageUrl, initialFor, isEmptyValue, isHidden, isPrimitive, isSmallObject, isTextual, itemNoun, itemOpenMode, itemSchemaFor, itemSchemas, newBlock, newItem, objectInitial, objectOpenMode, plainText, previewOf, primitiveItem, slotAllow, slotRowOf, structuredCloneSafe, summarize };
 
 //# sourceMappingURL=schema.js.map

package/dist/lib/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","names":[],"sources":["../../src/lib/schema.ts"],"sourcesContent":["/**\n * Schema helpers — pure functions the engine uses to decide HOW a field is edited and WHAT a row shows.\n */\nimport type { Condition, FieldSchema, OpenMode, PrimitiveType, SchemaType, TypeSchema } from \"../schema/types\";\nimport { getIn, isObj, newKey } from \"./path\";\nimport { cellValue, isEmptyCell, isTableValue, tableSummary } from \"../schema/table\";\n\nconst PRIMITIVES: ReadonlySet<SchemaType> = new Set<PrimitiveType>([\n  \"string\", \"text\", \"richtext\", \"number\", \"boolean\", \"slug\", \"url\", \"email\", \"date\", \"datetime\", \"color\", \"select\", \"multiselect\",\n  \"tags\", \"image\", \"file\", \"video\", \"icon\", \"link\", \"button\", \"reference\", \"code\", \"json\", \"geopoint\", \"rating\", \"table\",\n]);\nexport const isPrimitive = (t: SchemaType) => PRIMITIVES.has(t);\n/** Types whose value is plain text (counters, AI rewrite, copy/paste as text). */\nexport const isTextual = (t: SchemaType) => t === \"string\" || t === \"text\" || t === \"richtext\" || t === \"slug\" || t === \"url\" || t === \"email\";\n/** Types that are cheap to show inline inside a small object (no heavy surfaces). */\nconst INLINE_OK: ReadonlySet<SchemaType> = new Set([\"string\", \"number\", \"boolean\", \"select\", \"color\", \"icon\", \"url\", \"email\", \"date\", \"rating\", \"slug\"]);\n\nexport const itemSchemas = (f: FieldSchema): FieldSchema[] => (Array.isArray(f.of) ? f.of : []);\nexport const slotAllow = (f: FieldSchema): string[] | undefined => (f.of && !Array.isArray(f.of) ? f.of.allow : undefined);\nexport const itemSchemaFor = (f: FieldSchema, item: unknown): FieldSchema | undefined => {\n  const of = itemSchemas(f);\n  if (isObj(item) && typeof item._type === \"string\") return of.find((o) => o.name === item._type) ?? of[0];\n  return of[0];\n};\n/** An array whose single item type is a primitive (tags, gallery, references, list of strings). */\nexport const primitiveItem = (f: FieldSchema): FieldSchema | undefined => {\n  const of = itemSchemas(f);\n  return of.length === 1 && isPrimitive(of[0].type) ? of[0] : undefined;\n};\nexport const isSmallObject = (fields: FieldSchema[] = []) => fields.length > 0 && fields.length <= 3 && fields.every((f) => INLINE_OK.has(f.type));\n\n/** How an object field / array item opens (CPO D8: inline for ≤3 primitives, else drill). */\nexport function objectOpenMode(f: FieldSchema): OpenMode {\n  if (f.openMode) return f.openMode;\n  return isSmallObject(f.fields) ? \"inline\" : \"drill\";\n}\n/**\n * CPO D43 — one rule for rows: an item of ≤3 simple fields (text, number, switch, select, colour, icon, url, email,\n * date, rating, slug) EXPANDS inline under its row; anything bigger, nested or rich DRILLS into its own frame.\n * `openMode` on the array still wins (developer override). Several item types → drill (they rarely share a shape).\n */\nexport function itemOpenMode(arrayField: FieldSchema): OpenMode {\n  if (arrayField.openMode) return arrayField.openMode;\n  const of = itemSchemas(arrayField);\n  return of.length === 1 && isSmallObject(of[0].fields) ? \"inline\" : \"drill\";\n}\n\nexport function emptyFor(f: FieldSchema): unknown {\n  switch (f.type) {\n    case \"boolean\": return false;\n    case \"number\": case \"rating\": return null;\n    case \"multiselect\": case \"tags\": case \"array\": case \"slot\": return [];\n    case \"object\": return objectInitial(f.fields ?? []);\n    case \"image\": case \"file\": case \"video\": case \"reference\": case \"link\": case \"button\": case \"geopoint\": case \"json\": case \"table\": return null;\n    default: return \"\";\n  }\n}\nexport const initialFor = (f: FieldSchema) => (f.initialValue !== undefined ? structuredCloneSafe(f.initialValue) : emptyFor(f));\nexport function objectInitial(fields: FieldSchema[]): Record<string, unknown> {\n  const o: Record<string, unknown> = {};\n  for (const f of fields) if (f.initialValue !== undefined) o[f.name] = structuredCloneSafe(f.initialValue);\n  return o;\n}\n/** A new array item for `itemSchema` (stamped with `_key` and, when the array allows several types, `_type`). */\nexport function newItem(arrayField: FieldSchema, itemSchema: FieldSchema): unknown {\n  if (isPrimitive(itemSchema.type)) return initialFor(itemSchema);\n  const base = itemSchema.initialValue && isObj(itemSchema.initialValue) ? structuredCloneSafe(itemSchema.initialValue) : objectInitial(itemSchema.fields ?? []);\n  const multi = itemSchemas(arrayField).length > 1;\n  return { _key: newKey(), ...(multi ? { _type: itemSchema.name } : {}), ...(base as object) };\n}\nexport function newBlock(block: TypeSchema, settings?: FieldSchema[]): Record<string, unknown> {\n  const init = block.initialValue ? structuredCloneSafe(block.initialValue) : objectInitial(block.fields);\n  const s = settings?.length ? { _settings: objectInitial(settings) } : {};\n  return { _key: newKey(), _type: block.name, ...(block.variants?.[0] ? { _variant: block.variants[0].id } : {}), ...s, ...(init as object) };\n}\nexport function structuredCloneSafe<T>(v: T): T {\n  try {\n    return structuredClone(v);\n  } catch {\n    return JSON.parse(JSON.stringify(v)) as T;\n  }\n}\n\n/* ── Conditions ───────────────────────────────────────────────────────── */\n/**\n * What a condition can read beyond the fields beside it (V2 kit lib/schema.ts CondCtx): the object that holds them\n * (`parent`), the top of the component or CMS item (`root`) and its variant. Callers that don't pass it get the sibling\n * rules only; a `_variant` rule that can't be read then counts as met (the field shows), never as a silent hide.\n */\nexport interface CondCtx {\n  parent?: unknown;\n  root?: unknown;\n  /** the component's variant id, its first variant when the value has none */\n  variant?: string;\n}\n/** The condition context for fields under `basePath` of a form (the nearest slot child is the component's root). V2 condCtx. */\nexport function condCtx(form: { schema: TypeSchema; getAt: (p: (string | number)[]) => unknown; resolveSchema?: (t: string) => TypeSchema | undefined }, basePath: (string | number)[]): CondCtx {\n  const up = (p: (string | number)[]) => {\n    const q = [...p];\n    // the container may be a list item ([\"items\", 0]): the object holding it is one key further up\n    while (q.length && typeof q[q.length - 1] === \"number\") q.pop();\n    q.pop();\n    return q;\n  };\n  let rootPath: (string | number)[] = [];\n  let rootSchema: TypeSchema | undefined = form.schema;\n  for (let i = basePath.length; i > 0; i--) {\n    const v = form.getAt(basePath.slice(0, i));\n    if (isObj(v) && typeof v._type === \"string\" && typeof basePath[i - 1] === \"number\") {\n      rootPath = basePath.slice(0, i);\n      rootSchema = form.resolveSchema?.(v._type);\n      break;\n    }\n  }\n  const root = form.getAt(rootPath);\n  const own = isObj(root) && typeof root._variant === \"string\" ? root._variant : undefined;\n  return { parent: basePath.length > rootPath.length ? form.getAt(up(basePath)) : undefined, root, variant: own ?? rootSchema?.variants?.[0]?.id };\n}\n\nconst num = (v: unknown) => (typeof v === \"number\" ? v : typeof v === \"string\" && v.trim() !== \"\" && !Number.isNaN(Number(v)) ? Number(v) : typeof v === \"string\" && !Number.isNaN(Date.parse(v)) ? Date.parse(v) : NaN);\n/** One rule (V2 ruleHolds): true when it holds, null when it can't be read here (no context). */\nfunction ruleHolds(c: Condition, siblings: unknown, ctx: CondCtx | undefined): boolean | null {\n  let v: unknown;\n  if (c.field === \"_variant\" && !c.scope) {\n    if (isObj(siblings) && typeof siblings._variant === \"string\") v = siblings._variant;\n    else if (ctx) v = ctx.variant;\n    else return null;\n  } else if (c.scope) {\n    if (!ctx) return null;\n    const from = c.scope === \"root\" ? ctx.root : ctx.parent;\n    v = c.field === \"_variant\" ? ctx.variant : isObj(from) ? from[c.field] : undefined;\n  } else v = isObj(siblings) ? siblings[c.field] : undefined;\n  const op = c.op ?? (c.notEmpty ? \"notEmpty\" : c.equals !== undefined ? (Array.isArray(c.equals) ? \"in\" : \"is\") : null);\n  const target = c.op ? c.value : c.equals;\n  const list = Array.isArray(target) ? target : [target];\n  const has = (x: unknown) => list.some((y) => y === x || (Array.isArray(x) && x.includes(y as never)));\n  switch (op) {\n    case \"notEmpty\": return !isEmptyValue(v);\n    case \"empty\": return isEmptyValue(v);\n    case \"is\":\n    case \"in\": return has(v);\n    case \"isNot\":\n    case \"notIn\": return !has(v);\n    case \"gt\": return num(v) > num(target);\n    case \"lt\": return num(v) < num(target);\n    default: return true;\n  }\n}\n\n/** `hidden: true` hides; a Condition SHOWS the field only while its rules hold (types.ts contract). A rule it can't read\n *  here (a `_variant` or scoped rule with no context) holds, so the field shows. V2 isHidden. */\nexport function isHidden(f: FieldSchema, parent: unknown, ctx?: CondCtx): boolean {\n  if (f.hidden === true) return true;\n  if (!f.hidden) return false;\n  const c = f.hidden as Condition;\n  const met = [c, ...(c.also ?? [])].map((r) => ruleHolds(r, parent, ctx) ?? true);\n  return !(c.match === \"any\" ? met.some(Boolean) : met.every(Boolean));\n}\n\n/* ── Values → text ────────────────────────────────────────────────────── */\n/** Portable Text blocks' text, one block per space; \"\" when the array holds no blocks (a list of items). */\nconst blocksText = (v: unknown[]): string =>\n  v\n    .map((b) => (isObj(b) && Array.isArray(b.children) ? b.children.map((c) => (isObj(c) && typeof c.text === \"string\" ? c.text : \"\")).join(\"\") : \"\"))\n    .filter(Boolean)\n    .join(\" \")\n    .replace(/\\s+/g, \" \")\n    .trim();\nconst NAMED_ENTITIES: Record<string, string> = { amp: \"&\", lt: \"<\", gt: \">\", quot: '\"', apos: \"'\", nbsp: \" \" };\n/**\n * Markup's character references as the characters they stand for, AFTER the tags are gone (so a decoded `&lt;b&gt;`\n * stays words). Named ones a rich text editor writes, and every numeric one; anything else is left as written.\n */\nconst decodeEntities = (s: string): string =>\n  s.replace(/&(#x[0-9a-f]+|#\\d+|[a-z]+);/gi, (whole, ref: string) => {\n    if (ref[0] !== \"#\") return NAMED_ENTITIES[ref.toLowerCase()] ?? whole;\n    const code = ref[1] === \"x\" || ref[1] === \"X\" ? parseInt(ref.slice(2), 16) : parseInt(ref.slice(1), 10);\n    return Number.isFinite(code) && code > 0 && code <= 0x10ffff ? String.fromCodePoint(code) : whole;\n  });\n/**\n * A value as one line of text. Stored rich text reads as its words in every shape production keeps: an html string,\n * Portable Text blocks, the component props envelope `{ content: { version, content: blocks }, html }`, and the field\n * envelope `{ format, value: blocks, html }`.\n *\n * 🔴 An html string's words are DECODED: a row titled by `<p>Advisors &amp; specialists</p>` read \"Advisors &amp;\n * specialists\" in the dock (marby-astro QA, 2026-10-22).\n */\nexport const plainText = (v: unknown): string => {\n  if (typeof v === \"string\") return decodeEntities(v.replace(/<[^>]*>/g, \" \")).replace(/\\s+/g, \" \").trim();\n  if (typeof v === \"number\") return String(v);\n  if (Array.isArray(v)) return blocksText(v);\n  if (isObj(v)) {\n    if (typeof v.label === \"string\" && v.label) return v.label;\n    if (typeof v.title === \"string\") return v.title;\n    if (typeof v.href === \"string\") return v.href;\n    if (typeof v.name === \"string\") return v.name;\n    // the envelope's blocks first: their text is unescaped (the html holds `&amp;`)\n    if (\"content\" in v && typeof v.content === \"object\" && v.content !== null) {\n      const t = plainText(v.content);\n      if (t) return t;\n    }\n    if (Array.isArray(v.value)) {\n      const t = blocksText(v.value);\n      if (t) return t;\n    }\n    if (typeof v.html === \"string\") return plainText(v.html);\n  }\n  return \"\";\n};\nexport function isEmptyValue(v: unknown): boolean {\n  if (v == null) return true;\n  if (typeof v === \"string\") return plainText(v) === \"\" && !/<img|<hr|<table|data-block|data-embed/.test(v);\n  if (Array.isArray(v)) return v.length === 0;\n  if (isTableValue(v)) return !v.caption?.trim() && v.rows.every((r) => Object.values(r.cells ?? {}).every((c) => isEmptyCell(cellValue(c))));\n  if (isObj(v)) {\n    if (\"url\" in v) return !v.url;\n    if (\"href\" in v && !(\"label\" in v)) return !v.href;\n    if (\"label\" in v && \"href\" in v) return !v.label && !v.href;\n    return Object.keys(v).filter((k) => !k.startsWith(\"_\")).every((k) => isEmptyValue(v[k]));\n  }\n  return false;\n}\nexport const imageUrl = (v: unknown): string | undefined =>\n  typeof v === \"string\" && /^(https?:|blob:|data:image|\\/)/.test(v) ? v : isObj(v) && typeof v.url === \"string\" && v.url ? v.url : undefined;\n\n/** Singular noun for an array's items: itemNoun → item title → field title minus \"s\". */\nexport function itemNoun(f: FieldSchema): string {\n  if (f.itemNoun) return f.itemNoun;\n  const of = itemSchemas(f);\n  if (of.length === 1 && of[0].title && !isPrimitive(of[0].type)) return of[0].title.toLowerCase();\n  const t = f.title.toLowerCase();\n  return t.endsWith(\"ies\") ? `${t.slice(0, -3)}y` : t.endsWith(\"s\") ? t.slice(0, -1) : \"item\";\n}\n\n/* ── Previews (array rows, slot rows, crumbs) ─────────────────────────── */\nexport interface Preview {\n  title: string;\n  subtitle?: string;\n  media?: string;\n  icon?: string;\n  empty: boolean;\n}\n/** Display text of one field value (select → option label). */\nfunction fieldText(f: FieldSchema | undefined, v: unknown): string {\n  if (f?.type === \"select\") return f.options?.find((o) => o.value === v)?.label ?? plainText(v);\n  return plainText(v);\n}\nfunction firstText(fields: FieldSchema[], v: Record<string, unknown>, skip?: string) {\n  for (const f of fields) {\n    if (f.name === skip) continue;\n    if (f.type === \"select\") {\n      const t = fieldText(f, v[f.name]);\n      if (t) return { name: f.name, text: t };\n    }\n    if (f.type === \"string\" || f.type === \"text\" || f.type === \"richtext\" || f.type === \"number\") {\n      const t = plainText(v[f.name]);\n      if (t) return { name: f.name, text: t };\n    }\n    if (f.type === \"button\" || f.type === \"link\") {\n      const t = plainText(v[f.name]);\n      if (t) return { name: f.name, text: t };\n    }\n  }\n  // no prose anywhere: a URL or address still beats \"Item 3\" (D47 — item titles use the first text value)\n  for (const f of fields) {\n    if (f.name === skip || (f.type !== \"url\" && f.type !== \"email\" && f.type !== \"slug\")) continue;\n    const t = plainText(v[f.name]);\n    if (t) return { name: f.name, text: t };\n  }\n  return undefined;\n}\nexport function previewOf(itemSchema: FieldSchema | TypeSchema | undefined, item: unknown, index: number, fallbackTitle?: string): Preview {\n  const v = isObj(item) ? item : {};\n  const fields = (itemSchema && \"fields\" in itemSchema ? itemSchema.fields : undefined) ?? [];\n  const cfg = itemSchema?.preview;\n  const at = (p: string) => fieldText(fields.find((f) => f.name === p), getIn(v, p.split(\".\")));\n  let title = cfg?.title ? at(cfg.title) : \"\";\n  let titleField = cfg?.title;\n  if (!title) {\n    const t = firstText(fields, v);\n    title = t?.text ?? \"\";\n    titleField = t?.name;\n  }\n  let subtitle = cfg?.subtitle ? at(cfg.subtitle) : \"\";\n  if (!subtitle && !cfg?.subtitle) subtitle = firstText(fields, v, titleField)?.text ?? \"\";\n  let media = cfg?.media ? imageUrl(getIn(v, cfg.media.split(\".\"))) : undefined;\n  if (!media && !cfg?.media) {\n    const img = fields.find((f) => f.type === \"image\");\n    if (img) media = imageUrl(v[img.name]);\n  }\n  const empty = !title;\n  const noun = fallbackTitle ?? (itemSchema?.title ?? \"Item\");\n  return {\n    title: title || cfg?.fallback || `${noun} ${index + 1}`,\n    subtitle: subtitle ? (subtitle.length > 90 ? `${subtitle.slice(0, 88)}…` : subtitle) : undefined,\n    media,\n    icon: cfg?.icon ?? (itemSchema as FieldSchema | undefined)?.icon,\n    empty,\n  };\n}\n\n/**\n * How one slot child reads as a row (SlotField): its block's preview (the block's title while it has no text), the\n * variant chip its `_variant` names, and the line under it (block title · settings, else description, else \"Block i of n\").\n */\nexport function slotRowOf(block: TypeSchema | undefined, item: unknown, index: number, count: number, slotSettings?: FieldSchema[]): { preview: Preview; chip?: string; extra: string } {\n  const pv = previewOf(block, item, index, block?.title ?? \"Block\");\n  const variant = block?.variants?.find((v) => isObj(item) && v.id === item._variant)?.name;\n  const settings = slotSettings && isObj(item) ? summarize(slotSettings, item._settings, 2) : \"\";\n  return {\n    preview: { ...pv, title: pv.empty ? (block?.title ?? \"Unknown block\") : pv.title, icon: block?.icon ?? \"box\" },\n    chip: variant,\n    extra: [pv.empty ? undefined : block?.title, settings].filter(Boolean).join(\" · \") || block?.description || `Block ${index + 1} of ${count}`,\n  };\n}\n\n/** \"Cast iron · 4 items\" — one-line summary of an object for collapsed rows and fieldset headers. */\nexport function summarize(fields: FieldSchema[], v: unknown, max = 2): string {\n  if (!isObj(v)) return \"\";\n  const parts: string[] = [];\n  for (const f of fields) {\n    if (parts.length >= max) break;\n    const x = v[f.name];\n    if (isEmptyValue(x)) continue;\n    if (f.type === \"reference\" || f.type === \"json\" || f.type === \"code\" || f.type === \"image\" || f.type === \"file\") continue; // ids and blobs read badly\n    if (f.type === \"table\") {\n      parts.push(tableSummary(x));\n      continue;\n    }\n    if (f.type === \"rating\" && typeof x === \"number\") {\n      parts.push(`${x} / 5`);\n      continue;\n    }\n    if (Array.isArray(x)) parts.push(`${x.length} ${x.length === 1 ? itemNounSafe(f) : `${itemNounSafe(f)}s`}`);\n    else if (typeof x === \"boolean\") parts.push(`${f.title}: ${x ? \"on\" : \"off\"}`);\n    else {\n      const t = fieldText(f, x);\n      if (t) parts.push(t.length > 40 ? `${t.slice(0, 38)}…` : t);\n    }\n  }\n  return parts.join(\" · \");\n}\nconst itemNounSafe = (f: FieldSchema) => (f.type === \"array\" || f.type === \"slot\" ? itemNoun(f) : \"item\");\n"],"mappings":"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"}

package/{lib → dist/lib}/utils.js

@@ -1,4 +1,4 @@
-//#region src/kit/lib/utils.ts
+//#region src/lib/utils.ts
 var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 var uid = (p = "id") => `${p}_${Math.random().toString(36).slice(2, 9)}`;
 function formatNumber(n) {

package/dist/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":[],"sources":["../../src/lib/utils.ts"],"sourcesContent":["export const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));\nexport const uid = (p = \"id\") => `${p}_${Math.random().toString(36).slice(2, 9)}`;\nexport function formatNumber(n: number) {\n  if (n >= 1_000_000) return `${(n / 1_000_000).toFixed(n >= 10_000_000 ? 0 : 1)}M`;\n  if (n >= 1000) return `${(n / 1000).toFixed(n >= 10000 ? 0 : 1)}k`;\n  return `${n}`;\n}\nexport function plural(n: number, one: string, many = `${one}s`) {\n  return `${n} ${n === 1 ? one : many}`;\n}\nexport function initials(name: string) {\n  return name.split(/\\s+/).map((p) => p[0]).slice(0, 2).join(\"\").toUpperCase();\n}\nexport function relTime(iso: string | number | Date) {\n  const d = new Date(iso).getTime();\n  const s = Math.round((Date.now() - d) / 1000);\n  if (s < 45) return \"just now\";\n  const m = Math.round(s / 60); if (m < 60) return `${m}m ago`;\n  const h = Math.round(m / 60); if (h < 24) return `${h}h ago`;\n  const days = Math.round(h / 24); if (days < 7) return `${days}d ago`;\n  const w = Math.round(days / 7); if (w < 5) return `${w}w ago`;\n  return new Date(iso).toLocaleDateString(\"en-US\", { month: \"short\", day: \"numeric\", year: \"numeric\" });\n}\nexport const slugify = (s: string) => s.toLowerCase().trim().replace(/[^a-z0-9]+/g, \"-\").replace(/^-|-$/g, \"\");\n"],"mappings":";AAAA,IAAa,SAAS,OAAe,IAAI,SAAS,MAAM,WAAW,GAAG,EAAE,CAAC;AACzE,IAAa,OAAO,IAAI,SAAS,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC;AAC9E,SAAgB,aAAa,GAAW;CACtC,IAAI,KAAK,KAAW,OAAO,IAAI,IAAI,IAAA,CAAW,QAAQ,KAAK,MAAa,IAAI,CAAC,EAAE;CAC/E,IAAI,KAAK,KAAM,OAAO,IAAI,IAAI,IAAA,CAAM,QAAQ,KAAK,MAAQ,IAAI,CAAC,EAAE;CAChE,OAAO,GAAG;AACZ;AACA,SAAgB,OAAO,GAAW,KAAa,OAAO,GAAG,IAAI,IAAI;CAC/D,OAAO,GAAG,EAAE,GAAG,MAAM,IAAI,MAAM;AACjC;AACA,SAAgB,SAAS,MAAc;CACrC,OAAO,KAAK,MAAM,KAAK,CAAC,CAAC,KAAK,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,YAAY;AAC7E;AACA,SAAgB,QAAQ,KAA6B;CACnD,MAAM,IAAI,IAAI,KAAK,GAAG,CAAC,CAAC,QAAQ;CAChC,MAAM,IAAI,KAAK,OAAO,KAAK,IAAI,IAAI,KAAK,GAAI;CAC5C,IAAI,IAAI,IAAI,OAAO;CACnB,MAAM,IAAI,KAAK,MAAM,IAAI,EAAE;CAAG,IAAI,IAAI,IAAI,OAAO,GAAG,EAAE;CACtD,MAAM,IAAI,KAAK,MAAM,IAAI,EAAE;CAAG,IAAI,IAAI,IAAI,OAAO,GAAG,EAAE;CACtD,MAAM,OAAO,KAAK,MAAM,IAAI,EAAE;CAAG,IAAI,OAAO,GAAG,OAAO,GAAG,KAAK;CAC9D,MAAM,IAAI,KAAK,MAAM,OAAO,CAAC;CAAG,IAAI,IAAI,GAAG,OAAO,GAAG,EAAE;CACvD,OAAO,IAAI,KAAK,GAAG,CAAC,CAAC,mBAAmB,SAAS;EAAE,OAAO;EAAS,KAAK;EAAW,MAAM;CAAU,CAAC;AACtG;AACA,IAAa,WAAW,MAAc,EAAE,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,eAAe,GAAG,CAAC,CAAC,QAAQ,UAAU,EAAE"}

package/{lib → dist/lib}/validate.d.ts

@@ -4,17 +4,27 @@
  * typing for the first time — the shell decides). Warnings (recommendedMax, missing alt) never block publish.
  */
 import type { FieldPath, FieldSchema, TypeSchema } from "../schema/types";
+import { type CondCtx } from "./schema";
 export interface KitIssue {
     key: string;
     path: FieldPath;
     level: "error" | "warning";
     kind: "required" | "rule";
     message: string;
+    /** shown at once, even while the field is being typed in (a host's live check, e.g. the schema editor's help check) */
+    live?: boolean;
+    /** one fix the shell offers after the message ("Clear help") */
+    fix?: {
+        label: string;
+        apply: () => void;
+    };
 }
 type Raw = Omit<KitIssue, "key" | "path">;
 export declare const textLength: (v: unknown) => number;
 /** Validate one value against its field (not recursing into children). */
 export declare function validateValue(f: FieldSchema, v: unknown): Raw | null;
 /** Walk fields under `obj` and collect every issue, recursing into objects, array items and slot blocks. */
-export declare function collectIssues(fields: FieldSchema[], obj: unknown, base: FieldPath, resolveSchema?: (t: string) => TypeSchema | undefined, out?: KitIssue[]): KitIssue[];
+export declare function collectIssues(fields: FieldSchema[], obj: unknown, base: FieldPath, resolveSchema?: (t: string) => TypeSchema | undefined, out?: KitIssue[], 
+/** what a `_variant` condition reads above this level (V2; the root call: the value itself) */
+cc?: CondCtx): KitIssue[];
 export {};