stylelint-plugin-grid 1.0.1 → 1.0.3

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

@@ -25,18 +25,26 @@ split grid containers and items across files may prefer
 
 **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. |
+| 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

@@ -25,13 +25,19 @@ after checking the same-file assumptions documented in
 
 **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. |
+| 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

@@ -29,18 +29,26 @@ config after confirming they match your project's file boundaries.
 
 **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. |
+| 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/consistent-area-naming.md

@@ -10,7 +10,7 @@ The default style is `kebab-case`. Secondary option `style` also accepts
 
 ```css
 .layout {
-  grid-template-areas: "mainContent";
+ grid-template-areas: "mainContent";
 }
 ```
 
@@ -18,7 +18,7 @@ The default style is `kebab-case`. Secondary option `style` also accepts
 
 ```css
 .layout {
-  grid-template-areas: "main-content";
+ grid-template-areas: "main-content";
 }
 ```
 
@@ -26,9 +26,9 @@ The default style is `kebab-case`. Secondary option `style` also accepts
 
 ```js
 export default {
-  rules: {
-    "grid/consistent-area-naming": [true, { style: "snake-case" }]
-  }
+ rules: {
+  "grid/consistent-area-naming": [true, { style: "snake-case" }],
+ },
 };
 ```
 

package/docs/rules/getting-started.md

@@ -23,7 +23,7 @@ Or extend a subpath config from a larger Stylelint config:
 
 ```js
 export default {
-  extends: ["stylelint-plugin-grid/configs/grid-recommended"]
+ extends: ["stylelint-plugin-grid/configs/grid-recommended"],
 };
 ```
 
@@ -31,12 +31,12 @@ 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
-  }
+ plugins: ["stylelint-plugin-grid"],
+ rules: {
+  "grid/no-invalid-areas": true,
+  "grid/validate-area-shapes": true,
+  "grid/no-unused-areas": true,
+ },
 };
 ```
 
@@ -52,4 +52,4 @@ assumptions in `grid/no-unused-areas`, `grid/no-overlapping-areas`, and
 - [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.
+  because stricter template rules depend on parseable rows.

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-dense-auto-flow.md

@@ -15,13 +15,13 @@ implicit grid syntax make a conservative static check much noisier.
 
 ```css
 .cards {
-  grid-auto-flow: dense;
+ grid-auto-flow: dense;
 }
 ```
 
 ```css
 .cards {
-  grid-auto-flow: column dense;
+ grid-auto-flow: column dense;
 }
 ```
 
@@ -29,13 +29,13 @@ implicit grid syntax make a conservative static check much noisier.
 
 ```css
 .cards {
-  grid-auto-flow: row;
+ grid-auto-flow: row;
 }
 ```
 
 ```css
 .cards {
-  grid-auto-flow: column;
+ grid-auto-flow: column;
 }
 ```
 
@@ -43,10 +43,10 @@ implicit grid syntax make a conservative static check much noisier.
 
 ```js
 export default {
-  plugins: ["stylelint-plugin-grid"],
-  rules: {
-    "grid/no-dense-auto-flow": true
-  }
+ plugins: ["stylelint-plugin-grid"],
+ rules: {
+  "grid/no-dense-auto-flow": true,
+ },
 };
 ```
 

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-areas.md

@@ -12,15 +12,15 @@ This rule reports:
 
 ```css
 .layout {
-  grid-template-areas:
-    "header header"
-    "nav";
+ grid-template-areas:
+  "header header"
+  "nav";
 }
 ```
 
 ```css
 .layout {
-  grid-template-areas: "main 1bad";
+ grid-template-areas: "main 1bad";
 }
 ```
 
@@ -28,9 +28,9 @@ This rule reports:
 
 ```css
 .layout {
-  grid-template-areas:
-    "header header"
-    "nav main";
+ grid-template-areas:
+  "header header"
+  "nav main";
 }
 ```
 
@@ -38,10 +38,10 @@ This rule reports:
 
 ```js
 export default {
-  plugins: ["stylelint-plugin-grid"],
-  rules: {
-    "grid/no-invalid-areas": true
-  }
+ plugins: ["stylelint-plugin-grid"],
+ rules: {
+  "grid/no-invalid-areas": true,
+ },
 };
 ```
 

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

@@ -13,13 +13,13 @@ reporting runtime-dependent values such as `var()` and `env()`.
 
 ```css
 .cards {
-  grid-template-columns: repeat(auto-fit, 1fr);
+ grid-template-columns: repeat(auto-fit, 1fr);
 }
 ```
 
 ```css
 .cards {
-  grid-template-columns: repeat(auto-fill, minmax(auto, 1fr));
+ grid-template-columns: repeat(auto-fill, minmax(auto, 1fr));
 }
 ```
 
@@ -27,13 +27,13 @@ reporting runtime-dependent values such as `var()` and `env()`.
 
 ```css
 .cards {
-  grid-template-columns: repeat(auto-fit, minmax(12rem, 1fr));
+ grid-template-columns: repeat(auto-fit, minmax(12rem, 1fr));
 }
 ```
 
 ```css
 .cards {
-  grid-template-columns: repeat(auto-fill, [card] minmax(0, 1fr));
+ grid-template-columns: repeat(auto-fill, [card] minmax(0, 1fr));
 }
 ```
 
@@ -41,10 +41,10 @@ reporting runtime-dependent values such as `var()` and `env()`.
 
 ```js
 export default {
-  plugins: ["stylelint-plugin-grid"],
-  rules: {
-    "grid/no-invalid-auto-repeat": true
-  }
+ plugins: ["stylelint-plugin-grid"],
+ rules: {
+  "grid/no-invalid-auto-repeat": true,
+ },
 };
 ```