@affino/datagrid-vue-app 0.1.39 → 0.1.40

package/README.md

@@ -708,7 +708,7 @@ Out of the box this wires:
 - sort ascending / descending / clear
 - group / ungroup for groupable columns
 - pin column submenu (`left`, `right`, `none`)
-- value-set filter picker with search + apply/clear
+- value-set filter picker with search + apply/clear; server-backed row models may resolve values asynchronously through `api.columns.getHistogram(columnKey, { ignoreSelfFilter: true, search })`
 - column order / visibility popover
 
 Supported action keys for `actions` are:
@@ -1741,11 +1741,57 @@ The component emits:
 
 - When at least one filter is active, the `Advanced filter` toolbar button shows an active filter icon and active button styling.
 - Removing the only advanced-filter clause does not lock the UI; the builder keeps one empty clause row so the user can clear and rebuild the expression in place.
+- `advancedFilter.labels` customizes the toolbar text, panel headings, field labels, action labels, logical join labels, and operator labels. This is the supported localization path for built-in advanced-filter copy.
+
+```vue
+<DataGrid
+  :rows="rows"
+  :columns="columns"
+  :advanced-filter="{
+    labels: {
+      buttonLabel: 'Расширенный фильтр',
+      title: 'Условия отбора',
+      joinLabel: 'Связь',
+      columnLabel: 'Колонка',
+      operatorLabel: 'Оператор',
+      valueLabel: 'Значение',
+      apply: 'Применить',
+      cancel: 'Отмена',
+      operators: {
+        contains: 'содержит',
+        equals: 'равно',
+        'not-equals': 'не равно',
+      },
+      joins: { and: 'И', or: 'ИЛИ' },
+    },
+  }"
+/>
+```
 
 ## Built-in Overlay Panels
 
 - The built-in `Column layout`, `Advanced filter`, and `Find / replace` toolbar panels render through the shared Affino overlay host rather than inline in the grid tree.
 - These built-in panels are draggable by their header title area and reopen at the last detached position for the current grid instance during the active page session.
+- `columnLayout.labels` customizes the built-in columns panel text, including the toolbar label, panel title, close/cancel/apply actions, and move-button accessible labels.
+
+```vue
+<DataGrid
+  :rows="rows"
+  :columns="columns"
+  :column-layout="{
+    labels: {
+      buttonLabel: 'Колонки',
+      eyebrow: 'Настройка колонок',
+      title: 'Порядок и видимость',
+      close: 'Закрыть',
+      cancel: 'Отмена',
+      apply: 'Применить',
+      moveUp: 'Вверх',
+      moveDown: 'Вниз',
+    },
+  }"
+/>
+```
 
 ## Column Reorder
 
@@ -1792,7 +1838,7 @@ If you need to ship the UI but keep row order locked, leave `rowReorder` unset o
 ### Runtime access
 
 - `getApi()`
-- `getRuntime()`
+- `getRuntime()` returns the typed runtime bridge (`DataGridExposedRuntime`) for virtual-window and body-row APIs.
 - `getCore()`
 
 ### History

package/dist/DataGrid.d.ts

@@ -1,5 +1,5 @@
 import { type CSSProperties, type ExtractPublicPropTypes, type PropType, type VNode } from "vue";
