ts-util-core 2.0.0

package/dist/index.js

@@ -0,0 +1,104 @@
+// ---------------------------------------------------------------------------
+// ts-util-core — barrel export
+//
+// This is the main entry point. It wires all modules together and exposes
+// the unified `#` (TS-Util) namespace.
+//
+// Usage with ES modules (recommended):
+//
+//   import { AJAX, VIEW, MSG, Validation, Formatter } from 'ts-util-core';
+//
+//   // or as a single namespace:
+//   import * as RS from 'ts-util-core';
+//   RS.AJAX.request({ url: '/api/save', form: myForm });
+//
+// Usage as a global (for non-module scripts):
+//
+//   The library auto-registers `window.#` (accessed via `window['#']`)
+//   when loaded in a <script> tag without `type="module"`.
+//
+// Design patterns used:
+//   - Facade Pattern  : one import gives access to all features
+//   - Mediator Pattern : the EventEmitter is the central coordinator —
+//                        modules don't reference each other directly,
+//                        they communicate through events
+// ---------------------------------------------------------------------------
+// Re-export classes for advanced use
+export { EventEmitter } from './core/event-emitter.js';
+export { Ajax } from './core/ajax.js';
+export { View } from './core/view.js';
+export { Message } from './core/message.js';
+export { Validator } from './validation/validator.js';
+export { FormatterRegistry } from './formatting/registry.js';
+// Re-export utilities
+export { sprintf } from './utils/sprintf.js';
+export { formToJSON, isDateValid, parseHTML, scrollToElement, defaults } from './utils/dom.js';
+// ---------------------------------------------------------------------------
+// Pre-wired singleton instances — the `#` namespace
+// ---------------------------------------------------------------------------
+import { EventEmitter } from './core/event-emitter.js';
+import { Ajax } from './core/ajax.js';
+import { View } from './core/view.js';
+import { Message } from './core/message.js';
+import { Validator } from './validation/validator.js';
+import { FormatterRegistry } from './formatting/registry.js';
+import { builtInFormatters } from './formatting/formatters.js';
+// 1. Create the shared event bus (Mediator)
+const emitter = new EventEmitter();
+// 2. Instantiate modules — they receive the emitter, not each other
+const ajax = new Ajax(emitter);
+const view = new View(emitter, ajax);
+const msg = new Message();
+const validator = new Validator(emitter);
+const formatter = new FormatterRegistry();
+// 3. Wire cross-module dependencies via hooks (Observer Pattern)
+//    — The Validator tells the AJAX module how to validate forms
+ajax.setValidator((form) => validator.validate(form));
+//    — The Validator registers its beforeLoad hook with VIEW
+view.addBeforeLoad((context) => validator.initConstraints(context));
+//    — The FormatterRegistry registers its beforeLoad hook with VIEW
+view.addBeforeLoad((context) => formatter.applyAll(context));
+// 4. Register built-in formatters
+for (const f of builtInFormatters) {
+    formatter.add(f);
+}
+// 5. Export pre-wired instances as the public API
+/** AJAX module — HTTP requests with lifecycle hooks. */
+export const AJAX = ajax;
+/** VIEW module — load and initialize HTML fragments. */
+export const VIEW = view;
+/** MSG module — dialogs and notifications. */
+export const MSG = msg;
+/** Validation module — form validation engine. */
+export const Validation = validator;
+/** Formatter module — input masking registry. */
+export const Formatter = formatter;
+/** Event bus — subscribe to library-wide lifecycle events. */
+export const Events = emitter;
+// ---------------------------------------------------------------------------
+// Auto-initialize on DOMContentLoaded (when running in a browser)
+// ---------------------------------------------------------------------------
+if (typeof document !== 'undefined') {
+    const init = () => view.initPage();
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', init);
+    }
+    else {
+        init();
+    }
+}
+// ---------------------------------------------------------------------------
+// Global registration for non-module environments:  window['#']
+// ---------------------------------------------------------------------------
+if (typeof window !== 'undefined') {
+    const ns = {
+        AJAX: ajax,
+        VIEW: view,
+        MSG: msg,
+        Validation: validator,
+        Formatter: formatter,
+        Events: emitter,
+    };
+    window['#'] = ns;
+}
+//# 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/dist/types.d.ts

