@jesscss/core 2.0.0-alpha.1

package/lib/tree/list.d.ts

@@ -0,0 +1,38 @@
+import { type Context } from '../context.js';
+import { Node } from './node.js';
+import { type PrintOptions } from './util/print.js';
+import { type Operator } from './util/calculate.js';
+export type ListOptions = {
+    /**
+     * Lists can be separated by comma, semi-colon,
+     * or slash, depending on the type of list.
+     *
+     * @todo - Is there a more CSS-y way to define this?
+     */
+    sep?: ',' | ';' | '/';
+};
+export interface List<T extends Node = Node> extends Node<T[], ListOptions> {
+    eval(context: Context): Promise<this>;
+}
+/**
+ * A list of expressions
+ *
+ * i.e. one, two, three
+ * or .sel, #id.class, [attr]
+ * or one / two / three
+ */
+export declare class List<T extends Node = Node> extends Node<T[], ListOptions> {
+    type: string;
+    shortType: string;
+    get length(): number;
+    [Symbol.iterator](): Generator<[number, T], void, unknown>;
+    private _valueOf;
+    valueOf(): string;
+    toTrimmedString(options?: PrintOptions): string;
+    compare(other: Node): 0 | 1 | -1 | undefined;
+    operate(b: Node, op: Operator, context: Context): List<T>;
+}
+type Params = ConstructorParameters<typeof List>;
+export declare const list: (value: Params[0], options?: Params[1], location?: Params[2], treeContext?: Params[3]) => List;
+export {};
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/tree/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAc,IAAI,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,KAAK,YAAY,EAAmB,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD,MAAM,MAAM,WAAW,GAAG;IACxB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;CACvB,CAAC;AAEF,MAAM,WAAW,IAAI,CAAC,CAAC,SAAS,IAAI,GAAG,IAAI,CAAE,SAAQ,IAAI,CAAC,CAAC,EAAE,EAAE,WAAW,CAAC;IACzE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED;;;;;;GAMG;AACH,qBAAa,IAAI,CAAC,CAAC,SAAS,IAAI,GAAG,IAAI,CAAE,SAAQ,IAAI,CAAC,CAAC,EAAE,EAAE,WAAW,CAAC;IACrE,IAAI,SAAU;IACd,SAAS,SAAU;IAEnB,IAAI,MAAM,WAET;IAEC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAInB,OAAO,CAAC,QAAQ,CAAqB;IAE5B,OAAO;IAIP,eAAe,CAAC,OAAO,CAAC,EAAE,YAAY;IA4BtC,OAAO,CAAC,KAAK,EAAE,IAAI;IAenB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;CA2DnE;AAED,KAAK,MAAM,GAAG,qBAAqB,CAAC,OAAO,IAAI,CAAC,CAAC;AAEjD,eAAO,MAAM,IAAI,EAA+B,CAC9C,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EACpB,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,KACpB,IAAI,CAAC"}

package/lib/tree/list.js

