@flanksource/clicky-ui 0.3.55 → 0.3.56

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

@@ -1 +1 @@
-{"version":3,"file":"MentionTextarea.d.ts","sourceRoot":"","sources":["../../src/comments/MentionTextarea.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1E,MAAM,MAAM,oBAAoB,GAAG;IACjC,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,sDAAsD;IACtD,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,wDAAwD;IACxD,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IACpD,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAsGF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,sHAsL1B,CAAC"}
+{"version":3,"file":"MentionTextarea.d.ts","sourceRoot":"","sources":["../../src/comments/MentionTextarea.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1E,MAAM,MAAM,oBAAoB,GAAG;IACjC,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,sDAAsD;IACtD,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,wDAAwD;IACxD,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IACpD,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAsGF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,sHAuL1B,CAAC"}

package/dist/comments/MentionTextarea.js

@@ -173,7 +173,7 @@ var MentionTextarea = forwardRef(function MentionTextarea({ value, onChange, men
 		value,
 		placeholder,
 		"data-testid": dataTestId,
-		className: cn("w-full resize-none bg-transparent text-sm leading-snug outline-none placeholder:text-placeholder", className),
+		className: cn("w-full resize-none bg-transparent text-sm leading-snug outline-none placeholder:text-placeholder [@media(pointer:coarse)]:text-base", className),
 		onChange: (e) => {
 			onChange(e.target.value);
 			refreshMention(e.target);

package/dist/comments/MentionTextarea.js.map

@@ -1 +1 @@
-{"version":3,"file":"MentionTextarea.js","names":["_Fragment"],"sources":["../../src/comments/MentionTextarea.tsx"],"sourcesContent":["import {\n  forwardRef,\n  useEffect,\n  useImperativeHandle,\n  useRef,\n  useState,\n  type KeyboardEvent,\n} from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { cn } from \"../lib/utils\";\nimport { useFloatingZIndex } from \"../overlay/modalStack\";\nimport { CommentAuthorAvatar } from \"./CommentAuthor\";\nimport type { CommentMention, CommentMentionable } from \"./comment-types\";\n\nexport type MentionTextareaProps = {\n  /** Controlled value. */\n  value: string;\n  /** Called with the next value on edit or mention insertion. */\n  onChange: (value: string) => void;\n  /** People/agents offered in the @-mention popover. */\n  mentionables: CommentMentionable[];\n  /** Fired when a mention is inserted via the popover. */\n  onMentionSelect?: (mention: CommentMention) => void;\n  /** Enter (without Shift) while the popover is closed. */\n  onSubmit?: () => void;\n  /** Escape while the popover is closed. */\n  onCancel?: () => void;\n  placeholder?: string;\n  autoFocus?: boolean;\n  rows?: number;\n  className?: string;\n  \"data-testid\"?: string;\n};\n\nconst MENTION_QUERY = /(^|\\s)@([\\w.-]*)$/;\nconst MAX_RESULTS = 8;\n\ntype ActiveMention = { atIndex: number; query: string };\ntype CaretRect = { top: number; left: number; height: number };\n\nfunction detectMention(value: string, caret: number): ActiveMention | null {\n  const match = value.slice(0, caret).match(MENTION_QUERY);\n  if (!match) return null;\n  const query = match[2] ?? \"\";\n  const atIndex = caret - query.length - 1;\n  return { atIndex, query };\n}\n\nfunction filterMentionables(\n  mentionables: CommentMentionable[],\n  query: string,\n): CommentMentionable[] {\n  const q = query.toLowerCase();\n  const matches = q\n    ? mentionables.filter(\n        (m) =>\n          m.name.toLowerCase().includes(q) || m.id.toLowerCase().includes(q),\n      )\n    : mentionables;\n  return matches.slice(0, MAX_RESULTS);\n}\n\nconst MIRROR_PROPS = [\n  \"boxSizing\",\n  \"width\",\n  \"borderTopWidth\",\n  \"borderRightWidth\",\n  \"borderBottomWidth\",\n  \"borderLeftWidth\",\n  \"paddingTop\",\n  \"paddingRight\",\n  \"paddingBottom\",\n  \"paddingLeft\",\n  \"fontStyle\",\n  \"fontVariant\",\n  \"fontWeight\",\n  \"fontStretch\",\n  \"fontSize\",\n  \"lineHeight\",\n  \"fontFamily\",\n  \"textAlign\",\n  \"textTransform\",\n  \"textIndent\",\n  \"letterSpacing\",\n  \"wordSpacing\",\n  \"tabSize\",\n  \"whiteSpace\",\n  \"wordWrap\",\n  \"overflowWrap\",\n] as const;\n\n// Measures the caret pixel position with an off-screen mirror div that copies the\n// textarea's box metrics — the dependency-free way to anchor a popover at the caret.\nfunction caretViewportRect(\n  el: HTMLTextAreaElement,\n  position: number,\n): CaretRect {\n  if (\n    typeof document === \"undefined\" ||\n    typeof getComputedStyle !== \"function\"\n  ) {\n    const r = el.getBoundingClientRect();\n    return { top: r.top, left: r.left, height: 16 };\n  }\n  const style = getComputedStyle(el);\n  const mirror = document.createElement(\"div\");\n  for (const prop of MIRROR_PROPS) mirror.style[prop] = style[prop];\n  mirror.style.position = \"absolute\";\n  mirror.style.visibility = \"hidden\";\n  mirror.style.whiteSpace = \"pre-wrap\";\n  mirror.style.overflowWrap = \"break-word\";\n  mirror.style.top = \"0\";\n  mirror.style.left = \"-9999px\";\n  mirror.textContent = el.value.slice(0, position);\n\n  const marker = document.createElement(\"span\");\n  marker.textContent = el.value.slice(position) || \".\";\n  mirror.appendChild(marker);\n  document.body.appendChild(mirror);\n\n  const lineHeight =\n    parseInt(style.lineHeight, 10) || parseInt(style.fontSize, 10) || 16;\n  const offsetTop = marker.offsetTop;\n  const offsetLeft = marker.offsetLeft;\n  document.body.removeChild(mirror);\n\n  const rect = el.getBoundingClientRect();\n  return {\n    top: rect.top + offsetTop - el.scrollTop,\n    left: rect.left + offsetLeft - el.scrollLeft,\n    height: lineHeight,\n  };\n}\n\n/**\n * A textarea with an @-mention autocomplete. Typing `@` opens a caret-anchored\n * popover filtered against `mentionables`; selecting one inserts the name and\n * fires `onMentionSelect`. Enter submits and Escape cancels only when the\n * popover is closed.\n */\nexport const MentionTextarea = forwardRef<\n  HTMLTextAreaElement,\n  MentionTextareaProps\n>(function MentionTextarea(\n  {\n    value,\n    onChange,\n    mentionables,\n    onMentionSelect,\n    onSubmit,\n    onCancel,\n    placeholder,\n    autoFocus,\n    rows = 2,\n    className,\n    \"data-testid\": dataTestId,\n  },\n  forwardedRef,\n) {\n  const innerRef = useRef<HTMLTextAreaElement>(null);\n  useImperativeHandle(\n    forwardedRef,\n    () => innerRef.current as HTMLTextAreaElement,\n  );\n\n  const [active, setActive] = useState<ActiveMention | null>(null);\n  const [caretRect, setCaretRect] = useState<CaretRect | null>(null);\n  const [activeIndex, setActiveIndex] = useState(0);\n  const floatingZ = useFloatingZIndex();\n\n  const results = active ? filterMentionables(mentionables, active.query) : [];\n  const open = active != null && results.length > 0;\n\n  function refreshMention(el: HTMLTextAreaElement) {\n    const next = detectMention(el.value, el.selectionStart ?? el.value.length);\n    setActive(next);\n    setActiveIndex(0);\n    setCaretRect(next ? caretViewportRect(el, el.selectionStart ?? 0) : null);\n  }\n\n  function insertMention(m: CommentMentionable) {\n    const el = innerRef.current;\n    if (!el || !active) return;\n    const caret = el.selectionStart ?? value.length;\n    const next = `${value.slice(0, active.atIndex)}@${m.name} ${value.slice(caret)}`;\n    const nextCaret = active.atIndex + m.name.length + 2;\n    onChange(next);\n    onMentionSelect?.({ id: m.id, name: m.name, kind: m.kind });\n    setActive(null);\n    setCaretRect(null);\n    requestAnimationFrame(() => {\n      el.focus();\n      el.setSelectionRange(nextCaret, nextCaret);\n    });\n  }\n\n  function onKeyDown(e: KeyboardEvent<HTMLTextAreaElement>) {\n    if (open) {\n      if (e.key === \"ArrowDown\") {\n        e.preventDefault();\n        setActiveIndex((i) => (i + 1) % results.length);\n        return;\n      }\n      if (e.key === \"ArrowUp\") {\n        e.preventDefault();\n        setActiveIndex((i) => (i - 1 + results.length) % results.length);\n        return;\n      }\n      if (e.key === \"Enter\" || e.key === \"Tab\") {\n        e.preventDefault();\n        const choice = results[activeIndex];\n        if (choice) insertMention(choice);\n        return;\n      }\n      if (e.key === \"Escape\") {\n        e.preventDefault();\n        setActive(null);\n        setCaretRect(null);\n        return;\n      }\n    }\n    if (e.key === \"Enter\" && !e.shiftKey) {\n      e.preventDefault();\n      onSubmit?.();\n      return;\n    }\n    if (e.key === \"Escape\") {\n      e.preventDefault();\n      onCancel?.();\n    }\n  }\n\n  useEffect(() => {\n    if (!autoFocus) return;\n    const el = innerRef.current;\n    const raf = requestAnimationFrame(() => {\n      el?.focus();\n      const len = el?.value.length ?? 0;\n      el?.setSelectionRange(len, len);\n    });\n    return () => cancelAnimationFrame(raf);\n  }, [autoFocus]);\n\n  return (\n    <>\n      <textarea\n        ref={innerRef}\n        rows={rows}\n        value={value}\n        placeholder={placeholder}\n        data-testid={dataTestId}\n        className={cn(\n          \"w-full resize-none bg-transparent text-sm leading-snug outline-none placeholder:text-placeholder\",\n          className,\n        )}\n        onChange={(e) => {\n          onChange(e.target.value);\n          refreshMention(e.target);\n        }}\n        onKeyUp={(e) => refreshMention(e.currentTarget)}\n        onClick={(e) => refreshMention(e.currentTarget)}\n        onKeyDown={onKeyDown}\n        onBlur={() => {\n          setActive(null);\n          setCaretRect(null);\n        }}\n      />\n      {open &&\n        typeof document !== \"undefined\" &&\n        createPortal(\n          <ul\n            role=\"listbox\"\n            data-testid=\"mention-popover\"\n            style={{\n              position: \"fixed\",\n              top: (caretRect?.top ?? 0) + (caretRect?.height ?? 16) + 2,\n              left: caretRect?.left ?? 0,\n              zIndex: floatingZ,\n            }}\n            className=\"max-h-56 min-w-[12rem] overflow-auto rounded-md border border-border bg-popover py-1 shadow-md\"\n          >\n            {results.map((m, i) => (\n              <li key={m.id}>\n                <button\n                  type=\"button\"\n                  role=\"option\"\n                  aria-selected={i === activeIndex}\n                  // Use mousedown so selection runs before the textarea blur closes the popover.\n                  onMouseDown={(e) => {\n                    e.preventDefault();\n                    insertMention(m);\n                  }}\n                  onMouseEnter={() => setActiveIndex(i)}\n                  className={cn(\n                    \"flex w-full items-center gap-2 px-3 py-1.5 text-left text-xs text-popover-foreground\",\n                    i === activeIndex && \"bg-accent text-accent-foreground\",\n                  )}\n                >\n                  <CommentAuthorAvatar\n                    author={{\n                      name: m.name,\n                      kind: m.kind,\n                      ...(m.avatar ? { avatar: m.avatar } : {}),\n                      ...(m.icon ? { icon: m.icon } : {}),\n                    }}\n                    size=\"xs\"\n                    bare\n                  />\n                  <span className=\"truncate\">{m.name}</span>\n                  {m.kind === \"agent\" && (\n                    <span className=\"ml-auto text-[10px] text-muted-foreground\">\n                      agent\n                    </span>\n                  )}\n                </button>\n              </li>\n            ))}\n          </ul>,\n          document.body,\n        )}\n    </>\n  );\n});\n"],"mappings":"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"}
+{"version":3,"file":"MentionTextarea.js","names":["_Fragment"],"sources":["../../src/comments/MentionTextarea.tsx"],"sourcesContent":["import {\n  forwardRef,\n  useEffect,\n  useImperativeHandle,\n  useRef,\n  useState,\n  type KeyboardEvent,\n} from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { cn } from \"../lib/utils\";\nimport { useFloatingZIndex } from \"../overlay/modalStack\";\nimport { CommentAuthorAvatar } from \"./CommentAuthor\";\nimport type { CommentMention, CommentMentionable } from \"./comment-types\";\n\nexport type MentionTextareaProps = {\n  /** Controlled value. */\n  value: string;\n  /** Called with the next value on edit or mention insertion. */\n  onChange: (value: string) => void;\n  /** People/agents offered in the @-mention popover. */\n  mentionables: CommentMentionable[];\n  /** Fired when a mention is inserted via the popover. */\n  onMentionSelect?: (mention: CommentMention) => void;\n  /** Enter (without Shift) while the popover is closed. */\n  onSubmit?: () => void;\n  /** Escape while the popover is closed. */\n  onCancel?: () => void;\n  placeholder?: string;\n  autoFocus?: boolean;\n  rows?: number;\n  className?: string;\n  \"data-testid\"?: string;\n};\n\nconst MENTION_QUERY = /(^|\\s)@([\\w.-]*)$/;\nconst MAX_RESULTS = 8;\n\ntype ActiveMention = { atIndex: number; query: string };\ntype CaretRect = { top: number; left: number; height: number };\n\nfunction detectMention(value: string, caret: number): ActiveMention | null {\n  const match = value.slice(0, caret).match(MENTION_QUERY);\n  if (!match) return null;\n  const query = match[2] ?? \"\";\n  const atIndex = caret - query.length - 1;\n  return { atIndex, query };\n}\n\nfunction filterMentionables(\n  mentionables: CommentMentionable[],\n  query: string,\n): CommentMentionable[] {\n  const q = query.toLowerCase();\n  const matches = q\n    ? mentionables.filter(\n        (m) =>\n          m.name.toLowerCase().includes(q) || m.id.toLowerCase().includes(q),\n      )\n    : mentionables;\n  return matches.slice(0, MAX_RESULTS);\n}\n\nconst MIRROR_PROPS = [\n  \"boxSizing\",\n  \"width\",\n  \"borderTopWidth\",\n  \"borderRightWidth\",\n  \"borderBottomWidth\",\n  \"borderLeftWidth\",\n  \"paddingTop\",\n  \"paddingRight\",\n  \"paddingBottom\",\n  \"paddingLeft\",\n  \"fontStyle\",\n  \"fontVariant\",\n  \"fontWeight\",\n  \"fontStretch\",\n  \"fontSize\",\n  \"lineHeight\",\n  \"fontFamily\",\n  \"textAlign\",\n  \"textTransform\",\n  \"textIndent\",\n  \"letterSpacing\",\n  \"wordSpacing\",\n  \"tabSize\",\n  \"whiteSpace\",\n  \"wordWrap\",\n  \"overflowWrap\",\n] as const;\n\n// Measures the caret pixel position with an off-screen mirror div that copies the\n// textarea's box metrics — the dependency-free way to anchor a popover at the caret.\nfunction caretViewportRect(\n  el: HTMLTextAreaElement,\n  position: number,\n): CaretRect {\n  if (\n    typeof document === \"undefined\" ||\n    typeof getComputedStyle !== \"function\"\n  ) {\n    const r = el.getBoundingClientRect();\n    return { top: r.top, left: r.left, height: 16 };\n  }\n  const style = getComputedStyle(el);\n  const mirror = document.createElement(\"div\");\n  for (const prop of MIRROR_PROPS) mirror.style[prop] = style[prop];\n  mirror.style.position = \"absolute\";\n  mirror.style.visibility = \"hidden\";\n  mirror.style.whiteSpace = \"pre-wrap\";\n  mirror.style.overflowWrap = \"break-word\";\n  mirror.style.top = \"0\";\n  mirror.style.left = \"-9999px\";\n  mirror.textContent = el.value.slice(0, position);\n\n  const marker = document.createElement(\"span\");\n  marker.textContent = el.value.slice(position) || \".\";\n  mirror.appendChild(marker);\n  document.body.appendChild(mirror);\n\n  const lineHeight =\n    parseInt(style.lineHeight, 10) || parseInt(style.fontSize, 10) || 16;\n  const offsetTop = marker.offsetTop;\n  const offsetLeft = marker.offsetLeft;\n  document.body.removeChild(mirror);\n\n  const rect = el.getBoundingClientRect();\n  return {\n    top: rect.top + offsetTop - el.scrollTop,\n    left: rect.left + offsetLeft - el.scrollLeft,\n    height: lineHeight,\n  };\n}\n\n/**\n * A textarea with an @-mention autocomplete. Typing `@` opens a caret-anchored\n * popover filtered against `mentionables`; selecting one inserts the name and\n * fires `onMentionSelect`. Enter submits and Escape cancels only when the\n * popover is closed.\n */\nexport const MentionTextarea = forwardRef<\n  HTMLTextAreaElement,\n  MentionTextareaProps\n>(function MentionTextarea(\n  {\n    value,\n    onChange,\n    mentionables,\n    onMentionSelect,\n    onSubmit,\n    onCancel,\n    placeholder,\n    autoFocus,\n    rows = 2,\n    className,\n    \"data-testid\": dataTestId,\n  },\n  forwardedRef,\n) {\n  const innerRef = useRef<HTMLTextAreaElement>(null);\n  useImperativeHandle(\n    forwardedRef,\n    () => innerRef.current as HTMLTextAreaElement,\n  );\n\n  const [active, setActive] = useState<ActiveMention | null>(null);\n  const [caretRect, setCaretRect] = useState<CaretRect | null>(null);\n  const [activeIndex, setActiveIndex] = useState(0);\n  const floatingZ = useFloatingZIndex();\n\n  const results = active ? filterMentionables(mentionables, active.query) : [];\n  const open = active != null && results.length > 0;\n\n  function refreshMention(el: HTMLTextAreaElement) {\n    const next = detectMention(el.value, el.selectionStart ?? el.value.length);\n    setActive(next);\n    setActiveIndex(0);\n    setCaretRect(next ? caretViewportRect(el, el.selectionStart ?? 0) : null);\n  }\n\n  function insertMention(m: CommentMentionable) {\n    const el = innerRef.current;\n    if (!el || !active) return;\n    const caret = el.selectionStart ?? value.length;\n    const next = `${value.slice(0, active.atIndex)}@${m.name} ${value.slice(caret)}`;\n    const nextCaret = active.atIndex + m.name.length + 2;\n    onChange(next);\n    onMentionSelect?.({ id: m.id, name: m.name, kind: m.kind });\n    setActive(null);\n    setCaretRect(null);\n    requestAnimationFrame(() => {\n      el.focus();\n      el.setSelectionRange(nextCaret, nextCaret);\n    });\n  }\n\n  function onKeyDown(e: KeyboardEvent<HTMLTextAreaElement>) {\n    if (open) {\n      if (e.key === \"ArrowDown\") {\n        e.preventDefault();\n        setActiveIndex((i) => (i + 1) % results.length);\n        return;\n      }\n      if (e.key === \"ArrowUp\") {\n        e.preventDefault();\n        setActiveIndex((i) => (i - 1 + results.length) % results.length);\n        return;\n      }\n      if (e.key === \"Enter\" || e.key === \"Tab\") {\n        e.preventDefault();\n        const choice = results[activeIndex];\n        if (choice) insertMention(choice);\n        return;\n      }\n      if (e.key === \"Escape\") {\n        e.preventDefault();\n        setActive(null);\n        setCaretRect(null);\n        return;\n      }\n    }\n    if (e.key === \"Enter\" && !e.shiftKey) {\n      e.preventDefault();\n      onSubmit?.();\n      return;\n    }\n    if (e.key === \"Escape\") {\n      e.preventDefault();\n      onCancel?.();\n    }\n  }\n\n  useEffect(() => {\n    if (!autoFocus) return;\n    const el = innerRef.current;\n    const raf = requestAnimationFrame(() => {\n      el?.focus();\n      const len = el?.value.length ?? 0;\n      el?.setSelectionRange(len, len);\n    });\n    return () => cancelAnimationFrame(raf);\n  }, [autoFocus]);\n\n  return (\n    <>\n      <textarea\n        ref={innerRef}\n        rows={rows}\n        value={value}\n        placeholder={placeholder}\n        data-testid={dataTestId}\n        className={cn(\n          // iOS zooms the page into any focused field under 16px.\n          \"w-full resize-none bg-transparent text-sm leading-snug outline-none placeholder:text-placeholder [@media(pointer:coarse)]:text-base\",\n          className,\n        )}\n        onChange={(e) => {\n          onChange(e.target.value);\n          refreshMention(e.target);\n        }}\n        onKeyUp={(e) => refreshMention(e.currentTarget)}\n        onClick={(e) => refreshMention(e.currentTarget)}\n        onKeyDown={onKeyDown}\n        onBlur={() => {\n          setActive(null);\n          setCaretRect(null);\n        }}\n      />\n      {open &&\n        typeof document !== \"undefined\" &&\n        createPortal(\n          <ul\n            role=\"listbox\"\n            data-testid=\"mention-popover\"\n            style={{\n              position: \"fixed\",\n              top: (caretRect?.top ?? 0) + (caretRect?.height ?? 16) + 2,\n              left: caretRect?.left ?? 0,\n              zIndex: floatingZ,\n            }}\n            className=\"max-h-56 min-w-[12rem] overflow-auto rounded-md border border-border bg-popover py-1 shadow-md\"\n          >\n            {results.map((m, i) => (\n              <li key={m.id}>\n                <button\n                  type=\"button\"\n                  role=\"option\"\n                  aria-selected={i === activeIndex}\n                  // Use mousedown so selection runs before the textarea blur closes the popover.\n                  onMouseDown={(e) => {\n                    e.preventDefault();\n                    insertMention(m);\n                  }}\n                  onMouseEnter={() => setActiveIndex(i)}\n                  className={cn(\n                    \"flex w-full items-center gap-2 px-3 py-1.5 text-left text-xs text-popover-foreground\",\n                    i === activeIndex && \"bg-accent text-accent-foreground\",\n                  )}\n                >\n                  <CommentAuthorAvatar\n                    author={{\n                      name: m.name,\n                      kind: m.kind,\n                      ...(m.avatar ? { avatar: m.avatar } : {}),\n                      ...(m.icon ? { icon: m.icon } : {}),\n                    }}\n                    size=\"xs\"\n                    bare\n                  />\n                  <span className=\"truncate\">{m.name}</span>\n                  {m.kind === \"agent\" && (\n                    <span className=\"ml-auto text-[10px] text-muted-foreground\">\n                      agent\n                    </span>\n                  )}\n                </button>\n              </li>\n            ))}\n          </ul>,\n          document.body,\n        )}\n    </>\n  );\n});\n"],"mappings":"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"}

package/dist/comments/comment-assign.cjs

@@ -0,0 +1,68 @@
+const require_comment_stage = require("../lib/comment-stage.cjs");
+const require_UiRobotAi = require("../icons/components/UiRobotAi.cjs");
+const require_UiUser = require("../icons/components/UiUser.cjs");
+// src/comments/comment-assign.ts
+function isSameAssignee(left, right) {
+	return left.name === right.name && (left.kind ?? "user") === (right.kind ?? "user");
+}
+/**
+* The targets of an assignment: each configured person or agent, "Unassign"
+* while someone holds the root, then the caller's extra items. The dashboard
+* mounts these directly under its own trigger; cards nest them under "Assign…".
+*/
+function assignTargetItems(options) {
+	const { comment, config, onAssign, extraAssignItems, run } = options;
+	const items = [];
+	if (onAssign) {
+		for (const { id, name, kind } of config.assignees ?? []) {
+			const target = {
+				id,
+				name,
+				kind
+			};
+			const current = comment.assignee !== void 0 && isSameAssignee(comment.assignee, target);
+			items.push({
+				label: name,
+				icon: kind === "agent" ? require_UiRobotAi.UiRobotAi : require_UiUser.UiUser,
+				disabled: current,
+				title: current ? `Already assigned to ${name}` : `Assign to ${name}`,
+				onSelect: () => run("assign", () => onAssign(target))
+			});
+		}
+		if (comment.assignee) items.push({
+			label: "Unassign",
+			icon: require_UiUser.UiUserMinus,
+			onSelect: () => run("assign", () => onAssign(null))
+		});
+	}
+	items.push(...extraAssignItems?.(comment) ?? []);
+	return items;
+}
+/**
+* The root-only entries of a card's actions menu: Acknowledge while nobody
+* holds an active root, and an "Assign…" submenu of its targets. Empty for
+* resolved or closed roots, which are no longer being worked on.
+*/
+function assignmentMenuItems(options) {
+	const { comment, config, onAcknowledge, run } = options;
+	if (comment.parentId) return [];
+	if (require_comment_stage.resolveCommentStage(config, comment.status) !== "active") return [];
+	const items = [];
+	if (onAcknowledge && !comment.assignee) items.push({
+		label: "Acknowledge",
+		icon: require_UiUser.UiUserCheck,
+		onSelect: () => run("acknowledge", onAcknowledge)
+	});
+	const targets = assignTargetItems(options);
+	if (targets.length > 0) items.push({
+		label: "Assign…",
+		icon: require_UiUser.UiUserPlus,
+		onSelect: () => {},
+		children: targets
+	});
+	return items;
+}
+exports.assignTargetItems = assignTargetItems;
+exports.assignmentMenuItems = assignmentMenuItems;
+
+//# sourceMappingURL=comment-assign.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"comment-assign.cjs","names":["UiRobotAi","UiUser","UiUserMinus","resolveCommentStage","UiUserCheck","UiUserPlus"],"sources":["../../src/comments/comment-assign.ts"],"sourcesContent":["import type { DropdownMenuItem } from \"../overlay/DropdownMenu\";\nimport { UiRobotAi, UiUser, UiUserCheck, UiUserMinus, UiUserPlus } from \"../icons\";\nimport { resolveCommentStage } from \"../lib/comment-stage\";\nimport type { Comment, CommentAuthor, CommentConfig } from \"./comment-types\";\n\n/** Runs a card action and reports a failure against `verb` instead of swallowing it. */\nexport type CommentActionRunner = (\n  verb: string,\n  action: () => void | Promise<void>,\n) => void;\n\nexport type CommentAssignmentOptions = {\n  comment: Comment;\n  config: CommentConfig;\n  /** Claim the root for the current user or agent; omit to hide Acknowledge. */\n  onAcknowledge?: () => void | Promise<void>;\n  /** Hand the root to `assignee`, or clear it with `null`; omit to hide the people list. */\n  onAssign?: (assignee: CommentAuthor | null) => void | Promise<void>;\n  /**\n   * Caller-owned entries appended to the Assign menu (for example \"Run agent\"),\n   * computed per comment so they can reflect its state.\n   */\n  extraAssignItems?: (comment: Comment) => DropdownMenuItem[];\n  run: CommentActionRunner;\n};\n\nfunction isSameAssignee(left: CommentAuthor, right: CommentAuthor): boolean {\n  return left.name === right.name && (left.kind ?? \"user\") === (right.kind ?? \"user\");\n}\n\n/**\n * The targets of an assignment: each configured person or agent, \"Unassign\"\n * while someone holds the root, then the caller's extra items. The dashboard\n * mounts these directly under its own trigger; cards nest them under \"Assign…\".\n */\nexport function assignTargetItems(\n  options: CommentAssignmentOptions,\n): DropdownMenuItem[] {\n  const { comment, config, onAssign, extraAssignItems, run } = options;\n  const items: DropdownMenuItem[] = [];\n  if (onAssign) {\n    for (const { id, name, kind } of config.assignees ?? []) {\n      const target: CommentAuthor = { id, name, kind };\n      const current =\n        comment.assignee !== undefined &&\n        isSameAssignee(comment.assignee, target);\n      items.push({\n        label: name,\n        icon: kind === \"agent\" ? UiRobotAi : UiUser,\n        disabled: current,\n        title: current ? `Already assigned to ${name}` : `Assign to ${name}`,\n        onSelect: () => run(\"assign\", () => onAssign(target)),\n      });\n    }\n    if (comment.assignee) {\n      items.push({\n        label: \"Unassign\",\n        icon: UiUserMinus,\n        onSelect: () => run(\"assign\", () => onAssign(null)),\n      });\n    }\n  }\n  items.push(...(extraAssignItems?.(comment) ?? []));\n  return items;\n}\n\n/**\n * The root-only entries of a card's actions menu: Acknowledge while nobody\n * holds an active root, and an \"Assign…\" submenu of its targets. Empty for\n * resolved or closed roots, which are no longer being worked on.\n */\nexport function assignmentMenuItems(\n  options: CommentAssignmentOptions,\n): DropdownMenuItem[] {\n  const { comment, config, onAcknowledge, run } = options;\n  if (comment.parentId) return [];\n  if (resolveCommentStage(config, comment.status) !== \"active\") return [];\n  const items: DropdownMenuItem[] = [];\n  if (onAcknowledge && !comment.assignee) {\n    items.push({\n      label: \"Acknowledge\",\n      icon: UiUserCheck,\n      onSelect: () => run(\"acknowledge\", onAcknowledge),\n    });\n  }\n  const targets = assignTargetItems(options);\n  if (targets.length > 0) {\n    items.push({\n      label: \"Assign…\",\n      icon: UiUserPlus,\n      // Opening the submenu is the whole action; the parent never fires it.\n      onSelect: () => {},\n      children: targets,\n    });\n  }\n  return items;\n}\n"],"mappings":";;;;AA0BA,SAAS,eAAe,MAAqB,OAA+B;CAC1E,OAAO,KAAK,SAAS,MAAM,SAAS,KAAK,QAAQ,aAAa,MAAM,QAAQ;AAC9E;;;;;;AAOA,SAAgB,kBACd,SACoB;CACpB,MAAM,EAAE,SAAS,QAAQ,UAAU,kBAAkB,QAAQ;CAC7D,MAAM,QAA4B,CAAC;CACnC,IAAI,UAAU;EACZ,KAAK,MAAM,EAAE,IAAI,MAAM,UAAU,OAAO,aAAa,CAAC,GAAG;GACvD,MAAM,SAAwB;IAAE;IAAI;IAAM;GAAK;GAC/C,MAAM,UACJ,QAAQ,aAAa,KAAA,KACrB,eAAe,QAAQ,UAAU,MAAM;GACzC,MAAM,KAAK;IACT,OAAO;IACP,MAAM,SAAS,UAAUA,kBAAAA,YAAYC,eAAAA;IACrC,UAAU;IACV,OAAO,UAAU,uBAAuB,SAAS,aAAa;IAC9D,gBAAgB,IAAI,gBAAgB,SAAS,MAAM,CAAC;GACtD,CAAC;EACH;EACA,IAAI,QAAQ,UACV,MAAM,KAAK;GACT,OAAO;GACP,MAAMC,eAAAA;GACN,gBAAgB,IAAI,gBAAgB,SAAS,IAAI,CAAC;EACpD,CAAC;CAEL;CACA,MAAM,KAAK,GAAI,mBAAmB,OAAO,KAAK,CAAC,CAAE;CACjD,OAAO;AACT;;;;;;AAOA,SAAgB,oBACd,SACoB;CACpB,MAAM,EAAE,SAAS,QAAQ,eAAe,QAAQ;CAChD,IAAI,QAAQ,UAAU,OAAO,CAAC;CAC9B,IAAIC,sBAAAA,oBAAoB,QAAQ,QAAQ,MAAM,MAAM,UAAU,OAAO,CAAC;CACtE,MAAM,QAA4B,CAAC;CACnC,IAAI,iBAAiB,CAAC,QAAQ,UAC5B,MAAM,KAAK;EACT,OAAO;EACP,MAAMC,eAAAA;EACN,gBAAgB,IAAI,eAAe,aAAa;CAClD,CAAC;CAEH,MAAM,UAAU,kBAAkB,OAAO;CACzC,IAAI,QAAQ,SAAS,GACnB,MAAM,KAAK;EACT,OAAO;EACP,MAAMC,eAAAA;EAEN,gBAAgB,CAAC;EACjB,UAAU;CACZ,CAAC;CAEH,OAAO;AACT"}

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

@@ -0,0 +1,31 @@
+import { DropdownMenuItem } from '../overlay/DropdownMenu.js';
+import { Comment, CommentAuthor, CommentConfig } from './comment-types.js';
+/** Runs a card action and reports a failure against `verb` instead of swallowing it. */
+export type CommentActionRunner = (verb: string, action: () => void | Promise<void>) => void;
+export type CommentAssignmentOptions = {
+    comment: Comment;
+    config: CommentConfig;
+    /** Claim the root for the current user or agent; omit to hide Acknowledge. */
+    onAcknowledge?: () => void | Promise<void>;
+    /** Hand the root to `assignee`, or clear it with `null`; omit to hide the people list. */
+    onAssign?: (assignee: CommentAuthor | null) => void | Promise<void>;
+    /**
+     * Caller-owned entries appended to the Assign menu (for example "Run agent"),
+     * computed per comment so they can reflect its state.
+     */
+    extraAssignItems?: (comment: Comment) => DropdownMenuItem[];
+    run: CommentActionRunner;
+};
+/**
+ * The targets of an assignment: each configured person or agent, "Unassign"
+ * while someone holds the root, then the caller's extra items. The dashboard
+ * mounts these directly under its own trigger; cards nest them under "Assign…".
+ */
+export declare function assignTargetItems(options: CommentAssignmentOptions): DropdownMenuItem[];
+/**
+ * The root-only entries of a card's actions menu: Acknowledge while nobody
+ * holds an active root, and an "Assign…" submenu of its targets. Empty for
+ * resolved or closed roots, which are no longer being worked on.
+ */
+export declare function assignmentMenuItems(options: CommentAssignmentOptions): DropdownMenuItem[];
+//# sourceMappingURL=comment-assign.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"comment-assign.d.ts","sourceRoot":"","sources":["../../src/comments/comment-assign.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE7E,wFAAwF;AACxF,MAAM,MAAM,mBAAmB,GAAG,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAC/B,IAAI,CAAC;AAEV,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,gBAAgB,EAAE,CAAC;IAC5D,GAAG,EAAE,mBAAmB,CAAC;CAC1B,CAAC;AAMF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,gBAAgB,EAAE,CA2BpB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,wBAAwB,GAChC,gBAAgB,EAAE,CAuBpB"}

package/dist/comments/comment-assign.js

@@ -0,0 +1,67 @@
+import { resolveCommentStage } from "../lib/comment-stage.js";
+import { UiRobotAi } from "../icons/components/UiRobotAi.js";
+import { UiUser, UiUserCheck, UiUserMinus, UiUserPlus } from "../icons/components/UiUser.js";
+// src/comments/comment-assign.ts
+function isSameAssignee(left, right) {
+	return left.name === right.name && (left.kind ?? "user") === (right.kind ?? "user");
+}
+/**
+* The targets of an assignment: each configured person or agent, "Unassign"
+* while someone holds the root, then the caller's extra items. The dashboard
+* mounts these directly under its own trigger; cards nest them under "Assign…".
+*/
+function assignTargetItems(options) {
+	const { comment, config, onAssign, extraAssignItems, run } = options;
+	const items = [];
+	if (onAssign) {
+		for (const { id, name, kind } of config.assignees ?? []) {
+			const target = {
+				id,
+				name,
+				kind
+			};
+			const current = comment.assignee !== void 0 && isSameAssignee(comment.assignee, target);
+			items.push({
+				label: name,
+				icon: kind === "agent" ? UiRobotAi : UiUser,
+				disabled: current,
+				title: current ? `Already assigned to ${name}` : `Assign to ${name}`,
+				onSelect: () => run("assign", () => onAssign(target))
+			});
+		}
+		if (comment.assignee) items.push({
+			label: "Unassign",
+			icon: UiUserMinus,
+			onSelect: () => run("assign", () => onAssign(null))
+		});
+	}
+	items.push(...extraAssignItems?.(comment) ?? []);
+	return items;
+}
+/**
+* The root-only entries of a card's actions menu: Acknowledge while nobody
+* holds an active root, and an "Assign…" submenu of its targets. Empty for
+* resolved or closed roots, which are no longer being worked on.
+*/
+function assignmentMenuItems(options) {
+	const { comment, config, onAcknowledge, run } = options;
+	if (comment.parentId) return [];
+	if (resolveCommentStage(config, comment.status) !== "active") return [];
+	const items = [];
+	if (onAcknowledge && !comment.assignee) items.push({
+		label: "Acknowledge",
+		icon: UiUserCheck,
+		onSelect: () => run("acknowledge", onAcknowledge)
+	});
+	const targets = assignTargetItems(options);
+	if (targets.length > 0) items.push({
+		label: "Assign…",
+		icon: UiUserPlus,
+		onSelect: () => {},
+		children: targets
+	});
+	return items;
+}
+export { assignTargetItems, assignmentMenuItems };
+
+//# sourceMappingURL=comment-assign.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"comment-assign.js","names":[],"sources":["../../src/comments/comment-assign.ts"],"sourcesContent":["import type { DropdownMenuItem } from \"../overlay/DropdownMenu\";\nimport { UiRobotAi, UiUser, UiUserCheck, UiUserMinus, UiUserPlus } from \"../icons\";\nimport { resolveCommentStage } from \"../lib/comment-stage\";\nimport type { Comment, CommentAuthor, CommentConfig } from \"./comment-types\";\n\n/** Runs a card action and reports a failure against `verb` instead of swallowing it. */\nexport type CommentActionRunner = (\n  verb: string,\n  action: () => void | Promise<void>,\n) => void;\n\nexport type CommentAssignmentOptions = {\n  comment: Comment;\n  config: CommentConfig;\n  /** Claim the root for the current user or agent; omit to hide Acknowledge. */\n  onAcknowledge?: () => void | Promise<void>;\n  /** Hand the root to `assignee`, or clear it with `null`; omit to hide the people list. */\n  onAssign?: (assignee: CommentAuthor | null) => void | Promise<void>;\n  /**\n   * Caller-owned entries appended to the Assign menu (for example \"Run agent\"),\n   * computed per comment so they can reflect its state.\n   */\n  extraAssignItems?: (comment: Comment) => DropdownMenuItem[];\n  run: CommentActionRunner;\n};\n\nfunction isSameAssignee(left: CommentAuthor, right: CommentAuthor): boolean {\n  return left.name === right.name && (left.kind ?? \"user\") === (right.kind ?? \"user\");\n}\n\n/**\n * The targets of an assignment: each configured person or agent, \"Unassign\"\n * while someone holds the root, then the caller's extra items. The dashboard\n * mounts these directly under its own trigger; cards nest them under \"Assign…\".\n */\nexport function assignTargetItems(\n  options: CommentAssignmentOptions,\n): DropdownMenuItem[] {\n  const { comment, config, onAssign, extraAssignItems, run } = options;\n  const items: DropdownMenuItem[] = [];\n  if (onAssign) {\n    for (const { id, name, kind } of config.assignees ?? []) {\n      const target: CommentAuthor = { id, name, kind };\n      const current =\n        comment.assignee !== undefined &&\n        isSameAssignee(comment.assignee, target);\n      items.push({\n        label: name,\n        icon: kind === \"agent\" ? UiRobotAi : UiUser,\n        disabled: current,\n        title: current ? `Already assigned to ${name}` : `Assign to ${name}`,\n        onSelect: () => run(\"assign\", () => onAssign(target)),\n      });\n    }\n    if (comment.assignee) {\n      items.push({\n        label: \"Unassign\",\n        icon: UiUserMinus,\n        onSelect: () => run(\"assign\", () => onAssign(null)),\n      });\n    }\n  }\n  items.push(...(extraAssignItems?.(comment) ?? []));\n  return items;\n}\n\n/**\n * The root-only entries of a card's actions menu: Acknowledge while nobody\n * holds an active root, and an \"Assign…\" submenu of its targets. Empty for\n * resolved or closed roots, which are no longer being worked on.\n */\nexport function assignmentMenuItems(\n  options: CommentAssignmentOptions,\n): DropdownMenuItem[] {\n  const { comment, config, onAcknowledge, run } = options;\n  if (comment.parentId) return [];\n  if (resolveCommentStage(config, comment.status) !== \"active\") return [];\n  const items: DropdownMenuItem[] = [];\n  if (onAcknowledge && !comment.assignee) {\n    items.push({\n      label: \"Acknowledge\",\n      icon: UiUserCheck,\n      onSelect: () => run(\"acknowledge\", onAcknowledge),\n    });\n  }\n  const targets = assignTargetItems(options);\n  if (targets.length > 0) {\n    items.push({\n      label: \"Assign…\",\n      icon: UiUserPlus,\n      // Opening the submenu is the whole action; the parent never fires it.\n      onSelect: () => {},\n      children: targets,\n    });\n  }\n  return items;\n}\n"],"mappings":";;;;AA0BA,SAAS,eAAe,MAAqB,OAA+B;CAC1E,OAAO,KAAK,SAAS,MAAM,SAAS,KAAK,QAAQ,aAAa,MAAM,QAAQ;AAC9E;;;;;;AAOA,SAAgB,kBACd,SACoB;CACpB,MAAM,EAAE,SAAS,QAAQ,UAAU,kBAAkB,QAAQ;CAC7D,MAAM,QAA4B,CAAC;CACnC,IAAI,UAAU;EACZ,KAAK,MAAM,EAAE,IAAI,MAAM,UAAU,OAAO,aAAa,CAAC,GAAG;GACvD,MAAM,SAAwB;IAAE;IAAI;IAAM;GAAK;GAC/C,MAAM,UACJ,QAAQ,aAAa,KAAA,KACrB,eAAe,QAAQ,UAAU,MAAM;GACzC,MAAM,KAAK;IACT,OAAO;IACP,MAAM,SAAS,UAAU,YAAY;IACrC,UAAU;IACV,OAAO,UAAU,uBAAuB,SAAS,aAAa;IAC9D,gBAAgB,IAAI,gBAAgB,SAAS,MAAM,CAAC;GACtD,CAAC;EACH;EACA,IAAI,QAAQ,UACV,MAAM,KAAK;GACT,OAAO;GACP,MAAM;GACN,gBAAgB,IAAI,gBAAgB,SAAS,IAAI,CAAC;EACpD,CAAC;CAEL;CACA,MAAM,KAAK,GAAI,mBAAmB,OAAO,KAAK,CAAC,CAAE;CACjD,OAAO;AACT;;;;;;AAOA,SAAgB,oBACd,SACoB;CACpB,MAAM,EAAE,SAAS,QAAQ,eAAe,QAAQ;CAChD,IAAI,QAAQ,UAAU,OAAO,CAAC;CAC9B,IAAI,oBAAoB,QAAQ,QAAQ,MAAM,MAAM,UAAU,OAAO,CAAC;CACtE,MAAM,QAA4B,CAAC;CACnC,IAAI,iBAAiB,CAAC,QAAQ,UAC5B,MAAM,KAAK;EACT,OAAO;EACP,MAAM;EACN,gBAAgB,IAAI,eAAe,aAAa;CAClD,CAAC;CAEH,MAAM,UAAU,kBAAkB,OAAO;CACzC,IAAI,QAAQ,SAAS,GACnB,MAAM,KAAK;EACT,OAAO;EACP,MAAM;EAEN,gBAAgB,CAAC;EACjB,UAAU;CACZ,CAAC;CAEH,OAAO;AACT"}

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

@@ -1 +1 @@
-{"version":3,"file":"comment-types.cjs","names":[],"sources":["../../src/comments/comment-types.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport type { StaticIconComponent } from \"../data/Icon\";\n\n/** Semantic tone driving a status/facet color (maps onto Badge tones). */\nexport type CommentTone =\n  | \"default\"\n  | \"info\"\n  | \"success\"\n  | \"warning\"\n  | \"danger\"\n  | \"neutral\";\n\n/** Product lifecycle stage represented by one or more stored statuses. */\nexport type CommentStatusStage = \"active\" | \"resolved\" | \"closed\";\n\n/** A single selectable status (e.g. \"open\", \"resolved\"). Consumer-defined. */\nexport type CommentStatusConfig = {\n  /** Stable value stored on a comment's `status`. */\n  value: string;\n  /** Human label shown in menus and badges. */\n  label: string;\n  /** Color tone for the status chip. */\n  tone?: CommentTone;\n  /** Optional leading glyph. */\n  icon?: string | StaticIconComponent;\n  /** Lifecycle stage used by review queues and status actions. */\n  stage?: CommentStatusStage;\n  /**\n   * Whether this status counts as \"unresolved/open\" — drives progress tallies\n   * and which groups start expanded. Defaults to false.\n   */\n  unresolved?: boolean;\n};\n\n/** One option of a generic facet (e.g. a \"category\" value). */\nexport type CommentFacetOption = {\n  value: string;\n  label: string;\n  tone?: CommentTone;\n  /** Compact glyph for the collapsed card (e.g. \"BS\" for a category). */\n  short?: string;\n};\n\n/**\n * A generic, consumer-supplied classification axis. Replaces the financial\n * category/severity vocabulary — any app declares its own facets.\n */\nexport type CommentFacet = {\n  /** Key into `Comment.facets`. */\n  key: string;\n  label: string;\n  options: CommentFacetOption[];\n  /** Allow several values to be selected at once in the filter bar. */\n  multiple?: boolean;\n};\n\nexport type CommentMentionKind = \"user\" | \"agent\";\n\n/** A person or agent that can be @-mentioned in the composer. */\nexport type CommentMentionable = {\n  id: string;\n  name: string;\n  /** Image URL for `kind: \"user\"`. */\n  avatar?: string;\n  kind: CommentMentionKind;\n  /** Glyph override for `kind: \"agent\"`. */\n  icon?: string | StaticIconComponent;\n};\n\n/** A resolved mention emitted when a comment referencing a mentionable is posted. */\nexport type CommentMention = {\n  id: string;\n  name: string;\n  kind: CommentMentionKind;\n};\n\n/** A labelled group of reference chips (e.g. linked ids). */\nexport type CommentRefGroup = {\n  label: string;\n  items: string[];\n  /** Render items in a monospace font. */\n  mono?: boolean;\n};\n\n/** One item of a generic checklist; `status` cycles through `checklistStatusCycle`. */\nexport type CommentChecklistItem = {\n  label: string;\n  status: string;\n};\n\nexport type CommentAuthor = {\n  id?: string;\n  name: string;\n  kind?: CommentMentionKind;\n  avatar?: string;\n  /** Glyph override for `kind: \"agent\"` authors. */\n  icon?: string | StaticIconComponent;\n};\n\n/**\n * An opaque anchor key locating a comment within a document. Not a JSON path —\n * any stable string a consumer registers via the provider. `null`/absent means\n * document-level.\n */\nexport type CommentAnchor = string;\n\n/** Binary review signal attached to a root comment. */\nexport type CommentRating = \"positive\" | \"negative\";\nexport type CommentReviewDecision =\n  | \"approved\"\n  | \"rejected\"\n  | \"revision_requested\";\n\n/** Anchor key reserved for document-level (un-anchored) comments. */\nexport const DOCUMENT_ANCHOR = \"__document__\";\n\n/** A single comment. Replies set `parentId`; roots leave it null. */\nexport type Comment = {\n  id: string;\n  body: string;\n  /** ISO-8601 creation time. */\n  createdAt: string;\n  /** ISO-8601 last-update time. */\n  updatedAt?: string;\n  author: CommentAuthor | null;\n  /** Key into the configured statuses; roots only. */\n  status?: string;\n  /** Parent comment id when this is a reply. */\n  parentId?: string | null;\n  /** Where the comment is anchored; null/absent = document-level. */\n  anchor?: CommentAnchor | null;\n  /** Optional positive/negative review signal; roots only. */\n  rating?: CommentRating;\n  /** Human decision on an opted-in playground review element; roots only. */\n  reviewDecision?: CommentReviewDecision;\n  /** ISO-8601 time when a human closed the resolved comment. */\n  closedAt?: string;\n  /** Human who closed the comment. */\n  closedBy?: CommentAuthor;\n  /** facet.key → selected option value. */\n  facets?: Record<string, string>;\n  refs?: CommentRefGroup[];\n  checklist?: CommentChecklistItem[];\n};\n\n/** Payload for creating a new root comment. */\nexport type CommentCreateInput = {\n  body: string;\n  anchor?: CommentAnchor | null;\n  rating?: CommentRating;\n  reviewDecision?: CommentReviewDecision;\n  facets?: Record<string, string>;\n  mentions?: CommentMention[];\n};\n\nexport type CommentCreateAction = { id: string; label: string };\n\n/** Payload for replying to a comment. */\nexport type CommentReplyInput = {\n  parentId: string;\n  body: string;\n  anchor?: CommentAnchor | null;\n  mentions?: CommentMention[];\n};\n\n/**\n * Controlled callbacks. The components own no data fetching; the consumer\n * performs the mutation and feeds the updated `comments` back in.\n */\nexport type CommentCallbacks = {\n  onCreate?: (\n    input: CommentCreateInput,\n    actionId?: string,\n  ) => void | Promise<void>;\n  onReply?: (input: CommentReplyInput) => void | Promise<void>;\n  onUpdateStatus?: (id: string, status: string) => void | Promise<void>;\n  /** Human-only transition from active or resolved to closed. */\n  onClose?: (id: string) => void | Promise<void>;\n  onUpdateRating?: (id: string, rating: CommentRating) => void | Promise<void>;\n  onDelete?: (id: string) => void | Promise<void>;\n  onChecklistToggle?: (\n    id: string,\n    index: number,\n    next: string,\n  ) => void | Promise<void>;\n  /** Fired when a posted comment references a mentionable. */\n  onMention?: (mention: CommentMention, context: { body: string }) => void;\n};\n\n/** Static configuration shared across the comment components. */\nexport type CommentConfig = {\n  /** Selectable statuses; the first `unresolved` one is the default for new comments. */\n  statuses: CommentStatusConfig[];\n  /** Classification axes (category/severity/etc.). */\n  facets?: CommentFacet[];\n  /** People/agents available for @-mention. */\n  mentionables?: CommentMentionable[];\n  /** Status values a checklist item cycles through on click. */\n  checklistStatusCycle?: string[];\n};\n\n/** Aggregate metadata for one anchor, derived from the comment list. */\nexport type CommentAnchorMeta = {\n  count: number;\n  authors: string[];\n  latestStatus?: string;\n};\n\n/** Selected filter state for the filter bar / `applyCommentFilters`. */\nexport type CommentFilters = {\n  /** Selected status values; empty = all statuses. */\n  statuses: Set<string>;\n  /** facet.key → selected option values; empty set = all values for that facet. */\n  facets: Record<string, Set<string>>;\n  /** Restrict to an author kind, or \"all\". */\n  authorKind?: CommentMentionKind | \"all\";\n};\n\n/** Optional renderers passed down to a card. */\nexport type CommentRenderOptions = {\n  /** Custom comment-body renderer (e.g. full Markdown). Defaults to CommentMarkdown. */\n  renderBody?: (body: string) => ReactNode;\n};\n\n/** A domain-free default status set: open / in progress / resolved / closed. */\nexport const DEFAULT_COMMENT_STATUSES: CommentStatusConfig[] = [\n  {\n    value: \"open\",\n    label: \"Open\",\n    tone: \"info\",\n    unresolved: true,\n    stage: \"active\",\n  },\n  {\n    value: \"in_progress\",\n    label: \"In progress\",\n    tone: \"warning\",\n    unresolved: true,\n    stage: \"active\",\n  },\n  {\n    value: \"resolved\",\n    label: \"Resolved\",\n    tone: \"success\",\n    stage: \"resolved\",\n  },\n  { value: \"closed\", label: \"Closed\", tone: \"neutral\", stage: \"closed\" },\n];\n\n/** Default checklist status cycle used when a consumer omits one. */\nexport const DEFAULT_CHECKLIST_CYCLE = [\"open\", \"in_progress\", \"done\"];\n"],"mappings":";;AAkHA,IAAa,kBAAkB;;AA+G/B,IAAa,2BAAkD;CAC7D;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,YAAY;EACZ,OAAO;CACT;CACA;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,YAAY;EACZ,OAAO;CACT;CACA;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,OAAO;CACT;CACA;EAAE,OAAO;EAAU,OAAO;EAAU,MAAM;EAAW,OAAO;CAAS;AACvE;;AAGA,IAAa,0BAA0B;CAAC;CAAQ;CAAe;AAAM"}
+{"version":3,"file":"comment-types.cjs","names":[],"sources":["../../src/comments/comment-types.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport type { StaticIconComponent } from \"../data/Icon\";\n\n/** Semantic tone driving a status/facet color (maps onto Badge tones). */\nexport type CommentTone =\n  | \"default\"\n  | \"info\"\n  | \"success\"\n  | \"warning\"\n  | \"danger\"\n  | \"neutral\";\n\n/** Product lifecycle stage represented by one or more stored statuses. */\nexport type CommentStatusStage = \"active\" | \"resolved\" | \"closed\";\n\n/** A single selectable status (e.g. \"open\", \"resolved\"). Consumer-defined. */\nexport type CommentStatusConfig = {\n  /** Stable value stored on a comment's `status`. */\n  value: string;\n  /** Human label shown in menus and badges. */\n  label: string;\n  /** Color tone for the status chip. */\n  tone?: CommentTone;\n  /** Optional leading glyph. */\n  icon?: string | StaticIconComponent;\n  /** Lifecycle stage used by review queues and status actions. */\n  stage?: CommentStatusStage;\n  /**\n   * Whether this status counts as \"unresolved/open\" — drives progress tallies\n   * and which groups start expanded. Defaults to false.\n   */\n  unresolved?: boolean;\n};\n\n/** One option of a generic facet (e.g. a \"category\" value). */\nexport type CommentFacetOption = {\n  value: string;\n  label: string;\n  tone?: CommentTone;\n  /** Compact glyph for the collapsed card (e.g. \"BS\" for a category). */\n  short?: string;\n};\n\n/**\n * A generic, consumer-supplied classification axis. Replaces the financial\n * category/severity vocabulary — any app declares its own facets.\n */\nexport type CommentFacet = {\n  /** Key into `Comment.facets`. */\n  key: string;\n  label: string;\n  options: CommentFacetOption[];\n  /** Allow several values to be selected at once in the filter bar. */\n  multiple?: boolean;\n};\n\nexport type CommentMentionKind = \"user\" | \"agent\";\n\n/** A person or agent that can be @-mentioned in the composer. */\nexport type CommentMentionable = {\n  id: string;\n  name: string;\n  /** Image URL for `kind: \"user\"`. */\n  avatar?: string;\n  kind: CommentMentionKind;\n  /** Glyph override for `kind: \"agent\"`. */\n  icon?: string | StaticIconComponent;\n};\n\n/** A resolved mention emitted when a comment referencing a mentionable is posted. */\nexport type CommentMention = {\n  id: string;\n  name: string;\n  kind: CommentMentionKind;\n};\n\n/** A labelled group of reference chips (e.g. linked ids). */\nexport type CommentRefGroup = {\n  label: string;\n  items: string[];\n  /** Render items in a monospace font. */\n  mono?: boolean;\n};\n\n/** One item of a generic checklist; `status` cycles through `checklistStatusCycle`. */\nexport type CommentChecklistItem = {\n  label: string;\n  status: string;\n};\n\nexport type CommentAuthor = {\n  id?: string;\n  name: string;\n  kind?: CommentMentionKind;\n  avatar?: string;\n  /** Glyph override for `kind: \"agent\"` authors. */\n  icon?: string | StaticIconComponent;\n  /** The agent that posted on `name`'s behalf, when another agent wrote the text. */\n  via?: string;\n  /** The session that produced the text, so the run can be inspected later. */\n  sessionId?: string;\n  /** AI response cost in USD for producing the text. */\n  cost?: number;\n};\n\n/**\n * An opaque anchor key locating a comment within a document. Not a JSON path —\n * any stable string a consumer registers via the provider. `null`/absent means\n * document-level.\n */\nexport type CommentAnchor = string;\n\n/** Binary review signal attached to a root comment. */\nexport type CommentRating = \"positive\" | \"negative\";\nexport type CommentReviewDecision =\n  | \"approved\"\n  | \"rejected\"\n  | \"revision_requested\";\n\n/** Anchor key reserved for document-level (un-anchored) comments. */\nexport const DOCUMENT_ANCHOR = \"__document__\";\n\nexport type CommentAgentRunState = \"queued\" | \"sent\" | \"done\" | \"error\";\n\n/**\n * A root handed to an agent session. Hosts may share one session between many\n * roots; the library only carries the record so a host can render it.\n */\nexport type CommentAgentRun = {\n  /** Absent when the hand-off failed before a session existed. */\n  sessionId?: string;\n  /** ISO-8601 time the hand-off was requested. */\n  requestedAt: string;\n  state: CommentAgentRunState;\n  /** Why the hand-off failed; present only when `state` is `error`. */\n  error?: string;\n  /** Host label for where the root went, and how it was delivered, when not the host's default session. */\n  target?: { label: string; channel?: string };\n};\n\n/** A single comment. Replies set `parentId`; roots leave it null. */\nexport type Comment = {\n  id: string;\n  body: string;\n  /** ISO-8601 creation time. */\n  createdAt: string;\n  /** ISO-8601 last-update time. */\n  updatedAt?: string;\n  author: CommentAuthor | null;\n  /** Key into the configured statuses; roots only. */\n  status?: string;\n  /** Parent comment id when this is a reply. */\n  parentId?: string | null;\n  /** Where the comment is anchored; null/absent = document-level. */\n  anchor?: CommentAnchor | null;\n  /** Optional positive/negative review signal; roots only. */\n  rating?: CommentRating;\n  /** Human decision on an opted-in playground review element; roots only. */\n  reviewDecision?: CommentReviewDecision;\n  /** ISO-8601 time when a human closed the resolved comment. */\n  closedAt?: string;\n  /** Human who closed the comment. */\n  closedBy?: CommentAuthor;\n  /** Who holds the thread while it is being worked on; roots only. */\n  assignee?: CommentAuthor;\n  /** ISO-8601 time when `acknowledgedBy` picked the thread up; absent while merely assigned. */\n  acknowledgedAt?: string;\n  /** Who acknowledged the thread. */\n  acknowledgedBy?: CommentAuthor;\n  /** The agent-session hand-off for this thread; roots only. */\n  agentRun?: CommentAgentRun;\n  /** facet.key → selected option value. */\n  facets?: Record<string, string>;\n  refs?: CommentRefGroup[];\n  checklist?: CommentChecklistItem[];\n};\n\n/** Payload for creating a new root comment. */\nexport type CommentCreateInput = {\n  body: string;\n  anchor?: CommentAnchor | null;\n  rating?: CommentRating;\n  reviewDecision?: CommentReviewDecision;\n  facets?: Record<string, string>;\n  mentions?: CommentMention[];\n};\n\nexport type CommentCreateAction = { id: string; label: string };\n\n/** Payload for replying to a comment. */\nexport type CommentReplyInput = {\n  parentId: string;\n  body: string;\n  anchor?: CommentAnchor | null;\n  mentions?: CommentMention[];\n};\n\n/**\n * Controlled callbacks. The components own no data fetching; the consumer\n * performs the mutation and feeds the updated `comments` back in.\n */\nexport type CommentCallbacks = {\n  onCreate?: (\n    input: CommentCreateInput,\n    actionId?: string,\n  ) => void | Promise<void>;\n  onReply?: (input: CommentReplyInput) => void | Promise<void>;\n  onUpdateStatus?: (id: string, status: string) => void | Promise<void>;\n  /** Human-only transition from active or resolved to closed. */\n  onClose?: (id: string) => void | Promise<void>;\n  /** Claim an unassigned active root for the current user or agent. */\n  onAcknowledge?: (id: string) => void | Promise<void>;\n  /** Hand an active root to `assignee`, or return it to unassigned with `null`. */\n  onAssign?: (\n    id: string,\n    assignee: CommentAuthor | null,\n  ) => void | Promise<void>;\n  onUpdateRating?: (id: string, rating: CommentRating) => void | Promise<void>;\n  onDelete?: (id: string) => void | Promise<void>;\n  onChecklistToggle?: (\n    id: string,\n    index: number,\n    next: string,\n  ) => void | Promise<void>;\n  /** Fired when a posted comment references a mentionable. */\n  onMention?: (mention: CommentMention, context: { body: string }) => void;\n};\n\n/** Static configuration shared across the comment components. */\nexport type CommentConfig = {\n  /** Selectable statuses; the first `unresolved` one is the default for new comments. */\n  statuses: CommentStatusConfig[];\n  /** Classification axes (category/severity/etc.). */\n  facets?: CommentFacet[];\n  /** People/agents available for @-mention. */\n  mentionables?: CommentMentionable[];\n  /** People/agents a root can be assigned to; the Assign menu lists exactly these. */\n  assignees?: CommentMentionable[];\n  /** Status values a checklist item cycles through on click. */\n  checklistStatusCycle?: string[];\n};\n\n/** Aggregate metadata for one anchor, derived from the comment list. */\nexport type CommentAnchorMeta = {\n  count: number;\n  authors: string[];\n  latestStatus?: string;\n};\n\n/** Selected filter state for the filter bar / `applyCommentFilters`. */\nexport type CommentFilters = {\n  /** Selected status values; empty = all statuses. */\n  statuses: Set<string>;\n  /** facet.key → selected option values; empty set = all values for that facet. */\n  facets: Record<string, Set<string>>;\n  /** Restrict to an author kind, or \"all\". */\n  authorKind?: CommentMentionKind | \"all\";\n};\n\n/** Optional renderers passed down to a card. */\nexport type CommentRenderOptions = {\n  /** Custom comment-body renderer (e.g. full Markdown). Defaults to CommentMarkdown. */\n  renderBody?: (body: string) => ReactNode;\n};\n\n/** A domain-free default status set: open / in progress / resolved / closed. */\nexport const DEFAULT_COMMENT_STATUSES: CommentStatusConfig[] = [\n  {\n    value: \"open\",\n    label: \"Open\",\n    tone: \"info\",\n    unresolved: true,\n    stage: \"active\",\n  },\n  {\n    value: \"in_progress\",\n    label: \"In progress\",\n    tone: \"warning\",\n    unresolved: true,\n    stage: \"active\",\n  },\n  {\n    value: \"resolved\",\n    label: \"Resolved\",\n    tone: \"success\",\n    stage: \"resolved\",\n  },\n  { value: \"closed\", label: \"Closed\", tone: \"neutral\", stage: \"closed\" },\n];\n\n/** Default checklist status cycle used when a consumer omits one. */\nexport const DEFAULT_CHECKLIST_CYCLE = [\"open\", \"in_progress\", \"done\"];\n"],"mappings":";;AAwHA,IAAa,kBAAkB;;AAkJ/B,IAAa,2BAAkD;CAC7D;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,YAAY;EACZ,OAAO;CACT;CACA;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,YAAY;EACZ,OAAO;CACT;CACA;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,OAAO;CACT;CACA;EAAE,OAAO;EAAU,OAAO;EAAU,MAAM;EAAW,OAAO;CAAS;AACvE;;AAGA,IAAa,0BAA0B;CAAC;CAAQ;CAAe;AAAM"}

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

@@ -78,6 +78,12 @@ export type CommentAuthor = {
     avatar?: string;
     /** Glyph override for `kind: "agent"` authors. */
     icon?: string | StaticIconComponent;
+    /** The agent that posted on `name`'s behalf, when another agent wrote the text. */
+    via?: string;
+    /** The session that produced the text, so the run can be inspected later. */
+    sessionId?: string;
+    /** AI response cost in USD for producing the text. */
+    cost?: number;
 };
 /**
  * An opaque anchor key locating a comment within a document. Not a JSON path —
@@ -90,6 +96,25 @@ export type CommentRating = "positive" | "negative";
 export type CommentReviewDecision = "approved" | "rejected" | "revision_requested";
 /** Anchor key reserved for document-level (un-anchored) comments. */
 export declare const DOCUMENT_ANCHOR = "__document__";
+export type CommentAgentRunState = "queued" | "sent" | "done" | "error";
+/**
+ * A root handed to an agent session. Hosts may share one session between many
+ * roots; the library only carries the record so a host can render it.
+ */
+export type CommentAgentRun = {
+    /** Absent when the hand-off failed before a session existed. */
+    sessionId?: string;
+    /** ISO-8601 time the hand-off was requested. */
+    requestedAt: string;
+    state: CommentAgentRunState;
+    /** Why the hand-off failed; present only when `state` is `error`. */
+    error?: string;
+    /** Host label for where the root went, and how it was delivered, when not the host's default session. */
+    target?: {
+        label: string;
+        channel?: string;
+    };
+};
 /** A single comment. Replies set `parentId`; roots leave it null. */
 export type Comment = {
     id: string;
@@ -113,6 +138,14 @@ export type Comment = {
     closedAt?: string;
     /** Human who closed the comment. */
     closedBy?: CommentAuthor;
+    /** Who holds the thread while it is being worked on; roots only. */
+    assignee?: CommentAuthor;
+    /** ISO-8601 time when `acknowledgedBy` picked the thread up; absent while merely assigned. */
+    acknowledgedAt?: string;
+    /** Who acknowledged the thread. */
+    acknowledgedBy?: CommentAuthor;
+    /** The agent-session hand-off for this thread; roots only. */
+    agentRun?: CommentAgentRun;
     /** facet.key → selected option value. */
     facets?: Record<string, string>;
     refs?: CommentRefGroup[];
@@ -148,6 +181,10 @@ export type CommentCallbacks = {
     onUpdateStatus?: (id: string, status: string) => void | Promise<void>;
     /** Human-only transition from active or resolved to closed. */
     onClose?: (id: string) => void | Promise<void>;
+    /** Claim an unassigned active root for the current user or agent. */
+    onAcknowledge?: (id: string) => void | Promise<void>;
+    /** Hand an active root to `assignee`, or return it to unassigned with `null`. */
+    onAssign?: (id: string, assignee: CommentAuthor | null) => void | Promise<void>;
     onUpdateRating?: (id: string, rating: CommentRating) => void | Promise<void>;
     onDelete?: (id: string) => void | Promise<void>;
     onChecklistToggle?: (id: string, index: number, next: string) => void | Promise<void>;
@@ -164,6 +201,8 @@ export type CommentConfig = {
     facets?: CommentFacet[];
     /** People/agents available for @-mention. */
     mentionables?: CommentMentionable[];
+    /** People/agents a root can be assigned to; the Assign menu lists exactly these. */
+    assignees?: CommentMentionable[];
     /** Status values a checklist item cycles through on click. */
     checklistStatusCycle?: string[];
 };

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"comment-types.js","names":[],"sources":["../../src/comments/comment-types.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport type { StaticIconComponent } from \"../data/Icon\";\n\n/** Semantic tone driving a status/facet color (maps onto Badge tones). */\nexport type CommentTone =\n  | \"default\"\n  | \"info\"\n  | \"success\"\n  | \"warning\"\n  | \"danger\"\n  | \"neutral\";\n\n/** Product lifecycle stage represented by one or more stored statuses. */\nexport type CommentStatusStage = \"active\" | \"resolved\" | \"closed\";\n\n/** A single selectable status (e.g. \"open\", \"resolved\"). Consumer-defined. */\nexport type CommentStatusConfig = {\n  /** Stable value stored on a comment's `status`. */\n  value: string;\n  /** Human label shown in menus and badges. */\n  label: string;\n  /** Color tone for the status chip. */\n  tone?: CommentTone;\n  /** Optional leading glyph. */\n  icon?: string | StaticIconComponent;\n  /** Lifecycle stage used by review queues and status actions. */\n  stage?: CommentStatusStage;\n  /**\n   * Whether this status counts as \"unresolved/open\" — drives progress tallies\n   * and which groups start expanded. Defaults to false.\n   */\n  unresolved?: boolean;\n};\n\n/** One option of a generic facet (e.g. a \"category\" value). */\nexport type CommentFacetOption = {\n  value: string;\n  label: string;\n  tone?: CommentTone;\n  /** Compact glyph for the collapsed card (e.g. \"BS\" for a category). */\n  short?: string;\n};\n\n/**\n * A generic, consumer-supplied classification axis. Replaces the financial\n * category/severity vocabulary — any app declares its own facets.\n */\nexport type CommentFacet = {\n  /** Key into `Comment.facets`. */\n  key: string;\n  label: string;\n  options: CommentFacetOption[];\n  /** Allow several values to be selected at once in the filter bar. */\n  multiple?: boolean;\n};\n\nexport type CommentMentionKind = \"user\" | \"agent\";\n\n/** A person or agent that can be @-mentioned in the composer. */\nexport type CommentMentionable = {\n  id: string;\n  name: string;\n  /** Image URL for `kind: \"user\"`. */\n  avatar?: string;\n  kind: CommentMentionKind;\n  /** Glyph override for `kind: \"agent\"`. */\n  icon?: string | StaticIconComponent;\n};\n\n/** A resolved mention emitted when a comment referencing a mentionable is posted. */\nexport type CommentMention = {\n  id: string;\n  name: string;\n  kind: CommentMentionKind;\n};\n\n/** A labelled group of reference chips (e.g. linked ids). */\nexport type CommentRefGroup = {\n  label: string;\n  items: string[];\n  /** Render items in a monospace font. */\n  mono?: boolean;\n};\n\n/** One item of a generic checklist; `status` cycles through `checklistStatusCycle`. */\nexport type CommentChecklistItem = {\n  label: string;\n  status: string;\n};\n\nexport type CommentAuthor = {\n  id?: string;\n  name: string;\n  kind?: CommentMentionKind;\n  avatar?: string;\n  /** Glyph override for `kind: \"agent\"` authors. */\n  icon?: string | StaticIconComponent;\n};\n\n/**\n * An opaque anchor key locating a comment within a document. Not a JSON path —\n * any stable string a consumer registers via the provider. `null`/absent means\n * document-level.\n */\nexport type CommentAnchor = string;\n\n/** Binary review signal attached to a root comment. */\nexport type CommentRating = \"positive\" | \"negative\";\nexport type CommentReviewDecision =\n  | \"approved\"\n  | \"rejected\"\n  | \"revision_requested\";\n\n/** Anchor key reserved for document-level (un-anchored) comments. */\nexport const DOCUMENT_ANCHOR = \"__document__\";\n\n/** A single comment. Replies set `parentId`; roots leave it null. */\nexport type Comment = {\n  id: string;\n  body: string;\n  /** ISO-8601 creation time. */\n  createdAt: string;\n  /** ISO-8601 last-update time. */\n  updatedAt?: string;\n  author: CommentAuthor | null;\n  /** Key into the configured statuses; roots only. */\n  status?: string;\n  /** Parent comment id when this is a reply. */\n  parentId?: string | null;\n  /** Where the comment is anchored; null/absent = document-level. */\n  anchor?: CommentAnchor | null;\n  /** Optional positive/negative review signal; roots only. */\n  rating?: CommentRating;\n  /** Human decision on an opted-in playground review element; roots only. */\n  reviewDecision?: CommentReviewDecision;\n  /** ISO-8601 time when a human closed the resolved comment. */\n  closedAt?: string;\n  /** Human who closed the comment. */\n  closedBy?: CommentAuthor;\n  /** facet.key → selected option value. */\n  facets?: Record<string, string>;\n  refs?: CommentRefGroup[];\n  checklist?: CommentChecklistItem[];\n};\n\n/** Payload for creating a new root comment. */\nexport type CommentCreateInput = {\n  body: string;\n  anchor?: CommentAnchor | null;\n  rating?: CommentRating;\n  reviewDecision?: CommentReviewDecision;\n  facets?: Record<string, string>;\n  mentions?: CommentMention[];\n};\n\nexport type CommentCreateAction = { id: string; label: string };\n\n/** Payload for replying to a comment. */\nexport type CommentReplyInput = {\n  parentId: string;\n  body: string;\n  anchor?: CommentAnchor | null;\n  mentions?: CommentMention[];\n};\n\n/**\n * Controlled callbacks. The components own no data fetching; the consumer\n * performs the mutation and feeds the updated `comments` back in.\n */\nexport type CommentCallbacks = {\n  onCreate?: (\n    input: CommentCreateInput,\n    actionId?: string,\n  ) => void | Promise<void>;\n  onReply?: (input: CommentReplyInput) => void | Promise<void>;\n  onUpdateStatus?: (id: string, status: string) => void | Promise<void>;\n  /** Human-only transition from active or resolved to closed. */\n  onClose?: (id: string) => void | Promise<void>;\n  onUpdateRating?: (id: string, rating: CommentRating) => void | Promise<void>;\n  onDelete?: (id: string) => void | Promise<void>;\n  onChecklistToggle?: (\n    id: string,\n    index: number,\n    next: string,\n  ) => void | Promise<void>;\n  /** Fired when a posted comment references a mentionable. */\n  onMention?: (mention: CommentMention, context: { body: string }) => void;\n};\n\n/** Static configuration shared across the comment components. */\nexport type CommentConfig = {\n  /** Selectable statuses; the first `unresolved` one is the default for new comments. */\n  statuses: CommentStatusConfig[];\n  /** Classification axes (category/severity/etc.). */\n  facets?: CommentFacet[];\n  /** People/agents available for @-mention. */\n  mentionables?: CommentMentionable[];\n  /** Status values a checklist item cycles through on click. */\n  checklistStatusCycle?: string[];\n};\n\n/** Aggregate metadata for one anchor, derived from the comment list. */\nexport type CommentAnchorMeta = {\n  count: number;\n  authors: string[];\n  latestStatus?: string;\n};\n\n/** Selected filter state for the filter bar / `applyCommentFilters`. */\nexport type CommentFilters = {\n  /** Selected status values; empty = all statuses. */\n  statuses: Set<string>;\n  /** facet.key → selected option values; empty set = all values for that facet. */\n  facets: Record<string, Set<string>>;\n  /** Restrict to an author kind, or \"all\". */\n  authorKind?: CommentMentionKind | \"all\";\n};\n\n/** Optional renderers passed down to a card. */\nexport type CommentRenderOptions = {\n  /** Custom comment-body renderer (e.g. full Markdown). Defaults to CommentMarkdown. */\n  renderBody?: (body: string) => ReactNode;\n};\n\n/** A domain-free default status set: open / in progress / resolved / closed. */\nexport const DEFAULT_COMMENT_STATUSES: CommentStatusConfig[] = [\n  {\n    value: \"open\",\n    label: \"Open\",\n    tone: \"info\",\n    unresolved: true,\n    stage: \"active\",\n  },\n  {\n    value: \"in_progress\",\n    label: \"In progress\",\n    tone: \"warning\",\n    unresolved: true,\n    stage: \"active\",\n  },\n  {\n    value: \"resolved\",\n    label: \"Resolved\",\n    tone: \"success\",\n    stage: \"resolved\",\n  },\n  { value: \"closed\", label: \"Closed\", tone: \"neutral\", stage: \"closed\" },\n];\n\n/** Default checklist status cycle used when a consumer omits one. */\nexport const DEFAULT_CHECKLIST_CYCLE = [\"open\", \"in_progress\", \"done\"];\n"],"mappings":";;AAkHA,IAAa,kBAAkB;;AA+G/B,IAAa,2BAAkD;CAC7D;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,YAAY;EACZ,OAAO;CACT;CACA;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,YAAY;EACZ,OAAO;CACT;CACA;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,OAAO;CACT;CACA;EAAE,OAAO;EAAU,OAAO;EAAU,MAAM;EAAW,OAAO;CAAS;AACvE;;AAGA,IAAa,0BAA0B;CAAC;CAAQ;CAAe;AAAM"}
+{"version":3,"file":"comment-types.js","names":[],"sources":["../../src/comments/comment-types.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport type { StaticIconComponent } from \"../data/Icon\";\n\n/** Semantic tone driving a status/facet color (maps onto Badge tones). */\nexport type CommentTone =\n  | \"default\"\n  | \"info\"\n  | \"success\"\n  | \"warning\"\n  | \"danger\"\n  | \"neutral\";\n\n/** Product lifecycle stage represented by one or more stored statuses. */\nexport type CommentStatusStage = \"active\" | \"resolved\" | \"closed\";\n\n/** A single selectable status (e.g. \"open\", \"resolved\"). Consumer-defined. */\nexport type CommentStatusConfig = {\n  /** Stable value stored on a comment's `status`. */\n  value: string;\n  /** Human label shown in menus and badges. */\n  label: string;\n  /** Color tone for the status chip. */\n  tone?: CommentTone;\n  /** Optional leading glyph. */\n  icon?: string | StaticIconComponent;\n  /** Lifecycle stage used by review queues and status actions. */\n  stage?: CommentStatusStage;\n  /**\n   * Whether this status counts as \"unresolved/open\" — drives progress tallies\n   * and which groups start expanded. Defaults to false.\n   */\n  unresolved?: boolean;\n};\n\n/** One option of a generic facet (e.g. a \"category\" value). */\nexport type CommentFacetOption = {\n  value: string;\n  label: string;\n  tone?: CommentTone;\n  /** Compact glyph for the collapsed card (e.g. \"BS\" for a category). */\n  short?: string;\n};\n\n/**\n * A generic, consumer-supplied classification axis. Replaces the financial\n * category/severity vocabulary — any app declares its own facets.\n */\nexport type CommentFacet = {\n  /** Key into `Comment.facets`. */\n  key: string;\n  label: string;\n  options: CommentFacetOption[];\n  /** Allow several values to be selected at once in the filter bar. */\n  multiple?: boolean;\n};\n\nexport type CommentMentionKind = \"user\" | \"agent\";\n\n/** A person or agent that can be @-mentioned in the composer. */\nexport type CommentMentionable = {\n  id: string;\n  name: string;\n  /** Image URL for `kind: \"user\"`. */\n  avatar?: string;\n  kind: CommentMentionKind;\n  /** Glyph override for `kind: \"agent\"`. */\n  icon?: string | StaticIconComponent;\n};\n\n/** A resolved mention emitted when a comment referencing a mentionable is posted. */\nexport type CommentMention = {\n  id: string;\n  name: string;\n  kind: CommentMentionKind;\n};\n\n/** A labelled group of reference chips (e.g. linked ids). */\nexport type CommentRefGroup = {\n  label: string;\n  items: string[];\n  /** Render items in a monospace font. */\n  mono?: boolean;\n};\n\n/** One item of a generic checklist; `status` cycles through `checklistStatusCycle`. */\nexport type CommentChecklistItem = {\n  label: string;\n  status: string;\n};\n\nexport type CommentAuthor = {\n  id?: string;\n  name: string;\n  kind?: CommentMentionKind;\n  avatar?: string;\n  /** Glyph override for `kind: \"agent\"` authors. */\n  icon?: string | StaticIconComponent;\n  /** The agent that posted on `name`'s behalf, when another agent wrote the text. */\n  via?: string;\n  /** The session that produced the text, so the run can be inspected later. */\n  sessionId?: string;\n  /** AI response cost in USD for producing the text. */\n  cost?: number;\n};\n\n/**\n * An opaque anchor key locating a comment within a document. Not a JSON path —\n * any stable string a consumer registers via the provider. `null`/absent means\n * document-level.\n */\nexport type CommentAnchor = string;\n\n/** Binary review signal attached to a root comment. */\nexport type CommentRating = \"positive\" | \"negative\";\nexport type CommentReviewDecision =\n  | \"approved\"\n  | \"rejected\"\n  | \"revision_requested\";\n\n/** Anchor key reserved for document-level (un-anchored) comments. */\nexport const DOCUMENT_ANCHOR = \"__document__\";\n\nexport type CommentAgentRunState = \"queued\" | \"sent\" | \"done\" | \"error\";\n\n/**\n * A root handed to an agent session. Hosts may share one session between many\n * roots; the library only carries the record so a host can render it.\n */\nexport type CommentAgentRun = {\n  /** Absent when the hand-off failed before a session existed. */\n  sessionId?: string;\n  /** ISO-8601 time the hand-off was requested. */\n  requestedAt: string;\n  state: CommentAgentRunState;\n  /** Why the hand-off failed; present only when `state` is `error`. */\n  error?: string;\n  /** Host label for where the root went, and how it was delivered, when not the host's default session. */\n  target?: { label: string; channel?: string };\n};\n\n/** A single comment. Replies set `parentId`; roots leave it null. */\nexport type Comment = {\n  id: string;\n  body: string;\n  /** ISO-8601 creation time. */\n  createdAt: string;\n  /** ISO-8601 last-update time. */\n  updatedAt?: string;\n  author: CommentAuthor | null;\n  /** Key into the configured statuses; roots only. */\n  status?: string;\n  /** Parent comment id when this is a reply. */\n  parentId?: string | null;\n  /** Where the comment is anchored; null/absent = document-level. */\n  anchor?: CommentAnchor | null;\n  /** Optional positive/negative review signal; roots only. */\n  rating?: CommentRating;\n  /** Human decision on an opted-in playground review element; roots only. */\n  reviewDecision?: CommentReviewDecision;\n  /** ISO-8601 time when a human closed the resolved comment. */\n  closedAt?: string;\n  /** Human who closed the comment. */\n  closedBy?: CommentAuthor;\n  /** Who holds the thread while it is being worked on; roots only. */\n  assignee?: CommentAuthor;\n  /** ISO-8601 time when `acknowledgedBy` picked the thread up; absent while merely assigned. */\n  acknowledgedAt?: string;\n  /** Who acknowledged the thread. */\n  acknowledgedBy?: CommentAuthor;\n  /** The agent-session hand-off for this thread; roots only. */\n  agentRun?: CommentAgentRun;\n  /** facet.key → selected option value. */\n  facets?: Record<string, string>;\n  refs?: CommentRefGroup[];\n  checklist?: CommentChecklistItem[];\n};\n\n/** Payload for creating a new root comment. */\nexport type CommentCreateInput = {\n  body: string;\n  anchor?: CommentAnchor | null;\n  rating?: CommentRating;\n  reviewDecision?: CommentReviewDecision;\n  facets?: Record<string, string>;\n  mentions?: CommentMention[];\n};\n\nexport type CommentCreateAction = { id: string; label: string };\n\n/** Payload for replying to a comment. */\nexport type CommentReplyInput = {\n  parentId: string;\n  body: string;\n  anchor?: CommentAnchor | null;\n  mentions?: CommentMention[];\n};\n\n/**\n * Controlled callbacks. The components own no data fetching; the consumer\n * performs the mutation and feeds the updated `comments` back in.\n */\nexport type CommentCallbacks = {\n  onCreate?: (\n    input: CommentCreateInput,\n    actionId?: string,\n  ) => void | Promise<void>;\n  onReply?: (input: CommentReplyInput) => void | Promise<void>;\n  onUpdateStatus?: (id: string, status: string) => void | Promise<void>;\n  /** Human-only transition from active or resolved to closed. */\n  onClose?: (id: string) => void | Promise<void>;\n  /** Claim an unassigned active root for the current user or agent. */\n  onAcknowledge?: (id: string) => void | Promise<void>;\n  /** Hand an active root to `assignee`, or return it to unassigned with `null`. */\n  onAssign?: (\n    id: string,\n    assignee: CommentAuthor | null,\n  ) => void | Promise<void>;\n  onUpdateRating?: (id: string, rating: CommentRating) => void | Promise<void>;\n  onDelete?: (id: string) => void | Promise<void>;\n  onChecklistToggle?: (\n    id: string,\n    index: number,\n    next: string,\n  ) => void | Promise<void>;\n  /** Fired when a posted comment references a mentionable. */\n  onMention?: (mention: CommentMention, context: { body: string }) => void;\n};\n\n/** Static configuration shared across the comment components. */\nexport type CommentConfig = {\n  /** Selectable statuses; the first `unresolved` one is the default for new comments. */\n  statuses: CommentStatusConfig[];\n  /** Classification axes (category/severity/etc.). */\n  facets?: CommentFacet[];\n  /** People/agents available for @-mention. */\n  mentionables?: CommentMentionable[];\n  /** People/agents a root can be assigned to; the Assign menu lists exactly these. */\n  assignees?: CommentMentionable[];\n  /** Status values a checklist item cycles through on click. */\n  checklistStatusCycle?: string[];\n};\n\n/** Aggregate metadata for one anchor, derived from the comment list. */\nexport type CommentAnchorMeta = {\n  count: number;\n  authors: string[];\n  latestStatus?: string;\n};\n\n/** Selected filter state for the filter bar / `applyCommentFilters`. */\nexport type CommentFilters = {\n  /** Selected status values; empty = all statuses. */\n  statuses: Set<string>;\n  /** facet.key → selected option values; empty set = all values for that facet. */\n  facets: Record<string, Set<string>>;\n  /** Restrict to an author kind, or \"all\". */\n  authorKind?: CommentMentionKind | \"all\";\n};\n\n/** Optional renderers passed down to a card. */\nexport type CommentRenderOptions = {\n  /** Custom comment-body renderer (e.g. full Markdown). Defaults to CommentMarkdown. */\n  renderBody?: (body: string) => ReactNode;\n};\n\n/** A domain-free default status set: open / in progress / resolved / closed. */\nexport const DEFAULT_COMMENT_STATUSES: CommentStatusConfig[] = [\n  {\n    value: \"open\",\n    label: \"Open\",\n    tone: \"info\",\n    unresolved: true,\n    stage: \"active\",\n  },\n  {\n    value: \"in_progress\",\n    label: \"In progress\",\n    tone: \"warning\",\n    unresolved: true,\n    stage: \"active\",\n  },\n  {\n    value: \"resolved\",\n    label: \"Resolved\",\n    tone: \"success\",\n    stage: \"resolved\",\n  },\n  { value: \"closed\", label: \"Closed\", tone: \"neutral\", stage: \"closed\" },\n];\n\n/** Default checklist status cycle used when a consumer omits one. */\nexport const DEFAULT_CHECKLIST_CYCLE = [\"open\", \"in_progress\", \"done\"];\n"],"mappings":";;AAwHA,IAAa,kBAAkB;;AAkJ/B,IAAa,2BAAkD;CAC7D;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,YAAY;EACZ,OAAO;CACT;CACA;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,YAAY;EACZ,OAAO;CACT;CACA;EACE,OAAO;EACP,OAAO;EACP,MAAM;EACN,OAAO;CACT;CACA;EAAE,OAAO;EAAU,OAAO;EAAU,MAAM;EAAW,OAAO;CAAS;AACvE;;AAGA,IAAa,0BAA0B;CAAC;CAAQ;CAAe;AAAM"}

package/dist/comments/comment-utils.cjs

@@ -196,6 +196,8 @@ function buildThreadListHandlers(comments, config, cb) {
 	const handlers = {};
 	if (cb.onUpdateStatus) handlers.onUpdateStatus = cb.onUpdateStatus;
 	if (cb.onClose) handlers.onClose = cb.onClose;
+	if (cb.onAcknowledge) handlers.onAcknowledge = cb.onAcknowledge;
+	if (cb.onAssign) handlers.onAssign = cb.onAssign;
 	if (cb.onDelete) handlers.onDelete = cb.onDelete;
 	if (cb.onChecklistToggle) {
 		const toggle = cb.onChecklistToggle;

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

@@ -1 +1 @@
-{"version":3,"file":"comment-utils.cjs","names":["DEFAULT_CHECKLIST_CYCLE"],"sources":["../../src/comments/comment-utils.ts"],"sourcesContent":["import type { BadgeTone } from \"../data/Badge\";\nimport {\n  DEFAULT_CHECKLIST_CYCLE,\n  type Comment,\n  type CommentAnchor,\n  type CommentAnchorMeta,\n  type CommentAuthor,\n  type CommentCallbacks,\n  type CommentConfig,\n  type CommentFacet,\n  type CommentFacetOption,\n  type CommentFilters,\n  type CommentMention,\n  type CommentMentionable,\n  type CommentMentionKind,\n  type CommentStatusConfig,\n  type CommentTone,\n  DOCUMENT_ANCHOR,\n} from \"./comment-types\";\n\n/** Human-readable name for an author, falling back to \"Unknown\". */\nexport function authorDisplayName(author: CommentAuthor | null): string {\n  return author?.name?.trim() || \"Unknown\";\n}\n\n/** Maps a CommentTone onto the Badge component's tone vocabulary. */\nexport function toneToBadgeTone(tone: CommentTone | undefined): BadgeTone {\n  switch (tone) {\n    case \"success\":\n      return \"success\";\n    case \"danger\":\n      return \"danger\";\n    case \"warning\":\n      return \"warning\";\n    case \"info\":\n      return \"info\";\n    case \"neutral\":\n    case \"default\":\n    default:\n      return \"neutral\";\n  }\n}\n\n/** Looks up the status config for a stored status value. */\nexport function resolveStatusConfig(\n  config: CommentConfig,\n  value: string | undefined,\n): CommentStatusConfig | undefined {\n  if (value == null) return undefined;\n  return config.statuses.find((s) => s.value === value);\n}\n\n/** Looks up a facet option for a stored facet value. */\nexport function resolveFacetOption(\n  facet: CommentFacet,\n  value: string | undefined,\n): CommentFacetOption | undefined {\n  if (value == null) return undefined;\n  return facet.options.find((o) => o.value === value);\n}\n\n/** The default status value for new comments: first unresolved, else first. */\nexport function defaultStatusValue(config: CommentConfig): string | undefined {\n  const unresolved = config.statuses.find((s) => s.unresolved);\n  return (unresolved ?? config.statuses[0])?.value;\n}\n\n/** Whether a stored status counts as unresolved/open. */\nexport function isUnresolved(\n  config: CommentConfig,\n  status: string | undefined,\n): boolean {\n  return resolveStatusConfig(config, status)?.unresolved ?? false;\n}\n\n/** Returns the root (non-reply) comments in input order. */\nexport function getRoots(comments: Comment[]): Comment[] {\n  return comments.filter((c) => !c.parentId);\n}\n\n/** Indexes replies by their parent id. */\nexport function buildReplyMap(comments: Comment[]): Map<string, Comment[]> {\n  const map = new Map<string, Comment[]>();\n  for (const reply of comments) {\n    if (!reply.parentId) continue;\n    const items = map.get(reply.parentId) ?? [];\n    items.push(reply);\n    map.set(reply.parentId, items);\n  }\n  return map;\n}\n\n/**\n * Comments forming the threads rooted at `anchor`: matching roots plus their\n * descendants. Replies carry no anchor of their own — they belong to a thread,\n * not to a location — so selecting by anchor equality alone would drop them.\n */\nexport function selectAnchorThreads(\n  comments: Comment[],\n  anchor: CommentAnchor,\n): Comment[] {\n  const roots = comments.filter(\n    (c) => !c.parentId && (c.anchor ?? DOCUMENT_ANCHOR) === anchor,\n  );\n  const ids = new Set(roots.map((c) => String(c.id)));\n  const descendants: Comment[] = [];\n  // Fixed point, so a reply to a reply is kept when replies are not flattened.\n  for (let grew = true; grew; ) {\n    grew = false;\n    for (const c of comments) {\n      if (!c.parentId || ids.has(String(c.id))) continue;\n      if (!ids.has(String(c.parentId))) continue;\n      ids.add(String(c.id));\n      descendants.push(c);\n      grew = true;\n    }\n  }\n  return [...roots, ...descendants];\n}\n\n/**\n * Threads whose root is not yet resolved. A root carrying no status has not\n * been acted on, so it counts as unresolved; replies follow their root.\n */\nexport function selectUnresolvedThreads(\n  comments: Comment[],\n  config: CommentConfig,\n): Comment[] {\n  const keep = new Set(\n    getRoots(comments)\n      .filter(\n        (root) => root.status == null || isUnresolved(config, root.status),\n      )\n      .map((root) => String(root.id)),\n  );\n  return comments.filter((c) => keep.has(String(c.parentId ?? c.id)));\n}\n\n/** Stable reply ordering: by creation time, then id. */\nexport function sortReplies(replies: Comment[]): Comment[] {\n  return [...replies].sort((a, b) => {\n    if (a.createdAt !== b.createdAt)\n      return a.createdAt.localeCompare(b.createdAt);\n    return String(a.id).localeCompare(String(b.id));\n  });\n}\n\n/** Groups root comments by the value of a facet key (missing → \"\"). */\nexport function groupByFacet(\n  comments: Comment[],\n  facetKey: string,\n): Map<string, Comment[]> {\n  const map = new Map<string, Comment[]>();\n  for (const root of getRoots(comments)) {\n    const key = root.facets?.[facetKey] ?? \"\";\n    const items = map.get(key) ?? [];\n    items.push(root);\n    map.set(key, items);\n  }\n  return map;\n}\n\n/** Per-anchor comment counts derived from the list (document-level → DOCUMENT_ANCHOR). */\nexport function deriveAnchorCounts(\n  comments: Comment[],\n): Record<CommentAnchor, number> {\n  const counts: Record<CommentAnchor, number> = {};\n  for (const c of comments) {\n    const key = c.anchor ?? DOCUMENT_ANCHOR;\n    counts[key] = (counts[key] ?? 0) + 1;\n  }\n  return counts;\n}\n\n/** Per-anchor aggregate metadata (count, distinct authors, latest status). */\nexport function deriveAnchorMeta(\n  comments: Comment[],\n): Record<CommentAnchor, CommentAnchorMeta> {\n  const grouped: Record<CommentAnchor, Comment[]> = {};\n  for (const c of comments) {\n    const key = c.anchor ?? DOCUMENT_ANCHOR;\n    (grouped[key] ??= []).push(c);\n  }\n  const meta: Record<CommentAnchor, CommentAnchorMeta> = {};\n  for (const [anchor, items] of Object.entries(grouped)) {\n    const authors = [\n      ...new Set(\n        items.map((c) => c.author?.name).filter((n): n is string => !!n),\n      ),\n    ];\n    const latest = items.reduce((a, b) =>\n      (a.updatedAt ?? a.createdAt) > (b.updatedAt ?? b.createdAt) ? a : b,\n    );\n    meta[anchor] = {\n      count: items.length,\n      authors,\n      ...(latest.status != null ? { latestStatus: latest.status } : {}),\n    };\n  }\n  return meta;\n}\n\n/** Sums counts for an anchor and its descendants under a separator-delimited prefix. */\nexport function commentCountForPrefix(\n  counts: Record<string, number>,\n  prefix: string,\n  separator = \".\",\n): number {\n  let total = 0;\n  for (const [key, count] of Object.entries(counts)) {\n    if (key === prefix || key.startsWith(prefix + separator)) total += count;\n  }\n  return total;\n}\n\n/** Advances a checklist status to the next in the cycle (wrapping). */\nexport function nextChecklistStatus(\n  current: string,\n  cycle = DEFAULT_CHECKLIST_CYCLE,\n): string {\n  const idx = cycle.indexOf(current);\n  if (idx === -1) return cycle[0] ?? current;\n  return cycle[(idx + 1) % cycle.length] ?? current;\n}\n\n/** Strips inline markdown punctuation and truncates to a plain preview. */\nexport function truncatePlain(body: string, max = 80): string {\n  const plain = body.replace(/[#*_`~>[\\]()!]/g, \"\").trim();\n  return plain.length > max ? `${plain.slice(0, max)}…` : plain;\n}\n\nfunction authorKindOf(comment: Comment): CommentMentionKind {\n  return comment.author?.kind ?? \"user\";\n}\n\n/**\n * Filters a comment list by status / facets / author kind while keeping threads\n * intact: a reply survives iff its root survives. An empty status set or empty\n * per-facet set means \"no constraint\" for that axis.\n */\nexport function applyCommentFilters(\n  comments: Comment[],\n  filters: CommentFilters,\n  config: CommentConfig,\n): Comment[] {\n  const facetKeys = (config.facets ?? []).map((f) => f.key);\n  const passingRootIds = new Set<string>();\n\n  for (const root of getRoots(comments)) {\n    if (\n      filters.statuses.size > 0 &&\n      (root.status == null || !filters.statuses.has(root.status))\n    ) {\n      continue;\n    }\n    if (\n      filters.authorKind &&\n      filters.authorKind !== \"all\" &&\n      authorKindOf(root) !== filters.authorKind\n    ) {\n      continue;\n    }\n    const facetsPass = facetKeys.every((key) => {\n      const selected = filters.facets[key];\n      if (!selected || selected.size === 0) return true;\n      const value = root.facets?.[key];\n      return value != null && selected.has(value);\n    });\n    if (!facetsPass) continue;\n    passingRootIds.add(root.id);\n  }\n\n  return comments.filter((c) =>\n    c.parentId ? passingRootIds.has(c.parentId) : passingRootIds.has(c.id),\n  );\n}\n\n/** True when any filter axis constrains the result. */\nexport function hasActiveFilters(filters: CommentFilters): boolean {\n  if (filters.statuses.size > 0) return true;\n  if (filters.authorKind && filters.authorKind !== \"all\") return true;\n  return Object.values(filters.facets).some((set) => set.size > 0);\n}\n\n/** An empty filter state. */\nexport function emptyCommentFilters(): CommentFilters {\n  return { statuses: new Set(), facets: {}, authorKind: \"all\" };\n}\n\n/** Finds mentionables whose `@name` token appears in a body (case-insensitive). */\nexport function matchMentionsInBody(\n  body: string,\n  mentionables: CommentMentionable[],\n): CommentMention[] {\n  const lower = body.toLowerCase();\n  return mentionables\n    .filter((m) => lower.includes(`@${m.name.toLowerCase()}`))\n    .map((m) => ({ id: m.id, name: m.name, kind: m.kind }));\n}\n\n/** Per-id handlers consumed by CommentThreadList. */\nexport type ThreadListHandlers = {\n  onUpdateStatus?: (id: string, status: string) => void | Promise<void>;\n  onClose?: (id: string) => void | Promise<void>;\n  onChecklistToggle?: (id: string, index: number) => void;\n  onDelete?: (id: string) => void;\n  onReply?: (parent: Comment, body: string) => void | Promise<void>;\n};\n\n/**\n * Adapts high-level {@link CommentCallbacks} into the id-keyed handlers a\n * {@link CommentThreadList} consumes: resolves the next checklist status from the\n * cycle and extracts mentions from a reply body. Shared by `CommentThread` and\n * `CommentSidePanel` so the adaptation lives in one place.\n */\nexport function buildThreadListHandlers(\n  comments: Comment[],\n  config: CommentConfig,\n  cb: CommentCallbacks,\n): ThreadListHandlers {\n  const handlers: ThreadListHandlers = {};\n  if (cb.onUpdateStatus) handlers.onUpdateStatus = cb.onUpdateStatus;\n  if (cb.onClose) handlers.onClose = cb.onClose;\n  if (cb.onDelete) handlers.onDelete = cb.onDelete;\n  if (cb.onChecklistToggle) {\n    const toggle = cb.onChecklistToggle;\n    handlers.onChecklistToggle = (id, index) => {\n      const item = comments.find((c) => c.id === id)?.checklist?.[index];\n      if (!item) return;\n      void toggle(\n        id,\n        index,\n        nextChecklistStatus(item.status, config.checklistStatusCycle),\n      );\n    };\n  }\n  if (cb.onReply) {\n    const reply = cb.onReply;\n    const onMention = cb.onMention;\n    handlers.onReply = async (parent, body) => {\n      const mentions = matchMentionsInBody(body, config.mentionables ?? []);\n      await reply({\n        parentId: parent.id,\n        body,\n        anchor: parent.anchor ?? null,\n        ...(mentions.length > 0 ? { mentions } : {}),\n      });\n      for (const mention of mentions) onMention?.(mention, { body });\n    };\n  }\n  return handlers;\n}\n"],"mappings":"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"}
+{"version":3,"file":"comment-utils.cjs","names":["DEFAULT_CHECKLIST_CYCLE"],"sources":["../../src/comments/comment-utils.ts"],"sourcesContent":["import type { BadgeTone } from \"../data/Badge\";\nimport {\n  DEFAULT_CHECKLIST_CYCLE,\n  type Comment,\n  type CommentAnchor,\n  type CommentAnchorMeta,\n  type CommentAuthor,\n  type CommentCallbacks,\n  type CommentConfig,\n  type CommentFacet,\n  type CommentFacetOption,\n  type CommentFilters,\n  type CommentMention,\n  type CommentMentionable,\n  type CommentMentionKind,\n  type CommentStatusConfig,\n  type CommentTone,\n  DOCUMENT_ANCHOR,\n} from \"./comment-types\";\n\n/** Human-readable name for an author, falling back to \"Unknown\". */\nexport function authorDisplayName(author: CommentAuthor | null): string {\n  return author?.name?.trim() || \"Unknown\";\n}\n\n/** Maps a CommentTone onto the Badge component's tone vocabulary. */\nexport function toneToBadgeTone(tone: CommentTone | undefined): BadgeTone {\n  switch (tone) {\n    case \"success\":\n      return \"success\";\n    case \"danger\":\n      return \"danger\";\n    case \"warning\":\n      return \"warning\";\n    case \"info\":\n      return \"info\";\n    case \"neutral\":\n    case \"default\":\n    default:\n      return \"neutral\";\n  }\n}\n\n/** Looks up the status config for a stored status value. */\nexport function resolveStatusConfig(\n  config: CommentConfig,\n  value: string | undefined,\n): CommentStatusConfig | undefined {\n  if (value == null) return undefined;\n  return config.statuses.find((s) => s.value === value);\n}\n\n/** Looks up a facet option for a stored facet value. */\nexport function resolveFacetOption(\n  facet: CommentFacet,\n  value: string | undefined,\n): CommentFacetOption | undefined {\n  if (value == null) return undefined;\n  return facet.options.find((o) => o.value === value);\n}\n\n/** The default status value for new comments: first unresolved, else first. */\nexport function defaultStatusValue(config: CommentConfig): string | undefined {\n  const unresolved = config.statuses.find((s) => s.unresolved);\n  return (unresolved ?? config.statuses[0])?.value;\n}\n\n/** Whether a stored status counts as unresolved/open. */\nexport function isUnresolved(\n  config: CommentConfig,\n  status: string | undefined,\n): boolean {\n  return resolveStatusConfig(config, status)?.unresolved ?? false;\n}\n\n/** Returns the root (non-reply) comments in input order. */\nexport function getRoots(comments: Comment[]): Comment[] {\n  return comments.filter((c) => !c.parentId);\n}\n\n/** Indexes replies by their parent id. */\nexport function buildReplyMap(comments: Comment[]): Map<string, Comment[]> {\n  const map = new Map<string, Comment[]>();\n  for (const reply of comments) {\n    if (!reply.parentId) continue;\n    const items = map.get(reply.parentId) ?? [];\n    items.push(reply);\n    map.set(reply.parentId, items);\n  }\n  return map;\n}\n\n/**\n * Comments forming the threads rooted at `anchor`: matching roots plus their\n * descendants. Replies carry no anchor of their own — they belong to a thread,\n * not to a location — so selecting by anchor equality alone would drop them.\n */\nexport function selectAnchorThreads(\n  comments: Comment[],\n  anchor: CommentAnchor,\n): Comment[] {\n  const roots = comments.filter(\n    (c) => !c.parentId && (c.anchor ?? DOCUMENT_ANCHOR) === anchor,\n  );\n  const ids = new Set(roots.map((c) => String(c.id)));\n  const descendants: Comment[] = [];\n  // Fixed point, so a reply to a reply is kept when replies are not flattened.\n  for (let grew = true; grew; ) {\n    grew = false;\n    for (const c of comments) {\n      if (!c.parentId || ids.has(String(c.id))) continue;\n      if (!ids.has(String(c.parentId))) continue;\n      ids.add(String(c.id));\n      descendants.push(c);\n      grew = true;\n    }\n  }\n  return [...roots, ...descendants];\n}\n\n/**\n * Threads whose root is not yet resolved. A root carrying no status has not\n * been acted on, so it counts as unresolved; replies follow their root.\n */\nexport function selectUnresolvedThreads(\n  comments: Comment[],\n  config: CommentConfig,\n): Comment[] {\n  const keep = new Set(\n    getRoots(comments)\n      .filter(\n        (root) => root.status == null || isUnresolved(config, root.status),\n      )\n      .map((root) => String(root.id)),\n  );\n  return comments.filter((c) => keep.has(String(c.parentId ?? c.id)));\n}\n\n/** Stable reply ordering: by creation time, then id. */\nexport function sortReplies(replies: Comment[]): Comment[] {\n  return [...replies].sort((a, b) => {\n    if (a.createdAt !== b.createdAt)\n      return a.createdAt.localeCompare(b.createdAt);\n    return String(a.id).localeCompare(String(b.id));\n  });\n}\n\n/** Groups root comments by the value of a facet key (missing → \"\"). */\nexport function groupByFacet(\n  comments: Comment[],\n  facetKey: string,\n): Map<string, Comment[]> {\n  const map = new Map<string, Comment[]>();\n  for (const root of getRoots(comments)) {\n    const key = root.facets?.[facetKey] ?? \"\";\n    const items = map.get(key) ?? [];\n    items.push(root);\n    map.set(key, items);\n  }\n  return map;\n}\n\n/** Per-anchor comment counts derived from the list (document-level → DOCUMENT_ANCHOR). */\nexport function deriveAnchorCounts(\n  comments: Comment[],\n): Record<CommentAnchor, number> {\n  const counts: Record<CommentAnchor, number> = {};\n  for (const c of comments) {\n    const key = c.anchor ?? DOCUMENT_ANCHOR;\n    counts[key] = (counts[key] ?? 0) + 1;\n  }\n  return counts;\n}\n\n/** Per-anchor aggregate metadata (count, distinct authors, latest status). */\nexport function deriveAnchorMeta(\n  comments: Comment[],\n): Record<CommentAnchor, CommentAnchorMeta> {\n  const grouped: Record<CommentAnchor, Comment[]> = {};\n  for (const c of comments) {\n    const key = c.anchor ?? DOCUMENT_ANCHOR;\n    (grouped[key] ??= []).push(c);\n  }\n  const meta: Record<CommentAnchor, CommentAnchorMeta> = {};\n  for (const [anchor, items] of Object.entries(grouped)) {\n    const authors = [\n      ...new Set(\n        items.map((c) => c.author?.name).filter((n): n is string => !!n),\n      ),\n    ];\n    const latest = items.reduce((a, b) =>\n      (a.updatedAt ?? a.createdAt) > (b.updatedAt ?? b.createdAt) ? a : b,\n    );\n    meta[anchor] = {\n      count: items.length,\n      authors,\n      ...(latest.status != null ? { latestStatus: latest.status } : {}),\n    };\n  }\n  return meta;\n}\n\n/** Sums counts for an anchor and its descendants under a separator-delimited prefix. */\nexport function commentCountForPrefix(\n  counts: Record<string, number>,\n  prefix: string,\n  separator = \".\",\n): number {\n  let total = 0;\n  for (const [key, count] of Object.entries(counts)) {\n    if (key === prefix || key.startsWith(prefix + separator)) total += count;\n  }\n  return total;\n}\n\n/** Advances a checklist status to the next in the cycle (wrapping). */\nexport function nextChecklistStatus(\n  current: string,\n  cycle = DEFAULT_CHECKLIST_CYCLE,\n): string {\n  const idx = cycle.indexOf(current);\n  if (idx === -1) return cycle[0] ?? current;\n  return cycle[(idx + 1) % cycle.length] ?? current;\n}\n\n/** Strips inline markdown punctuation and truncates to a plain preview. */\nexport function truncatePlain(body: string, max = 80): string {\n  const plain = body.replace(/[#*_`~>[\\]()!]/g, \"\").trim();\n  return plain.length > max ? `${plain.slice(0, max)}…` : plain;\n}\n\nfunction authorKindOf(comment: Comment): CommentMentionKind {\n  return comment.author?.kind ?? \"user\";\n}\n\n/**\n * Filters a comment list by status / facets / author kind while keeping threads\n * intact: a reply survives iff its root survives. An empty status set or empty\n * per-facet set means \"no constraint\" for that axis.\n */\nexport function applyCommentFilters(\n  comments: Comment[],\n  filters: CommentFilters,\n  config: CommentConfig,\n): Comment[] {\n  const facetKeys = (config.facets ?? []).map((f) => f.key);\n  const passingRootIds = new Set<string>();\n\n  for (const root of getRoots(comments)) {\n    if (\n      filters.statuses.size > 0 &&\n      (root.status == null || !filters.statuses.has(root.status))\n    ) {\n      continue;\n    }\n    if (\n      filters.authorKind &&\n      filters.authorKind !== \"all\" &&\n      authorKindOf(root) !== filters.authorKind\n    ) {\n      continue;\n    }\n    const facetsPass = facetKeys.every((key) => {\n      const selected = filters.facets[key];\n      if (!selected || selected.size === 0) return true;\n      const value = root.facets?.[key];\n      return value != null && selected.has(value);\n    });\n    if (!facetsPass) continue;\n    passingRootIds.add(root.id);\n  }\n\n  return comments.filter((c) =>\n    c.parentId ? passingRootIds.has(c.parentId) : passingRootIds.has(c.id),\n  );\n}\n\n/** True when any filter axis constrains the result. */\nexport function hasActiveFilters(filters: CommentFilters): boolean {\n  if (filters.statuses.size > 0) return true;\n  if (filters.authorKind && filters.authorKind !== \"all\") return true;\n  return Object.values(filters.facets).some((set) => set.size > 0);\n}\n\n/** An empty filter state. */\nexport function emptyCommentFilters(): CommentFilters {\n  return { statuses: new Set(), facets: {}, authorKind: \"all\" };\n}\n\n/** Finds mentionables whose `@name` token appears in a body (case-insensitive). */\nexport function matchMentionsInBody(\n  body: string,\n  mentionables: CommentMentionable[],\n): CommentMention[] {\n  const lower = body.toLowerCase();\n  return mentionables\n    .filter((m) => lower.includes(`@${m.name.toLowerCase()}`))\n    .map((m) => ({ id: m.id, name: m.name, kind: m.kind }));\n}\n\n/** Per-id handlers consumed by CommentThreadList. */\nexport type ThreadListHandlers = {\n  onUpdateStatus?: (id: string, status: string) => void | Promise<void>;\n  onClose?: (id: string) => void | Promise<void>;\n  onAcknowledge?: (id: string) => void | Promise<void>;\n  onAssign?: (\n    id: string,\n    assignee: CommentAuthor | null,\n  ) => void | Promise<void>;\n  onChecklistToggle?: (id: string, index: number) => void;\n  onDelete?: (id: string) => void;\n  onReply?: (parent: Comment, body: string) => void | Promise<void>;\n};\n\n/**\n * Adapts high-level {@link CommentCallbacks} into the id-keyed handlers a\n * {@link CommentThreadList} consumes: resolves the next checklist status from the\n * cycle and extracts mentions from a reply body. Shared by `CommentThread` and\n * `CommentSidePanel` so the adaptation lives in one place.\n */\nexport function buildThreadListHandlers(\n  comments: Comment[],\n  config: CommentConfig,\n  cb: CommentCallbacks,\n): ThreadListHandlers {\n  const handlers: ThreadListHandlers = {};\n  if (cb.onUpdateStatus) handlers.onUpdateStatus = cb.onUpdateStatus;\n  if (cb.onClose) handlers.onClose = cb.onClose;\n  if (cb.onAcknowledge) handlers.onAcknowledge = cb.onAcknowledge;\n  if (cb.onAssign) handlers.onAssign = cb.onAssign;\n  if (cb.onDelete) handlers.onDelete = cb.onDelete;\n  if (cb.onChecklistToggle) {\n    const toggle = cb.onChecklistToggle;\n    handlers.onChecklistToggle = (id, index) => {\n      const item = comments.find((c) => c.id === id)?.checklist?.[index];\n      if (!item) return;\n      void toggle(\n        id,\n        index,\n        nextChecklistStatus(item.status, config.checklistStatusCycle),\n      );\n    };\n  }\n  if (cb.onReply) {\n    const reply = cb.onReply;\n    const onMention = cb.onMention;\n    handlers.onReply = async (parent, body) => {\n      const mentions = matchMentionsInBody(body, config.mentionables ?? []);\n      await reply({\n        parentId: parent.id,\n        body,\n        anchor: parent.anchor ?? null,\n        ...(mentions.length > 0 ? { mentions } : {}),\n      });\n      for (const mention of mentions) onMention?.(mention, { body });\n    };\n  }\n  return handlers;\n}\n"],"mappings":"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"}

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

@@ -57,6 +57,8 @@ export declare function matchMentionsInBody(body: string, mentionables: CommentM
 export type ThreadListHandlers = {
     onUpdateStatus?: (id: string, status: string) => void | Promise<void>;
     onClose?: (id: string) => void | Promise<void>;
+    onAcknowledge?: (id: string) => void | Promise<void>;
+    onAssign?: (id: string, assignee: CommentAuthor | null) => void | Promise<void>;
     onChecklistToggle?: (id: string, index: number) => void;
     onDelete?: (id: string) => void;
     onReply?: (parent: Comment, body: string) => void | Promise<void>;