@jesscss/core 2.0.0-alpha.1

package/lib/tree/call.d.ts

@@ -0,0 +1,66 @@
+import { Node } from './node.js';
+import { type Context } from '../context.js';
+import { type PrintOptions } from './util/print.js';
+import { type Rules } from './rules.js';
+import { List } from './list.js';
+export type CallValue = {
+    /**
+     * Can be an identifier or something like a mixin or variable lookup
+     *   e.g. $|#mixin|.class() is -> [Call name: [Ref (#mixin.class)], args: []]
+     */
+    name: string | Node;
+    args?: List<Node>;
+    /**
+     * Optional content node, used for passing blocks to mixins/functions.
+     * This is how Jess represents "call with content block" forms like:
+     *   $ > foo(): @{ ... }
+     * or:
+     *   $ > foo(): @($x) { ... }
+     */
+    contentNode?: Node;
+};
+export type CallOptions = {
+    /**
+     * Legacy Less feature -- if a ruleset is returned,
+     * all the properties can be marked as important.
+     */
+    markImportant?: boolean;
+    silentFail?: boolean;
+    /** Parser-provided hint for modern color-call syntax (space/slash form). */
+    modernSyntax?: boolean;
+};
+/**
+ * This is an exported type that allows extra properties
+ * and specifies the shape of `this` for a function call.
+ */
+export type ExtendedFn<T extends any[] = any[], R = any> = ((this: Context, ...args: T) => R) & {
+    /**
+     * Allow for optional calling, which means an optional
+     * reference to a function will output a stringified
+     * function representation if there's an evaluation error.
+     *
+     * This is done for Less, which sets this for functions
+     * that have a CSS equivalent.
+     */
+    allowOptional?: boolean;
+    evalArgs?: boolean;
+};
+/**
+ * @note In Less, the ref for something like `rgb`
+ * is not a string, but is an (optional) variable reference.
+ */
+export declare class Call extends Node<CallValue, CallOptions> {
+    type: "Call";
+    shortType: "call";
+    _requiredSemi: boolean;
+    constructor(value: CallValue, options?: CallOptions, location?: any, treeContext?: any);
+    toTrimmedString(options?: PrintOptions): string;
+    /** Recursively makes declarations important */
+    makeImportant(rules: Rules): Rules;
+    /** Come back and redo -- too hard to reason about as a MaybePromise */
+    evalNode(context: Context): Promise<Node>;
+}
+type Params = ConstructorParameters<typeof Call>;
+export declare const call: (value: Params[0], options?: Params[1], location?: Params[2], treeContext?: Params[3]) => Call;
+export {};
+//# sourceMappingURL=call.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"call.d.ts","sourceRoot":"","sources":["../../src/tree/call.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAoD,MAAM,WAAW,CAAC;AACnF,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,OAAO,EAAE,KAAK,YAAY,EAAmB,MAAM,iBAAiB,CAAC;AAGrE,OAAO,EAA0C,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAGhF,OAAO,EAAE,IAAI,EAAQ,MAAM,WAAW,CAAC;AAYvC,MAAM,MAAM,SAAS,GAAG;IACtB;;;OAGG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAClB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG;IAC9F;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,qBAAa,IAAK,SAAQ,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC;IACpD,IAAI,EAAG,MAAM,CAAU;IACvB,SAAS,EAAG,MAAM,CAAU;IACnB,aAAa,UAAQ;gBAElB,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,GAAG;IAM7E,eAAe,CAAC,OAAO,CAAC,EAAE,YAAY;IAwC/C,+CAA+C;IAC/C,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK;IAgBlC,uEAAuE;IACxD,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAmNzD;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/call.js

