@flanksource/clicky-ui 0.3.55 → 0.3.56

package/dist/comments/CommentProvider.cjs

@@ -9,7 +9,7 @@ let react_jsx_runtime = require("react/jsx-runtime");
 * `registerAnchor` so the side panel can scroll-align to them). Owns no
 * fetching — `comments` and the callbacks are controlled by the consumer.
 */
-function CommentProvider({ children, comments, config, resolveAnchor = require_comment_context.exactAnchorResolver, onRailModeChange, onScrollToAnchor, getAnchorTop: externalAnchorTop, onCreate, onReply, onUpdateStatus, onClose, onUpdateRating, onDelete, onChecklistToggle, onMention, initialRailMode = "closed" }) {
+function CommentProvider({ children, comments, config, resolveAnchor = require_comment_context.exactAnchorResolver, onRailModeChange, onScrollToAnchor, getAnchorTop: externalAnchorTop, onCreate, onReply, onUpdateStatus, onClose, onAcknowledge, onAssign, onUpdateRating, onDelete, onChecklistToggle, onMention, initialRailMode = "closed" }) {
 	const [railMode, setRailMode] = (0, react.useState)(initialRailMode);
 	const [focusedAnchor, setFocusedAnchor] = (0, react.useState)(null);
 	const [highlightAnchor, setHighlightAnchor] = (0, react.useState)(null);
@@ -96,6 +96,8 @@ function CommentProvider({ children, comments, config, resolveAnchor = require_c
 		...onReply ? { onReply } : {},
 		...onUpdateStatus ? { onUpdateStatus } : {},
 		...onClose ? { onClose } : {},
+		...onAcknowledge ? { onAcknowledge } : {},
+		...onAssign ? { onAssign } : {},
 		...onUpdateRating ? { onUpdateRating } : {},
 		...onDelete ? { onDelete } : {},
 		...onChecklistToggle ? { onChecklistToggle } : {},
@@ -105,6 +107,8 @@ function CommentProvider({ children, comments, config, resolveAnchor = require_c
 		onReply,
 		onUpdateStatus,
 		onClose,
+		onAcknowledge,
+		onAssign,
 		onUpdateRating,
 		onDelete,
 		onChecklistToggle,

package/dist/comments/CommentProvider.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"CommentProvider.cjs","names":["exactAnchorResolver","useState","useRef","useMemo","deriveAnchorCounts","deriveAnchorMeta","createCommentAnchorStore","useCallback","CommentAnchorStoreContext","CommentAnchorActionsContext","CommentContext"],"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  /** Delegate navigation when the annotated document lives outside this frame. */\n  onScrollToAnchor?: (\n    anchor: CommentAnchor,\n    options: CommentScrollOptions\n  ) => boolean;\n  /** Report anchor geometry supplied by an external document. Null means unavailable. */\n  getAnchorTop?: (anchor: CommentAnchor) => number | null;\n  /**\n   * Rail mode on mount. Use \"all\" where the host already decided the rail is\n   * visible, so the reader is not asked to open it a second time.\n   */\n  initialRailMode?: CommentRailMode;\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  onScrollToAnchor,\n  getAnchorTop: externalAnchorTop,\n  onCreate,\n  onReply,\n  onUpdateStatus,\n  onClose,\n  onUpdateRating,\n  onDelete,\n  onChecklistToggle,\n  onMention,\n  initialRailMode = \"closed\",\n}: CommentProviderProps) {\n  const [railMode, setRailMode] = useState<CommentRailMode>(initialRailMode);\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>(initialRailMode);\n  const onRailModeChangeRef = useRef(onRailModeChange);\n  const onScrollToAnchorRef = useRef(onScrollToAnchor);\n  const externalAnchorTopRef = useRef(externalAnchorTop);\n  externalAnchorTopRef.current = externalAnchorTop;\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    onScrollToAnchorRef.current = onScrollToAnchor;\n    resolveAnchorRef.current = resolveAnchor;\n  }, [onRailModeChange, onScrollToAnchor, externalAnchorTop, 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    if (externalAnchorTopRef.current)\n      return externalAnchorTopRef.current(anchor);\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      if (onScrollToAnchorRef.current)\n        return onScrollToAnchorRef.current(anchor, options);\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      ...(onClose ? { onClose } : {}),\n      ...(onUpdateRating ? { onUpdateRating } : {}),\n      ...(onDelete ? { onDelete } : {}),\n      ...(onChecklistToggle ? { onChecklistToggle } : {}),\n      ...(onMention ? { onMention } : {}),\n    }),\n    [\n      onCreate,\n      onReply,\n      onUpdateStatus,\n      onClose,\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"],"mappings":"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"}
+{"version":3,"file":"CommentProvider.cjs","names":["exactAnchorResolver","useState","useRef","useMemo","deriveAnchorCounts","deriveAnchorMeta","createCommentAnchorStore","useCallback","CommentAnchorStoreContext","CommentAnchorActionsContext","CommentContext"],"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  /** Delegate navigation when the annotated document lives outside this frame. */\n  onScrollToAnchor?: (\n    anchor: CommentAnchor,\n    options: CommentScrollOptions\n  ) => boolean;\n  /** Report anchor geometry supplied by an external document. Null means unavailable. */\n  getAnchorTop?: (anchor: CommentAnchor) => number | null;\n  /**\n   * Rail mode on mount. Use \"all\" where the host already decided the rail is\n   * visible, so the reader is not asked to open it a second time.\n   */\n  initialRailMode?: CommentRailMode;\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  onScrollToAnchor,\n  getAnchorTop: externalAnchorTop,\n  onCreate,\n  onReply,\n  onUpdateStatus,\n  onClose,\n  onAcknowledge,\n  onAssign,\n  onUpdateRating,\n  onDelete,\n  onChecklistToggle,\n  onMention,\n  initialRailMode = \"closed\",\n}: CommentProviderProps) {\n  const [railMode, setRailMode] = useState<CommentRailMode>(initialRailMode);\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>(initialRailMode);\n  const onRailModeChangeRef = useRef(onRailModeChange);\n  const onScrollToAnchorRef = useRef(onScrollToAnchor);\n  const externalAnchorTopRef = useRef(externalAnchorTop);\n  externalAnchorTopRef.current = externalAnchorTop;\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    onScrollToAnchorRef.current = onScrollToAnchor;\n    resolveAnchorRef.current = resolveAnchor;\n  }, [onRailModeChange, onScrollToAnchor, externalAnchorTop, 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    if (externalAnchorTopRef.current)\n      return externalAnchorTopRef.current(anchor);\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      if (onScrollToAnchorRef.current)\n        return onScrollToAnchorRef.current(anchor, options);\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      ...(onClose ? { onClose } : {}),\n      ...(onAcknowledge ? { onAcknowledge } : {}),\n      ...(onAssign ? { onAssign } : {}),\n      ...(onUpdateRating ? { onUpdateRating } : {}),\n      ...(onDelete ? { onDelete } : {}),\n      ...(onChecklistToggle ? { onChecklistToggle } : {}),\n      ...(onMention ? { onMention } : {}),\n    }),\n    [\n      onCreate,\n      onReply,\n      onUpdateStatus,\n      onClose,\n      onAcknowledge,\n      onAssign,\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"],"mappings":"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"}

package/dist/comments/CommentProvider.d.ts

@@ -26,5 +26,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, onScrollToAnchor, getAnchorTop: externalAnchorTop, onCreate, onReply, onUpdateStatus, onClose, onUpdateRating, onDelete, onChecklistToggle, onMention, initialRailMode, }: CommentProviderProps): import("react").JSX.Element;
+export declare function CommentProvider({ children, comments, config, resolveAnchor, onRailModeChange, onScrollToAnchor, getAnchorTop: externalAnchorTop, onCreate, onReply, onUpdateStatus, onClose, onAcknowledge, onAssign, onUpdateRating, onDelete, onChecklistToggle, onMention, initialRailMode, }: CommentProviderProps): import("react").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,EACpB,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,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;IACnD,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,CACjB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,oBAAoB,KAC1B,OAAO,CAAC;IACb,uFAAuF;IACvF,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,MAAM,GAAG,IAAI,CAAC;IACxD;;;OAGG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,aAAmC,EACnC,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EAAE,iBAAiB,EAC/B,QAAQ,EACR,OAAO,EACP,cAAc,EACd,OAAO,EACP,cAAc,EACd,QAAQ,EACR,iBAAiB,EACjB,SAAS,EACT,eAA0B,GAC3B,EAAE,oBAAoB,+BAoMtB"}
+{"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,EACpB,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,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;IACnD,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,CACjB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,oBAAoB,KAC1B,OAAO,CAAC;IACb,uFAAuF;IACvF,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,MAAM,GAAG,IAAI,CAAC;IACxD;;;OAGG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,aAAmC,EACnC,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EAAE,iBAAiB,EAC/B,QAAQ,EACR,OAAO,EACP,cAAc,EACd,OAAO,EACP,aAAa,EACb,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,iBAAiB,EACjB,SAAS,EACT,eAA0B,GAC3B,EAAE,oBAAoB,+BAwMtB"}

package/dist/comments/CommentProvider.js

@@ -9,7 +9,7 @@ import { jsx } from "react/jsx-runtime";
 * `registerAnchor` so the side panel can scroll-align to them). Owns no
 * fetching — `comments` and the callbacks are controlled by the consumer.
 */
