@kubex/zinc 1.1.11 → 1.1.13

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@kubex/zinc",
-  "version": "1.1.11",
+  "version": "1.1.13",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -633,6 +633,241 @@
             "events": []
           }
         },
+        {
+          "name": "zn-channel-tile",
+          "description": "A channel/queue slot tile with two faces: an active (occupied) state\nshowing an in-progress item, and an available (empty) state advertising\ncapacity — optionally reserving an incoming item with an auto-accept countdown.\n---\n\n\n### **Events:**\n - **zn-accept** - Emitted when an available tile is accepted (click or auto-accept). Cancelable — call `preventDefault()` to suppress the built-in `accept-uri` fetch.\n- **zn-reject** - Emitted when the reject control is pressed.\n\n### **Slots:**\n - **leading** - Replaces the leading icon in the active state.\n- **action** - Action content for the available state (e.g. a form). Falls back to a default accept button.\n- **footer** - Trailing content (e.g. status badges) in the active state.\n\n### **CSS Properties:**\n - **--channel-tile-color** - Resolved accent color (set from the `color` property). _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **progress** - The progress indicator (incoming countdown overlay or active progress bar).",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "available",
+              "description": "Renders the empty/available face instead of the active face.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "incoming",
+              "description": "(Available only) the tile is reserving an incoming item awaiting acceptance.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "variant",
+              "description": "Free-form grouping/theming key (reflected so consumers can query/style by it).",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "header",
+              "description": "Top-bar text (e.g. brand).",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "icon",
+              "description": "Leading icon (active state).",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "color",
+              "description": "Accent color driving the leading icon and `--channel-tile-color`.",
+              "value": { "type": "ChannelTileColor", "default": "'default'" }
+            },
+            {
+              "name": "title",
+              "description": "Primary line. Defaults to \"Available\" in the available state when unset.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "subtitle",
+              "description": "Secondary line.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "progress",
+              "description": "(Active only) progress bar fill, 0–100.",
+              "value": { "type": "number", "default": "0" }
+            },
+            {
+              "name": "progress-color",
+              "description": "(Active only) CSS color for the progress bar fill.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "fid",
+              "description": "Identifier carried in `zn-accept` / `zn-reject` event details.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "accept-uri",
+              "description": "(Available only) when set, accepting fetches this URI unless `zn-accept` is canceled.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "reserved-until",
+              "description": "(Available/incoming) epoch (seconds or millis) at which the reservation window ends.",
+              "value": { "type": "number", "default": "0" }
+            },
+            {
+              "name": "auto-accept-delay",
+              "description": "(Available/incoming) auto-accept window length in milliseconds.",
+              "value": { "type": "number", "default": "0" }
+            },
+            {
+              "name": "rejectable",
+              "description": "(Available/incoming) whether a reject control is offered.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "accept-icon",
+              "description": "Icon for the built-in accept button.",
+              "value": { "type": "string", "default": "'plus@lu'" }
+            },
+            {
+              "name": "accept-gaid",
+              "description": "Optional analytics id forwarded to the built-in accept button.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "reject-icon",
+              "description": "Icon for the reject control.",
+              "value": { "type": "string", "default": "'call_end'" }
+            },
+            {
+              "name": "reject-label",
+              "description": "Accessible label for the reject control.",
+              "value": { "type": "string", "default": "'Reject'" }
+            }
+          ],
+          "slots": [
+            {
+              "name": "leading",
+              "description": "Replaces the leading icon in the active state."
+            },
+            {
+              "name": "action",
+              "description": "Action content for the available state (e.g. a form). Falls back to a default accept button."
+            },
+            {
+              "name": "footer",
+              "description": "Trailing content (e.g. status badges) in the active state."
+            }
+          ],
+          "events": [
+            {
+              "name": "zn-accept",
+              "description": "Emitted when an available tile is accepted (click or auto-accept). Cancelable — call `preventDefault()` to suppress the built-in `accept-uri` fetch."
+            },
+            {
+              "name": "zn-reject",
+              "description": "Emitted when the reject control is pressed."
+            }
+          ],
+          "js": {
+            "properties": [
+              {
+                "name": "available",
+                "description": "Renders the empty/available face instead of the active face.",
+                "type": "boolean"
+              },
+              {
+                "name": "incoming",
+                "description": "(Available only) the tile is reserving an incoming item awaiting acceptance.",
+                "type": "boolean"
+              },
+              {
+                "name": "variant",
+                "description": "Free-form grouping/theming key (reflected so consumers can query/style by it).",
+                "type": "string"
+              },
+              {
+                "name": "header",
+                "description": "Top-bar text (e.g. brand).",
+                "type": "string"
+              },
+              {
+                "name": "icon",
+                "description": "Leading icon (active state).",
+                "type": "string"
+              },
+              {
+                "name": "color",
+                "description": "Accent color driving the leading icon and `--channel-tile-color`.",
+                "type": "ChannelTileColor"
+              },
+              {
+                "name": "title",
+                "description": "Primary line. Defaults to \"Available\" in the available state when unset.",
+                "type": "string"
+              },
+              {
+                "name": "subtitle",
+                "description": "Secondary line.",
+                "type": "string"
+              },
+              {
+                "name": "progress",
+                "description": "(Active only) progress bar fill, 0–100.",
+                "type": "number"
+              },
+              {
+                "name": "progressColor",
+                "description": "(Active only) CSS color for the progress bar fill.",
+                "type": "string"
+              },
+              {
+                "name": "fid",
+                "description": "Identifier carried in `zn-accept` / `zn-reject` event details.",
+                "type": "string"
+              },
+              {
+                "name": "acceptUri",
+                "description": "(Available only) when set, accepting fetches this URI unless `zn-accept` is canceled.",
+                "type": "string"
+              },
+              {
+                "name": "reservedUntil",
+                "description": "(Available/incoming) epoch (seconds or millis) at which the reservation window ends.",
+                "type": "number"
+              },
+              {
+                "name": "autoAcceptDelay",
+                "description": "(Available/incoming) auto-accept window length in milliseconds.",
+                "type": "number"
+              },
+              {
+                "name": "rejectable",
+                "description": "(Available/incoming) whether a reject control is offered.",
+                "type": "boolean"
+              },
+              {
+                "name": "acceptIcon",
+                "description": "Icon for the built-in accept button.",
+                "type": "string"
+              },
+              {
+                "name": "acceptGaid",
+                "description": "Optional analytics id forwarded to the built-in accept button.",
+                "type": "string"
+              },
+              {
+                "name": "rejectIcon",
+                "description": "Icon for the reject control.",
+                "type": "string"
+              },
+              {
+                "name": "rejectLabel",
+                "description": "Accessible label for the reject control.",
+                "type": "string"
+              }
+            ],
+            "events": [
+              {
+                "name": "zn-accept",
+                "description": "Emitted when an available tile is accepted (click or auto-accept). Cancelable — call `preventDefault()` to suppress the built-in `accept-uri` fetch."
+              },
+              {
+                "name": "zn-reject",
+                "description": "Emitted when the reject control is pressed."
+              }
+            ]
+          }
+        },
         {
           "name": "zn-chart",
           "description": "Chart component powered by Apache ECharts.\n---\n\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",

package/dist/zn.d.ts

@@ -3609,6 +3609,103 @@ declare module "components/tile-property/index" {
         }
     }
 }
