@jesscss/core 2.0.0-alpha.5 → 2.0.0-alpha.6

package/src/tree/__tests__/basic-render.test.ts

@@ -0,0 +1,212 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { rules, ruleset, decl, sel, el, spaced, any, comment, coll, dimension } from '../index.js';
+import { Context } from '../../context.js';
+
+describe('Basic Ruleset Rendering', () => {
+  let context: Context;
+
+  beforeEach(() => {
+    context = new Context();
+  });
+
+  it('should render a basic ruleset correctly', async () => {
+    const node = rules([
+      ruleset({
+        selector: sel([el('.test')]) as any,
+        rules: rules([
+          decl({ name: 'color', value: spaced([el('red')]) })
+        ])
+      })
+    ]);
+
+    const evald = await node.eval(context);
+    const css = evald.render(context);
+
+    expect(css).toBeString(`
+      .test {
+        color: red;
+      }`
+    );
+  });
+
+  it('should render a basic ruleset without collapseNesting', async () => {
+    const node = rules([
+      ruleset({
+        selector: sel([el('.test')]) as any,
+        rules: rules([
+          decl({ name: 'color', value: spaced([el('red')]) })
+        ])
+      })
+    ]);
+
+    const evald = await node.eval(context);
+    const css = evald.toString({ collapseNesting: false });
+
+    expect(css).toBeString(`
+      .test {
+        color: red;
+      }`
+    );
+  });
+
+  it('should preserve comments attached to declaration names', async () => {
+    const property = any('color', { role: 'property' });
+    property.post = [comment('/* survive */'), ' ', comment('/* me too */')];
+
+    const node = rules([
+      ruleset({
+        selector: sel([el('.test')]) as any,
+        rules: rules([
+          decl({ name: property, value: spaced([el('red')]) })
+        ])
+      })
+    ]);
+
+    const evald = await node.eval(context);
+    const css = evald.render(context);
+
+    expect(css).toBeString(`
+      .test {
+        color/* survive */ /* me too */: red;
+      }`
+    );
+  });
+
+  it('should expand Collection-valued declarations into dashed properties', async () => {
+    const node = rules([
+      ruleset({
+        selector: sel([el('.test')]) as any,
+        rules: rules([
+          decl({
+            name: 'font',
+            value: coll([
+              decl({ name: 'size', value: dimension([1, 'rem']) }),
+              decl({ name: 'weight', value: any('bold') })
+            ])
+          })
+        ])
+      })
+    ]);
+
+    const evald = await node.eval(context);
+    const css = evald.render(context);
+
+    expect(css).toBeString(`
+      .test {
+        font-size: 1rem;
+        font-weight: bold;
+      }`
+    );
+  });
+
+  it('should keep the base shorthand and expand nested property declarations', async () => {
+    const node = rules([
+      ruleset({
+        selector: sel([el('.test')]) as any,
+        rules: rules([
+          decl({
+            name: 'margin',
+            value: spaced([
+              any('auto'),
+              coll([
+                decl({ name: 'left', value: dimension([1, 'px']) }),
+                decl({ name: 'right', value: dimension([2, 'px']) })
+              ])
+            ])
+          })
+        ])
+      })
+    ]);
+
+    const evald = await node.eval(context);
+    const css = evald.render(context);
+
+    expect(css).toBeString(`
+      .test {
+        margin: auto;
+        margin-left: 1px;
+        margin-right: 2px;
+      }`
+    );
+  });
+
+  it('should recursively expand deep nested property declarations', async () => {
+    const node = rules([
+      ruleset({
+        selector: sel([el('.test')]) as any,
+        rules: rules([
+          decl({
+            name: 'border',
+            value: coll([
+              decl({
+                name: 'color',
+                value: coll([
+                  decl({ name: 'base', value: any('red') }),
+                  decl({ name: 'hover', value: any('blue') })
+                ])
+              })
+            ])
+          })
+        ])
+      })
+    ]);
+
+    const evald = await node.eval(context);
+    const css = evald.render(context);
+
+    expect(css).toBeString(`
+      .test {
+        border-color-base: red;
+        border-color-hover: blue;
+      }`
+    );
+  });
+});
+
+describe('Basic Ruleset Rendering', () => {
+  let context: Context;
+
+  beforeEach(() => {
+    context = new Context();
+  });
+
+  it('should render a basic ruleset correctly', async () => {
+    const node = rules([
+      ruleset({
+        selector: sel([el('.test')]) as any,
+        rules: rules([
+          decl({ name: 'color', value: spaced([el('red')]) })
+        ])
+      })
+    ]);
+
+    const evald = await node.eval(context);
+    const css = evald.render(context);
+
+    expect(css).toBeString(`
+      .test {
+        color: red;
+      }`
+    );
+  });
+
+  it('should render a basic ruleset without collapseNesting', async () => {
+    const node = rules([
+      ruleset({
+        selector: sel([el('.test')]) as any,
+        rules: rules([
+          decl({ name: 'color', value: spaced([el('red')]) })
+        ])
+      })
+    ]);
+
+    const evald = await node.eval(context);
+    const css = evald.toString({ collapseNesting: false });
+
+    expect(css).toBeString(`
+      .test {
+        color: red;
+      }`
+    );
+  });
+});

