@cssdoc/config 0.1.0 → 0.2.0

package/cssdoc.schema.json

@@ -36,6 +36,28 @@
       "description": "Enable or disable specific tags by name.",
       "type": "object",
       "additionalProperties": { "type": "boolean" }
+    },
+    "modifierConvention": {
+      "description": "How modifier classes are spelled: a preset name (bem, rscss, bare) or a custom convention.",
+      "oneOf": [
+        { "enum": ["bem", "rscss", "bare"] },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["structure", "separator"],
+          "properties": {
+            "structure": { "enum": ["chained", "suffix", "attribute"] },
+            "separator": { "type": "string" },
+            "propValue": { "type": "boolean" },
+            "propValueSeparator": { "type": "string" }
+          }
+        }
+      ]
+    },
+    "rules": {
+      "description": "Per-rule severity overrides (off/warn/error).",
+      "type": "object",
+      "additionalProperties": { "enum": ["off", "warn", "error"] }
     }
   }
 }

package/dist/index.d.mts

@@ -1,6 +1,8 @@
-import { CssDocConfiguration, CssDocTagDefinition } from "@cssdoc/core";
+import { CssDocConfiguration, CssDocTagDefinition, ModifierConventionInput } from "@cssdoc/core";
 
 //#region src/CssDocConfigFile.d.ts
+/** A per-rule severity override, as spelled in `cssdoc.json`. */
+type RuleSeverityOverride = "off" | "warn" | "error";
 /** The conventional file name loaders look for. */
 declare const CSSDOC_CONFIG_FILENAME = "cssdoc.json";
 /** A loaded `cssdoc.json` (plus the files it `extends`), ready to configure a parser. */
@@ -19,6 +21,13 @@ declare class CssDocConfigFile {
   readonly supportForTags: ReadonlyMap<string, boolean>;
   /** The resolved files this one `extends`, in declaration order. */
   readonly extendsFiles: readonly CssDocConfigFile[];
+  /** The modifier convention declared by this file, if any. */
+  readonly modifierConvention?: ModifierConventionInput;
+  /**
+   * The per-rule severity overrides, merged across the `extends` chain (this file wins). Not the
+   * resolved severities — pass these to `resolveRuleSeverities` in `@cssdoc/providers`.
+   */
+  readonly ruleSeverities: Readonly<Record<string, RuleSeverityOverride>>;
   private constructor();
   /** Whether this file — or any file it extends — reported an error. */
   get hasErrors(): boolean;
@@ -120,6 +129,37 @@ declare const cssDocSchema: {
         readonly type: "boolean";
       };
     };
+    readonly modifierConvention: {
+      readonly description: "How modifier classes are spelled: a preset name (bem, rscss, bare) or a custom convention.";
+      readonly oneOf: readonly [{
+        readonly enum: readonly ["bem", "rscss", "bare"];
+      }, {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["structure", "separator"];
+        readonly properties: {
+          readonly structure: {
+            readonly enum: readonly ["chained", "suffix", "attribute"];
+          };
+          readonly separator: {
+            readonly type: "string";
+          };
+          readonly propValue: {
+            readonly type: "boolean";
+          };
+          readonly propValueSeparator: {
+            readonly type: "string";
+          };
+        };
+      }];
+    };
+    readonly rules: {
+      readonly description: "Per-rule severity overrides (off/warn/error).";
+      readonly type: "object";
+      readonly additionalProperties: {
+        readonly enum: readonly ["off", "warn", "error"];
+      };
+    };
   };
 };
 //#endregion

package/dist/index.mjs

