icode-hooks 0.3.0

package/es/utils/getDocumentOrShadow.d.ts

@@ -0,0 +1,3 @@
+import type { BasicTarget } from '../utils/domTarget';
+declare const getDocumentOrShadow: (target: BasicTarget | BasicTarget[]) => Document | Node;
+export default getDocumentOrShadow;

package/es/utils/getDocumentOrShadow.js

@@ -0,0 +1,28 @@
+import { getTargetElement } from '../utils/domTarget';
+// 检查所有目标元素是否都在 Shadow DOM 中
+var checkIfAllInShadow = function (targets) {
+  return targets.every(function (item) {
+    var targetElement = getTargetElement(item);
+    if (!targetElement) return false;
+    // @ts-ignore
+    if (targetElement.getRootNode() instanceof ShadowRoot) return true;
+  });
+};
+var getShadow = function (node) {
+  if (!node) {
+    return document;
+  }
+  return node.getRootNode();
+};
+// 获取文档或 Shadow DOM
+var getDocumentOrShadow = function (target) {
+  if (!target || !document.getRootNode) {
+    return document;
+  }
+  var targets = Array.isArray(target) ? target : [target];
+  if (checkIfAllInShadow(targets)) {
+    return getShadow(getTargetElement(targets[0]));
+  }
+  return document;
+};
+export default getDocumentOrShadow;

package/es/utils/index.d.ts

@@ -0,0 +1,6 @@
+export declare const isObject: (value: unknown) => value is Record<any, any>;
+export declare const isFunction: (value: unknown) => value is (...args: any) => any;
+export declare const isString: (value: unknown) => value is string;
+export declare const isBoolean: (value: unknown) => value is boolean;
+export declare const isNumber: (value: unknown) => value is number;
+export declare const isUndef: (value: unknown) => value is undefined;

package/es/utils/index.js

@@ -0,0 +1,18 @@
+export var isObject = function (value) {
+  return value !== null && typeof value === 'object';
+};
+export var isFunction = function (value) {
+  return typeof value === 'function';
+};
+export var isString = function (value) {
+  return typeof value === 'string';
+};
+export var isBoolean = function (value) {
+  return typeof value === 'boolean';
+};
+export var isNumber = function (value) {
+  return typeof value === 'number';
+};
+export var isUndef = function (value) {
+  return typeof value === 'undefined';
+};

package/es/utils/isAppleDevice.d.ts

@@ -0,0 +1,2 @@
+declare const isAppleDevice: boolean;
+export default isAppleDevice;

package/es/utils/isAppleDevice.js

@@ -0,0 +1,3 @@
+// 判断是否是苹果设备
+var isAppleDevice = /(mac|iphone|ipod|ipad)/i.test(typeof navigator !== 'undefined' ? navigator === null || navigator === void 0 ? void 0 : navigator.platform : '');
+export default isAppleDevice;

package/es/utils/isBrowser.d.ts

@@ -0,0 +1,2 @@
+declare const isBrowser: boolean;
+export default isBrowser;

package/es/utils/isBrowser.js

@@ -0,0 +1,2 @@
+var isBrowser = !!(typeof window !== 'undefined' && window.document && window.document.createElement);
+export default isBrowser;

package/es/utils/isDev.d.ts

@@ -0,0 +1,2 @@
+declare const isDev: boolean;
+export default isDev;

package/es/utils/isDev.js

@@ -0,0 +1,3 @@
+// 判断是否是开发环境
+var isDev = process.env.NODE_ENV === 'development' || process.env.NODE_ENV === 'test';
+export default isDev;

package/es/utils/lodash-polyfill.d.ts

@@ -0,0 +1,2 @@
+import { debounce } from 'lodash-es';
+export { debounce };

package/es/utils/lodash-polyfill.js

@@ -0,0 +1,11 @@
+import { debounce } from 'lodash-es';
+// 判断是否是Node环境
+function isNodeOrWeb() {
+  var freeGlobal = (typeof global === 'undefined' ? 'undefined' : typeof global) == 'object' && global && global.Object === Object && global;
+  var freeSelf = typeof self == 'object' && self && self.Object === Object && self;
+  return freeGlobal || freeSelf;
+}
+if (!isNodeOrWeb()) {
+  global.Date = Date;
+}
+export { debounce };

