@mono-lit/helper 0.0.1 → 0.0.3

package/dist/src/components/breadcrumb/mono-breadcrumb.d.ts

@@ -1,5 +1,8 @@
-import { LitElement, TemplateResult } from 'lit';
-declare const MonoBreadcrumb_base: import('../../composables/hybird-prop').Constructor<import('./breadcrumb-core.js').MonoBreadcrumbCoreInterface> & typeof LitElement;
+import { Constructor } from "../../composables/hybird-prop.js";
+import { MonoBreadcrumbCoreInterface } from "./breadcrumb-core.js";
+import { LitElement, TemplateResult } from "lit";
+//#region src/components/breadcrumb/mono-breadcrumb.d.ts
+declare const MonoBreadcrumb_base: Constructor<MonoBreadcrumbCoreInterface> & typeof LitElement;
 /**
  * Light-DOM `mono-breadcrumb` (default build, `@mono-lit/helper/ui/breadcrumb`).
  *
@@ -15,24 +18,25 @@ declare const MonoBreadcrumb_base: import('../../composables/hybird-prop').Const
  * so a document loads only one.
  */
 export declare class MonoBreadcrumb extends MonoBreadcrumb_base {
-    static styles: import('lit').CSSResult[];
-    protected createRenderRoot(): HTMLElement;
-    private _slotsCaptured;
-    private _hasBodySlot;
-    /** Captured nodes for the whole-body slot — `slot="body"`. */
-    private _slotBody;
-    private _orphanHolder?;
-    connectedCallback(): void;
-    protected updated(changed: Map<string, unknown>): void;
-    protected _renderBody(): TemplateResult;
-    private _captureSlots;
-    private _placeIconSlots;
-    private _placeBodySlot;
-    private _placeSeparatorSlots;
+  static styles: import("lit").CSSResult[];
+  protected createRenderRoot(): HTMLElement;
+  private _slotsCaptured;
+  private _hasBodySlot;
+  /** Captured nodes for the whole-body slot — `slot="body"`. */
+  private _slotBody;
+  private _orphanHolder?;
+  connectedCallback(): void;
+  protected updated(changed: Map<string, unknown>): void;
+  protected _renderBody(): TemplateResult;
+  private _captureSlots;
+  private _placeIconSlots;
+  private _placeBodySlot;
+  private _placeSeparatorSlots;
 }
 declare global {
-    interface HTMLElementTagNameMap {
-        'mono-breadcrumb': MonoBreadcrumb;
-    }
+  interface HTMLElementTagNameMap {
+    'mono-breadcrumb': MonoBreadcrumb;
+  }
 }
-export {};
+//#endregion
+export {};

package/dist/src/components/breadcrumb/mono-breadcrumb.shadow.d.ts