@@ -0,0 +1,83 @@
+import { defineType, Node } from './node.js';
+import { getPrintOptions } from './util/print.js';
+import { compareNodeArray } from './util/compare.js';
+import { LIST_ITEM_TRIM } from './util/regex.js';
+/**
+ * A list of expressions
+ *
+ * i.e. one, two, three
+ * or .sel, #id.class, [attr]
+ * or one / two / three
+ */
+export class List extends Node {
+    type = 'List';
+    shortType = 'list';
+    get length() {
+        return this.value.length;
+    }
+    *[Symbol.iterator]() {
+        yield* this.value.entries();
+    }
+    _valueOf;
+    valueOf() {
+        return (this._valueOf ??= this.value.map(v => v.valueOf()).join(';'));
+    }
+    toTrimmedString(options) {
+        options = getPrintOptions(options);
+        const w = options.writer;
+        let { sep = ',' } = this.options ?? {};
+        let { value } = this;
+        let length = value.length;
+        const mark = w.mark();
+        if (value.length === 0) {
+            return '';
+        }
+        // Print first item as-is
+        let item = value[0];
+        let out = w.capture(() => item.toString(options));
+        w.add(out.replace(LIST_ITEM_TRIM, ''), item);
+        // Subsequent items: emit sep; capture next item to decide spacing precisely
+        for (let i = 1; i < length; i++) {
+            item = value[i];
+            if (sep === '/') {
+                w.add(' / ');
+            }
+            else {
+                w.add(`${sep} `);
+            }
+            out = (w.capture(() => item.toString(options))).replace(LIST_ITEM_TRIM, '');
+            w.add(out);
+        }
+        return w.getSince(mark);
+    }
+    compare(other) {
+        if (other instanceof List) {
+            const equalityMode = this.treeContext?.equalityMode ?? 'coerce';
+            const result = compareNodeArray(this.value, other.value, equalityMode);
+            return result;
+        }
+        if (other.type === 'Any') {
+            const normalize = (s) => s.replace(/;\s*/g, ', ').replace(/\s+/g, ' ').trim();
+            const left = normalize(this.toString());
+            const right = normalize(other.toString());
+            return left === right ? 0 : undefined;
+        }
+        return undefined;
+    }
+    operate(b, op, context) {
+        if (op !== '+') {
+            throw new Error(`List operation "${op}" not supported`);
+        }
+        let newList = this.maybeClone(context);
+        if (b instanceof List) {
+            newList.value.push(...b.value);
+        }
+        else {
+            /** @todo - do we need to verify the list type? */
+            newList.value.push(b);
+        }
+        return newList;
+    }
+}
+export const list = defineType(List, 'List');
+//# sourceMappingURL=list.js.map

package/lib/tree/list.js.map

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

package/lib/tree/log.d.ts

@@ -0,0 +1,29 @@
+import { type Context } from '../context.js';
+import { Node, type LocationInfo, type NodeOptions, type TreeContext } from './node.js';
+import { Nil } from './nil.js';
+import type { MaybePromise } from '@jesscss/awaitable-pipe';
+export type LogLevel = 'debug' | 'warn' | 'error';
+export type LogValue = {
+    level: LogLevel;
+    message: Node;
+};
+export interface Log extends Node<LogValue, NodeOptions> {
+    eval(context: Context): MaybePromise<Nil>;
+}
+/**
+ * A log node for diagnostic at-rules (@debug, @warn, @error).
+ * These are compile-time diagnostic directives that should not appear in CSS output.
+ */
+export declare class Log extends Node<LogValue, NodeOptions> {
+    type: "Log";
+    shortType: "log";
+    allowRoot: boolean;
+    allowRuleRoot: boolean;
+    constructor(value: LogValue, options?: NodeOptions, location?: LocationInfo, treeContext?: TreeContext);
+    toTrimmedString(): string;
+    toString(): string;
+    evalNode(context: Context): MaybePromise<Nil>;
+    private _logMessage;
+}
+export declare const log: (value?: LogValue | undefined, options?: NodeOptions | undefined, location?: LocationInfo | undefined) => Log;
+//# sourceMappingURL=log.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/tree/log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAyB,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAC/G,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAElD,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;CACf,CAAC;AAEF,MAAM,WAAW,GAAI,SAAQ,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC;IACtD,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,qBAAa,GAAI,SAAQ,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC;IAClD,IAAI,EAAG,KAAK,CAAU;IACtB,SAAS,EAAG,KAAK,CAAU;IAClB,SAAS,UAAQ;IACjB,aAAa,UAAQ;gBAG5B,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,WAAW,EACrB,QAAQ,CAAC,EAAE,YAAY,EACvB,WAAW,CAAC,EAAE,WAAW;IAOlB,eAAe;IAKf,QAAQ;IAIR,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC;IAiBtD,OAAO,CAAC,WAAW;CAgBpB;AAED,eAAO,MAAM,GAAG,+GAAyB,CAAC"}

package/lib/tree/log.js