@@ -0,0 +1,306 @@
+import { Node, defineType, F_VISIBLE, F_NON_STATIC, F_MAY_ASYNC } from './node.js';
+import { isNode } from './util/is-node.js';
+import { cast } from './util/cast.js';
+import { callWithContext } from '../define-function.js';
+import { getPrintOptions } from './util/print.js';
+import { Paren } from './paren.js';
+import { isThenable } from '@jesscss/awaitable-pipe';
+import { getFunctionFromMixins } from './rules.js';
+import { Any } from './any.js';
+import { freezeChildren } from './util/cloning.js';
+import { list } from './list.js';
+let rulesCtorPromise;
+// Lazy getter for Rules to break circular dependency:
+// rules.ts → cast.ts → color.ts → call.ts → rules.ts
+async function getRules() {
+    if (!rulesCtorPromise) {
+        rulesCtorPromise = import('./rules.js').then(({ Rules }) => Rules);
+    }
+    return rulesCtorPromise;
+}
+/**
+ * @note In Less, the ref for something like `rgb`
+ * is not a string, but is an (optional) variable reference.
+ */
+export class Call extends Node {
+    type = 'Call';
+    shortType = 'call';
+    _requiredSemi = true;
+    constructor(value, options, location, treeContext) {
+        super(value, options, location, treeContext);
+        // Function calls are always non-static and may be async
+        this.addFlags(F_VISIBLE, F_NON_STATIC, F_MAY_ASYNC);
+    }
+    toTrimmedString(options) {
+        const { silentFail } = this.options;
+        options = getPrintOptions(options);
+        const w = options.writer;
+        const mark = w.mark();
+        const { name, contentNode } = this.value;
+        const args = this.value.args;
+        if (typeof name === 'string') {
+            w.add(name, this);
+        }
+        else {
+            name.toString(options);
+        }
+        if (silentFail) {
+            w.add('?');
+        }
+        w.add('(');
+        if (args) {
+            const normalizedArgs = args.value.filter(Boolean);
+            const last = normalizedArgs.length - 1;
+            for (let i = 0; i <= last; i++) {
+                const arg = normalizedArgs[i];
+                const argOut = w.capture(() => arg.toString(options));
+                // Normalize boundary whitespace so calls serialize with stable comma spacing.
+                w.add(argOut.replace(/^[ \t\r\f]+|[ \t\r\f]+$/g, ''), arg);
+                if (i < last) {
+                    w.add(', ');
+                }
+            }
+        }
+        w.add(')');
+        if (this.options?.markImportant) {
+            w.add(' !important');
+        }
+        if (contentNode) {
+            w.add(': ');
+            contentNode.toString(options);
+        }
+        return w.getSince(mark);
+    }
+    /** Recursively makes declarations important */
+    makeImportant(rules) {
+        let important = Any.create('!important', { role: 'flag' });
+        for (const rule of rules.value) {
+            if (isNode(rule, 'Declaration')) {
+                rule.value.important = important;
+            }
+            else if (isNode(rule, 'Rules')) {
+                this.makeImportant(rule);
+            }
+            else if (isNode(rule, ['AtRule', 'Ruleset'])) {
+                if (rule.value.rules) {
+                    this.makeImportant(rule.value.rules);
+                }
+            }
+        }
+        return rules;
+    }
+    /** Come back and redo -- too hard to reason about as a MaybePromise */
+    async evalNode(context) {
+        let { name } = this.value;
+        let args = this.value.args;
+        let { markImportant } = this.options;
+        const adoptCallWhitespace = (node) => {
+            node.pre = this.pre;
+            node.post = this.post;
+            node.sourceParent = this;
+            return node;
+        };
+        const evalArgNodes = async (nodes) => {
+            if (!nodes) {
+                return undefined;
+            }
+            const out = [];
+            for (const node of nodes.value) {
+                out.push(await node.eval(context));
+            }
+            return list(out, nodes.options);
+        };
+        context.callStack.push(this);
+        context.parenFrames.push(false);
+        let n = typeof name === 'string' ? name : await name.eval(context);
+        // Resolve mixin reference only at call time (same as variable refs: evaluate when used, not when stored).
+        if (isNode(n, 'Reference') && n.options?.type === 'mixin-ruleset') {
+            n = await n.eval(context);
+        }
+        // Note: Stylesheet-defined functions should be represented as a Reference(type='function')
+        // by parsers that support them. We intentionally avoid implicit string→function lookup here
+        // to prevent surprising behavior for plain CSS function-like calls.
+        // If the evaluated name is a Call node, execute it directly
+        // This handles cases like @alias: .something(foo); @alias();
+        if (isNode(n, 'Call')) {
+            // Execute the inner Call node (it will handle its own callStack push/pop)
+            const result = await n.eval(context);
+            // Apply markImportant if needed
+            if (markImportant && isNode(result, 'Rules')) {
+                this.makeImportant(result);
+            }
+            // Always pop the outer call's stack entries
+            context.callStack.pop();
+            context.parenFrames.pop();
+            return result;
+        }
+        else if (isNode(n, 'Mixin') || isNode(n, 'Ruleset') || Array.isArray(n)) {
+            n = cast(getFunctionFromMixins(n));
+        }
+        else if (isNode(n, 'Func')) {
+            // Execute stylesheet-defined functions via their evalCall behavior.
+            const argNodes = await evalArgNodes(args) ?? list([]);
+            const result = await n.evalCall(context, argNodes);
+            context.callStack.pop();
+            context.parenFrames.pop();
+            return result;
+        }
+        else if (isNode(n, 'Collection')) {
+            // If the evaluated name is Rules or Collection (detached rulesets),
+            // return those rules directly, but only if args are empty
+            // If args are provided, throw an error - you can't call Rules/Collection with arguments
+            if (args && args.value.length > 0) {
+                context.callStack.pop();
+                context.parenFrames.pop();
+                throw new ReferenceError(`Cannot call ${n.type} with arguments`);
+            }
+            const Rules = await getRules();
+            let rules = Rules.create(n.value, n.options);
+            // Inherit from Collection (n) to preserve definition-scope parent chain
+            // This ensures variables like @a resolve from where the detached ruleset was defined
+            // Also copies sourceParent from the Collection (which was set by Reference when it resolved)
+            rules.inherit(n);
+            // Keep definition-site `parent` for primary lookup, but anchor `sourceParent`
+            // to this call so leaky fallback can resolve call-site variables (e.g. @d).
+            rules.sourceParent = this;
+            rules = await rules.eval(context);
+            context.callStack.pop();
+            context.parenFrames.pop();
+            // Apply markImportant if needed
+            if (markImportant) {
+                this.makeImportant(n);
+            }
+            return rules;
+        }
+        let fn = isNode(n, 'JsFunction') ? n.value : n;
+        if (typeof fn === 'function') {
+            const originalCaller = context.caller;
+            context.caller = this;
+            let didPopCallStack = false;
+            try {
+                /** Freeze args */
+                if (args) {
+                    const copiedArgs = args.copy(true, freezeChildren);
+                    for (const copied of copiedArgs.value) {
+                        // Anchor copied references to this Call so nested property refs
+                        // (e.g. $list-1) can walk back to call-site Rules.
+                        // Also anchor copied Mixin callback args to call-site source scope
+                        // so callback bodies can resolve surrounding variables.
+                        if (isNode(copied, 'Reference') && copied.options?.type === 'property') {
+                            copied.sourceParent = this;
+                        }
+                        else if (isNode(copied, 'Mixin')) {
+                            copied.sourceParent = this;
+                        }
+                        copied.frozen = true;
+                    }
+                    args = copiedArgs;
+                }
+                const shouldPassListArgs = Boolean(fn?._internal || fn?.options?.params);
+                const result = await (args
+                    ? (shouldPassListArgs
+                        ? callWithContext(context, fn, args)
+                        : callWithContext(context, fn, ...args.value))
+                    : callWithContext(context, fn));
+                context.caller = originalCaller;
+                context.callStack.pop();
+                didPopCallStack = true;
+                if (isNode(result)) {
+                    let evald = result.eval(context);
+                    if (isThenable(evald)) {
+                        evald = await evald;
+                        if (markImportant && isNode(evald, 'Rules')) {
+                            this.makeImportant(evald);
+                        }
+                        return adoptCallWhitespace(evald);
+                    }
+                    if (markImportant && isNode(evald, 'Rules')) {
+                        this.makeImportant(evald);
+                    }
+                    return adoptCallWhitespace(evald);
+                }
+                let castResult = cast(result);
+                if (isNode(castResult, 'Rules') && castResult.value.length === 1) {
+                    return adoptCallWhitespace(castResult.value[0]);
+                }
+                return adoptCallWhitespace(castResult);
+            }
+            catch (e) {
+                const unitMode = context?.opts?.unitMode ?? 'loose';
+                const shouldRethrowForMode = unitMode === 'strict';
+                if (e instanceof ReferenceError && e.message.includes('No matching mixins')) {
+                    if (this.parent?.type === 'SelectorCapture') {
+                        return adoptCallWhitespace(new Any(String(n.valueOf()), { role: 'ident' }).inherit(this));
+                    }
+                    if (isNode(name, 'Reference')) {
+                        throw new ReferenceError(`No matching mixins found for '${name.value.key.valueOf()}'`);
+                    }
+                    throw e;
+                }
+                if (!this.options?.silentFail || shouldRethrowForMode) {
+                    throw e;
+                }
+                let newCall = this.clone().inherit(this);
+                /** Remove this flag for serialization */
+                newCall.options.silentFail = false;
+                newCall.value.name = isNode(name, 'Reference') && name.options.fallbackValue === true
+                    ? String(name.value.key)
+                    : String(n.valueOf());
+                newCall.value.args = await evalArgNodes(args);
+                newCall.value.args?.value.forEach((arg, argIndex) => {
+                    // Normalize fallback-call arg spacing to Less-style call serialization.
+                    arg.pre = argIndex === 0 ? 0 : 1;
+                    if (isNode(arg, 'Sequence')) {
+                        arg.value.forEach((child, childIndex) => {
+                            child.pre = childIndex === 0 ? 0 : 1;
+                        });
+                    }
+                    else if (isNode(arg, 'List')) {
+                        arg.value.forEach((child) => {
+                            if (isNode(child, 'Sequence')) {
+                                child.value.forEach((nested, nestedIndex) => {
+                                    nested.pre = nestedIndex === 0 ? 0 : 1;
+                                });
+                            }
+                        });
+                    }
+                });
+                return adoptCallWhitespace(newCall);
+            }
+            finally {
+                context.caller = originalCaller;
+                context.parenFrames.pop();
+                if (!didPopCallStack) {
+                    context.callStack.pop();
+                }
+            }
+        }
+        else {
+            if (n === 'calc') {
+                context.calcFrames++;
+            }
+            const evaluatedArgs = await evalArgNodes(args);
+            if (n === 'calc') {
+                context.calcFrames--;
+            }
+            context.parenFrames.pop();
+            context.callStack.pop();
+            const node = this.clone();
+            node.options.silentFail = false;
+            if (n === 'calc' && evaluatedArgs) {
+                if (isNode(evaluatedArgs.value[0], 'Dimension')) {
+                    return evaluatedArgs.value[0];
+                }
+                else if (context.calcFrames !== 0) {
+                    return new Paren(evaluatedArgs.value[0]);
+                }
+            }
+            node.value.name = n;
+            node.value.args = evaluatedArgs;
+            return adoptCallWhitespace(node);
+        }
+        ;
+    }
+}
+export const call = defineType(Call, 'Call');
+//# sourceMappingURL=call.js.map

