stylelint-plugin-grid 1.0.0

package/dist/rules/prefer-gap-properties.js

@@ -0,0 +1,58 @@
+import stylelint, {} from "stylelint";
+import { isDefined } from "ts-extras";
+import { createStylelintRule, } from "../_internal/create-stylelint-rule.js";
+import { createRuleDocsUrl, createRuleName, } from "../_internal/plugin-constants.js";
+const { report, ruleMessages, validateOptions } = stylelint.utils;
+const ruleName = createRuleName("prefer-gap-properties");
+const messages = ruleMessages(ruleName, {
+    rejected: (propertyName, replacement) => `Prefer \`${replacement}\` over legacy \`${propertyName}\`.`,
+});
+const docs = {
+    description: "Prefer modern `gap`, `row-gap`, and `column-gap` properties over legacy grid gap aliases.",
+    recommended: true,
+    url: createRuleDocsUrl("prefer-gap-properties"),
+};
+const replacements = {
+    "grid-column-gap": "column-gap",
+    "grid-gap": "gap",
+    "grid-row-gap": "row-gap",
+};
+function getReplacement(declaration) {
+    return replacements[declaration.prop.toLowerCase()];
+}
+const ruleFunction = (primary) => (root, result) => {
+    if (!validateOptions(result, ruleName, {
+        actual: primary,
+        possible: [true],
+    })) {
+        return;
+    }
+    root.walkDecls((declaration) => {
+        const replacement = getReplacement(declaration);
+        if (!isDefined(replacement)) {
+            return;
+        }
+        report({
+            fix: () => {
+                declaration.prop = replacement;
+            },
+            message: messages.rejected(declaration.prop, replacement),
+            node: declaration,
+            result,
+            ruleName,
+            word: declaration.prop,
+        });
+    });
+};
+/** Public Stylelint rule definition. */
+const rule = createStylelintRule({
+    docs,
+    messages,
+    meta: {
+        fixable: true,
+    },
+    rule: ruleFunction,
+    ruleName,
+});
+export default rule;
+//# sourceMappingURL=prefer-gap-properties.js.map

package/dist/rules/prefer-gap-properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefer-gap-properties.js","sourceRoot":"","sources":["../../src/rules/prefer-gap-properties.ts"],"names":[],"mappings":"AAEA,OAAO,SAAS,EAAE,EAAiB,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EACH,mBAAmB,GAEtB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACH,iBAAiB,EACjB,cAAc,GACjB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC;AAElE,MAAM,QAAQ,GAAG,cAAc,CAAC,uBAAuB,CAAC,CAAC;AACzD,MAAM,QAAQ,GAEV,YAAY,CAAC,QAAQ,EAAE;IACvB,QAAQ,EAAE,CAAC,YAAoB,EAAE,WAAmB,EAAU,EAAE,CAC5D,YAAY,WAAW,oBAAoB,YAAY,KAAK;CACnE,CAAC,CAAC;AAEH,MAAM,IAAI,GAAG;IACT,WAAW,EACP,2FAA2F;IAC/F,WAAW,EAAE,IAAI;IACjB,GAAG,EAAE,iBAAiB,CAAC,uBAAuB,CAAC;CACzC,CAAC;AAEX,MAAM,YAAY,GAAqC;IACnD,iBAAiB,EAAE,YAAY;IAC/B,UAAU,EAAE,KAAK;IACjB,cAAc,EAAE,SAAS;CAC5B,CAAC;AAEF,SAAS,cAAc,CACnB,WAAkC;IAElC,OAAO,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,YAAY,GACd,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;IAC1B,IACI,CAAC,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE;QAC/B,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,CAAC,IAAI,CAAC;KACnB,CAAC,EACJ,CAAC;QACC,OAAO;IACX,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,EAAE;QAC3B,MAAM,WAAW,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;QAEhD,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;YAC1B,OAAO;QACX,CAAC;QAED,MAAM,CAAC;YACH,GAAG,EAAE,GAAG,EAAE;gBACN,WAAW,CAAC,IAAI,GAAG,WAAW,CAAC;YACnC,CAAC;YACD,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC;YACzD,IAAI,EAAE,WAAW;YACjB,MAAM;YACN,QAAQ;YACR,IAAI,EAAE,WAAW,CAAC,IAAI;SACzB,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEN,wCAAwC;AACxC,MAAM,IAAI,GACN,mBAAmB,CAAsC;IACrD,IAAI;IACJ,QAAQ;IACR,IAAI,EAAE;QACF,OAAO,EAAE,IAAI;KAChB;IACD,IAAI,EAAE,YAAY;IAClB,QAAQ;CACX,CAAC,CAAC;AAEP,eAAe,IAAI,CAAC"}

package/dist/rules/require-explicit-rows-with-column-flow.d.ts

