@lass-lang/core 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Initial release preparation
+
+## [0.0.1] - 2026-02-07
+
+### Added
+- Initial development version
+- Two-zone model with `---` separator for JS preamble
+- Dollar substitution (`$name` variables)
+- Expression interpolation (`{{ expr }}`)
+- Property lookup (`@(prop)` and `@prop` shorthand)
+- Style blocks (`@{ }` CSS fragments from JS)
+- Single-line comment stripping (`//`)
+- Error handling with `LassTranspileError` and error categories

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Long-lazuli
+
+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,93 @@
+# @lass-lang/core
+
+Core transpiler for the Lass language. Converts `.lass` files to executable JavaScript modules that produce CSS.
+
+## Installation
+
+```bash
+pnpm add @lass-lang/core
+```
+
+## Usage
+
+```typescript
+import { transpile } from '@lass-lang/core';
+
+// Transpile Lass source to a JavaScript module
+const source = `
+.button {
+  color: blue;
+  padding: 8px 16px;
+}
+`;
+
+const { code } = transpile(source);
+// code is a JS module string that exports the CSS
+
+// Execute the transpiled code to get CSS
+const dataUrl = `data:text/javascript;charset=utf-8,${encodeURIComponent(code)}`;
+const module = await import(dataUrl);
+console.log(module.default); // The CSS string
+```
+
+## API
+
+### `transpile(source, options?)`
+
+Transpiles Lass source code to a JavaScript module.
+
+**Parameters:**
+- `source` (string): The Lass source code
+- `options` (TranspileOptions, optional):
+  - `filename` (string): Source file path for error messages
+  - `sourceMap` (boolean): Generate source maps (future)
+
+**Returns:** `TranspileResult`
+- `code` (string): The generated JavaScript module code
+- `map` (string, optional): Source map (future)
+
+### Error Handling
+
+```typescript
+import { LassTranspileError, ErrorCategory } from '@lass-lang/core';
+
+try {
+  const { code } = transpile(source, { filename: 'style.lass' });
+} catch (error) {
+  if (error instanceof LassTranspileError) {
+    console.error(`${error.category} error at line ${error.location.line}`);
+  }
+}
+```
+
+**Error Categories:**
+- `ErrorCategory.SCAN` - Scanner-level errors
+- `ErrorCategory.SYMBOL` - Symbol detection errors
+- `ErrorCategory.SYNTAX` - Syntax errors
+
+## Features
+
+The Lass transpiler supports the full language feature set:
+
+- **Two-zone model** - Use `---` separator to define a JS preamble zone followed by a CSS zone
+- **Dollar substitution** - `$name` text substitution from preamble variables
+- **Expression interpolation** - `{{ expr }}` for inline JavaScript expressions
+- **Property lookup** - `@(prop)` or `@prop` shorthand to reference previously defined CSS property values
+- **Style blocks** - `@{ }` to embed CSS fragments generated from JavaScript
+- **Comment stripping** - `//` single-line comments are removed from output
+
+## TypeScript Support
+
+For TypeScript projects using `.lass` files, add type declarations:
+
+```typescript
+// lass.d.ts
+declare module '*.lass' {
+  const css: string;
+  export default css;
+}
+```
+
+## License
+
+MIT

package/dist/constants.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Runtime helper constants for @lass-lang/core
+ *
+ * These are JavaScript code strings that get injected into the transpiled
+ * output. They provide runtime behavior for Lass symbols.
+ */
+/**
+ * Runtime helper function for {{ expression }} output.
+ * Story 2.4: Array auto-join and null/undefined handling.
+ * Enhanced: Falsy suppression and multi-line re-indentation.
+ *
+ * - null/undefined/false -> '' (React-style silent handling)
+ * - arrays -> recursively flattened, filtered, stringified, then joined
+ *   - If any element contains newline, join with newline (multi-line blocks)
+ *   - Otherwise join with empty string (inline values)
+ * - other values -> String coercion
+ * - Multi-line strings are re-indented using the optional indent parameter
+ */
+export declare const LASS_SCRIPT_EXPRESSION_HELPER = "const __lassScriptExpression = (v, indent = '') => { if (v == null || v === false) return ''; if (Array.isArray(v)) { const a = v.flat(Infinity).map(x => (x == null || x === false) ? '' : String(x)).filter(x => x); const sep = a.some(x => x.includes('\\n')) ? '\\n' : ''; return a.join(sep); } const s = String(v); if (!indent || !s.includes('\\n')) return s; return s.split('\\n').map((l, i) => i === 0 ? l : indent + l).join('\\n'); };";
+/**
+ * Runtime helper function for $param variable substitution.
+ * Story 4.1: Variable Substitution
+ *
+ * - null -> 'unset' (CSS-meaningful fallback)
+ * - undefined or ReferenceError -> preserve '$name' unchanged
+ * - other values -> String coercion
+ *
+ * The getter function (g) delays evaluation so we can catch ReferenceError
+ * for non-existent variables.
+ */
+export declare const LASS_SCRIPT_LOOKUP_HELPER = "const __lassScriptLookup = (n, g) => { try { const v = g(); return v === null ? 'unset' : v === undefined ? '$' + n : v; } catch { return '$' + n; } };";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,6BAA6B,0bAA0b,CAAC;AAEre;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,4JAA4J,CAAC"}

