@flightdev/forms 0.0.2

package/dist/index.d.ts

@@ -0,0 +1,181 @@
+/**
+ * @flightdev/forms - Agnostic Full-Stack Form Handling
+ *
+ * Flight provides form primitives, you choose the validator.
+ *
+ * @example
+ * ```typescript
+ * import { createForm } from '@flightdev/forms';
+ * import { zod } from '@flightdev/forms/zod';
+ * import { z } from 'zod';
+ *
+ * const contactForm = createForm({
+ *   validator: zod(z.object({
+ *     email: z.string().email(),
+ *     message: z.string().min(10),
+ *   })),
+ *   action: async (data) => {
+ *     await sendEmail(data.email, data.message);
+ *     return { success: true };
+ *   },
+ * });
+ * ```
+ */
+/** Validation error for a single field */
+interface FieldError {
+    /** Field path (e.g., 'email', 'address.street') */
+    path: string;
+    /** Error message */
+    message: string;
+    /** Error code (e.g., 'invalid_type', 'too_small') */
+    code?: string;
+}
+/** Result of validation */
+interface ValidationResult<T> {
+    /** Whether validation passed */
+    success: boolean;
+    /** Validated and transformed data (if success) */
+    data?: T;
+    /** Validation errors (if not success) */
+    errors?: FieldError[];
+}
+/** Form submission result */
+interface FormResult<T = unknown> {
+    /** Whether the action succeeded */
+    success: boolean;
+    /** Returned data from the action */
+    data?: T;
+    /** Error message if failed */
+    error?: string;
+    /** Field-specific errors */
+    fieldErrors?: FieldError[];
+}
+/** Form state during submission */
+interface FormState<T = unknown> {
+    /** Whether form is currently submitting */
+    pending: boolean;
+    /** Last submission result */
+    result?: FormResult<T>;
+    /** Current form data */
+    data?: Partial<T>;
+    /** Current validation errors */
+    errors: Record<string, string>;
+    /** Fields that have been touched */
+    touched: Set<string>;
+    /** Whether form has been modified */
+    dirty: boolean;
+}
+/**
+ * Validation Adapter Interface
+ *
+ * Implement this to create a custom validator adapter.
+ * Flight provides Zod, Yup, and Valibot adapters.
+ */
+interface ValidationAdapter<TInput = unknown, TOutput = TInput> {
+    /** Adapter name for debugging */
+    readonly name: string;
+    /**
+     * Validate input data
+     *
+     * @param data - Raw input data to validate
+     * @returns Validation result with either typed data or errors
+     */
+    validate(data: unknown): ValidationResult<TOutput>;
+    /**
+     * Async validate (for schemas with async refinements)
+     */
+    validateAsync(data: unknown): Promise<ValidationResult<TOutput>>;
+    /**
+     * Get the inferred output type (for TypeScript)
+     * This is used for type inference only.
+     */
+    readonly _output: TOutput;
+}
+/** Validation adapter factory type */
+type ValidationAdapterFactory<TSchema, TOutput> = (schema: TSchema) => ValidationAdapter<unknown, TOutput>;
+/** Form action function type */
+type FormAction<TInput, TResult = unknown> = (data: TInput, context?: FormActionContext) => Promise<FormResult<TResult>>;
+/** Context passed to form actions */
+interface FormActionContext {
+    /** Original request (server-side) */
+    request?: Request;
+    /** Form data (for file uploads) */
+    formData?: FormData;
+}
+/** Form definition options */
+interface FormOptions<TValidator extends ValidationAdapter<unknown, unknown>, TResult = unknown> {
+    /** Validation adapter with schema */
+    validator: TValidator;
+    /** Server action to execute on submit */
+    action: FormAction<TValidator['_output'], TResult>;
+    /** Enable CSRF protection */
+    csrf?: boolean;
+    /** Form ID (for multiple forms on same page) */
+    id?: string;
+    /** Redirect URL on success */
+    redirectOnSuccess?: string;
+    /** Enable progressive enhancement */
+    progressive?: boolean;
+}
+/** Form instance */
+interface FormDefinition<TInput, TResult = unknown> {
+    /** Form ID */
+    readonly id: string;
+    /** Validate data */
+    validate(data: unknown): ValidationResult<TInput>;
+    /** Validate data async */
+    validateAsync(data: unknown): Promise<ValidationResult<TInput>>;
+    /** Execute the form action (server-side) */
+    execute(data: unknown, context?: FormActionContext): Promise<FormResult<TResult>>;
+    /** Parse FormData to object */
+    parseFormData(formData: FormData): Record<string, unknown>;
+    /** Handle form submission (server-side) */
+    handleSubmit(request: Request): Promise<FormResult<TResult>>;
+}
+/**
+ * Create a form definition
+ *
+ * @example
+ * ```typescript
+ * import { createForm } from '@flightdev/forms';
+ * import { zod } from '@flightdev/forms/zod';
+ * import { z } from 'zod';
+ *
+ * const loginForm = createForm({
+ *   validator: zod(z.object({
+ *     email: z.string().email(),
+ *     password: z.string().min(8),
+ *   })),
+ *   action: async (data) => {
+ *     const user = await authenticate(data.email, data.password);
+ *     if (user) {
+ *       return { success: true, data: { userId: user.id } };
+ *     }
+ *     return {
+ *       success: false,
+ *       error: 'Invalid credentials',
+ *       fieldErrors: [{ path: 'email', message: 'Invalid email or password' }],
+ *     };
+ *   },
+ * });
+ * ```
+ */
+declare function createForm<TValidator extends ValidationAdapter<unknown, unknown>, TResult = unknown>(options: FormOptions<TValidator, TResult>): FormDefinition<TValidator['_output'], TResult>;
+/**
+ * Create initial form state
+ */
+declare function createFormState<T>(): FormState<T>;
+/**
+ * Convert field errors array to errors object
+ */
+declare function errorsToObject(errors: FieldError[]): Record<string, string>;
+/**
+ * Get error for a specific field
+ */
+declare function getFieldError(errors: FieldError[], path: string): string | undefined;
+/**
+ * Check if form has any errors
+ */
+declare function hasErrors(state: FormState<unknown>): boolean;
+
+export { type FieldError, type FormAction, type FormActionContext, type FormDefinition, type FormOptions, type FormResult, type FormState, type ValidationAdapter, type ValidationAdapterFactory, type ValidationResult, createForm, createFormState, errorsToObject, getFieldError, hasErrors };

