@alfadocs/ui-kit 0.82.0 → 0.84.0

package/dist/_chunks/widget-picker-DEmTVuFL.js

@@ -0,0 +1,193 @@
+import { jsx as t, jsxs as c } from "react/jsx-runtime";
+import { forwardRef as P, useState as N, useEffect as S, useMemo as f, useCallback as T, useImperativeHandle as W } from "react";
+import { c as _ } from "./index-D2ZczOXr.js";
+import { useTranslation as j } from "react-i18next";
+import { D as l } from "./dialog-UbKJCi1X.js";
+import { T as z } from "./text-input-CUvCb6ST.js";
+import { B as C } from "./badge-DCOqV9mI.js";
+import { u as I } from "./registry-DvAUVLHh.js";
+import { S as L } from "./search-QbWPlY5f.js";
+const R = {
+  id: "widget-picker",
+  capabilities: ["pick"],
+  state: {
+    open: {
+      type: "boolean",
+      descriptionKey: "ui.agent.widgetPicker.state.open",
+      description: "Whether the picker dialog is currently open.",
+      read: (i) => i.getPickerState().open
+    },
+    items: {
+      type: "{ id: string, disabled: boolean }[]",
+      descriptionKey: "ui.agent.widgetPicker.state.items",
+      description: "Widget-type ids on offer and whether each is pickable. Ids only — titles are host-app strings.",
+      read: (i) => i.getPickerState().items
+    }
+  },
+  actions: {
+    pick_widget: {
+      // Picking adds a widget to the host dashboard — a write, reversible
+      // by removing the widget again.
+      safety: "write",
+      argsType: "id",
+      argsSchema: {
+        type: "object",
+        properties: {
+          id: {
+            type: "string",
+            description: "Widget-type id (see items state)."
+          }
+        },
+        required: ["id"]
+      },
+      returns: "boolean (accepted)",
+      returnsSchema: {
+        type: "boolean",
+        description: "True when the pick was applied; false when the picker is closed, the id is unknown, or the item is disabled."
+      },
+      idempotent: !1,
+      descriptionKey: "ui.agent.widgetPicker.actions.pickWidget",
+      description: "Pick a widget type from the open catalogue. The picker closes and the host adds the widget. Refused while the dialog is closed and for disabled items.",
+      invoke: (i, a) => i.pick(a.id)
+    }
+  },
+  domHooks: {
+    root: { attr: "data-component", value: "widget-picker" },
+    instanceId: {
+      attr: "data-component-id",
+      sourceProp: "id",
+      description: "Sourced from the id prop."
+    },
+    item: {
+      attr: "data-widget-type-id",
+      description: "Each option tile carries its widget-type id."
+    }
+  }
+}, A = _(
+  [
+    "ds:flex ds:w-full ds:min-h-[var(--min-target-size)] ds:items-start ds:gap-[var(--spacing-sm)]",
+    "ds:rounded-[var(--radius-md)] ds:border ds:border-border ds:bg-[var(--card)]",
+    "ds:ps-[var(--spacing-md)] ds:pe-[var(--spacing-md)] ds:py-[var(--spacing-md)]",
+    "ds:text-start ds:transition-colors",
+    "ds:hover:bg-muted/10",
+    "ds:focus-visible:outline-[length:var(--focus-ring-width)] ds:focus-visible:outline-solid ds:focus-visible:outline-ring ds:focus-visible:outline-offset-[length:var(--focus-ring-offset)]",
+    "ds:disabled:opacity-50 ds:disabled:cursor-not-allowed ds:disabled:hover:bg-transparent"
+  ].join(" "),
+  { variants: {}, defaultVariants: {} }
+), B = P(
+  ({ open: i, onOpenChange: a, items: d, onPick: m, title: k, id: h }, y) => {
+    const { t: r } = j(), [p, v] = N("");
+    S(() => {
+      i || v("");
+    }, [i]);
+    const b = f(() => {
+      const e = p.trim().toLowerCase();
+      return e ? d.filter(
+        (s) => s.title.toLowerCase().includes(e) || (s.description ?? "").toLowerCase().includes(e)
+      ) : d;
+    }, [d, p]), w = f(() => {
+      const e = [];
+      for (const s of b) {
+        const n = s.category || null;
+        let o = e.find((x) => x.category === n);
+        o || (o = { category: n, entries: [] }, n === null ? e.unshift(o) : e.push(o)), o.entries.push(s);
+      }
+      return e;
+    }, [b]), g = T(
+      (e) => {
+        m(e), a(!1);
+      },
+      [m, a]
+    ), u = f(
+      () => ({
+        pick(e) {
+          if (!i) return !1;
+          const s = d.find((n) => n.id === e);
+          return !s || s.disabled ? !1 : (g(e), !0);
+        },
+        getPickerState() {
+          return {
+            open: i,
+            items: d.map((e) => ({
+              id: e.id,
+              disabled: !!e.disabled
+            }))
+          };
+        }
+      }),
+      [i, d, g]
+    );
+    return W(y, () => u, [u]), I(R, u, h), /* @__PURE__ */ t(l.Root, { open: i, onOpenChange: a, children: /* @__PURE__ */ t(l.Content, { size: "lg", children: /* @__PURE__ */ c("div", { "data-component": "widget-picker", "data-component-id": h, children: [
+      /* @__PURE__ */ t(l.Title, { children: k ?? r("widgetPicker.title") }),
+      /* @__PURE__ */ t(l.Description, { className: "ds:sr-only", children: r("widgetPicker.description") }),
+      /* @__PURE__ */ t("div", { className: "ds:mt-[var(--spacing-sm)]", children: /* @__PURE__ */ t(
+        z,
+        {
+          "aria-label": r("widgetPicker.searchLabel"),
+          placeholder: r("widgetPicker.searchPlaceholder"),
+          startAdornment: /* @__PURE__ */ t(L, { "aria-hidden": "true" }),
+          value: p,
+          onChange: (e) => v(e.target.value)
+        }
+      ) }),
+      /* @__PURE__ */ t(
+        "div",
+        {
+          tabIndex: 0,
+          className: "ds:mt-[var(--spacing-md)] ds:flex ds:max-h-[60vh] ds:flex-col ds:gap-[var(--spacing-md)] ds:overflow-y-auto ds:pe-[var(--spacing-xs)] ds:focus-visible:outline-[length:var(--focus-ring-width)] ds:focus-visible:outline-solid ds:focus-visible:outline-ring ds:focus-visible:outline-offset-[length:var(--focus-ring-offset)]",
+          children: w.length === 0 ? /* @__PURE__ */ t(
+            "p",
+            {
+              role: "status",
+              className: "ds:py-[var(--spacing-lg)] ds:text-center ds:text-sm ds:text-muted-foreground",
+              children: d.length === 0 ? r("widgetPicker.none") : r("widgetPicker.empty")
+            }
+          ) : w.map((e) => /* @__PURE__ */ c(
+            "section",
+            {
+              className: "ds:flex ds:flex-col ds:gap-[var(--spacing-sm)]",
+              children: [
+                e.category ? /* @__PURE__ */ t("h3", { className: "ds:text-xs ds:font-semibold ds:uppercase ds:tracking-wide ds:text-muted-foreground", children: e.category }) : null,
+                /* @__PURE__ */ t("div", { className: "ds:grid ds:gap-[var(--spacing-sm)] ds:sm:grid-cols-2", children: e.entries.map((s) => /* @__PURE__ */ c(
+                  "button",
+                  {
+                    type: "button",
+                    disabled: s.disabled,
+                    onClick: () => g(s.id),
+                    className: A(),
+                    "data-widget-type-id": s.id,
+                    children: [
+                      s.icon ? /* @__PURE__ */ t(
+                        "span",
+                        {
+                          "aria-hidden": "true",
+                          className: "ds:mt-[var(--spacing-2xs)] ds:inline-flex ds:size-5 ds:shrink-0 ds:items-center ds:justify-center ds:text-muted-foreground ds:[&_svg]:size-5",
+                          children: s.icon
+                        }
+                      ) : null,
+                      /* @__PURE__ */ c("span", { className: "ds:flex ds:min-w-0 ds:flex-col ds:gap-[var(--spacing-2xs)]", children: [
+                        /* @__PURE__ */ c("span", { className: "ds:flex ds:items-center ds:gap-[var(--spacing-xs)]", children: [
+                          /* @__PURE__ */ t("span", { className: "ds:truncate ds:text-sm ds:font-medium", children: s.title }),
+                          s.badge ? /* @__PURE__ */ t(C, { variant: "info", size: "sm", children: s.badge }) : null
+                        ] }),
+                        s.description ? /* @__PURE__ */ t("span", { className: "ds:text-xs ds:text-muted-foreground", children: s.description }) : null
+                      ] })
+                    ]
+                  },
+                  s.id
+                )) })
+              ]
+            },
+            e.category ?? "__ungrouped__"
+          ))
+        }
+      )
+    ] }) }) });
+  }
+);
+B.displayName = "WidgetPicker";
+export {
+  B as W,
+  R as w
+};
+//# sourceMappingURL=widget-picker-DEmTVuFL.js.map

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "0.82.0",
+  "packageVersion": "0.84.0",
   "components": [
     {
       "kind": "component",
@@ -1756,9 +1756,62 @@
     {
       "kind": "component",
       "id": "chart",
-      "capabilities": [],
-      "state": [],
+      "capabilities": [
+        "view_change"
+      ],
+      "state": [
+        {
+          "name": "declaredType",
+          "type": "'line' | 'bar' | 'pie' | 'donut' | 'area' | 'radialBar'",
+          "description": "The consumer-declared chart type — the shape `update_series` expects.",
+          "descriptionKey": "ui.agent.chart.state.declaredType"
+        },
+        {
+          "name": "effectiveType",
+          "type": "'line' | 'bar' | 'pie' | 'donut' | 'area' | 'radialBar'",
+          "description": "The type currently rendered — differs from declaredType after a type-switcher pick.",
+          "descriptionKey": "ui.agent.chart.state.effectiveType"
+        },
+        {
+          "name": "availableTypes",
+          "type": "ChartType[]",
+          "description": "Types the switcher offers. Empty when the chart has no type switcher.",
+          "descriptionKey": "ui.agent.chart.state.availableTypes"
+        }
+      ],
       "actions": [
+        {
+          "name": "change_view",
+          "safety": "write",
+          "argsType": "type",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "type": {
+                "type": "string",
+                "enum": [
+                  "line",
+                  "bar",
+                  "area",
+                  "pie",
+                  "donut"
+                ],
+                "description": "The chart type to render."
+              }
+            },
+            "required": [
+              "type"
+            ]
+          },
+          "returns": "boolean (accepted)",
+          "returnsSchema": {
+            "type": "boolean",
+            "description": "True when the switch was applied; false when the chart has no type switcher or the type is not offered (check availableTypes first)."
+          },
+          "idempotent": true,
+          "description": "Switch the rendered chart type via the type switcher. No-op (returns false) when the chart has no switcher or the type is not offered.",
+          "descriptionKey": "ui.agent.chart.actions.changeView"
+        },
         {
           "name": "update_series",
           "safety": "write",
@@ -1805,7 +1858,7 @@
             ]
           },
           "idempotent": true,
-          "description": "Replace the chart series without remounting.",
+          "description": "Replace the chart series without remounting. Pass the DECLARED type’s shape (see declaredType state) — when the user has switched the view cross-shape the values are converted to the rendered shape. The write targets the live instance only: a later type switch re-reads the original props and discards it.",
           "descriptionKey": "ui.agent.chart.actions.updateSeries"
         },
         {
@@ -2817,6 +2870,124 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "dashboard-grid",
+      "capabilities": [
+        "edit_inline"
+      ],
+      "state": [
+        {
+          "name": "layout",
+          "type": "{ id: string, x: number, y: number, w: number, h: number }[]",
+          "description": "Current widget geometry in cell units — ids and rectangles only, no widget content.",
+          "descriptionKey": "ui.agent.dashboardGrid.state.layout"
+        },
+        {
+          "name": "cols",
+          "type": "number",
+          "description": "Logical column count of the board.",
+          "descriptionKey": "ui.agent.dashboardGrid.state.cols"
+        },
+        {
+          "name": "editing",
+          "type": "boolean",
+          "description": "Whether edit mode is on. Move/resize actions are refused while it is off — the host app owns the toggle.",
+          "descriptionKey": "ui.agent.dashboardGrid.state.editing"
+        }
+      ],
+      "actions": [
+        {
+          "name": "move_widget",
+          "safety": "write",
+          "argsType": "id, x, y",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Widget id (see layout state)."
+              },
+              "x": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "0-based logical column."
+              },
+              "y": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "0-based row."
+              }
+            },
+            "required": [
+              "id",
+              "x",
+              "y"
+            ]
+          },
+          "returns": "boolean (accepted)",
+          "returnsSchema": {
+            "type": "boolean",
+            "description": "True when applied; false when edit mode is off or the id is unknown."
+          },
+          "idempotent": true,
+          "description": "Move a widget to a cell. Out-of-bounds targets are clamped; colliding widgets are pushed down and the layout re-compacts. Refused while edit mode is off.",
+          "descriptionKey": "ui.agent.dashboardGrid.actions.moveWidget"
+        },
+        {
+          "name": "resize_widget",
+          "safety": "write",
+          "argsType": "id, w, h",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Widget id (see layout state)."
+              },
+              "w": {
+                "type": "integer",
+                "minimum": 1,
+                "description": "Column span (≥ 1)."
+              },
+              "h": {
+                "type": "integer",
+                "minimum": 1,
+                "description": "Row span (≥ 1)."
+              }
+            },
+            "required": [
+              "id",
+              "w",
+              "h"
+            ]
+          },
+          "returns": "boolean (accepted)",
+          "returnsSchema": {
+            "type": "boolean",
+            "description": "True when applied; false when edit mode is off or the id is unknown."
+          },
+          "idempotent": true,
+          "description": "Resize a widget to a span. Clamped to the grid and the widget’s min/max; colliding widgets are pushed down. Refused while edit mode is off.",
+          "descriptionKey": "ui.agent.dashboardGrid.actions.resizeWidget"
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "dashboard-grid"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-widget-id",
+          "description": "Each widget wrapper carries its layout id."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "data-table",
@@ -12688,6 +12859,69 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "widget-picker",
+      "capabilities": [
+        "pick"
+      ],
+      "state": [
+        {
+          "name": "open",
+          "type": "boolean",
+          "description": "Whether the picker dialog is currently open.",
+          "descriptionKey": "ui.agent.widgetPicker.state.open"
+        },
+        {
+          "name": "items",
+          "type": "{ id: string, disabled: boolean }[]",
+          "description": "Widget-type ids on offer and whether each is pickable. Ids only — titles are host-app strings.",
+          "descriptionKey": "ui.agent.widgetPicker.state.items"
+        }
+      ],
+      "actions": [
+        {
+          "name": "pick_widget",
+          "safety": "write",
+          "argsType": "id",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Widget-type id (see items state)."
+              }
+            },
+            "required": [
+              "id"
+            ]
+          },
+          "returns": "boolean (accepted)",
+          "returnsSchema": {
+            "type": "boolean",
+            "description": "True when the pick was applied; false when the picker is closed, the id is unknown, or the item is disabled."
+          },
+          "idempotent": false,
+          "description": "Pick a widget type from the open catalogue. The picker closes and the host adds the widget. Refused while the dialog is closed and for disabled items.",
+          "descriptionKey": "ui.agent.widgetPicker.actions.pickWidget"
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "widget-picker"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-widget-type-id",
+          "description": "Each option tile carries its widget-type id."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "workflow-card",

