@jesscss/style-resolver 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,42 @@
+# @jesscss/style-resolver
+
+**Stylesheet import resolution across CSS, Less, SCSS, and Jess — include paths,
+load paths, and extension/index resolution.**
+
+`@jesscss/style-resolver` is a building block for
+[Jess](https://github.com/jesscss/jess). Given a stylesheet's source and an import statement, it
+figures out which file that import actually points to, applying each language's
+lookup rules (Less and SCSS candidate expansion, partials, index files, search
+paths).
+
+It handles the mechanics of finding imports — extracting import statements from
+source, expanding a bare import path into the ordered list of candidate files a
+given language would try, and resolving that against a filesystem-like interface.
+
+## Where it fits
+
+Import resolution is a shared concern the compiler and tooling both need. It is
+also one of the building blocks toward the broader module/scoping story on the
+Jess roadmap (whose headline is the post-`.jess` minimal browser build) — but this
+package is just the resolver, not that feature.
+
+## Who uses it
+
+This is an internal package. Most people should install
+[`jess`](https://www.npmjs.com/package/jess) and use the `jess` CLI.
+The JavaScript/TypeScript API is **not yet stabilized** and is intentionally
+undocumented for now.
+
+## Status
+
+Alpha. Published to npm under both the `latest` and `alpha` dist-tags. Please
+[report bugs](https://github.com/jesscss/jess/issues).
+
+## Links
+
+- Repository: <https://github.com/jesscss/jess>
+- Documentation: <https://jesscss.github.io/> (currently pre-alpha content)
+
+## License
+
+[MIT](https://github.com/jesscss/jess/blob/dev/LICENSE)

package/lib/index.cjs

@@ -0,0 +1,122 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+let node_path = require("node:path");
+node_path = __toESM(node_path);
+//#region src/index.ts
+function uniq(items) {
+	const out = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const it of items) {
+		if (seen.has(it)) continue;
+		seen.add(it);
+		out.push(it);
+	}
+	return out;
+}
+function stripQueryHash(input) {
+	const m = input.match(/^([^?#]+)([?#].*)?$/);
+	return {
+		filePart: m?.[1] ?? input,
+		suffix: m?.[2] ?? ""
+	};
+}
+function extractImports(sourceText, lang) {
+	const out = [];
+	const re = /@(import|use)\s*(?:\(([^)]*)\)\s*)*(?:url\(\s*)?(?:'([^']+)'|"([^"]+)")/g;
+	for (let m; m = re.exec(sourceText);) {
+		const optionsRaw = m[2] ?? "";
+		const options = optionsRaw ? optionsRaw.split(",").map((s) => s.trim()).filter(Boolean) : void 0;
+		const spec = m[3] ?? m[4] ?? "";
+		if (!spec) continue;
+		const startInMatch = m[3] != null ? m[0].indexOf(m[3]) : m[0].indexOf(m[4] ?? "");
+		const startOffset = m.index + startInMatch;
+		const endOffset = startOffset + spec.length;
+		out.push({
+			lang,
+			specifier: spec,
+			options,
+			specifierRange: {
+				startOffset,
+				endOffset
+			}
+		});
+	}
+	return out;
+}
+function expandLessImportCandidates(importPath) {
+	if (node_path.extname(importPath) !== ".less") return [`${importPath}.less`, `${importPath}`];
+	return [importPath];
+}
+function expandScssImportCandidates(importPath) {
+	const ext = node_path.extname(importPath);
+	const base = ext ? importPath.slice(0, -ext.length) : importPath;
+	const candidates = [];
+	const pushUnique = (p) => {
+		if (!candidates.includes(p)) candidates.push(p);
+	};
+	const withExt = (p) => p.endsWith(".scss") ? p : `${p}.scss`;
+	if (ext) {
+		pushUnique(importPath);
+		const dir = node_path.dirname(importPath);
+		const file = node_path.basename(importPath);
+		if (!file.startsWith("_")) pushUnique(node_path.join(dir, `_${file}`));
+		return candidates;
+	}
+	pushUnique(withExt(base));
+	pushUnique(withExt(node_path.join(node_path.dirname(base), `_${node_path.basename(base)}`)));
+	pushUnique(withExt(node_path.join(base, "index")));
+	pushUnique(withExt(node_path.join(base, "_index")));
+	return candidates;
+}
+function resolveImport(fs, opts) {
+	const specifier = opts.specifier.trim();
+	if (!specifier) return null;
+	if (/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(specifier) || specifier.startsWith("data:")) return null;
+	const { filePart, suffix } = stripQueryHash(specifier);
+	const fromDir = node_path.dirname(opts.fromFilePath);
+	const cfg = opts.config ?? {};
+	const searchPaths = [fromDir];
+	if (opts.lang === "less" && Array.isArray(cfg.includePaths)) searchPaths.push(...cfg.includePaths);
+	if (opts.lang === "scss" && Array.isArray(cfg.loadPaths)) searchPaths.push(...cfg.loadPaths);
+	if (cfg.rootDir) searchPaths.push(cfg.rootDir);
+	const candidatesRel = opts.lang === "less" ? expandLessImportCandidates(filePart) : opts.lang === "scss" ? expandScssImportCandidates(filePart) : [filePart.endsWith(".css") ? filePart : `${filePart}.css`, filePart];
+	const candidatesAbs = [];
+	for (const baseDir of uniq(searchPaths)) for (const rel of candidatesRel) {
+		const abs = node_path.resolve(baseDir, rel);
+		candidatesAbs.push({
+			p: abs,
+			resolvedBy: baseDir === fromDir ? "exact" : "loadPath"
+		});
+	}
+	for (const c of candidatesAbs) if (fs.exists(c.p)) return {
+		filePath: c.p + suffix,
+		resolvedBy: c.resolvedBy
+	};
+	return null;
+}
+//#endregion
+exports.expandLessImportCandidates = expandLessImportCandidates;
+exports.expandScssImportCandidates = expandScssImportCandidates;
+exports.extractImports = extractImports;
+exports.resolveImport = resolveImport;

package/lib/index.d.ts

@@ -0,0 +1,35 @@
+export type StyleLang = 'css' | 'less' | 'scss' | 'jess';
+export type FsLike = {
+    exists(filePath: string): boolean;
+};
+export type StylesConfig = {
+    /** Project root; used as an optional search base. */
+    rootDir?: string;
+    /** Less-style include paths. */
+    includePaths?: string[];
+    /** SCSS-style load paths. */
+    loadPaths?: string[];
+};
+export type ImportStatement = {
+    lang: StyleLang;
+    specifier: string;
+    options?: string[];
+    specifierRange: {
+        startOffset: number;
+        endOffset: number;
+    };
+};
+export type ResolveResult = {
+    filePath: string;
+    resolvedBy: 'exact' | 'extension' | 'partial' | 'index' | 'loadPath';
+};
+export type ResolveImportOptions = {
+    lang: StyleLang;
+    fromFilePath: string;
+    specifier: string;
+    config?: StylesConfig;
+};
+export declare function extractImports(sourceText: string, lang: StyleLang): ImportStatement[];
+export declare function expandLessImportCandidates(importPath: string): string[];
+export declare function expandScssImportCandidates(importPath: string): string[];
+export declare function resolveImport(fs: FsLike, opts: ResolveImportOptions): ResolveResult | null;

package/lib/index.js

@@ -0,0 +1,95 @@
+import * as path from "node:path";
+//#region src/index.ts
+function uniq(items) {
+	const out = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const it of items) {
+		if (seen.has(it)) continue;
+		seen.add(it);
+		out.push(it);
+	}
+	return out;
+}
+function stripQueryHash(input) {
+	const m = input.match(/^([^?#]+)([?#].*)?$/);
+	return {
+		filePart: m?.[1] ?? input,
+		suffix: m?.[2] ?? ""
+	};
+}
+function extractImports(sourceText, lang) {
+	const out = [];
+	const re = /@(import|use)\s*(?:\(([^)]*)\)\s*)*(?:url\(\s*)?(?:'([^']+)'|"([^"]+)")/g;
+	for (let m; m = re.exec(sourceText);) {
+		const optionsRaw = m[2] ?? "";
+		const options = optionsRaw ? optionsRaw.split(",").map((s) => s.trim()).filter(Boolean) : void 0;
+		const spec = m[3] ?? m[4] ?? "";
+		if (!spec) continue;
+		const startInMatch = m[3] != null ? m[0].indexOf(m[3]) : m[0].indexOf(m[4] ?? "");
+		const startOffset = m.index + startInMatch;
+		const endOffset = startOffset + spec.length;
+		out.push({
+			lang,
+			specifier: spec,
+			options,
+			specifierRange: {
+				startOffset,
+				endOffset
+			}
+		});
+	}
+	return out;
+}
+function expandLessImportCandidates(importPath) {
+	if (path.extname(importPath) !== ".less") return [`${importPath}.less`, `${importPath}`];
+	return [importPath];
+}
+function expandScssImportCandidates(importPath) {
+	const ext = path.extname(importPath);
+	const base = ext ? importPath.slice(0, -ext.length) : importPath;
+	const candidates = [];
+	const pushUnique = (p) => {
+		if (!candidates.includes(p)) candidates.push(p);
+	};
+	const withExt = (p) => p.endsWith(".scss") ? p : `${p}.scss`;
+	if (ext) {
+		pushUnique(importPath);
+		const dir = path.dirname(importPath);
+		const file = path.basename(importPath);
+		if (!file.startsWith("_")) pushUnique(path.join(dir, `_${file}`));
+		return candidates;
+	}
+	pushUnique(withExt(base));
+	pushUnique(withExt(path.join(path.dirname(base), `_${path.basename(base)}`)));
+	pushUnique(withExt(path.join(base, "index")));
+	pushUnique(withExt(path.join(base, "_index")));
+	return candidates;
+}
+function resolveImport(fs, opts) {
+	const specifier = opts.specifier.trim();
+	if (!specifier) return null;
+	if (/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(specifier) || specifier.startsWith("data:")) return null;
+	const { filePart, suffix } = stripQueryHash(specifier);
+	const fromDir = path.dirname(opts.fromFilePath);
+	const cfg = opts.config ?? {};
+	const searchPaths = [fromDir];
+	if (opts.lang === "less" && Array.isArray(cfg.includePaths)) searchPaths.push(...cfg.includePaths);
+	if (opts.lang === "scss" && Array.isArray(cfg.loadPaths)) searchPaths.push(...cfg.loadPaths);
+	if (cfg.rootDir) searchPaths.push(cfg.rootDir);
+	const candidatesRel = opts.lang === "less" ? expandLessImportCandidates(filePart) : opts.lang === "scss" ? expandScssImportCandidates(filePart) : [filePart.endsWith(".css") ? filePart : `${filePart}.css`, filePart];
+	const candidatesAbs = [];
+	for (const baseDir of uniq(searchPaths)) for (const rel of candidatesRel) {
+		const abs = path.resolve(baseDir, rel);
+		candidatesAbs.push({
+			p: abs,
+			resolvedBy: baseDir === fromDir ? "exact" : "loadPath"
+		});
+	}
+	for (const c of candidatesAbs) if (fs.exists(c.p)) return {
+		filePath: c.p + suffix,
+		resolvedBy: c.resolvedBy
+	};
+	return null;
+}
+//#endregion
+export { expandLessImportCandidates, expandScssImportCandidates, extractImports, resolveImport };

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@jesscss/style-resolver",
+  "version": "2.0.0-alpha.10",
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "lib/index.cjs",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js",
+      "require": "./lib/index.cjs"
+    }
+  },
+  "files": [
+    "lib"
+  ],
+  "devDependencies": {
+    "typescript": "~5.8.2",
+    "vitest": "^4.1.0"
+  },
+  "module": "lib/index.js",
+  "scripts": {
+    "build": "pnpm compile",
+    "compile": "tsdown --tsconfig tsconfig.build.json --no-dts && tsc -p tsconfig.build.json --emitDeclarationOnly --noCheck",
+    "test": "vitest --watch=false",
+    "lint": "eslint '**/*.{js,ts}'"
+  }
+}