package/dist/constants.js

@@ -0,0 +1,32 @@
+/**
+ * Runtime helper constants for @lass-lang/core
+ *
+ * These are JavaScript code strings that get injected into the transpiled
+ * output. They provide runtime behavior for Lass symbols.
+ */
+/**
+ * Runtime helper function for {{ expression }} output.
+ * Story 2.4: Array auto-join and null/undefined handling.
+ * Enhanced: Falsy suppression and multi-line re-indentation.
+ *
+ * - null/undefined/false -> '' (React-style silent handling)
+ * - arrays -> recursively flattened, filtered, stringified, then joined
+ *   - If any element contains newline, join with newline (multi-line blocks)
+ *   - Otherwise join with empty string (inline values)
+ * - other values -> String coercion
+ * - Multi-line strings are re-indented using the optional indent parameter
+ */
+export const LASS_SCRIPT_EXPRESSION_HELPER = `const __lassScriptExpression = (v, indent = '') => { if (v == null || v === false) return ''; if (Array.isArray(v)) { const a = v.flat(Infinity).map(x => (x == null || x === false) ? '' : String(x)).filter(x => x); const sep = a.some(x => x.includes('\\n')) ? '\\n' : ''; return a.join(sep); } const s = String(v); if (!indent || !s.includes('\\n')) return s; return s.split('\\n').map((l, i) => i === 0 ? l : indent + l).join('\\n'); };`;
+/**
+ * Runtime helper function for $param variable substitution.
+ * Story 4.1: Variable Substitution
+ *
+ * - null -> 'unset' (CSS-meaningful fallback)
+ * - undefined or ReferenceError -> preserve '$name' unchanged
+ * - other values -> String coercion
+ *
+ * The getter function (g) delays evaluation so we can catch ReferenceError
+ * for non-existent variables.
+ */
+export const LASS_SCRIPT_LOOKUP_HELPER = `const __lassScriptLookup = (n, g) => { try { const v = g(); return v === null ? 'unset' : v === undefined ? '$' + n : v; } catch { return '$' + n; } };`;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,ubAAub,CAAC;AAEre;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,yJAAyJ,CAAC"}

package/dist/context-tracker.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Shared context tracking utilities for protected zones in CSS.
+ *
+ * Story 4.2: Extracted to reduce code duplication between
+ * findDollarVariablesStatic() and findStyleLookupShorthandsStatic().
+ *
+ * Protected contexts are zones where Lass symbols ($param, @prop) should
+ * NOT be detected:
+ * - String literals ("..." or '...')
+ * - Block comments (slash-star ... star-slash)
+ *
+ * Note: url() is NOT a protected context - only strings and comments are.
+ */
+/**
+ * Tracks context state for protected zones during scanning.
+ */
+export interface ContextState {
+    /** Currently inside a string literal ("..." or '...') */
+    inString: boolean;
+    /** The quote character that opened the current string */
+    stringChar: string;
+    /** Currently inside a block comment */
+    inBlockComment: boolean;
+}
+/**
+ * Creates a fresh context state for scanning.
+ */
+export declare function createContextState(): ContextState;
+/**
+ * Checks if currently in a protected context (string or block comment).
+ * Protected contexts prevent symbol detection for $param and @prop.
+ *
+ * Note: url() is NOT a protected context - only strings and comments are.
+ */
+export declare function isInProtectedContext(state: ContextState): boolean;
+/**
+ * Updates context state based on current character.
+ * Handles block comments and string literals with proper escape handling.
+ *
+ * @param text - The full text being scanned
+ * @param index - Current character index
+ * @param state - Context state to update (mutated)
+ * @returns Number of characters consumed (1 normally, 2 for comment markers)
+ */
+export declare function updateContextState(text: string, index: number, state: ContextState): number;
+//# sourceMappingURL=context-tracker.d.ts.map

