impact-nova 2.5.16 → 2.6.0-alpha.0

package/dist/components/data/ag-grid-react/comments/comments-panel.js

@@ -0,0 +1,272 @@
+import { jsx as t, jsxs as o } from "react/jsx-runtime";
+import { useRef as ie, useState as c, useEffect as $ } from "react";
+import { useVirtualizedList as de } from "../../../../lib/virtualized/useVirtualizedList.js";
+import { Avatar as ce, AvatarFallback as me } from "../../../data-display/avatar/avatar.js";
+import { DataTableSheet as he, DataTableSheetContent as pe, DataTableSheetHeader as ue } from "../../data-table/data-table-sheet.js";
+import { DataTableSheetBody as xe, DataTableSheetSection as fe } from "../../data-table/data-table-sheet-layout.js";
+import { Button as J } from "../../../primitives/button/button.js";
+import { Input as ve } from "../../../forms/input/input.js";
+import { DropdownMenu as ge, DropdownMenuTrigger as be, DropdownMenuContent as Ne, DropdownMenuItem as q } from "../../../feedback/dropdown-menu/dropdown-menu.js";
+import { EmptyContainer as F, EmptyContainerImage as K, EmptyContainerTitle as H, EmptyContainerDescription as Q } from "../../../primitives/empty-container/empty-container.js";
+import { useImpactNovaI18n as Y } from "../../../../i18n/use-impact-nova-i18n.js";
+import { cn as I } from "../../../../lib/utils.js";
+import { Cross as Ce, Search as we, Filterlist as Te, FillTick as Se, CheckTickcircle as ye } from "impact-nova-icons";
+import { COMMENTS_VIRTUALIZE_AFTER as Ee, COMMENTS_PANEL_PAGE_SIZE as U } from "./comments-constants.js";
+import { resolveCommentsCapabilities as Ie, commentsOverlayActions as Ae } from "./comments-capabilities.js";
+import { commentInitials as De, commentAvatarTone as Me, formatPanelTimestamp as Re } from "./comments-format.js";
+import { buildCommentThreadMenuItems as ke } from "./comments-ui-actions.js";
+import { CommentActionsMenu as Le } from "./comments-actions-menu.js";
+import Pe from "./assets/comments-no-results.png.js";
+import { Message3d as ze } from "../../../ui/local-raster-icons/rasterIcons.js";
+const _e = "!h-8 !w-8 !rounded-md text-sm font-extrabold", V = "flex-1 h-full w-full min-w-0 max-w-none animate-none rounded-none border-0 bg-transparent px-3 py-0 shadow-none [&>div]:max-w-[284px] [&>div]:gap-[10px]";
+function j(n, u, a) {
+  return n < u - 1 && !a ? "border-b border-stroke-hairline" : void 0;
+}
+function Be({
+  summary: n,
+  selected: u,
+  config: a,
+  persist: w,
+  onSelect: T,
+  onReload: x,
+  onError: r
+}) {
+  const { t: d, dateLocale: i } = Y(), h = Ie(a.getCapabilities, n.address), g = Ae(h), b = Math.max(0, n.messageCount - 1), m = n.author ?? d("comments.title"), N = {
+    address: n.address,
+    threadId: n.threadId,
+    resolved: n.resolved
+  }, l = ke({
+    showDelete: g.showDelete && !n.resolved,
+    deleteLabel: d("comments.deleteThread"),
+    extras: a.threadActions,
+    context: N,
+    onDelete: () => {
+      w({
+        type: "delete-thread",
+        threadId: n.threadId,
+        address: n.address
+      }).then(x).catch(() => r(d("comments.saveError")));
+    }
+  });
+  return /* @__PURE__ */ o(
+    "div",
+    {
+      "data-iv-comments-summary": "",
+      "data-slot": "comments-summary",
+      className: I("relative flex items-start rounded-2xl", u && "bg-brand-tint"),
+      children: [
+        /* @__PURE__ */ o(
+          "button",
+          {
+            type: "button",
+            className: "flex min-w-0 flex-1 flex-col items-start gap-3 p-4 pr-16 text-left",
+            "aria-current": u ? "true" : void 0,
+            onClick: () => T(n.address, n.threadId),
+            children: [
+              /* @__PURE__ */ o("div", { className: "flex min-w-0 items-center gap-3", children: [
+                a.renderAvatar ? a.renderAvatar({ author: m }) : /* @__PURE__ */ t(ce, { size: "sm", shape: "square", className: _e, children: /* @__PURE__ */ t(me, { className: I("text-sm font-extrabold", Me(m)), children: De(m) }) }),
+                /* @__PURE__ */ o("div", { className: "min-w-0", children: [
+                  /* @__PURE__ */ t("p", { className: "truncate text-sm font-semibold leading-[21px] text-content-secondary", children: m }),
+                  n.updatedAt ? /* @__PURE__ */ t("p", { className: "text-xs font-medium leading-4 text-content-tertiary", children: Re(n.updatedAt, i) }) : null
+                ] })
+              ] }),
+              /* @__PURE__ */ t("p", { className: "line-clamp-3 text-sm font-medium leading-5 text-content", children: n.preview }),
+              b > 0 && !n.resolved ? /* @__PURE__ */ t("span", { className: "text-sm font-medium leading-5 text-brand", children: d("comments.replies", { count: b }) }) : null
+            ]
+          }
+        ),
+        /* @__PURE__ */ o("div", { className: "absolute right-2 top-3 flex items-center", children: [
+          /* @__PURE__ */ t(
+            Le,
+            {
+              label: d("comments.threadActions"),
+              items: l,
+              align: "end",
+              render: a.renderThreadActions ? (S) => a.renderThreadActions({ items: S, context: N }) : void 0
+            }
+          ),
+          g.showResolve ? /* @__PURE__ */ t(
+            J,
+            {
+              type: "button",
+              size: "iconSm",
+              variant: "ghost",
+              className: I(n.resolved && "text-success"),
+              "aria-label": n.resolved ? d("comments.unresolve") : d("comments.resolve"),
+              onClick: () => {
+                w({
+                  type: "resolve",
+                  threadId: n.threadId,
+                  address: n.address,
+                  resolved: !n.resolved
+                }).then(x).catch(() => r(d("comments.saveError")));
+              },
+              children: n.resolved ? /* @__PURE__ */ t(Se, {}) : /* @__PURE__ */ t(ye, {})
+            }
+          ) : null
+        ] })
+      ]
+    }
+  );
+}
+function rt({
+  open: n,
+  onOpenChange: u,
+  config: a,
+  onSelect: w,
+  status: T,
+  locating: x = !1
+}) {
+  const { t: r } = Y(), d = ie(null), [i, h] = c([]), [g, b] = c(), [m, N] = c(!1), [l, S] = c({}), [f, P] = c(""), [A, z] = c(!1), [D, p] = c(null), [Z, G] = c(null), [M, W] = c(0), [X, ee] = c(!1), [R, te] = c(null), C = a.getSummaries, ne = a.persist, le = n ? `${JSON.stringify(l)}:${M}` : null, y = !!(n && le !== Z && !D), k = !!l.text || l.resolved !== void 0, re = !X || k, _ = !y && i.length === 0 && !k, B = !y && i.length === 0 && k, se = m || i.length > Ee;
+  $(() => {
+    if (!n || !C) return;
+    let e = !1;
+    const s = `${JSON.stringify(l)}:${M}`;
+    return C({ limit: U, query: l }).then((v) => {
+      e || (h([...v.items]), b(v.nextCursor), N(!!v.nextCursor), G(s), p(null), !l.text && l.resolved === void 0 && ee(v.items.length === 0));
+    }).catch(() => {
+      e || p(r("comments.loadError"));
+    }), () => {
+      e = !0;
+    };
+  }, [C, n, l, M, r]), $(() => {
+    if (!n) return;
+    const e = f.trim() || void 0;
+    if (e === l.text) return;
+    const s = window.setTimeout(() => {
+      h([]), p(null), S((v) => ({ ...v, text: e }));
+    }, 250);
+    return () => window.clearTimeout(s);
+  }, [n, l.text, f]);
+  const E = (e) => {
+    h([]), p(null), S(e);
+  }, oe = () => {
+    h([]), p(null), W((e) => e + 1);
+  }, L = de({
+    scrollElementRef: d,
+    rowCount: i.length,
+    getRowId: (e) => i[e]?.threadId ?? String(e),
+    getRowData: (e) => i[e],
+    estimateSize: () => 156,
+    hasMore: m,
+    onEndReached: () => {
+      !C || !m || !g || A || (z(!0), C({ cursor: g, limit: U, query: l }).then((e) => {
+        h((s) => [...s, ...e.items]), b(e.nextCursor), N(!!e.nextCursor);
+      }).catch(() => p(r("comments.loadError"))).finally(() => z(!1)));
+    }
+  }), ae = (e, s) => {
+    te(s), w(e, s);
+  }, O = (e) => /* @__PURE__ */ t(
+    Be,
+    {
+      summary: e,
+      selected: e.threadId === R,
+      config: a,
+      persist: ne,
+      onSelect: ae,
+      onReload: oe,
+      onError: p
+    }
+  );
+  return /* @__PURE__ */ t(he, { open: n, onOpenChange: u, children: /* @__PURE__ */ t(pe, { children: /* @__PURE__ */ o("div", { "data-iv-comments-panel": "", "data-slot": "comments-panel", className: "flex h-full min-h-0 flex-1 flex-col", children: [
+    /* @__PURE__ */ t(ue, { title: r("comments.panelTitle") }),
+    /* @__PURE__ */ o(xe, { children: [
+      re ? /* @__PURE__ */ o(fe, { className: "flex items-center gap-3 px-3 pb-2", children: [
+        /* @__PURE__ */ t("div", { className: "min-w-0 flex-1", children: /* @__PURE__ */ t(
+          ve,
+          {
+            value: f,
+            prefix: /* @__PURE__ */ t(we, { className: "size-4" }),
+            suffix: f ? /* @__PURE__ */ t(Ce, { className: "size-3.5", "aria-hidden": !0 }) : void 0,
+            suffixClick: f ? () => {
+              P(""), E({ ...l, text: void 0 });
+            } : void 0,
+            placeholder: r("comments.searchPlaceholder"),
+            "aria-label": r("comments.searchPlaceholder"),
+            onChange: (e) => P(e.target.value),
+            onKeyDown: (e) => {
+              e.key === "Enter" && E({ ...l, text: f.trim() || void 0 });
+            }
+          }
+        ) }),
+        /* @__PURE__ */ o(ge, { children: [
+          /* @__PURE__ */ t(be, { asChild: !0, children: /* @__PURE__ */ t(J, { type: "button", size: "icon", variant: "tertiary", "aria-label": r("comments.filterComments"), children: /* @__PURE__ */ t(Te, {}) }) }),
+          /* @__PURE__ */ o(Ne, { align: "end", children: [
+            /* @__PURE__ */ t(q, { onSelect: () => E({ resolved: !1, text: l.text }), children: r("comments.filterUnresolved") }),
+            /* @__PURE__ */ t(q, { onSelect: () => E({ resolved: !0, text: l.text }), children: r("comments.filterResolved") })
+          ] })
+        ] })
+      ] }) : null,
+      D ? /* @__PURE__ */ t("p", { role: "alert", className: "px-3 text-sm text-destructive", children: D }) : null,
+      T ? /* @__PURE__ */ t("p", { role: "status", "data-iv-comments-panel-status": "", className: "px-3 pb-2 text-sm text-content-secondary", children: T }) : null,
+      _ ? /* @__PURE__ */ o(F, { className: V, "data-iv-comments-panel-empty": "", children: [
+        /* @__PURE__ */ t(K, { width: 89, height: 70, className: "mb-0 after:hidden", children: /* @__PURE__ */ t(ze, { alt: "", className: "size-full", style: { width: 89, height: 70 } }) }),
+        /* @__PURE__ */ o("div", { className: "flex flex-col items-center gap-[3px] text-center", children: [
+          /* @__PURE__ */ t(H, { headingLevel: 3, className: "text-sm font-bold leading-[21px] tracking-normal", children: r("comments.emptyPanelTitle") }),
+          /* @__PURE__ */ t(Q, { className: "mt-0 max-w-[284px] text-[10px] font-medium leading-[14px] text-content-tertiary", children: r("comments.emptyPanelDescription") })
+        ] })
+      ] }) : null,
+      B ? /* @__PURE__ */ o(F, { className: V, "data-iv-comments-panel-no-results": "", children: [
+        /* @__PURE__ */ t(
+          K,
+          {
+            src: Pe,
+            alt: "",
+            width: 96,
+            height: 95,
+            className: "mb-2.5 after:hidden"
+          }
+        ),
+        /* @__PURE__ */ t(H, { headingLevel: 3, className: "text-sm font-bold leading-[21px] tracking-normal", children: r("comments.noResultsTitle") }),
+        /* @__PURE__ */ t(Q, { className: "mt-0.5 max-w-[284px] text-[10px] font-medium leading-[14px] text-content-tertiary", children: r("comments.noResultsDescription", { query: l.text ?? "" }) })
+      ] }) : null,
+      !_ && !B ? /* @__PURE__ */ o(
+        "div",
+        {
+          ref: d,
+          "data-iv-comments-panel-list": "",
+          "aria-busy": x || y || A || void 0,
+          "data-iv-comments-panel-locating": x ? "" : void 0,
+          className: I("min-h-0 flex-1 overflow-auto px-3 pb-3 pt-2", x && "pointer-events-none"),
+          children: [
+            se ? /* @__PURE__ */ t("div", { style: { height: L.totalSize, position: "relative" }, children: L.virtualItems.map((e) => {
+              const s = i[e.index];
+              return s ? /* @__PURE__ */ t(
+                "div",
+                {
+                  ref: L.measureElement,
+                  "data-index": e.index,
+                  className: j(
+                    e.index,
+                    i.length,
+                    s.threadId === R
+                  ),
+                  style: {
+                    position: "absolute",
+                    top: 0,
+                    left: 0,
+                    width: "100%",
+                    transform: `translateY(${e.start}px)`
+                  },
+                  children: O(s)
+                },
+                s.threadId
+              ) : null;
+            }) }) : i.map((e, s) => /* @__PURE__ */ t(
+              "div",
+              {
+                className: j(s, i.length, e.threadId === R),
+                children: O(e)
+              },
+              e.threadId
+            )),
+            y || A ? /* @__PURE__ */ t("p", { "aria-busy": "true", children: r("comments.loading") }) : null
+          ]
+        }
+      ) : null
+    ] })
+  ] }) }) });
+}
+export {
+  rt as CommentsPanel
+};