@@ -0,0 +1,8 @@
+import { type StylelintPluginRule } from "../_internal/create-stylelint-rule.js";
+declare const messages: {
+    rejected: () => string;
+};
+/** Public Stylelint rule definition. */
+declare const rule: StylelintPluginRule<boolean, undefined, typeof messages>;
+export default rule;
+//# sourceMappingURL=require-explicit-rows-with-column-flow.d.ts.map

package/dist/rules/require-explicit-rows-with-column-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-explicit-rows-with-column-flow.d.ts","sourceRoot":"","sources":["../../src/rules/require-explicit-rows-with-column-flow.ts"],"names":[],"mappings":"AAGA,OAAO,EAEH,KAAK,mBAAmB,EAC3B,MAAM,uCAAuC,CAAC;AAa/C,QAAA,MAAM,QAAQ,EAAE;IAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;CAGtC,CAAC;AAqDH,wCAAwC;AACxC,QAAA,MAAM,IAAI,EAAE,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,QAAQ,CAM7D,CAAC;AAEP,eAAe,IAAI,CAAC"}

package/dist/rules/require-explicit-rows-with-column-flow.js

@@ -0,0 +1,52 @@
+import stylelint, {} from "stylelint";
+import { isDefined } from "ts-extras";
+import { createStylelintRule, } from "../_internal/create-stylelint-rule.js";
+import { findSiblingDeclaration, splitTopLevelWhitespace, } from "../_internal/grid-template-analysis.js";
+import { createRuleDocsUrl, createRuleName, } from "../_internal/plugin-constants.js";
+const { report, ruleMessages, validateOptions } = stylelint.utils;
+const ruleName = createRuleName("require-explicit-rows-with-column-flow");
+const messages = ruleMessages(ruleName, {
+    rejected: () => "Pair `grid-auto-flow: column` with explicit row sizing in the same block, such as `grid-template-rows` or `grid-auto-rows`.",
+});
+const docs = {
+    description: "Require explicit row sizing when a rule uses `grid-auto-flow: column`.",
+    recommended: false,
+    url: createRuleDocsUrl("require-explicit-rows-with-column-flow"),
+};
+function hasColumnFlow(value) {
+    return splitTopLevelWhitespace(value).some((token) => token.toLowerCase() === "column");
+}
+const ruleFunction = (primary) => (root, result) => {
+    if (!validateOptions(result, ruleName, {
+        actual: primary,
+        possible: [true],
+    })) {
+        return;
+    }
+    root.walkDecls("grid-auto-flow", (declaration) => {
+        if (!hasColumnFlow(declaration.value)) {
+            return;
+        }
+        const hasExplicitRows = isDefined(findSiblingDeclaration(declaration, "grid-template-rows")) ||
+            isDefined(findSiblingDeclaration(declaration, "grid-auto-rows"));
+        if (hasExplicitRows) {
+            return;
+        }
+        report({
+            message: messages.rejected(),
+            node: declaration,
+            result,
+            ruleName,
+            word: "column",
+        });
+    });
+};
+/** Public Stylelint rule definition. */
+const rule = createStylelintRule({
+    docs,
+    messages,
+    rule: ruleFunction,
+    ruleName,
+});
+export default rule;
+//# sourceMappingURL=require-explicit-rows-with-column-flow.js.map

package/dist/rules/require-explicit-rows-with-column-flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-explicit-rows-with-column-flow.js","sourceRoot":"","sources":["../../src/rules/require-explicit-rows-with-column-flow.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,EAAE,EAAiB,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EACH,mBAAmB,GAEtB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACH,sBAAsB,EACtB,uBAAuB,GAC1B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACH,iBAAiB,EACjB,cAAc,GACjB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC;AAElE,MAAM,QAAQ,GAAG,cAAc,CAAC,wCAAwC,CAAC,CAAC;AAC1E,MAAM,QAAQ,GAA+B,YAAY,CAAC,QAAQ,EAAE;IAChE,QAAQ,EAAE,GAAW,EAAE,CACnB,6HAA6H;CACpI,CAAC,CAAC;AAEH,MAAM,IAAI,GAAG;IACT,WAAW,EACP,wEAAwE;IAC5E,WAAW,EAAE,KAAK;IAClB,GAAG,EAAE,iBAAiB,CAAC,wCAAwC,CAAC;CAC1D,CAAC;AAEX,SAAS,aAAa,CAAC,KAAa;IAChC,OAAO,uBAAuB,CAAC,KAAK,CAAC,CAAC,IAAI,CACtC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,QAAQ,CAC9C,CAAC;AACN,CAAC;AAED,MAAM,YAAY,GACd,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;IAC1B,IACI,CAAC,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE;QAC/B,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,CAAC,IAAI,CAAC;KACnB,CAAC,EACJ,CAAC;QACC,OAAO;IACX,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,gBAAgB,EAAE,CAAC,WAAW,EAAE,EAAE;QAC7C,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,OAAO;QACX,CAAC;QAED,MAAM,eAAe,GACjB,SAAS,CACL,sBAAsB,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAC5D;YACD,SAAS,CACL,sBAAsB,CAAC,WAAW,EAAE,gBAAgB,CAAC,CACxD,CAAC;QAEN,IAAI,eAAe,EAAE,CAAC;YAClB,OAAO;QACX,CAAC;QAED,MAAM,CAAC;YACH,OAAO,EAAE,QAAQ,CAAC,QAAQ,EAAE;YAC5B,IAAI,EAAE,WAAW;YACjB,MAAM;YACN,QAAQ;YACR,IAAI,EAAE,QAAQ;SACjB,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEN,wCAAwC;AACxC,MAAM,IAAI,GACN,mBAAmB,CAAsC;IACrD,IAAI;IACJ,QAAQ;IACR,IAAI,EAAE,YAAY;IAClB,QAAQ;CACX,CAAC,CAAC;AAEP,eAAe,IAAI,CAAC"}

