@bettercms-ai/kit 1.0.0 → 2.0.0-next.1

package/dist/controls/slot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot.js","names":[],"sources":["../../src/controls/slot.tsx"],"sourcesContent":["/**\n * COMPONENT SLOT — a prop that holds component instances (prod `slot`), on the engine's slot surface (engine/slot.tsx,\n * V2 HEAD 9829bf1): the block rows (icon tile, name, ⋯ menu, drag to reorder) and the compact searchable picker.\n *\n * What differs from V2's block slot is where the rows come from and what they store:\n *   - the picker lists the host's slot catalog (`useSlotCatalog`): the project's components with the SERVER's\n *     insertability verdict for each; one that can't go here stays in the list, disabled, with the reason under its name;\n *   - a row opens in place and edits that child's own props through the host's `SlotChild`;\n *   - the value is written in the stored shape (slot-services.ts): one `{ componentId, overrides? }`, or a list of them\n *     for a multiple slot, every item spread back with the keys this control does not show (style, window).\n *\n * Refusals are said in words, never by an inert control: no catalog service, an unreadable stored value, the nesting cap.\n */\nimport * as React from \"react\";\nimport { IconPlus, IconSearch } from \"@tabler/icons-react\";\nimport { useKitServices } from \"../context\";\nimport { KitIcon } from \"../lib/icons\";\nimport { cn } from \"../lib/cn\";\nimport { Button } from \"../ui/button\";\nimport { Popover, PopoverContent, PopoverTrigger } from \"../ui/overlay\";\nimport { RowList, useListOps, type RowModel } from \"../engine/array\";\nimport type { FieldSchema } from \"../schema/types\";\nimport type { ControlProps } from \"../types\";\nimport { readSlot, slotList, SLOT_DEPTH_MAX, type KitComponentSlot, type KitSlotEntry, type KitSlotItem } from \"./slot-services\";\n\n/** How many slots deep the control sits: the host's SlotChild editor sits inside a provider one level down. */\nexport const SlotDepthContext = React.createContext(0);\n\nconst count = (n: number) => `${n} block${n === 1 ? \"\" : \"s\"}`;\nconst NO_CATALOG = { entries: [] as KitSlotEntry[], nameOf: () => undefined };\n\n/** A note in words, labelable and focusable (the field label's `for` lands on it). */\nfunction SlotNote({ id, children, tone = \"muted\" }: { id?: string; children: React.ReactNode; tone?: \"muted\" | \"warning\" }) {\n  return (\n    <output\n      id={id}\n      role=\"note\"\n      tabIndex={id ? 0 : undefined}\n      className={cn(\n        \"block rounded-kit-sm text-kit-xs outline-none focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-kit-focus-ring focus-visible:[outline-style:solid] [html[data-input-modality=pointer]_&]:focus-visible:outline-none\",\n        tone === \"warning\" ? \"text-kit-warning-fg\" : \"text-kit-fg-3\",\n      )}\n    >\n      {children}\n    </output>\n  );\n}\n\nexport function ComponentSlotControl({ field, value, onChange, readOnly, id, path }: ControlProps) {\n  const slot: KitComponentSlot = field.componentSlot ?? { multiple: false, min: 0, max: 1 };\n  const depth = React.useContext(SlotDepthContext);\n  const { useSlotCatalog, SlotChild, toast } = useKitServices();\n  // a hook service: one identity for the life of the form, so it is called on every render or never\n  const catalog = useSlotCatalog ? useSlotCatalog({ componentIds: slot.componentIds }) : null; // eslint-disable-line react-hooks/rules-of-hooks\n  const read = readSlot(value);\n  const items = read.items;\n  const max = slot.multiple ? slot.max : 1;\n  const [openId, setOpenId] = React.useState<string | null>(null);\n  const nameOf = (componentId: string) => (catalog ?? NO_CATALOG).nameOf(componentId) ?? { title: catalog?.loading ? \"Loading…\" : componentId };\n  const locked = readOnly || read.unreadable > 0;\n\n  /* writes: the stored shape, never a `_key` (useListOps' duplicate adds one) */\n  const write = (next: unknown[]) => {\n    setOpenId(null);\n    if (slot.multiple) return onChange(slotList(next));\n    const [first] = slotList(next);\n    onChange(first ?? { componentId: \"\" });\n  };\n  const opsField: FieldSchema = { ...field, validation: { ...field.validation, min: slot.multiple ? slot.min : 0, max } };\n  const ops = useListOps(opsField, path, items, write);\n  if (depth >= SLOT_DEPTH_MAX) return <SlotNote id={id}>Nested block limit reached. A slot this deep would render as nothing, so it can&rsquo;t hold more blocks here.</SlotNote>;\n  const pick = (componentId: string) => {\n    if (!slot.multiple) {\n      const cur = items[0];\n      // a different component's overrides are keyed by the old component's props: dropped, never half-applied\n      onChange(cur && cur.componentId === componentId ? cur : { componentId });\n      setOpenId(null);\n      return;\n    }\n    if (items.length >= max) return;\n    onChange([...items, { componentId }]);\n    setOpenId(`i${items.length}`);\n  };\n  const setOverrides = (index: number, overrides: Record<string, unknown>) => {\n    const next = items.map((it, i) => (i === index ? { ...it, overrides } : it));\n    if (slot.multiple) onChange(next);\n    else onChange({ componentId: next[0].componentId, overrides });\n  };\n\n  const rows: RowModel[] = items.map((it, i) => {\n    const name = nameOf(it.componentId);\n    const entry = catalog?.entries.find((e) => e.id === it.componentId);\n    return {\n      id: `i${i}`,\n      index: i,\n      item: it,\n      path: [...path, i],\n      preview: { title: name.missing ? \"Missing block\" : name.title, icon: entry?.icon ?? \"box\", empty: false },\n      extra: name.missing ? \"Deleted, or not in this project. Replace or remove it.\" : (entry?.category ?? `Block ${i + 1} of ${items.length}`),\n    };\n  });\n\n  /*\n   * A slot that takes exactly one block type adds it in one press (V2 content-form.tsx \"Add {child}\"): no picker to\n   * choose from a list of one. Not insertable here → the picker, which says why. Undo puts the slot back as it was.\n   */\n  const only = slot.componentIds?.length === 1 ? catalog?.entries.find((e) => e.id === slot.componentIds![0]) : undefined;\n  const quickAdd = only?.insertable && (slot.multiple || items.length === 0) ? only : undefined;\n  const addOnly = (entry: KitSlotEntry) => {\n    const before = value;\n    pick(entry.id);\n    toast?.(`${entry.title} added to ${field.title}`, { action: { label: \"Undo\", onClick: () => onChange(before) } });\n  };\n\n  const picker = quickAdd ? (\n    <Button\n      size=\"lg\"\n      variant=\"ghost\"\n      className=\"text-kit-fg-2\"\n      leftIcon={<IconPlus stroke={1.5} />}\n      disabled={locked || (slot.multiple && items.length >= max)}\n      onClick={() => addOnly(quickAdd)}\n    >\n      Add {quickAdd.title}\n    </Button>\n  ) : catalog ? (\n    <SlotPicker\n      entries={catalog.entries}\n      loading={catalog.loading}\n      error={catalog.error}\n      note={catalog.note}\n      current={slot.multiple ? undefined : items[0]?.componentId}\n      label={slot.multiple ? \"Add block\" : items.length ? \"Replace block\" : \"Choose a block\"}\n      disabled={locked || (slot.multiple && items.length >= max)}\n      onPick={pick}\n    />\n  ) : null;\n\n  return (\n    <div className=\"flex min-w-0 flex-col gap-1.5\" data-slot=\"kit-component-slot\">\n      {read.unreadable > 0 ? (\n        <SlotNote tone=\"warning\">\n          {read.unreadable === 1 ? \"One child here isn't a block instance\" : `${read.unreadable} children here aren't block instances`} (blocks written by another editor). This editor\n          would drop {read.unreadable === 1 ? \"it\" : \"them\"} on save, so the slot is shown read-only and its value is kept.\n        </SlotNote>\n      ) : null}\n      {read.inherited && items.length === 0 ? <SlotNote>Shows the block&rsquo;s own content until a block is added here.</SlotNote> : null}\n      <div id={id} tabIndex={-1} className=\"min-w-0 outline-none\">\n        <RowList\n          field={opsField}\n          rows={rows}\n          readOnly={locked}\n          layout=\"list\"\n          mode=\"inline\"\n          openId={openId}\n          onOpen={(r) => setOpenId(openId === r.id ? null : r.id)}\n          onCloseInline={() => setOpenId(null)}\n          ops={ops}\n          renderInline={(r) => {\n            const it = r.item as KitSlotItem;\n            const title = r.preview.title;\n            if (nameOf(it.componentId).missing) return <SlotNote>This component no longer exists, so its props can&rsquo;t be edited. Replace it or remove it.</SlotNote>;\n            if (!SlotChild) return <SlotNote>This editor can&rsquo;t open {title}&rsquo;s own props.</SlotNote>;\n            return (\n              <SlotDepthContext.Provider value={depth + 1}>\n                <SlotChild\n                  componentId={it.componentId}\n                  title={title}\n                  overrides={it.overrides && typeof it.overrides === \"object\" ? it.overrides : {}}\n                  onChange={(o) => setOverrides(r.index, o)}\n                  readOnly={locked}\n                  depth={depth + 1}\n                />\n              </SlotDepthContext.Provider>\n            );\n          }}\n          leading={(r) => (\n            <span className=\"flex size-7 shrink-0 items-center justify-center rounded-kit-md border border-kit-line bg-kit-control-bg text-kit-fg-2 shadow-kit-xs\">\n              <KitIcon name={r.preview.icon} className=\"size-4\" />\n            </span>\n          )}\n          emptyLabel={slot.multiple ? \"No blocks yet. Add one to start composing.\" : \"No block yet. Choose one to fill this slot.\"}\n          addButton={picker ?? <SlotNote>No block library is connected to this editor, so {field.title} can&rsquo;t be changed here.</SlotNote>}\n        />\n      </div>\n      {slot.multiple ? (\n        <span className=\"text-kit-xs text-kit-fg-3\">\n          {items.length >= max ? `This slot holds at most ${count(max)}.` : slot.min > 0 ? `Between ${slot.min} and ${count(max)}.` : `Up to ${count(max)}.`}\n          {slot.min > 0 && items.length > 0 && items.length <= slot.min ? ` It needs at least ${slot.min}, so none can be removed.` : \"\"}\n        </span>\n      ) : null}\n    </div>\n  );\n}\n\n/**\n * The compact block picker (engine/slot.tsx BlockPicker), over the slot catalog: grouped by family, searchable, ↵ adds.\n * A component the server says can't go here is listed disabled with its reason in place of the description.\n */\nexport function SlotPicker({\n  entries,\n  loading,\n  error,\n  note,\n  current,\n  label,\n  disabled,\n  onPick,\n}: {\n  entries: KitSlotEntry[];\n  loading?: boolean;\n  error?: string;\n  note?: string;\n  current?: string;\n  label: string;\n  disabled?: boolean;\n  onPick: (componentId: string) => void;\n}) {\n  const [open, setOpen] = React.useState(false);\n  const [q, setQ] = React.useState(\"\");\n  const [active, setActive] = React.useState(0);\n  const listId = React.useId();\n  const list = entries.filter((b) => !q || `${b.title} ${b.category ?? \"\"} ${b.description ?? \"\"}`.toLowerCase().includes(q.toLowerCase()));\n  const cats = Array.from(new Set(list.map((b) => b.category || \"Blocks\")));\n  const flat = cats.flatMap((c) => list.filter((b) => (b.category || \"Blocks\") === c));\n  const choose = (b: KitSlotEntry | undefined) => {\n    if (!b || !b.insertable) return;\n    onPick(b.id);\n    setOpen(false);\n    setQ(\"\");\n  };\n  const optionId = (i: number) => `${listId}-${i}`;\n  return (\n    <Popover\n      open={open}\n      onOpenChange={(o) => {\n        setOpen(o);\n        setQ(\"\");\n        setActive(0);\n      }}\n    >\n      <PopoverTrigger render={<Button size=\"sm\" variant=\"ghost\" className=\"text-kit-fg-2\" leftIcon={<IconPlus stroke={1.5} />} disabled={disabled} />}>{label}</PopoverTrigger>\n      <PopoverContent className=\"w-[300px] p-0\" align=\"start\">\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) => (a + 1) % Math.max(1, flat.length));\n              } else if (e.key === \"ArrowUp\") {\n                e.preventDefault();\n                setActive((a) => (a - 1 + flat.length) % Math.max(1, flat.length));\n              } else if (e.key === \"Enter\") {\n                e.preventDefault();\n                choose(flat[active]);\n              }\n            }}\n            placeholder=\"Search blocks\"\n            aria-label=\"Search blocks\"\n            role=\"combobox\"\n            aria-expanded\n            aria-controls={listId}\n            aria-activedescendant={flat.length ? optionId(Math.min(active, flat.length - 1)) : undefined}\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-80 overflow-y-auto p-1\" role=\"listbox\" aria-label=\"Blocks\" aria-busy={loading || undefined}>\n          {loading && entries.length === 0 ? (\n            <p role=\"status\" className=\"px-3 py-6 text-center text-kit-sm text-kit-fg-3\">\n              Loading blocks…\n            </p>\n          ) : null}\n          {!loading && !error && flat.length === 0 ? <p className=\"px-3 py-6 text-center text-kit-sm text-kit-fg-3\">{entries.length ? \"No blocks match\" : \"This project has no blocks that can go here yet.\"}</p> : null}\n          {error ? (\n            <p role=\"alert\" className=\"px-3 py-3 text-kit-xs text-kit-danger-fg\">\n              {error}\n            </p>\n          ) : null}\n          {cats.map((c) => (\n            <div key={c} role=\"group\" aria-label={c} className=\"pb-1\">\n              <div aria-hidden className=\"px-2 pb-1 pt-1.5 text-kit-2xs font-medium text-kit-fg-3\">\n                {c}\n              </div>\n              {list\n                .filter((b) => (b.category || \"Blocks\") === c)\n                .map((b) => {\n                  const i = flat.indexOf(b);\n                  return (\n                    <div\n                      key={b.id}\n                      id={optionId(i)}\n                      role=\"option\"\n                      aria-selected={b.id === current}\n                      aria-disabled={!b.insertable || undefined}\n                      onMouseEnter={() => setActive(i)}\n                      onMouseDown={(e) => e.preventDefault()}\n                      onClick={() => choose(b)}\n                      className={cn(\"flex w-full items-center gap-2.5 rounded-kit-md p-1.5 text-left\", b.insertable ? \"cursor-pointer\" : \"cursor-not-allowed\", i === active && \"bg-kit-hover\")}\n                    >\n                      <span className={cn(\"flex size-8 shrink-0 items-center justify-center rounded-kit-md border border-kit-line bg-kit-surface text-kit-fg-2 shadow-kit-xs\", !b.insertable && \"opacity-50\")}>\n                        <KitIcon name={b.icon ?? \"box\"} className=\"size-4\" />\n                      </span>\n                      <span className=\"min-w-0 flex-1\">\n                        <span className={cn(\"block truncate text-kit-sm\", b.insertable ? \"text-kit-fg\" : \"text-kit-fg-3\")}>{b.title}</span>\n                        {!b.insertable && b.reason ? (\n                          <span className=\"block text-kit-xs text-kit-fg-3\">{b.reason}</span>\n                        ) : b.description ? (\n                          <span className=\"block truncate text-kit-xs text-kit-fg-3\">{b.description}</span>\n                        ) : null}\n                      </span>\n                    </div>\n                  );\n                })}\n            </div>\n          ))}\n        </div>\n        {note ? <p className=\"border-t border-kit-line px-3 py-2 text-kit-xs text-kit-fg-3\">{note}</p> : null}\n        <div data-hint=\"shortcuts\" className=\"border-t border-kit-line px-3 py-1.5 text-kit-2xs text-kit-fg-3\">\n          ↵ add · type to search\n        </div>\n      </PopoverContent>\n    </Popover>\n  );\n}\n"],"mappings":"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"}

