@fe-free/tool 1.2.3 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @fe-free/tool
 
+## 1.3.0
+
+### Minor Changes
+
+- feat: some
+
+## 1.2.4
+
+### Patch Changes
+
+- feat: useGlobalRequest
+
 ## 1.2.3
 
 ## 1.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fe-free/tool",
-  "version": "1.2.3",
+  "version": "1.3.0",
   "description": "",
   "main": "./src/index.ts",
   "author": "",
@@ -12,7 +12,9 @@
   "dependencies": {
     "lodash-es": "^4.17.21"
   },
-  "peerDependencies": {},
+  "peerDependencies": {
+    "ahooks": "^3.8.4"
+  },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   }

package/src/index.ts

@@ -2,4 +2,6 @@ export { pinyin, pinyinFilter, pinyinMatch, pinyinMatchWithoutFirstLetter } from
 
 export { getDayjs } from './date';
 
+export { useGlobalRequest } from './use_global_request';
+
 export { buildURL } from './url';

package/src/pinyin/pinyin.stories.tsx

@@ -0,0 +1,40 @@
+import { pinyin, pinyinFilter, pinyinMatch } from '@fe-free/tool';
+import type { Meta, StoryObj } from '@storybook/react';
+
+const meta: Meta = {
+  title: '@fe-free/tool/Pinyin',
+  tags: ['autodocs'],
+};
+
+export default meta;
+type Story = StoryObj;
+
+// 基础拼音转换
+export const Basic: Story = {
+  render: () => <div>{pinyin('你好')}</div>,
+};
+
+// 首字母拼音
+export const FirstLetter: Story = {
+  render: () => <div>{pinyin('你好', 'first_letter')}</div>,
+};
+
+// 拼音匹配
+export const PinyinMatch: Story = {
+  render: () => (
+    <>
+      <div>匹配结果: {pinyinMatch('你好', 'nh') + ''}</div>
+      <div>不匹配结果: {pinyinMatch('你好', 'wo') + ''}</div>
+    </>
+  ),
+};
+
+// 拼音过滤
+export const PinyinFilter: Story = {
+  render: () => (
+    <>
+      <div>过滤结果: {pinyinFilter(['你好', '我们'], 'nh')}</div>
+      <div>过滤结果: {pinyinFilter(['你好', '我们'], 'wo')}</div>
+    </>
+  ),
+};

package/src/url/url.stories.tsx

@@ -0,0 +1,103 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { buildURL } from './index';
+
+const meta: Meta = {
+  title: '@fe-free/tool/URL',
+  tags: ['autodocs'],
+};
+
+export default meta;
+type Story = StoryObj;
+
+// 基础 URL 构建
+export const Basic: Story = {
+  render: () => {
+    const url = 'https://example.com/path';
+    const result = buildURL(url);
+    return (
+      <div>
+        <p>原始 URL: {url}</p>
+        <p>构建后: {result}</p>
+      </div>
+    );
+  },
+};
+
+// 添加查询参数
+export const WithSearchParams: Story = {
+  render: () => {
+    const url = 'https://example.com/path';
+    const result = buildURL(url, {
+      searchParams: {
+        name: 'test',
+        age: 18,
+      },
+    });
+    return (
+      <div>
+        <p>原始 URL: {url}</p>
+        <p>添加查询参数后: {result}</p>
+      </div>
+    );
+  },
+};
+
+// 合并查询参数
+export const MergeSearchParams: Story = {
+  render: () => {
+    const url = 'https://example.com/path?existing=value';
+    const result = buildURL(url, {
+      searchParams: {
+        newParam: 'newValue',
+      },
+    });
+    return (
+      <div>
+        <p>原始 URL: {url}</p>
+        <p>合并查询参数后: {result}</p>
+      </div>
+    );
+  },
+};
+
+// 添加 hash 查询参数
+export const WithHashSearchParams: Story = {
+  render: () => {
+    const url = 'https://example.com/path#section';
+    const result = buildURL(url, {
+      hashSearchParams: {
+        tab: 'details',
+        view: 'list',
+      },
+    });
+    return (
+      <div>
+        <p>原始 URL: {url}</p>
+        <p>添加 hash 查询参数后: {result}</p>
+      </div>
+    );
+  },
+};
+
+// 复杂场景：同时处理查询参数和 hash 查询参数
+export const Complex: Story = {
+  render: () => {
+    const url = 'https://example.com/path?page=1#section?tab=main';
+    const result = buildURL(url, {
+      searchParams: {
+        sort: 'desc',
+        filter: 'active',
+      },
+      hashSearchParams: {
+        view: 'grid',
+        theme: 'dark',
+      },
+    });
+    return (
+      <div>
+        <p>原始 URL: {url}</p>
+        <p>复杂处理后: {result}</p>
+      </div>
+    );
+  },
+};

package/src/use_global_request.tsx

@@ -0,0 +1,26 @@
+import { useRequest } from 'ahooks';
+import type { Options, Plugin, Service } from 'ahooks/es/useRequest/src/types';
+
+function useGlobalRequest<TData, TParams extends any[]>(
+  service: Service<TData, TParams>,
+  options?: Options<TData, TParams>,
+  plugins?: Plugin<TData, TParams>[]
+) {
+  return useRequest(
+    service,
+    {
+      onError: (error) => {
+        // 全局抛出错误
+        setTimeout(() => {
+          throw error;
+        }, 0);
+      },
+      ...options,
+      // @ts-ignore
+      __ignore: true,
+    },
+    plugins
+  );
+}
+
+export { useGlobalRequest };

package/src/pinyin/index.md

@@ -1,63 +0,0 @@
----
-nav:
-  title: '组件'
-  order: 15
-group: 'tool'
-toc: content
----
-
-# pinyin
-
-将汉字转换为拼音
-
-## 场景
-
-输出拼音
-
-```tsx
-import { pinyin } from '@fe-free/tool';
-
-export default () => {
-  return <div>{pinyin('你好')}</div>;
-};
-```
-
-输出首拼音
-
-```tsx
-import { pinyin } from '@fe-free/tool';
-
-export default () => {
-  return <div>{pinyin('你好', 'first_letter')} </div>;
-};
-```
-
-匹配
-
-```tsx
-import { pinyinMatch } from '@fe-free/tool';
-
-export default () => {
-  return (
-    <>
-      <div>{pinyinMatch('你好', 'nh') + ''}</div>
-      <div>{pinyinMatch('你好', 'wo') + ''} </div>
-    </>
-  );
-};
-```
-
-过滤
-
-```tsx
-import { pinyinFilter } from '@fe-free/tool';
-
-export default () => {
-  return (
-    <>
-      <div>{pinyinFilter(['你好', ' 我们'], 'nh')} </div>
-      <div>{pinyinFilter(['你好', ' 我们'], 'wo')} </div>
-    </>
-  );
-};
-```