@malloydata/malloy 0.0.361 → 0.0.363

package/dist/lang/ast/source-properties/user-type-shape.js

@@ -0,0 +1,100 @@
+"use strict";
+/*
+ * Copyright Contributors to the Malloy project
+ * SPDX-License-Identifier: MIT
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserTypeShape = exports.UserTypeMemberIndirect = exports.UserTypeMemberDef = exports.UserTypeMember = void 0;
+const malloy_types_1 = require("../../../model/malloy_types");
+const malloy_element_1 = require("../types/malloy-element");
+const noteable_1 = require("../types/noteable");
+class UserTypeMember extends malloy_element_1.MalloyElement {
+    constructor(name) {
+        super();
+        this.name = name;
+        this.isNoteableObj = true;
+        this.extendNote = noteable_1.extendNoteMethod;
+    }
+}
+exports.UserTypeMember = UserTypeMember;
+class UserTypeMemberDef extends UserTypeMember {
+    constructor(name, typeDef) {
+        super(name);
+        this.typeDef = typeDef;
+        this.elementType = 'userTypeMemberDef';
+    }
+    userTypeFieldDef() {
+        const field = {
+            name: this.name,
+            typeDef: this.typeDef,
+        };
+        if (this.note) {
+            field.annotation = this.note;
+        }
+        return field;
+    }
+}
+exports.UserTypeMemberDef = UserTypeMemberDef;
+class UserTypeMemberIndirect extends UserTypeMember {
+    constructor(name, shapeName, arrayDepth = 0) {
+        super(name);
+        this.shapeName = shapeName;
+        this.arrayDepth = arrayDepth;
+        this.elementType = 'userTypeMemberIndirect';
+    }
+    userTypeFieldDef() {
+        const error = {
+            name: this.name,
+            typeDef: { type: 'error' },
+        };
+        const doc = this.document();
+        if (doc === undefined) {
+            return error;
+        }
+        const modelEntry = doc.modelEntry(this.shapeName);
+        if (modelEntry === undefined) {
+            this.logError('user-type-not-found', `User type '${this.shapeName}' is not defined`);
+            return error;
+        }
+        if (!(0, malloy_types_1.isUserTypeDef)(modelEntry.entry)) {
+            this.logError('not-a-user-type', `'${this.shapeName}' is not a user type`);
+            return error;
+        }
+        const fieldsFromReferencedType = modelEntry.entry.fields.map(f => {
+            const field = (0, malloy_types_1.mkFieldDef)(f.typeDef, f.name);
+            if (f.annotation) {
+                field.annotation = f.annotation;
+            }
+            return field;
+        });
+        let typeDef = {
+            type: 'record',
+            fields: fieldsFromReferencedType,
+        };
+        for (let i = 0; i < this.arrayDepth; i++) {
+            typeDef = (0, malloy_types_1.mkArrayTypeDef)(typeDef);
+        }
+        const field = { name: this.name, typeDef };
+        if (this.note) {
+            field.annotation = modelEntry.entry.annotation
+                ? { ...this.note, inherits: modelEntry.entry.annotation }
+                : this.note;
+        }
+        else if (modelEntry.entry.annotation) {
+            field.annotation = { inherits: modelEntry.entry.annotation };
+        }
+        return field;
+    }
+}
+exports.UserTypeMemberIndirect = UserTypeMemberIndirect;
+class UserTypeShape extends malloy_element_1.ListOf {
+    constructor() {
+        super(...arguments);
+        this.elementType = 'userTypeShape';
+    }
+    userTypeFieldDefs() {
+        return this.elements.map(member => member.userTypeFieldDef());
+    }
+}
+exports.UserTypeShape = UserTypeShape;
+//# sourceMappingURL=user-type-shape.js.map

package/dist/lang/ast/source-query-elements/sq-reference.js

@@ -86,7 +86,7 @@ class SQReference extends source_query_element_1.SourceQueryElement {
             this.asSource = new named_source_1.NamedSource(this.ref, undefined, this.args);
         }
         else {
-            this.sqLog('cannot-use-struct-as-source', `Expected '${this.ref.refString}' to be of type query or source, not '${entry.type}'`);
+            this.sqLog('cannot-use-user-type-as-source', `Expected '${this.ref.refString}' to be a query or source, not a user type`);
             return;
         }
         this.has({ asSource: this.asSource });

package/dist/lang/ast/source-query-elements/sq-typed-source.d.ts

@@ -0,0 +1,18 @@
+import { TypedSource } from '../source-elements/typed-source';
+import { SourceQueryElement } from './source-query-element';
+import type { ModelEntryReference } from '../types/malloy-element';
+/**
+ * Applies user type constraints to a source using
+ * the `::` operator.
+ *
+ * e.g. `conn.virtual('t')::MyType`
+ * e.g. `flights::(Schema1, Schema2)`
+ */
+export declare class SQTypedSource extends SourceQueryElement {
+    readonly sqSrc: SourceQueryElement;
+    readonly userTypes: ModelEntryReference[];
+    elementType: string;
+    constructor(sqSrc: SourceQueryElement, userTypes: ModelEntryReference[]);
+    getSource(): TypedSource | undefined;
+    isSource(): boolean;
+}