package/dist/rules/validate-area-shapes.d.ts

@@ -0,0 +1,8 @@
+import { type StylelintPluginRule } from "../_internal/create-stylelint-rule.js";
+declare const messages: {
+    rejected: (areaName: string) => string;
+};
+/** Public Stylelint rule definition. */
+declare const rule: StylelintPluginRule<boolean, undefined, typeof messages>;
+export default rule;
+//# sourceMappingURL=validate-area-shapes.d.ts.map

package/dist/rules/validate-area-shapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-area-shapes.d.ts","sourceRoot":"","sources":["../../src/rules/validate-area-shapes.ts"],"names":[],"mappings":"AAGA,OAAO,EAEH,KAAK,mBAAmB,EAC3B,MAAM,uCAAuC,CAAC;AAc/C,QAAA,MAAM,QAAQ,EAAE;IAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAA;CAMvD,CAAC;AAqCF,wCAAwC;AACxC,QAAA,MAAM,IAAI,EAAE,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,QAAQ,CAM7D,CAAC;AAEP,eAAe,IAAI,CAAC"}

package/dist/rules/validate-area-shapes.js

@@ -0,0 +1,47 @@
+import stylelint, {} from "stylelint";
+import { isEmpty } from "ts-extras";
+import { createStylelintRule, } from "../_internal/create-stylelint-rule.js";
+import { collectGridTemplateAreas, getAreaShapes, isRectangularArea, } from "../_internal/grid-template-analysis.js";
+import { createRuleDocsUrl, createRuleName, } from "../_internal/plugin-constants.js";
+const { report, ruleMessages, validateOptions } = stylelint.utils;
+const ruleName = createRuleName("validate-area-shapes");
+const messages = ruleMessages(ruleName, {
+    rejected: (areaName) => `Grid area "${areaName}" must form one contiguous rectangle in \`grid-template-areas\`.`,
+});
+const docs = {
+    description: "Require every named grid template area to form one contiguous rectangle.",
+    recommended: true,
+    url: createRuleDocsUrl("validate-area-shapes"),
+};
+const ruleFunction = (primary) => (root, result) => {
+    if (!validateOptions(result, ruleName, {
+        actual: primary,
+        possible: [true],
+    })) {
+        return;
+    }
+    for (const template of collectGridTemplateAreas(root)) {
+        if (isEmpty(template.diagnostics)) {
+            for (const shape of getAreaShapes(template)) {
+                if (!isRectangularArea(template, shape)) {
+                    report({
+                        message: messages.rejected(shape.name),
+                        node: template.declaration,
+                        result,
+                        ruleName,
+                        word: shape.name,
+                    });
+                }
+            }
+        }
+    }
+};
+/** Public Stylelint rule definition. */
+const rule = createStylelintRule({
+    docs,
+    messages,
+    rule: ruleFunction,
+    ruleName,
+});
+export default rule;
+//# sourceMappingURL=validate-area-shapes.js.map

package/dist/rules/validate-area-shapes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-area-shapes.js","sourceRoot":"","sources":["../../src/rules/validate-area-shapes.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,EAAE,EAAiB,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACH,mBAAmB,GAEtB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACH,wBAAwB,EACxB,aAAa,EACb,iBAAiB,GACpB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACH,iBAAiB,EACjB,cAAc,GACjB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC;AAElE,MAAM,QAAQ,GAAG,cAAc,CAAC,sBAAsB,CAAC,CAAC;AACxD,MAAM,QAAQ,GAA+C,YAAY,CACrE,QAAQ,EACR;IACI,QAAQ,EAAE,CAAC,QAAgB,EAAU,EAAE,CACnC,cAAc,QAAQ,kEAAkE;CAC/F,CACJ,CAAC;AAEF,MAAM,IAAI,GAAG;IACT,WAAW,EACP,0EAA0E;IAC9E,WAAW,EAAE,IAAI;IACjB,GAAG,EAAE,iBAAiB,CAAC,sBAAsB,CAAC;CACxC,CAAC;AAEX,MAAM,YAAY,GACd,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;IAC1B,IACI,CAAC,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE;QAC/B,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,CAAC,IAAI,CAAC;KACnB,CAAC,EACJ,CAAC;QACC,OAAO;IACX,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC;QACpD,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAChC,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1C,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;oBACtC,MAAM,CAAC;wBACH,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;wBACtC,IAAI,EAAE,QAAQ,CAAC,WAAW;wBAC1B,MAAM;wBACN,QAAQ;wBACR,IAAI,EAAE,KAAK,CAAC,IAAI;qBACnB,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;AACL,CAAC,CAAC;AAEN,wCAAwC;AACxC,MAAM,IAAI,GACN,mBAAmB,CAAsC;IACrD,IAAI;IACJ,QAAQ;IACR,IAAI,EAAE,YAAY;IAClB,QAAQ;CACX,CAAC,CAAC;AAEP,eAAe,IAAI,CAAC"}

