@stimulus-plumbers/controllers 0.2.8 → 0.2.9

package/src/plumbers/{input_format/formatters → formatters}/credit_card.js

@@ -32,7 +32,7 @@ const VALID_CARD_LENGTH = /^\d{13,19}$/;
 /** Captures groups of up to 4 characters followed by at least one more character */
 const GROUP_FOUR_DIGITS = /(.{4})(?=.)/g;
 
-export const CreditCardInputFormatter = {
+export const CreditCardFormatter = {
   /**
    * Converts raw input to the canonical stored form: digits only, no separators.
    * e.g. '4242 4242 4242 4242' → '4242424242424242'

package/src/plumbers/{input_format/formatters → formatters}/currency.js

@@ -4,7 +4,7 @@ const STRIP_NON_NUMERIC = /[^\d.,-]/g;
 /** Matches a valid canonical amount: optional negative sign, digits, optional decimal part */
 const VALID_AMOUNT_PATTERN = /^-?\d+(\.\d+)?$/;
 
-export const CurrencyInputFormatter = {
+export const CurrencyFormatter = {
   /**
    * Converts raw input to the canonical stored form: a plain decimal number string.
    * Handles US format (1,234.56), European format (1.234,56), and integers ($1,000).

package/src/plumbers/{input_format/formatters → formatters}/date.js

@@ -7,7 +7,7 @@ const SEPARATED_DATE_PATTERN = /^(\d{1,4})[/\-.](\d{1,2})[/\-.](\d{1,4})$/;
 /** Strips all non-digit characters (used when extracting 8-digit compact dates) */
 const STRIP_NON_DIGITS = /\D/g;
 
-export const DateInputFormatter = {
+export const DateFormatter = {
   /**
    * Converts raw input to the canonical stored form: ISO 8601 YYYY-MM-DD.
    * Accepts a variety of common date formats:
@@ -61,7 +61,7 @@ export const DateInputFormatter = {
    */
   validate(value) {
     if (typeof value !== 'string') return false;
-    const iso = DateInputFormatter.normalize(value);
+    const iso = DateFormatter.normalize(value);
     if (!ISO_DATE_PATTERN.test(iso)) return false;
     const date = new Date(`${iso}T00:00:00Z`);
     return !isNaN(date.getTime()) && date.toISOString().startsWith(iso);

package/src/plumbers/{input_format/formatters → formatters}/phone.js

@@ -18,7 +18,7 @@ const STRIP_NON_DIGITS = /\D/g;
 /** Matches an E.164 international phone number: + followed by 7–15 digits */
 const E164_PATTERN = /^\+\d{7,15}$/;
 
-export const PhoneInputFormatter = {
+export const PhoneFormatter = {
   /**
    * Converts raw input to canonical form.
    * If input starts with '+', produces E.164 (+digits); otherwise strips to digits only.

package/src/plumbers/{input_format/formatters → formatters}/plain.js

@@ -1,4 +1,4 @@
-export const PlainInputFormatter = {
+export const PlainFormatter = {
   normalize(raw) {
     if (typeof raw !== 'string') return '';
     return raw;

package/src/plumbers/{input_format/formatters → formatters}/time.js

@@ -1,7 +1,7 @@
 /** Matches a 24-hour time: HH:MM */
 const H24_PATTERN = /^([01]?\d|2[0-3]):([0-5]\d)$/;
 
-export const TimeInputFormatter = {
+export const TimeFormatter = {
   /**
    * Converts raw input to canonical 24-hour form: HH:MM.
    * Accepts HH:MM (24h) and h:mm AM/PM (12h).
@@ -38,7 +38,7 @@ export const TimeInputFormatter = {
    * @returns {boolean}
    */
   validate(value) {
-    return TimeInputFormatter.normalize(value) !== '';
+    return TimeFormatter.normalize(value) !== '';
   },
 
   /**

package/src/plumbers/index.js

@@ -7,6 +7,6 @@ export { initComboboxDropdown } from './combobox_dropdown';
 export { attachContentLoader } from './content_loader';
 export { attachDismisser } from './dismisser';
 export { attachFlipper } from './flipper';
-export { attachInputFormat } from './input_format';
+export { attachFormatter } from './formatter';
 export { attachShifter } from './shifter';
 export { attachVisibility } from './visibility';

package/src/plumbers/input_format/index.js

@@ -1,90 +0,0 @@
-import Plumber from '../plumber';
-import { PlainInputFormatter } from './formatters/plain';
-import { CreditCardInputFormatter } from './formatters/credit_card';
-import { PhoneInputFormatter } from './formatters/phone';
-import { CurrencyInputFormatter } from './formatters/currency';
-import { DateInputFormatter } from './formatters/date';
-import { TimeInputFormatter } from './formatters/time';
-
-export { PlainInputFormatter } from './formatters/plain';
-export { CreditCardInputFormatter } from './formatters/credit_card';
-export { PhoneInputFormatter } from './formatters/phone';
-export { CurrencyInputFormatter } from './formatters/currency';
-export { DateInputFormatter } from './formatters/date';
-export { TimeInputFormatter } from './formatters/time';
-
-export const FORMATTER_TYPES = {
-  PLAIN: 'plain',
-  CREDIT_CARD: 'creditCard',
-  PHONE: 'phone',
-  CURRENCY: 'currency',
-  DATE: 'date',
-  TIME: 'time',
-};
-
-const registry = new Map([
-  [FORMATTER_TYPES.PLAIN, PlainInputFormatter],
-  [FORMATTER_TYPES.CREDIT_CARD, CreditCardInputFormatter],
-  [FORMATTER_TYPES.PHONE, PhoneInputFormatter],
-  [FORMATTER_TYPES.CURRENCY, CurrencyInputFormatter],
-  [FORMATTER_TYPES.DATE, DateInputFormatter],
-  [FORMATTER_TYPES.TIME, TimeInputFormatter],
-]);
-
-const defaultOptions = {
-  type: FORMATTER_TYPES.PLAIN,
-  options: {},
-};
-
-export class InputFormat extends Plumber {
-  /**
-   * Registers a custom input formatter for a given type identifier.
-   * @param {string} type - The type identifier (e.g. 'iban')
-   * @param {Object} formatter - Object with normalize, validate, and optionally format/mask methods
-   */
-  static register(type, formatter) {
-    registry.set(type, formatter);
-  }
-
-  /**
-   * Creates a new InputFormat plumber instance.
-   * @param {Object} controller - Stimulus controller instance
-   * @param {Object} [options] - Configuration options
-   * @param {string} [options.type='plain'] - Formatter type identifier
-   * @param {Object} [options.options={}] - Type-specific options (e.g. locale, currency)
-   */
-  constructor(controller, options = {}) {
-    super(controller, options);
-    this.type = options.type ?? defaultOptions.type;
-    this.options = options.options ?? defaultOptions.options;
-    this.enhance();
-  }
-
-  enhance() {
-    const context = this;
-    const formatter = registry.get(context.type) ?? registry.get(FORMATTER_TYPES.PLAIN);
-
-    const helpers = {
-      normalize: (raw) => formatter.normalize?.(raw, context.options) ?? (typeof raw === 'string' ? raw : ''),
-      validate: (value) => formatter.validate?.(value, context.options) ?? true,
-      format: (value) => formatter.format?.(value, context.options) ?? (typeof value === 'string' ? value : ''),
-      mask: (value) => formatter.mask?.(value, context.options) ?? null,
-      maskable: () => typeof formatter.mask === 'function',
-    };
-
-    Object.defineProperty(this.controller, 'inputFormat', {
-      get() {
-        return helpers;
-      },
-      configurable: true,
-    });
-  }
-}
-
-/**
- * Factory function to create and attach an InputFormat plumber to a controller.
- * @param {Object} controller - Stimulus controller instance
- * @param {Object} [options] - Configuration options
- * @returns {InputFormat} InputFormat plumber instance
- */
-export const attachInputFormat = (controller, options) => new InputFormat(controller, options);