@jesscss/core 2.0.0-alpha.1

package/lib/logger.d.ts

@@ -0,0 +1,10 @@
+export interface Logger {
+    configure?(log: Logger): void;
+    log?(...args: any[]): void;
+    info?(...args: any[]): void;
+    warn?(...args: any[]): void;
+    error?(...args: any[]): void;
+}
+/** Configure with custom behavior */
+export declare const logger: Required<Logger>;
+//# sourceMappingURL=logger.d.ts.map

package/lib/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,MAAM;IACrB,SAAS,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CAC9B;AACD,qCAAqC;AACrC,eAAO,MAAM,MAAM,EAAE,QAAQ,CAAC,MAAM,CAoBnC,CAAC"}

package/lib/logger.js

@@ -0,0 +1,20 @@
+import chalk from 'chalk';
+/** Configure with custom behavior */
+export const logger = {
+    configure(log) {
+        Object.assign(logger, log);
+    },
+    log(...args) {
+        console.log(...args);
+    },
+    info(...args) {
+        console.info(...args);
+    },
+    warn(...args) {
+        console.error(chalk.yellow(...args));
+    },
+    error(...args) {
+        console.error(chalk.red(...args));
+    }
+};
+//# sourceMappingURL=logger.js.map

package/lib/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAS1B,qCAAqC;AACrC,MAAM,CAAC,MAAM,MAAM,GAAqB;IACtC,SAAS,CAAC,GAAW;QACnB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,GAAG,IAAW;QAChB,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,CAAC,GAAG,IAAW;QACjB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,IAAI,CAAC,GAAG,IAAW;QACjB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,GAAG,IAAW;QAClB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;CACF,CAAC"}

package/lib/plugin.d.ts

@@ -0,0 +1,94 @@
+import type { Rules } from './tree/rules.js';
+import type { Visitor } from './visitor/index.js';
+import { type ErrorDiagnostic, type WarningDiagnostic } from './jess-error.js';
+export type ISafeParseResult = {
+    /**
+     * The parsed tree, if parsing succeeded
+     */
+    tree?: Rules;
+    /**
+     * Normalized errors from parsing.
+     * This should include ALL errors from lexing, parsing, and any plugin-level issues.
+     * Plugins should convert all errors to normalized ErrorDiagnostic format.
+     * Always an array (empty if no errors).
+     */
+    errors: ErrorDiagnostic[];
+    /**
+     * Normalized warnings from parsing.
+     * This should include ALL warnings from lexing, parsing, and any plugin-level issues.
+     * Plugins should convert all warnings to normalized WarningDiagnostic format.
+     * Always an array (empty if no warnings).
+     */
+    warnings: WarningDiagnostic[];
+};
+export interface PluginInterface {
+    /**
+     * e.g. 'less-plugin'
+     */
+    name: string;
+    /**
+     * Queryable filter if we have resolved the extension
+     * no dots e.g. `['less', 'scss']`
+     */
+    supportedExtensions?: string[];
+    /**
+     * Expand an import path into a set of paths to try.
+     * e.g.
+     *   `@import 'foo'` -> `['./foo.less']`
+     *   `@import 'foo'` -> `['./foo.scss', './_foo.scss']`
+     */
+    expandImport?(importPath: string, currentDir: string): string[];
+    /**
+     * e.g.
+     *   `./foo` -> `/Users/foo/bar/foo`
+     *   `@/alias` -> `/Users/foo/bar/src/alias`
+     *   `one/two` -> `/Users/foo/node_modules/one/two`
+     *
+     * Does not attempt to check if the path exists.
+     * Note: paths may already be absolute.
+     *
+     * If the plugin has nothing to change, return `null` or return the array as-is.
+     *
+     * @note - I suppose a plugin doesn't have to resolve to an absolute path, if it's
+     *         using some other method to handle the resolved paths in `locate()`.
+     *         To that end, `locate()` shouldn't presume that the paths are absolute.
+     */
+    resolve?(path: string | string[], currentDir: string, searchPaths: string[]): null | string[] | Promise<null | string[]>;
+    /**
+     * Pick the first one that exists. Return null to let another plugin handle the path.
+     */
+    locate?(pathCandidates: string[], currentDir: string): null | string | Promise<string | null>;
+    /**
+     * Get the source code for the file.
+     */
+    getSource?(absoluteFilePath: string): Promise<string>;
+    /**
+     * If we have the extension in `supportedExtensions`, and this method exists,
+     * then this plugin is assumed to be able to parse the file.
+     */
+    parse?(filePath: string, source: string): Rules;
+    /** No errors thrown; instead will return errors in the result */
+    safeParse?(filePath: string, source: string): ISafeParseResult;
+    /** If this method exists, then the plugin can return a JS module / object */
+    import?(absoluteFilePath: string): Promise<Record<string, any>>;
+    /** Post-parse or post-eval visitor(s) */
+    visitor?: Visitor | Visitor[];
+    /** Pre-eval visitor(s) - called before node.eval() during the preEval phase */
+    preEvalVisitor?: Visitor | Visitor[];
+    /** Post-eval visitor(s) - called after node.eval() (alternative to visitor for clarity) */
+    postEvalVisitor?: Visitor | Visitor[];
+}
+export declare abstract class AbstractPlugin implements PluginInterface {
+    abstract name: string;
+    /**
+     * Does a basic path resolution. Node resolution is in other plugins.
+     */
+    resolve(filePath: string | string[], currentDir: string, searchPaths: string[]): string[];
+    /** Default source getter */
+    getSource(absoluteFilePath: string): Promise<string>;
+    /** Gets the first match using from the filesystem that exists */
+    locate(pathCandidates: string[], currentDir: string): null | string;
+    parse(filePath: string, source: string): Rules;
+}
+export type Plugin = <T extends Record<string, any>>(opts?: T) => PluginInterface;
+//# sourceMappingURL=plugin.d.ts.map