@@ -0,0 +1,56 @@
+import { Node, F_VISIBLE, defineType } from './node.js';
+import { Nil } from './nil.js';
+import { logger } from '../logger.js';
+/**
+ * A log node for diagnostic at-rules (@debug, @warn, @error).
+ * These are compile-time diagnostic directives that should not appear in CSS output.
+ */
+export class Log extends Node {
+    type = 'Log';
+    shortType = 'log';
+    allowRoot = true;
+    allowRuleRoot = true;
+    constructor(value, options, location, treeContext) {
+        super(value, options, location, treeContext);
+        // Log nodes should not be visible (they serialize to empty strings)
+        this.removeFlag(F_VISIBLE);
+    }
+    toTrimmedString() {
+        // Log nodes serialize to empty string since they're not supported in Jess syntax
+        return '';
+    }
+    toString() {
+        return '';
+    }
+    evalNode(context) {
+        // Evaluate the message expression
+        const messageResult = this.value.message.eval(context);
+        // Handle async evaluation if needed
+        if (messageResult && typeof messageResult.then === 'function') {
+            return messageResult.then((evaluatedMessage) => {
+                this._logMessage(evaluatedMessage);
+                return new Nil();
+            });
+        }
+        // Synchronous evaluation
+        this._logMessage(messageResult);
+        return new Nil();
+    }
+    _logMessage(message) {
+        const messageStr = String(message);
+        const { level } = this.value;
+        switch (level) {
+            case 'debug':
+                logger.log?.(messageStr);
+                break;
+            case 'warn':
+                logger.warn?.(messageStr);
+                break;
+            case 'error':
+                logger.error?.(messageStr);
+                break;
+        }
+    }
+}
+export const log = defineType(Log, 'Log');
+//# sourceMappingURL=log.js.map

package/lib/tree/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/tree/log.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAyD,MAAM,WAAW,CAAC;AAC/G,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AActC;;;GAGG;AACH,MAAM,OAAO,GAAI,SAAQ,IAA2B;IAClD,IAAI,GAAG,KAAc,CAAC;IACtB,SAAS,GAAG,KAAc,CAAC;IAClB,SAAS,GAAG,IAAI,CAAC;IACjB,aAAa,GAAG,IAAI,CAAC;IAE9B,YACE,KAAe,EACf,OAAqB,EACrB,QAAuB,EACvB,WAAyB;QAEzB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC7C,oEAAoE;QACpE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAEQ,eAAe;QACtB,iFAAiF;QACjF,OAAO,EAAE,CAAC;IACZ,CAAC;IAEQ,QAAQ;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;IAEQ,QAAQ,CAAC,OAAgB;QAChC,kCAAkC;QAClC,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEvD,oCAAoC;QACpC,IAAI,aAAa,IAAI,OAAQ,aAAqB,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACvE,OAAQ,aAA+B,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,EAAE;gBAChE,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;gBACnC,OAAO,IAAI,GAAG,EAAE,CAAC;YACnB,CAAC,CAAC,CAAC;QACL,CAAC;QAED,yBAAyB;QACzB,IAAI,CAAC,WAAW,CAAC,aAAqB,CAAC,CAAC;QACxC,OAAO,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;IAEO,WAAW,CAAC,OAAa;QAC/B,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAE7B,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,OAAO;gBACV,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC;gBACzB,MAAM;YACR,KAAK,MAAM;gBACT,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC;gBAC1B,MAAM;YACR,KAAK,OAAO;gBACV,MAAM,CAAC,KAAK,EAAE,CAAC,UAAU,CAAC,CAAC;gBAC3B,MAAM;QACV,CAAC;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC"}

package/lib/tree/mixin.d.ts