package/lib/tree/call.js.map

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

package/lib/tree/collection.d.ts

@@ -0,0 +1,30 @@
+import type { MaybePromise } from 'awaitable-pipe/lib/utils';
+import { Rules } from './rules.js';
+import { type PrintOptions } from './util/print.js';
+import type { Context } from '../context.js';
+/**
+ * A collection is essentially like an anonymous mixin,
+ * except that properties are arbitrary, so its intended
+ * for map data.
+ *
+ * Even though it doesn't allow everything that a regular set
+ * of rules does, we extend Rules just to make evaluation easier.
+ *
+ * Can be used like Sass property nesting.
+ * @see https://sass-lang.com/documentation/style-rules/declarations/#nesting
+ */
+export declare class Collection extends Rules {
+    type: "Collection";
+    shortType: "coll";
+    toTrimmedString(options?: PrintOptions): string;
+    /**
+     * Collection rules aren't evaluated by default. They're evaluated
+     * at access time OR if assigned to a property.
+     */
+    evalNode(context: Context): MaybePromise<this>;
+    preEval(context: Context): this | Promise<this>;
+}
+type Params = ConstructorParameters<typeof Collection>;
+export declare const coll: (value: Params[0], options?: Params[1], location?: Params[2], treeContext?: Params[3]) => Collection;
+export {};
+//# sourceMappingURL=collection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../src/tree/collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,qBAAa,UAAW,SAAQ,KAAK;IAC1B,IAAI,EAAG,YAAY,CAAU;IAC7B,SAAS,EAAG,MAAM,CAAU;IAE5B,eAAe,CAAC,OAAO,CAAC,EAAE,YAAY;IAI/C;;;OAGG;IACM,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC;IAI9C,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAQzD;AAED,KAAK,MAAM,GAAG,qBAAqB,CAAC,OAAO,UAAU,CAAC,CAAC;AAEvD,eAAO,MAAM,IAAI,EAAmD,CAClE,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,UAAU,CAAC"}

