zcw-shared 2.25.0 → 2.26.0

package/README.md

@@ -167,15 +167,6 @@ export interface MyFunctionDeps {
 import type { Ref } from '../../references/vue.d'  // Vue 没有 references 文件
 ```
 
-#### 规则 7：存储能力统一通过 `useStorage`
-
-- 不允许直接依赖 `localStorage` / `sessionStorage` 等同步 API
-- 必须组合 `useStorage` 与具体适配器（如 `useLocalStorage`、`useSessionStorage`、`useStorageWithIndexedDB`）创建 `storage` 对象
-- Env 类型统一定义为 `ReturnType<typeof useStorage<string>>`（或自定义 value 类型）
-- 在实现中仅使用 `storage.get/set/remove/clear` 等 Promise API，避免混用同步方法
-- 文档站中的 VitePress 交互示例同样需要使用 `useStorage` 与适配器，确保行为与生产代码一致
-- **多表结构化 IndexedDB**（多 object store、复合索引、`transaction`）可使用 **`useDexieShortcuts`**：将 `Dexie` 构造器与 `indexedDB` 注入 `deps`，应用侧安装 peer 依赖 **`dexie`**（版本范围见 `package.json` 的 `peerDependencies`）。详见 `docs/api/storage/useDexieShortcuts.md`。
-
 #### 规则 5：每个函数维护自己完整的依赖，不要分散
 
 ```typescript
@@ -270,6 +261,71 @@ export interface DeployTCBDeps {
 }
 ```
 
+#### 规则 7：存储能力统一通过 `useStorage`
+
+- 不允许直接依赖 `localStorage` / `sessionStorage` 等同步 API
+- 必须组合 `useStorage` 与具体适配器（如 `useLocalStorage`、`useSessionStorage`、`useStorageWithIndexedDB`）创建 `storage` 对象
+- Env 类型统一定义为 `ReturnType<typeof useStorage<string>>`（或自定义 value 类型）
+- 在实现中仅使用 `storage.get/set/remove/clear` 等 Promise API，避免混用同步方法
+- 文档站中的 VitePress 交互示例同样需要使用 `useStorage` 与适配器，确保行为与生产代码一致
+- **多表结构化 IndexedDB**（多 object store、复合索引、`transaction`）可使用 **`useDexieShortcuts`**：将 `Dexie` 构造器与 `indexedDB` 注入 `deps`，应用侧安装 peer 依赖 **`dexie`**（版本范围见 `package.json` 的 `peerDependencies`）。详见 `docs/api/storage/useDexieShortcuts.md`。
+
+#### 规则 8：浏览器宿主绑定层统一通过 `readBrowserHost`
+
+- 库内函数**不得**直接访问 `globalThis` / `window` / `document` / `localStorage`
+- 应用边界通过 `readBrowserHostFromGlobalThis()` 读取宿主，组装为 `ReadBrowserHostDeps` 后向下传递
+- `readBrowser*` / `createBrowser*` / `useBrowser*` 系列是**唯一**允许在内部调用 `readBrowserHostFromGlobalThis()` 的便捷封装，供 Web 宿主直引
+- `useBrowser*` Hook 可在绑定层直接 `import { ref, watch } from 'vue'`（与 Vue SFC 同级，属于应用边界）
+- 浏览器存储统一经 `createBrowserStringStorageKit` / `createBrowserSessionStorageKit` 组合 `useStorage` + 适配器；写入只用 `storage.set/remove`，同步 bootstrap 读可经 `backingStorage`
+- 新增浏览器绑定逻辑时，优先在 `src/functions/browser/readBrowserHost.ts` 扩展 `BrowserHostSnapshot`，不要在业务模块重复读取全局对象
+
+```typescript
+import {
+  readBrowserHostDepsFromGlobalThis,
+  requireBrowserHostLocalStorage,
+  type ReadBrowserHostDeps,
+} from '../browser/readBrowserHost'
+
+export function createBrowserExampleAccess(
+  hostDeps: ReadBrowserHostDeps = readBrowserHostDepsFromGlobalThis(),
+) {
+  return {
+    read(): string {
+      return requireBrowserHostLocalStorage(hostDeps).getItem('key') ?? ''
+    },
+  }
+}
+```
+
+#### 规则 9：编排类函数拆分 `{Name}Input` 与 `{Name}Deps`
+
+面向业务流程的编排函数（如 IM 复制、转发、媒体出站）允许将参数拆为两层：
+
+- **`{Name}Input`**：业务数据 + 由调用方实现的 I/O 回调（如 `copyImagePixels`）
+- **`{Name}Deps`**：环境能力（`document`、`setTimeout`、`URL` 等），第二参数传入；Web 宿主可使用 `readBrowserHost*` 默认注入
+
+```typescript
+export type ExecuteExampleInput = {
+  messageId: string
+  persist: (id: string) => Promise<void>
+}
+
+export interface ExecuteExampleDeps {
+  document?: Document
+}
+
+export async function executeExample(
+  input: ExecuteExampleInput,
+  deps: ExecuteExampleDeps = {
+    document: readBrowserHostDocument(readBrowserHostDepsFromGlobalThis()),
+  },
+) {
+  // input 承载业务数据与回调，deps 承载环境 API
+}
+```
+
+纯数据变换函数可只使用 `{Name}Deps` 或单一 `options`；命名与约定见 `src/functions/im/imOrchestrationTypes.ts`。
+
 #### 完整示例
 
 ```typescript
@@ -703,15 +759,15 @@ npm run publish:major  # 主要版本
 
 1. **不导入第三方库运行时函数**：不直接 `import { ref } from 'vue'`，而是通过 `env` 对象传入
 2. **Vue 类型特殊规则**：Vue 类型只能使用 `import type {} from 'vue'` 导入，不能从 `references/` 导入
-3. **不依赖全局对象**：不直接使用 `window`、`document`、`global`
-4. **接口命名规范**：`{FunctionName}Deps`，例如 `BuildProjectDeps`、`ModifyManifestDeps`
+3. **不依赖全局对象**：不直接使用 `window`、`document`、`global`；浏览器宿主统一经 `readBrowserHost`（规则 8）
+4. **接口命名规范**：`{FunctionName}Deps` 或编排函数的 `{FunctionName}Input` + `{FunctionName}Deps`
 5. **使用 deps. 前缀**：所有依赖访问都使用 `deps.methodName()`，不解构
 
 ### 快速检查清单
 
 在编写新函数或修改现有函数时，快速检查以下要点：
 
-**✅ 6大核心规则：**
+**✅ 9 大核心规则：**
 1. ❌ 不直接导入第三方库运行时函数 → ✅ 从 `references/` 导入类型（Vue 类型除外）
 2. ❌ Vue 类型不能从 `references/` 导入 → ✅ 只能使用 `import type {} from 'vue'`
 3. ❌ 不传入整个模块对象 → ✅ 只传入实际使用的函数
@@ -719,10 +775,14 @@ npm run publish:major  # 主要版本
 5. ❌ 不重复定义类型 → ✅ 使用 `Interface['method']` 提取
 6. ❌ 不分散依赖到多个参数 → ✅ 统一的 `Deps` 接口
 7. ❌ 第三方 SDK 也不能整个传入 → ✅ Vue、Wx 等也要拆分
+8. ❌ 业务代码不直接读 `globalThis` → ✅ 经 `readBrowserHost` / `readBrowser*` 绑定层注入
+9. ❌ 编排函数混用环境与业务参数 → ✅ `{Name}Input` + `{Name}Deps` 分层（见规则 9）
 
 **✅ 命名规范：**
 - 函数依赖接口：`{FunctionName}Deps`
+- 编排函数业务入参：`{FunctionName}Input`
 - Hook 环境接口：`{HookName}Environment`
+- 浏览器绑定便捷函数：`readBrowser*` / `createBrowser*` / `useBrowser*`
 - Playground 组件：`{FunctionName}Playground.vue`
 
 **✅ 文档完整性：**
@@ -1519,7 +1579,7 @@ p {
 添加新函数后，必须确认：
 
 - [ ] 函数文档已创建（`docs/api/category/functionName.md`）
-- [ ] 文档包含所有必需部分（Playground、导入、类型、说明、示例、注意事项）
+- [ ] 文档包含所有必需部分（函数描述、函数签名、参数表、返回值、工作原理；有 deps 时含前置依赖）
 - [ ] Playground 组件已创建（浏览器端函数）
 - [ ] 组件正确导入实际函数（不是 mock）
 - [ ] 侧边栏配置已更新

package/dist/functions/ai/buildResolvedLlmToolsList.d.ts

@@ -11,4 +11,3 @@ export declare function buildResolvedLlmToolsList(params: {
     rowToOpenAiTool: (row: AiToolCatalogRowForLlmResolve) => unknown;
     rowToOpenAiMcpTool: (row: AiMcpCatalogRowForLlmResolve, wire: McpToolsWireFormat) => Record<string, unknown>;
 }): unknown[];
-export declare const buildResolvedLlmToolsListPure: typeof buildResolvedLlmToolsList;

package/dist/functions/ai/buildResolvedLlmToolsList.js

@@ -25,5 +25,4 @@ export function buildResolvedLlmToolsList(params) {
     }
     return out;
 }
-export const buildResolvedLlmToolsListPure = buildResolvedLlmToolsList;
 //# sourceMappingURL=buildResolvedLlmToolsList.js.map

package/dist/functions/ai/buildResolvedLlmToolsList.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildResolvedLlmToolsList.js","sourceRoot":"","sources":["../../../src/functions/ai/buildResolvedLlmToolsList.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAGvE,MAAM,UAAU,yBAAyB,CAAC,MAazC;IACC,MAAM,GAAG,GAAc,EAAE,CAAA;IACzB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,SAAQ;QACxB,IACE,CAAC,4BAA4B,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,EAC1E,CAAC;YACD,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;YAAE,SAAQ;QAC1C,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAA;IACrC,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,SAAQ;QACxB,IACE,CAAC,4BAA4B,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,EACxE,CAAC;YACD,SAAQ;QACV,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;QACzD,IAAI,CAAC,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC;YAAE,SAAQ;QAC9D,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAChB,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAGD,MAAM,CAAC,MAAM,6BAA6B,GAAG,yBAAyB,CAAA"}
+{"version":3,"file":"buildResolvedLlmToolsList.js","sourceRoot":"","sources":["../../../src/functions/ai/buildResolvedLlmToolsList.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAGvE,MAAM,UAAU,yBAAyB,CAAC,MAazC;IACC,MAAM,GAAG,GAAc,EAAE,CAAA;IACzB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,SAAQ;QACxB,IACE,CAAC,4BAA4B,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,EAC1E,CAAC;YACD,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;YAAE,SAAQ;QAC1C,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAA;IACrC,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,SAAQ;QACxB,IACE,CAAC,4BAA4B,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,EACxE,CAAC;YACD,SAAQ;QACV,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;QACzD,IAAI,CAAC,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC;YAAE,SAAQ;QAC9D,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAChB,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/functions/array/filterListExcludingIds.d.ts

@@ -1,4 +1,3 @@
 export declare function filterListExcludingIds<T extends {
     id: string | number;
 }>(list: readonly T[], deletedIds: readonly (string | number)[] | undefined | null): T[];
-export declare const removeMessagesByIds: typeof filterListExcludingIds;

package/dist/functions/array/filterListExcludingIds.js

@@ -4,5 +4,4 @@ export function filterListExcludingIds(list, deletedIds) {
     const set = new Set(deletedIds.map((id) => String(id)));
     return list.filter((m) => !set.has(String(m.id)));
 }
-export const removeMessagesByIds = filterListExcludingIds;
 //# sourceMappingURL=filterListExcludingIds.js.map

package/dist/functions/array/filterListExcludingIds.js.map

@@ -1 +1 @@
-{"version":3,"file":"filterListExcludingIds.js","sourceRoot":"","sources":["../../../src/functions/array/filterListExcludingIds.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,sBAAsB,CACpC,IAAkB,EAClB,UAA2D;IAE3D,IAAI,CAAC,UAAU,EAAE,MAAM;QAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;IACzC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACvD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AACnD,CAAC;AAGD,MAAM,CAAC,MAAM,mBAAmB,GAAG,sBAAsB,CAAA"}
+{"version":3,"file":"filterListExcludingIds.js","sourceRoot":"","sources":["../../../src/functions/array/filterListExcludingIds.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,sBAAsB,CACpC,IAAkB,EAClB,UAA2D;IAE3D,IAAI,CAAC,UAAU,EAAE,MAAM;QAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;IACzC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACvD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AACnD,CAAC"}

package/dist/functions/browser/readBrowserAppendToBodyDeps.d.ts

@@ -0,0 +1,3 @@
+import type { UseAppendToBodyDeps } from '../../vue-hooks/dom/useAppendToBody';
+import { type ReadBrowserHostDeps } from './readBrowserHost';
+export declare function readBrowserAppendToBodyDeps(vue: Pick<Required<UseAppendToBodyDeps['vue']>, 'watch' | 'onBeforeUnmount' | 'toValue'>, hostDeps?: ReadBrowserHostDeps): UseAppendToBodyDeps;

package/dist/functions/browser/readBrowserAppendToBodyDeps.js

@@ -0,0 +1,8 @@
+import { readBrowserHostDepsFromGlobalThis, } from './readBrowserHost.js';
+export function readBrowserAppendToBodyDeps(vue, hostDeps = readBrowserHostDepsFromGlobalThis()) {
+    return {
+        vue,
+        getDefaultParent: () => (hostDeps.host.document?.body ?? null),
+    };
+}
+//# sourceMappingURL=readBrowserAppendToBodyDeps.js.map

package/dist/functions/browser/readBrowserAppendToBodyDeps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readBrowserAppendToBodyDeps.js","sourceRoot":"","sources":["../../../src/functions/browser/readBrowserAppendToBodyDeps.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,iCAAiC,GAElC,MAAM,mBAAmB,CAAA;AAK1B,MAAM,UAAU,2BAA2B,CACzC,GAAwF,EACxF,WAAgC,iCAAiC,EAAE;IAEnE,OAAO;QACL,GAAG;QACH,gBAAgB,EAAE,GAAG,EAAE,CACrB,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,IAAI,CAAsB;KAC9D,CAAA;AACH,CAAC"}

package/dist/functions/browser/readBrowserDetectDeps.d.ts

@@ -1,2 +1,4 @@
 import type { DetectBrowserDeps } from './detectBrowser';
+import { type ReadBrowserHostDeps } from './readBrowserHost';
+export declare function readBrowserDetectDeps(deps: ReadBrowserHostDeps): DetectBrowserDeps;
 export declare function readBrowserDetectDepsFromWindow(): DetectBrowserDeps;

package/dist/functions/browser/readBrowserDetectDeps.js

@@ -1,12 +1,15 @@
-export function readBrowserDetectDepsFromWindow() {
-    const nav = globalThis.navigator;
-    const win = globalThis;
+import { readBrowserHostDepsFromGlobalThis, } from './readBrowserHost.js';
+export function readBrowserDetectDeps(deps) {
+    const nav = deps.host.navigator;
     if (!nav)
         return { userAgent: '' };
     return {
         userAgent: nav.userAgent,
-        innerWidth: win.innerWidth,
-        innerHeight: win.innerHeight,
+        innerWidth: deps.host.innerWidth,
+        innerHeight: deps.host.innerHeight,
     };
 }
+export function readBrowserDetectDepsFromWindow() {
+    return readBrowserDetectDeps(readBrowserHostDepsFromGlobalThis());
+}
 //# sourceMappingURL=readBrowserDetectDeps.js.map

package/dist/functions/browser/readBrowserDetectDeps.js.map

@@ -1 +1 @@
-{"version":3,"file":"readBrowserDetectDeps.js","sourceRoot":"","sources":["../../../src/functions/browser/readBrowserDetectDeps.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,+BAA+B;IAC7C,MAAM,GAAG,GAAI,UAA+D,CAAC,SAAS,CAAA;IACtF,MAAM,GAAG,GAAG,UAAsE,CAAA;IAClF,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAA;IAClC,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;KAC7B,CAAA;AACH,CAAC"}
+{"version":3,"file":"readBrowserDetectDeps.js","sourceRoot":"","sources":["../../../src/functions/browser/readBrowserDetectDeps.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iCAAiC,GAElC,MAAM,mBAAmB,CAAA;AAG1B,MAAM,UAAU,qBAAqB,CAAC,IAAyB;IAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAA;IAC/B,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAA;IAClC,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;QAChC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW;KACnC,CAAA;AACH,CAAC;AAGD,MAAM,UAAU,+BAA+B;IAC7C,OAAO,qBAAqB,CAAC,iCAAiC,EAAE,CAAC,CAAA;AACnE,CAAC"}

package/dist/functions/browser/readBrowserHost.d.ts

@@ -0,0 +1,57 @@
+import type { Storage } from '../../../references/storage.d';
+import type { Document, Selection } from '../../../references/dom.d';
+import type { Window } from '../../../references/browser.d';
+import type { Blob } from '../../../references/blob.d';
+import type { setTimeout, clearTimeout } from '../../../references/timer.d';
+import type { FetchFunction } from '../../../references/fetch.d';
+import type { URL as URLConstructor } from '../../../references/url.d';
+export type BrowserHostCrypto = {
+    randomUUID?: () => string;
+};
+export type BrowserHostLocation = {
+    href: string;
+    protocol?: string;
+    port?: string;
+};
+export type DomClipboardItemConstructor = new (items: Record<string, Blob>) => unknown;
+export type DomMutableSelection = Selection & {
+    removeAllRanges(): void;
+    addRange(range: unknown): void;
+};
+export type BrowserHostSnapshot = {
+    navigator?: Window['navigator'];
+    innerWidth?: number;
+    innerHeight?: number;
+    localStorage?: Storage;
+    sessionStorage?: Storage;
+    document?: Document;
+    window?: Window;
+    location?: BrowserHostLocation;
+    crypto?: BrowserHostCrypto;
+    fetch?: FetchFunction;
+    URL?: Window['URL'];
+    URLConstructor?: typeof URLConstructor;
+    setTimeout?: typeof setTimeout;
+    clearTimeout?: typeof clearTimeout;
+    queueMicrotask?: (callback: () => void) => void;
+    open?: (url: string, target?: string, features?: string) => unknown;
+    Image?: Window['Image'];
+    File?: Window['File'];
+    Blob?: Window['Blob'];
+    ClipboardItem?: DomClipboardItemConstructor;
+    getSelection?: () => Selection | null;
+    createImageBitmap?: Window['createImageBitmap'];
+    matchMedia?: (query: string) => {
+        matches: boolean;
+    };
+};
+export interface ReadBrowserHostDeps {
+    host: BrowserHostSnapshot;
+}
+export declare function readBrowserHostFromGlobalThis(): BrowserHostSnapshot;
+export declare function readBrowserHostDepsFromGlobalThis(): ReadBrowserHostDeps;
+export declare function readOptionalBrowserHostLocalStorage(deps: ReadBrowserHostDeps): Storage | undefined;
+export declare function requireBrowserHostLocalStorage(deps: ReadBrowserHostDeps): Storage;
+export declare function readOptionalBrowserHostSessionStorage(deps: ReadBrowserHostDeps): Storage | undefined;
+export declare function readBrowserHostDocument(deps: ReadBrowserHostDeps): Document | undefined;
+export declare function resolveBrowserHostRandomUUIDFn(deps: ReadBrowserHostDeps): (() => string) | undefined;

package/dist/functions/browser/readBrowserHost.js

@@ -0,0 +1,61 @@
+export function readBrowserHostFromGlobalThis() {
+    if (typeof globalThis === 'undefined')
+        return {};
+    const g = globalThis;
+    const win = g.window ?? g;
+    const timerGlobal = globalThis;
+    const boundSetTimeout = typeof timerGlobal.setTimeout === 'function'
+        ? timerGlobal.setTimeout.bind(timerGlobal)
+        : undefined;
+    const boundClearTimeout = typeof timerGlobal.clearTimeout === 'function'
+        ? timerGlobal.clearTimeout.bind(timerGlobal)
+        : undefined;
+    const boundQueueMicrotask = typeof timerGlobal.queueMicrotask === 'function'
+        ? timerGlobal.queueMicrotask.bind(timerGlobal)
+        : undefined;
+    const resolvedUrl = (typeof g.URL === 'function' ? g.URL : win?.URL);
+    const resolvedFetch = typeof g.fetch === 'function' ? g.fetch : win?.fetch?.bind(win);
+    return {
+        ...g,
+        window: win,
+        location: g.location ?? win?.location,
+        document: g.document ?? win?.document,
+        fetch: resolvedFetch,
+        URL: resolvedUrl,
+        URLConstructor: resolvedUrl,
+        getSelection: (g.getSelection ?? win?.getSelection?.bind(win)),
+        ClipboardItem: g.ClipboardItem,
+        Blob: g.Blob,
+        setTimeout: boundSetTimeout,
+        clearTimeout: boundClearTimeout,
+        queueMicrotask: boundQueueMicrotask,
+        matchMedia: win.matchMedia?.bind(win),
+    };
+}
+export function readBrowserHostDepsFromGlobalThis() {
+    return { host: readBrowserHostFromGlobalThis() };
+}
+export function readOptionalBrowserHostLocalStorage(deps) {
+    return deps.host.localStorage;
+}
+export function requireBrowserHostLocalStorage(deps) {
+    const ls = deps.host.localStorage;
+    if (!ls) {
+        throw new Error('localStorage 不可用');
+    }
+    return ls;
+}
+export function readOptionalBrowserHostSessionStorage(deps) {
+    return deps.host.sessionStorage;
+}
+export function readBrowserHostDocument(deps) {
+    return deps.host.document;
+}
+export function resolveBrowserHostRandomUUIDFn(deps) {
+    const cryptoRef = deps.host.crypto;
+    if (cryptoRef && typeof cryptoRef.randomUUID === 'function') {
+        return () => cryptoRef.randomUUID();
+    }
+    return undefined;
+}
+//# sourceMappingURL=readBrowserHost.js.map

package/dist/functions/browser/readBrowserHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readBrowserHost.js","sourceRoot":"","sources":["../../../src/functions/browser/readBrowserHost.ts"],"names":[],"mappings":"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"}

package/dist/functions/browser/readBrowserImageCompressDeps.d.ts

@@ -1,2 +1,4 @@
 import type { CompressImageFileToBoundedJpegDeps } from '../image/compressImageFileToBoundedJpeg';
+import { type ReadBrowserHostDeps } from './readBrowserHost';
+export declare function readBrowserImageCompressDeps(hostDeps: ReadBrowserHostDeps): CompressImageFileToBoundedJpegDeps;
 export declare function readBrowserImageCompressDepsFromWindow(): CompressImageFileToBoundedJpegDeps;

package/dist/functions/browser/readBrowserImageCompressDeps.js

@@ -1,16 +1,19 @@
-export function readBrowserImageCompressDepsFromWindow() {
-    const win = globalThis;
-    const doc = globalThis
-        .document;
-    if (!win.Image || !win.File || !doc?.createElement || !win.URL?.createObjectURL) {
-        throw new Error('readBrowserImageCompressDepsFromWindow requires browser environment');
+import { readBrowserHostDepsFromGlobalThis, } from './readBrowserHost.js';
+export function readBrowserImageCompressDeps(hostDeps) {
+    const host = hostDeps.host;
+    const doc = host.document;
+    if (!host.Image || !host.File || !doc?.createElement || !host.URL?.createObjectURL) {
+        throw new Error('readBrowserImageCompressDeps requires browser environment');
     }
     return {
-        Image: win.Image,
-        File: win.File,
-        createObjectURL: (blob) => win.URL.createObjectURL(blob),
+        Image: host.Image,
+        File: host.File,
+        createObjectURL: (blob) => host.URL.createObjectURL(blob),
         createElement: doc.createElement,
-        createImageBitmap: win.createImageBitmap,
+        createImageBitmap: host.createImageBitmap,
     };
 }
+export function readBrowserImageCompressDepsFromWindow() {
+    return readBrowserImageCompressDeps(readBrowserHostDepsFromGlobalThis());
+}
 //# sourceMappingURL=readBrowserImageCompressDeps.js.map

package/dist/functions/browser/readBrowserImageCompressDeps.js.map

@@ -1 +1 @@
-{"version":3,"file":"readBrowserImageCompressDeps.js","sourceRoot":"","sources":["../../../src/functions/browser/readBrowserImageCompressDeps.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,sCAAsC;IACpD,MAAM,GAAG,GAAG,UAKX,CAAA;IACD,MAAM,GAAG,GAAI,UAA+G;SACzH,QAAQ,CAAA;IACX,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,aAAa,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,eAAe,EAAE,CAAC;QAChF,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAA;IACxF,CAAC;IACD,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,eAAe,EAAE,CAAC,IAAU,EAAE,EAAE,CAAC,GAAG,CAAC,GAAI,CAAC,eAAe,CAAC,IAAI,CAAC;QAC/D,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;KACzC,CAAA;AACH,CAAC"}
+{"version":3,"file":"readBrowserImageCompressDeps.js","sourceRoot":"","sources":["../../../src/functions/browser/readBrowserImageCompressDeps.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,iCAAiC,GAElC,MAAM,mBAAmB,CAAA;AAG1B,MAAM,UAAU,4BAA4B,CAC1C,QAA6B;IAE7B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAA;IAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAA;IACzB,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,aAAa,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,EAAE,CAAC;QACnF,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;IAC9E,CAAC;IACD,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,eAAe,EAAE,CAAC,IAAU,EAAE,EAAE,CAAC,IAAI,CAAC,GAAI,CAAC,eAAe,CAAC,IAAI,CAAC;QAChE,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;KAC1C,CAAA;AACH,CAAC;AAGD,MAAM,UAAU,sCAAsC;IACpD,OAAO,4BAA4B,CAAC,iCAAiC,EAAE,CAAC,CAAA;AAC1E,CAAC"}

package/dist/functions/browser/readBrowserLassoSelectionEnvironment.d.ts

@@ -0,0 +1,4 @@
+import type { VueCompositionAPI } from '../../../types/vue.d';
+import type { LassoSelectionEnvironment } from '../../vue-hooks/dom/useLassoSelection';
+import { type ReadBrowserHostDeps } from './readBrowserHost';
+export declare function readBrowserLassoSelectionEnvironment(vue: Pick<Required<VueCompositionAPI>, 'ref'>, hostDeps?: ReadBrowserHostDeps): LassoSelectionEnvironment;

package/dist/functions/browser/readBrowserLassoSelectionEnvironment.js

@@ -0,0 +1,23 @@
+import { readBrowserHostDepsFromGlobalThis, } from './readBrowserHost.js';
+export function readBrowserLassoSelectionEnvironment(vue, hostDeps = readBrowserHostDepsFromGlobalThis()) {
+    const host = hostDeps.host;
+    const win = host.window;
+    const doc = host.document;
+    return {
+        vue,
+        window: {
+            addEventListener: win.addEventListener.bind(win),
+            removeEventListener: win.removeEventListener.bind(win),
+            requestAnimationFrame: win.requestAnimationFrame.bind(win),
+            cancelAnimationFrame: win.cancelAnimationFrame.bind(win),
+        },
+        document: {
+            addEventListener: doc.addEventListener.bind(doc),
+            removeEventListener: doc.removeEventListener.bind(doc),
+            body: doc.body,
+            getSelection: host.getSelection,
+        },
+        queueMicrotask: host.queueMicrotask?.bind(host),
+    };
+}
+//# sourceMappingURL=readBrowserLassoSelectionEnvironment.js.map

package/dist/functions/browser/readBrowserLassoSelectionEnvironment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readBrowserLassoSelectionEnvironment.js","sourceRoot":"","sources":["../../../src/functions/browser/readBrowserLassoSelectionEnvironment.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,iCAAiC,GAElC,MAAM,mBAAmB,CAAA;AAG1B,MAAM,UAAU,oCAAoC,CAClD,GAA6C,EAC7C,WAAgC,iCAAiC,EAAE;IAEnE,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAA;IAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,MAAO,CAAA;IACxB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAS,CAAA;IAC1B,OAAO;QACL,GAAG;QACH,MAAM,EAAE;YACN,gBAAgB,EAAE,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC;YAChD,mBAAmB,EAAE,GAAG,CAAC,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC;YACtD,qBAAqB,EAAE,GAAG,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC;YAC1D,oBAAoB,EAAE,GAAG,CAAC,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC;SACzD;QACD,QAAQ,EAAE;YACR,gBAAgB,EAAE,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC;YAChD,mBAAmB,EAAE,GAAG,CAAC,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC;YACtD,IAAI,EAAE,GAAG,CAAC,IAAqD;YAC/D,YAAY,EAAE,IAAI,CAAC,YAAqE;SACzF;QACD,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC;KAChD,CAAA;AACH,CAAC"}

package/dist/functions/browser/readBrowserVueHookDeps.d.ts

@@ -0,0 +1,14 @@
+import type { VueCompositionAPI } from '../../../types/vue.d';
+import type { UseFocusVisibleDeps } from '../../vue-hooks/dom/useFocusVisible';
+import type { UseDelayedTrueDeps } from '../../vue-hooks/time/useDelayedTrue';
+import type { UseFileObjectUrlMapDeps } from '../../vue-hooks/browser/useFileObjectUrlMap';
+import type { UseFileUploadEnvironment } from '../../vue-hooks/browser/useFileUpload';
+import type { DraggableEnvironment } from '../../vue-hooks/dom/useDraggable';
+import type { UseAutoUpdateDeps } from '../../vue-hooks/dom/useAutoUpdate';
+import { type ReadBrowserHostDeps } from './readBrowserHost';
+export declare function readBrowserFocusVisibleDeps(vue: Pick<Required<VueCompositionAPI>, 'ref' | 'onMounted' | 'onUnmounted'>, hostDeps?: ReadBrowserHostDeps): UseFocusVisibleDeps;
+export declare function readBrowserDelayedTrueDeps(vue: Pick<Required<VueCompositionAPI>, 'ref' | 'watch' | 'onUnmounted'>, hostDeps?: ReadBrowserHostDeps): UseDelayedTrueDeps;
+export declare function readBrowserFileObjectUrlMapDeps(vue: Pick<Required<VueCompositionAPI>, 'ref' | 'watch' | 'onBeforeUnmount'>, hostDeps?: ReadBrowserHostDeps): UseFileObjectUrlMapDeps;
+export declare function readBrowserFileUploadDeps(vue: Pick<Required<VueCompositionAPI>, 'ref' | 'shallowRef' | 'onUnmounted'>, hostDeps?: ReadBrowserHostDeps): UseFileUploadEnvironment;
+export declare function readBrowserDraggableDeps(vue: DraggableEnvironment['vue'], hostDeps?: ReadBrowserHostDeps): DraggableEnvironment | undefined;
+export declare function readBrowserAutoUpdateDeps(watchFn: NonNullable<VueCompositionAPI['watch']>, hostDeps?: ReadBrowserHostDeps): UseAutoUpdateDeps;

package/dist/functions/browser/readBrowserVueHookDeps.js

@@ -0,0 +1,85 @@
+import { readBrowserHostDepsFromGlobalThis, } from './readBrowserHost.js';
+function readBrowserDelayedTrueHostDeps(hostDeps) {
+    const host = hostDeps.host;
+    const fallbackSetTimeout = ((fn) => {
+        fn();
+        return 0;
+    });
+    const fallbackClearTimeout = (() => { });
+    return {
+        setTimeout: host.setTimeout ?? fallbackSetTimeout,
+        clearTimeout: host.clearTimeout ?? fallbackClearTimeout,
+    };
+}
+export function readBrowserFocusVisibleDeps(vue, hostDeps = readBrowserHostDepsFromGlobalThis()) {
+    return { vue, document: hostDeps.host.document };
+}
+export function readBrowserDelayedTrueDeps(vue, hostDeps = readBrowserHostDepsFromGlobalThis()) {
+    return {
+        vue,
+        host: readBrowserDelayedTrueHostDeps(hostDeps),
+    };
+}
+export function readBrowserFileObjectUrlMapDeps(vue, hostDeps = readBrowserHostDepsFromGlobalThis()) {
+    const urlApi = hostDeps.host.URL;
+    return {
+        vue,
+        createObjectURL: urlApi
+            ? (file) => urlApi.createObjectURL(file)
+            : undefined,
+        revokeObjectURL: urlApi?.revokeObjectURL.bind(urlApi),
+    };
+}
+function readBrowserUrlHostDeps(hostDeps) {
+    const urlApi = hostDeps.host.URL;
+    const noopCreate = (() => '');
+    const noopRevoke = (() => { });
+    return {
+        createObjectURL: urlApi?.createObjectURL.bind(urlApi) ?? noopCreate,
+        revokeObjectURL: urlApi?.revokeObjectURL.bind(urlApi) ?? noopRevoke,
+    };
+}
+export function readBrowserFileUploadDeps(vue, hostDeps = readBrowserHostDepsFromGlobalThis()) {
+    return {
+        vue,
+        host: readBrowserUrlHostDeps(hostDeps),
+    };
+}
+export function readBrowserDraggableDeps(vue, hostDeps = readBrowserHostDepsFromGlobalThis()) {
+    const doc = hostDeps.host.document;
+    const win = hostDeps.host.window;
+    if (!doc?.addEventListener || !doc.removeEventListener || !doc.body || !win?.requestAnimationFrame) {
+        return undefined;
+    }
+    return {
+        addEventListener: doc.addEventListener.bind(doc),
+        removeEventListener: doc.removeEventListener.bind(doc),
+        body: doc.body,
+        requestAnimationFrame: win.requestAnimationFrame.bind(win),
+        vue,
+    };
+}
+function readBrowserThrottledEventListenerDeps(hostDeps) {
+    const host = hostDeps.host;
+    const win = host.window ?? host;
+    const fallbackSetTimeout = ((fn) => {
+        fn();
+        return 0;
+    });
+    const fallbackClearTimeout = (() => { });
+    const noopListener = (() => { });
+    return {
+        addEventListener: win.addEventListener?.bind(win) ?? noopListener,
+        removeEventListener: win.removeEventListener?.bind(win) ?? noopListener,
+        setTimeout: host.setTimeout ?? fallbackSetTimeout,
+        clearTimeout: host.clearTimeout ?? fallbackClearTimeout,
+        now: Date.now,
+    };
+}
+export function readBrowserAutoUpdateDeps(watchFn, hostDeps = readBrowserHostDepsFromGlobalThis()) {
+    return {
+        watch: watchFn,
+        ...readBrowserThrottledEventListenerDeps(hostDeps),
+    };
+}
+//# sourceMappingURL=readBrowserVueHookDeps.js.map

package/dist/functions/browser/readBrowserVueHookDeps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readBrowserVueHookDeps.js","sourceRoot":"","sources":["../../../src/functions/browser/readBrowserVueHookDeps.ts"],"names":[],"mappings":"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"}

package/dist/functions/browser/requireBrowserLocalStorage.d.ts

@@ -1,2 +1,3 @@
 import type { Storage } from '../../../references/storage.d';
-export declare function requireBrowserLocalStorage(): Storage;
+import { type ReadBrowserHostDeps } from './readBrowserHost';
+export declare function requireBrowserLocalStorage(deps?: ReadBrowserHostDeps): Storage;

package/dist/functions/browser/requireBrowserLocalStorage.js

@@ -1,8 +1,5 @@
-export function requireBrowserLocalStorage() {
-    const ls = globalThis.localStorage;
-    if (!ls) {
-        throw new Error('localStorage 不可用');
-    }
-    return ls;
+import { readBrowserHostDepsFromGlobalThis, requireBrowserHostLocalStorage, } from './readBrowserHost.js';
+export function requireBrowserLocalStorage(deps = readBrowserHostDepsFromGlobalThis()) {
+    return requireBrowserHostLocalStorage(deps);
 }
 //# sourceMappingURL=requireBrowserLocalStorage.js.map

package/dist/functions/browser/requireBrowserLocalStorage.js.map

@@ -1 +1 @@
-{"version":3,"file":"requireBrowserLocalStorage.js","sourceRoot":"","sources":["../../../src/functions/browser/requireBrowserLocalStorage.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,0BAA0B;IACxC,MAAM,EAAE,GAAI,UAAyC,CAAC,YAAY,CAAA;IAClE,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAA;IACrC,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC"}
+{"version":3,"file":"requireBrowserLocalStorage.js","sourceRoot":"","sources":["../../../src/functions/browser/requireBrowserLocalStorage.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iCAAiC,EACjC,8BAA8B,GAE/B,MAAM,mBAAmB,CAAA;AAG1B,MAAM,UAAU,0BAA0B,CACxC,OAA4B,iCAAiC,EAAE;IAE/D,OAAO,8BAA8B,CAAC,IAAI,CAAC,CAAA;AAC7C,CAAC"}

package/dist/functions/chat/chatAppearancePrefs.d.ts

@@ -3,6 +3,11 @@ export declare const CHAT_APPEARANCE_MODE_STORAGE_KEY = "chat.appearance.mode.v1
 export declare const CHAT_APPEARANCE_MODE_LABELS: Record<ChatAppearanceMode, string>;
 export declare function isChatAppearanceMode(v: string): v is ChatAppearanceMode;
 export declare function parseChatAppearanceModeFromStorage(raw: string | null | undefined): ChatAppearanceMode;
-export declare function readSystemPrefersDark(): boolean;
+export interface ReadSystemPrefersDarkDeps {
+    matchMedia?: (query: string) => {
+        matches: boolean;
+    };
+}
+export declare function readSystemPrefersDark(deps?: ReadSystemPrefersDarkDeps): boolean;
 export declare function resolveChatEffectiveTheme(mode: ChatAppearanceMode): 'light' | 'dark';
 export declare function chatAppearanceModeSubtitle(mode: ChatAppearanceMode): string;

package/dist/functions/chat/chatAppearancePrefs.js

@@ -1,3 +1,4 @@
+import { readBrowserHostDepsFromGlobalThis, } from '../browser/readBrowserHost.js';
 export const CHAT_APPEARANCE_MODE_STORAGE_KEY = 'chat.appearance.mode.v1';
 export const CHAT_APPEARANCE_MODE_LABELS = {
     light: '浅色',
@@ -12,11 +13,12 @@ export function parseChatAppearanceModeFromStorage(raw) {
     const trimmed = raw?.trim();
     return trimmed && isChatAppearanceMode(trimmed) ? trimmed : 'system';
 }
-export function readSystemPrefersDark() {
-    const w = globalThis;
-    if (!w.matchMedia)
+export function readSystemPrefersDark(deps) {
+    const matchMedia = deps?.matchMedia ??
+        readBrowserHostDepsFromGlobalThis().host.matchMedia;
+    if (!matchMedia)
         return false;
-    return w.matchMedia('(prefers-color-scheme: dark)').matches;
+    return matchMedia('(prefers-color-scheme: dark)').matches;
 }
 export function resolveChatEffectiveTheme(mode) {
     if (mode === 'dark')

package/dist/functions/chat/chatAppearancePrefs.js.map

@@ -1 +1 @@
-{"version":3,"file":"chatAppearancePrefs.js","sourceRoot":"","sources":["../../../src/functions/chat/chatAppearancePrefs.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gCAAgC,GAAG,yBAAyB,CAAA;AAEzE,MAAM,CAAC,MAAM,2BAA2B,GAAuC;IAC7E,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,IAAI;CACb,CAAA;AAED,MAAM,KAAK,GAAkC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;AAExE,MAAM,UAAU,oBAAoB,CAAC,CAAS;IAC5C,OAAQ,KAA2B,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;AACjD,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,GAA8B;IAE9B,MAAM,OAAO,GAAG,GAAG,EAAE,IAAI,EAAE,CAAA;IAC3B,OAAO,OAAO,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAA;AACtE,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,MAAM,CAAC,GAAG,UAA6E,CAAA;IACvF,IAAI,CAAC,CAAC,CAAC,UAAU;QAAE,OAAO,KAAK,CAAA;IAC/B,OAAO,CAAC,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC,OAAO,CAAA;AAC7D,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAwB;IAChE,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,MAAM,CAAA;IAClC,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,OAAO,CAAA;IACpC,OAAO,qBAAqB,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAwB;IACjE,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAA;AAC1C,CAAC"}
+{"version":3,"file":"chatAppearancePrefs.js","sourceRoot":"","sources":["../../../src/functions/chat/chatAppearancePrefs.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iCAAiC,GAElC,MAAM,4BAA4B,CAAA;AAEnC,MAAM,CAAC,MAAM,gCAAgC,GAAG,yBAAyB,CAAA;AAEzE,MAAM,CAAC,MAAM,2BAA2B,GAAuC;IAC7E,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,IAAI;CACb,CAAA;AAED,MAAM,KAAK,GAAkC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;AAExE,MAAM,UAAU,oBAAoB,CAAC,CAAS;IAC5C,OAAQ,KAA2B,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;AACjD,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,GAA8B;IAE9B,MAAM,OAAO,GAAG,GAAG,EAAE,IAAI,EAAE,CAAA;IAC3B,OAAO,OAAO,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAA;AACtE,CAAC;AAMD,MAAM,UAAU,qBAAqB,CACnC,IAAgC;IAEhC,MAAM,UAAU,GACd,IAAI,EAAE,UAAU;QAChB,iCAAiC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAA;IACrD,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAA;IAC7B,OAAO,UAAU,CAAC,8BAA8B,CAAC,CAAC,OAAO,CAAA;AAC3D,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAwB;IAChE,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,MAAM,CAAA;IAClC,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,OAAO,CAAA;IACpC,OAAO,qBAAqB,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAwB;IACjE,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAA;AAC1C,CAAC"}

package/dist/functions/chat/createBrowserChatAppearanceModeAccess.d.ts

@@ -1,5 +1,6 @@
 import type { ChatAppearanceMode } from '../../../types/chat-appearance';
-export declare function createBrowserChatAppearanceModeAccess(): {
+import { type ReadBrowserHostDeps } from '../browser/readBrowserHost';
+export declare function createBrowserChatAppearanceModeAccess(hostDeps?: ReadBrowserHostDeps): {
     read(): ChatAppearanceMode;
     write(mode: ChatAppearanceMode): void;
 };