-import { type CreateDataGridCoreOptions, type DataGridApi, type DataGridApiRowSelectionChangedEvent, type DataGridApiSelectionChangedEvent, type DataGridApiPluginDefinition, type DataGridAggregationModel, type DataGridColumnSnapshot, type DataGridColumnPin, type DataGridComputedFieldDefinition, type DataGridCoreServiceRegistry, type DataGridFilterSnapshot, type DataGridFormulaFieldDefinition, type DataGridFormulaFunctionRegistry, type DataGridGroupBySpec, type DataGridMigrateStateOptions, type DataGridRowNode, type DataGridRowSelectionSnapshot, type DataGridRowModel, type DataGridRowNodeInput, type DataGridSetStateOptions, type DataGridSortState, type DataGridUnifiedColumnState, type DataGridUnifiedState, type DataGridPivotSpec } from "@affino/datagrid-vue";
+import { type CreateDataGridCoreOptions, type DataGridApi, type DataGridApiRowSelectionChangedEvent, type DataGridApiSelectionChangedEvent, type DataGridApiPluginDefinition, type DataGridAggregationModel, type DataGridColumnSnapshot, type DataGridColumnPin, type DataGridComputedFieldDefinition, type DataGridCoreServiceRegistry, type DataGridFilterSnapshot, type DataGridFormulaFieldDefinition, type DataGridFormulaFunctionRegistry, type DataGridGroupBySpec, type DataGridMigrateStateOptions, type DataGridRowNode, type DataGridRowSelectionSnapshot, type DataGridRowModel, type DataGridRowNodeInput, type DataGridSetStateOptions, type DataGridSortState, type DataGridUnifiedColumnState, type DataGridUnifiedState, type DataGridPivotSpec, type UseDataGridRuntimeResult } from "@affino/datagrid-vue";
 import { defineDataGridStructuralRowActionHandler, type DataGridStructuralRowActionHandler, type DataGridStructuralRowActionId } from "./dataGridStructuralRowActions";
 import type { DataGridBivariantCallback } from "./types/bivariance";
 import type { DataGridAppToolbarModule } from "./host/DataGridModuleHost";
@@ -58,6 +58,7 @@ export declare function defineDataGridFilterCellStyleReader<TRow = unknown>(): <
 export declare function defineDataGridCellClassResolver<TRow = unknown>(): <TResolver extends DataGridCellClassResolver<TRow>>(resolver: TResolver) => TResolver;
 export declare function defineDataGridCellStyleResolver<TRow = unknown>(): <TResolver extends DataGridCellStyleResolver<TRow>>(resolver: TResolver) => TResolver;
 export { defineDataGridStructuralRowActionHandler };
