@spiracss/stylelint-plugin 0.1.11 → 0.1.12

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Akihiro Hoshiyama
+Copyright (c) 2025 SpiraCSS
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,3 +1,3 @@
 # @spiracss/stylelint-plugin
 
-Do not use. This package is experimental and internal only.
+Experimental package under active development. Breaking changes may occur frequently.

package/dist/cjs/rules/spiracss-class-structure.js

@@ -25,6 +25,7 @@ const messages = stylelint_1.default.utils.ruleMessages(exports.ruleName, {
     disallowedModifier: () => 'Modifier classes are disabled by selectorPolicy. Use data-variant/data-state or enable class mode.',
     invalidDataAttribute: (attr) => `Attribute "${attr}" is not allowed by selectorPolicy.`,
     invalidDataValue: (attr, value) => `Attribute "${attr}" value "${value}" does not match selectorPolicy valueNaming.`,
+    rootSelectorMissingBlock: (block, selector) => `Root selector "${selector}" must include the root Block ".${block}".`,
     fileNameMismatch: (block, expected, actual) => `Root Block ".${block}" must be defined in "${expected}.scss" (found "${actual}.scss").`
 });
 const defaultValueNaming = {
@@ -341,6 +342,24 @@ const collectRootBlockNames = (selector, options, patterns) => {
     }).processSync(selector);
     return [...names];
 };
+const analyzeRootSelector = (sel, rootBlockName, options, patterns) => {
+    let hasSpiraClass = false;
+    let hasRootBlock = false;
+    let hasOtherBlock = false;
+    sel.walk((node) => {
+        if (node.type !== 'class')
+            return;
+        const name = node.value;
+        const kind = classify(name, options, patterns);
+        if (kind !== 'external')
+            hasSpiraClass = true;
+        if (name === rootBlockName)
+            hasRootBlock = true;
+        if (kind === 'block' && name !== rootBlockName)
+            hasOtherBlock = true;
+    });
+    return { hasSpiraClass, hasRootBlock, hasOtherBlock };
+};
 const buildValuePattern = (naming) => {
     const maxWords = naming.maxWords;
     switch (naming.case) {
@@ -771,6 +790,7 @@ const spiracssClassStructure = stylelint_1.default.createPlugin(exports.ruleName
         const interactionRules = markInteractionRules(root, commentPatterns);
         let firstRule = null;
         let rootBlockName = null;
+        const topLevelRules = [];
         const filePath = ((_a = result === null || result === void 0 ? void 0 : result.opts) === null || _a === void 0 ? void 0 : _a.from) || '';
         const normalizedPath = filePath ? path_1.default.normalize(filePath) : '';
         const pathSegments = normalizedPath ? normalizedPath.split(path_1.default.sep).filter(Boolean) : [];
@@ -799,6 +819,7 @@ const spiracssClassStructure = stylelint_1.default.createPlugin(exports.ruleName
                 });
             };
             if (!parentRule) {
+                topLevelRules.push(rule);
                 const rootBlocks = collectRootBlockNames(rule.selector, options, patterns);
                 if (rootBlocks.length > 0) {
                     const rootName = rootBlockName || rootBlocks[0];
@@ -826,6 +847,28 @@ const spiracssClassStructure = stylelint_1.default.createPlugin(exports.ruleName
                 }));
             }).processSync(rule.selector);
         });
