ts-util-core 2.0.0

package/dist/validation/validator.d.ts

@@ -0,0 +1,45 @@
+import type { EventEmitter } from '../core/event-emitter.js';
+import type { AppEventMap } from '../types.js';
+import { type ConstraintHandler } from './constraints.js';
+type InvalidCallback = (labelNames: string[], elements: HTMLElement[]) => void;
+type TextareaTooLongCallback = (labelNames: string[], maxlengths: number[], elements: HTMLElement[]) => void;
+export declare class Validator {
+    private emitter;
+    private constraints;
+    private requiredInvalidCb;
+    private textareaTooLongCb;
+    constructor(emitter: EventEmitter<AppEventMap>);
+    /**
+     * Register a custom constraint handler.
+     *
+     * Registry Pattern — extend validation without modifying library code.
+     */
+    addConstraint(handler: ConstraintHandler): void;
+    /**
+     * Override the default behavior when required-field validation fails.
+     *
+     * Strategy Pattern — consumers inject their own notification UI.
+     */
+    setRequiredInvalidCallback(cb: InvalidCallback): void;
+    setTextareaTooLongCallback(cb: TextareaTooLongCallback): void;
+    /**
+     * Attach constraint handlers to all matching elements within `context`.
+     *
+     * This is the **beforeLoad hook** — it is registered with `VIEW.addBeforeLoad`
+     * so that dynamically loaded content is also initialized.
+     */
+    initConstraints(context: HTMLElement): void;
+    private bindIgnoreValidation;
+    /**
+     * Validate all required fields and textarea lengths within a container.
+     *
+     * @returns `true` if all validations pass.
+     */
+    validate(container: HTMLElement): boolean;
+    private checkTextareaLengths;
+    private checkRequired;
+    private handleRequiredInvalid;
+    private handleTextareaTooLong;
+}
+export {};
+//# sourceMappingURL=validator.d.ts.map

package/dist/validation/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/validation/validator.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAA8C,MAAM,aAAa,CAAC;AAE3F,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,kBAAkB,CAAC;AAE1B,KAAK,eAAe,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;AAC/E,KAAK,uBAAuB,GAAG,CAC7B,UAAU,EAAE,MAAM,EAAE,EACpB,UAAU,EAAE,MAAM,EAAE,EACpB,QAAQ,EAAE,WAAW,EAAE,KACpB,IAAI,CAAC;AAEV,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,WAAW,CAA6C;IAChE,OAAO,CAAC,iBAAiB,CAAgC;IACzD,OAAO,CAAC,iBAAiB,CAAwC;gBAErD,OAAO,EAAE,YAAY,CAAC,WAAW,CAAC;IAW9C;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAM/C;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI;IAIrD,0BAA0B,CAAC,EAAE,EAAE,uBAAuB,GAAG,IAAI;IAM7D;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IA+B3C,OAAO,CAAC,oBAAoB;IAyB5B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO;IAkBzC,OAAO,CAAC,oBAAoB;IAuB5B,OAAO,CAAC,aAAa;IA2DrB,OAAO,CAAC,qBAAqB;IAiB7B,OAAO,CAAC,qBAAqB;CAuB9B"}

package/dist/validation/validator.js