package/dist/components/data/ag-grid-react/comments/comments-persist.d.ts

@@ -0,0 +1,11 @@
+import { ThreadGenerationMap } from './comments-generation';
+import { CommentsRefreshApi } from './comments-ag-grid-presence';
+import { CommentsPersistEvent, ThreadId } from './comments.types';
+export declare function isCommentsConflictError(error: unknown): boolean;
+export declare function commitCommentsPersist(args: {
+    persist: (event: CommentsPersistEvent) => Promise<void>;
+    event: CommentsPersistEvent;
+    generations: ThreadGenerationMap;
+    threadId: ThreadId;
+    api: CommentsRefreshApi;
+}): Promise<"applied" | "stale" | "failed" | "conflict" | "rejected">;

package/dist/components/data/ag-grid-react/comments/comments-persist.js

@@ -0,0 +1,19 @@
+import { isValidCommentMessageText as i } from "./comments-identity.js";
+import { refreshCommentsPresence as r } from "./comments-ag-grid-presence.js";
+function s(e) {
+  return typeof e == "object" && e !== null && "status" in e && e.status === 409;
+}
+async function d(e) {
+  if ((e.event.type === "add-message" || e.event.type === "edit-message") && !i(e.event.message.text))
+    return "rejected";
+  const t = e.generations.next(e.threadId);
+  try {
+    return await e.persist(e.event), e.generations.isCurrent(e.threadId, t) ? (r(e.api, e.event.address), "applied") : "stale";
+  } catch (n) {
+    return e.generations.isCurrent(e.threadId, t) ? s(n) ? "conflict" : "failed" : "stale";
+  }
+}
+export {
+  d as commitCommentsPersist,
+  s as isCommentsConflictError
+};