@@ -0,0 +1,66 @@
+/** Supported constraint types declared via the `constraint` HTML attribute. */
+export type ConstraintType = 'required' | 'date' | 'number' | 'time' | 'upperCase' | 'onlyEn';
+/** A record whose values are either a single string or an array of strings. */
+export type FormDataRecord = Record<string, string | string[]>;
+export interface AjaxRequestParams {
+    url: string;
+    data?: Record<string, unknown>;
+    form?: HTMLElement;
+    ignoreDisabled?: boolean;
+    noblock?: boolean;
+    headers?: Record<string, string>;
+    success?: (data: unknown) => void;
+    error?: (error: Error) => void;
+    complete?: () => void;
+}
+export interface AjaxJsonRequestParams<T = unknown> extends Omit<AjaxRequestParams, 'success'> {
+    success?: (data: T) => void;
+}
+export interface ViewLoadParams extends Omit<AjaxRequestParams, 'success'> {
+    success?: (content: HTMLElement) => void;
+}
+export interface MessageOptions {
+    autoclose?: number;
+    title?: string;
+}
+export interface ConfirmButton {
+    label: string;
+    value: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    invalidElements: HTMLElement[];
+    labelNames: string[];
+}
+export interface TextareaValidationResult extends ValidationResult {
+    maxlengths: number[];
+}
+export interface Formatter {
+    key: string;
+    format: (element: HTMLInputElement) => void;
+}
+export interface AppEventMap {
+    'ajax:before': {
+        url: string;
+    };
+    'ajax:after': {
+        url: string;
+    };
+    'ajax:error': {
+        url: string;
+        error: Error;
+    };
+    'view:beforeLoad': {
+        context: HTMLElement;
+    };
+    'validation:invalid': {
+        labelNames: string[];
+        elements: HTMLElement[];
+    };
+    'validation:textareaTooLong': {
+        labelNames: string[];
+        maxlengths: number[];
+        elements: HTMLElement[];
+    };
+}
+//# 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":"AAIA,+EAA+E;AAC/E,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,MAAM,GACN,QAAQ,GACR,MAAM,GACN,WAAW,GACX,QAAQ,CAAC;AAEb,+EAA+E;AAC/E,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;AAI/D,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAClC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC;IAC5F,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;CAC7B;AAID,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC;IACxE,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;CAC1C;AAID,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAID,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,eAAe,EAAE,WAAW,EAAE,CAAC;IAC/B,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAChE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAID,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAC7C;AAID,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,YAAY,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,YAAY,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC;IAC5C,iBAAiB,EAAE;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE,CAAC;IAC5C,oBAAoB,EAAE;QAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC;IACxE,4BAA4B,EAAE;QAC5B,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,QAAQ,EAAE,WAAW,EAAE,CAAC;KACzB,CAAC;CACH"}

package/dist/types.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Shared type definitions for ts-util-core
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,2CAA2C;AAC3C,8EAA8E"}

package/dist/utils/dom.d.ts

@@ -0,0 +1,38 @@
+import type { FormDataRecord } from '../types.js';
+/**
+ * Convert all named form elements within a container to a key-value record.
+ *
+ * Replaces the original jQuery-based `formToJSON`.
+ *
+ * @param container - The DOM element containing form inputs.
+ * @param options.ignoreDisabled - Skip disabled elements (default `false`).
+ *
+ * @example
+ * ```ts
+ * const data = formToJSON(document.getElementById('myForm')!);
+ * // { username: "alice", roles: ["admin", "editor"] }
+ * ```
+ */
+export declare function formToJSON(container: HTMLElement, options?: {
+    ignoreDisabled?: boolean;
+}): FormDataRecord;
+/**
+ * Check whether a value is a valid date.
+ *
+ * Accepts a `Date` object or a string in `yyyy-MM-dd` / `yyyy/MM/dd` format.
+ */
+export declare function isDateValid(date: Date | string): boolean;
+/**
+ * Parse an HTML string into a `DocumentFragment`.
+ */
+export declare function parseHTML(html: string): DocumentFragment;
+/**
+ * Smoothly scroll an element into view.
+ */
+export declare function scrollToElement(element: HTMLElement): void;
+/**
+ * Merge multiple option objects (shallow). Later sources override earlier ones.
+ * A typed, zero-dependency replacement for `$.extend()`.
+ */
+export declare function defaults<T extends Record<string, unknown>>(base: T, ...overrides: Partial<T>[]): T;
+//# sourceMappingURL=dom.d.ts.map

