Function expr

packages/core/src/constraints/expr.ts:110–141

(source: string)

}

export function expr(source: string): ConstraintExpr {
  const cached = EXPR_CACHE.get(source);
  if (cached !== undefined) {
    // Refresh simple LRU access order.
    EXPR_CACHE.delete(source);
    EXPR_CACHE.set(source, cached);
    return cached;
  }

  const parsed = parse(source);
  const ast = freezeAst(parsed);
  const refs = freezeReadonlySet(extractRefs(ast));
  const hasIntrinsic = detectIntrinsicRefs(ast);
  const hasSiblingAggregation = detectSiblingAggregation(ast);
  // Keep call-site analysis hot-path free by validating usage here once.
  void collectWidgetRefUsages(ast);
  const out = Object.freeze({
    __brand: "ConstraintExpr" as const,
    source,
    ast,
    refs,
    hasIntrinsic,
    hasSiblingAggregation,
  });
  EXPR_CACHE.set(source, out);
  while (EXPR_CACHE.size > EXPR_CACHE_MAX) {
    const oldest = EXPR_CACHE.keys().next().value;
    if (typeof oldest !== "string") break;
    EXPR_CACHE.delete(oldest);
  }
  return out;
}

export function isConstraintExpr(value: unknown): value is ConstraintExpr {
  if (typeof value !== "object" || value === null) return false;