package/dist/components/data/ag-grid-react/comments/comments-reveal.d.ts

@@ -0,0 +1,11 @@
+import { CellAddress, CommentsLocateResult } from './comments.types';
+import { GridRowRevealApi } from '../grid-row-reveal';
+export type CommentsGridRevealApi = GridRowRevealApi & {
+    ensureColumnVisible: (key: string, position?: "auto" | "start" | "middle" | "end") => void;
+};
+export type RevealCommentCellOptions = {
+    locateRow?: (address: CellAddress) => Promise<CommentsLocateResult>;
+    pagination?: boolean;
+};
+export declare function revealCommentCell(gridApi: CommentsGridRevealApi | null | undefined, address: CellAddress, options?: RevealCommentCellOptions): Promise<"revealed" | "missing">;
+export declare function waitForCommentCell(container: HTMLElement | null, address: CellAddress, frames?: number): Promise<HTMLElement | null>;

package/dist/components/data/ag-grid-react/comments/comments-reveal.js

@@ -0,0 +1,31 @@
+import { revealGridRow as c } from "../grid-row-reveal.js";
+import { cellElementFromAddress as a } from "../grid-cell-address.js";
+async function s(r, e, t) {
+  const o = t?.locateRow;
+  return await c(r, e.rowId, {
+    pagination: t?.pagination,
+    colId: e.colId,
+    locateRow: o ? (n) => o({ rowId: n, colId: e.colId }) : void 0
+  }) === "revealed" ? "revealed" : "missing";
+}
+function w(r, e, t = 24) {
+  return new Promise((o) => {
+    const i = (n) => {
+      const l = a(r, e);
+      if (l || n <= 0) {
+        o(l);
+        return;
+      }
+      if (typeof requestAnimationFrame == "function") {
+        requestAnimationFrame(() => i(n - 1));
+        return;
+      }
+      o(l);
+    };
+    i(t);
+  });
+}
+export {
+  s as revealCommentCell,
+  w as waitForCommentCell
+};

