@anjianshi/utils 3.0.3 → 3.0.5

package/env-node/logging/index.d.ts

@@ -1,6 +1,8 @@
 /**
  * 针对 Node.js 环境定制 logging
- * 注意：使用此模块需要 chalk 依赖
+ *
+ * 使用前提：
+ * - 安装 chalk 依赖
  */
 import { type Logger } from '../../logging/index.js';
 export * from './handlers.js';

package/env-node/logging/index.js

@@ -1,6 +1,8 @@
 /**
  * 针对 Node.js 环境定制 logging
- * 注意：使用此模块需要 chalk 依赖
+ *
+ * 使用前提：
+ * - 安装 chalk 依赖
  */
 import { logger as defaultLogger } from '../../logging/index.js';
 import { ConsoleHandler } from './handlers.js';

package/env-react/emotion.d.ts

@@ -5,17 +5,23 @@
  * 使用前提：
  * 1. 只支持浏览器渲染
  * 2. 安装 @emotion/serialize、@emotion/utils
- * 2. 用 EmotionCacheProvider 包裹 App 根元素
+ * 3. 调用 registerEmotionFunctions() 注册 @emotion/serialize 的 serializeStyles() 和 @emotion/utils 的 insertStyles() 函数
+ * 4. 用 EmotionCacheProvider 包裹 App 根元素
  *
  * 来自：
  * https://github.com/emotion-js/emotion/issues/1853#issuecomment-623349622
  */
 import { type EmotionCache } from '@emotion/react';
-import { type CSSInterpolation } from '@emotion/serialize';
+import type { CSSInterpolation, serializeStyles as serializeStylesT } from '@emotion/serialize';
+import type { insertStyles as insertStylesT } from '@emotion/utils';
 export declare const useEmotionCache: () => EmotionCache | undefined;
 export declare const EmotionCacheProvider: import("react").FC<{
     children: React.ReactNode;
 } & import("react").RefAttributes<any>> | import("react").ForwardRefExoticComponent<{
     children: React.ReactNode;
 } & import("react").RefAttributes<any>>;
+declare let serializeStyles: typeof serializeStylesT | null;
+declare let insertStyles: typeof insertStylesT | null;
+export declare function registerEmotionFunctions(serializeStylesFn: typeof serializeStyles, insertStylesFn: typeof insertStyles): void;
 export declare function useEmotionClassName(): (...args: CSSInterpolation[]) => string;
+export {};

package/env-react/emotion.jsx

@@ -5,29 +5,39 @@
  * 使用前提：
  * 1. 只支持浏览器渲染
  * 2. 安装 @emotion/serialize、@emotion/utils
- * 2. 用 EmotionCacheProvider 包裹 App 根元素
+ * 3. 调用 registerEmotionFunctions() 注册 @emotion/serialize 的 serializeStyles() 和 @emotion/utils 的 insertStyles() 函数
+ * 4. 用 EmotionCacheProvider 包裹 App 根元素
  *
  * 来自：
  * https://github.com/emotion-js/emotion/issues/1853#issuecomment-623349622
  */
 import { withEmotionCache } from '@emotion/react';
-import { serializeStyles } from '@emotion/serialize';
-import { insertStyles } from '@emotion/utils';
 import { createContext, useContext, useCallback } from 'react';
 const CacheContext = createContext(undefined);
 export const useEmotionCache = () => useContext(CacheContext);
 export const EmotionCacheProvider = withEmotionCache(({ children }, cache) => {
     return <CacheContext.Provider value={cache}>{children}</CacheContext.Provider>;
 });
