@useclickly/react 1.0.0 → 1.0.2

package/dist/index.d.ts

@@ -1,72 +1,15 @@
-import * as react from 'react';
-import * as zustand from 'zustand';
-import { Annotation } from '@useclickly/core';
-export { Annotation, AnnotationKind, AnnotationStatus, ScreenshotData } from '@useclickly/core';
-
-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:
+ * @useclickly/react — public surface
  *
- * ```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.
- */
-declare function Clickly({ className }?: ClicklyProps): react.ReactPortal | null;
-
-interface AnnotationsStore {
-    byId: Record<string, Annotation>;
-    order: string[];
-    add: (a: Annotation) => void;
-    remove: (id: string) => void;
-    update: (id: string, patch: Partial<Annotation>) => void;
-    clear: () => void;
-    /** Imperative read. Hooks should use `useAnnotationsList()` instead. */
-    list: () => Annotation[];
-}
-declare const useAnnotations: zustand.UseBoundStore<zustand.StoreApi<AnnotationsStore>>;
-/**
- * Subscribe to the annotation list with shallow equality — re-renders
- * only when items add/remove/reorder/update. Always use this from
- * component code; never call `useAnnotations(s => s.list())`, which
- * returns a new array reference on every store change and infinite-loops
- * `useSyncExternalStore`.
- */
-declare function useAnnotationsList(): Annotation[];
-
-type OutputDetail = "compact" | "standard" | "detailed" | "forensic";
-interface Settings {
-    outputDetail: OutputDetail;
-    copyOnAdd: boolean;
-    showReactComponents: boolean;
-    markerColor: string;
-}
-interface SettingsStore extends Settings {
-    set: (patch: Partial<Settings>) => void;
-    reset: () => void;
-}
-declare const DEFAULTS: Settings;
-declare const useSettings: zustand.UseBoundStore<zustand.StoreApi<SettingsStore>>;
-
-/**
- * Phase 5 placeholder formatter — Phase 9 adds the React + Source lines
- * when those fields are populated. Phase 8 replaces the whole thing with
- * a full AFS-compliant implementation.
+ * The single export is `<Clickly />`. Stores and types are also
+ * re-exported for advanced integrations.
  */
-declare function annotationsToMarkdown(annotations: Annotation[], detail?: OutputDetail): string;
-
-export { type AnnotationsStore, Clickly, type ClicklyProps, DEFAULTS as DEFAULT_SETTINGS, type OutputDetail, type Settings, type SettingsStore, annotationsToMarkdown, useAnnotations, useAnnotationsList, useSettings };
+export { Clickly } from "./Clickly";
+export type { ClicklyProps } from "./Clickly";
+export { useAnnotations, useAnnotationsList } from "./state/annotations";
+export { useSettings, DEFAULTS as DEFAULT_SETTINGS } from "./state/settings";
+export type { AnnotationsStore } from "./state/annotations";
+export type { Settings, SettingsStore, OutputDetail } from "./state/settings";
+export { annotationsToMarkdown } from "./output/markdown";
+export type { Annotation, AnnotationStatus, AnnotationKind, ScreenshotData, } from "@useclickly/core";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAG9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,cAAc,GACf,MAAM,kBAAkB,CAAC"}