@frontmcp/react 0.0.1

package/state/useValtioResource.d.ts

@@ -0,0 +1,9 @@
+/**
+ * useValtioResource — thin wrapper around useStoreResource for Valtio proxies.
+ *
+ * The user must pass valtio's `subscribe` function since it's an optional peer dep.
+ * Deep path selectors use dot notation (e.g., 'user.profile.name').
+ */
+import type { ValtioResourceOptions } from './state.types';
+export declare function useValtioResource(options: ValtioResourceOptions): void;
+//# sourceMappingURL=useValtioResource.d.ts.map

package/state/useValtioResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useValtioResource.d.ts","sourceRoot":"","sources":["../../src/state/useValtioResource.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAY3D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAqCtE"}

package/types.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Core types for @frontmcp/react
+ */
+import type React from 'react';
+import type { DirectMcpServer, DirectClient, CallToolResult, ReadResourceResult } from '@frontmcp/sdk';
+import type { ComponentRegistry } from './components/ComponentRegistry';
+import type { DynamicRegistry } from './registry/DynamicRegistry';
+export interface ToolInfo {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}
+export interface ResourceInfo {
+    uri: string;
+    name?: string;
+    description?: string;
+    mimeType?: string;
+}
+export interface ResourceTemplateInfo {
+    uriTemplate: string;
+    name?: string;
+    description?: string;
+    mimeType?: string;
+}
+export interface PromptInfo {
+    name: string;
+    description?: string;
+    arguments?: Array<{
+        name: string;
+        description?: string;
+        required?: boolean;
+    }>;
+}
+export type FrontMcpStatus = 'idle' | 'connecting' | 'connected' | 'error';
+export interface FrontMcpContextValue {
+    name: string;
+    registry: ComponentRegistry;
+    dynamicRegistry: DynamicRegistry;
+    getDynamicRegistry: (server?: string) => DynamicRegistry;
+    connect: () => Promise<void>;
+}
+export interface DynamicToolDef {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    execute: (args: Record<string, unknown>) => Promise<CallToolResult>;
+}
+export interface DynamicResourceDef {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+    read: () => Promise<ReadResourceResult>;
+}
+export interface ResolvedServer {
+    name: string;
+    server: DirectMcpServer | null;
+    client: DirectClient | null;
+    status: FrontMcpStatus;
+    error: Error | null;
+    tools: ToolInfo[];
+    resources: ResourceInfo[];
+    resourceTemplates: ResourceTemplateInfo[];
+    prompts: PromptInfo[];
+    registry: ComponentRegistry;
+    connect: () => Promise<void>;
+}
+export interface ToolState<T = unknown> {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+    called: boolean;
+}
+export interface ResourceState<T = unknown> {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+}
+export interface PromptState<T = unknown> {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+}
+export interface UseCallToolOptions {
+    resetOnToolChange?: boolean;
+    onSuccess?: (data: unknown) => void;
+    onError?: (error: Error) => void;
+    /** Target a specific named server from the ServerRegistry */
+    server?: string;
+}
+export type UseCallToolReturn<TInput extends object, TOutput> = [
+    (args: TInput) => Promise<TOutput | null>,
+    ToolState<TOutput>,
+    () => void
+];
+export interface ComponentNode {
+    type: string;
+    props?: Record<string, unknown>;
+    children?: string | ComponentNode | ComponentNode[];
+}
+export interface FieldRenderProps {
+    name: string;
+    type: string;
+    required: boolean;
+    description?: string;
+    enumValues?: string[];
+    value: string;
+    onChange: (value: string) => void;
+}
+export interface StoreAdapter {
+    /** Logical name for this store (e.g., 'redux', 'valtio'). */
+    name: string;
+    /** Returns the current state snapshot. */
+    getState: () => unknown;
+    /** Subscribes to state changes. Returns an unsubscribe function. */
+    subscribe: (cb: () => void) => () => void;
+    /** Named selectors — each becomes a sub-resource state://{name}/{key}. */
+    selectors?: Record<string, (state: unknown) => unknown>;
+    /** Named actions — each becomes a dynamic tool {name}_{key}. */
+    actions?: Record<string, (...args: unknown[]) => unknown>;
+}
+export interface McpColumnDef<T = unknown> {
+    key: string;
+    header: string;
+    render?: (value: T) => React.ReactNode;
+}
+//# sourceMappingURL=types.d.ts.map

package/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/utils/index.d.ts

@@ -0,0 +1,2 @@
+export { zodToJsonSchema } from './zodToJsonSchema';
+//# sourceMappingURL=index.d.ts.map

package/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/utils/zodToJsonSchema.d.ts

@@ -0,0 +1,9 @@
+/**
+ * zodToJsonSchema — thin centralized wrapper around zod/v4's toJSONSchema.
+ *
+ * Keeps the zod dependency isolated so the rest of the React SDK only
+ * deals with plain JSON Schema objects.
+ */
+import type { z } from 'zod';
+export declare function zodToJsonSchema(schema: z.ZodType): Record<string, unknown>;
+//# sourceMappingURL=zodToJsonSchema.d.ts.map

package/utils/zodToJsonSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zodToJsonSchema.d.ts","sourceRoot":"","sources":["../../src/utils/zodToJsonSchema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE1E"}