package/dist/rules/validate-track-counts.d.ts

@@ -0,0 +1,9 @@
+import { type StylelintPluginRule } from "../_internal/create-stylelint-rule.js";
+declare const messages: {
+    columns: (areaColumns: number, trackColumns: number) => string;
+    rows: (areaRows: number, trackRows: number) => string;
+};
+/** Public Stylelint rule definition. */
+declare const rule: StylelintPluginRule<boolean, undefined, typeof messages>;
+export default rule;
+//# sourceMappingURL=validate-track-counts.d.ts.map

package/dist/rules/validate-track-counts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-track-counts.d.ts","sourceRoot":"","sources":["../../src/rules/validate-track-counts.ts"],"names":[],"mappings":"AAGA,OAAO,EAEH,KAAK,mBAAmB,EAC3B,MAAM,uCAAuC,CAAC;AAc/C,QAAA,MAAM,QAAQ,EAAE;IACZ,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/D,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CAMxD,CAAC;AAwEH,wCAAwC;AACxC,QAAA,MAAM,IAAI,EAAE,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,QAAQ,CAM7D,CAAC;AAEP,eAAe,IAAI,CAAC"}

package/dist/rules/validate-track-counts.js

@@ -0,0 +1,67 @@
+import stylelint, {} from "stylelint";
+import { arrayFirst, isDefined, isEmpty } from "ts-extras";
+import { createStylelintRule, } from "../_internal/create-stylelint-rule.js";
+import { collectGridTemplateAreas, countGridTracks, findSiblingDeclaration, } from "../_internal/grid-template-analysis.js";
+import { createRuleDocsUrl, createRuleName, } from "../_internal/plugin-constants.js";
+const { report, ruleMessages, validateOptions } = stylelint.utils;
+const ruleName = createRuleName("validate-track-counts");
+const messages = ruleMessages(ruleName, {
+    columns: (areaColumns, trackColumns) => `\`grid-template-areas\` defines ${String(areaColumns)} columns, but sibling \`grid-template-columns\` defines ${String(trackColumns)} tracks.`,
+    rows: (areaRows, trackRows) => `\`grid-template-areas\` defines ${String(areaRows)} rows, but sibling \`grid-template-rows\` defines ${String(trackRows)} tracks.`,
+});
+const docs = {
+    description: "Require template row and column track counts to match `grid-template-areas` dimensions.",
+    recommended: true,
+    url: createRuleDocsUrl("validate-track-counts"),
+};
+const ruleFunction = (primary) => (root, result) => {
+    if (!validateOptions(result, ruleName, {
+        actual: primary,
+        possible: [true],
+    })) {
+        return;
+    }
+    for (const template of collectGridTemplateAreas(root)) {
+        const expectedColumns = arrayFirst(template.rows)?.length;
+        if (isEmpty(template.diagnostics) && isDefined(expectedColumns)) {
+            const expectedRows = template.rows.length;
+            const rowsDeclaration = findSiblingDeclaration(template.declaration, "grid-template-rows");
+            const columnsDeclaration = findSiblingDeclaration(template.declaration, "grid-template-columns");
+            const actualRows = isDefined(rowsDeclaration)
+                ? countGridTracks(rowsDeclaration.value)
+                : undefined;
+            const actualColumns = isDefined(columnsDeclaration)
+                ? countGridTracks(columnsDeclaration.value)
+                : undefined;
+            if (isDefined(rowsDeclaration) &&
+                isDefined(actualRows) &&
+                actualRows !== expectedRows) {
+                report({
+                    message: messages.rows(expectedRows, actualRows),
+                    node: rowsDeclaration,
+                    result,
+                    ruleName,
+                });
+            }
+            if (isDefined(columnsDeclaration) &&
+                isDefined(actualColumns) &&
+                actualColumns !== expectedColumns) {
+                report({
+                    message: messages.columns(expectedColumns, actualColumns),
+                    node: columnsDeclaration,
+                    result,
+                    ruleName,
+                });
+            }
+        }
+    }
+};
+/** Public Stylelint rule definition. */
+const rule = createStylelintRule({
+    docs,
+    messages,
+    rule: ruleFunction,
+    ruleName,
+});
+export default rule;
+//# sourceMappingURL=validate-track-counts.js.map

