@flanksource/clicky-ui 0.3.25 → 0.3.27

package/dist/comments/CommentProvider.cjs

@@ -13,6 +13,7 @@ function CommentProvider({
   onCreate,
   onReply,
   onUpdateStatus,
+  onUpdateRating,
   onDelete,
   onChecklistToggle,
   onMention
@@ -72,19 +73,16 @@ function CommentProvider({
     },
     []
   );
-  const getAnchorTop = react.useCallback(
-    (anchor) => {
-      const resolved = resolveAnchorRef.current(
-        anchor,
-        Object.keys(anchorEls.current)
-      );
-      const el = resolved ? anchorEls.current[resolved] : null;
-      const container = contentRef.current;
-      if (!el || !container) return null;
-      return el.getBoundingClientRect().top - container.getBoundingClientRect().top;
-    },
-    []
-  );
+  const getAnchorTop = react.useCallback((anchor) => {
+    const resolved = resolveAnchorRef.current(
+      anchor,
+      Object.keys(anchorEls.current)
+    );
+    const el = resolved ? anchorEls.current[resolved] : null;
+    const container = contentRef.current;
+    if (!el || !container) return null;
+    return el.getBoundingClientRect().top - container.getBoundingClientRect().top;
+  }, []);
   const scrollToAnchor = react.useCallback(
     (anchor, options = {}) => {
       const resolved = resolveAnchorRef.current(
@@ -114,11 +112,20 @@ function CommentProvider({
       ...onCreate ? { onCreate } : {},
       ...onReply ? { onReply } : {},
       ...onUpdateStatus ? { onUpdateStatus } : {},
+      ...onUpdateRating ? { onUpdateRating } : {},
       ...onDelete ? { onDelete } : {},
       ...onChecklistToggle ? { onChecklistToggle } : {},
       ...onMention ? { onMention } : {}
     }),
-    [onCreate, onReply, onUpdateStatus, onDelete, onChecklistToggle, onMention]
+    [
+      onCreate,
+      onReply,
+      onUpdateStatus,
+      onUpdateRating,
+      onDelete,
+      onChecklistToggle,
+      onMention
+    ]
   );
   react.useLayoutEffect(() => {
     anchorStore.update(commentMeta, railMode, focusedAnchor, highlightAnchor);

package/dist/comments/CommentProvider.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"CommentProvider.cjs","sources":["../../src/comments/CommentProvider.tsx"],"sourcesContent":["import {\n  useCallback,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from \"react\";\nimport { deriveAnchorCounts, deriveAnchorMeta } from \"./comment-utils\";\nimport {\n  CommentContext,\n  CommentAnchorActionsContext,\n  CommentAnchorStoreContext,\n  createCommentAnchorStore,\n  exactAnchorResolver,\n  type AnchorResolver,\n  type CommentAnchorActions,\n  type CommentContextValue,\n  type CommentRailMode,\n  type CommentScrollOptions,\n} from \"./comment-context\";\nimport {\n  type Comment,\n  type CommentAnchor,\n  type CommentCallbacks,\n  type CommentConfig,\n} from \"./comment-types\";\n\nexport type CommentProviderProps = CommentCallbacks & {\n  children: ReactNode;\n  /** All comments for the document; counts and metadata are derived from these. */\n  comments: Comment[];\n  config: CommentConfig;\n  /** Strategy to map a requested anchor onto a registered one. Defaults to exact. */\n  resolveAnchor?: AnchorResolver;\n  /** Reports rail actions so a host can synchronize external visibility state. */\n  onRailModeChange?: (mode: CommentRailMode) => void;\n};\n\n/**\n * Supplies comment state to a document subtree: derived per-anchor counts and\n * metadata, rail open/focus state, and a generic anchor registry (cells call\n * `registerAnchor` so the side panel can scroll-align to them). Owns no\n * fetching — `comments` and the callbacks are controlled by the consumer.\n */\nexport function CommentProvider({\n  children,\n  comments,\n  config,\n  resolveAnchor = exactAnchorResolver,\n  onRailModeChange,\n  onCreate,\n  onReply,\n  onUpdateStatus,\n  onDelete,\n  onChecklistToggle,\n  onMention,\n}: CommentProviderProps) {\n  const [railMode, setRailMode] = useState<CommentRailMode>(\"closed\");\n  const [focusedAnchor, setFocusedAnchor] = useState<CommentAnchor | null>(\n    null,\n  );\n  const [highlightAnchor, setHighlightAnchor] = useState<CommentAnchor | null>(\n    null,\n  );\n  const railModeRef = useRef<CommentRailMode>(\"closed\");\n  const onRailModeChangeRef = useRef(onRailModeChange);\n  const resolveAnchorRef = useRef(resolveAnchor);\n  const anchorEls = useRef<Record<string, HTMLElement>>({});\n  const contentRef = useRef<HTMLDivElement | null>(null);\n\n  const commentCounts = useMemo(() => deriveAnchorCounts(comments), [comments]);\n  const commentMeta = useMemo(() => deriveAnchorMeta(comments), [comments]);\n  const [anchorStore] = useState(createCommentAnchorStore);\n\n  useLayoutEffect(() => {\n    onRailModeChangeRef.current = onRailModeChange;\n    resolveAnchorRef.current = resolveAnchor;\n  }, [onRailModeChange, resolveAnchor]);\n\n  const focusAnchor = useCallback((anchor: CommentAnchor) => {\n    setFocusedAnchor(anchor);\n    railModeRef.current = \"focused\";\n    setRailMode(\"focused\");\n    onRailModeChangeRef.current?.(\"focused\");\n  }, []);\n\n  const openCommentList = useCallback(() => {\n    const next = railModeRef.current === \"all\" ? \"closed\" : \"all\";\n    railModeRef.current = next;\n    setRailMode(next);\n    onRailModeChangeRef.current?.(next);\n  }, []);\n\n  const closeRail = useCallback(() => {\n    railModeRef.current = \"closed\";\n    setRailMode(\"closed\");\n    onRailModeChangeRef.current?.(\"closed\");\n  }, []);\n\n  const registerAnchor = useCallback(\n    (anchor: CommentAnchor, el: HTMLElement | null) => {\n      if (!el) {\n        delete anchorEls.current[anchor];\n        return;\n      }\n      const registered = anchorEls.current[anchor];\n      if (registered && registered !== el) {\n        throw new Error(\n          `Comment anchor \"${anchor}\" is registered by multiple elements`,\n        );\n      }\n      anchorEls.current[anchor] = el;\n    },\n    [],\n  );\n\n  const getAnchorTop = useCallback(\n    (anchor: CommentAnchor): number | null => {\n      const resolved = resolveAnchorRef.current(\n        anchor,\n        Object.keys(anchorEls.current),\n      );\n      const el = resolved ? anchorEls.current[resolved] : null;\n      const container = contentRef.current;\n      if (!el || !container) return null;\n      return (\n        el.getBoundingClientRect().top - container.getBoundingClientRect().top\n      );\n    },\n    [],\n  );\n\n  const scrollToAnchor = useCallback(\n    (anchor: CommentAnchor, options: CommentScrollOptions = {}): boolean => {\n      const resolved = resolveAnchorRef.current(\n        anchor,\n        Object.keys(anchorEls.current),\n      );\n      const el = resolved ? anchorEls.current[resolved] : null;\n      const container = contentRef.current;\n      if (!el || !container) return false;\n      const containerRect = container.getBoundingClientRect();\n      const anchorRect = el.getBoundingClientRect();\n      const offset = options.offset ?? 0;\n      const top =\n        options.block === \"center\"\n          ? container.scrollTop +\n            anchorRect.top -\n            containerRect.top +\n            anchorRect.height / 2 -\n            container.clientHeight / 2 -\n            offset\n          : container.scrollTop + anchorRect.top - containerRect.top - offset;\n      container.scrollTo({\n        top: Math.max(0, top),\n        behavior: options.behavior ?? \"smooth\",\n      });\n      return true;\n    },\n    [],\n  );\n\n  // A focused rail with no anchor selected has nothing to show.\n  useEffect(() => {\n    if (railMode === \"focused\" && !focusedAnchor) closeRail();\n  }, [closeRail, railMode, focusedAnchor]);\n\n  const callbacks = useMemo<CommentCallbacks>(\n    () => ({\n      ...(onCreate ? { onCreate } : {}),\n      ...(onReply ? { onReply } : {}),\n      ...(onUpdateStatus ? { onUpdateStatus } : {}),\n      ...(onDelete ? { onDelete } : {}),\n      ...(onChecklistToggle ? { onChecklistToggle } : {}),\n      ...(onMention ? { onMention } : {}),\n    }),\n    [onCreate, onReply, onUpdateStatus, onDelete, onChecklistToggle, onMention],\n  );\n\n  useLayoutEffect(() => {\n    anchorStore.update(commentMeta, railMode, focusedAnchor, highlightAnchor);\n  }, [anchorStore, commentMeta, railMode, focusedAnchor, highlightAnchor]);\n\n  const [anchorActions] = useState<CommentAnchorActions>(() => ({\n    focusAnchor,\n    registerAnchor,\n    scrollToAnchor,\n    contentRef,\n  }));\n\n  const value = useMemo<CommentContextValue>(\n    () => ({\n      comments,\n      config,\n      callbacks,\n      commentCounts,\n      commentMeta,\n      railMode,\n      focusedAnchor,\n      focusAnchor,\n      openCommentList,\n      closeRail,\n      registerAnchor,\n      getAnchorTop,\n      scrollToAnchor,\n      contentRef,\n      highlightAnchor,\n      setHighlightAnchor,\n    }),\n    [\n      comments,\n      config,\n      callbacks,\n      commentCounts,\n      commentMeta,\n      railMode,\n      focusedAnchor,\n      focusAnchor,\n      openCommentList,\n      closeRail,\n      registerAnchor,\n      getAnchorTop,\n      scrollToAnchor,\n      highlightAnchor,\n    ],\n  );\n\n  return (\n    <CommentAnchorStoreContext.Provider value={anchorStore}>\n      <CommentAnchorActionsContext.Provider value={anchorActions}>\n        <CommentContext.Provider value={value}>{children}</CommentContext.Provider>\n      </CommentAnchorActionsContext.Provider>\n    </CommentAnchorStoreContext.Provider>\n  );\n}\n"],"names":["exactAnchorResolver","useState","useRef","useMemo","deriveAnchorCounts","deriveAnchorMeta","createCommentAnchorStore","useLayoutEffect","useCallback","useEffect","CommentAnchorStoreContext","CommentAnchorActionsContext","CommentContext"],"mappings":"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"}
+{"version":3,"file":"CommentProvider.cjs","sources":["../../src/comments/CommentProvider.tsx"],"sourcesContent":["import {\n  useCallback,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from \"react\";\nimport { deriveAnchorCounts, deriveAnchorMeta } from \"./comment-utils\";\nimport {\n  CommentContext,\n  CommentAnchorActionsContext,\n  CommentAnchorStoreContext,\n  createCommentAnchorStore,\n  exactAnchorResolver,\n  type AnchorResolver,\n  type CommentAnchorActions,\n  type CommentContextValue,\n  type CommentRailMode,\n  type CommentScrollOptions,\n} from \"./comment-context\";\nimport {\n  type Comment,\n  type CommentAnchor,\n  type CommentCallbacks,\n  type CommentConfig,\n} from \"./comment-types\";\n\nexport type CommentProviderProps = CommentCallbacks & {\n  children: ReactNode;\n  /** All comments for the document; counts and metadata are derived from these. */\n  comments: Comment[];\n  config: CommentConfig;\n  /** Strategy to map a requested anchor onto a registered one. Defaults to exact. */\n  resolveAnchor?: AnchorResolver;\n  /** Reports rail actions so a host can synchronize external visibility state. */\n  onRailModeChange?: (mode: CommentRailMode) => void;\n};\n\n/**\n * Supplies comment state to a document subtree: derived per-anchor counts and\n * metadata, rail open/focus state, and a generic anchor registry (cells call\n * `registerAnchor` so the side panel can scroll-align to them). Owns no\n * fetching — `comments` and the callbacks are controlled by the consumer.\n */\nexport function CommentProvider({\n  children,\n  comments,\n  config,\n  resolveAnchor = exactAnchorResolver,\n  onRailModeChange,\n  onCreate,\n  onReply,\n  onUpdateStatus,\n  onUpdateRating,\n  onDelete,\n  onChecklistToggle,\n  onMention,\n}: CommentProviderProps) {\n  const [railMode, setRailMode] = useState<CommentRailMode>(\"closed\");\n  const [focusedAnchor, setFocusedAnchor] = useState<CommentAnchor | null>(\n    null,\n  );\n  const [highlightAnchor, setHighlightAnchor] = useState<CommentAnchor | null>(\n    null,\n  );\n  const railModeRef = useRef<CommentRailMode>(\"closed\");\n  const onRailModeChangeRef = useRef(onRailModeChange);\n  const resolveAnchorRef = useRef(resolveAnchor);\n  const anchorEls = useRef<Record<string, HTMLElement>>({});\n  const contentRef = useRef<HTMLDivElement | null>(null);\n\n  const commentCounts = useMemo(() => deriveAnchorCounts(comments), [comments]);\n  const commentMeta = useMemo(() => deriveAnchorMeta(comments), [comments]);\n  const [anchorStore] = useState(createCommentAnchorStore);\n\n  useLayoutEffect(() => {\n    onRailModeChangeRef.current = onRailModeChange;\n    resolveAnchorRef.current = resolveAnchor;\n  }, [onRailModeChange, resolveAnchor]);\n\n  const focusAnchor = useCallback((anchor: CommentAnchor) => {\n    setFocusedAnchor(anchor);\n    railModeRef.current = \"focused\";\n    setRailMode(\"focused\");\n    onRailModeChangeRef.current?.(\"focused\");\n  }, []);\n\n  const openCommentList = useCallback(() => {\n    const next = railModeRef.current === \"all\" ? \"closed\" : \"all\";\n    railModeRef.current = next;\n    setRailMode(next);\n    onRailModeChangeRef.current?.(next);\n  }, []);\n\n  const closeRail = useCallback(() => {\n    railModeRef.current = \"closed\";\n    setRailMode(\"closed\");\n    onRailModeChangeRef.current?.(\"closed\");\n  }, []);\n\n  const registerAnchor = useCallback(\n    (anchor: CommentAnchor, el: HTMLElement | null) => {\n      if (!el) {\n        delete anchorEls.current[anchor];\n        return;\n      }\n      const registered = anchorEls.current[anchor];\n      if (registered && registered !== el) {\n        throw new Error(\n          `Comment anchor \"${anchor}\" is registered by multiple elements`,\n        );\n      }\n      anchorEls.current[anchor] = el;\n    },\n    [],\n  );\n\n  const getAnchorTop = useCallback((anchor: CommentAnchor): number | null => {\n    const resolved = resolveAnchorRef.current(\n      anchor,\n      Object.keys(anchorEls.current),\n    );\n    const el = resolved ? anchorEls.current[resolved] : null;\n    const container = contentRef.current;\n    if (!el || !container) return null;\n    return (\n      el.getBoundingClientRect().top - container.getBoundingClientRect().top\n    );\n  }, []);\n\n  const scrollToAnchor = useCallback(\n    (anchor: CommentAnchor, options: CommentScrollOptions = {}): boolean => {\n      const resolved = resolveAnchorRef.current(\n        anchor,\n        Object.keys(anchorEls.current),\n      );\n      const el = resolved ? anchorEls.current[resolved] : null;\n      const container = contentRef.current;\n      if (!el || !container) return false;\n      const containerRect = container.getBoundingClientRect();\n      const anchorRect = el.getBoundingClientRect();\n      const offset = options.offset ?? 0;\n      const top =\n        options.block === \"center\"\n          ? container.scrollTop +\n            anchorRect.top -\n            containerRect.top +\n            anchorRect.height / 2 -\n            container.clientHeight / 2 -\n            offset\n          : container.scrollTop + anchorRect.top - containerRect.top - offset;\n      container.scrollTo({\n        top: Math.max(0, top),\n        behavior: options.behavior ?? \"smooth\",\n      });\n      return true;\n    },\n    [],\n  );\n\n  // A focused rail with no anchor selected has nothing to show.\n  useEffect(() => {\n    if (railMode === \"focused\" && !focusedAnchor) closeRail();\n  }, [closeRail, railMode, focusedAnchor]);\n\n  const callbacks = useMemo<CommentCallbacks>(\n    () => ({\n      ...(onCreate ? { onCreate } : {}),\n      ...(onReply ? { onReply } : {}),\n      ...(onUpdateStatus ? { onUpdateStatus } : {}),\n      ...(onUpdateRating ? { onUpdateRating } : {}),\n      ...(onDelete ? { onDelete } : {}),\n      ...(onChecklistToggle ? { onChecklistToggle } : {}),\n      ...(onMention ? { onMention } : {}),\n    }),\n    [\n      onCreate,\n      onReply,\n      onUpdateStatus,\n      onUpdateRating,\n      onDelete,\n      onChecklistToggle,\n      onMention,\n    ],\n  );\n\n  useLayoutEffect(() => {\n    anchorStore.update(commentMeta, railMode, focusedAnchor, highlightAnchor);\n  }, [anchorStore, commentMeta, railMode, focusedAnchor, highlightAnchor]);\n\n  const [anchorActions] = useState<CommentAnchorActions>(() => ({\n    focusAnchor,\n    registerAnchor,\n    scrollToAnchor,\n    contentRef,\n  }));\n\n  const value = useMemo<CommentContextValue>(\n    () => ({\n      comments,\n      config,\n      callbacks,\n      commentCounts,\n      commentMeta,\n      railMode,\n      focusedAnchor,\n      focusAnchor,\n      openCommentList,\n      closeRail,\n      registerAnchor,\n      getAnchorTop,\n      scrollToAnchor,\n      contentRef,\n      highlightAnchor,\n      setHighlightAnchor,\n    }),\n    [\n      comments,\n      config,\n      callbacks,\n      commentCounts,\n      commentMeta,\n      railMode,\n      focusedAnchor,\n      focusAnchor,\n      openCommentList,\n      closeRail,\n      registerAnchor,\n      getAnchorTop,\n      scrollToAnchor,\n      highlightAnchor,\n    ],\n  );\n\n  return (\n    <CommentAnchorStoreContext.Provider value={anchorStore}>\n      <CommentAnchorActionsContext.Provider value={anchorActions}>\n        <CommentContext.Provider value={value}>\n          {children}\n        </CommentContext.Provider>\n      </CommentAnchorActionsContext.Provider>\n    </CommentAnchorStoreContext.Provider>\n  );\n}\n"],"names":["exactAnchorResolver","useState","useRef","useMemo","deriveAnchorCounts","deriveAnchorMeta","createCommentAnchorStore","useLayoutEffect","useCallback","useEffect","CommentAnchorStoreContext","CommentAnchorActionsContext","CommentContext"],"mappings":"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"}

package/dist/comments/CommentProvider.d.ts

@@ -17,5 +17,5 @@ export type CommentProviderProps = CommentCallbacks & {
  * `registerAnchor` so the side panel can scroll-align to them). Owns no
  * fetching — `comments` and the callbacks are controlled by the consumer.
  */
-export declare function CommentProvider({ children, comments, config, resolveAnchor, onRailModeChange, onCreate, onReply, onUpdateStatus, onDelete, onChecklistToggle, onMention, }: CommentProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function CommentProvider({ children, comments, config, resolveAnchor, onRailModeChange, onCreate, onReply, onUpdateStatus, onUpdateRating, onDelete, onChecklistToggle, onMention, }: CommentProviderProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=CommentProvider.d.ts.map

package/dist/comments/CommentProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CommentProvider.d.ts","sourceRoot":"","sources":["../../src/comments/CommentProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,EAML,KAAK,cAAc,EAGnB,KAAK,eAAe,EAErB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,OAAO,EAEZ,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG;IACpD,QAAQ,EAAE,SAAS,CAAC;IACpB,iFAAiF;IACjF,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,mFAAmF;IACnF,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;CACpD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,aAAmC,EACnC,gBAAgB,EAChB,QAAQ,EACR,OAAO,EACP,cAAc,EACd,QAAQ,EACR,iBAAiB,EACjB,SAAS,GACV,EAAE,oBAAoB,2CAkLtB"}
+{"version":3,"file":"CommentProvider.d.ts","sourceRoot":"","sources":["../../src/comments/CommentProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,EAML,KAAK,cAAc,EAGnB,KAAK,eAAe,EAErB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,OAAO,EAEZ,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG;IACpD,QAAQ,EAAE,SAAS,CAAC;IACpB,iFAAiF;IACjF,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,mFAAmF;IACnF,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;CACpD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,aAAmC,EACnC,gBAAgB,EAChB,QAAQ,EACR,OAAO,EACP,cAAc,EACd,cAAc,EACd,QAAQ,EACR,iBAAiB,EACjB,SAAS,GACV,EAAE,oBAAoB,2CA0LtB"}

package/dist/comments/CommentProvider.js

@@ -11,6 +11,7 @@ function CommentProvider({
   onCreate,
   onReply,
   onUpdateStatus,
+  onUpdateRating,
   onDelete,
   onChecklistToggle,
   onMention
@@ -70,19 +71,16 @@ function CommentProvider({
     },
     []
   );
-  const getAnchorTop = useCallback(
-    (anchor) => {
-      const resolved = resolveAnchorRef.current(
-        anchor,
-        Object.keys(anchorEls.current)
-      );
-      const el = resolved ? anchorEls.current[resolved] : null;
-      const container = contentRef.current;
-      if (!el || !container) return null;
-      return el.getBoundingClientRect().top - container.getBoundingClientRect().top;
-    },
-    []
-  );
+  const getAnchorTop = useCallback((anchor) => {
+    const resolved = resolveAnchorRef.current(
+      anchor,
+      Object.keys(anchorEls.current)
+    );
+    const el = resolved ? anchorEls.current[resolved] : null;
+    const container = contentRef.current;
+    if (!el || !container) return null;
+    return el.getBoundingClientRect().top - container.getBoundingClientRect().top;
+  }, []);
   const scrollToAnchor = useCallback(
     (anchor, options = {}) => {
       const resolved = resolveAnchorRef.current(
@@ -112,11 +110,20 @@ function CommentProvider({
       ...onCreate ? { onCreate } : {},
       ...onReply ? { onReply } : {},
       ...onUpdateStatus ? { onUpdateStatus } : {},
+      ...onUpdateRating ? { onUpdateRating } : {},
       ...onDelete ? { onDelete } : {},
       ...onChecklistToggle ? { onChecklistToggle } : {},
       ...onMention ? { onMention } : {}
     }),
-    [onCreate, onReply, onUpdateStatus, onDelete, onChecklistToggle, onMention]
+    [
+      onCreate,
+      onReply,
+      onUpdateStatus,
+      onUpdateRating,
+      onDelete,
+      onChecklistToggle,
+      onMention
+    ]
   );
   useLayoutEffect(() => {
     anchorStore.update(commentMeta, railMode, focusedAnchor, highlightAnchor);

package/dist/comments/CommentProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"CommentProvider.js","sources":["../../src/comments/CommentProvider.tsx"],"sourcesContent":["import {\n  useCallback,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from \"react\";\nimport { deriveAnchorCounts, deriveAnchorMeta } from \"./comment-utils\";\nimport {\n  CommentContext,\n  CommentAnchorActionsContext,\n  CommentAnchorStoreContext,\n  createCommentAnchorStore,\n  exactAnchorResolver,\n  type AnchorResolver,\n  type CommentAnchorActions,\n  type CommentContextValue,\n  type CommentRailMode,\n  type CommentScrollOptions,\n} from \"./comment-context\";\nimport {\n  type Comment,\n  type CommentAnchor,\n  type CommentCallbacks,\n  type CommentConfig,\n} from \"./comment-types\";\n\nexport type CommentProviderProps = CommentCallbacks & {\n  children: ReactNode;\n  /** All comments for the document; counts and metadata are derived from these. */\n  comments: Comment[];\n  config: CommentConfig;\n  /** Strategy to map a requested anchor onto a registered one. Defaults to exact. */\n  resolveAnchor?: AnchorResolver;\n  /** Reports rail actions so a host can synchronize external visibility state. */\n  onRailModeChange?: (mode: CommentRailMode) => void;\n};\n\n/**\n * Supplies comment state to a document subtree: derived per-anchor counts and\n * metadata, rail open/focus state, and a generic anchor registry (cells call\n * `registerAnchor` so the side panel can scroll-align to them). Owns no\n * fetching — `comments` and the callbacks are controlled by the consumer.\n */\nexport function CommentProvider({\n  children,\n  comments,\n  config,\n  resolveAnchor = exactAnchorResolver,\n  onRailModeChange,\n  onCreate,\n  onReply,\n  onUpdateStatus,\n  onDelete,\n  onChecklistToggle,\n  onMention,\n}: CommentProviderProps) {\n  const [railMode, setRailMode] = useState<CommentRailMode>(\"closed\");\n  const [focusedAnchor, setFocusedAnchor] = useState<CommentAnchor | null>(\n    null,\n  );\n  const [highlightAnchor, setHighlightAnchor] = useState<CommentAnchor | null>(\n    null,\n  );\n  const railModeRef = useRef<CommentRailMode>(\"closed\");\n  const onRailModeChangeRef = useRef(onRailModeChange);\n  const resolveAnchorRef = useRef(resolveAnchor);\n  const anchorEls = useRef<Record<string, HTMLElement>>({});\n  const contentRef = useRef<HTMLDivElement | null>(null);\n\n  const commentCounts = useMemo(() => deriveAnchorCounts(comments), [comments]);\n  const commentMeta = useMemo(() => deriveAnchorMeta(comments), [comments]);\n  const [anchorStore] = useState(createCommentAnchorStore);\n\n  useLayoutEffect(() => {\n    onRailModeChangeRef.current = onRailModeChange;\n    resolveAnchorRef.current = resolveAnchor;\n  }, [onRailModeChange, resolveAnchor]);\n\n  const focusAnchor = useCallback((anchor: CommentAnchor) => {\n    setFocusedAnchor(anchor);\n    railModeRef.current = \"focused\";\n    setRailMode(\"focused\");\n    onRailModeChangeRef.current?.(\"focused\");\n  }, []);\n\n  const openCommentList = useCallback(() => {\n    const next = railModeRef.current === \"all\" ? \"closed\" : \"all\";\n    railModeRef.current = next;\n    setRailMode(next);\n    onRailModeChangeRef.current?.(next);\n  }, []);\n\n  const closeRail = useCallback(() => {\n    railModeRef.current = \"closed\";\n    setRailMode(\"closed\");\n    onRailModeChangeRef.current?.(\"closed\");\n  }, []);\n\n  const registerAnchor = useCallback(\n    (anchor: CommentAnchor, el: HTMLElement | null) => {\n      if (!el) {\n        delete anchorEls.current[anchor];\n        return;\n      }\n      const registered = anchorEls.current[anchor];\n      if (registered && registered !== el) {\n        throw new Error(\n          `Comment anchor \"${anchor}\" is registered by multiple elements`,\n        );\n      }\n      anchorEls.current[anchor] = el;\n    },\n    [],\n  );\n\n  const getAnchorTop = useCallback(\n    (anchor: CommentAnchor): number | null => {\n      const resolved = resolveAnchorRef.current(\n        anchor,\n        Object.keys(anchorEls.current),\n      );\n      const el = resolved ? anchorEls.current[resolved] : null;\n      const container = contentRef.current;\n      if (!el || !container) return null;\n      return (\n        el.getBoundingClientRect().top - container.getBoundingClientRect().top\n      );\n    },\n    [],\n  );\n\n  const scrollToAnchor = useCallback(\n    (anchor: CommentAnchor, options: CommentScrollOptions = {}): boolean => {\n      const resolved = resolveAnchorRef.current(\n        anchor,\n        Object.keys(anchorEls.current),\n      );\n      const el = resolved ? anchorEls.current[resolved] : null;\n      const container = contentRef.current;\n      if (!el || !container) return false;\n      const containerRect = container.getBoundingClientRect();\n      const anchorRect = el.getBoundingClientRect();\n      const offset = options.offset ?? 0;\n      const top =\n        options.block === \"center\"\n          ? container.scrollTop +\n            anchorRect.top -\n            containerRect.top +\n            anchorRect.height / 2 -\n            container.clientHeight / 2 -\n            offset\n          : container.scrollTop + anchorRect.top - containerRect.top - offset;\n      container.scrollTo({\n        top: Math.max(0, top),\n        behavior: options.behavior ?? \"smooth\",\n      });\n      return true;\n    },\n    [],\n  );\n\n  // A focused rail with no anchor selected has nothing to show.\n  useEffect(() => {\n    if (railMode === \"focused\" && !focusedAnchor) closeRail();\n  }, [closeRail, railMode, focusedAnchor]);\n\n  const callbacks = useMemo<CommentCallbacks>(\n    () => ({\n      ...(onCreate ? { onCreate } : {}),\n      ...(onReply ? { onReply } : {}),\n      ...(onUpdateStatus ? { onUpdateStatus } : {}),\n      ...(onDelete ? { onDelete } : {}),\n      ...(onChecklistToggle ? { onChecklistToggle } : {}),\n      ...(onMention ? { onMention } : {}),\n    }),\n    [onCreate, onReply, onUpdateStatus, onDelete, onChecklistToggle, onMention],\n  );\n\n  useLayoutEffect(() => {\n    anchorStore.update(commentMeta, railMode, focusedAnchor, highlightAnchor);\n  }, [anchorStore, commentMeta, railMode, focusedAnchor, highlightAnchor]);\n\n  const [anchorActions] = useState<CommentAnchorActions>(() => ({\n    focusAnchor,\n    registerAnchor,\n    scrollToAnchor,\n    contentRef,\n  }));\n\n  const value = useMemo<CommentContextValue>(\n    () => ({\n      comments,\n      config,\n      callbacks,\n      commentCounts,\n      commentMeta,\n      railMode,\n      focusedAnchor,\n      focusAnchor,\n      openCommentList,\n      closeRail,\n      registerAnchor,\n      getAnchorTop,\n      scrollToAnchor,\n      contentRef,\n      highlightAnchor,\n      setHighlightAnchor,\n    }),\n    [\n      comments,\n      config,\n      callbacks,\n      commentCounts,\n      commentMeta,\n      railMode,\n      focusedAnchor,\n      focusAnchor,\n      openCommentList,\n      closeRail,\n      registerAnchor,\n      getAnchorTop,\n      scrollToAnchor,\n      highlightAnchor,\n    ],\n  );\n\n  return (\n    <CommentAnchorStoreContext.Provider value={anchorStore}>\n      <CommentAnchorActionsContext.Provider value={anchorActions}>\n        <CommentContext.Provider value={value}>{children}</CommentContext.Provider>\n      </CommentAnchorActionsContext.Provider>\n    </CommentAnchorStoreContext.Provider>\n  );\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"CommentProvider.js","sources":["../../src/comments/CommentProvider.tsx"],"sourcesContent":["import {\n  useCallback,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from \"react\";\nimport { deriveAnchorCounts, deriveAnchorMeta } from \"./comment-utils\";\nimport {\n  CommentContext,\n  CommentAnchorActionsContext,\n  CommentAnchorStoreContext,\n  createCommentAnchorStore,\n  exactAnchorResolver,\n  type AnchorResolver,\n  type CommentAnchorActions,\n  type CommentContextValue,\n  type CommentRailMode,\n  type CommentScrollOptions,\n} from \"./comment-context\";\nimport {\n  type Comment,\n  type CommentAnchor,\n  type CommentCallbacks,\n  type CommentConfig,\n} from \"./comment-types\";\n\nexport type CommentProviderProps = CommentCallbacks & {\n  children: ReactNode;\n  /** All comments for the document; counts and metadata are derived from these. */\n  comments: Comment[];\n  config: CommentConfig;\n  /** Strategy to map a requested anchor onto a registered one. Defaults to exact. */\n  resolveAnchor?: AnchorResolver;\n  /** Reports rail actions so a host can synchronize external visibility state. */\n  onRailModeChange?: (mode: CommentRailMode) => void;\n};\n\n/**\n * Supplies comment state to a document subtree: derived per-anchor counts and\n * metadata, rail open/focus state, and a generic anchor registry (cells call\n * `registerAnchor` so the side panel can scroll-align to them). Owns no\n * fetching — `comments` and the callbacks are controlled by the consumer.\n */\nexport function CommentProvider({\n  children,\n  comments,\n  config,\n  resolveAnchor = exactAnchorResolver,\n  onRailModeChange,\n  onCreate,\n  onReply,\n  onUpdateStatus,\n  onUpdateRating,\n  onDelete,\n  onChecklistToggle,\n  onMention,\n}: CommentProviderProps) {\n  const [railMode, setRailMode] = useState<CommentRailMode>(\"closed\");\n  const [focusedAnchor, setFocusedAnchor] = useState<CommentAnchor | null>(\n    null,\n  );\n  const [highlightAnchor, setHighlightAnchor] = useState<CommentAnchor | null>(\n    null,\n  );\n  const railModeRef = useRef<CommentRailMode>(\"closed\");\n  const onRailModeChangeRef = useRef(onRailModeChange);\n  const resolveAnchorRef = useRef(resolveAnchor);\n  const anchorEls = useRef<Record<string, HTMLElement>>({});\n  const contentRef = useRef<HTMLDivElement | null>(null);\n\n  const commentCounts = useMemo(() => deriveAnchorCounts(comments), [comments]);\n  const commentMeta = useMemo(() => deriveAnchorMeta(comments), [comments]);\n  const [anchorStore] = useState(createCommentAnchorStore);\n\n  useLayoutEffect(() => {\n    onRailModeChangeRef.current = onRailModeChange;\n    resolveAnchorRef.current = resolveAnchor;\n  }, [onRailModeChange, resolveAnchor]);\n\n  const focusAnchor = useCallback((anchor: CommentAnchor) => {\n    setFocusedAnchor(anchor);\n    railModeRef.current = \"focused\";\n    setRailMode(\"focused\");\n    onRailModeChangeRef.current?.(\"focused\");\n  }, []);\n\n  const openCommentList = useCallback(() => {\n    const next = railModeRef.current === \"all\" ? \"closed\" : \"all\";\n    railModeRef.current = next;\n    setRailMode(next);\n    onRailModeChangeRef.current?.(next);\n  }, []);\n\n  const closeRail = useCallback(() => {\n    railModeRef.current = \"closed\";\n    setRailMode(\"closed\");\n    onRailModeChangeRef.current?.(\"closed\");\n  }, []);\n\n  const registerAnchor = useCallback(\n    (anchor: CommentAnchor, el: HTMLElement | null) => {\n      if (!el) {\n        delete anchorEls.current[anchor];\n        return;\n      }\n      const registered = anchorEls.current[anchor];\n      if (registered && registered !== el) {\n        throw new Error(\n          `Comment anchor \"${anchor}\" is registered by multiple elements`,\n        );\n      }\n      anchorEls.current[anchor] = el;\n    },\n    [],\n  );\n\n  const getAnchorTop = useCallback((anchor: CommentAnchor): number | null => {\n    const resolved = resolveAnchorRef.current(\n      anchor,\n      Object.keys(anchorEls.current),\n    );\n    const el = resolved ? anchorEls.current[resolved] : null;\n    const container = contentRef.current;\n    if (!el || !container) return null;\n    return (\n      el.getBoundingClientRect().top - container.getBoundingClientRect().top\n    );\n  }, []);\n\n  const scrollToAnchor = useCallback(\n    (anchor: CommentAnchor, options: CommentScrollOptions = {}): boolean => {\n      const resolved = resolveAnchorRef.current(\n        anchor,\n        Object.keys(anchorEls.current),\n      );\n      const el = resolved ? anchorEls.current[resolved] : null;\n      const container = contentRef.current;\n      if (!el || !container) return false;\n      const containerRect = container.getBoundingClientRect();\n      const anchorRect = el.getBoundingClientRect();\n      const offset = options.offset ?? 0;\n      const top =\n        options.block === \"center\"\n          ? container.scrollTop +\n            anchorRect.top -\n            containerRect.top +\n            anchorRect.height / 2 -\n            container.clientHeight / 2 -\n            offset\n          : container.scrollTop + anchorRect.top - containerRect.top - offset;\n      container.scrollTo({\n        top: Math.max(0, top),\n        behavior: options.behavior ?? \"smooth\",\n      });\n      return true;\n    },\n    [],\n  );\n\n  // A focused rail with no anchor selected has nothing to show.\n  useEffect(() => {\n    if (railMode === \"focused\" && !focusedAnchor) closeRail();\n  }, [closeRail, railMode, focusedAnchor]);\n\n  const callbacks = useMemo<CommentCallbacks>(\n    () => ({\n      ...(onCreate ? { onCreate } : {}),\n      ...(onReply ? { onReply } : {}),\n      ...(onUpdateStatus ? { onUpdateStatus } : {}),\n      ...(onUpdateRating ? { onUpdateRating } : {}),\n      ...(onDelete ? { onDelete } : {}),\n      ...(onChecklistToggle ? { onChecklistToggle } : {}),\n      ...(onMention ? { onMention } : {}),\n    }),\n    [\n      onCreate,\n      onReply,\n      onUpdateStatus,\n      onUpdateRating,\n      onDelete,\n      onChecklistToggle,\n      onMention,\n    ],\n  );\n\n  useLayoutEffect(() => {\n    anchorStore.update(commentMeta, railMode, focusedAnchor, highlightAnchor);\n  }, [anchorStore, commentMeta, railMode, focusedAnchor, highlightAnchor]);\n\n  const [anchorActions] = useState<CommentAnchorActions>(() => ({\n    focusAnchor,\n    registerAnchor,\n    scrollToAnchor,\n    contentRef,\n  }));\n\n  const value = useMemo<CommentContextValue>(\n    () => ({\n      comments,\n      config,\n      callbacks,\n      commentCounts,\n      commentMeta,\n      railMode,\n      focusedAnchor,\n      focusAnchor,\n      openCommentList,\n      closeRail,\n      registerAnchor,\n      getAnchorTop,\n      scrollToAnchor,\n      contentRef,\n      highlightAnchor,\n      setHighlightAnchor,\n    }),\n    [\n      comments,\n      config,\n      callbacks,\n      commentCounts,\n      commentMeta,\n      railMode,\n      focusedAnchor,\n      focusAnchor,\n      openCommentList,\n      closeRail,\n      registerAnchor,\n      getAnchorTop,\n      scrollToAnchor,\n      highlightAnchor,\n    ],\n  );\n\n  return (\n    <CommentAnchorStoreContext.Provider value={anchorStore}>\n      <CommentAnchorActionsContext.Provider value={anchorActions}>\n        <CommentContext.Provider value={value}>\n          {children}\n        </CommentContext.Provider>\n      </CommentAnchorActionsContext.Provider>\n    </CommentAnchorStoreContext.Provider>\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/comments/CommentSidePanel.cjs

@@ -159,7 +159,7 @@ function FocusedComments({
     /* @__PURE__ */ jsxRuntime.jsx(
       LocationMeta,
       {
-        label: anchor === commentTypes.DOCUMENT_ANCHOR ? "Document-level comment" : `Attached to ${label}`
+        label: anchor === commentTypes.DOCUMENT_ANCHOR ? "Whole-page comment" : `Attached to ${label}`
       }
     ),
     /* @__PURE__ */ jsxRuntime.jsx(

package/dist/comments/CommentSidePanel.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"CommentSidePanel.cjs","sources":["../../src/comments/CommentSidePanel.tsx"],"sourcesContent":["import { useEffect, useMemo, useRef, useState, type MouseEvent } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { Icon } from \"../data/Icon\";\nimport { UiComment } from \"../icons\";\nimport { CommentThread } from \"./CommentThread\";\nimport { CommentThreadList } from \"./CommentThreadList\";\nimport {\n  useCommentContextOptional,\n  type CommentContextValue,\n} from \"./comment-context\";\nimport {\n  buildThreadListHandlers,\n  getRoots,\n  sortReplies,\n  buildReplyMap,\n} from \"./comment-utils\";\nimport {\n  DOCUMENT_ANCHOR,\n  type Comment,\n  type CommentAnchor,\n} from \"./comment-types\";\n\nexport type CommentSidePanelProps = {\n  /** Explicit label per anchor key. */\n  anchorLabels?: Record<CommentAnchor, string>;\n  /** Fallback label formatter for anchors without an explicit label. */\n  formatAnchorLabel?: (anchor: CommentAnchor) => string;\n  compact?: boolean;\n  /** Position the focused thread beside its registered content anchor. */\n  focusedAlignment?: \"flow\" | \"anchor\";\n  className?: string;\n};\n\nfunction defaultAnchorLabel(anchor: CommentAnchor): string {\n  if (anchor === DOCUMENT_ANCHOR) return \"General\";\n  return anchor\n    .replace(/\\[\\d+\\]/g, \"\")\n    .replaceAll(\".\", \" › \")\n    .replaceAll(\"_\", \" \")\n    .trim();\n}\n\nfunction useAnchorLabel(props: CommentSidePanelProps) {\n  return (anchor: CommentAnchor): string =>\n    props.anchorLabels?.[anchor] ??\n    props.formatAnchorLabel?.(anchor) ??\n    defaultAnchorLabel(anchor);\n}\n\nfunction LocationMeta({ label }: { label: string }) {\n  return (\n    <span\n      data-testid=\"comment-location-meta\"\n      className=\"inline-flex items-center rounded-full bg-muted px-2 py-1 text-[10px] font-medium text-muted-foreground\"\n    >\n      {label}\n    </span>\n  );\n}\n\nfunction RailToggle({\n  active,\n  onClick,\n  children,\n  testId,\n}: {\n  active?: boolean;\n  onClick: () => void;\n  children: React.ReactNode;\n  testId?: string;\n}) {\n  return (\n    <button\n      type=\"button\"\n      onClick={onClick}\n      data-testid={testId}\n      className={cn(\n        \"inline-flex items-center gap-1.5 rounded-full border px-3 py-1.5 text-xs font-medium shadow-sm transition-colors\",\n        active\n          ? \"border-primary bg-primary text-primary-foreground\"\n          : \"border-border bg-background text-muted-foreground hover:text-foreground\",\n      )}\n    >\n      <Icon icon={UiComment} className=\"text-xs\" />\n      {children}\n    </button>\n  );\n}\n\nfunction orderedAnchors(ctx: CommentContextValue): string[] {\n  return Object.keys(ctx.commentMeta).sort((a, b) => {\n    if (a === DOCUMENT_ANCHOR) return -1;\n    if (b === DOCUMENT_ANCHOR) return 1;\n    const at = ctx.getAnchorTop(a);\n    const bt = ctx.getAnchorTop(b);\n    if (at == null && bt == null) return a.localeCompare(b);\n    if (at == null) return 1;\n    if (bt == null) return -1;\n    if (at !== bt) return at - bt;\n    return a.localeCompare(b);\n  });\n}\n\nfunction orderComments(\n  comments: Comment[],\n  anchorOrder: Map<string, number>,\n): Comment[] {\n  const replyMap = buildReplyMap(comments);\n  const roots = getRoots(comments).sort((a, b) => {\n    const ai =\n      anchorOrder.get(a.anchor ?? DOCUMENT_ANCHOR) ?? Number.MAX_SAFE_INTEGER;\n    const bi =\n      anchorOrder.get(b.anchor ?? DOCUMENT_ANCHOR) ?? Number.MAX_SAFE_INTEGER;\n    if (ai !== bi) return ai - bi;\n    if (a.createdAt !== b.createdAt)\n      return a.createdAt.localeCompare(b.createdAt);\n    return String(a.id).localeCompare(String(b.id));\n  });\n  return roots.flatMap((root) => [\n    root,\n    ...sortReplies(replyMap.get(root.id) ?? []),\n  ]);\n}\n\nfunction AllComments({\n  ctx,\n  label,\n}: {\n  ctx: CommentContextValue;\n  label: (a: CommentAnchor) => string;\n}) {\n  const ordered = useMemo(() => {\n    const anchorOrder = new Map(orderedAnchors(ctx).map((a, i) => [a, i]));\n    return orderComments(ctx.comments, anchorOrder);\n  }, [ctx]);\n  const handlers = buildThreadListHandlers(ordered, ctx.config, ctx.callbacks);\n\n  function activateThread(\n    event: MouseEvent<HTMLDivElement>,\n    anchor: CommentAnchor,\n  ) {\n    const target = event.target as Element;\n    if (\n      target.closest(\n        'button, a, input, textarea, select, [contenteditable=\"true\"]',\n      )\n    )\n      return;\n    const roleButton = target.closest('[role=\"button\"]');\n    if (roleButton && roleButton !== target.closest(\"[data-comment-kind]\"))\n      return;\n    if (anchor !== DOCUMENT_ANCHOR) {\n      const found = ctx.scrollToAnchor(anchor, {\n        behavior: \"smooth\",\n        block: \"start\",\n        offset: 12,\n      });\n      if (!found) return;\n    }\n    ctx.focusAnchor(anchor);\n  }\n\n  if (ordered.length === 0) {\n    return (\n      <p className=\"rounded-lg bg-muted/40 px-3 py-2 text-xs text-muted-foreground\">\n        No comments yet.\n      </p>\n    );\n  }\n\n  return (\n    <div\n      data-testid=\"comment-all-rail\"\n      className=\"space-y-3 overflow-y-auto pr-1\"\n    >\n      <CommentThreadList\n        comments={ordered}\n        config={ctx.config}\n        compact\n        renderRootMeta={(c) => {\n          const anchor = c.anchor ?? DOCUMENT_ANCHOR;\n          const available =\n            anchor === DOCUMENT_ANCHOR || ctx.getAnchorTop(anchor) != null;\n          return (\n            <LocationMeta\n              label={`${label(anchor)}${available ? \"\" : \" · Unavailable\"}`}\n            />\n          );\n        }}\n        getThreadProps={(c) => ({\n          \"data-testid\": \"comment-feed-item\",\n          onMouseEnter: () =>\n            ctx.setHighlightAnchor(c.anchor ?? DOCUMENT_ANCHOR),\n          onMouseLeave: () => ctx.setHighlightAnchor(null),\n          onClick: (event) =>\n            activateThread(event, c.anchor ?? DOCUMENT_ANCHOR),\n        })}\n        {...handlers}\n      />\n    </div>\n  );\n}\n\nfunction FocusedComments({\n  ctx,\n  anchor,\n  label,\n  compact,\n}: {\n  ctx: CommentContextValue;\n  anchor: CommentAnchor;\n  label: string;\n  compact?: boolean;\n}) {\n  const comments = ctx.comments.filter(\n    (c) => (c.anchor ?? DOCUMENT_ANCHOR) === anchor,\n  );\n  const hasComments = comments.length > 0;\n  return (\n    <div className=\"space-y-3\" data-comment-anchor={anchor}>\n      <LocationMeta\n        label={\n          anchor === DOCUMENT_ANCHOR\n            ? \"Document-level comment\"\n            : `Attached to ${label}`\n        }\n      />\n      <CommentThread\n        comments={comments}\n        config={ctx.config}\n        anchor={anchor}\n        compact={compact ?? false}\n        autoFocusComposer={!hasComments}\n        defaultExpandedRoots={hasComments}\n        composerPlaceholder={\n          hasComments ? \"Add another top-level comment…\" : \"Add a comment…\"\n        }\n        {...ctx.callbacks}\n      />\n    </div>\n  );\n}\n\n/**\n * A controlled comment rail driven by {@link CommentProvider}. Shows a focused\n * thread for the active anchor, the full document feed in anchor order, or a\n * toggle when collapsed. Renders nothing outside a provider or when empty.\n */\nexport function CommentSidePanel(props: CommentSidePanelProps) {\n  const ctx = useCommentContextOptional();\n  const label = useAnchorLabel(props);\n  const railRef = useRef<HTMLElement>(null);\n  const focusedRef = useRef<HTMLDivElement>(null);\n  const [focusedOffset, setFocusedOffset] = useState<number | null>(null);\n  const focusedAnchor = ctx?.railMode === \"focused\" ? ctx.focusedAnchor : null;\n\n  useEffect(() => {\n    if (!ctx || props.focusedAlignment !== \"anchor\" || !focusedAnchor) {\n      setFocusedOffset(null);\n      return;\n    }\n    const content = ctx.contentRef.current;\n    const rail = railRef.current;\n    const focused = focusedRef.current;\n    if (!content || !rail || !focused) return;\n\n    const update = () => {\n      const anchorTop = ctx.getAnchorTop(focusedAnchor);\n      if (anchorTop == null) {\n        setFocusedOffset(null);\n        return;\n      }\n      const desiredTop = anchorTop + content.getBoundingClientRect().top;\n      const currentOffset = Number.parseFloat(focused.style.top) || 0;\n      const nextOffset =\n        currentOffset + desiredTop - focused.getBoundingClientRect().top;\n      setFocusedOffset(Math.max(0, nextOffset));\n    };\n    update();\n    content.addEventListener(\"scroll\", update, { passive: true });\n    window.addEventListener(\"resize\", update);\n    const observer =\n      typeof ResizeObserver === \"undefined\" ? null : new ResizeObserver(update);\n    observer?.observe(content);\n    observer?.observe(rail);\n    return () => {\n      content.removeEventListener(\"scroll\", update);\n      window.removeEventListener(\"resize\", update);\n      observer?.disconnect();\n    };\n  }, [ctx, focusedAnchor, props.focusedAlignment]);\n\n  if (!ctx) return null;\n\n  const total = Object.values(ctx.commentCounts).reduce((a, b) => a + b, 0);\n  if (ctx.railMode === \"closed\" && total === 0) return null;\n\n  return (\n    <aside\n      ref={railRef}\n      data-testid=\"comment-side-panel\"\n      className={cn(\"relative w-[320px] space-y-3\", props.className)}\n    >\n      {ctx.railMode === \"all\" ? (\n        <>\n          <div className=\"flex items-center gap-2\">\n            <RailToggle active onClick={ctx.openCommentList}>\n              All comments ({total})\n            </RailToggle>\n            <button\n              type=\"button\"\n              onClick={ctx.closeRail}\n              className=\"ml-auto rounded-md px-2 py-1 text-xs font-medium text-muted-foreground hover:bg-muted hover:text-foreground\"\n            >\n              Close\n            </button>\n          </div>\n          <AllComments ctx={ctx} label={label} />\n        </>\n      ) : ctx.railMode === \"focused\" && ctx.focusedAnchor ? (\n        <div\n          ref={focusedRef}\n          data-testid=\"comment-focused-rail\"\n          className=\"relative space-y-3\"\n          style={focusedOffset == null ? undefined : { top: focusedOffset }}\n        >\n          <div className=\"flex items-center gap-2\">\n            {total > 0 && (\n              <RailToggle\n                onClick={ctx.openCommentList}\n                testId=\"comment-open-all\"\n              >\n                All comments ({total})\n              </RailToggle>\n            )}\n            <button\n              type=\"button\"\n              onClick={ctx.closeRail}\n              className=\"ml-auto rounded-md px-2 py-1 text-xs font-medium text-muted-foreground hover:bg-muted hover:text-foreground\"\n            >\n              Hide\n            </button>\n          </div>\n          <FocusedComments\n            ctx={ctx}\n            anchor={ctx.focusedAnchor}\n            label={label(ctx.focusedAnchor)}\n            {...(props.compact !== undefined ? { compact: props.compact } : {})}\n          />\n        </div>\n      ) : (\n        <RailToggle onClick={ctx.openCommentList} testId=\"comment-open-all\">\n          Open comments ({total})\n        </RailToggle>\n      )}\n    </aside>\n  );\n}\n"],"names":["DOCUMENT_ANCHOR","jsx","jsxs","cn","Icon","UiComment","buildReplyMap","getRoots","sortReplies","useMemo","buildThreadListHandlers","CommentThreadList","CommentThread","useCommentContextOptional","useRef","useState","useEffect","Fragment"],"mappings":"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"}
+{"version":3,"file":"CommentSidePanel.cjs","sources":["../../src/comments/CommentSidePanel.tsx"],"sourcesContent":["import { useEffect, useMemo, useRef, useState, type MouseEvent } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { Icon } from \"../data/Icon\";\nimport { UiComment } from \"../icons\";\nimport { CommentThread } from \"./CommentThread\";\nimport { CommentThreadList } from \"./CommentThreadList\";\nimport {\n  useCommentContextOptional,\n  type CommentContextValue,\n} from \"./comment-context\";\nimport {\n  buildThreadListHandlers,\n  getRoots,\n  sortReplies,\n  buildReplyMap,\n} from \"./comment-utils\";\nimport {\n  DOCUMENT_ANCHOR,\n  type Comment,\n  type CommentAnchor,\n} from \"./comment-types\";\n\nexport type CommentSidePanelProps = {\n  /** Explicit label per anchor key. */\n  anchorLabels?: Record<CommentAnchor, string>;\n  /** Fallback label formatter for anchors without an explicit label. */\n  formatAnchorLabel?: (anchor: CommentAnchor) => string;\n  compact?: boolean;\n  /** Position the focused thread beside its registered content anchor. */\n  focusedAlignment?: \"flow\" | \"anchor\";\n  className?: string;\n};\n\nfunction defaultAnchorLabel(anchor: CommentAnchor): string {\n  if (anchor === DOCUMENT_ANCHOR) return \"General\";\n  return anchor\n    .replace(/\\[\\d+\\]/g, \"\")\n    .replaceAll(\".\", \" › \")\n    .replaceAll(\"_\", \" \")\n    .trim();\n}\n\nfunction useAnchorLabel(props: CommentSidePanelProps) {\n  return (anchor: CommentAnchor): string =>\n    props.anchorLabels?.[anchor] ??\n    props.formatAnchorLabel?.(anchor) ??\n    defaultAnchorLabel(anchor);\n}\n\nfunction LocationMeta({ label }: { label: string }) {\n  return (\n    <span\n      data-testid=\"comment-location-meta\"\n      className=\"inline-flex items-center rounded-full bg-muted px-2 py-1 text-[10px] font-medium text-muted-foreground\"\n    >\n      {label}\n    </span>\n  );\n}\n\nfunction RailToggle({\n  active,\n  onClick,\n  children,\n  testId,\n}: {\n  active?: boolean;\n  onClick: () => void;\n  children: React.ReactNode;\n  testId?: string;\n}) {\n  return (\n    <button\n      type=\"button\"\n      onClick={onClick}\n      data-testid={testId}\n      className={cn(\n        \"inline-flex items-center gap-1.5 rounded-full border px-3 py-1.5 text-xs font-medium shadow-sm transition-colors\",\n        active\n          ? \"border-primary bg-primary text-primary-foreground\"\n          : \"border-border bg-background text-muted-foreground hover:text-foreground\",\n      )}\n    >\n      <Icon icon={UiComment} className=\"text-xs\" />\n      {children}\n    </button>\n  );\n}\n\nfunction orderedAnchors(ctx: CommentContextValue): string[] {\n  return Object.keys(ctx.commentMeta).sort((a, b) => {\n    if (a === DOCUMENT_ANCHOR) return -1;\n    if (b === DOCUMENT_ANCHOR) return 1;\n    const at = ctx.getAnchorTop(a);\n    const bt = ctx.getAnchorTop(b);\n    if (at == null && bt == null) return a.localeCompare(b);\n    if (at == null) return 1;\n    if (bt == null) return -1;\n    if (at !== bt) return at - bt;\n    return a.localeCompare(b);\n  });\n}\n\nfunction orderComments(\n  comments: Comment[],\n  anchorOrder: Map<string, number>,\n): Comment[] {\n  const replyMap = buildReplyMap(comments);\n  const roots = getRoots(comments).sort((a, b) => {\n    const ai =\n      anchorOrder.get(a.anchor ?? DOCUMENT_ANCHOR) ?? Number.MAX_SAFE_INTEGER;\n    const bi =\n      anchorOrder.get(b.anchor ?? DOCUMENT_ANCHOR) ?? Number.MAX_SAFE_INTEGER;\n    if (ai !== bi) return ai - bi;\n    if (a.createdAt !== b.createdAt)\n      return a.createdAt.localeCompare(b.createdAt);\n    return String(a.id).localeCompare(String(b.id));\n  });\n  return roots.flatMap((root) => [\n    root,\n    ...sortReplies(replyMap.get(root.id) ?? []),\n  ]);\n}\n\nfunction AllComments({\n  ctx,\n  label,\n}: {\n  ctx: CommentContextValue;\n  label: (a: CommentAnchor) => string;\n}) {\n  const ordered = useMemo(() => {\n    const anchorOrder = new Map(orderedAnchors(ctx).map((a, i) => [a, i]));\n    return orderComments(ctx.comments, anchorOrder);\n  }, [ctx]);\n  const handlers = buildThreadListHandlers(ordered, ctx.config, ctx.callbacks);\n\n  function activateThread(\n    event: MouseEvent<HTMLDivElement>,\n    anchor: CommentAnchor,\n  ) {\n    const target = event.target as Element;\n    if (\n      target.closest(\n        'button, a, input, textarea, select, [contenteditable=\"true\"]',\n      )\n    )\n      return;\n    const roleButton = target.closest('[role=\"button\"]');\n    if (roleButton && roleButton !== target.closest(\"[data-comment-kind]\"))\n      return;\n    if (anchor !== DOCUMENT_ANCHOR) {\n      const found = ctx.scrollToAnchor(anchor, {\n        behavior: \"smooth\",\n        block: \"start\",\n        offset: 12,\n      });\n      if (!found) return;\n    }\n    ctx.focusAnchor(anchor);\n  }\n\n  if (ordered.length === 0) {\n    return (\n      <p className=\"rounded-lg bg-muted/40 px-3 py-2 text-xs text-muted-foreground\">\n        No comments yet.\n      </p>\n    );\n  }\n\n  return (\n    <div\n      data-testid=\"comment-all-rail\"\n      className=\"space-y-3 overflow-y-auto pr-1\"\n    >\n      <CommentThreadList\n        comments={ordered}\n        config={ctx.config}\n        compact\n        renderRootMeta={(c) => {\n          const anchor = c.anchor ?? DOCUMENT_ANCHOR;\n          const available =\n            anchor === DOCUMENT_ANCHOR || ctx.getAnchorTop(anchor) != null;\n          return (\n            <LocationMeta\n              label={`${label(anchor)}${available ? \"\" : \" · Unavailable\"}`}\n            />\n          );\n        }}\n        getThreadProps={(c) => ({\n          \"data-testid\": \"comment-feed-item\",\n          onMouseEnter: () =>\n            ctx.setHighlightAnchor(c.anchor ?? DOCUMENT_ANCHOR),\n          onMouseLeave: () => ctx.setHighlightAnchor(null),\n          onClick: (event) =>\n            activateThread(event, c.anchor ?? DOCUMENT_ANCHOR),\n        })}\n        {...handlers}\n      />\n    </div>\n  );\n}\n\nfunction FocusedComments({\n  ctx,\n  anchor,\n  label,\n  compact,\n}: {\n  ctx: CommentContextValue;\n  anchor: CommentAnchor;\n  label: string;\n  compact?: boolean;\n}) {\n  const comments = ctx.comments.filter(\n    (c) => (c.anchor ?? DOCUMENT_ANCHOR) === anchor,\n  );\n  const hasComments = comments.length > 0;\n  return (\n    <div className=\"space-y-3\" data-comment-anchor={anchor}>\n      <LocationMeta\n        label={\n          anchor === DOCUMENT_ANCHOR\n            ? \"Whole-page comment\"\n            : `Attached to ${label}`\n        }\n      />\n      <CommentThread\n        comments={comments}\n        config={ctx.config}\n        anchor={anchor}\n        compact={compact ?? false}\n        autoFocusComposer={!hasComments}\n        defaultExpandedRoots={hasComments}\n        composerPlaceholder={\n          hasComments ? \"Add another top-level comment…\" : \"Add a comment…\"\n        }\n        {...ctx.callbacks}\n      />\n    </div>\n  );\n}\n\n/**\n * A controlled comment rail driven by {@link CommentProvider}. Shows a focused\n * thread for the active anchor, the full document feed in anchor order, or a\n * toggle when collapsed. Renders nothing outside a provider or when empty.\n */\nexport function CommentSidePanel(props: CommentSidePanelProps) {\n  const ctx = useCommentContextOptional();\n  const label = useAnchorLabel(props);\n  const railRef = useRef<HTMLElement>(null);\n  const focusedRef = useRef<HTMLDivElement>(null);\n  const [focusedOffset, setFocusedOffset] = useState<number | null>(null);\n  const focusedAnchor = ctx?.railMode === \"focused\" ? ctx.focusedAnchor : null;\n\n  useEffect(() => {\n    if (!ctx || props.focusedAlignment !== \"anchor\" || !focusedAnchor) {\n      setFocusedOffset(null);\n      return;\n    }\n    const content = ctx.contentRef.current;\n    const rail = railRef.current;\n    const focused = focusedRef.current;\n    if (!content || !rail || !focused) return;\n\n    const update = () => {\n      const anchorTop = ctx.getAnchorTop(focusedAnchor);\n      if (anchorTop == null) {\n        setFocusedOffset(null);\n        return;\n      }\n      const desiredTop = anchorTop + content.getBoundingClientRect().top;\n      const currentOffset = Number.parseFloat(focused.style.top) || 0;\n      const nextOffset =\n        currentOffset + desiredTop - focused.getBoundingClientRect().top;\n      setFocusedOffset(Math.max(0, nextOffset));\n    };\n    update();\n    content.addEventListener(\"scroll\", update, { passive: true });\n    window.addEventListener(\"resize\", update);\n    const observer =\n      typeof ResizeObserver === \"undefined\" ? null : new ResizeObserver(update);\n    observer?.observe(content);\n    observer?.observe(rail);\n    return () => {\n      content.removeEventListener(\"scroll\", update);\n      window.removeEventListener(\"resize\", update);\n      observer?.disconnect();\n    };\n  }, [ctx, focusedAnchor, props.focusedAlignment]);\n\n  if (!ctx) return null;\n\n  const total = Object.values(ctx.commentCounts).reduce((a, b) => a + b, 0);\n  if (ctx.railMode === \"closed\" && total === 0) return null;\n\n  return (\n    <aside\n      ref={railRef}\n      data-testid=\"comment-side-panel\"\n      className={cn(\"relative w-[320px] space-y-3\", props.className)}\n    >\n      {ctx.railMode === \"all\" ? (\n        <>\n          <div className=\"flex items-center gap-2\">\n            <RailToggle active onClick={ctx.openCommentList}>\n              All comments ({total})\n            </RailToggle>\n            <button\n              type=\"button\"\n              onClick={ctx.closeRail}\n              className=\"ml-auto rounded-md px-2 py-1 text-xs font-medium text-muted-foreground hover:bg-muted hover:text-foreground\"\n            >\n              Close\n            </button>\n          </div>\n          <AllComments ctx={ctx} label={label} />\n        </>\n      ) : ctx.railMode === \"focused\" && ctx.focusedAnchor ? (\n        <div\n          ref={focusedRef}\n          data-testid=\"comment-focused-rail\"\n          className=\"relative space-y-3\"\n          style={focusedOffset == null ? undefined : { top: focusedOffset }}\n        >\n          <div className=\"flex items-center gap-2\">\n            {total > 0 && (\n              <RailToggle\n                onClick={ctx.openCommentList}\n                testId=\"comment-open-all\"\n              >\n                All comments ({total})\n              </RailToggle>\n            )}\n            <button\n              type=\"button\"\n              onClick={ctx.closeRail}\n              className=\"ml-auto rounded-md px-2 py-1 text-xs font-medium text-muted-foreground hover:bg-muted hover:text-foreground\"\n            >\n              Hide\n            </button>\n          </div>\n          <FocusedComments\n            ctx={ctx}\n            anchor={ctx.focusedAnchor}\n            label={label(ctx.focusedAnchor)}\n            {...(props.compact !== undefined ? { compact: props.compact } : {})}\n          />\n        </div>\n      ) : (\n        <RailToggle onClick={ctx.openCommentList} testId=\"comment-open-all\">\n          Open comments ({total})\n        </RailToggle>\n      )}\n    </aside>\n  );\n}\n"],"names":["DOCUMENT_ANCHOR","jsx","jsxs","cn","Icon","UiComment","buildReplyMap","getRoots","sortReplies","useMemo","buildThreadListHandlers","CommentThreadList","CommentThread","useCommentContextOptional","useRef","useState","useEffect","Fragment"],"mappings":"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"}

package/dist/comments/CommentSidePanel.js

@@ -157,7 +157,7 @@ function FocusedComments({
     /* @__PURE__ */ jsx(
       LocationMeta,
       {
-        label: anchor === DOCUMENT_ANCHOR ? "Document-level comment" : `Attached to ${label}`
+        label: anchor === DOCUMENT_ANCHOR ? "Whole-page comment" : `Attached to ${label}`
       }
     ),
     /* @__PURE__ */ jsx(

package/dist/comments/CommentSidePanel.js.map

@@ -1 +1 @@
-{"version":3,"file":"CommentSidePanel.js","sources":["../../src/comments/CommentSidePanel.tsx"],"sourcesContent":["import { useEffect, useMemo, useRef, useState, type MouseEvent } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { Icon } from \"../data/Icon\";\nimport { UiComment } from \"../icons\";\nimport { CommentThread } from \"./CommentThread\";\nimport { CommentThreadList } from \"./CommentThreadList\";\nimport {\n  useCommentContextOptional,\n  type CommentContextValue,\n} from \"./comment-context\";\nimport {\n  buildThreadListHandlers,\n  getRoots,\n  sortReplies,\n  buildReplyMap,\n} from \"./comment-utils\";\nimport {\n  DOCUMENT_ANCHOR,\n  type Comment,\n  type CommentAnchor,\n} from \"./comment-types\";\n\nexport type CommentSidePanelProps = {\n  /** Explicit label per anchor key. */\n  anchorLabels?: Record<CommentAnchor, string>;\n  /** Fallback label formatter for anchors without an explicit label. */\n  formatAnchorLabel?: (anchor: CommentAnchor) => string;\n  compact?: boolean;\n  /** Position the focused thread beside its registered content anchor. */\n  focusedAlignment?: \"flow\" | \"anchor\";\n  className?: string;\n};\n\nfunction defaultAnchorLabel(anchor: CommentAnchor): string {\n  if (anchor === DOCUMENT_ANCHOR) return \"General\";\n  return anchor\n    .replace(/\\[\\d+\\]/g, \"\")\n    .replaceAll(\".\", \" › \")\n    .replaceAll(\"_\", \" \")\n    .trim();\n}\n\nfunction useAnchorLabel(props: CommentSidePanelProps) {\n  return (anchor: CommentAnchor): string =>\n    props.anchorLabels?.[anchor] ??\n    props.formatAnchorLabel?.(anchor) ??\n    defaultAnchorLabel(anchor);\n}\n\nfunction LocationMeta({ label }: { label: string }) {\n  return (\n    <span\n      data-testid=\"comment-location-meta\"\n      className=\"inline-flex items-center rounded-full bg-muted px-2 py-1 text-[10px] font-medium text-muted-foreground\"\n    >\n      {label}\n    </span>\n  );\n}\n\nfunction RailToggle({\n  active,\n  onClick,\n  children,\n  testId,\n}: {\n  active?: boolean;\n  onClick: () => void;\n  children: React.ReactNode;\n  testId?: string;\n}) {\n  return (\n    <button\n      type=\"button\"\n      onClick={onClick}\n      data-testid={testId}\n      className={cn(\n        \"inline-flex items-center gap-1.5 rounded-full border px-3 py-1.5 text-xs font-medium shadow-sm transition-colors\",\n        active\n          ? \"border-primary bg-primary text-primary-foreground\"\n          : \"border-border bg-background text-muted-foreground hover:text-foreground\",\n      )}\n    >\n      <Icon icon={UiComment} className=\"text-xs\" />\n      {children}\n    </button>\n  );\n}\n\nfunction orderedAnchors(ctx: CommentContextValue): string[] {\n  return Object.keys(ctx.commentMeta).sort((a, b) => {\n    if (a === DOCUMENT_ANCHOR) return -1;\n    if (b === DOCUMENT_ANCHOR) return 1;\n    const at = ctx.getAnchorTop(a);\n    const bt = ctx.getAnchorTop(b);\n    if (at == null && bt == null) return a.localeCompare(b);\n    if (at == null) return 1;\n    if (bt == null) return -1;\n    if (at !== bt) return at - bt;\n    return a.localeCompare(b);\n  });\n}\n\nfunction orderComments(\n  comments: Comment[],\n  anchorOrder: Map<string, number>,\n): Comment[] {\n  const replyMap = buildReplyMap(comments);\n  const roots = getRoots(comments).sort((a, b) => {\n    const ai =\n      anchorOrder.get(a.anchor ?? DOCUMENT_ANCHOR) ?? Number.MAX_SAFE_INTEGER;\n    const bi =\n      anchorOrder.get(b.anchor ?? DOCUMENT_ANCHOR) ?? Number.MAX_SAFE_INTEGER;\n    if (ai !== bi) return ai - bi;\n    if (a.createdAt !== b.createdAt)\n      return a.createdAt.localeCompare(b.createdAt);\n    return String(a.id).localeCompare(String(b.id));\n  });\n  return roots.flatMap((root) => [\n    root,\n    ...sortReplies(replyMap.get(root.id) ?? []),\n  ]);\n}\n\nfunction AllComments({\n  ctx,\n  label,\n}: {\n  ctx: CommentContextValue;\n  label: (a: CommentAnchor) => string;\n}) {\n  const ordered = useMemo(() => {\n    const anchorOrder = new Map(orderedAnchors(ctx).map((a, i) => [a, i]));\n    return orderComments(ctx.comments, anchorOrder);\n  }, [ctx]);\n  const handlers = buildThreadListHandlers(ordered, ctx.config, ctx.callbacks);\n\n  function activateThread(\n    event: MouseEvent<HTMLDivElement>,\n    anchor: CommentAnchor,\n  ) {\n    const target = event.target as Element;\n    if (\n      target.closest(\n        'button, a, input, textarea, select, [contenteditable=\"true\"]',\n      )\n    )\n      return;\n    const roleButton = target.closest('[role=\"button\"]');\n    if (roleButton && roleButton !== target.closest(\"[data-comment-kind]\"))\n      return;\n    if (anchor !== DOCUMENT_ANCHOR) {\n      const found = ctx.scrollToAnchor(anchor, {\n        behavior: \"smooth\",\n        block: \"start\",\n        offset: 12,\n      });\n      if (!found) return;\n    }\n    ctx.focusAnchor(anchor);\n  }\n\n  if (ordered.length === 0) {\n    return (\n      <p className=\"rounded-lg bg-muted/40 px-3 py-2 text-xs text-muted-foreground\">\n        No comments yet.\n      </p>\n    );\n  }\n\n  return (\n    <div\n      data-testid=\"comment-all-rail\"\n      className=\"space-y-3 overflow-y-auto pr-1\"\n    >\n      <CommentThreadList\n        comments={ordered}\n        config={ctx.config}\n        compact\n        renderRootMeta={(c) => {\n          const anchor = c.anchor ?? DOCUMENT_ANCHOR;\n          const available =\n            anchor === DOCUMENT_ANCHOR || ctx.getAnchorTop(anchor) != null;\n          return (\n            <LocationMeta\n              label={`${label(anchor)}${available ? \"\" : \" · Unavailable\"}`}\n            />\n          );\n        }}\n        getThreadProps={(c) => ({\n          \"data-testid\": \"comment-feed-item\",\n          onMouseEnter: () =>\n            ctx.setHighlightAnchor(c.anchor ?? DOCUMENT_ANCHOR),\n          onMouseLeave: () => ctx.setHighlightAnchor(null),\n          onClick: (event) =>\n            activateThread(event, c.anchor ?? DOCUMENT_ANCHOR),\n        })}\n        {...handlers}\n      />\n    </div>\n  );\n}\n\nfunction FocusedComments({\n  ctx,\n  anchor,\n  label,\n  compact,\n}: {\n  ctx: CommentContextValue;\n  anchor: CommentAnchor;\n  label: string;\n  compact?: boolean;\n}) {\n  const comments = ctx.comments.filter(\n    (c) => (c.anchor ?? DOCUMENT_ANCHOR) === anchor,\n  );\n  const hasComments = comments.length > 0;\n  return (\n    <div className=\"space-y-3\" data-comment-anchor={anchor}>\n      <LocationMeta\n        label={\n          anchor === DOCUMENT_ANCHOR\n            ? \"Document-level comment\"\n            : `Attached to ${label}`\n        }\n      />\n      <CommentThread\n        comments={comments}\n        config={ctx.config}\n        anchor={anchor}\n        compact={compact ?? false}\n        autoFocusComposer={!hasComments}\n        defaultExpandedRoots={hasComments}\n        composerPlaceholder={\n          hasComments ? \"Add another top-level comment…\" : \"Add a comment…\"\n        }\n        {...ctx.callbacks}\n      />\n    </div>\n  );\n}\n\n/**\n * A controlled comment rail driven by {@link CommentProvider}. Shows a focused\n * thread for the active anchor, the full document feed in anchor order, or a\n * toggle when collapsed. Renders nothing outside a provider or when empty.\n */\nexport function CommentSidePanel(props: CommentSidePanelProps) {\n  const ctx = useCommentContextOptional();\n  const label = useAnchorLabel(props);\n  const railRef = useRef<HTMLElement>(null);\n  const focusedRef = useRef<HTMLDivElement>(null);\n  const [focusedOffset, setFocusedOffset] = useState<number | null>(null);\n  const focusedAnchor = ctx?.railMode === \"focused\" ? ctx.focusedAnchor : null;\n\n  useEffect(() => {\n    if (!ctx || props.focusedAlignment !== \"anchor\" || !focusedAnchor) {\n      setFocusedOffset(null);\n      return;\n    }\n    const content = ctx.contentRef.current;\n    const rail = railRef.current;\n    const focused = focusedRef.current;\n    if (!content || !rail || !focused) return;\n\n    const update = () => {\n      const anchorTop = ctx.getAnchorTop(focusedAnchor);\n      if (anchorTop == null) {\n        setFocusedOffset(null);\n        return;\n      }\n      const desiredTop = anchorTop + content.getBoundingClientRect().top;\n      const currentOffset = Number.parseFloat(focused.style.top) || 0;\n      const nextOffset =\n        currentOffset + desiredTop - focused.getBoundingClientRect().top;\n      setFocusedOffset(Math.max(0, nextOffset));\n    };\n    update();\n    content.addEventListener(\"scroll\", update, { passive: true });\n    window.addEventListener(\"resize\", update);\n    const observer =\n      typeof ResizeObserver === \"undefined\" ? null : new ResizeObserver(update);\n    observer?.observe(content);\n    observer?.observe(rail);\n    return () => {\n      content.removeEventListener(\"scroll\", update);\n      window.removeEventListener(\"resize\", update);\n      observer?.disconnect();\n    };\n  }, [ctx, focusedAnchor, props.focusedAlignment]);\n\n  if (!ctx) return null;\n\n  const total = Object.values(ctx.commentCounts).reduce((a, b) => a + b, 0);\n  if (ctx.railMode === \"closed\" && total === 0) return null;\n\n  return (\n    <aside\n      ref={railRef}\n      data-testid=\"comment-side-panel\"\n      className={cn(\"relative w-[320px] space-y-3\", props.className)}\n    >\n      {ctx.railMode === \"all\" ? (\n        <>\n          <div className=\"flex items-center gap-2\">\n            <RailToggle active onClick={ctx.openCommentList}>\n              All comments ({total})\n            </RailToggle>\n            <button\n              type=\"button\"\n              onClick={ctx.closeRail}\n              className=\"ml-auto rounded-md px-2 py-1 text-xs font-medium text-muted-foreground hover:bg-muted hover:text-foreground\"\n            >\n              Close\n            </button>\n          </div>\n          <AllComments ctx={ctx} label={label} />\n        </>\n      ) : ctx.railMode === \"focused\" && ctx.focusedAnchor ? (\n        <div\n          ref={focusedRef}\n          data-testid=\"comment-focused-rail\"\n          className=\"relative space-y-3\"\n          style={focusedOffset == null ? undefined : { top: focusedOffset }}\n        >\n          <div className=\"flex items-center gap-2\">\n            {total > 0 && (\n              <RailToggle\n                onClick={ctx.openCommentList}\n                testId=\"comment-open-all\"\n              >\n                All comments ({total})\n              </RailToggle>\n            )}\n            <button\n              type=\"button\"\n              onClick={ctx.closeRail}\n              className=\"ml-auto rounded-md px-2 py-1 text-xs font-medium text-muted-foreground hover:bg-muted hover:text-foreground\"\n            >\n              Hide\n            </button>\n          </div>\n          <FocusedComments\n            ctx={ctx}\n            anchor={ctx.focusedAnchor}\n            label={label(ctx.focusedAnchor)}\n            {...(props.compact !== undefined ? { compact: props.compact } : {})}\n          />\n        </div>\n      ) : (\n        <RailToggle onClick={ctx.openCommentList} testId=\"comment-open-all\">\n          Open comments ({total})\n        </RailToggle>\n      )}\n    </aside>\n  );\n}\n"],"names":[],"mappings":";;;;;;;;;;AAiCA,SAAS,mBAAmB,QAA+B;AACzD,MAAI,WAAW,gBAAiB,QAAO;AACvC,SAAO,OACJ,QAAQ,YAAY,EAAE,EACtB,WAAW,KAAK,KAAK,EACrB,WAAW,KAAK,GAAG,EACnB,KAAA;AACL;AAEA,SAAS,eAAe,OAA8B;AACpD,SAAO,CAAC,WAAA;;AACN,wBAAM,iBAAN,mBAAqB,cACrB,WAAM,sBAAN,+BAA0B,YAC1B,mBAAmB,MAAM;AAAA;AAC7B;AAEA,SAAS,aAAa,EAAE,SAA4B;AAClD,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,eAAY;AAAA,MACZ,WAAU;AAAA,MAET,UAAA;AAAA,IAAA;AAAA,EAAA;AAGP;AAEA,SAAS,WAAW;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAKG;AACD,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,MAAK;AAAA,MACL;AAAA,MACA,eAAa;AAAA,MACb,WAAW;AAAA,QACT;AAAA,QACA,SACI,sDACA;AAAA,MAAA;AAAA,MAGN,UAAA;AAAA,QAAA,oBAAC,MAAA,EAAK,MAAM,WAAW,WAAU,WAAU;AAAA,QAC1C;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAGP;AAEA,SAAS,eAAe,KAAoC;AAC1D,SAAO,OAAO,KAAK,IAAI,WAAW,EAAE,KAAK,CAAC,GAAG,MAAM;AACjD,QAAI,MAAM,gBAAiB,QAAO;AAClC,QAAI,MAAM,gBAAiB,QAAO;AAClC,UAAM,KAAK,IAAI,aAAa,CAAC;AAC7B,UAAM,KAAK,IAAI,aAAa,CAAC;AAC7B,QAAI,MAAM,QAAQ,MAAM,KAAM,QAAO,EAAE,cAAc,CAAC;AACtD,QAAI,MAAM,KAAM,QAAO;AACvB,QAAI,MAAM,KAAM,QAAO;AACvB,QAAI,OAAO,GAAI,QAAO,KAAK;AAC3B,WAAO,EAAE,cAAc,CAAC;AAAA,EAC1B,CAAC;AACH;AAEA,SAAS,cACP,UACA,aACW;AACX,QAAM,WAAW,cAAc,QAAQ;AACvC,QAAM,QAAQ,SAAS,QAAQ,EAAE,KAAK,CAAC,GAAG,MAAM;AAC9C,UAAM,KACJ,YAAY,IAAI,EAAE,UAAU,eAAe,KAAK,OAAO;AACzD,UAAM,KACJ,YAAY,IAAI,EAAE,UAAU,eAAe,KAAK,OAAO;AACzD,QAAI,OAAO,GAAI,QAAO,KAAK;AAC3B,QAAI,EAAE,cAAc,EAAE;AACpB,aAAO,EAAE,UAAU,cAAc,EAAE,SAAS;AAC9C,WAAO,OAAO,EAAE,EAAE,EAAE,cAAc,OAAO,EAAE,EAAE,CAAC;AAAA,EAChD,CAAC;AACD,SAAO,MAAM,QAAQ,CAAC,SAAS;AAAA,IAC7B;AAAA,IACA,GAAG,YAAY,SAAS,IAAI,KAAK,EAAE,KAAK,CAAA,CAAE;AAAA,EAAA,CAC3C;AACH;AAEA,SAAS,YAAY;AAAA,EACnB;AAAA,EACA;AACF,GAGG;AACD,QAAM,UAAU,QAAQ,MAAM;AAC5B,UAAM,cAAc,IAAI,IAAI,eAAe,GAAG,EAAE,IAAI,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AACrE,WAAO,cAAc,IAAI,UAAU,WAAW;AAAA,EAChD,GAAG,CAAC,GAAG,CAAC;AACR,QAAM,WAAW,wBAAwB,SAAS,IAAI,QAAQ,IAAI,SAAS;AAE3E,WAAS,eACP,OACA,QACA;AACA,UAAM,SAAS,MAAM;AACrB,QACE,OAAO;AAAA,MACL;AAAA,IAAA;AAGF;AACF,UAAM,aAAa,OAAO,QAAQ,iBAAiB;AACnD,QAAI,cAAc,eAAe,OAAO,QAAQ,qBAAqB;AACnE;AACF,QAAI,WAAW,iBAAiB;AAC9B,YAAM,QAAQ,IAAI,eAAe,QAAQ;AAAA,QACvC,UAAU;AAAA,QACV,OAAO;AAAA,QACP,QAAQ;AAAA,MAAA,CACT;AACD,UAAI,CAAC,MAAO;AAAA,IACd;AACA,QAAI,YAAY,MAAM;AAAA,EACxB;AAEA,MAAI,QAAQ,WAAW,GAAG;AACxB,WACE,oBAAC,KAAA,EAAE,WAAU,kEAAiE,UAAA,oBAE9E;AAAA,EAEJ;AAEA,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,eAAY;AAAA,MACZ,WAAU;AAAA,MAEV,UAAA;AAAA,QAAC;AAAA,QAAA;AAAA,UACC,UAAU;AAAA,UACV,QAAQ,IAAI;AAAA,UACZ,SAAO;AAAA,UACP,gBAAgB,CAAC,MAAM;AACrB,kBAAM,SAAS,EAAE,UAAU;AAC3B,kBAAM,YACJ,WAAW,mBAAmB,IAAI,aAAa,MAAM,KAAK;AAC5D,mBACE;AAAA,cAAC;AAAA,cAAA;AAAA,gBACC,OAAO,GAAG,MAAM,MAAM,CAAC,GAAG,YAAY,KAAK,gBAAgB;AAAA,cAAA;AAAA,YAAA;AAAA,UAGjE;AAAA,UACA,gBAAgB,CAAC,OAAO;AAAA,YACtB,eAAe;AAAA,YACf,cAAc,MACZ,IAAI,mBAAmB,EAAE,UAAU,eAAe;AAAA,YACpD,cAAc,MAAM,IAAI,mBAAmB,IAAI;AAAA,YAC/C,SAAS,CAAC,UACR,eAAe,OAAO,EAAE,UAAU,eAAe;AAAA,UAAA;AAAA,UAEpD,GAAG;AAAA,QAAA;AAAA,MAAA;AAAA,IACN;AAAA,EAAA;AAGN;AAEA,SAAS,gBAAgB;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAKG;AACD,QAAM,WAAW,IAAI,SAAS;AAAA,IAC5B,CAAC,OAAO,EAAE,UAAU,qBAAqB;AAAA,EAAA;AAE3C,QAAM,cAAc,SAAS,SAAS;AACtC,SACE,qBAAC,OAAA,EAAI,WAAU,aAAY,uBAAqB,QAC9C,UAAA;AAAA,IAAA;AAAA,MAAC;AAAA,MAAA;AAAA,QACC,OACE,WAAW,kBACP,2BACA,eAAe,KAAK;AAAA,MAAA;AAAA,IAAA;AAAA,IAG5B;AAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA,QAAQ,IAAI;AAAA,QACZ;AAAA,QACA,SAAS,WAAW;AAAA,QACpB,mBAAmB,CAAC;AAAA,QACpB,sBAAsB;AAAA,QACtB,qBACE,cAAc,mCAAmC;AAAA,QAElD,GAAG,IAAI;AAAA,MAAA;AAAA,IAAA;AAAA,EACV,GACF;AAEJ;AAOO,SAAS,iBAAiB,OAA8B;AAC7D,QAAM,MAAM,0BAAA;AACZ,QAAM,QAAQ,eAAe,KAAK;AAClC,QAAM,UAAU,OAAoB,IAAI;AACxC,QAAM,aAAa,OAAuB,IAAI;AAC9C,QAAM,CAAC,eAAe,gBAAgB,IAAI,SAAwB,IAAI;AACtE,QAAM,iBAAgB,2BAAK,cAAa,YAAY,IAAI,gBAAgB;AAExE,YAAU,MAAM;AACd,QAAI,CAAC,OAAO,MAAM,qBAAqB,YAAY,CAAC,eAAe;AACjE,uBAAiB,IAAI;AACrB;AAAA,IACF;AACA,UAAM,UAAU,IAAI,WAAW;AAC/B,UAAM,OAAO,QAAQ;AACrB,UAAM,UAAU,WAAW;AAC3B,QAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAS;AAEnC,UAAM,SAAS,MAAM;AACnB,YAAM,YAAY,IAAI,aAAa,aAAa;AAChD,UAAI,aAAa,MAAM;AACrB,yBAAiB,IAAI;AACrB;AAAA,MACF;AACA,YAAM,aAAa,YAAY,QAAQ,sBAAA,EAAwB;AAC/D,YAAM,gBAAgB,OAAO,WAAW,QAAQ,MAAM,GAAG,KAAK;AAC9D,YAAM,aACJ,gBAAgB,aAAa,QAAQ,wBAAwB;AAC/D,uBAAiB,KAAK,IAAI,GAAG,UAAU,CAAC;AAAA,IAC1C;AACA,WAAA;AACA,YAAQ,iBAAiB,UAAU,QAAQ,EAAE,SAAS,MAAM;AAC5D,WAAO,iBAAiB,UAAU,MAAM;AACxC,UAAM,WACJ,OAAO,mBAAmB,cAAc,OAAO,IAAI,eAAe,MAAM;AAC1E,yCAAU,QAAQ;AAClB,yCAAU,QAAQ;AAClB,WAAO,MAAM;AACX,cAAQ,oBAAoB,UAAU,MAAM;AAC5C,aAAO,oBAAoB,UAAU,MAAM;AAC3C,2CAAU;AAAA,IACZ;AAAA,EACF,GAAG,CAAC,KAAK,eAAe,MAAM,gBAAgB,CAAC;AAE/C,MAAI,CAAC,IAAK,QAAO;AAEjB,QAAM,QAAQ,OAAO,OAAO,IAAI,aAAa,EAAE,OAAO,CAAC,GAAG,MAAM,IAAI,GAAG,CAAC;AACxE,MAAI,IAAI,aAAa,YAAY,UAAU,EAAG,QAAO;AAErD,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,KAAK;AAAA,MACL,eAAY;AAAA,MACZ,WAAW,GAAG,gCAAgC,MAAM,SAAS;AAAA,MAE5D,UAAA,IAAI,aAAa,QAChB,qBAAA,UAAA,EACE,UAAA;AAAA,QAAA,qBAAC,OAAA,EAAI,WAAU,2BACb,UAAA;AAAA,UAAA,qBAAC,YAAA,EAAW,QAAM,MAAC,SAAS,IAAI,iBAAiB,UAAA;AAAA,YAAA;AAAA,YAChC;AAAA,YAAM;AAAA,UAAA,GACvB;AAAA,UACA;AAAA,YAAC;AAAA,YAAA;AAAA,cACC,MAAK;AAAA,cACL,SAAS,IAAI;AAAA,cACb,WAAU;AAAA,cACX,UAAA;AAAA,YAAA;AAAA,UAAA;AAAA,QAED,GACF;AAAA,QACA,oBAAC,aAAA,EAAY,KAAU,MAAA,CAAc;AAAA,MAAA,EAAA,CACvC,IACE,IAAI,aAAa,aAAa,IAAI,gBACpC;AAAA,QAAC;AAAA,QAAA;AAAA,UACC,KAAK;AAAA,UACL,eAAY;AAAA,UACZ,WAAU;AAAA,UACV,OAAO,iBAAiB,OAAO,SAAY,EAAE,KAAK,cAAA;AAAA,UAElD,UAAA;AAAA,YAAA,qBAAC,OAAA,EAAI,WAAU,2BACZ,UAAA;AAAA,cAAA,QAAQ,KACP;AAAA,gBAAC;AAAA,gBAAA;AAAA,kBACC,SAAS,IAAI;AAAA,kBACb,QAAO;AAAA,kBACR,UAAA;AAAA,oBAAA;AAAA,oBACgB;AAAA,oBAAM;AAAA,kBAAA;AAAA,gBAAA;AAAA,cAAA;AAAA,cAGzB;AAAA,gBAAC;AAAA,gBAAA;AAAA,kBACC,MAAK;AAAA,kBACL,SAAS,IAAI;AAAA,kBACb,WAAU;AAAA,kBACX,UAAA;AAAA,gBAAA;AAAA,cAAA;AAAA,YAED,GACF;AAAA,YACA;AAAA,cAAC;AAAA,cAAA;AAAA,gBACC;AAAA,gBACA,QAAQ,IAAI;AAAA,gBACZ,OAAO,MAAM,IAAI,aAAa;AAAA,gBAC7B,GAAI,MAAM,YAAY,SAAY,EAAE,SAAS,MAAM,YAAY,CAAA;AAAA,cAAC;AAAA,YAAA;AAAA,UACnE;AAAA,QAAA;AAAA,MAAA,IAGF,qBAAC,YAAA,EAAW,SAAS,IAAI,iBAAiB,QAAO,oBAAmB,UAAA;AAAA,QAAA;AAAA,QAClD;AAAA,QAAM;AAAA,MAAA,EAAA,CACxB;AAAA,IAAA;AAAA,EAAA;AAIR;"}
+{"version":3,"file":"CommentSidePanel.js","sources":["../../src/comments/CommentSidePanel.tsx"],"sourcesContent":["import { useEffect, useMemo, useRef, useState, type MouseEvent } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { Icon } from \"../data/Icon\";\nimport { UiComment } from \"../icons\";\nimport { CommentThread } from \"./CommentThread\";\nimport { CommentThreadList } from \"./CommentThreadList\";\nimport {\n  useCommentContextOptional,\n  type CommentContextValue,\n} from \"./comment-context\";\nimport {\n  buildThreadListHandlers,\n  getRoots,\n  sortReplies,\n  buildReplyMap,\n} from \"./comment-utils\";\nimport {\n  DOCUMENT_ANCHOR,\n  type Comment,\n  type CommentAnchor,\n} from \"./comment-types\";\n\nexport type CommentSidePanelProps = {\n  /** Explicit label per anchor key. */\n  anchorLabels?: Record<CommentAnchor, string>;\n  /** Fallback label formatter for anchors without an explicit label. */\n  formatAnchorLabel?: (anchor: CommentAnchor) => string;\n  compact?: boolean;\n  /** Position the focused thread beside its registered content anchor. */\n  focusedAlignment?: \"flow\" | \"anchor\";\n  className?: string;\n};\n\nfunction defaultAnchorLabel(anchor: CommentAnchor): string {\n  if (anchor === DOCUMENT_ANCHOR) return \"General\";\n  return anchor\n    .replace(/\\[\\d+\\]/g, \"\")\n    .replaceAll(\".\", \" › \")\n    .replaceAll(\"_\", \" \")\n    .trim();\n}\n\nfunction useAnchorLabel(props: CommentSidePanelProps) {\n  return (anchor: CommentAnchor): string =>\n    props.anchorLabels?.[anchor] ??\n    props.formatAnchorLabel?.(anchor) ??\n    defaultAnchorLabel(anchor);\n}\n\nfunction LocationMeta({ label }: { label: string }) {\n  return (\n    <span\n      data-testid=\"comment-location-meta\"\n      className=\"inline-flex items-center rounded-full bg-muted px-2 py-1 text-[10px] font-medium text-muted-foreground\"\n    >\n      {label}\n    </span>\n  );\n}\n\nfunction RailToggle({\n  active,\n  onClick,\n  children,\n  testId,\n}: {\n  active?: boolean;\n  onClick: () => void;\n  children: React.ReactNode;\n  testId?: string;\n}) {\n  return (\n    <button\n      type=\"button\"\n      onClick={onClick}\n      data-testid={testId}\n      className={cn(\n        \"inline-flex items-center gap-1.5 rounded-full border px-3 py-1.5 text-xs font-medium shadow-sm transition-colors\",\n        active\n          ? \"border-primary bg-primary text-primary-foreground\"\n          : \"border-border bg-background text-muted-foreground hover:text-foreground\",\n      )}\n    >\n      <Icon icon={UiComment} className=\"text-xs\" />\n      {children}\n    </button>\n  );\n}\n\nfunction orderedAnchors(ctx: CommentContextValue): string[] {\n  return Object.keys(ctx.commentMeta).sort((a, b) => {\n    if (a === DOCUMENT_ANCHOR) return -1;\n    if (b === DOCUMENT_ANCHOR) return 1;\n    const at = ctx.getAnchorTop(a);\n    const bt = ctx.getAnchorTop(b);\n    if (at == null && bt == null) return a.localeCompare(b);\n    if (at == null) return 1;\n    if (bt == null) return -1;\n    if (at !== bt) return at - bt;\n    return a.localeCompare(b);\n  });\n}\n\nfunction orderComments(\n  comments: Comment[],\n  anchorOrder: Map<string, number>,\n): Comment[] {\n  const replyMap = buildReplyMap(comments);\n  const roots = getRoots(comments).sort((a, b) => {\n    const ai =\n      anchorOrder.get(a.anchor ?? DOCUMENT_ANCHOR) ?? Number.MAX_SAFE_INTEGER;\n    const bi =\n      anchorOrder.get(b.anchor ?? DOCUMENT_ANCHOR) ?? Number.MAX_SAFE_INTEGER;\n    if (ai !== bi) return ai - bi;\n    if (a.createdAt !== b.createdAt)\n      return a.createdAt.localeCompare(b.createdAt);\n    return String(a.id).localeCompare(String(b.id));\n  });\n  return roots.flatMap((root) => [\n    root,\n    ...sortReplies(replyMap.get(root.id) ?? []),\n  ]);\n}\n\nfunction AllComments({\n  ctx,\n  label,\n}: {\n  ctx: CommentContextValue;\n  label: (a: CommentAnchor) => string;\n}) {\n  const ordered = useMemo(() => {\n    const anchorOrder = new Map(orderedAnchors(ctx).map((a, i) => [a, i]));\n    return orderComments(ctx.comments, anchorOrder);\n  }, [ctx]);\n  const handlers = buildThreadListHandlers(ordered, ctx.config, ctx.callbacks);\n\n  function activateThread(\n    event: MouseEvent<HTMLDivElement>,\n    anchor: CommentAnchor,\n  ) {\n    const target = event.target as Element;\n    if (\n      target.closest(\n        'button, a, input, textarea, select, [contenteditable=\"true\"]',\n      )\n    )\n      return;\n    const roleButton = target.closest('[role=\"button\"]');\n    if (roleButton && roleButton !== target.closest(\"[data-comment-kind]\"))\n      return;\n    if (anchor !== DOCUMENT_ANCHOR) {\n      const found = ctx.scrollToAnchor(anchor, {\n        behavior: \"smooth\",\n        block: \"start\",\n        offset: 12,\n      });\n      if (!found) return;\n    }\n    ctx.focusAnchor(anchor);\n  }\n\n  if (ordered.length === 0) {\n    return (\n      <p className=\"rounded-lg bg-muted/40 px-3 py-2 text-xs text-muted-foreground\">\n        No comments yet.\n      </p>\n    );\n  }\n\n  return (\n    <div\n      data-testid=\"comment-all-rail\"\n      className=\"space-y-3 overflow-y-auto pr-1\"\n    >\n      <CommentThreadList\n        comments={ordered}\n        config={ctx.config}\n        compact\n        renderRootMeta={(c) => {\n          const anchor = c.anchor ?? DOCUMENT_ANCHOR;\n          const available =\n            anchor === DOCUMENT_ANCHOR || ctx.getAnchorTop(anchor) != null;\n          return (\n            <LocationMeta\n              label={`${label(anchor)}${available ? \"\" : \" · Unavailable\"}`}\n            />\n          );\n        }}\n        getThreadProps={(c) => ({\n          \"data-testid\": \"comment-feed-item\",\n          onMouseEnter: () =>\n            ctx.setHighlightAnchor(c.anchor ?? DOCUMENT_ANCHOR),\n          onMouseLeave: () => ctx.setHighlightAnchor(null),\n          onClick: (event) =>\n            activateThread(event, c.anchor ?? DOCUMENT_ANCHOR),\n        })}\n        {...handlers}\n      />\n    </div>\n  );\n}\n\nfunction FocusedComments({\n  ctx,\n  anchor,\n  label,\n  compact,\n}: {\n  ctx: CommentContextValue;\n  anchor: CommentAnchor;\n  label: string;\n  compact?: boolean;\n}) {\n  const comments = ctx.comments.filter(\n    (c) => (c.anchor ?? DOCUMENT_ANCHOR) === anchor,\n  );\n  const hasComments = comments.length > 0;\n  return (\n    <div className=\"space-y-3\" data-comment-anchor={anchor}>\n      <LocationMeta\n        label={\n          anchor === DOCUMENT_ANCHOR\n            ? \"Whole-page comment\"\n            : `Attached to ${label}`\n        }\n      />\n      <CommentThread\n        comments={comments}\n        config={ctx.config}\n        anchor={anchor}\n        compact={compact ?? false}\n        autoFocusComposer={!hasComments}\n        defaultExpandedRoots={hasComments}\n        composerPlaceholder={\n          hasComments ? \"Add another top-level comment…\" : \"Add a comment…\"\n        }\n        {...ctx.callbacks}\n      />\n    </div>\n  );\n}\n\n/**\n * A controlled comment rail driven by {@link CommentProvider}. Shows a focused\n * thread for the active anchor, the full document feed in anchor order, or a\n * toggle when collapsed. Renders nothing outside a provider or when empty.\n */\nexport function CommentSidePanel(props: CommentSidePanelProps) {\n  const ctx = useCommentContextOptional();\n  const label = useAnchorLabel(props);\n  const railRef = useRef<HTMLElement>(null);\n  const focusedRef = useRef<HTMLDivElement>(null);\n  const [focusedOffset, setFocusedOffset] = useState<number | null>(null);\n  const focusedAnchor = ctx?.railMode === \"focused\" ? ctx.focusedAnchor : null;\n\n  useEffect(() => {\n    if (!ctx || props.focusedAlignment !== \"anchor\" || !focusedAnchor) {\n      setFocusedOffset(null);\n      return;\n    }\n    const content = ctx.contentRef.current;\n    const rail = railRef.current;\n    const focused = focusedRef.current;\n    if (!content || !rail || !focused) return;\n\n    const update = () => {\n      const anchorTop = ctx.getAnchorTop(focusedAnchor);\n      if (anchorTop == null) {\n        setFocusedOffset(null);\n        return;\n      }\n      const desiredTop = anchorTop + content.getBoundingClientRect().top;\n      const currentOffset = Number.parseFloat(focused.style.top) || 0;\n      const nextOffset =\n        currentOffset + desiredTop - focused.getBoundingClientRect().top;\n      setFocusedOffset(Math.max(0, nextOffset));\n    };\n    update();\n    content.addEventListener(\"scroll\", update, { passive: true });\n    window.addEventListener(\"resize\", update);\n    const observer =\n      typeof ResizeObserver === \"undefined\" ? null : new ResizeObserver(update);\n    observer?.observe(content);\n    observer?.observe(rail);\n    return () => {\n      content.removeEventListener(\"scroll\", update);\n      window.removeEventListener(\"resize\", update);\n      observer?.disconnect();\n    };\n  }, [ctx, focusedAnchor, props.focusedAlignment]);\n\n  if (!ctx) return null;\n\n  const total = Object.values(ctx.commentCounts).reduce((a, b) => a + b, 0);\n  if (ctx.railMode === \"closed\" && total === 0) return null;\n\n  return (\n    <aside\n      ref={railRef}\n      data-testid=\"comment-side-panel\"\n      className={cn(\"relative w-[320px] space-y-3\", props.className)}\n    >\n      {ctx.railMode === \"all\" ? (\n        <>\n          <div className=\"flex items-center gap-2\">\n            <RailToggle active onClick={ctx.openCommentList}>\n              All comments ({total})\n            </RailToggle>\n            <button\n              type=\"button\"\n              onClick={ctx.closeRail}\n              className=\"ml-auto rounded-md px-2 py-1 text-xs font-medium text-muted-foreground hover:bg-muted hover:text-foreground\"\n            >\n              Close\n            </button>\n          </div>\n          <AllComments ctx={ctx} label={label} />\n        </>\n      ) : ctx.railMode === \"focused\" && ctx.focusedAnchor ? (\n        <div\n          ref={focusedRef}\n          data-testid=\"comment-focused-rail\"\n          className=\"relative space-y-3\"\n          style={focusedOffset == null ? undefined : { top: focusedOffset }}\n        >\n          <div className=\"flex items-center gap-2\">\n            {total > 0 && (\n              <RailToggle\n                onClick={ctx.openCommentList}\n                testId=\"comment-open-all\"\n              >\n                All comments ({total})\n              </RailToggle>\n            )}\n            <button\n              type=\"button\"\n              onClick={ctx.closeRail}\n              className=\"ml-auto rounded-md px-2 py-1 text-xs font-medium text-muted-foreground hover:bg-muted hover:text-foreground\"\n            >\n              Hide\n            </button>\n          </div>\n          <FocusedComments\n            ctx={ctx}\n            anchor={ctx.focusedAnchor}\n            label={label(ctx.focusedAnchor)}\n            {...(props.compact !== undefined ? { compact: props.compact } : {})}\n          />\n        </div>\n      ) : (\n        <RailToggle onClick={ctx.openCommentList} testId=\"comment-open-all\">\n          Open comments ({total})\n        </RailToggle>\n      )}\n    </aside>\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/comments/comment-types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"comment-types.cjs","sources":["../../src/comments/comment-types.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport type { StaticIconComponent } from \"../data/Icon\";\n\n/** Semantic tone driving a status/facet color (maps onto Badge tones). */\nexport type CommentTone =\n  | \"default\"\n  | \"info\"\n  | \"success\"\n  | \"warning\"\n  | \"danger\"\n  | \"neutral\";\n\n/** A single selectable status (e.g. \"open\", \"resolved\"). Consumer-defined. */\nexport type CommentStatusConfig = {\n  /** Stable value stored on a comment's `status`. */\n  value: string;\n  /** Human label shown in menus and badges. */\n  label: string;\n  /** Color tone for the status chip. */\n  tone?: CommentTone;\n  /** Optional leading glyph. */\n  icon?: string | StaticIconComponent;\n  /**\n   * Whether this status counts as \"unresolved/open\" — drives progress tallies\n   * and which groups start expanded. Defaults to false.\n   */\n  unresolved?: boolean;\n};\n\n/** One option of a generic facet (e.g. a \"category\" value). */\nexport type CommentFacetOption = {\n  value: string;\n  label: string;\n  tone?: CommentTone;\n  /** Compact glyph for the collapsed card (e.g. \"BS\" for a category). */\n  short?: string;\n};\n\n/**\n * A generic, consumer-supplied classification axis. Replaces the financial\n * category/severity vocabulary — any app declares its own facets.\n */\nexport type CommentFacet = {\n  /** Key into `Comment.facets`. */\n  key: string;\n  label: string;\n  options: CommentFacetOption[];\n  /** Allow several values to be selected at once in the filter bar. */\n  multiple?: boolean;\n};\n\nexport type CommentMentionKind = \"user\" | \"agent\";\n\n/** A person or agent that can be @-mentioned in the composer. */\nexport type CommentMentionable = {\n  id: string;\n  name: string;\n  /** Image URL for `kind: \"user\"`. */\n  avatar?: string;\n  kind: CommentMentionKind;\n  /** Glyph override for `kind: \"agent\"`. */\n  icon?: string | StaticIconComponent;\n};\n\n/** A resolved mention emitted when a comment referencing a mentionable is posted. */\nexport type CommentMention = {\n  id: string;\n  name: string;\n  kind: CommentMentionKind;\n};\n\n/** A labelled group of reference chips (e.g. linked ids). */\nexport type CommentRefGroup = {\n  label: string;\n  items: string[];\n  /** Render items in a monospace font. */\n  mono?: boolean;\n};\n\n/** One item of a generic checklist; `status` cycles through `checklistStatusCycle`. */\nexport type CommentChecklistItem = {\n  label: string;\n  status: string;\n};\n\nexport type CommentAuthor = {\n  id?: string;\n  name: string;\n  kind?: CommentMentionKind;\n  avatar?: string;\n  /** Glyph override for `kind: \"agent\"` authors. */\n  icon?: string | StaticIconComponent;\n};\n\n/**\n * An opaque anchor key locating a comment within a document. Not a JSON path —\n * any stable string a consumer registers via the provider. `null`/absent means\n * document-level.\n */\nexport type CommentAnchor = string;\n\n/** Anchor key reserved for document-level (un-anchored) comments. */\nexport const DOCUMENT_ANCHOR = \"__document__\";\n\n/** A single comment. Replies set `parentId`; roots leave it null. */\nexport type Comment = {\n  id: string;\n  body: string;\n  /** ISO-8601 creation time. */\n  createdAt: string;\n  /** ISO-8601 last-update time. */\n  updatedAt?: string;\n  author: CommentAuthor | null;\n  /** Key into the configured statuses; roots only. */\n  status?: string;\n  /** Parent comment id when this is a reply. */\n  parentId?: string | null;\n  /** Where the comment is anchored; null/absent = document-level. */\n  anchor?: CommentAnchor | null;\n  /** facet.key → selected option value. */\n  facets?: Record<string, string>;\n  refs?: CommentRefGroup[];\n  checklist?: CommentChecklistItem[];\n};\n\n/** Payload for creating a new root comment. */\nexport type CommentCreateInput = {\n  body: string;\n  anchor?: CommentAnchor | null;\n  facets?: Record<string, string>;\n  mentions?: CommentMention[];\n};\n\n/** Payload for replying to a comment. */\nexport type CommentReplyInput = {\n  parentId: string;\n  body: string;\n  anchor?: CommentAnchor | null;\n  mentions?: CommentMention[];\n};\n\n/**\n * Controlled callbacks. The components own no data fetching; the consumer\n * performs the mutation and feeds the updated `comments` back in.\n */\nexport type CommentCallbacks = {\n  onCreate?: (input: CommentCreateInput) => void | Promise<void>;\n  onReply?: (input: CommentReplyInput) => void | Promise<void>;\n  onUpdateStatus?: (id: string, status: string) => void | Promise<void>;\n  onDelete?: (id: string) => void | Promise<void>;\n  onChecklistToggle?: (\n    id: string,\n    index: number,\n    next: string,\n  ) => void | Promise<void>;\n  /** Fired when a posted comment references a mentionable. */\n  onMention?: (mention: CommentMention, context: { body: string }) => void;\n};\n\n/** Static configuration shared across the comment components. */\nexport type CommentConfig = {\n  /** Selectable statuses; the first `unresolved` one is the default for new comments. */\n  statuses: CommentStatusConfig[];\n  /** Classification axes (category/severity/etc.). */\n  facets?: CommentFacet[];\n  /** People/agents available for @-mention. */\n  mentionables?: CommentMentionable[];\n  /** Status values a checklist item cycles through on click. */\n  checklistStatusCycle?: string[];\n};\n\n/** Aggregate metadata for one anchor, derived from the comment list. */\nexport type CommentAnchorMeta = {\n  count: number;\n  authors: string[];\n  latestStatus?: string;\n};\n\n/** Selected filter state for the filter bar / `applyCommentFilters`. */\nexport type CommentFilters = {\n  /** Selected status values; empty = all statuses. */\n  statuses: Set<string>;\n  /** facet.key → selected option values; empty set = all values for that facet. */\n  facets: Record<string, Set<string>>;\n  /** Restrict to an author kind, or \"all\". */\n  authorKind?: CommentMentionKind | \"all\";\n};\n\n/** Optional renderers passed down to a card. */\nexport type CommentRenderOptions = {\n  /** Custom comment-body renderer (e.g. full Markdown). Defaults to CommentMarkdown. */\n  renderBody?: (body: string) => ReactNode;\n};\n\n/** A domain-free default status set: open / in progress / resolved. */\nexport const DEFAULT_COMMENT_STATUSES: CommentStatusConfig[] = [\n  { value: \"open\", label: \"Open\", tone: \"info\", unresolved: true },\n  {\n    value: \"in_progress\",\n    label: \"In progress\",\n    tone: \"warning\",\n    unresolved: true,\n  },\n  { value: \"resolved\", label: \"Resolved\", tone: \"success\" },\n  { value: \"closed\", label: \"Closed\", tone: \"neutral\" },\n];\n\n/** Default checklist status cycle used when a consumer omits one. */\nexport const DEFAULT_CHECKLIST_CYCLE = [\"open\", \"in_progress\", \"done\"];\n"],"names":[],"mappings":";;AAsGO,MAAM,kBAAkB;AA6FxB,MAAM,2BAAkD;AAAA,EAC7D,EAAE,OAAO,QAAQ,OAAO,QAAQ,MAAM,QAAQ,YAAY,KAAA;AAAA,EAC1D;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,MAAM;AAAA,IACN,YAAY;AAAA,EAAA;AAAA,EAEd,EAAE,OAAO,YAAY,OAAO,YAAY,MAAM,UAAA;AAAA,EAC9C,EAAE,OAAO,UAAU,OAAO,UAAU,MAAM,UAAA;AAC5C;AAGO,MAAM,0BAA0B,CAAC,QAAQ,eAAe,MAAM;;;;"}
+{"version":3,"file":"comment-types.cjs","sources":["../../src/comments/comment-types.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport type { StaticIconComponent } from \"../data/Icon\";\n\n/** Semantic tone driving a status/facet color (maps onto Badge tones). */\nexport type CommentTone =\n  | \"default\"\n  | \"info\"\n  | \"success\"\n  | \"warning\"\n  | \"danger\"\n  | \"neutral\";\n\n/** A single selectable status (e.g. \"open\", \"resolved\"). Consumer-defined. */\nexport type CommentStatusConfig = {\n  /** Stable value stored on a comment's `status`. */\n  value: string;\n  /** Human label shown in menus and badges. */\n  label: string;\n  /** Color tone for the status chip. */\n  tone?: CommentTone;\n  /** Optional leading glyph. */\n  icon?: string | StaticIconComponent;\n  /**\n   * Whether this status counts as \"unresolved/open\" — drives progress tallies\n   * and which groups start expanded. Defaults to false.\n   */\n  unresolved?: boolean;\n};\n\n/** One option of a generic facet (e.g. a \"category\" value). */\nexport type CommentFacetOption = {\n  value: string;\n  label: string;\n  tone?: CommentTone;\n  /** Compact glyph for the collapsed card (e.g. \"BS\" for a category). */\n  short?: string;\n};\n\n/**\n * A generic, consumer-supplied classification axis. Replaces the financial\n * category/severity vocabulary — any app declares its own facets.\n */\nexport type CommentFacet = {\n  /** Key into `Comment.facets`. */\n  key: string;\n  label: string;\n  options: CommentFacetOption[];\n  /** Allow several values to be selected at once in the filter bar. */\n  multiple?: boolean;\n};\n\nexport type CommentMentionKind = \"user\" | \"agent\";\n\n/** A person or agent that can be @-mentioned in the composer. */\nexport type CommentMentionable = {\n  id: string;\n  name: string;\n  /** Image URL for `kind: \"user\"`. */\n  avatar?: string;\n  kind: CommentMentionKind;\n  /** Glyph override for `kind: \"agent\"`. */\n  icon?: string | StaticIconComponent;\n};\n\n/** A resolved mention emitted when a comment referencing a mentionable is posted. */\nexport type CommentMention = {\n  id: string;\n  name: string;\n  kind: CommentMentionKind;\n};\n\n/** A labelled group of reference chips (e.g. linked ids). */\nexport type CommentRefGroup = {\n  label: string;\n  items: string[];\n  /** Render items in a monospace font. */\n  mono?: boolean;\n};\n\n/** One item of a generic checklist; `status` cycles through `checklistStatusCycle`. */\nexport type CommentChecklistItem = {\n  label: string;\n  status: string;\n};\n\nexport type CommentAuthor = {\n  id?: string;\n  name: string;\n  kind?: CommentMentionKind;\n  avatar?: string;\n  /** Glyph override for `kind: \"agent\"` authors. */\n  icon?: string | StaticIconComponent;\n};\n\n/**\n * An opaque anchor key locating a comment within a document. Not a JSON path —\n * any stable string a consumer registers via the provider. `null`/absent means\n * document-level.\n */\nexport type CommentAnchor = string;\n\n/** Binary review signal attached to a root comment. */\nexport type CommentRating = \"positive\" | \"negative\";\n\n/** Anchor key reserved for document-level (un-anchored) comments. */\nexport const DOCUMENT_ANCHOR = \"__document__\";\n\n/** A single comment. Replies set `parentId`; roots leave it null. */\nexport type Comment = {\n  id: string;\n  body: string;\n  /** ISO-8601 creation time. */\n  createdAt: string;\n  /** ISO-8601 last-update time. */\n  updatedAt?: string;\n  author: CommentAuthor | null;\n  /** Key into the configured statuses; roots only. */\n  status?: string;\n  /** Parent comment id when this is a reply. */\n  parentId?: string | null;\n  /** Where the comment is anchored; null/absent = document-level. */\n  anchor?: CommentAnchor | null;\n  /** Optional positive/negative review signal; roots only. */\n  rating?: CommentRating;\n  /** facet.key → selected option value. */\n  facets?: Record<string, string>;\n  refs?: CommentRefGroup[];\n  checklist?: CommentChecklistItem[];\n};\n\n/** Payload for creating a new root comment. */\nexport type CommentCreateInput = {\n  body: string;\n  anchor?: CommentAnchor | null;\n  rating?: CommentRating;\n  facets?: Record<string, string>;\n  mentions?: CommentMention[];\n};\n\n/** Payload for replying to a comment. */\nexport type CommentReplyInput = {\n  parentId: string;\n  body: string;\n  anchor?: CommentAnchor | null;\n  mentions?: CommentMention[];\n};\n\n/**\n * Controlled callbacks. The components own no data fetching; the consumer\n * performs the mutation and feeds the updated `comments` back in.\n */\nexport type CommentCallbacks = {\n  onCreate?: (input: CommentCreateInput) => void | Promise<void>;\n  onReply?: (input: CommentReplyInput) => void | Promise<void>;\n  onUpdateStatus?: (id: string, status: string) => void | Promise<void>;\n  onUpdateRating?: (id: string, rating: CommentRating) => void | Promise<void>;\n  onDelete?: (id: string) => void | Promise<void>;\n  onChecklistToggle?: (\n    id: string,\n    index: number,\n    next: string,\n  ) => void | Promise<void>;\n  /** Fired when a posted comment references a mentionable. */\n  onMention?: (mention: CommentMention, context: { body: string }) => void;\n};\n\n/** Static configuration shared across the comment components. */\nexport type CommentConfig = {\n  /** Selectable statuses; the first `unresolved` one is the default for new comments. */\n  statuses: CommentStatusConfig[];\n  /** Classification axes (category/severity/etc.). */\n  facets?: CommentFacet[];\n  /** People/agents available for @-mention. */\n  mentionables?: CommentMentionable[];\n  /** Status values a checklist item cycles through on click. */\n  checklistStatusCycle?: string[];\n};\n\n/** Aggregate metadata for one anchor, derived from the comment list. */\nexport type CommentAnchorMeta = {\n  count: number;\n  authors: string[];\n  latestStatus?: string;\n};\n\n/** Selected filter state for the filter bar / `applyCommentFilters`. */\nexport type CommentFilters = {\n  /** Selected status values; empty = all statuses. */\n  statuses: Set<string>;\n  /** facet.key → selected option values; empty set = all values for that facet. */\n  facets: Record<string, Set<string>>;\n  /** Restrict to an author kind, or \"all\". */\n  authorKind?: CommentMentionKind | \"all\";\n};\n\n/** Optional renderers passed down to a card. */\nexport type CommentRenderOptions = {\n  /** Custom comment-body renderer (e.g. full Markdown). Defaults to CommentMarkdown. */\n  renderBody?: (body: string) => ReactNode;\n};\n\n/** A domain-free default status set: open / in progress / resolved. */\nexport const DEFAULT_COMMENT_STATUSES: CommentStatusConfig[] = [\n  { value: \"open\", label: \"Open\", tone: \"info\", unresolved: true },\n  {\n    value: \"in_progress\",\n    label: \"In progress\",\n    tone: \"warning\",\n    unresolved: true,\n  },\n  { value: \"resolved\", label: \"Resolved\", tone: \"success\" },\n  { value: \"closed\", label: \"Closed\", tone: \"neutral\" },\n];\n\n/** Default checklist status cycle used when a consumer omits one. */\nexport const DEFAULT_CHECKLIST_CYCLE = [\"open\", \"in_progress\", \"done\"];\n"],"names":[],"mappings":";;AAyGO,MAAM,kBAAkB;AAiGxB,MAAM,2BAAkD;AAAA,EAC7D,EAAE,OAAO,QAAQ,OAAO,QAAQ,MAAM,QAAQ,YAAY,KAAA;AAAA,EAC1D;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,MAAM;AAAA,IACN,YAAY;AAAA,EAAA;AAAA,EAEd,EAAE,OAAO,YAAY,OAAO,YAAY,MAAM,UAAA;AAAA,EAC9C,EAAE,OAAO,UAAU,OAAO,UAAU,MAAM,UAAA;AAC5C;AAGO,MAAM,0BAA0B,CAAC,QAAQ,eAAe,MAAM;;;;"}

package/dist/comments/comment-types.d.ts

@@ -81,6 +81,8 @@ export type CommentAuthor = {
  * document-level.
  */
 export type CommentAnchor = string;
+/** Binary review signal attached to a root comment. */
+export type CommentRating = "positive" | "negative";
 /** Anchor key reserved for document-level (un-anchored) comments. */
 export declare const DOCUMENT_ANCHOR = "__document__";
 /** A single comment. Replies set `parentId`; roots leave it null. */
@@ -98,6 +100,8 @@ export type Comment = {
     parentId?: string | null;
     /** Where the comment is anchored; null/absent = document-level. */
     anchor?: CommentAnchor | null;
+    /** Optional positive/negative review signal; roots only. */
+    rating?: CommentRating;
     /** facet.key → selected option value. */
     facets?: Record<string, string>;
     refs?: CommentRefGroup[];
@@ -107,6 +111,7 @@ export type Comment = {
 export type CommentCreateInput = {
     body: string;
     anchor?: CommentAnchor | null;
+    rating?: CommentRating;
     facets?: Record<string, string>;
     mentions?: CommentMention[];
 };
@@ -125,6 +130,7 @@ export type CommentCallbacks = {
     onCreate?: (input: CommentCreateInput) => void | Promise<void>;
     onReply?: (input: CommentReplyInput) => void | Promise<void>;
     onUpdateStatus?: (id: string, status: string) => void | Promise<void>;
+    onUpdateRating?: (id: string, rating: CommentRating) => void | Promise<void>;
     onDelete?: (id: string) => void | Promise<void>;
     onChecklistToggle?: (id: string, index: number, next: string) => void | Promise<void>;
     /** Fired when a posted comment references a mentionable. */

package/dist/comments/comment-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"comment-types.d.ts","sourceRoot":"","sources":["../../src/comments/comment-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"comment-types.d.ts","sourceRoot":"","sources":["../../src/comments/comment-types.ts"],"names":[],"mappings":"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"}

package/dist/comments/comment-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"comment-types.js","sources":["../../src/comments/comment-types.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport type { StaticIconComponent } from \"../data/Icon\";\n\n/** Semantic tone driving a status/facet color (maps onto Badge tones). */\nexport type CommentTone =\n  | \"default\"\n  | \"info\"\n  | \"success\"\n  | \"warning\"\n  | \"danger\"\n  | \"neutral\";\n\n/** A single selectable status (e.g. \"open\", \"resolved\"). Consumer-defined. */\nexport type CommentStatusConfig = {\n  /** Stable value stored on a comment's `status`. */\n  value: string;\n  /** Human label shown in menus and badges. */\n  label: string;\n  /** Color tone for the status chip. */\n  tone?: CommentTone;\n  /** Optional leading glyph. */\n  icon?: string | StaticIconComponent;\n  /**\n   * Whether this status counts as \"unresolved/open\" — drives progress tallies\n   * and which groups start expanded. Defaults to false.\n   */\n  unresolved?: boolean;\n};\n\n/** One option of a generic facet (e.g. a \"category\" value). */\nexport type CommentFacetOption = {\n  value: string;\n  label: string;\n  tone?: CommentTone;\n  /** Compact glyph for the collapsed card (e.g. \"BS\" for a category). */\n  short?: string;\n};\n\n/**\n * A generic, consumer-supplied classification axis. Replaces the financial\n * category/severity vocabulary — any app declares its own facets.\n */\nexport type CommentFacet = {\n  /** Key into `Comment.facets`. */\n  key: string;\n  label: string;\n  options: CommentFacetOption[];\n  /** Allow several values to be selected at once in the filter bar. */\n  multiple?: boolean;\n};\n\nexport type CommentMentionKind = \"user\" | \"agent\";\n\n/** A person or agent that can be @-mentioned in the composer. */\nexport type CommentMentionable = {\n  id: string;\n  name: string;\n  /** Image URL for `kind: \"user\"`. */\n  avatar?: string;\n  kind: CommentMentionKind;\n  /** Glyph override for `kind: \"agent\"`. */\n  icon?: string | StaticIconComponent;\n};\n\n/** A resolved mention emitted when a comment referencing a mentionable is posted. */\nexport type CommentMention = {\n  id: string;\n  name: string;\n  kind: CommentMentionKind;\n};\n\n/** A labelled group of reference chips (e.g. linked ids). */\nexport type CommentRefGroup = {\n  label: string;\n  items: string[];\n  /** Render items in a monospace font. */\n  mono?: boolean;\n};\n\n/** One item of a generic checklist; `status` cycles through `checklistStatusCycle`. */\nexport type CommentChecklistItem = {\n  label: string;\n  status: string;\n};\n\nexport type CommentAuthor = {\n  id?: string;\n  name: string;\n  kind?: CommentMentionKind;\n  avatar?: string;\n  /** Glyph override for `kind: \"agent\"` authors. */\n  icon?: string | StaticIconComponent;\n};\n\n/**\n * An opaque anchor key locating a comment within a document. Not a JSON path —\n * any stable string a consumer registers via the provider. `null`/absent means\n * document-level.\n */\nexport type CommentAnchor = string;\n\n/** Anchor key reserved for document-level (un-anchored) comments. */\nexport const DOCUMENT_ANCHOR = \"__document__\";\n\n/** A single comment. Replies set `parentId`; roots leave it null. */\nexport type Comment = {\n  id: string;\n  body: string;\n  /** ISO-8601 creation time. */\n  createdAt: string;\n  /** ISO-8601 last-update time. */\n  updatedAt?: string;\n  author: CommentAuthor | null;\n  /** Key into the configured statuses; roots only. */\n  status?: string;\n  /** Parent comment id when this is a reply. */\n  parentId?: string | null;\n  /** Where the comment is anchored; null/absent = document-level. */\n  anchor?: CommentAnchor | null;\n  /** facet.key → selected option value. */\n  facets?: Record<string, string>;\n  refs?: CommentRefGroup[];\n  checklist?: CommentChecklistItem[];\n};\n\n/** Payload for creating a new root comment. */\nexport type CommentCreateInput = {\n  body: string;\n  anchor?: CommentAnchor | null;\n  facets?: Record<string, string>;\n  mentions?: CommentMention[];\n};\n\n/** Payload for replying to a comment. */\nexport type CommentReplyInput = {\n  parentId: string;\n  body: string;\n  anchor?: CommentAnchor | null;\n  mentions?: CommentMention[];\n};\n\n/**\n * Controlled callbacks. The components own no data fetching; the consumer\n * performs the mutation and feeds the updated `comments` back in.\n */\nexport type CommentCallbacks = {\n  onCreate?: (input: CommentCreateInput) => void | Promise<void>;\n  onReply?: (input: CommentReplyInput) => void | Promise<void>;\n  onUpdateStatus?: (id: string, status: string) => void | Promise<void>;\n  onDelete?: (id: string) => void | Promise<void>;\n  onChecklistToggle?: (\n    id: string,\n    index: number,\n    next: string,\n  ) => void | Promise<void>;\n  /** Fired when a posted comment references a mentionable. */\n  onMention?: (mention: CommentMention, context: { body: string }) => void;\n};\n\n/** Static configuration shared across the comment components. */\nexport type CommentConfig = {\n  /** Selectable statuses; the first `unresolved` one is the default for new comments. */\n  statuses: CommentStatusConfig[];\n  /** Classification axes (category/severity/etc.). */\n  facets?: CommentFacet[];\n  /** People/agents available for @-mention. */\n  mentionables?: CommentMentionable[];\n  /** Status values a checklist item cycles through on click. */\n  checklistStatusCycle?: string[];\n};\n\n/** Aggregate metadata for one anchor, derived from the comment list. */\nexport type CommentAnchorMeta = {\n  count: number;\n  authors: string[];\n  latestStatus?: string;\n};\n\n/** Selected filter state for the filter bar / `applyCommentFilters`. */\nexport type CommentFilters = {\n  /** Selected status values; empty = all statuses. */\n  statuses: Set<string>;\n  /** facet.key → selected option values; empty set = all values for that facet. */\n  facets: Record<string, Set<string>>;\n  /** Restrict to an author kind, or \"all\". */\n  authorKind?: CommentMentionKind | \"all\";\n};\n\n/** Optional renderers passed down to a card. */\nexport type CommentRenderOptions = {\n  /** Custom comment-body renderer (e.g. full Markdown). Defaults to CommentMarkdown. */\n  renderBody?: (body: string) => ReactNode;\n};\n\n/** A domain-free default status set: open / in progress / resolved. */\nexport const DEFAULT_COMMENT_STATUSES: CommentStatusConfig[] = [\n  { value: \"open\", label: \"Open\", tone: \"info\", unresolved: true },\n  {\n    value: \"in_progress\",\n    label: \"In progress\",\n    tone: \"warning\",\n    unresolved: true,\n  },\n  { value: \"resolved\", label: \"Resolved\", tone: \"success\" },\n  { value: \"closed\", label: \"Closed\", tone: \"neutral\" },\n];\n\n/** Default checklist status cycle used when a consumer omits one. */\nexport const DEFAULT_CHECKLIST_CYCLE = [\"open\", \"in_progress\", \"done\"];\n"],"names":[],"mappings":"AAsGO,MAAM,kBAAkB;AA6FxB,MAAM,2BAAkD;AAAA,EAC7D,EAAE,OAAO,QAAQ,OAAO,QAAQ,MAAM,QAAQ,YAAY,KAAA;AAAA,EAC1D;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,MAAM;AAAA,IACN,YAAY;AAAA,EAAA;AAAA,EAEd,EAAE,OAAO,YAAY,OAAO,YAAY,MAAM,UAAA;AAAA,EAC9C,EAAE,OAAO,UAAU,OAAO,UAAU,MAAM,UAAA;AAC5C;AAGO,MAAM,0BAA0B,CAAC,QAAQ,eAAe,MAAM;"}
+{"version":3,"file":"comment-types.js","sources":["../../src/comments/comment-types.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport type { StaticIconComponent } from \"../data/Icon\";\n\n/** Semantic tone driving a status/facet color (maps onto Badge tones). */\nexport type CommentTone =\n  | \"default\"\n  | \"info\"\n  | \"success\"\n  | \"warning\"\n  | \"danger\"\n  | \"neutral\";\n\n/** A single selectable status (e.g. \"open\", \"resolved\"). Consumer-defined. */\nexport type CommentStatusConfig = {\n  /** Stable value stored on a comment's `status`. */\n  value: string;\n  /** Human label shown in menus and badges. */\n  label: string;\n  /** Color tone for the status chip. */\n  tone?: CommentTone;\n  /** Optional leading glyph. */\n  icon?: string | StaticIconComponent;\n  /**\n   * Whether this status counts as \"unresolved/open\" — drives progress tallies\n   * and which groups start expanded. Defaults to false.\n   */\n  unresolved?: boolean;\n};\n\n/** One option of a generic facet (e.g. a \"category\" value). */\nexport type CommentFacetOption = {\n  value: string;\n  label: string;\n  tone?: CommentTone;\n  /** Compact glyph for the collapsed card (e.g. \"BS\" for a category). */\n  short?: string;\n};\n\n/**\n * A generic, consumer-supplied classification axis. Replaces the financial\n * category/severity vocabulary — any app declares its own facets.\n */\nexport type CommentFacet = {\n  /** Key into `Comment.facets`. */\n  key: string;\n  label: string;\n  options: CommentFacetOption[];\n  /** Allow several values to be selected at once in the filter bar. */\n  multiple?: boolean;\n};\n\nexport type CommentMentionKind = \"user\" | \"agent\";\n\n/** A person or agent that can be @-mentioned in the composer. */\nexport type CommentMentionable = {\n  id: string;\n  name: string;\n  /** Image URL for `kind: \"user\"`. */\n  avatar?: string;\n  kind: CommentMentionKind;\n  /** Glyph override for `kind: \"agent\"`. */\n  icon?: string | StaticIconComponent;\n};\n\n/** A resolved mention emitted when a comment referencing a mentionable is posted. */\nexport type CommentMention = {\n  id: string;\n  name: string;\n  kind: CommentMentionKind;\n};\n\n/** A labelled group of reference chips (e.g. linked ids). */\nexport type CommentRefGroup = {\n  label: string;\n  items: string[];\n  /** Render items in a monospace font. */\n  mono?: boolean;\n};\n\n/** One item of a generic checklist; `status` cycles through `checklistStatusCycle`. */\nexport type CommentChecklistItem = {\n  label: string;\n  status: string;\n};\n\nexport type CommentAuthor = {\n  id?: string;\n  name: string;\n  kind?: CommentMentionKind;\n  avatar?: string;\n  /** Glyph override for `kind: \"agent\"` authors. */\n  icon?: string | StaticIconComponent;\n};\n\n/**\n * An opaque anchor key locating a comment within a document. Not a JSON path —\n * any stable string a consumer registers via the provider. `null`/absent means\n * document-level.\n */\nexport type CommentAnchor = string;\n\n/** Binary review signal attached to a root comment. */\nexport type CommentRating = \"positive\" | \"negative\";\n\n/** Anchor key reserved for document-level (un-anchored) comments. */\nexport const DOCUMENT_ANCHOR = \"__document__\";\n\n/** A single comment. Replies set `parentId`; roots leave it null. */\nexport type Comment = {\n  id: string;\n  body: string;\n  /** ISO-8601 creation time. */\n  createdAt: string;\n  /** ISO-8601 last-update time. */\n  updatedAt?: string;\n  author: CommentAuthor | null;\n  /** Key into the configured statuses; roots only. */\n  status?: string;\n  /** Parent comment id when this is a reply. */\n  parentId?: string | null;\n  /** Where the comment is anchored; null/absent = document-level. */\n  anchor?: CommentAnchor | null;\n  /** Optional positive/negative review signal; roots only. */\n  rating?: CommentRating;\n  /** facet.key → selected option value. */\n  facets?: Record<string, string>;\n  refs?: CommentRefGroup[];\n  checklist?: CommentChecklistItem[];\n};\n\n/** Payload for creating a new root comment. */\nexport type CommentCreateInput = {\n  body: string;\n  anchor?: CommentAnchor | null;\n  rating?: CommentRating;\n  facets?: Record<string, string>;\n  mentions?: CommentMention[];\n};\n\n/** Payload for replying to a comment. */\nexport type CommentReplyInput = {\n  parentId: string;\n  body: string;\n  anchor?: CommentAnchor | null;\n  mentions?: CommentMention[];\n};\n\n/**\n * Controlled callbacks. The components own no data fetching; the consumer\n * performs the mutation and feeds the updated `comments` back in.\n */\nexport type CommentCallbacks = {\n  onCreate?: (input: CommentCreateInput) => void | Promise<void>;\n  onReply?: (input: CommentReplyInput) => void | Promise<void>;\n  onUpdateStatus?: (id: string, status: string) => void | Promise<void>;\n  onUpdateRating?: (id: string, rating: CommentRating) => void | Promise<void>;\n  onDelete?: (id: string) => void | Promise<void>;\n  onChecklistToggle?: (\n    id: string,\n    index: number,\n    next: string,\n  ) => void | Promise<void>;\n  /** Fired when a posted comment references a mentionable. */\n  onMention?: (mention: CommentMention, context: { body: string }) => void;\n};\n\n/** Static configuration shared across the comment components. */\nexport type CommentConfig = {\n  /** Selectable statuses; the first `unresolved` one is the default for new comments. */\n  statuses: CommentStatusConfig[];\n  /** Classification axes (category/severity/etc.). */\n  facets?: CommentFacet[];\n  /** People/agents available for @-mention. */\n  mentionables?: CommentMentionable[];\n  /** Status values a checklist item cycles through on click. */\n  checklistStatusCycle?: string[];\n};\n\n/** Aggregate metadata for one anchor, derived from the comment list. */\nexport type CommentAnchorMeta = {\n  count: number;\n  authors: string[];\n  latestStatus?: string;\n};\n\n/** Selected filter state for the filter bar / `applyCommentFilters`. */\nexport type CommentFilters = {\n  /** Selected status values; empty = all statuses. */\n  statuses: Set<string>;\n  /** facet.key → selected option values; empty set = all values for that facet. */\n  facets: Record<string, Set<string>>;\n  /** Restrict to an author kind, or \"all\". */\n  authorKind?: CommentMentionKind | \"all\";\n};\n\n/** Optional renderers passed down to a card. */\nexport type CommentRenderOptions = {\n  /** Custom comment-body renderer (e.g. full Markdown). Defaults to CommentMarkdown. */\n  renderBody?: (body: string) => ReactNode;\n};\n\n/** A domain-free default status set: open / in progress / resolved. */\nexport const DEFAULT_COMMENT_STATUSES: CommentStatusConfig[] = [\n  { value: \"open\", label: \"Open\", tone: \"info\", unresolved: true },\n  {\n    value: \"in_progress\",\n    label: \"In progress\",\n    tone: \"warning\",\n    unresolved: true,\n  },\n  { value: \"resolved\", label: \"Resolved\", tone: \"success\" },\n  { value: \"closed\", label: \"Closed\", tone: \"neutral\" },\n];\n\n/** Default checklist status cycle used when a consumer omits one. */\nexport const DEFAULT_CHECKLIST_CYCLE = [\"open\", \"in_progress\", \"done\"];\n"],"names":[],"mappings":"AAyGO,MAAM,kBAAkB;AAiGxB,MAAM,2BAAkD;AAAA,EAC7D,EAAE,OAAO,QAAQ,OAAO,QAAQ,MAAM,QAAQ,YAAY,KAAA;AAAA,EAC1D;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,MAAM;AAAA,IACN,YAAY;AAAA,EAAA;AAAA,EAEd,EAAE,OAAO,YAAY,OAAO,YAAY,MAAM,UAAA;AAAA,EAC9C,EAAE,OAAO,UAAU,OAAO,UAAU,MAAM,UAAA;AAC5C;AAGO,MAAM,0BAA0B,CAAC,QAAQ,eAAe,MAAM;"}