@jesscss/core 2.0.0-alpha.1

package/lib/tree/extend.js

@@ -0,0 +1,292 @@
+import { defineType, Node, F_VISIBLE, F_IMPLICIT_AMPERSAND } from './node.js';
+import { Ampersand } from './ampersand.js';
+import { Nil } from './nil.js';
+import { ComplexSelector } from './selector-complex.js';
+import { Combinator } from './combinator.js';
+import { PseudoSelector } from './selector-pseudo.js';
+import { getPrintOptions } from './util/print.js';
+import { isThenable } from '@jesscss/awaitable-pipe';
+import { isNode } from './util/is-node.js';
+export var ExtendFlag;
+(function (ExtendFlag) {
+    /** Sass and Jess default */
+    ExtendFlag[ExtendFlag["All"] = 0] = "All";
+    /** Less default - must not be a partial selector match */
+    ExtendFlag[ExtendFlag["Exact"] = 1] = "Exact";
+})(ExtendFlag || (ExtendFlag = {}));
+export class Extend extends Node {
+    type = 'Extend';
+    shortType = 'extend';
+    state = 0b0000;
+    valueOf() {
+        return `$extend ${this.value.target.valueOf()}`;
+    }
+    toTrimmedString(options) {
+        options = getPrintOptions(options);
+        const w = options.writer;
+        let { target, selector, flag, namespace } = this.value;
+        const mark = w.mark();
+        w.add('$extend');
+        if (selector) {
+            let out = w.capture(() => selector.toString(options)).trim();
+            w.add(' ');
+            w.add(out, selector);
+            w.add(' ->');
+        }
+        let out = w.capture(() => target.toString(options)).trim();
+        w.add(' ');
+        if (namespace) {
+            w.add(`${namespace}|`);
+        }
+        w.add(out, target);
+        if (flag === ExtendFlag.Exact) {
+            w.add(' !exact');
+        }
+        w.add(';');
+        return w.getSince(mark);
+    }
+    // Don't preEval Extend - let it be evaluated in evalNode when the ruleset is in the frame
+    // This ensures the ampersand resolves to the correct ruleset selector, not the parent frame
+    evalNode(context) {
+        let { selector, target, flag } = this.value;
+        const currentFrame = context.rulesetFrames.at(-1);
+        // If selector is undefined, convert it to ampersand so it resolves to the ruleset's selector
+        // If selector is already set to a non-ampersand (e.g., from a bubbled extend), keep it as-is
+        // The parser sets the selector correctly when bubbling extends, so we should preserve it
+        if (!selector) {
+            // Set selector to ampersand - it will resolve to the current ruleset's selector when evaluated
+            // This matches the conceptual model: .c:extend(.ext all) is like { &:extend(.ext all); } inside .c
+            // The frame selector should already be :is(.a, .b) .c (the evaluated selector from preEval)
+            selector = Ampersand.create(undefined);
+            // Make the ampersand visible so it's included in the selector when evaluated
+            // This ensures the parent selector is properly included in the extend selector
+            selector.addFlag(F_VISIBLE);
+        }
+        // If selector is already set (e.g., .ext7 from a bubbled extend), use it directly
+        // Don't convert non-ampersand selectors to ampersand - they should be used as-is
+        // Get current extend root from registry stack
+        const extendRoot = context.extendRoots.getCurrentExtendRoot();
+        if (!extendRoot) {
+            /** Throw error? */
+            return new Nil();
+        }
+        const maybeSel = selector.eval(context);
+        if (isThenable(maybeSel)) {
+            return maybeSel.then((sel) => {
+                if (sel instanceof Nil) {
+                    return new Nil();
+                }
+                // Resolve ampersand to its current parent selector if needed (live resolution for extend)
+                let resolvedSel = sel;
+                if (isNode(sel, 'Ampersand')) {
+                    const ampResolved = sel.getResolvedSelector();
+                    if (ampResolved && !(ampResolved instanceof Nil)) {
+                        resolvedSel = ampResolved;
+                    }
+                }
+                // Prefer the current ruleset's full selector (includes implicit &) so extend merges the full
+                // selector (e.g. .issue-2586-somepage .content not just .content).
+                if (currentFrame && isNode(currentFrame, 'Ruleset')) {
+                    const rs = currentFrame;
+                    const fullSel = rs.value?.selector;
+                    let usedParentListComposition = false;
+                    if (!this.value.selector) {
+                        const ownSel = rs.options?.ownSelector;
+                        const parentFrame = context.rulesetFrames.at(-2);
+                        const parentSel = (parentFrame && isNode(parentFrame, 'Ruleset')
+                            ? parentFrame.value?.selector
+                            : undefined);
+                        if (ownSel
+                            && parentSel
+                            && !(parentSel instanceof Nil)
+                            && isNode(parentSel, 'SelectorList')) {
+                            const parentIs = PseudoSelector.create({
+                                name: ':is',
+                                arg: parentSel.copy(true)
+                            });
+                            parentIs.generated = true;
+                            resolvedSel = ComplexSelector.create([
+                                parentIs,
+                                Combinator.create(' '),
+                                ownSel.copy(true)
+                            ]);
+                            usedParentListComposition = true;
+                        }
+                    }
+                    if (!this.value.selector && !usedParentListComposition) {
+                        if (fullSel && !(fullSel instanceof Nil)) {
+                            resolvedSel = fullSel;
+                        }
+                        else {
+                            // Extend ran during selector eval (e.g. .content:extend(...)); current frame is the parent.
+                            // Build full selector as parent + ' ' + resolvedSel (e.g. .issue-2586-somepage .content).
+                            if (isNode(currentFrame, 'Ruleset')) {
+                                const parentSel = currentFrame.value?.selector;
+                                if (parentSel && !(parentSel instanceof Nil) && resolvedSel.valueOf() !== parentSel.valueOf()) {
+                                    resolvedSel = ComplexSelector.create([
+                                        parentSel.copy(true),
+                                        Combinator.create(' '),
+                                        resolvedSel.copy(true)
+                                    ]);
+                                }
+                            }
+                        }
+                    }
+                }
+                const beforeMaterialize = resolvedSel.valueOf();
+                resolvedSel = materializeImplicitAmpersands(resolvedSel, flag !== ExtendFlag.All);
+                const rs = currentFrame;
+                const docOrder = getDocumentOrderForExtend(rs, context);
+                const extendRootOptions = extendRoot.options;
+                // Extends declared while traversing a reference branch are tagged so the
+                // extend resolver can keep them non-side-effecting outside that branch.
+                const fromReferenceScope = (context.inReferenceImportScope
+                    || extendRootOptions.referenceMode === true);
+                context.extends.push([target, resolvedSel, flag === ExtendFlag.All, extendRoot, this, docOrder, fromReferenceScope]);
+                return new Nil();
+            });
+        }
+        const sel = maybeSel;
+        if (sel instanceof Nil) {
+            return new Nil();
+        }
+        // Resolve ampersand to its current parent selector if needed (live resolution for extend)
+        let resolvedSel = sel;
+        if (isNode(sel, 'Ampersand')) {
+            const ampResolved = sel.getResolvedSelector();
+            if (ampResolved && !(ampResolved instanceof Nil)) {
+                resolvedSel = ampResolved;
+            }
+        }
+        // Prefer the current ruleset's full selector (includes implicit &) so extend merges the full
+        // selector (e.g. .issue-2586-somepage .content not just .content).
+        if (currentFrame && isNode(currentFrame, 'Ruleset')) {
+            const rs = currentFrame;
+            const fullSel = rs.value?.selector;
+            let usedParentListComposition = false;
+            if (!this.value.selector) {
+                const ownSel = rs.options?.ownSelector;
+                const parentFrame = context.rulesetFrames.at(-2);
+                const parentSel = (parentFrame && isNode(parentFrame, 'Ruleset')
+                    ? parentFrame.value?.selector
+                    : undefined);
+                if (ownSel
+                    && parentSel
+                    && !(parentSel instanceof Nil)
+                    && isNode(parentSel, 'SelectorList')) {
+                    const parentIs = PseudoSelector.create({
+                        name: ':is',
+                        arg: parentSel.copy(true)
+                    });
+                    parentIs.generated = true;
+                    resolvedSel = ComplexSelector.create([
+                        parentIs,
+                        Combinator.create(' '),
+                        ownSel.copy(true)
+                    ]);
+                    usedParentListComposition = true;
+                }
+            }
+            if (!this.value.selector && !usedParentListComposition) {
+                if (fullSel && !(fullSel instanceof Nil)) {
+                    resolvedSel = fullSel;
+                }
+                else {
+                    // Extend ran during selector eval (e.g. .content:extend(...)); current frame is the parent.
+                    // Build full selector as parent + ' ' + resolvedSel (e.g. .issue-2586-somepage .content).
+                    if (isNode(currentFrame, 'Ruleset')) {
+                        const parentSel = currentFrame.value?.selector;
+                        if (parentSel && !(parentSel instanceof Nil) && resolvedSel.valueOf() !== parentSel.valueOf()) {
+                            resolvedSel = ComplexSelector.create([
+                                parentSel.copy(true),
+                                Combinator.create(' '),
+                                resolvedSel.copy(true)
+                            ]);
+                        }
+                    }
+                }
+            }
+        }
+        const beforeMaterialize = resolvedSel.valueOf();
+        resolvedSel = materializeImplicitAmpersands(resolvedSel, flag !== ExtendFlag.All);
+        const rs = currentFrame && isNode(currentFrame, 'Ruleset') ? currentFrame : undefined;
+        const docOrder = getDocumentOrderForExtend(rs, context);
+        const extendRootOptions = extendRoot.options;
+        // Same reference-scope tagging for sync path.
+        const fromReferenceScope = (context.inReferenceImportScope
+            || extendRootOptions.referenceMode === true);
+        context.extends.push([target, resolvedSel, flag === ExtendFlag.All, extendRoot, this, docOrder, fromReferenceScope]);
+        return new Nil();
+    }
+}
+function materializeImplicitAmpersands(selector, includeNonListImplicit) {
+    const materialize = (node) => {
+        if (isNode(node, 'Ampersand')) {
+            const amp = node;
+            const n = amp;
+            if (n.hasFlag(F_IMPLICIT_AMPERSAND)) {
+                const resolved = amp.getResolvedSelector();
+                if (resolved
+                    && !(resolved instanceof Nil)
+                    && (includeNonListImplicit || isNode(resolved, 'SelectorList'))) {
+                    return materialize(resolved.copy(true));
+                }
+            }
+            return node.copy(true);
+        }
+        if (isNode(node, 'ComplexSelector')) {
+            const complex = node;
+            const parts = [];
+            for (const part of complex.value) {
+                if (isNode(part, 'Ampersand')) {
+                    const amp = part;
+                    const n = amp;
+                    if (n.hasFlag(F_IMPLICIT_AMPERSAND)) {
+                        const resolved = amp.getResolvedSelector();
+                        if (resolved
+                            && !(resolved instanceof Nil)
+                            && (includeNonListImplicit || isNode(resolved, 'SelectorList'))) {
+                            const repl = materialize(resolved.copy(true));
+                            if (isNode(repl, 'ComplexSelector')) {
+                                parts.push(...repl.value.map(x => x.copy(true)));
+                            }
+                            else {
+                                parts.push(repl);
+                            }
+                            continue;
+                        }
+                    }
+                }
+                const repl = materialize(part);
+                parts.push(repl);
+            }
+            return ComplexSelector.create(parts).inherit(node);
+        }
+        const value = node.value;
+        if (Array.isArray(value)) {
+            const cloned = node.copy(true);
+            cloned.value = value.map(item => materialize(item));
+            return cloned;
+        }
+        return node.copy(true);
+    };
+    return materialize(selector);
+}
+/** Document order for extend: prefer parse location startOffset (source order), else assigned map, else push order (length). */
+function getDocumentOrderForExtend(rs, context) {
+    if (!rs) {
+        return context.extends.length;
+    }
+    const loc = rs.location;
+    const fromLoc = Array.isArray(loc) && loc.length >= 1 && typeof loc[0] === 'number' ? loc[0] : undefined;
+    if (fromLoc !== undefined) {
+        return fromLoc;
+    }
+    const fromMap = context.documentOrderByRuleset?.get(rs);
+    if (fromMap !== undefined) {
+        return fromMap;
+    }
+    return context.extends.length;
+}
+export const extend = defineType(Extend, 'Extend');
+//# sourceMappingURL=extend.js.map

