@malloydata/malloy 0.0.399 → 0.0.401

package/dist/lang/parse-tree-walkers/model-annotation-walker.js

@@ -37,7 +37,7 @@ class ModelAnnotationWalker {
             this.notes.push((0, parse_utils_1.noteFromAnnotation)(a, this.parseInfo));
         }
     }
-    get annotation() {
+    get annotations() {
         return { notes: this.notes };
     }
 }
@@ -45,6 +45,6 @@ function walkForModelAnnotation(forParse, tokens, parseInfo) {
     const finder = new ModelAnnotationWalker(forParse, tokens, parseInfo);
     const listener = finder;
     ParseTreeWalker_1.ParseTreeWalker.DEFAULT.walk(listener, parseInfo.root);
-    return finder.annotation;
+    return finder.annotations;
 }
 //# sourceMappingURL=model-annotation-walker.js.map

package/dist/lang/prettify/index.js

@@ -49,7 +49,7 @@
  *     of a comparison reads as one unit; breaking inside is more confusing
  *     than the line being long.
  *   - SQL strings (`"""…"""`, including `%{…}` malloy interpolations) and
- *     block annotations (`#" … "`) are emitted verbatim from source. We don't
+ *     multi-line annotations (`#" … "`) are emitted verbatim from source. We don't
  *     own a SQL formatter; annotation indentation is significant.
  *   - `;` is the compact-inline statement separator. Wrapped form drops it
  *     (newlines do the job); inline form keeps it.

package/dist/lang/prettify/leaf.js

