@mono-lit/helper 0.0.2 → 0.0.4

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

@@ -1,76 +1,77 @@
-import { LitElement, TemplateResult } from 'lit';
-import { ButtonSize, ButtonColor, ButtonVariant, ButtonRounded, ButtonIconPosition, ButtonBadgeColor, ButtonCssClass, ButtonAffixProps, ButtonHandler } from './button-types.js';
-import { Constructor } from '../../composables/hybird-prop';
-import { buildSizeStyle, CssSizeValue } from '../../composables/css-size';
-import { DebounceConfig, RateLimitOption, ThrottleConfig } from '../../composables/rate-limit';
+import { Constructor } from "../../composables/hybird-prop.js";
+import { DebounceConfig, RateLimitOption, ThrottleConfig } from "../../composables/rate-limit.js";
+import { ButtonAffixProps, ButtonBadgeColor, ButtonColor, ButtonCssClass, ButtonHandler, ButtonIconPosition, ButtonRounded, ButtonSize, ButtonVariant } from "./button-types.js";
+import { CssSizeValue, buildSizeStyle } from "../../composables/css-size.js";
+import { LitElement, TemplateResult } from "lit";
+//#region src/components/button/button-core.d.ts
 type ButtonLikeElement = HTMLButtonElement | HTMLAnchorElement;
 /** Public + shared-protected surface added by the core mixin. */
 export declare class MonoButtonCoreInterface {
-    size: ButtonSize;
-    color: ButtonColor;
-    variant: ButtonVariant;
-    rounded?: ButtonRounded;
-    disabled: boolean;
-    loading: boolean;
-    width?: CssSizeValue;
-    height?: CssSizeValue;
-    minWidth?: CssSizeValue;
-    maxWidth?: CssSizeValue;
-    minHeight?: CssSizeValue;
-    maxHeight?: CssSizeValue;
-    href?: string;
-    target?: string;
-    type: 'button' | 'submit' | 'reset';
-    iconPosition: ButtonIconPosition;
-    prepend: ButtonAffixProps;
-    append: ButtonAffixProps;
-    badge?: string;
-    badgeColor: ButtonBadgeColor;
-    iconOnly: boolean;
-    glass: boolean;
-    tooltip?: string;
-    ariaLabelText?: string;
-    cssClass: ButtonCssClass;
-    throttle?: RateLimitOption<ThrottleConfig>;
-    debounce?: RateLimitOption<DebounceConfig>;
-    handler?: ButtonHandler;
-    noAutoLoading: boolean;
-    focus(): void;
-    blur(): void;
-    click(): void;
-    cancelPending(): void;
-    protected _hasIcon: boolean;
-    protected _hasPrepend: boolean;
-    protected _hasAppend: boolean;
-    /** The affix config for one side, always an object. */
-    protected _affix(name: 'prepend' | 'append'): ButtonAffixProps;
-    /** Whether that affix is inert — follows `disabled`, never `loading`. */
-    protected _affixDisabled(name: 'prepend' | 'append'): boolean;
-    protected _isActive: boolean;
-    protected _buttonElement?: ButtonLikeElement;
-    protected _cls(base: string, key: keyof ButtonCssClass): string;
-    protected _toBoolean(value: unknown): boolean;
-    protected _sizeStyle(): ReturnType<typeof buildSizeStyle>;
-    protected get _hasSize(): boolean;
-    protected _defaultIsEmpty(): boolean;
-    protected get _isIconOnlyLike(): boolean;
-    protected get _buttonClasses(): string;
-    protected _renderWrapper(inner: TemplateResult, style?: unknown): TemplateResult;
-    protected get _badgeClass(): string;
-    protected get _badgeColor(): string;
-    protected get _ariaLabel(): string | undefined;
-    /** Spinner visibility: the `loading` prop OR either self-driven phase. */
-    protected get _effectiveLoading(): boolean;
-    /** Where the spinner is drawn: in the icon position, whatever triggered loading. */
-    protected get _showsSpinner(): boolean;
-    /** A click does nothing observable (covers the wait as well as the work). */
-    protected get _isBlocked(): boolean;
-    /** The native `disabled` attribute — `_isBlocked` minus the wait. */
-    protected get _isInert(): boolean;
-    protected _handleClick(event: MouseEvent): void;
-    protected _handleKeyDown(event: KeyboardEvent): void;
-    protected _handleFocus(): void;
-    protected _handleBlur(): void;
+  size: ButtonSize;
+  color: ButtonColor;
+  variant: ButtonVariant;
+  rounded?: ButtonRounded;
+  disabled: boolean;
+  loading: boolean;
+  width?: CssSizeValue;
+  height?: CssSizeValue;
+  minWidth?: CssSizeValue;
+  maxWidth?: CssSizeValue;
+  minHeight?: CssSizeValue;
+  maxHeight?: CssSizeValue;
+  href?: string;
+  target?: string;
+  type: 'button' | 'submit' | 'reset';
+  iconPosition: ButtonIconPosition;
+  prepend: ButtonAffixProps;
+  append: ButtonAffixProps;
+  badge?: string;
+  badgeColor: ButtonBadgeColor;
+  iconOnly: boolean;
+  glass: boolean;
+  tooltip?: string;
+  ariaLabelText?: string;
+  cssClass: ButtonCssClass;
+  throttle?: RateLimitOption<ThrottleConfig>;
+  debounce?: RateLimitOption<DebounceConfig>;
+  handler?: ButtonHandler;
+  noAutoLoading: boolean;
+  focus(): void;
+  blur(): void;
+  click(): void;
+  cancelPending(): void;
+  protected _hasIcon: boolean;
+  protected _hasPrepend: boolean;
+  protected _hasAppend: boolean;
+  /** The affix config for one side, always an object. */
+  protected _affix(name: 'prepend' | 'append'): ButtonAffixProps;
+  /** Whether that affix is inert — follows `disabled`, never `loading`. */
+  protected _affixDisabled(name: 'prepend' | 'append'): boolean;
+  protected _isActive: boolean;
+  protected _buttonElement?: ButtonLikeElement;
+  protected _cls(base: string, key: keyof ButtonCssClass): string;
+  protected _toBoolean(value: unknown): boolean;
+  protected _sizeStyle(): ReturnType<typeof buildSizeStyle>;
+  protected get _hasSize(): boolean;
+  protected _defaultIsEmpty(): boolean;
+  protected get _isIconOnlyLike(): boolean;
+  protected get _buttonClasses(): string;
+  protected _renderWrapper(inner: TemplateResult, style?: unknown): TemplateResult;
+  protected get _badgeClass(): string;
+  protected get _badgeColor(): string;
+  protected get _ariaLabel(): string | undefined;
+  /** Spinner visibility: the `loading` prop OR either self-driven phase. */
+  protected get _effectiveLoading(): boolean;
+  /** Where the spinner is drawn: in the icon position, whatever triggered loading. */
+  protected get _showsSpinner(): boolean;
+  /** A click does nothing observable (covers the wait as well as the work). */
+  protected get _isBlocked(): boolean;
+  /** The native `disabled` attribute — `_isBlocked` minus the wait. */
+  protected get _isInert(): boolean;
+  protected _handleClick(event: MouseEvent): void;
+  protected _handleKeyDown(event: KeyboardEvent): void;
+  protected _handleFocus(): void;
+  protected _handleBlur(): void;
 }
 /**
  * `MonoButtonCore` — all render-mode-agnostic logic for `mono-button`: reactive
@@ -87,4 +88,5 @@ export declare class MonoButtonCoreInterface {
  * client-side.
  */
 export declare const MonoButtonCore: <T extends Constructor<LitElement>>(superClass: T) => Constructor<MonoButtonCoreInterface> & T;
