wssf-kage-ui 0.1.1 → 0.1.3

package/dist/esm/Mentions/index.d.ts

@@ -0,0 +1,57 @@
+import React from 'react';
+import './style.less';
+export interface MentionOption {
+    /** 选项值 */
+    value: string;
+    /** 显示文本 */
+    label?: React.ReactNode;
+    /** 是否禁用 */
+    disabled?: boolean;
+}
+export interface MentionsProps extends Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, 'value' | 'defaultValue' | 'onChange' | 'prefix' | 'onSelect'> {
+    /** 当前值 */
+    value?: string;
+    /** 默认值 */
+    defaultValue?: string;
+    /** 提及选项 */
+    options?: MentionOption[] | string[];
+    /** 触发字符 */
+    prefix?: string | string[];
+    /** 分隔符 */
+    split?: string;
+    /** 占位符 */
+    placeholder?: string;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 尺寸 */
+    size?: 'large' | 'middle' | 'small';
+    /** 状态 */
+    status?: 'error' | 'warning';
+    /** 自动调整高度 */
+    autoSize?: boolean | {
+        minRows?: number;
+        maxRows?: number;
+    };
+    /** 过滤选项 */
+    filterOption?: boolean | ((input: string, option: MentionOption) => boolean);
+    /** 无匹配时的内容 */
+    notFoundContent?: React.ReactNode;
+    /** 获取选项时的加载状态 */
+    loading?: boolean;
+    /** 值变化回调 */
+    onChange?: (value: string) => void;
+    /** 选中回调 */
+    onSelect?: (option: MentionOption, prefix: string) => void;
+    /** 搜索回调 */
+    onSearch?: (text: string, prefix: string) => void;
+    /** 失焦回调 */
+    onBlur?: (e: React.FocusEvent<HTMLTextAreaElement>) => void;
+    /** 聚焦回调 */
+    onFocus?: (e: React.FocusEvent<HTMLTextAreaElement>) => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+}
+export declare const Mentions: React.ForwardRefExoticComponent<MentionsProps & React.RefAttributes<HTMLTextAreaElement>>;
+export default Mentions;

package/dist/esm/Mentions/index.js