package/es/utils/testingHelpers.d.ts

@@ -0,0 +1,2 @@
+export declare function sleep(time: number): Promise<void>;
+export declare function request(req: any): Promise<unknown>;

package/es/utils/testingHelpers.js

@@ -0,0 +1,19 @@
+export function sleep(time) {
+  return new Promise(function (resolve) {
+    setTimeout(function () {
+      resolve();
+    }, time);
+  });
+}
+// 模拟请求
+export function request(req) {
+  return new Promise(function (resolve, reject) {
+    return setTimeout(function () {
+      if (req === 0) {
+        reject(new Error('fail'));
+      } else {
+        resolve('success');
+      }
+    }, 1000);
+  });
+}

package/es/utils/tests.d.ts

@@ -0,0 +1,4 @@
+import { renderHook } from '@testing-library/react';
+export * from '@testing-library/react';
+declare const customRender: typeof renderHook;
+export { customRender as renderHook };

package/es/utils/tests.js

@@ -0,0 +1,12 @@
+import { __assign } from "tslib";
+import { StrictMode } from 'react';
+import { renderHook } from '@testing-library/react';
+export * from '@testing-library/react';
+var Wrapper = process.env.REACT_MODE === 'strict' ? StrictMode : undefined;
+// 自定义渲染
+var customRender = function (ui, options) {
+  return renderHook(ui, __assign({
+    wrapper: Wrapper
+  }, options));
+};
+export { customRender as renderHook };

package/es/utils/useDeepCompareWithTarget.d.ts

@@ -0,0 +1,4 @@
+import type { DependencyList, EffectCallback } from 'react';
+import type { BasicTarget } from './domTarget';
+declare const useDeepCompareEffectWithTarget: (effect: EffectCallback, deps: DependencyList, target: BasicTarget<any> | BasicTarget<any>[]) => void;
+export default useDeepCompareEffectWithTarget;

package/es/utils/useDeepCompareWithTarget.js

@@ -0,0 +1,14 @@
+import { useRef } from 'react';
+import useEffectWithTarget from './useEffectWithTarget';
+import { depsEqual } from './depsEqual';
+// 使用深度比较的 effect 函数，用于在组件渲染时执行副作用，并且可以指定依赖项和目标元素
+var useDeepCompareEffectWithTarget = function (effect, deps, target) {
+  var ref = useRef();
+  var signalRef = useRef(0);
+  if (!depsEqual(deps, ref.current)) {
+    ref.current = deps;
+    signalRef.current += 1;
+  }
+  useEffectWithTarget(effect, [signalRef.current], target);
+};
+export default useDeepCompareEffectWithTarget;

package/es/utils/useEffectWithTarget.d.ts

@@ -0,0 +1,2 @@
+declare const useEffectWithTarget: (effect: import("react").EffectCallback, deps: import("react").DependencyList, target: import("./domTarget").BasicTarget<any> | import("./domTarget").BasicTarget<any>[]) => void;
+export default useEffectWithTarget;

package/es/utils/useEffectWithTarget.js

@@ -0,0 +1,5 @@
+import { useEffect } from 'react';
+import createEffectWithTarget from './createEffectWithTarget';
+// 使用 effect 函数，用于在组件渲染时执行副作用，并且可以指定依赖项和目标元素
+var useEffectWithTarget = createEffectWithTarget(useEffect);
+export default useEffectWithTarget;

package/es/utils/useIsomorphicLayoutEffectWithTarget.d.ts

@@ -0,0 +1,2 @@
+declare const useIsomorphicLayoutEffectWithTarget: (effect: import("react").EffectCallback, deps: import("react").DependencyList, target: import("./domTarget").BasicTarget<any> | import("./domTarget").BasicTarget<any>[]) => void;
+export default useIsomorphicLayoutEffectWithTarget;

package/es/utils/useIsomorphicLayoutEffectWithTarget.js

@@ -0,0 +1,5 @@
+import isBrowser from './isBrowser';
+import useEffectWithTarget from './useEffectWithTarget';
+import useLayoutEffectWithTarget from './useLayoutEffectWithTarget';
+var useIsomorphicLayoutEffectWithTarget = isBrowser ? useLayoutEffectWithTarget : useEffectWithTarget;
+export default useIsomorphicLayoutEffectWithTarget;

