@devaccel-labs/comment-service 0.7.0 → 0.9.0

package/dist/types/compiler/annotate.d.ts

@@ -1,7 +1,10 @@
 export declare function toProjectPath(filename: string, root: string): string;
 /**
- * Stamp the root DOM node of each component with a stable file + component name.
+ * Stamp the root node of each component of each component with a stable file + component name.
  * Line numbers are intentionally not included: moving the component in the file
- * or on the page must not change the stamp.
+ * or on the page must not change the stamp. A root that is itself a component
+ * (`<DropdownMenu>`, `<Menu.Root>`) gets the stamp as a prop: it reaches the DOM when
+ * the component spreads its props, and the toolbar reads it from React's tree when
+ * the component renders into a portal.
  */
 export declare function annotateSource(code: string, filename: string, root: string): string;

package/dist/types/react/index.d.ts

@@ -1,2 +1,3 @@
 export { captureAnchor, resolveInDocument } from "./capture.js";
-export { CommentToolbar, type ToolbarPosition, type ToolbarTheme } from "./toolbar.js";
+export { CommentToolbar, type ToolbarSource } from "./loader.js";
+export type { ToolbarPosition, ToolbarProps, ToolbarTheme } from "./toolbar.js";

package/dist/types/react/loader.d.ts

@@ -0,0 +1,10 @@
+import type { ToolbarProps } from "./toolbar.js";
+export type ToolbarSource = "latest" | "bundled";
+export declare function CommentToolbar({ source, sessionPath, pollMs, position, theme, navigate, }: ToolbarProps & {
+    /**
+     * "latest" (default) loads the newest compatible toolbar from the comment service, so fixes ship
+     * without a dependency upgrade, and falls back to the copy in this package if that fails.
+     * "bundled" always uses the copy in this package.
+     */
+    source?: ToolbarSource;
+}): null;

package/dist/types/react/runtime-version.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The contract between the loader in the npm package and the toolbar the Worker serves at
+ * `/v1/toolbar/<runtimeVersion>.js`. Bump it only when `mount` or `ToolbarProps` change incompatibly,
+ * and commit the last build of the old version under apps/worker/public/v1/toolbar/ first so apps
+ * still on it keep working.
+ */
+export declare const runtimeVersion = 1;

package/dist/types/react/runtime.d.ts

@@ -0,0 +1,7 @@
+import { type ToolbarProps } from "./toolbar.js";
+export { runtimeVersion } from "./runtime-version.js";
+export type ToolbarHandle = {
+    update(props: ToolbarProps): void;
+    unmount(): void;
+};
+export declare function mount(container: HTMLElement, props: ToolbarProps): ToolbarHandle;

package/dist/types/react/toolbar.d.ts

@@ -1,6 +1,6 @@
 export type ToolbarPosition = "bottom-left" | "bottom-center" | "bottom-right";
 export type ToolbarTheme = "light" | "dark" | "system";
-export declare function CommentToolbar({ sessionPath, pollMs, position, theme, navigate, }: {
+export type ToolbarProps = {
     sessionPath?: string;
     pollMs?: number;
     /** Default bar position. Each person can override it from their menu. */
@@ -12,4 +12,5 @@ export declare function CommentToolbar({ sessionPath, pollMs, position, theme, n
      * Without it, selecting a comment from another page does a full page load.
      */
     navigate?: (href: string) => void;
-}): import("react").ReactPortal | null;
+};
+export declare function ToolbarApp({ sessionPath, pollMs, position, theme, navigate, }: ToolbarProps): import("react").ReactPortal | null;

package/dist/vite.js

@@ -58,6 +58,16 @@ function setAttr(path, name, value) {
     return;
   path.node.openingElement.attributes.push(t.jsxAttribute(t.jsxIdentifier(name), t.stringLiteral(value)));
 }
+var unstampable = /^(?:React\.)?(?:Fragment|Suspense|StrictMode|Profiler|Activity|ViewTransition)$|\.(?:Provider|Consumer)$/;
+function jsxName(name) {
+  if (t.isJSXIdentifier(name))
+    return name.name;
+  if (t.isJSXMemberExpression(name)) {
+    const object = jsxName(name.object);
+    return object ? `${object}.${name.property.name}` : null;
+  }
+  return null;
+}
 function annotateSource(code, filename, root) {
   if (!filename.match(/\.[jt]sx$/))
     return code;
@@ -77,10 +87,8 @@ function annotateSource(code, filename, root) {
   let changed = false;
   traverse()(ast, {
     JSXElement(path) {
-      const opening = path.node.openingElement.name;
-      if (!t.isJSXIdentifier(opening))
-        return;
-      if (opening.name[0] !== opening.name[0].toLowerCase())
+      const tag = jsxName(path.node.openingElement.name);
+      if (!tag || unstampable.test(tag))
         return;
       if (!isRootJsx(path))
         return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devaccel-labs/comment-service",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "In-UI component comments for TanStack Start on Cloudflare. Anchors survive redeploys.",
   "type": "module",
   "license": "UNLICENSED",
@@ -43,8 +43,8 @@
   },
   "devDependencies": {
     "esbuild": "^0.28.1",
-    "@devaccel/comment-core": "0.1.0",
     "@devaccel/comment-compiler": "0.1.0",
+    "@devaccel/comment-core": "0.1.0",
     "@devaccel/comment-react": "0.1.0",
     "@devaccel/comment-server": "0.1.0",
     "@devaccel/comment-start": "0.1.0"