@likec4/language-server 1.15.1 → 1.17.0

package/src/index.ts

@@ -1,19 +1,19 @@
 import { startLanguageServer as startLanguim } from 'langium/lsp'
-import { NodeFileSystem } from 'langium/node'
 import { createConnection, ProposedFeatures } from 'vscode-languageserver/node'
+import { LikeC4FileSystem } from './LikeC4FileSystem'
 import { createLanguageServices } from './module'
 
 export { logger as lspLogger, setLogLevel } from './logger'
 export type * from './model'
 export type * from './module'
 export { createCustomLanguageServices, createLanguageServices, LikeC4Module } from './module'
-
+export { LikeC4FileSystem }
 export function startLanguageServer() {
   /* browser specific setup code */
   const connection = createConnection(ProposedFeatures.all)
 
   // Inject the shared services and language-specific services
-  const services = createLanguageServices({ connection, ...NodeFileSystem })
+  const services = createLanguageServices({ connection, ...LikeC4FileSystem })
 
   // Start the language server with the shared services
   startLanguim(services.shared)

package/src/like-c4.langium

@@ -267,6 +267,7 @@ ViewLayoutDirection returns string:
 
 ViewRule:
   ViewRulePredicate |
+  ViewRuleGlobalPredicateRef |
   ViewRuleGroup |
   ViewRuleStyleOrGlobalRef |
   ViewRuleAutoLayout
@@ -287,6 +288,7 @@ ViewRuleGroup:
 
 DynamicViewRule:
   DynamicViewIncludePredicate |
+  DynamicViewGlobalPredicateRef |
   ViewRuleStyleOrGlobalRef |
   ViewRuleAutoLayout
 ;
@@ -318,6 +320,9 @@ Predicate:
   ElementPredicate
 ;
 
+ViewRuleGlobalPredicateRef:
+  'global' 'predicate' predicate=[GlobalPredicateGroup];
+
 ElementPredicate:
   ElementPredicates;
 
@@ -443,6 +448,9 @@ DynamicViewIncludePredicate:
   'include' predicates=DynamicViewPredicateIterator
 ;
 
+DynamicViewGlobalPredicateRef:
+  'global' 'predicate' predicate=[GlobalDynamicPredicateGroup];
+
 DynamicViewPredicateIterator:
   value=ElementPredicate ({infer DynamicViewPredicateIterator.prev=current} ',' (value=ElementPredicate)?)*
 ;
@@ -506,10 +514,21 @@ RelationNavigateToProperty:
 Globals:
   name='global' '{'
     (
+      predicates+=(GlobalPredicateGroup | GlobalDynamicPredicateGroup)*
       styles+=(GlobalStyle | GlobalStyleGroup)*
     )*
   '}';
 
+GlobalPredicateGroup:
+  'predicateGroup' name=IdTerminal '{'
+    predicates+=ViewRulePredicate*
+  '}';
+
+GlobalDynamicPredicateGroup:
+  'dynamicPredicateGroup' name=IdTerminal '{'
+    predicates+=DynamicViewIncludePredicate*
+  '}';
+
 GlobalStyleId:
   name=IdTerminal;
 
@@ -538,7 +557,7 @@ OpacityProperty:
 
 // Element properties -------------------------------------
 IconProperty:
-  key='icon' ':'? (libicon=[LibIcon:IconId] | value=Uri) ';'?;
+  key='icon' ':'? (libicon=[LibIcon:IconId] | value=('none'|Uri)) ';'?;
 
 ShapeProperty:
   key='shape' ':'? value=ElementShape ';'?;

package/src/lsp/SemanticTokenProvider.ts

@@ -196,6 +196,32 @@ export class LikeC4SemanticTokenProvider extends AbstractSemanticTokenProvider {
         property: 'key',
         type: SemanticTokenTypes.property
       })
