@malloydata/malloy-query-builder 0.0.240-dev250305162504 → 0.0.240-dev250305163014

package/README.md

@@ -328,7 +328,7 @@ run: flights -> { aggregate: flight_count { where: carrier ~ f`WN, AA`} }
 {@link ASTSourceReference.setParameter}
 
 ```ts
-query.source.setParameter("param", 1);
+query.definition.asArrowQueryDefinition().sourceReference.parameters.setParameter("param", 1)
 ```
 ```
 run: flights(param is 1) ->
@@ -339,7 +339,7 @@ run: flights(param is 1) ->
 {@link ASTSourceReference.getSourceParameters}
 
 ```ts
-query.definition.asArrowQueryDefinition().source.getSourceParameters();
+query.definition.asArrowQueryDefinition().sourceReference.getSourceParameters();
 ```
 
 ## To a particular field in the query (including nests), add/edit/delete annotation

package/dist/query-ast.d.ts

@@ -39,234 +39,65 @@ declare abstract class ASTNode<T> {
     /**
      * @internal
      */
-    abstract find(path: Path): ASTAny;
-    /**
-     * Returns this node as an `ASTQuery`. Throws if it is not an `ASTQuery`.
-     *
-     * There are variants of this method for _all_ ASTXYZ nodes `asXYZ`, but they
-     * are not shown here so the docs aren't crazy big.
-     *
-     * @returns Returns this node as an `ASTQuery`.
-     */
-    asQuery(): ASTQuery;
-    /**
-     * Finds the AST node at the given `path`. Throws if it is not an `ASTQuery`.
-     *
-     * There are variants of this method for _all_ ASTXYZ nodes `findXYZ`, but they
-     * are not shown here so the docs aren't crazy big.
-     *
-     * @param path Path to the desired ASTNode, e.g. `['source', 'parameters', 0]`
-     * @returns Returns this node as an `ASTQuery`.
-     */
-    findQuery(path: Path): ASTQuery;
-    /**
-     * @hidden
-     */
-    asReference(): ASTReference;
-    /**
-     * @hidden
-     */
-    findReference(path: Path): ASTReference;
-    /**
-     * @hidden
-     */
-    asSourceReference(): ASTSourceReference;
-    /**
-     * @hidden
-     */
-    findSourceReference(path: Path): ASTSourceReference;
-    /**
-     * @hidden
-     */
-    asParameterValueList(): ASTParameterValueList;
-    /**
-     * @hidden
-     */
-    findParameterValueList(path: Path): ASTParameterValueList;
-    /**
-     * @hidden
-     */
-    asWhere(): ASTWhere;
-    /**
-     * @hidden
-     */
-    findWhere(path: Path): ASTWhere;
-    /**
-     * @hidden
-     */
-    asWhereList(): ASTWhereList;
-    /**
-     * @hidden
-     */
-    findWhereList(path: Path): ASTWhereList;
-    /**
-     * @hidden
-     */
-    asParameterValue(): ASTParameterValue;
-    /**
-     * @hidden
-     */
-    findParameterValue(path: Path): ASTParameterValue;
-    /**
-     * @hidden
-     */
-    asStringLiteralValue(): ASTStringLiteralValue;
-    /**
-     * @hidden
-     */
-    findStringLiteralValue(path: Path): ASTStringLiteralValue;
-    /**
-     * @hidden
-     */
-    asNumberLiteralValue(): ASTNumberLiteralValue;
-    /**
-     * @hidden
-     */
-    findNumberLiteralValue(path: Path): ASTNumberLiteralValue;
-    /**
-     * @hidden
-     */
-    asViewOperationList(): ASTViewOperationList;
-    /**
-     * @hidden
-     */
-    findViewOperationList(path: Path): ASTViewOperationList;
-    /**
-     * @hidden
-     */
-    asGroupByViewOperation(): ASTGroupByViewOperation;
-    /**
-     * @hidden
-     */
-    findGroupByViewOperation(path: Path): ASTGroupByViewOperation;
-    /**
-     * @hidden
-     */
-    asAggregateViewOperation(): ASTAggregateViewOperation;
-    /**
-     * @hidden
-     */
-    findAggregateViewOperation(path: Path): ASTAggregateViewOperation;
-    /**
-     * @hidden
-     */
-    asOrderByViewOperation(): ASTOrderByViewOperation;
-    /**
-     * @hidden
-     */
-    findOrderByViewOperation(path: Path): ASTOrderByViewOperation;
-    /**
-     * @hidden
-     */
-    asField(): ASTField;
-    /**
-     * @hidden
-     */
-    findField(path: Path): ASTField;
-    /**
-     * @hidden
-     */
-    asReferenceExpression(): ASTReferenceExpression;
-    /**
-     * @hidden
-     */
-    findReferenceExpression(path: Path): ASTReferenceExpression;
-    /**
-     * @hidden
-     */
-    asReferenceViewDefinition(): ASTReferenceViewDefinition;
-    /**
-     * @hidden
-     */
-    findReferenceViewDefinition(path: Path): ASTReferenceViewDefinition;
-    /**
-     * @hidden
-     */
-    asArrowQueryDefinition(): ASTArrowQueryDefinition;
-    /**
-     * @hidden
-     */
-    findArrowQueryDefinition(path: Path): ASTArrowQueryDefinition;
-    /**
-     * @hidden
-     */
-    asArrowViewDefinition(): ASTArrowViewDefinition;
-    /**
-     * @hidden
-     */
-    findArrowViewDefinition(path: Path): ASTArrowViewDefinition;
-    /**
-     * @hidden
-     */
-    asRefinementViewDefinition(): ASTRefinementViewDefinition;
-    /**
-     * @hidden
-     */
-    findRefinementViewDefinition(path: Path): ASTRefinementViewDefinition;
-    /**
-     * @hidden
-     */
-    asTimeTruncationExpression(): ASTTimeTruncationExpression;
-    /**
-     * @hidden
-     */
-    findTimeTruncationExpression(path: Path): ASTTimeTruncationExpression;
-    /**
-     * @hidden
-     */
-    asFilteredFieldExpression(): ASTFilteredFieldExpression;
-    /**
-     * @hidden
-     */
-    findFilteredFieldExpression(path: Path): ASTFilteredFieldExpression;
-    /**
-     * @hidden
-     */
-    asNestViewOperation(): ASTNestViewOperation;
-    /**
-     * @hidden
-     */
-    findNestViewOperation(path: Path): ASTNestViewOperation;
-    /**
-     * @hidden
-     */
-    asView(): ASTView;
-    /**
-     * @hidden
-     */
-    findView(path: Path): ASTView;
-    /**
-     * @hidden
-     */
-    asSegmentViewDefinition(): ASTSegmentViewDefinition;
-    /**
-     * @hidden
-     */
-    findSegmentViewDefinition(path: Path): ASTSegmentViewDefinition;
-    /**
-     * @hidden
-     */
-    asLimitViewOperation(): ASTLimitViewOperation;
-    /**
-     * @hidden
-     */
-    findLimitViewOperation(path: Path): ASTLimitViewOperation;
-    /**
-     * @hidden
-     */
-    asAnnotationList(): ASTAnnotationList;
-    /**
-     * @hidden
-     */
-    findAnnotationList(path: Path): ASTAnnotationList;
-    /**
-     * @hidden
-     */
-    asAnnotation(): ASTAnnotation;
-    /**
-     * @hidden
-     */
-    findAnnotation(path: Path): ASTAnnotation;
+    abstract findAny(path: Path): ASTAny;
+    get as(): {
+        Query(): ASTQuery;
+        Reference(): ASTReference;
+        SourceReference(): ASTSourceReference;
+        ParameterValueList(): ASTParameterValueList;
+        Where(): ASTWhere;
+        WhereList(): ASTWhereList;
+        ParameterValue(): ASTParameterValue;
+        StringLiteralValue(): ASTStringLiteralValue;
+        NumberLiteralValue(): ASTNumberLiteralValue;
+        ViewOperationList(): ASTViewOperationList;
+        GroupByViewOperation(): ASTGroupByViewOperation;
+        AggregateViewOperation(): ASTAggregateViewOperation;
+        OrderByViewOperation(): ASTOrderByViewOperation;
+        Field(): ASTField;
+        ReferenceExpression(): ASTReferenceExpression;
+        ReferenceViewDefinition(): ASTReferenceViewDefinition;
+        ArrowQueryDefinition(): ASTArrowQueryDefinition;
+        ArrowViewDefinition(): ASTArrowViewDefinition;
+        RefinementViewDefinition(): ASTRefinementViewDefinition;
+        TimeTruncationExpression(): ASTTimeTruncationExpression;
+        FilteredFieldExpression(): ASTFilteredFieldExpression;
+        NestViewOperation(): ASTNestViewOperation;
+        View(): ASTView;
+        SegmentViewDefinition(): ASTSegmentViewDefinition;
+        LimitViewOperation(): ASTLimitViewOperation;
+        AnnotationList(): ASTAnnotationList;
+        Annotation(): ASTAnnotation;
+    };
+    get find(): {
+        Query(path: Path): ASTQuery;
+        Reference(path: Path): ASTReference;
+        SourceReference(path: Path): ASTSourceReference;
+        ParameterValueList(path: Path): ASTParameterValueList;
+        Where(path: Path): ASTWhere;
+        WhereList(path: Path): ASTWhereList;
+        ParameterValue(path: Path): ASTParameterValue;
+        StringLiteralValue(path: Path): ASTStringLiteralValue;
+        NumberLiteralValue(path: Path): ASTNumberLiteralValue;
+        ViewOperationList(path: Path): ASTViewOperationList;
+        GroupByViewOperation(path: Path): ASTGroupByViewOperation;
+        AggregateViewOperation(path: Path): ASTAggregateViewOperation;
+        OrderByViewOperation(path: Path): ASTOrderByViewOperation;
+        Field(path: Path): ASTField;
+        ReferenceExpression(path: Path): ASTReferenceExpression;
+        ReferenceViewDefinition(path: Path): ASTReferenceViewDefinition;
+        ArrowQueryDefinition(path: Path): ASTArrowQueryDefinition;
+        ArrowViewDefinition(path: Path): ASTArrowViewDefinition;
+        RefinementViewDefinition(path: Path): ASTRefinementViewDefinition;
+        TimeTruncationExpression(path: Path): ASTTimeTruncationExpression;
+        FilteredFieldExpression(path: Path): ASTFilteredFieldExpression;
+        NestViewOperation(path: Path): ASTNestViewOperation;
+        View(path: Path): ASTView;
+        SegmentViewDefinition(path: Path): ASTSegmentViewDefinition;
+        LimitViewOperation(path: Path): ASTLimitViewOperation;
+        AnnotationList(path: Path): ASTAnnotationList;
+        Annotation(path: Path): ASTAnnotation;
+    };
     /**
      * @internal
      */
@@ -287,6 +118,8 @@ declare abstract class ASTNode<T> {
      * @internal
      */
     static schemaMerge(a: Malloy.Schema, b: Malloy.Schema): Malloy.Schema;
+    static tagFor(a: Malloy.FieldInfo, prefix?: string): Tag;
+    static fieldWasCalculation(a: Malloy.FieldInfo): boolean;
 }
 declare abstract class ASTListNode<T, N extends ASTNode<T> = ASTNode<T>> extends ASTNode<T[]> {
     protected node: T[];
@@ -322,7 +155,7 @@ declare abstract class ASTListNode<T, N extends ASTNode<T> = ASTNode<T>> extends
     /**
      * @internal
      */
-    find(path: Path): ASTAny;
+    findAny(path: Path): ASTAny;
     /**
      * @internal
      */
@@ -343,7 +176,7 @@ declare abstract class ASTObjectNode<T, Children extends ASTChildren<T>> extends
     /**
      * @internal
      */
-    find(path: Path): ASTAny;
+    findAny(path: Path): ASTAny;
 }
 /**
  * AST Object to represent the whole query AST.
@@ -555,6 +388,7 @@ export declare class ASTFieldReference extends ASTReference {
      * @internal
      */
     get segment(): ASTSegmentViewDefinition;
+    private getReferenceSchema;
     getFieldInfo(): Malloy.FieldInfo;
 }
 export declare class ASTSourceReference extends ASTReference {
@@ -643,7 +477,7 @@ export declare class ASTUnimplemented<T> extends ASTNode<T> {
     constructor(node: T);
     get treeEdited(): boolean;
     build(): T;
-    find(): never;
+    findAny(): never;
 }
 export interface IASTQueryOrViewDefinition {
     /**
@@ -927,7 +761,7 @@ export declare class ASTSegmentViewDefinition extends ASTObjectNode<Malloy.ViewD
      * @param name The name of the field to order by.
      * @param direction The order by direction (ascending or descending).
      */
-    addOrderBy(name: string, direction?: Malloy.OrderByDirection): void;
+    addOrderBy(name: string, direction?: Malloy.OrderByDirection): ASTOrderByViewOperation;
     /**
      * Adds an empty nest to this segment, with the given name.
      * @param name The name of the new nest.