@@ -0,0 +1,374 @@
+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); }
+var _excluded = ["value", "defaultValue", "options", "prefix", "split", "placeholder", "disabled", "size", "status", "autoSize", "filterOption", "notFoundContent", "loading", "onChange", "onSelect", "onSearch", "onFocus", "onBlur", "className", "style", "rows"];
+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; }
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+import React, { forwardRef, useCallback, useRef, useState, useEffect } from 'react';
+import "./style.less";
+
+// ============ Option Type ============
+
+// ============ Mentions Props ============
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+// ============ Mentions Component ============
+export var Mentions = /*#__PURE__*/forwardRef(function (props, ref) {
+  var controlledValue = props.value,
+    _props$defaultValue = props.defaultValue,
+    defaultValue = _props$defaultValue === void 0 ? '' : _props$defaultValue,
+    _props$options = props.options,
+    options = _props$options === void 0 ? [] : _props$options,
+    _props$prefix = props.prefix,
+    prefixConfig = _props$prefix === void 0 ? '@' : _props$prefix,
+    _props$split = props.split,
+    split = _props$split === void 0 ? ' ' : _props$split,
+    placeholder = props.placeholder,
+    _props$disabled = props.disabled,
+    disabled = _props$disabled === void 0 ? false : _props$disabled,
+    _props$size = props.size,
+    size = _props$size === void 0 ? 'middle' : _props$size,
+    status = props.status,
+    _props$autoSize = props.autoSize,
+    autoSize = _props$autoSize === void 0 ? false : _props$autoSize,
+    _props$filterOption = props.filterOption,
+    filterOption = _props$filterOption === void 0 ? true : _props$filterOption,
+    _props$notFoundConten = props.notFoundContent,
+    notFoundContent = _props$notFoundConten === void 0 ? '无匹配结果' : _props$notFoundConten,
+    _props$loading = props.loading,
+    loading = _props$loading === void 0 ? false : _props$loading,
+    onChange = props.onChange,
+    onSelect = props.onSelect,
+    onSearch = props.onSearch,
+    onFocus = props.onFocus,
+    onBlur = props.onBlur,
+    _props$className = props.className,
+    className = _props$className === void 0 ? '' : _props$className,
+    style = props.style,
+    _props$rows = props.rows,
+    rows = _props$rows === void 0 ? 3 : _props$rows,
+    rest = _objectWithoutProperties(props, _excluded);
+  var _useState = useState(defaultValue),
+    _useState2 = _slicedToArray(_useState, 2),
+    internalValue = _useState2[0],
+    setInternalValue = _useState2[1];
+  var _useState3 = useState(false),
+    _useState4 = _slicedToArray(_useState3, 2),
+    isOpen = _useState4[0],
+    setIsOpen = _useState4[1];
+  var _useState5 = useState(-1),
+    _useState6 = _slicedToArray(_useState5, 2),
+    activeIndex = _useState6[0],
+    setActiveIndex = _useState6[1];
+  var _useState7 = useState(''),
+    _useState8 = _slicedToArray(_useState7, 2),
+    searchText = _useState8[0],
+    setSearchText = _useState8[1];
+  var _useState9 = useState(''),
+    _useState10 = _slicedToArray(_useState9, 2),
+    currentPrefix = _useState10[0],
+    setCurrentPrefix = _useState10[1];
+  var _useState11 = useState({
+      start: 0,
+      end: 0
+    }),
+    _useState12 = _slicedToArray(_useState11, 2),
+    mentionPosition = _useState12[0],
+    setMentionPosition = _useState12[1];
+  var _useState13 = useState({
+      top: 0,
+      left: 0
+    }),
+    _useState14 = _slicedToArray(_useState13, 2),
+    dropdownPosition = _useState14[0],
+    setDropdownPosition = _useState14[1];
+  var containerRef = useRef(null);
+  var textareaRef = useRef(null);
+  var dropdownRef = useRef(null);
+  var measureRef = useRef(null);
+  var value = controlledValue !== undefined ? controlledValue : internalValue;
+
+  // 标准化前缀配置
+  var prefixes = Array.isArray(prefixConfig) ? prefixConfig : [prefixConfig];
+
+  // 标准化选项
+  var normalizedOptions = options.map(function (opt) {
+    return typeof opt === 'string' ? {
+      value: opt,
+      label: opt
+    } : opt;
+  });
+
+  // 过滤选项
+  var filteredOptions = normalizedOptions.filter(function (option) {
+    if (!filterOption) return true;
+    if (typeof filterOption === 'function') {
+      return filterOption(searchText, option);
+    }
+    // 默认过滤：值包含搜索内容（不区分大小写）
+    return option.value.toLowerCase().includes(searchText.toLowerCase());
+  });
+
+  // 设置 ref
+  var setTextareaRef = useCallback(function (node) {
+    textareaRef.current = node;
+    if (typeof ref === 'function') {
+      ref(node);
+    } else if (ref && 'current' in ref) {
+      ref.current = node;
+    }
+  }, [ref]);
+
+  // 计算光标位置对应的坐标
+  var getCursorCoordinates = useCallback(function (textarea, position) {
+    if (!measureRef.current) return {
+      top: 0,
+      left: 0
+    };
+    var div = measureRef.current;
+    var textBeforeCursor = textarea.value.substring(0, position);
+
+    // 复制 textarea 的样式到测量元素
+    var computedStyle = window.getComputedStyle(textarea);
+    div.style.font = computedStyle.font;
+    div.style.padding = computedStyle.padding;
+    div.style.border = computedStyle.border;
+    div.style.width = "".concat(textarea.clientWidth, "px");
+    div.textContent = textBeforeCursor;
+
+    // 添加一个光标标记
+    var cursor = document.createElement('span');
+    cursor.textContent = '|';
+    div.appendChild(cursor);
+    var rect = textarea.getBoundingClientRect();
+    var cursorRect = cursor.getBoundingClientRect();
+    return {
+      top: cursorRect.top - rect.top + textarea.scrollTop + 20,
+      left: cursorRect.left - rect.left
+    };
+  }, []);
+
+  // 检测提及触发
+  var detectMention = useCallback(function (text, cursorPos) {
+    // 从光标位置向前查找最近的前缀
+    var mentionStart = -1;
+    var detectedPrefix = '';
+    for (var i = cursorPos - 1; i >= 0; i--) {
+      var char = text[i];
+
+      // 遇到空格或换行，停止查找
+      if (char === ' ' || char === '\n') {
+        break;
+      }
+
+      // 检查是否是前缀字符
+      if (prefixes.includes(char)) {
+        mentionStart = i;
+        detectedPrefix = char;
+        break;
+      }
+    }
+    if (mentionStart >= 0) {
+      var mentionEnd = cursorPos;
+      var search = text.substring(mentionStart + 1, mentionEnd);
+      return {
+        active: true,
+        prefix: detectedPrefix,
+        start: mentionStart,
+        end: mentionEnd,
+        search: search
+      };
+    }
+    return {
+      active: false,
+      prefix: '',
+      start: 0,
+      end: 0,
+      search: ''
+    };
+  }, [prefixes]);
+
+  // 输入变化
+  var handleChange = useCallback(function (e) {
+    var newValue = e.target.value;
+    var cursorPos = e.target.selectionStart || 0;
+    if (controlledValue === undefined) {
+      setInternalValue(newValue);
+    }
+    onChange === null || onChange === void 0 || onChange(newValue);
+
+    // 检测提及
+    var mention = detectMention(newValue, cursorPos);
+    if (mention.active) {
+      setSearchText(mention.search);
+      setCurrentPrefix(mention.prefix);
+      setMentionPosition({
+        start: mention.start,
+        end: mention.end
+      });
+      setIsOpen(true);
+      setActiveIndex(-1);
+      onSearch === null || onSearch === void 0 || onSearch(mention.search, mention.prefix);
+
+      // 计算下拉框位置
+      if (textareaRef.current) {
+        var coords = getCursorCoordinates(textareaRef.current, mention.start);
+        setDropdownPosition(coords);
+      }
+    } else {
+      setIsOpen(false);
+      setSearchText('');
+      setCurrentPrefix('');
+    }
+  }, [controlledValue, onChange, detectMention, onSearch, getCursorCoordinates]);
+
+  // 选择选项
+  var handleSelect = useCallback(function (option) {
+    if (option.disabled || !textareaRef.current) return;
+    var textarea = textareaRef.current;
+    var before = value.substring(0, mentionPosition.start);
+    var after = value.substring(mentionPosition.end);
+    var newValue = "".concat(before).concat(currentPrefix).concat(option.value).concat(split).concat(after);
+    var newCursorPos = before.length + currentPrefix.length + option.value.length + split.length;
+    if (controlledValue === undefined) {
+      setInternalValue(newValue);
+    }
+    onChange === null || onChange === void 0 || onChange(newValue);
+    onSelect === null || onSelect === void 0 || onSelect(option, currentPrefix);
+    setIsOpen(false);
+    setSearchText('');
+    setCurrentPrefix('');
+
+    // 恢复焦点并设置光标位置
+    setTimeout(function () {
+      textarea.focus();
+      textarea.setSelectionRange(newCursorPos, newCursorPos);
+    }, 0);
+  }, [value, mentionPosition, currentPrefix, split, controlledValue, onChange, onSelect]);
+
+  // 键盘导航
+  var handleKeyDown = useCallback(function (e) {
+    if (!isOpen || filteredOptions.length === 0) return;
+    switch (e.key) {
+      case 'ArrowDown':
+        e.preventDefault();
+        setActiveIndex(function (prev) {
+          var next = prev + 1;
+          return next >= filteredOptions.length ? 0 : next;
+        });
+        break;
+      case 'ArrowUp':
+        e.preventDefault();
+        setActiveIndex(function (prev) {
+          var next = prev - 1;
+          return next < 0 ? filteredOptions.length - 1 : next;
+        });
+        break;
+      case 'Enter':
+        if (activeIndex >= 0 && activeIndex < filteredOptions.length) {
+          e.preventDefault();
+          handleSelect(filteredOptions[activeIndex]);
+        }
+        break;
+      case 'Escape':
+        e.preventDefault();
+        setIsOpen(false);
+        break;
+    }
+  }, [isOpen, filteredOptions, activeIndex, handleSelect]);
+
+  // 聚焦
+  var handleFocus = useCallback(function (e) {
+    onFocus === null || onFocus === void 0 || onFocus(e);
+  }, [onFocus]);
+
+  // 失焦
+  var handleBlur = useCallback(function (e) {
+    // 延迟关闭，允许点击选项
+    setTimeout(function () {
+      setIsOpen(false);
+    }, 150);
+    onBlur === null || onBlur === void 0 || onBlur(e);
+  }, [onBlur]);
+
+  // 滚动到激活项
+  useEffect(function () {
+    if (activeIndex >= 0 && dropdownRef.current) {
+      var activeItem = dropdownRef.current.querySelector('.kage-mentions-option-active');
+      activeItem === null || activeItem === void 0 || activeItem.scrollIntoView({
+        block: 'nearest'
+      });
+    }
+  }, [activeIndex]);
+
+  // 点击外部关闭
+  useEffect(function () {
+    var handleClickOutside = function handleClickOutside(e) {
+      if (containerRef.current && !containerRef.current.contains(e.target)) {
+        setIsOpen(false);
+      }
+    };
+    document.addEventListener('mousedown', handleClickOutside);
+    return function () {
+      return document.removeEventListener('mousedown', handleClickOutside);
+    };
+  }, []);
+  var classNames = ['kage-mentions', "kage-mentions-".concat(size), disabled && 'kage-mentions-disabled', status && "kage-mentions-status-".concat(status), isOpen && 'kage-mentions-open', className].filter(Boolean).join(' ');
+  return /*#__PURE__*/_jsxs("div", {
+    ref: containerRef,
+    className: classNames,
+    style: style,
+    children: [/*#__PURE__*/_jsx("textarea", _objectSpread({
+      ref: setTextareaRef,
+      className: "kage-mentions-textarea",
+      value: value,
+      placeholder: placeholder,
+      disabled: disabled,
+      rows: rows,
+      onChange: handleChange,
+      onFocus: handleFocus,
+      onBlur: handleBlur,
+      onKeyDown: handleKeyDown
+    }, rest)), /*#__PURE__*/_jsx("div", {
+      ref: measureRef,
+      className: "kage-mentions-measure"
+    }), isOpen && /*#__PURE__*/_jsx("div", {
+      ref: dropdownRef,
+      className: "kage-mentions-dropdown",
+      style: {
+        top: dropdownPosition.top,
+        left: dropdownPosition.left
+      },
+      children: loading ? /*#__PURE__*/_jsx("div", {
+        className: "kage-mentions-loading",
+        children: "\u52A0\u8F7D\u4E2D..."
+      }) : filteredOptions.length > 0 ? filteredOptions.map(function (option, index) {
+        var optionClassNames = ['kage-mentions-option', option.disabled && 'kage-mentions-option-disabled', index === activeIndex && 'kage-mentions-option-active'].filter(Boolean).join(' ');
+        return /*#__PURE__*/_jsx("div", {
+          className: optionClassNames,
+          onClick: function onClick() {
+            return handleSelect(option);
+          },
+          onMouseEnter: function onMouseEnter() {
+            return setActiveIndex(index);
+          },
+          children: option.label || option.value
+        }, option.value);
+      }) : /*#__PURE__*/_jsx("div", {
+        className: "kage-mentions-empty",
+        children: notFoundContent
+      })
+    })]
+  });
+});
+Mentions.displayName = 'Mentions';
+export default Mentions;