@@ -0,0 +1,87 @@
+import { Node, type LocationInfo } from './node.js';
+import type { Condition } from './condition.js';
+import { type List } from './list.js';
+import type { Any, AnyRole } from './any.js';
+import type { Rules } from './rules.js';
+import { Interpolated } from './interpolated.js';
+import type { Context, TreeContext } from '../context.js';
+import { type PrintOptions } from './util/print.js';
+import { type MaybePromise } from '@jesscss/awaitable-pipe';
+export interface MixinValue<Name extends AnyRole = 'name'> {
+    /**
+     * Mixin names can include . or # - in Sass they have to be escaped.
+     *
+     * Valid mixin names:
+     *   foo
+     *   foo.bar
+     *   foo#bar
+     *   foo.bar#baz
+     *   foo#bar.baz
+     *   -foo
+     *   _foo (private, from Sass both -foo and _foo are parsed as _foo)
+     *
+     * @todo - Should anonymous mixins have a different class type?
+     */
+    name?: Any<Name> | Interpolated<Name>;
+    /**
+     * Functions can be assigned an expression when parsing,
+     * but it will be evaluated as a set of Rules with a scope
+     * and an implicit `return`
+     */
+    rules: Rules;
+    /**
+     * - A plain node is a kind of value guard.
+     * - A name is just a named variable.
+     * - A var declaration is a named variable with a default value.
+     * - A rest is a rest parameter.
+     */
+    params?: List<Node>;
+    guard?: Condition;
+}
+export type MixinOptions = {
+    /** This is a flag that will set during parsing */
+    hasDefault?: boolean;
+    /**
+     * Cannot be overloaded. Written as !my-mixin() in Jess.
+     * If multiple mixin matches are found with the same
+     * name in a scope, it will throw an error.
+     */
+    unique?: boolean;
+};
+/**
+ * someMixin (arg1; arg2: 10px) {
+ *   color: black;
+ *   background-color: white;
+ *   border-radius: $arg2;
+ * }
+ *
+ *
+ * Note that mixin calls are called as JavaScript functions,
+ * with either only positional arguments, or a plain object
+ * as the first argument, representing named arguments,
+ * followed by positional arguments.
+ *
+ * e.g. `foo($a; $b) { ... }`
+ *   can be called from JS like:
+ *     foo(1, 2) or
+ *     foo({ a: 1, b: 2 }) or
+ *     foo({ b: 2 }, 1)
+ *
+ * @todo - Even though we allow a selector as a name.
+ */
+export declare class Mixin extends Node<MixinValue, MixinOptions> {
+    type: string;
+    shortType: string;
+    constructor(value: MixinValue, options?: MixinOptions, location?: LocationInfo, context?: TreeContext);
+    /** Return a selector-like keySet */
+    private _keySet;
+    get keySet(): Set<string>;
+    toTrimmedString(options?: PrintOptions): string;
+    preEval(context: Context): MaybePromise<this>;
+    /** Since this is a mixin definition, it's not evaluated until it's called. */
+    evalNode(): this;
+}
+type MixinConstructorParams = ConstructorParameters<typeof Mixin>;
+export declare const mixin: (value: MixinValue<AnyRole> | MixinConstructorParams[0], options?: MixinConstructorParams[1], location?: MixinConstructorParams[2], treeContext?: MixinConstructorParams[3]) => Mixin;
+export {};
+//# sourceMappingURL=mixin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mixin.d.ts","sourceRoot":"","sources":["../../src/tree/mixin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,IAAI,EAAc,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAC3E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,KAAK,YAAY,EAAmB,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,KAAK,YAAY,EAAc,MAAM,yBAAyB,CAAC;AAExE,MAAM,WAAW,UAAU,CAAC,IAAI,SAAS,OAAO,GAAG,MAAM;IACvD;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACtC;;;;OAIG;IACH,KAAK,EAAE,KAAK,CAAC;IACb;;;;;OAKG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,kDAAkD;IAClD,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAGF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,KAAM,SAAQ,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC;IACvD,IAAI,SAAW;IACf,SAAS,SAAW;gBAER,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,WAAW;IAOrG,oCAAoC;IACpC,OAAO,CAAC,OAAO,CAA0B;IACzC,IAAI,MAAM,gBAUT;IAEQ,eAAe,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM;IAyB/C,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC;IAmCtD,8EAA8E;IACrE,QAAQ;CAgDlB;AAED,KAAK,sBAAsB,GAAG,qBAAqB,CAAC,OAAO,KAAK,CAAC,CAAC;AAElE,eAAO,MAAM,KAAK,EAAiC,CACjD,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC,EACtD,OAAO,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,EACnC,QAAQ,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,EACpC,WAAW,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,KACpC,KAAK,CAAC"}