+declare module "components/channel-tile/channel-tile.component" {
+    import { type CSSResultGroup, type PropertyValues } from 'lit';
+    import ZincElement from "internal/zinc-element";
+    export type ChannelTileColor = 'default' | 'primary' | 'info' | 'success' | 'warning' | 'error' | 'disabled';
+    /**
+     * @summary A channel/queue slot tile with two faces: an active (occupied) state
+     * showing an in-progress item, and an available (empty) state advertising
+     * capacity — optionally reserving an incoming item with an auto-accept countdown.
+     * @documentation https://zinc.style/components/channel-tile
+     * @status experimental
+     * @since 1.0
+     *
+     * @dependency zn-button
+     * @dependency zn-icon
+     *
+     * @event zn-accept - Emitted when an available tile is accepted (click or auto-accept).
+     *  Cancelable — call `preventDefault()` to suppress the built-in `accept-uri` fetch.
+     * @event zn-reject - Emitted when the reject control is pressed.
+     *
+     * @slot leading - Replaces the leading icon in the active state.
+     * @slot action - Action content for the available state (e.g. a form). Falls back to a default accept button.
+     * @slot footer - Trailing content (e.g. status badges) in the active state.
+     *
+     * @csspart base - The component's base wrapper.
+     * @csspart progress - The progress indicator (incoming countdown overlay or active progress bar).
+     *
+     * @cssproperty --channel-tile-color - Resolved accent color (set from the `color` property).
+     */
+    export default class ZnChannelTile extends ZincElement {
+        static styles: CSSResultGroup;
+        /** Renders the empty/available face instead of the active face. */
+        available: boolean;
+        /** (Available only) the tile is reserving an incoming item awaiting acceptance. */
+        incoming: boolean;
+        /** Free-form grouping/theming key (reflected so consumers can query/style by it). */
+        variant: string;
+        /** Top-bar text (e.g. brand). */
+        header: string;
+        /** Leading icon (active state). */
+        icon: string;
+        /** Accent color driving the leading icon and `--channel-tile-color`. */
+        color: ChannelTileColor;
+        /** Primary line. Defaults to "Available" in the available state when unset. */
+        title: string;
+        /** Secondary line. */
+        subtitle: string;
+        /** (Active only) progress bar fill, 0–100. */
+        progress: number;
+        /** (Active only) CSS color for the progress bar fill. */
+        progressColor: string;
+        /** Identifier carried in `zn-accept` / `zn-reject` event details. */
+        fid: string;
+        /** (Available only) when set, accepting fetches this URI unless `zn-accept` is canceled. */
+        acceptUri: string;
+        /** (Available/incoming) epoch (seconds or millis) at which the reservation window ends. */
+        reservedUntil: number;
+        /** (Available/incoming) auto-accept window length in milliseconds. */
+        autoAcceptDelay: number;
+        /** (Available/incoming) whether a reject control is offered. */
+        rejectable: boolean;
+        /** Icon for the built-in accept button. */
+        acceptIcon: string;
+        /** Optional analytics id forwarded to the built-in accept button. */
+        acceptGaid: string;
+        /** Icon for the reject control. */
+        rejectIcon: string;
+        /** Accessible label for the reject control. */
+        rejectLabel: string;
+        private _tickInterval;
+        private _autoAcceptFired;
+        protected firstUpdated(changed: PropertyValues): void;
+        disconnectedCallback(): void;
+        protected updated(changed: PropertyValues): void;
+        private _isCountingDown;
+        private _startTicker;
+        private _stopTicker;
+        private _maybeAutoAccept;
+        private _accept;
+        private _reservedUntilMs;
+        private _countdownPercent;
+        private _handleReject;
+        private _handleClick;
+        protected render(): unknown;
+        private _renderLeading;
+        private _renderAvailableAction;
+    }
+}
+declare module "components/channel-tile/index" {
+    import ZnChannelTile from "components/channel-tile/channel-tile.component";
+    export * from "components/channel-tile/channel-tile.component";
+    export default ZnChannelTile;
+    global {
+        interface HTMLElementTagNameMap {
+            'zn-channel-tile': ZnChannelTile;
+        }
+    }
+}
 declare module "components/chart/builders" {
     import type { EChartsOption } from 'echarts';
     export type ChartType = 'area' | 'bar' | 'line' | 'sankey';
@@ -8346,6 +8443,28 @@ declare module "events/zn-reorder" {
         }
     }
 }
