stylelint-plugin-grid 1.0.1 → 1.0.2

package/dist/rules/prefer-minmax-zero-fr.js

@@ -0,0 +1,56 @@
+import stylelint, {} from "stylelint";
+import { setHas } from "ts-extras";
+import { createStylelintRule, } from "../_internal/create-stylelint-rule.js";
+import { splitTopLevelWhitespace } from "../_internal/grid-template-analysis.js";
+import { createRuleDocsUrl, createRuleName, } from "../_internal/plugin-constants.js";
+const { report, ruleMessages, validateOptions } = stylelint.utils;
+const ruleName = createRuleName("prefer-minmax-zero-fr");
+const messages = ruleMessages(ruleName, {
+    rejected: (track) => `Wrap bare flexible column track \`${track}\` in \`minmax(0, ${track})\` to avoid content-driven overflow.`,
+});
+const docs = {
+    description: "Prefer `minmax(0, <flex>)` for bare flexible CSS Grid column tracks.",
+    recommended: false,
+    url: createRuleDocsUrl("prefer-minmax-zero-fr"),
+};
+const ignoredTrackKeywords = new Set([
+    "masonry",
+    "none",
+    "subgrid",
+]);
+const flexTrackPattern = /^\+?(?:\d+|\d*\.\d+)fr$/v;
+function isBareFlexibleTrack(token) {
+    const normalizedToken = token.toLowerCase();
+    return (!setHas(ignoredTrackKeywords, normalizedToken) &&
+        flexTrackPattern.test(normalizedToken));
+}
+const ruleFunction = (primary) => (root, result) => {
+    if (!validateOptions(result, ruleName, {
+        actual: primary,
+        possible: [true],
+    })) {
+        return;
+    }
+    root.walkDecls("grid-template-columns", (declaration) => {
+        for (const token of splitTopLevelWhitespace(declaration.value)) {
+            if (isBareFlexibleTrack(token)) {
+                report({
+                    message: messages.rejected(token),
+                    node: declaration,
+                    result,
+                    ruleName,
+                    word: token,
+                });
+            }
+        }
+    });
+};
+/** Public Stylelint rule definition. */
+const rule = createStylelintRule({
+    docs,
+    messages,
+    rule: ruleFunction,
+    ruleName,
+});
+export default rule;
+//# sourceMappingURL=prefer-minmax-zero-fr.js.map

package/dist/rules/prefer-minmax-zero-fr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefer-minmax-zero-fr.js","sourceRoot":"","sources":["../../src/rules/prefer-minmax-zero-fr.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,EAAE,EAAiB,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,EACH,mBAAmB,GAEtB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,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,GAA4C,YAAY,CAClE,QAAQ,EACR;IACI,QAAQ,EAAE,CAAC,KAAa,EAAU,EAAE,CAChC,qCAAqC,KAAK,qBAAqB,KAAK,uCAAuC;CAClH,CACJ,CAAC;AAEF,MAAM,IAAI,GAAG;IACT,WAAW,EACP,sEAAsE;IAC1E,WAAW,EAAE,KAAK;IAClB,GAAG,EAAE,iBAAiB,CAAC,uBAAuB,CAAC;CACzC,CAAC;AAEX,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC;IACtD,SAAS;IACT,MAAM;IACN,SAAS;CACZ,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,0BAA0B,CAAC;AAEpD,SAAS,mBAAmB,CAAC,KAAa;IACtC,MAAM,eAAe,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAE5C,OAAO,CACH,CAAC,MAAM,CAAC,oBAAoB,EAAE,eAAe,CAAC;QAC9C,gBAAgB,CAAC,IAAI,CAAC,eAAe,CAAC,CACzC,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,uBAAuB,EAAE,CAAC,WAAW,EAAE,EAAE;QACpD,KAAK,MAAM,KAAK,IAAI,uBAAuB,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7D,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,MAAM,CAAC;oBACH,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;oBACjC,IAAI,EAAE,WAAW;oBACjB,MAAM;oBACN,QAAQ;oBACR,IAAI,EAAE,KAAK;iBACd,CAAC,CAAC;YACP,CAAC;QACL,CAAC;IACL,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/require-explicit-tracks-with-areas.d.ts

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