package/dist/components/data/ag-grid-react/comments/comments-ui-actions.d.ts

@@ -0,0 +1,18 @@
+import { CommentMenuItem, CommentMessageActionContext, CommentThreadActionContext, CommentUiAction } from './comments.types';
+export declare function buildCommentMessageMenuItems(args: {
+    showEdit: boolean;
+    showDelete: boolean;
+    editLabel: string;
+    deleteLabel: string;
+    extras?: readonly CommentUiAction<CommentMessageActionContext>[];
+    context: CommentMessageActionContext;
+    onEdit: () => void;
+    onDelete: () => void;
+}): CommentMenuItem[];
+export declare function buildCommentThreadMenuItems(args: {
+    showDelete: boolean;
+    deleteLabel: string;
+    extras?: readonly CommentUiAction<CommentThreadActionContext>[];
+    context: CommentThreadActionContext;
+    onDelete: () => void;
+}): CommentMenuItem[];

package/dist/components/data/ag-grid-react/comments/comments-ui-actions.js

@@ -0,0 +1,22 @@
+function d(e) {
+  const t = [];
+  return e.showEdit && t.push({ id: "edit", label: e.editLabel, onSelect: e.onEdit }), e.showDelete && t.push({ id: "delete", label: e.deleteLabel, onSelect: e.onDelete }), n(t, e.extras, e.context), t;
+}
+function i(e) {
+  const t = [];
+  return e.showDelete && t.push({ id: "delete-thread", label: e.deleteLabel, onSelect: e.onDelete }), n(t, e.extras, e.context), t;
+}
+function n(e, t, o) {
+  if (t)
+    for (const l of t)
+      e.push({
+        id: l.id,
+        label: l.label,
+        disabled: l.disabled,
+        onSelect: () => l.onSelect(o)
+      });
+}
+export {
+  d as buildCommentMessageMenuItems,
+  i as buildCommentThreadMenuItems
+};

