@tooluminati/react-troubleshooting 0.1.0

package/dist/panel-visibility.d.ts

@@ -0,0 +1,8 @@
+import { type TroubleshootingPanelVisibilityController } from '@tooluminati/diagnostics';
+export declare function getPanelVisibilityController(): TroubleshootingPanelVisibilityController;
+export declare function wirePanelVisibilityController(next: TroubleshootingPanelVisibilityController): void;
+export declare function showWebMcpTroubleshootingPanel(): void;
+export declare function hideWebMcpTroubleshootingPanel(): void;
+export declare function toggleWebMcpTroubleshootingPanel(): void;
+export declare function resetPanelVisibilityController(): void;
+//# sourceMappingURL=panel-visibility.d.ts.map

package/dist/panel-visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel-visibility.d.ts","sourceRoot":"","sources":["../src/panel-visibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,wCAAwC,EAC9C,MAAM,0BAA0B,CAAC;AAIlC,wBAAgB,4BAA4B,IAAI,wCAAwC,CAKvF;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,wCAAwC,GAC7C,IAAI,CAEN;AAED,wBAAgB,8BAA8B,IAAI,IAAI,CAErD;AAED,wBAAgB,8BAA8B,IAAI,IAAI,CAErD;AAED,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD;AAED,wBAAgB,8BAA8B,IAAI,IAAI,CAErD"}

package/dist/panel-visibility.js

@@ -0,0 +1,23 @@
+import { createTroubleshootingPanelVisibilityController, } from '@tooluminati/diagnostics';
+let controller;
+export function getPanelVisibilityController() {
+    if (!controller) {
+        controller = createTroubleshootingPanelVisibilityController();
+    }
+    return controller;
+}
+export function wirePanelVisibilityController(next) {
+    controller = next;
+}
+export function showWebMcpTroubleshootingPanel() {
+    getPanelVisibilityController().show();
+}
+export function hideWebMcpTroubleshootingPanel() {
+    getPanelVisibilityController().hide();
+}
+export function toggleWebMcpTroubleshootingPanel() {
+    getPanelVisibilityController().toggle();
+}
+export function resetPanelVisibilityController() {
+    controller = undefined;
+}

package/dist/useFormSubmitBlockers.d.ts

@@ -0,0 +1,11 @@
+import type { ActionAvailabilityProvider } from '@tooluminati/diagnostics';
+import type { FormDiagnosticSummary } from '@tooluminati/forms';
+export interface FormSubmitBlockersOptions {
+    actionId: string;
+    label: string;
+    getFormSummary: () => FormDiagnosticSummary;
+    getExtraReasons?: () => string[];
+}
+export declare function createFormSubmitBlockersProvider(options: FormSubmitBlockersOptions): ActionAvailabilityProvider;
+export declare function useFormSubmitBlockers(options: FormSubmitBlockersOptions): ActionAvailabilityProvider;
+//# sourceMappingURL=useFormSubmitBlockers.d.ts.map

package/dist/useFormSubmitBlockers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormSubmitBlockers.d.ts","sourceRoot":"","sources":["../src/useFormSubmitBlockers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,0BAA0B,EAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAIhE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,qBAAqB,CAAC;IAC5C,eAAe,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;CAClC;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,yBAAyB,GACjC,0BAA0B,CA4B5B;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,yBAAyB,GACjC,0BAA0B,CAO5B"}

package/dist/useFormSubmitBlockers.js