package/src/tree/__tests__/block.test.ts

@@ -0,0 +1,40 @@
+import { describe, expect, it } from 'vitest';
+import { any, block, expr } from '../index.js';
+import { Context } from '../../context.js';
+import { addEdge, getEdge } from '../util/cursor.js';
+import type { RenderKey } from '../node.js';
+
+describe('Block', () => {
+  it('serializes children with the configured wrapper shape', () => {
+    const curly = block(any('red'));
+    const square = block(any('red'), { type: 'square' });
+
+    expect(curly.toTrimmedString()).toBe('{red}');
+    expect(square.toTrimmedString()).toBe('[red]');
+  });
+
+  it('evaluates its child while preserving the wrapper shape', async () => {
+    const ctx = new Context();
+    const node = block(expr(any('red')));
+
+    const evald = await node.eval(ctx);
+
+    expect(evald.toTrimmedString({ context: ctx })).toBe('{red}');
+  });
+
+  it('keeps the canonical child direct while render keys can select alternates', () => {
+    const canonical = any('red');
+    const alternate = any('blue');
+    const node = block(canonical);
+    const key = {} as RenderKey;
+    const cursor = { node, renderKey: key };
+
+    expect(node.value).toBe(canonical);
+    expect(getEdge(cursor, 'value')?.node).toBe(canonical);
+
+    addEdge(node, 'value', key, alternate);
+
+    expect(node.value).toBe(canonical);
+    expect(getEdge(cursor, 'value')?.node).toBe(alternate);
+  });
+});

package/src/tree/__tests__/call.test.ts