package/lib/tree/extend.js.map

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

package/lib/tree/function.d.ts

@@ -0,0 +1,48 @@
+import { type Context } from '../context.js';
+import { Node, type LocationInfo, type TreeContext } from './node.js';
+import type { Any, AnyRole } from './any.js';
+import { Interpolated } from './interpolated.js';
+import { type List } from './list.js';
+import { type PrintOptions } from './util/print.js';
+/**
+ * Stylesheet-defined function with a return value.
+ * Called `Func` to avoid conflict with the built-in `Function` class.
+ *
+ * Parsed by Sass/Jess-like languages (e.g. SCSS `@function`).
+ *
+ * Evaluation model:
+ * - Evaluate the function body in an isolated scope (like mixins) with bound params.
+ * - Then look up a declaration by name (default: `return`) and return its value.
+ */
+export type FuncValue<Name extends AnyRole = 'name'> = {
+    name?: Any<Name> | Interpolated<Name>;
+    params?: List<Node>;
+    body: Node;
+};
+export type FuncOptions = {
+    /**
+     * Declaration name to look up after evaluating the body.
+     * Defaults to `'return'` (a `return: <expr>;` declaration).
+     */
+    returnName?: string;
+};
+export declare class Func extends Node<FuncValue, FuncOptions> {
+    type: "Func";
+    shortType: "fn";
+    constructor(value: FuncValue, options?: FuncOptions, location?: LocationInfo, treeContext?: TreeContext);
+    get nameKey(): string | undefined;
+    toTrimmedString(options?: PrintOptions): string;
+    /**
+     * Execute the function and return its looked-up value.
+     *
+     * We intentionally reuse the mixin-call machinery for argument binding & scoped evaluation
+     * to avoid duplicating complex param matching logic.
+     */
+    evalCall(context: Context, args?: List<Node>): Promise<Node>;
+}
+export declare const fn: (value: FuncValue | {
+    name?: string;
+    params?: List<Node>;
+    body: Node;
+}, options?: FuncOptions, location?: LocationInfo, treeContext?: TreeContext) => Func;
+//# sourceMappingURL=function.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"function.d.ts","sourceRoot":"","sources":["../../src/tree/function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAyB,IAAI,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7F,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,KAAK,IAAI,EAAQ,MAAM,WAAW,CAAC;AAK5C,OAAO,EAAE,KAAK,YAAY,EAAmB,MAAM,iBAAiB,CAAC;AAErE;;;;;;;;;GASG;AACH,MAAM,MAAM,SAAS,CAAC,IAAI,SAAS,OAAO,GAAG,MAAM,IAAI;IACrD,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,qBAAa,IAAK,SAAQ,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC;IACpD,IAAI,EAAG,MAAM,CAAU;IACvB,SAAS,EAAG,IAAI,CAAU;gBAEd,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,WAAW;IAMvG,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAMhC;IAEQ,eAAe,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM;IAsBxD;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE,IAAI,CAAC,IAAI,CAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAmC7E;AAED,eAAO,MAAM,EAAE,EAAqC,CAClD,KAAK,EAAE,SAAS,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,EACrE,OAAO,CAAC,EAAE,WAAW,EACrB,QAAQ,CAAC,EAAE,YAAY,EACvB,WAAW,CAAC,EAAE,WAAW,KACtB,IAAI,CAAC"}

