@tensor_1/react 2.31.0 → 2.33.0

package/dist/components/RuleBuilder.js

@@ -7,10 +7,12 @@ import {
   mapRuleGroup,
   moveRuleNode,
   removeRuleNode,
+  setRuleCombinator,
   summarizeRule,
   validateRuleDefinition
 } from "../rule-builder-model.js";
 import { fillLabel } from "../fill-label.js";
+import { useUixLabels } from "../labels-context.js";
 const DEFAULT_RULE_BUILDER_LABELS = {
   region: "Rule builder",
   summary: "Rule summary",
@@ -40,7 +42,20 @@ const DEFAULT_RULE_BUILDER_LABELS = {
   summaryIssuesMany: "Rule has {count} validation issues.",
   addCondition: "Add condition",
   addGroup: "Add group",
-  addAction: "Add action"
+  addAction: "Add action",
+  issueDuplicateId: "Duplicate id \u201C{id}\u201D.",
+  issueMaxDepth: "Nesting exceeds {max} levels.",
+  issueEmptyGroup: "Add at least one condition.",
+  issueMissingField: "Choose a field.",
+  issueMissingOperator: "Choose an operator.",
+  issueNoActions: "Add at least one action.",
+  issueMissingActionType: "Choose an action.",
+  summarySentence: "When {conditions}, then {actions}.",
+  summarySentenceConditionsOnly: "When {conditions}.",
+  summaryNoConditions: "no conditions",
+  summaryNoActions: "no actions",
+  and: "AND",
+  or: "OR"
 };
 let ruleId = 0;
 const nextId = (prefix) => `${prefix}-${Date.now().toString(36)}-${(++ruleId).toString(36)}`;
@@ -49,28 +64,45 @@ function defaultCondition(fields, operators) {
   const operator = operators.find((item) => field?.operators?.includes(item.id)) ?? operators[0];
   return { id: nextId("condition"), field: field?.id ?? "", operator: operator?.id ?? "", value: "" };
 }
-function RuleGroupEditor({ group, depth, root, fields, operators, maxDepth, disabled, onRootChange, labels }) {
+function RuleGroupEditor({ group, depth, root, fields, operators, maxDepth, disabled, onRootChange, labels, combinator, hideCombinator, allowGroups }) {
   const updateNode = (id, update) => onRootChange(mapRuleGroup(root, id, update));
   const addCondition = () => onRootChange(appendRuleNode(root, group.id, defaultCondition(fields, operators), maxDepth));
   const addGroup = () => onRootChange(appendRuleNode(root, group.id, {
     id: nextId("group"),
-    combinator: "and",
+    combinator: combinator ?? "and",
     conditions: [defaultCondition(fields, operators)]
   }, maxDepth));
+  const rowControls = (node, index, label) => disabled ? null : /* @__PURE__ */ jsx(
+    RowControls,
+    {
+      labels,
+      label,
+      first: index === 0,
+      last: index === group.conditions.length - 1,
+      disabled: false,
+      onUp: () => onRootChange(moveRuleNode(root, node.id, -1)),
+      onDown: () => onRootChange(moveRuleNode(root, node.id, 1)),
+      onRemove: () => onRootChange(removeRuleNode(root, node.id))
+    }
+  );
   return /* @__PURE__ */ jsxs("fieldset", { className: "uix-rule-builder__group", "data-depth": depth, children: [
     /* @__PURE__ */ jsxs("legend", { className: "uix-rule-builder__group-heading", children: [
       /* @__PURE__ */ jsx("span", { children: depth === 1 ? labels.when : labels.group }),
-      /* @__PURE__ */ jsxs("label", { children: [
+      !hideCombinator && (combinator ? /* @__PURE__ */ jsxs("span", { className: "uix-rule-builder__match", children: [
+        labels.match,
+        " ",
+        combinator === "or" ? labels.any : labels.all
+      ] }) : /* @__PURE__ */ jsxs("label", { children: [
         labels.match,
         /* @__PURE__ */ jsxs("select", { className: "uix-select uix-select--sm", value: group.combinator, disabled, onChange: (event) => updateNode(group.id, (node) => ({ ...node, combinator: event.currentTarget.value })), children: [
           /* @__PURE__ */ jsx("option", { value: "and", children: labels.all }),
           /* @__PURE__ */ jsx("option", { value: "or", children: labels.any })
         ] })
-      ] })
+      ] }))
     ] }),
     /* @__PURE__ */ jsx("div", { className: "uix-rule-builder__rows", children: group.conditions.map((node, index) => isRuleGroup(node) ? /* @__PURE__ */ jsxs("div", { className: "uix-rule-builder__nested", children: [
-      /* @__PURE__ */ jsx(RuleGroupEditor, { ...{ group: node, depth: depth + 1, root, fields, operators, maxDepth, disabled, onRootChange, labels } }),
-      /* @__PURE__ */ jsx(RowControls, { labels, label: labels.itemGroup, first: index === 0, last: index === group.conditions.length - 1, disabled, onUp: () => onRootChange(moveRuleNode(root, node.id, -1)), onDown: () => onRootChange(moveRuleNode(root, node.id, 1)), onRemove: () => onRootChange(removeRuleNode(root, node.id)) })
+      /* @__PURE__ */ jsx(RuleGroupEditor, { ...{ group: node, depth: depth + 1, root, fields, operators, maxDepth, disabled, onRootChange, labels, combinator, hideCombinator, allowGroups } }),
+      rowControls(node, index, labels.itemGroup)
     ] }, node.id) : /* @__PURE__ */ jsx(
       ConditionRow,
       {
@@ -80,13 +112,13 @@ function RuleGroupEditor({ group, depth, root, fields, operators, maxDepth, disa
         operators,
         disabled,
         onChange: (condition) => updateNode(node.id, () => condition),
-        controls: /* @__PURE__ */ jsx(RowControls, { labels, label: labels.itemCondition, first: index === 0, last: index === group.conditions.length - 1, disabled, onUp: () => onRootChange(moveRuleNode(root, node.id, -1)), onDown: () => onRootChange(moveRuleNode(root, node.id, 1)), onRemove: () => onRootChange(removeRuleNode(root, node.id)) })
+        controls: rowControls(node, index, labels.itemCondition)
       },
       node.id
     )) }),
-    /* @__PURE__ */ jsxs("div", { className: "uix-rule-builder__add", children: [
-      /* @__PURE__ */ jsx("button", { type: "button", className: "uix-btn uix-btn--secondary uix-btn--sm", onClick: addCondition, disabled: disabled || fields.length === 0 || operators.length === 0, children: labels.addCondition }),
-      /* @__PURE__ */ jsx("button", { type: "button", className: "uix-btn uix-btn--ghost uix-btn--sm", onClick: addGroup, disabled: disabled || depth >= maxDepth, children: labels.addGroup })
+    !disabled && /* @__PURE__ */ jsxs("div", { className: "uix-rule-builder__add", children: [
+      /* @__PURE__ */ jsx("button", { type: "button", className: "uix-btn uix-btn--secondary uix-btn--sm", onClick: addCondition, disabled: fields.length === 0 || operators.length === 0, children: labels.addCondition }),
+      allowGroups && /* @__PURE__ */ jsx("button", { type: "button", className: "uix-btn uix-btn--ghost uix-btn--sm", onClick: addGroup, disabled: depth >= maxDepth, children: labels.addGroup })
     ] })
   ] });
 }
@@ -124,9 +156,14 @@ function RuleBuilder({
   onChange,
   fields,
   operators,
-  actions,
+  actions = [],
   maxDepth = 3,
   readOnly = false,
+  conditionsOnly = false,
+  combinator,
+  hideCombinator = false,
+  allowGroups = true,
+  checks,
   validate,
   className,
   addConditionLabel,
@@ -134,33 +171,81 @@ function RuleBuilder({
   addActionLabel,
   labels: labelOverrides
 }) {
+  const provided = useUixLabels().ruleBuilder;
   const labels = {
     ...DEFAULT_RULE_BUILDER_LABELS,
+    ...provided,
     ...addConditionLabel != null ? { addCondition: addConditionLabel } : {},
     ...addGroupLabel != null ? { addGroup: addGroupLabel } : {},
     ...addActionLabel != null ? { addAction: addActionLabel } : {},
     ...labelOverrides
   };
   const issuesText = (template1, templateN) => fillLabel(issues.length === 1 ? template1 : templateN, { count: issues.length });
-  const issues = [...validateRuleDefinition(value, maxDepth), ...validate?.(value) ?? []];
+  const builtIn = validateRuleDefinition(value, maxDepth, {
+    messages: {
+      duplicateId: labels.issueDuplicateId,
+      maxDepth: labels.issueMaxDepth,
+      emptyGroup: labels.issueEmptyGroup,
+      missingField: labels.issueMissingField,
+      missingOperator: labels.issueMissingOperator,
+      noActions: labels.issueNoActions,
+      missingActionType: labels.issueMissingActionType
+    },
+    checks: conditionsOnly ? { noActions: false, missingActionType: false, ...checks } : checks
+  });
+  const issues = [...builtIn, ...validate?.(value) ?? []];
   const fieldLabels = Object.fromEntries(fields.map((field) => [field.id, field.label]));
   const operatorLabels = Object.fromEntries(operators.map((operator) => [operator.id, operator.label]));
   const actionLabels = Object.fromEntries(actions.map((action) => [action.id, action.label]));
-  if (readOnly) return /* @__PURE__ */ jsxs("section", { className: cx("uix-rule-builder uix-rule-builder--summary", className), "aria-label": labels.summary, children: [
-    /* @__PURE__ */ jsx("p", { children: summarizeRule(value, { fields: fieldLabels, operators: operatorLabels, actions: actionLabels }) }),
-    issues.length > 0 && /* @__PURE__ */ jsx("p", { className: "uix-rule-builder__invalid", children: issuesText(labels.summaryIssuesOne, labels.summaryIssuesMany) })
-  ] });
+  if (readOnly === "summary") {
+    const sentence = summarizeRule(value, {
+      fields: fieldLabels,
+      operators: operatorLabels,
+      actions: actionLabels,
+      conditionsOnly,
+      words: {
+        sentence: labels.summarySentence,
+        sentenceConditionsOnly: labels.summarySentenceConditionsOnly,
+        noConditions: labels.summaryNoConditions,
+        noActions: labels.summaryNoActions,
+        and: labels.and,
+        or: labels.or
+      }
+    });
+    return /* @__PURE__ */ jsxs("section", { className: cx("uix-rule-builder uix-rule-builder--summary", className), "aria-label": labels.summary, children: [
+      /* @__PURE__ */ jsx("p", { children: sentence }),
+      issues.length > 0 && /* @__PURE__ */ jsx("p", { className: "uix-rule-builder__invalid", children: issuesText(labels.summaryIssuesOne, labels.summaryIssuesMany) })
+    ] });
+  }
+  const disabled = readOnly === true;
+  const emitWhen = (when) => onChange({ ...value, when: combinator ? setRuleCombinator(when, combinator) : when });
   const updateActions = (next) => onChange({ ...value, then: next });
-  return /* @__PURE__ */ jsxs("section", { className: cx("uix-rule-builder", className), "aria-label": labels.region, children: [
-    /* @__PURE__ */ jsx(RuleGroupEditor, { group: value.when, depth: 1, root: value.when, fields, operators, maxDepth, disabled: readOnly, onRootChange: (when) => onChange({ ...value, when }), labels }),
-    /* @__PURE__ */ jsxs("fieldset", { className: "uix-rule-builder__actions", children: [
+  return /* @__PURE__ */ jsxs("section", { className: cx("uix-rule-builder", disabled && "uix-rule-builder--readonly", className), "aria-label": labels.region, children: [
+    /* @__PURE__ */ jsx(
+      RuleGroupEditor,
+      {
+        group: value.when,
+        depth: 1,
+        root: value.when,
+        fields,
+        operators,
+        maxDepth,
+        disabled,
+        onRootChange: emitWhen,
+        labels,
+        combinator,
+        hideCombinator,
+        allowGroups: allowGroups && maxDepth > 1
+      }
+    ),
+    !conditionsOnly && /* @__PURE__ */ jsxs("fieldset", { className: "uix-rule-builder__actions", children: [
       /* @__PURE__ */ jsx("legend", { children: labels.then }),
       value.then.map((action, index) => {
         const definition = actions.find((item) => item.id === action.type);
         return /* @__PURE__ */ jsxs("div", { className: "uix-rule-builder__action", children: [
-          /* @__PURE__ */ jsx("select", { className: "uix-select", value: action.type, onChange: (event) => updateActions(value.then.map((item) => item.id === action.id ? { ...item, type: event.currentTarget.value } : item)), "aria-label": labels.actionType, children: actions.map((item) => /* @__PURE__ */ jsx("option", { value: item.id, children: item.label }, item.id)) }),
-          definition?.renderParameters?.(action, (parameters) => updateActions(value.then.map((item) => item.id === action.id ? { ...item, parameters } : item)), false),
-          /* @__PURE__ */ jsx(
+          /* @__PURE__ */ jsx("select", { className: "uix-select", value: action.type, disabled, onChange: (event) => updateActions(value.then.map((item) => item.id === action.id ? { ...item, type: event.currentTarget.value } : item)), "aria-label": labels.actionType, children: actions.map((item) => /* @__PURE__ */ jsx("option", { value: item.id, children: item.label }, item.id)) }),
+          definition?.renderParameters?.(action, (parameters) => updateActions(value.then.map((item) => item.id === action.id ? { ...item, parameters } : item)), disabled),
+          !disabled && /* @__PURE__ */ jsx(
             RowControls,
             {
               labels,
@@ -183,7 +268,7 @@ function RuleBuilder({
           )
         ] }, action.id);
       }),
-      /* @__PURE__ */ jsx("button", { type: "button", className: "uix-btn uix-btn--secondary uix-btn--sm", disabled: actions.length === 0, onClick: () => updateActions([...value.then, { id: nextId("action"), type: actions[0]?.id ?? "", parameters: {} }]), children: labels.addAction })
+      !disabled && /* @__PURE__ */ jsx("button", { type: "button", className: "uix-btn uix-btn--secondary uix-btn--sm", disabled: actions.length === 0, onClick: () => updateActions([...value.then, { id: nextId("action"), type: actions[0]?.id ?? "", parameters: {} }]), children: labels.addAction })
     ] }),
     /* @__PURE__ */ jsx("div", { className: "uix-rule-builder__validation", "aria-live": "polite", children: issues.length === 0 ? /* @__PURE__ */ jsx("span", { children: labels.valid }) : /* @__PURE__ */ jsxs(Fragment, { children: [
       /* @__PURE__ */ jsx("strong", { children: issuesText(labels.issuesOne, labels.issuesMany) }),

package/dist/components/SchedulingCalendar.d.ts

@@ -1,110 +1,4 @@
-import * as react from 'react';
-import { ReactNode } from 'react';
-import { CalendarWeekday } from '../calendar-model.js';
-
-type SchedulingCalendarView = 'month' | 'week' | 'agenda';
-type SchedulingEntryState = 'scheduled' | 'conflicted' | 'in-progress' | 'blackout-violation';
-type SchedulingOverlayKind = 'maintenance' | 'blackout';
-/**
- * Which date text a `formatDate` call is for (TENSOR B1/C9, HAR-1347):
- * `day` names one day (each day cell's accessible name, the week-range title);
- * `weekday` is the short column header (the date is any day of that weekday);
- * `month` is the month-view title (the date is the first of the month).
- */
-type SchedulingDatePart = 'day' | 'weekday' | 'month';
-interface SchedulingCalendarEntry {
-    id: string;
-    title: string;
-    start: string;
-    end: string;
-    state?: SchedulingEntryState;
-    meta?: string;
-}
-interface SchedulingCalendarOverlay {
-    id: string;
-    label: string;
-    start: string;
-    end: string;
-    kind: SchedulingOverlayKind;
-}
-/**
- * Every word the calendar renders (TENSOR RX-125, UIX-12). `{timeZone}`, `{view}`,
- * `{title}`, `{state}`, `{start}`, `{end}` are placeholders.
- */
-interface SchedulingCalendarLabels {
-    region: string;
-    previous: string;
-    next: string;
-    viewGroup: string;
-    viewMonth: string;
-    viewWeek: string;
-    viewAgenda: string;
-    loading: string;
-    retry: string;
-    agenda: string;
-    agendaEmpty: string;
-    grid: string;
-    entry: string;
-    legend: string;
-    /** The "+N more" toggle on a day with more entries than `maxEntriesPerDay`. `{count}` placeholder. */
-    moreEntries: string;
-    /** Accessible name of that toggle. `{count}` and `{date}` placeholders. */
-    moreEntriesLabel: string;
-    /** The toggle once the day is expanded in place. */
-    fewerEntries: string;
-    states: Record<SchedulingEntryState, string>;
-}
-declare const DEFAULT_SCHEDULING_CALENDAR_LABELS: SchedulingCalendarLabels;
-interface SchedulingCalendarProps {
-    entries: SchedulingCalendarEntry[];
-    anchorDate: string;
-    timeZone: string;
-    view?: SchedulingCalendarView;
-    onViewChange?: (view: SchedulingCalendarView) => void;
-    onAnchorDateChange?: (date: string) => void;
-    onSelectEntry?: (entry: SchedulingCalendarEntry) => void;
-    overlays?: SchedulingCalendarOverlay[];
-    filter?: (entry: SchedulingCalendarEntry) => boolean;
-    renderEntry?: (entry: SchedulingCalendarEntry) => ReactNode;
-    locale?: string;
-    /** First column of the month and week grids: 0 = Sunday … 6 = Saturday. Defaults to 1 (Monday). */
-    weekStartsOn?: CalendarWeekday;
-    /**
-     * Formats every calendar date the component writes (`date` is `YYYY-MM-DD`). Use it to
-     * apply a product date format such as DD.MM.YYYY; defaults to `Intl` in `locale`.
-     */
-    formatDate?: (date: string, part: SchedulingDatePart) => string;
-    /**
-     * Formats an entry's start or end instant (ISO 8601) for the agenda and the entry names.
-     * The component does not shift it: render it in `timeZone` yourself. Defaults to `Intl`
-     * medium date + short time in `timeZone`.
-     */
-    formatInstant?: (instant: string) => string;
-    /**
-     * Show at most this many entries in a month or week day; the rest collapse behind a
-     * "+N more" toggle. Unset shows every entry.
-     */
-    maxEntriesPerDay?: number;
-    /**
-     * Called by the "+N more" toggle with the day and every entry on it. When set, the
-     * consumer shows them (a popover, a drawer, the day view) and the day stays collapsed;
-     * otherwise the day expands in place.
-     */
-    onShowMore?: (date: string, entries: SchedulingCalendarEntry[]) => void;
-    /**
-     * A small badge beside a day's date, e.g. a collision count. Keep it short (a number or a
-     * glyph): it shares a narrow column with the date and is clipped, not wrapped. It sits
-     * outside the date button, so give it its own accessible text (a visually hidden word next
-     * to the number). Return null for no badge.
-     */
-    renderDayBadge?: (date: string, entries: SchedulingCalendarEntry[]) => ReactNode;
-    loading?: boolean;
-    error?: string;
-    onRetry?: () => void;
-    className?: string;
-    labels?: Partial<SchedulingCalendarLabels>;
-}
-/** Month/week/agenda calendar for UTC ranges rendered in an explicit IANA time zone. */
-declare function SchedulingCalendar({ entries, anchorDate, timeZone, view: controlledView, onViewChange, onAnchorDateChange, onSelectEntry, overlays, filter, renderEntry, locale, weekStartsOn, formatDate, formatInstant: formatInstantProp, maxEntriesPerDay, onShowMore, renderDayBadge, loading, error, onRetry, className, labels: labelOverrides, }: SchedulingCalendarProps): react.JSX.Element;
-
-export { DEFAULT_SCHEDULING_CALENDAR_LABELS, SchedulingCalendar, type SchedulingCalendarEntry, type SchedulingCalendarLabels, type SchedulingCalendarOverlay, type SchedulingCalendarProps, type SchedulingCalendarView, type SchedulingDatePart, type SchedulingEntryState, type SchedulingOverlayKind };
+import 'react';
+import '../calendar-model.js';
+import '../scheduling-calendar-model.js';
+export { D as DEFAULT_SCHEDULING_CALENDAR_LABELS, S as SchedulingBand, a as SchedulingCalendar, b as SchedulingCalendarDay, c as SchedulingCalendarEntry, d as SchedulingCalendarLabels, e as SchedulingCalendarOverlay, f as SchedulingCalendarProps, g as SchedulingCalendarView, h as SchedulingDatePart, i as SchedulingEntryState, j as SchedulingLegendItem, k as SchedulingMarker, l as SchedulingMarkerEmphasis, m as SchedulingOverlayKind, n as SchedulingOverlayPattern, o as SchedulingStatus } from '../SchedulingCalendar-C4XVbqZr.js';