@mono-lit/helper 0.0.1 → 0.0.3

package/dist/src/components/dropdown-table/mono-data-dropdown.d.ts

@@ -1,11 +1,12 @@
-import { MonoTableController, MonoGridSource, MonoDataGridOptions, MonoTableProps, MonoCheckLimits } from '../table/mono-data-grid.js';
-import { MonoEventProps } from '../../composables/element-props';
-import { DropdownTableEvents } from './dropdown-table-types';
+import { MonoEventProps } from "../../composables/element-props.js";
+import { MonoCheckLimits, MonoDataGridOptions, MonoGridSource, MonoTableController, MonoTableProps } from "../table/mono-data-grid.js";
+import { DropdownTableEvents } from "./dropdown-table-types.js";
+//#region src/components/dropdown-table/mono-data-dropdown.d.ts
 /** One resolved selection (key + display text + the row it came from). */
 export interface MonoDropdownItem<T = any> {
-    key: unknown;
-    text: string;
-    data: T | undefined;
+  key: unknown;
+  text: string;
+  data: T | undefined;
 }
 /**
  * Central props for a dropdown-table, in the same shape as
@@ -16,44 +17,44 @@ export interface MonoDropdownItem<T = any> {
  * on a plain table. `dropdownTable` is the extra slot: the closed field itself.
  */
 export interface MonoDropdownProps extends MonoTableProps {
-    /**
-     * Props for the `<mono-dropdown-table>` field element, plus its events as
-     * `on<Event>` keys (`onChange`, `onOpen`, `onClose`, …) attached as listeners.
-     */
-    dropdownTable?: Record<string, unknown> & MonoEventProps<DropdownTableEvents>;
+  /**
+   * Props for the `<mono-dropdown-table>` field element, plus its events as
+   * `on<Event>` keys (`onChange`, `onOpen`, `onClose`, …) attached as listeners.
+   */
+  dropdownTable?: Record<string, unknown> & MonoEventProps<DropdownTableEvents>;
 }
 export interface MonoDataDropdownOptions extends MonoDataGridOptions {
-    /** Row key field (default `'Id'`). Also forwarded to the inner grid. */
-    keyExpr?: string;
-    /** Display text — a field name or a `(row) => string`. Defaults to `keyExpr`. */
-    displayExpr?: string | ((row: any) => string);
-    /** Multi-select (array value) vs single (scalar). */
-    multiple?: boolean;
-    /**
-     * Most rows the user can select in multi mode (unset = unlimited). Enforced by
-     * the grid's check store, so a row click, the keyboard, `<mono-table-checkbox>`
-     * (row and `type="all"`) and `selectAll()` all stop at it — a pick past the cap
-     * is rejected and the checkbox un-ticks itself. `setValue()` is not capped.
-     * The element's own `max` / `chip.max`, when set, override this.
-     */
-    max?: number;
-    /**
-     * Fewest rows the user can leave selected (unset = 0). Un-ticking at the floor
-     * is rejected; `clear()` keeps the first `min`. Overridden by the element's
-     * `min` / `chip.min` when set.
-     */
-    min?: number;
-    /** Central element props — the grid slots plus `dropdownTable`. */
-    props?: MonoDropdownProps;
-    /**
-     * A ref the dropdown writes a `props()` snapshot into on every change. The
-     * DROPDOWN owns this, not the inner grid — the snapshot has to carry
-     * `dropdownTable` alongside the grid slots, so a template can drive both the
-     * field and its header loop from one object.
-     */
-    state?: {
-        value: MonoDropdownProps | undefined;
-    };
+  /** Row key field (default `'Id'`). Also forwarded to the inner grid. */
+  keyExpr?: string;
+  /** Display text — a field name or a `(row) => string`. Defaults to `keyExpr`. */
+  displayExpr?: string | ((row: any) => string);
+  /** Multi-select (array value) vs single (scalar). */
+  multiple?: boolean;
+  /**
+   * Most rows the user can select in multi mode (unset = unlimited). Enforced by
+   * the grid's check store, so a row click, the keyboard, `<mono-table-checkbox>`
+   * (row and `type="all"`) and `selectAll()` all stop at it — a pick past the cap
+   * is rejected and the checkbox un-ticks itself. `setValue()` is not capped.
+   * The element's own `max` / `chip.max`, when set, override this.
+   */
+  max?: number;
+  /**
+   * Fewest rows the user can leave selected (unset = 0). Un-ticking at the floor
+   * is rejected; `clear()` keeps the first `min`. Overridden by the element's
+   * `min` / `chip.min` when set.
+   */
+  min?: number;
+  /** Central element props — the grid slots plus `dropdownTable`. */
+  props?: MonoDropdownProps;
+  /**
+   * A ref the dropdown writes a `props()` snapshot into on every change. The
+   * DROPDOWN owns this, not the inner grid — the snapshot has to carry
+   * `dropdownTable` alongside the grid slots, so a template can drive both the
+   * field and its header loop from one object.
+   */
+  state?: {
+    value: MonoDropdownProps | undefined;
+  };
 }
 /**
  * The dropdown controller — wraps a {@link monoDataGrid} (`.grid`, bind the panel's
@@ -61,92 +62,81 @@ export interface MonoDataDropdownOptions extends MonoDataGridOptions {
  * resolution. Mutated in place; read after `subscribe` fires (coalesced).
  */
 export interface MonoDropdownController<T = any> {
-    /** The inner table controller. Bind `mono-table-*` with `:control-table.prop="dd.table"`
-     *  (alias `:data-grid.prop="dd.grid"`). */
-    readonly grid: MonoTableController<T>;
-    /** Alias of {@link grid} — the inner `controlMonoTable`. Preferred in new code. */
-    readonly table: MonoTableController<T>;
-    /**
-     * Central element props — the grid's slots plus `dropdownTable` (the field
-     * itself). Mirrors `table.props()`; a stable read, mutated in place.
-     */
-    props(): MonoDropdownProps;
-    readonly multiple: boolean;
-    /** Selected value: scalar (single) or array (multi). Setting resolves display. */
-    value: unknown;
-    /** Whether the dropdown panel is open. */
-    open: boolean;
-    /** Assignable sink fired on INTERNAL value changes (toggle/remove/clear), not `setValue`. */
-    onValueChange: ((value: unknown) => void) | null;
-    isSelected(key: unknown): boolean;
-    /**
-     * The selection limits in force — the element's `max` / `min` when it set
-     * them, else the controller options'. Read `atMax` / `atMin` from
-     * `table.check()` for the live state.
-     */
-    limits(): MonoCheckLimits;
-    /**
-     * The element pushes its effective `max` / `min` here. `undefined` for a key
-     * means "the element has no opinion" and the controller option applies again.
-     */
-    setLimits(limits: MonoCheckLimits): void;
-    toggleRow(key: unknown, rowData?: T): void;
-    removeKey(key: unknown): void;
-    clear(): void;
-    /**
-     * Select every row the source returns for the CURRENT filter + search — the
-     * dropdown's counterpart to the table's `<mono-table-checkbox type="all">`.
-     * Drains through `table.getData()` and primes the display cache from the drained
-     * rows, so it costs the drain and no resolution requests. Fills only the room
-     * `max` leaves.
-     * No-op unless `multiple`, and re-entrant calls are ignored while one is running.
-     * `clear()` is the inverse.
-     *
-     * Read {@link selectAllPending} to show a loading state while it runs.
-     */
-    selectAll(): Promise<void>;
-    /**
-     * Whether a {@link selectAll} drain is in flight — the dropdown's equivalent of
-     * the table's `check().pending`. Flips true (with a notify) BEFORE the first
-     * request, so a subscriber can render the spinner before the network blocks.
-     *
-     * Unlike the table, a repeat `selectAll()` re-drains: the table memoises its last
-     * drain, but that memo is invalidated against grid internals (row-set version,
-     * search terms) this controller does not own, and a stale selection is a worse
-     * failure than a redundant fetch.
-     */
-    readonly selectAllPending: boolean;
-    /** The selected items (ordered), resolved to `{ key, text, data }`. */
-    selectedItems(): Array<MonoDropdownItem<T>>;
-    /** Joined display text of the current selection. */
-    displayText(): string;
-    /**
-     * Replace the selection. Pass `rows` when you already hold the matching row
-     * objects (a drain, a paged read) to seed the display cache and skip the
-     * `in`-filter round trips `resolveSelected` would otherwise make.
-     *
-     * Does NOT emit — this is the inbound path the element pushes `modelValue` down.
-     * Use {@link selectAll} or {@link toggleRow} for a change that should notify.
-     */
-    setValue(next: unknown, rows?: readonly T[]): void;
-    setOpen(next: boolean): void;
-    /** Fetch + cache display text for any selected keys not yet resolved. */
-    resolveSelected(): Promise<void>;
-    subscribe(cb: () => void): () => void;
-    bind(source: MonoGridSource<T> | T[] | null): void;
-    dispose(): void;
+  /** The inner table controller. Bind `mono-table-*` with `:control-table.prop="dd.table"`
+   *  (alias `:data-grid.prop="dd.grid"`). */
+  readonly grid: MonoTableController<T>;
+  /** Alias of {@link grid} — the inner `controlMonoTable`. Preferred in new code. */
+  readonly table: MonoTableController<T>;
+  /**
+   * Central element props — the grid's slots plus `dropdownTable` (the field
+   * itself). Mirrors `table.props()`; a stable read, mutated in place.
+   */
+  props(): MonoDropdownProps;
+  readonly multiple: boolean;
+  /** Selected value: scalar (single) or array (multi). Setting resolves display. */
+  value: unknown;
+  /** Whether the dropdown panel is open. */
+  open: boolean;
+  /** Assignable sink fired on INTERNAL value changes (toggle/remove/clear), not `setValue`. */
+  onValueChange: ((value: unknown) => void) | null;
+  isSelected(key: unknown): boolean;
+  /**
+   * The selection limits in force — the element's `max` / `min` when it set
+   * them, else the controller options'. Read `atMax` / `atMin` from
+   * `table.check()` for the live state.
+   */
+  limits(): MonoCheckLimits;
+  /**
+   * The element pushes its effective `max` / `min` here. `undefined` for a key
+   * means "the element has no opinion" and the controller option applies again.
+   */
+  setLimits(limits: MonoCheckLimits): void;
+  toggleRow(key: unknown, rowData?: T): void;
+  removeKey(key: unknown): void;
+  clear(): void;
+  /**
+   * Select every row the source returns for the CURRENT filter + search — the
+   * dropdown's counterpart to the table's `<mono-table-checkbox type="all">`.
+   * Drains through `table.getData()` and primes the display cache from the drained
+   * rows, so it costs the drain and no resolution requests. Fills only the room
+   * `max` leaves.
+   * No-op unless `multiple`, and re-entrant calls are ignored while one is running.
+   * `clear()` is the inverse.
+   *
+   * Read {@link selectAllPending} to show a loading state while it runs.
+   */
+  selectAll(): Promise<void>;
+  /**
+   * Whether a {@link selectAll} drain is in flight — the dropdown's equivalent of
+   * the table's `check().pending`. Flips true (with a notify) BEFORE the first
+   * request, so a subscriber can render the spinner before the network blocks.
+   *
+   * Unlike the table, a repeat `selectAll()` re-drains: the table memoises its last
+   * drain, but that memo is invalidated against grid internals (row-set version,
+   * search terms) this controller does not own, and a stale selection is a worse
+   * failure than a redundant fetch.
+   */
+  readonly selectAllPending: boolean;
+  /** The selected items (ordered), resolved to `{ key, text, data }`. */
+  selectedItems(): Array<MonoDropdownItem<T>>;
+  /** Joined display text of the current selection. */
+  displayText(): string;
+  /**
+   * Replace the selection. Pass `rows` when you already hold the matching row
+   * objects (a drain, a paged read) to seed the display cache and skip the
+   * `in`-filter round trips `resolveSelected` would otherwise make.
+   *
+   * Does NOT emit — this is the inbound path the element pushes `modelValue` down.
+   * Use {@link selectAll} or {@link toggleRow} for a change that should notify.
+   */
+  setValue(next: unknown, rows?: readonly T[]): void;
+  setOpen(next: boolean): void;
+  /** Fetch + cache display text for any selected keys not yet resolved. */
+  resolveSelected(): Promise<void>;
+  subscribe(cb: () => void): () => void;
+  bind(source: MonoGridSource<T> | T[] | null): void;
+  dispose(): void;
 }