package/dist/components/data/ag-grid-react/comments/comments-window.d.ts

@@ -0,0 +1,10 @@
+import { CellCommentThread, CommentMessage, CommentsThreadPageRequest } from './comments.types';
+export type CommentsThreadWindow = {
+    messages: CommentMessage[];
+    hasMoreOlder: boolean;
+    hiddenCount: number;
+    messageCount: number;
+};
+export declare function commentsThreadPageRequest(purpose: CommentsThreadPageRequest["purpose"], before?: string): CommentsThreadPageRequest;
+export declare function selectCommentThreadWindow(messages: readonly CommentMessage[], request: CommentsThreadPageRequest): CommentsThreadWindow;
+export declare function boundLoadedThread(thread: CellCommentThread, request: CommentsThreadPageRequest): CellCommentThread;

package/dist/components/data/ag-grid-react/comments/comments-window.js

@@ -0,0 +1,62 @@
+import { COMMENTS_PREVIEW_VISIBLE as r, commentPreviewSlice as l } from "./comments-format.js";
+import { COMMENTS_THREAD_PAGE_SIZE as a } from "./comments-constants.js";
+function C(e, n) {
+  return {
+    purpose: e,
+    limit: e === "preview" ? r : a,
+    before: n
+  };
+}
+function m(e, n) {
+  const d = e.length;
+  if (n.purpose === "preview") {
+    const s = l(e);
+    return s.kind === "all" ? { messages: [...s.messages], hasMoreOlder: !1, hiddenCount: 0, messageCount: d } : {
+      messages: [...s.head, ...s.tail],
+      hasMoreOlder: s.hiddenCount > 0,
+      hiddenCount: s.hiddenCount,
+      messageCount: d
+    };
+  }
+  if (n.before) {
+    const s = e.findIndex((t) => t.id === n.before);
+    if (s <= 0)
+      return { messages: [], hasMoreOlder: !1, hiddenCount: 0, messageCount: d };
+    const i = Math.max(0, s - n.limit);
+    return {
+      messages: e.slice(i, s),
+      hasMoreOlder: i > 0,
+      hiddenCount: i,
+      messageCount: d
+    };
+  }
+  const o = Math.max(0, d - n.limit);
+  return {
+    messages: e.slice(o),
+    hasMoreOlder: o > 0,
+    hiddenCount: o,
+    messageCount: d
+  };
+}
+function c(e, n) {
+  if (e.messages.length <= n.limit && (e.hasMoreOlder != null || e.hiddenCount != null || e.messageCount != null))
+    return {
+      ...e,
+      hasMoreOlder: e.hasMoreOlder ?? !1,
+      hiddenCount: e.hiddenCount ?? 0,
+      messageCount: e.messageCount ?? e.messages.length
+    };
+  const o = m(e.messages, n);
+  return {
+    ...e,
+    messages: o.messages,
+    hasMoreOlder: o.hasMoreOlder,
+    hiddenCount: o.hiddenCount,
+    messageCount: o.messageCount
+  };
+}
+export {
+  c as boundLoadedThread,
+  C as commentsThreadPageRequest,
+  m as selectCommentThreadWindow
+};

