@mono-lit/helper 0.0.1 → 0.0.3

package/dist/src/components/input/input-core.d.ts

@@ -1,79 +1,80 @@
-import { LitElement, nothing, TemplateResult } from 'lit';
-import { InputType, InputSize, InputColor, InputVariant, InputValidationState, InputCssClass } from './input-types.js';
-import { InputFormat, InputFormatOn } from './input-format.js';
-import { Constructor } from '../../composables/hybird-prop';
-import { buildSizeStyle, CssSizeValue } from '../../composables/css-size';
+import { Constructor } from "../../composables/hybird-prop.js";
+import { CssSizeValue, buildSizeStyle } from "../../composables/css-size.js";
+import { InputFormat, InputFormatOn } from "./input-format.js";
+import { InputColor, InputCssClass, InputSize, InputType, InputValidationState, InputVariant } from "./input-types.js";
+import { LitElement, TemplateResult, nothing } from "lit";
+//#region src/components/input/input-core.d.ts
 export declare const numberStringConverter: {
-    fromAttribute(value: string | null): number | undefined;
-    toAttribute(value: number | undefined): string | null;
+  fromAttribute(value: string | null): number | undefined;
+  toAttribute(value: number | undefined): string | null;
 };
 export type InputSlotName = 'prefix' | 'suffix' | 'label' | 'helper';
 /** Public surface added by the core mixin (for typing the wrappers + tag map). */
 export declare class MonoInputCoreInterface {
-    cssClass: InputCssClass;
-    cssClassName: string;
-    type: InputType;
-    size: InputSize;
-    color: InputColor;
-    variant: InputVariant;
-    modelValue: string;
-    formatDisplay?: InputFormat;
-    formatValue?: InputFormat;
-    formatOn: InputFormatOn;
-    formatLocale?: string;
-    value: string;
-    name: string;
-    placeholder: string;
-    label: string;
-    helperText: string;
-    validationState: InputValidationState;
-    validationMessage: string;
-    error: boolean;
-    errorMessage: string;
-    success: boolean;
-    successMessage: string;
-    pattern: string;
-    autocomplete: string;
-    inputmode: string;
-    ariaLabelText?: string;
-    minLength?: number;
-    maxLength?: number;
-    min?: number;
-    max?: number;
-    step?: number;
-    disabled: boolean;
-    readonly: boolean;
-    required: boolean;
-    clearable: boolean;
-    autofocus: boolean;
-    width?: CssSizeValue;
-    height?: CssSizeValue;
-    minWidth?: CssSizeValue;
-    maxWidth?: CssSizeValue;
-    minHeight?: CssSizeValue;
-    maxHeight?: CssSizeValue;
-    focus(): void;
-    blur(): void;
-    select(): void;
-    protected _hasPrefixSlotState: boolean;
-    protected _hasSuffixSlotState: boolean;
-    protected _hasLabelSlotState: boolean;
-    protected _hasHelperSlotState: boolean;
-    protected readonly _hasPrefixSlot: boolean;
-    protected readonly _hasSuffixSlot: boolean;
-    protected readonly _hasLabelSlot: boolean;
-    protected readonly _hasHelperSlot: boolean;
-    protected readonly _inputId: string;
-    protected readonly _messageId: string;
-    protected readonly _resolvedValidationState: InputValidationState;
-    protected readonly _wrapperClasses: string;
-    protected readonly _fieldClasses: string;
-    protected _cls(base: string, key: keyof InputCssClass): string;
-    protected _sizeStyle(): ReturnType<typeof buildSizeStyle>;
-    protected _renderWrapper(inner: TemplateResult): TemplateResult;
-    protected _renderNative(): TemplateResult;
-    protected _renderClear(): TemplateResult | typeof nothing;
-    protected renderIcon(name: 'close'): TemplateResult;
+  cssClass: InputCssClass;
+  cssClassName: string;
+  type: InputType;
+  size: InputSize;
+  color: InputColor;
+  variant: InputVariant;
+  modelValue: string;
+  formatDisplay?: InputFormat;
+  formatValue?: InputFormat;
+  formatOn: InputFormatOn;
+  formatLocale?: string;
+  value: string;
+  name: string;
+  placeholder: string;
+  label: string;
+  helperText: string;
+  validationState: InputValidationState;
+  validationMessage: string;
+  error: boolean;
+  errorMessage: string;
+  success: boolean;
+  successMessage: string;
+  pattern: string;
+  autocomplete: string;
+  inputmode: string;
+  ariaLabelText?: string;
+  minLength?: number;
+  maxLength?: number;
+  min?: number;
+  max?: number;
+  step?: number;
+  disabled: boolean;
+  readonly: boolean;
+  required: boolean;
+  clearable: boolean;
+  autofocus: boolean;
+  width?: CssSizeValue;
+  height?: CssSizeValue;
+  minWidth?: CssSizeValue;
+  maxWidth?: CssSizeValue;
+  minHeight?: CssSizeValue;
+  maxHeight?: CssSizeValue;
+  focus(): void;
+  blur(): void;
+  select(): void;
+  protected _hasPrefixSlotState: boolean;
+  protected _hasSuffixSlotState: boolean;
+  protected _hasLabelSlotState: boolean;
+  protected _hasHelperSlotState: boolean;
+  protected readonly _hasPrefixSlot: boolean;
+  protected readonly _hasSuffixSlot: boolean;
+  protected readonly _hasLabelSlot: boolean;
+  protected readonly _hasHelperSlot: boolean;
+  protected readonly _inputId: string;
+  protected readonly _messageId: string;
+  protected readonly _resolvedValidationState: InputValidationState;
+  protected readonly _wrapperClasses: string;
+  protected readonly _fieldClasses: string;
+  protected _cls(base: string, key: keyof InputCssClass): string;
+  protected _sizeStyle(): ReturnType<typeof buildSizeStyle>;
+  protected _renderWrapper(inner: TemplateResult): TemplateResult;
+  protected _renderNative(): TemplateResult;
+  protected _renderClear(): TemplateResult | typeof nothing;
+  protected renderIcon(name: 'close'): TemplateResult;
 }
 /**
  * `MonoInputCore` — all render-mode-agnostic logic for `mono-input`: reactive
@@ -89,3 +90,4 @@ export declare class MonoInputCoreInterface {
  *    class getters.
  */
 export declare const MonoInputCore: <T extends Constructor<LitElement>>(superClass: T) => Constructor<MonoInputCoreInterface> & T;
