@bettercms-ai/kit 0.1.1 → 1.0.0

package/controls/reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.js","names":[],"sources":["../../src/kit/controls/reference.tsx"],"sourcesContent":["/**\n * REFERENCE — single: a select-like trigger (\"Select a CMS item\") → a 300px search popover with \"None\", result rows,\n * drafts labelled, and \"Create new\" inline when the host can create. Never lists the document being edited. No one-click\n * clear (⋯ → Remove). MULTI-REFERENCE — reorderable chips + \"+ Add\", \"n / max\"; at the limit the picker swaps in place.\n * (V2 HEAD 9829bf1 kit/controls/reference.tsx, DESIGN.md 6.8, 8.16, 9.6.)\n *\n * The rows come from the host (reference-services.ts): `searchReferences` is POST /content/reference-options, which\n * already applies the field's `reference.filter` and scope; `truncated` says its filter scan stopped early, and the\n * picker says so. The stored value is the target id (\"en_12\"; a list for many), exactly V2's shape.\n *\n * Kit deviations from V2: no seed rows (every row is a real record from the service); matching is the server's title /\n * slug search, so rows keep the server's order; a stored id the lookup cannot find shows as a \"Missing\" card, or in a\n * multi list one compact \"n missing\" chip with Remove (DESIGN 9.6's production rule), instead of disappearing; chips sort with the engine's `useDragReorder`\n * (@dnd-kit is not on the kit allow-list).\n */\nimport * as React from \"react\";\nimport { IconArrowUpRight, IconCheck, IconChevronDown, IconDatabase, IconDots, IconFileDatabase, IconFileText, IconForms, IconPlus, IconReplace, IconSearch, IconShoppingBag, IconTrash, IconX } from \"@tabler/icons-react\";\nimport type { KitReferenceKind, KitReferenceOption } from \"./reference-services\";\nimport { Button } from \"../ui/button\";\nimport { Avatar } from \"../ui/display\";\nimport { Menu, MenuContent, MenuItem, MenuSeparator, MenuTrigger, Popover, PopoverContent, PopoverTrigger } from \"../ui/overlay\";\nimport { cn } from \"../lib/cn\";\nimport { useDragReorder } from \"../engine/item-list\";\nimport { useKitEnv, useKitServices } from \"../context\";\nimport type { ControlProps } from \"../types\";\n\nconst NON_ENTRY = new Set([\"page\", \"form\", \"collection\", \"shopify\"]);\nconst isEntryTarget = (t: string) => !NON_ENTRY.has(t);\nconst targetsOf = (field: ControlProps[\"field\"]) => field.reference?.to ?? [];\n\n/** The noun the picker uses (D48: \"CMS item\" where V2 says \"entry\"). */\nexport function referenceNoun(to: string[]): string {\n  if (to.length === 1) return to[0] === \"page\" ? \"page\" : to[0] === \"form\" ? \"form\" : to[0] === \"collection\" ? \"collection\" : to[0] === \"shopify\" ? \"product\" : \"CMS item\";\n  return to.length && to.every(isEntryTarget) ? \"CMS item\" : \"item\";\n}\nconst plural = (noun: string) => (noun === \"CMS item\" ? \"CMS items\" : `${noun}s`);\nconst withArticle = (noun: string) => `${/^[aeiou]/i.test(noun) ? \"an\" : \"a\"} ${noun}`;\nconst reasonOf = (e: unknown) => (e instanceof Error ? e.message : String(e));\nconst PAGE = 25;\n/** V2 (Radix) slides a picker that would overflow along the edge, keeping it over the panel; Base UI would flip it to\n *  end-aligned, which hangs it left over the preview */\nconst SHIFT = { align: \"shift\" } as const;\n\nconst KIND_ICON: Record<KitReferenceKind, React.ComponentType<{ className?: string; stroke?: number }>> = {\n  entry: IconFileDatabase,\n  page: IconFileText,\n  form: IconForms,\n  collection: IconDatabase,\n  shopify: IconShoppingBag,\n};\n\nexport function RefThumb({ o, size = 28 }: { o: Pick<KitReferenceOption, \"kind\" | \"title\" | \"photo\"> | null; size?: number }) {\n  // a person with a photo is drawn as V2 draws an author: their round avatar (initials if the image fails)\n  if (o?.photo) return <Avatar name={o.title} src={o.photo} size={size} decorative />;\n  const Icon = o ? KIND_ICON[o.kind] : IconFileDatabase;\n  return (\n    <span aria-hidden style={{ width: size, height: size }} className=\"flex shrink-0 items-center justify-center rounded-kit-md border border-kit-line bg-kit-subtle text-kit-fg-3\">\n      <Icon className={size > 24 ? \"size-4\" : \"size-3.5\"} stroke={1.5} />\n    </span>\n  );\n}\n\nfunction DraftChip({ status }: { status?: string | null }) {\n  return status === \"draft\" ? <span className=\"shrink-0 rounded-kit-md bg-kit-muted px-1 text-kit-2xs text-kit-fg-3\">Draft</span> : null;\n}\n\n/* ── Lookup: stored ids → their records ────────────────────────────── */\n/**\n * The records behind `ids`, read once per id through `lookupReferences`. An id the service does not hand back is\n * `missing`; a failed read is `error` (in words). A row picked in the picker is `remember`ed, so it shows at once.\n */\nexport function useReferenceRecords(ids: string[], to: string[]) {\n  const { lookupReferences } = useKitServices();\n  const [known, setKnown] = React.useState<Record<string, KitReferenceOption>>({});\n  const [missing, setMissing] = React.useState<ReadonlySet<string>>(new Set());\n  const [error, setError] = React.useState<string | null>(null);\n  const inflight = React.useRef(new Set<string>());\n  const alive = React.useRef(true);\n  // set on every mount: StrictMode mounts, unmounts and mounts again, and a flag only cleared would drop every read\n  React.useEffect(() => {\n    alive.current = true;\n    return () => {\n      alive.current = false;\n    };\n  }, []);\n  const idsKey = ids.join(\"|\");\n  const toKey = to.join(\"|\");\n  React.useEffect(() => {\n    if (!lookupReferences) return;\n    const asked = ids.filter((x) => !known[x] && !missing.has(x) && !inflight.current.has(x));\n    if (!asked.length) return;\n    for (const x of asked) inflight.current.add(x);\n    lookupReferences(asked, to)\n      .then((rows) => {\n        if (!alive.current) return;\n        const found = new Set(rows.map((r) => r.id));\n        setKnown((k) => ({ ...k, ...Object.fromEntries(rows.map((r) => [r.id, r])) }));\n        setMissing((m) => new Set([...m, ...asked.filter((x) => !found.has(x))]));\n        setError(null);\n      })\n      .catch((e: unknown) => alive.current && setError(`The saved ${plural(referenceNoun(to))} could not be read: ${reasonOf(e)}`))\n      .finally(() => {\n        for (const x of asked) inflight.current.delete(x);\n      });\n  }, [idsKey, toKey, lookupReferences, known, missing]); // eslint-disable-line react-hooks/exhaustive-deps\n  const remember = React.useCallback((o: KitReferenceOption) => {\n    setKnown((k) => ({ ...k, [o.id]: o }));\n    setMissing((m) => (m.has(o.id) ? new Set([...m].filter((x) => x !== o.id)) : m));\n  }, []);\n  return { known, missing, loading: !!lookupReferences && ids.some((x) => !known[x] && !missing.has(x)) && !error, error, remember, canLookup: !!lookupReferences };\n}\n\n/* ── The search popover body, shared by single and multi ───────────── */\nfunction PickerBody({\n  to,\n  filter,\n  selected,\n  multi,\n  max,\n  noun,\n  onPick,\n  onNone,\n  canCreate,\n  onCreated,\n}: {\n  to: string[];\n  filter?: string;\n  selected: string[];\n  multi?: boolean;\n  max?: number;\n  noun: string;\n  onPick: (o: KitReferenceOption) => void;\n  onNone?: () => void;\n  canCreate: boolean;\n  onCreated: (o: KitReferenceOption) => void;\n}) {\n  const { searchReferences, createReference } = useKitServices();\n  const env = useKitEnv();\n  const [q, setQ] = React.useState(\"\");\n  const [query, setQuery] = React.useState(\"\");\n  const [rows, setRows] = React.useState<KitReferenceOption[]>([]);\n  const [truncated, setTruncated] = React.useState(false);\n  const [loading, setLoading] = React.useState(true);\n  const [error, setError] = React.useState<string | null>(null);\n  const [active, setActive] = React.useState(0);\n  const [creating, setCreating] = React.useState(false);\n  const [createBusy, setCreateBusy] = React.useState(false);\n  const [createError, setCreateError] = React.useState<string | null>(null);\n  const listId = React.useId();\n\n  React.useEffect(() => {\n    const t = window.setTimeout(() => setQuery(q.trim()), q.trim() ? 180 : 0);\n    return () => window.clearTimeout(t);\n  }, [q]);\n  const toKey = to.join(\"|\");\n  React.useEffect(() => {\n    if (!searchReferences) return;\n    const ctrl = new AbortController();\n    setLoading(true);\n    searchReferences({ to, filter, q: query, limit: PAGE, excludeId: env.docId, signal: ctrl.signal })\n      .then((r) => {\n        if (ctrl.signal.aborted) return;\n        setRows(r.options.filter((o) => o.id !== env.docId));\n        setTruncated(r.truncated);\n        setError(null);\n        setActive(0);\n      })\n      .catch((e: unknown) => !ctrl.signal.aborted && setError(reasonOf(e)))\n      .finally(() => !ctrl.signal.aborted && setLoading(false));\n    return () => ctrl.abort();\n  }, [query, toKey, filter, env.docId, searchReferences]); // eslint-disable-line react-hooks/exhaustive-deps\n\n  const none = onNone && !q;\n  const total = rows.length + (none ? 1 : 0);\n  const at = (i: number) => (none ? (i === 0 ? null : rows[i - 1]) : rows[i]);\n  const full = multi && max != null && selected.length >= max;\n  const choose = (i: number) => {\n    const o = at(i);\n    if (o) onPick(o);\n    else if (none) onNone!();\n  };\n  const optionId = (i: number) => `${listId}-${i}`;\n  const create = async (title: string) => {\n    if (!createReference) return;\n    setCreateBusy(true);\n    setCreateError(null);\n    try {\n      const o = await createReference({ to: to[0], title });\n      setCreating(false);\n      onCreated(o);\n    } catch (e) {\n      setCreateError(`Not created: ${reasonOf(e)}`);\n    } finally {\n      setCreateBusy(false);\n    }\n  };\n  // V2's search copy: \"pages\" for a page picker, \"entries\" for every other one\n  const searchLabel = `Search ${noun === \"page\" ? \"pages\" : \"entries\"}`;\n  return (\n    <div className=\"flex flex-col\">\n      <label className=\"flex h-10 items-center gap-2 border-b border-kit-line px-3 text-kit-fg-3\">\n        <IconSearch className=\"size-4 shrink-0\" stroke={1.5} aria-hidden />\n        <input\n          autoFocus\n          value={q}\n          onChange={(e) => {\n            setQ(e.target.value);\n            setActive(0);\n          }}\n          onKeyDown={(e) => {\n            if (e.key === \"ArrowDown\") {\n              e.preventDefault();\n              setActive((a) => Math.min(total - 1, a + 1));\n            } else if (e.key === \"ArrowUp\") {\n              e.preventDefault();\n              setActive((a) => Math.max(0, a - 1));\n            } else if (e.key === \"Home\") {\n              e.preventDefault();\n              setActive(0);\n            } else if (e.key === \"End\") {\n              e.preventDefault();\n              setActive(Math.max(0, total - 1));\n            } else if (e.key === \"Enter\" && total) {\n              e.preventDefault();\n              choose(Math.min(active, total - 1));\n            }\n          }}\n          placeholder={`${searchLabel}…`}\n          role=\"combobox\"\n          aria-expanded\n          aria-autocomplete=\"list\"\n          aria-controls={listId}\n          aria-activedescendant={total ? optionId(Math.min(active, total - 1)) : undefined}\n          aria-label={searchLabel}\n          className=\"h-full min-w-0 flex-1 bg-transparent text-kit-sm text-kit-fg outline-none placeholder:text-kit-fg-3\"\n        />\n      </label>\n      <div id={listId} className=\"max-h-72 overflow-y-auto p-1\" role=\"listbox\" aria-label={`${noun} results`} aria-multiselectable={multi || undefined} aria-busy={loading || undefined}>\n        {none ? (\n          <div\n            id={optionId(0)}\n            role=\"option\"\n            aria-selected={false}\n            onMouseEnter={() => setActive(0)}\n            onMouseDown={(e) => e.preventDefault()}\n            onClick={onNone}\n            className={cn(\"flex h-8 w-full cursor-pointer items-center gap-2 rounded-kit-md px-2 text-left text-kit-sm text-kit-fg-3\", active === 0 && \"bg-kit-hover\")}\n          >\n            None\n          </div>\n        ) : null}\n        {rows.map((o, j) => {\n          const i = j + (none ? 1 : 0);\n          const on = selected.includes(o.id);\n          return (\n            <div\n              key={`${o.kind}:${o.id}`}\n              id={optionId(i)}\n              role=\"option\"\n              aria-selected={on}\n              onMouseEnter={() => setActive(i)}\n              onMouseDown={(e) => e.preventDefault()}\n              onClick={() => onPick(o)}\n              className={cn(\"flex w-full cursor-pointer items-center gap-2.5 rounded-kit-md p-1.5 text-left\", i === active && \"bg-kit-hover\")}\n            >\n              {multi ? (\n                <span aria-hidden className={cn(\"flex size-4 shrink-0 items-center justify-center rounded-kit-sm border\", on ? \"border-kit-accent bg-kit-accent text-kit-accent-on\" : \"border-kit-line-strong\", !on && full && \"opacity-40\")}>\n                  {on ? <IconCheck className=\"size-3\" stroke={3} /> : null}\n                </span>\n              ) : null}\n              <RefThumb o={o} size={28} />\n              <span className=\"min-w-0 flex-1\">\n                <span className=\"block truncate text-kit-sm text-kit-fg\">{o.title}</span>\n                {o.subtitle ? <span className=\"block truncate text-kit-xs text-kit-fg-3\">{o.subtitle}</span> : null}\n              </span>\n              <DraftChip status={o.status} />\n              {!multi && on ? <IconCheck className=\"size-4 shrink-0 text-kit-fg\" stroke={2} aria-hidden /> : null}\n            </div>\n          );\n        })}\n        {!loading && !error && rows.length === 0 ? <div className=\"px-3 py-6 text-center text-kit-sm text-kit-fg-3\">No matches</div> : null}\n        {loading && rows.length === 0 ? (\n          <div role=\"status\" className=\"px-3 py-6 text-center text-kit-sm text-kit-fg-3\">\n            Searching…\n          </div>\n        ) : null}\n        {error ? (\n          <p role=\"alert\" className=\"px-3 py-3 text-kit-xs text-kit-danger-fg\">\n            {plural(noun).replace(/^./, (c) => c.toUpperCase())} could not be listed: {error}\n          </p>\n        ) : null}\n      </div>\n      {truncated && !error ? (\n        <p role=\"note\" className=\"border-t border-kit-line px-3 py-2 text-kit-xs text-kit-warning-fg\">\n          Some {plural(noun)} were not checked against this field's filter, so the list may be incomplete. Search by name to narrow it.\n        </p>\n      ) : null}\n      {multi ? (\n        <div className={cn(\"border-t border-kit-line px-3 py-2 text-kit-xs\", full ? \"text-kit-warning-fg\" : \"text-kit-fg-3\")}>\n          {selected.length}\n          {max != null ? ` of ${max}` : \"\"} selected{full ? ` · Limit is ${max}. Picking another swaps out the last one.` : \"\"}\n        </div>\n      ) : null}\n      {canCreate ? (\n        <div className=\"border-t border-kit-line p-1.5\">\n          {creating ? (\n            <form\n              className=\"flex flex-col gap-1.5\"\n              onSubmit={(e) => {\n                e.preventDefault();\n                e.stopPropagation();\n                const t = String(new FormData(e.currentTarget).get(\"t\") ?? \"\").trim();\n                if (t) void create(t);\n              }}\n            >\n              <div className=\"flex items-center gap-1.5\">\n                <input\n                  name=\"t\"\n                  autoFocus\n                  defaultValue={q}\n                  aria-label={`New ${noun} name`}\n                  placeholder={`New ${noun} name`}\n                  className=\"h-8 min-w-0 flex-1 rounded-kit-md border border-kit-field-border bg-kit-field-bg px-2 text-kit-sm text-kit-fg outline-none hover:border-kit-field-border-hover focus:border-kit-field-border-focus\"\n                />\n                <Button size=\"sm\" type=\"submit\" variant=\"primary\" loading={createBusy} disabled={createBusy}>\n                  Create\n                </Button>\n              </div>\n              {createError ? (\n                <p role=\"alert\" className=\"px-1 text-kit-xs text-kit-danger-fg\">\n                  {createError}\n                </p>\n              ) : null}\n            </form>\n          ) : (\n            <button\n              type=\"button\"\n              onClick={() => setCreating(true)}\n              className=\"flex h-8 w-full items-center gap-2 rounded-kit-md px-2 text-left text-kit-sm text-kit-fg-2 hover:bg-kit-hover hover:text-kit-fg\"\n            >\n              <IconPlus className=\"size-4\" stroke={1.5} aria-hidden />\n              Create new {noun}\n              {q ? <span className=\"truncate text-kit-fg-3\">“{q}”</span> : null}\n            </button>\n          )}\n        </div>\n      ) : null}\n    </div>\n  );\n}\n\n/** \"Create new\" only where the host can create a draft in the ONE entry model the field targets. */\nfunction useCanCreate(to: string[]) {\n  const { createReference } = useKitServices();\n  return !!createReference && to.length === 1 && isEntryTarget(to[0]);\n}\n\n/** Why the field cannot change its value here (no search service), in words. */\nfunction NoSearch({ title }: { title: string }) {\n  return (\n    <p role=\"note\" className=\"text-kit-xs text-kit-fg-3\">\n      No reference search is connected to this editor, so {title} can't be changed here.\n    </p>\n  );\n}\n\n/* ── Single reference ──────────────────────────────────────────────── */\nexport function ReferenceControl({ field, value, onChange, readOnly, id }: ControlProps) {\n  const env = useKitEnv();\n  const { searchReferences, toast } = useKitServices();\n  const to = targetsOf(field);\n  const noun = referenceNoun(to);\n  const current = typeof value === \"string\" && value ? value : null;\n  const ids = React.useMemo(() => (current ? [current] : []), [current]);\n  const rec = useReferenceRecords(ids, to);\n  const canCreate = useCanCreate(to) && !readOnly;\n  const [open, setOpen] = React.useState(false);\n  const pick = (o: KitReferenceOption) => {\n    rec.remember(o);\n    onChange(o.id);\n    setOpen(false);\n  };\n  /* the trigger opens like V2's even with no search service; the popover then says why nothing can be picked */\n  const editable = !readOnly;\n  const body = !editable ? null : !searchReferences ? (\n    <PopoverContent className=\"w-[300px] p-3\" align=\"start\" collisionAvoidance={SHIFT}>\n      <NoSearch title={field.title} />\n    </PopoverContent>\n  ) : (\n    <PopoverContent className=\"w-[300px] p-0\" align=\"start\" collisionAvoidance={SHIFT}>\n      <PickerBody\n        to={to}\n        filter={field.reference?.filter}\n        selected={current ? [current] : []}\n        noun={noun}\n        onPick={pick}\n        onNone={\n          current\n            ? () => {\n                onChange(null);\n                setOpen(false);\n              }\n            : undefined\n        }\n        canCreate={canCreate}\n        onCreated={(o) => {\n          pick(o);\n          toast?.success(`${noun.replace(/^./, (c) => c.toUpperCase())} created as a draft`, { description: `“${o.title}”` });\n        }}\n      />\n    </PopoverContent>\n  );\n\n  const missing = !!current && rec.missing.has(current);\n  if (current && !missing) {\n    const o = rec.known[current];\n    const title = o?.title ?? (rec.loading ? \"Loading…\" : current);\n    const subtitle = o ? o.subtitle : rec.error ?? (!rec.canLookup ? `Saved ${noun} id` : null);\n    const openable = !!o && o.kind === \"entry\" && !!o.modelSlug && !!env.onOpenReference;\n    return (\n      <Popover open={open} onOpenChange={setOpen}>\n        <div data-slot=\"kit-reference-card\" className=\"flex items-center gap-2.5 rounded-kit-lg border border-kit-line bg-kit-control-bg p-1.5 pr-1 transition-colors hover:border-kit-line-strong\">\n          <PopoverTrigger\n            id={id}\n            disabled={!editable}\n            aria-label={`${field.title}: ${title}.${editable ? \" Change\" : \"\"}`}\n            className=\"flex min-w-0 flex-1 items-center gap-2.5 rounded-kit-md text-left outline-none focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-kit-focus-ring focus-visible:[outline-style:solid] disabled:cursor-default [html[data-input-modality=pointer]_&]:focus-visible:outline-none\"\n          >\n            <RefThumb o={o ?? null} size={32} />\n            <span className=\"min-w-0 flex-1\">\n              <span className={cn(\"block truncate text-kit-sm font-medium text-kit-fg\", !o && !rec.canLookup && \"font-kit-mono text-kit-xs\")}>{title}</span>\n              {subtitle ? <span className={cn(\"block truncate text-kit-xs\", rec.error && !o ? \"text-kit-danger-fg\" : \"text-kit-fg-3\")}>{subtitle}</span> : null}\n            </span>\n            <DraftChip status={o?.status} />\n          </PopoverTrigger>\n          {readOnly ? null : (\n            <Menu>\n              <MenuTrigger\n                aria-label={`${o?.title ?? field.title} actions`}\n                className=\"flex size-7 shrink-0 items-center justify-center rounded-kit-md text-kit-fg-3 hover:bg-kit-hover hover:text-kit-fg data-[popup-open]:bg-kit-hover\"\n              >\n                <IconDots className=\"size-4\" stroke={1.5} aria-hidden />\n              </MenuTrigger>\n              <MenuContent align=\"end\" className=\"w-48\">\n                {openable ? (\n                  <MenuItem icon={<IconArrowUpRight stroke={1.5} />} onClick={() => env.onOpenReference!({ collectionId: o!.modelSlug!, entryId: o!.id, title: o!.title })}>\n                    Open {o!.title.length > 18 ? `${o!.title.slice(0, 16)}…` : o!.title}\n                  </MenuItem>\n                ) : null}\n                {editable ? (\n                  <MenuItem icon={<IconReplace stroke={1.5} />} onClick={() => window.setTimeout(() => setOpen(true), 0)}>\n                    Replace\n                  </MenuItem>\n                ) : null}\n                {openable || editable ? <MenuSeparator /> : null}\n                <MenuItem danger icon={<IconTrash stroke={1.5} />} onClick={() => onChange(null)}>\n                  Remove\n                </MenuItem>\n              </MenuContent>\n            </Menu>\n          )}\n        </div>\n        {body}\n      </Popover>\n    );\n  }\n  /* empty, or a saved id the lookup cannot find: V2's select trigger (V2 draws an unresolved id as no selection). Ours\n     says \"Missing\" on it instead of hiding the saved id (DESIGN 9.6); the picker's None clears it, a row replaces it. */\n  return (\n    <Popover open={open} onOpenChange={setOpen}>\n      <PopoverTrigger\n        id={id}\n        disabled={!editable}\n        data-slot={missing ? \"kit-reference-card\" : undefined}\n        data-missing={missing || undefined}\n        aria-label={missing ? `${field.title}: Missing ${noun}.${editable ? \" Change\" : \"\"}` : `${field.title}: select ${withArticle(noun)}`}\n        className={cn(\n          \"flex h-8 w-full items-center gap-2 rounded-kit-md border bg-kit-field-bg px-2.5 text-left text-kit-sm transition-colors hover:border-kit-field-border-hover disabled:cursor-not-allowed disabled:opacity-60 data-[popup-open]:border-kit-field-border-focus\",\n          missing ? \"border-kit-warning-line text-kit-warning-fg\" : \"border-kit-field-border text-kit-fg-3\",\n        )}\n      >\n        <IconFileDatabase className=\"size-4 shrink-0\" stroke={1.5} aria-hidden />\n        {missing ? (\n          <span className=\"flex-1 truncate\">\n            Missing {noun}\n            <span className=\"sr-only\">. Deleted, or not visible to you. The saved id stays until you replace or remove it.</span>\n          </span>\n        ) : (\n          <span className=\"flex-1 truncate\">Select {withArticle(noun)}</span>\n        )}\n        <IconChevronDown className=\"size-3.5 shrink-0\" stroke={1.5} aria-hidden />\n      </PopoverTrigger>\n      {body}\n    </Popover>\n  );\n}\n\n/* ── Multi-reference: an array of ids ─────────────────────────────── */\nfunction RefChip({\n  id,\n  o,\n  canLookup,\n  readOnly,\n  sort,\n  onRemove,\n}: {\n  id: string;\n  o?: KitReferenceOption;\n  /** false: no lookup service, so the saved id is all there is to show (never a \"Loading…\" that never ends) */\n  canLookup: boolean;\n  readOnly?: boolean;\n  sort: ReturnType<typeof useDragReorder>;\n  onRemove: () => void;\n}) {\n  const handle = sort.handle(id);\n  const title = o?.title ?? (canLookup ? \"Loading…\" : id);\n  return (\n    <span\n      ref={sort.register(id)}\n      style={sort.style(id)}\n      className={cn(\n        \"inline-flex h-6 max-w-full items-center gap-1.5 rounded-kit-md border border-kit-line bg-kit-control-bg pl-0.5 pr-1 text-kit-sm text-kit-fg shadow-kit-xs\",\n        sort.active === id && \"z-10 shadow-kit-md\",\n      )}\n    >\n      <span\n        {...(readOnly ? {} : handle)}\n        tabIndex={0}\n        aria-label={readOnly ? title : `${title}, drag to reorder`}\n        onKeyDown={(e) => {\n          if (readOnly) return;\n          if (e.key === \"Delete\" || e.key === \"Backspace\") {\n            e.preventDefault();\n            onRemove();\n            return;\n          }\n          handle.onKeyDown(e);\n        }}\n        className={cn(\n          \"inline-flex min-w-0 touch-none items-center gap-1.5 rounded-kit-sm outline-none focus-visible:outline-2 focus-visible:outline-offset-1 focus-visible:outline-kit-focus-ring focus-visible:[outline-style:solid] [html[data-input-modality=pointer]_&]:focus-visible:outline-none\",\n          !readOnly && \"cursor-grab active:cursor-grabbing\",\n        )}\n      >\n        <RefThumb o={o ?? null} size={20} />\n        <span className=\"truncate\">{title}</span>\n      </span>\n      {readOnly ? null : (\n        <button type=\"button\" aria-label={`Remove ${title}`} onPointerDown={(e) => e.stopPropagation()} onClick={onRemove} className=\"flex rounded-kit-sm p-0.5 text-kit-fg-3 hover:bg-kit-hover hover:text-kit-fg\">\n          <IconX className=\"size-3\" stroke={1.5} aria-hidden />\n        </button>\n      )}\n    </span>\n  );\n}\n\n/** Multi-reference: an array of reference ids. `field` is the ARRAY field; the engine hands it the item's `reference`. */\nexport function ReferencesControl({ field, value, onChange, readOnly, id }: ControlProps) {\n  const { searchReferences } = useKitServices();\n  const item = Array.isArray(field.of) ? field.of[0] : undefined;\n  const to = item?.reference?.to ?? field.reference?.to ?? [];\n  const filter = item?.reference?.filter ?? field.reference?.filter;\n  const noun = referenceNoun(to);\n  const ids = React.useMemo(() => (Array.isArray(value) ? value : []).filter((x): x is string => typeof x === \"string\" && x !== \"\"), [value]);\n  const rec = useReferenceRecords(ids, to);\n  const canCreate = useCanCreate(to) && !readOnly;\n  const max = field.validation?.max;\n  /* ids the lookup cannot find are drawn as ONE compact \"n missing\" chip after Add (V2 hides them; one row keeps V2's height),\n     so the chips that sort are the rest; a reorder puts them back around the missing ids, which keep their places */\n  const missingIds = ids.filter((x) => rec.missing.has(x));\n  const shown = missingIds.length ? ids.filter((x) => !rec.missing.has(x)) : ids;\n  const sort = useDragReorder(\n    shown,\n    (from, to2) => {\n      const next = [...shown];\n      const [moved] = next.splice(from, 1);\n      next.splice(to2, 0, moved);\n      let i = 0;\n      onChange(ids.map((x) => (rec.missing.has(x) ? x : next[i++])));\n    },\n    { axis: \"grid\", disabled: readOnly },\n  );\n  const missingNoun = missingIds.length === 1 ? noun : plural(noun);\n  const toggle = (o: KitReferenceOption) => {\n    rec.remember(o);\n    if (ids.includes(o.id)) return onChange(ids.filter((x) => x !== o.id));\n    if (max != null && ids.length >= max) return onChange([...ids.slice(0, -1), o.id]); // swap in place at the limit\n    onChange([...ids, o.id]);\n  };\n  return (\n    <div className=\"flex flex-col gap-1\">\n      {/* the field label points at the Add trigger; read-only there is none, so the box carries the id. The chips sit\n          straight in the wrapping box, as V2's do (a wrapper would take them out of the box's flow). */}\n      <div\n        id={readOnly ? id : undefined}\n        role=\"group\"\n        aria-label={field.title}\n        className=\"flex min-h-8 flex-wrap items-center gap-1 rounded-kit-md border border-kit-field-border bg-kit-field-bg p-1 transition-colors hover:border-kit-field-border-hover\"\n      >\n        {shown.map((x) => (\n          <RefChip key={x} id={x} o={rec.known[x]} canLookup={rec.canLookup} readOnly={readOnly} sort={sort} onRemove={() => onChange(ids.filter((y) => y !== x))} />\n        ))}\n        {sort.a11y}\n        {!readOnly ? (\n          <Popover>\n            <PopoverTrigger id={id} aria-label={`Add to ${field.title}`} className=\"inline-flex h-6 items-center gap-1 rounded-kit-md px-1.5 text-kit-sm text-kit-fg-3 hover:bg-kit-hover hover:text-kit-fg\">\n              <IconPlus className=\"size-3.5\" stroke={1.5} aria-hidden />\n              Add\n            </PopoverTrigger>\n            <PopoverContent className=\"w-[300px] p-0\" align=\"start\" collisionAvoidance={SHIFT}>\n              {/* no search service: the picker says why instead of listing anything */}\n              {!searchReferences ? (\n                <div className=\"p-3\">\n                  <NoSearch title={field.title} />\n                </div>\n              ) : (\n              <PickerBody\n                to={to}\n                filter={filter}\n                selected={ids}\n                multi\n                max={max}\n                noun={noun}\n                onPick={toggle}\n                canCreate={canCreate}\n                onCreated={(o) => {\n                  rec.remember(o);\n                  onChange(max != null && ids.length >= max ? [...ids.slice(0, -1), o.id] : [...ids, o.id]);\n                }}\n              />\n              )}\n            </PopoverContent>\n          </Popover>\n        ) : ids.length === 0 ? (\n          <span className=\"px-1.5 text-kit-sm text-kit-fg-3\">None</span>\n        ) : null}\n        {/* after Add, so Add keeps V2's place (V2 draws nothing for these ids) */}\n        {missingIds.length ? (\n          <span\n            data-missing\n            data-slot=\"kit-reference-missing\"\n            className=\"inline-flex h-6 max-w-full items-center gap-1 rounded-kit-md border border-kit-warning-line bg-kit-control-bg pl-1.5 pr-1 text-kit-sm text-kit-warning-fg shadow-kit-xs\"\n          >\n            <span className=\"truncate tabular-nums\">\n              {missingIds.length} missing\n              <span className=\"sr-only\">\n                {\" \"}\n                {missingNoun}. Deleted, or not visible to you. The saved {missingIds.length === 1 ? \"id stays\" : \"ids stay\"} until you remove {missingIds.length === 1 ? \"it\" : \"them\"}.\n              </span>\n            </span>\n            {readOnly ? null : (\n              <button\n                type=\"button\"\n                aria-label={`Remove ${missingIds.length} missing ${missingNoun}`}\n                onClick={() => onChange(ids.filter((y) => !rec.missing.has(y)))}\n                className=\"flex rounded-kit-sm p-0.5 hover:bg-kit-hover hover:text-kit-fg\"\n              >\n                <IconX className=\"size-3\" stroke={1.5} aria-hidden />\n              </button>\n            )}\n          </span>\n        ) : null}\n      </div>\n      {rec.error ? (\n        <p role=\"alert\" className=\"text-kit-xs text-kit-danger-fg\">\n          {rec.error}\n        </p>\n      ) : null}\n      {max != null ? (\n        <span className=\"self-end tabular-nums text-kit-xs text-kit-fg-3\">\n          {ids.length} / {max}\n        </span>\n      ) : null}\n    </div>\n  );\n}\n"],"mappings":"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"}