package/dist/components/data/ag-grid-react/comments/comments.types.d.ts

@@ -0,0 +1,178 @@
+import { ReactNode } from 'react';
+import { GridCellAddress } from '../grid-cell-address';
+export type ThreadId = string;
+/** Logical grid cell. Shared identity — not Comment-specific. */
+export type CellAddress = GridCellAddress;
+export type CommentMessage = {
+    id: string;
+    text: string;
+    author: string;
+    createdAt: string;
+    updatedAt?: string;
+};
+export type CellCommentThread = {
+    threadId: ThreadId;
+    address: CellAddress;
+    messages: CommentMessage[];
+    resolved: boolean;
+    /** Older history exists beyond `messages`. Omit when the window is the full thread. */
+    hasMoreOlder?: boolean;
+    /** Messages not in this window (older and/or collapsed preview middle). */
+    hiddenCount?: number;
+    /** Total messages in the thread when known. */
+    messageCount?: number;
+};
+export type CellCommentSummary = {
+    threadId: ThreadId;
+    address: CellAddress;
+    preview: string;
+    author?: string;
+    updatedAt?: string;
+    resolved: boolean;
+    messageCount: number;
+};
+/** Result of locating a commented row that is not in the current grid model. */
+export type CommentsLocateResult = {
+    status: "ready";
+    rowIndex?: number;
+} | {
+    status: "missing";
+};
+export type CommentsCapabilities = {
+    canView: boolean;
+    canCreate: boolean;
+    canReply: boolean;
+    canEdit: boolean;
+    canDelete: boolean;
+    canResolve: boolean;
+};
+export type CommentsPersistEvent = {
+    type: "add-message";
+    threadId: ThreadId;
+    address: CellAddress;
+    message: CommentMessage;
+} | {
+    type: "edit-message";
+    threadId: ThreadId;
+    address: CellAddress;
+    message: CommentMessage;
+} | {
+    type: "delete-message";
+    threadId: ThreadId;
+    address: CellAddress;
+    messageId: string;
+} | {
+    type: "delete-thread";
+    threadId: ThreadId;
+    address: CellAddress;
+} | {
+    type: "resolve";
+    threadId: ThreadId;
+    address: CellAddress;
+    resolved: boolean;
+};
+export type CommentsSummaryPageRequest = {
+    cursor?: string;
+    limit: number;
+    query?: {
+        resolved?: boolean;
+        text?: string;
+    };
+};
+export type CommentsSummaryPage = {
+    items: readonly CellCommentSummary[];
+    nextCursor?: string;
+};
+export type CommentsThreadPageRequest = {
+    purpose: "preview" | "page";
+    limit: number;
+    /** Oldest message id currently loaded; return the page older than this. */
+    before?: string;
+};
+export type DataTableCommentsConfig = {
+    hasIndicator: (address: CellAddress) => boolean;
+    getThreadId?: (address: CellAddress) => ThreadId;
+    /**
+     * Load the active thread. Optional `request` asks for a bounded window
+     * (newest page, older page, or hover preview). Extra arg is ignored by
+     * existing `(threadId, address) => thread` adapters; the host still windows
+     * oversized payloads before render.
+     */
+    loadThread: (threadId: ThreadId, address: CellAddress, request?: CommentsThreadPageRequest) => Promise<CellCommentThread | undefined>;
+    persist: (event: CommentsPersistEvent) => Promise<void>;
+    getAuthor: () => string;
+    getCapabilities?: (address: CellAddress) => CommentsCapabilities;
+    getSummaries?: (request: CommentsSummaryPageRequest) => Promise<CommentsSummaryPage>;
+    /**
+     * Load a commented row that is not in the current grid model (SSRM block,
+     * infinite row, or app-replaced `rowData` page). Identity stays `{ rowId, colId }`.
+     * Return `{ status: "ready", rowIndex }` so the host can `paginationGoToPage`
+     * from the **live** index, then `ensureIndexVisible`. Do not persist page numbers.
+     * Omit when every commented row is already in client-side `rowData`.
+     */
+    locateRow?: (address: CellAddress) => Promise<CommentsLocateResult>;
+    commentMode?: boolean;
+    onCommentModeChange?: (on: boolean) => void;
+    previewOnHover?: boolean;
+    /**
+     * Extra items after Edit/Delete on the message `…` menu.
+     * Omit for the default menu. Does not replace Edit/Delete.
+     */
+    messageActions?: readonly CommentUiAction<CommentMessageActionContext>[];
+    /**
+     * Extra items after Delete thread on overlay and panel `…` menus.
+     * Omit for the default menu.
+     */
+    threadActions?: readonly CommentUiAction<CommentThreadActionContext>[];
+    /** Replace the author glyph. Overlay/panel only — never per cell. */
+    renderAvatar?: (props: {
+        author: string;
+    }) => ReactNode;
+    /** Replace message text rendering (markdown, links, …). */
+    renderMessageBody?: (props: {
+        message: CommentMessage;
+    }) => ReactNode;
+    /** Replace the reply box. Host still owns draft state and persist. */
+    renderComposer?: (props: CommentComposerRenderProps) => ReactNode;
+    /** Replace the message `…` menu. `items` is Edit/Delete plus `messageActions`. */
+    renderMessageActions?: (props: {
+        items: CommentMenuItem[];
+        context: CommentMessageActionContext;
+    }) => ReactNode;
+    /** Replace the thread `…` menu. `items` is Delete thread plus `threadActions`. */
+    renderThreadActions?: (props: {
+        items: CommentMenuItem[];
+        context: CommentThreadActionContext;
+    }) => ReactNode;
+};
+export type CommentMenuItem = {
+    id: string;
+    label: string;
+    disabled?: boolean;
+    onSelect: () => void;
+};
+export type CommentUiAction<TContext> = {
+    id: string;
+    label: string;
+    disabled?: boolean;
+    onSelect: (context: TContext) => void;
+};
+export type CommentMessageActionContext = {
+    address: CellAddress;
+    threadId: ThreadId;
+    resolved: boolean;
+    message: CommentMessage;
+};
+export type CommentThreadActionContext = {
+    address: CellAddress;
+    threadId: ThreadId;
+    resolved: boolean;
+};
+export type CommentComposerRenderProps = {
+    value: string;
+    onChange: (value: string) => void;
+    onSave: () => void;
+    disabled: boolean;
+    saving: boolean;
+    author: string;
+};