+export type DataGridExposedRuntime<TRow = unknown> = Pick<UseDataGridRuntimeResult<TRow>, "api" | "syncBodyRowsInRange" | "setViewportRange" | "setVirtualWindowRange" | "setRows" | "rowPartition" | "virtualWindow" | "columnSnapshot" | "getBodyRowAtIndex" | "resolveBodyRowIndexById">;
 declare const dataGridProps: {
     readonly rows: {
         readonly type: PropType<readonly unknown[]>;
@@ -341,6 +342,7 @@ export interface DataGridExposed<TRow = unknown> {
     history: DataGridHistoryController;
     getHistory: () => DataGridHistoryController;
     getApi: () => DataGridApi<TRow> | null;
+    getRuntime: () => DataGridExposedRuntime<TRow> | null;
     getSelectionAggregatesLabel: () => string;
     runStructuralRowAction: (action: DataGridStructuralRowActionId, rowId: string | number) => Promise<boolean>;
     getState: () => DataGridUnifiedState<TRow> | null;

package/dist/advanced-filter.js

@@ -1,4 +1,4 @@
-import { _ as e } from "./chunks/DataGridAdvancedFilterPopover.vue_vue_type_script_setup_true_lang-BUkG_Bz7.js";
+import { _ as e } from "./chunks/DataGridAdvancedFilterPopover.vue_vue_type_script_setup_true_lang-DxZakgyj.js";
 export {
   e as DataGridAdvancedFilterPopover
 };

package/dist/chunks/{DataGridAdvancedFilterPopover-BBLSw7c4.js → DataGridAdvancedFilterPopover-C_MjEKFo.js}

@@ -1,4 +1,4 @@
-import { _ as f } from "./DataGridAdvancedFilterPopover.vue_vue_type_script_setup_true_lang-BUkG_Bz7.js";
+import { _ as f } from "./DataGridAdvancedFilterPopover.vue_vue_type_script_setup_true_lang-DxZakgyj.js";
 export {
   f as default
 };

package/dist/chunks/DataGridAdvancedFilterPopover.vue_vue_type_script_setup_true_lang-DxZakgyj.js

@@ -0,0 +1,263 @@
+import { defineComponent as N, inject as z, ref as A, computed as c, watch as w, nextTick as O, openBlock as i, createElementBlock as u, Fragment as C, createElementVNode as a, mergeProps as F, unref as _, createCommentVNode as P, createTextVNode as K, toDisplayString as l, createBlock as M, Teleport as U, renderList as T, createVNode as k } from "vue";
+import { usePopoverController as Z, useFloatingPopover as H } from "@affino/popover-vue";
+import { _ as L } from "./DataGridFilterableCombobox.vue_vue_type_script_setup_true_lang-xry4J3Lx.js";
+import { d as J, r as Q } from "./dataGridOverlayThemeVars-vzY74EIz.js";
+import { D } from "./dataGridAdvancedFilter-xnME5bRa.js";
+import { u as W } from "./useDataGridDraggableOverlaySurface-BgkSR_nl.js";
+const X = ["data-datagrid-advanced-filter-active"], Y = {
+  key: 0,
+  class: "datagrid-app-toolbar__button-icon datagrid-app-toolbar__button-icon--advanced-filter",
+  "data-datagrid-advanced-filter-icon": "true",
+  "aria-hidden": "true"
+}, x = /* @__PURE__ */ a("svg", {
+  viewBox: "0 0 16 16",
+  focusable: "false"
+}, [
+  /* @__PURE__ */ a("path", {
+    d: "M2 3.5h12l-4.6 5.2v3.2l-2.8 1.6V8.7L2 3.5Z",
+    fill: "currentColor"
+  })
+], -1), ee = [
+  x
+], ae = ["data-datagrid-overlay-dragging"], te = { class: "datagrid-advanced-filter__header" }, le = { class: "datagrid-advanced-filter__eyebrow" }, oe = { class: "datagrid-advanced-filter__title" }, de = { class: "datagrid-advanced-filter__applied" }, re = { class: "datagrid-advanced-filter__applied-head" }, ie = { class: "datagrid-advanced-filter__eyebrow" }, ne = { class: "datagrid-advanced-filter__applied-title" }, se = ["disabled"], ce = {
+  key: 0,
+  class: "datagrid-advanced-filter__applied-list"
+}, ue = {
+  key: 1,
+  class: "datagrid-advanced-filter__applied-empty"
+}, ve = { class: "datagrid-advanced-filter__rows" }, pe = { class: "datagrid-advanced-filter__field datagrid-advanced-filter__field--join" }, _e = { class: "datagrid-advanced-filter__label" }, fe = { class: "datagrid-advanced-filter__field" }, ge = { class: "datagrid-advanced-filter__label" }, be = { class: "datagrid-advanced-filter__field" }, me = { class: "datagrid-advanced-filter__label" }, ye = { class: "datagrid-advanced-filter__field datagrid-advanced-filter__field--value" }, he = { class: "datagrid-advanced-filter__label" }, we = ["name", "value", "placeholder", "aria-label", "onInput"], Ce = { class: "datagrid-advanced-filter__row-actions" }, ke = ["onClick"], Le = { class: "datagrid-advanced-filter__footer" }, Ae = { class: "datagrid-advanced-filter__footer-actions" }, je = /* @__PURE__ */ N({
+  __name: "DataGridAdvancedFilterPopover",
+  props: {
+    isOpen: { type: Boolean },
+    clauses: {},
+    columns: {},
+    appliedFilterSummaryItems: { default: () => [] },
+    hasAnyFilters: { type: Boolean, default: !1 },
+    buttonLabel: {},
+    labels: { default: () => D },
+    active: { type: Boolean, default: !1 },
+    showActiveIcon: { type: Boolean, default: !1 }
+  },
+  emits: ["open", "add", "remove", "apply", "cancel", "reset-all", "update-clause"],
+  setup(I, { emit: j }) {
+    const n = I, s = j, m = z(J, A(null)), y = A({}), r = Z(
+      {
+        id: "advanced-filter",
+        role: "dialog",
+        closeOnEscape: !0,
+        closeOnInteractOutside: !0
+      },
+      {
+        onOpen: () => {
+          n.isOpen || s("open"), h();
+        },
+        onClose: () => {
+          n.isOpen && s("cancel");
+        }
+      }
+    ), p = H(r, {
+      placement: "bottom",
+      align: "start",
+      gutter: 10,
+      viewportPadding: 12,
+      zIndex: 180,
+      lockScroll: !1,
+      returnFocus: !0
+    }), f = W({
+      surfaceId: "advanced-filter",
+      rootElementRef: m,
+      floating: p
+    }), B = c(() => r.getTriggerProps({ role: "dialog" })), E = c(() => r.getContentProps({ role: "dialog", tabIndex: -1 })), S = c(() => r.state.value.open), V = c(() => p.teleportTarget.value), e = c(() => n.labels ?? D), $ = c(() => typeof n.buttonLabel == "string" && n.buttonLabel.trim().length > 0 ? n.buttonLabel.trim() : e.value.buttonLabel), R = c(() => Object.freeze([
+      { value: "and", label: e.value.joins.and },
+      { value: "or", label: e.value.joins.or }
+    ])), q = c(() => Object.freeze([
+      { value: "contains", label: e.value.operators.contains },
+      { value: "in", label: e.value.operators.in },
+      { value: "equals", label: e.value.operators.equals },
+      { value: "not-equals", label: e.value.operators["not-equals"] },
+      { value: "starts-with", label: e.value.operators["starts-with"] },
+      { value: "ends-with", label: e.value.operators["ends-with"] },
+      { value: "gt", label: e.value.operators.gt },
+      { value: "gte", label: e.value.operators.gte },
+      { value: "lt", label: e.value.operators.lt },
+      { value: "lte", label: e.value.operators.lte }
+    ])), G = c(() => n.columns.map((o) => ({
+      value: o.key,
+      label: o.label
+    })));
+    w(
+      () => n.isOpen,
+      async (o) => {
+        if (o) {
+          h(), r.state.value.open || r.open("programmatic"), await O(), p.contentRef.value?.querySelector('[data-advanced-filter-autofocus="true"]')?.focus({ preventScroll: !0 }), await p.updatePosition();
+          return;
+        }
+        r.state.value.open && r.close("programmatic");
+      },
+      { immediate: !0 }
+    ), w(m, () => {
+      r.state.value.open && h();
+    }), w(
+      () => n.clauses.length,
+      async () => {
+        r.state.value.open && (await O(), await p.updatePosition());
+      }
+    );
+    function h() {
+      y.value = Q(m.value);
+    }
+    function g(o, d, t) {
+      s("update-clause", { clauseId: o, field: d, value: t });
+    }
+    return (o, d) => (i(), u(C, null, [
+      a("button", F({
+        ref: _(p).triggerRef,
+        type: "button",
+        class: ["datagrid-app-toolbar__button", { "datagrid-app-toolbar__button--active": o.active }],
+        "data-datagrid-toolbar-action": "advanced-filter",
+        "data-datagrid-advanced-filter-active": o.showActiveIcon ? "true" : "false",
+        style: y.value
+      }, B.value), [
+        o.showActiveIcon ? (i(), u("span", Y, ee)) : P("", !0),
+        K(" " + l($.value), 1)
+      ], 16, X),
+      (i(), M(U, { to: V.value }, [
+        S.value ? (i(), u("section", F({
+          key: 0,
+          ref: _(p).contentRef,
+          class: "datagrid-advanced-filter",
+          "data-datagrid-overlay-surface": "true",
+          "data-datagrid-overlay-surface-id": "advanced-filter",
+          "data-datagrid-overlay-dragging": _(f).dragging.value ? "true" : "false",
+          style: [_(f).surfaceStyle.value, y.value]
+        }, E.value), [
+          a("header", te, [
+            a("div", {
+              class: "datagrid-overlay-drag-handle",
+              "data-datagrid-overlay-drag-handle": "true",
+              onPointerdown: d[0] || (d[0] = //@ts-ignore
+              (...t) => _(f).handlePointerDown && _(f).handlePointerDown(...t))
+            }, [
+              a("div", le, l(e.value.eyebrow), 1),
+              a("h3", oe, l(e.value.title), 1)
+            ], 32),
+            a("button", {
+              type: "button",
+              class: "datagrid-advanced-filter__ghost",
+              onClick: d[1] || (d[1] = (t) => s("cancel"))
+            }, l(e.value.close), 1)
+          ]),
+          a("section", de, [
+            a("div", re, [
+              a("div", null, [
+                a("div", ie, l(e.value.appliedEyebrow), 1),
+                a("div", ne, l(e.value.appliedTitle), 1)
+              ]),
+              a("button", {
+                type: "button",
+                class: "datagrid-advanced-filter__ghost",
+                disabled: !o.hasAnyFilters,
+                "data-datagrid-advanced-filter-action": "reset-all",
+                onClick: d[2] || (d[2] = (t) => s("reset-all"))
+              }, l(e.value.resetAllFilters), 9, se)
+            ]),
+            o.appliedFilterSummaryItems.length > 0 ? (i(), u("div", ce, [
+              (i(!0), u(C, null, T(o.appliedFilterSummaryItems, (t, b) => (i(), u("span", {
+                key: `applied-filter-${b}`,
+                class: "datagrid-advanced-filter__applied-chip"
+              }, l(t), 1))), 128))
+            ])) : (i(), u("div", ue, l(e.value.noFiltersApplied), 1))
+          ]),
+          a("div", ve, [
+            (i(!0), u(C, null, T(o.clauses, (t, b) => (i(), u("div", {
+              key: t.id,
+              class: "datagrid-advanced-filter__row"
+            }, [
+              a("label", pe, [
+                a("span", _e, l(e.value.joinLabel), 1),
+                k(L, {
+                  class: "datagrid-advanced-filter__select",
+                  value: t.join,
+                  options: R.value,
+                  "open-on-mount": !1,
+                  "open-on-focus": !1,
+                  "sticky-popover-id": "advanced-filter",
+                  disabled: b === 0,
+                  "aria-label": e.value.joinAriaLabel,
+                  onCommit: (v) => g(t.id, "join", v)
+                }, null, 8, ["value", "options", "disabled", "aria-label", "onCommit"])
+              ]),
+              a("label", fe, [
+                a("span", ge, l(e.value.columnLabel), 1),
+                k(L, {
+                  class: "datagrid-advanced-filter__select",
+                  value: t.columnKey,
+                  options: G.value,
+                  "open-on-mount": !1,
+                  "open-on-focus": !1,
+                  "sticky-popover-id": "advanced-filter",
+                  "data-advanced-filter-autofocus": b === 0 ? "true" : null,
+                  "aria-label": e.value.columnAriaLabel,
+                  onCommit: (v) => g(t.id, "columnKey", v)
+                }, null, 8, ["value", "options", "data-advanced-filter-autofocus", "aria-label", "onCommit"])
+              ]),
+              a("label", be, [
+                a("span", me, l(e.value.operatorLabel), 1),
+                k(L, {
+                  class: "datagrid-advanced-filter__select",
+                  value: t.operator,
+                  options: q.value,
+                  "open-on-mount": !1,
+                  "open-on-focus": !1,
+                  "sticky-popover-id": "advanced-filter",
+                  "aria-label": e.value.operatorAriaLabel,
+                  onCommit: (v) => g(t.id, "operator", v)
+                }, null, 8, ["value", "options", "aria-label", "onCommit"])
+              ]),
+              a("label", ye, [
+                a("span", he, l(e.value.valueLabel), 1),
+                a("input", {
+                  name: `datagrid-advanced-filter-value-${t.id}`,
+                  value: t.value,
+                  type: "text",
+                  placeholder: e.value.valuePlaceholder,
+                  "aria-label": e.value.valueAriaLabel,
+                  onInput: (v) => g(t.id, "value", v.target.value)
+                }, null, 40, we)
+              ]),
+              a("div", Ce, [
+                a("button", {
+                  type: "button",
+                  class: "datagrid-advanced-filter__ghost datagrid-advanced-filter__ghost--danger",
+                  onClick: (v) => s("remove", t.id)
+                }, l(o.clauses.length <= 1 ? e.value.clearClause : e.value.removeClause), 9, ke)
+              ])
+            ]))), 128))
+          ]),
+          a("footer", Le, [
+            a("button", {
+              type: "button",
+              class: "datagrid-advanced-filter__secondary",
+              onClick: d[3] || (d[3] = (t) => s("add"))
+            }, l(e.value.addClause), 1),
+            a("div", Ae, [
+              a("button", {
+                type: "button",
+                class: "datagrid-advanced-filter__secondary",
+                onClick: d[4] || (d[4] = (t) => s("cancel"))
+              }, l(e.value.cancel), 1),
+              a("button", {
+                type: "button",
+                class: "datagrid-advanced-filter__primary",
+                onClick: d[5] || (d[5] = (t) => s("apply"))
+              }, l(e.value.apply), 1)
+            ])
+          ])
+        ], 16, ae)) : P("", !0)
+      ], 8, ["to"]))
+    ], 64));
+  }
+});
+export {
+  je as _
+};