@@ -0,0 +1,210 @@
+// ---------------------------------------------------------------------------
+// Validator — form validation engine
+//
+// Design patterns used:
+//   - Observer Pattern  : integrates with VIEW.addBeforeLoad to auto-init
+//   - Strategy Pattern  : invalid-field handling is injectable via the emitter
+//   - Decorator Pattern : constraints are attached to elements by attribute
+//   - Registry Pattern  : ConstraintHandler lookup by name
+// ---------------------------------------------------------------------------
+import { scrollToElement } from '../utils/dom.js';
+import { builtInConstraints, } from './constraints.js';
+export class Validator {
+    emitter;
+    constraints = new Map();
+    requiredInvalidCb = null;
+    textareaTooLongCb = null;
+    constructor(emitter) {
+        this.emitter = emitter;
+        // Register built-in constraints
+        for (const c of builtInConstraints) {
+            this.constraints.set(c.name, c);
+        }
+    }
+    // -- Constraint Registration ------------------------------------------------
+    /**
+     * Register a custom constraint handler.
+     *
+     * Registry Pattern — extend validation without modifying library code.
+     */
+    addConstraint(handler) {
+        this.constraints.set(handler.name, handler);
+    }
+    // -- Callback Setters (Strategy Pattern) ------------------------------------
+    /**
+     * Override the default behavior when required-field validation fails.
+     *
+     * Strategy Pattern — consumers inject their own notification UI.
+     */
+    setRequiredInvalidCallback(cb) {
+        this.requiredInvalidCb = cb;
+    }
+    setTextareaTooLongCallback(cb) {
+        this.textareaTooLongCb = cb;
+    }
+    // -- Initialization (called by VIEW.addBeforeLoad) --------------------------
+    /**
+     * Attach constraint handlers to all matching elements within `context`.
+     *
+     * This is the **beforeLoad hook** — it is registered with `VIEW.addBeforeLoad`
+     * so that dynamically loaded content is also initialized.
+     */
+    initConstraints(context) {
+        const elements = context.querySelectorAll('[constraint]');
+        for (const el of elements) {
+            const tokens = (el.getAttribute('constraint') || '').split(/\s+/);
+            for (const token of tokens) {
+                if (!token)
+                    continue;
+                const handler = this.constraints.get(token);
+                handler?.attach(el);
+            }
+        }
+        // Auto-select text on focus (text inputs and textareas)
+        const focusTargets = context.querySelectorAll('input[type="text"], textarea');
+        for (const el of focusTargets) {
+            el.addEventListener('focus', () => {
+                setTimeout(() => el.select(), 1);
+            });
+        }
+        // Ignore-validation submit buttons
+        this.bindIgnoreValidation(context);
+    }
+    // -- Form Submit Integration ------------------------------------------------
+    bindIgnoreValidation(context) {
+        const buttons = context.querySelectorAll("input[type='submit'][ignoreValidation='true']");
+        for (const btn of buttons) {
+            btn.addEventListener('click', () => {
+                btn.closest('form')?.classList.add('ignoreValidation');
+            });
+        }
+        const forms = context.querySelectorAll('form');
+        for (const form of forms) {
+            form.addEventListener('submit', (e) => {
+                if (!form.classList.contains('ignoreValidation')) {
+                    if (!this.validate(form)) {
+                        e.preventDefault();
+                    }
+                }
+                form.classList.remove('ignoreValidation');
+            });
+        }
+    }
+    // -- Core Validation Logic --------------------------------------------------
+    /**
+     * Validate all required fields and textarea lengths within a container.
+     *
+     * @returns `true` if all validations pass.
+     */
+    validate(container) {
+        // Check textarea max-length first
+        const tooLong = this.checkTextareaLengths(container);
+        if (!tooLong.valid) {
+            this.handleTextareaTooLong(tooLong);
+            return false;
+        }
+        // Check required fields
+        const result = this.checkRequired(container);
+        if (!result.valid) {
+            this.handleRequiredInvalid(result);
+            return false;
+        }
+        return true;
+    }
+    checkTextareaLengths(container) {
+        const textareas = container.querySelectorAll('textarea[maxlength]');
+        const invalidElements = [];
+        const labelNames = [];
+        const maxlengths = [];
+        for (const ta of textareas) {
+            const max = parseInt(ta.getAttribute('maxlength') || '0', 10);
+            if (ta.value.length > max) {
+                invalidElements.push(ta);
+                labelNames.push(ta.getAttribute('labelName') || ta.name || '');
+                maxlengths.push(max);
+            }
+        }
+        return {
+            valid: invalidElements.length === 0,
+            invalidElements,
+            labelNames,
+            maxlengths,
+        };
+    }
+    checkRequired(container) {
+        const elements = container.querySelectorAll("[constraint~='required']");
+        // Group by name (for radio/checkbox groups)
+        const groups = new Map();
+        let idCounter = 0;
+        for (const el of elements) {
+            const input = el;
+            let name = input.name || `__unnamed_${idCounter++}`;
+            if (!groups.has(name)) {
+                groups.set(name, []);
+            }
+            groups.get(name).push(el);
+        }
+        const invalidElements = [];
+        const labelNames = [];
+        for (const [, groupElements] of groups) {
+            let notEmpty = false;
+            for (const el of groupElements) {
+                const input = el;
+                if (input.type === 'radio' || input.type === 'checkbox') {
+                    if (input.checked)
+                        notEmpty = true;
+                }
+                else if ((el.getAttribute('constraint') || '').includes('number')) {
+                    if (input.value !== '0' && input.value !== '')
+                        notEmpty = true;
+                }
+                else if (input.value && input.value !== '') {
+                    notEmpty = true;
+                }
+            }
+            if (!notEmpty) {
+                const first = groupElements[0];
+                invalidElements.push(first);
+                labelNames.push(first.getAttribute('labelName') ||
+                    first.name ||
+                    '');
+            }
+        }
+        return {
+            valid: invalidElements.length === 0,
+            invalidElements,
+            labelNames,
+        };
+    }
+    // -- Default Failure Handlers -----------------------------------------------
+    handleRequiredInvalid(result) {
+        this.emitter.emit('validation:invalid', {
+            labelNames: result.labelNames,
+            elements: result.invalidElements,
+        });
+        if (this.requiredInvalidCb) {
+            this.requiredInvalidCb(result.labelNames, result.invalidElements);
+            return;
+        }
+        // Default behavior: alert + scroll
+        const text = result.labelNames.map((n) => `"${n}"`).join(', ');
+        scrollToElement(result.invalidElements[0]);
+        window.alert(`${text} is required!`);
+    }
+    handleTextareaTooLong(result) {
+        this.emitter.emit('validation:textareaTooLong', {
+            labelNames: result.labelNames,
+            maxlengths: result.maxlengths,
+            elements: result.invalidElements,
+        });
+        if (this.textareaTooLongCb) {
+            this.textareaTooLongCb(result.labelNames, result.maxlengths, result.invalidElements);
+            return;
+        }
+        // Default behavior: alert + scroll
+        const lines = result.labelNames.map((name, i) => `"${name}" length is too long, max length is ${result.maxlengths[i]}!`);
+        scrollToElement(result.invalidElements[0]);
+        window.alert(lines.join('\n'));
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/validation/validator.js.map

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

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "ts-util-core",
+  "version": "2.0.0",
+  "description": "TS-Util Core Library — form validation, AJAX, view loading, messaging, and formatting utilities",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  },
+  "license": "MIT"
+}

