@unsass/selector 1.2.0 → 1.4.0

package/CHANGELOG.md

@@ -2,6 +2,42 @@
 
 All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## 1.4.0 (2026-01-03)
+
+* ci: add `release.config.js` ([6fb94ff](https://github.com/unsass/selector/commit/6fb94ff))
+* ci: lint code ([e7c5ae5](https://github.com/unsass/selector/commit/e7c5ae5))
+* ci: rename `node.js.yml` to `publish.yml` ([bdfb2a2](https://github.com/unsass/selector/commit/bdfb2a2))
+* ci: update `commit-msg` ([7f78c1c](https://github.com/unsass/selector/commit/7f78c1c))
+* feat: use the plain-CSS if() syntax ([bfda10e](https://github.com/unsass/selector/commit/bfda10e))
+* chore: switch to ESM ([faee4d8](https://github.com/unsass/selector/commit/faee4d8))
+* chore(deps-dev): bump to `@commitlint/cli` 20.3.0 ([581c39e](https://github.com/unsass/selector/commit/581c39e))
+* chore(deps-dev): bump to `sass-true` 10.1.0 ([125f7b4](https://github.com/unsass/selector/commit/125f7b4))
+* chore(deps-dev): bump to `stylelint` 16.26.1 ([9249a20](https://github.com/unsass/selector/commit/9249a20))
+* chore(deps-dev): prevent dependencies vulnerabilities ([311b5f1](https://github.com/unsass/selector/commit/311b5f1))
+* chore(deps): bump to `@commitlint/cli` 20.1.0 ([7873ab3](https://github.com/unsass/selector/commit/7873ab3))
+* chore(deps): bump to `sass-true` 8.1.0 ([796746d](https://github.com/unsass/selector/commit/796746d))
+* chore(deps): bump to `sass-true` 9.0.0 ([c6f302c](https://github.com/unsass/selector/commit/c6f302c))
+* chore(deps): bump to `sass` 1.97.1 ([3dfbf70](https://github.com/unsass/selector/commit/3dfbf70))
+* chore(deps): bump to `semantic-release` 25.0.1 ([93db310](https://github.com/unsass/selector/commit/93db310))
+* chore(deps): bump to `stylelint-config-unsass` 2.0.0 ([ccb922e](https://github.com/unsass/selector/commit/ccb922e))
+* chore(deps): bump to `stylelint-config-unsass` 2.2.0 ([04e20fa](https://github.com/unsass/selector/commit/04e20fa))
+* chore(deps): clean `package-lock.json` ([65d4a3d](https://github.com/unsass/selector/commit/65d4a3d))
+* chore(deps): prevent dependencies vulnerabilities ([b3fbab9](https://github.com/unsass/selector/commit/b3fbab9))
+* test(deps): switch from jest to vitest ([8c3ed03](https://github.com/unsass/selector/commit/8c3ed03))
+
+## [1.3.0](https://github.com/unsass/selector/compare/v1.2.0...v1.3.0) (2023-09-11)
+
+
+### Features
+
+* **create:** add list option for `$scope` parameter ([ebd78c1](https://github.com/unsass/selector/commit/ebd78c1705a2271b4d8bad8b2441936abc928284))
+
+
+### Build System
+
+* **deps:** bump to `sass` 1.66.1 ([b9ff3d5](https://github.com/unsass/selector/commit/b9ff3d5ccad6ab1a5fba427cfdc753a09f50418d))
+* **deps:** prevent dependencies vulnerabilities ([610177d](https://github.com/unsass/selector/commit/610177d035c8d255e836846fe4a5b7c9be932c08))
+
 ## [1.2.0](https://github.com/unsass/selector/compare/v1.1.0...v1.2.0) (2023-03-20)
 
 

package/package.json

@@ -1,39 +1,36 @@
 {
     "name": "@unsass/selector",
-    "version": "1.2.0",
+    "version": "1.4.0",
     "description": "Sass functions and mixins to manage CSS selectors.",
+    "type": "module",
     "scripts": {
         "lint:css": "stylelint --fix \"**/*.scss\"",
         "lint": "npm-run-all --parallel lint:*",
-        "test": "jest",
+        "test": "vitest",
         "prepare": "husky install",
         "release": "semantic-release"
     },
     "engines": {
-        "node": ">=16.0.0",
-        "npm": ">=8.0.0"
+        "node": ">=18"
     },
     "sass": "index.scss",
     "devDependencies": {
-        "@commitlint/cli": "^17.4.4",
-        "@commitlint/config-conventional": "^17.4.4",
-        "@semantic-release/changelog": "^6.0.2",
+        "@commitlint/cli": "^20.3.0",
+        "@commitlint/config-conventional": "^20.3.0",
+        "@semantic-release/changelog": "^6.0.3",
         "@semantic-release/git": "^10.0.1",
-        "glob": "^7.2.0",
-        "husky": "^8.0.3",
-        "jest": "^29.5.0",
-        "jest-environment-node-single-context": "^29.0.0",
-        "jest-junit": "^15.0.0",
+        "husky": "^9.1.7",
         "npm-run-all": "^4.1.5",
-        "sass-true": "^7.0.0",
-        "semantic-release": "^20.1.3",
-        "stylelint": "^15.3.0",
-        "stylelint-config-unsass": "^1.0.1"
+        "sass-true": "^10.1.0",
+        "semantic-release": "^25.0.2",
+        "stylelint": "^16.26.1",
+        "stylelint-config-unsass": "^2.2.0",
+        "vitest": "^4.0.16"
     },
     "dependencies": {
         "@unsass/string": "^1.4.2",
         "@unsass/types": "^1.0.2",
-        "sass": "^1.53.0"
+        "sass": "^1.97.1"
     },
     "keywords": [
         "sass",

package/src/_functions.scss

@@ -31,7 +31,7 @@
 /// @example - scss
 ///   $selector: pseudo-class(".foo", "before");
 ///   // ".foo::before"
-//
+///
 /// @access public
 ///
 @function pseudo-element($selector, $pseudo-element) {
@@ -42,7 +42,7 @@
 /// @example - scss
 ///   $selector: to-id("foo");
 ///   // "#foo"
-//
+///
 /// @access public
 ///
 @function to-id($selector) {

package/src/_mixins.scss

@@ -50,7 +50,7 @@
 ///   }
 ///
 /// @param {string} $selector - Selector name.
-/// @param {string} $scope - Selector affix value.
+/// @param {string, list} $scope - Selector affix value.
 /// @param {string} $separator - Selector affix separator.
 /// @param {string} $pseudo-class - Selector pseudo-class.
 /// @param {string} $pseudo-element - Selector pseudo-element.
@@ -63,13 +63,13 @@
 ///
 @mixin create($selector, $scope: null, $separator: ":", $suffix: false, $pseudo-class: null, $pseudo-element: null, $root: false) {
     @if $pseudo-class and $suffix {
-        @error "You cannot add a suffix with a selector that already has a pseudo-class."
+        @error "You cannot add a suffix with a selector that already has a pseudo-class.";
     } @else if $pseudo-element and $suffix {
-        @error "You cannot add a suffix with a selector that already has a pseudo-element."
+        @error "You cannot add a suffix with a selector that already has a pseudo-element.";
     }
 
-    $selector: if(type.is-list($selector), "#{list.nth($selector, 1)}", $selector);
-    $class-selector: string.slice($selector, 1, 1)  == ".";
+    $selector: if(sass(type.is-list($selector)): "#{list.nth($selector, 1)}"; else: $selector);
+    $class-selector: string.slice($selector, 1, 1) == ".";
 
     @if $class-selector {
         $selector: string.slice($selector, 2);
@@ -90,15 +90,39 @@
     ///
 
     @if $scope and not $suffix {
-        @if type.is-number(string.to-number(string.slice($scope, 1, $end-at: 1))) {
-            $scope: string.replace(\3 #{string.unquote($scope)}, " ");
+        $class: "";
+
+        @if type.is-list($scope) {
+            @each $key in $scope {
+                @if type.is-number(string.to-number(string.slice($key, 1, $end-at: 1))) {
+                    $key: string.replace(\3 #{string.unquote($key)}, " ");
+                }
+
+                $class: $class + "#{$key}\\#{$separator}";
+            }
+        } @else {
+            @if type.is-number(string.to-number(string.slice($scope, 1, $end-at: 1))) {
+                $scope: string.replace(\3 #{string.unquote($scope)}, " ");
+            }
+
+            $class: "#{$scope}\\#{$separator}";
         }
 
-        $selector: selector.append("#{$scope}\\#{$separator}", $selector);
+        $selector: selector.append($class, $selector);
     }
 
     @if $scope and $suffix {
-        $selector: selector.append($selector, "\\#{$separator}#{$scope}");
+        $class: "";
+
+        @if type.is-list($scope) {
+            @each $key in $scope {
+                $class: $class + "\\#{$separator}#{$key}";
+            }
+        } @else {
+            $class: "\\#{$separator}#{$scope}";
+        }
+
+        $selector: selector.append($selector, $class);
     }
 
     ///