package/dist/utils/dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/utils/dom.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,WAAW,EACtB,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GACzC,cAAc,CAyChB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,CAGxD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAIxD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAE1D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxD,IAAI,EAAE,CAAC,EACP,GAAG,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GACzB,CAAC,CAEH"}

package/dist/utils/dom.js

@@ -0,0 +1,95 @@
+// ---------------------------------------------------------------------------
+// DOM utility functions — vanilla TypeScript replacements for jQuery helpers
+//
+// Design patterns used:
+//   - Facade Pattern : simple API over verbose native DOM methods
+// ---------------------------------------------------------------------------
+/**
+ * Convert all named form elements within a container to a key-value record.
+ *
+ * Replaces the original jQuery-based `formToJSON`.
+ *
+ * @param container - The DOM element containing form inputs.
+ * @param options.ignoreDisabled - Skip disabled elements (default `false`).
+ *
+ * @example
+ * ```ts
+ * const data = formToJSON(document.getElementById('myForm')!);
+ * // { username: "alice", roles: ["admin", "editor"] }
+ * ```
+ */
+export function formToJSON(container, options = {}) {
+    const { ignoreDisabled = false } = options;
+    const selectors = 'input[name], textarea[name], select[name]';
+    let elements = Array.from(container.querySelectorAll(selectors));
+    if (ignoreDisabled) {
+        elements = elements.filter((el) => !el.disabled);
+    }
+    const params = {};
+    for (const el of elements) {
+        const name = el.name;
+        if (!name)
+            continue;
+        if (el instanceof HTMLInputElement && el.type === 'checkbox') {
+            if (!(name in params))
+                params[name] = [];
+            if (el.checked)
+                params[name].push(el.value);
+        }
+        else if (el instanceof HTMLSelectElement && el.multiple) {
+            if (!(name in params))
+                params[name] = [];
+            const selected = Array.from(el.selectedOptions).map((o) => o.value);
+            params[name].push(...selected);
+        }
+        else if (el instanceof HTMLInputElement && el.type === 'radio') {
+            if (el.checked)
+                params[name] = el.value;
+        }
+        else {
+            const existing = params[name];
+            if (existing === undefined) {
+                params[name] = el.value;
+            }
+            else if (typeof existing === 'string') {
+                params[name] = [existing, el.value];
+            }
+            else {
+                existing.push(el.value);
+            }
+        }
+    }
+    return params;
+}
+/**
+ * Check whether a value is a valid date.
+ *
+ * Accepts a `Date` object or a string in `yyyy-MM-dd` / `yyyy/MM/dd` format.
+ */
+export function isDateValid(date) {
+    if (date instanceof Date)
+        return !isNaN(date.getTime());
+    return /^\d{4}[/-]\d{1,2}[/-]\d{1,2}$/.test(date);
+}
+/**
+ * Parse an HTML string into a `DocumentFragment`.
+ */
+export function parseHTML(html) {
+    const template = document.createElement('template');
+    template.innerHTML = html.trim();
+    return template.content;
+}
+/**
+ * Smoothly scroll an element into view.
+ */
+export function scrollToElement(element) {
+    element.scrollIntoView({ behavior: 'smooth', block: 'center' });
+}
+/**
+ * Merge multiple option objects (shallow). Later sources override earlier ones.
+ * A typed, zero-dependency replacement for `$.extend()`.
+ */
+export function defaults(base, ...overrides) {
+    return Object.assign({}, base, ...overrides);
+}
+//# sourceMappingURL=dom.js.map

