@pisell/private-materials 6.3.58 → 6.3.59

package/es/pro/Selector/components/Card/index.js

@@ -0,0 +1,113 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import React, { useMemo } from 'react';
+import classNames from 'classnames';
+import "./index.less";
+var stopPropagation = function stopPropagation(e) {
+  e.stopPropagation();
+};
+var Card = function Card(_ref) {
+  var _ref$variant = _ref.variant,
+    variant = _ref$variant === void 0 ? 'outlined' : _ref$variant,
+    _ref$layout = _ref.layout,
+    layout = _ref$layout === void 0 ? 'horizontal' : _ref$layout,
+    actions = _ref.actions,
+    _ref$actionsPosition = _ref.actionsPosition,
+    actionsPosition = _ref$actionsPosition === void 0 ? 'right' : _ref$actionsPosition,
+    corner = _ref.corner,
+    children = _ref.children,
+    _ref$selected = _ref.selected,
+    selected = _ref$selected === void 0 ? false : _ref$selected,
+    _ref$disabled = _ref.disabled,
+    disabled = _ref$disabled === void 0 ? false : _ref$disabled,
+    _ref$hoverable = _ref.hoverable,
+    hoverable = _ref$hoverable === void 0 ? false : _ref$hoverable,
+    onClick = _ref.onClick,
+    styles = _ref.styles,
+    _ref$selectedType = _ref.selectedType,
+    selectedType = _ref$selectedType === void 0 ? 'outlined' : _ref$selectedType,
+    className = _ref.className,
+    style = _ref.style;
+  // 样式属性对象，用于传递给样式函数
+  var styleProps = {
+    selected: selected,
+    disabled: disabled,
+    hoverable: hoverable,
+    variant: variant,
+    layout: layout
+  };
+
+  // 计算容器样式
+  var containerStyle = useMemo(function () {
+    if (!(styles !== null && styles !== void 0 && styles.container)) return style;
+    var customStyle = typeof styles.container === 'function' ? styles.container(styleProps) : styles.container;
+    return _objectSpread(_objectSpread({}, customStyle), style);
+  }, [styles === null || styles === void 0 ? void 0 : styles.container, style, styleProps]);
+
+  // 计算内容样式
+  var contentStyle = useMemo(function () {
+    if (!(styles !== null && styles !== void 0 && styles.content)) return undefined;
+    return typeof styles.content === 'function' ? styles.content(styleProps) : styles.content;
+  }, [styles === null || styles === void 0 ? void 0 : styles.content, styleProps]);
+
+  // 计算操作区样式
+  var actionsStyle = useMemo(function () {
+    if (!(styles !== null && styles !== void 0 && styles.actions)) return undefined;
+    return typeof styles.actions === 'function' ? styles.actions(styleProps) : styles.actions;
+  }, [styles === null || styles === void 0 ? void 0 : styles.actions, styleProps]);
+
+  // 计算角标样式
+  var cornerStyle = useMemo(function () {
+    if (!(styles !== null && styles !== void 0 && styles.corner)) return undefined;
+    return typeof styles.corner === 'function' ? styles.corner(styleProps) : styles.corner;
+  }, [styles === null || styles === void 0 ? void 0 : styles.corner, styleProps]);
+
+  // 渲染操作区域
+  var renderActions = function renderActions() {
+    if (!actions) return null;
+    var _actions = Array.isArray(actions) ? actions.filter(Boolean) : [actions];
+    if (_actions.length === 0) return null;
+    return /*#__PURE__*/React.createElement("ul", {
+      className: "pisell-pro-card_actions",
+      style: actionsStyle
+    }, actions.map(function (action, index) {
+      return /*#__PURE__*/React.createElement("li", {
+        key: index,
+        className: "pisell-pro-card_actions-item"
+      }, /*#__PURE__*/React.createElement("span", {
+        onClick: stopPropagation
+      }, action));
+    }));
+  };
+
+  // 渲染右上角组件
+  var renderCorner = function renderCorner() {
+    if (!corner || layout !== 'vertical') return null;
+    return /*#__PURE__*/React.createElement("div", {
+      className: "pisell-pro-card_corner",
+      style: cornerStyle,
+      onClick: stopPropagation
+    }, corner);
+  };
+
+  // 处理卡片点击
+  var handleClick = function handleClick(e) {
+    if (disabled) return;
+    onClick === null || onClick === void 0 || onClick(e);
+  };
+  return /*#__PURE__*/React.createElement("div", {
+    className: classNames('pisell-pro-card', "pisell-pro-card-".concat(variant), "pisell-pro-card-".concat(layout), _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({
+      'pisell-pro-card-selected': selected
+    }, "pisell-pro-card-selected-".concat(selectedType), selected && selectedType !== 'none'), 'pisell-pro-card-disabled', disabled), 'pisell-pro-card-hoverable', hoverable && !disabled), 'pisell-pro-card-clickable', onClick && !disabled), "pisell-pro-card-actions-".concat(actionsPosition), layout === 'horizontal' && actions), className),
+    style: containerStyle,
+    onClick: handleClick
+  }, layout === 'horizontal' && actionsPosition === 'left' && renderActions(), /*#__PURE__*/React.createElement("div", {
+    className: "pisell-pro-card_content",
+    style: contentStyle
+  }, children), (layout === 'vertical' || actionsPosition === 'right') && renderActions(), renderCorner());
+};
+export default Card;

