os-user-dirs 2.4.0 → 2.5.0

package/README.md

@@ -66,6 +66,22 @@ getBasePath("config");
 //=> '/home/user/.config'
 ```
 
+#### System search directories
+
+```javascript
+import { configDirs, dataDirs } from "os-user-dirs";
+
+configDirs();
+//=> ['/etc/xdg'] (Linux)
+//=> ['/Library/Application Support', '/Library/Preferences'] (macOS)
+//=> ['C:\\ProgramData'] (Windows)
+
+dataDirs();
+//=> ['/usr/local/share', '/usr/share'] (Linux)
+//=> ['/Library/Application Support'] (macOS)
+//=> ['C:\\ProgramData'] (Windows)
+```
+
 #### Project directories
 
 ```javascript
@@ -172,6 +188,14 @@ Returns the path to the runtime directory (`$XDG_RUNTIME_DIR` on Linux), or `nul
 #### `getBasePath(name)`
 Returns the path to the specified base directory. Valid names: `config`, `data`, `cache`, `state`, `log`, `runtime`.
 
+### System Search Directories
+
+#### `configDirs()`
+Returns the system config directory search path list (`string[]`). On Linux, reads `$XDG_CONFIG_DIRS` (default: `["/etc/xdg"]`). On macOS: `["/Library/Application Support", "/Library/Preferences"]`. On Windows: `[%PROGRAMDATA%]`.
+
+#### `dataDirs()`
+Returns the system data directory search path list (`string[]`). On Linux, reads `$XDG_DATA_DIRS` (default: `["/usr/local/share", "/usr/share"]`). On macOS: `["/Library/Application Support"]`. On Windows: `[%PROGRAMDATA%]`.
+
 ### Project Directories
 
 #### `projectDirs(name, options?)`

package/index.d.ts

@@ -47,6 +47,22 @@ export function logDir(): string;
 /** Returns the path to the XDG runtime directory, or null if unavailable. */
 export function runtimeDir(): string | null;
 
+/**
+ * Returns the system config directory search path list.
+ * On Linux, reads `$XDG_CONFIG_DIRS` (default: `["/etc/xdg"]`).
+ * On macOS: `["/Library/Application Support", "/Library/Preferences"]`.
+ * On Windows: `[%PROGRAMDATA%]`.
+ */
+export function configDirs(): string[];
+
+/**
+ * Returns the system data directory search path list.
+ * On Linux, reads `$XDG_DATA_DIRS` (default: `["/usr/local/share", "/usr/share"]`).
+ * On macOS: `["/Library/Application Support"]`.
+ * On Windows: `[%PROGRAMDATA%]`.
+ */
+export function dataDirs(): string[];
+
 /** Returns the path to the specified base directory. */
 export function getBasePath(name: "config"): string;
 export function getBasePath(name: "data"): string;
@@ -108,6 +124,8 @@ declare const osUserDirs: typeof downloads & {
     logDir: typeof logDir;
     runtimeDir: typeof runtimeDir;
     getBasePath: typeof getBasePath;
+    configDirs: typeof configDirs;
+    dataDirs: typeof dataDirs;
     projectDirs: typeof projectDirs;
     getXDGUserDir: typeof getXDGUserDir;
     getXDGDownloadDir: typeof getXDGDownloadDir;

package/index.js

@@ -144,6 +144,59 @@ function stateDir() { return resolveBase("state"); }
 function logDir() { return resolveBase("log"); }
 function runtimeDir() { return resolveBase("runtime"); }
 
+const SEARCH_DIRS_CONFIG = {
+    config: {
+        env: "XDG_CONFIG_DIRS",
+        linux: ["/etc/xdg"],
+        darwin: ["/Library/Application Support", "/Library/Preferences"],
+        win32: "PROGRAMDATA",
+    },
+    data: {
+        env: "XDG_DATA_DIRS",
+        linux: ["/usr/local/share", "/usr/share"],
+        darwin: ["/Library/Application Support"],
+        win32: "PROGRAMDATA",
+    },
+};
+
+function resolveSearchDirs(name) {
+    const cfg = SEARCH_DIRS_CONFIG[name];
+    if (!cfg) {
+        throw new Error("Unknown search directory: " + name + ". Valid names: " + Object.keys(SEARCH_DIRS_CONFIG).join(", "));
+    }
+
+    const platform = process.platform;
+
+    if (platform === "linux") {
+        const envVal = process.env[cfg.env];
+        if (envVal) {
+            const dirs = envVal.split(":").filter(Boolean);
+            if (dirs.length > 0) {
+                return dirs.map(function (d) { return path.resolve(d); });
+            }
+        }
+        return cfg.linux.slice();
+    }
+
+    if (platform === "darwin") {
+        return cfg.darwin.slice();
+    }
+
+    if (platform === "win32") {
+        const winVal = process.env[cfg.win32];
+        if (winVal) {
+            return [path.resolve(winVal)];
+        }
+        return [path.join(process.env.SYSTEMDRIVE || "C:", "ProgramData")];
+    }
+
+    // Unknown platform: use Linux defaults
+    return cfg.linux.slice();
+}
+
+function configDirs() { return resolveSearchDirs("config"); }
+function dataDirs() { return resolveSearchDirs("data"); }
+
 function getBasePath(name) {
     return resolveBase(name);
 }
@@ -226,6 +279,8 @@ module.exports.stateDir = stateDir;
 module.exports.logDir = logDir;
 module.exports.runtimeDir = runtimeDir;
 module.exports.getBasePath = getBasePath;
+module.exports.configDirs = configDirs;
+module.exports.dataDirs = dataDirs;
 module.exports.projectDirs = projectDirs;
 module.exports.getXDGUserDir = getXDGUserDir;
 

package/index.mjs

@@ -17,6 +17,8 @@ export const stateDir = osUserDirs.stateDir;
 export const logDir = osUserDirs.logDir;
 export const runtimeDir = osUserDirs.runtimeDir;
 export const getBasePath = osUserDirs.getBasePath;
+export const configDirs = osUserDirs.configDirs;
+export const dataDirs = osUserDirs.dataDirs;
 export const projectDirs = osUserDirs.projectDirs;
 export const getXDGUserDir = osUserDirs.getXDGUserDir;
 export const getXDGDownloadDir = osUserDirs.getXDGDownloadDir;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "os-user-dirs",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Get OS-specific user directories and XDG base directories (config, data, cache, runtime) with zero dependencies.",
   "main": "index.js",
   "types": "index.d.ts",