@mono-lit/helper 0.0.1 → 0.0.3

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

@@ -1,3 +1,4 @@
+//#region src/components/card/card-types.d.ts
 /**
  * Card Component Type Definitions
  */
@@ -38,100 +39,101 @@ export type CardMediaPosition = 'top' | 'bottom';
  * }}
  */
 export interface CardCssClass {
-    root?: string;
-    media?: string;
-    header?: string;
-    icon?: string;
-    headerContent?: string;
-    title?: string;
-    subtitle?: string;
-    body?: string;
-    actions?: string;
-    footer?: string;
-    loading?: string;
+  root?: string;
+  media?: string;
+  header?: string;
+  icon?: string;
+  headerContent?: string;
+  title?: string;
+  subtitle?: string;
+  body?: string;
+  actions?: string;
+  footer?: string;
+  loading?: string;
 }
 export interface CardProps {
-    /**
-     * Content scale — padding, type, gaps and the header icon. Not a dimension:
-     * use `width` / `height` for that. See {@link CardSize}.
-     */
-    size?: CardSize;
-    /** Visual style variant of the card. */
-    variant?: CardVariant;
-    /** Color theme of the card. */
-    color?: CardColor;
-    /** Corner radius of the card. */
-    rounded?: CardRounded;
-    /** Position of the media slot (top or bottom). */
-    mediaPosition?: CardMediaPosition;
-    'media-position'?: CardMediaPosition;
-    mediaposition?: CardMediaPosition;
-    /**
-     * Title text shown in the card header. `slot="title"` replaces it, and
-     * `slot="header"` replaces the icon, title and subtitle together.
-     */
-    title?: string;
-    /** Subtitle text shown under the title. `slot="subtitle"` replaces it. */
-    subtitle?: string;
-    /** @deprecated Old name of `title`, still accepted. */
-    heading?: string;
-    /** @deprecated Old name of `subtitle`, still accepted. */
-    subheading?: string;
-    /** Adds a border around the card. */
-    bordered?: boolean;
-    /** Adds a hover elevation effect. */
-    hoverable?: boolean;
-    /** Makes the card interactive and clickable. */
-    clickable?: boolean;
-    /** Applies the selected highlight state. */
-    selected?: boolean;
-    /** Disables interaction and dims the card. */
-    disabled?: boolean;
-    /** Shows a loading overlay on the card. */
-    loading?: boolean;
-    /**
-     * Explicit sizing. Each accepts a CSS length string (`"320px"`, `"80%"`) or a
-     * number (interpreted as px). Use `width="100%"` for a full-width card.
-     */
-    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;
-    /** Shows a divider below the header. */
-    headerDivider?: boolean;
-    'header-divider'?: boolean;
-    headerdivider?: boolean;
-    /** Shows a divider above the footer. */
-    footerDivider?: boolean;
-    'footer-divider'?: boolean;
-    footerdivider?: boolean;
-    /** Renders the card as an anchor with this URL. */
-    href?: string;
-    /** Anchor target window when href is set. */
-    target?: string;
-    /** Accessible label text for screen readers. */
-    ariaLabelText?: string;
-    ariaLabel?: string;
-    'aria-label'?: string;
-    'aria-label-text'?: string;
-    arialabel?: string;
-    arialabeltext?: string;
-    /** Per-element class overrides. */
-    cssClass?: CardCssClass;
-    'css-class'?: CardCssClass;
+  /**
+   * Content scale — padding, type, gaps and the header icon. Not a dimension:
+   * use `width` / `height` for that. See {@link CardSize}.
+   */
+  size?: CardSize;
+  /** Visual style variant of the card. */
+  variant?: CardVariant;
+  /** Color theme of the card. */
+  color?: CardColor;
+  /** Corner radius of the card. */
+  rounded?: CardRounded;
+  /** Position of the media slot (top or bottom). */
+  mediaPosition?: CardMediaPosition;
+  'media-position'?: CardMediaPosition;
+  mediaposition?: CardMediaPosition;
+  /**
+   * Title text shown in the card header. `slot="title"` replaces it, and
+   * `slot="header"` replaces the icon, title and subtitle together.
+   */
+  title?: string;
+  /** Subtitle text shown under the title. `slot="subtitle"` replaces it. */
+  subtitle?: string;
+  /** @deprecated Old name of `title`, still accepted. */
+  heading?: string;
+  /** @deprecated Old name of `subtitle`, still accepted. */
+  subheading?: string;
+  /** Adds a border around the card. */
+  bordered?: boolean;
+  /** Adds a hover elevation effect. */
+  hoverable?: boolean;
+  /** Makes the card interactive and clickable. */
+  clickable?: boolean;
+  /** Applies the selected highlight state. */
+  selected?: boolean;
+  /** Disables interaction and dims the card. */
+  disabled?: boolean;
+  /** Shows a loading overlay on the card. */
+  loading?: boolean;
+  /**
+   * Explicit sizing. Each accepts a CSS length string (`"320px"`, `"80%"`) or a
+   * number (interpreted as px). Use `width="100%"` for a full-width card.
+   */
+  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;
+  /** Shows a divider below the header. */
+  headerDivider?: boolean;
+  'header-divider'?: boolean;
+  headerdivider?: boolean;
+  /** Shows a divider above the footer. */
+  footerDivider?: boolean;
+  'footer-divider'?: boolean;
+  footerdivider?: boolean;
+  /** Renders the card as an anchor with this URL. */
+  href?: string;
+  /** Anchor target window when href is set. */
+  target?: string;
+  /** Accessible label text for screen readers. */
+  ariaLabelText?: string;
+  ariaLabel?: string;
+  'aria-label'?: string;
+  'aria-label-text'?: string;
+  arialabel?: string;
+  arialabeltext?: string;
+  /** Per-element class overrides. */
+  cssClass?: CardCssClass;
+  'css-class'?: CardCssClass;
 }
 export interface CardClickEventDetail {
-    originalEvent: MouseEvent | KeyboardEvent;
+  originalEvent: MouseEvent | KeyboardEvent;
 }
 export type CardClickEvent = CustomEvent<CardClickEventDetail>;
 export interface CardEvents {
-    click: CardClickEvent;
-    'mno-click': CardClickEvent;
-    mnoClick: CardClickEvent;
+  click: CardClickEvent;
+  'mno-click': CardClickEvent;
+  mnoClick: CardClickEvent;
 }