-export {};
+//#endregion
+export {};

package/dist/src/components/button/button-dropdown-core.d.ts

@@ -1,57 +1,59 @@
-import { LitElement, nothing, TemplateResult } from 'lit';
-import { ButtonDropdownCssClass, ButtonDropdownItem } from './button-dropdown-types.js';
-import { ButtonProps } from './button-types.js';
-import { DropdownPlacement, DropdownSource } from '../dropdown/dropdown-types.js';
-import { Constructor } from '../../composables/hybird-prop';
+import { Constructor } from "../../composables/hybird-prop.js";
+import { ButtonProps } from "./button-types.js";
+import { DropdownPlacement, DropdownSource } from "../dropdown/dropdown-types.js";
+import { ButtonDropdownCssClass, ButtonDropdownItem } from "./button-dropdown-types.js";
+import { LitElement, TemplateResult, nothing } from "lit";
+//#region src/components/button/button-dropdown-core.d.ts
 /** Public surface added by the core mixin (for typing the wrappers + tag map). */
 export declare class MonoButtonDropdownCoreInterface {
-    buttons: ButtonDropdownItem[];
-    min: number;
-    placement: DropdownPlacement;
-    offset: number;
-    color?: ButtonProps['color'];
-    variant?: ButtonProps['variant'];
-    size?: ButtonProps['size'];
-    trigger?: ButtonProps & {
-        label?: string;
-        icon?: string;
-    };
-    modelValue: boolean;
-    disabled: boolean;
-    closeOnSelect: boolean;
-    closeOnOutsideClick: boolean;
-    closeOnEscape: boolean;
-    cssClass: ButtonDropdownCssClass;
-    show(source?: DropdownSource): void;
-    hide(source?: DropdownSource): void;
-    toggle(source?: DropdownSource): void;
-    /** Whether the entries are currently behind the trigger rather than inline. */
-    readonly collapsed: boolean;
-    /** Tag of the button element to render — differs per build. */
-    protected _buttonTag(): string;
-    /** Whether entry content may be a Lit template (shadow only — see the impl). */
-    protected _declarativeItems(): boolean;
-    protected _cls(base: string, key: keyof ButtonDropdownCssClass): string;
-    protected renderRow(): TemplateResult;
-    /** The `⋮` trigger, or `nothing` while the entries are inline. */
-    protected renderTrigger(): TemplateResult | typeof nothing;
-    /** The menu rows — rendered INSIDE the panel each build writes itself. */
-    protected renderMenuList(): TemplateResult;
-    /**
-     * The panel is deliberately NOT built here. `PopupPortalController` physically
-     * moves it into a `<body>` portal, and a node inside a `${}` expression carries
-     * a `ChildPart` range that breaks when its nodes are ejected ("this `ChildPart`
-     * has no `parentNode`"). Each build writes the panel as a STATIC element in its
-     * own template — the same arrangement `mono-dropdown` uses — and reads these.
-     */
-    protected readonly panelClass: string;
-    protected readonly panelHidden: boolean;
-    protected bindPanel: (el: Element | undefined) => void;
-    /** Ref for the inner root each build renders — where the styling attributes go. */
-    protected bindRoot: (el: Element | undefined) => void;
-    protected _computeRootAttrs(): Record<string, string | null>;
-    protected _applyRootAttrs(root: HTMLElement | null | undefined): void;
-    /** The `mono-item-color` an entry gets inside the menu (null = the panel's ink). */
-    protected _itemColorAttr(item: ButtonDropdownItem): string | null;
+  buttons: ButtonDropdownItem[];
+  min: number;
+  placement: DropdownPlacement;
+  offset: number;
+  color?: ButtonProps['color'];
+  variant?: ButtonProps['variant'];
+  size?: ButtonProps['size'];
+  trigger?: ButtonProps & {
+    label?: string;
+    icon?: string;
+  };
+  modelValue: boolean;
+  disabled: boolean;
+  closeOnSelect: boolean;
+  closeOnOutsideClick: boolean;
+  closeOnEscape: boolean;
+  cssClass: ButtonDropdownCssClass;
+  show(source?: DropdownSource): void;
+  hide(source?: DropdownSource): void;
+  toggle(source?: DropdownSource): void;
+  /** Whether the entries are currently behind the trigger rather than inline. */
+  readonly collapsed: boolean;
+  /** Tag of the button element to render — differs per build. */
+  protected _buttonTag(): string;
+  /** Whether entry content may be a Lit template (shadow only — see the impl). */
+  protected _declarativeItems(): boolean;
+  protected _cls(base: string, key: keyof ButtonDropdownCssClass): string;
+  protected renderRow(): TemplateResult;
+  /** The `⋮` trigger, or `nothing` while the entries are inline. */
+  protected renderTrigger(): TemplateResult | typeof nothing;
+  /** The menu rows — rendered INSIDE the panel each build writes itself. */
+  protected renderMenuList(): TemplateResult;
+  /**
+   * The panel is deliberately NOT built here. `PopupPortalController` physically
+   * moves it into a `<body>` portal, and a node inside a `${}` expression carries
+   * a `ChildPart` range that breaks when its nodes are ejected ("this `ChildPart`
+   * has no `parentNode`"). Each build writes the panel as a STATIC element in its
+   * own template — the same arrangement `mono-dropdown` uses — and reads these.
+   */
+  protected readonly panelClass: string;
+  protected readonly panelHidden: boolean;
+  protected bindPanel: (el: Element | undefined) => void;
+  /** Ref for the inner root each build renders — where the styling attributes go. */
+  protected bindRoot: (el: Element | undefined) => void;
+  protected _computeRootAttrs(): Record<string, string | null>;
+  protected _applyRootAttrs(root: HTMLElement | null | undefined): void;
+  /** The `mono-item-color` an entry gets inside the menu (null = the panel's ink). */
+  protected _itemColorAttr(item: ButtonDropdownItem): string | null;
 }
 export declare const MonoButtonDropdownCore: <T extends Constructor<LitElement>>(superClass: T) => Constructor<MonoButtonDropdownCoreInterface> & T;