+let serializeStyles = null;
+let insertStyles = null;
+export function registerEmotionFunctions(serializeStylesFn, insertStylesFn) {
+    serializeStyles = serializeStylesFn;
+    insertStyles = insertStylesFn;
+}
 export function useEmotionClassName() {
     const cache = useEmotionCache();
     return useCallback((...args) => {
         if (!cache) {
             if (process.env.NODE_ENV === 'production') {
+                console.error('useEmotionClassName: emotion-cache-missing');
                 return 'emotion-cache-missing';
             }
             throw new Error('No emotion cache found!');
         }
+        if (!serializeStyles || !insertStyles) {
+            console.error('useEmotionClassName: need register serializeStyles() and insertStyles() functions first.');
+            return 'emotion-functions-missing';
+        }
         const serialized = serializeStyles(args, cache.registered);
         insertStyles(cache, serialized, false);
         return cache.key + '-' + serialized.name;

package/env-service/prisma/adapt-logging.js

@@ -3,6 +3,9 @@
  *
  * 注意：Prisma 的 debugging 日志是直接输出到 console 的，没有提供处理渠道，所以无法记录进日志文件。
  * 理论上可以重写 console.log/debug... 等方法来实现捕获，但这牵扯面太广，暂不这样做。
+ *
+ * 使用前提：
+ * - 安装 chalk 依赖
  */
 import nodeUtil from 'node:util';
 import chalk from 'chalk';

package/logging/index.d.ts

@@ -1,3 +1,9 @@
+/**
+ * 通用日志记录实现
+ *
+ * 使用前提：
+ * - 安装 dayjs 依赖
+ */
 import { type Dayjs } from 'dayjs';
 export { default as formatters } from './formatters.js';
 export * from './adapt.js';

package/logging/index.js

@@ -1,3 +1,9 @@
+/**
+ * 通用日志记录实现
+ *
+ * 使用前提：
+ * - 安装 dayjs 依赖
+ */
 import dayjs from 'dayjs';
 export { default as formatters } from './formatters.js';
 export * from './adapt.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anjianshi/utils",
-  "version": "3.0.3",
+  "version": "3.0.5",
   "description": "Common JavaScript Utils",
   "homepage": "https://github.com/anjianshi/js-packages/utils",
   "bugs": {
@@ -31,15 +31,17 @@
     "redis": "^5.5.6",
     "typescript": "^5.8.3",
     "vconsole": "^3.15.1",
-    "@anjianshi/presets-eslint-base": "6.0.0",
     "@anjianshi/presets-eslint-react": "6.0.0",
+    "@anjianshi/presets-eslint-base": "6.0.0",
     "@anjianshi/presets-eslint-node": "6.0.0",
     "@anjianshi/presets-eslint-typescript": "6.0.0",
-    "@anjianshi/presets-typescript": "3.2.5",
-    "@anjianshi/presets-prettier": "3.0.5"
+    "@anjianshi/presets-prettier": "3.0.5",
+    "@anjianshi/presets-typescript": "3.2.5"
   },
   "peerDependencies": {
     "@emotion/react": "^11.14.0",
+    "@emotion/serialize": "^1.3.3",
+    "@emotion/utils": "^1.4.2",
     "@prisma/client": "^6.8.2",
     "chalk": "^5.4.1",
     "dayjs": "^1.11.13",
@@ -50,6 +52,12 @@
     "@emotion/react": {
       "optional": true
     },
+    "@emotion/serialize": {
+      "optional": true
+    },
+    "@emotion/utils": {
+      "optional": true
+    },
     "@prisma/client": {
       "optional": true
     },

package/validators/index.d.ts

@@ -1,3 +1,9 @@
+/**
+ * 通用验证器实现
+ *
+ * 使用前提：
+ * - 因为涉及时间对象解析，需安装 dayjs 依赖
+ */
 export * from './base.js';
 export * from './boolean.js';
 export * from './number.js';

package/validators/index.js

@@ -1,3 +1,9 @@
+/**
+ * 通用验证器实现
+ *
+ * 使用前提：
+ * - 因为涉及时间对象解析，需安装 dayjs 依赖
+ */
 export * from './base.js';
 export * from './boolean.js';
 export * from './number.js';