package/dist/lang/ast/source-query-elements/sq-typed-source.js

@@ -0,0 +1,39 @@
+"use strict";
+/*
+ * Copyright Contributors to the Malloy project
+ * SPDX-License-Identifier: MIT
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SQTypedSource = void 0;
+const typed_source_1 = require("../source-elements/typed-source");
+const source_query_element_1 = require("./source-query-element");
+/**
+ * Applies user type constraints to a source using
+ * the `::` operator.
+ *
+ * e.g. `conn.virtual('t')::MyType`
+ * e.g. `flights::(Schema1, Schema2)`
+ */
+class SQTypedSource extends source_query_element_1.SourceQueryElement {
+    constructor(sqSrc, userTypes) {
+        super({ sqSrc });
+        this.sqSrc = sqSrc;
+        this.userTypes = userTypes;
+        this.elementType = 'sq-typed-source';
+        this.has({ userTypes });
+    }
+    getSource() {
+        const src = this.sqSrc.getSource();
+        if (src) {
+            const typed = new typed_source_1.TypedSource(src, this.userTypes);
+            this.has({ typed });
+            return typed;
+        }
+        this.sqLog('failed-to-compute-source-to-type', 'Could not compute source to apply type constraints');
+    }
+    isSource() {
+        return true;
+    }
+}
+exports.SQTypedSource = SQTypedSource;
+//# sourceMappingURL=sq-typed-source.js.map

package/dist/lang/ast/statements/define-user-type.d.ts

@@ -0,0 +1,28 @@
+import type { DocStatement, Document } from '../types/malloy-element';
+import { MalloyElement, DocStatementList } from '../types/malloy-element';
+import type { Noteable } from '../types/noteable';
+import { extendNoteMethod } from '../types/noteable';
+import type { Annotation, UserTypeFieldDef } from '../../../model/malloy_types';
+import type { UserTypeMember } from '../source-properties/user-type-shape';
+import { UserTypeShape } from '../source-properties/user-type-shape';
+export declare class ExtendedUserTypeShape extends UserTypeShape {
+    readonly extendName: string;
+    type: string;
+    constructor(parts: UserTypeMember[], extendName: string);
+    userTypeFieldDefs(): UserTypeFieldDef[];
+}
+export declare class DefineUserType extends MalloyElement implements DocStatement, Noteable {
+    readonly name: string;
+    readonly shapeDef: UserTypeShape;
+    readonly exported: boolean;
+    elementType: string;
+    constructor(name: string, shapeDef: UserTypeShape, exported: boolean);
+    readonly isNoteableObj = true;
+    extendNote: typeof extendNoteMethod;
+    note?: Annotation;
+    execute(doc: Document): void;
+}
+export declare class DefineUserTypeList extends DocStatementList {
+    elementType: string;
+    constructor(userTypeList: DefineUserType[]);
+}

package/dist/lang/ast/statements/define-user-type.js

