@wisdomgarden/cloak-plugin-darkmode 0.0.1

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright (c) 2014 WisdomGarden
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README-EN.md

@@ -0,0 +1,95 @@
+[**English Version**](./README-EN.md) | [中文版](./README.md)
+
+# DarkMode Plugin
+
+Detect and monitor dark mode changes on HarmonyOS.
+
+---
+
+## Installation
+
+```bash
+ohpm install @wisdomgarden/cloak-plugin-darkmode
+```
+
+---
+
+## Usage
+
+### Native Side
+
+Modify `EntryAbility.ets`:
+
+```typescript
+import { CloakPluginDarkMode } from '@wisdomgarden/cloak-plugin-darkmode';
+import { Configuration } from '@kit.AbilityKit';
+
+const darkModePlugin = new CloakPluginDarkMode();
+
+onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
+  const cloak = new Cloak(this);
+  cloak.addPlugins([
+    // ... other plugins
+    darkModePlugin
+  ]);
+}
+
+onConfigurationUpdate(newConfig: Configuration): void {
+  darkModePlugin.onConfigurationUpdate(newConfig);
+}
+```
+
+### Frontend Side
+
+```typescript
+// Get current dark mode state
+const { isDarkModeOn } = await window.Cloak.plugins.DarkMode.isDarkMode();
+
+// Listen for dark mode changes
+const handlerId = window.Cloak.plugins.DarkMode.addEventListener('darkModeChange', (event) => {
+  console.log(event.isDarkModeOn);
+});
+
+// Remove listener
+window.Cloak.plugins.DarkMode.removeEventListener('darkModeChange', handlerId);
+```
+
+---
+
+## API
+
+### `isDarkMode()`
+
+Get the current dark mode state.
+
+**Returns**: `Promise<DarkModeResult>`
+
+#### `DarkModeResult`
+
+| Field | Type | Description |
+|---|---|---|
+| `isDarkModeOn` | `boolean` | `true` means dark mode is on |
+
+---
+
+### `addEventListener(event, handler)`
+
+Listen for dark mode changes.
+
+| Parameter | Type | Description |
+|---|---|---|
+| `event` | `'darkModeChange'` | Event name |
+| `handler` | `(event: DarkModeResult) => void` | Callback function |
+
+**Returns**: `string` handlerId, used to remove the listener.
+
+---
+
+### `removeEventListener(event, handlerId?)`
+
+Remove a listener.
+
+| Parameter | Type | Description |
+|---|---|---|
+| `event` | `'darkModeChange'` | Event name |
+| `handlerId` | `string?` | If not provided, all listeners for the event will be removed |

package/README.md

@@ -0,0 +1,95 @@
+[**中文版**](./README.md) | [English Version](./README-EN.md) 
+
+# DarkMode 插件
+
+用于检测和监听 HarmonyOS 暗黑模式变化。
+
+---
+
+## 安装
+
+```bash
+ohpm install @wisdomgarden/cloak-plugin-darkmode
+```
+
+---
+
+## 使用方法
+
+### 原生侧
+
+修改 `EntryAbility.ets`：
+
+```typescript
+import { CloakPluginDarkMode } from '@wisdomgarden/cloak-plugin-darkmode';
+import { Configuration } from '@kit.AbilityKit';
+
+const darkModePlugin = new CloakPluginDarkMode();
+
+onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
+  const cloak = new Cloak(this);
+  cloak.addPlugins([
+    // ... 其他插件
+    darkModePlugin
+  ]);
+}
+
+onConfigurationUpdate(newConfig: Configuration): void {
+  darkModePlugin.onConfigurationUpdate(newConfig);
+}
+```
+
+### 前端侧
+
+```typescript
+// 获取当前暗黑模式状态
+const { isDarkModeOn } = await window.Cloak.plugins.DarkMode.isDarkMode();
+
+// 监听暗黑模式变化
+const handlerId = window.Cloak.plugins.DarkMode.addEventListener('darkModeChange', (event) => {
+  console.log(event.isDarkModeOn);
+});
+
+// 移除监听
+window.Cloak.plugins.DarkMode.removeEventListener('darkModeChange', handlerId);
+```
+
+---
+
+## API
+
+### `isDarkMode()`
+
+获取当前暗黑模式状态。
+
+**返回值**：`Promise<DarkModeResult>`
+
+#### `DarkModeResult`
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `isDarkModeOn` | `boolean` | `true` 表示当前为暗黑模式 |
+
+---
+
+### `addEventListener(event, handler)`
+
+监听暗黑模式变化。
+
+| 参数 | 类型 | 说明 |
+|---|---|---|
+| `event` | `'darkModeChange'` | 事件名 |
+| `handler` | `(event: DarkModeResult) => void` | 回调函数 |
+
+**返回值**：`string` handlerId，用于移除监听。
+
+---
+
+### `removeEventListener(event, handlerId?)`
+
+移除监听。
+
+| 参数 | 类型 | 说明 |
+|---|---|---|
+| `event` | `'darkModeChange'` | 事件名 |
+| `handlerId` | `string?` | 不传则移除该事件所有监听 |

package/index.d.ts

@@ -0,0 +1,25 @@
+import { Plugin } from "@wisdomgarden/cloak";
+
+export interface DarkModeResult {
+  isDarkModeOn: boolean;
+}
+
+export type DarkModeEventMap = {
+  darkModeChange: DarkModeResult;
+}
+
+export interface DarkModePlugin extends Plugin {
+  isDarkMode(): Promise<DarkModeResult>;
+  addEventListener<K extends keyof DarkModeEventMap>(
+    event: K,
+    handler: (event: DarkModeEventMap[K]) => void
+  ): string;
+  removeEventListener(event: string, handlerId?: string): void;
+  clearAllEvents(): void;
+}
+
+declare module "@wisdomgarden/cloak" {
+  export interface CloakPlugins {
+    DarkMode: DarkModePlugin;
+  }
+}

package/index.mjs

@@ -0,0 +1,22 @@
+let PluginInstance = null;
+const PluginName = 'Http'
+const register = (plugin) => {
+  if (plugin.registered) {
+    return;
+  }
+  plugin.registered = true;
+  PluginInstance = plugin;
+};
+
+(() => {
+  window.__CloakPluginsRegister = window.__CloakPluginsRegister || {};
+  window.__CloakPluginsRegister[PluginName] = register;
+  if (Cloak && Cloak.plugins && Cloak.plugins[PluginName]) {
+    register(Cloak.plugins[PluginName]);
+  }
+})();
+
+export {
+  register,
+  PluginInstance as Http
+};

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@wisdomgarden/cloak-plugin-darkmode",
+  "version": "0.0.1",
+  "description": "Dark mode detection and monitoring plugin for Cloak applications.",
+  "author": "WisdomGarden",
+  "repository": "https://github.com/WisdomGardenInc/CloakPlugins/tree/master/plugins/CloakPluginDarkMode",
+  "homepage": "https://tronclass.com.cn/",
+  "license": "Apache-2.0",
+  "main": "index.mjs",
+  "module": "index.mjs",
+  "type": "module",
+  "scripts": {
+    "prepack": "cp ../../README*.md . && cp ../../LICENSE ."
+  },
+  "keywords": [
+    "Cloak",
+    "CloakPlugin",
+    "HarmonyOS",
+    "Cordova",
+    "Capacitor",
+    "Hybrid",
+    "H5",
+    "darkmode",
+    "dark-mode"
+  ]
+}