@cpreston321/reactools-sdk 0.1.2

package/README.md

@@ -0,0 +1,117 @@
+# @cpreston321/reactools-sdk
+
+SDK for creating custom tabs and plugins for Reactools DevTools.
+
+## Installation
+
+```bash
+npm install @cpreston321/reactools-sdk
+```
+
+## Creating Custom Tabs
+
+### Using `registerTab`
+
+```tsx
+import { registerTab } from '@cpreston321/reactools-sdk';
+import { Database } from 'lucide-react';
+
+const { unregister } = registerTab({
+  id: 'my-custom-tab',
+  title: 'My Tab',
+  icon: Database,
+  category: 'app',
+  view: {
+    type: 'component',
+    component: MyTabContent,
+  },
+});
+
+// Later: unregister()
+```
+
+### Using the Hook
+
+```tsx
+import { useRegisterTab } from '@cpreston321/reactools-sdk';
+
+function MyComponent() {
+  useRegisterTab({
+    id: 'my-tab',
+    title: 'My Tab',
+    icon: 'Code',
+    view: {
+      type: 'component',
+      component: MyTabContent,
+    },
+  });
+
+  return <div>...</div>;
+}
+```
+
+## Creating Plugins
+
+```tsx
+import { createPlugin } from '@cpreston321/reactools-sdk';
+
+const myPlugin = createPlugin({
+  id: 'my-plugin',
+  name: 'My Plugin',
+  version: '1.0.0',
+  tabs: [
+    {
+      id: 'overview',
+      title: 'Overview',
+      icon: 'LayoutDashboard',
+      view: { type: 'component', component: OverviewTab },
+    },
+  ],
+  setup: (ctx) => {
+    ctx.on('panel:open', () => console.log('Panel opened!'));
+  },
+});
+```
+
+## API Reference
+
+### Types
+
+```typescript
+interface TabDefinition {
+  id: string;
+  title: string;
+  icon: string | ComponentType<{ className?: string }>;
+  category?: 'pinned' | 'app' | 'modules' | 'custom';
+  order?: number;
+  badge?: number | string | (() => number | string | null);
+  show?: () => boolean;
+  view: TabViewType;
+}
+
+type TabViewType =
+  | { type: 'component'; component: ComponentType }
+  | { type: 'iframe'; src: string; permissions?: string[] }
+  | { type: 'launch'; label: string; action: () => void };
+```
+
+### Hooks
+
+```typescript
+import { useDevTools, useRegisterTab } from '@cpreston321/reactools-sdk';
+
+const { tabs, tabsByCategory, context } = useDevTools();
+```
+
+### Events
+
+```typescript
+import { tabRegistry } from '@cpreston321/reactools-sdk';
+
+tabRegistry.on('panel:open', () => {});
+tabRegistry.on('panel:close', () => {});
+tabRegistry.on('tab:change', ({ tabId }) => {});
+tabRegistry.on('position:change', ({ position }) => {});
+```
+
+See the [main documentation](https://github.com/your-username/reactools) for full details.

package/dist/api/createPlugin.d.ts

@@ -0,0 +1,41 @@
+import { PluginDefinition, RegisterDefinition } from '../types';
+/**
+ * Create and register a Reactools plugin
+ *
+ * Plugins allow you to bundle multiple tabs and setup logic together.
+ *
+ * @example
+ * ```tsx
+ * import { createPlugin } from '@cpreston321/reactools-sdk';
+ *
+ * const plugin = createPlugin({
+ *   id: 'my-plugin',
+ *   name: 'My Plugin',
+ *   version: '1.0.0',
+ *   tabs: [
+ *     {
+ *       id: 'overview',
+ *       title: 'Overview',
+ *       icon: 'LayoutDashboard',
+ *       view: { type: 'component', component: OverviewTab },
+ *     },
+ *     {
+ *       id: 'settings',
+ *       title: 'Settings',
+ *       icon: 'Settings',
+ *       view: { type: 'component', component: SettingsTab },
+ *     },
+ *   ],
+ *   setup: (ctx) => {
+ *     ctx.on('panel:open', () => console.log('Panel opened!'));
+ *   },
+ * });
+ *
+ * // Later: plugin.unregister();
+ * ```
+ *
+ * @param plugin - Plugin definition object
+ * @returns Function to unregister the plugin and all its tabs
+ */
+export declare function createPlugin(plugin: PluginDefinition): RegisterDefinition;
+//# sourceMappingURL=createPlugin.d.ts.map

package/dist/api/createPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPlugin.d.ts","sourceRoot":"","sources":["../../src/api/createPlugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,kBAAkB,CAEzE"}

package/dist/api/registerTab.d.ts

@@ -0,0 +1,26 @@
+import { RegisterDefinition, TabDefinition } from '../types';
+/**
+ * Register a custom tab in the Reactools panel
+ *
+ * @example
+ * ```tsx
+ * import { registerTab } from '@cpreston321/reactools-sdk';
+ *
+ * const tab = registerTab({
+ *   id: 'my-custom-tab',
+ *   title: 'My Tab',
+ *   icon: 'Settings',
+ *   view: {
+ *     type: 'component',
+ *     component: MyTabContent,
+ *   },
+ * });
+ *
+ * // Later: tab.unregister();
+ * ```
+ *
+ * @param tab - Tab definition object
+ * @returns Function to unregister the tab
+ */
+export declare function registerTab(tab: TabDefinition): RegisterDefinition;
+//# sourceMappingURL=registerTab.d.ts.map

package/dist/api/registerTab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerTab.d.ts","sourceRoot":"","sources":["../../src/api/registerTab.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,kBAAkB,CAElE"}

package/dist/hooks/useDevTools.d.ts

@@ -0,0 +1,28 @@
+import { DevToolsContext, RegisterDefinition, TabDefinition } from '../types';
+export interface UseDevToolsReturn {
+    /** All registered tabs */
+    tabs: TabDefinition[];
+    /** Tabs grouped by category */
+    tabsByCategory: Record<string, TabDefinition[]>;
+    /** Register a new tab */
+    registerTab: (tab: TabDefinition) => RegisterDefinition;
+    /** Current devtools context */
+    context: DevToolsContext;
+}
+/**
+ * Hook to access the devtools state and register tabs
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { tabs, context, registerTab } = useDevTools();
+ *
+ *   console.log('Panel is open:', context.isOpen);
+ *   console.log('Active tab:', context.activeTabId);
+ *
+ *   return <div>...</div>;
+ * }
+ * ```
+ */
+export declare function useDevTools(): UseDevToolsReturn;
+//# sourceMappingURL=useDevTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDevTools.d.ts","sourceRoot":"","sources":["../../src/hooks/useDevTools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,aAAa,EACd,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,+BAA+B;IAC/B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;IAChD,yBAAyB;IACzB,WAAW,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,kBAAkB,CAAC;IACxD,+BAA+B;IAC/B,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,IAAI,iBAAiB,CA6B/C"}

package/dist/hooks/useRegisterTab.d.ts

@@ -0,0 +1,22 @@
+import { TabDefinition } from '../types';
+/**
+ * Hook to register a tab that auto-unregisters on unmount
+ *
+ * @example
+ * ```tsx
+ * function MyFeature() {
+ *   useRegisterTab({
+ *     id: 'my-feature-tab',
+ *     title: 'My Feature',
+ *     icon: 'Sparkles',
+ *     view: { type: 'component', component: MyFeaturePanel },
+ *   });
+ *
+ *   return <div>Feature content...</div>;
+ * }
+ * ```
+ *
+ * @param tab - Tab definition object
+ */
+export declare function useRegisterTab(tab: TabDefinition): void;
+//# sourceMappingURL=useRegisterTab.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useRegisterTab.d.ts","sourceRoot":"","sources":["../../src/hooks/useRegisterTab.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAiBvD"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { tabRegistry } from './registry';
+export type { DevToolsContext, DevToolsEvents, PanelPosition, PluginContext, PluginDefinition, TabCategory, TabDefinition, TabViewType, UnregisterFn, } from './types';
+export { registerTab } from './api/registerTab';
+export { createPlugin } from './api/createPlugin';
+export { useDevTools } from './hooks/useDevTools';
+export { useRegisterTab } from './hooks/useRegisterTab';
+//# 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":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,YAAY,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,WAAW,EACX,YAAY,GACb,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,198 @@
+var h = Object.defineProperty;
+var b = (i, t, e) => t in i ? h(i, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : i[t] = e;
+var o = (i, t, e) => b(i, typeof t != "symbol" ? t + "" : t, e);
+import { useSyncExternalStore as a, useCallback as u, useRef as d, useEffect as g } from "react";
+class l {
+  constructor() {
+    o(this, "tabs", /* @__PURE__ */ new Map());
+    o(this, "plugins", /* @__PURE__ */ new Map());
+    o(this, "listeners", /* @__PURE__ */ new Set());
+    o(this, "eventHandlers", /* @__PURE__ */ new Map());
+    // State that gets connected to the panel store
+    o(this, "_isOpen", !1);
+    o(this, "_position", "bottom");
+    o(this, "_activeTabId", null);
+    // Cached snapshots for useSyncExternalStore (must return same reference if unchanged)
+    o(this, "_cachedTabs", []);
+    o(this, "_cachedTabsByCategory", {});
+    o(this, "_cachedContext", {
+      isOpen: !1,
+      position: "bottom",
+      activeTabId: null
+    });
+  }
+  /**
+   * Register a new tab
+   * @returns Unregister function to remove the tab
+   */
+  registerTab(t) {
+    return this.tabs.has(t.id) && console.warn(
+      `[reactools] Tab with id "${t.id}" already exists. Overwriting.`
+    ), this.tabs.set(t.id, {
+      category: "custom",
+      order: 100,
+      ...t
+    }), this.notify(), {
+      tab: t,
+      unregister: () => {
+        this.tabs.delete(t.id), this.notify();
+      }
+    };
+  }
+  /**
+   * Register a plugin with multiple tabs
+   * @returns Unregister function to remove the plugin and its tabs
+   */
+  registerPlugin(t) {
+    var s;
+    this.plugins.set(t.id, t);
+    const e = ((s = t.tabs) == null ? void 0 : s.map(
+      (n) => this.registerTab({ ...n, id: `${t.id}:${n.id}` })
+    )) ?? [];
+    if (t.setup) {
+      const n = this.createPluginContext(t.id);
+      Promise.resolve(t.setup(n)).catch((c) => {
+        console.error(`[reactools] Plugin "${t.id}" setup failed:`, c);
+      });
+    }
+    return {
+      plugin: t,
+      unregister: () => {
+        for (const n of e)
+          n.unregister();
+        this.plugins.delete(t.id), this.notify();
+      }
+    };
+  }
+  /**
+   * Get all registered tabs, filtered by visibility
+   * Returns cached array for useSyncExternalStore stability
+   */
+  getTabs() {
+    return this._cachedTabs;
+  }
+  /**
+   * Get tabs grouped by category
+   * Returns cached object for useSyncExternalStore stability
+   */
+  getTabsByCategory() {
+    return this._cachedTabsByCategory;
+  }
+  /**
+   * Get a tab by ID (including hidden tabs)
+   */
+  getTabById(t) {
+    return this.tabs.get(t);
+  }
+  /**
+   * Rebuild cached tabs (called on changes)
+   */
+  rebuildCache() {
+    this._cachedTabs = Array.from(this.tabs.values()).filter((t) => !t.show || t.show()).sort((t, e) => (t.order ?? 100) - (e.order ?? 100)), this._cachedTabsByCategory = this._cachedTabs.reduce(
+      (t, e) => {
+        const s = e.category ?? "custom";
+        return t[s] || (t[s] = []), t[s].push(e), t;
+      },
+      {}
+    );
+  }
+  /**
+   * Subscribe to registry changes
+   */
+  subscribe(t) {
+    return this.listeners.add(t), () => this.listeners.delete(t);
+  }
+  /**
+   * Subscribe to a specific event
+   */
+  on(t, e) {
+    return this.eventHandlers.has(t) || this.eventHandlers.set(t, /* @__PURE__ */ new Set()), this.eventHandlers.get(t).add(e), () => {
+      var s;
+      return (s = this.eventHandlers.get(t)) == null ? void 0 : s.delete(e);
+    };
+  }
+  /**
+   * Emit an event to all subscribers
+   */
+  emit(t, e) {
+    const s = this.eventHandlers.get(t);
+    if (s)
+      for (const n of s)
+        n(e);
+  }
+  /**
+   * Get the current devtools context
+   * Returns cached object for useSyncExternalStore stability
+   */
+  getContext() {
+    return this._cachedContext;
+  }
+  /**
+   * Update the context (called by the panel store)
+   */
+  setContext(t) {
+    const e = this._isOpen, s = this._position, n = this._activeTabId;
+    t.isOpen !== void 0 && (this._isOpen = t.isOpen), t.position !== void 0 && (this._position = t.position), t.activeTabId !== void 0 && (this._activeTabId = t.activeTabId), (e !== this._isOpen || s !== this._position || n !== this._activeTabId) && (this._cachedContext = {
+      isOpen: this._isOpen,
+      position: this._position,
+      activeTabId: this._activeTabId
+    }), e !== this._isOpen && this.emit(this._isOpen ? "panel:open" : "panel:close", void 0), s !== this._position && this.emit("position:change", { position: this._position }), n !== this._activeTabId && this._activeTabId && this.emit("tab:change", { tabId: this._activeTabId });
+  }
+  notify() {
+    this.rebuildCache();
+    for (const t of this.listeners)
+      t();
+  }
+  createPluginContext(t) {
+    return {
+      registerTab: (e) => this.registerTab({ ...e, id: `${t}:${e.id}` }),
+      getContext: () => this.getContext(),
+      on: (e, s) => this.on(e, s)
+    };
+  }
+}
+const r = new l();
+function f(i) {
+  return r.registerTab(i);
+}
+function _(i) {
+  return r.registerPlugin(i);
+}
+function y() {
+  const i = a(
+    r.subscribe.bind(r),
+    r.getTabs.bind(r),
+    r.getTabs.bind(r)
+  ), t = a(
+    r.subscribe.bind(r),
+    r.getTabsByCategory.bind(r),
+    r.getTabsByCategory.bind(r)
+  ), e = a(
+    r.subscribe.bind(r),
+    r.getContext.bind(r),
+    r.getContext.bind(r)
+  ), s = u((n) => r.registerTab(n), []);
+  return {
+    tabs: i,
+    tabsByCategory: t,
+    registerTab: s,
+    context: e
+  };
+}
+function v(i) {
+  const t = d(null), e = d(i.id);
+  g(() => {
+    var s;
+    return e.current !== i.id && ((s = t.current) == null || s.call(t), e.current = i.id), t.current = r.registerTab(i).unregister, () => {
+      var n;
+      (n = t.current) == null || n.call(t);
+    };
+  }, [i.id, i.title, i.icon, i.category, i.order]);
+}
+export {
+  _ as createPlugin,
+  f as registerTab,
+  r as tabRegistry,
+  y as useDevTools,
+  v as useRegisterTab
+};

package/dist/registry.d.ts

@@ -0,0 +1,79 @@
+import { DevToolsContext, DevToolsEvents, PluginDefinition, TabDefinition } from './types';
+type EventHandler<T> = (payload: T) => void;
+/**
+ * Central registry for tabs and plugins
+ * This is a singleton that manages all tab registrations and plugin lifecycle
+ */
+declare class TabRegistry {
+    private tabs;
+    private plugins;
+    private listeners;
+    private eventHandlers;
+    private _isOpen;
+    private _position;
+    private _activeTabId;
+    private _cachedTabs;
+    private _cachedTabsByCategory;
+    private _cachedContext;
+    /**
+     * Register a new tab
+     * @returns Unregister function to remove the tab
+     */
+    registerTab(tab: TabDefinition): {
+        tab: TabDefinition;
+        unregister: () => void;
+    };
+    /**
+     * Register a plugin with multiple tabs
+     * @returns Unregister function to remove the plugin and its tabs
+     */
+    registerPlugin(plugin: PluginDefinition): {
+        plugin: PluginDefinition;
+        unregister: () => void;
+    };
+    /**
+     * Get all registered tabs, filtered by visibility
+     * Returns cached array for useSyncExternalStore stability
+     */
+    getTabs(): TabDefinition[];
+    /**
+     * Get tabs grouped by category
+     * Returns cached object for useSyncExternalStore stability
+     */
+    getTabsByCategory(): Record<string, TabDefinition[]>;
+    /**
+     * Get a tab by ID (including hidden tabs)
+     */
+    getTabById(id: string): TabDefinition | undefined;
+    /**
+     * Rebuild cached tabs (called on changes)
+     */
+    private rebuildCache;
+    /**
+     * Subscribe to registry changes
+     */
+    subscribe(listener: () => void): () => void;
+    /**
+     * Subscribe to a specific event
+     */
+    on<T extends keyof DevToolsEvents>(event: T, handler: EventHandler<DevToolsEvents[T]>): () => void;
+    /**
+     * Emit an event to all subscribers
+     */
+    emit<T extends keyof DevToolsEvents>(event: T, payload: DevToolsEvents[T]): void;
+    /**
+     * Get the current devtools context
+     * Returns cached object for useSyncExternalStore stability
+     */
+    getContext(): DevToolsContext;
+    /**
+     * Update the context (called by the panel store)
+     */
+    setContext(context: Partial<DevToolsContext>): void;
+    private notify;
+    private createPluginContext;
+}
+/** Singleton instance of the tab registry */
+export declare const tabRegistry: TabRegistry;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EAGd,gBAAgB,EAChB,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;AAE5C;;;GAGG;AACH,cAAM,WAAW;IACf,OAAO,CAAC,IAAI,CAAoC;IAChD,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,aAAa,CAAiD;IAGtE,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,YAAY,CAAuB;IAG3C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,qBAAqB,CAAuC;IACpE,OAAO,CAAC,cAAc,CAIpB;IAEF;;;OAGG;IACH,WAAW,CAAC,GAAG,EAAE,aAAa;;;;IAuB9B;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,gBAAgB;;;;IA6BvC;;;OAGG;IACH,OAAO,IAAI,aAAa,EAAE;IAI1B;;;OAGG;IACH,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;IAIpD;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIjD;;OAEG;IACH,OAAO,CAAC,YAAY;IAgBpB;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAK3C;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,cAAc,EAC/B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GACvC,MAAM,IAAI;IASb;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,cAAc,EACjC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACzB,IAAI;IASP;;;OAGG;IACH,UAAU,IAAI,eAAe;IAI7B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAmCnD,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,mBAAmB;CAQ5B;AAED,6CAA6C;AAC7C,eAAO,MAAM,WAAW,aAAoB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,114 @@
+import { ComponentType } from 'react';
+/** Tab categories for organizing tabs in the sidebar */
+export type TabCategory = "pinned" | "app" | "modules" | "custom";
+/** View types for rendering tab content */
+export type TabViewType = {
+    type: "component";
+    component: ComponentType;
+} | {
+    type: "iframe";
+    src: string;
+    permissions?: string[];
+} | {
+    type: "launch";
+    label: string;
+    action: () => void | Promise<void>;
+};
+/** Definition for a tab in the devtools panel */
+export interface TabDefinition {
+    /** Unique identifier for the tab */
+    id: string;
+    /** Display name shown in tab bar */
+    title: string;
+    /** Icon - accepts Lucide icon name or React component */
+    icon: string | ComponentType<{
+        className?: string;
+    }>;
+    /** Category for grouping tabs (default: 'custom') */
+    category?: TabCategory;
+    /** View configuration */
+    view: TabViewType;
+    /** Order priority within category (lower = higher priority, default: 100) */
+    order?: number;
+    /** Show badge with count or indicator */
+    badge?: number | string | (() => number | string | null);
+    /** Conditional rendering - return false to hide tab */
+    show?: () => boolean;
+}
+export type RegisterDefinition = {
+    plugin: PluginDefinition;
+    unregister: UnregisterFn;
+} | {
+    tab: TabDefinition;
+    unregister: UnregisterFn;
+};
+/** Context provided to plugin setup functions */
+export interface PluginContext {
+    /** Register a new tab */
+    registerTab: (tab: TabDefinition) => RegisterDefinition;
+    /** Get the current devtools context */
+    getContext: () => DevToolsContext;
+    /** Subscribe to devtools events */
+    on: <T extends keyof DevToolsEvents>(event: T, handler: (payload: DevToolsEvents[T]) => void) => () => void;
+}
+/** Definition for a devtools plugin */
+export interface PluginDefinition {
+    /** Unique plugin identifier */
+    id: string;
+    /** Plugin display name */
+    name: string;
+    /** Plugin version */
+    version: string;
+    /** Tabs contributed by this plugin */
+    tabs?: TabDefinition[];
+    /** Setup function called when plugin is registered */
+    setup?: (context: PluginContext) => void | Promise<void>;
+}
+/** Current devtools context/state */
+export interface DevToolsContext {
+    /** Whether the panel is currently open */
+    isOpen: boolean;
+    /** Current panel position */
+    position: PanelPosition;
+    /** Currently active tab ID */
+    activeTabId: string | null;
+}
+/** Panel position options */
+export type PanelPosition = "top" | "bottom" | "left" | "right" | "floating";
+/** Events emitted by the devtools panel */
+export interface DevToolsEvents {
+    "panel:open": undefined;
+    "panel:close": undefined;
+    "tab:change": {
+        tabId: string;
+    };
+    "position:change": {
+        position: PanelPosition;
+    };
+}
+/**
+ * Unregister function returned by registerTab(), createPlugin(), or integration setup functions.
+ * Pass these to the integrations array in ReactoolsProvider.
+ *
+ * @example
+ * ```tsx
+ * import { setupReactQueryIntegration } from '@cpreston321/reactools-integrations/react-query';
+ * import { registerTab, createPlugin } from '@cpreston321/reactools-sdk';
+ *
+ * <ReactoolsProvider config={{
+ *   integrations: [
+ *     // Integration setup functions (called)
+ *     setupReactQueryIntegration(),
+ *     setupReactRouterIntegration(),
+ *
+ *     // Direct tab registration
+ *     registerTab({ id: 'my-tab', title: 'My Tab', icon: 'Code', view: { type: 'component', component: MyTab } }),
+ *
+ *     // Direct plugin registration
+ *     createPlugin({ id: 'my-plugin', name: 'My Plugin', version: '1.0.0', tabs: [...] }),
+ *   ]
+ * }}>
+ * ```
+ */
+export type UnregisterFn = () => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@cpreston321/reactools-sdk",
+  "version": "0.1.2",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.12",
+    "react": "^18.3.1",
+    "vite": "^6.0.3",
+    "vite-plugin-dts": "^4.3.0"
+  },
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "vite build",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}