@kubex/zinc 1.1.179 → 1.1.181

package/dist/zn.d.ts

@@ -155,6 +155,12 @@ declare module "internal/form" {
     import type { ZincFormControl } from "internal/zinc-element";
     import type Button from "components/button/index";
     export const formCollections: WeakMap<HTMLFormElement, Set<ZincFormControl>>;
+    /** Trims a control's string value in place, so what's shown matches what's submitted. */
+    export function trimControlValue(control: Element & {
+        value?: unknown;
+        type?: string;
+        input?: unknown;
+    }): void;
     export function clearFormStoreValues(formOrStoreKey: HTMLFormElement | string): void;
     export interface FormControlControllerOptions {
         /** A function that returns the form containing the form control. */
@@ -2446,6 +2452,7 @@ declare module "components/input/input.component" {
         private handleFocus;
         private handleInput;
         private handleInvalid;
+        private syncEmailDisplay;
         private handleKeyDown;
         private handlePasswordToggle;
         private handleColorSwatchClick;
@@ -4600,6 +4607,8 @@ declare module "components/tile/tile.component" {
         inline: boolean;
         /** Renders the caption in the normal table-content weight instead of bold. */
         plain: boolean;
+        /** Moves the actions under the caption and description when the tile is narrower than 600px. */
+        stackActions: boolean;
         /** Set by `zn-tile-group` to lay the tile out as a shared-column subgrid row. */
         grouped: boolean;
         private _isLink;
@@ -4799,11 +4808,19 @@ declare module "components/chart/builders" {
     import type { EChartsOption } from 'echarts';
     export type ChartType = 'area' | 'bar' | 'donut' | 'funnel' | 'gauge' | 'heatmap' | 'line' | 'pie' | 'radar' | 'sankey' | 'scatter' | 'sunburst' | 'treemap';
     export interface SeriesItem {
+        /** Stable identity for incremental live updates. */
+        id?: string;
+        animation?: boolean;
+        animationDuration?: number;
+        animationDurationUpdate?: number;
+        animationEasingUpdate?: 'linear';
+        animationThreshold?: number;
         name: string;
         data: any[];
         color?: string;
         /** Series sharing a stack ID are stacked, overriding the chart-wide `stacked` setting. */
         stack?: string;
+        stackStrategy?: 'all' | 'samesign' | 'positive' | 'negative';
         /** Fill below a line, for example `{ opacity: 0.15 }`; `{ opacity: 0 }` keeps a stacked base invisible. */
         areaStyle?: Record<string, unknown>;
         lineStyle?: Record<string, unknown>;
@@ -4870,6 +4887,70 @@ declare module "components/chart/echarts-loader" {
     export type EChartsModule = typeof echartsCore;
     export function loadECharts(): Promise<EChartsModule>;
 }
+declare module "components/chart/live" {
+    import type { SeriesItem } from "components/chart/builders";
+    export interface LivePoint {
+        at: number;
+        value: number | null;
+    }
+    export interface LivePrediction {
+        status: string;
+        average_rates?: boolean;
+        points: {
+            at: number;
+            expected: number;
+            lower: number;
+            upper: number;
+            available: boolean;
+        }[];
+    }
+    export interface LiveFrame {
+        from: number;
+        until: number;
+        server_time: number;
+        expires_at: number;
+        resolution_seconds: number;
+        metric: string;
+        points: LivePoint[];
+        prediction?: LivePrediction;
+    }
+    export interface LiveGrant {
+        stream_url: string;
+        expires_at: number;
+        server_time: number;
+    }
+    /** Authoritative bucket replacement, never increment counts on delivery/reconnect. */
+    export class LiveWindow {
+        frame?: LiveFrame;
+        private points;
+        private prediction?;
+        apply(value: unknown, snapshot: boolean): LiveFrame;
+        advance(serverTime: number): void;
+        get predictionStatus(): string;
+        series(hideZero?: boolean): SeriesItem[];
+    }
+    /** One transport per chart. Grants renew only through a same-origin login gate. */
+    export class LiveTransport {
+        private source?;
+        private timer?;
+        private expiryTimer?;
+        private abort?;
+        private stopped;
+        private generation;
+        private retry;
+        private renewing;
+        private readonly frame;
+        private readonly status;
+        private readonly heartbeat?;
+        constructor(frame: (data: unknown, snapshot: boolean) => void, status: (status: string) => void, heartbeat?: (serverTime: number) => void);
+        start(streamURL: string, renewURL: string): void;
+        stop(): void;
+        private active;
+        private deadline;
+        private connect;
+        private renew;
+    }
+}
 declare module "components/chart/chart.component" {
     import { type ChartType, type RadarIndicator, type SeriesItem } from "components/chart/builders";
     import { type CSSResultGroup, type PropertyValues } from 'lit';
@@ -4894,6 +4975,9 @@ declare module "components/chart/chart.component" {
         stacked: boolean;
         live: boolean;
         dataUrl: string;
+        streamUrl: string;
+        liveRenewUrl: string;
+        hideZero: boolean;
         liveInterval: number;
         height: number;
         enableAnimations: boolean | number;
@@ -4911,6 +4995,16 @@ declare module "components/chart/chart.component" {
         private echarts?;
         private initPromise?;
         private liveTimer?;
+        private pollAbort?;
+        private liveStatus;
+        private liveWindow;
+        private replaceLiveSeries;
+        private transport;
+        private liveTransitionDuration;
+        private liveSeries;
+        private updateChart;
+        protected updated(changed: PropertyValues): void;
+        connectedCallback(): void;
         private readonly resizeObserver;
         protected firstUpdated(_changedProperties: PropertyValues): void;
         protected getUpdateComplete(): Promise<boolean>;
@@ -4919,6 +5013,7 @@ declare module "components/chart/chart.component" {
         private getBorderColor;
         private buildOption;
         private initChart;
+        private stopLive;
         private startLive;
         private reinit;
         attributeChangedCallback(name: string, _old: string | null, value: string | null): void;
@@ -6199,22 +6294,14 @@ declare module "components/stepper/index" {
 declare module "components/stat/stat.component" {
     import { type CSSResultGroup } from 'lit';
     import ZincElement from "internal/zinc-element";
+    import type { IconColor } from "components/icon/index";
     /**
-     * @summary Short summary of the component's intended use.
+     * @summary Displays a key metric, optionally compared with a previous value.
      * @documentation https://zinc.style/components/stats-tile
      * @status experimental
      * @since 1.0
      *
-     * @dependency zn-example
-     *
-     * @event zn-event-name - Emitted as an example.
-     *
-     * @slot - The default slot.
-     * @slot example - An example slot.
-     *
-     * @csspart base - The component's base wrapper.
-     *
-     * @cssproperty --example - An example CSS custom property.
+     * @dependency zn-icon
      */
     export default class ZnStatsTile extends ZincElement {
         static styles: CSSResultGroup;
@@ -6226,10 +6313,27 @@ declare module "components/stat/stat.component" {
         currency: string;
         showDelta: boolean;
         color: 'primary' | 'error' | 'info' | 'warning' | 'success' | 'neutral';
+        /** `value-first` puts the amount under the caption with the description beneath it, and tints the amount rather
+         * than the description with `color`. */
+        layout: 'default' | 'value-first';
+        /** How `show-delta` compares with `previous`: the relative change, or the difference in points. */
+        deltaFormat: 'percent' | 'points';
+        /** An icon shown beside the amount. */
+        icon: string;
+        /** The icon's color; without one it takes the amount's. */
+        iconColor: IconColor;
+        /** `large` gives the amount more weight, for a summary row of a few headline figures. */
+        size: 'medium' | 'large';
+        /** Pads the stat, for stats laid edge to edge in a flush container such as `zn-cols no-gap divide`. */
+        padded: boolean;
         calcPercentageDifference(): number;
         getCurrentAmount(): string;
         private getDisplayAmount;
         diffText(): import("lit-html").TemplateResult<1> | null;
+        private pointsDelta;
+        private renderAmount;
+        private renderValueFirst;
+        private percentDelta;
         render(): import("lit-html").TemplateResult<1>;
     }
 }