jess 1.0.8-alpha.7 → 2.0.0-alpha.2

package/bin/cli.js

@@ -1,97 +1,57 @@
 #!/usr/bin/env node
-const render = require('../lib/render').render
-const yargs = require('yargs/yargs')
-const fs = require('fs')
-const path = require('path')
-const chalk = require('chalk')
-
-const rollup = require('rollup')
-const commonJs = require('@rollup/plugin-commonjs')
-const nodeResolve = require('@rollup/plugin-node-resolve').default
-const jess = require('rollup-plugin-jess').default
-const terser = require('rollup-plugin-terser').terser
-
-
-const { hideBin } = require('yargs/helpers')
-const args =
-  yargs(hideBin(process.argv))
-    .check(argv => {
-      const filePaths = argv._
-      if (!filePaths.length) {
-        throw new Error(chalk.yellow('Input filename required.'))
-      } else {
-        return true
-      }
-    })
-    .option('o', {
-      alias: 'out',
-      describe: 'Output folder',
-      type: 'string'
-    })
-    .option('b', {
-      alias: 'bundle',
-      default: false,
-      type: 'boolean',
-      describe: 'Create a runtime bundle module'
-    })
-    .example([
-      ['$0 input.jess', 'Compile to input.css'],
-      ['$0 input.jess output.css', 'Customize output file'],
-      ['$0 input.jess -o dist', 'Output to the dist directory']
-    ])
-
-const argv = args.argv
+import yargs from 'yargs/yargs';
+import { hideBin } from 'yargs/helpers';
+import fs from 'node:fs';
+import path from 'node:path';
+import chalk from 'chalk';
+import { Compiler } from '../lib/index.js';
+
+const args = yargs(hideBin(process.argv))
+  .check((argv) => {
+    const filePaths = argv._;
+    if (!filePaths.length) {
+      throw new Error(chalk.yellow('Input filename required.'));
+    }
+    return true;
+  })
+  .option('o', {
+    alias: 'out',
+    describe: 'Output folder',
+    type: 'string'
+  })
+  .example([
+    ['$0 input.jess', 'Compile to input.css'],
+    ['$0 input.less', 'Compile Less to input.css'],
+    ['$0 input.jess output.css', 'Customize output file'],
+    ['$0 input.jess -o dist', 'Output to the dist directory']
+  ]);
+
+const argv = args.parseSync();
 
 const start = async () => {
-  const startTime = new Date()
-  const files = argv._
-  const inFile = files[0]
-  let cssFile = files[1] || inFile.replace(/\.jess/, '.css')
-  const outDir = path.resolve(process.cwd(), argv.o || path.dirname(cssFile))
-  cssFile = path.basename(cssFile)
+  const startTime = Date.now();
+  const files = argv._;
+  const inFile = String(files[0]);
+  let cssFile = files[1] ? String(files[1]) : inFile.replace(/\.(jess|less)$/, '.css');
+  const outDir = path.resolve(process.cwd(), argv.o || path.dirname(cssFile));
+  cssFile = path.basename(cssFile);
 
   try {
-    const hasErr = await fs.promises.access(path.resolve(process.cwd(), inFile), fs.constants.R_OK)
-    if (hasErr) {
-      throw ''
-    }
-  } catch (e) {
-    throw new Error(`Could not read "${inFile}"`)
+    await fs.promises.access(path.resolve(process.cwd(), inFile), fs.constants.R_OK);
+  } catch {
+    throw new Error(`Could not read "${inFile}"`);
   }
-  
-  let css
 
-  if (argv.b) {
-    const bundle = await rollup.rollup({
-      input: inFile,
-      plugins: [
-        commonJs(),
-        nodeResolve(),
-        jess()
-      ]
-    })
-    const { output } = await bundle.generate({
-      plugins: [terser()]
-    })
-    const js = output[0].code
-    const jsFile = cssFile.replace(/\.css/, '.js')
-    await fs.promises.writeFile(path.resolve(outDir, jsFile), js)
-    css = output[1].source
-  } else {
-    /** @todo - Allow setting of options in the cli? */
-    /** @todo - Write bundles and map */
-    const result = await render(inFile, {})
-    css = result.$toCSS()
-  }
+  const compiler = new Compiler();
+  const css = await compiler.render(inFile, {});
 
-  await fs.promises.writeFile(path.resolve(outDir, cssFile), css)
+  await fs.promises.writeFile(path.resolve(outDir, cssFile), css);
 
-  const endTime = new Date()
-  const seconds = Math.round((endTime - startTime) / 10) / 100
-  console.log(`${chalk.blue('Finished in')} ${chalk.cyan(seconds + 's')}`)
-}
+  const seconds = Math.round((Date.now() - startTime) / 10) / 100;
+  console.log(`${chalk.blue('Finished in')} ${chalk.cyan(seconds + 's')}`);
+};
 