+//#endregion

package/dist/src/components/input/input-format.d.ts

@@ -1,3 +1,4 @@
+//#region src/components/input/input-format.d.ts
 /**
  * `<mono-input>` value formatting — the pattern dialect, and the caret maths that make it usable
  * while typing.
@@ -34,32 +35,32 @@
 export type InputFormatOn = 'input' | 'blur';
 /** What a format FUNCTION receives. */
 export interface InputFormatCtx {
-    /** The typed text with any formatting removed — the raw value. */
-    value: string;
-    /** The input's `type`, so one function can serve several fields. */
-    type: string;
-    /** The resolved locale, when one was given. */
-    locale?: string;
+  /** The typed text with any formatting removed — the raw value. */
+  value: string;
+  /** The input's `type`, so one function can serve several fields. */
+  type: string;
+  /** The resolved locale, when one was given. */
+  locale?: string;
 }
 /** A pattern string, or a function that returns the finished text. */
 export type InputFormat = string | ((ctx: InputFormatCtx) => string);
 /** A parsed pattern. */
 export type InputFormatDescriptor = {
-    kind: 'number';
-    grouping: boolean;
-    minFraction: number;
-    maxFraction: number;
-    prefix: string;
-    suffix: string;
+  kind: 'number';
+  grouping: boolean;
+  minFraction: number;
+  maxFraction: number;
+  prefix: string;
+  suffix: string;
 } | {
-    kind: 'template';
-    before: string;
-    after: string;
+  kind: 'template';
+  before: string;
+  after: string;
 };
 /** The characters a locale draws a grouped decimal number with. */
 export interface LocaleSeparators {
-    group: string;
-    decimal: string;
+  group: string;
+  decimal: string;
 }
 /**
  * Ask `Intl` which characters this locale uses, rather than assuming `,` and `.`.
@@ -86,7 +87,7 @@ export declare function stripFormat(text: string, descriptor: InputFormatDescrip
  * grouped; the fraction is carried through verbatim, clamped to the pattern's ceiling.
  */
 export declare function applyFormat(raw: string, descriptor: InputFormatDescriptor | null, locale?: string, opts?: {
-    pad?: boolean;
+  pad?: boolean;
 }): string;
 /**
  * Normalise a raw value for the VALUE side.
@@ -113,6 +114,7 @@ export declare function caretAfterFormat(next: string, caretInPrev: number, prev
 export declare function significantFor(descriptor: InputFormatDescriptor | null, locale?: string): (ch: string) => boolean;
 /** Resolve either form of a format prop to its finished text. */
 export declare function resolveFormat(format: InputFormat | undefined, raw: string, ctx: {
-    type: string;
-    locale?: string;
+  type: string;
+  locale?: string;
 }, mode: 'display' | 'value'): string | null;
