@useclickly/react 1.0.0 → 1.0.2

package/dist/Clickly.d.ts

@@ -0,0 +1,25 @@
+export interface ClicklyProps {
+    /** Custom class on the host element (for z-index / positioning overrides). */
+    className?: string;
+    /** Optional MCP server endpoint, e.g. "http://localhost:4747". */
+    endpoint?: string;
+    /** Join an existing MCP session by ID. */
+    sessionId?: string;
+    onAnnotationAdd?: (id: string) => void;
+    onAnnotationDelete?: (id: string) => void;
+    onAnnotationsClear?: () => void;
+    onCopy?: (markdown: string) => void;
+    onSessionCreated?: (sessionId: string) => void;
+}
+/**
+ * Mount once near the root of your React app. Dev-only by convention:
+ *
+ * ```tsx
+ * {process.env.NODE_ENV === "development" && <Clickly />}
+ * ```
+ *
+ * Renders a small floating button (FAB) in the bottom-right corner.
+ * Click it (or press `⌘/Ctrl+Shift+F`) to open the full toolbar.
+ */
+export declare function Clickly({ className }?: ClicklyProps): import("react").ReactPortal | null;
+//# sourceMappingURL=Clickly.d.ts.map

package/dist/Clickly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Clickly.d.ts","sourceRoot":"","sources":["../src/Clickly.tsx"],"names":[],"mappings":"AAYA,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD;AASD;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,EAAE,SAAS,EAAE,GAAE,YAAiB,sCA6EvD"}

package/dist/hooks/useDraggable.d.ts

@@ -0,0 +1,28 @@
+export interface Position {
+    x: number;
+    y: number;
+}
+interface DraggableApi {
+    position: Position;
+    setPosition: (p: Position) => void;
+    /** Spread onto the drag handle. */
+    handleProps: {
+        onPointerDown: (e: React.PointerEvent) => void;
+        style: React.CSSProperties;
+    };
+    isDragging: boolean;
+}
+/**
+ * In-session drag positioning. Position resets to `defaultPos` whenever
+ * the consumer remounts (e.g. toolbar collapse → expand cycle).
+ *
+ * We deliberately do NOT persist across reloads — users expect the
+ * toolbar to come back at its default anchor, not where they last left
+ * it three sessions ago. Drag is for "get out of my way right now".
+ */
+export declare function useDraggable(defaultPos: Position, size: {
+    width: number;
+    height: number;
+}): DraggableApi;
+export {};
+//# sourceMappingURL=useDraggable.d.ts.map

package/dist/hooks/useDraggable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDraggable.d.ts","sourceRoot":"","sources":["../../src/hooks/useDraggable.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,UAAU,YAAY;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,CAAC,CAAC,EAAE,QAAQ,KAAK,IAAI,CAAC;IACnC,mCAAmC;IACnC,WAAW,EAAE;QACX,aAAa,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC;QAC/C,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC;KAC5B,CAAC;IACF,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtC,YAAY,CAqDd"}

package/dist/hooks/usePersistedState.d.ts

@@ -0,0 +1,6 @@
+/**
+ * `useState` + localStorage. Plain JSON-serializable values only.
+ * Safe under SSR (returns `initial` on first render).
+ */
+export declare function usePersistedState<T>(key: string, initial: T): [T, (next: T | ((prev: T) => T)) => void];
+//# sourceMappingURL=usePersistedState.d.ts.map

package/dist/hooks/usePersistedState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePersistedState.d.ts","sourceRoot":"","sources":["../../src/hooks/usePersistedState.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,CAAC,GACT,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAqB3C"}