+//#endregion

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

@@ -1,23 +1,25 @@
-import { CardVariant, CardColor } from './card-types.js';
+import { CardColor, CardVariant } from "./card-types.js";
+//#region src/components/card/card-utils.d.ts
 /**
  * Validate card props
  */
 export declare function validateCardProps(props: {
-    variant?: CardVariant;
-    color?: CardColor;
+  variant?: CardVariant;
+  color?: CardColor;
 }): boolean;
 /**
  * Generate root CSS classes for card
  */
 export declare function generateCardRootClasses(props: {
-    variant?: CardVariant;
-    color?: CardColor;
-    bordered?: boolean;
-    hoverable?: boolean;
-    clickable?: boolean;
-    disabled?: boolean;
+  variant?: CardVariant;
+  color?: CardColor;
+  bordered?: boolean;
+  hoverable?: boolean;
+  clickable?: boolean;
+  disabled?: boolean;
 }): string;
 /**
  * Generate ARIA attributes for accessibility
  */
 export declare function generateCardAttributes(clickable: boolean, hoverable: boolean, label: string | undefined): Record<string, string | boolean | undefined>;
+//#endregion

package/dist/src/components/card/index.d.ts

@@ -1,4 +1,5 @@
 /// <reference path="../../../vue.d.ts" />
-export { MonoCard } from './mono-card.js';
-export type { CardSize, CardRounded, CardVariant, CardColor, CardCssClass, CardMediaPosition, CardProps, CardEvents } from './card-types.js';
-export { validateCardProps, generateCardAttributes } from './card-utils.js';
+import { CardColor, CardCssClass, CardEvents, CardMediaPosition, CardProps, CardRounded, CardSize, CardVariant } from "./card-types.js";
+import { generateCardAttributes, validateCardProps } from "./card-utils.js";
+import { MonoCard } from "./mono-card.js";
+export { type CardColor, type CardCssClass, type CardEvents, type CardMediaPosition, type CardProps, type CardRounded, type CardSize, type CardVariant, MonoCard, generateCardAttributes, validateCardProps };

package/dist/src/components/card/index.shadow.d.ts

@@ -1,6 +1,6 @@
 /// <reference path="../../../vue.d.ts" />