package/dist/utils/dom.js.map

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

package/dist/utils/sprintf.d.ts

@@ -0,0 +1,16 @@
+/**
+ * C-style `sprintf` implementation.
+ *
+ * Supported format specifiers: `%b` `%c` `%d` `%f` `%o` `%s` `%x` `%X` `%%`
+ *
+ * @example
+ * ```ts
+ * sprintf("Hello %s, you are %d years old", "Alice", 30)
+ * // → "Hello Alice, you are 30 years old"
+ *
+ * sprintf("%05d", 42)
+ * // → "00042"
+ * ```
+ */
+export declare function sprintf(format: string, ...args: unknown[]): string;
+//# sourceMappingURL=sprintf.d.ts.map

package/dist/utils/sprintf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprintf.d.ts","sourceRoot":"","sources":["../../src/utils/sprintf.ts"],"names":[],"mappings":"AAkCA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CA4FlE"}

package/dist/utils/sprintf.js

@@ -0,0 +1,116 @@
+// ---------------------------------------------------------------------------
+// sprintf — printf-style string formatting
+//
+// Design patterns used:
+//   - Pure Function : no side effects, deterministic output
+// ---------------------------------------------------------------------------
+function convert(m, nosign = false) {
+    const sign = nosign ? '' : m.negative ? '-' : m.sign;
+    const padLen = m.min - m.argument.length + 1 - sign.length;
+    const pad = padLen > 0 ? m.pad.repeat(padLen) : '';
+    if (!m.left) {
+        return m.pad === '0' || nosign
+            ? sign + pad + m.argument
+            : pad + sign + m.argument;
+    }
+    return m.pad === '0' || nosign
+        ? sign + m.argument + pad.replace(/0/g, ' ')
+        : sign + m.argument + pad;
+}
+/**
+ * C-style `sprintf` implementation.
+ *
+ * Supported format specifiers: `%b` `%c` `%d` `%f` `%o` `%s` `%x` `%X` `%%`
+ *
+ * @example
+ * ```ts
+ * sprintf("Hello %s, you are %d years old", "Alice", 30)
+ * // → "Hello Alice, you are 30 years old"
+ *
+ * sprintf("%05d", 42)
+ * // → "00042"
+ * ```
+ */
+export function sprintf(format, ...args) {
+    const exp = /(%([%]|(-)?(\+|\x20)?(0)?(\d+)?(\.(\d)?)?([bcdfosxX])))/g;
+    const matches = [];
+    const strings = [];
+    let convCount = 0;
+    let matchPosEnd = 0;
+    let result;
+    while ((result = exp.exec(format)) !== null) {
+        if (result[9])
+            convCount++;
+        const stringPosStart = matchPosEnd;
+        const stringPosEnd = exp.lastIndex - result[0].length;
+        strings.push(format.substring(stringPosStart, stringPosEnd));
+        matchPosEnd = exp.lastIndex;
+        const argValue = args[convCount - 1];
+        matches.push({
+            match: result[0],
+            left: !!result[3],
+            sign: result[4] || '',
+            pad: result[5] || ' ',
+            min: result[6] ? parseInt(result[6]) : 0,
+            precision: result[8] !== undefined ? parseInt(result[8]) : undefined,
+            code: result[9] || '%',
+            negative: Number(argValue) < 0,
+            argument: String(argValue),
+        });
+    }
+    strings.push(format.substring(matchPosEnd));
+    if (matches.length === 0)
+        return format;
+    if (args.length < convCount)
+        return format;
+    let output = '';
+    for (let i = 0; i < matches.length; i++) {
+        const m = matches[i];
+        let substitution;
+        switch (m.code) {
+            case '%':
+                substitution = '%';
+                break;
+            case 'b':
+                m.argument = Math.abs(parseInt(m.argument)).toString(2);
+                substitution = convert(m, true);
+                break;
+            case 'c':
+                m.argument = String.fromCharCode(Math.abs(parseInt(m.argument)));
+                substitution = convert(m, true);
+                break;
+            case 'd':
+                m.argument = String(Math.abs(parseInt(m.argument)));
+                substitution = convert(m);
+                break;
+            case 'f':
+                m.argument = Math.abs(parseFloat(m.argument)).toFixed(m.precision ?? 6);
+                substitution = convert(m);
+                break;
+            case 'o':
+                m.argument = Math.abs(parseInt(m.argument)).toString(8);
+                substitution = convert(m);
+                break;
+            case 's':
+                m.argument = m.precision
+                    ? m.argument.substring(0, m.precision)
+                    : m.argument;
+                substitution = convert(m, true);
+                break;
+            case 'x':
+                m.argument = Math.abs(parseInt(m.argument)).toString(16);
+                substitution = convert(m);
+                break;
+            case 'X':
+                m.argument = Math.abs(parseInt(m.argument)).toString(16);
+                substitution = convert(m).toUpperCase();
+                break;
+            default:
+                substitution = m.match;
+        }
+        output += strings[i] + substitution;
+    }
+    output += strings[matches.length];
+    return output;
+}
+//# sourceMappingURL=sprintf.js.map

