@obinexusltd/obix-sdk-forms 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * OBIX Forms - Validation, autocomplete, progressive enhancement
+ * Comprehensive form management with advanced validation
+ */
+export interface ValidationRule {
+    name: string;
+    validate: (value: unknown) => boolean | Promise<boolean>;
+    message: string;
+}
+export type AutocompleteType = "off" | "on" | "name" | "email" | "tel" | "url" | "street-address" | "postal-code" | "cc-name" | "cc-number" | "cc-exp" | "cc-csc";
+export interface FieldDefinition {
+    name: string;
+    type: string;
+    required: boolean;
+    validationRules: ValidationRule[];
+    autocomplete?: AutocompleteType;
+    initialValue?: unknown;
+    metadata?: Record<string, unknown>;
+}
+export interface ProgressiveEnhancement {
+    noJsBaseline: boolean;
+    gracefulDegradation: boolean;
+    lazyValidation: boolean;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: Record<string, string[]>;
+    warnings?: Record<string, string[]>;
+}
+export interface FormConfig {
+    fields: FieldDefinition[];
+    progressiveEnhancement?: ProgressiveEnhancement;
+    submitHandler?: (data: Record<string, unknown>) => Promise<void>;
+}
+export type ValidationTiming = "onChange" | "onBlur" | "onSubmit";
+export interface FormEngine {
+    validate(data: Record<string, unknown>): Promise<ValidationResult>;
+    getField(name: string): FieldDefinition | undefined;
+    submit(data: Record<string, unknown>): Promise<void>;
+    enableAutocomplete(fieldName: string, type: AutocompleteType): void;
+    setValidationTiming(timing: ValidationTiming): void;
+    getValidationTiming(): ValidationTiming;
+    shouldValidateOn(event: "change" | "blur" | "submit"): boolean;
+}
+export declare function createFormEngine(config: FormConfig): FormEngine;
+//# 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":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,gBAAgB,GACxB,KAAK,GACL,IAAI,GACJ,MAAM,GACN,OAAO,GACP,KAAK,GACL,KAAK,GACL,gBAAgB,GAChB,aAAa,GACb,SAAS,GACT,WAAW,GACX,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,OAAO,CAAC;IACtB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AAED,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAElE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IACpD,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACpE,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACpD,mBAAmB,IAAI,gBAAgB,CAAC;IACxC,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;CAChE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAuE/D"}

package/dist/index.js

@@ -0,0 +1,67 @@
+/**
+ * OBIX Forms - Validation, autocomplete, progressive enhancement
+ * Comprehensive form management with advanced validation
+ */
+export function createFormEngine(config) {
+    const fields = new Map(config.fields.map((field) => [field.name, { ...field }]));
+    let validationTiming = "onSubmit";
+    return {
+        async validate(data) {
+            const errors = {};
+            const warnings = {};
+            for (const field of fields.values()) {
+                const value = data[field.name];
+                if (field.required && (value === undefined || value === null || value === "")) {
+                    errors[field.name] = [...(errors[field.name] ?? []), "This field is required."];
+                }
+                for (const rule of field.validationRules) {
+                    const isValid = await rule.validate(value);
+                    if (!isValid) {
+                        errors[field.name] = [...(errors[field.name] ?? []), rule.message];
+                    }
+                }
+                if (field.required && !field.autocomplete) {
+                    warnings[field.name] = [...(warnings[field.name] ?? []), "Missing autocomplete attribute for required field."];
+                }
+            }
+            return {
+                valid: Object.keys(errors).length === 0,
+                errors,
+                warnings
+            };
+        },
+        getField(name) {
+            return fields.get(name);
+        },
+        async submit(data) {
+            const result = await this.validate(data);
+            if (!result.valid) {
+                throw new Error("Form validation failed.");
+            }
+            await config.submitHandler?.(data);
+        },
+        enableAutocomplete(fieldName, type) {
+            const field = fields.get(fieldName);
+            if (!field) {
+                throw new Error(`Field '${fieldName}' not found.`);
+            }
+            field.autocomplete = type;
+        },
+        setValidationTiming(timing) {
+            validationTiming = timing;
+        },
+        getValidationTiming() {
+            return validationTiming;
+        },
+        shouldValidateOn(event) {
+            if (validationTiming === "onChange") {
+                return event === "change";
+            }
+            if (validationTiming === "onBlur") {
+                return event === "blur";
+            }
+            return event === "submit";
+        }
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@obinexusltd/obix-sdk-forms",
+  "version": "0.1.0",
+  "description": "OBIX Forms - Validation, autocomplete, progressive enhancement",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "license": "MIT",
+  "author": "OBINexus <okpalan@protonmail.com>",
+  "peerDependencies": {
+    "@obinexusltd/obix-sdk-core": "^0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}