@mappoh/nova 0.1.16

package/dist/forms/form-engine.js

@@ -0,0 +1,228 @@
+/**
+ * Nova Engine — Form Engine
+ *
+ * Schema-driven forms with validation, multi-step support,
+ * dirty/touched tracking, and async submission.
+ */
+export class NovaForm {
+    schema;
+    fieldStates = {};
+    currentStep = 0;
+    submitting = false;
+    submitError = null;
+    listeners = new Set();
+    constructor(schema) {
+        this.schema = schema;
+        this.initFields();
+    }
+    /** Initialize field states from schema */
+    initFields() {
+        for (const step of this.schema.steps) {
+            for (const [name, field] of Object.entries(step.fields)) {
+                this.fieldStates[name] = {
+                    value: field.defaultValue ?? (field.type === 'checkbox' ? false : ''),
+                    error: null,
+                    touched: false,
+                    dirty: false,
+                    validating: false,
+                };
+            }
+        }
+    }
+    /** Get current form state snapshot */
+    get state() {
+        return {
+            fields: { ...this.fieldStates },
+            currentStep: this.currentStep,
+            totalSteps: this.schema.steps.length,
+            submitting: this.submitting,
+            submitError: this.submitError,
+            valid: this.isValid(),
+        };
+    }
+    /** Get the current step schema */
+    get step() {
+        return this.schema.steps[this.currentStep];
+    }
+    /** Update a field value */
+    setValue(name, value) {
+        const field = this.fieldStates[name];
+        if (!field)
+            return;
+        field.value = value;
+        field.dirty = true;
+        // Clear error on change
+        if (field.error) {
+            field.error = null;
+        }
+        this.notify();
+    }
+    /** Mark a field as touched (blurred) */
+    touch(name) {
+        const field = this.fieldStates[name];
+        if (!field)
+            return;
+        field.touched = true;
+        this.validateField(name);
+        this.notify();
+    }
+    /** Validate a single field */
+    validateField(name) {
+        const field = this.fieldStates[name];
+        if (!field)
+            return null;
+        const schema = this.getFieldSchema(name);
+        if (!schema)
+            return null;
+        // Required check
+        if (schema.required) {
+            if (field.value === '' || field.value === null || field.value === undefined) {
+                field.error = `${schema.label ?? name} is required`;
+                return field.error;
+            }
+        }
+        // Run validators
+        if (schema.validators) {
+            for (const validator of schema.validators) {
+                // Handle match validator
+                if ('_matchField' in validator) {
+                    const matchName = validator._matchField;
+                    const matchField = this.fieldStates[matchName];
+                    if (matchField && field.value !== matchField.value) {
+                        field.error = `Must match ${matchName}`;
+                        return field.error;
+                    }
+                    continue;
+                }
+                const error = validator(field.value);
+                if (error) {
+                    field.error = error;
+                    return error;
+                }
+            }
+        }
+        field.error = null;
+        return null;
+    }
+    /** Validate all fields in the current step */
+    validateStep() {
+        const step = this.schema.steps[this.currentStep];
+        let valid = true;
+        for (const name of Object.keys(step.fields)) {
+            const error = this.validateField(name);
+            if (error)
+                valid = false;
+            this.fieldStates[name].touched = true;
+        }
+        this.notify();
+        return valid;
+    }
+    /** Validate all fields across all steps */
+    validateAll() {
+        let valid = true;
+        for (const step of this.schema.steps) {
+            for (const name of Object.keys(step.fields)) {
+                const error = this.validateField(name);
+                if (error)
+                    valid = false;
+                this.fieldStates[name].touched = true;
+            }
+        }
+        this.notify();
+        return valid;
+    }
+    /** Check if form is valid (no errors) */
+    isValid() {
+        return Object.values(this.fieldStates).every((f) => f.error === null);
+    }
+    /** Go to next step (validates current step first) */
+    nextStep() {
+        if (!this.validateStep())
+            return false;
+        if (this.currentStep < this.schema.steps.length - 1) {
+            this.currentStep++;
+            this.notify();
+            return true;
+        }
+        return false;
+    }
+    /** Go to previous step */
+    prevStep() {
+        if (this.currentStep > 0) {
+            this.currentStep--;
+            this.notify();
+            return true;
+        }
+        return false;
+    }
+    /** Go to specific step */
+    goToStep(index) {
+        if (index >= 0 && index < this.schema.steps.length) {
+            this.currentStep = index;
+            this.notify();
+        }
+    }
+    /** Submit the form */
+    async submit() {
+        if (!this.validateAll())
+            return false;
+        this.submitting = true;
+        this.submitError = null;
+        this.notify();
+        try {
+            const data = {};
+            for (const [name, field] of Object.entries(this.fieldStates)) {
+                data[name] = field.value;
+            }
+            await this.schema.onSubmit(data);
+            this.submitting = false;
+            this.notify();
+            return true;
+        }
+        catch (err) {
+            this.submitting = false;
+            this.submitError = err instanceof Error ? err.message : 'Submission failed';
+            this.notify();
+            return false;
+        }
+    }
+    /** Get all form data */
+    getData() {
+        const data = {};
+        for (const [name, field] of Object.entries(this.fieldStates)) {
+            data[name] = field.value;
+        }
+        return data;
+    }
+    /** Reset form to initial state */
+    reset() {
+        this.currentStep = 0;
+        this.submitting = false;
+        this.submitError = null;
+        this.initFields();
+        this.notify();
+    }
+    /** Subscribe to state changes */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    notify() {
+        const state = this.state;
+        for (const listener of this.listeners) {
+            listener(state);
+        }
+    }
+    getFieldSchema(name) {
+        for (const step of this.schema.steps) {
+            if (name in step.fields)
+                return step.fields[name];
+        }
+        return null;
+    }
+}
+/** Create a form instance from a schema */
+export function createForm(schema) {
+    return new NovaForm(schema);
+}
+//# sourceMappingURL=form-engine.js.map