package/readme.txt

@@ -0,0 +1,4 @@
+It depends on
+1. jQuery
+2. Spinner (http://fgnass.github.io/spin.js/)
+3. Messi (https://github.com/marcosesperon/Messi/)

package/src/core/ajax.ts

@@ -0,0 +1,127 @@
+// ---------------------------------------------------------------------------
+// AJAX module — fetch-based HTTP client with lifecycle hooks
+//
+// Design patterns used:
+//   - Facade Pattern         : one `request()` call orchestrates validate →
+//                              block → serialize → fetch → unblock
+//   - Template Method Pattern: `requestJSON` / `post` / `postJSON` delegate
+//                              to the base `request` with tweaked options
+//   - Strategy Pattern       : loading overlay behavior is injected via
+//                              the EventEmitter (ajax:before / ajax:after)
+// ---------------------------------------------------------------------------
+
+import type { EventEmitter } from './event-emitter.js';
+import type { AppEventMap, AjaxRequestParams, AjaxJsonRequestParams } from '../types.js';
+import { formToJSON } from '../utils/dom.js';
+
+export class Ajax {
+  private emitter: EventEmitter<AppEventMap>;
+  private validateForm: ((form: HTMLElement) => boolean) | null = null;
+
+  constructor(emitter: EventEmitter<AppEventMap>) {
+    this.emitter = emitter;
+  }
+
+  /** Register the form validation function (injected by the Validation module). */
+  setValidator(fn: (form: HTMLElement) => boolean): void {
+    this.validateForm = fn;
+  }
+
+  /**
+   * Send an HTTP request (POST by default).
+   *
+   * Lifecycle:
+   * 1. Validate form (if `params.form` provided)
+   * 2. Emit `ajax:before`
+   * 3. Serialize form data + merge `params.data`
+   * 4. `fetch()`
+   * 5. Emit `ajax:after` (on success) or `ajax:error` (on failure)
+   * 6. Call `params.success` / `params.error` / `params.complete`
+   *
+   * @returns The raw `Response`, or `undefined` if validation failed.
+   */
+  async request(params: AjaxRequestParams): Promise<Response | undefined> {
+    // 1. Validate
+    if (params.form && this.validateForm) {
+      if (!this.validateForm(params.form)) return undefined;
+    }
+
+    // 2. Before-hook
+    if (!params.noblock) {
+      this.emitter.emit('ajax:before', { url: params.url });
+    }
+
+    // 3. Build body
+    const body: Record<string, unknown> = {};
+
+    if (params.form) {
+      const formData = formToJSON(params.form, {
+        ignoreDisabled: params.ignoreDisabled,
+      });
+      Object.assign(body, formData);
+    }
+
+    if (params.data) {
+      Object.assign(body, params.data);
+    }
+
+    // 4. Fetch
+    const headers: Record<string, string> = {
+      'Content-Type': 'application/json',
+      'Ajax-Call': 'true',
+      ...params.headers,
+    };
+
+    try {
+      const response = await fetch(params.url, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify(body),
+      });
+
+      if (!response.ok) {
+        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+      }
+
+      // 5a. After-hook (success)
+      if (!params.noblock) {
+        this.emitter.emit('ajax:after', { url: params.url });
+      }
+
+      params.success?.(response);
+      return response;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+
+      // 5b. After-hook (error)
+      if (!params.noblock) {
+        this.emitter.emit('ajax:after', { url: params.url });
+      }
+      this.emitter.emit('ajax:error', { url: params.url, error });
+
+      params.error?.(error);
+      return undefined;
+    } finally {
+      params.complete?.();
+    }
+  }
+
+  /**
+   * Send a request and parse the response as JSON.
+   *
+   * Template Method — delegates to `request()`, adds JSON parsing.
+   */
+  async requestJSON<T = unknown>(
+    params: AjaxJsonRequestParams<T>,
+  ): Promise<T | undefined> {
+    const response = await this.request({
+      ...params,
+      success: undefined, // we handle success after JSON parse
+    });
+    if (!response) return undefined;
+
+    const data = (await response.json()) as T;
+    params.success?.(data);
+    return data;
+  }
+}

package/src/core/event-emitter.ts

@@ -0,0 +1,84 @@
+// ---------------------------------------------------------------------------
+// Typed EventEmitter — the unified hook / callback system
+//
+// Design patterns used:
+//   - Observer Pattern : multiple listeners subscribe to named events
+//   - Strategy Pattern : consumers replace default behavior via listeners
+//   - Generics         : the event map is fully typed at compile time
+// ---------------------------------------------------------------------------
+
+/**
+ * A fully typed event emitter.
+ *
+ * `TEvents` is a map of `{ eventName: payloadType }`.
+ * All `on`, `off`, and `emit` calls are type-checked against this map.
+ *
+ * @example
+ * ```ts
+ * const emitter = new EventEmitter<{ 'ajax:before': { url: string } }>();
+ * emitter.on('ajax:before', ({ url }) => console.log(url));
+ * emitter.emit('ajax:before', { url: '/api' });
+ * ```
+ */
+export class EventEmitter<TEvents extends { [K in keyof TEvents]: unknown }> {
+  private listeners = new Map<
+    keyof TEvents,
+    Set<(payload: never) => void>
+  >();
+
+  /** Subscribe to an event. Returns an unsubscribe function. */
+  on<K extends keyof TEvents>(
+    event: K,
+    listener: (payload: TEvents[K]) => void,
+  ): () => void {
+    if (!this.listeners.has(event)) {
+      this.listeners.set(event, new Set());
+    }
+    const set = this.listeners.get(event)!;
+    set.add(listener as (payload: never) => void);
+
+    // Return unsubscribe function for convenience
+    return () => {
+      set.delete(listener as (payload: never) => void);
+    };
+  }
+
+  /** Unsubscribe a specific listener. */
+  off<K extends keyof TEvents>(
+    event: K,
+    listener: (payload: TEvents[K]) => void,
+  ): void {
+    this.listeners.get(event)?.delete(listener as (payload: never) => void);
+  }
+
+  /** Subscribe to an event — listener is automatically removed after one call. */
+  once<K extends keyof TEvents>(
+    event: K,
+    listener: (payload: TEvents[K]) => void,
+  ): () => void {
+    const wrapper = ((payload: TEvents[K]) => {
+      this.off(event, wrapper);
+      listener(payload);
+    }) as (payload: TEvents[K]) => void;
+
+    return this.on(event, wrapper);
+  }
+
+  /** Emit an event, calling all registered listeners with the payload. */
+  emit<K extends keyof TEvents>(event: K, payload: TEvents[K]): void {
+    const set = this.listeners.get(event);
+    if (!set) return;
+    for (const listener of set) {
+      (listener as (payload: TEvents[K]) => void)(payload);
+    }
+  }
+
+  /** Remove all listeners for a specific event, or all events if none specified. */
+  clear(event?: keyof TEvents): void {
+    if (event) {
+      this.listeners.delete(event);
+    } else {
+      this.listeners.clear();
+    }
+  }
+}