package/lib/tree/function.js

@@ -0,0 +1,74 @@
+import { defineType, F_VISIBLE, Node } from './node.js';
+import { Rules } from './rules.js';
+import { list } from './list.js';
+import { Mixin } from './mixin.js';
+import { getFunctionFromMixins } from './rules.js';
+import { cast } from './util/cast.js';
+import { getPrintOptions } from './util/print.js';
+export class Func extends Node {
+    type = 'Func';
+    shortType = 'fn';
+    constructor(value, options, location, treeContext) {
+        super(value, options, location, treeContext);
+        // Like mixins/functions in source languages: not emitted directly.
+        this.removeFlag(F_VISIBLE);
+    }
+    get nameKey() {
+        const { name } = this.value;
+        if (!name) {
+            return undefined;
+        }
+        return String(name.valueOf());
+    }
+    toTrimmedString(options) {
+        options = getPrintOptions(options);
+        const w = options.writer;
+        const mark = w.mark();
+        const { name, params, body } = this.value;
+        w.add('$function', this);
+        w.add(' ');
+        w.add(name ? `${name}` : '@', this);
+        w.add('(');
+        if (params) {
+            params.toString(options);
+        }
+        w.add(') ');
+        // Body is always emitted as braced rules. If it's not a Rules node already, wrap it.
+        const bodyRules = body instanceof Rules ? body : Rules.create([body]);
+        bodyRules.toBraced(options);
+        return w.getSince(mark);
+    }
+    /**
+     * Execute the function and return its looked-up value.
+     *
+     * We intentionally reuse the mixin-call machinery for argument binding & scoped evaluation
+     * to avoid duplicating complex param matching logic.
+     */
+    async evalCall(context, args = list([])) {
+        const returnName = this.options?.returnName ?? 'return';
+        // Normalize body to a Rules node so it can be evaluated/scoped consistently.
+        const bodyNode = this.value.body;
+        const bodyRules = bodyNode instanceof Rules
+            ? bodyNode
+            : Rules.create([bodyNode]);
+        // Build a temporary anonymous mixin wrapper to observe the same param binding rules.
+        const mixinLike = new Mixin({ rules: bodyRules, params: this.value.params }, undefined, Array.isArray(this.location) && this.location.length === 6 ? this.location : undefined, this.treeContext);
+        // Ensure it participates in the same parent chain as this function definition.
+        if (this.parent) {
+            this.parent.adopt(mixinLike);
+        }
+        const fn = getFunctionFromMixins(mixinLike);
+        const evaluated = await fn.call(context, ...args.value.map(a => cast(a)));
+        if (!(evaluated instanceof Rules)) {
+            throw new Error(`Function ${this.nameKey ?? '<anonymous>'} must evaluate to rules`);
+        }
+        const decl = evaluated.find('declaration', returnName, 'Declaration', { searchParents: false });
+        if (!decl) {
+            throw new Error(`Function ${this.nameKey ?? '<anonymous>'} must return a value (missing "${returnName}: ...")`);
+        }
+        // Return the declaration's value (already in the correct scope).
+        return await decl.value.value.eval(context);
+    }
+}
+export const fn = defineType(Func, 'Func', 'fn');
+//# sourceMappingURL=function.js.map