package/controls/rich-text/blocks.d.ts

@@ -0,0 +1,28 @@
+import { type IslandEl, type IslandKind, type IslandModels } from "./dom";
+export interface IslandCtx {
+    readOnly?: boolean;
+    dense?: boolean;
+    emit: () => void;
+    remove: (el: IslandEl) => void;
+    /** Leave the block: caret to the start of the next line. */
+    exit: (el: IslandEl) => void;
+    /** CPO D54: an island write joins the body field's ONE undo history (`before` = the model it replaces) */
+    record?: (el: IslandEl, before: IslandModels[IslandKind], label: string, coalesce?: boolean) => void;
+    /** a refusal the author must see (an address the image cannot use) */
+    notify: (message: string, description?: string) => void;
+    duplicate?: (el: IslandEl) => void;
+    move?: (el: IslandEl, dir: -1 | 1) => void;
+    /** the body field's one history (D54): ⌘Z on a focused block or in its panel */
+    undo?: () => boolean;
+    /**
+     * One action as ONE undo step, in the host's history when it keeps one (the dock's toolbar Undo), else the body's
+     * own. `write` makes the change and answers the island it changed; `before` is that island's model before it. Answers
+     * the step's undo (an Undo toast): true, or the sentence saying why nothing was undone.
+     */
+    step?: (label: string, write: () => IslandEl | null, before?: IslandModels[IslandKind]) => () => true | string;
+    redo?: () => boolean;
+}
+export declare function Island({ el, ctx }: {
+    el: IslandEl;
+    ctx: IslandCtx;
+}): import("react/jsx-runtime").JSX.Element;