@@ -0,0 +1,346 @@
+import { Node, any, call, coll, decl, expr, fn, interpolated, jsfunc, list, num, ref, rules, seq, vardecl } from '../index.js';
+import { Context } from '../../context.js';
+import { defineFunction } from '../../define-function.js';
+
+let context: Context;
+describe('Call', () => {
+  beforeEach(() => {
+    context = new Context();
+  });
+
+  it('should serialize a CSS function', () => {
+    let rule = call({
+      name: 'rgb',
+      args: list([num(100), num(100), num(100)])
+    });
+    expect(`${rule}`).toBe('rgb(100, 100, 100)');
+  });
+
+  it('should serialize an optional function lookup', () => {
+    let rule = call({
+      name: ref('rgb', { fallbackValue: true }),
+      args: list([num(100), num(100), num(100)])
+    });
+    expect(`${rule}`).toBe('$rgb?(100, 100, 100)');
+  });
+
+  /** @todo */
+  it('should serialize a mixin call', () => {
+    let rule = call({
+      name: ref('my-mixin', { type: 'mixin' }),
+      args: list([num(100), num(100), num(100)])
+    });
+    expect(`${rule}`).toBe('|my-mixin(100, 100, 100)');
+  });
+
+  it('evaluates an interpolated CSS function name before serialization', async () => {
+    const node = call({
+      name: interpolated({
+        source: '%%',
+        replacements: [expr(any('blur'))]
+      }, { role: 'ident' }),
+      args: list([expr(any('4px'))])
+    });
+
+    const evald = await node.eval(context);
+
+    expect(evald.toTrimmedString({ context })).toBe('blur(4px)');
+  });
+
+  it('renders fallback-call args with normalized nested sequence spacing without mutating canonical args', async () => {
+    const second = num(2);
+    second.pre = 0;
+    const arg = seq([num(1), second]);
+    const failingFn = () => {
+      throw new Error('boom');
+    };
+    const node = call({
+      name: ref('fn', { type: 'variable', fallbackValue: true }),
+      args: list([arg])
+    }, { silentFail: true });
+    const root = rules([
+      vardecl({
+        name: any('fn'),
+        value: jsfunc({ name: 'fn', fn: failingFn })
+      }),
+      node
+    ]);
+
+    const evald = await root.eval(context);
+
+    expect(evald.toTrimmedString({ context })).toContain('fn(1 2)');
+    expect(second.pre).toBe(0);
+    expect(arg.toTrimmedString()).toBe('12');
+  });
+
+  it('renders fallback-call args from replaced source args without mutating the canonical source args', async () => {
+    const originalSecond = num(2);
+    originalSecond.pre = 0;
+    const originalArg = seq([num(1), originalSecond]);
+    const patchedSecond = num(4);
+    patchedSecond.pre = 0;
+    const patchedArg = seq([num(3), patchedSecond]);
+    const failingFn = () => {
+      throw new Error('boom');
+    };
+    const node = call({
+      name: ref('fn', { type: 'variable', fallbackValue: true }),
+      args: list([originalArg])
+    }, { silentFail: true });
+    const root = rules([
+      vardecl({
+        name: any('fn'),
+        value: jsfunc({ name: 'fn', fn: failingFn })
+      }),
+      node
+    ]);
+    const clonedRoot = root.clone(true);
+    const clonedNode = clonedRoot.at(1, context) as ReturnType<typeof call>;
+    const patchedArgs = list([patchedArg]);
+
+    clonedNode.adopt(patchedArgs, context);
+    (clonedNode as unknown as { args: ReturnType<typeof list> }).args = patchedArgs;
+
+    const evald = await clonedRoot.eval(context);
+
+    expect(evald.toTrimmedString({ context })).toContain('fn(3 4)');
+    expect(originalSecond.pre).toBe(0);
+    expect(patchedSecond.pre).toBe(0);
+    expect(originalArg.toTrimmedString()).toBe('12');
+    expect(patchedArg.toTrimmedString()).toBe('34');
+  });
+
+  it('preserves a cloned content node across fallback-call materialization without mutating the canonical call', async () => {
+    const failingFn = () => {
+      throw new Error('boom');
+    };
+    const node = call({
+      name: ref('fn', { type: 'variable', fallbackValue: true }),
+      args: list([num(1)])
+    }, { silentFail: true });
+    const root = rules([
+      vardecl({
+        name: any('fn'),
+        value: jsfunc({ name: 'fn', fn: failingFn })
+      }),
+      node
+    ]);
+    const clonedRoot = root.clone(true);
+    const clonedNode = clonedRoot.at(1, context) as ReturnType<typeof call>;
+    const patchedContent = any('patched');
+
+    clonedNode.adopt(patchedContent, context);
+    (clonedNode as unknown as { contentNode: ReturnType<typeof any> }).contentNode = patchedContent;
+
+    const evald = await clonedRoot.eval(context);
+
+    expect(evald.toTrimmedString({ context })).toContain('fn(1): patched');
+    expect(node.get('contentNode')).toBeUndefined();
+    expect(node.toTrimmedString()).toBe('$fn??(1)');
+  });
+
+  it('passes the current evaluated arg nodes into JS function calls without mutating the canonical arg nodes', async () => {
+    const second = num(2);
+    second.pre = 0;
+    const arg = seq([num(1), second]);
+    let seenArg: unknown;
+    const node = call({
+      name: ref('fn', { type: 'variable' }),
+      args: list([arg])
+    });
+    const root = rules([
+      vardecl({
+        name: any('fn'),
+        value: jsfunc({
+          name: 'fn',
+          fn: (value: unknown) => {
+            seenArg = value;
+            return value;
+          }
+        })
+      }),
+      node
+    ]);
+    const clonedRoot = root.clone(true);
+    const clonedNode = clonedRoot.at(1, context) as ReturnType<typeof call>;
+    const clonedArg = clonedNode.get('args').at(0, context) as ReturnType<typeof seq>;
+    const clonedSecond = num(4);
+    clonedSecond.pre = 0;
+
+    (clonedArg as unknown as { value: ReturnType<typeof num>[] }).value = [num(3), clonedSecond];
+
+    const evald = await clonedRoot.eval(context);
+
+    expect(seenArg).toBe(clonedArg);
+    expect(evald.toTrimmedString({ context })).toContain('34');
+    expect(arg.toTrimmedString()).toBe('12');
+    expect(second.pre).toBe(0);
+    expect(clonedArg.toTrimmedString()).toBe('34');
+    expect(clonedSecond.pre).toBe(0);
+  });
+
+  it('defers lazy defineFunction args until callWithContext requests them', async () => {
+    const lazyFn = defineFunction(
+      'lazy-if',
+      async function(_condition: Node, thenValue: () => Promise<Node>, elseValue: () => Promise<Node>) {
+        return await elseValue();
+      },
+      {
+        params: [{
+          name: 'condition',
+          type: Node
+        }, {
+          name: 'thenValue',
+          type: Node,
+          lazy: true
+        }, {
+          name: 'elseValue',
+          type: Node,
+          lazy: true
+        }]
+      }
+    );
+    const node = call({
+      name: ref('fn', { type: 'variable' }),
+      args: list([any('ignored'), ref('missingThen'), num(2)])
+    });
+    const root = rules([
+      vardecl({
+        name: any('fn'),
+        value: jsfunc({ name: 'fn', fn: lazyFn })
+      }),
+      node
+    ]);
+
+    const evald = await root.eval(context);
+
+    expect(evald.toTrimmedString({ context })).toContain('2');
+  });
+
+  it('does not clear canonical silentFail in the non-function branch during patch-only eval', async () => {
+    const node = call({
+      name: 'rgb',
+      args: list([num(1)])
+    }, { silentFail: true });
+
+    const evald = await node.eval(context);
+
+    expect(evald.toTrimmedString({ context })).toBe('rgb(1)');
+    expect(node.toTrimmedString()).toBe('rgb?(1)');
+    expect(node.options.silentFail).toBe(true);
+  });
+
+  it('reads a cloned silentFail option during serialization without mutating canonical output', () => {
+    const node = call({
+      name: 'rgb',
+      args: list([num(1)])
+    });
+    const clonedNode = node.clone();
+
+    clonedNode.options = { silentFail: true };
+
+    expect(clonedNode.toTrimmedString({ context })).toBe('rgb?(1)');
+    expect(node.toTrimmedString()).toBe('rgb(1)');
+    expect(node.options.silentFail).toBeUndefined();
+  });
+
+  it('reads a cloned silentFail option during non-function eval without mutating canonical options', async () => {
+    const node = call({
+      name: 'rgb',
+      args: list([num(1)])
+    });
+    const clonedNode = node.clone();
+
+    clonedNode.options = { silentFail: true };
+
+    const evald = await clonedNode.eval(context);
+
+    expect(evald.toTrimmedString({ context })).toBe('rgb(1)');
+    expect(clonedNode.toTrimmedString({ context })).toBe('rgb?(1)');
+    expect(node.toTrimmedString()).toBe('rgb(1)');
+    expect(node.options.silentFail).toBeUndefined();
+  });
+
+  it('uses the call-local shallow clone in the silent-fail non-function branch without canonically reparenting children', async () => {
+    const args = list([num(1)]);
+    const node = call({
+      name: 'rgb',
+      args
+    }, { silentFail: true });
+
+    const evald = await node.eval(context);
+
+    expect(evald.toTrimmedString({ context })).toBe('rgb(1)');
+    expect(args.parent).toBe(node);
+    expect(node.toTrimmedString()).toBe('rgb?(1)');
+  });
+
+  it('returns a collection through a placement-owned Rules boundary without mutating canonical children', async () => {
+    const childDecl = decl({ name: 'color', value: any('red') });
+    const collectionNode = coll([childDecl]);
+    const node = call({
+      name: collectionNode,
+      args: list([])
+    }, { markImportant: true });
+
+    const result = await node.eval(context);
+    const resultContext = { ...context, renderKey: (result as typeof result & { renderKey: symbol | number }).renderKey };
+
+    expect(result.toTrimmedString({ context })).toContain('color: red !important;');
+    expect(result.at(0, context)).toBe(childDecl);
+    expect(childDecl.getCurrentImportant(resultContext)?.toTrimmedString()).toBe('!important');
+    expect(childDecl.parent).toBe(collectionNode);
+    expect(childDecl.toTrimmedString({ context })).toBe('color: red');
+  });
+
+  it('keeps canonical collection children on the source Rules when the returned boundary is marked important', () => {
+    const childDecl = decl({ name: 'color', value: any('red') });
+    const returnValue = rules([childDecl]);
+    const node = call({
+      name: returnValue,
+      args: list([])
+    }, { markImportant: true });
+
+    const shallow = returnValue.createPlacementWrapper(context, context.nextRenderKey());
+    const shallowContext = { ...context, renderKey: shallow.renderKey };
+
+    expect(shallow.value[0]).toBe(childDecl);
+    expect(childDecl.parent).toBe(returnValue);
+    expect(returnValue.value[0]).toBe(childDecl);
+
+    node.makeImportant(shallow, context);
+
+    expect(shallow.at(0, context)).toBe(childDecl);
+    expect(shallow.toTrimmedString({ context })).toContain('!important');
+    expect(childDecl.get('important', shallowContext)?.toTrimmedString()).toBe('!important');
+    expect(childDecl.get('important')).toBeUndefined();
+  });
+
+  it('reads a cloned markImportant option for collection results without mutating canonical options', async () => {
+    const childDecl = decl({ name: 'color', value: any('red') });
+    const collectionNode = coll([childDecl]);
+    const node = call({
+      name: collectionNode,
+      args: list([])
+    });
+    const clonedNode = node.clone();
+
+    clonedNode.options = { markImportant: true };
+
+    const result = await clonedNode.eval(context);
+
+    expect(result.toTrimmedString({ context })).toContain('color: red !important;');
+    expect(node.options.markImportant).toBeUndefined();
+  });
+
+  // it('should serialize to a module', () => {
+  //   let rule = call({
+  //     name: 'rgb',
+  //     value: list([num(100), num(100), num(100)])
+  //   })
+  //   rule.toModule(context, out)
+  //   expect(out.toString()).toBe(
+  //     '$J.call({\n  name: "rgb",\n  value: $J.list([\n    $J.num({\n      value: 100,\n      unit: ""\n    }),\n    $J.num({\n      value: 100,\n      unit: ""\n    }),\n    $J.num({\n      value: 100,\n      unit: ""\n    })\n  ]),\n  ref: () => rgb,\n})'
+  //   )
+  // })
+});