package/dist/context-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-tracker.d.ts","sourceRoot":"","sources":["../src/context-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,QAAQ,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAMjD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAEjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,YAAY,GAClB,MAAM,CAoCR"}

package/dist/context-tracker.js

@@ -0,0 +1,76 @@
+/**
+ * Shared context tracking utilities for protected zones in CSS.
+ *
+ * Story 4.2: Extracted to reduce code duplication between
+ * findDollarVariablesStatic() and findStyleLookupShorthandsStatic().
+ *
+ * Protected contexts are zones where Lass symbols ($param, @prop) should
+ * NOT be detected:
+ * - String literals ("..." or '...')
+ * - Block comments (slash-star ... star-slash)
+ *
+ * Note: url() is NOT a protected context - only strings and comments are.
+ */
+/**
+ * Creates a fresh context state for scanning.
+ */
+export function createContextState() {
+    return {
+        inString: false,
+        stringChar: '',
+        inBlockComment: false,
+    };
+}
+/**
+ * Checks if currently in a protected context (string or block comment).
+ * Protected contexts prevent symbol detection for $param and @prop.
+ *
+ * Note: url() is NOT a protected context - only strings and comments are.
+ */
+export function isInProtectedContext(state) {
+    return state.inString || state.inBlockComment;
+}
+/**
+ * Updates context state based on current character.
+ * Handles block comments and string literals with proper escape handling.
+ *
+ * @param text - The full text being scanned
+ * @param index - Current character index
+ * @param state - Context state to update (mutated)
+ * @returns Number of characters consumed (1 normally, 2 for comment markers)
+ */
+export function updateContextState(text, index, state) {
+    const char = text[index];
+    const nextChar = text[index + 1];
+    // Track block comment start: /*
+    if (!state.inString && !state.inBlockComment && char === '/' && nextChar === '*') {
+        state.inBlockComment = true;
+        return 2;
+    }
+    // Track block comment end: */
+    if (state.inBlockComment && char === '*' && nextChar === '/') {
+        state.inBlockComment = false;
+        return 2;
+    }
+    // Track string literals (only when not in comment)
+    if (!state.inBlockComment && (char === '"' || char === "'")) {
+        if (!state.inString) {
+            state.inString = true;
+            state.stringChar = char;
+        }
+        else if (char === state.stringChar) {
+            // Check for escaped quote - count consecutive backslashes
+            let backslashCount = 0;
+            for (let j = index - 1; j >= 0 && text[j] === '\\'; j--) {
+                backslashCount++;
+            }
+            // If odd number of backslashes, quote is escaped
+            if (backslashCount % 2 === 0) {
+                state.inString = false;
+            }
+        }
+        return 1;
+    }
+    return 1;
+}
+//# sourceMappingURL=context-tracker.js.map