package/dist/rules/require-explicit-tracks-with-areas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-explicit-tracks-with-areas.d.ts","sourceRoot":"","sources":["../../src/rules/require-explicit-tracks-with-areas.ts"],"names":[],"mappings":"AAGA,OAAO,EAEH,KAAK,mBAAmB,EAC3B,MAAM,uCAAuC,CAAC;AAc/C,KAAK,gBAAgB,GAAG,QAAQ,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC,CAAC;AAEH,QAAA,MAAM,QAAQ,EAAE;IAAE,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,CAAA;CAM3D,CAAC;AAwEF,wCAAwC;AACxC,QAAA,MAAM,IAAI,EAAE,mBAAmB,CAC3B,OAAO,EACP,gBAAgB,GAAG,SAAS,EAC5B,OAAO,QAAQ,CAQlB,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/rules/require-explicit-tracks-with-areas.js

@@ -0,0 +1,65 @@
+import stylelint, {} from "stylelint";
+import { isEmpty } from "ts-extras";
+import { createStylelintRule, } from "../_internal/create-stylelint-rule.js";
+import { collectGridTemplateAreas, findSiblingDeclaration, } 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-tracks-with-areas");
+const messages = ruleMessages(ruleName, {
+    rejected: (propertyName) => `Pair \`grid-template-areas\` with \`${propertyName}\` in the same block so named areas have explicit track sizing.`,
+});
+const docs = {
+    description: "Require explicit track sizing alongside CSS Grid named area templates.",
+    recommended: false,
+    url: createRuleDocsUrl("require-explicit-tracks-with-areas"),
+};
+const ruleFunction = (primary, secondary) => (root, result) => {
+    if (!validateOptions(result, ruleName, {
+        actual: primary,
+        possible: [true],
+    }, {
+        actual: secondary,
+        optional: true,
+        possible: {
+            columns: [true, false],
+            rows: [true, false],
+        },
+    })) {
+        return;
+    }
+    const requireColumns = secondary?.columns ?? true;
+    const requireRows = secondary?.rows ?? false;
+    for (const template of collectGridTemplateAreas(root)) {
+        if (isEmpty(template.diagnostics)) {
+            if (requireColumns &&
+                !findSiblingDeclaration(template.declaration, "grid-template-columns")) {
+                report({
+                    message: messages.rejected("grid-template-columns"),
+                    node: template.declaration,
+                    result,
+                    ruleName,
+                    word: template.declaration.prop,
+                });
+            }
+            if (requireRows &&
+                !findSiblingDeclaration(template.declaration, "grid-template-rows")) {
+                report({
+                    message: messages.rejected("grid-template-rows"),
+                    node: template.declaration,
+                    result,
+                    ruleName,
+                    word: template.declaration.prop,
+                });
+            }
+        }
+    }
+};
+/** Public Stylelint rule definition. */
+const rule = createStylelintRule({
+    docs,
+    messages,
+    rule: ruleFunction,
+    ruleName,
+});
+export default rule;
+//# sourceMappingURL=require-explicit-tracks-with-areas.js.map

