@devaccel-labs/comment-service 0.7.0 → 0.8.0

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devaccel-labs/comment-service",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "In-UI component comments for TanStack Start on Cloudflare. Anchors survive redeploys.",
   "type": "module",
   "license": "UNLICENSED",