codelaw-rules-scss 0.3.0__py3-none-any.whl

codelaw_rules_scss/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2026 Arpit Arya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+SPDX-License-Identifier: MIT

codelaw_rules_scss/NOTICE

@@ -0,0 +1,19 @@
+@codelaw/rules-scss / codelaw-rules-scss
+
+The rules are reimplementations written for codelaw. Their `ported_from:`
+fields name the stylelint-scss rules (https://github.com/stylelint-scss/stylelint-scss,
+MIT License, Copyright (c) 2015 - present stylelint-scss contributors) and
+the stylelint rule (https://stylelint.io, MIT License) whose documented
+behaviour they reproduce; no stylelint-scss or stylelint code or
+documentation text is included. `scss/no-import`, `scss/no-slash-division`
+and `scss/double-slash-comment-empty` follow Dart Sass's deprecations
+(https://sass-lang.com/documentation/breaking-changes/) and have no source
+rule.
+
+The data tables in data/scss/ are lists of names:
+
+- at-rules.json: the CSS at-rule names of codelaw-rules-css's table
+  (extracted from stylelint 17.16.0's reference lists, MIT License) and
+  Sass's own at-rule names.
+- functions.json: CSS function names (from the CSS specifications) and the
+  names of Dart Sass's built-in functions (https://sass-lang.com/documentation/modules/).

codelaw_rules_scss/README.md

@@ -0,0 +1,57 @@
+# @codelaw/rules-scss · codelaw-rules-scss
+
+codelaw's rules for SCSS (Sass's `.scss` syntax) — one of the first-party rule
+packs ([SR-RULE-PACKS](../../records/0101_rule-packs.md)). The same files ship on
+npm as `@codelaw/rules-scss` and on PyPI as `codelaw-rules-scss`.
+
+SCSS is a CSS dialect under [L3](../../records/0005_LAW-3-languages.md) (amended
+2026-10-26): `codelaw format` and `codelaw check` read `.scss` files with their
+own grammar, and **the `css/*` rules of `@codelaw/rules-css` also run on SCSS**
+where they declare `scss` — install both packs in an SCSS project. The indented
+`.sass` syntax and Less are out of scope.
+
+```toml
+# codelaw.toml
+extends = ["codelaw:css/recommended", "codelaw:scss/recommended"]
+preview = true   # every rule is `preview` until a corpus run promotes it
+```
+
+## Presets
+
+<!-- docs-sync:presets -->
+
+| preset | rules | ported from |
+|---|---|---|
+| `scss/recommended` | 7 | correctness: at-rule-no-unknown, duplicate definitions, `@extend` placeholders, null tests, empty comments, partial names |
+| `scss/strict` | 15 | the additions to `scss/recommended` (it extends it): Dart Sass's module migrations (no `@import`, no global function names, no slash division), unknown functions, naming patterns and a nesting limit |
+
+<!-- /docs-sync:presets -->
+
+`scss/no-import` is in `strict`, not `recommended`: a codebase that still uses `@import` moves to
+`@use` on its own schedule.
+
+## Rules
+
+<!-- docs-sync:rules -->
+
+| rule | fix | flags |
+|---|---|---|
+| `scss/at-extend-no-missing-placeholder` | manual | `@extend .class` instead of a `%placeholder` |
+| `scss/at-if-no-null` | auto | `@if $x != null` (fixed to `$x`) and `@if $x == null` (fixed to `not $x`) |
+| `scss/at-mixin-pattern` | manual | mixin names outside the pattern (kebab-case) |
+| `scss/at-rule-no-unknown` | manual | at-rules neither CSS nor Sass defines |
+| `scss/dollar-variable-pattern` | manual | `$variable` names outside the pattern (kebab-case) |
+| `scss/double-slash-comment-empty` | auto | an empty `//` comment |
+| `scss/function-no-unknown` | manual | functions that are not CSS, Sass built-ins or the file's own |
+| `scss/load-no-partial-leading-underscore` | auto | `@use "_partial"` |
+| `scss/max-nesting-depth` | manual | style rules nested deeper than `max` (3) |
+| `scss/no-duplicate-dollar-variables` | manual | a `$variable` declared twice in one scope |
+| `scss/no-duplicate-mixins` | manual | a mixin defined twice in one scope |
+| `scss/no-global-function-names` | auto | `map-get()` and the other built-ins that moved into modules |
+| `scss/no-import` | suggest | `@import` of a Sass file |
+| `scss/no-slash-division` | suggest | `/` as division |
+| `scss/percent-placeholder-pattern` | manual | `%placeholder` names outside the pattern (kebab-case) |
+
+<!-- /docs-sync:rules -->
+
+`$a+$b` is not a rule here: spacing around an operator is layout, and layout is the formatter's ([SR-FORMATTER](../../records/0105_formatter.md) decision 3) — `codelaw format` spaces it.

codelaw_rules_scss/codelaw-pack.toml

@@ -0,0 +1,6 @@
+name = "@codelaw/rules-scss"
+version = "0.3.0"
+min_codelaw = "0.1.0"
+languages = ["scss"]
+presets = ["scss/recommended", "scss/strict"]
+description = "codelaw's rules for SCSS (Sass), ported from stylelint-scss, with Dart Sass's module-system migrations (SR-RULE-PACKS)"

codelaw_rules_scss/corpus.toml

@@ -0,0 +1,19 @@
+# `codelaw test --corpus` finding counts (SR-RULE-AUTHORING decision 4).
+# Rewrite with --update-snapshot, and review the change.
+
+[findings]
+"scss/at-extend-no-missing-placeholder" = 21
+"scss/at-if-no-null" = 20
+"scss/at-mixin-pattern" = 6
+"scss/at-rule-no-unknown" = 0
+"scss/dollar-variable-pattern" = 5
+"scss/double-slash-comment-empty" = 227
+"scss/function-no-unknown" = 96
+"scss/load-no-partial-leading-underscore" = 0
+"scss/max-nesting-depth" = 15
+"scss/no-duplicate-dollar-variables" = 9
+"scss/no-duplicate-mixins" = 0
+"scss/no-global-function-names" = 191
+"scss/no-import" = 197
+"scss/no-slash-division" = 10
+"scss/percent-placeholder-pattern" = 1

codelaw_rules_scss/data/scss/at-rules.json

@@ -0,0 +1,68 @@
+{
+ "known": [
+  "annotation",
+  "apply",
+  "at-root",
+  "bottom-center",
+  "bottom-left",
+  "bottom-left-corner",
+  "bottom-right",
+  "bottom-right-corner",
+  "character-variant",
+  "container",
+  "content",
+  "counter-style",
+  "custom-media",
+  "custom-selector",
+  "debug",
+  "document",
+  "each",
+  "else",
+  "error",
+  "extend",
+  "font-face",
+  "font-feature-values",
+  "font-palette-values",
+  "for",
+  "forward",
+  "function",
+  "historical-forms",
+  "if",
+  "import",
+  "include",
+  "keyframes",
+  "layer",
+  "left-bottom",
+  "left-middle",
+  "left-top",
+  "media",
+  "mixin",
+  "namespace",
+  "nest",
+  "ornaments",
+  "page",
+  "position-try",
+  "property",
+  "return",
+  "right-bottom",
+  "right-middle",
+  "right-top",
+  "scope",
+  "scroll-timeline",
+  "starting-style",
+  "styleset",
+  "stylistic",
+  "supports",
+  "swash",
+  "top-center",
+  "top-left",
+  "top-left-corner",
+  "top-right",
+  "top-right-corner",
+  "use",
+  "view-transition",
+  "viewport",
+  "warn",
+  "while"
+ ]
+}

codelaw_rules_scss/data/scss/functions.json

@@ -0,0 +1,219 @@
+{
+ "css": [
+  "abs",
+  "acos",
+  "alpha",
+  "anchor",
+  "anchor-name",
+  "anchor-size",
+  "asin",
+  "atan",
+  "atan2",
+  "attr",
+  "blur",
+  "brightness",
+  "calc",
+  "calc-size",
+  "circle",
+  "clamp",
+  "color",
+  "color-contrast",
+  "color-mix",
+  "conic-gradient",
+  "contrast",
+  "contrast-color",
+  "cos",
+  "counter",
+  "counters",
+  "cross-fade",
+  "cubic-bezier",
+  "device-cmyk",
+  "drop-shadow",
+  "element",
+  "ellipse",
+  "env",
+  "exp",
+  "expression",
+  "fit-content",
+  "format",
+  "from-font",
+  "grayscale",
+  "hsl",
+  "hsla",
+  "hue-rotate",
+  "hwb",
+  "hypot",
+  "if",
+  "image",
+  "image-set",
+  "inset",
+  "invert",
+  "lab",
+  "layer",
+  "lch",
+  "leader",
+  "light-dark",
+  "linear",
+  "linear-gradient",
+  "local",
+  "log",
+  "matrix",
+  "matrix3d",
+  "max",
+  "min",
+  "minmax",
+  "mod",
+  "oklab",
+  "oklch",
+  "opacity",
+  "paint",
+  "path",
+  "perspective",
+  "polygon",
+  "pow",
+  "progid",
+  "radial-gradient",
+  "ray",
+  "rect",
+  "rem",
+  "repeat",
+  "repeating-conic-gradient",
+  "repeating-linear-gradient",
+  "repeating-radial-gradient",
+  "rgb",
+  "rgba",
+  "rotate",
+  "rotate3d",
+  "rotatex",
+  "rotatey",
+  "rotatez",
+  "round",
+  "running",
+  "saturate",
+  "scale",
+  "scale3d",
+  "scalex",
+  "scaley",
+  "scalez",
+  "scroll",
+  "selector",
+  "sepia",
+  "shape",
+  "sign",
+  "sin",
+  "skew",
+  "skewx",
+  "skewy",
+  "sqrt",
+  "src",
+  "steps",
+  "string",
+  "style",
+  "symbols",
+  "tan",
+  "target-counter",
+  "target-counters",
+  "target-text",
+  "tech",
+  "translate",
+  "translate3d",
+  "translatex",
+  "translatey",
+  "translatez",
+  "url",
+  "var",
+  "view",
+  "xywh"
+ ],
+ "sass": [
+  "abs",
+  "adjust-color",
+  "adjust-hue",
+  "alpha",
+  "and",
+  "append",
+  "blue",
+  "call",
+  "ceil",
+  "change-color",
+  "comparable",
+  "complement",
+  "content-exists",
+  "darken",
+  "desaturate",
+  "fade",
+  "fade-in",
+  "fade-out",
+  "feature-exists",
+  "floor",
+  "function-exists",
+  "get-function",
+  "global-variable-exists",
+  "grayscale",
+  "green",
+  "hsl",
+  "hsla",
+  "hue",
+  "ie-hex-str",
+  "if",
+  "index",
+  "inspect",
+  "invert",
+  "is-bracketed",
+  "is-superselector",
+  "join",
+  "keywords",
+  "length",
+  "lighten",
+  "lightness",
+  "list-separator",
+  "map-get",
+  "map-has-key",
+  "map-keys",
+  "map-merge",
+  "map-remove",
+  "map-values",
+  "max",
+  "min",
+  "mix",
+  "mixin-exists",
+  "not",
+  "nth",
+  "opacify",
+  "opacity",
+  "or",
+  "percentage",
+  "quote",
+  "random",
+  "red",
+  "rgb",
+  "rgba",
+  "round",
+  "saturate",
+  "saturation",
+  "scale-color",
+  "selector-append",
+  "selector-extend",
+  "selector-nest",
+  "selector-parse",
+  "selector-replace",
+  "selector-unify",
+  "set-nth",
+  "simple-selectors",
+  "sqrt",
+  "str-index",
+  "str-insert",
+  "str-length",
+  "str-slice",
+  "to-lower-case",
+  "to-upper-case",
+  "transparentize",
+  "type-of",
+  "unique-id",
+  "unit",
+  "unitless",
+  "unquote",
+  "variable-exists",
+  "zip"
+ ]
+}

codelaw_rules_scss/presets/scss/recommended.toml

@@ -0,0 +1,10 @@
+description = "SCSS correctness: unknown at-rules and functions' neighbours, duplicate definitions, placeholders, null tests"
+
+[rules]
+"scss/at-extend-no-missing-placeholder" = "error"
+"scss/at-if-no-null" = "error"
+"scss/at-rule-no-unknown" = "error"
+"scss/double-slash-comment-empty" = "error"
+"scss/load-no-partial-leading-underscore" = "error"
+"scss/no-duplicate-dollar-variables" = "error"
+"scss/no-duplicate-mixins" = "error"

codelaw_rules_scss/presets/scss/strict.toml

@@ -0,0 +1,12 @@
+extends = ["codelaw:scss/recommended"]
+description = "scss/recommended plus Dart Sass's module-system migrations (no @import, no global functions, no slash division), unknown functions, naming patterns and a nesting limit"
+
+[rules]
+"scss/at-mixin-pattern" = "error"
+"scss/dollar-variable-pattern" = "error"
+"scss/function-no-unknown" = "error"
+"scss/max-nesting-depth" = "error"
+"scss/no-global-function-names" = "error"
+"scss/no-import" = "error"
+"scss/no-slash-division" = "error"
+"scss/percent-placeholder-pattern" = "error"

codelaw_rules_scss/rules/scss/at-extend-no-missing-placeholder.cases.md

@@ -0,0 +1,49 @@
+# Cases: scss/at-extend-no-missing-placeholder
+
+### case: a placeholder
+
+```scss
+.a {
+  @extend %b;
+}
+```
+
+```expect
+(none)
+```
+
+### case: an element
+
+```scss
+.a {
+  @extend a;
+}
+```
+
+```expect
+2:11 scss/at-extend-no-missing-placeholder
+```
+
+### case: an optional class
+
+```scss
+.a {
+  @extend .b !optional;
+}
+```
+
+```expect
+2:11 scss/at-extend-no-missing-placeholder
+```
+
+### case: interpolation
+
+```scss
+.a {
+  @extend #{$sel};
+}
+```
+
+```expect
+(none)
+```

codelaw_rules_scss/rules/scss/at-extend-no-missing-placeholder.md

@@ -0,0 +1,51 @@
+---
+id: scss/at-extend-no-missing-placeholder
+title: "`@extend` targets a placeholder"
+languages: [scss]
+fix: manual
+fix_reason: "turning a class into a placeholder changes the stylesheet's output"
+stability: preview
+ported_from: [stylelint-scss/at-extend-no-missing-placeholder]
+since: 0.3.0
+---
+
+`@extend` names a `%placeholder`, not a class or an element.
+
+**Why:** Extending a class drags every selector that mentions the class into the output, including ones far from the code at hand.
+
+```codelaw
+native: scss/at-extend-no-missing-placeholder
+```
+
+## How to fix
+
+1. Move the shared declarations into a `%placeholder`.
+2. `@extend` the placeholder from each place that needs it.
+
+## Examples
+
+### SCSS
+
+#### Don't
+
+```scss
+.a {
+  @extend .b;
+}
+```
+
+#### Do
+
+```scss
+%b {
+  color: red;
+}
+
+.a {
+  @extend %b;
+}
+```
+
+## Differences from the source
+
+A target with interpolation is not judged.

codelaw_rules_scss/rules/scss/at-if-no-null.cases.md

@@ -0,0 +1,105 @@
+# Cases: scss/at-if-no-null
+
+### case: not equal
+
+```scss
+@if $x != null {
+  a: b;
+}
+```
+
+```expect
+1:5 scss/at-if-no-null
+```
+
+```fixed
+@if $x {
+  a: b;
+}
+```
+
+### case: an else if
+
+```scss
+@if $a {
+  a: b;
+} @else if $x != null {
+  c: d;
+}
+```
+
+```expect
+3:12 scss/at-if-no-null
+```
+
+```fixed
+@if $a {
+  a: b;
+} @else if $x {
+  c: d;
+}
+```
+
+### case: equal becomes not
+
+```scss
+@if $x == null {
+  a: b;
+}
+```
+
+```expect
+1:5 scss/at-if-no-null
+```
+
+```fixed
+@if not $x {
+  a: b;
+}
+```
+
+### case: an else if that is equal
+
+```scss
+@if $a {
+  a: b;
+} @else if $x == null {
+  c: d;
+}
+```
+
+```expect
+3:12 scss/at-if-no-null
+```
+
+```fixed
+@if $a {
+  a: b;
+} @else if not $x {
+  c: d;
+}
+```
+
+### case: part of a condition is reported without a fix
+
+```scss
+@if $x != null and $y {
+  a: b;
+}
+```
+
+```expect
+1:5 scss/at-if-no-null
+```
+
+### case: no null
+
+```scss
+@if $x == 1 {
+  a: b;
+}
+```
+
+```expect
+(none)
+```

codelaw_rules_scss/rules/scss/at-if-no-null.md

@@ -0,0 +1,41 @@
+---
+id: scss/at-if-no-null
+title: "No comparing to `null` in `@if`"
+languages: [scss]
+fix: auto
+stability: preview
+ported_from: [stylelint-scss/at-if-no-null]
+since: 0.3.0
+---
+
+`@if` tests a value directly: `@if $x`, `@if not $x`, not `@if $x != null` or `@if $x == null`.
+
+**Why:** Every value other than `null` and `false` is truthy in Sass, so testing the value says the same thing in fewer words.
+
+```codelaw
+native: scss/at-if-no-null
+```
+
+## Examples
+
+### SCSS
+
+#### Don't
+
+```scss
+@if $x != null {
+  a: b;
+}
+```
+
+#### Do
+
+```scss
+@if $x {
+  a: b;
+}
+```
+
+## Differences from the source
+
+`$x != null` is fixed to `$x` and `$x == null` to `not $x`. A comparison that is only part of a condition is reported without a fix.