package/dist/rules/validate-track-counts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-track-counts.js","sourceRoot":"","sources":["../../src/rules/validate-track-counts.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,EAAE,EAAiB,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE3D,OAAO,EACH,mBAAmB,GAEtB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACH,wBAAwB,EACxB,eAAe,EACf,sBAAsB,GACzB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACH,iBAAiB,EACjB,cAAc,GACjB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC;AAElE,MAAM,QAAQ,GAAG,cAAc,CAAC,uBAAuB,CAAC,CAAC;AACzD,MAAM,QAAQ,GAGV,YAAY,CAAC,QAAQ,EAAE;IACvB,OAAO,EAAE,CAAC,WAAmB,EAAE,YAAoB,EAAU,EAAE,CAC3D,mCAAmC,MAAM,CAAC,WAAW,CAAC,2DAA2D,MAAM,CAAC,YAAY,CAAC,UAAU;IACnJ,IAAI,EAAE,CAAC,QAAgB,EAAE,SAAiB,EAAU,EAAE,CAClD,mCAAmC,MAAM,CAAC,QAAQ,CAAC,qDAAqD,MAAM,CAAC,SAAS,CAAC,UAAU;CAC1I,CAAC,CAAC;AAEH,MAAM,IAAI,GAAG;IACT,WAAW,EACP,yFAAyF;IAC7F,WAAW,EAAE,IAAI;IACjB,GAAG,EAAE,iBAAiB,CAAC,uBAAuB,CAAC;CACzC,CAAC;AAEX,MAAM,YAAY,GACd,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;IAC1B,IACI,CAAC,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE;QAC/B,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,CAAC,IAAI,CAAC;KACnB,CAAC,EACJ,CAAC;QACC,OAAO;IACX,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,eAAe,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAE1D,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC;YAC9D,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;YAC1C,MAAM,eAAe,GAAG,sBAAsB,CAC1C,QAAQ,CAAC,WAAW,EACpB,oBAAoB,CACvB,CAAC;YACF,MAAM,kBAAkB,GAAG,sBAAsB,CAC7C,QAAQ,CAAC,WAAW,EACpB,uBAAuB,CAC1B,CAAC;YACF,MAAM,UAAU,GAAG,SAAS,CAAC,eAAe,CAAC;gBACzC,CAAC,CAAC,eAAe,CAAC,eAAe,CAAC,KAAK,CAAC;gBACxC,CAAC,CAAC,SAAS,CAAC;YAChB,MAAM,aAAa,GAAG,SAAS,CAAC,kBAAkB,CAAC;gBAC/C,CAAC,CAAC,eAAe,CAAC,kBAAkB,CAAC,KAAK,CAAC;gBAC3C,CAAC,CAAC,SAAS,CAAC;YAEhB,IACI,SAAS,CAAC,eAAe,CAAC;gBAC1B,SAAS,CAAC,UAAU,CAAC;gBACrB,UAAU,KAAK,YAAY,EAC7B,CAAC;gBACC,MAAM,CAAC;oBACH,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC;oBAChD,IAAI,EAAE,eAAe;oBACrB,MAAM;oBACN,QAAQ;iBACX,CAAC,CAAC;YACP,CAAC;YAED,IACI,SAAS,CAAC,kBAAkB,CAAC;gBAC7B,SAAS,CAAC,aAAa,CAAC;gBACxB,aAAa,KAAK,eAAe,EACnC,CAAC;gBACC,MAAM,CAAC;oBACH,OAAO,EAAE,QAAQ,CAAC,OAAO,CACrB,eAAe,EACf,aAAa,CAChB;oBACD,IAAI,EAAE,kBAAkB;oBACxB,MAAM;oBACN,QAAQ;iBACX,CAAC,CAAC;YACP,CAAC;QACL,CAAC;IACL,CAAC;AACL,CAAC,CAAC;AAEN,wCAAwC;AACxC,MAAM,IAAI,GACN,mBAAmB,CAAsC;IACrD,IAAI;IACJ,QAAQ;IACR,IAAI,EAAE,YAAY;IAClB,QAAQ;CACX,CAAC,CAAC;AAEP,eAAe,IAAI,CAAC"}

package/docs/rules/configs/grid-all.md