package/dist/rules/require-explicit-tracks-with-areas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-explicit-tracks-with-areas.js","sourceRoot":"","sources":["../../src/rules/require-explicit-tracks-with-areas.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,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,oCAAoC,CAAC,CAAC;AAOtE,MAAM,QAAQ,GAAmD,YAAY,CACzE,QAAQ,EACR;IACI,QAAQ,EAAE,CAAC,YAAoB,EAAU,EAAE,CACvC,uCAAuC,YAAY,iEAAiE;CAC3H,CACJ,CAAC;AAEF,MAAM,IAAI,GAAG;IACT,WAAW,EACP,wEAAwE;IAC5E,WAAW,EAAE,KAAK;IAClB,GAAG,EAAE,iBAAiB,CAAC,oCAAoC,CAAC;CACtD,CAAC;AAEX,MAAM,YAAY,GACd,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;IACrC,IACI,CAAC,eAAe,CACZ,MAAM,EACN,QAAQ,EACR;QACI,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,CAAC,IAAI,CAAC;KACnB,EACD;QACI,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE;YACN,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC;YACtB,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC;SACtB;KACJ,CACJ,EACH,CAAC;QACC,OAAO;IACX,CAAC;IAED,MAAM,cAAc,GAAG,SAAS,EAAE,OAAO,IAAI,IAAI,CAAC;IAClD,MAAM,WAAW,GAAG,SAAS,EAAE,IAAI,IAAI,KAAK,CAAC;IAE7C,KAAK,MAAM,QAAQ,IAAI,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC;QACpD,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAChC,IACI,cAAc;gBACd,CAAC,sBAAsB,CACnB,QAAQ,CAAC,WAAW,EACpB,uBAAuB,CAC1B,EACH,CAAC;gBACC,MAAM,CAAC;oBACH,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,uBAAuB,CAAC;oBACnD,IAAI,EAAE,QAAQ,CAAC,WAAW;oBAC1B,MAAM;oBACN,QAAQ;oBACR,IAAI,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI;iBAClC,CAAC,CAAC;YACP,CAAC;YAED,IACI,WAAW;gBACX,CAAC,sBAAsB,CACnB,QAAQ,CAAC,WAAW,EACpB,oBAAoB,CACvB,EACH,CAAC;gBACC,MAAM,CAAC;oBACH,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC;oBAChD,IAAI,EAAE,QAAQ,CAAC,WAAW;oBAC1B,MAAM;oBACN,QAAQ;oBACR,IAAI,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI;iBAClC,CAAC,CAAC;YACP,CAAC;QACL,CAAC;IACL,CAAC;AACL,CAAC,CAAC;AAEN,wCAAwC;AACxC,MAAM,IAAI,GAIN,mBAAmB,CACnB;IACI,IAAI;IACJ,QAAQ;IACR,IAAI,EAAE,YAAY;IAClB,QAAQ;CACX,CACJ,CAAC;AAEF,eAAe,IAAI,CAAC"}

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

@@ -28,15 +28,23 @@ split grid containers and items across files may prefer
 | Rule | Fix | Description |
 | --- | :-: | --- |
 | [`consistent-area-naming`](../consistent-area-naming.md) | — | Require consistent naming for `grid-template-areas` and single-name `grid-area` identifiers. |
+| [`no-conflicting-placement`](../no-conflicting-placement.md) | — | Disallow same-block CSS Grid placement declarations that write the same placement slot. |
 | [`no-dense-auto-flow`](../no-dense-auto-flow.md) | — | Disallow `grid-auto-flow: dense` because it can reorder auto-placed grid items visually. |
+| [`no-ineffective-container-properties`](../no-ineffective-container-properties.md) | — | Disallow CSS Grid container declarations in blocks whose final literal display value is not grid-capable. |
 | [`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-invalid-repeat-count`](../no-invalid-repeat-count.md) | — | Disallow invalid fixed repeat counts in CSS Grid track templates. |
