@bettercms-ai/kit 0.1.0 → 1.0.0

package/engine/item-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-list.js","names":[],"sources":["../../src/kit/engine/item-list.tsx"],"sourcesContent":["/**\n * ITEM LIST — arrays of one line each (CPO D47): feature lists, bullets, \"what's included\", key points\n * (V2 HEAD 9829bf1 kit/engine/item-list.tsx).\n * Each item is a row you type into directly: grip · auto-growing input (founder rule: the whole text shows) · ⋯.\n * No drill frame, no expand. Keyboard: Enter adds the next item, Backspace on an empty row removes it, a multi-line\n * paste becomes several items, ⌥↑ / ⌥↓ move the row, ↑ / ↓ at the edges of the text step between rows. None of these\n * keys are printed on screen (D44); they live in aria labels and the ⋯ menu.\n *\n * Works for arrays of primitives (string / text / url / email / number) AND arrays of one-field objects\n * (`[{ _key, text }]`), which read and write that one field and keep their `_key`.\n *\n * Kit deviation: V2 sorts with @dnd-kit, which is not on the kit's package allow-list. `useDragReorder` below is the\n * kit's sortable: pointer drag on the grip (4px activation, siblings slide out of the way like dnd-kit's vertical\n * strategy), and dnd-kit's KeyboardSensor + sortableKeyboardCoordinates on a focused grip: Space / Enter picks the row\n * up, the arrow keys move it (siblings slide, nothing is written yet), Space / Enter / Tab drops it as ONE reorder\n * (one undo step), Escape puts it back. `sort.a11y` is dnd-kit's accessibility markup (hidden instructions + a visually\n * hidden `role=\"status\"` live region), rendered where V2's DndContext rendered it: right after the sortable children.\n */\nimport * as React from \"react\";\nimport { useReducedMotion } from \"framer-motion\";\nimport { IconArrowDown, IconArrowUp, IconCopy, IconDots, IconGripVertical, IconPlus, IconTrash } from \"@tabler/icons-react\";\nimport { Button } from \"../ui/button\";\nimport { Textarea } from \"../ui/input\";\nimport { Menu, MenuContent, MenuItem, MenuSeparator, MenuTrigger } from \"../ui/overlay\";\nimport { cn } from \"../lib/cn\";\nimport type { FieldPath, FieldSchema } from \"../schema/types\";\nimport { useForm, useKitServices } from \"../context\";\nimport { newKey, pathKey } from \"../lib/path\";\nimport { itemNoun } from \"../lib/schema\";\n\nexport type ItemKind = \"text\" | \"number\" | \"url\" | \"email\";\n\nexport interface ItemListAdapter {\n  kind: ItemKind;\n  /** the text shown in the row */\n  read: (item: unknown) => string;\n  /** a new list item holding `value` (objects keep `prev`'s other keys and `_key`) */\n  write: (value: unknown, prev?: unknown) => unknown;\n  /** the stable key of an item, when it carries one (`_key` on objects) */\n  keyOf?: (item: unknown) => string | undefined;\n  /** the path of the editable value inside item `i` (canvas anchoring, issues) */\n  valuePath: (i: number) => FieldPath;\n  placeholder?: string;\n}\n\n/** V2 controls/text TEXT_FOCUS: a list row's input shows the field focus border only, no ring shadow. */\nconst TEXT_FOCUS = \"focus:shadow-none focus-visible:shadow-none\";\nconst EASE = \"cubic-bezier(0.22, 1, 0.36, 1)\";\n\n\nconst cap = (s: string) => s.charAt(0).toUpperCase() + s.slice(1);\n/** \"- Net-30\", \"• Net-30\", \"1. Net-30\", \"[x] Net-30\" → \"Net-30\" */\nconst stripBullet = (s: string) => s.replace(/^\\s*(?:[-*•‣◦▪–—]|\\d+[.)]|\\[[ xX]\\])\\s+/, \"\").trim();\nconst move = <T,>(list: T[], from: number, to: number): T[] => {\n  const next = list.slice();\n  const [it] = next.splice(from, 1);\n  next.splice(to, 0, it);\n  return next;\n};\n/** dnd-kit's arrayMove, for callers that reorder lists. */\nexport const arrayMove = move;\n\nfunction toValue(kind: ItemKind, text: string): unknown {\n  if (kind === \"number\") {\n    const t = text.trim();\n    if (!t) return null;\n    const n = Number(t.replace(/,/g, \"\"));\n    return Number.isFinite(n) ? n : undefined;\n  }\n  return kind === \"url\" || kind === \"email\" ? text.trim() : text;\n}\n\n/* ── Sortable (the kit's stand-in for @dnd-kit) ─────────────────────── */\ninterface DragState {\n  id: string;\n  from: number;\n  over: number;\n  dx: number;\n  dy: number;\n  /** how far a sibling slides to make room (dragged height + the list gap) */\n  shift: number;\n  /** item rects at pick-up (grid tiles slide into their neighbour's rect) */\n  rects: (DOMRect | undefined)[];\n  /** picked up from the keyboard: the row glides between slots instead of following a pointer */\n  keyboard?: boolean;\n}\n\n/** Tiles on the first row of a grid at pick-up (↑ / ↓ jump by this many, like sortableKeyboardCoordinates). */\nconst columns = (rects: (DOMRect | undefined)[]) => {\n  const top = rects[0]?.top;\n  return top == null ? 1 : Math.max(1, rects.filter((r) => r?.top === top).length);\n};\n\n/**\n * Sortable rows by id. `register(id)` goes on the element that moves, `handle(id)` on its grip. Pointer: drag past\n * `distance` px to pick up; the row follows the pointer, siblings slide (list axis by one row, grid into the\n * neighbour's rect), the drop commits ONE reorder.\n * Keyboard on the grip (dnd-kit KeyboardSensor): Space / Enter picks up; ↑ / ↓ (← / → too in a grid, where ↑ / ↓ jump\n * a row of tiles) move it one slot; Space / Enter / Tab drops it as ONE reorder; Escape (or leaving the grip) cancels\n * with nothing written. Focus stays on the grip.\n */\nexport function useDragReorder(\n  ids: string[],\n  onReorder: (from: number, to: number) => void,\n  { axis = \"y\", disabled = false, distance = 4 }: { axis?: \"y\" | \"grid\"; disabled?: boolean; distance?: number } = {},\n) {\n  const [drag, setDrag] = React.useState<DragState | null>(null);\n  const [announcement, setOwnAnnouncement] = React.useState(\"\");\n  const ownId = React.useId();\n  /* inside a shared sort (V2's one DndContext over several lists) the instructions and live region are the context's */\n  const shared = React.useContext(SharedSortContext);\n  const describedBy = shared?.id ?? ownId;\n  const setAnnouncement = shared?.announce ?? setOwnAnnouncement;\n  /* reduced motion: the keyboard glide and the neighbours' slide jump straight to their place */\n  const glide = useReducedMotion() ? \"none\" : `transform 200ms ${EASE}`;\n  const els = React.useRef(new Map<string, HTMLElement>());\n  const grips = React.useRef(new Map<string, HTMLElement>());\n  const refocus = React.useRef<string | null>(null);\n  /* the keyboard drag, read synchronously by key handlers (state lags a render behind) */\n  const kb = React.useRef<DragState | null>(null);\n  const setKb = (s: DragState | null) => {\n    kb.current = s;\n    setDrag(s);\n  };\n  const latest = React.useRef({ ids, onReorder });\n  latest.current = { ids, onReorder };\n\n  React.useLayoutEffect(() => {\n    const id = refocus.current;\n    if (!id) return;\n    refocus.current = null;\n    const g = grips.current.get(id);\n    if (g && document.activeElement !== g) g.focus();\n  });\n\n  const register = (id: string) => (el: HTMLElement | null) => {\n    if (el) els.current.set(id, el);\n    else els.current.delete(id);\n  };\n\n  const onPointerDown = (id: string) => (e: React.PointerEvent) => {\n    if (disabled || e.button !== 0 || kb.current) return;\n    e.stopPropagation();\n    const from = latest.current.ids.indexOf(id);\n    if (from < 0) return;\n    const x0 = e.clientX;\n    const y0 = e.clientY;\n    let rects: (DOMRect | undefined)[] = [];\n    let state: DragState | null = null;\n    const userSelect = document.body.style.userSelect;\n    const onMove = (ev: PointerEvent) => {\n      const dx = ev.clientX - x0;\n      const dy = ev.clientY - y0;\n      if (!state) {\n        if (Math.hypot(dx, dy) < distance) return;\n        rects = latest.current.ids.map((k) => els.current.get(k)?.getBoundingClientRect());\n        const r = rects[from];\n        const next = rects[from + 1] ?? rects[from - 1];\n        const gap = r && next ? Math.max(0, next.top > r.top ? next.top - r.bottom : r.top - next.bottom) : 0;\n        state = { id, from, over: from, dx, dy, shift: (r?.height ?? 0) + gap, rects };\n        document.body.style.userSelect = \"none\";\n        setAnnouncement(`Picked up item ${from + 1} of ${latest.current.ids.length}.`);\n      }\n      const hit = rects.findIndex((r) => r && ev.clientY >= r.top && ev.clientY <= r.bottom && (axis === \"y\" || (ev.clientX >= r.left && ev.clientX <= r.right)));\n      state = { ...state, dx, dy, over: hit >= 0 ? hit : state.over };\n      setDrag(state);\n    };\n    const end = (commit: boolean) => {\n      window.removeEventListener(\"pointermove\", onMove);\n      window.removeEventListener(\"pointerup\", onUp);\n      window.removeEventListener(\"pointercancel\", onCancel);\n      document.body.style.userSelect = userSelect;\n      const s = state;\n      setDrag(null);\n      if (!s) return;\n      /* the click that ends a drag never opens the row under it */\n      const swallow = (ce: MouseEvent) => {\n        ce.stopPropagation();\n        ce.preventDefault();\n      };\n      window.addEventListener(\"click\", swallow, { capture: true, once: true });\n      window.setTimeout(() => window.removeEventListener(\"click\", swallow, { capture: true }), 0);\n      if (commit && s.over !== s.from) latest.current.onReorder(s.from, s.over);\n      setAnnouncement(commit ? `Item dropped at position ${s.over + 1} of ${latest.current.ids.length}.` : `Dragging was cancelled. Item ${s.from + 1} was dropped.`);\n    };\n    const onUp = () => end(true);\n    const onCancel = () => end(false);\n    window.addEventListener(\"pointermove\", onMove);\n    window.addEventListener(\"pointerup\", onUp);\n    window.addEventListener(\"pointercancel\", onCancel);\n  };\n\n  /** where the picked-up row sits over slot `over` (the sortable strategies' target rect) */\n  const offset = (s: DragState, over: number) => {\n    const a = s.rects[s.from];\n    const b = s.rects[over];\n    if (!a || !b || over === s.from) return { dx: 0, dy: 0 };\n    if (axis === \"grid\") return { dx: b.left - a.left, dy: b.top - a.top };\n    return { dx: 0, dy: over > s.from ? b.bottom - a.bottom : b.top - a.top };\n  };\n\n  const onKeyDown = (id: string) => (e: React.KeyboardEvent) => {\n    if (disabled || e.nativeEvent.isComposing) return;\n    const { ids: list, onReorder: commit } = latest.current;\n    const n = list.length;\n    const s = kb.current;\n    if (!s) {\n      if (e.key !== \" \" && e.key !== \"Enter\") return;\n      const from = list.indexOf(id);\n      if (from < 0 || drag) return;\n      e.preventDefault();\n      e.stopPropagation();\n      const rects = list.map((k) => els.current.get(k)?.getBoundingClientRect());\n      const r = rects[from];\n      const next = rects[from + 1] ?? rects[from - 1];\n      const gap = r && next ? Math.max(0, next.top > r.top ? next.top - r.bottom : r.top - next.bottom) : 0;\n      setKb({ id, from, over: from, dx: 0, dy: 0, shift: (r?.height ?? 0) + gap, rects, keyboard: true });\n      setAnnouncement(`Picked up item ${from + 1} of ${n}.`);\n      return;\n    }\n    if (s.id !== id) return;\n    if (e.key === \" \" || e.key === \"Enter\" || e.key === \"Tab\") {\n      if (e.key !== \"Tab\") {\n        e.preventDefault();\n        refocus.current = id;\n      }\n      e.stopPropagation();\n      setKb(null);\n      // the list changed under the drag (another writer): nothing is moved, and the reason is announced\n      if (list[s.from] !== id) return setAnnouncement(`The list changed while moving. Item ${s.from + 1} was not moved.`);\n      if (s.over !== s.from) commit(s.from, s.over);\n      setAnnouncement(`Item dropped at position ${s.over + 1} of ${n}.`);\n      return;\n    }\n    if (e.key === \"Escape\") {\n      e.preventDefault();\n      e.stopPropagation();\n      refocus.current = id;\n      setKb(null);\n      setAnnouncement(`Dragging was cancelled. Item ${s.from + 1} was dropped.`);\n      return;\n    }\n    const rowStep = axis === \"grid\" ? columns(s.rects) : 1;\n    const step =\n      e.key === \"ArrowDown\" ? rowStep : e.key === \"ArrowUp\" ? -rowStep :\n      axis === \"grid\" && e.key === \"ArrowRight\" ? 1 : axis === \"grid\" && e.key === \"ArrowLeft\" ? -1 : 0;\n    if (!step) return;\n    e.preventDefault();\n    e.stopPropagation();\n    const to = s.over + step;\n    if (to < 0 || to >= n) return;\n    setKb({ ...s, over: to, ...offset(s, to) });\n    setAnnouncement(`Item moved to position ${to + 1} of ${n}.`);\n  };\n\n  /* focus leaving a picked-up grip (a click elsewhere) puts the row back, like Escape */\n  const onBlur = (id: string) => () => {\n    const s = kb.current;\n    if (!s || s.id !== id) return;\n    setKb(null);\n    setAnnouncement(`Dragging was cancelled. Item ${s.from + 1} was dropped.`);\n  };\n\n  const handle = (id: string) => ({\n    ref: (el: HTMLElement | null) => {\n      if (el) grips.current.set(id, el);\n      else grips.current.delete(id);\n    },\n    onPointerDown: onPointerDown(id),\n    onKeyDown: onKeyDown(id),\n    onBlur: onBlur(id),\n    \"aria-pressed\": drag?.id === id ? true : undefined,\n    \"aria-roledescription\": \"sortable\",\n    \"aria-describedby\": describedBy,\n    \"data-drag-handle\": id,\n  });\n\n  const style = (id: string): React.CSSProperties | undefined => {\n    if (!drag) return undefined;\n    if (id === drag.id) return { transform: `translate3d(${axis === \"grid\" ? drag.dx : 0}px, ${drag.dy}px, 0)`, zIndex: 10, position: \"relative\", transition: drag.keyboard ? glide : \"none\" };\n    const i = ids.indexOf(id);\n    const { from, over, shift } = drag;\n    if (axis === \"grid\") {\n      /* dnd-kit rectSortingStrategy (V2 grid lists): each tile between the pick-up and the hover slot slides into its\n         neighbour's rect, so the gap opens where the tile will land */\n      const to = from < over && i > from && i <= over ? i - 1 : from > over && i >= over && i < from ? i + 1 : i;\n      const a = drag.rects[i];\n      const b = drag.rects[to];\n      const t = to !== i && a && b ? `translate3d(${b.left - a.left}px, ${b.top - a.top}px, 0)` : undefined;\n      return { transform: t, transition: glide };\n    }\n    const dy = from < over && i > from && i <= over ? -shift : from > over && i >= over && i < from ? shift : 0;\n    return { transform: dy ? `translate3d(0, ${dy}px, 0)` : undefined, transition: glide };\n  };\n\n  const a11y = shared ? null : <SortAnnouncer id={describedBy} announcement={announcement} />;\n  return { register, handle, style, active: drag?.id ?? null, over: drag ? ids[drag.over] ?? null : null, a11y };\n}\n\nconst SharedSortContext = React.createContext<{ id: string; announce: (message: string) => void } | null>(null);\n\n/**\n * One announcer for several sortable lists, as V2 has where ONE DndContext wraps them (a table's row groups): the\n * lists under `SharedSortProvider value={value}` describe their grips with its instructions and announce into its live region, and `a11y`\n * renders once where V2's DndContext rendered it (after its children).\n */\nexport function useSharedSort() {\n  const [announcement, setAnnouncement] = React.useState(\"\");\n  const id = React.useId();\n  const value = React.useMemo(() => ({ id, announce: setAnnouncement }), [id]);\n  return { value, a11y: <SortAnnouncer id={id} announcement={announcement} /> };\n}\nexport const SharedSortProvider = SharedSortContext.Provider;\n\n/* dnd-kit's LiveRegion style: visually hidden, still read by screen readers */\nconst LIVE_REGION: React.CSSProperties = {\n  position: \"fixed\", top: 0, left: 0, width: 1, height: 1, margin: -1, border: 0, padding: 0, overflow: \"hidden\",\n  clip: \"rect(0 0 0 0)\", clipPath: \"inset(100%)\", whiteSpace: \"nowrap\",\n};\n/**\n * dnd-kit's <Accessibility> (V2 got it from every DndContext): the drag instructions (display: none, named by each\n * handle's aria-describedby) and an assertive `role=\"status\"` live region with the last move. Like dnd-kit it renders\n * only after mount.\n */\nfunction SortAnnouncer({ id, announcement }: { id: string; announcement: string }) {\n  const [mounted, setMounted] = React.useState(false);\n  React.useEffect(() => setMounted(true), []);\n  if (!mounted) return null;\n  return (\n    <>\n      <div id={id} style={{ display: \"none\" }}>\n        To pick up a draggable item, press the space bar or enter. While dragging, use the arrow keys to move the item. Press space or enter again to drop the item in its new position, or press escape to cancel.\n      </div>\n      <div style={LIVE_REGION} role=\"status\" aria-live=\"assertive\" aria-atomic>\n        {announcement}\n      </div>\n    </>\n  );\n}\n\n/** Keys for list items that have none (primitives): stable across our own edits, regenerated on outside changes. */\nfunction useRowKeys(list: unknown[], keyOf?: (item: unknown) => string | undefined) {\n  const local = React.useRef<string[]>([]);\n  if (keyOf) return { keys: list.map((it, i) => keyOf(it) ?? `i${i}`), set: (_: string[]) => {} };\n  if (local.current.length !== list.length) {\n    const next = local.current.slice(0, list.length);\n    while (next.length < list.length) next.push(newKey());\n    local.current = next;\n  }\n  return { keys: local.current, set: (k: string[]) => (local.current = k) };\n}\n\nexport function ItemList({\n  field,\n  path,\n  list,\n  readOnly,\n  adapter,\n  inputId,\n}: {\n  field: FieldSchema;\n  path: FieldPath;\n  list: unknown[];\n  readOnly: boolean;\n  adapter: ItemListAdapter;\n  /** the field label's `htmlFor` lands on the first row */\n  inputId?: string;\n}) {\n  const form = useForm()!;\n  const { toast } = useKitServices();\n  const { min, max } = field.validation ?? {};\n  const noun = itemNoun(field);\n  const { keys, set: setKeys } = useRowKeys(list, adapter.keyOf);\n  const inputs = React.useRef(new Map<string, HTMLTextAreaElement>());\n  const addRef = React.useRef<HTMLButtonElement>(null);\n  const focusReq = React.useRef<{ key: string; caret: \"start\" | \"end\" | number } | null>(null);\n  const atMax = max != null && list.length >= max;\n  const atMin = min != null && list.length <= min;\n\n  // Apply a pending focus after the list re-renders (add / remove / move / paste).\n  React.useLayoutEffect(() => {\n    const req = focusReq.current;\n    if (!req) return;\n    const el = inputs.current.get(req.key);\n    if (!el) return;\n    focusReq.current = null;\n    el.focus({ preventScroll: false });\n    const at = req.caret === \"start\" ? 0 : req.caret === \"end\" ? el.value.length : Math.min(req.caret, el.value.length);\n    el.setSelectionRange(at, at);\n    el.scrollIntoView?.({ block: \"nearest\" });\n  });\n\n  const commit = (next: unknown[], nextKeys: string[]) => {\n    setKeys(nextKeys);\n    form.setAt(path, next);\n  };\n  const limitToast = () => toast?.(\"Limit reached\", { description: `${field.title} allows ${max} at most.` });\n\n  /** Insert `values` after row i (and optionally replace row i itself in the same write). */\n  const insertAfter = (i: number, values: unknown[], caret: \"start\" | \"end\" = \"end\", current?: unknown) => {\n    const room = max == null ? values.length : Math.max(0, max - list.length);\n    if (room === 0) return limitToast();\n    const take = values.slice(0, room);\n    if (take.length < values.length) toast?.(\"Some lines were left out\", { description: `${field.title} allows ${max} at most, so ${values.length - take.length} didn't fit.` });\n    const items = take.map((v) => adapter.write(v));\n    const newKeys = items.map((it) => adapter.keyOf?.(it) ?? newKey());\n    const head = current === undefined ? list.slice(0, i + 1) : [...list.slice(0, i), current];\n    commit([...head, ...items, ...list.slice(i + 1)], [...keys.slice(0, i + 1), ...newKeys, ...keys.slice(i + 1)]);\n    focusReq.current = { key: newKeys[newKeys.length - 1], caret };\n  };\n  const add = () => {\n    if (atMax) return limitToast();\n    insertAfter(list.length - 1, [adapter.kind === \"number\" ? null : \"\"]);\n  };\n  const removeAt = (i: number, opts: { undo?: boolean; focus?: \"prev\" | \"none\" } = {}) => {\n    if (atMin) return toast?.(`At least ${min} required`, { description: `${field.title} needs ${min} or more.` });\n    const prevList = list;\n    const prevKeys = keys;\n    commit(list.filter((_, j) => j !== i), keys.filter((_, j) => j !== i));\n    if (opts.focus !== \"none\") {\n      const target = i > 0 ? keys[i - 1] : keys[i + 1];\n      if (target) focusReq.current = { key: target, caret: i > 0 ? \"end\" : \"start\" };\n      else window.setTimeout(() => addRef.current?.focus(), 0);\n    }\n    if (opts.undo) {\n      const text = adapter.read(prevList[i]);\n      toast?.(text ? `“${text.length > 40 ? `${text.slice(0, 38)}…` : text}” removed` : `${cap(noun)} removed`, {\n        action: { label: \"Undo\", onClick: () => commit(prevList, prevKeys) },\n        duration: 10_000,\n      });\n    }\n  };\n  const moveRow = (i: number, d: -1 | 1, keepFocus = false) => {\n    const to = i + d;\n    if (to < 0 || to >= list.length) return;\n    const caret = inputs.current.get(keys[i])?.selectionStart ?? \"end\";\n    commit(move(list, i, to), move(keys, i, to));\n    if (keepFocus) focusReq.current = { key: keys[i], caret };\n  };\n  const duplicate = (i: number) => {\n    if (atMax) return limitToast();\n    insertAfter(i, [toValue(adapter.kind, adapter.read(list[i])) ?? adapter.read(list[i])]);\n  };\n  const focusRow = (i: number, caret: \"start\" | \"end\") => {\n    const el = inputs.current.get(keys[i]);\n    if (!el) return;\n    el.focus();\n    const at = caret === \"start\" ? 0 : el.value.length;\n    el.setSelectionRange(at, at);\n  };\n\n  const sort = useDragReorder(keys, (from, to) => commit(move(list, from, to), move(keys, from, to)), { disabled: readOnly });\n\n  const n = list.length;\n  return (\n    <div className=\"flex flex-col gap-1.5\">\n      {n ? (\n        <>\n          <ul className=\"flex flex-col gap-1.5\" aria-label={field.title}>\n            {list.map((item, i) => (\n              <ItemRow\n                key={keys[i]}\n                rowKey={keys[i]}\n                sort={sort}\n                index={i}\n                count={n}\n                noun={noun}\n                item={item}\n                adapter={adapter}\n                readOnly={readOnly}\n                fieldKey={pathKey([...path, ...adapter.valuePath(i)])}\n                invalid={!!form.visibleIssue(pathKey([...path, ...adapter.valuePath(i)]))}\n                inputId={i === 0 ? inputId : undefined}\n                canAdd={!atMax}\n                canRemove={!atMin}\n                min={min}\n                register={(el) => (el ? inputs.current.set(keys[i], el) : inputs.current.delete(keys[i]))}\n                onChange={(v) => form.setAt([...path, i], adapter.write(v, item))}\n                onBlur={() => form.touch(pathKey([...path, ...adapter.valuePath(i)]))}\n                onEnter={(caretAtStart) => {\n                  if (!adapter.read(item).trim() && i === n - 1) return; // an empty last row doesn't spawn another\n                  if (atMax) return limitToast();\n                  // caret at the very start of a filled row: insert ABOVE (like a list in a doc)\n                  if (caretAtStart && adapter.read(item)) {\n                    const k = adapter.write(adapter.kind === \"number\" ? null : \"\");\n                    const nk = adapter.keyOf?.(k) ?? newKey();\n                    commit([...list.slice(0, i), k, ...list.slice(i)], [...keys.slice(0, i), nk, ...keys.slice(i)]);\n                    focusReq.current = { key: keys[i], caret: \"start\" };\n                    return;\n                  }\n                  insertAfter(i, [adapter.kind === \"number\" ? null : \"\"]);\n                }}\n                onBackspaceEmpty={() => removeAt(i, { focus: \"prev\" })}\n                onPasteLines={(first, rest, caret) => {\n                  const items = rest.map((t) => toValue(adapter.kind, t)).filter((v) => v !== undefined);\n                  const current = adapter.write(toValue(adapter.kind, first) ?? first, item);\n                  if (items.length && !atMax) insertAfter(i, items, \"end\", current);\n                  else {\n                    if (items.length) limitToast();\n                    form.setAt([...path, i], current);\n                    focusReq.current = { key: keys[i], caret };\n                  }\n                }}\n                onMove={(d) => moveRow(i, d, true)}\n                onStep={(d) => {\n                  const j = i + d;\n                  if (j >= 0 && j < n) focusRow(j, d < 0 ? \"end\" : \"start\");\n                }}\n                onDuplicate={() => duplicate(i)}\n                onRemove={() => removeAt(i, { undo: true })}\n                onMenuMove={(d) => moveRow(i, d)}\n              />\n            ))}\n          </ul>\n          {sort.a11y}\n        </>\n      ) : null}\n      {readOnly ? (n ? null : <span className=\"text-kit-sm text-kit-fg-3\">Nothing here yet.</span>) : (\n        <Button ref={addRef} size=\"sm\" variant=\"ghost\" className=\"-ml-1 self-start text-kit-fg-2\" leftIcon={<IconPlus stroke={1.5} />} disabled={atMax} onClick={add}>\n          Add {noun}\n        </Button>\n      )}\n    </div>\n  );\n}\n\nfunction ItemRow({\n  rowKey, sort, index, count, noun, item, adapter, readOnly, fieldKey, invalid, inputId, canAdd, canRemove, min, register,\n  onChange, onBlur, onEnter, onBackspaceEmpty, onPasteLines, onMove, onStep, onDuplicate, onRemove, onMenuMove,\n}: {\n  rowKey: string; sort: ReturnType<typeof useDragReorder>; index: number; count: number; noun: string; item: unknown; adapter: ItemListAdapter; readOnly: boolean;\n  fieldKey: string; invalid: boolean; inputId?: string; canAdd: boolean; canRemove: boolean; min?: number;\n  register: (el: HTMLTextAreaElement | null) => void;\n  onChange: (v: unknown) => void; onBlur: () => void; onEnter: (caretAtStart: boolean) => void; onBackspaceEmpty: () => void;\n  onPasteLines: (first: string, rest: string[], caret: number) => void; onMove: (d: -1 | 1) => void; onStep: (d: -1 | 1) => void;\n  onDuplicate: () => void; onRemove: () => void; onMenuMove: (d: -1 | 1) => void;\n}) {\n  const isDragging = sort.active === rowKey;\n  const text = adapter.read(item);\n  // numbers keep what you're typing (\"1.\", \"-\") until it parses\n  const [draft, setDraft] = React.useState<string | null>(null);\n  const shown = draft ?? text;\n  const label = `${cap(noun)} ${index + 1} of ${count}`;\n  const name = text ? `“${text.length > 32 ? `${text.slice(0, 30)}…` : text}”` : `${noun} ${index + 1}`;\n  return (\n    <li\n      ref={sort.register(rowKey)}\n      style={sort.style(rowKey)}\n      data-field-key={fieldKey}\n      className={cn(\"group/il relative flex items-start gap-1\", isDragging && \"z-10 rounded-kit-md bg-kit-surface shadow-kit-lg\")}\n    >\n      {readOnly ? null : (\n        <button\n          type=\"button\"\n          aria-label={`Reorder ${name}`}\n          {...sort.handle(rowKey)}\n          className=\"relative mt-1.5 flex h-5 w-4 shrink-0 cursor-grab touch-none items-center justify-center rounded-kit-sm text-kit-fg-4 transition-colors before:absolute before:-inset-1.5 hover:text-kit-fg-2 active:cursor-grabbing\"\n        >\n          <IconGripVertical className=\"size-3.5\" stroke={1.5} />\n        </button>\n      )}\n      <div className=\"min-w-0 flex-1\">\n        <Textarea\n          ref={register}\n          id={inputId}\n          rows={1}\n          value={shown}\n          readOnly={readOnly}\n          aria-label={label}\n          aria-invalid={invalid || undefined}\n          placeholder={adapter.placeholder ?? cap(noun)}\n          inputMode={adapter.kind === \"number\" ? \"decimal\" : adapter.kind === \"url\" ? \"url\" : adapter.kind === \"email\" ? \"email\" : undefined}\n          spellCheck={adapter.kind === \"text\"}\n          onBlur={() => {\n            setDraft(null);\n            onBlur();\n          }}\n          onChange={(e) => {\n            const raw = e.target.value.replace(/\\r?\\n/g, \" \");\n            if (adapter.kind === \"number\") {\n              setDraft(raw);\n              const v = toValue(\"number\", raw);\n              if (v !== undefined) onChange(v);\n              return;\n            }\n            onChange(toValue(adapter.kind, raw));\n          }}\n          onPaste={(e) => {\n            if (readOnly) return;\n            const clip = e.clipboardData.getData(\"text/plain\");\n            if (!/\\r?\\n/.test(clip.trim())) return; // one line: the browser pastes it\n            const lines = clip.split(/\\r?\\n/).map(stripBullet).filter(Boolean);\n            if (lines.length < 2) return;\n            e.preventDefault();\n            const el = e.currentTarget;\n            const before = el.value.slice(0, el.selectionStart);\n            const after = el.value.slice(el.selectionEnd);\n            const rest = lines.slice(1);\n            rest[rest.length - 1] = `${rest[rest.length - 1]}${after}`;\n            onPasteLines(`${before}${lines[0]}`, rest, before.length + lines[0].length);\n          }}\n          onKeyDown={(e) => {\n            if (readOnly || e.nativeEvent.isComposing) return;\n            const el = e.currentTarget;\n            const atStart = el.selectionStart === 0 && el.selectionEnd === 0;\n            const atEnd = el.selectionStart === el.value.length && el.selectionEnd === el.value.length;\n            if (e.key === \"Enter\" && !e.shiftKey && !e.metaKey && !e.ctrlKey) {\n              e.preventDefault();\n              onEnter(atStart && el.value.length > 0);\n            } else if (e.key === \"Backspace\" && !el.value && canRemove) {\n              e.preventDefault();\n              onBackspaceEmpty();\n            } else if (e.altKey && (e.key === \"ArrowUp\" || e.key === \"ArrowDown\")) {\n              e.preventDefault();\n              onMove(e.key === \"ArrowUp\" ? -1 : 1);\n            } else if (e.key === \"ArrowUp\" && atStart && !e.shiftKey) {\n              if (index > 0) {\n                e.preventDefault();\n                onStep(-1);\n              }\n            } else if (e.key === \"ArrowDown\" && atEnd && !e.shiftKey) {\n              if (index < count - 1) {\n                e.preventDefault();\n                onStep(1);\n              }\n            }\n          }}\n          className={cn(TEXT_FOCUS, \"min-h-8 py-1.5 leading-5\")}\n        />\n      </div>\n      {readOnly ? null : (\n        <Menu>\n          <MenuTrigger\n            aria-label={`${cap(noun)} ${index + 1} actions`}\n            className=\"mt-0.5 flex size-7 shrink-0 items-center justify-center rounded-kit-md text-kit-fg-4 transition-colors hover:bg-kit-hover hover:text-kit-fg group-focus-within/il:text-kit-fg-3 group-hover/il:text-kit-fg-3 data-[popup-open]:bg-kit-hover data-[popup-open]:text-kit-fg\"\n          >\n            <IconDots className=\"size-4\" stroke={1.5} />\n          </MenuTrigger>\n          <MenuContent align=\"end\" className=\"w-48\">\n            <MenuItem icon={<IconCopy stroke={1.5} />} disabled={!canAdd} onClick={onDuplicate}>{canAdd ? \"Duplicate\" : \"Duplicate · limit reached\"}</MenuItem>\n            <MenuSeparator />\n            <MenuItem icon={<IconArrowUp stroke={1.5} />} disabled={index === 0} shortcut=\"⌥↑\" onClick={() => onMenuMove(-1)}>Move up</MenuItem>\n            <MenuItem icon={<IconArrowDown stroke={1.5} />} disabled={index === count - 1} shortcut=\"⌥↓\" onClick={() => onMenuMove(1)}>Move down</MenuItem>\n            <MenuSeparator />\n            <MenuItem danger icon={<IconTrash stroke={1.5} />} disabled={!canRemove} onClick={onRemove}>{canRemove ? \"Delete\" : `Delete · at least ${min} required`}</MenuItem>\n          </MenuContent>\n        </Menu>\n      )}\n    </li>\n  );\n}\n"],"mappings":"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"}