+//#endregion

package/dist/src/components/button/button-dropdown-types.d.ts

@@ -1,7 +1,7 @@
-import { DropdownPlacement, DropdownSource } from '../dropdown/dropdown-types.js';
-import { ButtonEvents, ButtonProps } from './button-types.js';
-import { MonoEventProps } from '../../composables/element-props.js';
-export type { DropdownPlacement as ButtonDropdownPlacement };
+import { ButtonEvents, ButtonProps } from "./button-types.js";
+import { DropdownPlacement, DropdownSource } from "../dropdown/dropdown-types.js";
+import { MonoEventProps } from "../../composables/element-props.js";
+//#region src/components/button/button-dropdown-types.d.ts
 /**
  * One entry in `buttons`.
  *
@@ -10,33 +10,33 @@ export type { DropdownPlacement as ButtonDropdownPlacement };
  * everything else behave as they would on a standalone button.
  */
 export interface ButtonDropdownItem extends ButtonProps, Omit<MonoEventProps<ButtonEvents>, 'onClick'> {
-    /** Text of the button (and of its row in the menu). */
-    label?: string;
-    /**
-     * Icon class placed in the button's icon slot, e.g. `'i-mdi-pencil'`.
-     * `iconPosition` (inherited from `ButtonProps`) decides which side it sits on.
-     */
-    icon?: string;
-    /**
-     * Runs when this entry is clicked, before the element's own `click`.
-     * Bind the array with `.prop` — a function can't survive an attribute.
-     */
-    onClick?: (event: MouseEvent) => void;
-    /** Extra class on this entry's button. */
-    className?: string;
+  /** Text of the button (and of its row in the menu). */
+  label?: string;
+  /**
+   * Icon class placed in the button's icon slot, e.g. `'i-mdi-pencil'`.
+   * `iconPosition` (inherited from `ButtonProps`) decides which side it sits on.
+   */
+  icon?: string;
+  /**
+   * Runs when this entry is clicked, before the element's own `click`.
+   * Bind the array with `.prop` — a function can't survive an attribute.
+   */
+  onClick?: (event: MouseEvent) => void;
+  /** Extra class on this entry's button. */
+  className?: string;
 }
 /** Detail shared by `click` / `open` / `close`. */
 export interface ButtonDropdownClickEventDetail {
-    /** The entry that was activated (absent for open/close). */
-    item?: ButtonDropdownItem;
-    /** Its index in `buttons` (absent for open/close). */
-    index?: number;
-    /** Whether the menu is open after this event. */
-    modelValue: boolean;
-    /** Whether the entries are currently collapsed behind the trigger. */
-    collapsed: boolean;
-    source: DropdownSource;
-    sourceEvent?: Event;
+  /** The entry that was activated (absent for open/close). */
+  item?: ButtonDropdownItem;
+  /** Its index in `buttons` (absent for open/close). */
+  index?: number;
+  /** Whether the menu is open after this event. */
+  modelValue: boolean;
+  /** Whether the entries are currently collapsed behind the trigger. */
+  collapsed: boolean;
+  source: DropdownSource;
+  sourceEvent?: Event;
 }
 export type ButtonDropdownClickEvent = CustomEvent<ButtonDropdownClickEventDetail>;
 export type ButtonDropdownOpenEvent = CustomEvent<ButtonDropdownClickEventDetail>;
