@woosau/dsh-custom-env 0.1.0 → 0.1.4

package/lib/types/os-user-env/windows.d.ts

@@ -5,6 +5,7 @@
 /** Win32 registry and broadcast calls used to publish user environment values. */
 export interface WindowsUserEnvBindings {
     readonly openKey: (hKey: number, subKey: string, options: number, samDesired: number, result: [unknown]) => number;
+    readonly queryValue: (hKey: unknown, valueName: string, reserved: unknown, type: [number] | null, data: Buffer | null, cbData: [number]) => number;
     readonly setValue: (hKey: unknown, valueName: string, reserved: number, type: number, data: Buffer, cbData: number) => number;
     readonly deleteValue: (hKey: unknown, valueName: string) => number;
     readonly closeKey: (hKey: unknown) => number;
@@ -21,13 +22,27 @@ export declare function setWindowsUserEnvBindingsForTests(next: WindowsUserEnvBi
  * @returns Buffer accepted by RegSetValueExW.
  */
 export declare function encodeRegSz(value: string): Buffer;
+/**
+ * Whether `name` exists under HKCU\\Environment (value may be empty).
+ * @param name - Variable name.
+ * @param platform - Override for tests; defaults to `process.platform`.
+ * @returns true when the value name is present.
+ */
+export declare function hasWindowsUserEnv(name: string, platform?: NodeJS.Platform): boolean;
 /**
  * Write entries into HKCU\\Environment and broadcast WM_SETTINGCHANGE.
  * No-op on non-Windows hosts or when `entries` is empty.
  * @param entries - Variable map to persist.
  * @param platform - Override for tests; defaults to `process.platform`.
  */
-export declare function persistWindowsUserEnv(entries: Readonly<Record<string, string>>, platform?: NodeJS.Platform): void;
+export declare function writeWindowsUserEnv(entries: Readonly<Record<string, string>>, platform?: NodeJS.Platform): void;
+/**
+ * Delete many user environment values from HKCU\\Environment in one open/broadcast.
+ * Missing values are ignored.
+ * @param names - Variable names to remove.
+ * @param platform - Override for tests; defaults to `process.platform`.
+ */
+export declare function removeWindowsUserEnvs(names: readonly string[], platform?: NodeJS.Platform): void;
 /**
  * Delete one user environment value from HKCU\\Environment.
  * Missing values are ignored.

package/lib/types/types.d.ts

@@ -21,6 +21,11 @@ export interface EnvSnapshot {
     readonly exists: boolean;
     readonly entries: readonly EnvEntry[];
 }
+/** One name/value pair for plugin-facing `setVar` / `setVars`. */
+export interface EnvVarWrite {
+    readonly name: string;
+    readonly value: string;
+}
 /** Snapshot returned by `customEnv/cliStatus` and `cliInstall`. */
 export interface CliStatus {
     readonly platform: string;

package/locale/en.json

@@ -1,4 +1,4 @@
 {
   "meta.title": "Environment variables",
-  "meta.description": "Edit $DSH_HOME/.env, sync Host/OS user environment, and install the dsh CLI for this Host on Windows/macOS."
+  "meta.description": "Edit $DSH_HOME/.env and sync the Host / OS user environment."
 }

package/locale/zh.json

@@ -1,4 +1,4 @@
 {
   "meta.title": "环境变量",
-  "meta.description": "编辑 $DSH_HOME/.env，同步 Host/操作系统用户环境，并在 Windows/macOS 为本 Host 安装 dsh CLI。"
+  "meta.description": "编辑 $DSH_HOME/.env，并同步 Host / 操作系统用户环境。"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@woosau/dsh-custom-env",
-  "description": "DSH plugin: manage $DSH_HOME/.env from Settings, sync Host process.env and Windows/macOS user environment",
-  "version": "0.1.0",
+  "description": "DSH plugin: manage $DSH_HOME/.env from Settings",
+  "version": "0.1.4",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",