-function CommentProvider({ children, comments, config, resolveAnchor = exactAnchorResolver, onRailModeChange, onScrollToAnchor, getAnchorTop: externalAnchorTop, onCreate, onReply, onUpdateStatus, onClose, onUpdateRating, onDelete, onChecklistToggle, onMention, initialRailMode = "closed" }) {
+function CommentProvider({ children, comments, config, resolveAnchor = exactAnchorResolver, onRailModeChange, onScrollToAnchor, getAnchorTop: externalAnchorTop, onCreate, onReply, onUpdateStatus, onClose, onAcknowledge, onAssign, onUpdateRating, onDelete, onChecklistToggle, onMention, initialRailMode = "closed" }) {
 	const [railMode, setRailMode] = useState(initialRailMode);
 	const [focusedAnchor, setFocusedAnchor] = useState(null);
 	const [highlightAnchor, setHighlightAnchor] = useState(null);
@@ -96,6 +96,8 @@ function CommentProvider({ children, comments, config, resolveAnchor = exactAnch
 		...onReply ? { onReply } : {},
 		...onUpdateStatus ? { onUpdateStatus } : {},
 		...onClose ? { onClose } : {},
+		...onAcknowledge ? { onAcknowledge } : {},
+		...onAssign ? { onAssign } : {},
 		...onUpdateRating ? { onUpdateRating } : {},
 		...onDelete ? { onDelete } : {},
 		...onChecklistToggle ? { onChecklistToggle } : {},
@@ -105,6 +107,8 @@ function CommentProvider({ children, comments, config, resolveAnchor = exactAnch
 		onReply,
 		onUpdateStatus,
 		onClose,
+		onAcknowledge,
+		onAssign,
 		onUpdateRating,
 		onDelete,
 		onChecklistToggle,

package/dist/comments/CommentProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"CommentProvider.js","names":[],"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  /** Delegate navigation when the annotated document lives outside this frame. */\n  onScrollToAnchor?: (\n    anchor: CommentAnchor,\n    options: CommentScrollOptions\n  ) => boolean;\n  /** Report anchor geometry supplied by an external document. Null means unavailable. */\n  getAnchorTop?: (anchor: CommentAnchor) => number | null;\n  /**\n   * Rail mode on mount. Use \"all\" where the host already decided the rail is\n   * visible, so the reader is not asked to open it a second time.\n   */\n  initialRailMode?: CommentRailMode;\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  onScrollToAnchor,\n  getAnchorTop: externalAnchorTop,\n  onCreate,\n  onReply,\n  onUpdateStatus,\n  onClose,\n  onUpdateRating,\n  onDelete,\n  onChecklistToggle,\n  onMention,\n  initialRailMode = \"closed\",\n}: CommentProviderProps) {\n  const [railMode, setRailMode] = useState<CommentRailMode>(initialRailMode);\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>(initialRailMode);\n  const onRailModeChangeRef = useRef(onRailModeChange);\n  const onScrollToAnchorRef = useRef(onScrollToAnchor);\n  const externalAnchorTopRef = useRef(externalAnchorTop);\n  externalAnchorTopRef.current = externalAnchorTop;\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    onScrollToAnchorRef.current = onScrollToAnchor;\n    resolveAnchorRef.current = resolveAnchor;\n  }, [onRailModeChange, onScrollToAnchor, externalAnchorTop, 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    if (externalAnchorTopRef.current)\n      return externalAnchorTopRef.current(anchor);\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      if (onScrollToAnchorRef.current)\n        return onScrollToAnchorRef.current(anchor, options);\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      ...(onClose ? { onClose } : {}),\n      ...(onUpdateRating ? { onUpdateRating } : {}),\n      ...(onDelete ? { onDelete } : {}),\n      ...(onChecklistToggle ? { onChecklistToggle } : {}),\n      ...(onMention ? { onMention } : {}),\n    }),\n    [\n      onCreate,\n      onReply,\n      onUpdateStatus,\n      onClose,\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"],"mappings":"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"}
+{"version":3,"file":"CommentProvider.js","names":[],"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  /** Delegate navigation when the annotated document lives outside this frame. */\n  onScrollToAnchor?: (\n    anchor: CommentAnchor,\n    options: CommentScrollOptions\n  ) => boolean;\n  /** Report anchor geometry supplied by an external document. Null means unavailable. */\n  getAnchorTop?: (anchor: CommentAnchor) => number | null;\n  /**\n   * Rail mode on mount. Use \"all\" where the host already decided the rail is\n   * visible, so the reader is not asked to open it a second time.\n   */\n  initialRailMode?: CommentRailMode;\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  onScrollToAnchor,\n  getAnchorTop: externalAnchorTop,\n  onCreate,\n  onReply,\n  onUpdateStatus,\n  onClose,\n  onAcknowledge,\n  onAssign,\n  onUpdateRating,\n  onDelete,\n  onChecklistToggle,\n  onMention,\n  initialRailMode = \"closed\",\n}: CommentProviderProps) {\n  const [railMode, setRailMode] = useState<CommentRailMode>(initialRailMode);\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>(initialRailMode);\n  const onRailModeChangeRef = useRef(onRailModeChange);\n  const onScrollToAnchorRef = useRef(onScrollToAnchor);\n  const externalAnchorTopRef = useRef(externalAnchorTop);\n  externalAnchorTopRef.current = externalAnchorTop;\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    onScrollToAnchorRef.current = onScrollToAnchor;\n    resolveAnchorRef.current = resolveAnchor;\n  }, [onRailModeChange, onScrollToAnchor, externalAnchorTop, 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    if (externalAnchorTopRef.current)\n      return externalAnchorTopRef.current(anchor);\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      if (onScrollToAnchorRef.current)\n        return onScrollToAnchorRef.current(anchor, options);\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      ...(onClose ? { onClose } : {}),\n      ...(onAcknowledge ? { onAcknowledge } : {}),\n      ...(onAssign ? { onAssign } : {}),\n      ...(onUpdateRating ? { onUpdateRating } : {}),\n      ...(onDelete ? { onDelete } : {}),\n      ...(onChecklistToggle ? { onChecklistToggle } : {}),\n      ...(onMention ? { onMention } : {}),\n    }),\n    [\n      onCreate,\n      onReply,\n      onUpdateStatus,\n      onClose,\n      onAcknowledge,\n      onAssign,\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"],"mappings":"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"}

package/dist/comments/CommentSidePanel.cjs

@@ -29,7 +29,7 @@ function RailToggle({ active, onClick, children, testId }) {
 		type: "button",
 		onClick,
 		"data-testid": testId,
-		className: require_utils.cn("inline-flex items-center gap-1.5 rounded-full border px-3 py-1.5 text-xs font-medium shadow-sm transition-colors", active ? "border-primary bg-primary text-primary-foreground" : "border-border bg-background text-muted-foreground hover:text-foreground"),
+		className: require_utils.cn("inline-flex items-center gap-1.5 rounded-full border px-3 py-1.5 text-xs font-medium shadow-sm transition-colors [@media(pointer:coarse)]:min-h-11 [@media(pointer:coarse)]:text-sm", active ? "border-primary bg-primary text-primary-foreground" : "border-border bg-background text-muted-foreground hover:text-foreground"),
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_Icon.Icon, {
 			icon: require_UiComment.UiComment,
 			className: "text-xs"
@@ -59,7 +59,7 @@ function orderComments(comments, anchorOrder) {
 		return String(a.id).localeCompare(String(b.id));
 	}).flatMap((root) => [root, ...require_comment_utils.sortReplies(replyMap.get(root.id) ?? [])]);
 }
-function AllComments({ ctx, comments, label, emptyLabel, threadToMarkdown, renderRootDetails }) {
+function AllComments({ ctx, comments, label, emptyLabel, threadToMarkdown, renderRootDetails, extraAssignItems }) {
 	const ordered = (0, react.useMemo)(() => {
 		return orderComments(comments, new Map(orderedAnchors(ctx).map((a, i) => [a, i])));
 	}, [ctx, comments]);
@@ -102,11 +102,12 @@ function AllComments({ ctx, comments, label, emptyLabel, threadToMarkdown, rende
 			}),
 			...handlers,
 			...renderRootDetails ? { renderRootDetails } : {},
+			...extraAssignItems ? { extraAssignItems } : {},
 			...threadToMarkdown ? { threadToMarkdown } : {}
 		})
 	});
 }