package/dist/utils/sprintf.js.map

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

package/dist/validation/constraints.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A constraint handler defines behavior that is attached to input elements
+ * bearing a matching `constraint` attribute value.
+ *
+ * Each handler is self-contained — it knows how to bind its own events
+ * and how to validate its own input.
+ */
+export interface ConstraintHandler {
+    /** The constraint keyword (e.g. `"date"`, `"number"`). */
+    name: string;
+    /**
+     * Called once per matching element to attach event listeners.
+     * This is the **Decorator** step — it augments the element's behavior.
+     */
+    attach(element: HTMLInputElement | HTMLTextAreaElement): void;
+}
+export declare const dateConstraint: ConstraintHandler;
+export declare const numberConstraint: ConstraintHandler;
+export declare const timeConstraint: ConstraintHandler;
+export declare const upperCaseConstraint: ConstraintHandler;
+export declare const onlyEnConstraint: ConstraintHandler;
+export declare const builtInConstraints: ConstraintHandler[];
+//# sourceMappingURL=constraints.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constraints.d.ts","sourceRoot":"","sources":["../../src/validation/constraints.ts"],"names":[],"mappings":"AAcA;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,IAAI,CAAC;CAC/D;AAID,eAAO,MAAM,cAAc,EAAE,iBAc5B,CAAC;AAIF,eAAO,MAAM,gBAAgB,EAAE,iBAkC9B,CAAC;AAIF,eAAO,MAAM,cAAc,EAAE,iBAmC5B,CAAC;AAIF,eAAO,MAAM,mBAAmB,EAAE,iBAgBjC,CAAC;AAIF,eAAO,MAAM,gBAAgB,EAAE,iBAQ9B,CAAC;AAIF,eAAO,MAAM,kBAAkB,EAAE,iBAAiB,EAMjD,CAAC"}

package/dist/validation/constraints.js

