@flanksource/clicky-ui 0.3.9 → 0.3.11

package/dist/comments/CommentThreadList.js.map

@@ -1 +1 @@
-{"version":3,"file":"CommentThreadList.js","sources":["../../src/comments/CommentThreadList.tsx"],"sourcesContent":["import { useState, type HTMLAttributes, type ReactNode } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { Button } from \"../components/button\";\nimport { CommentCard } from \"./CommentCard\";\nimport { buildReplyMap, getRoots, sortReplies } from \"./comment-utils\";\nimport type { Comment, CommentConfig } from \"./comment-types\";\n\nexport type CommentThreadListProps = {\n  comments: Comment[];\n  config: CommentConfig;\n  compact?: boolean;\n  /** Extra content rendered above each root card (e.g. an anchor label). */\n  renderRootMeta?: (comment: Comment) => ReactNode;\n  /** Props merged onto each thread wrapper (e.g. for scroll anchoring). */\n  getThreadProps?: (comment: Comment) => HTMLAttributes<HTMLDivElement>;\n  /** Custom body renderer forwarded to each card. */\n  renderBody?: (body: string) => ReactNode;\n  onUpdateStatus?: (id: string, status: string) => void;\n  onChecklistToggle?: (id: string, index: number) => void;\n  onDelete?: (id: string) => void;\n  /** Submit a reply to `parent`. Presence enables the inline reply affordance. */\n  onReply?: (parent: Comment, body: string) => void | Promise<void>;\n};\n\nfunction ReplyInput({\n  onSubmit,\n  onCancel,\n}: {\n  onSubmit: (body: string) => void | Promise<void>;\n  onCancel: () => void;\n}) {\n  const [body, setBody] = useState(\"\");\n  async function send() {\n    if (!body.trim()) return;\n    await onSubmit(body.trim());\n    setBody(\"\");\n  }\n  return (\n    <div className=\"ml-6 flex gap-1.5 py-1\">\n      <input\n        autoFocus\n        value={body}\n        onChange={(e) => setBody(e.target.value)}\n        onKeyDown={(e) => {\n          if (e.key === \"Enter\") {\n            e.preventDefault();\n            void send();\n          }\n          if (e.key === \"Escape\") onCancel();\n        }}\n        placeholder=\"Write a reply…\"\n        data-testid=\"comment-reply-input\"\n        className=\"h-7 flex-1 rounded-md border border-border bg-background px-2 py-1 text-xs outline-none focus:border-primary/40\"\n      />\n      <Button\n        size=\"sm\"\n        className=\"h-7 text-xs\"\n        disabled={!body.trim()}\n        onClick={() => void send()}\n      >\n        Send\n      </Button>\n    </div>\n  );\n}\n\n/**\n * Renders a list of threaded comments: each root with its sorted replies and an\n * optional inline reply box. Fully controlled — mutations route through the\n * id-keyed callbacks.\n */\nexport function CommentThreadList({\n  comments,\n  config,\n  compact = false,\n  renderRootMeta,\n  getThreadProps,\n  renderBody,\n  onUpdateStatus,\n  onChecklistToggle,\n  onDelete,\n  onReply,\n}: CommentThreadListProps) {\n  const [replyingTo, setReplyingTo] = useState<string | null>(null);\n  const roots = getRoots(comments);\n  const replyMap = buildReplyMap(comments);\n\n  if (roots.length === 0) return null;\n\n  function cardHandlers(id: string) {\n    return {\n      ...(onUpdateStatus\n        ? { onUpdateStatus: (status: string) => onUpdateStatus(id, status) }\n        : {}),\n      ...(onChecklistToggle\n        ? { onChecklistToggle: (index: number) => onChecklistToggle(id, index) }\n        : {}),\n      ...(onDelete ? { onDelete: () => onDelete(id) } : {}),\n    };\n  }\n\n  return (\n    <div className=\"space-y-2\">\n      {roots.map((root) => {\n        const replies = sortReplies(replyMap.get(root.id) ?? []);\n        const threadProps = getThreadProps?.(root) ?? {};\n        return (\n          <div\n            key={root.id}\n            data-testid=\"comment-thread-block\"\n            data-comment-id={root.id}\n            {...threadProps}\n            className={cn(\"space-y-1.5 p-1\", threadProps.className)}\n          >\n            {renderRootMeta ? (\n              <div className=\"px-1\">{renderRootMeta(root)}</div>\n            ) : null}\n            <CommentCard\n              comment={root}\n              config={config}\n              compact={compact}\n              {...(renderBody ? { renderBody } : {})}\n              {...cardHandlers(root.id)}\n              {...(onReply ? { onReply: () => setReplyingTo(root.id) } : {})}\n            />\n            {replies.length > 0 && (\n              <div className=\"space-y-1.5\">\n                {replies.map((reply) => (\n                  <CommentCard\n                    key={reply.id}\n                    comment={reply}\n                    config={config}\n                    compact={compact}\n                    {...(renderBody ? { renderBody } : {})}\n                    {...cardHandlers(reply.id)}\n                  />\n                ))}\n              </div>\n            )}\n            {onReply && replyingTo === root.id && (\n              <ReplyInput\n                onCancel={() => setReplyingTo(null)}\n                onSubmit={async (body) => {\n                  await onReply(root, body);\n                  setReplyingTo(null);\n                }}\n              />\n            )}\n          </div>\n        );\n      })}\n    </div>\n  );\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"CommentThreadList.js","sources":["../../src/comments/CommentThreadList.tsx"],"sourcesContent":["import { useRef, useState, type HTMLAttributes, type ReactNode } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { Button } from \"../components/button\";\nimport { CommentCard } from \"./CommentCard\";\nimport { buildReplyMap, getRoots, sortReplies } from \"./comment-utils\";\nimport type { Comment, CommentConfig } from \"./comment-types\";\n\nexport type CommentThreadListProps = {\n  comments: Comment[];\n  config: CommentConfig;\n  compact?: boolean;\n  /** Expand root comments immediately, exposing actions such as Reply. */\n  defaultExpandedRoots?: boolean;\n  /** Extra content rendered above each root card (e.g. an anchor label). */\n  renderRootMeta?: (comment: Comment) => ReactNode;\n  /** Props merged onto each thread wrapper (e.g. for scroll anchoring). */\n  getThreadProps?: (comment: Comment) => HTMLAttributes<HTMLDivElement>;\n  /** Custom body renderer forwarded to each card. */\n  renderBody?: (body: string) => ReactNode;\n  onUpdateStatus?: (id: string, status: string) => void;\n  onChecklistToggle?: (id: string, index: number) => void;\n  onDelete?: (id: string) => void;\n  /** Submit a reply to `parent`. Presence enables the inline reply affordance. */\n  onReply?: (parent: Comment, body: string) => void | Promise<void>;\n};\n\nfunction ReplyInput({\n  onSubmit,\n  onCancel,\n}: {\n  onSubmit: (body: string) => void | Promise<void>;\n  onCancel: () => void;\n}) {\n  const [body, setBody] = useState(\"\");\n  const [submitting, setSubmitting] = useState(false);\n  const submittingRef = useRef(false);\n  async function send() {\n    if (!body.trim() || submittingRef.current) return;\n    submittingRef.current = true;\n    setSubmitting(true);\n    try {\n      await onSubmit(body.trim());\n      setBody(\"\");\n    } finally {\n      submittingRef.current = false;\n      setSubmitting(false);\n    }\n  }\n  return (\n    <div className=\"ml-6 flex gap-1.5 py-1\" aria-busy={submitting}>\n      <input\n        autoFocus\n        value={body}\n        disabled={submitting}\n        onChange={(e) => setBody(e.target.value)}\n        onKeyDown={(e) => {\n          if (e.key === \"Enter\") {\n            e.preventDefault();\n            void send();\n          }\n          if (e.key === \"Escape\") onCancel();\n        }}\n        placeholder=\"Write a reply…\"\n        data-testid=\"comment-reply-input\"\n        className=\"h-7 flex-1 rounded-md border border-border bg-background px-2 py-1 text-xs outline-none focus:border-primary/40\"\n      />\n      <Button\n        size=\"sm\"\n        className=\"h-7 text-xs\"\n        disabled={submitting || !body.trim()}\n        onClick={() => void send()}\n      >\n        Send\n      </Button>\n    </div>\n  );\n}\n\n/**\n * Renders a list of threaded comments: each root with its sorted replies and an\n * optional inline reply box. Fully controlled — mutations route through the\n * id-keyed callbacks.\n */\nexport function CommentThreadList({\n  comments,\n  config,\n  compact = false,\n  defaultExpandedRoots = false,\n  renderRootMeta,\n  getThreadProps,\n  renderBody,\n  onUpdateStatus,\n  onChecklistToggle,\n  onDelete,\n  onReply,\n}: CommentThreadListProps) {\n  const [replyingTo, setReplyingTo] = useState<string | null>(null);\n  const roots = getRoots(comments);\n  const replyMap = buildReplyMap(comments);\n\n  if (roots.length === 0) return null;\n\n  function cardHandlers(id: string) {\n    return {\n      ...(onUpdateStatus\n        ? { onUpdateStatus: (status: string) => onUpdateStatus(id, status) }\n        : {}),\n      ...(onChecklistToggle\n        ? { onChecklistToggle: (index: number) => onChecklistToggle(id, index) }\n        : {}),\n      ...(onDelete ? { onDelete: () => onDelete(id) } : {}),\n    };\n  }\n\n  return (\n    <div className=\"space-y-2\">\n      {roots.map((root) => {\n        const replies = sortReplies(replyMap.get(root.id) ?? []);\n        const threadProps = getThreadProps?.(root) ?? {};\n        return (\n          <div\n            key={root.id}\n            data-testid=\"comment-thread-block\"\n            data-comment-id={root.id}\n            {...threadProps}\n            className={cn(\"space-y-1.5 p-1\", threadProps.className)}\n          >\n            {renderRootMeta ? (\n              <div className=\"px-1\">{renderRootMeta(root)}</div>\n            ) : null}\n            <CommentCard\n              comment={root}\n              config={config}\n              compact={compact}\n              defaultExpanded={defaultExpandedRoots}\n              {...(renderBody ? { renderBody } : {})}\n              {...cardHandlers(root.id)}\n              {...(onReply ? { onReply: () => setReplyingTo(root.id) } : {})}\n            />\n            {replies.length > 0 && (\n              <div className=\"space-y-1.5\">\n                {replies.map((reply) => (\n                  <CommentCard\n                    key={reply.id}\n                    comment={reply}\n                    config={config}\n                    compact={compact}\n                    {...(renderBody ? { renderBody } : {})}\n                    {...cardHandlers(reply.id)}\n                  />\n                ))}\n              </div>\n            )}\n            {onReply && replyingTo === root.id && (\n              <ReplyInput\n                onCancel={() => setReplyingTo(null)}\n                onSubmit={async (body) => {\n                  await onReply(root, body);\n                  setReplyingTo(null);\n                }}\n              />\n            )}\n          </div>\n        );\n      })}\n    </div>\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/comments/comment-context.cjs

@@ -3,6 +3,88 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const react = require("react");
 const commentTypes = require("./comment-types.cjs");
 const CommentContext = react.createContext(null);
+const EMPTY_ANCHOR_STATE = Object.freeze({
+  meta: void 0,
+  active: false,
+  highlighted: false
+});
+function sameMeta(first, second) {
+  if (first === second) return true;
+  if (!first || !second) return false;
+  return first.count === second.count && first.latestStatus === second.latestStatus && first.authors.length === second.authors.length && first.authors.every((author, index) => author === second.authors[index]);
+}
+function sameAnchorState(first, second) {
+  return sameMeta(first.meta, second.meta) && first.active === second.active && first.highlighted === second.highlighted;
+}
+function createCommentAnchorStore() {
+  let meta = {};
+  let mode = "closed";
+  let focused = null;
+  let highlighted = null;
+  const snapshots = /* @__PURE__ */ new Map();
+  const listeners = /* @__PURE__ */ new Map();
+  function nextSnapshot(anchor) {
+    return {
+      meta: meta[anchor],
+      active: mode === "focused" && focused === anchor,
+      highlighted: highlighted === anchor || mode === "focused" && focused === anchor
+    };
+  }
+  return {
+    update(nextMeta, nextMode, nextFocused, nextHighlighted) {
+      meta = nextMeta;
+      mode = nextMode;
+      focused = nextFocused;
+      highlighted = nextHighlighted;
+      for (const [anchor, anchorListeners] of listeners) {
+        const current = snapshots.get(anchor) ?? EMPTY_ANCHOR_STATE;
+        const next = nextSnapshot(anchor);
+        if (sameAnchorState(current, next)) continue;
+        snapshots.set(anchor, next);
+        for (const listener of anchorListeners) listener();
+      }
+    },
+    getSnapshot(anchor) {
+      const current = snapshots.get(anchor) ?? EMPTY_ANCHOR_STATE;
+      const next = nextSnapshot(anchor);
+      if (sameAnchorState(current, next)) return current;
+      snapshots.set(anchor, next);
+      return next;
+    },
+    subscribe(anchor, listener) {
+      const anchorListeners = listeners.get(anchor) ?? /* @__PURE__ */ new Set();
+      anchorListeners.add(listener);
+      listeners.set(anchor, anchorListeners);
+      return () => {
+        anchorListeners.delete(listener);
+        if (anchorListeners.size === 0) listeners.delete(anchor);
+      };
+    }
+  };
+}
+const CommentAnchorStoreContext = react.createContext(null);
+const CommentAnchorActionsContext = react.createContext(null);
+function useCommentAnchorOptional(anchor) {
+  const contextStore = react.useContext(CommentAnchorStoreContext);
+  const store = contextStore ?? EMPTY_ANCHOR_STORE;
+  const subscribe = react.useCallback(
+    (listener) => anchor ? store.subscribe(anchor, listener) : () => void 0,
+    [anchor, store]
+  );
+  const getSnapshot = react.useCallback(
+    () => anchor ? store.getSnapshot(anchor) : EMPTY_ANCHOR_STATE,
+    [anchor, store]
+  );
+  const snapshot = react.useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+  return contextStore && anchor ? snapshot : null;
+}
+const EMPTY_ANCHOR_STORE = createCommentAnchorStore();
+function useCommentAnchorActionsOptional() {
+  return react.useContext(CommentAnchorActionsContext);
+}
+function strictAnchorResolver(anchor, registered) {
+  return registered.includes(anchor) ? anchor : null;
+}
 function exactAnchorResolver(anchor, registered) {
   if (registered.includes(anchor)) return anchor;
   if (registered.includes(commentTypes.DOCUMENT_ANCHOR)) return commentTypes.DOCUMENT_ANCHOR;
@@ -25,9 +107,15 @@ function useCommentContext() {
 function useCommentContextOptional() {
   return react.useContext(CommentContext);
 }
+exports.CommentAnchorActionsContext = CommentAnchorActionsContext;
+exports.CommentAnchorStoreContext = CommentAnchorStoreContext;
 exports.CommentContext = CommentContext;
+exports.createCommentAnchorStore = createCommentAnchorStore;
 exports.dottedAnchorResolver = dottedAnchorResolver;
 exports.exactAnchorResolver = exactAnchorResolver;
+exports.strictAnchorResolver = strictAnchorResolver;
+exports.useCommentAnchorActionsOptional = useCommentAnchorActionsOptional;
+exports.useCommentAnchorOptional = useCommentAnchorOptional;
 exports.useCommentContext = useCommentContext;
 exports.useCommentContextOptional = useCommentContextOptional;
 //# sourceMappingURL=comment-context.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"comment-context.cjs","sources":["../../src/comments/comment-context.ts"],"sourcesContent":["import { createContext, useContext, type RefObject } from \"react\";\nimport {\n  DOCUMENT_ANCHOR,\n  type Comment,\n  type CommentAnchor,\n  type CommentAnchorMeta,\n  type CommentCallbacks,\n  type CommentConfig,\n} from \"./comment-types\";\n\nexport type CommentRailMode = \"closed\" | \"focused\" | \"all\";\n\n/** Resolves a requested anchor to a registered one (or null). */\nexport type AnchorResolver = (anchor: CommentAnchor, registered: string[]) => string | null;\n\nexport type CommentContextValue = {\n  comments: Comment[];\n  config: CommentConfig;\n  callbacks: CommentCallbacks;\n  commentCounts: Record<CommentAnchor, number>;\n  commentMeta: Record<CommentAnchor, CommentAnchorMeta>;\n  railMode: CommentRailMode;\n  focusedAnchor: CommentAnchor | null;\n  focusAnchor: (anchor: CommentAnchor) => void;\n  openCommentList: () => void;\n  closeRail: () => void;\n  registerAnchor: (anchor: CommentAnchor, el: HTMLElement | null) => void;\n  getAnchorTop: (anchor: CommentAnchor) => number | null;\n  contentRef: RefObject<HTMLDivElement | null>;\n  highlightAnchor: CommentAnchor | null;\n  setHighlightAnchor: (anchor: CommentAnchor | null) => void;\n};\n\nexport const CommentContext = createContext<CommentContextValue | null>(null);\n\n/** Default resolver: exact match, else the document anchor if registered. */\nexport function exactAnchorResolver(anchor: CommentAnchor, registered: string[]): string | null {\n  if (registered.includes(anchor)) return anchor;\n  if (registered.includes(DOCUMENT_ANCHOR)) return DOCUMENT_ANCHOR;\n  return null;\n}\n\n/** Resolver for dotted anchor keys: walks up `a.b.c` → `a.b` → `a` → document. */\nexport function dottedAnchorResolver(anchor: CommentAnchor, registered: string[]): string | null {\n  if (registered.includes(anchor)) return anchor;\n  let cursor = anchor;\n  while (cursor.includes(\".\")) {\n    cursor = cursor.slice(0, cursor.lastIndexOf(\".\"));\n    if (registered.includes(cursor)) return cursor;\n  }\n  return registered.includes(DOCUMENT_ANCHOR) ? DOCUMENT_ANCHOR : null;\n}\n\n/** Reads the comment context; throws when used outside a CommentProvider. */\nexport function useCommentContext(): CommentContextValue {\n  const ctx = useContext(CommentContext);\n  if (!ctx) throw new Error(\"useCommentContext must be used within a CommentProvider\");\n  return ctx;\n}\n\n/** Reads the comment context, returning null when no provider is present. */\nexport function useCommentContextOptional(): CommentContextValue | null {\n  return useContext(CommentContext);\n}\n"],"names":["createContext","DOCUMENT_ANCHOR","useContext"],"mappings":";;;;AAiCO,MAAM,iBAAiBA,MAAAA,cAA0C,IAAI;AAGrE,SAAS,oBAAoB,QAAuB,YAAqC;AAC9F,MAAI,WAAW,SAAS,MAAM,EAAG,QAAO;AACxC,MAAI,WAAW,SAASC,aAAAA,eAAe,EAAG,QAAOA,aAAAA;AACjD,SAAO;AACT;AAGO,SAAS,qBAAqB,QAAuB,YAAqC;AAC/F,MAAI,WAAW,SAAS,MAAM,EAAG,QAAO;AACxC,MAAI,SAAS;AACb,SAAO,OAAO,SAAS,GAAG,GAAG;AAC3B,aAAS,OAAO,MAAM,GAAG,OAAO,YAAY,GAAG,CAAC;AAChD,QAAI,WAAW,SAAS,MAAM,EAAG,QAAO;AAAA,EAC1C;AACA,SAAO,WAAW,SAASA,4BAAe,IAAIA,aAAAA,kBAAkB;AAClE;AAGO,SAAS,oBAAyC;AACvD,QAAM,MAAMC,MAAAA,WAAW,cAAc;AACrC,MAAI,CAAC,IAAK,OAAM,IAAI,MAAM,yDAAyD;AACnF,SAAO;AACT;AAGO,SAAS,4BAAwD;AACtE,SAAOA,MAAAA,WAAW,cAAc;AAClC;;;;;;"}
+{"version":3,"file":"comment-context.cjs","sources":["../../src/comments/comment-context.ts"],"sourcesContent":["import {\n  createContext,\n  useCallback,\n  useContext,\n  useSyncExternalStore,\n  type RefObject,\n} from \"react\";\nimport {\n  DOCUMENT_ANCHOR,\n  type Comment,\n  type CommentAnchor,\n  type CommentAnchorMeta,\n  type CommentCallbacks,\n  type CommentConfig,\n} from \"./comment-types\";\n\nexport type CommentRailMode = \"closed\" | \"focused\" | \"all\";\n\nexport type CommentScrollOptions = {\n  behavior?: ScrollBehavior;\n  block?: \"start\" | \"center\";\n  offset?: number;\n};\n\n/** Resolves a requested anchor to a registered one (or null). */\nexport type AnchorResolver = (anchor: CommentAnchor, registered: string[]) => string | null;\n\nexport type CommentContextValue = {\n  comments: Comment[];\n  config: CommentConfig;\n  callbacks: CommentCallbacks;\n  commentCounts: Record<CommentAnchor, number>;\n  commentMeta: Record<CommentAnchor, CommentAnchorMeta>;\n  railMode: CommentRailMode;\n  focusedAnchor: CommentAnchor | null;\n  focusAnchor: (anchor: CommentAnchor) => void;\n  openCommentList: () => void;\n  closeRail: () => void;\n  registerAnchor: (anchor: CommentAnchor, el: HTMLElement | null) => void;\n  getAnchorTop: (anchor: CommentAnchor) => number | null;\n  scrollToAnchor: (anchor: CommentAnchor, options?: CommentScrollOptions) => boolean;\n  contentRef: RefObject<HTMLDivElement | null>;\n  highlightAnchor: CommentAnchor | null;\n  setHighlightAnchor: (anchor: CommentAnchor | null) => void;\n};\n\nexport const CommentContext = createContext<CommentContextValue | null>(null);\n\nexport type CommentAnchorState = {\n  meta: CommentAnchorMeta | undefined;\n  active: boolean;\n  highlighted: boolean;\n};\n\nexport type CommentAnchorStore = {\n  update: (\n    commentMeta: Record<CommentAnchor, CommentAnchorMeta>,\n    railMode: CommentRailMode,\n    focusedAnchor: CommentAnchor | null,\n    highlightAnchor: CommentAnchor | null,\n  ) => void;\n  getSnapshot: (anchor: CommentAnchor) => CommentAnchorState;\n  subscribe: (anchor: CommentAnchor, listener: () => void) => () => void;\n};\n\nexport type CommentAnchorActions = Pick<\n  CommentContextValue,\n  \"focusAnchor\" | \"registerAnchor\" | \"scrollToAnchor\" | \"contentRef\"\n>;\n\nconst EMPTY_ANCHOR_STATE: CommentAnchorState = Object.freeze({\n  meta: undefined,\n  active: false,\n  highlighted: false,\n});\n\nfunction sameMeta(\n  first: CommentAnchorMeta | undefined,\n  second: CommentAnchorMeta | undefined,\n): boolean {\n  if (first === second) return true;\n  if (!first || !second) return false;\n  return (\n    first.count === second.count &&\n    first.latestStatus === second.latestStatus &&\n    first.authors.length === second.authors.length &&\n    first.authors.every((author, index) => author === second.authors[index])\n  );\n}\n\nfunction sameAnchorState(\n  first: CommentAnchorState,\n  second: CommentAnchorState,\n): boolean {\n  return (\n    sameMeta(first.meta, second.meta) &&\n    first.active === second.active &&\n    first.highlighted === second.highlighted\n  );\n}\n\nexport function createCommentAnchorStore(): CommentAnchorStore {\n  let meta: Record<CommentAnchor, CommentAnchorMeta> = {};\n  let mode: CommentRailMode = \"closed\";\n  let focused: CommentAnchor | null = null;\n  let highlighted: CommentAnchor | null = null;\n  const snapshots = new Map<CommentAnchor, CommentAnchorState>();\n  const listeners = new Map<CommentAnchor, Set<() => void>>();\n\n  function nextSnapshot(anchor: CommentAnchor): CommentAnchorState {\n    return {\n      meta: meta[anchor],\n      active: mode === \"focused\" && focused === anchor,\n      highlighted: highlighted === anchor || (mode === \"focused\" && focused === anchor),\n    };\n  }\n\n  return {\n    update(nextMeta, nextMode, nextFocused, nextHighlighted) {\n      meta = nextMeta;\n      mode = nextMode;\n      focused = nextFocused;\n      highlighted = nextHighlighted;\n      for (const [anchor, anchorListeners] of listeners) {\n        const current = snapshots.get(anchor) ?? EMPTY_ANCHOR_STATE;\n        const next = nextSnapshot(anchor);\n        if (sameAnchorState(current, next)) continue;\n        snapshots.set(anchor, next);\n        for (const listener of anchorListeners) listener();\n      }\n    },\n    getSnapshot(anchor) {\n      const current = snapshots.get(anchor) ?? EMPTY_ANCHOR_STATE;\n      const next = nextSnapshot(anchor);\n      if (sameAnchorState(current, next)) return current;\n      snapshots.set(anchor, next);\n      return next;\n    },\n    subscribe(anchor, listener) {\n      const anchorListeners = listeners.get(anchor) ?? new Set();\n      anchorListeners.add(listener);\n      listeners.set(anchor, anchorListeners);\n      return () => {\n        anchorListeners.delete(listener);\n        if (anchorListeners.size === 0) listeners.delete(anchor);\n      };\n    },\n  };\n}\n\nexport const CommentAnchorStoreContext = createContext<CommentAnchorStore | null>(null);\nexport const CommentAnchorActionsContext = createContext<CommentAnchorActions | null>(null);\n\n/** Subscribes to metadata and focus state for one anchor only. */\nexport function useCommentAnchorOptional(\n  anchor: CommentAnchor | null | undefined,\n): CommentAnchorState | null {\n  const contextStore = useContext(CommentAnchorStoreContext);\n  const store = contextStore ?? EMPTY_ANCHOR_STORE;\n  const subscribe = useCallback(\n    (listener: () => void) => (anchor ? store.subscribe(anchor, listener) : () => undefined),\n    [anchor, store],\n  );\n  const getSnapshot = useCallback(\n    () => (anchor ? store.getSnapshot(anchor) : EMPTY_ANCHOR_STATE),\n    [anchor, store],\n  );\n  const snapshot = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n  return contextStore && anchor ? snapshot : null;\n}\n\nconst EMPTY_ANCHOR_STORE = createCommentAnchorStore();\n\n/** Reads stable anchor actions without subscribing to document comment state. */\nexport function useCommentAnchorActionsOptional(): CommentAnchorActions | null {\n  return useContext(CommentAnchorActionsContext);\n}\n\n/** Resolver for opaque identities such as URIs: exact match or no match. */\nexport function strictAnchorResolver(anchor: CommentAnchor, registered: string[]): string | null {\n  return registered.includes(anchor) ? anchor : null;\n}\n\n/** Default resolver: exact match, else the document anchor if registered. */\nexport function exactAnchorResolver(anchor: CommentAnchor, registered: string[]): string | null {\n  if (registered.includes(anchor)) return anchor;\n  if (registered.includes(DOCUMENT_ANCHOR)) return DOCUMENT_ANCHOR;\n  return null;\n}\n\n/** Resolver for dotted anchor keys: walks up `a.b.c` → `a.b` → `a` → document. */\nexport function dottedAnchorResolver(anchor: CommentAnchor, registered: string[]): string | null {\n  if (registered.includes(anchor)) return anchor;\n  let cursor = anchor;\n  while (cursor.includes(\".\")) {\n    cursor = cursor.slice(0, cursor.lastIndexOf(\".\"));\n    if (registered.includes(cursor)) return cursor;\n  }\n  return registered.includes(DOCUMENT_ANCHOR) ? DOCUMENT_ANCHOR : null;\n}\n\n/** Reads the comment context; throws when used outside a CommentProvider. */\nexport function useCommentContext(): CommentContextValue {\n  const ctx = useContext(CommentContext);\n  if (!ctx) throw new Error(\"useCommentContext must be used within a CommentProvider\");\n  return ctx;\n}\n\n/** Reads the comment context, returning null when no provider is present. */\nexport function useCommentContextOptional(): CommentContextValue | null {\n  return useContext(CommentContext);\n}\n"],"names":["createContext","useContext","useCallback","useSyncExternalStore","DOCUMENT_ANCHOR"],"mappings":"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"}

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

@@ -1,6 +1,11 @@
 import { RefObject } from 'react';
 import { Comment, CommentAnchor, CommentAnchorMeta, CommentCallbacks, CommentConfig } from './comment-types';
 export type CommentRailMode = "closed" | "focused" | "all";
+export type CommentScrollOptions = {
+    behavior?: ScrollBehavior;
+    block?: "start" | "center";
+    offset?: number;
+};
 /** Resolves a requested anchor to a registered one (or null). */
 export type AnchorResolver = (anchor: CommentAnchor, registered: string[]) => string | null;
 export type CommentContextValue = {
@@ -16,11 +21,32 @@ export type CommentContextValue = {
     closeRail: () => void;
     registerAnchor: (anchor: CommentAnchor, el: HTMLElement | null) => void;
     getAnchorTop: (anchor: CommentAnchor) => number | null;
+    scrollToAnchor: (anchor: CommentAnchor, options?: CommentScrollOptions) => boolean;
     contentRef: RefObject<HTMLDivElement | null>;
     highlightAnchor: CommentAnchor | null;
     setHighlightAnchor: (anchor: CommentAnchor | null) => void;
 };
 export declare const CommentContext: import('react').Context<CommentContextValue | null>;
+export type CommentAnchorState = {
+    meta: CommentAnchorMeta | undefined;
+    active: boolean;
+    highlighted: boolean;
+};
+export type CommentAnchorStore = {
+    update: (commentMeta: Record<CommentAnchor, CommentAnchorMeta>, railMode: CommentRailMode, focusedAnchor: CommentAnchor | null, highlightAnchor: CommentAnchor | null) => void;
+    getSnapshot: (anchor: CommentAnchor) => CommentAnchorState;
+    subscribe: (anchor: CommentAnchor, listener: () => void) => () => void;
+};
+export type CommentAnchorActions = Pick<CommentContextValue, "focusAnchor" | "registerAnchor" | "scrollToAnchor" | "contentRef">;
+export declare function createCommentAnchorStore(): CommentAnchorStore;
+export declare const CommentAnchorStoreContext: import('react').Context<CommentAnchorStore | null>;
+export declare const CommentAnchorActionsContext: import('react').Context<CommentAnchorActions | null>;
+/** Subscribes to metadata and focus state for one anchor only. */
+export declare function useCommentAnchorOptional(anchor: CommentAnchor | null | undefined): CommentAnchorState | null;
+/** Reads stable anchor actions without subscribing to document comment state. */
+export declare function useCommentAnchorActionsOptional(): CommentAnchorActions | null;
+/** Resolver for opaque identities such as URIs: exact match or no match. */
+export declare function strictAnchorResolver(anchor: CommentAnchor, registered: string[]): string | null;
 /** Default resolver: exact match, else the document anchor if registered. */
 export declare function exactAnchorResolver(anchor: CommentAnchor, registered: string[]): string | null;
 /** Resolver for dotted anchor keys: walks up `a.b.c` → `a.b` → `a` → document. */

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

@@ -1 +1 @@
-{"version":3,"file":"comment-context.d.ts","sourceRoot":"","sources":["../../src/comments/comment-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC;AAE3D,iEAAiE;AACjE,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,MAAM,GAAG,IAAI,CAAC;AAE5F,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC7C,WAAW,EAAE,MAAM,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;IACtD,QAAQ,EAAE,eAAe,CAAC;IAC1B,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,WAAW,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IAC7C,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,cAAc,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IACxE,YAAY,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,MAAM,GAAG,IAAI,CAAC;IACvD,UAAU,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC7C,eAAe,EAAE,aAAa,GAAG,IAAI,CAAC;IACtC,kBAAkB,EAAE,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,CAAC;CAC5D,CAAC;AAEF,eAAO,MAAM,cAAc,qDAAkD,CAAC;AAE9E,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAI9F;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAQ/F;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,IAAI,mBAAmB,CAIvD;AAED,6EAA6E;AAC7E,wBAAgB,yBAAyB,IAAI,mBAAmB,GAAG,IAAI,CAEtE"}
+{"version":3,"file":"comment-context.d.ts","sourceRoot":"","sources":["../../src/comments/comment-context.ts"],"names":[],"mappings":"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"}

package/dist/comments/comment-context.js

@@ -1,6 +1,88 @@
-import { useContext, createContext } from "react";
+import { useContext, useCallback, useSyncExternalStore, createContext } from "react";
 import { DOCUMENT_ANCHOR } from "./comment-types.js";
 const CommentContext = createContext(null);
+const EMPTY_ANCHOR_STATE = Object.freeze({
+  meta: void 0,
+  active: false,
+  highlighted: false
+});
+function sameMeta(first, second) {
+  if (first === second) return true;
+  if (!first || !second) return false;
+  return first.count === second.count && first.latestStatus === second.latestStatus && first.authors.length === second.authors.length && first.authors.every((author, index) => author === second.authors[index]);
+}
+function sameAnchorState(first, second) {
+  return sameMeta(first.meta, second.meta) && first.active === second.active && first.highlighted === second.highlighted;
+}
+function createCommentAnchorStore() {
+  let meta = {};
+  let mode = "closed";
+  let focused = null;
+  let highlighted = null;
+  const snapshots = /* @__PURE__ */ new Map();
+  const listeners = /* @__PURE__ */ new Map();
+  function nextSnapshot(anchor) {
+    return {
+      meta: meta[anchor],
+      active: mode === "focused" && focused === anchor,
+      highlighted: highlighted === anchor || mode === "focused" && focused === anchor
+    };
+  }
+  return {
+    update(nextMeta, nextMode, nextFocused, nextHighlighted) {
+      meta = nextMeta;
+      mode = nextMode;
+      focused = nextFocused;
+      highlighted = nextHighlighted;
+      for (const [anchor, anchorListeners] of listeners) {
+        const current = snapshots.get(anchor) ?? EMPTY_ANCHOR_STATE;
+        const next = nextSnapshot(anchor);
+        if (sameAnchorState(current, next)) continue;
+        snapshots.set(anchor, next);
+        for (const listener of anchorListeners) listener();
+      }
+    },
+    getSnapshot(anchor) {
+      const current = snapshots.get(anchor) ?? EMPTY_ANCHOR_STATE;
+      const next = nextSnapshot(anchor);
+      if (sameAnchorState(current, next)) return current;
+      snapshots.set(anchor, next);
+      return next;
+    },
+    subscribe(anchor, listener) {
+      const anchorListeners = listeners.get(anchor) ?? /* @__PURE__ */ new Set();
+      anchorListeners.add(listener);
+      listeners.set(anchor, anchorListeners);
+      return () => {
+        anchorListeners.delete(listener);
+        if (anchorListeners.size === 0) listeners.delete(anchor);
+      };
+    }
+  };
+}
+const CommentAnchorStoreContext = createContext(null);
+const CommentAnchorActionsContext = createContext(null);
+function useCommentAnchorOptional(anchor) {
+  const contextStore = useContext(CommentAnchorStoreContext);
+  const store = contextStore ?? EMPTY_ANCHOR_STORE;
+  const subscribe = useCallback(
+    (listener) => anchor ? store.subscribe(anchor, listener) : () => void 0,
+    [anchor, store]
+  );
+  const getSnapshot = useCallback(
+    () => anchor ? store.getSnapshot(anchor) : EMPTY_ANCHOR_STATE,
+    [anchor, store]
+  );
+  const snapshot = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+  return contextStore && anchor ? snapshot : null;
+}
+const EMPTY_ANCHOR_STORE = createCommentAnchorStore();
+function useCommentAnchorActionsOptional() {
+  return useContext(CommentAnchorActionsContext);
+}
+function strictAnchorResolver(anchor, registered) {
+  return registered.includes(anchor) ? anchor : null;
+}
 function exactAnchorResolver(anchor, registered) {
   if (registered.includes(anchor)) return anchor;
   if (registered.includes(DOCUMENT_ANCHOR)) return DOCUMENT_ANCHOR;
@@ -24,9 +106,15 @@ function useCommentContextOptional() {
   return useContext(CommentContext);
 }
 export {
+  CommentAnchorActionsContext,
+  CommentAnchorStoreContext,
   CommentContext,
+  createCommentAnchorStore,
   dottedAnchorResolver,
   exactAnchorResolver,
+  strictAnchorResolver,
+  useCommentAnchorActionsOptional,
+  useCommentAnchorOptional,
   useCommentContext,
   useCommentContextOptional
 };

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

@@ -1 +1 @@
-{"version":3,"file":"comment-context.js","sources":["../../src/comments/comment-context.ts"],"sourcesContent":["import { createContext, useContext, type RefObject } from \"react\";\nimport {\n  DOCUMENT_ANCHOR,\n  type Comment,\n  type CommentAnchor,\n  type CommentAnchorMeta,\n  type CommentCallbacks,\n  type CommentConfig,\n} from \"./comment-types\";\n\nexport type CommentRailMode = \"closed\" | \"focused\" | \"all\";\n\n/** Resolves a requested anchor to a registered one (or null). */\nexport type AnchorResolver = (anchor: CommentAnchor, registered: string[]) => string | null;\n\nexport type CommentContextValue = {\n  comments: Comment[];\n  config: CommentConfig;\n  callbacks: CommentCallbacks;\n  commentCounts: Record<CommentAnchor, number>;\n  commentMeta: Record<CommentAnchor, CommentAnchorMeta>;\n  railMode: CommentRailMode;\n  focusedAnchor: CommentAnchor | null;\n  focusAnchor: (anchor: CommentAnchor) => void;\n  openCommentList: () => void;\n  closeRail: () => void;\n  registerAnchor: (anchor: CommentAnchor, el: HTMLElement | null) => void;\n  getAnchorTop: (anchor: CommentAnchor) => number | null;\n  contentRef: RefObject<HTMLDivElement | null>;\n  highlightAnchor: CommentAnchor | null;\n  setHighlightAnchor: (anchor: CommentAnchor | null) => void;\n};\n\nexport const CommentContext = createContext<CommentContextValue | null>(null);\n\n/** Default resolver: exact match, else the document anchor if registered. */\nexport function exactAnchorResolver(anchor: CommentAnchor, registered: string[]): string | null {\n  if (registered.includes(anchor)) return anchor;\n  if (registered.includes(DOCUMENT_ANCHOR)) return DOCUMENT_ANCHOR;\n  return null;\n}\n\n/** Resolver for dotted anchor keys: walks up `a.b.c` → `a.b` → `a` → document. */\nexport function dottedAnchorResolver(anchor: CommentAnchor, registered: string[]): string | null {\n  if (registered.includes(anchor)) return anchor;\n  let cursor = anchor;\n  while (cursor.includes(\".\")) {\n    cursor = cursor.slice(0, cursor.lastIndexOf(\".\"));\n    if (registered.includes(cursor)) return cursor;\n  }\n  return registered.includes(DOCUMENT_ANCHOR) ? DOCUMENT_ANCHOR : null;\n}\n\n/** Reads the comment context; throws when used outside a CommentProvider. */\nexport function useCommentContext(): CommentContextValue {\n  const ctx = useContext(CommentContext);\n  if (!ctx) throw new Error(\"useCommentContext must be used within a CommentProvider\");\n  return ctx;\n}\n\n/** Reads the comment context, returning null when no provider is present. */\nexport function useCommentContextOptional(): CommentContextValue | null {\n  return useContext(CommentContext);\n}\n"],"names":[],"mappings":";;AAiCO,MAAM,iBAAiB,cAA0C,IAAI;AAGrE,SAAS,oBAAoB,QAAuB,YAAqC;AAC9F,MAAI,WAAW,SAAS,MAAM,EAAG,QAAO;AACxC,MAAI,WAAW,SAAS,eAAe,EAAG,QAAO;AACjD,SAAO;AACT;AAGO,SAAS,qBAAqB,QAAuB,YAAqC;AAC/F,MAAI,WAAW,SAAS,MAAM,EAAG,QAAO;AACxC,MAAI,SAAS;AACb,SAAO,OAAO,SAAS,GAAG,GAAG;AAC3B,aAAS,OAAO,MAAM,GAAG,OAAO,YAAY,GAAG,CAAC;AAChD,QAAI,WAAW,SAAS,MAAM,EAAG,QAAO;AAAA,EAC1C;AACA,SAAO,WAAW,SAAS,eAAe,IAAI,kBAAkB;AAClE;AAGO,SAAS,oBAAyC;AACvD,QAAM,MAAM,WAAW,cAAc;AACrC,MAAI,CAAC,IAAK,OAAM,IAAI,MAAM,yDAAyD;AACnF,SAAO;AACT;AAGO,SAAS,4BAAwD;AACtE,SAAO,WAAW,cAAc;AAClC;"}
+{"version":3,"file":"comment-context.js","sources":["../../src/comments/comment-context.ts"],"sourcesContent":["import {\n  createContext,\n  useCallback,\n  useContext,\n  useSyncExternalStore,\n  type RefObject,\n} from \"react\";\nimport {\n  DOCUMENT_ANCHOR,\n  type Comment,\n  type CommentAnchor,\n  type CommentAnchorMeta,\n  type CommentCallbacks,\n  type CommentConfig,\n} from \"./comment-types\";\n\nexport type CommentRailMode = \"closed\" | \"focused\" | \"all\";\n\nexport type CommentScrollOptions = {\n  behavior?: ScrollBehavior;\n  block?: \"start\" | \"center\";\n  offset?: number;\n};\n\n/** Resolves a requested anchor to a registered one (or null). */\nexport type AnchorResolver = (anchor: CommentAnchor, registered: string[]) => string | null;\n\nexport type CommentContextValue = {\n  comments: Comment[];\n  config: CommentConfig;\n  callbacks: CommentCallbacks;\n  commentCounts: Record<CommentAnchor, number>;\n  commentMeta: Record<CommentAnchor, CommentAnchorMeta>;\n  railMode: CommentRailMode;\n  focusedAnchor: CommentAnchor | null;\n  focusAnchor: (anchor: CommentAnchor) => void;\n  openCommentList: () => void;\n  closeRail: () => void;\n  registerAnchor: (anchor: CommentAnchor, el: HTMLElement | null) => void;\n  getAnchorTop: (anchor: CommentAnchor) => number | null;\n  scrollToAnchor: (anchor: CommentAnchor, options?: CommentScrollOptions) => boolean;\n  contentRef: RefObject<HTMLDivElement | null>;\n  highlightAnchor: CommentAnchor | null;\n  setHighlightAnchor: (anchor: CommentAnchor | null) => void;\n};\n\nexport const CommentContext = createContext<CommentContextValue | null>(null);\n\nexport type CommentAnchorState = {\n  meta: CommentAnchorMeta | undefined;\n  active: boolean;\n  highlighted: boolean;\n};\n\nexport type CommentAnchorStore = {\n  update: (\n    commentMeta: Record<CommentAnchor, CommentAnchorMeta>,\n    railMode: CommentRailMode,\n    focusedAnchor: CommentAnchor | null,\n    highlightAnchor: CommentAnchor | null,\n  ) => void;\n  getSnapshot: (anchor: CommentAnchor) => CommentAnchorState;\n  subscribe: (anchor: CommentAnchor, listener: () => void) => () => void;\n};\n\nexport type CommentAnchorActions = Pick<\n  CommentContextValue,\n  \"focusAnchor\" | \"registerAnchor\" | \"scrollToAnchor\" | \"contentRef\"\n>;\n\nconst EMPTY_ANCHOR_STATE: CommentAnchorState = Object.freeze({\n  meta: undefined,\n  active: false,\n  highlighted: false,\n});\n\nfunction sameMeta(\n  first: CommentAnchorMeta | undefined,\n  second: CommentAnchorMeta | undefined,\n): boolean {\n  if (first === second) return true;\n  if (!first || !second) return false;\n  return (\n    first.count === second.count &&\n    first.latestStatus === second.latestStatus &&\n    first.authors.length === second.authors.length &&\n    first.authors.every((author, index) => author === second.authors[index])\n  );\n}\n\nfunction sameAnchorState(\n  first: CommentAnchorState,\n  second: CommentAnchorState,\n): boolean {\n  return (\n    sameMeta(first.meta, second.meta) &&\n    first.active === second.active &&\n    first.highlighted === second.highlighted\n  );\n}\n\nexport function createCommentAnchorStore(): CommentAnchorStore {\n  let meta: Record<CommentAnchor, CommentAnchorMeta> = {};\n  let mode: CommentRailMode = \"closed\";\n  let focused: CommentAnchor | null = null;\n  let highlighted: CommentAnchor | null = null;\n  const snapshots = new Map<CommentAnchor, CommentAnchorState>();\n  const listeners = new Map<CommentAnchor, Set<() => void>>();\n\n  function nextSnapshot(anchor: CommentAnchor): CommentAnchorState {\n    return {\n      meta: meta[anchor],\n      active: mode === \"focused\" && focused === anchor,\n      highlighted: highlighted === anchor || (mode === \"focused\" && focused === anchor),\n    };\n  }\n\n  return {\n    update(nextMeta, nextMode, nextFocused, nextHighlighted) {\n      meta = nextMeta;\n      mode = nextMode;\n      focused = nextFocused;\n      highlighted = nextHighlighted;\n      for (const [anchor, anchorListeners] of listeners) {\n        const current = snapshots.get(anchor) ?? EMPTY_ANCHOR_STATE;\n        const next = nextSnapshot(anchor);\n        if (sameAnchorState(current, next)) continue;\n        snapshots.set(anchor, next);\n        for (const listener of anchorListeners) listener();\n      }\n    },\n    getSnapshot(anchor) {\n      const current = snapshots.get(anchor) ?? EMPTY_ANCHOR_STATE;\n      const next = nextSnapshot(anchor);\n      if (sameAnchorState(current, next)) return current;\n      snapshots.set(anchor, next);\n      return next;\n    },\n    subscribe(anchor, listener) {\n      const anchorListeners = listeners.get(anchor) ?? new Set();\n      anchorListeners.add(listener);\n      listeners.set(anchor, anchorListeners);\n      return () => {\n        anchorListeners.delete(listener);\n        if (anchorListeners.size === 0) listeners.delete(anchor);\n      };\n    },\n  };\n}\n\nexport const CommentAnchorStoreContext = createContext<CommentAnchorStore | null>(null);\nexport const CommentAnchorActionsContext = createContext<CommentAnchorActions | null>(null);\n\n/** Subscribes to metadata and focus state for one anchor only. */\nexport function useCommentAnchorOptional(\n  anchor: CommentAnchor | null | undefined,\n): CommentAnchorState | null {\n  const contextStore = useContext(CommentAnchorStoreContext);\n  const store = contextStore ?? EMPTY_ANCHOR_STORE;\n  const subscribe = useCallback(\n    (listener: () => void) => (anchor ? store.subscribe(anchor, listener) : () => undefined),\n    [anchor, store],\n  );\n  const getSnapshot = useCallback(\n    () => (anchor ? store.getSnapshot(anchor) : EMPTY_ANCHOR_STATE),\n    [anchor, store],\n  );\n  const snapshot = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n  return contextStore && anchor ? snapshot : null;\n}\n\nconst EMPTY_ANCHOR_STORE = createCommentAnchorStore();\n\n/** Reads stable anchor actions without subscribing to document comment state. */\nexport function useCommentAnchorActionsOptional(): CommentAnchorActions | null {\n  return useContext(CommentAnchorActionsContext);\n}\n\n/** Resolver for opaque identities such as URIs: exact match or no match. */\nexport function strictAnchorResolver(anchor: CommentAnchor, registered: string[]): string | null {\n  return registered.includes(anchor) ? anchor : null;\n}\n\n/** Default resolver: exact match, else the document anchor if registered. */\nexport function exactAnchorResolver(anchor: CommentAnchor, registered: string[]): string | null {\n  if (registered.includes(anchor)) return anchor;\n  if (registered.includes(DOCUMENT_ANCHOR)) return DOCUMENT_ANCHOR;\n  return null;\n}\n\n/** Resolver for dotted anchor keys: walks up `a.b.c` → `a.b` → `a` → document. */\nexport function dottedAnchorResolver(anchor: CommentAnchor, registered: string[]): string | null {\n  if (registered.includes(anchor)) return anchor;\n  let cursor = anchor;\n  while (cursor.includes(\".\")) {\n    cursor = cursor.slice(0, cursor.lastIndexOf(\".\"));\n    if (registered.includes(cursor)) return cursor;\n  }\n  return registered.includes(DOCUMENT_ANCHOR) ? DOCUMENT_ANCHOR : null;\n}\n\n/** Reads the comment context; throws when used outside a CommentProvider. */\nexport function useCommentContext(): CommentContextValue {\n  const ctx = useContext(CommentContext);\n  if (!ctx) throw new Error(\"useCommentContext must be used within a CommentProvider\");\n  return ctx;\n}\n\n/** Reads the comment context, returning null when no provider is present. */\nexport function useCommentContextOptional(): CommentContextValue | null {\n  return useContext(CommentContext);\n}\n"],"names":[],"mappings":"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"}

package/dist/comments.cjs

@@ -48,6 +48,9 @@ exports.CommentThread = CommentThread.CommentThread;
 exports.CommentProvider = CommentProvider.CommentProvider;
 exports.dottedAnchorResolver = commentContext.dottedAnchorResolver;
 exports.exactAnchorResolver = commentContext.exactAnchorResolver;
+exports.strictAnchorResolver = commentContext.strictAnchorResolver;
+exports.useCommentAnchorActionsOptional = commentContext.useCommentAnchorActionsOptional;
+exports.useCommentAnchorOptional = commentContext.useCommentAnchorOptional;
 exports.useCommentContext = commentContext.useCommentContext;
 exports.useCommentContextOptional = commentContext.useCommentContextOptional;
 exports.CommentSidePanel = CommentSidePanel.CommentSidePanel;

package/dist/comments.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"comments.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"comments.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/comments.d.ts

@@ -8,7 +8,7 @@ export { CommentComposer, type CommentComposerProps, } from './comments/CommentC
 export { CommentThreadList, type CommentThreadListProps, } from './comments/CommentThreadList';
 export { CommentThread, type CommentThreadProps, } from './comments/CommentThread';
 export { CommentProvider, type CommentProviderProps } from './comments/CommentProvider';
-export { useCommentContext, useCommentContextOptional, exactAnchorResolver, dottedAnchorResolver, type CommentContextValue, type CommentRailMode, type AnchorResolver, } from './comments/comment-context';
+export { useCommentContext, useCommentContextOptional, useCommentAnchorOptional, useCommentAnchorActionsOptional, exactAnchorResolver, dottedAnchorResolver, strictAnchorResolver, type CommentContextValue, type CommentAnchorState, type CommentAnchorActions, type CommentRailMode, type AnchorResolver, type CommentScrollOptions, } from './comments/comment-context';
 export { CommentSidePanel, type CommentSidePanelProps, } from './comments/CommentSidePanel';
 export { GroupedComments, type GroupedCommentsProps, } from './comments/GroupedComments';
 export { CommentFilterBar, type CommentFilterBarProps, } from './comments/CommentFilterBar';

package/dist/comments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../src/comments.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AAEzC,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,mBAAmB,EACnB,KAAK,wBAAwB,GAC9B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,GAC5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,aAAa,EACb,KAAK,kBAAkB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACxF,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../src/comments.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AAEzC,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,mBAAmB,EACnB,KAAK,wBAAwB,GAC9B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,GAC5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,aAAa,EACb,KAAK,kBAAkB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACxF,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,wBAAwB,EACxB,+BAA+B,EAC/B,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,4BAA4B,CAAC"}

package/dist/comments.js

@@ -8,7 +8,7 @@ import { CommentComposer } from "./comments/CommentComposer.js";
 import { CommentThreadList } from "./comments/CommentThreadList.js";
 import { CommentThread } from "./comments/CommentThread.js";
 import { CommentProvider } from "./comments/CommentProvider.js";
-import { dottedAnchorResolver, exactAnchorResolver, useCommentContext, useCommentContextOptional } from "./comments/comment-context.js";
+import { dottedAnchorResolver, exactAnchorResolver, strictAnchorResolver, useCommentAnchorActionsOptional, useCommentAnchorOptional, useCommentContext, useCommentContextOptional } from "./comments/comment-context.js";
 import { CommentSidePanel } from "./comments/CommentSidePanel.js";
 import { GroupedComments } from "./comments/GroupedComments.js";
 import { CommentFilterBar } from "./comments/CommentFilterBar.js";
@@ -49,8 +49,11 @@ export {
   resolveFacetOption,
   resolveStatusConfig,
   sortReplies,
+  strictAnchorResolver,
   toneToBadgeTone,
   truncatePlain,
+  useCommentAnchorActionsOptional,
+  useCommentAnchorOptional,
   useCommentContext,
   useCommentContextOptional
 };