-/**
- * `monoDataDropdown` — the composable that owns all the grid-dropdown "magic":
- * selection (single/multi), the bound `value`, and resolving a selected KEY to its
- * display TEXT. The options table is the reused headless {@link monoDataGrid}
- * exposed as `.grid`, so search / sort / paging / header-filter all work by binding
- * the panel's `mono-table-*` helpers to it. Pair with `<mono-dropdown-table>`.
- *
- * Display resolution uses `store.load({ filter })` ONLY — never `byKey` (which
- * caches per key and would hide updated rows) — with an `in`-filter (+ OR-chain
- * fallback) for a remote source, or the array source's `data()` for a local one.
- */
-/** Renamed "control" alias of {@link monoDataDropdown} (no breaking change — both work). */
-export { monoDataDropdown as controlMonoDataDropdown };
 export declare function monoDataDropdown<T = any>(source?: MonoGridSource<T> | T[] | null, opts?: MonoDataDropdownOptions): MonoDropdownController<T>;
+//#endregion
+export { monoDataDropdown as controlMonoDataDropdown };

package/dist/src/components/dropdown-table/mono-dropdown-table.d.ts

@@ -1,5 +1,8 @@
-import { LitElement } from 'lit';
-declare const MonoDropdownTable_base: import('../../composables/hybird-prop').Constructor<import('./dropdown-table-core.js').MonoDropdownTableCoreInterface> & typeof LitElement;
+import { Constructor } from "../../composables/hybird-prop.js";
+import { MonoDropdownTableCoreInterface } from "./dropdown-table-core.js";
+import { LitElement } from "lit";
+//#region src/components/dropdown-table/mono-dropdown-table.d.ts
+declare const MonoDropdownTable_base: Constructor<MonoDropdownTableCoreInterface> & typeof LitElement;
 /**
  * Light-DOM `mono-dropdown-table` (default build, `@mono-lit/helper/ui/dropdown-table`).
  * A dropdown whose panel holds a **native `<table>`** for picking row(s), driven by
@@ -27,20 +30,21 @@ declare const MonoDropdownTable_base: import('../../composables/hybird-prop').Co
  * </mono-dropdown-table>
  */
 export declare class MonoDropdownTable extends MonoDropdownTable_base {
-    static styles: import('lit').CSSResult[];
-    protected createRenderRoot(): HTMLElement;
-    private _slotsCaptured;
-    private _slotSearch;
-    private _slotBody;
-    private _slotFooter;
-    connectedCallback(): void;
-    protected updated(changed: Map<string, unknown>): void;
-    private _captureSlots;
-    private _placeSlot;
+  static styles: import("lit").CSSResult[];
+  protected createRenderRoot(): HTMLElement;
+  private _slotsCaptured;
+  private _slotSearch;
+  private _slotBody;
+  private _slotFooter;
+  connectedCallback(): void;
+  protected updated(changed: Map<string, unknown>): void;
+  private _captureSlots;
+  private _placeSlot;
 }
 declare global {
-    interface HTMLElementTagNameMap {
-        'mono-dropdown-table': MonoDropdownTable;
-    }
+  interface HTMLElementTagNameMap {
+    'mono-dropdown-table': MonoDropdownTable;
+  }
 }
