impact-nova 2.6.0-alpha.0 → 2.6.0

package/dist/i18n/format/index.d.ts

@@ -1,6 +0,0 @@
-export { FORMATTER_CACHE_LIMIT, getNumberFormat, getDateTimeFormat, getCollator, getRelativeTimeFormat, } from './formatter-cache';
-export { formatNumber, formatCurrency, formatPercent, formatCompactNumber, getNumberSeparators, type CompactMagnitude, type NumberSeparators, } from './format-number';
-export { parseNumber } from './parse-number';
-export { formatDate, formatTime, formatDateTime, formatRelativeTime, toValidDate, SHORT_DATE_OPTIONS, SHORT_TIME_OPTIONS, SHORT_DATE_TIME_OPTIONS, } from './format-date';
-export { getLocalizedDatePattern } from './date-pattern';
-export { compareStrings } from './collator';

package/dist/i18n/format/parse-number.d.ts

@@ -1,6 +0,0 @@
-/**
- * Parse a localized numeric string into a canonical JavaScript number.
- * Display formatting must never become the stored value.
- * Returns null for empty, mixed-separator, or otherwise malformed input.
- */
-export declare function parseNumber(input: string, locale: string): number | null;

package/dist/i18n/format/parse-number.js

@@ -1,53 +0,0 @@
-import { getNumberSeparators as h } from "./format-number.js";
-const A = /[\s\u00A0\u202F\u2009\u2007\u2008\u200A]/, $ = /[\s\u00A0\u202F\u2009\u2007\u2008\u200A]/g;
-function d(t) {
-  return t.length > 0 && A.test(t);
-}
-function C(t, r) {
-  if (!r || d(r) || !t.includes(r)) return !0;
-  const e = t.split(r);
-  return e.some((n) => n.length === 0 || !/^\d+$/.test(n)) ? !1 : e.slice(1).every((n) => n.length >= 2 && n.length <= 3);
-}
-function x(t) {
-  return t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function E(t) {
-  let r = t.trim().replace(new RegExp("\\p{Sc}", "gu"), "");
-  return r = r.replace(/^[A-Z]{3}\s+/u, "").replace(/\s+[A-Z]{3}$/u, ""), r.trim();
-}
-function S(t, r) {
-  if (typeof t != "string") return null;
-  let e = E(t);
-  if (!e) return null;
-  const { decimal: n, group: i, minus: f } = h(r);
-  let o = !1;
-  const p = [f, "-", "−", "－"];
-  for (const c of p)
-    if (c && e.startsWith(c)) {
-      o = !0, e = e.slice(c.length).trim();
-      break;
-    }
-  if ((e.endsWith("-") || e.endsWith(f)) && (o = !0, e = e.slice(0, e.endsWith(f) ? -f.length : -1).trim()), !e) return null;
-  const a = n ? e.lastIndexOf(n) : -1;
-  let s, u;
-  if (a >= 0) {
-    if (s = e.slice(0, a), u = e.slice(a + n.length), u.length === 0 || !/^\d+$/.test(u)) return null;
-  } else
-    s = e, u = null;
-  if (n && u == null && s.includes(n) || i && !C(s, i)) return null;
-  let l = s;
-  if (i && !d(i)) {
-    const c = new RegExp(x(i), "g");
-    l = l.replace(c, "");
-  }
-  if (l = l.replace($, ""), l.length === 0) {
-    if (!u) return null;
-    l = "0";
-  }
-  if (!/^\d+$/.test(l)) return null;
-  const m = `${o ? "-" : ""}${l}.${u ?? "0"}`, g = Number(m);
-  return Number.isFinite(g) ? g : null;
-}
-export {
-  S as parseNumber
-};

package/dist/i18n/locale-config.d.ts

@@ -1,28 +0,0 @@
-export declare const DEFAULT_LOCALE = "en";
-export interface LocaleConfigInput {
-    locale?: string;
-    dateLocale?: string;
-    numberLocale?: string;
-}
-export interface ResolvedLocaleConfig {
-    locale: string;
-    dateLocale: string;
-    numberLocale: string;
-}
-/**
- * Canonicalize a BCP 47 tag with Intl.Locale.
- * Invalid/malformed tags fall back to `fallback` — the returned value is what callers must advertise.
- */
-export declare function canonicalizeLocale(tag: string | undefined | null, fallback?: string): string;
-/** Language subtag only (`de-DE` → `de`). Used for message-pack lookup, not formatting. */
-export declare function languageFromLocale(tag: string): string;
-/**
- * Resolve the public locale model:
- * language = locale ?? "en"
- * dateLocale = dateLocale ?? locale ?? "en"
- * numberLocale = numberLocale ?? locale ?? "en"
- *
- * Independent overrides that fail canonicalization fall back to the resolved language locale,
- * not a hidden en-US rewrite.
- */
-export declare function resolveLocaleConfig(input?: LocaleConfigInput): ResolvedLocaleConfig;

package/dist/i18n/locale-config.js

@@ -1,32 +0,0 @@
-const L = "en";
-function r(e) {
-  if (e == null) return;
-  const n = e.trim();
-  return n.length > 0 ? n : void 0;
-}
-function t(e, n = "en") {
-  const o = r(e);
-  if (!o) return n;
-  try {
-    return new Intl.Locale(o).toString();
-  } catch {
-    return n;
-  }
-}
-function a(e) {
-  try {
-    return new Intl.Locale(e).language;
-  } catch {
-    return "en";
-  }
-}
-function l(e = {}) {
-  const n = t(e.locale, "en"), o = r(e.dateLocale) ? t(e.dateLocale, n) : n, c = r(e.numberLocale) ? t(e.numberLocale, n) : n;
-  return { locale: n, dateLocale: o, numberLocale: c };
-}
-export {
-  L as DEFAULT_LOCALE,
-  t as canonicalizeLocale,
-  a as languageFromLocale,
-  l as resolveLocaleConfig
-};

package/dist/i18n/week-start.d.ts

@@ -1,6 +0,0 @@
-type Weekday = 0 | 1 | 2 | 3 | 4 | 5 | 6;
-/**
- * explicit weekStartsOn → Intl.Locale weekInfo → date-fns locale options → Sunday.
- */
-export declare function getWeekStartsOn(locale: string, explicit?: Weekday): Weekday;
-export {};

package/dist/i18n/week-start.js

@@ -1,30 +0,0 @@
-import { getDateFnsLocale as f } from "./getDateFnsLocale.js";
-import { canonicalizeLocale as i } from "./locale-config.js";
-function u(e) {
-  const t = e;
-  if (typeof t.getWeekInfo == "function")
-    try {
-      return t.getWeekInfo();
-    } catch {
-      return;
-    }
-  if (t.weekInfo && typeof t.weekInfo.firstDay == "number")
-    return t.weekInfo;
-}
-function c(e) {
-  return e === 7 ? 0 : e >= 1 && e <= 6 ? e : 0;
-}
-function k(e, t) {
-  if (t != null) return t;
-  try {
-    const o = new Intl.Locale(i(e)), n = u(o);
-    if (n && Number.isFinite(n.firstDay))
-      return c(n.firstDay);
-  } catch {
-  }
-  const r = f(e).options?.weekStartsOn;
-  return r ?? 0;
-}
-export {
-  k as getWeekStartsOn
-};

package/dist/llms/rules/data-table-chat.js

@@ -1 +0,0 @@
-export default "> MCP resource `impact-nova://data-table-chat`. Follow this guide — do not invent APIs or put threads in `rowData`.\n\n# DataTable row Chat\n\nMCP resource: **`impact-nova://data-table-chat`**.\n\nLearning path for enabling **row Chat** on Impact Nova `DataTable`.\n\nStorybook: **Data Display / DataTable / Chat / QuickStart**.\n\nChat is **not** a cell comment and **not** an AG Grid Note.\n\n- Comment → cell `{ rowId, colId }`\n- Note → cell text\n- Chat → **row** `{ rowId }` from `getRowId`, with **many conversations** per row\n- Thread reply → `{ rowId, conversationId, parentId }`\n- Pin → a flag on a message in that conversation\n\n## 1. Opt-in\n\nOmit `chat` and the grid is unchanged: no Chat column, host, listeners, or fetch.\n\n```tsx\n<DataTableContent getRowId={(params) => params.data.id} chat={chat} />\n```\n\nRequired:\n\n| Piece | Why |\n|---|---|\n| `getRowId` | Stable row identity. Never `rowIndex` or a DOM node |\n| `hasConversation` | O(1) presence for visible Chat cells |\n| `loadConversation` | Newest window (50) for `{ rowId, conversationId }` + `before` cursor for older messages |\n| `persist` | One event (`create-conversation` or one message), not the lifetime array |\n| `getAuthor` | Name stamped on new messages |\n\nOptional: `unreadCount`, `getSummaries` (rows list + per-row chats), `locateRow` (required for app-paged / SSRM), `column: false`, `colId`, `priority(rowId)` (`high` / `medium` / `low`), `quickActions`, `messageActions` / `threadActions` / `listActions`, `composerTools`, `listPeople({ query, limit })` (directory for Add member; Nova shows 10 after excluding current members), `can(action, context)` (authorization), `renderComposer` / `renderAvatar` / `renderMessageBody` / `renderMembers` / `renderPeoplePicker`.\n\nComposer ships **attach file / image** (local `File` → object URL until persist writes it), **emoji**, **bold / italic / link**, and a **Quick action** menu from `composerTools` (omit the menu when you pass none). Nova does not own product verbs. An offer table passes “Finalize offer”, a ticket table passes “Resolve”, a request table passes “Complete” — each `onSelect` writes the row, then calls `context.close()` to dismiss Chat. Stay-in-thread tools use `context.insertText(...)` instead. The same `close()` is on `quickActions`, `messageActions`, `threadActions`, and `listActions`. Persist `set-priority` with `high` / `medium` / `low`, or `null` to clear (Normal). Message-row and composer checkmarks set priority. Conversation **⋯** is notify + mute (`set-notify`, `mute-conversation`) — not priority. Persist `set-members` when adding or removing people; omit `listPeople` for a read-only member list derived from authors.\n\n`loadConversation` may be **client-windowed** (return the full array; Nova keeps the newest 50 and `before` for older) or **server-windowed** (return only the requested page plus `hasMoreOlder`). The thread virtualizes after 32 messages, follows a new latest message when you are near the bottom (WhatsApp-style), and does not jump on load-older prepend.\n\n## 2. System column\n\nDefault injects pinned-right `iv-chat` (69px). It is excluded from the column tree, saved views, auto-size, and export. Do not persist it in consumer column state.\n\n## 3. Pagination\n\n- **Client pagination:** all rows stay in the model. Nova uses live `rowIndex`. Do not pass `locateRow`.\n- **Server / app-paged:** `getRowNode` is missing. Pass `locateRow(rowId)` and load the page (see Comments `ServerPagedCommentsDemo`). Chat opens for that `rowId` immediately.\n\nFiltered rows (`rowIndex == null`) open Chat with **Hidden by current filter**. Nova does not call `locateRow`.\n\n## 4. Panel\n\nChat uses a right **Sheet** (`impact-nova/sheet`) — not FilterPanel and not DataTableSheet. Widths are Chat-owned: catalog 840px, row-chats 340 + 640 min. Pinned/thread shares the remaining width with the main thread (up to 640px each, shrinks with the viewport). Scroll, virtualize, sort, and paginate do not retarget the open row.\n\n- Toolbar **Chats** opens unique **row names**. Click a row to see its chats.\n- Chat cell opens that row’s chats. **+ Chat** starts another conversation on the same row.\n- Back returns to the unique-row list.\n\nEmpty lists use `EmptyContainer` (`impact-nova/empty-container`).\n\nThe thread header cluster (pin + avatars, or `AddUser` when empty) opens the **Info** drawer. Thread replies open the **Thread** drawer. The drawer shares width with the main thread (up to 640px each) and shrinks with the viewport. `loadConversation` receives `purpose: \"page\" | \"thread\" | \"pinned\"`. Persist `pin-message`, `add-message` with `parentId`, `edit-message`, and `delete-message`. Do not add a WebSocket layer inside Nova.\n\nThe **Info** drawer is the WhatsApp-style panel: pinned cards and members share the height like VS Code sidebars. Each chevron has three angles: **45° split**, **90° expanded**, **0° collapsed**. Expanding one collapses the other to its header.\n\n## 5. Mapping your backend\n\nNova never sees REST URLs or vendor DTOs. `loadConversation`, `listPeople`, `getSummaries`, and `persist` **are** the adapters.\n\n```ts\ntype PeopleDto = { user_id: string; display_name: string; avatar_url?: string; role?: string }\n\nlistPeople: async ({ query, limit } = {}) => {\n  const json = await api.getPeople({ query, limit })\n  return json.users.map((row: PeopleDto) => ({\n    id: row.user_id,\n    name: row.display_name,\n    avatarUrl: row.avatar_url,\n  }))\n}\n```\n\nApply the same mapping in `loadConversation` for `conversation.members` and in `persist` when you write `set-members` back. Nova's member model is `{ id, name, avatarUrl? }`. Roles stay in the consumer; do not send them in for Nova to interpret.\n\n## 6. Permissions\n\nImpact Nova is not the source of truth for authorization. Pass `can(action, context)`:\n\n| Action | Default when `can` is omitted |\n|---|---|\n| `view` / `create` / `edit` / `delete` | `getCapabilities(rowId)` (`canEdit` / `canDelete` default false) |\n| `invite` / `remove-member` | `canCreate` **and** `listPeople` is provided |\n\nReturn `true` or `false` to override one action. Return `undefined` to use the default.\n\n```ts\ncan: (action, context) => {\n  if (action === \"invite\" || action === \"remove-member\") return isAdmin(context.rowId)\n  if (action === \"edit\") return context.message?.author === currentUser\n  return undefined\n}\n```\n\nA visible button is not a grant. If `persist` throws `{ status: 403 }` or `{ status: 401 }`, Nova rolls back optimistic member changes and toasts permission denied.\n\nLeave / transfer-ownership are not Chat domain verbs. Put them on `listActions` and call your API, then `context.close()` if the user left.\n\n## 7. Composition\n\nChat is a DataTable opt-in, same as Comments — not a Radix `<Chat><ChatHeader/></Chat>` tree. Zero-config is `chat={config}`. Escape hatches replace one piece:\n\n| Slot | Replaces |\n|---|---|\n| `renderAvatar` | Author glyph (`{ author, member? }`) |\n| `renderMessageBody` | Message text |\n| `renderComposer` | Reply box (host still owns draft + persist) |\n| `renderMembers` | Info-drawer roster |\n| `renderPeoplePicker` | Add-member directory |\n| `renderMessageActions` / `renderThreadActions` | `…` menus |\n| `messageActions` / `threadActions` / `listActions` / `quickActions` / `composerTools` | Extra actions Nova does not understand |\n\nDo not rebuild Chat to add “Open purchase order”. Add a `ChatUiAction` and handle it in `onSelect`.\n\n## 8. Members UX\n\n**Add member** is the first row in the members list. It opens a full-panel directory (search, first 10 people, multi-select). Persist `set-members` plus `add-message` with `system: true` so the thread shows “{{name}} was added” / “{{name}} was removed”. If the toolbar has no members yet, it shows `AddUser` from `impact-nova-icons`.\n\nThe on-screen roster is bounded (40, then Show more). `listPeople` runs when the picker opens — never once per grid row.\n\n## Related\n\n- [data-table-comments.md](impact-nova://data-table-comments)\n- [data-table-notes.md](impact-nova://data-table-notes)\n";

package/dist/llms/rules/data-table-comments.js

@@ -1 +0,0 @@
-export default "> MCP resource `impact-nova://data-table-comments`. Follow this guide — do not invent APIs or put threads in `rowData`.\n\n# DataTable cell comments\n\nMCP resource: **`impact-nova://data-table-comments`**.\n\nLearning path for enabling Google Sheets–style **cell comments** on Impact Nova `DataTable`.\n\nStorybook: **Data Display / DataTable / Comments / QuickStart**.\n\nThis is **not** AG Grid Notes, and there is **no** read/unread model.\n\n## 1. What is a comment?\n\nA comment is a conversation attached to a **logical cell**:\n\n```\ngrid + getRowId(row) + colId  →  CellAddress { rowId, colId }\n```\n\nThe thread lives in **your** store (or API). It is not a field on `rowData`. The cell triangle is only painted when that cell is currently rendered.\n\nThe overlay is shown only while that logical cell intersects the usable grid viewport (below the header, not under a pinned column). Scroll it fully away and the overlay hides; scroll it back and the same thread restores, including an unsaved draft. Explicit close (X / Escape / click outside) ends the session. Use the Comments panel to keep a list while navigating.\n\n## 2. What is not a comment?\n\n- AG Grid Notes — a separate opt-in on `notes={...}`; see [data-table-notes.md](impact-nova://data-table-notes)\n- Read/unread, badges, or per-cell React widgets\n- Storing `page` or frozen `rowIndex` on the thread (filters change the live index)\n\n## 3. Quick start (required)\n\nStart at Storybook **QuickStart**. Copy the Docs source.\n\nRequired:\n\n| Piece | Why |\n|---|---|\n| `getRowId` | Stable row identity |\n| `comments.hasIndicator` | O(1). `true` only for **unresolved** threads that should show the triangle |\n| `comments.loadThread` | Fetch the thread for an address |\n| `comments.persist` | Create / reply / edit / delete / resolve |\n| `comments.getAuthor` | Name stamped on new messages |\n\nOptional:\n\n| Piece | Why |\n|---|---|\n| `getSummaries` | Comments list in `DataTableSheet` |\n| `locateRow` | Row is **not** in the current grid model (SSRM / app-paged `rowData`) |\n| `getCapabilities` | View-only vs edit per cell |\n| `commentMode` / `CommentModeToggle` | Click empty cells to compose |\n| `loadThread` `request` | Windowed thread history (`preview` \\| `page`) |\n\n```tsx\nimport { DataTable, DataTableContent, DataTableToolbar } from \"impact-nova/data-table\";\nimport {\n  CommentModeToggle,\n  defaultGetThreadId,\n  type DataTableCommentsConfig,\n} from \"impact-nova/ag-grid-react/comments\";\n\n<DataTable className=\"h-[640px]\">\n  <DataTableToolbar>\n    <CommentModeToggle pressed={commentMode} onPressedChange={setCommentMode} />\n  </DataTableToolbar>\n  <DataTableContent\n    getRowId={(params) => params.data.id}\n    columnDefs={columnDefs}\n    rowData={rowData}\n    comments={comments}\n  />\n</DataTable>\n```\n\nOmit `comments` entirely to disable the feature. Nova will not mount the comments host.\n\n## 4. Right-click → Add comment\n\nWith `comments` set, the grid context menu includes **Add comment** (native AG Grid note items are stripped). Comment mode is **not** required.\n\nStory: **AddComment**. Persist event: `{ type: \"add-message\", threadId, address, message }`.\n\n## 5. Client-side grid\n\nAll rows in `rowData` (CSRM). Optional AG Grid `pagination` only changes what is painted.\n\n- Comment store is still separate\n- Panel click: `getRowNode(rowId)` → live `rowIndex` → `paginationGoToPage` → `ensureIndexVisible`\n- Do **not** implement `locateRow`\n\nStory: **ClientSidePagination**.\n\n## 6. Server-side / app-paged grid\n\nOnly the current page/block is in the grid model. The comment still exists.\n\n1. Panel (or your UI) identifies `{ rowId, colId }`\n2. `getRowNode(rowId)` misses\n3. `comments.locateRow(address)` loads that page into the grid (your API)\n4. Return `{ status: \"ready\" }` or `{ status: \"ready\", rowIndex }`\n5. Nova reveals the cell and opens the overlay\n\nFiltered-out rows (`rowIndex == null`) stay **Not in current view**. `locateRow` is not called for those.\n\nStory: **ServerSidePagination**.\n\n## 7. Three different “pages”\n\n| Kind | What it pages | Config |\n|---|---|---|\n| Grid | Which rows AG Grid has loaded/painted | `pagination` / SSRM / your `rowData` slice |\n| Comments list | Which thread **summaries** are in the sheet | `getSummaries({ cursor, limit, query })` |\n| Thread history | Which **messages** are in the overlay | `loadThread(..., { purpose, limit, before })` |\n\nThese are independent. A 10,000-message thread is still one cell.\n\n## 8. Cell identity\n\nUse `getRowId` + stable `colId`. Default thread id is `rowId + \"\\\\0\" + colId` (`defaultGetThreadId`). Override `getThreadId` only if column ids regenerate.\n\nDo not key comments by DOM nodes, rendered cell components, or array indexes.\n\n## 9. Thread lifecycle\n\nCreate → reply → resolve → reopen. Indicator is on **unresolved** threads only.\n\nStories: **Lifecycle**, **Loading**, **PersistError**, **ReadOnly**.\n\n## 10. Large scale\n\n`hasIndicator` must be O(1). Overlay holds **one** windowed thread. Panel virtualizes summaries. Story: **LargeScale** (50k columns) — architecture proof, not the copy-paste starter.\n\n## 11. Appearance (optional)\n\nThe default UI is already production-ready. Omit every field below to keep it.\n\n**Level 1 — CSS.** Set variables on a wrapper (they inherit):\n\n```css\n.planning-grid {\n  --iv-comment-indicator-color: var(--color-success);\n  --iv-comment-indicator-size: 12px;\n}\n```\n\nStable hooks (popover is portaled): `[data-iv-comments]`, `[data-slot=\"comments-popover\"]`, `[data-slot=\"comments-header\"]`, `[data-slot=\"comments-message\"]`, `[data-slot=\"comments-composer\"]`, `[data-slot=\"comments-panel\"]`.\n\nIndicator shape stays CSS `::after` (no per-cell React).\n\n**Level 2 — extra menu items.** Append after Edit/Delete without replacing the menu:\n\n```tsx\ncomments={{\n  hasIndicator,\n  loadThread,\n  persist,\n  getAuthor,\n  messageActions: [\n    {\n      id: \"open\",\n      label: \"Open\",\n      onSelect: ({ address, message }) => openRecord(address, message.id),\n    },\n  ],\n}}\n```\n\n`threadActions` appends after Delete thread on the overlay and panel `…` menus.\n\n**Level 3 — replace one piece.** Unspecified slots keep Nova defaults:\n\n```tsx\ncomments={{\n  hasIndicator,\n  loadThread,\n  persist,\n  getAuthor,\n  renderAvatar: ({ author }) => <YourAvatar name={author} />,\n}}\n```\n\nAlso available: `renderMessageBody`, `renderComposer`, `renderMessageActions` (receives Edit/Delete plus `messageActions`), `renderThreadActions`.\n\nThese render only while the overlay or panel is open. They do not run per cell.\n\n**Not customizable (intentionally):** overlay anchoring, cell identity, persistence, virtualization, AG Grid presence, Comment indicator as a React component.\n\n## 12. API reference\n\nTypes and helpers: `impact-nova/ag-grid-react/comments`.\n\nSee `DataTableCommentsConfig` in that subpath. Contributor tripwire: `src/components/data/ag-grid-react/comments/comments.decisions.md`.\n\n## 13. Testing\n\nStorybook `play` functions under **Data Display / DataTable / Comments** are the behavioural suite (`npm run test:storybook`). Unit tests live next to `comments/*.ts`.\n";

package/dist/llms/rules/data-table-notes.js

@@ -1 +0,0 @@
-export default "> MCP resource `impact-nova://data-table-notes`. Follow this guide — do not invent APIs or put threads in `rowData`.\n\n# DataTable cell notes\n\nMCP resource: **`impact-nova://data-table-notes`**.\n\nAG Grid **Notes** on Impact Nova `DataTable`. A note is short text on a logical cell. A **comment** is a conversation. They can coexist.\n\nStorybook: **Data Display / DataTable / Notes / QuickStart**.\n\n## When to use Notes vs Comments\n\n- **Note** — cell-specific text (override reason, reminder). AG Grid owns the popup and menu.\n- **Comment** — thread with replies, resolve/reopen. Nova owns the overlay.\n\n## Enable Notes\n\n```tsx\nimport { DataTable, DataTableContent } from \"impact-nova/data-table\";\nimport type { DataTableNotesConfig } from \"impact-nova/ag-grid-react/notes\";\n\n<DataTableContent\n  getRowId={(params) => params.data.id}\n  notes={notes}\n  columnDefs={columnDefs}\n  rowData={rowData}\n/>\n```\n\n`getNote` / `setNote` are keyed by `{ rowId, colId }`. Omit `notes` for zero Notes work.\n\n## Same cell\n\nBlue triangle = Comment. Yellow = Note. Split blue/yellow = both. Hover opens the AG Grid note. Context menu keeps comment actions and native note actions.\n\n## Appearance (optional)\n\nUnset variables keep the Nova yellow default. No Notes component map.\n\n```css\n.planning-grid {\n  --iv-note-indicator-color: var(--color-destructive);\n  --iv-note-indicator-size: 12px;\n  --iv-note-popup-background: var(--color-warning-surface);\n  --iv-note-popup-text: var(--color-foreground);\n  --iv-note-popup-input-background: var(--color-background);\n  --iv-note-popup-border: 1px solid var(--color-warning-border);\n}\n```\n\nThe popup shell is AG Grid’s `.ag-notes-popup`. Nova only tokenises it via `--ag-note-*` mapped from the `--iv-note-*` knobs above. Do not replace the native editor with a React slot. Extra Comment `messageActions` still work on the same grid — they are Comment overlay items, not AG Grid note menu items.\n\n## Performance\n\nOpt-in. `getNote` runs for painted cells only. No per-cell React. 50,000+ columns use AG Grid column virtualization.\n";