@fast-china/utils 2.1.5 → 2.1.7

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to Fast.Utils are documented in this file.
 
+## [2.1.7] - 2026-09-14
+
+### Changed
+
+- Bundled CryptoJS into the ESM package output to avoid CommonJS subpath resolution failures in strict ESM and uni-app toolchains while preserving module-level tree-shaking.
+
+## [2.1.6] - 2026-09-13
+
+### Added
+
+- Added lightweight Vue 3 composables for native event listeners, window size, ResizeObserver, element size, current time, and minimum-width breakpoints.
+- Added automatic Vue scope cleanup, manual stop handles where applicable, SSR-safe initial state, runtime validation, and public type coverage for the new composables.
+
 ## [2.1.5] - 2026-09-12
 
 ### Added
@@ -113,6 +126,8 @@ All notable changes to Fast.Utils are documented in this file.
 
 - Added authenticated ciphertext validation, bounded crypto parameters and payloads, unbiased Web Crypto randomness, prototype-safe query/object transforms, and namespace-scoped Storage cleanup.
 
+[2.1.7]: https://github.com/China-xiaoFang/Fast.Utils/compare/v2.1.6...v2.1.7
+[2.1.6]: https://github.com/China-xiaoFang/Fast.Utils/compare/v2.1.5...v2.1.6
 [2.1.5]: https://github.com/China-xiaoFang/Fast.Utils/compare/v2.1.4...v2.1.5
 [2.1.4]: https://github.com/China-xiaoFang/Fast.Utils/compare/v2.1.3...v2.1.4
 [2.1.3]: https://github.com/China-xiaoFang/Fast.Utils/compare/v2.1.2...v2.1.3

package/README.md

@@ -10,7 +10,7 @@
 
 Browser-first TypeScript utilities for modern browsers, WebViews, Vue 3, and uni-app.
 
