fixdog 0.0.1

package/dist/client/index.d.ts

@@ -0,0 +1,110 @@
+type ElementInfoKind = "source" | "dom";
+interface DomSnapshot {
+    outerHTML: string;
+    text: string;
+    attributes: Record<string, string>;
+}
+interface ElementInfo {
+    kind: ElementInfoKind;
+    componentName?: string;
+    filePath?: string;
+    line?: number;
+    column?: number;
+    domSnapshot?: DomSnapshot;
+    box?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+type EditorType = "vscode" | "vscode-insiders" | "cursor" | "webstorm" | "atom" | "sublime";
+interface UiDogNextOptions {
+    /**
+     * Editor to open when clicking elements
+     * @default 'cursor'
+     */
+    editor?: EditorType;
+    /**
+     * Project root path for resolving file paths
+     */
+    projectPath?: string;
+    /**
+     * Modifier key for element selection
+     * @default 'alt'
+     */
+    modifier?: "alt" | "ctrl" | "meta" | "shift";
+    /**
+     * Enable sidebar mode
+     * @default true
+     */
+    enableSidebar?: boolean;
+    /**
+     * API endpoint for edit requests
+     * @default 'https://api.ui.dog'
+     */
+    apiEndpoint?: string;
+}
+declare global {
+    interface Window {
+        __UIDOG_NEXT_INITIALIZED__?: boolean;
+        __UIDOG_SIDEBAR__?: {
+            isOpen: boolean;
+            elementInfo: ElementInfo | null;
+            editorUrl: string | null;
+        };
+    }
+}
+
+/**
+ * UiDog SDK for Next.js - Main entry point
+ *
+ * Uses Bippy to hook into React's internals for element source detection,
+ * providing a seamless developer experience for inspecting component locations.
+ */
+
+/**
+ * Initialize UiDog for Next.js
+ *
+ * This function sets up Bippy instrumentation, element detection, and the sidebar UI.
+ * It should be called early in your application's lifecycle, ideally via
+ * instrumentation-client.ts (Next.js 15.3+) or at the top of _app.tsx.
+ */
+declare function initializeUiDogNext(options?: UiDogNextOptions): void;
+
+/**
+ * Client entry point for UiDog Next.js integration
+ *
+ * This file is designed to be imported in:
+ * - Next.js 15.3+: instrumentation-client.ts at project root
+ * - Next.js 14.x / Pages Router: top of _app.tsx (must be first import)
+ *
+ * IMPORTANT: This file MUST be imported BEFORE React loads to properly
+ * install Bippy's React DevTools hook.
+ *
+ * Usage:
+ * ```typescript
+ * // instrumentation-client.ts (Next.js 15.3+)
+ * import 'uidog-sdk-next/client';
+ * ```
+ *
+ * ```typescript
+ * // pages/_app.tsx (Next.js 14.x / Pages Router)
+ * import 'uidog-sdk-next/client'; // MUST be first import
+ * import type { AppProps } from 'next/app';
+ * // ... rest of your imports
+ * ```
+ */
+
+/**
+ * Configure UiDog options before initialization
+ * Call this before auto-initialization happens (at DOMContentLoaded)
+ */
+declare function configureUiDogNext(options: UiDogNextOptions): void;
+/**
+ * Disable auto-initialization
+ * Use this if you want to manually initialize UiDog later
+ */
+declare function disableAutoInit(): void;
+
+export { UiDogNextOptions, configureUiDogNext, disableAutoInit, initializeUiDogNext };