+| [`no-invalid-span`](../no-invalid-span.md) | — | Disallow non-positive `span` counts in CSS Grid placement declarations. |
 | [`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-reversed-placement-lines`](../no-reversed-placement-lines.md) | — | Disallow reversed or zero-width numeric CSS Grid placement line ranges. |
 | [`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. |
+| [`no-zero-grid-lines`](../no-zero-grid-lines.md) | — | Disallow line `0` in CSS Grid placement declarations. |
 | [`prefer-gap-properties`](../prefer-gap-properties.md) | 🔧 | Prefer modern `gap`, `row-gap`, and `column-gap` properties over legacy grid gap aliases. |
+| [`prefer-minmax-zero-fr`](../prefer-minmax-zero-fr.md) | — | Prefer `minmax(0, <flex>)` for bare flexible CSS Grid column tracks. |
 | [`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`. |
+| [`require-explicit-tracks-with-areas`](../require-explicit-tracks-with-areas.md) | — | Require explicit track sizing alongside CSS Grid named area templates. |
 | [`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

@@ -27,11 +27,17 @@ after checking the same-file assumptions documented in
 
 | Rule | Fix | Description |
 | --- | :-: | --- |
+| [`no-conflicting-placement`](../no-conflicting-placement.md) | — | Disallow same-block CSS Grid placement declarations that write the same placement slot. |
+| [`no-ineffective-container-properties`](../no-ineffective-container-properties.md) | — | Disallow CSS Grid container declarations in blocks whose final literal display value is not grid-capable. |
 | [`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-invalid-repeat-count`](../no-invalid-repeat-count.md) | — | Disallow invalid fixed repeat counts in CSS Grid track templates. |
+| [`no-invalid-span`](../no-invalid-span.md) | — | Disallow non-positive `span` counts in CSS Grid placement declarations. |
 | [`no-mismatched-template-rows`](../no-mismatched-template-rows.md) | — | Require `grid-template-rows` track count to match `grid-template-areas` row count. |
+| [`no-reversed-placement-lines`](../no-reversed-placement-lines.md) | — | Disallow reversed or zero-width numeric CSS Grid placement line ranges. |
 | [`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-zero-grid-lines`](../no-zero-grid-lines.md) | — | Disallow line `0` in CSS Grid placement declarations. |
 | [`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

@@ -32,15 +32,23 @@ config after confirming they match your project's file boundaries.
 | 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-conflicting-placement`](../no-conflicting-placement.md) | — | ✅ | ✅ | Disallow same-block CSS Grid placement declarations that write the same placement slot. |
 | [`no-dense-auto-flow`](../no-dense-auto-flow.md) | — | ✅ | — | Disallow `grid-auto-flow: dense` because it can reorder auto-placed grid items visually. |
+| [`no-ineffective-container-properties`](../no-ineffective-container-properties.md) | — | ✅ | ✅ | Disallow CSS Grid container declarations in blocks whose final literal display value is not grid-capable. |
 | [`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-invalid-repeat-count`](../no-invalid-repeat-count.md) | — | ✅ | ✅ | Disallow invalid fixed repeat counts in CSS Grid track templates. |
+| [`no-invalid-span`](../no-invalid-span.md) | — | ✅ | ✅ | Disallow non-positive `span` counts in CSS Grid placement declarations. |
 | [`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-reversed-placement-lines`](../no-reversed-placement-lines.md) | — | ✅ | ✅ | Disallow reversed or zero-width numeric CSS Grid placement line ranges. |
 | [`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. |
+| [`no-zero-grid-lines`](../no-zero-grid-lines.md) | — | ✅ | ✅ | Disallow line `0` in CSS Grid placement declarations. |
 | [`prefer-gap-properties`](../prefer-gap-properties.md) | 🔧 | ✅ | ✅ | Prefer modern `gap`, `row-gap`, and `column-gap` properties over legacy grid gap aliases. |
+| [`prefer-minmax-zero-fr`](../prefer-minmax-zero-fr.md) | — | ✅ | — | Prefer `minmax(0, <flex>)` for bare flexible CSS Grid column tracks. |
 | [`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`. |
+| [`require-explicit-tracks-with-areas`](../require-explicit-tracks-with-areas.md) | — | ✅ | — | Require explicit track sizing alongside CSS Grid named area templates. |
 | [`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/no-conflicting-placement.md

@@ -0,0 +1,59 @@
+# no-conflicting-placement
+
+Disallow same-block CSS Grid placement declarations that write the same
+placement slot.
+
+Grid placement shorthands and longhands override shared row and column slots.
+Keeping competing declarations in one block usually leaves stale CSS behind and
+makes later edits risky. Use one placement strategy per block.
+
+## Incorrect
+
+```css
+.item {
+  grid-area: sidebar;
+  grid-column: 2 / 4;
+}
+```
+
+```css
+.item {
+  grid-column: 1 / 3;
+  grid-column-start: 2;
+}
+```
+
+## Correct
+
+```css
+.item {
+  grid-area: sidebar;
+}
+```
+
+```css
+.item {
+  grid-row: 1 / 3;
+  grid-column: 2 / 4;
+}
+```
+
+## Stylelint Config
+
+```js
+export default {
+  plugins: ["stylelint-plugin-grid"],
+  rules: {
+    "grid/no-conflicting-placement": true
+  }
+};
+```
+
+## Related Rules
+
+- [`no-reversed-placement-lines`](./no-reversed-placement-lines.md) checks
+  numeric placement ranges.
+- [`no-zero-grid-lines`](./no-zero-grid-lines.md) rejects line `0` in placement
+  values.
+- [`grid-recommended`](./configs/grid-recommended.md) enables this rule by
+  default.

package/docs/rules/no-ineffective-container-properties.md

@@ -0,0 +1,63 @@
+# no-ineffective-container-properties
+
+Disallow CSS Grid container declarations in blocks whose final literal
+`display` value is not grid-capable.
+
+Properties such as `grid-template-columns` and `grid-auto-flow` only define a
+grid container when the element computes to `display: grid` or
+`display: inline-grid`. If the same block ends with `display: contents`,
+`display: flex`, or another known non-grid value, those declarations are
+ineffective.
+
+## Incorrect
+
+```css
+.layout {
+  display: contents;
+  grid-template-columns: 1fr 1fr;
+}
+```
+
+```css
+.layout {
+  display: grid;
+  display: flex;
+  grid-template-areas: "main side";
+}
+```
+
+## Correct
+
+```css
+.layout {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) 16rem;
+}
+```
+
+```css
+.layout {
+  display: var(--layout-display);
+  grid-template-areas: "main";
+}
+```
+
+## Stylelint Config
+
+```js
+export default {
+  plugins: ["stylelint-plugin-grid"],
+  rules: {
+    "grid/no-ineffective-container-properties": true
+  }
+};
+```
+
+## Related Rules
+
+- [`validate-track-counts`](./validate-track-counts.md) compares explicit track
+  counts with named area templates.
+- [`require-explicit-tracks-with-areas`](./require-explicit-tracks-with-areas.md)
+  requires explicit track sizing for named area templates.
+- [`grid-recommended`](./configs/grid-recommended.md) enables this rule by
+  default.

package/docs/rules/no-invalid-repeat-count.md

@@ -0,0 +1,56 @@
+# no-invalid-repeat-count
+
+Disallow invalid fixed repeat counts in CSS Grid track templates.
+
+The first argument to a fixed `repeat()` must be a positive integer. Counts such
+as `0`, negative numbers, and decimals make the track template invalid. This
+rule leaves `auto-fit`, `auto-fill`, and dynamic values to the rules that own
+those cases.
+
+## Incorrect
+
+```css
+.layout {
+  grid-template-columns: repeat(0, 1fr);
+}
+```
+
+```css
+.layout {
+  grid-template-rows: repeat(2.5, auto);
+}
+```
+
+## Correct
+
+```css
+.layout {
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+}
+```
+
+```css
+.layout {
+  grid-template-columns: repeat(auto-fit, minmax(12rem, 1fr));
+}
+```
+
+## Stylelint Config
+
+```js
+export default {
+  plugins: ["stylelint-plugin-grid"],
+  rules: {
+    "grid/no-invalid-repeat-count": true
+  }
+};
+```
+
+## Related Rules
+
+- [`no-invalid-auto-repeat`](./no-invalid-auto-repeat.md) checks track sizes
+  inside `repeat(auto-fit, ...)` and `repeat(auto-fill, ...)`.
+- [`validate-track-counts`](./validate-track-counts.md) compares expanded track
+  counts with named area templates.
+- [`grid-recommended`](./configs/grid-recommended.md) enables this rule by
+  default.

package/docs/rules/no-invalid-span.md

@@ -0,0 +1,55 @@
+# no-invalid-span
+
+Disallow non-positive `span` counts in CSS Grid placement declarations.
+
+Grid spans must move across at least one track. Values such as `span 0` and
+`span -1` cannot place an item usefully and usually make the declaration
+invalid or ignored.
+
+## Incorrect
+
+```css
+.item {
+  grid-column: span 0 / span 2;
+}
+```
+
+```css
+.item {
+  grid-row-start: span -1;
+}
+```
+
+## Correct
+
+```css
+.item {
+  grid-column: span 2 / sidebar-end;
+}
+```
+
+```css
+.item {
+  grid-row-start: span var(--rows);
+}
+```
+
+## Stylelint Config
+
+```js
+export default {
+  plugins: ["stylelint-plugin-grid"],
+  rules: {
+    "grid/no-invalid-span": true
+  }
+};
+```
+
+## Related Rules
+
+- [`no-zero-grid-lines`](./no-zero-grid-lines.md) rejects line `0` in placement
+  values.
+- [`no-reversed-placement-lines`](./no-reversed-placement-lines.md) checks
+  numeric placement ranges.
+- [`grid-recommended`](./configs/grid-recommended.md) enables this rule by
+  default.

package/docs/rules/no-reversed-placement-lines.md

@@ -0,0 +1,56 @@
+# no-reversed-placement-lines
+
+Disallow reversed or zero-width numeric CSS Grid placement line ranges.
+
+Numeric line ranges such as `grid-column: 4 / 2` and `grid-row: 3 / 3` do not
+describe a forward span across tracks. This rule only compares plain numeric
+line pairs in the same block and ignores named lines, spans, mixed signs, and
+dynamic values.
+
+## Incorrect
+
+```css
+.item {
+  grid-column: 4 / 2;
+}
+```
+
+```css
+.item {
+  grid-row-start: 7;
+  grid-row-end: 6;
+}
+```
+
+## Correct
+
+```css
+.item {
+  grid-column: 2 / 4;
+}
+```
+
+```css
+.item {
+  grid-row: span 2 / 5;
+}
+```
+
+## Stylelint Config
+
+```js
+export default {
+  plugins: ["stylelint-plugin-grid"],
+  rules: {
+    "grid/no-reversed-placement-lines": true
+  }
+};
+```
+
+## Related Rules
+
+- [`no-invalid-span`](./no-invalid-span.md) rejects non-positive span counts.
+- [`no-zero-grid-lines`](./no-zero-grid-lines.md) rejects line `0` in placement
+  values.
+- [`grid-recommended`](./configs/grid-recommended.md) enables this rule by
+  default.

package/docs/rules/no-zero-grid-lines.md

@@ -0,0 +1,53 @@
+# no-zero-grid-lines
+
+Disallow line `0` in CSS Grid placement declarations.
+
+CSS Grid line numbering starts at `1` from the start edge and `-1` from the end
+edge. Line `0` does not exist, so placement values using `0` are invalid.
+
+## Incorrect
+
+```css
+.item {
+  grid-column: 0 / 2;
+}
+```
+
+```css
+.item {
+  grid-row-end: 0;
+}
+```
+
+## Correct
+
+```css
+.item {
+  grid-column: 1 / -1;
+}
+```
+
+```css
+.item {
+  grid-row: var(--row-start) / var(--row-end);
+}
+```
+
+## Stylelint Config
+
+```js
+export default {
+  plugins: ["stylelint-plugin-grid"],
+  rules: {
+    "grid/no-zero-grid-lines": true
+  }
+};
+```
+
+## Related Rules
+
+- [`no-invalid-span`](./no-invalid-span.md) rejects non-positive span counts.
+- [`no-reversed-placement-lines`](./no-reversed-placement-lines.md) checks
+  numeric placement ranges.
+- [`grid-recommended`](./configs/grid-recommended.md) enables this rule by
+  default.

package/docs/rules/prefer-minmax-zero-fr.md

@@ -0,0 +1,49 @@
+# prefer-minmax-zero-fr
+
+Prefer `minmax(0, <flex>)` for bare flexible CSS Grid column tracks.
+
+Bare `fr` column tracks use an automatic minimum size, so long content can
+force columns wider than intended. Wrapping the flexible track in `minmax(0, …)`
+keeps the column flexible while allowing content to shrink or overflow according
+to the rest of the layout rules.
+
+## Incorrect
+
+```css
+.layout {
+  grid-template-columns: 1fr 2fr;
+}
+```
+
+## Correct
+
+```css
+.layout {
+  grid-template-columns: minmax(0, 1fr) minmax(0, 2fr);
+}
+```
+
+```css
+.layout {
+  grid-template-columns: repeat(2, 1fr);
+}
+```
+
+## Stylelint Config
+
+```js
+export default {
+  plugins: ["stylelint-plugin-grid"],
+  rules: {
+    "grid/prefer-minmax-zero-fr": true
+  }
+};
+```
+
+## Related Rules
+
+- [`no-invalid-minmax`](./no-invalid-minmax.md) rejects flexible minimums inside
+  `minmax()`.
+- [`no-invalid-auto-repeat`](./no-invalid-auto-repeat.md) checks auto-repeat
+  track sizes.
+- [`grid-all`](./configs/grid-all.md) enables this optional rule.