package/dist/forms/form-engine.js.map

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

package/dist/forms/index.d.ts

@@ -0,0 +1,3 @@
+export { NovaForm, createForm } from './form-engine';
+export type { FieldSchema, StepSchema, FormSchema, FieldState, FormState } from './form-engine';
+//# sourceMappingURL=index.d.ts.map

package/dist/forms/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/forms/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC"}

package/dist/forms/index.js

@@ -0,0 +1,2 @@
+export { NovaForm, createForm } from './form-engine';
+//# sourceMappingURL=index.js.map

package/dist/forms/index.js.map

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

package/dist/forms/validators.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Nova Engine — Built-in Validators
+ *
+ * Each validator returns null if valid, or an error message string if invalid.
+ */
+export type Validator = (value: unknown) => string | null;
+export type AsyncValidator = (value: unknown) => Promise<string | null>;
+export declare function required(msg?: string): Validator;
+export declare function minLength(min: number, msg?: string): Validator;
+export declare function maxLength(max: number, msg?: string): Validator;
+export declare function isEmail(msg?: string): Validator;
+export declare function pattern(regex: RegExp, msg?: string): Validator;
+export declare function minValue(min: number, msg?: string): Validator;
+export declare function maxValue(max: number, msg?: string): Validator;
+export declare function match(fieldName: string, _msg?: string): Validator & {
+    _matchField: string;
+};
+/** Run multiple validators in sequence, returning the first error */
+export declare function compose(...validators: Validator[]): Validator;
+//# sourceMappingURL=validators.d.ts.map

package/dist/forms/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/forms/validators.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC;AAC1D,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAExE,wBAAgB,QAAQ,CAAC,GAAG,SAA2B,GAAG,SAAS,CAOlE;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAO9D;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAO9D;AAED,wBAAgB,OAAO,CAAC,GAAG,SAAwB,GAAG,SAAS,CAM9D;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAmB,GAAG,SAAS,CAKxE;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAQ7D;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAQ7D;AAED,wBAAgB,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAO3F;AAED,qEAAqE;AACrE,wBAAgB,OAAO,CAAC,GAAG,UAAU,EAAE,SAAS,EAAE,GAAG,SAAS,CAQ7D"}

package/dist/forms/validators.js