package/dist/index.js

@@ -0,0 +1,4 @@
+export { createForm, createFormState, errorsToObject, getFieldError, hasErrors } from './chunk-5LLYBEXV.js';
+import './chunk-DGUM43GV.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "@flightdev/forms",
+  "version": "0.0.2",
+  "description": "Agnostic full-stack form handling for Flight Framework. Choose your validator: Zod, Yup, Valibot, or custom.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./zod": {
+      "types": "./dist/adapters/zod.d.ts",
+      "import": "./dist/adapters/zod.js"
+    },
+    "./yup": {
+      "types": "./dist/adapters/yup.d.ts",
+      "import": "./dist/adapters/yup.js"
+    },
+    "./valibot": {
+      "types": "./dist/adapters/valibot.d.ts",
+      "import": "./dist/adapters/valibot.js"
+    },
+    "./react": {
+      "types": "./dist/frameworks/react.d.ts",
+      "import": "./dist/frameworks/react.js"
+    },
+    "./vue": {
+      "types": "./dist/frameworks/vue.d.ts",
+      "import": "./dist/frameworks/vue.js"
+    },
+    "./svelte": {
+      "types": "./dist/frameworks/svelte.d.ts",
+      "import": "./dist/frameworks/svelte.js"
+    },
+    "./solid": {
+      "types": "./dist/frameworks/solid.d.ts",
+      "import": "./dist/frameworks/solid.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {},
+  "peerDependencies": {
+    "zod": ">=3.0.0",
+    "yup": ">=1.0.0",
+    "valibot": ">=0.30.0",
+    "react": ">=18.0.0",
+    "vue": ">=3.0.0",
+    "svelte": ">=4.0.0",
+    "solid-js": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "zod": {
+      "optional": true
+    },
+    "yup": {
+      "optional": true
+    },
+    "valibot": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    },
+    "svelte": {
+      "optional": true
+    },
+    "solid-js": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.0.0"
+  },
+  "keywords": [
+    "flight",
+    "forms",
+    "validation",
+    "zod",
+    "yup",
+    "valibot",
+    "progressive-enhancement"
+  ],
+  "author": "Flight Contributors",
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}