package/lib/tree/collection.js

@@ -0,0 +1,37 @@
+import { defineType } from './node.js';
+import { Rules } from './rules.js';
+/**
+ * A collection is essentially like an anonymous mixin,
+ * except that properties are arbitrary, so its intended
+ * for map data.
+ *
+ * Even though it doesn't allow everything that a regular set
+ * of rules does, we extend Rules just to make evaluation easier.
+ *
+ * Can be used like Sass property nesting.
+ * @see https://sass-lang.com/documentation/style-rules/declarations/#nesting
+ */
+export class Collection extends Rules {
+    type = 'Collection';
+    shortType = 'coll';
+    toTrimmedString(options) {
+        return this.toBraced(options);
+    }
+    /**
+     * Collection rules aren't evaluated by default. They're evaluated
+     * at access time OR if assigned to a property.
+     */
+    evalNode(context) {
+        return this;
+    }
+    preEval(context) {
+        if (this.preEvaluated) {
+            return this;
+        }
+        const node = this.maybeClone(context);
+        node.preEvaluated = true;
+        return node;
+    }
+}
+export const coll = defineType(Collection, 'Collection', 'coll');
+//# sourceMappingURL=collection.js.map

package/lib/tree/collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.js","sourceRoot":"","sources":["../../src/tree/collection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAa,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAInC;;;;;;;;;;GAUG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,GAAG,YAAqB,CAAC;IAC7B,SAAS,GAAG,MAAe,CAAC;IAE5B,eAAe,CAAC,OAAsB;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED;;;OAGG;IACM,QAAQ,CAAC,OAAgB;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAEQ,OAAO,CAAC,OAAgB;QAC/B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAS,CAAC;QAC9C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAID,MAAM,CAAC,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU,EAAE,YAAY,EAAE,MAAM,CAKhD,CAAC"}