package/lib/tree/function.js.map

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

package/lib/tree/import-js.d.ts

@@ -0,0 +1,35 @@
+import { Node } from './node.js';
+import { type Quoted } from './quoted.js';
+import { type PrintOptions } from './util/print.js';
+/**
+ * Imports of TS/JS ESM modules.
+ *
+ * `@-use 'foo.js' as foo;`
+ */
+type JsImportSpecifier = string | [string, string] | {
+    name: string;
+    alias?: string;
+};
+export type JsImportOptions = {
+    /** e.g. `@-use 'foo.js' as foo` sets namespace to `foo` */
+    namespace?: string;
+    /**
+     * - In array,
+     *   - string is a plain import identifier
+     *   - [string, string] is { [identifier1] as [identifier2] }
+    */
+    imports?: string | JsImportSpecifier[];
+};
+export type JsImportValue = {
+    path: Quoted;
+    imports?: JsImportSpecifier[];
+};
+export declare class JsImport extends Node<JsImportValue, JsImportOptions> {
+    type: "JsImport";
+    shortType: "js";
+    constructor(value: JsImportValue, options?: JsImportOptions, location?: any, treeContext?: any);
+    toTrimmedString(options?: PrintOptions): string;
+}
+export declare const js: (value?: any, options?: any, location?: any) => never;
+export {};
+//# sourceMappingURL=import-js.d.ts.map