package/lib/tree/mixin.js

@@ -0,0 +1,112 @@
+import { F_VISIBLE, Node, defineType } from './node.js';
+import { Interpolated } from './interpolated.js';
+import { getPrintOptions } from './util/print.js';
+import { isThenable } from '@jesscss/awaitable-pipe';
+// const COMPOUND_REGEX = /[#.]?[-_a-zA-Z\xA0-\uFFFF][-_a-zA-Z0-9\xA0-\uFFFF]*/ug;
+/**
+ * someMixin (arg1; arg2: 10px) {
+ *   color: black;
+ *   background-color: white;
+ *   border-radius: $arg2;
+ * }
+ *
+ *
+ * Note that mixin calls are called as JavaScript functions,
+ * with either only positional arguments, or a plain object
+ * as the first argument, representing named arguments,
+ * followed by positional arguments.
+ *
+ * e.g. `foo($a; $b) { ... }`
+ *   can be called from JS like:
+ *     foo(1, 2) or
+ *     foo({ a: 1, b: 2 }) or
+ *     foo({ b: 2 }, 1)
+ *
+ * @todo - Even though we allow a selector as a name.
+ */
+export class Mixin extends Node {
+    type = 'Mixin';
+    shortType = 'mixin';
+    constructor(value, options, location, context) {
+        super(value, options, location, context);
+        this.removeFlag(F_VISIBLE);
+    }
+    // Mixin has preEval method but doesn't need to set flags - preEvaluated is tracked as boolean
+    /** Return a selector-like keySet */
+    _keySet;
+    get keySet() {
+        let keySet = this._keySet;
+        if (!keySet) {
+            let { name } = this.value;
+            if (!name) {
+                return (this._keySet = new Set());
+            }
+            keySet = this._keySet = new Set([name.valueOf()]);
+        }
+        return keySet;
+    }
+    toTrimmedString(options) {
+        options = getPrintOptions(options);
+        const w = options.writer;
+        let { name, rules, params, guard } = this.value;
+        const mark = w.mark();
+        w.add(name ? `${name}` : '@');
+        if (name || params || guard) {
+            w.add('(');
+            if (params) {
+                params.toString(options);
+            }
+            w.add(')');
+        }
+        if (guard) {
+            w.add(' when ');
+            w.add(`${guard}`);
+        }
+        if (name || params || guard) {
+            w.add(' ');
+        }
+        // Emit rules directly into shared writer; do not re-add return value
+        rules.toBraced(options);
+        return w.getSince(mark);
+    }
+    preEval(context) {
+        if (this.preEvaluated) {
+            return this;
+        }
+        // Mixins should NOT pre-evaluate their rules during initial registration.
+        // Rules inside mixins should only be pre-evaluated when the mixin is called.
+        // So we only handle the name (if interpolated) and mark as preEvaluated,
+        // but do NOT call super.preEval() which would pre-evaluate children.
+        let node = this.maybeClone(context);
+        node.preEvaluated = true;
+        node.sourceNode ??= this;
+        let { name, rules } = node.value;
+        if (context.leakyRules) {
+            rules.options.rulesVisibility.Mixin = 'public';
+            // Keep Less mixin-definition vars as fallback by default. Call-time scope
+            // controls for params/local vars are handled in mixin evaluation paths.
+            rules.options.rulesVisibility.VarDeclaration = 'optional';
+        }
+        else {
+            rules.options.rulesVisibility.Mixin = 'private';
+            rules.options.rulesVisibility.VarDeclaration = 'private';
+        }
+        if (name && name instanceof Interpolated) {
+            const maybeKey = name.eval(context);
+            if (isThenable(maybeKey)) {
+                return maybeKey.then((key) => {
+                    node.value.name = key;
+                    return node;
+                });
+            }
+            node.value.name = maybeKey;
+        }
+        return node;
+    }
+    /** Since this is a mixin definition, it's not evaluated until it's called. */
+    evalNode() {
+        return this;
+    }
+}
+export const mixin = defineType(Mixin, 'Mixin');
+//# sourceMappingURL=mixin.js.map