@@ -0,0 +1,82 @@
+"use strict";
+/*
+ * Copyright Contributors to the Malloy project
+ * SPDX-License-Identifier: MIT
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefineUserTypeList = exports.DefineUserType = exports.ExtendedUserTypeShape = void 0;
+const malloy_element_1 = require("../types/malloy-element");
+const noteable_1 = require("../types/noteable");
+const malloy_types_1 = require("../../../model/malloy_types");
+const user_type_shape_1 = require("../source-properties/user-type-shape");
+class ExtendedUserTypeShape extends user_type_shape_1.UserTypeShape {
+    constructor(parts, extendName) {
+        super(parts);
+        this.extendName = extendName;
+        this.type = 'extendedUserTypeShape';
+    }
+    userTypeFieldDefs() {
+        const doc = this.document();
+        const baseFields = new Map();
+        if (doc) {
+            const modelEntry = doc.modelEntry(this.extendName);
+            if (modelEntry === undefined) {
+                this.logError('user-type-not-found', `User type '${this.extendName}' is not defined`);
+            }
+            else if (!(0, malloy_types_1.isUserTypeDef)(modelEntry.entry)) {
+                this.logError('not-a-user-type', `'${this.extendName}' is not a user type`);
+            }
+            else {
+                for (const f of modelEntry.entry.fields) {
+                    baseFields.set(f.name, f);
+                }
+            }
+        }
+        for (const f of super.userTypeFieldDefs()) {
+            baseFields.set(f.name, f);
+        }
+        return [...baseFields.values()];
+    }
+}
+exports.ExtendedUserTypeShape = ExtendedUserTypeShape;
+class DefineUserType extends malloy_element_1.MalloyElement {
+    constructor(name, shapeDef, exported) {
+        super();
+        this.name = name;
+        this.shapeDef = shapeDef;
+        this.exported = exported;
+        this.elementType = 'defineUserType';
+        this.isNoteableObj = true;
+        this.extendNote = noteable_1.extendNoteMethod;
+        this.has({ shapeDef });
+    }
+    execute(doc) {
+        if (doc.modelEntry(this.name)) {
+            this.logError('user-type-definition-name-conflict', `Cannot redefine '${this.name}'`);
+            return;
+        }
+        const fields = this.shapeDef.userTypeFieldDefs();
+        if (fields === undefined) {
+            return;
+        }
+        const entry = {
+            type: 'userType',
+            name: this.name,
+            fields,
+            location: this.location,
+        };
+        if (this.note) {
+            entry.annotation = this.note;
+        }
+        doc.setEntry(this.name, { entry, exported: this.exported });
+    }
+}
+exports.DefineUserType = DefineUserType;
+class DefineUserTypeList extends malloy_element_1.DocStatementList {
+    constructor(userTypeList) {
+        super(userTypeList);
+        this.elementType = 'defineUserTypes';
+    }
+}
+exports.DefineUserTypeList = DefineUserTypeList;
+//# sourceMappingURL=define-user-type.js.map

package/dist/lang/ast/types/malloy-element.js

@@ -464,7 +464,8 @@ class Document extends MalloyElement {
                 const entry = { ...orig };
                 if ((0, malloy_types_1.isSourceDef)(entry) ||
                     entry.type === 'query' ||
-                    entry.type === 'function') {
+                    entry.type === 'function' ||
+                    entry.type === 'userType') {
                     const exported = extendingModelDef.exports.includes(nm);
                     this.setEntry(nm, { entry, exported });
                 }
@@ -518,15 +519,22 @@ class Document extends MalloyElement {
         }
         for (const [name, modelEntry] of this.documentModel) {
             const entryDef = modelEntry.entry;
-            if ((0, malloy_types_1.isSourceDef)(entryDef) || entryDef.type === 'query') {
+            if ((0, malloy_types_1.isSourceDef)(entryDef) ||
+                entryDef.type === 'query' ||
+                entryDef.type === 'userType') {
                 if (modelEntry.exported) {
                     def.exports.push(name);
                 }
-                const newEntry = { ...entryDef };
-                if (newEntry.modelAnnotation === undefined && def.annotation) {
-                    newEntry.modelAnnotation = def.annotation;
+                if (entryDef.type === 'userType') {
+                    def.contents[name] = { ...entryDef };
+                }
+                else {
+                    const newEntry = { ...entryDef };
+                    if (newEntry.modelAnnotation === undefined && def.annotation) {
+                        newEntry.modelAnnotation = def.annotation;
+                    }
+                    def.contents[name] = newEntry;
                 }
-                def.contents[name] = newEntry;
             }
         }
         // Copy the accumulated sourceRegistry

package/dist/lang/lib/Malloy/MalloyLexer.d.ts

@@ -37,150 +37,152 @@ export declare class MalloyLexer extends Lexer {
     static readonly SAMPLE = 31;
     static readonly SELECT = 32;
     static readonly SOURCE = 33;
-    static readonly TOP = 34;
-    static readonly WHERE = 35;
-    static readonly VIEW = 36;
-    static readonly TIMEZONE = 37;
-    static readonly ALL = 38;
-    static readonly AND = 39;
-    static readonly AS = 40;
-    static readonly ASC = 41;
-    static readonly AVG = 42;
-    static readonly BOOLEAN = 43;
-    static readonly BY = 44;
-    static readonly CASE = 45;
-    static readonly CAST = 46;
-    static readonly CONDITION = 47;
-    static readonly COUNT = 48;
-    static readonly COMPOSE = 49;
-    static readonly DATE = 50;
-    static readonly DAY = 51;
-    static readonly DESC = 52;
-    static readonly DISTINCT = 53;
-    static readonly ELSE = 54;
-    static readonly END = 55;
-    static readonly EXCLUDE = 56;
-    static readonly EXTEND = 57;
-    static readonly FALSE = 58;
-    static readonly FILTER = 59;
-    static readonly FULL = 60;
-    static readonly FOR = 61;
-    static readonly FROM = 62;
-    static readonly HAS = 63;
-    static readonly HOUR = 64;
-    static readonly IMPORT = 65;
-    static readonly INCLUDE = 66;
-    static readonly INNER = 67;
-    static readonly IS = 68;
-    static readonly IN = 69;
-    static readonly INTERNAL_KW = 70;
-    static readonly JSON = 71;
-    static readonly LAST = 72;
-    static readonly LEFT = 73;
-    static readonly LIKE = 74;
-    static readonly MAX = 75;
-    static readonly MIN = 76;
-    static readonly MINUTE = 77;
-    static readonly MONTH = 78;
-    static readonly NOT = 79;
-    static readonly NOW = 80;
-    static readonly NULL = 81;
-    static readonly NUMBER = 82;
-    static readonly ON = 83;
-    static readonly OR = 84;
-    static readonly PICK = 85;
-    static readonly PRIVATE_KW = 86;
-    static readonly PUBLIC_KW = 87;
-    static readonly QUARTER = 88;
-    static readonly RIGHT = 89;
-    static readonly SECOND = 90;
-    static readonly STRING = 91;
-    static readonly SOURCE_KW = 92;
-    static readonly SUM = 93;
-    static readonly SQL = 94;
-    static readonly TABLE = 95;
-    static readonly THEN = 96;
-    static readonly THIS = 97;
-    static readonly TIMESTAMPTZ = 98;
-    static readonly TIMESTAMP = 99;
-    static readonly TO = 100;
-    static readonly TRUE = 101;
-    static readonly TURTLE = 102;
-    static readonly WEEK = 103;
-    static readonly WHEN = 104;
-    static readonly WITH = 105;
-    static readonly YEAR = 106;
-    static readonly UNGROUPED = 107;
-    static readonly HACKY_REGEX = 108;
-    static readonly RAW_SQ = 109;
-    static readonly RAW_DQ = 110;
-    static readonly SQ3_FILTER = 111;
-    static readonly SQ_FILTER = 112;
-    static readonly DQ3_FILTER = 113;
-    static readonly DQ_FILTER = 114;
-    static readonly BQ3_FILTER = 115;
-    static readonly BQ_FILTER = 116;
-    static readonly SQ_STRING = 117;
-    static readonly DQ_STRING = 118;
-    static readonly BQ_STRING = 119;
-    static readonly DOC_BLOCK_ANNOTATION_BEGIN = 120;
-    static readonly BLOCK_ANNOTATION_BEGIN = 121;
-    static readonly DOC_ANNOTATION = 122;
-    static readonly ANNOTATION = 123;
-    static readonly AMPER = 124;
-    static readonly ARROW = 125;
-    static readonly FAT_ARROW = 126;
-    static readonly OPAREN = 127;
-    static readonly CPAREN = 128;
-    static readonly OBRACK = 129;
-    static readonly CBRACK = 130;
-    static readonly OCURLY = 131;
-    static readonly CCURLY = 132;
-    static readonly DOUBLECOLON = 133;
-    static readonly TRIPLECOLON = 134;
-    static readonly EXCLAM = 135;
-    static readonly COLON = 136;
-    static readonly COMMA = 137;
-    static readonly DOT = 138;
-    static readonly LT = 139;
-    static readonly GT = 140;
-    static readonly EQ = 141;
-    static readonly NE = 142;
-    static readonly LTE = 143;
-    static readonly GTE = 144;
-    static readonly PLUS = 145;
-    static readonly MINUS = 146;
-    static readonly STAR = 147;
-    static readonly STARSTAR = 148;
-    static readonly SLASH = 149;
-    static readonly BAR = 150;
-    static readonly SEMI = 151;
-    static readonly NOT_MATCH = 152;
-    static readonly MATCH = 153;
-    static readonly PERCENT = 154;
-    static readonly DOUBLE_QMARK = 155;
-    static readonly QMARK = 156;
-    static readonly LITERAL_TIMESTAMP = 157;
-    static readonly LITERAL_HOUR = 158;
-    static readonly LITERAL_DAY = 159;
-    static readonly LITERAL_QUARTER = 160;
-    static readonly LITERAL_MONTH = 161;
-    static readonly LITERAL_WEEK = 162;
-    static readonly LITERAL_YEAR = 163;
-    static readonly IDENTIFIER = 164;
-    static readonly PERCENT_LITERAL = 165;
-    static readonly NUMERIC_LITERAL = 166;
-    static readonly INTEGER_LITERAL = 167;
-    static readonly BLOCK_COMMENT = 168;
-    static readonly COMMENT_TO_EOL = 169;
-    static readonly WHITE_SPACE = 170;
-    static readonly SQL_BEGIN = 171;
-    static readonly UNWATED_CHARS_TRAILING_NUMBERS = 172;
-    static readonly UNEXPECTED_CHAR = 173;
-    static readonly OPEN_CODE = 174;
-    static readonly SQL_END = 175;
-    static readonly BLOCK_ANNOTATION_END = 176;
-    static readonly BLOCK_ANNOTATION_TEXT = 177;
+    static readonly TYPE = 34;
+    static readonly TOP = 35;
+    static readonly WHERE = 36;
+    static readonly VIEW = 37;
+    static readonly TIMEZONE = 38;
+    static readonly ALL = 39;
+    static readonly AND = 40;
+    static readonly AS = 41;
+    static readonly ASC = 42;
+    static readonly AVG = 43;
+    static readonly BOOLEAN = 44;
+    static readonly BY = 45;
+    static readonly CASE = 46;
+    static readonly CAST = 47;
+    static readonly CONDITION = 48;
+    static readonly COUNT = 49;
+    static readonly COMPOSE = 50;
+    static readonly DATE = 51;
+    static readonly DAY = 52;
+    static readonly DESC = 53;
+    static readonly DISTINCT = 54;
+    static readonly ELSE = 55;
+    static readonly END = 56;
+    static readonly EXCLUDE = 57;
+    static readonly EXTEND = 58;
+    static readonly FALSE = 59;
+    static readonly FILTER = 60;
+    static readonly FULL = 61;
+    static readonly FOR = 62;
+    static readonly FROM = 63;
+    static readonly HAS = 64;
+    static readonly HOUR = 65;
+    static readonly IMPORT = 66;
+    static readonly INCLUDE = 67;
+    static readonly INNER = 68;
+    static readonly IS = 69;
+    static readonly IN = 70;
+    static readonly INTERNAL_KW = 71;
+    static readonly JSON = 72;
+    static readonly LAST = 73;
+    static readonly LEFT = 74;
+    static readonly LIKE = 75;
+    static readonly MAX = 76;
+    static readonly MIN = 77;
+    static readonly MINUTE = 78;
+    static readonly MONTH = 79;
+    static readonly NOT = 80;
+    static readonly NOW = 81;
+    static readonly NULL = 82;
+    static readonly NUMBER = 83;
+    static readonly ON = 84;
+    static readonly OR = 85;
+    static readonly PICK = 86;
+    static readonly PRIVATE_KW = 87;
+    static readonly PUBLIC_KW = 88;
+    static readonly QUARTER = 89;
+    static readonly RIGHT = 90;
+    static readonly SECOND = 91;
+    static readonly STRING = 92;
+    static readonly SOURCE_KW = 93;
+    static readonly SUM = 94;
+    static readonly SQL = 95;
+    static readonly TABLE = 96;
+    static readonly THEN = 97;
+    static readonly THIS = 98;
+    static readonly TIMESTAMPTZ = 99;
+    static readonly TIMESTAMP = 100;
+    static readonly TO = 101;
+    static readonly TRUE = 102;
+    static readonly TURTLE = 103;
+    static readonly WEEK = 104;
+    static readonly WHEN = 105;
+    static readonly WITH = 106;
+    static readonly YEAR = 107;
+    static readonly UNGROUPED = 108;
+    static readonly VIRTUAL = 109;
+    static readonly HACKY_REGEX = 110;
+    static readonly RAW_SQ = 111;
+    static readonly RAW_DQ = 112;
+    static readonly SQ3_FILTER = 113;
+    static readonly SQ_FILTER = 114;
+    static readonly DQ3_FILTER = 115;
+    static readonly DQ_FILTER = 116;
+    static readonly BQ3_FILTER = 117;
+    static readonly BQ_FILTER = 118;
+    static readonly SQ_STRING = 119;
+    static readonly DQ_STRING = 120;
+    static readonly BQ_STRING = 121;
+    static readonly DOC_BLOCK_ANNOTATION_BEGIN = 122;
+    static readonly BLOCK_ANNOTATION_BEGIN = 123;
+    static readonly DOC_ANNOTATION = 124;
+    static readonly ANNOTATION = 125;
+    static readonly AMPER = 126;
+    static readonly ARROW = 127;
+    static readonly FAT_ARROW = 128;
+    static readonly OPAREN = 129;
+    static readonly CPAREN = 130;
+    static readonly OBRACK = 131;
+    static readonly CBRACK = 132;
+    static readonly OCURLY = 133;
+    static readonly CCURLY = 134;
+    static readonly DOUBLECOLON = 135;
+    static readonly TRIPLECOLON = 136;
+    static readonly EXCLAM = 137;
+    static readonly COLON = 138;
+    static readonly COMMA = 139;
+    static readonly DOT = 140;
+    static readonly LT = 141;
+    static readonly GT = 142;
+    static readonly EQ = 143;
+    static readonly NE = 144;
+    static readonly LTE = 145;
+    static readonly GTE = 146;
+    static readonly PLUS = 147;
+    static readonly MINUS = 148;
+    static readonly STAR = 149;
+    static readonly STARSTAR = 150;
+    static readonly SLASH = 151;
+    static readonly BAR = 152;
+    static readonly SEMI = 153;
+    static readonly NOT_MATCH = 154;
+    static readonly MATCH = 155;
+    static readonly PERCENT = 156;
+    static readonly DOUBLE_QMARK = 157;
+    static readonly QMARK = 158;
+    static readonly LITERAL_TIMESTAMP = 159;
+    static readonly LITERAL_HOUR = 160;
+    static readonly LITERAL_DAY = 161;
+    static readonly LITERAL_QUARTER = 162;
+    static readonly LITERAL_MONTH = 163;
+    static readonly LITERAL_WEEK = 164;
+    static readonly LITERAL_YEAR = 165;
+    static readonly IDENTIFIER = 166;
+    static readonly PERCENT_LITERAL = 167;
+    static readonly NUMERIC_LITERAL = 168;
+    static readonly INTEGER_LITERAL = 169;
+    static readonly BLOCK_COMMENT = 170;
+    static readonly COMMENT_TO_EOL = 171;
+    static readonly WHITE_SPACE = 172;
+    static readonly SQL_BEGIN = 173;
+    static readonly UNWATED_CHARS_TRAILING_NUMBERS = 174;
+    static readonly UNEXPECTED_CHAR = 175;
+    static readonly OPEN_CODE = 176;
+    static readonly SQL_END = 177;
+    static readonly BLOCK_ANNOTATION_END = 178;
+    static readonly BLOCK_ANNOTATION_TEXT = 179;
     static readonly SQL_MODE = 1;
     static readonly BLOCK_ANNOTATION_MODE = 2;
     static readonly channelNames: string[];