+        if (options.enforceSingleRootBlock && rootBlockName) {
+            const resolvedRootBlockName = rootBlockName;
+            topLevelRules.forEach((rule) => {
+                if (typeof rule.selector !== 'string')
+                    return;
+                if (rule.selector.includes(':global'))
+                    return;
+                (0, postcss_selector_parser_1.default)((selectors) => {
+                    selectors.each((sel) => {
+                        const { hasSpiraClass, hasRootBlock, hasOtherBlock } = analyzeRootSelector(sel, resolvedRootBlockName, options, patterns);
+                        if (!hasSpiraClass || hasRootBlock || hasOtherBlock)
+                            return;
+                        stylelint_1.default.utils.report({
+                            ruleName: exports.ruleName,
+                            result,
+                            node: rule,
+                            message: messages.rootSelectorMissingBlock(resolvedRootBlockName, sel.toString().trim())
+                        });
+                    });
+                }).processSync(rule.selector);
+            });
+        }
         if (options.enforceRootFileName && rootBlockName && fileBase) {
             const isComponentsLayer = options.componentsDirs.some((dir) => {
                 const normalizedDir = path_1.default.normalize(dir);

package/dist/esm/rules/spiracss-class-structure.js

@@ -19,6 +19,7 @@ const messages = stylelint.utils.ruleMessages(ruleName, {
     disallowedModifier: () => 'Modifier classes are disabled by selectorPolicy. Use data-variant/data-state or enable class mode.',
     invalidDataAttribute: (attr) => `Attribute "${attr}" is not allowed by selectorPolicy.`,
     invalidDataValue: (attr, value) => `Attribute "${attr}" value "${value}" does not match selectorPolicy valueNaming.`,
+    rootSelectorMissingBlock: (block, selector) => `Root selector "${selector}" must include the root Block ".${block}".`,
     fileNameMismatch: (block, expected, actual) => `Root Block ".${block}" must be defined in "${expected}.scss" (found "${actual}.scss").`
 });
 const defaultValueNaming = {
@@ -335,6 +336,24 @@ const collectRootBlockNames = (selector, options, patterns) => {
     }).processSync(selector);
     return [...names];
 };
+const analyzeRootSelector = (sel, rootBlockName, options, patterns) => {
+    let hasSpiraClass = false;
+    let hasRootBlock = false;
+    let hasOtherBlock = false;
+    sel.walk((node) => {
+        if (node.type !== 'class')
+            return;
+        const name = node.value;
+        const kind = classify(name, options, patterns);
+        if (kind !== 'external')
+            hasSpiraClass = true;
+        if (name === rootBlockName)
+            hasRootBlock = true;
+        if (kind === 'block' && name !== rootBlockName)
+            hasOtherBlock = true;
+    });
+    return { hasSpiraClass, hasRootBlock, hasOtherBlock };
+};
 const buildValuePattern = (naming) => {
     const maxWords = naming.maxWords;
     switch (naming.case) {
@@ -765,6 +784,7 @@ const spiracssClassStructure = stylelint.createPlugin(ruleName, (primaryOption,
         const interactionRules = markInteractionRules(root, commentPatterns);
         let firstRule = null;
         let rootBlockName = null;
+        const topLevelRules = [];
         const filePath = ((_a = result === null || result === void 0 ? void 0 : result.opts) === null || _a === void 0 ? void 0 : _a.from) || '';
         const normalizedPath = filePath ? path.normalize(filePath) : '';
         const pathSegments = normalizedPath ? normalizedPath.split(path.sep).filter(Boolean) : [];
@@ -793,6 +813,7 @@ const spiracssClassStructure = stylelint.createPlugin(ruleName, (primaryOption,
                 });
             };
             if (!parentRule) {
+                topLevelRules.push(rule);
                 const rootBlocks = collectRootBlockNames(rule.selector, options, patterns);
                 if (rootBlocks.length > 0) {
                     const rootName = rootBlockName || rootBlocks[0];
@@ -820,6 +841,28 @@ const spiracssClassStructure = stylelint.createPlugin(ruleName, (primaryOption,
                 }));
             }).processSync(rule.selector);
         });
+        if (options.enforceSingleRootBlock && rootBlockName) {
+            const resolvedRootBlockName = rootBlockName;
+            topLevelRules.forEach((rule) => {
+                if (typeof rule.selector !== 'string')
+                    return;
+                if (rule.selector.includes(':global'))
+                    return;
+                selectorParser((selectors) => {
+                    selectors.each((sel) => {
+                        const { hasSpiraClass, hasRootBlock, hasOtherBlock } = analyzeRootSelector(sel, resolvedRootBlockName, options, patterns);
+                        if (!hasSpiraClass || hasRootBlock || hasOtherBlock)
+                            return;
+                        stylelint.utils.report({
+                            ruleName,
+                            result,
+                            node: rule,
+                            message: messages.rootSelectorMissingBlock(resolvedRootBlockName, sel.toString().trim())
+                        });
+                    });
+                }).processSync(rule.selector);
+            });
+        }
         if (options.enforceRootFileName && rootBlockName && fileBase) {
             const isComponentsLayer = options.componentsDirs.some((dir) => {
                 const normalizedDir = path.normalize(dir);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spiracss/stylelint-plugin",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "SpiraCSS development utilities",
   "keywords": [
     "spiracss",
@@ -13,7 +13,7 @@
   ],
   "publishConfig": {
     "access": "public",
-    "tag": "beta"
+    "tag": "latest"
   },
   "license": "MIT",
   "engines": {