@hhfenpm/medical-agent-utils 1.0.0

package/README.md

@@ -0,0 +1,157 @@
+# @hhfenpm/medical-agent-utils
+
+通用工具函数库，包含 UUID 生成、对象属性获取、设备检测等常用工具函数。
+
+## 安装
+
+```bash
+npm install @hhfenpm/medical-agent-utils
+# 或
+yarn add @hhfenpm/medical-agent-utils
+```
+
+## 使用方式
+
+### 按需引入
+
+```javascript
+// 引入单个函数
+import { uuid, get, isTablet } from '@hhfenpm/medical-agent-utils'
+
+// 使用
+const id = uuid()
+const value = get(obj, 'path.to.value', defaultValue)
+if (isTablet()) {
+  console.log('当前是平板设备')
+}
+```
+
+### 全量引入
+
+```javascript
+// 引入所有工具
+import utils from '@hhfenpm/medical-agent-utils'
+
+// 使用
+const id = utils.uuid.uuid()
+const value = utils.get.get(obj, 'path.to.value')
+const deviceInfo = utils.device.getDeviceInfo()
+```
+
+## API 文档
+
+### UUID 生成 (uuid)
+
+#### `uuid()`
+
+生成短 UUID。
+
+```javascript
+import { uuid } from '@hhfenpm/medical-agent-utils'
+
+const id = uuid() // 'abc123'
+```
+
+#### `uuidLong()`
+
+生成长 UUID。
+
+```javascript
+import { uuidLong } from '@hhfenpm/medical-agent-utils'
+
+const longId = uuidLong() // 'abc123def456ghi789'
+```
+
+---
+
+### 对象属性获取 (get)
+
+#### `get(object, path, defaultValue)`
+
+安全获取对象属性，类似 lodash.get。
+
+```javascript
+import { get } from '@hhfenpm/medical-agent-utils'
+
+const obj = { a: { b: { c: 123 } } }
+const value = get(obj, 'a.b.c', 0) // 123
+const defaultValue = get(obj, 'a.b.d', 0) // 0
+```
+
+**参数：**
+
+- `object` - 目标对象
+- `path` - 属性路径（字符串或数组）
+- `defaultValue` - 默认值（可选）
+
+---
+
+### 设备检测 (device)
+
+#### `isTablet()`
+
+检测当前设备是否为平板。
+
+```javascript
+import { isTablet } from '@hhfenpm/medical-agent-utils'
+
+if (isTablet()) {
+  console.log('当前是平板设备')
+}
+```
+
+#### `getDeviceType()`
+
+获取设备类型。
+
+```javascript
+import { getDeviceType } from '@hhfenpm/medical-agent-utils'
+
+getDeviceType() // 'desktop' | 'tablet' | 'mobile'
+```
+
+#### `isTouchDevice()`
+
+检测是否为触摸设备。
+
+```javascript
+import { isTouchDevice } from '@hhfenpm/medical-agent-utils'
+
+if (isTouchDevice()) {
+  console.log('支持触摸操作')
+}
+```
+
+#### `getDeviceInfo()`
+
+获取完整设备信息。
+
+```javascript
+import { getDeviceInfo } from '@hhfenpm/medical-agent-utils'
+
+const info = getDeviceInfo()
+// {
+//   isTablet: false,
+//   deviceType: 'desktop',
+//   isTouchDevice: false,
+//   userAgent: '...',
+//   screenWidth: 1920,
+//   screenHeight: 1080,
+//   devicePixelRatio: 1,
+//   orientation: 'landscape-primary',
+// }
+```
+
+## 浏览器兼容性
+
+- 现代浏览器（Chrome, Firefox, Safari, Edge）
+- IE 11+（部分功能需要 polyfill）
+
+## 注意事项
+
+1. 部分函数依赖浏览器环境（如 `window`, `navigator`），在 SSR 场景下已添加环境判断
+2. 使用 Rollup 构建，支持 Tree-shaking，按需引入时只会打包使用的函数
+
+## 许可证
+
+MIT