-start()
-  .catch(e => {
-    console.error(chalk.red(e.message))
-  })
+start().catch((e) => {
+  console.error(chalk.red(e.message));
+  process.exit(1);
+});

package/lib/config.d.ts

@@ -1,2 +1,33 @@
-declare let result: any;
-export default result;
+import { type StylesConfig } from 'styles-config';
+/**
+ * Get configuration from styles.config.* or jess.config.* file, searching from the given directory
+ * up through parent directories.
+ *
+ * @param searchFrom - File or directory path to start searching from (searches up to root)
+ * @returns Configuration object, or empty object if no config found
+ */
+export declare const getConfig: (searchFrom?: string) => StylesConfig;
+export interface ConfigWithMeta {
+    config: StylesConfig;
+    configFilePath?: string;
+}
+export declare const getConfigWithMeta: (searchFrom?: string) => ConfigWithMeta;
+export interface OutputTestConfig {
+    file: string;
+    config: Partial<StylesConfig>;
+}
+/**
+ * Get the expected output CSS file(s) and config(s) for testing.
+ *
+ * Supports:
+ * - No output config: Returns default {name}.css with empty config
+ * - Single output object: `output: { file: "{name}.css", collapseNesting: false, ... }`
+ *   - Returns the file and uses those options for compilation
+ * - Multiple outputs array: `output: [{ file: "{name}.css", ... }, ...]`
+ *   - Returns array of {file, config} objects - test should iterate and test each
+ * - Default options: First object in array without `file` property provides defaults
+ *
+ * @param lessFilePath - Path to the LESS file
+ * @returns Single output config, or array of output configs if multiple outputs defined
+ */
+export declare function getExpectedOutputFiles(lessFilePath: string): OutputTestConfig | OutputTestConfig[];

package/lib/config.js