package/dist/context-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-tracker.js","sourceRoot":"","sources":["../src/context-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAcH;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,QAAQ,EAAE,KAAK;QACf,UAAU,EAAE,EAAE;QACd,cAAc,EAAE,KAAK;KACtB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAmB;IACtD,OAAO,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,cAAc,CAAC;AAChD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,KAAa,EACb,KAAmB;IAEnB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAE,CAAC;IAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAEjC,gCAAgC;IAChC,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,IAAI,IAAI,KAAK,GAAG,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;QACjF,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC;QAC5B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,8BAA8B;IAC9B,IAAI,KAAK,CAAC,cAAc,IAAI,IAAI,KAAK,GAAG,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;QAC7D,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC;QAC7B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,mDAAmD;IACnD,IAAI,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;YACtB,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;QAC1B,CAAC;aAAM,IAAI,IAAI,KAAK,KAAK,CAAC,UAAU,EAAE,CAAC;YACrC,0DAA0D;YAC1D,IAAI,cAAc,GAAG,CAAC,CAAC;YACvB,KAAK,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;gBACxD,cAAc,EAAE,CAAC;YACnB,CAAC;YACD,iDAAiD;YACjD,IAAI,cAAc,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC;YACzB,CAAC;QACH,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Error handling infrastructure for Lass transpiler.
+ *
+ * Provides structured error types with source location information
+ * for actionable error messages following NFR-ERROR requirements.
+ */
+/**
+ * Error categories for Lass transpilation errors.
+ * Used to classify errors and provide appropriate guidance.
+ */
+export declare enum ErrorCategory {
+    /** Scanner-level errors (context tracking, unexpected characters) */
+    SCAN = "SCAN",
+    /** Symbol detection errors ($name, {{ }}, @{ }, etc.) */
+    SYMBOL = "SYMBOL",
+    /** Syntax errors (malformed Lass constructs) */
+    SYNTAX = "SYNTAX"
+}
+/**
+ * Source location information for error reporting.
+ * Provides precise positioning within the source file.
+ */
+export interface SourceLocation {
+    /** Line number (1-based) */
+    line: number;
+    /** Column number (1-based) */
+    column: number;
+    /** Character offset from start of file (0-based) */
+    offset: number;
+}
+/**
+ * Extended location with optional file path.
+ */
+export interface FileLocation extends SourceLocation {
+    /** Source file path (if available) */
+    filename?: string;
+}
+/**
+ * Custom error class for Lass transpilation errors.
+ *
+ * Provides structured error information including:
+ * - Source file path (when provided)
+ * - Line and column numbers
+ * - Error category for classification
+ * - Actionable error description
+ *
+ * Error message format follows NFR-ERROR requirements:
+ * "[filename:]line:column - [CATEGORY] description"
+ */
+export declare class LassTranspileError extends Error {
+    /** Error category for classification */
+    readonly category: ErrorCategory;
+    /** Source location where the error occurred */
+    readonly location: FileLocation;
+    /**
+     * Creates a new transpilation error.
+     *
+     * @param message - Actionable error description
+     * @param category - Error category (SCAN, SYMBOL, SYNTAX)
+     * @param location - Source location information
+     */
+    constructor(message: string, category: ErrorCategory, location: FileLocation);
+    /**
+     * Creates an error with just a source position.
+     * Useful when filename is not available.
+     */
+    static at(message: string, category: ErrorCategory, line: number, column: number, offset?: number): LassTranspileError;
+    /**
+     * Creates an error with file path and source position.
+     */
+    static atFile(message: string, category: ErrorCategory, filename: string, line: number, column: number, offset?: number): LassTranspileError;
+}
+/**
+ * Helper to format source location for display.
+ *
+ * @param location - Source location to format
+ * @returns Formatted string like "filename:line:column" or "line:column"
+ */
+export declare function formatLocation(location: FileLocation): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,oBAAY,aAAa;IACvB,qEAAqE;IACrE,IAAI,SAAS;IACb,yDAAyD;IACzD,MAAM,WAAW;IACjB,gDAAgD;IAChD,MAAM,WAAW;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IAEjC,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAEhC;;;;;;OAMG;gBACS,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY;IAiB5E;;;OAGG;IACH,MAAM,CAAC,EAAE,CACP,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAU,GACjB,kBAAkB;IAIrB;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAU,GACjB,kBAAkB;CAGtB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAG7D"}

package/dist/errors.js