package/{controls → dist/controls}/table/index.js

@@ -1,6 +1,6 @@
 import { TableControl, TableFullScreenAction } from "./table.js";
 import { ACTIONS, CONTROLS } from "../../engine/kit-field.js";
-//#region src/kit/controls/table/index.ts
+//#region src/controls/table/index.ts
 /**
 * Data table: registers the control and its label-row action (one line each, so lanes merge cleanly).
 * Imported for its side effect by the kit entry; import the parts themselves by path.

package/dist/controls/table/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/controls/table/index.ts"],"sourcesContent":["/**\n * Data table: registers the control and its label-row action (one line each, so lanes merge cleanly).\n * Imported for its side effect by the kit entry; import the parts themselves by path.\n */\nimport { ACTIONS, CONTROLS } from \"../../engine/kit-field\";\nimport { TableControl, TableFullScreenAction } from \"./table\";\n\nCONTROLS.table = TableControl;\nACTIONS.table = TableFullScreenAction;\n"],"mappings":";;;;;;;AAOA,SAAS,QAAQ;AACjB,QAAQ,QAAQ"}

package/{controls → dist/controls}/table/prod.js

@@ -1,5 +1,5 @@
 import { TABLE_COLUMN_TYPES } from "../../schema/table.js";
-//#region src/kit/controls/table/prod.ts
+//#region src/controls/table/prod.ts
 /**
 * The production side of a data table, for the schema adapter (adapters/schema.ts) to call when it reads one:
 *
@@ -13,12 +13,12 @@ import { TABLE_COLUMN_TYPES } from "../../schema/table.js";
 */
 var isObj = (v) => !!v && typeof v === "object" && !Array.isArray(v);
 var COLUMN_TYPES = new Set(TABLE_COLUMN_TYPES.map((t) => t.value));