-export { MonoCardShadow } from './mono-card.shadow.js';
-export { MonoCardCore } from './card-core.js';
-export type { CardSlotName } from './card-core.js';
-export type { CardSize, CardRounded, CardVariant, CardColor, CardCssClass, CardMediaPosition, CardProps, CardEvents, } from './card-types.js';
-export { validateCardProps, generateCardAttributes, } from './card-utils.js';
+import { CardColor, CardCssClass, CardEvents, CardMediaPosition, CardProps, CardRounded, CardSize, CardVariant } from "./card-types.js";
+import { CardSlotName, MonoCardCore } from "./card-core.js";
+import { generateCardAttributes, validateCardProps } from "./card-utils.js";
+import { MonoCardShadow } from "./mono-card.shadow.js";
+export { type CardColor, type CardCssClass, type CardEvents, type CardMediaPosition, type CardProps, type CardRounded, type CardSize, type CardSlotName, type CardVariant, MonoCardCore, MonoCardShadow, generateCardAttributes, validateCardProps };

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

@@ -1,5 +1,8 @@
-import { LitElement, TemplateResult } from 'lit';
-declare const MonoCard_base: import('../../composables/hybird-prop').Constructor<import('./card-core.js').MonoCardCoreInterface> & typeof LitElement;
+import { Constructor } from "../../composables/hybird-prop.js";
+import { MonoCardCoreInterface } from "./card-core.js";
+import { LitElement, TemplateResult } from "lit";
+//#region src/components/card/mono-card.d.ts
+declare const MonoCard_base: Constructor<MonoCardCoreInterface> & typeof LitElement;
 /**
  * Light-DOM `mono-card` (default build, `@mono-lit/helper/ui/card`).
  *
@@ -21,36 +24,37 @@ declare const MonoCard_base: import('../../composables/hybird-prop').Constructor
  * same document.
  */
 export declare class MonoCard extends MonoCard_base {
-    static styles: import('lit').CSSResult[];
-    protected createRenderRoot(): HTMLElement;
-    private _slotsCaptured;
-    private _buckets;
-    private _renderMedia;
-    private _renderHeader;
-    /**
-     * The body is the only region rendered unconditionally.
-     *
-     * It's the home for the fallback bucket, which holds the consumer framework's
-     * positional anchors. Those need a live parent even when the card starts with
-     * no visible body content — that's what lets a `v-if` flipping on later insert
-     * *inside* the card instead of beside it, and it stops Lit from ever destroying
-     * a container that holds the consumer's nodes. `.mono-card-body:empty` collapses
-     * it while it holds nothing but anchors.
-     */
-    private _renderBody;
-    private _renderActions;
-    private _renderFooter;
-    private _renderLoading;
-    private _renderContent;
-    protected render(): TemplateResult;
-    connectedCallback(): void;
-    private _captureSlots;
-    protected updated(changed: Map<string, unknown>): void;
-    private _parked?;
+  static styles: import("lit").CSSResult[];
+  protected createRenderRoot(): HTMLElement;
+  private _slotsCaptured;
+  private _buckets;
+  private _renderMedia;
+  private _renderHeader;
+  /**
+   * The body is the only region rendered unconditionally.
+   *
+   * It's the home for the fallback bucket, which holds the consumer framework's
+   * positional anchors. Those need a live parent even when the card starts with
+   * no visible body content — that's what lets a `v-if` flipping on later insert
+   * *inside* the card instead of beside it, and it stops Lit from ever destroying
+   * a container that holds the consumer's nodes. `.mono-card-body:empty` collapses
+   * it while it holds nothing but anchors.
+   */
+  private _renderBody;
+  private _renderActions;
+  private _renderFooter;
+  private _renderLoading;
+  private _renderContent;
+  protected render(): TemplateResult;
+  connectedCallback(): void;
+  private _captureSlots;
+  protected updated(changed: Map<string, unknown>): void;
+  private _parked?;
 }
 declare global {
-    interface HTMLElementTagNameMap {
-        'mono-card': MonoCard;
-    }
+  interface HTMLElementTagNameMap {
+    'mono-card': MonoCard;
+  }
 }
-export {};
+//#endregion
+export {};

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

