@cssdoc/core 0.3.2 → 0.3.3

package/dist/index.d.mts

@@ -516,7 +516,7 @@ interface ParseOptions {
 //#endregion
 //#region src/parse.d.ts
 /**
- * Parse a CSS string into a documentation model. Records are delimited by doc comments carrying a
+ * Parse a CSS string into a documentation model. Records are delimited by `/**` doc comments carrying a
  * record tag (`@component`/`@name` by default; override via {@link ParseOptions.isRecordBoundary});
  * everything from one boundary comment to the next belongs to that record.
  *

package/dist/index.mjs

@@ -1063,7 +1063,18 @@ function buildEntry(name, doc, nodes, matcher) {
 	};
 }
 /**
-* Parse a CSS string into a documentation model. Records are delimited by doc comments carrying a
+* A cssdoc record is opened only by a JSDoc-style doc comment (its opener is `/**`) — never a plain
+* block comment. PostCSS doesn't distinguish the two, so an ordinary comment that merely mentions
+* `@component` (a TODO, a banner) would otherwise mint a phantom, summary-less record. We check the raw
+* source at the comment's offset for the `/**` opener, falling back to the leftover `*` that a `/**`
+* leaves at the start of the comment body when no offset is available.
+*/
+function isDocComment(node, source) {
+	const offset = node.source?.start?.offset;
+	return offset === void 0 ? node.text.startsWith("*") : source.startsWith("/**", offset);
+}
+/**
+* Parse a CSS string into a documentation model. Records are delimited by `/**` doc comments carrying a
 * record tag (`@component`/`@name` by default; override via {@link ParseOptions.isRecordBoundary});
 * everything from one boundary comment to the next belongs to that record.
 *
@@ -1087,7 +1098,7 @@ function parseCssDocs(css, options = {}) {
 	const records = [];
 	let current = null;
 	for (const node of root.nodes) {
-		if (node.type === "comment") {
+		if (node.type === "comment" && isDocComment(node, css)) {
 			const name = boundary(node.text);
 			if (name) {
 				current = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cssdoc/core",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "A generic CSS documentation extractor: parse doc-comments + the CSS AST into a serializable model (TSDoc, for CSS).",
   "keywords": [
     "css",
@@ -31,7 +31,7 @@
   },
   "dependencies": {
     "postcss": "^8.5.16",
-    "@cssdoc/spec": "0.3.2"
+    "@cssdoc/spec": "0.3.3"
   },
   "devDependencies": {
     "@types/node": "^24.13.3",