@lass-lang/plugin-utils 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @lass-lang/plugin-utils
+ *
+ * Shared utilities for Lass bundler plugins.
+ *
+ * These utilities handle bundler-agnostic plugin infrastructure:
+ * - Virtual path conventions for .lass <-> .css mapping
+ * - Import rewriting for isolated execution
+ * - Constants shared across all bundler plugins
+ *
+ * This is separate from:
+ * - Core's transpilation (handled by @lass-lang/core)
+ * - Bundler-specific injection (each plugin implements its own injectStyle)
+ */
+/** Extension for .lass source files */
+export declare const LASS_EXT = ".lass";
+/** Virtual CSS extension for regular .lass files: foo.lass -> foo.lass.css */
+export declare const VIRTUAL_CSS_EXT = ".lass.css";
+/** Virtual CSS extension for CSS Modules: foo.module.lass -> foo.lass.module.css */
+export declare const VIRTUAL_MODULE_CSS_EXT = ".lass.module.css";
+/**
+ * Regex for matching ES import statements with relative paths.
+ *
+ * Captures:
+ * - Group 1: Import prefix (e.g., "import x from '")
+ * - Group 2: Relative path (e.g., "./file.json")
+ * - Group 3: Quote suffix (e.g., "'")
+ * - Group 4: Trailing content (e.g., " with { type: 'json' };")
+ */
+export declare const IMPORT_STATEMENT_RE: RegExp;
+/**
+ * Convert a .lass file path to its virtual CSS path.
+ *
+ * @example
+ * toVirtualCssPath('src/styles.lass') // => 'src/styles.lass.css'
+ * toVirtualCssPath('src/component.module.lass') // => 'src/component.lass.module.css'
+ */
+export declare function toVirtualCssPath(lassPath: string): string;
+/**
+ * Convert a virtual CSS path back to its .lass source path.
+ *
+ * @example
+ * fromVirtualCssPath('src/styles.lass.css') // => 'src/styles.lass'
+ * fromVirtualCssPath('src/component.lass.module.css') // => 'src/component.module.lass'
+ */
+export declare function fromVirtualCssPath(virtualPath: string): string;
+/**
+ * Check if a path is a virtual CSS path (regular or module).
+ */
+export declare function isVirtualCssPath(path: string): boolean;
+/**
+ * Check if a path is a virtual CSS Modules path.
+ */
+export declare function isVirtualModuleCssPath(path: string): boolean;
+/**
+ * Normalize path for cross-platform compatibility.
+ * Converts backslashes to forward slashes.
+ */
+export declare function normalizePath(path: string): string;
+/**
+ * Rewrite relative imports to absolute file:// URLs for isolated execution.
+ *
+ * When executing transpiled Lass code in isolation (data URL or temp file),
+ * relative imports won't resolve correctly. This function converts them to
+ * absolute file:// URLs that work from any execution context.
+ *
+ * Also auto-adds JSON import assertions when missing (required by runtimes).
+ *
+ * @param code - The transpiled JS code
+ * @param baseDir - The directory to resolve relative paths from
+ * @returns The code with rewritten imports
+ */
+export declare function rewriteImportsForExecution(code: string, baseDir: string): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AASH,uCAAuC;AACvC,eAAO,MAAM,QAAQ,UAAU,CAAC;AAEhC,8EAA8E;AAC9E,eAAO,MAAM,eAAe,cAAc,CAAC;AAE3C,oFAAoF;AACpF,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AAEzD;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,QACsE,CAAC;AAMvG;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAQ9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAiBhF"}

package/dist/index.js