-function FocusedComments({ ctx, comments: visible, anchor, label, compact, threadToMarkdown, renderRootDetails, createActions }) {
+function FocusedComments({ ctx, comments: visible, anchor, label, compact, threadToMarkdown, renderRootDetails, createActions, extraAssignItems }) {
 	const comments = require_comment_utils.selectAnchorThreads(visible, anchor);
 	const hasComments = comments.length > 0;
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -123,6 +124,7 @@ function FocusedComments({ ctx, comments: visible, anchor, label, compact, threa
 			...ctx.callbacks,
 			...renderRootDetails ? { renderRootDetails } : {},
 			...createActions ? { createActions } : {},
+			...extraAssignItems ? { extraAssignItems } : {},
 			...threadToMarkdown ? { threadToMarkdown } : {}
 		})]
 	});
@@ -151,7 +153,9 @@ function CommentSidePanel(props) {
 		if (!content || !rail || !focused) return;
 		const update = () => {
 			const anchorTop = ctx.getAnchorTop(focusedAnchor);
-			if (anchorTop == null) {
+			const contentBox = content.getBoundingClientRect();
+			const stacked = contentBox.height > 0 && rail.getBoundingClientRect().top >= contentBox.bottom;
+			if (anchorTop == null || stacked) {
 				setFocusedOffset(null);
 				return;
 			}
@@ -194,10 +198,10 @@ function CommentSidePanel(props) {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("aside", {
 		ref: railRef,
 		"data-testid": "comment-side-panel",
-		className: require_utils.cn("relative w-[320px] space-y-3", props.className),
+		className: require_utils.cn("relative w-[320px] max-w-full space-y-3", props.className),
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 			"data-testid": "comment-rail-header",
-			className: "sticky top-0 z-20 flex items-center gap-2 bg-background py-2",
+			className: "sticky top-0 z-20 flex flex-wrap items-center gap-2 bg-background py-2",
 			children: [
 				(counts.active > 0 || ctx.railMode === "all") && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RailToggle, {
 					active: ctx.railMode === "all" && stage === "active",
@@ -209,7 +213,7 @@ function CommentSidePanel(props) {
 					type: "button",
 					"aria-pressed": ctx.railMode === "all" && stage === "resolved",
 					onClick: () => selectStage("resolved"),
-					className: require_utils.cn("rounded-full border px-2 py-1 text-xs font-medium transition-colors", ctx.railMode === "all" && stage === "resolved" ? "border-primary bg-primary text-primary-foreground" : "border-border bg-background text-muted-foreground hover:text-foreground"),
+					className: require_utils.cn("rounded-full border px-2 py-1 text-xs font-medium transition-colors [@media(pointer:coarse)]:min-h-11 [@media(pointer:coarse)]:px-3 [@media(pointer:coarse)]:text-sm", ctx.railMode === "all" && stage === "resolved" ? "border-primary bg-primary text-primary-foreground" : "border-border bg-background text-muted-foreground hover:text-foreground"),
 					children: [
 						"Resolved (",
 						counts.resolved,
@@ -220,7 +224,7 @@ function CommentSidePanel(props) {
 					type: "button",
 					"aria-pressed": ctx.railMode === "all" && stage === "closed",
 					onClick: () => selectStage("closed"),
-					className: require_utils.cn("rounded-full border px-2 py-1 text-xs font-medium transition-colors", ctx.railMode === "all" && stage === "closed" ? "border-primary bg-primary text-primary-foreground" : "border-border bg-background text-muted-foreground hover:text-foreground"),
+					className: require_utils.cn("rounded-full border px-2 py-1 text-xs font-medium transition-colors [@media(pointer:coarse)]:min-h-11 [@media(pointer:coarse)]:px-3 [@media(pointer:coarse)]:text-sm", ctx.railMode === "all" && stage === "closed" ? "border-primary bg-primary text-primary-foreground" : "border-border bg-background text-muted-foreground hover:text-foreground"),
 					children: [
 						"Closed (",
 						counts.closed,
@@ -230,7 +234,7 @@ function CommentSidePanel(props) {
 				ctx.railMode !== "closed" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 					type: "button",
 					onClick: ctx.closeRail,
-					className: "ml-auto rounded-md px-2 py-1 text-xs font-medium text-muted-foreground hover:bg-muted hover:text-foreground",
+					className: "ml-auto rounded-md px-2 py-1 text-xs font-medium text-muted-foreground hover:bg-muted hover:text-foreground [@media(pointer:coarse)]:min-h-11 [@media(pointer:coarse)]:px-3 [@media(pointer:coarse)]:text-sm",
 					children: ctx.railMode === "all" ? "Close" : "Hide"
 				})
 			]
@@ -240,7 +244,8 @@ function CommentSidePanel(props) {
 			label,
 			emptyLabel: stage === "active" ? "No open comments." : stage === "resolved" ? "No resolved comments." : "No closed comments.",
 			...props.threadToMarkdown ? { threadToMarkdown: props.threadToMarkdown } : {},
-			...props.renderRootDetails ? { renderRootDetails: props.renderRootDetails } : {}
+			...props.renderRootDetails ? { renderRootDetails: props.renderRootDetails } : {},
+			...props.extraAssignItems ? { extraAssignItems: props.extraAssignItems } : {}
 		}) : ctx.railMode === "focused" && ctx.focusedAnchor ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 			ref: focusedRef,
 			"data-testid": "comment-focused-rail",
@@ -254,7 +259,8 @@ function CommentSidePanel(props) {
 				label: label(ctx.focusedAnchor),
 				...props.compact !== void 0 ? { compact: props.compact } : {},
 				...props.threadToMarkdown ? { threadToMarkdown: props.threadToMarkdown } : {},
-				...props.renderRootDetails ? { renderRootDetails: props.renderRootDetails } : {}
+				...props.renderRootDetails ? { renderRootDetails: props.renderRootDetails } : {},
+				...props.extraAssignItems ? { extraAssignItems: props.extraAssignItems } : {}
 			})
 		}) : null]
 	});

package/dist/comments/CommentSidePanel.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"CommentSidePanel.cjs","names":["cn","Icon","UiComment","buildReplyMap","getRoots","sortReplies","useMemo","buildThreadListHandlers","CommentThreadList","selectAnchorThreads","CommentThread","useCommentContextOptional","useRef","useState","resolveCommentStage","selectCommentThreadsByStage"],"sources":["../../src/comments/CommentSidePanel.tsx"],"sourcesContent":["import {\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  type MouseEvent,\n  type ReactNode,\n} 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  selectAnchorThreads,\n  sortReplies,\n  buildReplyMap,\n} from \"./comment-utils\";\nimport {\n  resolveCommentStage,\n  selectCommentThreadsByStage,\n} from \"../lib/comment-stage\";\nimport {\n  DOCUMENT_ANCHOR,\n  type Comment,\n  type CommentAnchor,\n  type CommentCreateAction,\n  type CommentStatusStage,\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  /** Serialize one whole thread for Copy and its maximized Markdown tab. */\n  threadToMarkdown?: (thread: readonly Comment[]) => string;\n  renderRootDetails?: (comment: Comment) => ReactNode;\n  createActions?: readonly CommentCreateAction[];\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  comments,\n  label,\n  emptyLabel,\n  threadToMarkdown,\n  renderRootDetails,\n}: {\n  ctx: CommentContextValue;\n  comments: Comment[];\n  label: (a: CommentAnchor) => string;\n  emptyLabel: string;\n  threadToMarkdown?: (thread: readonly Comment[]) => string;\n  renderRootDetails?: (comment: Comment) => ReactNode;\n}) {\n  const ordered = useMemo(() => {\n    const anchorOrder = new Map(orderedAnchors(ctx).map((a, i) => [a, i]));\n    return orderComments(comments, anchorOrder);\n  }, [ctx, comments]);\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, details, 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        {emptyLabel}\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        {...(renderRootDetails ? { renderRootDetails } : {})}\n        {...(threadToMarkdown ? { threadToMarkdown } : {})}\n      />\n    </div>\n  );\n}\n\nfunction FocusedComments({\n  ctx,\n  comments: visible,\n  anchor,\n  label,\n  compact,\n  threadToMarkdown,\n  renderRootDetails,\n  createActions,\n}: {\n  ctx: CommentContextValue;\n  comments: Comment[];\n  anchor: CommentAnchor;\n  label: string;\n  compact?: boolean;\n  threadToMarkdown?: (thread: readonly Comment[]) => string;\n  renderRootDetails?: (comment: Comment) => ReactNode;\n  createActions?: readonly CommentCreateAction[];\n}) {\n  const comments = selectAnchorThreads(visible, anchor);\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        defaultExpanded={hasComments}\n        composerPlaceholder={\n          hasComments ? \"Add another top-level comment…\" : \"Add a comment…\"\n        }\n        {...ctx.callbacks}\n        {...(renderRootDetails ? { renderRootDetails } : {})}\n        {...(createActions ? { createActions } : {})}\n        {...(threadToMarkdown ? { threadToMarkdown } : {})}\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 [stage, setStage] = useState<CommentStatusStage>(\"active\");\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  // Threads, not cards: a reply is part of its root, never a separate entry.\n  const counts = getRoots(ctx.comments).reduce(\n    (result, root) => {\n      const rootStage = resolveCommentStage(ctx.config, root.status);\n      if (rootStage) result[rootStage] += 1;\n      return result;\n    },\n    { active: 0, resolved: 0, closed: 0 },\n  );\n  const visible = selectCommentThreadsByStage(ctx.comments, ctx.config, stage);\n  if (\n    ctx.railMode === \"closed\" &&\n    counts.active + counts.resolved + counts.closed === 0\n  )\n    return null;\n\n  function selectStage(next: CommentStatusStage) {\n    setStage(next);\n    if (ctx?.railMode !== \"all\") ctx?.openCommentList();\n  }\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      <div\n        data-testid=\"comment-rail-header\"\n        className=\"sticky top-0 z-20 flex items-center gap-2 bg-background py-2\"\n      >\n        {(counts.active > 0 || ctx.railMode === \"all\") && (\n          <RailToggle\n            active={ctx.railMode === \"all\" && stage === \"active\"}\n            onClick={() => selectStage(\"active\")}\n            testId=\"comment-open-all\"\n          >\n            {ctx.railMode === \"closed\"\n              ? `Open comments (${counts.active})`\n              : ctx.railMode === \"focused\"\n                ? `All comments (${counts.active})`\n                : `Open (${counts.active})`}\n          </RailToggle>\n        )}\n        {counts.resolved > 0 && (\n          <button\n            type=\"button\"\n            aria-pressed={ctx.railMode === \"all\" && stage === \"resolved\"}\n            onClick={() => selectStage(\"resolved\")}\n            className={cn(\n              \"rounded-full border px-2 py-1 text-xs font-medium transition-colors\",\n              ctx.railMode === \"all\" && stage === \"resolved\"\n                ? \"border-primary bg-primary text-primary-foreground\"\n                : \"border-border bg-background text-muted-foreground hover:text-foreground\",\n            )}\n          >\n            Resolved ({counts.resolved})\n          </button>\n        )}\n        {counts.closed > 0 && (\n          <button\n            type=\"button\"\n            aria-pressed={ctx.railMode === \"all\" && stage === \"closed\"}\n            onClick={() => selectStage(\"closed\")}\n            className={cn(\n              \"rounded-full border px-2 py-1 text-xs font-medium transition-colors\",\n              ctx.railMode === \"all\" && stage === \"closed\"\n                ? \"border-primary bg-primary text-primary-foreground\"\n                : \"border-border bg-background text-muted-foreground hover:text-foreground\",\n            )}\n          >\n            Closed ({counts.closed})\n          </button>\n        )}\n        {ctx.railMode !== \"closed\" && (\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            {ctx.railMode === \"all\" ? \"Close\" : \"Hide\"}\n          </button>\n        )}\n      </div>\n      {ctx.railMode === \"all\" ? (\n        <AllComments\n          ctx={ctx}\n          comments={visible}\n          label={label}\n          emptyLabel={\n            stage === \"active\"\n              ? \"No open comments.\"\n              : stage === \"resolved\"\n                ? \"No resolved comments.\"\n                : \"No closed comments.\"\n          }\n          {...(props.threadToMarkdown\n            ? { threadToMarkdown: props.threadToMarkdown }\n            : {})}\n          {...(props.renderRootDetails\n            ? { renderRootDetails: props.renderRootDetails }\n            : {})}\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          <FocusedComments\n            ctx={ctx}\n            comments={ctx.comments}\n            anchor={ctx.focusedAnchor}\n            {...(props.createActions\n              ? { createActions: props.createActions }\n              : {})}\n            label={label(ctx.focusedAnchor)}\n            {...(props.compact !== undefined ? { compact: props.compact } : {})}\n            {...(props.threadToMarkdown\n              ? { threadToMarkdown: props.threadToMarkdown }\n              : {})}\n            {...(props.renderRootDetails\n              ? { renderRootDetails: props.renderRootDetails }\n              : {})}\n          />\n        </div>\n      ) : null}\n    </aside>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"CommentSidePanel.cjs","names":["cn","Icon","UiComment","buildReplyMap","getRoots","sortReplies","useMemo","buildThreadListHandlers","CommentThreadList","selectAnchorThreads","CommentThread","useCommentContextOptional","useRef","useState","resolveCommentStage","selectCommentThreadsByStage"],"sources":["../../src/comments/CommentSidePanel.tsx"],"sourcesContent":["import {\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  type MouseEvent,\n  type ReactNode,\n} from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { Icon } from \"../data/Icon\";\nimport { UiComment } from \"../icons\";\nimport type { DropdownMenuItem } from \"../overlay/DropdownMenu\";\nimport { CommentThread } from \"./CommentThread\";\nimport { CommentThreadList } from \"./CommentThreadList\";\nimport {\n  useCommentContextOptional,\n  type CommentContextValue,\n} from \"./comment-context\";\nimport {\n  buildThreadListHandlers,\n  getRoots,\n  selectAnchorThreads,\n  sortReplies,\n  buildReplyMap,\n} from \"./comment-utils\";\nimport {\n  resolveCommentStage,\n  selectCommentThreadsByStage,\n} from \"../lib/comment-stage\";\nimport {\n  DOCUMENT_ANCHOR,\n  type Comment,\n  type CommentAnchor,\n  type CommentCreateAction,\n  type CommentStatusStage,\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  /** Serialize one whole thread for Copy and its maximized Markdown tab. */\n  threadToMarkdown?: (thread: readonly Comment[]) => string;\n  renderRootDetails?: (comment: Comment) => ReactNode;\n  createActions?: readonly CommentCreateAction[];\n  /**\n   * Entries appended to each root's \"Assign…\" submenu — the seam for host\n   * actions that start from an assignment, such as running an agent.\n   */\n  extraAssignItems?: (comment: Comment) => DropdownMenuItem[];\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 [@media(pointer:coarse)]:min-h-11 [@media(pointer:coarse)]:text-sm\",\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  comments,\n  label,\n  emptyLabel,\n  threadToMarkdown,\n  renderRootDetails,\n  extraAssignItems,\n}: {\n  ctx: CommentContextValue;\n  comments: Comment[];\n  label: (a: CommentAnchor) => string;\n  emptyLabel: string;\n  threadToMarkdown?: (thread: readonly Comment[]) => string;\n  renderRootDetails?: (comment: Comment) => ReactNode;\n  extraAssignItems?: (comment: Comment) => DropdownMenuItem[];\n}) {\n  const ordered = useMemo(() => {\n    const anchorOrder = new Map(orderedAnchors(ctx).map((a, i) => [a, i]));\n    return orderComments(comments, anchorOrder);\n  }, [ctx, comments]);\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, details, 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        {emptyLabel}\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        {...(renderRootDetails ? { renderRootDetails } : {})}\n        {...(extraAssignItems ? { extraAssignItems } : {})}\n        {...(threadToMarkdown ? { threadToMarkdown } : {})}\n      />\n    </div>\n  );\n}\n\nfunction FocusedComments({\n  ctx,\n  comments: visible,\n  anchor,\n  label,\n  compact,\n  threadToMarkdown,\n  renderRootDetails,\n  createActions,\n  extraAssignItems,\n}: {\n  ctx: CommentContextValue;\n  comments: Comment[];\n  anchor: CommentAnchor;\n  label: string;\n  compact?: boolean;\n  threadToMarkdown?: (thread: readonly Comment[]) => string;\n  renderRootDetails?: (comment: Comment) => ReactNode;\n  createActions?: readonly CommentCreateAction[];\n  extraAssignItems?: (comment: Comment) => DropdownMenuItem[];\n}) {\n  const comments = selectAnchorThreads(visible, anchor);\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        defaultExpanded={hasComments}\n        composerPlaceholder={\n          hasComments ? \"Add another top-level comment…\" : \"Add a comment…\"\n        }\n        {...ctx.callbacks}\n        {...(renderRootDetails ? { renderRootDetails } : {})}\n        {...(createActions ? { createActions } : {})}\n        {...(extraAssignItems ? { extraAssignItems } : {})}\n        {...(threadToMarkdown ? { threadToMarkdown } : {})}\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 [stage, setStage] = useState<CommentStatusStage>(\"active\");\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      // A rail stacked under the content (narrow screens) has no anchor row to\n      // line up with; offsetting it only pushes the thread out of view.\n      const contentBox = content.getBoundingClientRect();\n      const stacked =\n        contentBox.height > 0 &&\n        rail.getBoundingClientRect().top >= contentBox.bottom;\n      if (anchorTop == null || stacked) {\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  // Threads, not cards: a reply is part of its root, never a separate entry.\n  const counts = getRoots(ctx.comments).reduce(\n    (result, root) => {\n      const rootStage = resolveCommentStage(ctx.config, root.status);\n      if (rootStage) result[rootStage] += 1;\n      return result;\n    },\n    { active: 0, resolved: 0, closed: 0 },\n  );\n  const visible = selectCommentThreadsByStage(ctx.comments, ctx.config, stage);\n  if (\n    ctx.railMode === \"closed\" &&\n    counts.active + counts.resolved + counts.closed === 0\n  )\n    return null;\n\n  function selectStage(next: CommentStatusStage) {\n    setStage(next);\n    if (ctx?.railMode !== \"all\") ctx?.openCommentList();\n  }\n\n  return (\n    <aside\n      ref={railRef}\n      data-testid=\"comment-side-panel\"\n      className={cn(\"relative w-[320px] max-w-full space-y-3\", props.className)}\n    >\n      <div\n        data-testid=\"comment-rail-header\"\n        className=\"sticky top-0 z-20 flex flex-wrap items-center gap-2 bg-background py-2\"\n      >\n        {(counts.active > 0 || ctx.railMode === \"all\") && (\n          <RailToggle\n            active={ctx.railMode === \"all\" && stage === \"active\"}\n            onClick={() => selectStage(\"active\")}\n            testId=\"comment-open-all\"\n          >\n            {ctx.railMode === \"closed\"\n              ? `Open comments (${counts.active})`\n              : ctx.railMode === \"focused\"\n                ? `All comments (${counts.active})`\n                : `Open (${counts.active})`}\n          </RailToggle>\n        )}\n        {counts.resolved > 0 && (\n          <button\n            type=\"button\"\n            aria-pressed={ctx.railMode === \"all\" && stage === \"resolved\"}\n            onClick={() => selectStage(\"resolved\")}\n            className={cn(\n              \"rounded-full border px-2 py-1 text-xs font-medium transition-colors [@media(pointer:coarse)]:min-h-11 [@media(pointer:coarse)]:px-3 [@media(pointer:coarse)]:text-sm\",\n              ctx.railMode === \"all\" && stage === \"resolved\"\n                ? \"border-primary bg-primary text-primary-foreground\"\n                : \"border-border bg-background text-muted-foreground hover:text-foreground\",\n            )}\n          >\n            Resolved ({counts.resolved})\n          </button>\n        )}\n        {counts.closed > 0 && (\n          <button\n            type=\"button\"\n            aria-pressed={ctx.railMode === \"all\" && stage === \"closed\"}\n            onClick={() => selectStage(\"closed\")}\n            className={cn(\n              \"rounded-full border px-2 py-1 text-xs font-medium transition-colors [@media(pointer:coarse)]:min-h-11 [@media(pointer:coarse)]:px-3 [@media(pointer:coarse)]:text-sm\",\n              ctx.railMode === \"all\" && stage === \"closed\"\n                ? \"border-primary bg-primary text-primary-foreground\"\n                : \"border-border bg-background text-muted-foreground hover:text-foreground\",\n            )}\n          >\n            Closed ({counts.closed})\n          </button>\n        )}\n        {ctx.railMode !== \"closed\" && (\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 [@media(pointer:coarse)]:min-h-11 [@media(pointer:coarse)]:px-3 [@media(pointer:coarse)]:text-sm\"\n          >\n            {ctx.railMode === \"all\" ? \"Close\" : \"Hide\"}\n          </button>\n        )}\n      </div>\n      {ctx.railMode === \"all\" ? (\n        <AllComments\n          ctx={ctx}\n          comments={visible}\n          label={label}\n          emptyLabel={\n            stage === \"active\"\n              ? \"No open comments.\"\n              : stage === \"resolved\"\n                ? \"No resolved comments.\"\n                : \"No closed comments.\"\n          }\n          {...(props.threadToMarkdown\n            ? { threadToMarkdown: props.threadToMarkdown }\n            : {})}\n          {...(props.renderRootDetails\n            ? { renderRootDetails: props.renderRootDetails }\n            : {})}\n          {...(props.extraAssignItems\n            ? { extraAssignItems: props.extraAssignItems }\n            : {})}\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          <FocusedComments\n            ctx={ctx}\n            comments={ctx.comments}\n            anchor={ctx.focusedAnchor}\n            {...(props.createActions\n              ? { createActions: props.createActions }\n              : {})}\n            label={label(ctx.focusedAnchor)}\n            {...(props.compact !== undefined ? { compact: props.compact } : {})}\n            {...(props.threadToMarkdown\n              ? { threadToMarkdown: props.threadToMarkdown }\n              : {})}\n            {...(props.renderRootDetails\n              ? { renderRootDetails: props.renderRootDetails }\n              : {})}\n            {...(props.extraAssignItems\n              ? { extraAssignItems: props.extraAssignItems }\n              : {})}\n          />\n        </div>\n      ) : null}\n    </aside>\n  );\n}\n"],"mappings":"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"}

package/dist/comments/CommentSidePanel.d.ts

@@ -1,4 +1,5 @@
 import { ReactNode } from 'react';
+import { DropdownMenuItem } from '../overlay/DropdownMenu.js';
 import { Comment, CommentAnchor, CommentCreateAction } from './comment-types.js';
 export type CommentSidePanelProps = {
     /** Explicit label per anchor key. */
@@ -13,6 +14,11 @@ export type CommentSidePanelProps = {
     threadToMarkdown?: (thread: readonly Comment[]) => string;
     renderRootDetails?: (comment: Comment) => ReactNode;
     createActions?: readonly CommentCreateAction[];
+    /**
+     * Entries appended to each root's "Assign…" submenu — the seam for host
+     * actions that start from an assignment, such as running an agent.
+     */
+    extraAssignItems?: (comment: Comment) => DropdownMenuItem[];
 };
 /**
  * A controlled comment rail driven by {@link CommentProvider}. Shows a focused

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

@@ -1 +1 @@
-{"version":3,"file":"CommentSidePanel.d.ts","sourceRoot":"","sources":["../../src/comments/CommentSidePanel.tsx"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAqBf,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,mBAAmB,EAEzB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,qBAAqB,GAAG;IAClC,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC7C,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,MAAM,CAAC;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,KAAK,MAAM,CAAC;IAC1D,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,SAAS,CAAC;IACpD,aAAa,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAChD,CAAC;AAuOF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,sCAiL5D"}
+{"version":3,"file":"CommentSidePanel.d.ts","sourceRoot":"","sources":["../../src/comments/CommentSidePanel.tsx"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAIf,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAkBhE,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,mBAAmB,EAEzB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,qBAAqB,GAAG;IAClC,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC7C,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,MAAM,CAAC;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,KAAK,MAAM,CAAC;IAC1D,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,SAAS,CAAC;IACpD,aAAa,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,gBAAgB,EAAE,CAAC;CAC7D,CAAC;AA6OF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,sCA6L5D"}

package/dist/comments/CommentSidePanel.js

@@ -29,7 +29,7 @@ function RailToggle({ active, onClick, children, testId }) {
 		type: "button",
 		onClick,
 		"data-testid": testId,
-		className: cn("inline-flex items-center gap-1.5 rounded-full border px-3 py-1.5 text-xs font-medium shadow-sm transition-colors", active ? "border-primary bg-primary text-primary-foreground" : "border-border bg-background text-muted-foreground hover:text-foreground"),
+		className: cn("inline-flex items-center gap-1.5 rounded-full border px-3 py-1.5 text-xs font-medium shadow-sm transition-colors [@media(pointer:coarse)]:min-h-11 [@media(pointer:coarse)]:text-sm", active ? "border-primary bg-primary text-primary-foreground" : "border-border bg-background text-muted-foreground hover:text-foreground"),
 		children: [/* @__PURE__ */ jsx(Icon, {
 			icon: UiComment,
 			className: "text-xs"
@@ -59,7 +59,7 @@ function orderComments(comments, anchorOrder) {
 		return String(a.id).localeCompare(String(b.id));
 	}).flatMap((root) => [root, ...sortReplies(replyMap.get(root.id) ?? [])]);
 }
-function AllComments({ ctx, comments, label, emptyLabel, threadToMarkdown, renderRootDetails }) {
+function AllComments({ ctx, comments, label, emptyLabel, threadToMarkdown, renderRootDetails, extraAssignItems }) {
 	const ordered = useMemo(() => {
 		return orderComments(comments, new Map(orderedAnchors(ctx).map((a, i) => [a, i])));
 	}, [ctx, comments]);
@@ -102,11 +102,12 @@ function AllComments({ ctx, comments, label, emptyLabel, threadToMarkdown, rende
 			}),
 			...handlers,
 			...renderRootDetails ? { renderRootDetails } : {},
+			...extraAssignItems ? { extraAssignItems } : {},
 			...threadToMarkdown ? { threadToMarkdown } : {}
 		})
 	});
 }