package/es/pro/Selector/components/Card/index.less

@@ -0,0 +1,162 @@
+/* Card组件样式 */
+.pisell-pro-card {
+  position: relative;
+  display: flex;
+  border-radius: 8px;
+  transition: all 0.2s;
+  box-sizing: border-box;
+  overflow: hidden;
+  box-shadow: 0px 1px 2px rgba(16, 24, 40, 0.05);
+
+  /* 变体样式 */
+  &-outlined {
+    border: 1px solid #d0d5dd;
+  }
+
+  &-borderless {
+    border: 1px solid transparent;
+    box-shadow: none;
+    outline: none;
+  }
+
+  /* 布局样式 */
+  &-vertical {
+    flex-direction: column;
+    border-radius: 12px;
+
+    .pisell-pro-card_content {
+      flex: 1;
+    }
+
+    .pisell-pro-card_actions {
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      margin: 0;
+    }
+
+    .pisell-pro-card_actions-item {
+      margin: 20px 0;
+    }
+  }
+
+  &-horizontal {
+    flex-direction: row;
+    align-items: center;
+    gap: 10px;
+
+    .pisell-pro-card_content {
+      flex: 1;
+      font-size: 16px;
+    }
+
+    .pisell-pro-card_actions {
+      display: flex;
+      align-items: center;
+      margin: 0;
+      padding: 0;
+    }
+
+    .pisell-pro-card_actions-item {
+      margin: 0;
+    }
+  }
+
+  /* 可悬停效果 */
+  &-hoverable:not(&-disabled):hover {
+    box-shadow: 0 2px 4px rgba(0, 0, 0, 0.08);
+  }
+
+  /* 可点击样式 */
+  &-clickable:not(&-disabled) {
+    cursor: pointer;
+  }
+
+  /* 禁用状态 */
+  &-disabled {
+    cursor: not-allowed;
+    color: #98a2b3;
+    background-color: #f9fafb;
+
+    &:hover {
+      box-shadow: none;
+      transform: none;
+    }
+  }
+
+  /* 选中状态 - outlined类型 */
+  &-selected&-selected-outlined {
+    &.pisell-pro-card-outlined {
+      border-color: #7f56d9;
+      background-color: #f9f5ff;
+    }
+
+    &.pisell-pro-card-borderless {
+      border-color: #7f56d9;
+    }
+    .pisell-pro-card_content {
+      color: #7f56d9;
+    }
+  }
+
+  /* 选中状态 - outlined-bold类型（加粗边框，使用 outline 实现不影响布局） */
+  &-selected&-selected-outlined-bold {
+    &.pisell-pro-card-outlined {
+      border-color: #7f56d9;
+      background-color: #f9f5ff;
+      outline: 2px solid #7f56d9;
+      outline-offset: -2px;
+    }
+
+    &.pisell-pro-card-borderless {
+      border-color: #7f56d9;
+      outline: 2px solid #7f56d9;
+      outline-offset: -2px;
+    }
+    .pisell-pro-card_content {
+      color: #7f56d9;
+    }
+  }
+
+  /* 选中状态 - filled类型 */
+  &-selected&-selected-filled {
+    &.pisell-pro-card-outlined,
+    &.pisell-pro-card-borderless {
+      background-color: #7f56d9;
+      color: #ffffff;
+      border-color: #7f56d9;
+
+      .pisell-pro-card_content {
+        color: #ffffff;
+      }
+    }
+  }
+}
+
+/* 操作区域 */
+.pisell-pro-card_actions {
+  flex-shrink: 0;
+
+  &-item {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    flex: 1;
+  }
+}
+
+/* 角标区域 */
+.pisell-pro-card_corner {
+  position: absolute;
+  top: 12px;
+  right: 12px;
+  z-index: 1;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+/* 禁用状态下的角标 */
+.pisell-pro-card-disabled .pisell-pro-card_corner {
+  opacity: 0.5;
+}

package/es/pro/Selector/components/Card/types.d.ts

@@ -0,0 +1 @@
+export type { CardVariant, CardLayout, SelectedType, ActionsPosition, CardStyles, CardStyleProps, CardProps, } from './index';

package/es/pro/Selector/components/Card/types.js

@@ -0,0 +1 @@
+export {};

package/es/pro/Selector/components/Indicator/index.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import './index.less';
+export interface IndicatorProps {
+    mode?: 'single' | 'multiple';
+    variant?: 'outlined' | 'filled';
+    defaultChecked?: boolean;
+    checked?: boolean;
+    disabled?: boolean;
+    onChange?: (e: React.ChangeEvent<HTMLInputElement>) => void;
+    className?: string;
+    styles?: {
+        container?: React.CSSProperties;
+        indicator?: React.CSSProperties;
+    };
+    children?: React.ReactNode;
+    size?: 'small' | 'middle' | 'large' | number;
+}
+declare const Indicator: React.FC<IndicatorProps>;
+export default Indicator;

package/es/pro/Selector/components/Indicator/index.js

@@ -0,0 +1,101 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import React, { useMemo, useState, useEffect } from 'react';
+import classNames from 'classnames';
+import "./index.less";
+var sizeMap = {
+  small: 20,
+  middle: 24,
+  large: 28
+};
+var Indicator = function Indicator(props) {
+  var _props$mode = props.mode,
+    mode = _props$mode === void 0 ? 'single' : _props$mode,
+    _props$variant = props.variant,
+    variant = _props$variant === void 0 ? 'outlined' : _props$variant,
+    _props$disabled = props.disabled,
+    disabled = _props$disabled === void 0 ? false : _props$disabled,
+    className = props.className,
+    _props$styles = props.styles,
+    styles = _props$styles === void 0 ? {} : _props$styles,
+    children = props.children,
+    _props$size = props.size,
+    size = _props$size === void 0 ? 'middle' : _props$size,
+    onChange = props.onChange,
+    defaultChecked = props.defaultChecked,
+    checkedProp = props.checked;
+  var _useState = useState(defaultChecked || false),
+    _useState2 = _slicedToArray(_useState, 2),
+    internalChecked = _useState2[0],
+    setInternalChecked = _useState2[1];
+  useEffect(function () {
+    if (checkedProp !== undefined) {
+      setInternalChecked(checkedProp);
+    }
+  }, [checkedProp]);
+  var isControlled = checkedProp !== undefined;
+  var checked = isControlled ? checkedProp : internalChecked;
+  var prefixCls = 'pisell-pro-indicator';
+  var classes = classNames(prefixCls, "".concat(prefixCls, "-").concat(mode), "".concat(prefixCls, "-").concat(variant), _defineProperty(_defineProperty({}, "".concat(prefixCls, "-checked"), checked), "".concat(prefixCls, "-disabled"), disabled), className);
+  var indicatorStyle = useMemo(function () {
+    var sizeValue = sizeMap[size] || Number(size);
+    return _objectSpread({
+      width: sizeValue,
+      height: sizeValue
+    }, styles.indicator);
+  }, [size, styles.indicator]);
+  var handleInputChange = function handleInputChange(e) {
+    if (disabled) return;
+    if (!isControlled) {
+      setInternalChecked(e.target.checked);
+    }
+    onChange === null || onChange === void 0 || onChange(e);
+  };
+  var renderCheckIcon = function renderCheckIcon() {
+    var sizeValue = sizeMap[size] || Number(size);
+    var iconSize = sizeValue * 0.6;
+    var strokeWidth = iconSize * 0.15;
+    return /*#__PURE__*/React.createElement("svg", {
+      className: "".concat(prefixCls, "-check-icon"),
+      width: iconSize,
+      height: iconSize * 0.76,
+      viewBox: "0 0 17 13",
+      fill: "none",
+      xmlns: "http://www.w3.org/2000/svg"
+    }, /*#__PURE__*/React.createElement("path", {
+      d: "M14.8814 1.44043L5.64141 10.6804L1.44141 6.48043",
+      stroke: "currentColor",
+      strokeWidth: strokeWidth,
+      strokeLinecap: "round",
+      strokeLinejoin: "round"
+    }));
+  };
+  return /*#__PURE__*/React.createElement("label", {
+    className: classes,
+    style: styles.container
+  }, /*#__PURE__*/React.createElement("input", {
+    type: mode === 'single' ? 'radio' : 'checkbox',
+    className: "".concat(prefixCls, "-input"),
+    checked: !!checked,
+    disabled: disabled,
+    onChange: handleInputChange
+  }), /*#__PURE__*/React.createElement("div", {
+    className: "".concat(prefixCls, "-inner"),
+    style: indicatorStyle
+  }, checked && /*#__PURE__*/React.createElement(React.Fragment, null, mode === 'single' && variant === 'outlined' ? /*#__PURE__*/React.createElement("div", {
+    className: "".concat(prefixCls, "-dot")
+  }) : renderCheckIcon())), children && /*#__PURE__*/React.createElement("span", {
+    className: "".concat(prefixCls, "-content")
+  }, children));
+};
+export default Indicator;

package/es/pro/Selector/components/Indicator/index.less

@@ -0,0 +1,114 @@
+.pisell-pro-indicator {
+  display: inline-flex;
+  align-items: center;
+  vertical-align: middle;
+  cursor: pointer;
+  user-select: none;
+  font-size: 14px;
+  line-height: 1.5;
+  position: relative;
+
+  &-input {
+    position: absolute;
+    opacity: 0;
+    width: 0;
+    height: 0;
+    margin: 0;
+    padding: 0;
+    z-index: -1;
+    pointer-events: none;
+  }
+
+  &-inner {
+    position: relative;
+    box-sizing: border-box;
+    border: 1px solid #d0d5dd;
+    background-color: #ffffff;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    flex-shrink: 0;
+    width: 24px;
+    height: 24px;
+
+    svg {
+      color: inherit;
+    }
+  }
+
+  &-content {
+    margin-left: 10px;
+    word-break: break-word;
+  }
+
+  &-single &-inner {
+    border-radius: 50%;
+    border-width: 1.2px;
+  }
+
+  &-multiple &-inner {
+    border-radius: 6px;
+    border-width: 1.4px;
+  }
+
+  &-single.pisell-pro-indicator-outlined.pisell-pro-indicator-checked &-inner {
+    border-color: #7f56d9;
+    background-color: #ffffff;
+  }
+
+  &-single.pisell-pro-indicator-outlined &-dot {
+    width: 45%;
+    height: 45%;
+    background-color: #7f56d9;
+    border-radius: 50%;
+  }
+
+  &-single.pisell-pro-indicator-filled.pisell-pro-indicator-checked &-inner {
+    border-color: #7f56d9;
+    background-color: #7f56d9;
+  }
+
+  &-single.pisell-pro-indicator-filled &-check-icon {
+    color: #ffffff;
+  }
+
+  &-multiple.pisell-pro-indicator-outlined.pisell-pro-indicator-checked &-inner {
+    border-color: #7f56d9;
+    background-color: #ffffff;
+  }
+
+  &-multiple.pisell-pro-indicator-outlined &-check-icon {
+    color: #7f56d9;
+  }
+
+  &-multiple.pisell-pro-indicator-filled.pisell-pro-indicator-checked &-inner {
+    border-color: #7f56d9;
+    background-color: #7f56d9;
+  }
+
+  &-multiple.pisell-pro-indicator-filled &-check-icon {
+    color: #ffffff;
+  }
+
+  &-check-icon {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+  }
+
+  &-disabled {
+    cursor: not-allowed;
+    color: #98a2b3;
+  }
+
+  &-disabled.pisell-pro-indicator-outlined &-inner {
+    border-color: #eaecf0 !important;
+    background-color: #f9fafb !important;
+    color: #98a2b3 !important;
+  }
+
+  &-disabled.pisell-pro-indicator-filled &-inner {
+    border-color: #eaecf0 !important;
+    background-color: #eaecf0 !important;
+  }
+}

package/es/pro/Selector/components/IntersectionObserver.d.ts

@@ -0,0 +1,105 @@
+/**
+ * IntersectionObserver 组件
+ * 用于监听一组 DOM 元素的可见性状态，并获取第一个可见元素的索引。
+ * @example
+ * function App() {
+ *   return (
+ *     <IntersectionObserverProvider
+ *       onFirstVisibleIndexChange={(index) => {
+ *         console.log('第一个可见元素的索引:', index);
+ *       }}
+ *       rootMargin="0px 0px -10% 0px" // 自定义根边距
+ *     >
+ *       <ScrollContainer>
+ *         {items.map((item, index) => (
+ *           <IntersectionItem key={item.id} index={index}>
+ *             <ItemComponent data={item} />
+ *           </IntersectionItem>
+ *         ))}
+ *       </ScrollContainer>
+ *     </IntersectionObserverProvider>
+ *   );
+ * }
+ */
+import React from 'react';
+import type { ReactNode, CSSProperties } from 'react';
+declare global {
+    interface Window {
+        IntersectionObserver: typeof IntersectionObserver;
+    }
+}
+/**
+ * 元素信息接口
+ */
+interface ElementInfo {
+    element: HTMLElement;
+    index: number;
+    isVisible: boolean;
+}
+/**
+ * IntersectionObserver 上下文值接口
+ */
+interface IntersectionObserverContextValue {
+    /** 是否已初始化 */
+    initialized: boolean;
+    /** 注册元素 */
+    registerElement: (element: HTMLElement, index: number) => void;
+    /** 注销元素 */
+    unregisterElement: (element: HTMLElement) => void;
+    /** 批量注册元素 */
+    registerElements: (elements: Array<{
+        element: HTMLElement;
+        index: number;
+    }>) => void;
+    /** 清除所有注册的元素 */
+    clearAll: () => void;
+    /** 第一个可见元素的索引，-1 表示没有可见元素 */
+    firstVisibleIndex: number;
+}
+/**
+ * IntersectionObserver Provider 属性接口
+ */
+interface IntersectionObserverProps {
+    children: ReactNode;
+    /** 根容器，默认为视口 */
+    root?: Element | null;
+    /** 根边距 */
+    rootMargin?: string;
+    /** 阈值 */
+    threshold?: number | number[];
+    /** 第一个可见元素索引变化时的回调 */
+    onFirstVisibleIndexChange?: (index: number) => void;
+    /** 是否禁用组件，禁用后不会创建 IntersectionObserver */
+    disabled?: boolean;
+}
+/**
+ * IntersectionItem 组件属性接口
+ */
+interface IntersectionItemProps {
+    /** 元素索引 */
+    index: number;
+    /** 子元素 */
+    children?: ReactNode;
+    /** 类名 */
+    className?: string;
+    /** 样式 */
+    style?: CSSProperties;
+}
+/**
+ * IntersectionObserver 上下文
+ */
+declare const IntersectionObserverContext: React.Context<IntersectionObserverContextValue>;
+export declare const IntersectionObserverProvider: React.FC<IntersectionObserverProps>;
+/**
+ * 使用 IntersectionObserver 的 Hook
+ * @returns {Object} 包含注册元素函数和第一个可见元素索引的对象
+ */
+export declare const useIntersectionObserver: () => IntersectionObserverContextValue;
+/**
+ * IntersectionItem 组件
+ * 自动注册元素到 IntersectionObserver 中
+ */
+export declare const IntersectionItem: React.FC<IntersectionItemProps>;
+export type { IntersectionObserverProps, IntersectionItemProps, IntersectionObserverContextValue, ElementInfo, };
+export { IntersectionObserverContext, };
+export default IntersectionObserverProvider;