@@ -0,0 +1,82 @@
+/**
+ * Nova Engine — Built-in Validators
+ *
+ * Each validator returns null if valid, or an error message string if invalid.
+ */
+export function required(msg = 'This field is required') {
+    return (value) => {
+        if (value === null || value === undefined || value === '' || (Array.isArray(value) && value.length === 0)) {
+            return msg;
+        }
+        return null;
+    };
+}
+export function minLength(min, msg) {
+    return (value) => {
+        if (typeof value === 'string' && value.length < min) {
+            return msg ?? `Must be at least ${min} characters`;
+        }
+        return null;
+    };
+}
+export function maxLength(max, msg) {
+    return (value) => {
+        if (typeof value === 'string' && value.length > max) {
+            return msg ?? `Must be at most ${max} characters`;
+        }
+        return null;
+    };
+}
+export function isEmail(msg = 'Enter a valid email') {
+    return (value) => {
+        if (typeof value !== 'string')
+            return msg;
+        const re = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+        return re.test(value) ? null : msg;
+    };
+}
+export function pattern(regex, msg = 'Invalid format') {
+    return (value) => {
+        if (typeof value !== 'string')
+            return msg;
+        return regex.test(value) ? null : msg;
+    };
+}
+export function minValue(min, msg) {
+    return (value) => {
+        const num = Number(value);
+        if (isNaN(num) || num < min) {
+            return msg ?? `Must be at least ${min}`;
+        }
+        return null;
+    };
+}
+export function maxValue(max, msg) {
+    return (value) => {
+        const num = Number(value);
+        if (isNaN(num) || num > max) {
+            return msg ?? `Must be at most ${max}`;
+        }
+        return null;
+    };
+}
+export function match(fieldName, _msg) {
+    const validator = ((_value) => {
+        // This validator is handled specially by the form engine
+        return null;
+    });
+    validator._matchField = fieldName;
+    return validator;
+}
+/** Run multiple validators in sequence, returning the first error */
+export function compose(...validators) {
+    return (value) => {
+        for (const v of validators) {
+            const error = v(value);
+            if (error)
+                return error;
+        }
+        return null;
+    };
+}
+//# sourceMappingURL=validators.js.map

package/dist/forms/validators.js.map

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

package/dist/gallery/gallery.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Nova Engine — Image Gallery
+ *
+ * Lightbox, zoom, pan, filmstrip navigation, keyboard controls,
+ * and touch gestures for image galleries.
+ */
+export interface GalleryItem {
+    /** Full-size image URL */
+    src: string;
+    /** Thumbnail URL (uses src if omitted) */
+    thumb?: string;
+    /** Alt text */
+    alt?: string;
+    /** Caption text */
+    caption?: string;
+    /** Width of the full image */
+    width?: number;
+    /** Height of the full image */
+    height?: number;
+}
+export interface GalleryOptions {
+    /** Array of gallery items */
+    items: GalleryItem[];
+    /** Initial slide index. Default: 0 */
+    startIndex?: number;
+    /** Show filmstrip thumbnails. Default: true */
+    filmstrip?: boolean;
+    /** Enable zoom on click/pinch. Default: true */
+    zoom?: boolean;
+    /** Max zoom level. Default: 3 */
+    maxZoom?: number;
+    /** Enable keyboard navigation. Default: true */
+    keyboard?: boolean;
+    /** Enable swipe gestures. Default: true */
+    swipe?: boolean;
+    /** Loop navigation. Default: true */
+    loop?: boolean;
+    /** Auto-close on backdrop click. Default: true */
+    closeOnBackdrop?: boolean;
+    /** Show counter (1 / 5). Default: true */
+    counter?: boolean;
+    /** Animation duration in ms. Default: 250 */
+    animationDuration?: number;
+    /** Called when slide changes */
+    onChange?: (index: number) => void;
+    /** Called when gallery closes */
+    onClose?: () => void;
+}
+export interface GalleryInstance {
+    open(index?: number): void;
+    close(): void;
+    next(): void;
+    prev(): void;
+    goTo(index: number): void;
+    isOpen(): boolean;
+    destroy(): void;
+}
+/** Create a gallery / lightbox instance. */
+export declare function createGallery(options: GalleryOptions): GalleryInstance;
+/**
+ * Attach a gallery to image elements matching a selector.
+ * Automatically builds items from img[src] and img[alt].
+ * Returns a cleanup function.
+ */
+export declare function gallery(selector: string, options?: Partial<GalleryOptions>): () => void;
+//# sourceMappingURL=gallery.d.ts.map

package/dist/gallery/gallery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gallery.d.ts","sourceRoot":"","sources":["../../src/gallery/gallery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gDAAgD;IAChD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qCAAqC;IACrC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kDAAkD;IAClD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gCAAgC;IAChC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,IAAI,IAAI,IAAI,CAAC;IACb,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,IAAI,OAAO,CAAC;IAClB,OAAO,IAAI,IAAI,CAAC;CACjB;AAuED,4CAA4C;AAC5C,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,eAAe,CAkQtE;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,MAAM,IAAI,CA2BZ"}