@@ -0,0 +1,131 @@
+// ---------------------------------------------------------------------------
+// Constraint handlers — individual input behavior decorators
+//
+// Design patterns used:
+//   - Strategy Pattern  : each constraint is an independent strategy object
+//   - Decorator Pattern : constraints add behavior to plain HTML inputs
+//                         via attribute-driven binding
+//   - Registry Pattern  : constraints are registered by name and looked up
+//                         from the `constraint` attribute at runtime
+// ---------------------------------------------------------------------------
+import { sprintf } from '../utils/sprintf.js';
+import { isDateValid } from '../utils/dom.js';
+// -- Date constraint --------------------------------------------------------
+export const dateConstraint = {
+    name: 'date',
+    attach(element) {
+        element.addEventListener('change', () => {
+            if (element.value !== '' && !isDateValid(element.value)) {
+                element.value = '';
+            }
+        });
+        // Disable IME for date input
+        element.style['imeMode'] = 'disabled';
+        element.setAttribute('inputmode', 'numeric');
+    },
+};
+// -- Number constraint ------------------------------------------------------
+export const numberConstraint = {
+    name: 'number',
+    attach(element) {
+        element.addEventListener('keydown', ((event) => {
+            // Allow: backspace, delete, tab, escape, enter, arrows, home, end
+            const allowedKeys = [
+                'Backspace', 'Delete', 'Tab', 'Escape', 'Enter',
+                'ArrowLeft', 'ArrowRight', 'ArrowUp', 'ArrowDown',
+                'Home', 'End',
+            ];
+            if (allowedKeys.includes(event.key))
+                return;
+            // Allow Ctrl/Cmd + A/C/V/X
+            if ((event.ctrlKey || event.metaKey) && ['a', 'c', 'v', 'x'].includes(event.key))
+                return;
+            // Allow digits, dot, minus
+            if (/[\d.\-]/.test(event.key))
+                return;
+            event.preventDefault();
+        }));
+        element.addEventListener('change', () => {
+            const val = element.value;
+            if (!/^-?[0-9]+(\.[0-9]+)?$/.test(val) || /^0\d+$/.test(val)) {
+                element.value = '0';
+            }
+        });
+        // Default empty number fields to 0
+        if (element.value === '') {
+            element.value = '0';
+        }
+        element.style['imeMode'] = 'disabled';
+        element.setAttribute('inputmode', 'decimal');
+    },
+};
+// -- Time constraint --------------------------------------------------------
+export const timeConstraint = {
+    name: 'time',
+    attach(element) {
+        element.addEventListener('blur', () => {
+            const input = element.value;
+            let hour = '00';
+            let minute = '00';
+            if (/^\d{1,4}$/.test(input)) {
+                hour = sprintf('%02s', input.substring(0, 2));
+                minute = sprintf('%02s', input.substring(2, 4));
+            }
+            else if (/^\d{0,2}:\d{0,2}$/.test(input)) {
+                const colonIdx = input.indexOf(':');
+                hour = sprintf('%02s', input.substring(0, colonIdx));
+                minute = sprintf('%02s', input.substring(colonIdx + 1));
+            }
+            element.value = `${hour}:${minute}`;
+        });
+        element.addEventListener('keydown', ((event) => {
+            const allowedKeys = [
+                'Backspace', 'Delete', 'Tab', 'Escape', 'Enter',
+                'ArrowLeft', 'ArrowRight', 'Home', 'End',
+            ];
+            if (allowedKeys.includes(event.key))
+                return;
+            if ((event.ctrlKey || event.metaKey) && ['a', 'c', 'v', 'x'].includes(event.key))
+                return;
+            if (/[\d:]/.test(event.key))
+                return;
+            event.preventDefault();
+        }));
+        element.style['imeMode'] = 'disabled';
+        element.setAttribute('inputmode', 'numeric');
+    },
+};
+// -- UpperCase constraint ---------------------------------------------------
+export const upperCaseConstraint = {
+    name: 'upperCase',
+    attach(element) {
+        let timeout;
+        element.addEventListener('keyup', () => {
+            clearTimeout(timeout);
+            timeout = setTimeout(() => {
+                const val = element.value;
+                if (/[a-z]/.test(val)) {
+                    element.value = val.toUpperCase();
+                }
+            }, 500);
+        });
+    },
+};
+// -- OnlyEn constraint ------------------------------------------------------
+export const onlyEnConstraint = {
+    name: 'onlyEn',
+    attach(element) {
+        element.style['imeMode'] = 'disabled';
+        element.setAttribute('inputmode', 'text');
+        element.setAttribute('lang', 'en');
+    },
+};
+// -- All built-in constraints -----------------------------------------------
+export const builtInConstraints = [
+    dateConstraint,
+    numberConstraint,
+    timeConstraint,
+    upperCaseConstraint,
+    onlyEnConstraint,
+];
+//# sourceMappingURL=constraints.js.map

package/dist/validation/constraints.js.map

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