-var PHONES = new Set([
+var PHONES = /* @__PURE__ */ new Set([
 	"scroll",
 	"stack",
 	"cards"
 ]);
-var JSONLD = new Set([
+var JSONLD = /* @__PURE__ */ new Set([
 	"ItemList",
 	"Dataset",
 	"Offers"

package/dist/controls/table/prod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prod.js","names":[],"sources":["../../../src/controls/table/prod.ts"],"sourcesContent":["/**\n * The production side of a data table, for the schema adapter (adapters/schema.ts) to call when it reads one:\n *\n *  - a component `table` prop with `config.mode: \"data\"` (BE @bettercms-ai/types component.ts; prop-fields.ts\n *    isDataTable) holds ONE TableValue, with the table field's options beside `mode` in its `config`;\n *  - a content-model `table` field (BE content-model.ts) holds the same value, its options in `config`.\n *\n * A `table` prop with no mode (or `\"rows\"` / `\"types\"`) is the older array of rows and is NOT this value.\n * Only the option keys the backend defines are read, each only when it has the type the backend reads, so a stray key\n * never turns into a setting the backend would not honour.\n */\nimport { TABLE_COLUMN_TYPES, type TableColumnType, type TableFieldOptions, type TableJsonLdType, type TableResponsive, type TableSettingsOptions } from \"../../schema/table\";\n\nconst isObj = (v: unknown): v is Record<string, unknown> => !!v && typeof v === \"object\" && !Array.isArray(v);\nconst COLUMN_TYPES = new Set<string>(TABLE_COLUMN_TYPES.map((t) => t.value));\nconst PHONES = new Set<string>([\"scroll\", \"stack\", \"cards\"]);\nconst JSONLD = new Set<string>([\"ItemList\", \"Dataset\", \"Offers\"]);\nconst SETTING_FLAGS = [\"headers\", \"totals\", \"highlight\", \"sticky\", \"sort\", \"search\"] as const;\n\n/** BE isDataTable: a `table` prop or sub-field holding one TableValue. */\nexport const isDataTableProp = (p: { type?: unknown; config?: unknown }): boolean => p.type === \"table\" && isObj(p.config) && p.config.mode === \"data\";\n\n/** The field options a data table's `config` carries, as the kit's `FieldSchema.table`. */\nexport function tableOptionsFromConfig(config: unknown): TableFieldOptions {\n  if (!isObj(config)) return {};\n  const o: TableFieldOptions = {};\n  const strs = (v: unknown, ok: Set<string>) => (Array.isArray(v) ? v.filter((x): x is string => typeof x === \"string\" && ok.has(x)) : undefined);\n  const columnTypes = strs(config.columnTypes, COLUMN_TYPES);\n  if (columnTypes) o.columnTypes = columnTypes as TableColumnType[];\n  for (const k of [\"lockColumns\", \"requireCaption\", \"allowGroups\", \"allowFootnotes\", \"allowNote\"] as const) if (typeof config[k] === \"boolean\") o[k] = config[k] as boolean;\n  for (const k of [\"minRows\", \"maxRows\", \"maxColumns\"] as const) {\n    const n = config[k];\n    if (typeof n === \"number\" && Number.isInteger(n) && n >= 0) o[k] = n;\n  }\n  if (isObj(config.settings)) {\n    const s: TableSettingsOptions = {};\n    for (const k of SETTING_FLAGS) if (typeof config.settings[k] === \"boolean\") s[k] = config.settings[k] as boolean;\n    const phones = strs(config.settings.phones, PHONES);\n    if (phones) s.phones = phones as TableResponsive[];\n    o.settings = s;\n  }\n  const jsonLd = strs(config.jsonLd, JSONLD);\n  if (jsonLd) o.jsonLd = jsonLd as TableJsonLdType[];\n  return o;\n}\n\n/** The `config` a data-table prop is written with (the inverse of tableOptionsFromConfig). */\nexport function tableConfigFromOptions(o: TableFieldOptions | undefined): Record<string, unknown> {\n  return { mode: \"data\", ...(o ? JSON.parse(JSON.stringify(o)) : {}) };\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,IAAM,SAAS,MAA6C,CAAC,CAAC,KAAK,OAAO,MAAM,YAAY,CAAC,MAAM,QAAQ,CAAC;AAC5G,IAAM,eAAe,IAAI,IAAY,mBAAmB,KAAK,MAAM,EAAE,KAAK,CAAC;AAC3E,IAAM,yBAAS,IAAI,IAAY;CAAC;CAAU;CAAS;AAAO,CAAC;AAC3D,IAAM,yBAAS,IAAI,IAAY;CAAC;CAAY;CAAW;AAAQ,CAAC;AAChE,IAAM,gBAAgB;CAAC;CAAW;CAAU;CAAa;CAAU;CAAQ;AAAQ;;AAGnF,IAAa,mBAAmB,MAAqD,EAAE,SAAS,WAAW,MAAM,EAAE,MAAM,KAAK,EAAE,OAAO,SAAS;;AAGhJ,SAAgB,uBAAuB,QAAoC;CACzE,IAAI,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC;CAC5B,MAAM,IAAuB,CAAC;CAC9B,MAAM,QAAQ,GAAY,OAAqB,MAAM,QAAQ,CAAC,IAAI,EAAE,QAAQ,MAAmB,OAAO,MAAM,YAAY,GAAG,IAAI,CAAC,CAAC,IAAI,KAAA;CACrI,MAAM,cAAc,KAAK,OAAO,aAAa,YAAY;CACzD,IAAI,aAAa,EAAE,cAAc;CACjC,KAAK,MAAM,KAAK;EAAC;EAAe;EAAkB;EAAe;EAAkB;CAAW,GAAY,IAAI,OAAO,OAAO,OAAO,WAAW,EAAE,KAAK,OAAO;CAC5J,KAAK,MAAM,KAAK;EAAC;EAAW;EAAW;CAAY,GAAY;EAC7D,MAAM,IAAI,OAAO;EACjB,IAAI,OAAO,MAAM,YAAY,OAAO,UAAU,CAAC,KAAK,KAAK,GAAG,EAAE,KAAK;CACrE;CACA,IAAI,MAAM,OAAO,QAAQ,GAAG;EAC1B,MAAM,IAA0B,CAAC;EACjC,KAAK,MAAM,KAAK,eAAe,IAAI,OAAO,OAAO,SAAS,OAAO,WAAW,EAAE,KAAK,OAAO,SAAS;EACnG,MAAM,SAAS,KAAK,OAAO,SAAS,QAAQ,MAAM;EAClD,IAAI,QAAQ,EAAE,SAAS;EACvB,EAAE,WAAW;CACf;CACA,MAAM,SAAS,KAAK,OAAO,QAAQ,MAAM;CACzC,IAAI,QAAQ,EAAE,SAAS;CACvB,OAAO;AACT;;AAGA,SAAgB,uBAAuB,GAA2D;CAChG,OAAO;EAAE,MAAM;EAAQ,GAAI,IAAI,KAAK,MAAM,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC;CAAG;AACrE"}

package/{controls → dist/controls}/table/refs.js

@@ -1,6 +1,6 @@
 import { useKitServices } from "../../context.js";
 import * as React from "react";
-//#region src/kit/controls/table/refs.ts
+//#region src/controls/table/refs.ts
 /**
 * Reference cells: what a `reference` column's cell may point at, found through the HOST (the kit never fetches).
 *
@@ -16,6 +16,17 @@ import * as React from "react";
 *
 * Absent → the picker says, in words, that this view cannot search pages or entries (stored cells still show).
 */
+/**
+* The POST /content/reference-options `config` bodies one column's `refTo` needs (the host sends each and merges the
+* answers): pages through `targets: ["page"]`, each collection through `contentModelId`.
+*/
+function tableRefConfigs(refTo) {
+	const to = refTo?.length ? refTo : ["page"];
+	const out = [];
+	if (to.includes("page")) out.push({ targets: ["page"] });
+	for (const id of to) if (id !== "page" && id) out.push({ contentModelId: id });
+	return out;
+}
 /** The words a stored reference shows: what a read resolved onto it, its stored label, else its id. */
 function refLabel(r) {
 	return r.resolved?.title || r.label || r.ref;
@@ -63,6 +74,6 @@ function useRefSearch(open, refTo, q) {
 	return answer?.ask === ask ? answer.state : { status: "loading" };
 }
 //#endregion
-export { refLabel, useRefSearch };
+export { refLabel, tableRefConfigs, useRefSearch };
 
 //# sourceMappingURL=refs.js.map

package/dist/controls/table/refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.js","names":[],"sources":["../../../src/controls/table/refs.ts"],"sourcesContent":["/**\n * Reference cells: what a `reference` column's cell may point at, found through the HOST (the kit never fetches).\n *\n * A reference cell stores `{ ref, label?, href? }` (BE table-value.ts TableRef): the id of a page or an entry. Its column's\n * `refTo` narrows the targets (\"page\", and collections by content-model id or slug); with no `refTo` V2 offers pages. The\n * backend checks the id exists and is a kind `refTo` allows (`reference_target_not_allowed`), so the picker only lists\n * what the same rule accepts: the host answers through POST /content/reference-options with the configs\n * `tableRefConfigs(refTo)` names.\n *\n * Host contract (a KitServices key, provided by src/features/dock-v2 and the /style-guide/kit sandbox):\n *\n *   tableRefSearch(req) → Promise<TableRefOption[]>\n *\n * Absent → the picker says, in words, that this view cannot search pages or entries (stored cells still show).\n */\nimport * as React from \"react\";\nimport { useKitServices } from \"../../context\";\nimport type { TableRef } from \"../../schema/table\";\n\nexport interface TableRefOption {\n  /** page or entry id: what the cell stores as `ref` */\n  id: string;\n  title: string;\n  /** \"Blog post · my-slug\", \"Page\" */\n  subtitle?: string;\n  /** the public path, stored as the cell's `href` so the published table links without a read */\n  href?: string;\n}\nexport interface TableRefSearchRequest {\n  /** the column's `refTo` (null = pages, as V2) */\n  refTo: string[] | null;\n  q: string;\n  signal: AbortSignal;\n}\nexport type TableRefSearch = (req: TableRefSearchRequest) => Promise<TableRefOption[]>;\nexport interface TableKitServices {\n  tableRefSearch?: TableRefSearch;\n}\ndeclare module \"../../context\" {\n  interface KitServices {\n    /** Search pages and entries for a table's reference cells (see above). Absent → the picker names why it can't. */\n    tableRefSearch?: TableRefSearch;\n  }\n}\n\n/**\n * The POST /content/reference-options `config` bodies one column's `refTo` needs (the host sends each and merges the\n * answers): pages through `targets: [\"page\"]`, each collection through `contentModelId`.\n */\nexport function tableRefConfigs(refTo: string[] | null | undefined): Record<string, unknown>[] {\n  const to = refTo?.length ? refTo : [\"page\"];\n  const out: Record<string, unknown>[] = [];\n  if (to.includes(\"page\")) out.push({ targets: [\"page\"] });\n  for (const id of to) if (id !== \"page\" && id) out.push({ contentModelId: id });\n  return out;\n}\n\n/** The words a stored reference shows: what a read resolved onto it, its stored label, else its id. */\nexport function refLabel(r: TableRef & { resolved?: { title?: string } }): string {\n  return r.resolved?.title || r.label || r.ref;\n}\n\nexport type RefSearchState =\n  | { status: \"unavailable\" }\n  | { status: \"loading\" }\n  | { status: \"ready\"; options: TableRefOption[] }\n  | { status: \"error\"; message: string };\n\n/** Search while `open`, 200ms after the last keystroke; a newer query aborts the older one. */\nexport function useRefSearch(open: boolean, refTo: string[] | null, q: string): RefSearchState {\n  const search = useKitServices().tableRefSearch;\n  const key = refTo?.join(\",\") ?? \"\";\n  const ask = `${key}\\u0000${q.trim()}`;\n  // the answer, tagged with the question it answers: a different question reads as loading until its own answer lands\n  const [answer, setAnswer] = React.useState<{ ask: string; state: RefSearchState } | null>(null);\n  React.useEffect(() => {\n    if (!search || !open) return;\n    const ctl = new AbortController();\n    const t = window.setTimeout(() => {\n      search({ refTo: key ? key.split(\",\") : null, q: q.trim(), signal: ctl.signal }).then(\n        (options) => !ctl.signal.aborted && setAnswer({ ask, state: { status: \"ready\", options } }),\n        (e: unknown) => !ctl.signal.aborted && setAnswer({ ask, state: { status: \"error\", message: e instanceof Error && e.message ? e.message : \"The search did not answer.\" } }),\n      );\n    }, 200);\n    return () => {\n      ctl.abort();\n      window.clearTimeout(t);\n    };\n  }, [search, open, key, q, ask]);\n  if (!search) return { status: \"unavailable\" };\n  return answer?.ask === ask ? answer.state : { status: \"loading\" };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAiDA,SAAgB,gBAAgB,OAA+D;CAC7F,MAAM,KAAK,OAAO,SAAS,QAAQ,CAAC,MAAM;CAC1C,MAAM,MAAiC,CAAC;CACxC,IAAI,GAAG,SAAS,MAAM,GAAG,IAAI,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;CACvD,KAAK,MAAM,MAAM,IAAI,IAAI,OAAO,UAAU,IAAI,IAAI,KAAK,EAAE,gBAAgB,GAAG,CAAC;CAC7E,OAAO;AACT;;AAGA,SAAgB,SAAS,GAAyD;CAChF,OAAO,EAAE,UAAU,SAAS,EAAE,SAAS,EAAE;AAC3C;;AASA,SAAgB,aAAa,MAAe,OAAwB,GAA2B;CAC7F,MAAM,SAAS,eAAe,CAAC,CAAC;CAChC,MAAM,MAAM,OAAO,KAAK,GAAG,KAAK;CAChC,MAAM,MAAM,GAAG,IAAI,QAAQ,EAAE,KAAK;CAElC,MAAM,CAAC,QAAQ,aAAa,MAAM,SAAwD,IAAI;CAC9F,MAAM,gBAAgB;EACpB,IAAI,CAAC,UAAU,CAAC,MAAM;EACtB,MAAM,MAAM,IAAI,gBAAgB;EAChC,MAAM,IAAI,OAAO,iBAAiB;GAChC,OAAO;IAAE,OAAO,MAAM,IAAI,MAAM,GAAG,IAAI;IAAM,GAAG,EAAE,KAAK;IAAG,QAAQ,IAAI;GAAO,CAAC,CAAC,CAAC,MAC7E,YAAY,CAAC,IAAI,OAAO,WAAW,UAAU;IAAE;IAAK,OAAO;KAAE,QAAQ;KAAS;IAAQ;GAAE,CAAC,IACzF,MAAe,CAAC,IAAI,OAAO,WAAW,UAAU;IAAE;IAAK,OAAO;KAAE,QAAQ;KAAS,SAAS,aAAa,SAAS,EAAE,UAAU,EAAE,UAAU;IAA6B;GAAE,CAAC,CAC3K;EACF,GAAG,GAAG;EACN,aAAa;GACX,IAAI,MAAM;GACV,OAAO,aAAa,CAAC;EACvB;CACF,GAAG;EAAC;EAAQ;EAAM;EAAK;EAAG;CAAG,CAAC;CAC9B,IAAI,CAAC,QAAQ,OAAO,EAAE,QAAQ,cAAc;CAC5C,OAAO,QAAQ,QAAQ,MAAM,OAAO,QAAQ,EAAE,QAAQ,UAAU;AAClE"}

package/{controls → dist/controls}/table/stored.js

@@ -1,5 +1,5 @@
 import { TABLE_COLUMN_TYPES, isTableValue } from "../../schema/table.js";
-//#region src/kit/controls/table/stored.ts
+//#region src/controls/table/stored.ts
 /**
 * The table value as the backend stores it (BE `packages/types/src/table-value.ts`, a `table` field or a `table` prop with
 * `config.mode: "data"`). The editor works on `normalizeTable(value)`, which fills keys the stored value may not have

package/dist/controls/table/stored.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored.js","names":[],"sources":["../../../src/controls/table/stored.ts"],"sourcesContent":["/**\n * The table value as the backend stores it (BE `packages/types/src/table-value.ts`, a `table` field or a `table` prop with\n * `config.mode: \"data\"`). The editor works on `normalizeTable(value)`, which fills keys the stored value may not have\n * (`id`, empty `columnGroups` / `rowGroups` / `footnotes`). Writing those back would change a value nobody edited, so\n * `storedTable` hands back exactly what the person changed:\n *\n *  - keys normalize invented (an `id`, an empty list the stored value did not carry) are dropped again;\n *  - `undefined` keys (a switch turned off: `highlight`, `sortable`, `notes`…) are removed, as JSON would remove them;\n *  - a reference cell's `resolved` (what a read writes onto it) is never written back (BE normalizeTableValue drops it too).\n *\n * The backend refuses any key it does not know (`table_value_invalid`), so nothing else is added here.\n */\nimport { TABLE_COLUMN_TYPES, isTableValue, type TableValue } from \"../../schema/table\";\n\nconst LISTS = [\"columnGroups\", \"rowGroups\", \"footnotes\"] as const;\n\n/** A JSON copy without `undefined` keys (what the save would send), and without a reference cell's read-only `resolved`. */\nfunction plain<T>(v: T): T {\n  return JSON.parse(JSON.stringify(v, (k, x) => (k === \"resolved\" ? undefined : x))) as T;\n}\n\n/** `next` as the backend stores it, given the value it was loaded from (`prev`; undefined for a new table). */\nexport function storedTable(next: TableValue, prev: unknown): TableValue {\n  const out = plain(next) as TableValue & Record<string, unknown>;\n  const was = isTableValue(prev) ? (prev as unknown as Record<string, unknown>) : null;\n  if (was) {\n    if (!(\"id\" in was) && out.id !== undefined) delete out.id;\n    for (const k of LISTS) if (!(k in was) && Array.isArray(out[k]) && (out[k] as unknown[]).length === 0) delete out[k];\n    // normalize reads a column type it does not know (or none) as \"text\": unless the person picked another type, the\n    // stored one is written back as it was\n    const prevCols = new Map((Array.isArray(was.columns) ? was.columns : []).filter((c): c is Record<string, unknown> => !!c && typeof c === \"object\").map((c) => [c._key, c] as const));\n    for (const col of out.columns as unknown as Record<string, unknown>[]) {\n      const p = prevCols.get(col._key);\n      if (!p || col.type !== \"text\" || TABLE_COLUMN_TYPES.some((t) => t.value === p.type)) continue;\n      if (p.type === undefined) delete col.type;\n      else col.type = p.type;\n    }\n  } else {\n    for (const k of LISTS) if (Array.isArray(out[k]) && (out[k] as unknown[]).length === 0) delete out[k];\n  }\n  return out;\n}\n"],"mappings":";;;;;;;;;;;;;;AAcA,IAAM,QAAQ;CAAC;CAAgB;CAAa;AAAW;;AAGvD,SAAS,MAAS,GAAS;CACzB,OAAO,KAAK,MAAM,KAAK,UAAU,IAAI,GAAG,MAAO,MAAM,aAAa,KAAA,IAAY,CAAE,CAAC;AACnF;;AAGA,SAAgB,YAAY,MAAkB,MAA2B;CACvE,MAAM,MAAM,MAAM,IAAI;CACtB,MAAM,MAAM,aAAa,IAAI,IAAK,OAA8C;CAChF,IAAI,KAAK;EACP,IAAI,EAAE,QAAQ,QAAQ,IAAI,OAAO,KAAA,GAAW,OAAO,IAAI;EACvD,KAAK,MAAM,KAAK,OAAO,IAAI,EAAE,KAAK,QAAQ,MAAM,QAAQ,IAAI,EAAE,KAAM,IAAI,EAAE,CAAe,WAAW,GAAG,OAAO,IAAI;EAGlH,MAAM,WAAW,IAAI,KAAK,MAAM,QAAQ,IAAI,OAAO,IAAI,IAAI,UAAU,CAAC,EAAA,CAAG,QAAQ,MAAoC,CAAC,CAAC,KAAK,OAAO,MAAM,QAAQ,CAAC,CAAC,KAAK,MAAM,CAAC,EAAE,MAAM,CAAC,CAAU,CAAC;EACnL,KAAK,MAAM,OAAO,IAAI,SAAiD;GACrE,MAAM,IAAI,SAAS,IAAI,IAAI,IAAI;GAC/B,IAAI,CAAC,KAAK,IAAI,SAAS,UAAU,mBAAmB,MAAM,MAAM,EAAE,UAAU,EAAE,IAAI,GAAG;GACrF,IAAI,EAAE,SAAS,KAAA,GAAW,OAAO,IAAI;QAChC,IAAI,OAAO,EAAE;EACpB;CACF,OACE,KAAK,MAAM,KAAK,OAAO,IAAI,MAAM,QAAQ,IAAI,EAAE,KAAM,IAAI,EAAE,CAAe,WAAW,GAAG,OAAO,IAAI;CAErG,OAAO;AACT"}

package/{controls → dist/controls}/table/table-editor.js

@@ -1,11 +1,11 @@
+import { GENERAL_TABLE, boolLabels, cellNote, cellText, cellType, cellValue, coerce, isCellObject, isEmptyCell, isObjLike, normalizeTable, orderedRows, parseDelimited, parseTableElement, pasteRange, tableFromRows, tableToRows, tkey, toBool, toNumber, withValue } from "../../schema/table.js";
 import { cn } from "../../lib/cn.js";
 import { useKitServices } from "../../context.js";
 import { Button, IconButton } from "../../ui/button.js";
 import { Segmented, Switch } from "../../ui/controls.js";
 import { Menu, MenuCheckItem, MenuContent, MenuItem, MenuRadioGroup, MenuRadioItem, MenuSeparator, MenuSub, MenuSubContent, MenuSubTrigger, MenuTrigger, Popover, PopoverAnchor, PopoverContent } from "../../ui/overlay.js";
-import { GENERAL_TABLE, boolLabels, cellNote, cellText, cellType, cellValue, coerce, isCellObject, isEmptyCell, isObjLike, normalizeTable, orderedRows, parseDelimited, parseTableElement, pasteRange, tableFromRows, tableToRows, tkey, toBool, toNumber, withValue } from "../../schema/table.js";
-import { Input, Textarea } from "../../ui/input.js";
 import { FieldSection, FieldUnit, FieldUnitRow } from "../../engine/grouping.js";
+import { Input, Textarea } from "../../ui/input.js";
 import { Select } from "../../ui/select.js";
 import { LinkField, hrefOf, linkText, normLink } from "../link.js";
 import { SharedSortProvider, useSharedSort } from "../../engine/item-list.js";
@@ -16,10 +16,10 @@ import { ChoiceSwitch } from "../../ui/choice-switch.js";
 import { LinkAddressButton, isScriptHref, tableLink } from "./table-link.js";
 import { refLabel, useRefSearch } from "./refs.js";
 import * as React from "react";
-import { IconAlignLeft, IconArrowDown, IconArrowUp, IconArrowsMaximize, IconCheck, IconChevronDown, IconCurrencyDollar, IconDots, IconFileDatabase, IconFolder, IconGripVertical, IconHash, IconLayoutColumns, IconLetterT, IconLink, IconList, IconPlus, IconStar, IconTable, IconToggleRight } from "@tabler/icons-react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { IconAlignLeft, IconArrowDown, IconArrowUp, IconArrowsMaximize, IconCheck, IconChevronDown, IconCurrencyDollar, IconDots, IconFileDatabase, IconFolder, IconGripVertical, IconHash, IconLayoutColumns, IconLetterT, IconLink, IconList, IconPlus, IconStar, IconTable, IconToggleRight } from "@tabler/icons-react";
 import { ContextMenu } from "@base-ui/react/context-menu";
-//#region src/kit/controls/table/table-editor.tsx
+//#region src/controls/table/table-editor.tsx
 /**
 * TABLE EDITOR (CPO D42, D49, D50, D52; port of V2 src/components/table/table-editor.tsx) — calm by default.
 *
@@ -93,8 +93,6 @@ var TypeIcon = ({ type, className }) => {
 		"aria-hidden": true
 	});
 };
-/** A ⋯ trigger: shown on hover / focus of its group, always on touch. */
-var DOTS = "flex size-6 shrink-0 items-center justify-center rounded-kit-md text-kit-fg-3 outline-none hover:bg-kit-hover hover:text-kit-fg data-[popup-open]:bg-kit-hover data-[popup-open]:text-kit-fg";
 var mapRow = (key, f) => (t) => ({
 	...t,
 	rows: t.rows.map((r) => r._key === key ? f(r) : r)
@@ -512,7 +510,7 @@ function Grid({ ctx, label, full }) {
 	};
 	return /* @__PURE__ */ jsxs("div", {
 		ref: host,
-		className: cn("min-w-0 overflow-x-auto rounded-kit-lg border border-kit-line bg-kit-surface", full && "max-h-full min-h-0 flex-1 overflow-auto"),
+		className: cn("min-w-0 overflow-x-auto rounded-kit-lg border border-kit-field-border bg-kit-surface", full && "max-h-full min-h-0 flex-1 overflow-auto"),
 		"data-full": full ? "" : void 0,
 		children: [
 			/* @__PURE__ */ jsxs("table", {
@@ -781,8 +779,9 @@ function GridCell({ ctx, row, col, r, c, onMove, onPaste, full }) {
 			]
 		});
 	}
+	const cls = cn("relative border-l border-t border-kit-line p-0 align-top", head && "bg-[var(--kit-subtle-2)]", full && c === 0 && "sticky left-8 z-[1] bg-kit-surface", row.highlight && "bg-kit-accent-softer", col.highlight && "bg-kit-subtle");
 	return /* @__PURE__ */ jsxs("td", {
-		className: cn("relative border-l border-t border-kit-line p-0 align-top", head && "bg-[var(--kit-subtle-2)]", full && c === 0 && "sticky left-8 z-[1] bg-kit-surface", row.highlight && "bg-kit-accent-softer", col.highlight && "bg-kit-subtle"),
+		className: cls,
 		children: [readOnly ? body : /* @__PURE__ */ jsx(CellMenu, {
 			ctx,
 			row,
@@ -1040,13 +1039,13 @@ function ColumnMenu({ ctx, col, index, onInsert, children }) {
 				open,
 				onOpenChange: setOpen,
 				children: [/* @__PURE__ */ jsx(MenuTrigger, {
-					tabIndex: -1,
-					"aria-label": `Options for column ${col.label || index + 1}`,
-					className: cn(DOTS, "opacity-0 focus-visible:opacity-100 group-hover/col:opacity-100 group-focus-within/col:opacity-100 data-[popup-open]:opacity-100 [@media(pointer:coarse)]:opacity-100"),
-					children: /* @__PURE__ */ jsx(IconDots, {
-						className: "size-3.5",
-						stroke: 1.5
-					})
+					render: /* @__PURE__ */ jsx(IconButton, {
+						size: "xs",
+						tabIndex: -1,
+						label: `Options for column ${col.label || index + 1}`,
+						className: "shrink-0 opacity-0 focus-visible:opacity-100 group-hover/col:opacity-100 group-focus-within/col:opacity-100 data-[popup-open]:opacity-100 [@media(pointer:coarse)]:opacity-100"
+					}),
+					children: /* @__PURE__ */ jsx(IconDots, { stroke: 1.5 })
 				}), /* @__PURE__ */ jsxs(MenuContent, {
 					align: "end",
 					className: "min-w-52",
@@ -1274,15 +1273,15 @@ function RowMenu({ ctx, row, index, count, onInsert, children }) {
 		ctx.undoable("Row deleted", prev);
 	};
 	const groups = offered(ctx.options).groups ? t.rowGroups ?? [] : [];
-	return /* @__PURE__ */ jsxs(Menu, { children: [children(/* @__PURE__ */ jsx(MenuTrigger, {
-		tabIndex: -1,
-		"aria-label": `Options for row ${index + 1}`,
-		className: DOTS,
-		children: /* @__PURE__ */ jsx(IconDots, {
-			className: "size-3.5",
-			stroke: 1.5
-		})
-	})), /* @__PURE__ */ jsxs(MenuContent, {
+	const trigger = /* @__PURE__ */ jsx(MenuTrigger, {
+		render: /* @__PURE__ */ jsx(IconButton, {
+			size: "xs",
+			tabIndex: -1,
+			label: `Options for row ${index + 1}`
+		}),
+		children: /* @__PURE__ */ jsx(IconDots, { stroke: 1.5 })
+	});
+	return /* @__PURE__ */ jsxs(Menu, { children: [children(trigger), /* @__PURE__ */ jsxs(MenuContent, {
 		className: "min-w-52",
 		children: [
 			/* @__PURE__ */ jsx(MenuItem, {
@@ -1360,7 +1359,8 @@ function CellMenu({ ctx, row, col, cell, onWrite, onNote, children }) {
 	const asText = own === "text";
 	const atMax = !!ctx.options.maxRows && !row.footer && t.rows.filter((r) => !r.footer).length >= ctx.options.maxRows;
 	const setOwn = (type) => {
-		const value = coerce(cellText(col, row, cell, ctx.resolveRef), {
+		const raw = cellText(col, row, cell, ctx.resolveRef);
+		const value = coerce(raw, {
 			type: type ?? colType,
 			max: col.max
 		});
@@ -1971,15 +1971,18 @@ function RowsPart({ ctx, basePath, onOpen }) {
 							role: "group",
 							"aria-label": run.totals ? "Totals" : run.group.label || "Untitled group",
 							className: "flex flex-col gap-1.5",
-							children: [run.totals ? /* @__PURE__ */ jsx("span", {
-								className: "flex h-7 items-center px-0.5 text-kit-sm font-medium text-kit-fg-2",
-								children: "Totals"
-							}) : /* @__PURE__ */ jsx(GroupHeading, {
-								ctx,
-								group: run.group,
-								index: groups.indexOf(run.group),
-								count: groups.length,
-								rows: run.items.length
+							children: [/* @__PURE__ */ jsx("div", {
+								className: "rounded-kit-md transition-colors",
+								children: run.totals ? /* @__PURE__ */ jsx("span", {
+									className: "flex h-7 items-center px-0.5 text-kit-sm font-medium text-kit-fg-2",
+									children: "Totals"
+								}) : /* @__PURE__ */ jsx(GroupHeading, {
+									ctx,
+									group: run.group,
+									index: groups.indexOf(run.group),
+									count: groups.length,
+									rows: run.items.length
+								})
 							}), /* @__PURE__ */ jsx("div", {
 								className: "ml-1.5 border-l border-kit-line pl-3",
 								children: list
@@ -2045,14 +2048,14 @@ function GroupHeading({ ctx, group, index, count, rows }) {
 					setDraft(group.label);
 				}
 			},
-			className: "-mx-0.5 h-7 min-w-0 flex-1 truncate rounded-kit-md bg-transparent px-0.5 text-kit-sm font-medium text-kit-fg-2 outline-none transition-colors placeholder:font-normal placeholder:text-kit-fg-4 hover:bg-kit-hover focus:bg-kit-surface focus:px-2 focus:text-kit-fg focus:shadow-[inset_0_0_0_1px_var(--kit-line-strong)]"
+			className: "-mx-0.5 h-7 min-w-0 flex-1 truncate rounded-kit-md bg-transparent px-0.5 text-[13px] font-medium text-kit-fg-2 outline-none transition-colors placeholder:font-normal placeholder:text-kit-fg-4 hover:bg-kit-hover focus:bg-kit-surface focus:px-2 focus:text-kit-fg focus:shadow-[inset_0_0_0_1px_var(--kit-line-strong)]"
 		}), readOnly ? null : /* @__PURE__ */ jsxs(Menu, { children: [/* @__PURE__ */ jsx(MenuTrigger, {
-			"aria-label": `Options for ${group.label || "this group"}`,
-			className: cn(DOTS, "size-7 opacity-0 focus-visible:opacity-100 group-hover/gh:opacity-100 group-focus-within/gh:opacity-100 data-[popup-open]:opacity-100 [@media(pointer:coarse)]:opacity-100"),
-			children: /* @__PURE__ */ jsx(IconDots, {
-				className: "size-4",
-				stroke: 1.5
-			})
+			render: /* @__PURE__ */ jsx(IconButton, {
+				size: "xs",
+				label: `Options for ${group.label || "this group"}`,
+				className: "opacity-0 focus-visible:opacity-100 group-hover/gh:opacity-100 group-focus-within/gh:opacity-100 data-[popup-open]:opacity-100 [@media(pointer:coarse)]:opacity-100"
+			}),
+			children: /* @__PURE__ */ jsx(IconDots, { stroke: 1.5 })
 		}), /* @__PURE__ */ jsxs(MenuContent, {
 			align: "end",
 			className: "min-w-44",
@@ -2336,12 +2339,12 @@ function CellField({ ctx, row, col, ci, needsName, onWrite }) {
 					}) : null,
 					/* @__PURE__ */ jsx("span", { className: "flex-1" }),
 					canWords || canNote || !readOnly && !isEmptyCell(v) ? /* @__PURE__ */ jsxs(Menu, { children: [/* @__PURE__ */ jsx(MenuTrigger, {
-						"aria-label": `Options for ${name}`,
-						className: cn(DOTS, "-my-1 opacity-0 focus-visible:opacity-100 group-hover/cell:opacity-100 group-focus-within/cell:opacity-100 data-[popup-open]:opacity-100 [@media(pointer:coarse)]:opacity-100"),
-						children: /* @__PURE__ */ jsx(IconDots, {
-							className: "size-3.5",
-							stroke: 1.5
-						})
+						render: /* @__PURE__ */ jsx(IconButton, {
+							size: "xs",
+							label: `Options for ${name}`,
+							className: "-my-1 opacity-0 focus-visible:opacity-100 group-hover/cell:opacity-100 group-focus-within/cell:opacity-100 data-[popup-open]:opacity-100 [@media(pointer:coarse)]:opacity-100"
+						}),
+						children: /* @__PURE__ */ jsx(IconDots, { stroke: 1.5 })
 					}), /* @__PURE__ */ jsxs(MenuContent, {
 						align: "end",
 						className: "min-w-52",
@@ -2717,6 +2720,6 @@ function TableSettings({ ctx }) {
 }
 var dropUndefined = (o) => Object.fromEntries(Object.entries(o).filter(([, v]) => v !== void 0));
 //#endregion
-export { TableEditor, TableFullScreenButton, TableItemEditor };
+export { TYPE_UI, TableEditor, TableFullScreenButton, TableItemEditor, linkNote, moveRowTo, offered, retype, setTotals, typedCell, unlinkNote };
 
 //# sourceMappingURL=table-editor.js.map