@@ -0,0 +1,123 @@
+/**
+ * @lass-lang/plugin-utils
+ *
+ * Shared utilities for Lass bundler plugins.
+ *
+ * These utilities handle bundler-agnostic plugin infrastructure:
+ * - Virtual path conventions for .lass <-> .css mapping
+ * - Import rewriting for isolated execution
+ * - Constants shared across all bundler plugins
+ *
+ * This is separate from:
+ * - Core's transpilation (handled by @lass-lang/core)
+ * - Bundler-specific injection (each plugin implements its own injectStyle)
+ */
+import { posix, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+/** Extension for .lass source files */
+export const LASS_EXT = '.lass';
+/** Virtual CSS extension for regular .lass files: foo.lass -> foo.lass.css */
+export const VIRTUAL_CSS_EXT = '.lass.css';
+/** Virtual CSS extension for CSS Modules: foo.module.lass -> foo.lass.module.css */
+export const VIRTUAL_MODULE_CSS_EXT = '.lass.module.css';
+/**
+ * Regex for matching ES import statements with relative paths.
+ *
+ * Captures:
+ * - Group 1: Import prefix (e.g., "import x from '")
+ * - Group 2: Relative path (e.g., "./file.json")
+ * - Group 3: Quote suffix (e.g., "'")
+ * - Group 4: Trailing content (e.g., " with { type: 'json' };")
+ */
+export const IMPORT_STATEMENT_RE = /^(\s*import\s+(?:[\w*{}\s,]+\s+from\s+)?['"])(\.[^'"]+)(['"])(\s*(?:with\s+\{[^}]*\})?\s*;?\s*)$/gm;
+// ============================================================================
+// VIRTUAL PATH UTILITIES
+// ============================================================================
+/**
+ * Convert a .lass file path to its virtual CSS path.
+ *
+ * @example
+ * toVirtualCssPath('src/styles.lass') // => 'src/styles.lass.css'
+ * toVirtualCssPath('src/component.module.lass') // => 'src/component.lass.module.css'
+ */
+export function toVirtualCssPath(lassPath) {
+    if (lassPath.endsWith('.module.lass')) {
+        return lassPath.slice(0, -'.module.lass'.length) + VIRTUAL_MODULE_CSS_EXT;
+    }
+    return lassPath.slice(0, -LASS_EXT.length) + VIRTUAL_CSS_EXT;
+}
+/**
+ * Convert a virtual CSS path back to its .lass source path.
+ *
+ * @example
+ * fromVirtualCssPath('src/styles.lass.css') // => 'src/styles.lass'
+ * fromVirtualCssPath('src/component.lass.module.css') // => 'src/component.module.lass'
+ */
+export function fromVirtualCssPath(virtualPath) {
+    if (virtualPath.endsWith(VIRTUAL_MODULE_CSS_EXT)) {
+        return virtualPath.slice(0, -VIRTUAL_MODULE_CSS_EXT.length) + '.module.lass';
+    }
+    if (virtualPath.endsWith(VIRTUAL_CSS_EXT)) {
+        return virtualPath.slice(0, -VIRTUAL_CSS_EXT.length) + LASS_EXT;
+    }
+    return virtualPath;
+}
+/**
+ * Check if a path is a virtual CSS path (regular or module).
+ */
+export function isVirtualCssPath(path) {
+    return path.endsWith(VIRTUAL_CSS_EXT) || path.endsWith(VIRTUAL_MODULE_CSS_EXT);
+}
+/**
+ * Check if a path is a virtual CSS Modules path.
+ */
+export function isVirtualModuleCssPath(path) {
+    return path.endsWith(VIRTUAL_MODULE_CSS_EXT);
+}
+// ============================================================================
+// PATH UTILITIES
+// ============================================================================
+/**
+ * Normalize path for cross-platform compatibility.
+ * Converts backslashes to forward slashes.
+ */
+export function normalizePath(path) {
+    return path.split(/[\\/]/).join(posix.sep);
+}
+// ============================================================================
+// IMPORT REWRITING
+// ============================================================================
+/**
+ * Rewrite relative imports to absolute file:// URLs for isolated execution.
+ *
+ * When executing transpiled Lass code in isolation (data URL or temp file),
+ * relative imports won't resolve correctly. This function converts them to
+ * absolute file:// URLs that work from any execution context.
+ *
+ * Also auto-adds JSON import assertions when missing (required by runtimes).
+ *
+ * @param code - The transpiled JS code
+ * @param baseDir - The directory to resolve relative paths from
+ * @returns The code with rewritten imports
+ */
+export function rewriteImportsForExecution(code, baseDir) {
+    return code.replace(IMPORT_STATEMENT_RE, (_match, prefix, relativePath, suffix, trailing) => {
+        const absolutePath = resolve(baseDir, relativePath);
+        const fileUrl = pathToFileURL(absolutePath).href;
+        // Handle import assertions
+        let assertion = '';
+        if (trailing.includes('with')) {
+            // Already has assertion, don't add another
+            assertion = '';
+        }
+        else if (relativePath.endsWith('.json')) {
+            // Auto-add JSON assertion (required by runtimes)
+            assertion = " with { type: 'json' }";
+        }
+        return `${prefix}${fileUrl}${suffix}${assertion}${trailing}`;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@lass-lang/plugin-utils",
+  "version": "0.0.1",
+  "description": "Shared utilities for Lass bundler plugins",
+  "author": "Long-lazuli",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
+  },
+  "keywords": [
+    "lass",
+    "plugin",
+    "utilities",
+    "bundler",
+    "vite",
+    "bun"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lass-lang/plugin-utils.git"
+  },
+  "bugs": {
+    "url": "https://github.com/lass-lang/plugin-utils/issues"
+  },
+  "homepage": "https://github.com/lass-lang/plugin-utils#readme"
+}