package/lib/tree/import-js.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-js.d.ts","sourceRoot":"","sources":["../../src/tree/import-js.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,IAAI,EAAc,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,KAAK,YAAY,EAAmB,MAAM,iBAAiB,CAAC;AAErE;;;;GAIG;AAEH,KAAK,iBAAiB,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtF,MAAM,MAAM,eAAe,GAAG;IAC5B,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;MAIE;IACF,OAAO,CAAC,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC/B,CAAC;AAEF,qBAAa,QAAS,SAAQ,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC;IAChE,IAAI,EAAG,UAAU,CAAU;IAC3B,SAAS,EAAG,IAAI,CAAU;gBAEd,KAAK,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,GAAG;IAMrF,eAAe,CAAC,OAAO,CAAC,EAAE,YAAY;CAiChD;AAED,eAAO,MAAM,EAAE,uDAAwD,CAAC"}

package/lib/tree/import-js.js

@@ -0,0 +1,45 @@
+import { F_MAY_ASYNC, F_NON_STATIC, Node, defineType } from './node.js';
+import { getPrintOptions } from './util/print.js';
+export class JsImport extends Node {
+    type = 'JsImport';
+    shortType = 'js';
+    constructor(value, options, location, treeContext) {
+        super(value, options, location, treeContext);
+        // JS imports are always non-static and may be async
+        this.addFlags(F_MAY_ASYNC, F_NON_STATIC);
+    }
+    toTrimmedString(options) {
+        options = getPrintOptions(options);
+        const w = options.writer;
+        const mark = w.mark();
+        const { path } = this.value;
+        const { namespace } = this.options;
+        const imports = this.value.imports ?? (Array.isArray(this.options.imports) ? this.options.imports : undefined);
+        w.add('@-use ');
+        path.toString(options);
+        let explicitNamespace = namespace;
+        if (!explicitNamespace && imports?.length) {
+            const nsSpec = imports.find((specifier) => {
+                if (typeof specifier === 'string') {
+                    return false;
+                }
+                if (Array.isArray(specifier)) {
+                    return specifier[0] === '*';
+                }
+                return specifier.name === '*';
+            });
+            if (nsSpec) {
+                explicitNamespace = Array.isArray(nsSpec)
+                    ? nsSpec[1]
+                    : (typeof nsSpec === 'string' ? undefined : nsSpec.alias);
+            }
+        }
+        if (explicitNamespace) {
+            w.add(` as ${explicitNamespace}`);
+        }
+        w.add(';');
+        return w.getSince(mark);
+    }
+}
+export const js = defineType(JsImport, 'JsImport', 'js');
+//# sourceMappingURL=import-js.js.map