@@ -1,5 +1,8 @@
-import { LitElement, TemplateResult } from 'lit';
-declare const MonoCardShadow_base: import('../../composables/hybird-prop').Constructor<import('./card-core.js').MonoCardCoreInterface> & typeof LitElement;
+import { Constructor } from "../../composables/hybird-prop.js";
+import { MonoCardCoreInterface } from "./card-core.js";
+import { LitElement, TemplateResult } from "lit";
+//#region src/components/card/mono-card.shadow.d.ts
+declare const MonoCardShadow_base: Constructor<MonoCardCoreInterface> & typeof LitElement;
 /**
  * Shadow-DOM card (the opt-in SSR build, `@mono-lit/helper/ui/shadow/card`).
  *
@@ -21,32 +24,33 @@ declare const MonoCardShadow_base: import('../../composables/hybird-prop').Const
  * build via `MonoCardCore`.
  */
 export declare class MonoCardShadow extends MonoCardShadow_base {
-    static styles: import('lit').CSSResult[];
-    firstUpdated(changed: Map<string, unknown>): void;
-    private _slotFor;
-    /**
-     * Whether something is ASSIGNED to this slot. Not `flatten: true`: for an
-     * empty slot that returns the FALLBACK content, and `<slot name="header">`'s
-     * fallback is the title/subtitle markup — every card would look like it had a
-     * header slot and hide its icon.
-     */
-    private _slotHasContent;
-    private _setSlotState;
-    private _onSlotChange;
-    private _slot;
-    private _renderMedia;
-    private _renderHeader;
-    private _renderBody;
-    private _renderActions;
-    private _renderFooter;
-    private _renderLoading;
-    private _renderContent;
-    protected render(): TemplateResult;
-    connectedCallback(): void;
+  static styles: import("lit").CSSResult[];
+  firstUpdated(changed: Map<string, unknown>): void;
+  private _slotFor;
+  /**
+   * Whether something is ASSIGNED to this slot. Not `flatten: true`: for an
+   * empty slot that returns the FALLBACK content, and `<slot name="header">`'s
+   * fallback is the title/subtitle markup — every card would look like it had a
+   * header slot and hide its icon.
+   */
+  private _slotHasContent;
+  private _setSlotState;
+  private _onSlotChange;
+  private _slot;
+  private _renderMedia;
+  private _renderHeader;
+  private _renderBody;
+  private _renderActions;
+  private _renderFooter;
+  private _renderLoading;
+  private _renderContent;
+  protected render(): TemplateResult;
+  connectedCallback(): void;
 }
 declare global {
-    interface HTMLElementTagNameMap {
-        'mono-shadow-card': MonoCardShadow;
-    }
+  interface HTMLElementTagNameMap {
+    'mono-shadow-card': MonoCardShadow;
+  }
 }
-export {};
+//#endregion
+export {};

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

@@ -1,34 +1,35 @@
-import { LitElement, TemplateResult } from 'lit';
-import { Constructor } from '../../composables/hybird-prop';
-import { CssSizeValue } from '../../composables/css-size';
-import { ChartCssClass, MonoChartColor, MonoChartController, MonoChartData, MonoChartType } from './chart-types.js';
+import { Constructor } from "../../composables/hybird-prop.js";
+import { CssSizeValue } from "../../composables/css-size.js";
+import { ChartCssClass, MonoChartColor, MonoChartController, MonoChartData, MonoChartType } from "./chart-types.js";
+import { LitElement, TemplateResult } from "lit";
+//#region src/components/chart/chart-core.d.ts
 export declare function loadChartJs(): Promise<any>;
 /** Public surface added by the chart core mixin. */
 export declare class MonoChartCoreInterface {
-    dataChart?: MonoChartController;
-    /** Pull `controlMonoChart({ props })` onto this element. */
-    protected _applyControllerProps(): void;
-    type?: MonoChartType;
-    /** Set by the presets to lock their type; undefined on the generic element. */
-    protected _presetType?: MonoChartType;
-    /** The shared template — each build calls this from its own `render()`. */
-    protected renderChart(): TemplateResult;
-    data?: MonoChartData;
-    chartOptions?: Record<string, unknown>;
-    width?: CssSizeValue;
-    height?: CssSizeValue;
-    aspectRatio: number;
-    legend: boolean | string;
-    title: string;
-    stacked: boolean;
-    color?: MonoChartColor | string;
-    colors?: string | string[];
-    cssClass: ChartCssClass;
-    cssClassName: string;
-    /** The live chart.js instance, or null. */
-    readonly chart: unknown;
-    /** Force a full teardown + recreate. */
-    rebuild(): void;
+  dataChart?: MonoChartController;
+  /** Pull `controlMonoChart({ props })` onto this element. */
+  protected _applyControllerProps(): void;
+  type?: MonoChartType;
+  /** Set by the presets to lock their type; undefined on the generic element. */
+  protected _presetType?: MonoChartType;
+  /** The shared template — each build calls this from its own `render()`. */
+  protected renderChart(): TemplateResult;
+  data?: MonoChartData;
+  chartOptions?: Record<string, unknown>;
+  width?: CssSizeValue;
+  height?: CssSizeValue;
+  aspectRatio: number;
+  legend: boolean | string;
+  title: string;
+  stacked: boolean;
+  color?: MonoChartColor | string;
+  colors?: string | string[];
+  cssClass: ChartCssClass;
+  cssClassName: string;
+  /** The live chart.js instance, or null. */
+  readonly chart: unknown;
+  /** Force a full teardown + recreate. */
+  rebuild(): void;
 }
 /**
  * `MonoChartCore` — render-mode-agnostic logic for the chart elements.
@@ -41,3 +42,4 @@ export declare class MonoChartCoreInterface {
  * canvas needs to be told when its box changes.
  */
 export declare const MonoChartCore: <T extends Constructor<LitElement>>(superClass: T) => Constructor<MonoChartCoreInterface> & T;
