xxf_react 0.6.6 → 0.6.8

package/dist/http/models/RequestConfig.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 请求配置相关类型
+ */
+import type { CacheConfig } from './CacheConfig';
+/**
+ * 请求配置
+ *
+ * 用于定义单个 API 端点的配置
+ *
+ * @example
+ * ```ts
+ * .get<User>('getUser', {
+ *   path: '/users/{id}',
+ *   headers: { 'Accept': 'application/json' },
+ *   timeout: 5000,
+ *   cache: { mode: CacheMode.IfCache, ttl: 60000 },
+ * })
+ * ```
+ */
+export interface RequestConfig {
+    /** 请求方法 */
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    /** 请求路径，支持路径参数如 /users/{id} */
+    path: string;
+    /** 请求头 */
+    headers?: Record<string, string>;
+    /** 超时时间 (ms) */
+    timeout?: number;
+    /** 缓存配置 */
+    cache?: CacheConfig;
+    /** 重试次数 */
+    retry?: number;
+}
+/**
+ * API 调用选项
+ *
+ * 用于调用 API 时传入的运行时参数
+ *
+ * @example
+ * ```ts
+ * // 完整示例
+ * await api.getUser({
+ *   pathParams: { id: '123' },
+ *   query: { include: 'profile' },
+ *   headers: { 'X-Request-Id': 'abc' },
+ *   cache: { mode: CacheMode.OnlyRemote },  // 本次调用强制不缓存
+ * })
+ *
+ * // POST 请求
+ * await api.createUser({
+ *   body: { name: 'John', email: 'john@example.com' },
+ * })
+ * ```
+ */
+export interface ApiOptions {
+    /** URL 路径参数，用于替换路径中的 {param} */
+    pathParams?: Record<string, string | number>;
+    /** 查询参数，会自动过滤 undefined 和 null */
+    query?: Record<string, string | number | boolean | undefined>;
+    /** 请求体（用于 POST/PUT/PATCH） */
+    body?: unknown;
+    /** 覆盖缓存配置（优先级最高） */
+    cache?: Partial<CacheConfig>;
+    /** 覆盖请求头 */
+    headers?: Record<string, string>;
+}
+//# sourceMappingURL=RequestConfig.d.ts.map

package/dist/http/models/RequestConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestConfig.d.ts","sourceRoot":"","sources":["../../../src/http/models/RequestConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,aAAa;IAC1B,WAAW;IACX,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAA;IACnD,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU;IACV,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW;IACX,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,UAAU;IACvB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;IAC5C,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAA;IAC7D,6BAA6B;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,oBAAoB;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;IAC5B,YAAY;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACnC"}

package/dist/http/models/RequestConfig.js

@@ -0,0 +1,4 @@
+/**
+ * 请求配置相关类型
+ */
+export {};

package/dist/http/models/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * HTTP 网络框架类型定义
+ *
+ * 按功能模块拆分：
+ * - CacheMode: 缓存模式枚举
+ * - CacheEntry: 缓存条目结构
+ * - ApiTypes: API 响应相关类型
+ * - CacheConfig: 缓存配置
+ * - CacheInterceptor: 缓存拦截器
+ * - HttpClientConfig: HTTP 客户端配置
+ * - RequestConfig: 请求配置
+ * - DiskCacheConfig: 磁盘缓存配置
+ * - LruMetadata: LRU 元数据
+ */
+export { CacheMode } from './CacheMode';
+export type { CacheEntry } from './CacheEntry';
+export type { ApiResult, ApiCallback } from './ApiTypes';
+export type { CacheConfig, CacheKeyRequest } from './CacheConfig';
+export type { CacheInterceptor, CacheInterceptorContext, CacheInterceptorResult, } from './CacheInterceptor';
+export type { HttpClientConfig } from './HttpClientConfig';
+export type { RequestConfig, ApiOptions } from './RequestConfig';
+export type { DiskLruCacheConfig, HttpCacheConfig } from './DiskCacheConfig';
+export type { LruMetadataEntry, LruMetadata } from './LruMetadata';
+//# sourceMappingURL=index.d.ts.map

package/dist/http/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/http/models/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAGvC,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAG9C,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxD,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAGjE,YAAY,EACR,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,GACzB,MAAM,oBAAoB,CAAA;AAG3B,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAG1D,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAGhE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAG5E,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA"}

package/dist/http/models/index.js

@@ -0,0 +1,16 @@
+/**
+ * HTTP 网络框架类型定义
+ *
+ * 按功能模块拆分：
+ * - CacheMode: 缓存模式枚举
+ * - CacheEntry: 缓存条目结构
+ * - ApiTypes: API 响应相关类型
+ * - CacheConfig: 缓存配置
+ * - CacheInterceptor: 缓存拦截器
+ * - HttpClientConfig: HTTP 客户端配置
+ * - RequestConfig: 请求配置
+ * - DiskCacheConfig: 磁盘缓存配置
+ * - LruMetadata: LRU 元数据
+ */
+// 缓存模式
+export { CacheMode } from './CacheMode';