-function FocusedComments({ ctx, comments: visible, anchor, label, compact, threadToMarkdown, renderRootDetails, createActions }) {
+function FocusedComments({ ctx, comments: visible, anchor, label, compact, threadToMarkdown, renderRootDetails, createActions, extraAssignItems }) {
 	const comments = selectAnchorThreads(visible, anchor);
 	const hasComments = comments.length > 0;
 	return /* @__PURE__ */ jsxs("div", {
@@ -123,6 +124,7 @@ function FocusedComments({ ctx, comments: visible, anchor, label, compact, threa
 			...ctx.callbacks,
 			...renderRootDetails ? { renderRootDetails } : {},
 			...createActions ? { createActions } : {},
+			...extraAssignItems ? { extraAssignItems } : {},
 			...threadToMarkdown ? { threadToMarkdown } : {}
 		})]
 	});
@@ -151,7 +153,9 @@ function CommentSidePanel(props) {
 		if (!content || !rail || !focused) return;
 		const update = () => {
 			const anchorTop = ctx.getAnchorTop(focusedAnchor);
-			if (anchorTop == null) {
+			const contentBox = content.getBoundingClientRect();
+			const stacked = contentBox.height > 0 && rail.getBoundingClientRect().top >= contentBox.bottom;
+			if (anchorTop == null || stacked) {
 				setFocusedOffset(null);
 				return;
 			}
@@ -194,10 +198,10 @@ function CommentSidePanel(props) {
 	return /* @__PURE__ */ jsxs("aside", {
 		ref: railRef,
 		"data-testid": "comment-side-panel",
-		className: cn("relative w-[320px] space-y-3", props.className),
+		className: cn("relative w-[320px] max-w-full space-y-3", props.className),
 		children: [/* @__PURE__ */ jsxs("div", {
 			"data-testid": "comment-rail-header",
-			className: "sticky top-0 z-20 flex items-center gap-2 bg-background py-2",
+			className: "sticky top-0 z-20 flex flex-wrap items-center gap-2 bg-background py-2",
 			children: [
 				(counts.active > 0 || ctx.railMode === "all") && /* @__PURE__ */ jsx(RailToggle, {
 					active: ctx.railMode === "all" && stage === "active",
@@ -209,7 +213,7 @@ function CommentSidePanel(props) {
 					type: "button",
 					"aria-pressed": ctx.railMode === "all" && stage === "resolved",
 					onClick: () => selectStage("resolved"),
-					className: cn("rounded-full border px-2 py-1 text-xs font-medium transition-colors", ctx.railMode === "all" && stage === "resolved" ? "border-primary bg-primary text-primary-foreground" : "border-border bg-background text-muted-foreground hover:text-foreground"),
+					className: cn("rounded-full border px-2 py-1 text-xs font-medium transition-colors [@media(pointer:coarse)]:min-h-11 [@media(pointer:coarse)]:px-3 [@media(pointer:coarse)]:text-sm", ctx.railMode === "all" && stage === "resolved" ? "border-primary bg-primary text-primary-foreground" : "border-border bg-background text-muted-foreground hover:text-foreground"),
 					children: [
 						"Resolved (",
 						counts.resolved,
@@ -220,7 +224,7 @@ function CommentSidePanel(props) {
 					type: "button",
 					"aria-pressed": ctx.railMode === "all" && stage === "closed",
 					onClick: () => selectStage("closed"),
-					className: cn("rounded-full border px-2 py-1 text-xs font-medium transition-colors", ctx.railMode === "all" && stage === "closed" ? "border-primary bg-primary text-primary-foreground" : "border-border bg-background text-muted-foreground hover:text-foreground"),
+					className: cn("rounded-full border px-2 py-1 text-xs font-medium transition-colors [@media(pointer:coarse)]:min-h-11 [@media(pointer:coarse)]:px-3 [@media(pointer:coarse)]:text-sm", ctx.railMode === "all" && stage === "closed" ? "border-primary bg-primary text-primary-foreground" : "border-border bg-background text-muted-foreground hover:text-foreground"),
 					children: [
 						"Closed (",
 						counts.closed,
@@ -230,7 +234,7 @@ function CommentSidePanel(props) {
 				ctx.railMode !== "closed" && /* @__PURE__ */ jsx("button", {
 					type: "button",
 					onClick: ctx.closeRail,
-					className: "ml-auto rounded-md px-2 py-1 text-xs font-medium text-muted-foreground hover:bg-muted hover:text-foreground",
+					className: "ml-auto rounded-md px-2 py-1 text-xs font-medium text-muted-foreground hover:bg-muted hover:text-foreground [@media(pointer:coarse)]:min-h-11 [@media(pointer:coarse)]:px-3 [@media(pointer:coarse)]:text-sm",
 					children: ctx.railMode === "all" ? "Close" : "Hide"
 				})
 			]
@@ -240,7 +244,8 @@ function CommentSidePanel(props) {
 			label,
 			emptyLabel: stage === "active" ? "No open comments." : stage === "resolved" ? "No resolved comments." : "No closed comments.",
 			...props.threadToMarkdown ? { threadToMarkdown: props.threadToMarkdown } : {},
-			...props.renderRootDetails ? { renderRootDetails: props.renderRootDetails } : {}
+			...props.renderRootDetails ? { renderRootDetails: props.renderRootDetails } : {},
+			...props.extraAssignItems ? { extraAssignItems: props.extraAssignItems } : {}
 		}) : ctx.railMode === "focused" && ctx.focusedAnchor ? /* @__PURE__ */ jsx("div", {
 			ref: focusedRef,
 			"data-testid": "comment-focused-rail",
@@ -254,7 +259,8 @@ function CommentSidePanel(props) {
 				label: label(ctx.focusedAnchor),
 				...props.compact !== void 0 ? { compact: props.compact } : {},
 				...props.threadToMarkdown ? { threadToMarkdown: props.threadToMarkdown } : {},
-				...props.renderRootDetails ? { renderRootDetails: props.renderRootDetails } : {}
+				...props.renderRootDetails ? { renderRootDetails: props.renderRootDetails } : {},
+				...props.extraAssignItems ? { extraAssignItems: props.extraAssignItems } : {}
 			})
 		}) : null]
 	});