@tensor_1/react 2.30.0 → 2.31.0

package/dist/filter-model.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Typed column filters for `FilterEditor` (HAR-1365; TENSOR C6 `table-filter-editor.tsx`,
+ * MOTUS C-1 "+ filter"). The value is data the product serializes into its own query; the
+ * summary feeds a `Chip`. Pure, so a server can summarize a saved view too.
+ */
+interface FilterChoice {
+    value: string;
+    label: string;
+}
+type TextFilterOperator = 'contains' | 'not-contains' | 'is' | 'is-not' | 'starts-with';
+type NumberFilterOperator = 'eq' | 'neq' | 'lt' | 'lte' | 'gt' | 'gte' | 'between';
+type FilterValue = {
+    kind: 'enum';
+    values: string[];
+} | {
+    kind: 'text';
+    operator: TextFilterOperator;
+    text: string;
+} | {
+    kind: 'number';
+    operator: NumberFilterOperator;
+    value?: number;
+    to?: number;
+} | {
+    kind: 'date-range';
+    from?: string;
+    to?: string;
+} | {
+    kind: 'boolean';
+    value?: boolean;
+} | {
+    kind: 'reference';
+    values: FilterChoice[];
+};
+type FilterValueKind = FilterValue['kind'];
+interface FilterField {
+    id: string;
+    /** Column name, also the start of the chip summary. */
+    label: string;
+    kind: FilterValueKind;
+    /** `enum`: the choices. */
+    options?: readonly FilterChoice[];
+    /** `reference`: finds records to pick; rejected promises show the error state. */
+    onSearch?: (query: string) => Promise<readonly FilterChoice[]>;
+    /** `text` / `number`: the operators offered, in order. Default: all of the kind. */
+    operators?: readonly (TextFilterOperator | NumberFilterOperator)[];
+    /** `number`: a unit shown after the value, e.g. "days". */
+    unit?: string;
+    /** `boolean`: words for true and false, e.g. Escalated / Not escalated. Default from labels. */
+    trueLabel?: string;
+    falseLabel?: string;
+}
+interface FilterSummaryLabels {
+    operators: Record<TextFilterOperator | NumberFilterOperator, string>;
+    yes: string;
+    no: string;
+    /** `{from}`, `{to}`; also used for a number range. */
+    range: string;
+    /** Only a start date. `{from}`. */
+    from: string;
+    /** Only an end date. `{to}`. */
+    until: string;
+    /** More than `maxListed` values: `{first}`, `{count}`. */
+    more: string;
+}
+declare const DEFAULT_FILTER_SUMMARY_LABELS: FilterSummaryLabels;
+declare const TEXT_FILTER_OPERATORS: readonly TextFilterOperator[];
+declare const NUMBER_FILTER_OPERATORS: readonly NumberFilterOperator[];
+/** The empty value for a field kind (what Clear resets to). */
+declare function emptyFilterValue(kind: FilterValueKind): FilterValue;
+/** True when the value filters nothing (so the chip goes away). */
+declare function isFilterEmpty(value: FilterValue | undefined): boolean;
+interface SummarizeFilterOptions {
+    labels?: Partial<FilterSummaryLabels>;
+    /** Formats a `YYYY-MM-DD` date (a product format such as DD.MM.YYYY). Default: as given. */
+    formatDate?: (date: string) => string;
+    /** Formats a number. Default: `String`. */
+    formatNumber?: (value: number) => string;
+    /** List this many values before "+N". Default 2. */
+    maxListed?: number;
+}
+/**
+ * One line for the filter chip, e.g. "State: Open, Pending", "Priority ≥ 2", "Created:
+ * 01.10.2026 – 05.10.2026", "Escalated: Yes". Empty values give an empty string.
+ */
+declare function summarizeFilter(field: FilterField, value: FilterValue | undefined, options?: SummarizeFilterOptions): string;
+
+export { DEFAULT_FILTER_SUMMARY_LABELS, type FilterChoice, type FilterField, type FilterSummaryLabels, type FilterValue, type FilterValueKind, NUMBER_FILTER_OPERATORS, type NumberFilterOperator, type SummarizeFilterOptions, TEXT_FILTER_OPERATORS, type TextFilterOperator, emptyFilterValue, isFilterEmpty, summarizeFilter };

package/dist/filter-model.js