@@ -0,0 +1,42 @@
+---
+title: Grid-all
+description: Complete shareable config for stylelint-plugin-grid.
+---
+
+# grid-all
+
+`gridPluginConfigs["grid-all"]` enables every public rule exported by this
+package.
+
+## Usage
+
+```js
+import { gridPluginConfigs } from "stylelint-plugin-grid";
+
+export default gridPluginConfigs["grid-all"];
+```
+
+Use this config after reading the
+[current static-analysis boundaries](../guides/current-status.md). Projects that
+split grid containers and items across files may prefer
+[`grid-recommended`](./grid-recommended.md) plus selected stricter rules.
+
+## Rules in this config
+
+**Fix legend:** 🔧 = autofixable · — = report only
+
+| Rule | Fix | Description |
+| --- | :-: | --- |
+| [`consistent-area-naming`](../consistent-area-naming.md) | — | Require consistent naming for `grid-template-areas` and single-name `grid-area` identifiers. |
+| [`no-dense-auto-flow`](../no-dense-auto-flow.md) | — | Disallow `grid-auto-flow: dense` because it can reorder auto-placed grid items visually. |
+| [`no-invalid-areas`](../no-invalid-areas.md) | — | Disallow malformed `grid-template-areas` declarations. |
+| [`no-invalid-auto-repeat`](../no-invalid-auto-repeat.md) | — | Disallow definitely invalid CSS Grid auto-repeat track sizes. |
+| [`no-invalid-minmax`](../no-invalid-minmax.md) | — | Disallow flexible `fr` values as the minimum argument in CSS Grid `minmax()` track sizes. |
+| [`no-mismatched-template-rows`](../no-mismatched-template-rows.md) | — | Require `grid-template-rows` track count to match `grid-template-areas` row count. |
+| [`no-overlapping-areas`](../no-overlapping-areas.md) | — | Disallow multiple selectors assigning the same single-name `grid-area` value in one stylesheet. |
+| [`no-unknown-areas`](../no-unknown-areas.md) | — | Disallow single-name `grid-area` references that do not match any named area declared in the same stylesheet. |
+| [`no-unused-areas`](../no-unused-areas.md) | — | Disallow named template areas that are never referenced by a single-name `grid-area` declaration in the same stylesheet. |
+| [`prefer-gap-properties`](../prefer-gap-properties.md) | 🔧 | Prefer modern `gap`, `row-gap`, and `column-gap` properties over legacy grid gap aliases. |
+| [`require-explicit-rows-with-column-flow`](../require-explicit-rows-with-column-flow.md) | — | Require explicit row sizing when a rule uses `grid-auto-flow: column`. |
+| [`validate-area-shapes`](../validate-area-shapes.md) | — | Require every named grid template area to form one contiguous rectangle. |
+| [`validate-track-counts`](../validate-track-counts.md) | — | Require template row and column track counts to match `grid-template-areas` dimensions. |

package/docs/rules/configs/grid-recommended.md

@@ -0,0 +1,37 @@
+---
+title: Grid-recommended
+description: Recommended shareable config for stylelint-plugin-grid.
+---
+
+# grid-recommended
+
+`gridPluginConfigs["grid-recommended"]` enables the low-noise CSS Grid rules
+that are safe for most stylesheets.
+
+## Usage
+
+```js
+import { gridPluginConfigs } from "stylelint-plugin-grid";
+
+export default gridPluginConfigs["grid-recommended"];
+```
+
+This config is the default starting point from
+[Getting Started](../getting-started.md). Move to [`grid-all`](./grid-all.md) only
+after checking the same-file assumptions documented in
+[Current Status](../guides/current-status.md).
+
+## Rules in this config
+
+**Fix legend:** 🔧 = autofixable · — = report only
+
+| Rule | Fix | Description |
+| --- | :-: | --- |
+| [`no-invalid-areas`](../no-invalid-areas.md) | — | Disallow malformed `grid-template-areas` declarations. |
+| [`no-invalid-auto-repeat`](../no-invalid-auto-repeat.md) | — | Disallow definitely invalid CSS Grid auto-repeat track sizes. |
+| [`no-invalid-minmax`](../no-invalid-minmax.md) | — | Disallow flexible `fr` values as the minimum argument in CSS Grid `minmax()` track sizes. |
+| [`no-mismatched-template-rows`](../no-mismatched-template-rows.md) | — | Require `grid-template-rows` track count to match `grid-template-areas` row count. |
+| [`no-unknown-areas`](../no-unknown-areas.md) | — | Disallow single-name `grid-area` references that do not match any named area declared in the same stylesheet. |
+| [`prefer-gap-properties`](../prefer-gap-properties.md) | 🔧 | Prefer modern `gap`, `row-gap`, and `column-gap` properties over legacy grid gap aliases. |
+| [`validate-area-shapes`](../validate-area-shapes.md) | — | Require every named grid template area to form one contiguous rectangle. |
+| [`validate-track-counts`](../validate-track-counts.md) | — | Require template row and column track counts to match `grid-template-areas` dimensions. |

package/docs/rules/configs/index.md

