@tensor_1/react 2.23.0 → 2.25.0

package/dist/components/SearchSuggest.js

@@ -0,0 +1,299 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useEffect, useId, useImperativeHandle, useLayoutEffect, useRef, useState } from "react";
+import { cx } from "../cx.js";
+import { useAnchoredPosition } from "../hooks/useAnchoredPosition.js";
+import { searchSegments } from "../search-suggest-model.js";
+import { Spinner } from "./Spinner.js";
+const SearchIcon = () => /* @__PURE__ */ jsxs("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [
+  /* @__PURE__ */ jsx("circle", { cx: "11", cy: "11", r: "7" }),
+  /* @__PURE__ */ jsx("path", { d: "m20 20-3.5-3.5" })
+] });
+const ClearIcon = () => /* @__PURE__ */ jsx("svg", { viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: 1.5, strokeLinecap: "round", "aria-hidden": "true", children: /* @__PURE__ */ jsx("path", { d: "M4 4l8 8M12 4l-8 8" }) });
+function Emphasised({ text, query }) {
+  return /* @__PURE__ */ jsx(Fragment, { children: searchSegments(text, query).map(
+    (segment, index) => segment.match ? /* @__PURE__ */ jsx("mark", { className: "uix-search-suggest__match", children: segment.text }, index) : /* @__PURE__ */ jsx("span", { children: segment.text }, index)
+  ) });
+}
+const keepFocus = (event) => event.preventDefault();
+const useIsomorphicLayoutEffect = typeof document !== "undefined" ? useLayoutEffect : useEffect;
+function SearchSuggest({
+  value,
+  onValueChange,
+  options,
+  onSelect,
+  label,
+  placeholder,
+  highlight,
+  heading,
+  headingAction,
+  footer,
+  loading = false,
+  loadingLabel,
+  empty,
+  error,
+  shortcutHint,
+  clearLabel = "Clear search",
+  status,
+  size = "md",
+  open: openProp,
+  strategy = "absolute",
+  onOpenChange,
+  inputRef,
+  autoFocus,
+  name,
+  className,
+  onBlur,
+  ...props
+}) {
+  const id = useId();
+  const listboxId = `${id}-listbox`;
+  const headingId = `${id}-heading`;
+  const rootRef = useRef(null);
+  const fieldRef = useRef(null);
+  useImperativeHandle(inputRef, () => fieldRef.current, []);
+  const [openState, setOpenState] = useState(false);
+  const open = openProp ?? openState;
+  const setOpen = (next) => {
+    if (openProp === void 0) setOpenState(next);
+    if (next !== open) onOpenChange?.(next);
+  };
+  const [focused, setFocused] = useState(false);
+  const [activeState, setActive] = useState(-1);
+  const itemCount = options.length + (footer ? 1 : 0);
+  const active = activeState < itemCount ? activeState : -1;
+  const optionKey = options.map((option) => option.id).join("|");
+  useEffect(() => setActive(-1), [optionKey]);
+  const hasText = value.trim().length > 0;
+  const showEmpty = hasText && !loading && !error && options.length === 0 && empty != null;
+  const showLoading = loading && options.length === 0;
+  const visible = open && (itemCount > 0 || showLoading || showEmpty || error != null);
+  const optionId = (index) => `${id}-option-${index}`;
+  useEffect(() => {
+    if (!visible || active < 0) return;
+    const node = document.getElementById(optionId(active));
+    node?.scrollIntoView?.({ block: "nearest" });
+  }, [active, visible]);
+  const choose = (index) => {
+    const option = options[index];
+    if (option) onSelect(option.id, option);
+    else if (footer && index === options.length) footer.onSelect();
+    else return;
+    setOpen(false);
+    setActive(-1);
+  };
+  const handleKeyDown = (event) => {
+    if (event.nativeEvent.isComposing || event.keyCode === 229) return;
+    switch (event.key) {
+      case "ArrowDown":
+      case "ArrowUp": {
+        event.preventDefault();
+        if (!itemCount) {
+          setOpen(true);
+          return;
+        }
+        const down = event.key === "ArrowDown";
+        if (!visible) {
+          setOpen(true);
+          setActive(down ? 0 : itemCount - 1);
+          return;
+        }
+        setActive((stored) => {
+          const current = stored < itemCount ? stored : -1;
+          if (current < 0) return down ? 0 : itemCount - 1;
+          return (current + (down ? 1 : -1) + itemCount) % itemCount;
+        });
+        return;
+      }
+      case "Home":
+      case "End":
+        if (visible && active >= 0 && itemCount) {
+          event.preventDefault();
+          setActive(event.key === "Home" ? 0 : itemCount - 1);
+        }
+        return;
+      case "Enter":
+        if (visible && active >= 0) {
+          event.preventDefault();
+          choose(active);
+          return;
+        }
+        if (visible && hasText && options.length) {
+          event.preventDefault();
+          choose(0);
+        }
+        return;
+      case "Escape":
+        if (visible) {
+          event.preventDefault();
+          event.stopPropagation();
+          setOpen(false);
+          setActive(-1);
+        } else if (value) {
+          event.preventDefault();
+          event.stopPropagation();
+          onValueChange("");
+        }
+        return;
+      default:
+    }
+  };
+  const handleBlur = (event) => {
+    onBlur?.(event);
+    if (!rootRef.current?.contains(event.relatedTarget)) {
+      setFocused(false);
+      setOpen(false);
+      setActive(-1);
+    }
+  };
+  const clear = () => {
+    onValueChange("");
+    setActive(-1);
+    fieldRef.current?.focus();
+  };
+  const activeId = visible && active >= 0 ? optionId(active) : void 0;
+  const fieldBoxRef = useRef(null);
+  const popupRef = useRef(null);
+  const floating = strategy === "fixed";
+  useIsomorphicLayoutEffect(() => {
+    const popup = popupRef.current;
+    const box = fieldBoxRef.current;
+    if (!floating || !visible || !popup || !box) return;
+    const size2 = () => {
+      popup.style.width = `${box.offsetWidth}px`;
+    };
+    size2();
+    window.addEventListener("resize", size2);
+    return () => window.removeEventListener("resize", size2);
+  }, [floating, visible]);
+  useAnchoredPosition(floating ? fieldBoxRef : null, popupRef, { open: floating && visible, placement: "bottom-start", offset: 4 });
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      ref: rootRef,
+      className: cx("uix-search-suggest", size === "lg" && "uix-search-suggest--lg", className),
+      "data-open": visible || void 0,
+      onBlur: handleBlur,
+      ...props,
+      children: [
+        /* @__PURE__ */ jsxs("div", { ref: fieldBoxRef, className: "uix-search-suggest__field", children: [
+          /* @__PURE__ */ jsx("span", { className: "uix-search-suggest__lead", "aria-hidden": "true", children: /* @__PURE__ */ jsx(SearchIcon, {}) }),
+          /* @__PURE__ */ jsx(
+            "input",
+            {
+              ref: fieldRef,
+              className: "uix-input uix-search-suggest__input",
+              type: "text",
+              role: "combobox",
+              "aria-label": label,
+              "aria-autocomplete": "list",
+              "aria-expanded": visible,
+              "aria-controls": listboxId,
+              "aria-activedescendant": activeId,
+              "aria-busy": loading || void 0,
+              autoComplete: "off",
+              spellCheck: false,
+              enterKeyHint: "search",
+              name,
+              value,
+              placeholder,
+              autoFocus,
+              onChange: (event) => {
+                onValueChange(event.target.value);
+                setActive(-1);
+                setOpen(true);
+              },
+              onFocus: () => {
+                setFocused(true);
+                setOpen(true);
+              },
+              onClick: () => setOpen(true),
+              onKeyDown: handleKeyDown
+            }
+          ),
+          /* @__PURE__ */ jsxs("span", { className: "uix-search-suggest__trail", children: [
+            loading && /* @__PURE__ */ jsx(Spinner, { className: "uix-search-suggest__spinner", label: loadingLabel }),
+            !loading && value && /* @__PURE__ */ jsx("button", { type: "button", className: "uix-search-suggest__clear", "aria-label": clearLabel, onMouseDown: keepFocus, onClick: clear, children: /* @__PURE__ */ jsx(ClearIcon, {}) }),
+            !loading && !value && !focused && shortcutHint && /* @__PURE__ */ jsx("kbd", { className: "uix-kbd", "aria-hidden": "true", children: shortcutHint })
+          ] })
+        ] }),
+        /* @__PURE__ */ jsxs("div", { ref: popupRef, className: "uix-search-suggest__popup", "data-strategy": floating ? "fixed" : void 0, hidden: !visible, children: [
+          heading && options.length > 0 && /* @__PURE__ */ jsxs("div", { className: "uix-search-suggest__header", children: [
+            /* @__PURE__ */ jsx("span", { className: "uix-search-suggest__heading", id: headingId, children: heading }),
+            headingAction && /* @__PURE__ */ jsx("button", { type: "button", className: "uix-search-suggest__header-action", onMouseDown: keepFocus, onClick: headingAction.onSelect, children: headingAction.label })
+          ] }),
+          /* @__PURE__ */ jsxs(
+            "ul",
+            {
+              id: listboxId,
+              role: "listbox",
+              className: "uix-search-suggest__list",
+              "aria-label": heading && options.length > 0 ? void 0 : label,
+              "aria-labelledby": heading && options.length > 0 ? headingId : void 0,
+              "aria-busy": loading || void 0,
+              children: [
+                options.map((option, index) => {
+                  const crumbs = option.meta ?? [];
+                  const descId = option.description ? `${optionId(index)}-desc` : void 0;
+                  return /* @__PURE__ */ jsxs(
+                    "li",
+                    {
+                      id: optionId(index),
+                      role: "option",
+                      "aria-selected": index === active,
+                      "aria-label": crumbs.length ? `${option.title}, ${crumbs.join(" \u203A ")}` : option.title,
+                      "aria-describedby": descId,
+                      className: "uix-search-suggest__option",
+                      "data-active": index === active || void 0,
+                      onMouseDown: keepFocus,
+                      onMouseMove: () => {
+                        if (active !== index) setActive(index);
+                      },
+                      onClick: () => choose(index),
+                      children: [
+                        option.icon != null && /* @__PURE__ */ jsx("span", { className: "uix-search-suggest__icon", "aria-hidden": "true", children: option.icon }),
+                        /* @__PURE__ */ jsxs("span", { className: "uix-search-suggest__body", children: [
+                          /* @__PURE__ */ jsx("span", { className: "uix-search-suggest__title", children: /* @__PURE__ */ jsx(Emphasised, { text: option.title, query: highlight ?? value }) }),
+                          crumbs.length > 0 && /* @__PURE__ */ jsx("span", { className: "uix-search-suggest__meta", title: crumbs.join(" \u203A "), children: crumbs.map((crumb, crumbIndex) => /* @__PURE__ */ jsx("span", { className: "uix-search-suggest__crumb", children: crumb }, crumbIndex)) }),
+                          option.description && /* @__PURE__ */ jsx("span", { id: descId, className: "uix-search-suggest__desc", children: /* @__PURE__ */ jsx(Emphasised, { text: option.description, query: highlight ?? value }) })
+                        ] })
+                      ]
+                    },
+                    option.id
+                  );
+                }),
+                footer && /* @__PURE__ */ jsx(
+                  "li",
+                  {
+                    id: optionId(options.length),
+                    role: "option",
+                    "aria-selected": active === options.length,
+                    className: "uix-search-suggest__footer",
+                    "data-active": active === options.length || void 0,
+                    onMouseDown: keepFocus,
+                    onMouseMove: () => {
+                      if (active !== options.length) setActive(options.length);
+                    },
+                    onClick: () => choose(options.length),
+                    children: footer.label
+                  }
+                )
+              ]
+            }
+          ),
+          showLoading && // The field's spinner is the announced status; this row is the visual echo in the list.
+          /* @__PURE__ */ jsxs("div", { className: "uix-search-suggest__state", "aria-hidden": "true", children: [
+            /* @__PURE__ */ jsx("span", { className: "uix-spinner" }),
+            loadingLabel && /* @__PURE__ */ jsx("span", { children: loadingLabel })
+          ] }),
+          error != null && options.length === 0 && !loading && /* @__PURE__ */ jsx("div", { className: "uix-search-suggest__state", children: error }),
+          showEmpty && /* @__PURE__ */ jsx("div", { className: "uix-search-suggest__state", children: empty })
+        ] }),
+        /* @__PURE__ */ jsx("span", { className: "uix-visually-hidden", role: "status", "aria-live": "polite", children: status ?? "" })
+      ]
+    }
+  );
+}
+export {
+  SearchSuggest
+};