package/lib/tree/import-js.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-js.js","sourceRoot":"","sources":["../../src/tree/import-js.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAExE,OAAO,EAAqB,eAAe,EAAE,MAAM,iBAAiB,CAAC;AA0BrE,MAAM,OAAO,QAAS,SAAQ,IAAoC;IAChE,IAAI,GAAG,UAAmB,CAAC;IAC3B,SAAS,GAAG,IAAa,CAAC;IAE1B,YAAY,KAAoB,EAAE,OAAyB,EAAE,QAAc,EAAE,WAAiB;QAC5F,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC7C,oDAAoD;QACpD,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAC3C,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,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAC5B,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAE/G,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAChB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,iBAAiB,GAAG,SAAS,CAAC;QAClC,IAAI,CAAC,iBAAiB,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;gBACxC,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;oBAClC,OAAO,KAAK,CAAC;gBACf,CAAC;gBACD,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC7B,OAAO,SAAS,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;gBAC9B,CAAC;gBACD,OAAO,SAAS,CAAC,IAAI,KAAK,GAAG,CAAC;YAChC,CAAC,CAAC,CAAC;YACH,IAAI,MAAM,EAAE,CAAC;gBACX,iBAAiB,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;oBACvC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;oBACX,CAAC,CAAC,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QACD,IAAI,iBAAiB,EAAE,CAAC;YACtB,CAAC,CAAC,GAAG,CAAC,OAAO,iBAAiB,EAAE,CAAC,CAAC;QACpC,CAAC;QACD,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACX,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,EAAE,GAAG,UAAU,CAAgB,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC"}