@@ -46,29 +46,29 @@ export type ButtonDropdownCloseEvent = CustomEvent<ButtonDropdownClickEventDetai
  * and camel — because `dispatchMonoEvent` emits both spellings.
  */
 export interface ButtonDropdownEvents {
-    click: ButtonDropdownClickEvent;
-    open: ButtonDropdownOpenEvent;
-    close: ButtonDropdownCloseEvent;
-    'mno-click': ButtonDropdownClickEvent;
-    mnoClick: ButtonDropdownClickEvent;
-    'mno-open': ButtonDropdownOpenEvent;
-    mnoOpen: ButtonDropdownOpenEvent;
-    'mno-close': ButtonDropdownCloseEvent;
-    mnoClose: ButtonDropdownCloseEvent;
+  click: ButtonDropdownClickEvent;
+  open: ButtonDropdownOpenEvent;
+  close: ButtonDropdownCloseEvent;
+  'mno-click': ButtonDropdownClickEvent;
+  mnoClick: ButtonDropdownClickEvent;
+  'mno-open': ButtonDropdownOpenEvent;
+  mnoOpen: ButtonDropdownOpenEvent;
+  'mno-close': ButtonDropdownCloseEvent;
+  mnoClose: ButtonDropdownCloseEvent;
 }
 /** Per-part class overrides. */
 export interface ButtonDropdownCssClass {
-    root?: string;
-    /** The inline row rendered when the entries are NOT collapsed. */
-    row?: string;
-    /** The `⋮` trigger button. */
-    trigger?: string;
-    /** The floating panel. */
-    panel?: string;
-    /** The `<ul>` inside the panel. */
-    list?: string;
-    /** Each `<li>`. */
-    item?: string;
+  root?: string;
+  /** The inline row rendered when the entries are NOT collapsed. */
+  row?: string;
+  /** The `⋮` trigger button. */
+  trigger?: string;
+  /** The floating panel. */
+  panel?: string;
+  /** The `<ul>` inside the panel. */
+  list?: string;
+  /** Each `<li>`. */
+  item?: string;
 }
 /**
  * Props for `<mono-button-dropdown>`.
@@ -78,52 +78,54 @@ export interface ButtonDropdownCssClass {
  * carry a stringified value.
  */
 export interface ButtonDropdownProps {
-    /** The actions. Each entry takes every `<mono-button>` prop. */
-    buttons?: ButtonDropdownItem[];
-    /**
-     * How many entries may render inline. While `buttons.length <= min` they are
-     * all shown as plain buttons; past that, ALL of them move into the dropdown and
-     * only the trigger remains. Default `1`.
-     */
-    min?: number;
-    /**
-     * Colors the `⋮` trigger. Entries are deliberately NOT colored inside the menu
-     * — an entry's own `color` tints its ICON there instead, since a list of
-     * differently-coloured buttons reads as noise. Outside the menu (inline, when
-     * the list is short enough) entries keep their real button styling.
-     */
-    color?: ButtonProps['color'];
-    /** Visual style of the `⋮` trigger — same values `<mono-button>` takes. */
-    variant?: ButtonProps['variant'];
-    /** Size of the `⋮` trigger. */
-    size?: ButtonProps['size'];
-    /** Corner radius of the `⋮` trigger — the same scale `<mono-button>` takes. */
-    rounded?: ButtonProps['rounded'];
-    /** Where the panel opens relative to the trigger. Default `'bottom-end'`. */
-    placement?: DropdownPlacement;
-    /** Gap in px between trigger and panel. Default `4`. */
-    offset?: number;
-    /**
-     * Props for the `⋮` trigger button — same shape as an entry, minus the click.
-     * The button's events are accepted as `on<Event>` keys (`onLoadingChange`, …).
-     */
-    trigger?: ButtonProps & MonoEventProps<ButtonEvents> & {
-        label?: string;
-        icon?: string;
-    };
-    /** Open state. Two-way is opt-in: listen for `open` / `close`. */
-    modelValue?: boolean;
-    'model-value'?: boolean;
-    /** Disables the trigger and every entry. */
-    disabled?: boolean;
-    /** Close when a menu entry is clicked. Default `true`. */
-    closeOnSelect?: boolean;
-    'close-on-select'?: boolean;
-    closeOnOutsideClick?: boolean;
-    'close-on-outside-click'?: boolean;
-    closeOnEscape?: boolean;
-    'close-on-escape'?: boolean;
-    cssClass?: ButtonDropdownCssClass;
-    'css-class'?: ButtonDropdownCssClass | string;
-    cssClassName?: string;
+  /** The actions. Each entry takes every `<mono-button>` prop. */
+  buttons?: ButtonDropdownItem[];
+  /**
+   * How many entries may render inline. While `buttons.length <= min` they are
+   * all shown as plain buttons; past that, ALL of them move into the dropdown and
+   * only the trigger remains. Default `1`.
+   */
+  min?: number;
+  /**
+   * Colors the `⋮` trigger. Entries are deliberately NOT colored inside the menu
+   * — an entry's own `color` tints its ICON there instead, since a list of
+   * differently-coloured buttons reads as noise. Outside the menu (inline, when
+   * the list is short enough) entries keep their real button styling.
+   */
+  color?: ButtonProps['color'];
+  /** Visual style of the `⋮` trigger — same values `<mono-button>` takes. */
+  variant?: ButtonProps['variant'];
+  /** Size of the `⋮` trigger. */
+  size?: ButtonProps['size'];
+  /** Corner radius of the `⋮` trigger — the same scale `<mono-button>` takes. */
+  rounded?: ButtonProps['rounded'];
+  /** Where the panel opens relative to the trigger. Default `'bottom-end'`. */
+  placement?: DropdownPlacement;
+  /** Gap in px between trigger and panel. Default `4`. */
+  offset?: number;
+  /**
+   * Props for the `⋮` trigger button — same shape as an entry, minus the click.
+   * The button's events are accepted as `on<Event>` keys (`onLoadingChange`, …).
+   */
+  trigger?: ButtonProps & MonoEventProps<ButtonEvents> & {
+    label?: string;
+    icon?: string;
+  };
+  /** Open state. Two-way is opt-in: listen for `open` / `close`. */
+  modelValue?: boolean;
+  'model-value'?: boolean;
+  /** Disables the trigger and every entry. */
+  disabled?: boolean;
+  /** Close when a menu entry is clicked. Default `true`. */
+  closeOnSelect?: boolean;
+  'close-on-select'?: boolean;
+  closeOnOutsideClick?: boolean;
+  'close-on-outside-click'?: boolean;
+  closeOnEscape?: boolean;
+  'close-on-escape'?: boolean;
+  cssClass?: ButtonDropdownCssClass;
+  'css-class'?: ButtonDropdownCssClass | string;
+  cssClassName?: string;
 }
+//#endregion
+export type { DropdownPlacement as ButtonDropdownPlacement };