+      if (ast.isIconProperty(node)) {
+        if (node.libicon) {
+          acceptor({
+            node,
+            property: 'libicon',
+            type: SemanticTokenTypes.enum,
+            modifier: [SemanticTokenModifiers.defaultLibrary]
+          })
+        } else {
+          if (node.value === 'none') {
+            acceptor({
+              node,
+              property: 'value',
+              type: SemanticTokenTypes.enum,
+              modifier: [SemanticTokenModifiers.defaultLibrary]
+            })
+          } else {
+            acceptor({
+              node,
+              property: 'value',
+              type: SemanticTokenTypes.string
+            })
+          }
+        }
+        return 'prune'
+      }
       if ('value' in node && node.value) {
         acceptor({
           node,
@@ -203,14 +229,6 @@ export class LikeC4SemanticTokenProvider extends AbstractSemanticTokenProvider {
           type: SemanticTokenTypes.string
         })
       }
-      if (ast.isIconProperty(node) && node.libicon) {
-        acceptor({
-          node,
-          property: 'libicon',
-          type: SemanticTokenTypes.enum,
-          modifier: [SemanticTokenModifiers.defaultLibrary]
-        })
-      }
       return 'prune'
     }
     if (

package/src/model/fqn-computation.ts

@@ -52,7 +52,9 @@ export function computeDocumentFqn(document: LikeC4LangiumDocument, services: Li
         if (isDefined(el.body) && !isEmpty(el.body.elements)) {
           const fqn = getFqnElementRef(el.element)
           for (const child of el.body.elements) {
-            traverseStack.push([child, fqn])
+            if (!ast.isRelation(child)) {
+              traverseStack.push([child, fqn])
+            }
           }
         }
         continue
@@ -66,7 +68,9 @@ export function computeDocumentFqn(document: LikeC4LangiumDocument, services: Li
         ElementOps.writeId(el, fqn)
         if (isDefined(el.body) && !isEmpty(el.body.elements)) {
           for (const child of el.body.elements) {
-            traverseStack.push([child, fqn])
+            if (!ast.isRelation(child)) {
+              traverseStack.push([child, fqn])
+            }
           }
         }
         continue

package/src/model/model-builder.ts

@@ -13,10 +13,8 @@ import { deepEqual as eq } from 'fast-equals'
 import type { Cancellation, LangiumDocument, LangiumDocuments, URI, WorkspaceCache } from 'langium'
 import { Disposable, DocumentState, interruptAndCheck } from 'langium'
 import {
-  entries,
   filter,
   flatMap,
-  forEach,
   groupBy,
   indexBy,
   isEmpty,
@@ -46,21 +44,37 @@ import { isParsedLikeC4LangiumDocument } from '../ast'
 import { logError, logger, logWarnError } from '../logger'
 import { computeDynamicView, computeView, LikeC4ModelGraph } from '../model-graph'
 import type { LikeC4Services } from '../module'
-import { assignNavigateTo, resolveGlobalRules, resolveRelativePaths, resolveRulesExtendedViews } from '../view-utils'
+import { assignNavigateTo, resolveRelativePaths, resolveRulesExtendedViews } from '../view-utils'
 
 function buildModel(services: LikeC4Services, docs: ParsedLikeC4LangiumDocument[]): c4.ParsedLikeC4Model {
+  // Merge specifications and globals from all documents
   const c4Specification: ParsedAstSpecification = {
     tags: new Set(),
     elements: {},
     relationships: {},
     colors: {}
   }
-  forEach(map(docs, prop('c4Specification')), spec => {
+  const globals: c4.ModelGlobals = {
+    predicates: {},
+    dynamicPredicates: {},
+    styles: {}
+  }
+  for (const doc of docs) {
+    const {
+      c4Specification: spec,
+      c4Globals
+    } = doc
+
     spec.tags.forEach(t => c4Specification.tags.add(t))
     Object.assign(c4Specification.elements, spec.elements)
     Object.assign(c4Specification.relationships, spec.relationships)
     Object.assign(c4Specification.colors, spec.colors)
-  })
+
+    Object.assign(globals.predicates, c4Globals.predicates)
+    Object.assign(globals.dynamicPredicates, c4Globals.dynamicPredicates)
+    Object.assign(globals.styles, c4Globals.styles)
+  }
+
   function resolveLinks(doc: LangiumDocument, links: c4.NonEmptyArray<ParsedLink>) {
     return map(
       links,
@@ -211,23 +225,6 @@ function buildModel(services: LikeC4Services, docs: ParsedLikeC4LangiumDocument[
     indexBy(prop('id'))
   )
 
-  const parsedGlobals: {
-    styles: Record<c4.GlobalStyleID, c4.ViewRuleStyle[]>
-  } = {
-    styles: {}
-  }
-  Object.assign(parsedGlobals.styles, ...docs.map(d => d.c4Globals.styles))
-
-  const globals: {
-    styles: Record<c4.GlobalStyleID, c4.GlobalStyle>
-  } = {
-    styles: pipe(
-      entries(parsedGlobals.styles),
-      map(([id, styles]) => ({ id, styles })),
-      indexBy(prop('id'))
-    )
-  }
-
   function toC4View(doc: LangiumDocument) {
     const docUri = doc.uri.toString()
     return (parsedAstView: ParsedAstView): c4.LikeC4View => {
@@ -399,10 +396,9 @@ export class LikeC4ModelBuilder {
 
       const allViews = [] as c4.ComputedView[]
       for (const view of values(model.views)) {
-        const resolvedView = resolveGlobalRules(view, model.globals.styles)
-        const result = isElementView(resolvedView)
-          ? computeView(resolvedView, index)
-          : computeDynamicView(resolvedView, index)
+        const result = isElementView(view)
+          ? computeView(view, index)
+          : computeDynamicView(view, index)
         if (!result.isSuccess) {
           logWarnError(result.error)
           continue
@@ -467,10 +463,9 @@ export class LikeC4ModelBuilder {
           return null
         }
         const index = new LikeC4ModelGraph(model)
-        const resolvedView = resolveGlobalRules(view, model.globals.styles)
-        const result = isElementView(resolvedView)
-          ? computeView(resolvedView, index)
-          : computeDynamicView(resolvedView, index)
+        const result = isElementView(view)
+          ? computeView(view, index)
+          : computeDynamicView(view, index)
         if (!result.isSuccess) {
           logError(result.error)
           return null

package/src/model/model-parser.ts

@@ -11,6 +11,7 @@ import type {
   ParsedAstDynamicView,
   ParsedAstElement,
   ParsedAstElementView,
+  ParsedAstGlobals,
   ParsedAstRelation,
   ParsedLikeC4LangiumDocument,
   ParsedLink
@@ -288,6 +289,25 @@ export class LikeC4ModelParser {
     const { parseResult, c4Globals } = doc
 
     const globals = parseResult.value.globals.filter(isValid)
+
+    const elRelPredicates = globals.flatMap(r => r.predicates.filter(isValid))
+    for (const predicate of elRelPredicates) {
+      try {
+        const globalPredicateId = predicate.name as c4.GlobalPredicateId
+        if (!isTruthy(globalPredicateId)) {
+          continue
+        }
+        if (globalPredicateId in c4Globals.predicates) {
+          logger.warn(`Global predicate named "${globalPredicateId}" is already defined`)
+          continue
+        }
+
+        this.parseAndStoreGlobalPredicateGroupOrDynamic(predicate, globalPredicateId, c4Globals, isValid)
+      } catch (e) {
+        logWarnError(e)
+      }
+    }
+
     const styles = globals.flatMap(r => r.styles.filter(isValid))
     for (const style of styles) {
       try {
@@ -310,12 +330,49 @@ export class LikeC4ModelParser {
     }
   }
 
+  private parseAndStoreGlobalPredicateGroupOrDynamic(
+    astRule: ast.GlobalPredicateGroup | ast.GlobalDynamicPredicateGroup,
+    id: c4.GlobalPredicateId,
+    c4Globals: ParsedAstGlobals,
+    isValid: IsValidFn
+  ) {
+    if (ast.isGlobalPredicateGroup(astRule)) {
+      const predicates = this.parseGlobalPredicateGroup(astRule, isValid)
+      if (predicates.length > 0) {
+        c4Globals.predicates[id] = predicates as c4.NonEmptyArray<c4.ViewRulePredicate>
+      }
+      return
+    }
+    if (ast.isGlobalDynamicPredicateGroup(astRule)) {
+      const predicates = this.parseGlobalDynamicPredicateGroup(astRule, isValid)
+      if (predicates.length > 0) {
+        c4Globals.dynamicPredicates[id] = predicates as c4.NonEmptyArray<c4.DynamicViewIncludeRule>
+      }
+      return
+    }
+    nonexhaustive(astRule)
+  }
+
+  private parseGlobalPredicateGroup(
+    astRule: ast.GlobalPredicateGroup,
+    isValid: IsValidFn
+  ): c4.ViewRulePredicate[] {
+    return astRule.predicates.map(p => this.parseViewRulePredicate(p, isValid))
+  }
+
+  private parseGlobalDynamicPredicateGroup(
+    astRule: ast.GlobalDynamicPredicateGroup,
+    isValid: IsValidFn
+  ): c4.DynamicViewIncludeRule[] {
+    return astRule.predicates.map(p => this.parseDynamicViewIncludePredicate(p, isValid))
+  }
+
   private parseGlobalStyleOrGroup(
     astRule: ast.GlobalStyle | ast.GlobalStyleGroup,
     isValid: IsValidFn
   ): c4.ViewRuleStyle[] {
     if (ast.isGlobalStyle(astRule)) {
-      return [this.parseGlobalStyle(astRule, isValid)]
+      return [this.parseViewRuleStyle(astRule, isValid)]
     }
     if (ast.isGlobalStyleGroup(astRule)) {
       return astRule.styles.map(s => this.parseViewRuleStyle(s, isValid))
@@ -323,19 +380,17 @@ export class LikeC4ModelParser {
     nonexhaustive(astRule)
   }
 
-  private parseGlobalStyle(astRule: ast.GlobalStyle, isValid: IsValidFn): c4.ViewRuleStyle {
-    const styleProps = astRule.props.filter(ast.isStyleProperty)
-    const targets = astRule.target
-    const notation = astRule.props.find(ast.isNotationProperty)
-    return this.parseRuleStyle(styleProps, targets, isValid, notation)
-  }
-
   private parseViews(doc: ParsedLikeC4LangiumDocument, isValid: IsValidFn) {
     const viewBlocks = doc.parseResult.value.views.filter(v => isValid(v))
     for (const viewBlock of viewBlocks) {
-      const localStyles = viewBlock.styles
-        .flatMap(s => this.parseViewRuleStyleOrGlobalRef(s, isValid))
-      const stylesToApply = localStyles
+      const localStyles = viewBlock.styles.flatMap(s => {
+        try {
+          return this.parseViewRuleStyleOrGlobalRef(s, isValid)
+        } catch (e) {
+          logWarnError(e)
+          return []
+        }
+      })
 
       for (const view of viewBlock.views) {
         try {
@@ -344,8 +399,8 @@ export class LikeC4ModelParser {
           }
           doc.c4Views.push(
             ast.isElementView(view)
-              ? this.parseElementView(view, stylesToApply, isValid)
-              : this.parseDynamicElementView(view, stylesToApply, isValid)
+              ? this.parseElementView(view, localStyles, isValid)
+              : this.parseDynamicElementView(view, localStyles, isValid)
           )
         } catch (e) {
           logWarnError(e)
@@ -415,14 +470,14 @@ export class LikeC4ModelParser {
       }
     }
     if (ast.isElementKindExpression(astNode)) {
-      invariant(astNode.kind, 'ElementKindExpr kind is not resolved: ' + astNode.$cstNode?.text)
+      invariant(astNode.kind?.ref, 'ElementKindExpr kind is not resolved: ' + astNode.$cstNode?.text)
       return {
-        elementKind: astNode.kind.$refText as c4.ElementKind,
+        elementKind: astNode.kind.ref.name as c4.ElementKind,
         isEqual: astNode.isEqual
       }
     }
     if (ast.isElementTagExpression(astNode)) {
-      invariant(astNode.tag, 'ElementTagExpr tag is not resolved: ' + astNode.$cstNode?.text)
+      invariant(astNode.tag?.ref, 'ElementTagExpr tag is not resolved: ' + astNode.$cstNode?.text)
       let elementTag = astNode.tag.$refText
       if (elementTag.startsWith('#')) {
         elementTag = elementTag.slice(1)
@@ -653,6 +708,9 @@ export class LikeC4ModelParser {
     if (ast.isViewRulePredicate(astRule)) {
       return this.parseViewRulePredicate(astRule, isValid)
     }
+    if (ast.isViewRuleGlobalPredicateRef(astRule)) {
+      return this.parseViewRuleGlobalPredicateRef(astRule, isValid)
+    }
     if (ast.isViewRuleStyleOrGlobalRef(astRule)) {
       return this.parseViewRuleStyleOrGlobalRef(astRule, isValid)
     }
@@ -665,7 +723,19 @@ export class LikeC4ModelParser {
     nonexhaustive(astRule)
   }
 
-  private parseViewRuleStyleOrGlobalRef(astRule: ast.ViewRuleStyleOrGlobalRef, isValid: IsValidFn): c4.ViewRuleStyleOrGlobalRef {
+  private parseViewRuleGlobalPredicateRef(
+    astRule: ast.ViewRuleGlobalPredicateRef | ast.DynamicViewGlobalPredicateRef,
+    _isValid: IsValidFn
+  ): c4.ViewRuleGlobalPredicateRef {
+    return {
+      predicateId: astRule.predicate.$refText as c4.GlobalPredicateId
+    }
+  }
+
+  private parseViewRuleStyleOrGlobalRef(
+    astRule: ast.ViewRuleStyleOrGlobalRef,
+    isValid: IsValidFn
+  ): c4.ViewRuleStyleOrGlobalRef {
     if (ast.isViewRuleStyle(astRule)) {
       return this.parseViewRuleStyle(astRule, isValid)
     }
@@ -675,7 +745,7 @@ export class LikeC4ModelParser {
     nonexhaustive(astRule)
   }
 
-  private parseViewRuleStyle(astRule: ast.ViewRuleStyle, isValid: IsValidFn): c4.ViewRuleStyle {
+  private parseViewRuleStyle(astRule: ast.ViewRuleStyle | ast.GlobalStyle, isValid: IsValidFn): c4.ViewRuleStyle {
     const styleProps = astRule.props.filter(ast.isStyleProperty)
     const targets = astRule.target
     const notation = astRule.props.find(ast.isNotationProperty)
@@ -971,6 +1041,9 @@ export class LikeC4ModelParser {
     if (ast.isDynamicViewIncludePredicate(astRule)) {
       return this.parseDynamicViewIncludePredicate(astRule, isValid)
     }
+    if (ast.isDynamicViewGlobalPredicateRef(astRule)) {
+      return this.parseViewRuleGlobalPredicateRef(astRule, isValid)
+    }
     if (ast.isViewRuleStyleOrGlobalRef(astRule)) {
       return this.parseViewRuleStyleOrGlobalRef(astRule, isValid)
     }

package/src/model-graph/LikeC4ModelGraph.ts

@@ -5,6 +5,7 @@ import {
   type Fqn,
   invariant,
   isSameHierarchy,
+  type ModelGlobals,
   parentFqn,
   type Relation,
   type RelationID
@@ -14,7 +15,8 @@ import { isArray, isString } from 'remeda'
 type Params = {
   elements: Record<Fqn, Element>
   relations: Record<RelationID, Relation>
-  // views: ElementView[]
+  // Optional for tests
+  globals?: ModelGlobals
 }
 
 type RelationEdge = {
@@ -41,24 +43,33 @@ function intersection<T>(a: Set<T>, b: Set<T>) {
  * Subject to change.
  */
 export class LikeC4ModelGraph {
-  #elements = new Map<Fqn, Element>()
+  readonly #elements = new Map<Fqn, Element>()
   // Parent element for given FQN
-  #parents = new Map<Fqn, Element>()
+  readonly #parents = new Map<Fqn, Element>()
   // Children elements for given FQN
-  #children = new Map<Fqn, Element[]>()
-  #rootElements = new Set<Element>()
+  readonly #children = new Map<Fqn, Element[]>()
+  readonly #rootElements = new Set<Element>()
 
-  #relations = new Map<RelationID, Relation>()
+  readonly #relations = new Map<RelationID, Relation>()
   // Incoming to an element or its descendants
-  #incoming = new MapRelations()
+  readonly #incoming = new MapRelations()
   // Outgoing from an element or its descendants
-  #outgoing = new MapRelations()
+  readonly #outgoing = new MapRelations()
   // Relationships inside the element, among descendants
-  #internal = new MapRelations()
+  readonly #internal = new MapRelations()
 
-  #cacheAscendingSiblings = new Map<Fqn, Element[]>()
+  readonly #cacheAscendingSiblings = new Map<Fqn, Element[]>()
 
-  constructor({ elements, relations }: Params) {
+  public readonly globals: ModelGlobals
+
+  constructor(
+    { elements, relations, globals }: Params
+  ) {
+    this.globals = globals ?? {
+      predicates: {},
+      dynamicPredicates: {},
+      styles: {}
+    }
     for (const el of Object.values(elements)) {
       this.addElement(el)
     }

package/src/model-graph/compute-view/__test__/fixture.ts

@@ -11,6 +11,8 @@ import {
   type ElementWhereExpr,
   type Expression as C4Expression,
   type Fqn,
+  type GlobalStyleID,
+  type IconUrl,
   type IncomingExpr as C4IncomingExpr,
   type InOutExpr as C4InOutExpr,
   isElementRef,
@@ -28,6 +30,7 @@ import {
   type Tag,
   type ViewID,
   type ViewRule,
+  type ViewRuleGlobalStyle,
   type ViewRuleGroup,
   type ViewRulePredicate,
   type ViewRuleStyle,
@@ -161,6 +164,7 @@ export const fakeElements = {
     id: 'cloud',
     kind: 'system',
     title: 'cloud',
+    icon: 'none',
     tags: ['next', 'old']
   }),
   'cloud.backend': el({
@@ -177,6 +181,7 @@ export const fakeElements = {
   'cloud.backend.graphql': el({
     id: 'cloud.backend.graphql',
     kind: 'component',
+    icon: 'tech:graphql' as IconUrl,
     title: 'graphql'
   }),
   'email': el({
@@ -200,12 +205,14 @@ export const fakeElements = {
     id: 'cloud.frontend.dashboard',
     kind: 'component',
     title: 'dashboard',
+    icon: 'tech:react' as IconUrl,
     tags: ['next']
   }),
   'amazon': el({
     id: 'amazon',
     kind: 'system',
     title: 'amazon',
+    icon: 'tech:aws' as IconUrl,
     tags: ['aws']
   }),
   'amazon.s3': el({
@@ -213,6 +220,7 @@ export const fakeElements = {
     kind: 'component',
     title: 's3',
     shape: 'storage',
+    icon: 'aws:s3' as IconUrl,
     tags: ['aws', 'storage']
   })
 } satisfies Record<string, Element>
@@ -331,11 +339,37 @@ export const fakeRelations = [
   })
 ]
 
+export const globalStyles = {
+  'mute_old': [{
+    targets: [$expr({
+      elementTag: 'old' as Tag,
+      isEqual: true
+    })],
+    style: {
+      color: 'muted'
+    }
+  }],
+  'red_next': [{
+    targets: [$expr({
+      elementTag: 'next' as Tag,
+      isEqual: true
+    })],
+    style: {
+      color: 'red'
+    }
+  }]
+} as const
+
 export type FakeRelationIds = (typeof fakeRelations)[number]['id']
 
 export const fakeModel = new LikeC4ModelGraph({
   elements: fakeElements,
-  relations: indexBy(fakeRelations, r => r.id)
+  relations: indexBy(fakeRelations, r => r.id),
+  globals: {
+    predicates: {},
+    dynamicPredicates: {},
+    styles: globalStyles
+  }
 })
 
 const emptyView = {
@@ -510,30 +544,34 @@ type CustomProps = {
 }
 export function $include(expr: Expression | C4Expression, props?: CustomProps): ViewRulePredicate {
   let _expr = props?.where ? $where(expr, props.where) : $expr(expr)
-  if (props?.with) {
-    if (isRelationExpression(_expr) || isRelationWhere(_expr)) {
-      _expr = {
-        customRelation: {
-          relation: _expr,
-          ...props.with as any
-        }
+  _expr = props?.with ? $with(_expr, props.with) : _expr
+  return {
+    include: [_expr]
+  }
+}
+export function $with(expr: C4Expression, props?: CustomProps['with']): C4CustomRelationExpr | C4CustomElementExpr {
+  if (isRelationExpression(expr) || isRelationWhere(expr)) {
+    return {
+      customRelation: {
+        relation: expr,
+        ...props as any
       }
-    } else if (isElementRef(_expr) || isElementWhere(_expr)) {
-      _expr = {
-        custom: {
-          expr: _expr,
-          ...props.with as any
-        }
+    }
+  } else if (isElementRef(expr) || isElementWhere(expr)) {
+    return {
+      custom: {
+        expr: expr,
+        ...props as any
       }
     }
   }
-  return {
-    include: [_expr]
-  }
+
+  throw 'Unsupported type of internal expression'
 }
-export function $exclude(expr: Expression | C4Expression): ViewRulePredicate {
+export function $exclude(expr: Expression | C4Expression, where?: WhereOperator<TestTag, string>): ViewRulePredicate {
+  let _expr = where ? $where(expr, where) : $expr(expr)
   return {
-    exclude: [$expr(expr)]
+    exclude: [_expr]
   }
 }
 export function $group(groupRules: ViewRuleGroup['groupRules']): ViewRuleGroup {
@@ -550,6 +588,18 @@ export function $style(element: ElementRefExpr, style: ViewRuleStyle['style']):
   }
 }
 
+type GlobalStyles = keyof typeof globalStyles
+type GlobalExpr = `style ${GlobalStyles}`
+export function $global(expr: GlobalExpr): ViewRuleGlobalStyle {
+  const [_t, id] = expr.split(' ') as [string, string]
+  if (_t === 'style') {
+    return {
+      styleId: id as GlobalStyleID
+    }
+  }
+  throw new Error('Invalid global expression')
+}
+
 export function computeView(
   ...args: [FakeElementIds, ViewRule | ViewRule[]] | [ViewRule | ViewRule[]]
 ) {