@arbor-css/util 0.0.102 → 0.0.104

package/dist/configLoader.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The filenames Arbor recognises as config entry points, in search priority order.
+ */
+export declare const CONFIG_FILE_NAMES: readonly ["arbor.config.ts", "arbor.config.js", "arbor.config.mjs"];
+export type ConfigFileName = (typeof CONFIG_FILE_NAMES)[number];
+/**
+ * A minimal subset of the jiti `Jiti` interface that `loadConfigWithDeps`
+ * requires. Typed this way so that callers can pass either
+ * `createJiti(…)` or `createJiti` from `'jiti/static'` — both satisfy it.
+ */
+export interface JitiLike {
+    /** The module cache populated by jiti during require/import calls. */
+    cache: Record<string, unknown>;
+    import<T = unknown>(id: string, opts?: unknown): Promise<T>;
+}
+/**
+ * The result of a successful config load.
+ */
+export interface LoadedConfigWithDeps<TPreset> {
+    /** Absolute path to the config entry-point file. */
+    configPath: string;
+    /** The default export from the config file (expected to be an ArborPreset). */
+    preset: TPreset;
+    /**
+     * All local (non-node_modules) files that were transitively imported while
+     * loading the config, including the config file itself.
+     * Use this list to set up file-watchers or PostCSS dependency messages so
+     * that changes to any imported module trigger a reload.
+     */
+    dependencies: string[];
+}
+/**
+ * Load an Arbor config file via a provided jiti instance and collect every
+ * local module that was transitively imported during the load.
+ *
+ * @param configPath - Absolute path to the config entry-point.
+ * @param jiti       - A pre-created jiti instance (caller supplies the
+ *                     appropriate variant: `jiti` or `jiti/static`).
+ *
+ * @returns The loaded preset and the full dependency set, or `null` if loading fails.
+ */
+export declare function loadConfigWithDeps<TPreset = unknown>(configPath: string, jiti: JitiLike): Promise<LoadedConfigWithDeps<TPreset> | null>;
+/**
+ * Search *only* inside `dir` (no upward traversal) for an Arbor config file.
+ * Returns the absolute path to the first match, or `null` if none is found.
+ *
+ * Used by the PostCSS plugin which is anchored to the build's `cwd`.
+ */
+export declare function findConfigInDir(dir: string): Promise<string | null>;
+//# sourceMappingURL=configLoader.d.ts.map

package/dist/configLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configLoader.d.ts","sourceRoot":"","sources":["../src/configLoader.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,eAAO,MAAM,iBAAiB,qEAIpB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACxB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC5D;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,OAAO;IAC5C,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,MAAM,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;CACvB;AAgCD;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,GAAG,OAAO,EACzD,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,QAAQ,GACZ,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAkC/C;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWzE"}

package/dist/configLoader.js

@@ -0,0 +1,100 @@
+import { access } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * The filenames Arbor recognises as config entry points, in search priority order.
+ */
+export const CONFIG_FILE_NAMES = [
+    'arbor.config.ts',
+    'arbor.config.js',
+    'arbor.config.mjs',
+];
+/**
+ * Convert a `file://…` URL or an absolute path to a normalised absolute
+ * filesystem path.  Returns `null` for non-filesystem identifiers (e.g. bare
+ * module specifiers, data: URLs).
+ */
+function toFsPath(id) {
+    try {
+        if (id.startsWith('file://')) {
+            return fileURLToPath(id);
+        }
+        // jiti also stores plain paths in some environments.
+        // it seems that it also uses forward slashes in Windows...
+        // stuff like '/home/user/...' and 'c:/users/...' shows up.
+        if (id.startsWith('/') || /^[A-Za-z]:[\\/]/.test(id)) {
+            return id;
+        }
+    }
+    catch {
+        // ignore malformed URLs
+    }
+    return null;
+}
+/**
+ * Returns true for paths that live inside a `node_modules` directory.
+ * We only want to watch first-party source files.
+ */
+function isNodeModule(fsPath) {
+    return fsPath.includes('node_modules');
+}
+/**
+ * Load an Arbor config file via a provided jiti instance and collect every
+ * local module that was transitively imported during the load.
+ *
+ * @param configPath - Absolute path to the config entry-point.
+ * @param jiti       - A pre-created jiti instance (caller supplies the
+ *                     appropriate variant: `jiti` or `jiti/static`).
+ *
+ * @returns The loaded preset and the full dependency set, or `null` if loading fails.
+ */
+export async function loadConfigWithDeps(configPath, jiti) {
+    // Snapshot the keys already in jiti's cache so we can diff afterwards.
+    // We need moduleCache *enabled* during the load so that jiti populates
+    // cache as it resolves transitive imports — that's how we discover deps.
+    const cacheKeysBefore = new Set(Object.keys(jiti.cache));
+    const mod = await jiti.import(configPath);
+    const preset = (mod?.default ?? mod);
+    // Collect all cache keys that appeared during this load, then immediately
+    // evict them so the next reload re-evaluates every module from scratch
+    // (equivalent to moduleCache: false, but compatible with dep tracking).
+    const newKeys = Object.keys(jiti.cache).filter((k) => !cacheKeysBefore.has(k));
+    for (const key of newKeys) {
+        delete jiti.cache[key];
+    }
+    const dependencies = [];
+    for (const key of newKeys) {
+        const fsPath = toFsPath(key);
+        if (!fsPath)
+            continue;
+        if (isNodeModule(fsPath))
+            continue;
+        dependencies.push(fsPath);
+    }
+    // Always include the entry point itself — jiti may not cache it under the
+    // exact same string we passed (e.g. file:// URL vs plain path).
+    if (!dependencies.includes(configPath)) {
+        dependencies.unshift(configPath);
+    }
+    return { configPath, preset, dependencies };
+}
+/**
+ * Search *only* inside `dir` (no upward traversal) for an Arbor config file.
+ * Returns the absolute path to the first match, or `null` if none is found.
+ *
+ * Used by the PostCSS plugin which is anchored to the build's `cwd`.
+ */
+export async function findConfigInDir(dir) {
+    for (const candidate of CONFIG_FILE_NAMES) {
+        const resolvedPath = resolve(dir, candidate);
+        try {
+            await access(resolvedPath);
+            return resolvedPath;
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=configLoader.js.map

package/dist/configLoader.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbor-css/util",
-  "version": "0.0.102",
+  "version": "0.0.104",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -17,10 +17,17 @@
       "node": "./dist/index.js",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./config-loader": {
+      "import": "./dist/configLoader.js",
+      "node": "./dist/configLoader.js",
+      "types": "./dist/configLoader.d.ts",
+      "default": "./dist/configLoader.js"
     }
   },
   "sideEffects": false,
   "devDependencies": {
+    "@types/node": "^25.9.1",
     "typescript": "^6.0.3"
   },
   "dependencies": {},