package/dist/components/data/ag-grid-react/comments/index.d.ts

@@ -0,0 +1,5 @@
+export type { CellAddress, CellCommentSummary, CellCommentThread, CommentComposerRenderProps, CommentMenuItem, CommentMessage, CommentMessageActionContext, CommentThreadActionContext, CommentUiAction, CommentsCapabilities, CommentsLocateResult, CommentsPersistEvent, CommentsSummaryPage, CommentsSummaryPageRequest, CommentsThreadPageRequest, DataTableCommentsConfig, ThreadId, } from './comments.types';
+export { defaultGetThreadId, mintCommentMessageId, THREAD_ID_SEPARATOR } from './comments-identity';
+export { boundLoadedThread, commentsThreadPageRequest, selectCommentThreadWindow, } from './comments-window';
+export { COMMENTS_THREAD_PAGE_SIZE, COMMENTS_PANEL_PAGE_SIZE } from './comments-constants';
+export { CommentModeToggle, type CommentModeToggleProps } from './comment-mode-toggle';

package/dist/components/data/ag-grid-react/comments/index.js

@@ -0,0 +1,15 @@
+import { THREAD_ID_SEPARATOR as m, defaultGetThreadId as t, mintCommentMessageId as d } from "./comments-identity.js";
+import { boundLoadedThread as E, commentsThreadPageRequest as T, selectCommentThreadWindow as a } from "./comments-window.js";
+import { COMMENTS_PANEL_PAGE_SIZE as n, COMMENTS_THREAD_PAGE_SIZE as A } from "./comments-constants.js";
+import { CommentModeToggle as f } from "./comment-mode-toggle.js";
+export {
+  n as COMMENTS_PANEL_PAGE_SIZE,
+  A as COMMENTS_THREAD_PAGE_SIZE,
+  f as CommentModeToggle,
+  m as THREAD_ID_SEPARATOR,
+  E as boundLoadedThread,
+  T as commentsThreadPageRequest,
+  t as defaultGetThreadId,
+  d as mintCommentMessageId,
+  a as selectCommentThreadWindow
+};