package/dist/agent-i18n/en.json

@@ -190,8 +190,14 @@
       }
     },
     "chart": {
+      "state": {
+        "declaredType": "The consumer-declared chart type — the shape `update_series` expects.",
+        "effectiveType": "The type currently rendered — differs from declaredType after a type-switcher pick.",
+        "availableTypes": "Types the switcher offers. Empty when the chart has no type switcher."
+      },
       "actions": {
-        "updateSeries": "Replace the chart series without remounting.",
+        "changeView": "Switch the rendered chart type via the type switcher. No-op (returns false) when the chart has no switcher or the type is not offered.",
+        "updateSeries": "Replace the chart series without remounting. Pass the DECLARED type’s shape (see declaredType state) — when the user has switched the view cross-shape the values are converted to the rendered shape. The write targets the live instance only: a later type switch re-reads the original props and discards it.",
         "exportPng": "Return a PNG data URI of the chart for export or screenshotting."
       }
     },
@@ -323,6 +329,17 @@
         "clearSelection": "Clear the selected country."
       }
     },
+    "dashboardGrid": {
+      "state": {
+        "layout": "Current widget geometry in cell units — ids and rectangles only, no widget content.",
+        "cols": "Logical column count of the board.",
+        "editing": "Whether edit mode is on. Move/resize actions are refused while it is off — the host app owns the toggle."
+      },
+      "actions": {
+        "moveWidget": "Move a widget to a cell. Out-of-bounds targets are clamped; colliding widgets are pushed down and the layout re-compacts. Refused while edit mode is off.",
+        "resizeWidget": "Resize a widget to a span. Clamped to the grid and the widget’s min/max; colliding widgets are pushed down. Refused while edit mode is off."
+      }
+    },
     "dataTableTabs": {
       "state": {
         "activeTabId": "Id of the currently-active saved-filter tab.",
@@ -1292,6 +1309,15 @@
         "getResult": "Return the converted value in the to-unit, or null when no source value is set."
       }
     },