package/lib/tree/color.d.ts

@@ -0,0 +1,101 @@
+import { Node, type NodeOptions } from './node.js';
+import { type Operator } from './util/calculate.js';
+import { type Context } from '../context.js';
+import { type PrintOptions } from './util/print.js';
+type ColorValues = [number, number, number, number] | number[];
+type ChannelTuple = [number, string];
+type ChannelValue = number | ChannelTuple;
+type AlphaValue = number | ChannelTuple;
+type RGBChannels = [ChannelValue, ChannelValue, ChannelValue];
+type HSLChannels = [ChannelValue, ChannelValue, ChannelValue];
+export declare enum ColorFormat {
+    HEX = 0,
+    RGB = 1,
+    HSL = 2
+}
+export interface ColorData {
+    node?: string | Node;
+    /** Legacy field; format now lives on Color options. */
+    format?: ColorFormat;
+    rgb?: RGBChannels;
+    hsl?: HSLChannels;
+    alpha?: AlphaValue;
+}
+export interface ColorOptions extends NodeOptions {
+    format?: ColorFormat;
+    modernSyntax?: boolean;
+}
+export interface Color extends Node<ColorData, ColorOptions> {
+    eval(context: Context): Color;
+}
+/**
+ * Color's `value` will store RGB, HSL, and alpha separately to avoid unnecessary conversions.
+ * Conversion only happens when modifying colors or when explicitly requested.
+ */
+export declare class Color extends Node<ColorData, ColorOptions> {
+    type: "Color";
+    shortType: "color";
+    constructor(value: ColorData | string | ColorValues, options?: ConstructorParameters<typeof Node<ColorData, ColorOptions>>[1], location?: ConstructorParameters<typeof Node<ColorData, ColorOptions>>[2], context?: ConstructorParameters<typeof Node<ColorData, ColorOptions>>[3]);
+    private normalizeChannelValue;
+    private hueToDegrees;
+    private percentToUnit;
+    private rgbChannelToNumber;
+    private alphaToNumber;
+    private getSerializedAlphaText;
+    private getSerializedRgbText;
+    /**
+     * Get RGB values, converting from HSL if needed.
+     * Returns clamped values (0-255) for better developer experience.
+     * For internal calculations, use _rgb instead.
+     */
+    get rgb(): [number, number, number];
+    /**
+     * Internal getter for unclamped RGB values.
+     * Use this for calculations and conversions.
+     */
+    get _rgb(): [number, number, number];
+    set rgb(rgb: [number, number, number] | RGBChannels);
+    /**
+     * Get HSL values, converting from RGB if needed.
+     * Returns clamped values (hue: 0-360, saturation/lightness: 0-1) for better developer experience.
+     * For internal calculations, use _hsl instead.
+     */
+    get hsl(): [number, number, number];
+    /**
+     * Internal getter for unclamped HSL values.
+     * Use this for calculations and conversions.
+     */
+    get _hsl(): [number, number, number];
+    set hsl(hsl: [number, number, number] | HSLChannels);
+    /**
+     * Get alpha value.
+     * Returns clamped value (0-1) for better developer experience.
+     * For internal calculations, use _alpha instead.
+     */
+    get alpha(): number;
+    /**
+     * Internal getter for unclamped alpha value.
+     * Use this for calculations and conversions.
+     */
+    get _alpha(): number;
+    set alpha(alpha: AlphaValue);
+    /**
+     * Get RGBA values for backward compatibility.
+     * Returns clamped values for better developer experience.
+     */
+    get rgba(): ColorValues;
+    set rgba(rgba: ColorValues);
+    /**
+     * Get HSLA values for backward compatibility.
+     * Returns clamped values for better developer experience.
+     */
+    get hsla(): [number, number, number, number];
+    set hsla(hsla: [number, number, number, number]);
+    toHSL(): [number, number, number];
+    toHex(): string;
+    toTrimmedString(options?: PrintOptions): string;
+    operate(b: Node, op: Operator, context?: Context | undefined): Color;
+}
+export declare const color: (value?: string | ColorValues | ColorData | undefined, options?: ColorOptions | undefined, location?: import("./node-base.js").LocationInfo | undefined) => Color;
+export {};
+//# sourceMappingURL=color.d.ts.map

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

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