@@ -63,6 +63,37 @@ const cssDocSchema = {
 			description: "Enable or disable specific tags by name.",
 			type: "object",
 			additionalProperties: { type: "boolean" }
+		},
+		modifierConvention: {
+			description: "How modifier classes are spelled: a preset name (bem, rscss, bare) or a custom convention.",
+			oneOf: [{ enum: [
+				"bem",
+				"rscss",
+				"bare"
+			] }, {
+				type: "object",
+				additionalProperties: false,
+				required: ["structure", "separator"],
+				properties: {
+					structure: { enum: [
+						"chained",
+						"suffix",
+						"attribute"
+					] },
+					separator: { type: "string" },
+					propValue: { type: "boolean" },
+					propValueSeparator: { type: "string" }
+				}
+			}]
+		},
+		rules: {
+			description: "Per-rule severity overrides (off/warn/error).",
+			type: "object",
+			additionalProperties: { enum: [
+				"off",
+				"warn",
+				"error"
+			] }
 		}
 	}
 };
@@ -96,6 +127,13 @@ var CssDocConfigFile = class CssDocConfigFile {
 	supportForTags;
 	/** The resolved files this one `extends`, in declaration order. */
 	extendsFiles;
+	/** The modifier convention declared by this file, if any. */
+	modifierConvention;
+	/**
+	* The per-rule severity overrides, merged across the `extends` chain (this file wins). Not the
+	* resolved severities — pass these to `resolveRuleSeverities` in `@cssdoc/providers`.
+	*/
+	ruleSeverities;
 	constructor(init) {
 		this.filePath = init.filePath;
 		this.fileNotFound = init.fileNotFound;
@@ -104,6 +142,11 @@ var CssDocConfigFile = class CssDocConfigFile {
 		this.tagDefinitions = init.tagDefinitions;
 		this.supportForTags = init.supportForTags;
 		this.extendsFiles = init.extendsFiles;
+		this.modifierConvention = init.modifierConvention;
+		const severities = {};
+		for (const extended of init.extendsFiles) Object.assign(severities, extended.ruleSeverities);
+		Object.assign(severities, init.rules);
+		this.ruleSeverities = severities;
 	}
 	/** Whether this file — or any file it extends — reported an error. */
 	get hasErrors() {
@@ -127,6 +170,7 @@ var CssDocConfigFile = class CssDocConfigFile {
 			const definition = configuration.tryGetTagDefinition(tagName);
 			if (definition) configuration.setSupportForTag(definition, supported);
 		}
+		if (this.modifierConvention !== void 0) configuration.setModifierConvention(this.modifierConvention);
 	}
 	/**
 	* Build a {@link CssDocConfiguration} from this file. Convenience for the common case.
@@ -170,7 +214,8 @@ var CssDocConfigFile = class CssDocConfigFile {
 			noStandardTags: false,
 			tagDefinitions: [],
 			supportForTags: /* @__PURE__ */ new Map(),
-			extendsFiles: []
+			extendsFiles: [],
+			rules: {}
 		});
 	}
 	static _loadFile(filePath, visited) {
@@ -182,7 +227,8 @@ var CssDocConfigFile = class CssDocConfigFile {
 			noStandardTags: false,
 			tagDefinitions: [],
 			supportForTags: /* @__PURE__ */ new Map(),
-			extendsFiles: []
+			extendsFiles: [],
+			rules: {}
 		});
 		if (visited.has(filePath)) {
 			messages.push("Circular extends reference; skipped.");
@@ -226,7 +272,9 @@ var CssDocConfigFile = class CssDocConfigFile {
 			noStandardTags: raw.noStandardTags ?? false,
 			tagDefinitions,
 			supportForTags: new Map(Object.entries(raw.supportForTags ?? {})),
-			extendsFiles
+			extendsFiles,
+			modifierConvention: raw.modifierConvention,
+			rules: raw.rules ?? {}
 		});
 	}
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cssdoc/config",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Load a cssdoc.json configuration file (custom tags, extends) into an @cssdoc/core CssDocConfiguration — TSDoc-config, for CSS.",
   "keywords": [
     "config",
@@ -31,7 +31,7 @@
   },
   "dependencies": {
     "ajv": "^8.20.0",
-    "@cssdoc/core": "0.1.0"
+    "@cssdoc/core": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^24.13.3",