@@ -0,0 +1,46 @@
+---
+title: Configs
+description: Shareable Stylelint configs exported by stylelint-plugin-grid.
+---
+
+# Configs
+
+`stylelint-plugin-grid` exports two ESM-first shareable configs.
+
+| Config                                                                | Purpose                                                              |
+| --------------------------------------------------------------------- | -------------------------------------------------------------------- |
+| [🟢 — `gridPluginConfigs["grid-recommended"]`](./grid-recommended.md) | Low-noise checks for broadly applicable CSS Grid correctness.        |
+| [🟣 — `gridPluginConfigs["grid-all"]`](./grid-all.md)                 | Every public rule, including stricter same-stylesheet policy checks. |
+
+Use `grid-recommended` first, then move selected stricter rules into your local
+config after confirming they match your project's file boundaries.
+
+## Config Pages
+
+- [`grid-recommended`](./grid-recommended.md) enables the low-noise baseline.
+- [`grid-all`](./grid-all.md) enables every public rule, including same-stylesheet
+  policy checks.
+- [Current status](../guides/current-status.md) explains why some rules are kept
+  out of the recommended config.
+
+## Rules by Config
+
+**Fix legend:** 🔧 = autofixable · — = report only
+
+**Config legend:** ✅ = enabled · — = not enabled
+
+| Rule | Fix | [`grid-all`](./grid-all.md) | [`grid-recommended`](./grid-recommended.md) | Description |
+| --- | :-: | :-: | :-: | --- |
+| [`consistent-area-naming`](../consistent-area-naming.md) | — | ✅ | — | Require consistent naming for `grid-template-areas` and single-name `grid-area` identifiers. |
+| [`no-dense-auto-flow`](../no-dense-auto-flow.md) | — | ✅ | — | Disallow `grid-auto-flow: dense` because it can reorder auto-placed grid items visually. |
+| [`no-invalid-areas`](../no-invalid-areas.md) | — | ✅ | ✅ | Disallow malformed `grid-template-areas` declarations. |
+| [`no-invalid-auto-repeat`](../no-invalid-auto-repeat.md) | — | ✅ | ✅ | Disallow definitely invalid CSS Grid auto-repeat track sizes. |
+| [`no-invalid-minmax`](../no-invalid-minmax.md) | — | ✅ | ✅ | Disallow flexible `fr` values as the minimum argument in CSS Grid `minmax()` track sizes. |
+| [`no-mismatched-template-rows`](../no-mismatched-template-rows.md) | — | ✅ | ✅ | Require `grid-template-rows` track count to match `grid-template-areas` row count. |
+| [`no-overlapping-areas`](../no-overlapping-areas.md) | — | ✅ | — | Disallow multiple selectors assigning the same single-name `grid-area` value in one stylesheet. |
+| [`no-unknown-areas`](../no-unknown-areas.md) | — | ✅ | ✅ | Disallow single-name `grid-area` references that do not match any named area declared in the same stylesheet. |
+| [`no-unused-areas`](../no-unused-areas.md) | — | ✅ | — | Disallow named template areas that are never referenced by a single-name `grid-area` declaration in the same stylesheet. |
+| [`prefer-gap-properties`](../prefer-gap-properties.md) | 🔧 | ✅ | ✅ | Prefer modern `gap`, `row-gap`, and `column-gap` properties over legacy grid gap aliases. |
+| [`require-explicit-rows-with-column-flow`](../require-explicit-rows-with-column-flow.md) | — | ✅ | — | Require explicit row sizing when a rule uses `grid-auto-flow: column`. |
+| [`validate-area-shapes`](../validate-area-shapes.md) | — | ✅ | ✅ | Require every named grid template area to form one contiguous rectangle. |
+| [`validate-track-counts`](../validate-track-counts.md) | — | ✅ | ✅ | Require template row and column track counts to match `grid-template-areas` dimensions. |

package/docs/rules/consistent-area-naming.md

@@ -0,0 +1,41 @@
+# consistent-area-naming
+
+Require consistent naming for `grid-template-areas` and single-name `grid-area`
+identifiers.
+
+The default style is `kebab-case`. Secondary option `style` also accepts
+`camel-case` and `snake-case`.
+
+## Incorrect
+
+```css
+.layout {
+  grid-template-areas: "mainContent";
+}
+```
+
+## Correct
+
+```css
+.layout {
+  grid-template-areas: "main-content";
+}
+```
+
+## Options
+
+```js
+export default {
+  rules: {
+    "grid/consistent-area-naming": [true, { style: "snake-case" }]
+  }
+};
+```
+
+## Related Rules
+
+- [`no-invalid-areas`](./no-invalid-areas.md) enforces valid area tokens before
+  naming-style policy applies.
+- [`no-unused-areas`](./no-unused-areas.md) and
+  [`no-unknown-areas`](./no-unknown-areas.md) use the same named-area vocabulary.
+- [`grid-all`](./configs/grid-all.md) enables this stricter policy rule.

package/docs/rules/getting-started.md