package/es/utils/useLayoutEffectWithTarget.d.ts

@@ -0,0 +1,2 @@
+declare const useEffectWithTarget: (effect: import("react").EffectCallback, deps: import("react").DependencyList, target: import("./domTarget").BasicTarget<any> | import("./domTarget").BasicTarget<any>[]) => void;
+export default useEffectWithTarget;

package/es/utils/useLayoutEffectWithTarget.js

@@ -0,0 +1,4 @@
+import { useLayoutEffect } from 'react';
+import createEffectWithTarget from './createEffectWithTarget';
+var useEffectWithTarget = createEffectWithTarget(useLayoutEffect);
+export default useEffectWithTarget;

package/lib/createUpdateEffect/index.d.ts

@@ -0,0 +1,4 @@
+import type { useEffect, useLayoutEffect } from 'react';
+type EffectHookType = typeof useEffect | typeof useLayoutEffect;
+export declare const createUpdateEffect: (hook: EffectHookType) => EffectHookType;
+export default createUpdateEffect;

package/lib/createUpdateEffect/index.js

@@ -0,0 +1,28 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = exports.createUpdateEffect = void 0;
+var _react = require("react");
+var createUpdateEffect = exports.createUpdateEffect = function createUpdateEffect(hook) {
+  return function (effect, deps) {
+    var isMounted = (0, _react.useRef)(false);
+    // hook 传递进来就是useEffect或者useLayoutEffect，所以这里可以调用它 并且返回一个函数，这个函数在组件卸载时调用
+    hook(function () {
+      return function () {
+        isMounted.current = false;
+      };
+    }, []);
+    // 如果组件已经挂载，则执行effect
+    hook(function () {
+      if (!isMounted.current) {
+        // 如果没有挂载说明是初始化第一次 只需要做记录标志位
+        isMounted.current = true;
+      } else {
+        return effect(); // 如果已经挂载，则执行effect
+      }
+    }, deps);
+  };
+};
+var _default = exports["default"] = createUpdateEffect;

package/lib/index.d.ts

@@ -0,0 +1,9 @@
+export { default as useBoolean } from './useBoolean';
+export { default as useToggle } from './useToggle';
+export { default as useLatest } from './useLatest';
+export { default as useMemoizedFn } from './useMemoizedFn';
+export { default as useUpdate } from './useUpdate';
+export { default as useUpdateEffect } from './useUpdateEffect';
+export { default as useCreation } from './useCreation';
+export { default as useRequest } from './useRequest';
+export { default as usePrescription } from './usePrescription';

package/lib/index.js

@@ -0,0 +1,69 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "useBoolean", {
+  enumerable: true,
+  get: function get() {
+    return _useBoolean["default"];
+  }
+});
+Object.defineProperty(exports, "useCreation", {
+  enumerable: true,
+  get: function get() {
+    return _useCreation["default"];
+  }
+});
+Object.defineProperty(exports, "useLatest", {
+  enumerable: true,
+  get: function get() {
+    return _useLatest["default"];
+  }
+});
+Object.defineProperty(exports, "useMemoizedFn", {
+  enumerable: true,
+  get: function get() {
+    return _useMemoizedFn["default"];
+  }
+});
+Object.defineProperty(exports, "usePrescription", {
+  enumerable: true,
+  get: function get() {
+    return _usePrescription["default"];
+  }
+});
+Object.defineProperty(exports, "useRequest", {
+  enumerable: true,
+  get: function get() {
+    return _useRequest["default"];
+  }
+});
+Object.defineProperty(exports, "useToggle", {
+  enumerable: true,
+  get: function get() {
+    return _useToggle["default"];
+  }
+});
+Object.defineProperty(exports, "useUpdate", {
+  enumerable: true,
+  get: function get() {
+    return _useUpdate["default"];
+  }
+});
+Object.defineProperty(exports, "useUpdateEffect", {
+  enumerable: true,
+  get: function get() {
+    return _useUpdateEffect["default"];
+  }
+});
+var _useBoolean = _interopRequireDefault(require("./useBoolean"));
+var _useToggle = _interopRequireDefault(require("./useToggle"));
+var _useLatest = _interopRequireDefault(require("./useLatest"));
+var _useMemoizedFn = _interopRequireDefault(require("./useMemoizedFn"));
+var _useUpdate = _interopRequireDefault(require("./useUpdate"));
+var _useUpdateEffect = _interopRequireDefault(require("./useUpdateEffect"));
+var _useCreation = _interopRequireDefault(require("./useCreation"));
+var _useRequest = _interopRequireDefault(require("./useRequest"));
+var _usePrescription = _interopRequireDefault(require("./usePrescription"));

