@jesscss/core 2.0.0-alpha.1

package/lib/tree/range.d.ts

@@ -0,0 +1,33 @@
+import type { Context } from '../context.js';
+import { Node } from './node.js';
+import { type PrintOptions } from './util/print.js';
+export type RangeValue = {
+    start: Node;
+    end: Node;
+    step?: Node;
+};
+export type RangeOptions = {
+    /** If false, serialize as `1> to ...` */
+    includeStart?: boolean;
+    /** If false, serialize as `... to <3` */
+    includeEnd?: boolean;
+};
+/**
+ * A numeric-ish range expression intended for `$for` headers.
+ *
+ * Examples:
+ * - `1 to 3`         (inclusive start/end)
+ * - `1 to <3`        (exclusive end)
+ * - `1> to 3`        (exclusive start)
+ * - `1> to <10 step 2`
+ */
+export declare class Range extends Node<RangeValue, RangeOptions> {
+    type: "Range";
+    shortType: "range";
+    evalNode(_context: Context): Range;
+    toTrimmedString(options?: PrintOptions): string;
+}
+type RangeParams = ConstructorParameters<typeof Range>;
+export declare const range: (value: RangeParams[0], options?: RangeParams[1], location?: RangeParams[2], treeContext?: RangeParams[3]) => Range;
+export {};
+//# sourceMappingURL=range.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../src/tree/range.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAiC,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,KAAK,YAAY,EAAmB,MAAM,iBAAiB,CAAC;AAErE,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,IAAI,CAAC;IACZ,GAAG,EAAE,IAAI,CAAC;IACV,IAAI,CAAC,EAAE,IAAI,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,yCAAyC;IACzC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,yCAAyC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;;;;;;GAQG;AACH,qBAAa,KAAM,SAAQ,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC;IACvD,IAAI,EAAG,OAAO,CAAU;IACxB,SAAS,EAAG,OAAO,CAAU;IAEpB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,KAAK;IAKlC,eAAe,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM;CA4BzD;AAED,KAAK,WAAW,GAAG,qBAAqB,CAAC,OAAO,KAAK,CAAC,CAAC;AAEvD,eAAO,MAAM,KAAK,EAA0C,CAC1D,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EACrB,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EACxB,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EACzB,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,KACzB,KAAK,CAAC"}

package/lib/tree/range.js

@@ -0,0 +1,47 @@
+import { Node, defineType } from './node.js';
+import { getPrintOptions } from './util/print.js';
+/**
+ * A numeric-ish range expression intended for `$for` headers.
+ *
+ * Examples:
+ * - `1 to 3`         (inclusive start/end)
+ * - `1 to <3`        (exclusive end)
+ * - `1> to 3`        (exclusive start)
+ * - `1> to <10 step 2`
+ */
+export class Range extends Node {
+    type = 'Range';
+    shortType = 'range';
+    evalNode(_context) {
+        // Parsing-only for now; semantics can be implemented later.
+        return this;
+    }
+    toTrimmedString(options) {
+        options = getPrintOptions(options);
+        const w = options.writer;
+        const mark = w.mark();
+        const { start, end, step } = this.value;
+        const includeStart = this.options?.includeStart !== false;
+        const includeEnd = this.options?.includeEnd !== false;
+        const emitTrimmed = (n) => {
+            const s = w.capture(() => n.toString(options));
+            w.add(s.replace(/^[ \t\r\f]+|[ \t\r\f]+$/g, ''), n);
+        };
+        emitTrimmed(start);
+        if (!includeStart) {
+            w.add('>');
+        }
+        w.add(' to ');
+        if (!includeEnd) {
+            w.add('<');
+        }
+        emitTrimmed(end);
+        if (step) {
+            w.add(' step ');
+            emitTrimmed(step);
+        }
+        return w.getSince(mark);
+    }
+}
+export const range = defineType(Range, 'Range', 'range');
+//# sourceMappingURL=range.js.map

package/lib/tree/range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"range.js","sourceRoot":"","sources":["../../src/tree/range.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAqB,MAAM,WAAW,CAAC;AAChE,OAAO,EAAqB,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAerE;;;;;;;;GAQG;AACH,MAAM,OAAO,KAAM,SAAQ,IAA8B;IACvD,IAAI,GAAG,OAAgB,CAAC;IACxB,SAAS,GAAG,OAAgB,CAAC;IAEpB,QAAQ,CAAC,QAAiB;QACjC,4DAA4D;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IAEQ,eAAe,CAAC,OAAsB;QAC7C,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAO,CAAC;QAC1B,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACtB,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QACxC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,KAAK,KAAK,CAAC;QAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,KAAK,KAAK,CAAC;QAEtD,MAAM,WAAW,GAAG,CAAC,CAAO,EAAE,EAAE;YAC9B,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YAC/C,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACtD,CAAC,CAAC;QAEF,WAAW,CAAC,KAAK,CAAC,CAAC;QACnB,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACb,CAAC;QACD,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACb,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,CAAC;QACjB,IAAI,IAAI,EAAE,CAAC;YACT,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAChB,WAAW,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QACD,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF;AAID,MAAM,CAAC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAK7C,CAAC"}