@@ -0,0 +1,55 @@
+---
+title: Getting Started
+description: Install and configure stylelint-plugin-grid.
+---
+
+# Getting Started
+
+Install the plugin next to Stylelint:
+
+```sh
+npm install --save-dev stylelint stylelint-plugin-grid
+```
+
+Use the recommended config for a low-noise baseline:
+
+```js
+import { gridPluginConfigs } from "stylelint-plugin-grid";
+
+export default gridPluginConfigs["grid-recommended"];
+```
+
+Or extend a subpath config from a larger Stylelint config:
+
+```js
+export default {
+  extends: ["stylelint-plugin-grid/configs/grid-recommended"]
+};
+```
+
+Enable individual rules when you need a tighter policy:
+
+```js
+export default {
+  plugins: ["stylelint-plugin-grid"],
+  rules: {
+    "grid/no-invalid-areas": true,
+    "grid/validate-area-shapes": true,
+    "grid/no-unused-areas": true
+  }
+};
+```
+
+## Recommended Starting Point
+
+Start with `grid-recommended`. Add `grid-all` only after checking the same-file
+assumptions in `grid/no-unused-areas`, `grid/no-overlapping-areas`, and
+`grid/consistent-area-naming` against your project structure.
+
+## Related Docs
+
+- [Config reference](./configs/) explains what each exported config enables.
+- [Current status](./guides/current-status.md) documents what the rules skip on
+  purpose.
+- [`grid/no-invalid-areas`](./no-invalid-areas.md) is the first rule to understand
+because stricter template rules depend on parseable rows.

package/docs/rules/guides/current-status.md

@@ -0,0 +1,44 @@
+---
+title: Current Status
+description: Current scope of the CSS Grid safety rule catalog.
+---
+
+# Current Status
+
+The repository has been re-identified as `stylelint-plugin-grid` and now
+ships a focused CSS Grid rule catalog.
+
+## Stable Scope
+
+- Grid area template parsing is intentionally conservative.
+- Track-count validation handles explicit tracks and integer `repeat(...)`
+  notation.
+- Auto-repeat validation catches definitely invalid fixed-size mistakes while
+  avoiding runtime-dependent `var(...)` and `env(...)` values.
+- Rules skip dynamic values such as `var(...)`, `env(...)`, and multi-value
+  `grid-area` line placement when static analysis would be unreliable.
+
+## Deliberate Non-Goals
+
+- Inferring component relationships across files.
+- Guessing whether duplicate `grid-area` assignments are intentional overlays.
+- Inferring row sizing for column auto-placement from other selectors or cascade
+  branches.
+- Rewriting `grid-template-areas` strings automatically.
+
+Those choices keep the plugin useful on save instead of turning it into a noisy
+layout oracle.
+
+## Related Docs
+
+- [Getting Started](../getting-started.md) shows the recommended baseline config.
+- [`grid-all`](../configs/grid-all.md) includes the stricter same-stylesheet rules.
+- [`no-invalid-auto-repeat`](../no-invalid-auto-repeat.md) and
+  [`no-invalid-minmax`](../no-invalid-minmax.md) cover track sizing syntax that
+  browsers can reject.
+- [`no-dense-auto-flow`](../no-dense-auto-flow.md),
+  [`require-explicit-rows-with-column-flow`](../require-explicit-rows-with-column-flow.md),
+  [`no-unused-areas`](../no-unused-areas.md),
+  [`no-overlapping-areas`](../no-overlapping-areas.md), and
+  [`consistent-area-naming`](../consistent-area-naming.md) are the main rules to
+  review before opting into stricter policy checks.

package/docs/rules/no-dense-auto-flow.md

@@ -0,0 +1,57 @@
+# no-dense-auto-flow
+
+Disallow `grid-auto-flow: dense` because dense packing can reorder auto-placed
+grid items visually.
+
+Dense auto-placement backfills earlier holes with later items when they fit.
+That can make the visual order differ from source order, which is risky for
+keyboard navigation, reading order, and assistive technology expectations.
+
+This rule intentionally checks only the explicit `grid-auto-flow` property. It
+does not attempt to parse the `grid` shorthand, where quoted area names and
+implicit grid syntax make a conservative static check much noisier.
+
+## Incorrect
+
+```css
+.cards {
+  grid-auto-flow: dense;
+}
+```
+
+```css
+.cards {
+  grid-auto-flow: column dense;
+}
+```
+
+## Correct
+
+```css
+.cards {
+  grid-auto-flow: row;
+}
+```
+
+```css
+.cards {
+  grid-auto-flow: column;
+}
+```
+
+## Stylelint Config
+
+```js
+export default {
+  plugins: ["stylelint-plugin-grid"],
+  rules: {
+    "grid/no-dense-auto-flow": true
+  }
+};
+```
+
+## Related Rules
+
+- [`no-overlapping-areas`](./no-overlapping-areas.md) catches another class of
+  layout-order hazards from duplicate named area assignments.
+- [`grid-all`](./configs/grid-all.md) enables this stricter policy rule.