@@ -1,15 +1,102 @@
-"use strict";
-var _a;
-Object.defineProperty(exports, "__esModule", { value: true });
-const cosmiconfig_1 = require("cosmiconfig");
-const explorerSync = cosmiconfig_1.cosmiconfigSync('jess', {
-    searchPlaces: [
-        '.jessrc.js',
-        'jess.config.js'
-    ]
-});
-let result = ((_a = explorerSync.search()) === null || _a === void 0 ? void 0 : _a.config) || { options: {} };
-if ('default' in result) {
-    result = result.default;
+import * as path from 'path';
+import { loadConfigSync, loadConfigSyncWithMeta } from 'styles-config';
+/**
+ * Get configuration from styles.config.* or jess.config.* file, searching from the given directory
+ * up through parent directories.
+ *
+ * @param searchFrom - File or directory path to start searching from (searches up to root)
+ * @returns Configuration object, or empty object if no config found
+ */
+export const getConfig = (searchFrom) => {
+    return loadConfigSync(searchFrom);
+};
+export const getConfigWithMeta = (searchFrom) => {
+    return loadConfigSyncWithMeta(searchFrom);
+};
+/**
+ * Get the expected output CSS file(s) and config(s) for testing.
+ *
+ * Supports:
+ * - No output config: Returns default {name}.css with empty config
+ * - Single output object: `output: { file: "{name}.css", collapseNesting: false, ... }`
+ *   - Returns the file and uses those options for compilation
+ * - Multiple outputs array: `output: [{ file: "{name}.css", ... }, ...]`
+ *   - Returns array of {file, config} objects - test should iterate and test each
+ * - Default options: First object in array without `file` property provides defaults
+ *
+ * @param lessFilePath - Path to the LESS file
+ * @returns Single output config, or array of output configs if multiple outputs defined
+ */
+export function getExpectedOutputFiles(lessFilePath) {
+    // getConfig expects a directory, so pass the directory of the less file
+    const config = getConfig(path.dirname(lessFilePath));
+    const outputConfig = config.output;
+    // Preserve non-output config (compile/language/etc.) so fixture-level styles.config
+    // can drive compiler behavior in tests.
+    const { output: ignoredOutput, ...baseConfig } = config;
+    void ignoredOutput;
+    // Extract file name without extension for {name} replacement
+    const dir = path.dirname(lessFilePath);
+    const name = path.basename(lessFilePath, path.extname(lessFilePath));
+    // No output config, default to {name}.css
+    if (!outputConfig) {
+        return {
+            file: path.join(dir, `${name}.css`),
+            config: baseConfig
+        };
+    }
+    // Handle single output object
+    if (!Array.isArray(outputConfig)) {
+        const file = outputConfig.file || '{name}.css';
+        const outputFile = file.replace('{name}', name);
+        // Extract config options (everything except 'file')
+        const configOptions = Object.fromEntries(Object.entries(outputConfig).filter(([key]) => key !== 'file'));
+        return {
+            file: path.join(dir, outputFile),
+            config: { ...baseConfig, output: configOptions }
+        };
+    }
+    // Handle array of outputs
+    if (outputConfig.length === 0) {
+        return {
+            file: path.join(dir, `${name}.css`),
+            config: {}
+        };
+    }
+    // First object without 'file' property is default options
+    let defaultOptions = {};
+    let startIndex = 0;
+    if (outputConfig[0] && !('file' in outputConfig[0])) {
+        defaultOptions = { ...outputConfig[0] };
+        startIndex = 1;
+    }
+    // Build array of output configs
+    const outputs = [];
+    for (let i = startIndex; i < outputConfig.length; i++) {
+        const output = outputConfig[i];
+        if (!output || typeof output !== 'object' || !('file' in output)) {
+            continue;
+        }
+        // Merge default options with this output's options
+        const { file: outputFile, ...outputOptions } = output;
+        const mergedOptions = { ...defaultOptions, ...outputOptions };
+        const file = outputFile || '{name}.css';
+        const finalFile = file.replace('{name}', name);
+        outputs.push({
+            file: path.join(dir, finalFile),
+            config: { ...baseConfig, output: mergedOptions }
+        });
+    }
+    // If only one output, return it directly (not as array)
+    if (outputs.length === 1) {
+        return outputs[0];
+    }
+    // Return array if multiple outputs
+    return outputs.length > 0
+        ? outputs
+        : [{
+                file: path.join(dir, `${name}.css`),
+                config: baseConfig
+            }];
 }
-exports.default = result;
+//# sourceMappingURL=config.js.map

package/lib/config.js.map

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

package/lib/diagnostics.d.ts

@@ -0,0 +1,14 @@
+import type { ErrorDiagnostic, WarningDiagnostic } from '@jesscss/core';
+/**
+ * Formats and outputs diagnostics (errors and warnings) to the console.
+ * Uses linecraft's CodeDebug component for formatted code frames.
+ *
+ * @param errors - Array of error diagnostics
+ * @param warnings - Array of warning diagnostics
+ * @param options - Output options
+ */
+export declare function outputDiagnostics(errors: ErrorDiagnostic[], warnings: WarningDiagnostic[], options?: {
+    suppressWarnings?: boolean;
+    breakOnError?: boolean;
+    verbose?: boolean;
+}): void;

package/lib/diagnostics.js

@@ -0,0 +1,153 @@
+import { relative, resolve } from 'node:path';
+import { CodeDebug, Region } from 'linecraft';
+/**
+ * Formats and outputs diagnostics (errors and warnings) to the console.
+ * Uses linecraft's CodeDebug component for formatted code frames.
+ *
+ * @param errors - Array of error diagnostics
+ * @param warnings - Array of warning diagnostics
+ * @param options - Output options
+ */
+export function outputDiagnostics(errors, warnings, options = {}) {
+    const { suppressWarnings = false, breakOnError = true, verbose = false } = options;
+    // Merge warnings intelligently:
+    // 1. Group by code + filePath + line (for similar warnings like extend targets)
+    // 2. For warnings with parameterized messages (like "Extend target X"), merge them
+    const warningGroups = new Map();
+    for (const warning of warnings) {
+        // For extend warnings and similar parameterized messages, group by code + filePath + line
+        // This merges "Extend target .a not accessible" and "Extend target .b not accessible" into one group
+        const isParameterized = warning.code === 'extend/not-found' || warning.code === 'extend/not-accessible';
+        const groupKey = isParameterized
+            ? `${warning.code}:${warning.filePath ?? ''}:${warning.line}`
+            : `${warning.code}:${warning.message}:${warning.filePath ?? ''}:${warning.line}`;
+        const existing = warningGroups.get(groupKey);
+        if (existing) {
+            existing.warnings.push(warning);
+        }
+        else {
+            warningGroups.set(groupKey, { warnings: [warning], representative: warning });
+        }
+    }
+    // Output warnings to stdout (unless suppressed)
+    if (!suppressWarnings && warningGroups.size > 0) {
+        for (const { warnings: groupWarnings, representative } of warningGroups.values()) {
+            if (groupWarnings.length === 1) {
+                // Single warning - output as-is
+                outputDiagnostic(representative, 'warning', process.stdout, verbose, 1);
+            }
+            else {
+                // Multiple similar warnings - merge them
+                // Don't show repeat count since we're already summarizing multiple different warnings
+                const merged = mergeSimilarWarnings(groupWarnings, representative);
+                outputDiagnostic(merged, 'warning', process.stdout, verbose, 1);
+            }
+        }
+    }
+    // Output errors to stderr
+    // By default, only output the first error (unless breakOnError is false)
+    const errorsToOutput = breakOnError ? errors.slice(0, 1) : errors;
+    for (const error of errorsToOutput) {
+        outputDiagnostic(error, 'error', process.stderr, verbose);
+    }
+}
+/**
+ * Merges multiple similar warnings into a single diagnostic with a combined message.
+ * For parameterized warnings like "Extend target X not accessible", combines all targets.
+ */
+function mergeSimilarWarnings(warnings, representative) {
+    // Extract parameterized values from messages (e.g., ".a", ".b" from "Extend target .a not accessible")
+    const targets = [];
+    for (const warning of warnings) {
+        // Extract the target from messages like "Extend target ".a" not accessible"
+        const match = warning.message.match(/Extend target "([^"]+)" (not found|not accessible)/);
+        if (match) {
+            targets.push(match[1]);
+        }
+    }
+    // Create merged message
+    let mergedMessage;
+    if (targets.length > 0) {
+        if (targets.length <= 5) {
+            // Show all targets if 5 or fewer
+            mergedMessage = `Extend target${targets.length > 1 ? 's' : ''} ${targets.map(t => `"${t}"`).join(', ')} ${representative.message.includes('not accessible') ? 'not accessible' : 'not found'}`;
+        }
+        else {
+            // Show first 3 and count if more
+            const shown = targets.slice(0, 3).map(t => `"${t}"`).join(', ');
+            const remaining = targets.length - 3;
+            mergedMessage = `Extend targets ${shown} and ${remaining} more ${representative.message.includes('not accessible') ? 'not accessible' : 'not found'}`;
+        }
+    }
+    else {
+        // Fallback: use representative message with count
+        mergedMessage = representative.message;
+    }
+    return {
+        ...representative,
+        message: mergedMessage
+    };
+}
+/**
+ * Outputs a single diagnostic using linecraft's CodeDebug component.
+ * The output will persist in the terminal after the region is destroyed.
+ */
+function outputDiagnostic(diagnostic, type, stream = process.stdout, verbose = false, repeatCount = 1) {
+    const { code, phase, message, reason, fix, filePath, line, column, lines, note } = diagnostic;
+    const endLine = 'endLine' in diagnostic ? diagnostic.endLine : undefined;
+    const endColumn = 'endColumn' in diagnostic ? diagnostic.endColumn : undefined;
+    // Get file paths
+    const fullPath = filePath ? resolve(filePath) : '';
+    const shortPath = filePath ? relative(process.cwd(), filePath) : '(unknown)';
+    // Extract lines for code frame
+    const lineNumbers = lines ? Object.keys(lines).map(Number).sort((a, b) => a - b) : [];
+    const errorLineNum = line;
+    const errorLineContent = lines?.[errorLineNum] ?? '';
+    const lineBefore = lineNumbers.length > 0 && lineNumbers[0] < errorLineNum
+        ? lines?.[errorLineNum - 1] ?? null
+        : null;
+    const lineAfter = lineNumbers.length > 0 && lineNumbers[lineNumbers.length - 1] > errorLineNum
+        ? lines?.[errorLineNum + 1] ?? null
+        : null;
+    // Build message - send raw strings to CodeDebug
+    const messageLines = [
+        `${code} [${phase}]`,
+        message
+    ];
+    // Add repeat count if > 1 (only for exact duplicates, not merged similar warnings)
+    // The repeatCount is only meaningful when it represents the same exact warning repeated
+    if (repeatCount > 1 && !message.includes(' and ') && !message.includes('more')) {
+        messageLines.push(`(repeated ${repeatCount} time${repeatCount > 1 ? 's' : ''})`);
+    }
+    // Only include reason and fix if verbose mode is enabled
+    if (verbose) {
+        messageLines.push('');
+        messageLines.push(`Reason: ${reason}`);
+        messageLines.push(`Fix: ${fix}`);
+    }
+    if (note) {
+        messageLines.push(note.startsWith('Note:') ? note : `Note: ${note}`);
+    }
+    const fullMessage = messageLines.join('\n');
+    // Create CodeDebug component and output it to the specified stream
+    // Region will use getTerminalWidth() which should handle redirected streams
+    const region = Region({ stdout: stream });
+    region.set(CodeDebug({
+        startLine: errorLineNum,
+        startColumn: column,
+        endLine: endLine,
+        endColumn: endColumn,
+        errorLine: errorLineContent,
+        lineBefore: lineBefore,
+        lineAfter: lineAfter,
+        message: fullMessage,
+        filePath: shortPath,
+        fullPath: fullPath,
+        type: type
+    }));
+    // Flush to ensure rendering, then destroy without clearing to persist output
+    // This will write the content to the terminal permanently
+    void region.flush();
+    void region.destroy(false); // false = don't clear, persist the output
+}
+//# sourceMappingURL=diagnostics.js.map