+declare module "events/zn-accept" {
+    export type ZnAcceptEvent = CustomEvent<{
+        fid: string;
+        acceptUri: string;
+    }>;
+    global {
+        interface GlobalEventHandlersEventMap {
+            'zn-accept': ZnAcceptEvent;
+        }
+    }
+}
+declare module "events/zn-reject" {
+    export type ZnRejectEvent = CustomEvent<{
+        fid: string;
+        variant: string;
+    }>;
+    global {
+        interface GlobalEventHandlersEventMap {
+            'zn-reject': ZnRejectEvent;
+        }
+    }
+}
 declare module "events/events" {
     export type { ZnAfterHideEvent } from "events/zn-after-hide";
     export type { ZnAfterShowEvent } from "events/zn-after-show";
@@ -8359,6 +8478,8 @@ declare module "events/events" {
     export type { ZnSearchChangeEvent } from "events/zn-search-change";
     export type { ZnLanguageChangeEvent } from "events/zn-language-change";
     export type { ZnReorderEvent } from "events/zn-reorder";
+    export type { ZnAcceptEvent } from "events/zn-accept";
+    export type { ZnRejectEvent } from "events/zn-reject";
 }
 declare module "zinc" {
     export { default as Button } from "components/button/index";
@@ -8386,6 +8507,7 @@ declare module "zinc" {
     export { default as Tile } from "components/tile/index";
     export { default as TileGroup } from "components/tile-group/index";
     export { default as TileProperty } from "components/tile-property/index";
+    export { default as ChannelTile } from "components/channel-tile/index";
     export { default as Chart } from "components/chart/index";
     export { default as SimpleChart } from "components/simple-chart/index";
     export { default as Header } from "components/header/index";