-export {};
+//#endregion
+export {};

package/dist/src/components/dropdown-table/mono-dropdown-table.shadow.d.ts

@@ -1,5 +1,8 @@
-import { LitElement, TemplateResult } from 'lit';
-declare const MonoDropdownTableShadow_base: import('../../composables/hybird-prop').Constructor<import('./dropdown-table-core.js').MonoDropdownTableCoreInterface> & typeof LitElement;
+import { Constructor } from "../../composables/hybird-prop.js";
+import { MonoDropdownTableCoreInterface } from "./dropdown-table-core.js";
+import { LitElement, TemplateResult } from "lit";
+//#region src/components/dropdown-table/mono-dropdown-table.shadow.d.ts
+declare const MonoDropdownTableShadow_base: Constructor<MonoDropdownTableCoreInterface> & typeof LitElement;
 /**
  * Shadow-DOM `mono-shadow-dropdown-table` (SSR build, `@mono-lit/helper/ui/shadow/dropdown-table`).
  * The FIELD renders in a real shadow root (chips painted by the component's own sheet);
@@ -10,13 +13,14 @@ declare const MonoDropdownTableShadow_base: import('../../composables/hybird-pro
  * `MonoDropdownTableCore`.
  */
 export declare class MonoDropdownTableShadow extends MonoDropdownTableShadow_base {
-    static styles: import('lit').CSSResult[];
-    connectedCallback(): void;
-    private _onSlotChange;
-    firstUpdated(changed: Map<string, unknown>): void;
-    /** Mark a region whose `<slot>` has no assigned content `mono-empty` (light uses `:empty`). */
-    private _scanRegions;
-    /** Native `<slot>` per region (body = the default unnamed slot for the `<table>`). */
-    protected _renderRegion(cls: string, name: string): TemplateResult;
+  static styles: import("lit").CSSResult[];
+  connectedCallback(): void;
+  private _onSlotChange;
+  firstUpdated(changed: Map<string, unknown>): void;
+  /** Mark a region whose `<slot>` has no assigned content `mono-empty` (light uses `:empty`). */
+  private _scanRegions;
+  /** Native `<slot>` per region (body = the default unnamed slot for the `<table>`). */
+  protected _renderRegion(cls: string, name: string): TemplateResult;
 }
