@cssdoc/config 0.5.4 → 0.6.0

package/cssdoc.schema.json

@@ -109,6 +109,13 @@
                 "type": "string"
               }
             },
+            "pseudoElements": {
+              "description": "Native pseudo-elements (without the ::) to document, e.g. [\"before\",\"after\"]. Overrides the built-in default set.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
             "propValue": {
               "type": "boolean"
             },
@@ -119,6 +126,10 @@
         }
       ]
     },
+    "inlineComments": {
+      "description": "How a /* … */ comment on a member's rule combines with its tag prose: append (default), prepend, replace, or ignore.",
+      "enum": ["append", "prepend", "replace", "ignore"]
+    },
     "rules": {
       "description": "Per-rule severity overrides (off/warn/error).",
       "type": "object",

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { CssDocConfiguration, CssDocTagDefinition, ModifierConventionInput } from "@cssdoc/core";
+import { CssDocConfiguration, CssDocTagDefinition, InlineCommentMode, ModifierConventionInput } from "@cssdoc/core";
 
 //#region src/CssDocConfigFile.d.ts
 /** A per-rule severity override, as spelled in `cssdoc.json`. */
@@ -45,6 +45,8 @@ declare class CssDocConfigFile {
   readonly extendsFiles: readonly CssDocConfigFile[];
   /** The modifier convention declared by this file, if any. */
   readonly modifierConvention?: ModifierConventionInput;
+  /** How inline `/* … *\/` comments combine with tag prose, if declared by this file. */
+  readonly inlineComments?: InlineCommentMode;
   /**
    * The per-rule severity overrides, merged across the `extends` chain (this file wins). Not the
    * resolved severities — pass these to `resolveRuleSeverities` in `@cssdoc/providers`.
@@ -214,6 +216,13 @@ declare const cssDocSchema: {
               readonly type: "string";
             };
           };
+          readonly pseudoElements: {
+            readonly description: "Native pseudo-elements (without the ::) to document, e.g. [\"before\",\"after\"]. Overrides the built-in default set.";
+            readonly type: "array";
+            readonly items: {
+              readonly type: "string";
+            };
+          };
           readonly propValue: {
             readonly type: "boolean";
           };
@@ -223,6 +232,10 @@ declare const cssDocSchema: {
         };
       }];
     };
+    readonly inlineComments: {
+      readonly description: "How a /* … */ comment on a member's rule combines with its tag prose: append (default), prepend, replace, or ignore.";
+      readonly enum: readonly ["append", "prepend", "replace", "ignore"];
+    };
     readonly rules: {
       readonly description: "Per-rule severity overrides (off/warn/error).";
       readonly type: "object";

package/dist/index.mjs

@@ -102,11 +102,25 @@ const cssDocSchema = {
 						type: "array",
 						items: { type: "string" }
 					},
+					pseudoElements: {
+						description: "Native pseudo-elements (without the ::) to document, e.g. [\"before\",\"after\"]. Overrides the built-in default set.",
+						type: "array",
+						items: { type: "string" }
+					},
 					propValue: { type: "boolean" },
 					propValueSeparator: { type: "string" }
 				}
 			}]
 		},
+		inlineComments: {
+			description: "How a /* … */ comment on a member's rule combines with its tag prose: append (default), prepend, replace, or ignore.",
+			enum: [
+				"append",
+				"prepend",
+				"replace",
+				"ignore"
+			]
+		},
 		rules: {
 			description: "Per-rule severity overrides (off/warn/error).",
 			type: "object",
@@ -217,6 +231,8 @@ var CssDocConfigFile = class CssDocConfigFile {
 	extendsFiles;
 	/** The modifier convention declared by this file, if any. */
 	modifierConvention;
+	/** How inline `/* … *\/` comments combine with tag prose, if declared by this file. */
+	inlineComments;
 	/**
 	* The per-rule severity overrides, merged across the `extends` chain (this file wins). Not the
 	* resolved severities — pass these to `resolveRuleSeverities` in `@cssdoc/providers`.
@@ -247,6 +263,7 @@ var CssDocConfigFile = class CssDocConfigFile {
 		this.supportForTags = init.supportForTags;
 		this.extendsFiles = init.extendsFiles;
 		this.modifierConvention = init.modifierConvention;
+		this.inlineComments = init.inlineComments;
 		const severities = {};
 		const naming = {};
 		const render = {};
@@ -289,6 +306,7 @@ var CssDocConfigFile = class CssDocConfigFile {
 			if (definition) configuration.setSupportForTag(definition, supported);
 		}
 		if (this.modifierConvention !== void 0) configuration.setModifierConvention(this.modifierConvention);
+		if (this.inlineComments !== void 0) configuration.setInlineComments(this.inlineComments);
 	}
 	/**
 	* Build a {@link CssDocConfiguration} from this file. Convenience for the common case.
@@ -400,6 +418,7 @@ var CssDocConfigFile = class CssDocConfigFile {
 			supportForTags: new Map(Object.entries(raw.supportForTags ?? {})),
 			extendsFiles,
 			modifierConvention: raw.modifierConvention,
+			inlineComments: raw.inlineComments,
 			rules: raw.rules ?? {},
 			naming: raw.naming ?? {},
 			structureIgnore: raw.structureIgnore ?? [],

package/package.json

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