@jesscss/plugin-scss 2.0.0-alpha.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Matthew Dean
+
+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.

package/README.md

@@ -0,0 +1,35 @@
+# @jesscss/plugin-scss
+
+**The SCSS language engine for Jess — the experimental base that seeds
+"Sass+".**
+
+This plugin layers an SCSS grammar (`@jesscss/scss-parser`) onto the Jess
+compiler, the same way [`@jesscss/plugin-less`](../jess-plugin-less) provides the
+Less engine. It parses `.scss` into the Jess AST for the engine to evaluate and
+emit.
+
+## Roadmap status — experimental, not the alpha focus
+
+Jess's language is an **ordered progression: Now Less.js → Next "Sass+" →
+Final `.jess`.** Only Less.js is shipping today.
+
+`plugin-scss` sits at the **"Next"** milestone. It is the experimental base for
+**Sass+** — the intended Sass successor, a dialect that fixes and extends
+Sass-style ergonomics — but Sass+ itself is **not shipped**, and SCSS support is
+**not a goal of the current Less-focused alpha.** Expect gaps and breaking
+changes. If you need production Sass today, use Sass.
+
+What exists now is the SCSS parser plus this plugin wiring; the Sass+ dialect,
+semantics, and defaults are still being designed. Treat anything here as a
+preview, not a promise.
+
+## Status
+
+**Alpha / experimental.** Part of [Jess](https://github.com/jesscss/jess). The
+programmatic plugin/compiler API is **not yet stabilized** — the `jess` CLI is
+the documented public surface for the alpha, and it targets Less today.
+
+- Project overview & positioning: <https://github.com/jesscss/jess#readme>
+- Docs: <https://jesscss.github.io/> (currently pre-alpha content)
+- Issues: <https://github.com/jesscss/jess/issues>
+- License: MIT

package/lib/index.cjs

@@ -0,0 +1,54 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+let _jesscss_core = require("@jesscss/core");
+let _jesscss_fns_sass_registry = require("@jesscss/fns/sass/registry");
+let _jesscss_scss_parser = require("@jesscss/scss-parser");
+let _jesscss_style_resolver = require("@jesscss/style-resolver");
+//#region src/index.ts
+const sassValueEvaluator = (0, _jesscss_core.buildEvaluator)((0, _jesscss_fns_sass_registry.makeSassRegistry)());
+var ScssPlugin = class extends _jesscss_core.AbstractPlugin {
+	name = "scss";
+	supportedExtensions = [".scss"];
+	unitMode;
+	equalityMode;
+	constructor(opts = {}) {
+		super();
+		this.opts = opts;
+		this.unitMode = opts.unitMode ?? "preserve";
+		this.equalityMode = opts.equalityMode ?? "sass";
+	}
+	expandImport(importPath) {
+		return (0, _jesscss_style_resolver.expandScssImportCandidates)(importPath);
+	}
+	setContext(context) {
+		if (context.documentContext?.plugin !== this) return;
+		if (context.opts.unitMode === void 0) context.setOption("unitMode", this.unitMode);
+		if (context.opts.equalityMode === void 0) context.setOption("equalityMode", this.equalityMode);
+		context.registerValueEvaluator(sassValueEvaluator);
+	}
+	safeParse(filePath, source) {
+		try {
+			return {
+				document: (0, _jesscss_scss_parser.parse)(source),
+				errors: [],
+				warnings: []
+			};
+		} catch (error) {
+			return {
+				errors: [(0, _jesscss_core.parserDiagnostic)({
+					dialect: "SCSS",
+					error,
+					filePath,
+					source
+				})],
+				warnings: []
+			};
+		}
+	}
+};
+const scssPlugin = ((opts) => new ScssPlugin(opts));
+//#endregion
+exports.ScssPlugin = ScssPlugin;
+exports.default = scssPlugin;

package/lib/index.d.ts

@@ -0,0 +1,35 @@
+import { AbstractPlugin, type ISafeParseResult, type EqualityMode, type UnitMode, type Context } from '@jesscss/core';
+export type ScssPluginOptions = {
+    allowExtendSelectors?: ExtendSelectorKind[];
+    /**
+     * Compatibility input retained on this frontend's option object. The shared
+     * evaluator reads the resolved Context compile/input option; configuring a
+     * Compiler should use `compile.unitMode` or matched input options.
+     */
+    unitMode?: UnitMode;
+    /**
+     * Compatibility input retained on this frontend's option object. It does not
+     * select a separate SCSS evaluator; configure the shared evaluator through
+     * Context compile/input options.
+     */
+    equalityMode?: EqualityMode;
+    /**
+     * Whether to collapse nested selectors (flatten nesting during print).
+     * This is a Jess output option, not a Sass option.
+     */
+    collapseNesting?: boolean;
+};
+type ExtendSelectorKind = 'simple' | 'basic' | 'pseudo' | 'complex' | 'compound';
+export declare class ScssPlugin extends AbstractPlugin {
+    opts: ScssPluginOptions;
+    name: string;
+    supportedExtensions: string[];
+    unitMode: UnitMode;
+    equalityMode: EqualityMode;
+    constructor(opts?: ScssPluginOptions);
+    expandImport(importPath: string): string[];
+    setContext(context: Context): void;
+    safeParse(filePath: string, source: string): ISafeParseResult;
+}
+declare const scssPlugin: (opts?: ScssPluginOptions) => ScssPlugin;
+export default scssPlugin;

package/lib/index.js

@@ -0,0 +1,49 @@
+import { AbstractPlugin, buildEvaluator, parserDiagnostic } from "@jesscss/core";
+import { makeSassRegistry } from "@jesscss/fns/sass/registry";
+import { parse } from "@jesscss/scss-parser";
+import { expandScssImportCandidates } from "@jesscss/style-resolver";
+//#region src/index.ts
+const sassValueEvaluator = buildEvaluator(makeSassRegistry());
+var ScssPlugin = class extends AbstractPlugin {
+	name = "scss";
+	supportedExtensions = [".scss"];
+	unitMode;
+	equalityMode;
+	constructor(opts = {}) {
+		super();
+		this.opts = opts;
+		this.unitMode = opts.unitMode ?? "preserve";
+		this.equalityMode = opts.equalityMode ?? "sass";
+	}
+	expandImport(importPath) {
+		return expandScssImportCandidates(importPath);
+	}
+	setContext(context) {
+		if (context.documentContext?.plugin !== this) return;
+		if (context.opts.unitMode === void 0) context.setOption("unitMode", this.unitMode);
+		if (context.opts.equalityMode === void 0) context.setOption("equalityMode", this.equalityMode);
+		context.registerValueEvaluator(sassValueEvaluator);
+	}
+	safeParse(filePath, source) {
+		try {
+			return {
+				document: parse(source),
+				errors: [],
+				warnings: []
+			};
+		} catch (error) {
+			return {
+				errors: [parserDiagnostic({
+					dialect: "SCSS",
+					error,
+					filePath,
+					source
+				})],
+				warnings: []
+			};
+		}
+	}
+};
+const scssPlugin = ((opts) => new ScssPlugin(opts));
+//#endregion
+export { ScssPlugin, scssPlugin as default };

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@jesscss/plugin-scss",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "An SCSS stylesheet engine for Jess",
+  "version": "2.0.0-alpha.10",
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "main": "lib/index.cjs",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js",
+      "require": "./lib/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib"
+  ],
+  "dependencies": {
+    "@jesscss/core": "2.0.0-alpha.10",
+    "@jesscss/fns": "2.0.0-alpha.10",
+    "@jesscss/scss-parser": "2.0.0-alpha.10",
+    "@jesscss/style-resolver": "2.0.0-alpha.10"
+  },
+  "devDependencies": {},
+  "author": "Matthew Dean <matthew-dean@users.noreply.github.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/jesscss/jess/issues"
+  },
+  "homepage": "https://github.com/jesscss/jess#readme",
+  "type": "module",
+  "module": "lib/index.js",
+  "scripts": {
+    "ci": "pnpm build && pnpm test",
+    "build": "pnpm compile",
+    "compile": "tsdown --tsconfig tsconfig.build.json --no-dts && tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "test": "vitest --run --passWithNoTests",
+    "lint:fix": "eslint --fix '**/*.{js,ts}'",
+    "lint": "eslint '**/*.{js,ts}'"
+  }
+}