package/dist/index.esm.js

@@ -0,0 +1,243 @@
+/**
+ * UUID 生成工具
+ */
+
+/**
+ * 生成短 UUID
+ * @returns {string} UUID 字符串
+ */
+function uuid() {
+  let random;
+
+  try {
+    const arr = new Uint32Array(1);
+    // https://developer.mozilla.org/en-US/docs/Web/API/RandomSource/getRandomValues
+    if (typeof window !== 'undefined' && window.crypto) {
+      window.crypto.getRandomValues(arr);
+      random = arr[0] & 2147483647;
+    } else {
+      random = Math.floor(Math.random() * 2147483648);
+    }
+  } catch (b) {
+    random = Math.floor(Math.random() * 2147483648);
+  }
+
+  return random.toString(36)
+}
+
+/**
+ * 生成长 UUID
+ * @returns {string} 长 UUID 字符串
+ */
+function uuidLong() {
+  return `${uuid()}${uuid()}${uuid()}`
+}
+
+var uuid$1 = /*#__PURE__*/Object.freeze({
+  __proto__: null,
+  default: uuid,
+  uuid: uuid,
+  uuidLong: uuidLong
+});
+
+/**
+ * 安全获取对象属性工具
+ * 类似 lodash.get
+ */
+
+function baseGet(object, path) {
+  path = castPath(path);
+
+  var index = 0,
+    length = path.length;
+
+  while (object != null && index < length) {
+    object = object[path[index++]];
+  }
+  return index && index == length ? object : undefined
+}
+
+function castPath(value, object) {
+  if (Array.isArray(value)) {
+    return value
+  }
+  return stringToPath(String(value))
+}
+
+function stringToPath(string) {
+  var result = [];
+  if (string.charCodeAt(0) === 46 /* . */) {
+    result.push('');
+  }
+  string.replace(
+    /[^.[\]]+|\[(?:(-?\d+(?:\.\d+)?)|(["'])((?:(?!\2)[^\\]|\\.)*?)\2)\]|(?=(?:\.|\[\])(?:\.|\[\]|$))/g,
+    function (match, number, quote, subString) {
+      result.push(quote ? subString.replace(/\\(\\)?/g, '$1') : number || match);
+    }
+  );
+  return result
+}
+
+/**
+ * 获取对象属性
+ * @param {Object} object - 目标对象
+ * @param {string|Array} path - 属性路径
+ * @param {*} defaultValue - 默认值
+ * @returns {*} 属性值
+ */
+function get(object, path, defaultValue) {
+  var result = object == null ? undefined : baseGet(object, path);
+  return result === undefined ? defaultValue : result
+}
+
+var get$1 = /*#__PURE__*/Object.freeze({
+  __proto__: null,
+  get: get
+});
+
+/**
+ * 设备检测工具函数
+ */
+
+/**
+ * 检测当前设备是否为平板
+ * @returns {boolean} 是否为平板设备
+ */
+function isTablet() {
+  if (typeof window === 'undefined' || typeof navigator === 'undefined') {
+    return false
+  }
+
+  // 获取用户代理字符串
+  const userAgent = navigator.userAgent.toLowerCase();
+
+  // 检测常见的平板设备标识
+  const tabletPatterns = [
+    /ipad/, // iPad
+    /android.*tablet/, // Android 平板
+    /kindle/, // Kindle
+    /silk/, // Amazon Silk
+    /playbook/, // BlackBerry PlayBook
+    /bb10/, // BlackBerry 10
+    /rim tablet/, // BlackBerry Tablet OS
+    /windows.*touch/, // Windows 平板
+    /tablet/, // 通用平板标识
+  ];
+
+  // 检查用户代理是否匹配平板模式
+  const isTabletByUserAgent = tabletPatterns.some((pattern) =>
+    pattern.test(userAgent)
+  );
+
+  // 检测屏幕尺寸和触摸支持
+  const hasTouch =
+    'ontouchstart' in window || navigator.maxTouchPoints > 0;
+  const screenWidth = window.screen.width;
+  const screenHeight = window.screen.height;
+  const minDimension = Math.min(screenWidth, screenHeight);
+  const maxDimension = Math.max(screenWidth, screenHeight);
+
+  // 平板设备的典型屏幕尺寸范围
+  const isTabletByScreenSize =
+    minDimension >= 600 &&
+    minDimension <= 1200 &&
+    maxDimension >= 800 &&
+    maxDimension <= 1600;
+
+  // 检测是否为移动设备但屏幕较大（可能是平板）
+  const isMobile = /android|webos|iphone|ipod|blackberry|iemobile|opera mini/i.test(
+    userAgent
+  );
+  const isLargeMobile = isMobile && minDimension >= 600;
+
+  // 综合判断：用户代理匹配 或 (屏幕尺寸符合平板特征 且 支持触摸) 或 (大屏移动设备)
+  return (
+    isTabletByUserAgent ||
+    (isTabletByScreenSize && hasTouch) ||
+    isLargeMobile
+  )
+}
+
+/**
+ * 检测当前设备类型
+ * @returns {string} 'desktop' | 'tablet' | 'mobile'
+ */
+function getDeviceType() {
+  if (typeof window === 'undefined' || typeof navigator === 'undefined') {
+    return 'desktop'
+  }
+
+  if (isTablet()) {
+    return 'tablet'
+  }
+
+  const userAgent = navigator.userAgent.toLowerCase();
+  const isMobile = /android|webos|iphone|ipod|blackberry|iemobile|opera mini/i.test(
+    userAgent
+  );
+
+  return isMobile ? 'mobile' : 'desktop'
+}
+
+/**
+ * 检测是否为触摸设备
+ * @returns {boolean} 是否为触摸设备
+ */
+function isTouchDevice() {
+  if (typeof window === 'undefined' || typeof navigator === 'undefined') {
+    return false
+  }
+  return 'ontouchstart' in window || navigator.maxTouchPoints > 0
+}
+
+/**
+ * 获取设备信息
+ * @returns {object} 设备信息对象
+ */
+function getDeviceInfo() {
+  if (typeof window === 'undefined' || typeof navigator === 'undefined') {
+    return {
+      isTablet: false,
+      deviceType: 'desktop',
+      isTouchDevice: false,
+      userAgent: '',
+      screenWidth: 0,
+      screenHeight: 0,
+      devicePixelRatio: 1,
+      orientation: 'unknown',
+    }
+  }
+
+  return {
+    isTablet: isTablet(),
+    deviceType: getDeviceType(),
+    isTouchDevice: isTouchDevice(),
+    userAgent: navigator.userAgent,
+    screenWidth: window.screen.width,
+    screenHeight: window.screen.height,
+    devicePixelRatio: window.devicePixelRatio || 1,
+    orientation: screen.orientation ? screen.orientation.type : 'unknown',
+  }
+}
+
+var device = /*#__PURE__*/Object.freeze({
+  __proto__: null,
+  getDeviceInfo: getDeviceInfo,
+  getDeviceType: getDeviceType,
+  isTablet: isTablet,
+  isTouchDevice: isTouchDevice
+});
+
+/**
+ * @hhfenpm/medical-agent-utils
+ * 通用工具函数库
+ */
+
+
+var index = {
+  uuid: uuid$1,
+  get: get$1,
+  device,
+};
+
+export { index as default, get, getDeviceInfo, getDeviceType, isTablet, isTouchDevice, uuid, uuidLong };

package/dist/index.js

@@ -0,0 +1,254 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * UUID 生成工具
+ */
+
+/**
+ * 生成短 UUID
+ * @returns {string} UUID 字符串
+ */
+function uuid() {
+  let random;
+
+  try {
+    const arr = new Uint32Array(1);
+    // https://developer.mozilla.org/en-US/docs/Web/API/RandomSource/getRandomValues
+    if (typeof window !== 'undefined' && window.crypto) {
+      window.crypto.getRandomValues(arr);
+      random = arr[0] & 2147483647;
+    } else {
+      random = Math.floor(Math.random() * 2147483648);
+    }
+  } catch (b) {
+    random = Math.floor(Math.random() * 2147483648);
+  }
+
+  return random.toString(36)
+}
+
+/**
+ * 生成长 UUID
+ * @returns {string} 长 UUID 字符串
+ */
+function uuidLong() {
+  return `${uuid()}${uuid()}${uuid()}`
+}
+
+var uuid$1 = /*#__PURE__*/Object.freeze({
+  __proto__: null,
+  default: uuid,
+  uuid: uuid,
+  uuidLong: uuidLong
+});
+
+/**
+ * 安全获取对象属性工具
+ * 类似 lodash.get
+ */
+
+function baseGet(object, path) {
+  path = castPath(path);
+
+  var index = 0,
+    length = path.length;
+
+  while (object != null && index < length) {
+    object = object[path[index++]];
+  }
+  return index && index == length ? object : undefined
+}
+
+function castPath(value, object) {
+  if (Array.isArray(value)) {
+    return value
+  }
+  return stringToPath(String(value))
+}
+
+function stringToPath(string) {
+  var result = [];
+  if (string.charCodeAt(0) === 46 /* . */) {
+    result.push('');
+  }
+  string.replace(
+    /[^.[\]]+|\[(?:(-?\d+(?:\.\d+)?)|(["'])((?:(?!\2)[^\\]|\\.)*?)\2)\]|(?=(?:\.|\[\])(?:\.|\[\]|$))/g,
+    function (match, number, quote, subString) {
+      result.push(quote ? subString.replace(/\\(\\)?/g, '$1') : number || match);
+    }
+  );
+  return result
+}
+
+/**
+ * 获取对象属性
+ * @param {Object} object - 目标对象
+ * @param {string|Array} path - 属性路径
+ * @param {*} defaultValue - 默认值
+ * @returns {*} 属性值
+ */
+function get(object, path, defaultValue) {
+  var result = object == null ? undefined : baseGet(object, path);
+  return result === undefined ? defaultValue : result
+}
+
+var get$1 = /*#__PURE__*/Object.freeze({
+  __proto__: null,
+  get: get
+});
+
+/**
+ * 设备检测工具函数
+ */
+
+/**
+ * 检测当前设备是否为平板
+ * @returns {boolean} 是否为平板设备
+ */
+function isTablet() {
+  if (typeof window === 'undefined' || typeof navigator === 'undefined') {
+    return false
+  }
+
+  // 获取用户代理字符串
+  const userAgent = navigator.userAgent.toLowerCase();
+
+  // 检测常见的平板设备标识
+  const tabletPatterns = [
+    /ipad/, // iPad
+    /android.*tablet/, // Android 平板
+    /kindle/, // Kindle
+    /silk/, // Amazon Silk
+    /playbook/, // BlackBerry PlayBook
+    /bb10/, // BlackBerry 10
+    /rim tablet/, // BlackBerry Tablet OS
+    /windows.*touch/, // Windows 平板
+    /tablet/, // 通用平板标识
+  ];
+
+  // 检查用户代理是否匹配平板模式
+  const isTabletByUserAgent = tabletPatterns.some((pattern) =>
+    pattern.test(userAgent)
+  );
+
+  // 检测屏幕尺寸和触摸支持
+  const hasTouch =
+    'ontouchstart' in window || navigator.maxTouchPoints > 0;
+  const screenWidth = window.screen.width;
+  const screenHeight = window.screen.height;
+  const minDimension = Math.min(screenWidth, screenHeight);
+  const maxDimension = Math.max(screenWidth, screenHeight);
+
+  // 平板设备的典型屏幕尺寸范围
+  const isTabletByScreenSize =
+    minDimension >= 600 &&
+    minDimension <= 1200 &&
+    maxDimension >= 800 &&
+    maxDimension <= 1600;
+
+  // 检测是否为移动设备但屏幕较大（可能是平板）
+  const isMobile = /android|webos|iphone|ipod|blackberry|iemobile|opera mini/i.test(
+    userAgent
+  );
+  const isLargeMobile = isMobile && minDimension >= 600;
+
+  // 综合判断：用户代理匹配 或 (屏幕尺寸符合平板特征 且 支持触摸) 或 (大屏移动设备)
+  return (
+    isTabletByUserAgent ||
+    (isTabletByScreenSize && hasTouch) ||
+    isLargeMobile
+  )
+}
+
+/**
+ * 检测当前设备类型
+ * @returns {string} 'desktop' | 'tablet' | 'mobile'
+ */
+function getDeviceType() {
+  if (typeof window === 'undefined' || typeof navigator === 'undefined') {
+    return 'desktop'
+  }
+
+  if (isTablet()) {
+    return 'tablet'
+  }
+
+  const userAgent = navigator.userAgent.toLowerCase();
+  const isMobile = /android|webos|iphone|ipod|blackberry|iemobile|opera mini/i.test(
+    userAgent
+  );
+
+  return isMobile ? 'mobile' : 'desktop'
+}
+
+/**
+ * 检测是否为触摸设备
+ * @returns {boolean} 是否为触摸设备
+ */
+function isTouchDevice() {
+  if (typeof window === 'undefined' || typeof navigator === 'undefined') {
+    return false
+  }
+  return 'ontouchstart' in window || navigator.maxTouchPoints > 0
+}
+
+/**
+ * 获取设备信息
+ * @returns {object} 设备信息对象
+ */
+function getDeviceInfo() {
+  if (typeof window === 'undefined' || typeof navigator === 'undefined') {
+    return {
+      isTablet: false,
+      deviceType: 'desktop',
+      isTouchDevice: false,
+      userAgent: '',
+      screenWidth: 0,
+      screenHeight: 0,
+      devicePixelRatio: 1,
+      orientation: 'unknown',
+    }
+  }
+
+  return {
+    isTablet: isTablet(),
+    deviceType: getDeviceType(),
+    isTouchDevice: isTouchDevice(),
+    userAgent: navigator.userAgent,
+    screenWidth: window.screen.width,
+    screenHeight: window.screen.height,
+    devicePixelRatio: window.devicePixelRatio || 1,
+    orientation: screen.orientation ? screen.orientation.type : 'unknown',
+  }
+}
+
+var device = /*#__PURE__*/Object.freeze({
+  __proto__: null,
+  getDeviceInfo: getDeviceInfo,
+  getDeviceType: getDeviceType,
+  isTablet: isTablet,
+  isTouchDevice: isTouchDevice
+});
+
+/**
+ * @hhfenpm/medical-agent-utils
+ * 通用工具函数库
+ */
+
+
+var index = {
+  uuid: uuid$1,
+  get: get$1,
+  device,
+};
+
+exports.default = index;
+exports.get = get;
+exports.getDeviceInfo = getDeviceInfo;
+exports.getDeviceType = getDeviceType;
+exports.isTablet = isTablet;
+exports.isTouchDevice = isTouchDevice;
+exports.uuid = uuid;
+exports.uuidLong = uuidLong;

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@hhfenpm/medical-agent-utils",
+  "version": "1.0.0",
+  "description": "通用工具函数库，包含UUID生成、对象属性获取、设备检测等常用工具",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "utils",
+    "tools",
+    "uuid",
+    "get",
+    "device"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^25.0.0",
+    "@rollup/plugin-node-resolve": "^15.0.0",
+    "rollup": "^3.29.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "bugs": {
+    "url": ""
+  },
+  "homepage": ""
+}