package/lib/useBoolean/index.d.ts

@@ -0,0 +1,8 @@
+interface UseBooleanActions {
+    state: boolean;
+    setTrue: () => void;
+    setFalse: () => void;
+    toggle: () => void;
+}
+export default function useBoolean(initialValue?: boolean): UseBooleanActions;
+export {};

package/lib/useBoolean/index.js

@@ -0,0 +1,33 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = useBoolean;
+var _tslib = require("tslib");
+var _react = require("react");
+function useBoolean(initialValue) {
+  if (initialValue === void 0) {
+    initialValue = false;
+  }
+  var _a = (0, _tslib.__read)((0, _react.useState)(initialValue), 2),
+    state = _a[0],
+    setState = _a[1];
+  var setTrue = function setTrue() {
+    return setState(true);
+  };
+  var setFalse = function setFalse() {
+    return setState(false);
+  };
+  var toggle = function toggle() {
+    return setState(function (v) {
+      return !v;
+    });
+  };
+  return {
+    state: state,
+    setTrue: setTrue,
+    setFalse: setFalse,
+    toggle: toggle
+  };
+}

package/lib/useCreation/index.d.ts

@@ -0,0 +1,2 @@
+import type { DependencyList } from 'react';
+export default function useCreation<T>(factory: () => T, deps: DependencyList): T;

package/lib/useCreation/index.js

@@ -0,0 +1,28 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = useCreation;
+var _react = require("react");
+var _depsAreSame = _interopRequireDefault(require("../utils/depsAreSame"));
+//
+function useCreation(factory, deps) {
+  // 使用 useRef 来存储依赖项、对象和初始化状态
+  var current = (0, _react.useRef)({
+    deps: deps,
+    // 依赖项
+    obj: undefined,
+    // 对象
+    initialized: false // 初始化状态
+  }).current;
+  // 如果初始化状态为 false 或者依赖项不相同，则重新创建对象
+  if (current.initialized === false || !(0, _depsAreSame["default"])(current.deps, deps)) {
+    current.deps = deps; // 更新依赖项
+    current.obj = factory(); // 创建对象
+    current.initialized = true; // 更新初始化状态
+  }
+  // 返回对象
+  return current.obj;
+}

package/lib/useLatest/index.d.ts

@@ -0,0 +1,3 @@
+import { type MutableRefObject } from 'react';
+declare function useLatest<T>(value: T): MutableRefObject<T>;
+export default useLatest;

package/lib/useLatest/index.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _react = require("react");
+function useLatest(value) {
+  var ref = (0, _react.useRef)(value);
+  ref.current = value;
+  return ref;
+}
+var _default = exports["default"] = useLatest;

package/lib/useMemoizedFn/index.d.ts

@@ -0,0 +1,3 @@
+type noop = (this: any, ...args: any) => any;
+declare function useMemoizedFn<T extends noop>(fn: T): T;
+export default useMemoizedFn;

package/lib/useMemoizedFn/index.js

@@ -0,0 +1,40 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
+var _react = require("react");
+var _utils = require("../utils");
+var _isDev = _interopRequireDefault(require("../utils/isDev"));
+/**
+ * title: 基础用法
+ * desc: useMemoizedFn 与 useCallback 可以实现同样的效果。
+ */
+
+function useMemoizedFn(fn) {
+  if (_isDev["default"]) {
+    if (!(0, _utils.isFunction)(fn)) {
+      console.error("useMemoizedFn expected parameter is a function,got".concat((0, _typeof2["default"])(fn)));
+    }
+  }
+  var fnRef = (0, _react.useRef)(fn);
+  fnRef.current = (0, _react.useMemo)(function () {
+    return fn;
+  }, [fn]);
+  var memoizedFn = (0, _react.useRef)();
+  if (!memoizedFn.current) {
+    memoizedFn.current = function () {
+      var args = [];
+      for (var _i = 0; _i < arguments.length; _i++) {
+        args[_i] = arguments[_i];
+      }
+      console.log(fnRef.current, 'fnRef.current');
+      return fnRef.current.apply(this, args);
+    };
+  }
+  return memoizedFn.current;
+}
+var _default = exports["default"] = useMemoizedFn;