package/lib/diagnostics.js.map

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

package/lib/index.d.ts

@@ -1,8 +1,84 @@
-/**
- * For tree-shaking, this should only export
- * things needed for the client-side runtime
- */
-export * from './tree';
-export { Context } from './context';
-export * from './render-css';
-export * from './util';
+import { Context, type ErrorDiagnostic, type WarningDiagnostic, type Deprecation } from '@jesscss/core';
+import { type StylesConfig } from 'styles-config';
+export type ConfigOptions = StylesConfig & {
+    /** Output file path for matching against output config options */
+    outputFile?: string;
+    /** Suppress warnings (similar to Less's suppressWarnings option) */
+    suppressWarnings?: boolean;
+    /** Break on first error (stop processing after first error). Default: true */
+    breakOnError?: boolean;
+    /** Show detailed reason and fix in diagnostics. Default: false */
+    verbose?: boolean;
+    /** Deprecation warnings of these types will cause an error to be thrown */
+    fatalDeprecations?: Iterable<Deprecation>;
+    /** Whether to limit repetition of deprecation warnings (max 5). Default: true */
+    limitDeprecationRepetition?: boolean;
+};
+export declare class Compiler {
+    opts: ConfigOptions;
+    constructor(opts?: ConfigOptions);
+    /**
+     * Create a context with the configured plugins
+     */
+    createContext(filePath?: string, renderOptions?: Partial<ConfigOptions>): Context;
+    compile(filePath: string, options?: Partial<ConfigOptions>): Promise<{
+        tree: any;
+        context: Context;
+    }>;
+    /**
+     * Render CSS from a file path
+     */
+    render(filePath: string, options?: Partial<ConfigOptions>): Promise<any>;
+    /**
+     * Render CSS from a string content
+     */
+    renderString(content: string, options?: {
+        filePath?: string;
+        language?: string;
+        extension?: string;
+        config?: Partial<ConfigOptions>;
+    }): Promise<string>;
+    /**
+     * Renders to CSS and returns a structured result object containing CSS and metadata.
+     * Can accept either a file path or string content.
+     * Similar to dart-sass's compileToResult() pattern, but uses "render" naming to match less.js.
+     *
+     * @param input - File path (string) or source content (object with source string)
+     * @param options - Render options
+     * @returns RenderResult with css, errors, warnings, and loadedUrls
+     */
+    renderToResult(input: string | {
+        source: string;
+        filePath?: string;
+        language?: string;
+        extension?: string;
+    }, options?: Partial<ConfigOptions> & {
+        filePath?: string;
+        language?: string;
+        extension?: string;
+    }): Promise<{
+        css: string;
+        errors: ErrorDiagnostic[];
+        warnings: WarningDiagnostic[];
+        loadedUrls: string[];
+    }>;
+    /**
+     * Safe version of compile that collects errors and warnings instead of throwing.
+     * Returns the tree (or null if compilation failed) along with collected errors and warnings.
+     */
+    safeCompile(filePath: string, options?: Partial<ConfigOptions>): Promise<{
+        tree: any | null;
+        context: Context;
+        errors: ErrorDiagnostic[];
+        warnings: WarningDiagnostic[];
+    }>;
+    /**
+     * Safe version of render that collects errors and warnings instead of throwing.
+     * Returns the CSS (or null if rendering failed) along with collected errors and warnings.
+     */
+    safeRender(filePath: string, options?: Partial<ConfigOptions>): Promise<{
+        css: string | null;
+        errors: ErrorDiagnostic[];
+        warnings: WarningDiagnostic[];
+    }>;
+}