@cssdoc/spec 0.3.3 → 0.4.0

package/dist/index.mjs

@@ -118,6 +118,12 @@ const CSSDOC_TAGS = [
 		allowMultiple: true,
 		argument: "part-name"
 	},
+	{
+		name: "tokens",
+		kind: "block",
+		allowMultiple: true,
+		argument: "custom-property"
+	},
 	{
 		name: "function",
 		kind: "block",
@@ -179,6 +185,20 @@ const CSSDOC_TAGS = [
 		name: "demo",
 		kind: "block"
 	},
+	{
+		name: "usage",
+		kind: "block"
+	},
+	{
+		name: "compat",
+		kind: "block",
+		allowMultiple: true
+	},
+	{
+		name: "related",
+		kind: "block",
+		allowMultiple: true
+	},
 	{
 		name: "alpha",
 		kind: "modifier"

package/grammar/CssDoc.grammarkdown

@@ -273,6 +273,11 @@ CssPropertyTag :
     CssPropertyKeyword WhiteSpace CustomPropertyName Separator Description
     CssPropertyKeyword WhiteSpace CustomPropertyName SyntaxDescriptor Separator Description
 
+// A design token the component consumes (`var(--name)`); the set is derived from the CSS, this adds prose.
+TokensTag :
+    `@tokens` WhiteSpace CustomPropertyName
+    `@tokens` WhiteSpace CustomPropertyName Separator Description
+
 // A state name: a bare identifier (a custom `:state(name)` state) or a `:`-prefixed native
 // pseudo-class state, e.g. `:disabled`.
 StateName :
@@ -377,6 +382,21 @@ DemoSpec :
 DemoTag :
     `@demo` WhiteSpace DemoSpec
 
+// --- Usage, compatibility & related ------------------------------------------------------------
+
+// How to include the stylesheet / use the component.
+UsageTag :
+    `@usage` WhiteSpace Description
+
+// A browser-support or feature-compatibility note.
+CompatTag :
+    `@compat` WhiteSpace Description
+
+// A related component cross-reference, named by its record name.
+RelatedTag :
+    `@related` WhiteSpace RecordName
+    `@related` WhiteSpace RecordName Separator Description
+
 // --- Modifier (flag) tags: release stage / traits; presence means true ------------------------
 
 ModifierFlagTag :
@@ -407,6 +427,7 @@ BlockTag :
     PartTag
     CssPartTag
     CssPropertyTag
+    TokensTag
     CssStateTag
     CssFunctionTag
     KeyframesTag
@@ -419,6 +440,9 @@ BlockTag :
     StructureTag
     ExampleTag
     DemoTag
+    UsageTag
+    CompatTag
+    RelatedTag
     DeprecatedTag
     SeeTag
     SinceTag

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cssdoc/spec",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "The canonical cssdoc spec: the tag vocabulary and the formal grammar (CssDoc.grammarkdown), the single source of truth shared by the parser and every syntax grammar. Zero runtime dependencies.",
   "keywords": [
     "cssdoc",