package/lib/useMount/index.d.ts

@@ -0,0 +1,2 @@
+declare const useMount: (fn: any) => void;
+export default useMount;

package/lib/useMount/index.js

@@ -0,0 +1,23 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
+var _react = require("react");
+var _utils = require("../utils");
+var _isDev = _interopRequireDefault(require("../utils/isDev"));
+// 为了在开发阶段做参数校验、打印警告，帮你早点发现错误；生产环境不做这些检查，避免性能和包体积成本。
+var useMount = function useMount(fn) {
+  if (_isDev["default"]) {
+    if (!(0, _utils.isFunction)(fn)) {
+      console.error("useMount:parameter `fn` expected to be a function,but got \"".concat((0, _typeof2["default"])(fn), "\"."));
+    }
+  }
+  (0, _react.useEffect)(function () {
+    fn === null || fn === void 0 ? void 0 : fn();
+  }, []);
+};
+var _default = exports["default"] = useMount;

package/lib/usePrescription/api.d.ts

@@ -0,0 +1,7 @@
+import type { Prescription } from './types';
+/** 药房后台接口层（实际项目里换成 umi request / 公共 request） */
+export declare const prescriptionApi: {
+    getPrescription(id: string): Promise<Prescription>;
+    confirmDrug(id: string): Promise<void>;
+    cancelPrescription(id: string): Promise<void>;
+};

package/lib/usePrescription/api.js

@@ -0,0 +1,23 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.prescriptionApi = void 0;
+/** 药房后台接口层（实际项目里换成 umi request / 公共 request） */
+var prescriptionApi = exports.prescriptionApi = {
+  getPrescription: function getPrescription(id) {
+    return Promise.resolve({
+      id: id,
+      patientName: '张三',
+      drugList: [],
+      status: 'pending'
+    });
+  },
+  confirmDrug: function confirmDrug(id) {
+    return Promise.resolve();
+  },
+  cancelPrescription: function cancelPrescription(id) {
+    return Promise.resolve();
+  }
+};

package/lib/usePrescription/index.d.ts

@@ -0,0 +1,36 @@
+import type { Prescription } from './types';
+export type { DrugItem, Prescription, PrescriptionStatus } from './types';
+export type UsePrescriptionOptions = {
+    /** 为 false 时不自动拉详情（仅手动 loadDetail） */
+    ready?: boolean;
+    /** 与详情共用 cacheKey 时开启 */
+    cacheKey?: string;
+};
+export type PrescriptionServices<TPrescription extends Prescription = Prescription> = {
+    getPrescription: (id: string) => Promise<TPrescription>;
+    confirmDrug: (id: string) => Promise<unknown>;
+    cancelPrescription: (id: string) => Promise<unknown>;
+};
+/**
+ * 处方详情 + 发药 / 作废（药房后台常见组合）
+ *
+ * - id 变化自动重新拉详情（refreshDeps）
+ * - 发药 / 作废成功后 mutate 乐观更新 status
+ */
+export declare function usePrescription<TPrescription extends Prescription = Prescription>(id: string | undefined, services: PrescriptionServices<TPrescription>, options?: UsePrescriptionOptions): {
+    readonly prescription: TPrescription | undefined;
+    readonly loading: boolean;
+    readonly error: Error | undefined;
+    readonly refreshing: boolean;
+    readonly confirming: boolean;
+    readonly cancelling: boolean;
+    /** id 变化或手动刷新详情 */
+    readonly refresh: () => void;
+    /** 手动按 id 拉详情（列表跳详情等） */
+    readonly loadDetail: () => void;
+    readonly confirmSend: (targetId?: string) => Promise<void>;
+    readonly cancel: (targetId?: string) => Promise<void>;
+    /** 本地改详情（乐观更新 / 回滚） */
+    readonly mutate: (data?: TPrescription | ((oldData?: TPrescription | undefined) => TPrescription | undefined) | undefined) => void;
+};
+export default usePrescription;