@tooluminati/forms 0.1.0

package/dist/tanstack-form.js

@@ -0,0 +1,33 @@
+import { useWebMcpFormTool } from './useWebMcpFormTool';
+function flattenTanStackErrors(errors = []) {
+    return errors.map((error, index) => ({
+        path: typeof error === 'object' && error && 'path' in error
+            ? String(error.path)
+            : String(index),
+        message: typeof error === 'object' && error && 'message' in error
+            ? String(error.message)
+            : String(error),
+    }));
+}
+export function useTanStackFormWebMcpTool({ form, ...options }) {
+    useWebMcpFormTool({
+        ...options,
+        getValues: () => form.state.values,
+        setValues: (values) => {
+            for (const [field, value] of Object.entries(values)) {
+                form.setFieldValue?.(field, value);
+            }
+        },
+        getErrors: () => flattenTanStackErrors(form.state.errors),
+        getSummary: () => ({
+            submitting: form.state.isSubmitting,
+            validating: form.state.isValidating,
+            dirty: form.state.isDirty,
+        }),
+        submit: async () => {
+            await form.handleSubmit();
+            const errors = flattenTanStackErrors(form.state.errors);
+            return errors.length > 0 ? { success: false, errors } : { success: true };
+        },
+    });
+}

package/dist/types.d.ts

@@ -0,0 +1,41 @@
+import type { JsonSchema, WebMcpToolAnnotations } from '@tooluminati/core';
+export interface FormError {
+    path: string;
+    message: string;
+    kind?: string | undefined;
+}
+export interface FormDiagnosticSummary {
+    name: string;
+    submitting?: boolean | undefined;
+    validating?: boolean | undefined;
+    dirty?: boolean | undefined;
+    touched?: boolean | undefined;
+    errors: FormError[];
+    schema?: JsonSchema | undefined;
+    values?: unknown;
+}
+export type FormSubmitResult = {
+    success: true;
+    message?: string;
+    data?: unknown;
+} | {
+    success: false;
+    message?: string;
+    errors?: FormError[];
+};
+export interface WebMcpFormToolOptions<TValues> {
+    name: string;
+    description: string;
+    schema?: JsonSchema;
+    getValues: () => TValues;
+    setValues: (values: TValues) => void | Promise<void>;
+    submit: () => FormSubmitResult | Promise<FormSubmitResult>;
+    getErrors?: () => FormError[];
+    getSummary?: () => Partial<FormDiagnosticSummary>;
+    validateArgs?: ((args: unknown) => TValues) | undefined;
+    annotations?: WebMcpToolAnnotations | undefined;
+    redactValues?: ((values: TValues) => unknown) | undefined;
+    redactResult?: ((result: unknown) => unknown) | undefined;
+    includeValidationSummary?: boolean | undefined;
+}
+//# 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":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GACnD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAA;CAAE,CAAC;AAE/D,MAAM,WAAW,qBAAqB,CAAC,OAAO;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,EAAE,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC3D,SAAS,CAAC,EAAE,MAAM,SAAS,EAAE,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAClD,YAAY,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;IACxD,WAAW,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAChD,YAAY,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;IAC1D,YAAY,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;IAC1D,wBAAwB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChD"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/useWebMcpFormTool.d.ts

@@ -0,0 +1,5 @@
+import { type DependencyList } from 'react';
+import type { WebMcpFormToolOptions } from './types';
+export { createFormValidationSummaryTool } from './create-form-tools';
+export declare function useWebMcpFormTool<TValues>(options: WebMcpFormToolOptions<TValues>, deps?: DependencyList): void;
+//# sourceMappingURL=useWebMcpFormTool.d.ts.map

package/dist/useWebMcpFormTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWebMcpFormTool.d.ts","sourceRoot":"","sources":["../src/useWebMcpFormTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAKrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErD,OAAO,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AAEtE,wBAAgB,iBAAiB,CAAC,OAAO,EACvC,OAAO,EAAE,qBAAqB,CAAC,OAAO,CAAC,EACvC,IAAI,GAAE,cAAmB,GACxB,IAAI,CAmBN"}

package/dist/useWebMcpFormTool.js

@@ -0,0 +1,14 @@
+import { useMemo } from 'react';
+import { useWebMcpTools } from '@tooluminati/react';
+import { createWebMcpFormTools } from './create-form-tools';
+import { inferSchemaFromValue } from './infer-schema';
+export { createFormValidationSummaryTool } from './create-form-tools';
+export function useWebMcpFormTool(options, deps = []) {
+    const schema = useMemo(() => options.schema ?? inferSchemaFromValue(options.getValues()), [options]);
+    if (!schema) {
+        throw new Error(`Could not infer WebMCP schema for form "${options.name}". ` +
+            'Provide an explicit schema or use concrete non-null defaults.');
+    }
+    const tools = useMemo(() => createWebMcpFormTools(options), [options]);
+    useWebMcpTools(tools, deps, { source: 'form' });
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@tooluminati/forms",
+  "version": "0.1.0",
+  "description": "Form diagnostics and submission adapters for Tooluminati.",
+  "type": "module",
+  "sideEffects": false,
+  "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"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "@tooluminati/react": "0.1.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jitterbox/Tooluminati.git",
+    "directory": "packages/forms"
+  },
+  "bugs": {
+    "url": "https://github.com/jitterbox/Tooluminati/issues"
+  },
+  "homepage": "https://github.com/jitterbox/Tooluminati#readme",
+  "keywords": [
+    "tooluminati",
+    "webmcp",
+    "react",
+    "forms",
+    "react-hook-form"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs && tsc -p tsconfig.json --emitDeclarationOnly",
+    "typecheck": "tsc --noEmit"
+  }
+}