@@ -0,0 +1,91 @@
+const DEFAULT_FILTER_SUMMARY_LABELS = {
+  operators: {
+    contains: "contains",
+    "not-contains": "does not contain",
+    is: "is",
+    "is-not": "is not",
+    "starts-with": "starts with",
+    eq: "=",
+    neq: "\u2260",
+    lt: "<",
+    lte: "\u2264",
+    gt: ">",
+    gte: "\u2265",
+    between: "between"
+  },
+  yes: "Yes",
+  no: "No",
+  range: "{from} \u2013 {to}",
+  from: "from {from}",
+  until: "until {to}",
+  more: "{first} +{count}"
+};
+const TEXT_FILTER_OPERATORS = ["contains", "not-contains", "is", "is-not", "starts-with"];
+const NUMBER_FILTER_OPERATORS = ["eq", "neq", "lt", "lte", "gt", "gte", "between"];
+function emptyFilterValue(kind) {
+  switch (kind) {
+    case "enum":
+      return { kind, values: [] };
+    case "text":
+      return { kind, operator: "contains", text: "" };
+    case "number":
+      return { kind, operator: "eq" };
+    case "date-range":
+      return { kind };
+    case "boolean":
+      return { kind };
+    case "reference":
+      return { kind, values: [] };
+  }
+}
+function isFilterEmpty(value) {
+  if (!value) return true;
+  switch (value.kind) {
+    case "enum":
+    case "reference":
+      return value.values.length === 0;
+    case "text":
+      return value.text.trim() === "";
+    case "number":
+      return value.value === void 0 || value.operator === "between" && value.to === void 0;
+    case "date-range":
+      return !value.from && !value.to;
+    case "boolean":
+      return value.value === void 0;
+  }
+}
+const fill = (template, values) => template.replace(/\{(\w+)\}/g, (match, key) => key in values ? String(values[key]) : match);
+function summarizeFilter(field, value, options = {}) {
+  if (!value || isFilterEmpty(value)) return "";
+  const labels = { ...DEFAULT_FILTER_SUMMARY_LABELS, ...options.labels, operators: { ...DEFAULT_FILTER_SUMMARY_LABELS.operators, ...options.labels?.operators } };
+  const date = options.formatDate ?? ((d) => d);
+  const num = (n) => `${options.formatNumber?.(n) ?? String(n)}${field.unit ? ` ${field.unit}` : ""}`;
+  const list = (items) => {
+    const max = Math.max(1, options.maxListed ?? 2);
+    return items.length > max ? fill(labels.more, { first: items.slice(0, max).join(", "), count: items.length - max }) : items.join(", ");
+  };
+  switch (value.kind) {
+    case "enum": {
+      const byValue = new Map((field.options ?? []).map((o) => [o.value, o.label]));
+      return `${field.label}: ${list(value.values.map((v) => byValue.get(v) ?? v))}`;
+    }
+    case "reference":
+      return `${field.label}: ${list(value.values.map((v) => v.label))}`;
+    case "text":
+      return `${field.label} ${labels.operators[value.operator]} \u201C${value.text.trim()}\u201D`;
+    case "number":
+      return value.operator === "between" ? `${field.label}: ${fill(labels.range, { from: num(value.value), to: num(value.to) })}` : `${field.label} ${labels.operators[value.operator]} ${num(value.value)}`;
+    case "date-range":
+      return `${field.label}: ${value.from && value.to ? fill(labels.range, { from: date(value.from), to: date(value.to) }) : value.from ? fill(labels.from, { from: date(value.from) }) : fill(labels.until, { to: date(value.to) })}`;
+    case "boolean":
+      return `${field.label}: ${value.value ? field.trueLabel ?? labels.yes : field.falseLabel ?? labels.no}`;
+  }
+}
+export {
+  DEFAULT_FILTER_SUMMARY_LABELS,
+  NUMBER_FILTER_OPERATORS,
+  TEXT_FILTER_OPERATORS,
+  emptyFilterValue,
+  isFilterEmpty,
+  summarizeFilter
+};

package/dist/icons/Icon.d.ts

@@ -5,6 +5,7 @@ import { IconNode, UixIcon, IconProps } from './types.js';
 /** Renders a glyph as an inline SVG; the props contract shared by every icon. */
 declare function renderIcon(node: IconNode, { size, tone, label, strokeWidth, className, style, ...rest }: IconProps, ref?: unknown): react.ReactElement<{
     string?: number | string | undefined | undefined;
+    r?: number | string | undefined | undefined;
     type?: string | undefined | undefined;
     id?: string | undefined | undefined;
     name?: string | undefined | undefined;
@@ -252,7 +253,6 @@ declare function renderIcon(node: IconNode, { size, tone, label, strokeWidth, cl
     fill: string;
     clip?: number | string | undefined | undefined;
     stroke: string;
-    r?: number | string | undefined | undefined;
     filter?: string | undefined | undefined;
     values?: string | undefined | undefined;
     offset?: number | string | undefined | undefined;