@@ -0,0 +1,81 @@
+/**
+ * Error handling infrastructure for Lass transpiler.
+ *
+ * Provides structured error types with source location information
+ * for actionable error messages following NFR-ERROR requirements.
+ */
+/**
+ * Error categories for Lass transpilation errors.
+ * Used to classify errors and provide appropriate guidance.
+ */
+export var ErrorCategory;
+(function (ErrorCategory) {
+    /** Scanner-level errors (context tracking, unexpected characters) */
+    ErrorCategory["SCAN"] = "SCAN";
+    /** Symbol detection errors ($name, {{ }}, @{ }, etc.) */
+    ErrorCategory["SYMBOL"] = "SYMBOL";
+    /** Syntax errors (malformed Lass constructs) */
+    ErrorCategory["SYNTAX"] = "SYNTAX";
+})(ErrorCategory || (ErrorCategory = {}));
+/**
+ * Custom error class for Lass transpilation errors.
+ *
+ * Provides structured error information including:
+ * - Source file path (when provided)
+ * - Line and column numbers
+ * - Error category for classification
+ * - Actionable error description
+ *
+ * Error message format follows NFR-ERROR requirements:
+ * "[filename:]line:column - [CATEGORY] description"
+ */
+export class LassTranspileError extends Error {
+    /** Error category for classification */
+    category;
+    /** Source location where the error occurred */
+    location;
+    /**
+     * Creates a new transpilation error.
+     *
+     * @param message - Actionable error description
+     * @param category - Error category (SCAN, SYMBOL, SYNTAX)
+     * @param location - Source location information
+     */
+    constructor(message, category, location) {
+        // Format: "[filename:]line:column - [CATEGORY] message"
+        const prefix = location.filename ? `${location.filename}:` : '';
+        const formattedMessage = `${prefix}${location.line}:${location.column} - [${category}] ${message}`;
+        super(formattedMessage);
+        this.name = 'LassTranspileError';
+        this.category = category;
+        this.location = location;
+        // Maintain proper stack trace in V8 environments
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, LassTranspileError);
+        }
+    }
+    /**
+     * Creates an error with just a source position.
+     * Useful when filename is not available.
+     */
+    static at(message, category, line, column, offset = 0) {
+        return new LassTranspileError(message, category, { line, column, offset });
+    }
+    /**
+     * Creates an error with file path and source position.
+     */
+    static atFile(message, category, filename, line, column, offset = 0) {
+        return new LassTranspileError(message, category, { filename, line, column, offset });
+    }
+}
+/**
+ * Helper to format source location for display.
+ *
+ * @param location - Source location to format
+ * @returns Formatted string like "filename:line:column" or "line:column"
+ */
+export function formatLocation(location) {
+    const prefix = location.filename ? `${location.filename}:` : '';
+    return `${prefix}${location.line}:${location.column}`;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,CAAN,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,qEAAqE;IACrE,8BAAa,CAAA;IACb,yDAAyD;IACzD,kCAAiB,CAAA;IACjB,gDAAgD;IAChD,kCAAiB,CAAA;AACnB,CAAC,EAPW,aAAa,KAAb,aAAa,QAOxB;AAuBD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,wCAAwC;IAC/B,QAAQ,CAAgB;IAEjC,+CAA+C;IACtC,QAAQ,CAAe;IAEhC;;;;;;OAMG;IACH,YAAY,OAAe,EAAE,QAAuB,EAAE,QAAsB;QAC1E,wDAAwD;QACxD,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,MAAM,gBAAgB,GAAG,GAAG,MAAM,GAAG,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,MAAM,OAAO,QAAQ,KAAK,OAAO,EAAE,CAAC;QAEnG,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAExB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,iDAAiD;QACjD,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,EAAE,CACP,OAAe,EACf,QAAuB,EACvB,IAAY,EACZ,MAAc,EACd,SAAiB,CAAC;QAElB,OAAO,IAAI,kBAAkB,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,OAAe,EACf,QAAuB,EACvB,QAAgB,EAChB,IAAY,EACZ,MAAc,EACd,SAAiB,CAAC;QAElB,OAAO,IAAI,kBAAkB,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvF,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,QAAsB;IACnD,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;AACxD,CAAC"}

package/dist/helpers.d.ts

@@ -0,0 +1,24 @@
+/**
+ * String escape utilities for @lass-lang/core
+ *
+ * Functions for escaping text when embedding in various contexts.
+ */
+/**
+ * Escapes special characters for template literal embedding.
+ * Only escapes backslash and backtick - NOT dollar sign (needed for substitution).
+ *
+ * @param text - Text to escape
+ * @returns Escaped text safe for template literal
+ */
+export declare function escapeForTemplateLiteral(text: string): string;
+/**
+ * Escapes a value for embedding in a JavaScript string literal.
+ * Story 3.3: Used when @(prop) is inside {{ }} context.
+ *
+ * Escapes: backslash, double quote, newline, carriage return
+ *
+ * @param value - The value to escape
+ * @returns Escaped value safe for JS string embedding
+ */
+export declare function escapeForJs(value: string): string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjD"}

package/dist/helpers.js

@@ -0,0 +1,32 @@
+/**
+ * String escape utilities for @lass-lang/core
+ *
+ * Functions for escaping text when embedding in various contexts.
+ */
+/**
+ * Escapes special characters for template literal embedding.
+ * Only escapes backslash and backtick - NOT dollar sign (needed for substitution).
+ *
+ * @param text - Text to escape
+ * @returns Escaped text safe for template literal
+ */
+export function escapeForTemplateLiteral(text) {
+    return text.replace(/\\/g, '\\\\').replace(/`/g, '\\`');
+}
+/**
+ * Escapes a value for embedding in a JavaScript string literal.
+ * Story 3.3: Used when @(prop) is inside {{ }} context.
+ *
+ * Escapes: backslash, double quote, newline, carriage return
+ *
+ * @param value - The value to escape
+ * @returns Escaped value safe for JS string embedding
+ */
+export function escapeForJs(value) {
+    return value
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '\\r');
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK;SACT,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @lass-lang/core
+ *
+ * Lass language transpiler core package.
+ * Converts .lass files to executable JavaScript modules that produce CSS.
+ *
+ * Transpilation Pipeline (The Story):
+ * 1. detectZones() - Split source into preamble and CSS zones
+ * 2. stripLineComments() - Remove // comments from CSS zone
+ * 3. normalizeStyleLookupShorthands() - @prop -> @(prop)
+ * 4. resolvePropertyAccessors() - @(prop) -> value
+ * 5. resolveDollarVariables() - $param -> ${...}
+ * 6. processExpressions() - {{ expr }} -> ${...}
+ * 7. buildOutput() - Assemble final JS module
+ *
+ * This is the "igloo" view - each function is a building block.
+ * Drill into transpiler.ts for step implementations.
+ */
+import type { TranspileResult, TranspileOptions } from './types.js';
+/**
+ * Transpiles Lass source code to a JavaScript module.
+ *
+ * The Story (Igloo Principle):
+ * 1. Split the file into preamble and CSS zones at the ---
+ * 2. Strip // comments from CSS zone
+ * 3. Normalize @prop -> @(prop) shorthands
+ * 4. Resolve @(prop) accessors to their values
+ * 5. Replace $param with ${...} for variable substitution
+ * 6. Find {{ expressions }} and make them interpolations
+ * 7. Wrap it all in a JS module that exports CSS
+ *
+ * Implementation History:
+ * - Story 1.4: CSS passthrough - wraps input in JS module export
+ * - Story 2.1: Two-zone detection - splits on ---, identifies preamble and CSS zones
+ * - Story 2.2: Preamble execution - includes preamble in output, executes when imported
+ * - Story 2.3: Expression interpolation - transforms {{ expr }} to ${expr} in template literal
+ * - Story 2.4: Array auto-join - wraps expressions in __lassScriptExpression() for array/null handling
+ * - Story 2.5: Universal {{ }} - processed everywhere in CSS zone (strings, url(), comments)
+ * - Story 3.2: @(prop) resolution - resolves @(prop) to previously-declared CSS values (Phase 1)
+ * - Story 3.3: @(prop) in {{ }} - detects @(prop) inside expressions, quotes values for JS context
+ * - Refactored: Changed from @prop to @(prop) for unambiguous syntax (supports custom properties)
+ * - Story 4.1: $param substitution - replaces $param with ${$param} for template literal interpolation
+ * - Story 4.2: @prop shorthand - normalizes @prop to @(prop) before resolution
+ * - Story 4.4: // comment stripping - removes single-line comments from CSS zone
+ *
+ * @param source - The Lass source code
+ * @param options - Transpilation options
+ * @returns The transpiled JavaScript module code
+ */
+export declare function transpile(source: string, options?: TranspileOptions): TranspileResult;
+export type { TranspileResult, TranspileOptions } from './types.js';
+export { Scanner } from './scanner.js';
+/**
+ * Re-exported types from scanner module.
+ * - ScanResult: Result of a scan operation
+ * - ScanOptions: Options for scanner customization
+ * - ZoneSplit: Result of zone separation (preamble/CSS)
+ * - ExpressionSplit: Result of {{ }} expression splitting
+ * - PropertyAccessor: Info about detected @(prop) accessor (propName, indices)
+ * - DollarVariable: Info about detected $param variable (varName, indices)
+ * - StyleLookupShorthand: Info about detected @prop shorthand (propName, indices)
+ */
+export type { ScanResult, ScanOptions, ZoneSplit, ExpressionSplit, PropertyAccessor, DollarVariable, StyleLookupShorthand } from './scanner.js';
+export { LassTranspileError, ErrorCategory, formatLocation, type SourceLocation, type FileLocation, } from './errors.js';
+export { cutByBraces, findPropertyValue, areSiblingTrees, isInsideAtRule, type ScopeSlice, type ScopeSlices, } from './scope-tracker.js';
+//# 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;;;;;;;;;;;;;;;;;GAiBG;AAWH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAMpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CAuBjB;AAMD,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAMpE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC;;;;;;;;;GASG;AACH,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAMhJ,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AAMrB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,oBAAoB,CAAC"}