-[![npm version](https://img.shields.io/npm/v/@fast-china/utils?color=orange)](https://www.npmjs.com/package/@fast-china/utils) [![node](https://img.shields.io/badge/node-%5E22.18%20%7C%7C%20%5E24.18-brightgreen)](https://nodejs.org/) [![vue](https://img.shields.io/badge/vue-%5E3.3-42b883)](https://vuejs.org/) [![license](https://img.shields.io/npm/l/@fast-china/utils)](./LICENSE)
+[![npm version](https://img.shields.io/npm/v/@fast-china/utils?color=orange)](https://www.npmjs.com/package/@fast-china/utils) [![node](https://img.shields.io/badge/node-%5E22.18%20%7C%7C%20%5E24.18-brightgreen)](https://nodejs.org/) [![vue](https://img.shields.io/badge/vue-%5E3.5.11-42b883)](https://vuejs.org/) [![license](https://img.shields.io/npm/l/@fast-china/utils)](./LICENSE)
 
 ## Highlights
 
@@ -133,13 +133,23 @@ Base64 and Crypto text decoding/decryption functions return the primitive-string
 
 Store passwords with `HashPasswordPBKDF2SHA256` and `VerifyPasswordPBKDF2SHA256`. MD5, SHA-1, AES-CBC, and AES-ECB do not provide password-storage or authenticated-encryption guarantees. See the [API reference](./docs/API.md#crypto) for the complete method list and security boundaries.
 
+CryptoJS is bundled into the ESM and CDN artifacts for the compatibility hash and AES APIs. Consumers do not install or resolve `crypto-js` subpaths; applications that do not use Crypto APIs can still remove the independent crypto module through Tree Shaking.
+
 ## Vue 3
 
 ```ts
-import { useEmits, useProps, withInstall } from "@fast-china/utils";
+import { useBreakpoints, useElementSize, useEventListener, useNow, useWindowSize } from "@fast-china/utils";
+import { useTemplateRef } from "vue";
+
+const elementRef = useTemplateRef<HTMLElement>("element");
+const { width: windowWidth } = useWindowSize();
+const { width: elementWidth } = useElementSize(elementRef);
+const now = useNow();
+const breakpoints = useBreakpoints({ desktop: 1280, mobile: 0, tablet: 768 });
+useEventListener(document, "visibilitychange", () => console.log(document.visibilityState));
 ```
 
-The package provides Vue 3 `app.use()` registration, Composition API helpers, typed props/emits/slots, and TSX rendering. Vue remains external to the build and is required as a peer dependency.
+The package provides lightweight native-backed browser composables, Vue 3 `app.use()` registration, typed props/emits/slots, and TSX rendering. Browser composables clean up with the current Vue scope; advanced scheduling, controls, SSR configuration, and device APIs remain outside this package. Vue remains external to the build and is required as a peer dependency.
 
 ## Modules
 
@@ -153,7 +163,7 @@ The `object` module includes dependency-free deep cloning and equality plus pred
 
 - The package-manager entry is pure ESM; the CDN entry is a separately minified IIFE.
 - ES2022 modern browsers and WebViews.
-- Vue 3.3 or newer through a required peer dependency.
+- Vue 3.5.11 or newer through a required peer dependency.
 - uni-app through automatic global `uni` detection when Storage is configured.
 - No import-time access to `window`, Storage, or `uni`; unsupported calls fail explicitly.
 - Web Crypto, URL, Intl, TextEncoder, and related platform capabilities are not polyfilled.

package/README.zh.md

@@ -10,7 +10,7 @@
 
 面向现代浏览器、WebView、Vue 3 与 uni-app 的 TypeScript 前端工具库。
 
-[![npm 版本](https://img.shields.io/npm/v/@fast-china/utils?color=orange)](https://www.npmjs.com/package/@fast-china/utils) [![node](https://img.shields.io/badge/node-%5E22.18%20%7C%7C%20%5E24.18-brightgreen)](https://nodejs.org/) [![Vue](https://img.shields.io/badge/vue-%5E3.3-42b883)](https://vuejs.org/) [![开源协议](https://img.shields.io/npm/l/@fast-china/utils)](./LICENSE)
+[![npm 版本](https://img.shields.io/npm/v/@fast-china/utils?color=orange)](https://www.npmjs.com/package/@fast-china/utils) [![node](https://img.shields.io/badge/node-%5E22.18%20%7C%7C%20%5E24.18-brightgreen)](https://nodejs.org/) [![Vue](https://img.shields.io/badge/vue-%5E3.5.11-42b883)](https://vuejs.org/) [![开源协议](https://img.shields.io/npm/l/@fast-china/utils)](./LICENSE)
 
 ## 特性
 
@@ -133,13 +133,23 @@ Base64 与 Crypto 的文本解码/解密入口返回原始字符串类型 `Decod
 
 密码存储使用 `HashPasswordPBKDF2SHA256` 和 `VerifyPasswordPBKDF2SHA256`。MD5、SHA-1、AES-CBC 与 AES-ECB 不提供密码存储或认证加密保证。完整方法列表和安全边界见 [API 文档](./docs/API.zh-CN.md#crypto)。
 
+兼容哈希与 AES API 使用的 CryptoJS 已内联到 ESM 和 CDN 产物，消费项目无需安装或解析 `crypto-js` 子路径；未使用 Crypto API 的应用仍可通过 Tree Shaking 移除独立的加密模块。
+
 ## Vue 3
 
 ```ts
-import { useEmits, useProps, withInstall } from "@fast-china/utils";
+import { useBreakpoints, useElementSize, useEventListener, useNow, useWindowSize } from "@fast-china/utils";
+import { useTemplateRef } from "vue";
+
+const elementRef = useTemplateRef<HTMLElement>("element");
+const { width: windowWidth } = useWindowSize();
+const { width: elementWidth } = useElementSize(elementRef);
+const now = useNow();
+const breakpoints = useBreakpoints({ desktop: 1280, mobile: 0, tablet: 768 });
+useEventListener(document, "visibilitychange", () => console.log(document.visibilityState));
 ```
 
-包内提供 Vue 3 `app.use()` 注册、Composition API Helper、Props/Emits/Slots 类型和 TSX 渲染。Vue 不会打进构建产物，并作为必须安装的 Peer Dependency。
+包内提供基于原生浏览器 API 的轻量 Composable、Vue 3 `app.use()` 注册、Props/Emits/Slots 类型和 TSX 渲染。浏览器 Composable 随当前 Vue 作用域自动清理；高级调度、控制、SSR 配置和设备 API 不在本包范围内。Vue 不会打进构建产物，并作为必须安装的 Peer Dependency。
 
 ## 模块
 
@@ -153,7 +163,7 @@ import { useEmits, useProps, withInstall } from "@fast-china/utils";
 
 - 包管理器入口为纯 ESM；CDN 入口为单独压缩的 IIFE。
 - 面向 ES2022 现代浏览器与 WebView。
-- Vue 3.3 及以上版本通过必须安装的 Peer Dependency 接入。
+- Vue 3.5.11 及以上版本通过必须安装的 Peer Dependency 接入。
 - 配置 Storage 时自动检测全局 `uni` 并接入 uni-app。
 - 导入阶段不访问 `window`、Storage 或 `uni`；不支持的调用明确失败。
 - 不注入 Web Crypto、URL、Intl、TextEncoder 等 Polyfill。

package/THIRD_PARTY_LICENSES.md

@@ -0,0 +1,26 @@
+# Third-Party Licenses
+
+## CryptoJS
+
+CryptoJS is licensed under the MIT License.
+
+Copyright (c) 2009-2013 Jeff Mott  
+Copyright (c) 2013-2016 Evan Vosberg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.