@pisell/private-materials 3.4.16 → 3.4.18

package/lib/plus/productSelect/components/TabsStructure/TabsStructure.less

@@ -0,0 +1,224 @@
+// ===== Mixins =====
+.pisell-tabstruct-focus-ring() {
+  outline: 2px solid var(--ps-color-primary, #7f56d9);
+  outline-offset: 2px;
+}
+
+.pisell-tabstruct-disabled() {
+  opacity: 0.6;
+  cursor: not-allowed;
+  pointer-events: none;
+}
+
+.pisell-tabstruct-smooth-scroll() {
+  scroll-behavior: smooth;
+  -webkit-overflow-scrolling: touch;
+}
+
+.pisell-tabstruct-hide-scrollbar() {
+  scrollbar-width: none;
+  /* Firefox */
+  -ms-overflow-style: none;
+  /* IE and Edge */
+
+  &::-webkit-scrollbar {
+    display: none;
+    /* Chrome, Safari, Opera */
+  }
+}
+
+// ===== Tab Wrapper =====
+.pisell-tabstruct-wrapper {
+  position: relative;
+  display: flex;
+  align-items: center;
+  inline-size: 100%;
+  box-sizing: border-box;
+}
+
+// ===== Tab List =====
+.pisell-tabstruct-list {
+  padding: 0;
+  margin: 0;
+  display: inline-flex;
+  align-items: center;
+  list-style: none;
+  gap: 8px;
+  border-radius: 20px;
+}
+
+// ===== Tab Item =====
+.pisell-tabstruct-item {
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0 16px;
+  height: 40px;
+  border: none;
+  background: var(--ps-tab-item-bg, #fff);
+  color: #1b1b1b;
+  font-size: 14px;
+  font-weight: 600;
+  line-height: 1.4;
+  text-decoration: none;
+  cursor: pointer;
+  transition: all 0.2s ease-in-out;
+  white-space: nowrap;
+  user-select: none;
+  // 基础样式采用原pill样式
+  border-radius: 20px;
+
+  // Focus state
+  &:focus-visible {
+    .pisell-tabstruct-focus-ring();
+  }
+
+  &--selected {
+    color: #ffffff;
+    border-radius: 20px;
+    background-color: var(--ps-color-primary, #7f56d9);;
+  }
+
+  &[aria-selected='true'] {
+    color: #ffffff;
+    border-radius: 20px;
+    background-color: var(--ps-color-primary, #7f56d9);;
+  }
+
+  // Disabled state
+  &--disabled {
+    .pisell-tabstruct-disabled();
+    color: #adb5bd;
+  }
+}
+
+// ===== Tab Rail =====
+.pisell-tabstruct-rail {
+  position: relative;
+  display: inline-flex;
+  inline-size: 100%;
+  overflow: auto;
+  scroll-snap-type: x mandatory;
+  .pisell-tabstruct-smooth-scroll();
+  .pisell-tabstruct-hide-scrollbar();
+}
+
+// ===== Selection Indicator =====
+.pisell-tabstruct-selection {
+  position: absolute;
+  z-index: 10;
+  transition: all 0.2s ease-in-out;
+  pointer-events: none;
+  z-index: 0;
+  block-size: 100%;
+  background-color: var(--ps-color-primary, #7f56d9);
+  border-radius: 20px;
+  box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
+
+  &--positioned {
+    inset-block-start: auto;
+    inset-block-end: 0;
+    inset-inline-start: 0;
+  }
+
+  &::before {
+    content: '';
+    position: absolute;
+    inset: 2px;
+    border-radius: calc(20px - 2px);
+  }
+
+  &::after {
+    content: '';
+    position: absolute;
+    inset-block-start: 1px;
+    inset-inline-start: 1px;
+    inset-inline-end: 1px;
+    block-size: 50%;
+    background-color: var(--ps-color-primary, #7f56d9);
+    border-radius: 20px 20px 0 0;
+  }
+
+  &--focused {
+    .pisell-tabstruct-focus-ring();
+  }
+}
+
+// ===== Scroll Shadow =====
+.pisell-tabstruct-shadow {
+  position: absolute;
+  z-index: 5;
+  pointer-events: none;
+  opacity: 0;
+  transition: opacity all 0.2s ease-in-out;
+
+  &--visible {
+    opacity: 1;
+  }
+
+  &--start {
+    inset-block-start: 0;
+    inset-block-end: 0;
+    inset-inline-start: 0;
+    inline-size: 20px;
+    background: linear-gradient(90deg, rgba(0, 0, 0, 0.1) 0%, transparent 100%);
+  }
+
+  &--end {
+    inset-block-start: 0;
+    inset-block-end: 0;
+    inset-inline-end: 0;
+    inline-size: 20px;
+    background: linear-gradient(
+      270deg,
+      rgba(0, 0, 0, 0.1) 0%,
+      transparent 100%
+    );
+  }
+}
+
+// ===== Chevron Controls =====
+.pisell-tabstruct-chevron-controls {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  z-index: 15;
+}
+
+.pisell-tabstruct-chevron-button {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 24px;
+  height: 24px;
+  padding: 0;
+  border: 1px solid transparent;
+  border-radius: 12px;
+  background-color: #f8f9fa;
+  color: #262626;
+  cursor: pointer;
+  transition: all 0.2s ease-in-out;
+  flex-shrink: 0;
+
+  &:hover:not(.pisell-tabstruct-chevron-button--disabled) {
+    background-color: #e9ecef;
+    color: #495057;
+  }
+
+  &:focus-visible {
+    .pisell-tabstruct-focus-ring();
+  }
+
+  &--disabled {
+    .pisell-tabstruct-disabled();
+    color: #adb5bd;
+    background-color: #f2f4f7;
+  }
+
+  svg {
+    font-size: 20px;
+    font-weight: bold;
+    flex-shrink: 0;
+  }
+}

package/lib/plus/productSelect/components/TabsStructure/hooks.d.ts

@@ -0,0 +1,22 @@
+/// <reference types="react" />
+interface UseSelectionIndicatorReturn {
+    selectionIndicatorProps: {
+        focusRingClasses: string;
+        isFocusVisible: boolean;
+        style: React.CSSProperties;
+    };
+    listContainerProps: {
+        onFocus: (event: React.FocusEvent) => void;
+        onBlur: () => void;
+        onMouseDown: () => void;
+    };
+}
+/**
+ * Hook for managing selection indicator position with enhanced features
+ * @param containerRef - Ref to the tab container
+ * @param selectedTabId - ID of the currently selected tab (optional)
+ * @param transition - Custom transition string (optional)
+ * @returns Selection indicator props and list container props
+ */
+export declare function useSelectionIndicator(containerRef: React.RefObject<HTMLElement>, selectedTabId?: string, transition?: string): UseSelectionIndicatorReturn;
+export {};

package/lib/plus/productSelect/components/TabsStructure/hooks.js

@@ -0,0 +1,209 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/plus/productSelect/components/TabsStructure/hooks.ts
+var hooks_exports = {};
+__export(hooks_exports, {
+  useSelectionIndicator: () => useSelectionIndicator
+});
+module.exports = __toCommonJS(hooks_exports);
+var import_react = require("react");
+var import_utils = require("./utils");
+function useSelectionIndicator(containerRef, selectedTabId, transition) {
+  const [indicatorStyle, setIndicatorStyle] = (0, import_react.useState)({
+    width: 0,
+    transform: "translateX(0)",
+    transition: "none"
+  });
+  const [selectedTabRef, setSelectedTabRef] = (0, import_react.useState)();
+  const [isFocusVisible, setIsFocusVisible] = (0, import_react.useState)(false);
+  const [focusRingClasses, setFocusRingClasses] = (0, import_react.useState)("");
+  const setSelectedTab = (0, import_react.useCallback)((element) => {
+    setSelectedTabRef(
+      (prevRef) => (prevRef == null ? void 0 : prevRef.current) === element ? prevRef : { current: element }
+    );
+  }, []);
+  const findSelectedTabByAttribute = (0, import_react.useCallback)(() => {
+    if (!containerRef.current) return null;
+    const selectedTab = containerRef.current.querySelector('[role="tab"][aria-selected="true"]');
+    if (selectedTab) {
+      setSelectedTab(selectedTab);
+    }
+    return selectedTab;
+  }, [containerRef, setSelectedTab]);
+  const findSelectedTabById = (0, import_react.useCallback)(() => {
+    if (!selectedTabId || !containerRef.current) return null;
+    const selectedTab = containerRef.current.querySelector(`[id="${selectedTabId}"]`);
+    return selectedTab;
+  }, [containerRef, selectedTabId]);
+  const getTransition = (0, import_react.useCallback)((customTransition) => {
+    return customTransition || "transform 300ms, width 100ms";
+  }, []);
+  const getDirection = (0, import_react.useCallback)(() => {
+    if (!containerRef.current) return "ltr";
+    return window.getComputedStyle(containerRef.current).direction || "ltr";
+  }, [containerRef]);
+  const updateIndicatorPosition = (0, import_react.useCallback)(() => {
+    try {
+      const selectedTab = findSelectedTabByAttribute() || findSelectedTabById();
+      if (!selectedTab || !containerRef.current) {
+        setIndicatorStyle((prev) => ({
+          ...prev,
+          width: 0,
+          transform: "translateX(0)"
+        }));
+        return;
+      }
+      const container = containerRef.current;
+      const offsetParent = selectedTab.offsetParent;
+      if (!offsetParent) {
+        setIndicatorStyle((prev) => ({
+          ...prev,
+          width: 0,
+          transform: "translateX(0)"
+        }));
+        return;
+      }
+      if (!selectedTab.isConnected) {
+        console.warn("useSelectionIndicator: Selected tab is no longer connected to DOM");
+        return;
+      }
+      const direction = getDirection();
+      const width = selectedTab.offsetWidth;
+      if (width <= 0) {
+        setIndicatorStyle((prev) => ({
+          ...prev,
+          width: 0,
+          transform: "translateX(0)"
+        }));
+        return;
+      }
+      let left;
+      if (direction === "rtl") {
+        left = -1 * (offsetParent.clientWidth - selectedTab.offsetLeft - selectedTab.offsetWidth);
+      } else {
+        left = selectedTab.offsetLeft;
+      }
+      const transitionValue = getTransition(transition);
+      setIndicatorStyle({
+        width: `${width}px`,
+        transform: `translateX(${left}px)`,
+        transition: transitionValue
+      });
+    } catch (error) {
+      console.warn("useSelectionIndicator: Error updating indicator position:", error);
+      setIndicatorStyle((prev) => ({
+        ...prev,
+        width: 0,
+        transform: "translateX(0)"
+      }));
+    }
+  }, [containerRef, selectedTabId, transition, findSelectedTabByAttribute, findSelectedTabById, getDirection, getTransition]);
+  const debouncedUpdate = (0, import_react.useMemo)(
+    () => (0, import_utils.debounce)(updateIndicatorPosition, 50),
+    [updateIndicatorPosition]
+  );
+  const handleFocusIn = (0, import_react.useCallback)((event) => {
+    setIsFocusVisible(event.target instanceof HTMLElement && event.target.matches(":focus-visible"));
+    setFocusRingClasses(event.target instanceof HTMLElement && event.target.matches(":focus-visible") ? "focus-visible" : "");
+  }, []);
+  const handleFocusOut = (0, import_react.useCallback)(() => {
+    setIsFocusVisible(false);
+    setFocusRingClasses("");
+  }, []);
+  const handleMouseDown = (0, import_react.useCallback)(() => {
+    setIsFocusVisible(false);
+    setFocusRingClasses("");
+  }, []);
+  (0, import_react.useEffect)(() => {
+    debouncedUpdate();
+  }, [debouncedUpdate, selectedTabId]);
+  (0, import_react.useEffect)(() => {
+    const container = containerRef.current;
+    if (!container) return;
+    let resizeObserver = null;
+    try {
+      resizeObserver = new ResizeObserver((entries) => {
+        try {
+          const validEntries = entries.filter(
+            (entry) => entry.target && entry.target.isConnected
+          );
+          if (validEntries.length > 0) {
+            debouncedUpdate();
+          }
+        } catch (error) {
+          console.warn("useSelectionIndicator: Error in ResizeObserver callback:", error);
+        }
+      });
+      resizeObserver.observe(container);
+      if (selectedTabRef == null ? void 0 : selectedTabRef.current) {
+        resizeObserver.observe(selectedTabRef.current);
+      }
+    } catch (error) {
+      console.warn("useSelectionIndicator: Failed to create ResizeObserver:", error);
+    }
+    return () => {
+      if (resizeObserver) {
+        try {
+          resizeObserver.disconnect();
+        } catch (error) {
+          console.warn("useSelectionIndicator: Error disconnecting ResizeObserver:", error);
+        }
+      }
+    };
+  }, [containerRef, selectedTabRef, debouncedUpdate]);
+  (0, import_react.useEffect)(() => {
+    const container = containerRef.current;
+    if (!container) return;
+    const nativeFocusIn = (event) => {
+      const syntheticEvent = {
+        ...event,
+        currentTarget: event.currentTarget,
+        target: event.target
+      };
+      handleFocusIn(syntheticEvent);
+    };
+    container.addEventListener("focusin", nativeFocusIn);
+    container.addEventListener("focusout", handleFocusOut);
+    container.addEventListener("mousedown", handleMouseDown);
+    return () => {
+      container.removeEventListener("focusin", nativeFocusIn);
+      container.removeEventListener("focusout", handleFocusOut);
+      container.removeEventListener("mousedown", handleMouseDown);
+    };
+  }, [containerRef, handleFocusIn, handleFocusOut, handleMouseDown]);
+  return {
+    selectionIndicatorProps: {
+      focusRingClasses,
+      isFocusVisible,
+      style: {
+        ...indicatorStyle,
+        transition: getTransition(transition)
+      }
+    },
+    listContainerProps: {
+      onFocus: handleFocusIn,
+      onBlur: handleFocusOut,
+      onMouseDown: handleMouseDown
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useSelectionIndicator
+});

package/lib/plus/productSelect/components/TabsStructure/index.d.ts

@@ -0,0 +1,5 @@
+export { default as TabsStructure, TabListContainer, TabItem, Rail, SelectionIndicator, ScrollShadow, ChevronControls, ChevronButton } from './TabsStructure';
+export type { TabsStructureProps, TabListContainerProps, TabItemProps, RailProps, SelectionIndicatorProps, ScrollShadowProps, ChevronControlsProps, ChevronButtonProps, TabContextValue, ScrollLocation, TabWrapperClasses, TabListClasses, TabItemClasses, RailClasses, SelectionClasses, ShadowClasses, ChevronClasses, } from './types';
+export { tabWrapperClasses, tabListClasses, tabItemClasses, railClasses, selectionClasses, shadowClasses, chevronClasses, chevronButtonClasses, tabWrapperClassNames, tabListClassNames, tabItemClassNames, railClassNames, selectionClassNames, shadowClassNames, chevronClassNames } from './styles';
+export { debounce, mergeRefs } from './utils';
+export { useSelectionIndicator, } from './hooks';

package/lib/plus/productSelect/components/TabsStructure/index.js

@@ -0,0 +1,92 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/plus/productSelect/components/TabsStructure/index.ts
+var TabsStructure_exports = {};
+__export(TabsStructure_exports, {
+  ChevronButton: () => import_TabsStructure.ChevronButton,
+  ChevronControls: () => import_TabsStructure.ChevronControls,
+  Rail: () => import_TabsStructure.Rail,
+  ScrollShadow: () => import_TabsStructure.ScrollShadow,
+  SelectionIndicator: () => import_TabsStructure.SelectionIndicator,
+  TabItem: () => import_TabsStructure.TabItem,
+  TabListContainer: () => import_TabsStructure.TabListContainer,
+  TabsStructure: () => import_TabsStructure.default,
+  chevronButtonClasses: () => import_styles.chevronButtonClasses,
+  chevronClassNames: () => import_styles.chevronClassNames,
+  chevronClasses: () => import_styles.chevronClasses,
+  debounce: () => import_utils.debounce,
+  mergeRefs: () => import_utils.mergeRefs,
+  railClassNames: () => import_styles.railClassNames,
+  railClasses: () => import_styles.railClasses,
+  selectionClassNames: () => import_styles.selectionClassNames,
+  selectionClasses: () => import_styles.selectionClasses,
+  shadowClassNames: () => import_styles.shadowClassNames,
+  shadowClasses: () => import_styles.shadowClasses,
+  tabItemClassNames: () => import_styles.tabItemClassNames,
+  tabItemClasses: () => import_styles.tabItemClasses,
+  tabListClassNames: () => import_styles.tabListClassNames,
+  tabListClasses: () => import_styles.tabListClasses,
+  tabWrapperClassNames: () => import_styles.tabWrapperClassNames,
+  tabWrapperClasses: () => import_styles.tabWrapperClasses,
+  useSelectionIndicator: () => import_hooks.useSelectionIndicator
+});
+module.exports = __toCommonJS(TabsStructure_exports);
+var import_TabsStructure = __toESM(require("./TabsStructure"));
+var import_styles = require("./styles");
+var import_utils = require("./utils");
+var import_hooks = require("./hooks");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ChevronButton,
+  ChevronControls,
+  Rail,
+  ScrollShadow,
+  SelectionIndicator,
+  TabItem,
+  TabListContainer,
+  TabsStructure,
+  chevronButtonClasses,
+  chevronClassNames,
+  chevronClasses,
+  debounce,
+  mergeRefs,
+  railClassNames,
+  railClasses,
+  selectionClassNames,
+  selectionClasses,
+  shadowClassNames,
+  shadowClasses,
+  tabItemClassNames,
+  tabItemClasses,
+  tabListClassNames,
+  tabListClasses,
+  tabWrapperClassNames,
+  tabWrapperClasses,
+  useSelectionIndicator
+});

package/lib/plus/productSelect/components/TabsStructure/styles.d.ts

@@ -0,0 +1,47 @@
+/**
+ * CSS Classes mapping for TabComponent
+ */
+import { TabWrapperClasses, TabListClasses, TabItemClasses, RailClasses, SelectionClasses, ShadowClasses, ChevronClasses } from './types';
+export declare const tabWrapperClasses: TabWrapperClasses;
+export declare const tabListClasses: TabListClasses;
+export declare const tabItemClasses: TabItemClasses;
+export declare const railClasses: RailClasses;
+export declare const selectionClasses: SelectionClasses;
+export declare const shadowClasses: ShadowClasses;
+export declare const chevronClasses: ChevronClasses;
+export declare const chevronButtonClasses: {
+    button: string;
+    disabled: string;
+    prev: string;
+    next: string;
+};
+export declare const tabWrapperClassNames: {
+    wrapper: string;
+};
+export declare const tabListClassNames: {
+    list: string;
+};
+export declare const tabItemClassNames: {
+    item: string;
+    selected: string;
+    disabled: string;
+};
+export declare const railClassNames: {
+    rail: string;
+};
+export declare const selectionClassNames: {
+    selection: string;
+    position: string;
+    focused: string;
+};
+export declare const shadowClassNames: {
+    shadow: string;
+    isVisible: string;
+    locationStart: string;
+    locationEnd: string;
+};
+export declare const chevronClassNames: {
+    controls: string;
+    button: string;
+    disabled: string;
+};