package/lib/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAI7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAsB,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAA2B,MAAM,iBAAiB,CAAC;AAE5H,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;OAEG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC;IACb;;;;;OAKG;IACH,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B;;;;;OAKG;IACH,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE/B;;;;;OAKG;IACH,YAAY,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEhE;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,GAAG,MAAM,EAAE,CAAC,CAAC;IAEzH;;OAEG;IACH,MAAM,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE9F;;OAEG;IACH,SAAS,CAAC,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtD;;;OAGG;IACH,KAAK,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IAEhD,iEAAiE;IACjE,SAAS,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAE/D,6EAA6E;IAC7E,MAAM,CAAC,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAEhE,yCAAyC;IACzC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;IAC9B,+EAA+E;IAC/E,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;IACrC,2FAA2F;IAC3F,eAAe,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;CACvC;AAID,8BAAsB,cAAe,YAAW,eAAe;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE;IAkB9E,4BAA4B;IACtB,SAAS,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAS1D,iEAAiE;IACjE,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM;IAUnE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK;CAkC/C;AAED,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,KAAK,eAAe,CAAC"}

package/lib/plugin.js

@@ -0,0 +1,174 @@
+import { join, isAbsolute, resolve } from 'node:path';
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { JessError } from './jess-error.js';
+const { isArray } = Array;
+export class AbstractPlugin {
+    /**
+     * Does a basic path resolution. Node resolution is in other plugins.
+     */
+    resolve(filePath, currentDir, searchPaths) {
+        const bases = [currentDir, ...searchPaths];
+        const out = [];
+        const seen = new Set();
+        filePath = isArray(filePath) ? filePath : [filePath];
+        for (const base of bases) {
+            const baseDir = isAbsolute(base) ? base : join(currentDir, base);
+            for (const path of filePath) {
+                const abs = resolve(baseDir, path);
+                if (abs && !seen.has(abs)) {
+                    seen.add(abs);
+                    out.push(abs);
+                }
+            }
+        }
+        return out;
+    }
+    /** Default source getter */
+    async getSource(absoluteFilePath) {
+        try {
+            const result = await readFile(absoluteFilePath, 'utf8');
+            return result;
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+    /** Gets the first match using from the filesystem that exists */
+    locate(pathCandidates, currentDir) {
+        for (const candidate of pathCandidates) {
+            const absolutePath = isAbsolute(candidate) ? candidate : join(currentDir, candidate);
+            if (existsSync(absolutePath)) {
+                return absolutePath;
+            }
+        }
+        return null;
+    }
+    parse(filePath, source) {
+        const safeParse = this.safeParse;
+        if (!safeParse) {
+            throw new Error(`Plugin "${this.name}" does not support parsing`);
+        }
+        const { tree, errors } = safeParse.call(this, filePath, source);
+        if (errors.length > 0) {
+            const firstError = errors[0];
+            throw new JessError({
+                code: firstError.code,
+                phase: firstError.phase,
+                severity: 'error',
+                ctx: firstError.file ? { file: firstError.file } : undefined,
+                filePath: firstError.filePath,
+                source: firstError.file?.source,
+                line: firstError.line,
+                column: firstError.column,
+                reason: firstError.reason,
+                fix: firstError.fix,
+                note: firstError.note,
+                errors: firstError.errors,
+                lexerErrors: firstError.lexerErrors
+            });
+        }
+        if (!tree) {
+            throw new Error(`Plugin "${this.name}" failed to parse "${filePath}"`);
+        }
+        return tree;
+    }
+}
+// export abstract class FileManager<O extends Record<string, any> = Record<string, any>> {
+//   abstract supportedExtensions?: string[];
+//   constructor(
+//     public opts: Partial<O> = {}
+//   ) {}
+//   /**
+//    * Turns relative paths into absolute paths.
+//    * e.g.
+//    *   `./foo` -> `/Users/foo/bar/foo`
+//    *   `@/alias` -> `/Users/foo/bar/src/alias`
+//    *   `one/two` -> `/Users/foo/node_modules/one/two`
+//    *
+//    * Does not attempt to check if the path exists.
+//    * Note: paths may already be absolute.
+//    */
+//   abstract resolver?(paths: Set<string>, currentDir: string): Set<string>;
+//   /**
+//    * e.g.
+//    *   Less file manager: `@import 'foo'` -> `['./foo.less']`
+//    *   Sass file manager: `@import 'foo'` -> `['./foo.scss', './_foo.scss']`
+//    */
+//   abstract getPathsToTry?(filePath: string, currentDir: string, paths: string[], options: PathOptions): Set<string>;
+//   /**
+//    * Get the final resolved path.
+//    *
+//    * @param filePath Will be a partial path
+//    * @param paths The paths to search. This should always contain
+//    * the directory context where the file was imported. Can be
+//    * a fully-qualified path or a glob. Relative paths
+//    * will be resolved relative to process.cwd(). Plugins
+//    * may alter the paths array and return false to let another
+//    * plugin handle the path resolution.
+//    * @param options Determined by the file manager
+//    */
+//   resolvePath(
+//     filePath: string,
+//     currentDir: string,
+//     paths: string[],
+//     options: PathOptions
+//   ): string | string[] {
+//     filePath = this.opts.resolver(filePath);
+//     const pathsTried: string[] = [];
+//     if (isAbsolute(filePath)) {
+//       pathsTried.push(filePath);
+//       if (existsSync(filePath)) {
+//         return filePath;
+//       }
+//     }
+//     let isRelative = filePath.startsWith('.');
+//     let tryPath: string | undefined;
+//     if (options.allowBareRelative || isRelative) {
+//       tryPath = join(currentDir, filePath);
+//       pathsTried.push(tryPath);
+//       if (existsSync(tryPath)) {
+//         return tryPath;
+//       }
+//     }
+//     if (!isRelative) {
+//       try {
+//         tryPath = require.resolve(filePath);
+//         if (existsSync(tryPath)) {
+//           return tryPath;
+//         }
+//       } catch (err) {
+//         // ignore
+//       }
+//     }
+//     for (let i = 0; i < paths.length; i++) {
+//       tryPath = join(paths[i]!, filePath);
+//       pathsTried.push(tryPath);
+//       if (existsSync(tryPath)) {
+//         return tryPath;
+//       }
+//     }
+//     return pathsTried;
+//   }
+//   async loadFile(fullPath: string) {
+//     return await readFile(fullPath, 'utf8');
+//   }
+//   /**
+//    * Can override this instead of `getTree` if we want
+//    * to preserve extension-checking logic.
+//    */
+//   protected async _getTree(fullPath: string, options?: Record<string, any>): Promise<Rules | false> {
+//     return false;
+//   }
+//   /**
+//    * @param fullPath The fully resolved path
+//    */
+//   async getTree(fullPath: string, options?: Record<string, any>): Promise<Rules | false> {
+//     const supported = this.supportedExtensions;
+//     if (supported && !supported.includes(extname(fullPath))) {
+//       return false;
+//     }
+//     return await this._getTree(fullPath, options);
+//   }
+// }
+//# sourceMappingURL=plugin.js.map

package/lib/plugin.js.map

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

package/lib/tree/ampersand.d.ts

@@ -0,0 +1,94 @@
+import { type NodeOptions, type LocationInfo, type TreeContext, type Node } from './node.js';
+import { Nil } from './nil.js';
+import type { Context } from '../context.js';
+import { SimpleSelector } from './selector-simple.js';
+import { type Selector } from './selector.js';
+import { type PrintOptions } from './util/print.js';
+export type AmpersandValue = {
+    /**
+     * The only value that may exist is an anonymous value
+     * This is represented as &(). Any &() will signal
+     * a forced output (as well as an adjacent ident starting with
+     * a dash or numbers)
+     *
+     * @example
+       .rule {
+         &-foo {
+           color: red;
+         }
+       }
+       // output:
+       .rule-foo {
+         color: red;
+       }
+  
+       .rule {
+         &(-foo) {
+           color: red;
+         }
+       }
+       // output:
+       .rule-foo {
+         color: red;
+       }
+  
+      .rule {
+         &.foo {
+           color: red;
+         }
+       }
+       // output:
+       .rule {
+         &.foo {
+           color: red;
+         }
+       }
+  
+       .rule {
+         &().foo {
+           color: red;
+         }
+       }
+       // output:
+       .rule.foo {
+         color: red;
+       }
+  
+     */
+    /** Set to an empty string to hoist to root */
+    appendValue?: string;
+    /**
+     * When set (e.g. by ruleset preEval), returns the current parent ruleset's selector ("pointer").
+     * Prefer this over value.selector so extend sees the parent after it has been mutated (e.g. by extend).
+     */
+    selectorContainer?: {
+        selector?: Selector | Nil | undefined;
+    };
+};
+/**
+ * The '&' selector element
+ */
+export declare class Ampersand extends SimpleSelector<{
+    appendValue?: string;
+}> {
+    type: "Ampersand";
+    shortType: "amp";
+    private _storedSelector;
+    private _selectorContainer;
+    constructor(value?: AmpersandValue | string, options?: NodeOptions, location?: LocationInfo, treeContext?: TreeContext);
+    get keySet(): Set<string>;
+    /** The keys of an ampersand are the keys of the selector it contains */
+    protected _computeKeySetAndFastReject(): void;
+    /**
+     * Returns the current selector from the selector container (live when container is ruleset value).
+     * Used by extend, serialization, and matching so nested rules see the parent after extend.
+     */
+    getResolvedSelector(): Selector | Nil | undefined;
+    valueOf(): string;
+    toTrimmedString(options?: PrintOptions): string;
+    /** Hmm this should never return Extend */
+    evalNode(context: Context): Selector | Nil;
+    clone(deep?: boolean, cloneFn?: (n: Node) => Node): this;
+}
+export declare const amp: (value?: string | AmpersandValue | undefined, options?: NodeOptions | undefined, location?: LocationInfo | undefined) => Ampersand;
+//# sourceMappingURL=ampersand.d.ts.map

package/lib/tree/ampersand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ampersand.d.ts","sourceRoot":"","sources":["../../src/tree/ampersand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAqC,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAC5I,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAKtD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,KAAK,YAAY,EAAmB,MAAM,iBAAiB,CAAC;AAErE,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiDG;IACH,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,iBAAiB,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,GAAG,GAAG,SAAS,CAAA;KAAE,CAAC;CAC/D,CAAC;AAEF;;GAEG;AACH,qBAAa,SAAU,SAAQ,cAAc,CAAC;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;IAC5D,IAAI,EAAG,WAAW,CAAU;IACrC,SAAS,EAAG,KAAK,CAAU;IAE3B,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,kBAAkB,CAAwD;gBAGhF,KAAK,CAAC,EAAE,cAAc,GAAG,MAAM,EAC/B,OAAO,CAAC,EAAE,WAAW,EACrB,QAAQ,CAAC,EAAE,YAAY,EACvB,WAAW,CAAC,EAAE,WAAW;IAoB3B,IAAa,MAAM,gBAYlB;IAED,wEAAwE;cACrD,2BAA2B,IAAI,IAAI;IAqBtD;;;OAGG;IACH,mBAAmB,IAAI,QAAQ,GAAG,GAAG,GAAG,SAAS;IAUxC,OAAO;IAQP,eAAe,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM;IAiBxD,0CAA0C;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,GAAG,GAAG;IAwJ1C,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,KAAK,IAAI,GAAG,IAAI;CAYlE;AAED,eAAO,MAAM,GAAG,oIAA4C,CAAC"}