+//#endregion

package/dist/src/components/input/input-types.d.ts

@@ -1,179 +1,181 @@
-import { VisibilityProps } from '../../composables/visibility';
-import { InputFormat, InputFormatCtx, InputFormatOn } from './input-format.js';
-export type { InputFormat, InputFormatCtx, InputFormatOn };
+import { VisibilityProps } from "../../composables/visibility.js";
+import { InputFormat, InputFormatCtx, InputFormatOn } from "./input-format.js";
+//#region src/components/input/input-types.d.ts
 export type InputType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'date' | 'time' | 'month' | 'week' | 'search';
 export type InputSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
 export type InputVariant = 'outlined' | 'filled' | 'underlined';
 export type InputColor = 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info' | 'teal' | 'purple' | 'neutral' | 'dark';
 export type InputValidationState = 'default' | 'valid' | 'invalid' | 'warning';
 export type InputModelEventDetail = {
-    modelValue: string;
-    currentValue: string;
-    oldValue: string;
-    value: string;
-    name?: string;
-    sourceEvent?: Event;
-    /** What the field is SHOWING — differs from `value` once a `format-display` is set. */
-    displayValue?: string;
+  modelValue: string;
+  currentValue: string;
+  oldValue: string;
+  value: string;
+  name?: string;
+  sourceEvent?: Event;
+  /** What the field is SHOWING — differs from `value` once a `format-display` is set. */
+  displayValue?: string;
 };
 export interface InputCssClass {
-    root?: string;
-    label?: string;
-    required?: string;
-    field?: string;
-    prefix?: string;
-    native?: string;
-    clear?: string;
-    suffix?: string;
-    messageWrap?: string;
-    message?: string;
+  root?: string;
+  label?: string;
+  required?: string;
+  field?: string;
+  prefix?: string;
+  native?: string;
+  clear?: string;
+  suffix?: string;
+  messageWrap?: string;
+  message?: string;
 }
 export type InputModelEvent = CustomEvent<InputModelEventDetail>;
 export interface InputProps extends VisibilityProps {
-    /** Native input type controlling the field's behavior and keyboard. */
-    type?: InputType;
-    /** Visual size of the input field. */
-    size?: InputSize;
-    /** Theme color applied to focus, borders, and accents. */
-    color?: InputColor;
-    /** Visual style of the field (outlined, filled, or underlined). */
-    variant?: InputVariant;
-    /** Placeholder text shown when the field is empty. */
-    placeholder?: string;
-    /** Current input value. */
-    value?: string | number;
-    /** Form field name submitted with the input. */
-    name?: string;
-    /** Two-way bound value for v-model-style usage. */
-    modelValue?: string;
-    'model-value'?: string;
-    modelvalue?: string;
-    /**
-     * How the field is DISPLAYED — a pattern (`#,##0.##`, `{}@gmail.com`) or a function.
-     * Never changes the value. A numeric pattern requires `type="text"`.
-     */
-    formatDisplay?: InputFormat;
-    'format-display'?: InputFormat;
-    formatdisplay?: InputFormat;
-    /**
-     * How the VALUE is shaped. A numeric pattern normalises to a plain numeric string
-     * (`"10000000.25"`); a template assembles the full string.
-     */
-    formatValue?: InputFormat;
-    'format-value'?: InputFormat;
-    formatvalue?: InputFormat;
-    /** When the display reformats: `'input'` (default) or `'blur'`. */
-    formatOn?: InputFormatOn;
-    'format-on'?: InputFormatOn;
-    formaton?: InputFormatOn;
-    /** Locale a numeric pattern is drawn with — the pattern is a shape, the locale the characters. */
-    formatLocale?: string;
-    'format-locale'?: string;
-    formatlocale?: string;
-    /** Disables interaction and dims the field. */
-    disabled?: boolean;
-    /** Makes the field read-only while still focusable. */
-    readonly?: boolean;
-    /** Shows a clear button when the field has a value. */
-    clearable?: boolean;
-    /** Marks the field as required and shows a required indicator. */
-    required?: boolean;
-    /** Focuses the field automatically on first render. */
-    autofocus?: boolean;
-    /** Label text displayed above the field. */
-    label?: string;
-    /** Helper text shown below the field. */
-    helperText?: string;
-    'helper-text'?: string;
-    helpertext?: string;
-    /** Explicit validation state for styling and messaging. */
-    validationState?: InputValidationState;
-    'validation-state'?: InputValidationState;
-    validationstate?: InputValidationState;
-    /** Validation message shown below the field. */
-    validationMessage?: string;
-    'validation-message'?: string;
-    validationmessage?: string;
-    /** Marks the field in an error state. */
-    error?: boolean;
-    /** Error message shown below the field. */
-    errorMessage?: string;
-    'error-message'?: string;
-    errormessage?: string;
-    /** Marks the field in a success state. */
-    success?: boolean;
-    /** Success message shown below the field. */
-    successMessage?: string;
-    'success-message'?: string;
-    successmessage?: string;
-    /** Accessible label for the input element. */
-    ariaLabelText?: string;
-    /** Shorter alias for the accessible label. */
-    ariaLabel?: string;
-    'aria-label'?: string;
-    'aria-label-text'?: string;
-    arialabel?: string;
-    arialabeltext?: string;
-    /** Minimum allowed input length. */
-    minLength?: number;
-    'min-length'?: number;
-    minlength?: number;
-    /** Maximum allowed input length. */
-    maxLength?: number;
-    'max-length'?: number;
-    maxlength?: number;
-    /**
-     * Minimum value. On a field with a NUMBER `format` this clamps the typed value on commit
-     * (never while typing — a lower bound is crossed on the way to most legal values). On every
-     * other type it is the native attribute.
-     */
-    min?: number | string;
-    /**
-     * Maximum value. On a field with a NUMBER `format` this clamps the typed value AS YOU TYPE, so
-     * the field cannot be pushed past it. On every other type it is the native attribute — note the
-     * platform ignores it on `type="text"`, which a numeric format requires.
-     */
-    max?: number | string;
-    /** Step increment for numeric or date inputs. */
-    step?: number | string;
-    /** Validation pattern the value must match. */
-    pattern?: string;
-    /** Native autocomplete hint for the field. */
-    autocomplete?: string;
-    /** Native inputmode hint for the on-screen keyboard. */
-    inputmode?: string;
-    /**
-     * Explicit sizing. Each accepts a CSS length string (`"320px"`, `"80%"`) or a
-     * number (interpreted as px). Use `width="100%"` for a full-width field.
-     */
-    width?: string | number;
-    height?: string | number;
-    minWidth?: string | number;
-    'min-width'?: string | number;
-    maxWidth?: string | number;
-    'max-width'?: string | number;
-    minHeight?: string | number;
-    'min-height'?: string | number;
-    maxHeight?: string | number;
-    'max-height'?: string | number;
-    /** Per-part class overrides for internal elements. */
-    cssClass?: InputCssClass;
-    /**
-     * Simple HTML root class only.
-     *
-     * Example:
-     * <mono-input css-class="premium-input"></mono-input>
-     */
-    'css-class'?: string;
+  /** Native input type controlling the field's behavior and keyboard. */
+  type?: InputType;
+  /** Visual size of the input field. */
+  size?: InputSize;
+  /** Theme color applied to focus, borders, and accents. */
+  color?: InputColor;
+  /** Visual style of the field (outlined, filled, or underlined). */
+  variant?: InputVariant;
+  /** Placeholder text shown when the field is empty. */
+  placeholder?: string;
+  /** Current input value. */
+  value?: string | number;
+  /** Form field name submitted with the input. */
+  name?: string;
+  /** Two-way bound value for v-model-style usage. */
+  modelValue?: string;
+  'model-value'?: string;
+  modelvalue?: string;
+  /**
+   * How the field is DISPLAYED — a pattern (`#,##0.##`, `{}@gmail.com`) or a function.
+   * Never changes the value. A numeric pattern requires `type="text"`.
+   */
+  formatDisplay?: InputFormat;
+  'format-display'?: InputFormat;
+  formatdisplay?: InputFormat;
+  /**
+   * How the VALUE is shaped. A numeric pattern normalises to a plain numeric string
+   * (`"10000000.25"`); a template assembles the full string.
+   */
+  formatValue?: InputFormat;
+  'format-value'?: InputFormat;
+  formatvalue?: InputFormat;
+  /** When the display reformats: `'input'` (default) or `'blur'`. */
+  formatOn?: InputFormatOn;
+  'format-on'?: InputFormatOn;
+  formaton?: InputFormatOn;
+  /** Locale a numeric pattern is drawn with — the pattern is a shape, the locale the characters. */
+  formatLocale?: string;
+  'format-locale'?: string;
+  formatlocale?: string;
+  /** Disables interaction and dims the field. */
+  disabled?: boolean;
+  /** Makes the field read-only while still focusable. */
+  readonly?: boolean;
+  /** Shows a clear button when the field has a value. */
+  clearable?: boolean;
+  /** Marks the field as required and shows a required indicator. */
+  required?: boolean;
+  /** Focuses the field automatically on first render. */
+  autofocus?: boolean;
+  /** Label text displayed above the field. */
+  label?: string;
+  /** Helper text shown below the field. */
+  helperText?: string;
+  'helper-text'?: string;
+  helpertext?: string;
+  /** Explicit validation state for styling and messaging. */
+  validationState?: InputValidationState;
+  'validation-state'?: InputValidationState;
+  validationstate?: InputValidationState;
+  /** Validation message shown below the field. */
+  validationMessage?: string;
+  'validation-message'?: string;
+  validationmessage?: string;
+  /** Marks the field in an error state. */
+  error?: boolean;
+  /** Error message shown below the field. */
+  errorMessage?: string;
+  'error-message'?: string;
+  errormessage?: string;
+  /** Marks the field in a success state. */
+  success?: boolean;
+  /** Success message shown below the field. */
+  successMessage?: string;
+  'success-message'?: string;
+  successmessage?: string;
+  /** Accessible label for the input element. */
+  ariaLabelText?: string;
+  /** Shorter alias for the accessible label. */
+  ariaLabel?: string;
+  'aria-label'?: string;
+  'aria-label-text'?: string;
+  arialabel?: string;
+  arialabeltext?: string;
+  /** Minimum allowed input length. */
+  minLength?: number;
+  'min-length'?: number;
+  minlength?: number;
+  /** Maximum allowed input length. */
+  maxLength?: number;
+  'max-length'?: number;
+  maxlength?: number;
+  /**
+   * Minimum value. On a field with a NUMBER `format` this clamps the typed value on commit
+   * (never while typing — a lower bound is crossed on the way to most legal values). On every
+   * other type it is the native attribute.
+   */
+  min?: number | string;
+  /**
+   * Maximum value. On a field with a NUMBER `format` this clamps the typed value AS YOU TYPE, so
+   * the field cannot be pushed past it. On every other type it is the native attribute — note the
+   * platform ignores it on `type="text"`, which a numeric format requires.
+   */
+  max?: number | string;
+  /** Step increment for numeric or date inputs. */
+  step?: number | string;
+  /** Validation pattern the value must match. */
+  pattern?: string;
+  /** Native autocomplete hint for the field. */
+  autocomplete?: string;
+  /** Native inputmode hint for the on-screen keyboard. */
+  inputmode?: string;
+  /**
+   * Explicit sizing. Each accepts a CSS length string (`"320px"`, `"80%"`) or a
+   * number (interpreted as px). Use `width="100%"` for a full-width field.
+   */
+  width?: string | number;
+  height?: string | number;
+  minWidth?: string | number;
+  'min-width'?: string | number;
+  maxWidth?: string | number;
+  'max-width'?: string | number;
+  minHeight?: string | number;
+  'min-height'?: string | number;
+  maxHeight?: string | number;
+  'max-height'?: string | number;
+  /** Per-part class overrides for internal elements. */
+  cssClass?: InputCssClass;
+  /**
+   * Simple HTML root class only.
+   *
+   * Example:
+   * <mono-input css-class="premium-input"></mono-input>
+   */
+  'css-class'?: string;
 }
 export interface InputEvents {
-    input: InputModelEvent;
-    change: InputModelEvent;
-    clear: InputModelEvent;
-    'mno-input': InputModelEvent;
-    mnoInput: InputModelEvent;
-    'mno-change': InputModelEvent;
-    mnoChange: InputModelEvent;
-    'mno-clear': InputModelEvent;
-    mnoClear: InputModelEvent;
+  input: InputModelEvent;
+  change: InputModelEvent;
+  clear: InputModelEvent;
+  'mno-input': InputModelEvent;
+  mnoInput: InputModelEvent;
+  'mno-change': InputModelEvent;
+  mnoChange: InputModelEvent;
+  'mno-clear': InputModelEvent;
+  mnoClear: InputModelEvent;
 }
+//#endregion
+export type { InputFormat, InputFormatCtx, InputFormatOn };

package/dist/src/components/input/input-utils.d.ts

@@ -1,10 +1,12 @@
-import { InputType, InputSize, InputColor, InputVariant } from './input-types.js';
+import { InputColor, InputSize, InputType, InputVariant } from "./input-types.js";
+//#region src/components/input/input-utils.d.ts
 export declare function validateInputProps(props: {
-    type?: InputType;
-    size?: InputSize;
-    color?: InputColor;
-    variant?: InputVariant;
+  type?: InputType;
+  size?: InputSize;
+  color?: InputColor;
+  variant?: InputVariant;
 }): boolean;
 export declare function generateInputAttributes(type: InputType, disabled: boolean, readonly: boolean, required: boolean, pattern?: string, min?: number | string, max?: number | string, step?: number | string, placeholder?: string): Record<string, string | number | boolean | undefined>;
 export declare function generateInputAriaAttributes(disabled: boolean, readonly: boolean, required: boolean, hasError: boolean, label?: string, errorMessage?: string): Record<string, string | undefined>;
 export declare function getInputIcon(type: InputType): string;
+//#endregion