+    "widgetPicker": {
+      "state": {
+        "open": "Whether the picker dialog is currently open.",
+        "items": "Widget-type ids on offer and whether each is pickable. Ids only — titles are host-app strings."
+      },
+      "actions": {
+        "pickWidget": "Pick a widget type from the open catalogue. The picker closes and the host adds the widget. Refused while the dialog is closed and for disabled items."
+      }
+    },
     "workflowEditor": {
       "state": {
         "totalSteps": "Total number of nodes currently in the workflow graph.",

package/dist/components/chart/chart.d.ts

@@ -60,14 +60,49 @@ export interface ChartProps extends VariantProps<typeof chartVariants> {
      * `radialValueFormatter` for that.
      */
     valueFormatter?: (value: number) => string;
+    /**
+     * Opt-in type switcher. Pass two or more of `'line' | 'bar' | 'area' |
+     * 'pie' | 'donut'` to render an icon radiogroup (an `IconButtonGroup`)
+     * above the plot that lets the user flip the chart between those types.
+     * `type` is the initial selection and is always offered; the user's pick
+     * then sticks across re-renders (remount with a new `key` to reset it).
+     * When the picked type reads the other data shape, the data adapts: axis
+     * series collapse to one slice per series (that series' total) for `pie` /
+     * `donut`, and slice values become a single-series axis chart with
+     * `labels` as the categories. `radialBar` cannot participate — such
+     * entries are ignored (DEV warning) and a `radialBar` chart never shows
+     * the switcher.
+     */
+    switchableTypes?: ChartType[];
+    /** Called when the user picks a different type via the switcher. */
+    onTypeChange?: (type: ChartType) => void;
     /** Extra class names on the wrapper. */
     className?: string;
 }
 export interface ChartHandle {
     /** Returns a PNG data URI for the chart. */
     dataURI: () => Promise<string>;
-    /** Updates series without remounting. */
+    /**
+     * Updates series without remounting. Always pass the DECLARED `type`'s
+     * shape — while the user has switched the view across the axis/slice
+     * boundary the values (and, for axis→slice, the slice labels) are
+     * converted to the rendered shape; for slice→axis the categories stay
+     * the `labels` prop, so keep the value count stable. The update writes
+     * to the live ApexCharts instance only: a later type switch remounts
+     * from the original props and discards it.
+     */
     updateSeries: (next: ChartProps['series']) => void;
+    /**
+     * Switches the rendered type via the type switcher. Returns `false`
+     * (no-op) when the switcher is not enabled or the type is not offered.
+     */
+    setType: (next: ChartType) => boolean;
+    /** Declared vs rendered type plus the types the switcher offers ([] when disabled). */
+    getTypeState: () => {
+        declaredType: ChartType;
+        effectiveType: ChartType;
+        availableTypes: ChartType[];
+    };
 }
 export declare const Chart: import("react").ForwardRefExoticComponent<ChartProps & import("react").RefAttributes<ChartHandle>>;
 export { chartVariants };

package/dist/components/chart/index.js

@@ -1,4 +1,4 @@
-import { C as t, c as s, a as c } from "../../_chunks/chart-CpkpA74k.js";
+import { C as t, c as s, a as c } from "../../_chunks/chart-GFLv4cXm.js";
 export {
   t as Chart,
   s as chartAgent,

package/dist/components/dashboard-grid/dashboard-grid-engine.d.ts

@@ -0,0 +1,37 @@
+export interface DashboardWidgetLayout {
+    id: string;
+    /** 0-based logical column of the inline-start edge. */
+    x: number;
+    /** 0-based row of the block-start edge. */
+    y: number;
+    /** Column span (≥ 1). */
+    w: number;
+    /** Row span (≥ 1). */
+    h: number;
+    minW?: number;
+    minH?: number;
+    maxW?: number;
+    maxH?: number;
+}
+export declare function collides(a: DashboardWidgetLayout, b: DashboardWidgetLayout): boolean;
+/** Clamp a rect to the grid bounds and its own min/max constraints. */
+export declare function clampRect(item: DashboardWidgetLayout, cols: number): DashboardWidgetLayout;
+/**
+ * Resolve overlaps and apply upward gravity. The `activeId` rect (the one
+ * being dragged/resized) keeps its exact position; every other widget is
+ * pushed down out of collisions, then pulled up as far as gravity allows.
+ * Deterministic: non-active widgets settle in reading order (y, then x).
+ */
+export declare function normalise(layout: DashboardWidgetLayout[], cols: number, activeId?: string): DashboardWidgetLayout[];
+/** Move a widget to a target cell, resolving collisions around it. */
+export declare function moveItem(layout: DashboardWidgetLayout[], id: string, x: number, y: number, cols: number): DashboardWidgetLayout[];
+/** Resize a widget to a target span, resolving collisions around it. */
+export declare function resizeItem(layout: DashboardWidgetLayout[], id: string, w: number, h: number, cols: number): DashboardWidgetLayout[];
+/** First free slot (reading order) that fits a `w`×`h` rect. */
+export declare function firstFit(layout: DashboardWidgetLayout[], cols: number, w: number, h: number): {
+    x: number;
+    y: number;
+};
+/** Total rows the layout occupies (for sizing the add tile / container). */
+export declare function rowCount(layout: DashboardWidgetLayout[]): number;
+//# sourceMappingURL=dashboard-grid-engine.d.ts.map

package/dist/components/dashboard-grid/dashboard-grid.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { DashboardGridHandle } from './dashboard-grid';
+export declare const dashboardGridAgent: AgentAdapter<DashboardGridHandle>;
+//# sourceMappingURL=dashboard-grid.agent.d.ts.map