yamllint-js 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.2.3](https://github.com/kimzuni-labs/yamllint-js/compare/v0.2.2...v0.2.3) (2026-02-19)
+
+
+### ✨ Features
+
+* support options on loadYamlLintConfig ([9f67bea](https://github.com/kimzuni-labs/yamllint-js/commit/9f67beab94698b64c1b09c332a246d4099ff0cbc))
+
+
+### 🐛 Bug Fixes
+
+* stopDir option on loadConfigFile ([9f67bea](https://github.com/kimzuni-labs/yamllint-js/commit/9f67beab94698b64c1b09c332a246d4099ff0cbc))
+* throw on failure in loadConfigFile ([9f67bea](https://github.com/kimzuni-labs/yamllint-js/commit/9f67beab94698b64c1b09c332a246d4099ff0cbc))
+
 ## [0.2.2](https://github.com/kimzuni-labs/yamllint-js/compare/v0.2.1...v0.2.2) (2026-02-19)
 
 

package/dist/config.d.mts

@@ -70,7 +70,15 @@ declare class YamlLintConfig {
   extend(baseConfig: unknown): void;
 }
 interface LoadConfigFileOptions {
+  /**
+   * @default process.cwd()
+   */
   startDir?: string;
+  /**
+   * @default getHomedir()
+   *
+   * @see {@link getHomedir}
+   */
   stopDir?: string;
 }
 /**
@@ -81,6 +89,7 @@ interface LoadConfigFileOptions {
  * ```typescript
  * const autoDetected = await loadConfigFile();
  * const specified = await loadConfigFile("path/to/yamllint.yaml");
+ * const withOptions = await loadConfigFile({ startDir, stopDir });
  * ```
  */
 declare const loadConfigFile: (filepath?: string | LoadConfigFileOptions) => Promise<unknown>;
@@ -96,8 +105,12 @@ declare const loadConfigFile: (filepath?: string | LoadConfigFileOptions) => Pro
 declare function detectUserGlobalConfig(): Promise<string | undefined>;
 /**
  * Load and return a fully resolved YamlLint configuration instance.
+ *
+ * - First, try to load config file from the current directory to user home directory.
+ * - If not found, try to load from the user global config file.
+ * - If not found, try to load from the default config.
  */
-declare function loadYamlLintConfig(): Promise<YamlLintConfig>;
+declare function loadYamlLintConfig(options?: LoadConfigFileOptions): Promise<YamlLintConfig>;
 /**
  * if value is {@link AllLevel} or undefined
  * then convert to {@link Level} (undefined -> "error"),

package/dist/config.mjs

@@ -166,7 +166,6 @@ async function validateRuleConf(rule, config) {
 }
 const loadConfigFile = (() => {
 	const jsReg = /\.[cm]?js$/;
-	const homeDir = getHomedir();
 	const filenames = [
 		"package.json",
 		...getNodeSearchPlaces(COMMAND_NAMES),
@@ -178,10 +177,11 @@ const loadConfigFile = (() => {
 			const filename = path.basename(filepath);
 			if (jsReg.test(filepath) || filepath.endsWith(".ts")) {
 				const jiti = createJiti(import.meta.url);
-				if (await fs.stat(filepath).then((x) => x.size).catch(() => 0) < 1) throw new Error();
-				const mod = await jiti.import(filepath, { default: true });
-				const value = mod.default ?? mod;
-				if (typeof value === "object" && value !== null) return value;
+				if (await fs.stat(filepath).then((x) => x.size).catch(() => 0) > 0) {
+					const mod = await jiti.import(filepath, { default: true });
+					const value = mod.default ?? mod;
+					if (typeof value === "object" && value !== null) return value;
+				}
 			} else if (filename === "package.json") {
 				const content = autoDecode(await fs.readFile(filepath));
 				const pkg = JSON.parse(content);
@@ -194,14 +194,15 @@ const loadConfigFile = (() => {
 				const content = autoDecode(await fs.readFile(filepath));
 				return yaml.parse(content, YAML_OPTIONS);
 			}
+			throw new Error();
 		} catch {
 			if (throwOnFailure) throw new YamlLintConfigError(`failed to load config file "${filepath}"`);
-			return;
 		}
 	};
 	return async function loadConfigFile(filepath) {
 		if (typeof filepath === "string") return loadFile(filepath, true);
-		const { startDir = process.cwd(), stopDir } = filepath ?? {};
+		const startDir = filepath?.startDir ?? process.cwd();
+		const stopDir = filepath?.stopDir === void 0 ? getHomedir() : path.resolve(filepath.stopDir);
 		let currDir = path.resolve(startDir);
 		do {
 			for (const filename of filenames) {
@@ -212,7 +213,7 @@ const loadConfigFile = (() => {
 				}
 			}
 			currDir = path.dirname(currDir);
-		} while (currDir !== stopDir && currDir !== homeDir && currDir !== path.dirname(currDir));
+		} while (currDir !== stopDir && currDir !== path.dirname(currDir));
 	};
 })();
 async function detectUserGlobalConfig() {
@@ -222,11 +223,11 @@ async function detectUserGlobalConfig() {
 	else userGlobalConfig = path.join(getHomedir(), ".config", "yamllint", "config");
 	return await fs.stat(userGlobalConfig).then((x) => x.isFile()).catch(() => false) ? userGlobalConfig : void 0;
 }
-async function loadYamlLintConfig() {
+async function loadYamlLintConfig(options) {
 	let userGlobalConfig;
 	let load;
 	let conf;
-	if (load = await loadConfigFile()) conf = await YamlLintConfig.init({ _data: load });
+	if (load = await loadConfigFile(options)) conf = await YamlLintConfig.init({ _data: load });
 	else if (userGlobalConfig = await detectUserGlobalConfig()) conf = await YamlLintConfig.init({ file: userGlobalConfig });
 	else conf = await YamlLintConfig.init({ content: "extends: default" });
 	return conf;

package/dist/package.mjs

@@ -1,6 +1,6 @@
 var name = "yamllint-js";
 var description = "A linter for YAML files — an unofficial native Node.js port of Python yamllint.";
-var version = "0.2.2";
+var version = "0.2.3";
 var bin = {
 	"yamllint-js": "dist/main.mjs",
 	"yamllint": "dist/main.mjs"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "yamllint-js",
   "description": "A linter for YAML files — an unofficial native Node.js port of Python yamllint.",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "license": "GPL-3.0-or-later",
   "type": "module",
   "author": {