package/lib/tree/reference.d.ts

@@ -0,0 +1,76 @@
+import { Node, type LocationInfo } from './node.js';
+import type { Context, TreeContext } from '../context.js';
+import { Any, type AnyRole } from './any.js';
+import { Selector } from './selector.js';
+import type { Call } from './call.js';
+import type { Quoted } from './quoted.js';
+import type { Num } from './number.js';
+import { type PrintOptions } from './util/print.js';
+import { type MaybePromise } from '@jesscss/awaitable-pipe';
+import type { Interpolated } from './interpolated.js';
+/**
+ * The type is determined by syntax
+ * and location.
+ *   e.g. in Jess
+ *    - `$foo` refers to a variable
+ *    - `$.foo` is a prop or var
+ *    - `$foo$(bar)` is a var var
+ *    - `$foo.bar` is a prop or var `bar` in `foo`
+ *    - in `$|.foo()`, `.foo` is a mixin
+ *    - in `$foo|.mixin()`, `.mixin` is a mixin in `$foo`
+ *    - Resolution:
+ *      - `$` searches scope,
+ *      - `$^` searches in declaration order
+ *   in Less
+ *   - `@foo` refers to a variable
+ *   - `$foo` refers to a property
+ *   - `.foo` or `#foo` refers to a mixin
+ */
+export type ReferenceValue = {
+    target?: Reference | Call | undefined;
+    key: string | string[] | Node | Any | number | Num | Quoted | Selector | Reference | Interpolated;
+};
+export type ReferenceOptions = {
+    /**
+     * What kind of lookup are we doing?
+     */
+    type?: 'index' | 'declaration' | 'variable' | 'property' | 'function' | 'mixin' | 'ruleset' | 'mixin-ruleset';
+    /**
+     * Resolution strategy:
+     * - 'scope': Search in scope (Less-style, default)
+     * - 'linear': Search linearly from definition position (Sass-style for regular code)
+     * - 'call-time': Search linearly from call site position (Sass-style for mixins/functions)
+     */
+    resolution?: 'scope' | 'linear' | 'call-time';
+    /**
+     * Optional references just resolve to the string
+     * representation if the fallback value is set to true.
+     *
+     * @note - Used by Less for function references
+     */
+    fallbackValue?: Node | true;
+    filter?: (node: Node) => boolean;
+    role?: AnyRole;
+};
+/**
+ * This is a variable or property reference,
+ * which can itself contain a reference (a variable variable).
+ */
+export declare class Reference extends Node<ReferenceValue, ReferenceOptions> {
+    type: string;
+    shortType: string;
+    constructor(value: ReferenceValue | string, options?: ReferenceOptions, location?: LocationInfo, treeContext?: TreeContext);
+    valueOf(): string;
+    /**
+     * @note - A reference doesn't render `$` (unless it has a target);
+     *         that's managed by the parent expression.
+     */
+    toTrimmedString(options?: PrintOptions): string;
+    /**
+     * We don't need to mark evaluated, because a reference
+     * should never resolve to itself
+     */
+    evalNode(context: Context): MaybePromise<Node>;
+}
+export declare const ref: (value?: string | ReferenceValue | undefined, options?: ReferenceOptions | undefined, location?: LocationInfo | undefined) => Reference;
+//# sourceMappingURL=reference.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../src/tree/reference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,IAAI,EAAwC,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACtG,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG1D,OAAO,EAAE,GAAG,EAAE,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,KAAK,YAAY,EAAmB,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAc,KAAK,YAAY,EAAQ,MAAM,yBAAyB,CAAC;AAG9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC;IACtC,GAAG,EACD,MAAM,GACJ,MAAM,EAAE,GACR,IAAI,GACJ,GAAG,GACH,MAAM,GACN,GAAG,GACH,MAAM,GACN,QAAQ,GACR,SAAS,GACT,YAAY,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,aAAa,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,eAAe,CAAC;IAC9G;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC9C;;;;;OAKG;IACH,aAAa,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAcF;;;GAGG;AACH,qBAAa,SAAU,SAAQ,IAAI,CAAC,cAAc,EAAE,gBAAgB,CAAC;IACnE,IAAI,SAAe;IACnB,SAAS,SAAS;gBAEN,KAAK,EAAE,cAAc,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,WAAW;IASjH,OAAO;IAIhB;;;OAGG;IACM,eAAe,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM;IA2ExD;;;OAGG;IACM,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC;CAgaxD;AAED,eAAO,MAAM,GAAG,yIAA4C,CAAC"}