package/engine/kit-field.d.ts

@@ -0,0 +1,72 @@
+/**
+ * KitField — renders ONE field of the schema at `path` (must be inside <SchemaForm>): the shell + the control for its
+ * type (V2 HEAD 9829bf1 kit/engine/kit-field.tsx).
+ *
+ * Arrays (array.tsx) and slots (slot.tsx) get their rows; objects open inline (FieldInset), drill (NavRow -> a frame),
+ * popover or dialog (NestedForm: its own navigation stack). Primitive types dispatch through the CONTROLS table, which
+ * the controls lanes fill. Every SchemaType has a control there; a type that is none of them (a schema newer than this
+ * kit) edits its raw value in the JSON control (FallbackControl), never nothing and never a stand-in.
+ */
+import * as React from "react";
+import type { ComponentType } from "react";
+import type { FieldPath, FieldSchema, SchemaType } from "../schema/types";
+import type { ControlProps } from "../types";
+import { type NestedFormProps } from "./array";
+export interface KitFieldProps {
+    field: FieldSchema;
+    path: (string | number)[];
+    parent?: Record<string, unknown>;
+}
+/** Type → control. Registered by the controls lane; a type with no entry edits its raw value (FallbackControl). */
+export declare const CONTROLS: Partial<Record<SchemaType, ComponentType<ControlProps>>>;
+/**
+ * Type → label-row action (DESIGN 4.4: slug Generate, rich text expand, table Edit in full screen), registered by the
+ * controls lane next to its control. It gets the control's props. V2 draws it only while the field is editable, except
+ * the types in ACTION_WHEN_READ_ONLY, whose action takes `readOnly` and decides for itself (slug Generate).
+ */
+export declare const ACTIONS: Partial<Record<SchemaType, ComponentType<ControlProps>>>;
+export declare const ACTION_WHEN_READ_ONLY: Set<SchemaType>;
+/** D58: the field for the lens: read-only (plain text) when it can't edit it. Hidden fields never reach here
+ *  (SchemaForm drops them from the schema). */
+export declare function useFieldAccess(field: FieldSchema): {
+    readOnly: boolean;
+};
+/** CPO D39: the field's help line — schema text first, then a line computed from its settings, then the house convention. */
+export declare function withDefaultHelp(field: FieldSchema, isPublished?: boolean, readOnly?: boolean): FieldSchema;
+export declare function KitField({ field, path, parent }: KitFieldProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * A row that opens something (V2 NavRow): type tile, title over a summary line, the field's chrome (from RowChrome),
+ * the issue rollup and a chevron.
+ * Like V2 it always draws its button and chevron, also with no `onClick` (a popover trigger around it opens on the
+ * click). Only `inert` (the form draws no frames, so nothing can open) leaves both out.
+ */
+export declare function NavRow({ icon, title, subtitle, path, onClick, inert, className, trailing, }: {
+    icon?: string;
+    title: string;
+    subtitle?: string;
+    path?: FieldPath;
+    onClick?: () => void;
+    inert?: boolean;
+    className?: string;
+    trailing?: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * A dialog gets its OWN navigation stack: lists inside it drill inside the dialog (breadcrumb, Esc, stepper), never the
+ * panel behind. Writes go straight into the parent form at `path`.
+ */
+export declare function NestedForm({ fields, title, icon, path, navRef }: NestedFormProps): import("react/jsx-runtime").JSX.Element;
+export declare function plainOf(field: FieldSchema, value: unknown): string;
+/**
+ * Every SchemaType has a kit control (kit-field.test checks CONTROLS against the type list in schema/types.ts). A field
+ * whose type is none of them edits its raw stored value in the JSON control, tagged `data-kit-fallback="<type>"`: the
+ * value is shown and kept, and an edit is written only once it parses.
+ */
+export declare function FallbackControl(props: ControlProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * A control that cannot carry a stored value unchanged (rich text holding formatting its editor would drop) hands that
+ * value to the host's control for the type (KitServices.LegacyControl: the dashboard's FieldRenderer arm), bare inside
+ * the kit FieldShell, which owns the label and the help; the control names its reason above it. The box carries
+ * `data-kit-legacy="<type>"`, so the parity harness counts it (mismatch class `legacy-control`). A host with no legacy
+ * service, or a control that throws while rendering, says why in words; the form around it keeps working.
+ */
+export declare function LegacyFallback(props: ControlProps): import("react/jsx-runtime").JSX.Element;