-export {};
+//#endregion
+export {};

package/dist/src/components/file-upload/file-upload-core.d.ts

@@ -1,47 +1,48 @@
-import { LitElement, TemplateResult } from 'lit';
-import { FileUploadCssClass, FileUploadItem, FileUploadValidationState, FileUploadVariant } from './file-upload-types.js';
-import { Constructor } from '../../composables/hybird-prop';
+import { Constructor } from "../../composables/hybird-prop.js";
+import { FileUploadCssClass, FileUploadItem, FileUploadValidationState, FileUploadVariant } from "./file-upload-types.js";
+import { LitElement, TemplateResult } from "lit";
+//#region src/components/file-upload/file-upload-core.d.ts
 /** Public + shared-protected surface added by the core mixin. */
 export declare class MonoFileUploadCoreInterface {
-    label: string;
-    helperText: string;
-    /** Dropzone headline. `placeholder` is the old name, kept as an alias. */
-    title: string;
-    /** Dropzone secondary line. `subtext` is the old name, kept as an alias. */
-    subtitle: string;
-    /** @deprecated alias of `title` */
-    placeholder: string;
-    /** @deprecated alias of `subtitle` */
-    subtext: string;
-    icon: string;
-    removeIcon: string;
-    accept: string;
-    multiple: boolean;
-    disabled: boolean;
-    required: boolean;
-    dragdrop: boolean;
-    maxFileSize: number;
-    maxFiles: number;
-    modelValue: FileUploadItem[];
-    cssClass: FileUploadCssClass;
-    variant: FileUploadVariant;
-    validationState: FileUploadValidationState;
-    validationMessage: string;
-    clear(): void;
-    protected _hasIconSlot: boolean;
-    protected _hasTitleSlot: boolean;
-    protected _hasSubtitleSlot: boolean;
-    protected _inputEl: HTMLInputElement;
-    protected _cls(base: string, key: keyof FileUploadCssClass): string;
-    protected get _wrapperClasses(): string;
-    protected get _subtitleClasses(): string;
-    protected _useIconSlots(): boolean;
-    protected _renderDropzoneIcon(): TemplateResult;
-    protected _renderTitle(): TemplateResult;
-    protected _renderSubtitle(): TemplateResult;
-    protected _renderDefaultGlyph(): TemplateResult;
-    protected _renderRemoveIcon(): TemplateResult;
-    protected _renderThumbGlyph(item: FileUploadItem): TemplateResult;
+  label: string;
+  helperText: string;
+  /** Dropzone headline. `placeholder` is the old name, kept as an alias. */
+  title: string;
+  /** Dropzone secondary line. `subtext` is the old name, kept as an alias. */
+  subtitle: string;
+  /** @deprecated alias of `title` */
+  placeholder: string;
+  /** @deprecated alias of `subtitle` */
+  subtext: string;
+  icon: string;
+  removeIcon: string;
+  accept: string;
+  multiple: boolean;
+  disabled: boolean;
+  required: boolean;
+  dragdrop: boolean;
+  maxFileSize: number;
+  maxFiles: number;
+  modelValue: FileUploadItem[];
+  cssClass: FileUploadCssClass;
+  variant: FileUploadVariant;
+  validationState: FileUploadValidationState;
+  validationMessage: string;
+  clear(): void;
+  protected _hasIconSlot: boolean;
+  protected _hasTitleSlot: boolean;
+  protected _hasSubtitleSlot: boolean;
+  protected _inputEl: HTMLInputElement;
+  protected _cls(base: string, key: keyof FileUploadCssClass): string;
+  protected get _wrapperClasses(): string;
+  protected get _subtitleClasses(): string;
+  protected _useIconSlots(): boolean;
+  protected _renderDropzoneIcon(): TemplateResult;
+  protected _renderTitle(): TemplateResult;
+  protected _renderSubtitle(): TemplateResult;
+  protected _renderDefaultGlyph(): TemplateResult;
+  protected _renderRemoveIcon(): TemplateResult;
+  protected _renderThumbGlyph(item: FileUploadItem): TemplateResult;
 }
 /**
  * `MonoFileUploadCore` — all render-mode-agnostic logic for `mono-file-upload`:
@@ -58,3 +59,4 @@ export declare class MonoFileUploadCoreInterface {
  * and `_inputEl` (`@query`) only run client-side from user interaction.
  */
 export declare const MonoFileUploadCore: <T extends Constructor<LitElement>>(superClass: T) => Constructor<MonoFileUploadCoreInterface> & T;
+//#endregion