package/dist/http/types.d.ts

@@ -0,0 +1,13 @@
+/**
+ * HTTP 网络框架类型定义
+ *
+ * 统一导出入口，保持向后兼容
+ * 实际类型定义在 models/ 目录下按功能拆分
+ *
+ * @example
+ * ```ts
+ * import { CacheMode, type HttpClientConfig } from 'xxf_react/http'
+ * ```
+ */
+export { CacheMode, type CacheEntry, type ApiResult, type ApiCallback, type CacheConfig, type CacheKeyRequest, type CacheInterceptor, type CacheInterceptorContext, type CacheInterceptorResult, type HttpClientConfig, type RequestConfig, type ApiOptions, type DiskLruCacheConfig, type HttpCacheConfig, type LruMetadataEntry, type LruMetadata, } from './models';
+//# sourceMappingURL=types.d.ts.map

package/dist/http/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/http/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAEH,SAAS,EAET,KAAK,UAAU,EAEf,KAAK,SAAS,EACd,KAAK,WAAW,EAEhB,KAAK,WAAW,EAChB,KAAK,eAAe,EAEpB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAE3B,KAAK,gBAAgB,EAErB,KAAK,aAAa,EAClB,KAAK,UAAU,EAEf,KAAK,kBAAkB,EACvB,KAAK,eAAe,EAEpB,KAAK,gBAAgB,EACrB,KAAK,WAAW,GACnB,MAAM,UAAU,CAAA"}

package/dist/http/types.js

@@ -0,0 +1,14 @@
+/**
+ * HTTP 网络框架类型定义
+ *
+ * 统一导出入口，保持向后兼容
+ * 实际类型定义在 models/ 目录下按功能拆分
+ *
+ * @example
+ * ```ts
+ * import { CacheMode, type HttpClientConfig } from 'xxf_react/http'
+ * ```
+ */
+export { 
+// 缓存模式枚举
+CacheMode, } from './models';

package/dist/index.d.ts

@@ -9,5 +9,6 @@ export * from './responsive';
 export * from './foundation';
 export * from './layout';
 export * from './event-bus';
+export * from './http';
 export declare function initXXF(): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAG5B,wBAAgB,OAAO,SAEtB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AAGvB,wBAAgB,OAAO,SAGtB"}

package/dist/index.js

@@ -1,4 +1,5 @@
 import { initPromiseErrorExtension } from "./flow/PromiseExt";
+import { extendVideoElement } from "./media";
 export * from './sse';
 export * from './fetch';
 export * from './utils';
@@ -10,7 +11,9 @@ export * from './responsive';
 export * from './foundation';
 export * from './layout';
 export * from './event-bus';
+export * from './http';
 ///框架初始化函数，调用后会初始化一些全局功能
 export function initXXF() {
     initPromiseErrorExtension();
+    extendVideoElement();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xxf_react",
-  "version": "0.6.6",
+  "version": "0.6.8",
   "private": false,
   "type": "module",
   "main": "dist/index.js",
@@ -53,6 +53,10 @@
     "./event-bus": {
       "types": "./dist/event-bus/index.d.ts",
       "import": "./dist/event-bus/index.js"
+    },
+    "./http": {
+      "types": "./dist/http/index.d.ts",
+      "import": "./dist/http/index.js"
     }
   },
   "files": [
@@ -65,23 +69,29 @@
     "react": ">=18"
   },
   "dependencies": {
-    "zustand": "^5.0.11",
     "@microsoft/fetch-event-source": "^2.0.1",
     "@use-gesture/react": "^10.3.1",
     "bowser": "^2.14.1",
     "broadcast-channel": "^7.3.0",
     "dayjs": "^1.11.19",
+    "idb-keyval": "^6.2.2",
+    "ky": "^1.14.3",
     "react-async-hook": "^4.0.0",
     "react-resize-detector": "^12.3.0",
     "react-responsive": "^10.0.1",
     "react-toastify": "^11.0.5",
     "react-virtualized-auto-sizer": "^2.0.2",
     "react-virtuoso": "^4.17.0",
+    "rfdc": "^1.4.1",
     "tailwind-variants": "^3.2.2",
     "tiny-lru": "^11.4.7",
-    "use-debounce": "^10.0.6"
+    "use-debounce": "^10.0.6",
+    "zustand": "^5.0.11"
   },
   "devDependencies": {
-    "next": "^16.0.7"
+    "@types/node": "^25.3.0",
+    "@types/react": "^19.2.14",
+    "next": "^16.1.6",
+    "typescript": "^5.9.3"
   }
 }