package/lib/tree/mixin.js.map

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

package/lib/tree/negative.d.ts

@@ -0,0 +1,17 @@
+import { Node } from './node.js';
+import type { Context } from '../context.js';
+import { type MaybePromise } from '@jesscss/awaitable-pipe';
+/**
+ * The negative sign before a node
+ */
+export interface Negative extends Node<Node> {
+    eval(context: Context): MaybePromise<Node>;
+}
+export declare class Negative extends Node<Node> {
+    type: "Negative";
+    shortType: "negative";
+    constructor(value: Node, options?: any, location?: any, treeContext?: any);
+    evalNode(context: Context): MaybePromise<Node>;
+}
+export declare const negative: (value?: Node<unknown, import("./node-base.js").NodeOptions> | undefined, options?: any, location?: any) => Negative;
+//# sourceMappingURL=negative.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"negative.d.ts","sourceRoot":"","sources":["../../src/tree/negative.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAuC,MAAM,WAAW,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,yBAAyB,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,QAAS,SAAQ,IAAI,CAAC,IAAI,CAAC;IAC1C,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED,qBAAa,QAAS,SAAQ,IAAI,CAAC,IAAI,CAAC;IACtC,IAAI,EAAG,UAAU,CAAU;IAC3B,SAAS,EAAG,UAAU,CAAU;gBAEpB,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,GAAG;IAMhE,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC;CAWxD;AAED,eAAO,MAAM,QAAQ,sHAAmC,CAAC"}

package/lib/tree/negative.js

@@ -0,0 +1,22 @@
+import { Node, defineType, F_VISIBLE, F_NON_STATIC } from './node.js';
+import { Dimension } from './dimension.js';
+import { pipe, tryStep } from '@jesscss/awaitable-pipe';
+export class Negative extends Node {
+    type = 'Negative';
+    shortType = 'negative';
+    constructor(value, options, location, treeContext) {
+        super(value, options, location, treeContext);
+        // Negative operations are always non-static, but can inherit may_async from children
+        this.addFlags(F_VISIBLE, F_NON_STATIC);
+    }
+    evalNode(context) {
+        return pipe(() => this.value.eval(context), tryStep((value) => {
+            if (!value.operate) {
+                throw new TypeError(`Cannot operate on ${value.type}`);
+            }
+            return value.operate(new Dimension({ number: -1 }), '*', context);
+        }, { rethrow: true }));
+    }
+}
+export const negative = defineType(Negative, 'Negative');
+//# sourceMappingURL=negative.js.map

package/lib/tree/negative.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"negative.js","sourceRoot":"","sources":["../../src/tree/negative.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEtE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAqB,IAAI,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAS3E,MAAM,OAAO,QAAS,SAAQ,IAAU;IACtC,IAAI,GAAG,UAAmB,CAAC;IAC3B,SAAS,GAAG,UAAmB,CAAC;IAEhC,YAAY,KAAW,EAAE,OAAa,EAAE,QAAc,EAAE,WAAiB;QACvE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC7C,qFAAqF;QACrF,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACzC,CAAC;IAEQ,QAAQ,CAAC,OAAgB;QAChC,OAAO,IAAI,CACT,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAC9B,OAAO,CAAC,CAAC,KAAW,EAAE,EAAE;YACtB,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM,IAAI,SAAS,CAAC,qBAAqB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACpE,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CACtB,CAAC;IACJ,CAAC;CACF;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC"}