@@ -164,8 +164,8 @@ function emitVisibleToken(f, t, idx) {
         return; // already emitted (e.g. SQL block range)
     flushHiddenBefore(f, idx);
     const text = (_a = t.text) !== null && _a !== void 0 ? _a : '';
-    // ---- Verbatim regions: SQL strings and block annotations ----
-    // We don't own a SQL formatter. Annotation indentation is significant.
+    // ---- Verbatim regions: SQL strings and multi-line annotations ----
+    // We don't own a SQL formatter. Multi-line annotation indentation is significant.
     if (t.type === tokens_1.L.SQL_BEGIN) {
         const endIdx = (0, tokens_1.findMatching)(f.tokens, idx, tokens_1.L.SQL_BEGIN, tokens_1.L.SQL_END);
         const stop = f.tokens[endIdx].stopIndex;

package/dist/lang/translate-response.d.ts

@@ -1,5 +1,5 @@
 import type * as Malloy from '@malloydata/malloy-interfaces';
-import type { Annotation, ModelDef } from '../model/malloy_types';
+import type { AnnotationsDef, ModelDef } from '../model/malloy_types';
 import type { MalloyElement } from './ast';
 import type { LogMessage } from './parse-log';
 import type { DocumentSymbol } from './parse-tree-walkers/document-symbol-walker';
@@ -55,7 +55,7 @@ interface Metadata extends ResponseBase, NeededData, ProblemResponse, FinalRespo
 }
 export type MetadataResponse = Partial<Metadata>;
 interface ModelAnnotationData extends ResponseBase, NeededData, ProblemResponse, FinalResponse {
-    modelAnnotation: Annotation;
+    modelAnnotations: AnnotationsDef;
 }
 export type ModelAnnotationResponse = Partial<ModelAnnotationData>;
 interface Completions extends ResponseBase, NeededData, ProblemResponse, FinalResponse {

package/dist/model/malloy_types.d.ts

@@ -335,7 +335,7 @@ export type Argument = Parameter;
  * shape here is the conservative "not yet narrowed" version.
  */
 export type GivenTypeDef = AtomicTypeDef | FilterExpressionParamTypeDef;
-export interface Given extends HasLocation, HasAnnotation {
+export interface Given extends HasLocation, HasAnnotations {
     /** The name as written at the declaration site. Used by diagnostics
      *  that need a readable surface name out of an opaque GivenID. */
     name: string;
@@ -396,7 +396,7 @@ export interface DocumentLocation {
  * the references, and in that case, this should include something like an
  * index or pointer to the full definition elsewhere in the model.
  */
-export interface LightweightDefinition extends HasLocation, HasAnnotation {
+export interface LightweightDefinition extends HasLocation, HasAnnotations {
     type: string;
 }
 interface DocumentReferenceBase {
@@ -436,8 +436,8 @@ export type DocumentReference = DocumentExploreReference | DocumentQueryReferenc
 export interface HasLocation {
     location?: DocumentLocation;
 }
-export interface HasAnnotation {
-    annotation?: Annotation;
+export interface HasAnnotations {
+    annotations?: AnnotationsDef;
 }
 /** All names have their source names and how they will appear in the symbol table that owns them */
 export interface AliasedName {
@@ -497,7 +497,7 @@ export declare function canOrderBy(s: string): boolean;
  * value could be an expression, and this is one of the objects
  * which might have an annotation.
  */
-export interface FieldBase extends NamedObject, Expression, ResultMetadata, HasAnnotation {
+export interface FieldBase extends NamedObject, Expression, ResultMetadata, HasAnnotations {
     accessModifier?: NonDefaultAccessModifierLabel | undefined;
     requiresGroupBy?: RequiredGroupBy[];
     ungroupings?: AggregateUngrouping[];
@@ -656,15 +656,15 @@ export interface Filtered {
 export interface TurtleSegment extends Filtered {
     name: string;
 }
-export interface Pipeline {
+export interface Pipeline extends HasAnnotations, HasLocation {
     pipeline: PipeSegment[];
 }
-export interface Query extends Pipeline, Filtered, HasLocation, HasAnnotation {
+export interface Query extends Pipeline, Filtered {
     type?: 'query';
     name?: string;
     structRef: StructRef;
     sourceArguments?: SafeRecord<Argument>;
-    modelAnnotation?: Annotation;
+    modelAnnotations?: AnnotationsDef;
     compositeResolvedSourceDef?: SourceDef;
     givenUsage?: GivenUsage;
 }
@@ -822,7 +822,7 @@ export interface QuerySegment extends Filtered, Ordered, SegmentUsageSummary {
 }
 export type NonDefaultAccessModifierLabel = 'private' | 'internal';
 export type AccessModifierLabel = NonDefaultAccessModifierLabel | 'public';
-export interface TurtleDef extends NamedObject, Pipeline, HasAnnotation {
+export interface TurtleDef extends NamedObject, Pipeline {
     type: 'turtle';
     accessModifier?: NonDefaultAccessModifierLabel | undefined;
     refSummary?: RefSummary;
@@ -830,9 +830,9 @@ export interface TurtleDef extends NamedObject, Pipeline, HasAnnotation {
 }
 export interface TurtleDefPlusFilters extends TurtleDef, Filtered {
 }
-interface StructDefBase extends HasLocation, NamedObject, HasAnnotation {
+interface StructDefBase extends HasLocation, NamedObject, HasAnnotations {
     type: string;
-    modelAnnotation?: ModelAnnotation;
+    modelAnnotations?: ModelAnnotationsDef;
     fields: FieldDef[];
     /** Marker for error placeholder structs created by ErrorFactory */
     errorFactory?: boolean;
@@ -1084,7 +1084,7 @@ export type AtomicFieldDef = BasicAtomicDef | BasicArrayDef | RecordDef | Repeat
 export declare function isBasicAtomic(fd: FieldDef | QueryFieldDef | AtomicTypeDef): fd is BasicAtomicDef;
 export type FieldDef = BasicAtomicDef | JoinFieldDef | TurtleDef;
 export type FieldDefType = AtomicFieldType | 'turtle' | JoinElementType;
-export interface RefToField extends HasAnnotation {
+export interface RefToField extends HasAnnotations {
     type: 'fieldref';
     path: string[];
     at?: DocumentLocation;
@@ -1094,11 +1094,11 @@ export type QueryFieldDef = AtomicFieldDef | TurtleDef | RefToField;
 export type TypedDef = AtomicTypeDef | JoinFieldDef | TurtleDef | RefToField | StructDef;
 /** Get the output name for a NamedObject */
 export declare function getIdentifier(n: AliasedName): string;
-export interface UserTypeFieldDef extends HasAnnotation {
+export interface UserTypeFieldDef extends HasAnnotations {
     name: string;
     typeDef: AtomicTypeDef;
 }
-export interface UserTypeDef extends NamedObject, HasAnnotation {
+export interface UserTypeDef extends NamedObject, HasAnnotations {
     type: 'userType';
     fields: UserTypeFieldDef[];
 }
@@ -1120,7 +1120,7 @@ export interface ModelDef {
      */
     sourceRegistry: Record<SourceID, SourceRegistryValue>;
     givens?: Record<GivenID, Given>;
-    annotation?: ModelAnnotation;
+    annotations?: ModelAnnotationsDef;
     queryList: Query[];
     dependencies: DependencyTree;
     references?: DocumentReference[];
@@ -1129,9 +1129,11 @@ export interface ModelDef {
 /** Very common record type */
 export type NamedSourceDefs = SafeRecord<SourceDef>;
 export type NamedModelObjects = SafeRecord<NamedModelObject>;
-/** Malloy source annotations attached to objects */
-export interface Annotation {
-    inherits?: Annotation;
+/** Bundle of source annotations attached to one object: the `notes` and
+ *  `blockNotes` written on it, plus the bundle from the spiritual parent
+ *  via `inherits`. The IR shape paired with the `Annotations` view class. */
+export interface AnnotationsDef {
+    inherits?: AnnotationsDef;
     blockNotes?: Note[];
     notes?: Note[];
 }
@@ -1139,15 +1141,17 @@ export interface Note {
     text: string;
     at: DocumentLocation;
     /**
-     * For block annotations: characters of leading whitespace removed from each
-     * body line by the dedent pass. Used to map payload-parser error columns
-     * back to source (`source_col = indentStripped + parser_col` for body lines).
-     * Omitted for single-line notes and blocks with no common indent.
+     * For multi-line annotations (`#|`…`|#`): characters of leading whitespace
+     * removed from each body line by the dedent pass. Used to map
+     * payload-parser error columns back to source
+     * (`source_col = indentStripped + parser_col` for body lines). Omitted for
+     * single-line annotations and for multi-line annotations with no common
+     * indent.
      */
     indentStripped?: number;
 }
-/** Annotations with a uuid to make it easier to stream */
-export interface ModelAnnotation extends Annotation {
+/** Annotations bundle with a uuid to make it easier to stream. */
+export interface ModelAnnotationsDef extends AnnotationsDef {
     id: string;
 }
 export type QueryScalar = string | boolean | number | bigint | Date | Buffer | null;
@@ -1177,7 +1181,7 @@ export interface DrillSource {
     sourceFilters?: FilterCondition[];
     sourceArguments?: SafeRecord<Argument>;
 }
-export interface CompiledQuery extends DrillSource, HasAnnotation {
+export interface CompiledQuery extends DrillSource, HasAnnotations {
     structs: SourceDef[];
     sql: string;
     lastStageName: string;

package/dist/model/persist_utils.js

@@ -9,7 +9,7 @@ exports.findPersistentDependencies = findPersistentDependencies;
 exports.minimalBuildGraph = minimalBuildGraph;
 const malloy_types_1 = require("./malloy_types");
 const source_def_utils_1 = require("./source_def_utils");
-const annotation_1 = require("../annotation");
+const annotation_1 = require("../api/foundation/annotation");
 /**
  * Resolve a source name to its definition from model contents.
  */
@@ -22,9 +22,9 @@ function resolveSource(modelDef, name) {
  * Returns both the persist flag and any tag parse errors.
  */
 function checkPersistAnnotation(source) {
-    if (!source.annotation)
+    if (!source.annotations)
         return { persist: false, log: [] };
-    const { tag, log } = new annotation_1.Annotations(source.annotation).parseAsTag('@');
+    const { tag, log } = new annotation_1.Annotations(source.annotations).parseAsTag('@');
     return { persist: tag.has('persist'), log };
 }
 /**

package/dist/model/query_model_impl.js

@@ -176,7 +176,7 @@ class QueryModelImpl {
             sourceArguments,
             queryName: query.name,
             connectionName: ret.connectionName,
-            annotation: query.annotation,
+            annotations: query.annotations,
             queryTimezone: ret.structs[0].queryTimezone,
             defaultRowLimitAdded: addedDefaultRowLimit,
         };

package/dist/model/query_node.js

@@ -14,7 +14,7 @@ exports.isBasicScalar = isBasicScalar;
 const uuid_1 = require("uuid");
 const malloy_compile_error_1 = require("./malloy_compile_error");
 const malloy_types_1 = require("./malloy_types");
-const annotation_1 = require("../annotation");
+const annotation_1 = require("../api/foundation/annotation");
 const dialect_1 = require("../dialect");
 const utils_1 = require("./utils");
 class QueryNode {
@@ -205,7 +205,7 @@ class QueryStruct {
     }
     modelCompilerFlags() {
         if (this._modelTag === undefined) {
-            const annotation = this.structDef.modelAnnotation;
+            const annotation = this.structDef.modelAnnotations;
             const { tag } = new annotation_1.Annotations(annotation).parseAsTag('!');
             this._modelTag = tag;
         }
@@ -561,20 +561,20 @@ class QueryStruct {
         return field;
     }
     getQueryFieldReference(f) {
-        const { path, annotation, drillExpression } = f;
+        const { path, annotations, drillExpression } = f;
         const field = this.getFieldByName(path, f.at);
-        if (annotation || drillExpression) {
+        if (annotations || drillExpression) {
             if (field.parent === undefined) {
                 throw new Error('Inconcievable, field reference to orphaned query field');
             }
             // Made a field object from the source, but the annotations were computed by the compiler
             // when it generated the reference, and has both the source and reference annotations included.
             if (field instanceof QueryFieldStruct) {
-                const newDef = { ...field.fieldDef, annotation, drillExpression };
+                const newDef = { ...field.fieldDef, annotations, drillExpression };
                 return new QueryFieldStruct(newDef, undefined, field.parent, field.parent.prepareResultOptions, field.referenceId);
             }
             else {
-                const newDef = { ...field.fieldDef, annotation, drillExpression };
+                const newDef = { ...field.fieldDef, annotations, drillExpression };
                 return field.parent.makeQueryField(newDef, field.referenceId);
             }
         }
@@ -619,7 +619,7 @@ class QueryStruct {
     }
     applyStructFiltersToTurtleDef(turtleDef) {
         const pipeline = [...turtleDef.pipeline];
-        const annotation = turtleDef.annotation;
+        const annotations = turtleDef.annotations;
         const addedFilters = turtleDef.filterList || [];
         pipeline[0] = {
             ...pipeline[0],
@@ -629,7 +629,7 @@ class QueryStruct {
             type: 'turtle',
             name: turtleDef.name,
             pipeline,
-            annotation,
+            annotations,
             location: turtleDef.location,
         };
         return flatTurtleDef;

package/dist/model/query_query.js

@@ -403,9 +403,9 @@ class QueryQuery extends query_node_1.QueryField {
                         join: 'many',
                         name,
                         fields: structDef.fields,
-                        ...(structDef.annotation && { annotation: structDef.annotation }),
-                        ...(structDef.modelAnnotation && {
-                            modelAnnotation: structDef.modelAnnotation,
+                        ...(structDef.annotations && { annotations: structDef.annotations }),
+                        ...(structDef.modelAnnotations && {
+                            modelAnnotations: structDef.modelAnnotations,
                         }),
                         resultMetadata,
                         ...(queryTimezone && { queryTimezone }),
@@ -418,9 +418,9 @@ class QueryQuery extends query_node_1.QueryField {
                         join: 'one',
                         name,
                         fields: structDef.fields,
-                        ...(structDef.annotation && { annotation: structDef.annotation }),
-                        ...(structDef.modelAnnotation && {
-                            modelAnnotation: structDef.modelAnnotation,
+                        ...(structDef.annotations && { annotations: structDef.annotations }),
+                        ...(structDef.modelAnnotations && {
+                            modelAnnotations: structDef.modelAnnotations,
                         }),
                         resultMetadata,
                         ...(queryTimezone && { queryTimezone }),
@@ -451,11 +451,11 @@ class QueryQuery extends query_node_1.QueryField {
                         delete fOut.expressionType;
                     }
                     const location = fOut.location;
-                    const annotation = fOut.annotation;
+                    const annotations = fOut.annotations;
                     const common = {
                         resultMetadata,
                         location,
-                        annotation,
+                        annotations,
                     };
                     // build out the result fields...
                     switch (fOut.type) {
@@ -513,8 +513,8 @@ class QueryQuery extends query_node_1.QueryField {
             resultMetadata: this.getResultMetadata(this.rootResult),
             queryTimezone: resultStruct.getQueryInfo().queryTimezone,
         };
-        if (this.parent.structDef.modelAnnotation) {
-            outputStruct.modelAnnotation = this.parent.structDef.modelAnnotation;
+        if (this.parent.structDef.modelAnnotations) {
+            outputStruct.modelAnnotations = this.parent.structDef.modelAnnotations;
         }
         return outputStruct;
     }
@@ -1546,7 +1546,7 @@ class QueryQuery extends query_node_1.QueryField {
             // console.log(stageWriter.generateSQLStages());
             structDef = pipeOut.outputStruct;
         }
-        structDef.annotation = fi.turtleDef.annotation;
+        structDef.annotations = fi.turtleDef.annotations;
         return {
             structDef,
             pipeOut,
@@ -1821,8 +1821,8 @@ class QueryQueryIndex extends QueryQuery {
             ],
             connection: this.parent.connectionName,
         };
-        if (this.parent.structDef.modelAnnotation) {
-            ret.modelAnnotation = this.parent.structDef.modelAnnotation;
+        if (this.parent.structDef.modelAnnotations) {
+            ret.modelAnnotations = this.parent.structDef.modelAnnotations;
         }
         return ret;
     }

package/dist/model/source_def_utils.js

@@ -44,8 +44,8 @@ function mkQuerySourceDef(base, query, name) {
         // HasLocation
         location: base.location,
         // StructDefBase
-        annotation: base.annotation,
-        modelAnnotation: base.modelAnnotation,
+        annotations: base.annotations,
+        modelAnnotations: base.modelAnnotations,
         fields: base.fields,
         // Filtered
         filterList: base.filterList,
@@ -83,8 +83,8 @@ function mkSQLSourceDef(base, selectStr, selectSegments) {
         // HasLocation
         location: base.location,
         // StructDefBase
-        annotation: base.annotation,
-        modelAnnotation: base.modelAnnotation,
+        annotations: base.annotations,
+        modelAnnotations: base.modelAnnotations,
         fields: base.fields,
         // Filtered
         filterList: base.filterList,

package/dist/run_sql_options.d.ts

@@ -1,16 +1,10 @@
-import type { Annotation, NamedObject, SourceComponentInfo } from './model/malloy_types';
-type SourceRefWithMetadata = NamedObject & {
-    annotation?: Annotation;
-    sourceComponentInfos?: SourceComponentInfo[];
-};
+import type { AnnotationsDef } from './model/malloy_types';
 export interface RunSQLOptions {
     rowLimit?: number;
     abortSignal?: AbortSignal;
-    modelAnnotation?: Annotation;
-    queryAnnotation?: Annotation;
-    clientMetadata?: {
-        sourceRefWithMetadata?: SourceRefWithMetadata;
-    };
+    /** Model annotations forwarded to the adapter (e.g. `##!` dialect flags). */
+    modelAnnotations?: AnnotationsDef;
+    /** Query annotations forwarded to the adapter. */
+    queryAnnotations?: AnnotationsDef;
 }
 export type QueryOptionsReader = RunSQLOptions | (() => RunSQLOptions);
-export {};

package/dist/to_stable.d.ts

@@ -1,5 +1,5 @@
 import * as Malloy from '@malloydata/malloy-interfaces';
-import type { Annotation, FieldDef, ModelDef, ResultStructMetadataDef, SourceDef } from './model';
+import type { AnnotationsDef, FieldDef, ModelDef, ResultStructMetadataDef, SourceDef } from './model';
 import { Tag } from '@malloydata/malloy-tag';
 export declare function sourceDefToSourceInfo(sourceDef: SourceDef): Malloy.SourceInfo;
 export declare function modelDefToModelInfo(modelDef: ModelDef): Malloy.ModelInfo;
@@ -8,7 +8,7 @@ export declare function modelDefToModelInfo(modelDef: ModelDef): Malloy.ModelInf
  * and the api surfaces. The stable shape carries the raw annotation strings;
  * routes are derivable at the consumer via `parsePrefix` (`./prefix.ts`).
  */
-export declare function toStableAnnotations(annot: Annotation | undefined): Malloy.Annotation[];
+export declare function toStableAnnotations(annot: AnnotationsDef | undefined): Malloy.Annotation[];
 export declare function convertFieldInfos(source: SourceDef, fields: FieldDef[]): Malloy.FieldInfo[];
 export declare function writeLiteralToTag(tag: Tag, path: (string | number)[], literal: Malloy.LiteralValue): void;
 export declare function getResultStructMetadataAnnotation(field: SourceDef, resultMetadata: ResultStructMetadataDef): Malloy.Annotation | undefined;

package/dist/to_stable.js

@@ -47,7 +47,7 @@ exports.writeLiteralToTag = writeLiteralToTag;
 exports.getResultStructMetadataAnnotation = getResultStructMetadataAnnotation;
 const Malloy = __importStar(require("@malloydata/malloy-interfaces"));
 const model_1 = require("./model");
-const annotation_1 = require("./annotation");
+const annotation_1 = require("./api/foundation/annotation");
 const malloy_tag_1 = require("@malloydata/malloy-tag");
 function sourceDefToSourceInfo(sourceDef) {
     var _a;
@@ -78,7 +78,7 @@ function sourceDefToSourceInfo(sourceDef) {
             fields: convertFieldInfos(sourceDef, sourceDef.fields),
         },
         parameters,
-        annotations: toStableAnnotations(sourceDef.annotation),
+        annotations: toStableAnnotations(sourceDef.annotations),
     };
     return sourceInfo;
 }
@@ -99,7 +99,7 @@ function modelDefToModelInfo(modelDef) {
         }
         else if (entry.type === 'query') {
             const outputStruct = (0, model_1.getResultStructDefForQuery)(modelDef, entry);
-            const annotations = toStableAnnotations(entry.annotation);
+            const annotations = toStableAnnotations(entry.annotations);
             const resultMetadataAnnotation = outputStruct.resultMetadata
                 ? getResultStructMetadataAnnotation(outputStruct, outputStruct.resultMetadata)
                 : undefined;
@@ -120,7 +120,7 @@ function modelDefToModelInfo(modelDef) {
     }
     for (const query of modelDef.queryList) {
         const outputStruct = (0, model_1.getResultStructDefForQuery)(modelDef, query);
-        const annotations = toStableAnnotations(query.annotation);
+        const annotations = toStableAnnotations(query.annotations);
         const resultMetadataAnnotation = outputStruct.resultMetadata
             ? getResultStructMetadataAnnotation(outputStruct, outputStruct.resultMetadata)
             : undefined;
@@ -189,7 +189,7 @@ function convertFieldInfos(source, fields) {
         const isPublic = field.accessModifier === undefined;
         if (!isPublic)
             continue;
-        const rawAnnotations = toStableAnnotations(field.annotation);
+        const rawAnnotations = toStableAnnotations(field.annotations);
         const annotations = rawAnnotations.length > 0 ? rawAnnotations : undefined;
         if ((0, model_1.isTurtle)(field)) {
             const outputStruct = (0, model_1.getResultStructDefForView)(source, field);
@@ -451,8 +451,8 @@ function convertRecordType(field) {
                     }
                 }
             }
-            if (f.annotation) {
-                annotations.push(...toStableAnnotations(f.annotation));
+            if (f.annotations) {
+                annotations.push(...toStableAnnotations(f.annotations));
             }
             if ((0, model_1.isAtomic)(f)) {
                 return {

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const MALLOY_VERSION = "0.0.399";
+export declare const MALLOY_VERSION = "0.0.401";

package/dist/version.js

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MALLOY_VERSION = void 0;
 // generated with 'generate-version-file' script; do not edit manually
-exports.MALLOY_VERSION = '0.0.399';
+exports.MALLOY_VERSION = '0.0.401';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@malloydata/malloy",
-  "version": "0.0.399",
+  "version": "0.0.401",
   "license": "MIT",
   "exports": {
     ".": "./dist/index.js",
@@ -51,9 +51,9 @@
     "generate-version-file": "VERSION=$(npm pkg get version --workspaces=false | tr -d \\\")\necho \"// generated with 'generate-version-file' script; do not edit manually\\nexport const MALLOY_VERSION = '$VERSION';\" > src/version.ts"
   },
   "dependencies": {
-    "@malloydata/malloy-filter": "0.0.399",
-    "@malloydata/malloy-interfaces": "0.0.399",
-    "@malloydata/malloy-tag": "0.0.399",
+    "@malloydata/malloy-filter": "0.0.401",
+    "@malloydata/malloy-interfaces": "0.0.401",
+    "@malloydata/malloy-tag": "0.0.401",
     "@noble/hashes": "^1.8.0",
     "antlr4ts": "^0.5.0-alpha.4",
     "assert": "^2.0.0",

package/dist/annotation.d.ts

@@ -1,96 +0,0 @@
-import type { Tag } from '@malloydata/malloy-tag';
-import type { Annotation, DocumentLocation } from './model';
-import type { LogMessage } from './lang';
-/**
- * @deprecated Argument shape for the deprecated RegExp form of
- * {@link annotationToTag}. The RegExp form cannot see block annotations
- * (`#|`…`|#`). Pass a route string to `annotationToTag` instead, or use the
- * {@link Annotations} view on a tagged entity.
- */
-export interface TagParseSpec {
-    prefix?: RegExp;
-}
-/** One annotation, unparsed — its raw text and where its content begins. */
-export interface AnnotationText {
-    /** The annotation exactly as written — prefix + content. */
-    rawText: string;
-    /** Offset where the content begins; `rawText.slice(contentIndex)` is the content. */
-    contentIndex: number;
-    /** Where `rawText` begins in the source document. */
-    at: DocumentLocation;
-    /**
-     * For block annotations: characters of leading whitespace removed from
-     * each body line by the translator's dedent pass. A BYO parser that wants
-     * source-mapped error columns adds this to the parser's reported column for
-     * body lines (`source_col = indentStripped + parser_col`).
-     */
-    indentStripped?: number;
-}
-/** An {@link AnnotationText} that also carries its route (`''` is MOTLY). */
-export interface RoutedAnnotation extends AnnotationText {
-    route: string;
-}
-/**
- * Collect annotations, using the shared prefix parser.
- * - no `route`: every annotation, each carrying its own `route` (the only way
- *   to reach one whose prefix is malformed).
- * - a `route`: only annotations on that route, `route` omitted from each result
- *   (you passed it); malformed prefixes excluded.
- */
-export declare function collectAnnotations(annote: Annotation | undefined): RoutedAnnotation[];
-export declare function collectAnnotations(annote: Annotation | undefined, route: string): AnnotationText[];
-/**
- * @deprecated The RegExp form cannot see block annotations (`#|`…`|#`). Use
- * `new Annotations(annote).texts(route)` instead, or the {@link Annotations}
- * view on a tagged entity (`entity.annotations.texts(route)`).
- */
-export declare function annotationToTaglines(annote: Annotation | undefined, prefix?: RegExp): string[];
-export interface MalloyTagParse {
-    tag: Tag;
-    log: LogMessage[];
-}
-/** Parse the annotations on `route` (default `''`, the MOTLY tag route) as MOTLY. */
-export declare function annotationToTag(annote: Annotation | undefined, route?: string): MalloyTagParse;
-/**
- * @deprecated The RegExp `prefix` form cannot see block annotations
- * (`#|`…`|#`) and cannot report content offsets for error mapping. Pass a route
- * string (the other overload), or use {@link Annotations.parseAsTag} on a
- * tagged entity.
- */
-export declare function annotationToTag(annote: Annotation | undefined, spec?: TagParseSpec): MalloyTagParse;
-/**
- * The route-aware annotation API for a tagged entity.
- *
- * An annotation has a *prefix* (everything from `#`/`##` up to the first
- * whitespace) that resolves to a *route* — a namespace key. Built-in routes:
- * `''` (MOTLY tags, the human default), `!` (compiler flags), `@` (persistence
- * directives), `"` (doc-string markdown). Apps stake their own routes with
- * brackets: `#(myApp) ...` is route `myApp`. The grammar (forms, bracket
- * pairs, malformation warnings) lives in `./prefix.ts`.
- *
- * All annotation reading lives here, written once; each tagged class only has
- * to say *where* its annotation is (by handing it to the constructor). Unlike
- * the deprecated RegExp readers (`tagParse`/`getTaglines`), this sees block
- * annotations.
- */
-export declare class Annotations {
-    private readonly annote;
-    constructor(annote: Annotation | undefined);
-    /**
-     * Raw annotation text strings (prefix + content) — all routes if `route` is
-     * omitted, just that route's otherwise. The route-based successor to the
-     * deprecated `getTaglines`. For source-mapped offsets (bring-your-own
-     * parsers), see {@link forRoute}.
-     */
-    texts(route?: string): string[];
-    /**
-     * Your route's annotations as objects (`rawText` + `contentIndex` + `at`) —
-     * the bring-your-own-parser door. A non-MOTLY app (e.g. JSON on its own
-     * route) reads these to slice the content (`rawText.slice(contentIndex)`)
-     * itself and map its parser's errors back to source via `at`. Malformed-prefix
-     * annotations are excluded.
-     */
-    forRoute(route: string): AnnotationText[];
-    /** Parse a route's annotations as a MOTLY tag. Default `''` is the tag route. */
-    parseAsTag(route?: string): MalloyTagParse;
-}