@@ -1,6 +1,9 @@
-import { LitElement } from 'lit';
-import { BreadcrumbItem } from './breadcrumb-types.js';
-declare const MonoBreadcrumbShadow_base: import('../../composables/hybird-prop').Constructor<import('./breadcrumb-core.js').MonoBreadcrumbCoreInterface> & typeof LitElement;
+import { Constructor } from "../../composables/hybird-prop.js";
+import { BreadcrumbItem } from "./breadcrumb-types.js";
+import { MonoBreadcrumbCoreInterface } from "./breadcrumb-core.js";
+import { LitElement } from "lit";
+//#region src/components/breadcrumb/mono-breadcrumb.shadow.d.ts
+declare const MonoBreadcrumbShadow_base: Constructor<MonoBreadcrumbCoreInterface> & typeof LitElement;
 /**
  * Shadow-DOM `mono-breadcrumb` (SSR build, `@mono-lit/helper/ui/shadow/breadcrumb`).
  *
@@ -22,52 +25,53 @@ declare const MonoBreadcrumbShadow_base: import('../../composables/hybird-prop')
  * `mono-breadcrumb`, so a document loads only one build.
  */
 export declare class MonoBreadcrumbShadow extends MonoBreadcrumbShadow_base {
-    static styles: import('lit').CSSResult[];
-    /**
-     * Number of crumbs the SERVER actually rendered into the SSR'd shadow root,
-     * captured at `connectedCallback` before hydration replaces the DOM. `null`
-     * when there's no SSR'd shadow root (pure client render).
-     *
-     * @lit-labs/ssr does NOT forward `.prop` array bindings to the server, so for
-     * `:items.prop="arr"` the server renders 0 crumbs while the client `items` has
-     * N. Gating the first (hydration) render on this count makes the client's
-     * first render match the server exactly → no "shorter than expected iterable"
-     * and no double render. `:items="JSON.stringify(arr)"` forwards the string, so
-     * the server renders N and this is N → unchanged.
-     */
-    private _ssrItemCount;
-    protected _useIconSlots(): boolean;
-    /**
-     * Cap the HYDRATION render at exactly the server-rendered crumb count so the
-     * client's first render reproduces the SSR'd DOM structure. After hydration
-     * (`hasUpdated`) render the full list. Safety net for the rare case where the
-     * client `items` ends up longer than what the server emitted. On the server,
-     * always render the real `items`.
-     */
-    protected _itemsForRender(): BreadcrumbItem[];
-    connectedCallback(): void;
-    protected firstUpdated(changed: Map<string, unknown>): void;
-    protected updated(changed: Map<string, unknown>): void;
-    /**
-     * Register the consumer's own `slot="icon-<id>"` light children.
-     *
-     * `renderBreadcrumbIcon` only emits the wrapper (and therefore the `<slot>`) when
-     * the item has an `icon` OR `getSlotIconNodes(id)` reports something. That map is
-     * filled by the LIGHT build's capture pass, which never runs here — so a
-     * user-slotted `<svg slot="icon-home">` produced no wrapper, no slot, and no icon
-     * at all. Register them before render so the slot exists for them to project into.
-     *
-     * Must run in `willUpdate`, not `updated`: by `updated` the render that needed the
-     * information has already happened.
-     */
-    protected willUpdate(changed: Map<string, unknown>): void;
-    private _captureUserIconSlots;
-    /**
-     * Reconcile LIGHT-DOM icon spans (this element's own children) with `items`.
-     * Each becomes a `<span slot="icon-<id>" class="mono-breadcrumb-iconify i-…">`
-     * that projects into the shadow `<slot name="icon-<id>">` and is styled by the
-     * page's global UnoCSS. Client-only; icons paint at hydration.
-     */
-    private _syncLightIcons;
+  static styles: import("lit").CSSResult[];
+  /**
+   * Number of crumbs the SERVER actually rendered into the SSR'd shadow root,
+   * captured at `connectedCallback` before hydration replaces the DOM. `null`
+   * when there's no SSR'd shadow root (pure client render).
+   *
+   * @lit-labs/ssr does NOT forward `.prop` array bindings to the server, so for
+   * `:items.prop="arr"` the server renders 0 crumbs while the client `items` has
+   * N. Gating the first (hydration) render on this count makes the client's
+   * first render match the server exactly → no "shorter than expected iterable"
+   * and no double render. `:items="JSON.stringify(arr)"` forwards the string, so
+   * the server renders N and this is N → unchanged.
+   */
+  private _ssrItemCount;
+  protected _useIconSlots(): boolean;
+  /**
+   * Cap the HYDRATION render at exactly the server-rendered crumb count so the
+   * client's first render reproduces the SSR'd DOM structure. After hydration
+   * (`hasUpdated`) render the full list. Safety net for the rare case where the
+   * client `items` ends up longer than what the server emitted. On the server,
+   * always render the real `items`.
+   */
+  protected _itemsForRender(): BreadcrumbItem[];
+  connectedCallback(): void;
+  protected firstUpdated(changed: Map<string, unknown>): void;
+  protected updated(changed: Map<string, unknown>): void;
+  /**
+   * Register the consumer's own `slot="icon-<id>"` light children.
+   *
+   * `renderBreadcrumbIcon` only emits the wrapper (and therefore the `<slot>`) when
+   * the item has an `icon` OR `getSlotIconNodes(id)` reports something. That map is
+   * filled by the LIGHT build's capture pass, which never runs here — so a
+   * user-slotted `<svg slot="icon-home">` produced no wrapper, no slot, and no icon
+   * at all. Register them before render so the slot exists for them to project into.
+   *
+   * Must run in `willUpdate`, not `updated`: by `updated` the render that needed the
+   * information has already happened.
+   */
+  protected willUpdate(changed: Map<string, unknown>): void;
+  private _captureUserIconSlots;
+  /**
+   * Reconcile LIGHT-DOM icon spans (this element's own children) with `items`.
+   * Each becomes a `<span slot="icon-<id>" class="mono-breadcrumb-iconify i-…">`
+   * that projects into the shadow `<slot name="icon-<id>">` and is styled by the
+   * page's global UnoCSS. Client-only; icons paint at hydration.
+   */
+  private _syncLightIcons;
 }
-export {};
+//#endregion
+export {};

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