package/lib/tree/nil.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Import from node-base to avoid circular dependency.
+ * The patching of Node.prototype.nil happens in node.ts
+ */
+import { Node, type LocationInfo, type NodeOptions } from './node-base.js';
+import type { Context, TreeContext } from '../context.js';
+export interface Nil extends Node<''> {
+    valueOf(): '';
+    eval(context: Context): Nil;
+}
+/**
+ * A Node type that outputs nothing.
+ *
+ * We need this for things like rulesets,
+ * which need dynamically-linked nodes
+ *
+ * This is also the default value for declarations like:
+ * `$var:;`
+ */
+export declare class Nil extends Node<''> {
+    type: string;
+    shortType: string;
+    allowRoot: boolean;
+    allowRuleRoot: boolean;
+    state: number;
+    constructor(value?: any, options?: NodeOptions, location?: LocationInfo, treeContext?: TreeContext);
+    toTrimmedString(): string;
+    toString(): string;
+}
+export declare const nil: (value?: any, options?: NodeOptions | undefined, location?: LocationInfo | undefined) => Nil;
+//# sourceMappingURL=nil.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nil.d.ts","sourceRoot":"","sources":["../../src/tree/nil.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,IAAI,EAGJ,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE1D,MAAM,WAAW,GAAI,SAAQ,IAAI,CAAC,EAAE,CAAC;IACnC,OAAO,IAAI,EAAE,CAAC;IACd,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,GAAG,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,qBAAa,GAAI,SAAQ,IAAI,CAAC,EAAE,CAAC;IAC/B,IAAI,SAAS;IACb,SAAS,SAAS;IACT,SAAS,UAAQ;IACjB,aAAa,UAAQ;IACrB,KAAK,SAAU;gBAGtB,KAAK,CAAC,EAAE,GAAG,EACX,OAAO,CAAC,EAAE,WAAW,EACrB,QAAQ,CAAC,EAAE,YAAY,EACvB,WAAW,CAAC,EAAE,WAAW;IAQlB,eAAe;IAIf,QAAQ;CAGlB;AAED,eAAO,MAAM,GAAG,8FAAyB,CAAC"}

package/lib/tree/nil.js

@@ -0,0 +1,36 @@
+/**
+ * Import from node-base to avoid circular dependency.
+ * The patching of Node.prototype.nil happens in node.ts
+ */
+import { Node, F_VISIBLE, defineType } from './node-base.js';
+/**
+ * A Node type that outputs nothing.
+ *
+ * We need this for things like rulesets,
+ * which need dynamically-linked nodes
+ *
+ * This is also the default value for declarations like:
+ * `$var:;`
+ */
+export class Nil extends Node {
+    type = 'Nil';
+    shortType = 'nil';
+    allowRoot = true;
+    allowRuleRoot = true;
+    state = 0b0000; // 0b0000 means no flags are set
+    constructor(value, options, location, treeContext) {
+        super('', options, location, treeContext);
+        // Nil nodes should not be visible (they serialize to empty strings)
+        this.removeFlag(F_VISIBLE);
+        // Nil nodes should never render, even if fullRender is set on prototype (e.g., in tests)
+        this.fullRender = false;
+    }
+    toTrimmedString() {
+        return '';
+    }
+    toString() {
+        return '';
+    }
+}
+export const nil = defineType(Nil, 'Nil');
+//# sourceMappingURL=nil.js.map

package/lib/tree/nil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nil.js","sourceRoot":"","sources":["../../src/tree/nil.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,IAAI,EACJ,SAAS,EACT,UAAU,EAGX,MAAM,gBAAgB,CAAC;AAQxB;;;;;;;;GAQG;AACH,MAAM,OAAO,GAAI,SAAQ,IAAQ;IAC/B,IAAI,GAAG,KAAK,CAAC;IACb,SAAS,GAAG,KAAK,CAAC;IACT,SAAS,GAAG,IAAI,CAAC;IACjB,aAAa,GAAG,IAAI,CAAC;IACrB,KAAK,GAAG,MAAM,CAAC,CAAC,gCAAgC;IAEzD,YACE,KAAW,EACX,OAAqB,EACrB,QAAuB,EACvB,WAAyB;QACzB,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC1C,oEAAoE;QACpE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC3B,yFAAyF;QACzF,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAEQ,eAAe;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAEQ,QAAQ;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC"}