+//#endregion

package/dist/src/components/chart/chart-odata.d.ts

@@ -1,6 +1,7 @@
-import { arrayToODataString } from '../filter/filter-odata.js';
-import { MonoDataSourceOptions } from '../../utils/data-source-options.js';
-import { MonoChartAggregateCtx, MonoChartSeries } from './chart-types.js';
+import { MonoDataSourceOptions } from "../../utils/data-source-options.js";
+import { MonoChartAggregateCtx, MonoChartSeries } from "./chart-types.js";
+import { arrayToODataString } from "../filter/filter-odata.js";
+//#region src/components/chart/chart-odata.d.ts
 /**
  * Build `groupby((<groupBy>),aggregate(<field> with <agg> as <field>, …))`.
  *
@@ -20,16 +21,14 @@ export declare function buildChartApply(groupBy: string, series?: readonly MonoC
  * rows, which is the whole point of doing this server-side.
  */
 export declare function composeApply(apply: string, filter: unknown): string;
-/** Re-exported so an `aggregate()` hook can convert a devextreme filter itself. */
-export { arrayToODataString as chartODataFilter };
 /** What `buildChartOdataRequest` hands to the transport. */
 export interface MonoChartOdataRequest {
-    /** devextreme load options for the DataSource `monoOdataFetch` builds. */
-    options: Record<string, unknown>;
-    /** Raw query-string parameters (`$apply`, custom keys) — sent verbatim. */
-    params: Record<string, unknown>;
-    /** Whether the rows will come back rolled up (an `$apply` was built). */
-    aggregated: boolean;
+  /** devextreme load options for the DataSource `monoOdataFetch` builds. */
+  options: Record<string, unknown>;
+  /** Raw query-string parameters (`$apply`, custom keys) — sent verbatim. */
+  params: Record<string, unknown>;
+  /** Whether the rows will come back rolled up (an `$apply` was built). */
+  aggregated: boolean;
 }
 /**
  * Compose the request an `odata` chart sends — pure, so the merge of
@@ -44,9 +43,11 @@ export interface MonoChartOdataRequest {
  * `$filter`; `paginate` is forced off so every bucket comes back.
  */
 export declare function buildChartOdataRequest(input: {
-    options?: Record<string, unknown>;
-    base?: MonoDataSourceOptions;
-    aggregate?: (ctx: MonoChartAggregateCtx) => string;
-    groupBy?: string;
-    series: readonly MonoChartSeries[];
+  options?: Record<string, unknown>;
+  base?: MonoDataSourceOptions;
+  aggregate?: (ctx: MonoChartAggregateCtx) => string;
+  groupBy?: string;
+  series: readonly MonoChartSeries[];
 }): MonoChartOdataRequest;
+//#endregion
+export { arrayToODataString as chartODataFilter };