package/dist/components/TableControls.d.ts

@@ -6,15 +6,40 @@ interface ViewMenuColumn {
     label: ReactNode;
     visible: boolean;
     disabled?: boolean;
+    /** Always shown (e.g. the record id): the row has no checkbox and no Hide / Show, its name sits in the checkbox's slot. */
+    required?: boolean;
+    /** Plain-text name for the `{label}` templates in `columnLabels` when `label` is not a string. */
+    textLabel?: string;
+}
+/**
+ * Words for the column rows. `{label}` is replaced by the column name; `moved` also gets
+ * `{position}` and `{count}`. Every key has an English default.
+ */
+interface ViewMenuColumnLabels {
+    /** Name of a row's ⋯ menu button and of the menu. Default `Column actions: {label}`. */
+    rowActions: string;
+    /** Name of a row's drag grip. Default `Drag to reorder: {label}`. */
+    reorder: string;
+    moveUp: string;
+    moveDown: string;
+    hide: string;
+    show: string;
+    /** Tooltip on a required column's name. Default `Always shown`. */
+    required: string;
+    /** Polite announcement after a move. Default `{label} moved to position {position} of {count}`. */
+    moved: string;
 }
 interface ViewMenuProps {
-    density: string;
-    densityLabel: ReactNode;
-    densityOptions: readonly {
+    /** The density section renders when `densityOptions` and `onDensityChange` are given. */
+    density?: string;
+    densityLabel?: ReactNode;
+    densityOptions?: readonly {
         value: string;
         label: ReactNode;
     }[];
-    onDensityChange: (value: string) => void;
+    onDensityChange?: (value: string) => void;
+    /** Optional title over the zebra / freeze switches. */
+    displayLabel?: ReactNode;
     zebra?: {
         checked: boolean;
         label: ReactNode;
@@ -28,9 +53,23 @@ interface ViewMenuProps {
     columns?: readonly ViewMenuColumn[];
     columnsLabel?: ReactNode;
     onColumnVisibilityChange?: (id: string, visible: boolean) => void;
+    /**
+     * Turns on reordering: every column row gets a drag grip (pointer; ArrowUp / ArrowDown once
+     * focused) and a ⋯ menu with Move up · Move down · Hide / Show, which is the keyboard path.
+     * Receives every column id, first to last. The order is the application's to persist.
+     */
+    onReorder?: (orderedIds: string[]) => void;
+    columnLabels?: Partial<ViewMenuColumnLabels>;
+    /** Pinned under the columns, e.g. a Reset sort `.uix-menu__item` button. */
+    footer?: ReactNode;
+    className?: string;
 }
-/** Controlled table presentation menu; wrap it with Popover when trigger behavior is needed. */
-declare function ViewMenu({ density, densityLabel, densityOptions, onDensityChange, zebra, freeze, columns, columnsLabel, onColumnVisibilityChange }: ViewMenuProps): react.JSX.Element;
+/**
+ * Controlled table presentation panel with its own surface: density, zebra / freeze and a column
+ * list under sticky section titles. A column row is grip · checkbox · name · ⋯ (grip and ⋯ with
+ * `onReorder`). Usable inside a Popover or any overlay shell, including one that adds no chrome.
+ */
+declare function ViewMenu({ density, densityLabel, densityOptions, onDensityChange, displayLabel, zebra, freeze, columns, columnsLabel, onColumnVisibilityChange, onReorder, columnLabels, footer, className, }: ViewMenuProps): react.JSX.Element;
 interface FilterOption {
     value: string;
     label: string;
@@ -102,4 +141,4 @@ type SavedViewMenuProps = SavedViewMenuBaseProps & ({
  */
 declare function SavedViewMenu({ items, sections, onSelect, onPinChange, pinLabel, unpinLabel, onReorder, reorderLabel, emptyLabel, actions, footer }: SavedViewMenuProps): react.JSX.Element;
 
-export { type FilterOption, FilterPopover, type FilterPopoverProps, type SavedViewItem, SavedViewMenu, type SavedViewMenuProps, type SavedViewSection, ViewMenu, type ViewMenuColumn, type ViewMenuProps };
+export { type FilterOption, FilterPopover, type FilterPopoverProps, type SavedViewItem, SavedViewMenu, type SavedViewMenuProps, type SavedViewSection, ViewMenu, type ViewMenuColumn, type ViewMenuColumnLabels, type ViewMenuProps };