@jesscss/style-resolver 2.0.0-alpha.6 → 2.0.0-alpha.8

package/README.md

@@ -0,0 +1,43 @@
+# @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) — Less.js v5, a ground-up rewrite of the
+Less CSS preprocessor. 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` / `lessc` CLIs.
+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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jesscss/style-resolver",
-  "version": "2.0.0-alpha.6",
+  "version": "2.0.0-alpha.8",
   "publishConfig": {
     "access": "public"
   },
@@ -10,7 +10,6 @@
   "exports": {
     ".": {
       "types": "./lib/index.d.ts",
-      "source": "./src/index.ts",
       "import": "./lib/index.js",
       "require": "./lib/index.cjs"
     }
@@ -25,7 +24,7 @@
   "module": "lib/index.js",
   "scripts": {
     "build": "pnpm compile",
-    "compile": "tsdown --tsconfig tsconfig.build.json && tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "compile": "tsdown --tsconfig tsconfig.build.json --no-dts && tsc -p tsconfig.build.json --emitDeclarationOnly --noCheck",
     "test": "vitest --watch=false",
     "lint": "eslint '**/*.{js,ts}'"
   }

package/lib/index.d.cts

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