@@ -0,0 +1,35 @@
+import { useMemo } from 'react';
+import { useWebMcpTool } from '@tooluminati/react';
+import { createActionAvailabilityTool } from '@tooluminati/diagnostics';
+export function createFormSubmitBlockersProvider(options) {
+    return {
+        getActionAvailability(actionId) {
+            if (actionId !== options.actionId) {
+                return undefined;
+            }
+            const summary = options.getFormSummary();
+            const reasons = [
+                ...summary.errors.map((e) => `${e.path}: ${e.message}`),
+                ...(options.getExtraReasons?.() ?? []),
+            ];
+            if (summary.submitting) {
+                reasons.push('Form is submitting.');
+            }
+            return {
+                actionId,
+                label: options.label,
+                available: reasons.length === 0,
+                reasons,
+            };
+        },
+        listActions() {
+            const action = createFormSubmitBlockersProvider(options).getActionAvailability(options.actionId);
+            return action ? [action] : [];
+        },
+    };
+}
+export function useFormSubmitBlockers(options) {
+    const provider = useMemo(() => createFormSubmitBlockersProvider(options), [options]);
+    useWebMcpTool(createActionAvailabilityTool(provider), [provider]);
+    return provider;
+}

package/dist/useTanStackQueryWebMcpTools.d.ts

@@ -0,0 +1,9 @@
+import { type QueryClientLike } from '@tooluminati/state';
+export interface TanStackQueryWebMcpToolsOptions {
+    allowKeys: unknown[];
+    includeDataShape?: boolean;
+    includeData?: boolean;
+    name?: string;
+}
+export declare function useTanStackQueryWebMcpTools(queryClient: QueryClientLike, options: TanStackQueryWebMcpToolsOptions): void;
+//# sourceMappingURL=useTanStackQueryWebMcpTools.d.ts.map

package/dist/useTanStackQueryWebMcpTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTanStackQueryWebMcpTools.d.ts","sourceRoot":"","sources":["../src/useTanStackQueryWebMcpTools.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,+BAA+B;IAC9C,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,eAAe,EAC5B,OAAO,EAAE,+BAA+B,GACvC,IAAI,CAmBN"}

package/dist/useTanStackQueryWebMcpTools.js

@@ -0,0 +1,16 @@
+import { useMemo } from 'react';
+import { useWebMcpTools } from '@tooluminati/react';
+import { createQueryCacheSummaryTool, } from '@tooluminati/state';
+export function useTanStackQueryWebMcpTools(queryClient, options) {
+    const { allowKeys, includeDataShape, includeData, name, } = options;
+    const tool = useMemo(() => {
+        return createQueryCacheSummaryTool({
+            queryClient,
+            allowKeys,
+            ...(includeDataShape !== undefined ? { includeDataShape } : {}),
+            ...(includeData !== undefined ? { includeData } : {}),
+            ...(name ? { name } : {}),
+        });
+    }, [queryClient, allowKeys, includeDataShape, includeData, name]);
+    useWebMcpTools([tool], [tool], { source: 'diagnostic' });
+}

package/dist/useTroubleshootingPanel.d.ts

@@ -0,0 +1,14 @@
+import { type TroubleshootingPanelSnapshot } from '@tooluminati/diagnostics';
+export declare function useTroubleshootingPanel(): {
+    snapshot: TroubleshootingPanelSnapshot;
+    panelState: import("@tooluminati/diagnostics").TroubleshootingPanelState;
+    refresh: () => void;
+    copyDiagnostics: () => string;
+};
+export declare function useTroubleshootingPanelVisibility(): {
+    visibility: import("@tooluminati/diagnostics").TroubleshootingPanelVisibilityController;
+    isPanelEnabled: boolean;
+    visible: boolean;
+    collapsed: boolean;
+};
+//# sourceMappingURL=useTroubleshootingPanel.d.ts.map

package/dist/useTroubleshootingPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTroubleshootingPanel.d.ts","sourceRoot":"","sources":["../src/useTroubleshootingPanel.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,0BAA0B,CAAC;AAGlC,wBAAgB,uBAAuB;;;;;EAkBtC;AAED,wBAAgB,iCAAiC;;;;;EAYhD"}

package/dist/useTroubleshootingPanel.js

@@ -0,0 +1,29 @@
+import { useEffect, useState } from 'react';
+import { serializeTroubleshootingDiagnostics, } from '@tooluminati/diagnostics';
+import { useWebMcpTroubleshootingContext } from './WebMcpTroubleshootingContext';
+export function useTroubleshootingPanel() {
+    const { viewModel } = useWebMcpTroubleshootingContext();
+    const [snapshot, setSnapshot] = useState(() => viewModel.refresh());
+    useEffect(() => {
+        const refresh = () => setSnapshot(viewModel.refresh());
+        refresh();
+        return viewModel.subscribe(refresh);
+    }, [viewModel]);
+    return {
+        snapshot,
+        panelState: snapshot.panelState,
+        refresh: () => setSnapshot(viewModel.refresh()),
+        copyDiagnostics: () => serializeTroubleshootingDiagnostics(snapshot),
+    };
+}
+export function useTroubleshootingPanelVisibility() {
+    const { visibility, isPanelEnabled } = useWebMcpTroubleshootingContext();
+    const [, bump] = useState(0);
+    useEffect(() => visibility.subscribe(() => bump((n) => n + 1)), [visibility]);
+    return {
+        visibility,
+        isPanelEnabled,
+        visible: visibility.visible,
+        collapsed: visibility.collapsed,
+    };
+}

package/dist/webmcp-declarative-attributes.d.ts

@@ -0,0 +1,20 @@
+import 'react';
+declare module 'react' {
+    interface FormHTMLAttributes<T> {
+        toolname?: string | undefined;
+        tooldescription?: string | undefined;
+        /** Presence attribute; set to "" when enabled. */
+        toolautosubmit?: '' | undefined;
+    }
+    interface InputHTMLAttributes<T> {
+        toolparamdescription?: string | undefined;
+    }
+    interface SelectHTMLAttributes<T> {
+        toolparamdescription?: string | undefined;
+    }
+    interface TextareaHTMLAttributes<T> {
+        toolparamdescription?: string | undefined;
+    }
+}
+export {};
+//# sourceMappingURL=webmcp-declarative-attributes.d.ts.map

package/dist/webmcp-declarative-attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webmcp-declarative-attributes.d.ts","sourceRoot":"","sources":["../src/webmcp-declarative-attributes.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,CAAC;AAEf,OAAO,QAAQ,OAAO,CAAC;IACrB,UAAU,kBAAkB,CAAC,CAAC;QAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACrC,kDAAkD;QAClD,cAAc,CAAC,EAAE,EAAE,GAAG,SAAS,CAAC;KACjC;IAED,UAAU,mBAAmB,CAAC,CAAC;QAC7B,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC3C;IAED,UAAU,oBAAoB,CAAC,CAAC;QAC9B,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC3C;IAED,UAAU,sBAAsB,CAAC,CAAC;QAChC,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC3C;CACF;AAED,OAAO,EAAE,CAAC"}

package/dist/webmcp-declarative-attributes.js

@@ -0,0 +1,2 @@
+/* eslint-disable @typescript-eslint/no-unused-vars -- merge React HTML attribute interfaces */
+import 'react';

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@tooluminati/react-troubleshooting",
+  "version": "0.1.0",
+  "description": "React troubleshooting bundle with timeline, blockers, and dev panel.",
+  "type": "module",
+  "sideEffects": [
+    "**/webmcp-declarative-attributes.*"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "dependencies": {
+    "@tooluminati/core": "0.1.0",
+    "@tooluminati/react": "0.1.0",
+    "@tooluminati/diagnostics": "0.1.0",
+    "@tooluminati/policies": "0.1.0",
+    "@tooluminati/state": "0.1.0",
+    "@tooluminati/forms": "0.1.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "@tanstack/react-query": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@tanstack/react-query": {
+      "optional": true
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jitterbox/Tooluminati.git",
+    "directory": "packages/react-troubleshooting"
+  },
+  "keywords": [
+    "tooluminati",
+    "webmcp",
+    "react",
+    "troubleshooting",
+    "diagnostics"
+  ],
+  "bugs": {
+    "url": "https://github.com/jitterbox/Tooluminati/issues"
+  },
+  "homepage": "https://github.com/jitterbox/Tooluminati#readme",
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs && tsc -p tsconfig.json --emitDeclarationOnly",
+    "typecheck": "tsc --noEmit"
+  }
+}