ifc-expressions 2.3.0 → 3.0.0-beta.0

package/dist/cjs/compiler/TypeManager.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/compiler/TypeManager.ts"],"names":[],"mappings":"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","file":"compiler/TypeManager.js","sourcesContent":["import { ParserRuleContext } from \"antlr4\";\nimport { Type, Types } from \"../type/Types.js\";\nimport { ExpressionTypeError } from \"../error/ExpressionTypeError.js\";\nimport { ExprType } from \"../type/ExprType.js\";\n\nexport class TypeManager {\n  private readonly types = new Map<ParserRuleContext, ExprType>();\n\n  constructor() {}\n\n  public setType(parserRuleContext: ParserRuleContext, type: ExprType) {\n    this.types.set(parserRuleContext, type);\n  }\n\n  public getType(parserRuleContext: ParserRuleContext): ExprType {\n    return this.types.get(parserRuleContext);\n  }\n\n  public copyTypeFrom(ctx: ParserRuleContext, from: ParserRuleContext) {\n    const theType = this.types.get(from as ParserRuleContext);\n    this.types.set(ctx, theType);\n  }\n\n  public requireString(ctx: ParserRuleContext) {\n    const actualType = this.types.get(ctx as ParserRuleContext);\n    Types.requireWeakIsAssignableFrom(\n      Type.STRING,\n      this.types.get(ctx as ParserRuleContext),\n      () =>\n        new ExpressionTypeError(\n          `expected type string, actual type is ${actualType.getName()}`,\n          ctx\n        )\n    );\n  }\n\n  public requireBoolean(ctx: ParserRuleContext) {\n    const actualType = this.types.get(ctx as ParserRuleContext);\n    Types.requireWeakIsAssignableFrom(\n      Type.BOOLEAN,\n      this.types.get(ctx as ParserRuleContext),\n      () =>\n        new ExpressionTypeError(\n          `expected type boolean, actual type is ${actualType.getName()}`,\n          ctx\n        )\n    );\n  }\n\n  public requireLogicalOrBoolean(ctx: ParserRuleContext) {\n    return this.requireOneOf(ctx, Type.BOOLEAN, Type.LOGICAL);\n  }\n\n  public requireOneOf(ctx: ParserRuleContext, ...types: Array<ExprType>) {\n    const requiredType = Types.or(...types);\n    const actualType = this.types.get(ctx as ParserRuleContext);\n    Types.requireWeakIsAssignableFrom(\n      requiredType,\n      this.types.get(ctx as ParserRuleContext),\n      () =>\n        new ExpressionTypeError(\n          `expected type ${requiredType}, actual type is ${actualType.getName()}`,\n          ctx\n        )\n    );\n  }\n\n  public requireNumeric(ctx: ParserRuleContext) {\n    const actualType = this.types.get(ctx as ParserRuleContext);\n    Types.requireWeakIsAssignableFrom(\n      Type.NUMERIC,\n      actualType,\n      () =>\n        new ExpressionTypeError(\n          `expected type numeric, actual type is ${actualType.getName()}`,\n          ctx\n        )\n    );\n  }\n\n  public requireTypesOverlap(ctxA: ParserRuleContext, ctxB: ParserRuleContext) {\n    Types.requireTypesOverlap(\n      this.types.get(ctxA),\n      this.types.get(ctxB),\n      () =>\n        new ExpressionTypeError(\n          `Types ${this.types.get(ctxA).getName()} and ${this.types\n            .get(ctxB)\n            .getName()} are required to overlap but they don't.`,\n          ctxA\n        )\n    );\n  }\n\n  public isType(type: ExprType, ...ctxs) {\n    return ctxs.every((ctx) => Types.isType(this.types.get(ctx), type));\n  }\n\n  public overlapsWith(type: ExprType, ...ctxs) {\n    return ctxs.every((ctx) => type.overlapsWith(this.types.get(ctx)));\n  }\n\n  public isString(...ctxs) {\n    return this.isType(Type.STRING, ...ctxs);\n  }\n\n  public overlapsWithString(...ctxs) {\n    return this.overlapsWith(Type.STRING, ...ctxs);\n  }\n\n  public isBoolean(...ctxs) {\n    return this.isType(Type.BOOLEAN, ...ctxs);\n  }\n\n  public isLogical(...ctxs) {\n    return this.isType(Type.LOGICAL, ...ctxs);\n  }\n\n  public overlapsWithBoolean(...ctxs) {\n    return this.overlapsWith(Type.BOOLEAN, ...ctxs);\n  }\n\n  public overlapsWithLogical(...ctxs) {\n    return this.overlapsWith(Type.LOGICAL, ...ctxs);\n  }\n\n  public isNumeric(...ctxs) {\n    return this.isType(Type.NUMERIC, ...ctxs);\n  }\n\n  public overlapsWithNumeric(...ctxs) {\n    return this.overlapsWith(Type.NUMERIC, ...ctxs);\n  }\n}\n"]}
+{"version":3,"sources":["../../src/compiler/TypeManager.ts"],"names":[],"mappings":"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","file":"compiler/TypeManager.js","sourcesContent":["import { ParserRuleContext } from \"antlr4ng\";\nimport { Type, Types } from \"../type/Types.js\";\nimport { ExpressionTypeError } from \"../error/ExpressionTypeError.js\";\nimport { ExprType } from \"../type/ExprType.js\";\n\nexport class TypeManager {\n  private readonly types = new Map<ParserRuleContext, ExprType>();\n\n  constructor() {}\n\n  public setType(parserRuleContext: ParserRuleContext, type: ExprType) {\n    this.types.set(parserRuleContext, type);\n  }\n\n  public getType(parserRuleContext: ParserRuleContext): ExprType {\n    return this.types.get(parserRuleContext);\n  }\n\n  public copyTypeFrom(ctx: ParserRuleContext, from: ParserRuleContext) {\n    const theType = this.types.get(from as ParserRuleContext);\n    this.types.set(ctx, theType);\n  }\n\n  public requireString(ctx: ParserRuleContext) {\n    const actualType = this.types.get(ctx as ParserRuleContext);\n    Types.requireWeakIsAssignableFrom(\n      Type.STRING,\n      this.types.get(ctx as ParserRuleContext),\n      () =>\n        new ExpressionTypeError(\n          `expected type string, actual type is ${actualType.getName()}`,\n          ctx\n        )\n    );\n  }\n\n  public requireBoolean(ctx: ParserRuleContext) {\n    const actualType = this.types.get(ctx as ParserRuleContext);\n    Types.requireWeakIsAssignableFrom(\n      Type.BOOLEAN,\n      this.types.get(ctx as ParserRuleContext),\n      () =>\n        new ExpressionTypeError(\n          `expected type boolean, actual type is ${actualType.getName()}`,\n          ctx\n        )\n    );\n  }\n\n  public requireLogicalOrBoolean(ctx: ParserRuleContext) {\n    return this.requireOneOf(ctx, Type.BOOLEAN, Type.LOGICAL);\n  }\n\n  public requireOneOf(ctx: ParserRuleContext, ...types: Array<ExprType>) {\n    const requiredType = Types.or(...types);\n    const actualType = this.types.get(ctx as ParserRuleContext);\n    Types.requireWeakIsAssignableFrom(\n      requiredType,\n      this.types.get(ctx as ParserRuleContext),\n      () =>\n        new ExpressionTypeError(\n          `expected type ${requiredType}, actual type is ${actualType.getName()}`,\n          ctx\n        )\n    );\n  }\n\n  public requireNumeric(ctx: ParserRuleContext) {\n    const actualType = this.types.get(ctx as ParserRuleContext);\n    Types.requireWeakIsAssignableFrom(\n      Type.NUMERIC,\n      actualType,\n      () =>\n        new ExpressionTypeError(\n          `expected type numeric, actual type is ${actualType.getName()}`,\n          ctx\n        )\n    );\n  }\n\n  public requireTypesOverlap(ctxA: ParserRuleContext, ctxB: ParserRuleContext) {\n    Types.requireTypesOverlap(\n      this.types.get(ctxA),\n      this.types.get(ctxB),\n      () =>\n        new ExpressionTypeError(\n          `Types ${this.types.get(ctxA).getName()} and ${this.types\n            .get(ctxB)\n            .getName()} are required to overlap but they don't.`,\n          ctxA\n        )\n    );\n  }\n\n  public isType(type: ExprType, ...ctxs) {\n    return ctxs.every((ctx) => Types.isType(this.types.get(ctx), type));\n  }\n\n  public overlapsWith(type: ExprType, ...ctxs) {\n    return ctxs.every((ctx) => type.overlapsWith(this.types.get(ctx)));\n  }\n\n  public isString(...ctxs) {\n    return this.isType(Type.STRING, ...ctxs);\n  }\n\n  public overlapsWithString(...ctxs) {\n    return this.overlapsWith(Type.STRING, ...ctxs);\n  }\n\n  public isBoolean(...ctxs) {\n    return this.isType(Type.BOOLEAN, ...ctxs);\n  }\n\n  public isLogical(...ctxs) {\n    return this.isType(Type.LOGICAL, ...ctxs);\n  }\n\n  public overlapsWithBoolean(...ctxs) {\n    return this.overlapsWith(Type.BOOLEAN, ...ctxs);\n  }\n\n  public overlapsWithLogical(...ctxs) {\n    return this.overlapsWith(Type.LOGICAL, ...ctxs);\n  }\n\n  public isNumeric(...ctxs) {\n    return this.isType(Type.NUMERIC, ...ctxs);\n  }\n\n  public overlapsWithNumeric(...ctxs) {\n    return this.overlapsWith(Type.NUMERIC, ...ctxs);\n  }\n}\n"]}

package/dist/cjs/context/IfcExpressionContext.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/context/IfcExpressionContext.ts"],"names":[],"mappings":"","file":"context/IfcExpressionContext.js","sourcesContent":["import { IfcPropertyAccessor } from \"./IfcPropertyAccessor.js\";\nimport { IfcElementAccessor } from \"./IfcElementAccessor.js\";\n\nexport interface IfcExpressionContext {\n  resolvePropRef(): IfcPropertyAccessor;\n\n  resolveElemRef(): IfcElementAccessor;\n}\n"]}
+{"version":3,"sources":["../../src/context/IfcExpressionContext.ts"],"names":[],"mappings":"","file":"context/IfcExpressionContext.js","sourcesContent":["import { ExprType } from \"../type/ExprType.js\";\n\nexport interface IfcExpressionContext {\n  resolvePropRef();\n\n  resolveElemRef();\n\n  resolveBuiltinVariable(name: string): unknown;\n}\n"]}

package/dist/cjs/context/NopContext.js

@@ -8,6 +8,9 @@ class NopContext {
     resolvePropRef() {
         throw new Error("No IfcExpressionContext implementation provided - cannot resolve property reference");
     }
+    resolveBuiltinVariable(name) {
+        throw new Error(`No IfcExpressionContext implementation provided - cannot resolve builtin variable '${name}'`);
+    }
 }
 exports.NopContext = NopContext;
 //# sourceMappingURL=NopContext.js.map

package/dist/cjs/context/NopContext.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/context/NopContext.ts"],"names":[],"mappings":";;;AAMA,MAAa,UAAU;IACrB,cAAc;QACZ,MAAM,IAAI,KAAK,CACb,oFAAoF,CACrF,CAAC;IACJ,CAAC;IAED,cAAc;QACZ,MAAM,IAAI,KAAK,CACb,qFAAqF,CACtF,CAAC;IACJ,CAAC;CACF;AAZD,gCAYC","file":"context/NopContext.js","sourcesContent":["import {\n  IfcElementAccessor,\n  IfcExpressionContext,\n  IfcPropertyAccessor,\n} from \"../IfcExpression.js\";\n\nexport class NopContext implements IfcExpressionContext {\n  resolveElemRef(): IfcElementAccessor {\n    throw new Error(\n      \"No IfcExpressionContext implementation provided - cannot resolve element reference\"\n    );\n  }\n\n  resolvePropRef(): IfcPropertyAccessor {\n    throw new Error(\n      \"No IfcExpressionContext implementation provided - cannot resolve property reference\"\n    );\n  }\n}\n"]}
+{"version":3,"sources":["../../src/context/NopContext.ts"],"names":[],"mappings":";;;AAMA,MAAa,UAAU;IACrB,cAAc;QACZ,MAAM,IAAI,KAAK,CACb,oFAAoF,CACrF,CAAC;IACJ,CAAC;IAED,cAAc;QACZ,MAAM,IAAI,KAAK,CACb,qFAAqF,CACtF,CAAC;IACJ,CAAC;IAED,sBAAsB,CAAC,IAAY;QACjC,MAAM,IAAI,KAAK,CACb,sFAAsF,IAAI,GAAG,CAC9F,CAAC;IACJ,CAAC;CACF;AAlBD,gCAkBC","file":"context/NopContext.js","sourcesContent":["import {\n  IfcElementAccessor,\n  IfcExpressionContext,\n  IfcPropertyAccessor,\n} from \"../IfcExpression.js\";\n\nexport class NopContext implements IfcExpressionContext {\n  resolveElemRef(): IfcElementAccessor {\n    throw new Error(\n      \"No IfcExpressionContext implementation provided - cannot resolve element reference\"\n    );\n  }\n\n  resolvePropRef(): IfcPropertyAccessor {\n    throw new Error(\n      \"No IfcExpressionContext implementation provided - cannot resolve property reference\"\n    );\n  }\n\n  resolveBuiltinVariable(name: string): unknown {\n    throw new Error(\n      `No IfcExpressionContext implementation provided - cannot resolve builtin variable '${name}'`\n    );\n  }\n}\n"]}

package/dist/cjs/documentation/Documentation.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveLocalizedText = void 0;
+function resolveLocalizedText(text, localizer) {
+    if (!text) {
+        return undefined;
+    }
+    return localizer ? localizer.t(text.key, text.fallback) : text.fallback;
+}
+exports.resolveLocalizedText = resolveLocalizedText;
+//# sourceMappingURL=Documentation.js.map

package/dist/cjs/documentation/Documentation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/documentation/Documentation.ts"],"names":[],"mappings":";;;AAcA,SAAgB,oBAAoB,CAClC,IAA+B,EAC/B,SAAkC;IAElC,IAAI,CAAC,IAAI,EAAE;QACT,OAAO,SAAS,CAAC;KAClB;IAED,OAAO,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;AAC1E,CAAC;AATD,oDASC","file":"documentation/Documentation.js","sourcesContent":["export type LocalizedText = {\n  key: string;\n  fallback: string;\n};\n\nexport type DocumentationLocalizer = {\n  t(key: string, fallback: string): string;\n};\n\nexport type ArgumentDocumentation = {\n  label: LocalizedText;\n  documentation: LocalizedText;\n};\n\nexport function resolveLocalizedText(\n  text: LocalizedText | undefined,\n  localizer?: DocumentationLocalizer\n): string | undefined {\n  if (!text) {\n    return undefined;\n  }\n\n  return localizer ? localizer.t(text.key, text.fallback) : text.fallback;\n}\n"]}

package/dist/cjs/error/ExpressionTypeError.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/error/ExpressionTypeError.ts"],"names":[],"mappings":";;;AACA,qEAA+D;AAE/D,MAAa,mBAAoB,SAAQ,4CAAmB;IAC1D,YAAY,OAAe,EAAE,GAAsB;QACjD,KAAK,CAAC,eAAe,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;IACvC,CAAC;CACF;AAJD,kDAIC","file":"error/ExpressionTypeError.js","sourcesContent":["import { ParserRuleContext } from \"antlr4\";\nimport { ValidationException } from \"./ValidationException.js\";\n\nexport class ExpressionTypeError extends ValidationException {\n  constructor(message: string, ctx: ParserRuleContext) {\n    super(`Type error: ${message}`, ctx);\n  }\n}\n"]}
+{"version":3,"sources":["../../src/error/ExpressionTypeError.ts"],"names":[],"mappings":";;;AACA,qEAA+D;AAE/D,MAAa,mBAAoB,SAAQ,4CAAmB;IAC1D,YAAY,OAAe,EAAE,GAAsB;QACjD,KAAK,CAAC,eAAe,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;IACvC,CAAC;CACF;AAJD,kDAIC","file":"error/ExpressionTypeError.js","sourcesContent":["import { ParserRuleContext } from \"antlr4ng\";\nimport { ValidationException } from \"./ValidationException.js\";\n\nexport class ExpressionTypeError extends ValidationException {\n  constructor(message: string, ctx: ParserRuleContext) {\n    super(`Type error: ${message}`, ctx);\n  }\n}\n"]}

package/dist/cjs/error/IfcExpressionBuiltinConfigException.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IfcExpressionBuiltinConfigException = void 0;
+class IfcExpressionBuiltinConfigException extends Error {
+    constructor(message) {
+        super(message);
+    }
+}
+exports.IfcExpressionBuiltinConfigException = IfcExpressionBuiltinConfigException;
+//# sourceMappingURL=IfcExpressionBuiltinConfigException.js.map

package/dist/cjs/error/IfcExpressionBuiltinConfigException.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/error/IfcExpressionBuiltinConfigException.ts"],"names":[],"mappings":";;;AAAA,MAAa,mCAAoC,SAAQ,KAAK;IAC5D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF;AAJD,kFAIC","file":"error/IfcExpressionBuiltinConfigException.js","sourcesContent":["export class IfcExpressionBuiltinConfigException extends Error {\n  constructor(message: string) {\n    super(message);\n  }\n}\n"]}

package/dist/cjs/error/InvalidSyntaxException.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/error/InvalidSyntaxException.ts"],"names":[],"mappings":";;;AACA,qEAA+D;AAE/D,MAAa,sBAAuB,SAAQ,4CAAmB;IAE7D,YAAY,cAAsB,EAAE,GAAsB;QACxD,KAAK,CAAC,mBAAmB,cAAc,EAAE,EAAE,GAAG,CAAC,CAAC;QAChD,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;CACF;AAND,wDAMC","file":"error/InvalidSyntaxException.js","sourcesContent":["import { ParserRuleContext } from \"antlr4\";\nimport { ValidationException } from \"./ValidationException.js\";\n\nexport class InvalidSyntaxException extends ValidationException {\n  readonly offendingInput: string;\n  constructor(offendingInput: string, ctx: ParserRuleContext) {\n    super(`Invalid syntax: ${offendingInput}`, ctx);\n    this.offendingInput = offendingInput;\n  }\n}\n"]}
+{"version":3,"sources":["../../src/error/InvalidSyntaxException.ts"],"names":[],"mappings":";;;AACA,qEAA+D;AAE/D,MAAa,sBAAuB,SAAQ,4CAAmB;IAE7D,YAAY,cAAsB,EAAE,GAAsB;QACxD,KAAK,CAAC,mBAAmB,cAAc,EAAE,EAAE,GAAG,CAAC,CAAC;QAChD,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;CACF;AAND,wDAMC","file":"error/InvalidSyntaxException.js","sourcesContent":["import { ParserRuleContext } from \"antlr4ng\";\nimport { ValidationException } from \"./ValidationException.js\";\n\nexport class InvalidSyntaxException extends ValidationException {\n  readonly offendingInput: string;\n  constructor(offendingInput: string, ctx: ParserRuleContext) {\n    super(`Invalid syntax: ${offendingInput}`, ctx);\n    this.offendingInput = offendingInput;\n  }\n}\n"]}

package/dist/cjs/error/NoSuchFunctionException.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/error/NoSuchFunctionException.ts"],"names":[],"mappings":";;;AACA,qEAA+D;AAE/D,MAAa,uBAAwB,SAAQ,4CAAmB;IAE9D,YAAY,YAAoB,EAAE,GAAsB;QACtD,KAAK,CAAC,kCAAkC,YAAY,EAAE,EAAE,GAAG,CAAC,CAAC;QAC7D,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAND,0DAMC","file":"error/NoSuchFunctionException.js","sourcesContent":["import { ParserRuleContext } from \"antlr4\";\nimport { ValidationException } from \"./ValidationException.js\";\n\nexport class NoSuchFunctionException extends ValidationException {\n  readonly functionName: string;\n  constructor(functionName: string, ctx: ParserRuleContext) {\n    super(`Not a IFC Expression Function: ${functionName}`, ctx);\n    this.functionName = functionName;\n  }\n}\n"]}
+{"version":3,"sources":["../../src/error/NoSuchFunctionException.ts"],"names":[],"mappings":";;;AACA,qEAA+D;AAE/D,MAAa,uBAAwB,SAAQ,4CAAmB;IAE9D,YAAY,YAAoB,EAAE,GAAsB;QACtD,KAAK,CAAC,kCAAkC,YAAY,EAAE,EAAE,GAAG,CAAC,CAAC;QAC7D,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAND,0DAMC","file":"error/NoSuchFunctionException.js","sourcesContent":["import { ParserRuleContext } from \"antlr4ng\";\nimport { ValidationException } from \"./ValidationException.js\";\n\nexport class NoSuchFunctionException extends ValidationException {\n  readonly functionName: string;\n  constructor(functionName: string, ctx: ParserRuleContext) {\n    super(`Not a IFC Expression Function: ${functionName}`, ctx);\n    this.functionName = functionName;\n  }\n}\n"]}

package/dist/cjs/error/NoSuchMemberException.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoSuchMemberException = void 0;
+const ValidationException_js_1 = require("./ValidationException.js");
+class NoSuchMemberException extends ValidationException_js_1.ValidationException {
+    constructor(memberName, type, ctx) {
+        super(`No member ${memberName} found for type ${type}`, ctx);
+        this.memberName = memberName;
+        this.type = type;
+    }
+}
+exports.NoSuchMemberException = NoSuchMemberException;
+//# sourceMappingURL=NoSuchMemberException.js.map

package/dist/cjs/error/NoSuchMemberException.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/error/NoSuchMemberException.ts"],"names":[],"mappings":";;;AAAA,qEAA+D;AAE/D,MAAa,qBAAsB,SAAQ,4CAAmB;IAI5D,YAAY,UAAkB,EAAE,IAAY,EAAE,GAAG;QAC/C,KAAK,CAAC,aAAa,UAAU,mBAAmB,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;QAC7D,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AATD,sDASC","file":"error/NoSuchMemberException.js","sourcesContent":["import { ValidationException } from \"./ValidationException.js\";\n\nexport class NoSuchMemberException extends ValidationException {\n  readonly memberName: string;\n  readonly type: string;\n\n  constructor(memberName: string, type: string, ctx) {\n    super(`No member ${memberName} found for type ${type}`, ctx);\n    this.memberName = memberName;\n    this.type = type;\n  }\n}\n"]}

package/dist/cjs/error/ValidationException.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/error/ValidationException.ts"],"names":[],"mappings":";;;AAEA,MAAa,mBAAoB,SAAQ,KAAK;IAM5C,YAAY,OAAe,EAAE,GAAsB;QACjD,KAAK,CACH,sBAAsB,OAAO,OAAO,mBAAmB,CAAC,iBAAiB,CACvE,GAAG,CACJ,WAAW,GAAG,CAAC,OAAO,EAAE,GAAG,CAC7B,CAAC;QACF,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACjE,CAAC;IAEO,MAAM,CAAC,iBAAiB,CAAC,GAAsB;QACrD,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;QAChC,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC;QACpC,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;QAC7B,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QAChE,IAAI,QAAQ,IAAI,MAAM,EAAE;YACtB,OAAO,UAAU,IAAI,QAAQ;gBAC3B,CAAC,CAAC,QAAQ,QAAQ,YAAY,UAAU,EAAE;gBAC1C,CAAC,CAAC,QAAQ,QAAQ,aAAa,UAAU,IAAI,QAAQ,EAAE,CAAC;SAC3D;aAAM;YACL,OAAO,QAAQ,QAAQ,YAAY,UAAU,YAAY,MAAM,YAAY,QAAQ,EAAE,CAAC;SACvF;IACH,CAAC;CACF;AA/BD,kDA+BC","file":"error/ValidationException.js","sourcesContent":["import { ParserRuleContext } from \"antlr4\";\n\nexport class ValidationException extends Error {\n  public readonly fromLine: number;\n  public readonly toLine: number;\n  public readonly fromColumn: number;\n  public readonly toColumn: number;\n\n  constructor(message: string, ctx: ParserRuleContext) {\n    super(\n      `Validation Failed: ${message} at ${ValidationException.makeColumnsString(\n        ctx\n      )}, near '${ctx.getText()}'`\n    );\n    this.fromLine = ctx.start.line;\n    this.fromColumn = ctx.start.column;\n    this.toLine = ctx.stop.line;\n    this.toColumn = ctx.stop.column + (ctx.stop.text || \"\").length;\n  }\n\n  private static makeColumnsString(ctx: ParserRuleContext): string {\n    const fromLine = ctx.start.line;\n    const fromColumn = ctx.start.column;\n    const toLine = ctx.stop.line;\n    const toColumn = ctx.stop.column + (ctx.stop.text || \"\").length;\n    if (fromLine == toLine) {\n      return fromColumn == toColumn\n        ? `line ${fromLine}, column ${fromColumn}`\n        : `line ${fromLine}, columns ${fromColumn}-${toColumn}`;\n    } else {\n      return `line ${fromLine}, column ${fromColumn} to line ${toLine}, column ${toColumn}`;\n    }\n  }\n}\n"]}
+{"version":3,"sources":["../../src/error/ValidationException.ts"],"names":[],"mappings":";;;AAEA,MAAa,mBAAoB,SAAQ,KAAK;IAM5C,YAAY,OAAe,EAAE,GAAsB;QACjD,KAAK,CACH,sBAAsB,OAAO,OAAO,mBAAmB,CAAC,iBAAiB,CACvE,GAAG,CACJ,WAAW,GAAG,CAAC,OAAO,EAAE,GAAG,CAC7B,CAAC;QACF,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACjE,CAAC;IAEO,MAAM,CAAC,iBAAiB,CAAC,GAAsB;QACrD,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;QAChC,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC;QACpC,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;QAC7B,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QAChE,IAAI,QAAQ,IAAI,MAAM,EAAE;YACtB,OAAO,UAAU,IAAI,QAAQ;gBAC3B,CAAC,CAAC,QAAQ,QAAQ,YAAY,UAAU,EAAE;gBAC1C,CAAC,CAAC,QAAQ,QAAQ,aAAa,UAAU,IAAI,QAAQ,EAAE,CAAC;SAC3D;aAAM;YACL,OAAO,QAAQ,QAAQ,YAAY,UAAU,YAAY,MAAM,YAAY,QAAQ,EAAE,CAAC;SACvF;IACH,CAAC;CACF;AA/BD,kDA+BC","file":"error/ValidationException.js","sourcesContent":["import { ParserRuleContext } from \"antlr4ng\";\n\nexport class ValidationException extends Error {\n  public readonly fromLine: number;\n  public readonly toLine: number;\n  public readonly fromColumn: number;\n  public readonly toColumn: number;\n\n  constructor(message: string, ctx: ParserRuleContext) {\n    super(\n      `Validation Failed: ${message} at ${ValidationException.makeColumnsString(\n        ctx\n      )}, near '${ctx.getText()}'`\n    );\n    this.fromLine = ctx.start.line;\n    this.fromColumn = ctx.start.column;\n    this.toLine = ctx.stop.line;\n    this.toColumn = ctx.stop.column + (ctx.stop.text || \"\").length;\n  }\n\n  private static makeColumnsString(ctx: ParserRuleContext): string {\n    const fromLine = ctx.start.line;\n    const fromColumn = ctx.start.column;\n    const toLine = ctx.stop.line;\n    const toColumn = ctx.stop.column + (ctx.stop.text || \"\").length;\n    if (fromLine == toLine) {\n      return fromColumn == toColumn\n        ? `line ${fromLine}, column ${fromColumn}`\n        : `line ${fromLine}, columns ${fromColumn}-${toColumn}`;\n    } else {\n      return `line ${fromLine}, column ${fromColumn} to line ${toLine}, column ${toColumn}`;\n    }\n  }\n}\n"]}

package/dist/cjs/error/WrongFunctionArgumentTypeException.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/error/WrongFunctionArgumentTypeException.ts"],"names":[],"mappings":";;;AAAA,qEAA+D;AAI/D,MAAa,kCAAmC,SAAQ,4CAAmB;IAOzE,YACE,YAAoB,EACpB,YAAoB,EACpB,YAAsB,EACtB,UAAoB,EACpB,aAAqB,EACrB,GAAsB;QAEtB,KAAK,CACH,YAAY,YAAY,2BAA2B,UAAU,CAAC,OAAO,EAAE,qCAAqC,YAAY,CAAC,OAAO,EAAE,mBAAmB,YAAY,yBAAyB,aAAa,GAAG,EAC1M,GAAG,CACJ,CAAC;QACF,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF;AAzBD,gFAyBC","file":"error/WrongFunctionArgumentTypeException.js","sourcesContent":["import { ExpressionTypeError } from \"./ExpressionTypeError.js\";\nimport { ParserRuleContext } from \"antlr4\";\nimport { ExprType } from \"../type/ExprType.js\";\n\nexport class WrongFunctionArgumentTypeException extends ExpressionTypeError {\n  readonly functionName: string;\n  readonly argumentName: string;\n  readonly expectedType: ExprType;\n  readonly actualType: ExprType;\n  readonly argumentIndex: number;\n\n  constructor(\n    functionName: string,\n    argumentName: string,\n    expectedType: ExprType,\n    actualType: ExprType,\n    argumentIndex: number,\n    ctx: ParserRuleContext\n  ) {\n    super(\n      `Function ${functionName}: Actual argument type '${actualType.getName()}' does not satisfy expected type '${expectedType.getName()}' for argument '${argumentName}' at 0-based position ${argumentIndex}.`,\n      ctx\n    );\n    this.functionName = functionName;\n    this.argumentName = argumentName;\n    this.expectedType = expectedType;\n    this.actualType = actualType;\n    this.argumentIndex = argumentIndex;\n  }\n}\n"]}
+{"version":3,"sources":["../../src/error/WrongFunctionArgumentTypeException.ts"],"names":[],"mappings":";;;AAAA,qEAA+D;AAI/D,MAAa,kCAAmC,SAAQ,4CAAmB;IAOzE,YACE,YAAoB,EACpB,YAAoB,EACpB,YAAsB,EACtB,UAAoB,EACpB,aAAqB,EACrB,GAAsB;QAEtB,KAAK,CACH,YAAY,YAAY,2BAA2B,UAAU,CAAC,OAAO,EAAE,qCAAqC,YAAY,CAAC,OAAO,EAAE,mBAAmB,YAAY,yBAAyB,aAAa,GAAG,EAC1M,GAAG,CACJ,CAAC;QACF,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF;AAzBD,gFAyBC","file":"error/WrongFunctionArgumentTypeException.js","sourcesContent":["import { ExpressionTypeError } from \"./ExpressionTypeError.js\";\nimport { ParserRuleContext } from \"antlr4ng\";\nimport { ExprType } from \"../type/ExprType.js\";\n\nexport class WrongFunctionArgumentTypeException extends ExpressionTypeError {\n  readonly functionName: string;\n  readonly argumentName: string;\n  readonly expectedType: ExprType;\n  readonly actualType: ExprType;\n  readonly argumentIndex: number;\n\n  constructor(\n    functionName: string,\n    argumentName: string,\n    expectedType: ExprType,\n    actualType: ExprType,\n    argumentIndex: number,\n    ctx: ParserRuleContext\n  ) {\n    super(\n      `Function ${functionName}: Actual argument type '${actualType.getName()}' does not satisfy expected type '${expectedType.getName()}' for argument '${argumentName}' at 0-based position ${argumentIndex}.`,\n      ctx\n    );\n    this.functionName = functionName;\n    this.argumentName = argumentName;\n    this.expectedType = expectedType;\n    this.actualType = actualType;\n    this.argumentIndex = argumentIndex;\n  }\n}\n"]}

package/dist/cjs/expression/ExprKind.js

@@ -17,6 +17,9 @@ var ExprKind;
     ExprKind["NUM_LITERAL"] = "NUM_LITERAL";
     ExprKind["REF_ELEMENT"] = "REF_ELEMENT";
     ExprKind["REF_PROPERTY"] = "REF_PROPERTY";
+    ExprKind["REF_BUILTIN_ROOT"] = "REF_BUILTIN_ROOT";
+    ExprKind["REF_BUILTIN_MEMBER"] = "REF_BUILTIN_MEMBER";
+    ExprKind["REF_BUILTIN_FUNCTION"] = "REF_BUILTIN_FUNCTION";
     ExprKind["STR_CONCAT"] = "STR_CONCAT";
     ExprKind["STR_LITERAL"] = "STR_LITERAL";
     ExprKind["AND"] = "AND";

package/dist/cjs/expression/ExprKind.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/expression/ExprKind.ts"],"names":[],"mappings":";;;AAAA,IAAY,QA8BX;AA9BD,WAAY,QAAQ;IAClB,iCAAqB,CAAA;IACrB,qDAAyC,CAAA;IACzC,2BAAe,CAAA;IACf,uCAA2B,CAAA;IAC3B,uCAA2B,CAAA;IAC3B,qCAAyB,CAAA;IACzB,yCAA6B,CAAA;IAC7B,iCAAqB,CAAA;IACrB,mCAAuB,CAAA;IACvB,+BAAmB,CAAA;IACnB,2CAA+B,CAAA;IAC/B,uCAA2B,CAAA;IAC3B,uCAA2B,CAAA;IAC3B,yCAA6B,CAAA;IAC7B,qCAAyB,CAAA;IACzB,uCAA2B,CAAA;IAC3B,uBAAW,CAAA;IACX,qBAAS,CAAA;IACT,uBAAW,CAAA;IACX,uBAAW,CAAA;IACX,+CAAmC,CAAA;IACnC,+CAAmC,CAAA;IACnC,qCAAyB,CAAA;IACzB,6CAAiC,CAAA;IACjC,2CAA+B,CAAA;IAC/B,6DAAiD,CAAA;IACjD,iDAAqC,CAAA;IACrC,mEAAuD,CAAA;IACvD,uCAA2B,CAAA,CAAC,0EAA0E;AACxG,CAAC,EA9BW,QAAQ,wBAAR,QAAQ,QA8BnB","file":"expression/ExprKind.js","sourcesContent":["export enum ExprKind {\n  FUNCTION = \"FUNCTION\",\n  FUNCTION_ARGUMENTS = \"FUNCTION_ARGUMENTS\",\n  ARRAY = \"ARRAY\",\n  METHOD_CALL = \"METHOD_CALL\",\n  PARENTHESIS = \"PARENTHESIS\",\n  NUM_DIVIDE = \"NUM_DIVIDE\",\n  NUM_MULTIPLY = \"NUM_MULTIPLY\",\n  NUM_PLUS = \"NUM_PLUS\",\n  NUM_MINUS = \"NUM_MINUS\",\n  NUM_POWER = \"POWER\",\n  NUM_UNARY_MINUS = \"UNARY_MINUS\",\n  NUM_LITERAL = \"NUM_LITERAL\",\n  REF_ELEMENT = \"REF_ELEMENT\",\n  REF_PROPERTY = \"REF_PROPERTY\",\n  STR_CONCAT = \"STR_CONCAT\",\n  STR_LITERAL = \"STR_LITERAL\",\n  AND = \"AND\",\n  OR = \"OR\",\n  XOR = \"XOR\",\n  NOT = \"NOT\",\n  BOOLEAN_LITERAL = \"BOOLEAN_LITERAL\",\n  LOGICAL_LITERAL = \"LOGICAL_LITERAL\",\n  CMP_EQUALS = \"CMP_EQUALS\",\n  CMP_NOT_EQUALS = \"CMP_NOT_EQUALS\",\n  CMP_LESS_THAN = \"CMP_LESS_THAN\",\n  CMP_LESS_THAN_OR_EQUAL = \"CMP_LESS_THAN_OR_EQUAL\",\n  CMP_GREATER_THAN = \"CMP_GREATER_THAN\",\n  CMP_GREATER_THAN_OR_EQUAL = \"CMP_GREATER_THAN_OR_EQUAL\",\n  PARSE_ERROR = \"PARSE_ERROR\" /* to be used when no expr was compiled due to a parse/validation error */,\n}\n"]}
+{"version":3,"sources":["../../src/expression/ExprKind.ts"],"names":[],"mappings":";;;AAAA,IAAY,QAiCX;AAjCD,WAAY,QAAQ;IAClB,iCAAqB,CAAA;IACrB,qDAAyC,CAAA;IACzC,2BAAe,CAAA;IACf,uCAA2B,CAAA;IAC3B,uCAA2B,CAAA;IAC3B,qCAAyB,CAAA;IACzB,yCAA6B,CAAA;IAC7B,iCAAqB,CAAA;IACrB,mCAAuB,CAAA;IACvB,+BAAmB,CAAA;IACnB,2CAA+B,CAAA;IAC/B,uCAA2B,CAAA;IAC3B,uCAA2B,CAAA;IAC3B,yCAA6B,CAAA;IAC7B,iDAAqC,CAAA;IACrC,qDAAyC,CAAA;IACzC,yDAA6C,CAAA;IAC7C,qCAAyB,CAAA;IACzB,uCAA2B,CAAA;IAC3B,uBAAW,CAAA;IACX,qBAAS,CAAA;IACT,uBAAW,CAAA;IACX,uBAAW,CAAA;IACX,+CAAmC,CAAA;IACnC,+CAAmC,CAAA;IACnC,qCAAyB,CAAA;IACzB,6CAAiC,CAAA;IACjC,2CAA+B,CAAA;IAC/B,6DAAiD,CAAA;IACjD,iDAAqC,CAAA;IACrC,mEAAuD,CAAA;IACvD,uCAA2B,CAAA,CAAC,0EAA0E;AACxG,CAAC,EAjCW,QAAQ,wBAAR,QAAQ,QAiCnB","file":"expression/ExprKind.js","sourcesContent":["export enum ExprKind {\n  FUNCTION = \"FUNCTION\",\n  FUNCTION_ARGUMENTS = \"FUNCTION_ARGUMENTS\",\n  ARRAY = \"ARRAY\",\n  METHOD_CALL = \"METHOD_CALL\",\n  PARENTHESIS = \"PARENTHESIS\",\n  NUM_DIVIDE = \"NUM_DIVIDE\",\n  NUM_MULTIPLY = \"NUM_MULTIPLY\",\n  NUM_PLUS = \"NUM_PLUS\",\n  NUM_MINUS = \"NUM_MINUS\",\n  NUM_POWER = \"POWER\",\n  NUM_UNARY_MINUS = \"UNARY_MINUS\",\n  NUM_LITERAL = \"NUM_LITERAL\",\n  REF_ELEMENT = \"REF_ELEMENT\",\n  REF_PROPERTY = \"REF_PROPERTY\",\n  REF_BUILTIN_ROOT = \"REF_BUILTIN_ROOT\",\n  REF_BUILTIN_MEMBER = \"REF_BUILTIN_MEMBER\",\n  REF_BUILTIN_FUNCTION = \"REF_BUILTIN_FUNCTION\",\n  STR_CONCAT = \"STR_CONCAT\",\n  STR_LITERAL = \"STR_LITERAL\",\n  AND = \"AND\",\n  OR = \"OR\",\n  XOR = \"XOR\",\n  NOT = \"NOT\",\n  BOOLEAN_LITERAL = \"BOOLEAN_LITERAL\",\n  LOGICAL_LITERAL = \"LOGICAL_LITERAL\",\n  CMP_EQUALS = \"CMP_EQUALS\",\n  CMP_NOT_EQUALS = \"CMP_NOT_EQUALS\",\n  CMP_LESS_THAN = \"CMP_LESS_THAN\",\n  CMP_LESS_THAN_OR_EQUAL = \"CMP_LESS_THAN_OR_EQUAL\",\n  CMP_GREATER_THAN = \"CMP_GREATER_THAN\",\n  CMP_GREATER_THAN_OR_EQUAL = \"CMP_GREATER_THAN_OR_EQUAL\",\n  PARSE_ERROR = \"PARSE_ERROR\" /* to be used when no expr was compiled due to a parse/validation error */,\n}\n"]}

package/dist/cjs/expression/function/Func.js

@@ -18,6 +18,24 @@ class Func {
         this.formalArguments = args;
         this.checkArgs(args);
     }
+    withDocumentation(documentation) {
+        this.documentationRef = documentation;
+        return this;
+    }
+    getDocumentation() {
+        return this.documentationRef;
+    }
+    getFormalArguments() {
+        return this.formalArguments;
+    }
+    getSignatureLabel(displayName = this.name) {
+        const preferredArguments = this.formalArguments.filter((argument) => argument.displayLabel !== undefined);
+        const signatureArguments = preferredArguments.length > 0
+            ? preferredArguments
+            : this.formalArguments.filter((argument) => argument.required);
+        const labels = signatureArguments.map((argument) => argument.displayLabel?.fallback ?? argument.name);
+        return `${displayName}(${labels.join(", ")})`;
+    }
     checkArgumentsAndGetReturnType(argumentTypes, ctx) {
         this.checkArgumentTypes(argumentTypes, ctx);
         return this.getReturnType(argumentTypes.map((t) => t[1]));
@@ -61,21 +79,7 @@ class Func {
         }
         return this.calculateResult(callingExpr, argumentsReadyForUse);
     }
-    /**
-     * Override to transform individual arguments if needed. After this step, if any of the ExprEvalResult objects in the
-     * returned array is an ExprEvalError, the function evaluation fails.
-     * @param callingExpr
-     * @param evaluatedArguments
-     * @protected
-     */
     transformArguments(callingExpr, evaluatedArguments) { }
-    /**
-     * Gets the argument values from the list of provided arguments in the form of 'name' -> ExprEvalResult (which may contain errors).
-     * Generates an error if a required value is missing.
-     * @param callingExpr
-     * @param provided
-     * @protected
-     */
     getArgumentValues(callingExpr, provided) {
         const result = new Map();
         const numProvided = provided.length;

package/dist/cjs/expression/function/Func.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/expression/function/Func.ts"],"names":[],"mappings":"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","file":"expression/function/Func.js","sourcesContent":["import { ExpressionValue } from \"../../value/ExpressionValue.js\";\nimport { IfcExpressionFunctionConfigException } from \"../../error/IfcExpressionFunctionConfigException.js\";\nimport { isNullish } from \"../../util/IfcExpressionUtils.js\";\nimport { FuncArg } from \"./FuncArg.js\";\nimport {\n  ExprEvalError,\n  ExprEvalMissingRequiredFunctionArgumentErrorObj,\n  ExprEvalResult,\n  ExprEvalSuccessObj,\n  isExprEvalError,\n} from \"../ExprEvalResult.js\";\nimport { ExprKind } from \"../ExprKind.js\";\nimport { Types } from \"../../type/Types.js\";\nimport { MissingFunctionArgumentException } from \"../../error/MissingFunctionArgumentException.js\";\nimport { WrongFunctionArgumentTypeException } from \"../../error/WrongFunctionArgumentTypeException.js\";\nimport { ExprType } from \"../../type/ExprType.js\";\nimport { ParserRuleContext } from \"antlr4\";\nimport { FunctionExpr } from \"./FunctionExpr.js\";\nimport { Expr } from \"../Expr.js\";\nimport { SpuriousFunctionArgumentException } from \"../../error/SpuriousFunctionArgumentException.js\";\n\nexport abstract class Func {\n  protected name: string;\n  protected formalArguments: Array<FuncArg<unknown>>;\n\n  protected constructor(name: string, args: Array<FuncArg<unknown>>) {\n    this.name = name;\n    if (isNullish(this.name)) {\n      throw new IfcExpressionFunctionConfigException(\n        \"Function must have a name\"\n      );\n    }\n    this.formalArguments = args;\n    this.checkArgs(args);\n  }\n\n  public abstract getReturnType(argumentTypes: Array<ExprType>): ExprType;\n\n  public checkArgumentsAndGetReturnType(\n    argumentTypes: Array<[ParserRuleContext, ExprType]>,\n    ctx\n  ): ExprType {\n    this.checkArgumentTypes(argumentTypes, ctx);\n    return this.getReturnType(argumentTypes.map((t) => t[1]));\n  }\n\n  protected checkArgumentTypes(\n    providedArgumentTypes: Array<[ParserRuleContext, ExprType]>,\n    ctx\n  ): void {\n    const numProvided = providedArgumentTypes.length;\n    if (!isNullish(this.formalArguments)) {\n      if (numProvided > this.formalArguments.length) {\n        throw new SpuriousFunctionArgumentException(\n          this.name,\n          \"[unexpected argument]\",\n          this.formalArguments.length,\n          ctx,\n          `Function expects (at most) ${this.formalArguments.length} arguments`\n        );\n      }\n      for (let i = 0; i < this.formalArguments.length; i++) {\n        const currentArg: FuncArg<unknown> = this.formalArguments[i];\n        if (numProvided > i) {\n          Types.requireWeakIsAssignableFrom(\n            this.formalArguments[i].getType(),\n            providedArgumentTypes[i][1],\n            () =>\n              new WrongFunctionArgumentTypeException(\n                this.name,\n                this.formalArguments[i].name,\n                this.formalArguments[i].getType(),\n                providedArgumentTypes[i][1],\n                i,\n                providedArgumentTypes[i][0]\n              )\n          );\n        } else {\n          if (currentArg.hasDefaultValue()) {\n            //should be fine.\n          }\n          if (currentArg.required) {\n            throw new MissingFunctionArgumentException(\n              this.name,\n              currentArg.name,\n              i,\n              ctx\n            );\n          }\n        }\n      }\n    }\n  }\n\n  public getName(): string {\n    return this.name;\n  }\n\n  public evaluate(\n    callingExpr: FunctionExpr,\n    funcArgs: Array<ExprEvalResult<ExpressionValue>>\n  ): ExprEvalResult<ExpressionValue> {\n    const evaluatedArguments = this.getArgumentValues(callingExpr, funcArgs);\n    if (isExprEvalError(evaluatedArguments)) {\n      return evaluatedArguments;\n    }\n    const argumentsReadyForUse = new Map<string, ExpressionValue>();\n    for (const [argName, argValue] of evaluatedArguments.entries()) {\n      if (isExprEvalError(argValue)) {\n        return argValue;\n      }\n      argumentsReadyForUse.set(argName, argValue.result);\n    }\n    return this.calculateResult(callingExpr, argumentsReadyForUse);\n  }\n\n  /**\n   * Subclasses must provide the funcation evaluation code here.\n   * @param callingExpr\n   * @param evaluatedArguments\n   * @protected\n   */\n  protected abstract calculateResult(\n    callingExpr: FunctionExpr,\n    evaluatedArguments: Map<string, ExpressionValue>\n  ): ExprEvalResult<ExpressionValue>;\n\n  /**\n   * Override to transform individual arguments if needed. After this step, if any of the ExprEvalResult objects in the\n   * returned array is an ExprEvalError, the function evaluation fails.\n   * @param callingExpr\n   * @param evaluatedArguments\n   * @protected\n   */\n  protected transformArguments(\n    callingExpr: Expr<any>,\n    evaluatedArguments: Map<string, ExprEvalResult<ExpressionValue>>\n  ): void {}\n\n  /**\n   * Gets the argument values from the list of provided arguments in the form of 'name' -> ExprEvalResult (which may contain errors).\n   * Generates an error if a required value is missing.\n   * @param callingExpr\n   * @param provided\n   * @protected\n   */\n  protected getArgumentValues(\n    callingExpr: FunctionExpr,\n    provided: Array<ExprEvalResult<ExpressionValue>>\n  ): Map<string, ExprEvalResult<ExpressionValue>> | ExprEvalError {\n    const result = new Map<string, ExprEvalResult<ExpressionValue>>();\n    const numProvided = provided.length;\n    if (!isNullish(this.formalArguments)) {\n      for (let i = 0; i < this.formalArguments.length; i++) {\n        const currentArg: FuncArg<unknown> = this.formalArguments[i];\n        if (numProvided > i) {\n          result.set(\n            currentArg.name,\n            currentArg.transformValue(callingExpr, provided[i])\n          );\n        } else {\n          if (currentArg.hasDefaultValue()) {\n            result.set(\n              currentArg.name,\n              new ExprEvalSuccessObj(currentArg.defaultValue as ExpressionValue)\n            );\n          }\n          if (currentArg.required) {\n            return new ExprEvalMissingRequiredFunctionArgumentErrorObj(\n              ExprKind.FUNCTION_ARGUMENTS,\n              `Required argument ${currentArg.name}, expected at position ${i} (starting at 0), is missing`,\n              this.name,\n              currentArg.name,\n              i,\n              callingExpr.getTextSpan()\n            );\n          }\n        }\n      }\n    }\n    this.transformArguments(callingExpr, result);\n    return result;\n  }\n\n  private checkArgs(args: Array<FuncArg<unknown>>): void {\n    if (!Array.isArray(this.formalArguments)) {\n      throw new IfcExpressionFunctionConfigException(\n        \"Formal function arguments is not an array\"\n      );\n    }\n    let optionalArgsReached: boolean = false;\n    const names = new Set<string>();\n    for (let i = 0; i < this.formalArguments.length; i++) {\n      if (names.has(this.formalArguments[i].name)) {\n        throw new IfcExpressionFunctionConfigException(\n          `Duplicate argument name '${this.formalArguments[i].name}'.`\n        );\n      }\n      if (optionalArgsReached) {\n        if (this.formalArguments[i].required) {\n          throw new IfcExpressionFunctionConfigException(\n            `Optional arguments must follow required ones. Argument '${this.formalArguments[i].name}' is required but follows an optional one`\n          );\n        }\n      } else {\n        if (!this.formalArguments[i].required) {\n          optionalArgsReached = true;\n        }\n      }\n    }\n  }\n}\n"]}
+{"version":3,"sources":["../../src/expression/function/Func.ts"],"names":[],"mappings":"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","file":"expression/function/Func.js","sourcesContent":["import { ExpressionValue } from \"../../value/ExpressionValue.js\";\nimport { IfcExpressionFunctionConfigException } from \"../../error/IfcExpressionFunctionConfigException.js\";\nimport { isNullish } from \"../../util/IfcExpressionUtils.js\";\nimport { FuncArg } from \"./FuncArg.js\";\nimport {\n  ExprEvalError,\n  ExprEvalMissingRequiredFunctionArgumentErrorObj,\n  ExprEvalResult,\n  ExprEvalSuccessObj,\n  isExprEvalError,\n} from \"../ExprEvalResult.js\";\nimport { ExprKind } from \"../ExprKind.js\";\nimport { Types } from \"../../type/Types.js\";\nimport { MissingFunctionArgumentException } from \"../../error/MissingFunctionArgumentException.js\";\nimport { WrongFunctionArgumentTypeException } from \"../../error/WrongFunctionArgumentTypeException.js\";\nimport { ExprType } from \"../../type/ExprType.js\";\nimport { ParserRuleContext } from \"antlr4ng\";\nimport { FunctionExpr } from \"./FunctionExpr.js\";\nimport { Expr } from \"../Expr.js\";\nimport { SpuriousFunctionArgumentException } from \"../../error/SpuriousFunctionArgumentException.js\";\nimport { LocalizedText } from \"../../documentation/Documentation.js\";\n\nexport abstract class Func {\n  protected name: string;\n  protected formalArguments: Array<FuncArg<unknown>>;\n  protected documentationRef?: LocalizedText;\n\n  protected constructor(name: string, args: Array<FuncArg<unknown>>) {\n    this.name = name;\n    if (isNullish(this.name)) {\n      throw new IfcExpressionFunctionConfigException(\n        \"Function must have a name\"\n      );\n    }\n    this.formalArguments = args;\n    this.checkArgs(args);\n  }\n\n  public abstract getReturnType(argumentTypes: Array<ExprType>): ExprType;\n\n  public withDocumentation(documentation: LocalizedText): this {\n    this.documentationRef = documentation;\n    return this;\n  }\n\n  public getDocumentation(): LocalizedText | undefined {\n    return this.documentationRef;\n  }\n\n  public getFormalArguments(): ReadonlyArray<FuncArg<unknown>> {\n    return this.formalArguments;\n  }\n\n  public getSignatureLabel(displayName = this.name): string {\n    const preferredArguments = this.formalArguments.filter(\n      (argument) => argument.displayLabel !== undefined\n    );\n    const signatureArguments =\n      preferredArguments.length > 0\n        ? preferredArguments\n        : this.formalArguments.filter((argument) => argument.required);\n    const labels = signatureArguments.map(\n      (argument) => argument.displayLabel?.fallback ?? argument.name\n    );\n    return `${displayName}(${labels.join(\", \")})`;\n  }\n\n  public checkArgumentsAndGetReturnType(\n    argumentTypes: Array<[ParserRuleContext, ExprType]>,\n    ctx\n  ): ExprType {\n    this.checkArgumentTypes(argumentTypes, ctx);\n    return this.getReturnType(argumentTypes.map((t) => t[1]));\n  }\n\n  protected checkArgumentTypes(\n    providedArgumentTypes: Array<[ParserRuleContext, ExprType]>,\n    ctx\n  ): void {\n    const numProvided = providedArgumentTypes.length;\n    if (!isNullish(this.formalArguments)) {\n      if (numProvided > this.formalArguments.length) {\n        throw new SpuriousFunctionArgumentException(\n          this.name,\n          \"[unexpected argument]\",\n          this.formalArguments.length,\n          ctx,\n          `Function expects (at most) ${this.formalArguments.length} arguments`\n        );\n      }\n      for (let i = 0; i < this.formalArguments.length; i++) {\n        const currentArg: FuncArg<unknown> = this.formalArguments[i];\n        if (numProvided > i) {\n          Types.requireWeakIsAssignableFrom(\n            this.formalArguments[i].getType(),\n            providedArgumentTypes[i][1],\n            () =>\n              new WrongFunctionArgumentTypeException(\n                this.name,\n                this.formalArguments[i].name,\n                this.formalArguments[i].getType(),\n                providedArgumentTypes[i][1],\n                i,\n                providedArgumentTypes[i][0]\n              )\n          );\n        } else {\n          if (currentArg.hasDefaultValue()) {\n            //should be fine.\n          }\n          if (currentArg.required) {\n            throw new MissingFunctionArgumentException(\n              this.name,\n              currentArg.name,\n              i,\n              ctx\n            );\n          }\n        }\n      }\n    }\n  }\n\n  public getName(): string {\n    return this.name;\n  }\n\n  public evaluate(\n    callingExpr: FunctionExpr,\n    funcArgs: Array<ExprEvalResult<ExpressionValue>>\n  ): ExprEvalResult<ExpressionValue> {\n    const evaluatedArguments = this.getArgumentValues(callingExpr, funcArgs);\n    if (isExprEvalError(evaluatedArguments)) {\n      return evaluatedArguments;\n    }\n    const argumentsReadyForUse = new Map<string, ExpressionValue>();\n    for (const [argName, argValue] of evaluatedArguments.entries()) {\n      if (isExprEvalError(argValue)) {\n        return argValue;\n      }\n      argumentsReadyForUse.set(argName, argValue.result);\n    }\n    return this.calculateResult(callingExpr, argumentsReadyForUse);\n  }\n\n  protected abstract calculateResult(\n    callingExpr: FunctionExpr,\n    evaluatedArguments: Map<string, ExpressionValue>\n  ): ExprEvalResult<ExpressionValue>;\n\n  protected transformArguments(\n    callingExpr: Expr<any>,\n    evaluatedArguments: Map<string, ExprEvalResult<ExpressionValue>>\n  ): void {}\n\n  protected getArgumentValues(\n    callingExpr: FunctionExpr,\n    provided: Array<ExprEvalResult<ExpressionValue>>\n  ): Map<string, ExprEvalResult<ExpressionValue>> | ExprEvalError {\n    const result = new Map<string, ExprEvalResult<ExpressionValue>>();\n    const numProvided = provided.length;\n    if (!isNullish(this.formalArguments)) {\n      for (let i = 0; i < this.formalArguments.length; i++) {\n        const currentArg: FuncArg<unknown> = this.formalArguments[i];\n        if (numProvided > i) {\n          result.set(\n            currentArg.name,\n            currentArg.transformValue(callingExpr, provided[i])\n          );\n        } else {\n          if (currentArg.hasDefaultValue()) {\n            result.set(\n              currentArg.name,\n              new ExprEvalSuccessObj(currentArg.defaultValue as ExpressionValue)\n            );\n          }\n          if (currentArg.required) {\n            return new ExprEvalMissingRequiredFunctionArgumentErrorObj(\n              ExprKind.FUNCTION_ARGUMENTS,\n              `Required argument ${currentArg.name}, expected at position ${i} (starting at 0), is missing`,\n              this.name,\n              currentArg.name,\n              i,\n              callingExpr.getTextSpan()\n            );\n          }\n        }\n      }\n    }\n    this.transformArguments(callingExpr, result);\n    return result;\n  }\n\n  private checkArgs(args: Array<FuncArg<unknown>>): void {\n    if (!Array.isArray(this.formalArguments)) {\n      throw new IfcExpressionFunctionConfigException(\n        \"Formal function arguments is not an array\"\n      );\n    }\n    let optionalArgsReached: boolean = false;\n    const names = new Set<string>();\n    for (let i = 0; i < this.formalArguments.length; i++) {\n      if (names.has(this.formalArguments[i].name)) {\n        throw new IfcExpressionFunctionConfigException(\n          `Duplicate argument name '${this.formalArguments[i].name}'.`\n        );\n      }\n      if (optionalArgsReached) {\n        if (this.formalArguments[i].required) {\n          throw new IfcExpressionFunctionConfigException(\n            `Optional arguments must follow required ones. Argument '${this.formalArguments[i].name}' is required but follows an optional one`\n          );\n        }\n      } else {\n        if (!this.formalArguments[i].required) {\n          optionalArgsReached = true;\n        }\n      }\n    }\n  }\n}\n"]}

package/dist/cjs/expression/function/FuncArg.js

@@ -12,11 +12,11 @@ class FuncArg {
     getType() {
         return Types_js_1.Type.ANY;
     }
-    /**
-     * For the value provided for a specific invocation of the function, return an appropriate result (maybe some kind of type conversion or type check might happen here)
-     *
-     * @param invocationValue
-     */
+    withDocumentation(displayLabel, documentation) {
+        this._displayLabel = displayLabel;
+        this._documentation = documentation;
+        return this;
+    }
     transformValue(callingExpr, invocationValue) {
         return invocationValue;
     }
@@ -29,6 +29,12 @@ class FuncArg {
     get defaultValue() {
         return this._defaultValue;
     }
+    get displayLabel() {
+        return this._displayLabel;
+    }
+    get documentation() {
+        return this._documentation;
+    }
     hasDefaultValue() {
         return !(0, IfcExpressionUtils_js_1.isNullish)(this._defaultValue);
     }

package/dist/cjs/expression/function/FuncArg.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/expression/function/FuncArg.ts"],"names":[],"mappings":";;;AAEA,4EAA6D;AAC7D,kDAA2C;AAI3C,MAAa,OAAO;IAKlB,YAAY,QAAiB,EAAE,IAAY,EAAE,YAAgB;QAC3D,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;IACpC,CAAC;IAEM,OAAO;QACZ,OAAO,eAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACI,cAAc,CACnB,WAAyB,EACzB,eAAgD;QAEhD,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,eAAe;QACb,OAAO,CAAC,IAAA,iCAAS,EAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACxC,CAAC;CACF;AA1CD,0BA0CC","file":"expression/function/FuncArg.js","sourcesContent":["import { ExpressionValue } from \"../../value/ExpressionValue.js\";\nimport { ExprEvalResult } from \"../ExprEvalResult.js\";\nimport { isNullish } from \"../../util/IfcExpressionUtils.js\";\nimport { Type } from \"../../type/Types.js\";\nimport { ExprType } from \"../../type/ExprType.js\";\nimport { FunctionExpr } from \"./FunctionExpr.js\";\n\nexport class FuncArg<T> {\n  protected _required: boolean;\n  protected _name: string;\n  protected _defaultValue?: T;\n\n  constructor(required: boolean, name: string, defaultValue?: T) {\n    this._required = required;\n    this._name = name;\n    this._defaultValue = defaultValue;\n  }\n\n  public getType(): ExprType {\n    return Type.ANY;\n  }\n\n  /**\n   * For the value provided for a specific invocation of the function, return an appropriate result (maybe some kind of type conversion or type check might happen here)\n   *\n   * @param invocationValue\n   */\n  public transformValue(\n    callingExpr: FunctionExpr,\n    invocationValue: ExprEvalResult<ExpressionValue>\n  ): ExprEvalResult<ExpressionValue> {\n    return invocationValue;\n  }\n\n  get required(): boolean {\n    return this._required;\n  }\n\n  get name(): string {\n    return this._name;\n  }\n\n  get defaultValue(): T | undefined {\n    return this._defaultValue;\n  }\n\n  hasDefaultValue(): boolean {\n    return !isNullish(this._defaultValue);\n  }\n}\n"]}
+{"version":3,"sources":["../../src/expression/function/FuncArg.ts"],"names":[],"mappings":";;;AAEA,4EAA6D;AAC7D,kDAA2C;AAK3C,MAAa,OAAO;IAOlB,YAAY,QAAiB,EAAE,IAAY,EAAE,YAAgB;QAC3D,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;IACpC,CAAC;IAEM,OAAO;QACZ,OAAO,eAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAEM,iBAAiB,CACtB,YAA2B,EAC3B,aAA4B;QAE5B,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;QAClC,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,cAAc,CACnB,WAAyB,EACzB,eAAgD;QAEhD,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,eAAe;QACb,OAAO,CAAC,IAAA,iCAAS,EAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACxC,CAAC;CACF;AAxDD,0BAwDC","file":"expression/function/FuncArg.js","sourcesContent":["import { ExpressionValue } from \"../../value/ExpressionValue.js\";\nimport { ExprEvalResult } from \"../ExprEvalResult.js\";\nimport { isNullish } from \"../../util/IfcExpressionUtils.js\";\nimport { Type } from \"../../type/Types.js\";\nimport { ExprType } from \"../../type/ExprType.js\";\nimport { FunctionExpr } from \"./FunctionExpr.js\";\nimport { LocalizedText } from \"../../documentation/Documentation.js\";\n\nexport class FuncArg<T> {\n  protected _required: boolean;\n  protected _name: string;\n  protected _defaultValue?: T;\n  protected _displayLabel?: LocalizedText;\n  protected _documentation?: LocalizedText;\n\n  constructor(required: boolean, name: string, defaultValue?: T) {\n    this._required = required;\n    this._name = name;\n    this._defaultValue = defaultValue;\n  }\n\n  public getType(): ExprType {\n    return Type.ANY;\n  }\n\n  public withDocumentation(\n    displayLabel: LocalizedText,\n    documentation: LocalizedText\n  ): this {\n    this._displayLabel = displayLabel;\n    this._documentation = documentation;\n    return this;\n  }\n\n  public transformValue(\n    callingExpr: FunctionExpr,\n    invocationValue: ExprEvalResult<ExpressionValue>\n  ): ExprEvalResult<ExpressionValue> {\n    return invocationValue;\n  }\n\n  get required(): boolean {\n    return this._required;\n  }\n\n  get name(): string {\n    return this._name;\n  }\n\n  get defaultValue(): T | undefined {\n    return this._defaultValue;\n  }\n\n  get displayLabel(): LocalizedText | undefined {\n    return this._displayLabel;\n  }\n\n  get documentation(): LocalizedText | undefined {\n    return this._documentation;\n  }\n\n  hasDefaultValue(): boolean {\n    return !isNullish(this._defaultValue);\n  }\n}\n"]}

package/dist/cjs/expression/function/IfcExpressionFunctions.js

@@ -41,12 +41,44 @@ function registerOrDie(fnKey, func) {
     }
     builtinFunctions.set(fnKey, func);
 }
+function toDocKey(label) {
+    return label.replace(/[^a-zA-Z0-9]+/g, "_");
+}
+function withDocumentation(func, summary, args = []) {
+    func.withDocumentation({
+        key: `function.${func.getName()}.summary`,
+        fallback: summary,
+    });
+    args.forEach((argument, index) => {
+        const formalArgument = func.getFormalArguments()[index];
+        if (!formalArgument) {
+            return;
+        }
+        const docKey = toDocKey(argument.label);
+        formalArgument.withDocumentation({
+            key: `function.${func.getName()}.arg.${docKey}.label`,
+            fallback: argument.label,
+        }, {
+            key: `function.${func.getName()}.arg.${docKey}.summary`,
+            fallback: argument.documentation,
+        });
+    });
+    return func;
+}
 function registerFunc(func, ...aliases) {
     const fnKey = func.getName();
     const keys = [...aliases];
     keys.unshift(fnKey);
     keys.forEach((key) => registerOrDie(IfcExpressionFunctions.normalizeName(key), func));
 }
+function documentAttributeAccessor(name, summary) {
+    return withDocumentation(new AttributeAccessorFunction_js_1.AttributeAccessorFunction(name, Types_js_1.Type.STRING), summary, [
+        {
+            label: "object",
+            documentation: "The IFC object to read from",
+        },
+    ]);
+}
 class IfcExpressionFunctions {
     static normalizeName(name) {
         if ((0, IfcExpressionUtils_js_1.isNullish)(name)) {
@@ -66,50 +98,174 @@ class IfcExpressionFunctions {
         }
         return builtinFunctions.get(this.normalizeName(name));
     }
+    static getBuiltinFunctionNames() {
+        return [...builtinFunctions.keys()].sort((left, right) => left.localeCompare(right));
+    }
 }
 exports.IfcExpressionFunctions = IfcExpressionFunctions;
-registerFunc(new MAP_js_1.MAP());
-registerFunc(new CHOOSE_js_1.CHOOSE());
-registerFunc(new AT_js_1.AT());
-registerFunc(new IF_js_1.IF());
-registerFunc(new ROUND_js_1.ROUND());
-registerFunc(new AttributeAccessorFunction_js_1.AttributeAccessorFunction("name", Types_js_1.Type.STRING));
-registerFunc(new AttributeAccessorFunction_js_1.AttributeAccessorFunction("guid", Types_js_1.Type.STRING));
-registerFunc(new AttributeAccessorFunction_js_1.AttributeAccessorFunction("ifcClass", Types_js_1.Type.STRING));
-registerFunc(new AttributeAccessorFunction_js_1.AttributeAccessorFunction("description", Types_js_1.Type.STRING));
-registerFunc(new AttributeAccessorFunction_js_1.AttributeAccessorFunction("value", Types_js_1.Types.or(Types_js_1.Type.STRING, Types_js_1.Type.NUMERIC, Types_js_1.Type.BOOLEAN, Types_js_1.Type.ARRAY)));
-registerFunc(new PROPERTYSET_js_1.PROPERTYSET());
-registerFunc(new PROPERTY_js_1.PROPERTY());
-registerFunc(new TYPE_js_1.TYPE());
-registerFunc(new NOT_js_1.NOT());
-registerFunc(new TOSTRING_js_1.TOSTRING());
-registerFunc(new TONUMERIC_js_1.TONUMERIC(), "TONUMBER");
-registerFunc(new TOBOOLEAN_js_1.TOBOOLEAN());
-registerFunc(new TOLOGICAL_js_1.TOLOGICAL(), "NOTFOUNDASUNKNOWN");
-registerFunc(new TOIFCDATE_js_1.TOIFCDATE());
-registerFunc(new TOIFCTIME_js_1.TOIFCTIME());
-registerFunc(new TOIFCDATETIME_js_1.TOIFCDATETIME());
-registerFunc(new TOIFCDURATION_js_1.TOIFCDURATION());
-registerFunc(new TOIFCTIMESTAMP_js_1.TOIFCTIMESTAMP());
-registerFunc(new ADDDURATION_js_1.ADDDURATION());
-registerFunc(new TOLOWERCASE_js_1.TOLOWERCASE());
-registerFunc(new TOUPPERCASE_js_1.TOUPPERCASE());
-registerFunc(new SUBSTRING_js_1.SUBSTRING());
-registerFunc(new SPLIT_js_1.SPLIT());
-registerFunc(new EXISTS_js_1.EXISTS());
-registerFunc(new FuncBooleanBinary_js_1.FuncBooleanBinary("AND", "and"));
-registerFunc(new FuncBooleanBinary_js_1.FuncBooleanBinary("OR", "or"));
-registerFunc(new FuncBooleanBinary_js_1.FuncBooleanBinary("XOR", "xor"));
-registerFunc(new FuncBooleanBinary_js_1.FuncBooleanBinary("IMPLIES", "implies"));
-registerFunc(new EQUALS_js_1.EQUALS());
-registerFunc(new CompareMagnitudes_js_1.CompareMagnitudes("GREATERTHAN", (cmp) => cmp > 0));
-registerFunc(new CompareMagnitudes_js_1.CompareMagnitudes("GREATERTHANOREQUAL", (cmp) => cmp >= 0));
-registerFunc(new CompareMagnitudes_js_1.CompareMagnitudes("LESSTHAN", (cmp) => cmp < 0));
-registerFunc(new CompareMagnitudes_js_1.CompareMagnitudes("LESSTHANOREQUAL", (cmp) => cmp <= 0));
-registerFunc(new MatchesPattern_js_1.MatchesPattern("CONTAINS", true, false));
-registerFunc(new MatchesPattern_js_1.MatchesPattern("MATCHES", true, true));
-registerFunc(new MatchesPattern_js_1.MatchesPattern("REGEXCONTAINS", false, false));
-registerFunc(new MatchesPattern_js_1.MatchesPattern("REGEXMATCHES", false, true));
+registerFunc(withDocumentation(new MAP_js_1.MAP(), "map an input value through a list of key/value mappings", [
+    { label: "input", documentation: "The value to look up" },
+    {
+        label: "mappings",
+        documentation: "The mapping table as [key, value] pairs",
+    },
+    {
+        label: "defaultValue",
+        documentation: "The fallback value to return when no mapping matches",
+    },
+]));
+registerFunc(withDocumentation(new CHOOSE_js_1.CHOOSE(), "return the value from the first matching boolean case", [
+    {
+        label: "cases",
+        documentation: "The candidate [condition, value] pairs to evaluate in order",
+    },
+    {
+        label: "defaultValue",
+        documentation: "The fallback value when no case evaluates to true",
+    },
+]));
+registerFunc(withDocumentation(new AT_js_1.AT(), "return the item at the specified index from an array or tuple", [
+    { label: "input", documentation: "The array or tuple to read from" },
+    { label: "index", documentation: "The zero-based index to read" },
+]));
+registerFunc(withDocumentation(new IF_js_1.IF(), "choose one of two or three values based on a boolean or logical condition", [
+    { label: "condition", documentation: "The condition to evaluate" },
+    {
+        label: "thenValue",
+        documentation: "The value returned when the condition is true",
+    },
+    {
+        label: "elseValue",
+        documentation: "The value returned when the condition is false",
+    },
+    {
+        label: "unknownValue",
+        documentation: "The value returned when a logical condition is unknown",
+    },
+]));
+registerFunc(withDocumentation(new ROUND_js_1.ROUND(), "round a numeric value to the requested number of decimal places", [
+    { label: "input", documentation: "The numeric value to round" },
+    {
+        label: "decimals",
+        documentation: "The number of decimal places to keep",
+    },
+]));
+registerFunc(documentAttributeAccessor("name", "read the name attribute from an IFC object"));
+registerFunc(documentAttributeAccessor("guid", "read the global identifier from an IFC object"));
+registerFunc(documentAttributeAccessor("ifcClass", "read the IFC class name from an IFC object"));
+registerFunc(documentAttributeAccessor("description", "read the description attribute from an IFC object"));
+registerFunc(withDocumentation(new AttributeAccessorFunction_js_1.AttributeAccessorFunction("value", Types_js_1.Types.or(Types_js_1.Type.STRING, Types_js_1.Type.NUMERIC, Types_js_1.Type.BOOLEAN, Types_js_1.Type.ARRAY)), "read the value of an IFC property object", [{ label: "object", documentation: "The IFC property object to read from" }]));
+registerFunc(withDocumentation(new PROPERTYSET_js_1.PROPERTYSET(), "resolve a property set on an IFC object", [
+    { label: "object", documentation: "The IFC object to inspect" },
+    {
+        label: "name",
+        documentation: "The name of the property set to resolve",
+    },
+]));
+registerFunc(withDocumentation(new PROPERTY_js_1.PROPERTY(), "resolve a property on an IFC element, type object, or property set", [
+    { label: "object", documentation: "The IFC object to inspect" },
+    { label: "name", documentation: "The name of the property to resolve" },
+]));
+registerFunc(withDocumentation(new TYPE_js_1.TYPE(), "resolve the IFC type object of an element", [
+    { label: "object", documentation: "The IFC element to inspect" },
+]));
+registerFunc(withDocumentation(new NOT_js_1.NOT(), "negate a boolean or logical value", [
+    { label: "value", documentation: "The value to negate" },
+]));
+registerFunc(withDocumentation(new TOSTRING_js_1.TOSTRING(), "convert a value to its string representation", [{ label: "input", documentation: "The value to convert" }]));
+registerFunc(withDocumentation(new TONUMERIC_js_1.TONUMERIC(), "convert a value to a numeric representation", [{ label: "input", documentation: "The value to convert" }]), "TONUMBER");
+registerFunc(withDocumentation(new TOBOOLEAN_js_1.TOBOOLEAN(), "convert a value to a boolean representation", [{ label: "input", documentation: "The value to convert" }]));
+registerFunc(withDocumentation(new TOLOGICAL_js_1.TOLOGICAL(), "convert a value to a logical representation that can be true, false, or unknown", [{ label: "input", documentation: "The value to convert" }]), "NOTFOUNDASUNKNOWN");
+registerFunc(withDocumentation(new TOIFCDATE_js_1.TOIFCDATE(), "convert a value to an IFC date", [
+    { label: "input", documentation: "The value to convert" },
+]));
+registerFunc(withDocumentation(new TOIFCTIME_js_1.TOIFCTIME(), "convert a value to an IFC time", [
+    { label: "input", documentation: "The value to convert" },
+]));
+registerFunc(withDocumentation(new TOIFCDATETIME_js_1.TOIFCDATETIME(), "convert a value to an IFC date-time", [{ label: "input", documentation: "The value to convert" }]));
+registerFunc(withDocumentation(new TOIFCDURATION_js_1.TOIFCDURATION(), "convert a value to an IFC duration", [
+    { label: "input", documentation: "The value to convert" },
+]));
+registerFunc(withDocumentation(new TOIFCTIMESTAMP_js_1.TOIFCTIMESTAMP(), "convert a value to an IFC timestamp", [{ label: "input", documentation: "The value to convert" }]));
+registerFunc(withDocumentation(new ADDDURATION_js_1.ADDDURATION(), "add a duration to an IFC date-time or timestamp", [
+    {
+        label: "pointInTime",
+        documentation: "The IFC date-time or timestamp to shift",
+    },
+    { label: "duration", documentation: "The duration to add" },
+]));
+registerFunc(withDocumentation(new TOLOWERCASE_js_1.TOLOWERCASE(), "convert a string to lowercase", [
+    { label: "input", documentation: "The string to transform" },
+]));
+registerFunc(withDocumentation(new TOUPPERCASE_js_1.TOUPPERCASE(), "convert a string to uppercase", [
+    { label: "input", documentation: "The string to transform" },
+]));
+registerFunc(withDocumentation(new SUBSTRING_js_1.SUBSTRING(), "extract a substring from a string", [
+    { label: "input", documentation: "The source string" },
+    { label: "from", documentation: "The inclusive start index" },
+    { label: "to", documentation: "The exclusive end index" },
+]));
+registerFunc(withDocumentation(new SPLIT_js_1.SPLIT(), "split a string into an array of substrings", [
+    { label: "input", documentation: "The source string" },
+    { label: "separator", documentation: "The separator string to split on" },
+    { label: "limit", documentation: "The maximum number of resulting items" },
+]));
+registerFunc(withDocumentation(new EXISTS_js_1.EXISTS(), "check whether an IFC reference can be resolved", [{ label: "object", documentation: "The IFC reference to test" }]));
+registerFunc(withDocumentation(new FuncBooleanBinary_js_1.FuncBooleanBinary("AND", "and"), "return true only when both inputs are true", [
+    { label: "left", documentation: "The left logical operand" },
+    { label: "right", documentation: "The right logical operand" },
+]));
+registerFunc(withDocumentation(new FuncBooleanBinary_js_1.FuncBooleanBinary("OR", "or"), "return true when at least one input is true", [
+    { label: "left", documentation: "The left logical operand" },
+    { label: "right", documentation: "The right logical operand" },
+]));
+registerFunc(withDocumentation(new FuncBooleanBinary_js_1.FuncBooleanBinary("XOR", "xor"), "return true when exactly one input is true", [
+    { label: "left", documentation: "The left logical operand" },
+    { label: "right", documentation: "The right logical operand" },
+]));
+registerFunc(withDocumentation(new FuncBooleanBinary_js_1.FuncBooleanBinary("IMPLIES", "implies"), "evaluate logical implication from left to right", [
+    { label: "left", documentation: "The premise" },
+    { label: "right", documentation: "The consequence" },
+]));
+registerFunc(withDocumentation(new EQUALS_js_1.EQUALS(), "compare two values for equality", [
+    { label: "left", documentation: "The left value to compare" },
+    { label: "right", documentation: "The right value to compare" },
+]));
+registerFunc(withDocumentation(new CompareMagnitudes_js_1.CompareMagnitudes("GREATERTHAN", (cmp) => cmp > 0), "return true when the left value is greater than the right value", [
+    { label: "left", documentation: "The left value to compare" },
+    { label: "right", documentation: "The right value to compare" },
+]));
+registerFunc(withDocumentation(new CompareMagnitudes_js_1.CompareMagnitudes("GREATERTHANOREQUAL", (cmp) => cmp >= 0), "return true when the left value is greater than or equal to the right value", [
+    { label: "left", documentation: "The left value to compare" },
+    { label: "right", documentation: "The right value to compare" },
+]));
+registerFunc(withDocumentation(new CompareMagnitudes_js_1.CompareMagnitudes("LESSTHAN", (cmp) => cmp < 0), "return true when the left value is less than the right value", [
+    { label: "left", documentation: "The left value to compare" },
+    { label: "right", documentation: "The right value to compare" },
+]));
+registerFunc(withDocumentation(new CompareMagnitudes_js_1.CompareMagnitudes("LESSTHANOREQUAL", (cmp) => cmp <= 0), "return true when the left value is less than or equal to the right value", [
+    { label: "left", documentation: "The left value to compare" },
+    { label: "right", documentation: "The right value to compare" },
+]));
+registerFunc(withDocumentation(new MatchesPattern_js_1.MatchesPattern("CONTAINS", true, false), "check whether the input contains a simple wildcard pattern", [
+    { label: "input", documentation: "The source string" },
+    { label: "pattern", documentation: "The wildcard pattern to search for" },
+]));
+registerFunc(withDocumentation(new MatchesPattern_js_1.MatchesPattern("MATCHES", true, true), "check whether the input fully matches a simple wildcard pattern", [
+    { label: "input", documentation: "The source string" },
+    { label: "pattern", documentation: "The wildcard pattern to match" },
+]));
+registerFunc(withDocumentation(new MatchesPattern_js_1.MatchesPattern("REGEXCONTAINS", false, false), "check whether the input contains a regular-expression match", [
+    { label: "input", documentation: "The source string" },
+    {
+        label: "pattern",
+        documentation: "The regular expression to search for",
+    },
+]));
+registerFunc(withDocumentation(new MatchesPattern_js_1.MatchesPattern("REGEXMATCHES", false, true), "check whether the input fully matches a regular expression", [
+    { label: "input", documentation: "The source string" },
+    { label: "pattern", documentation: "The regular expression to match" },
+]));
 registerFunc(new ReplacePattern_js_1.ReplacePattern("REPLACE", true));
 registerFunc(new ReplacePattern_js_1.ReplacePattern("REGEXREPLACE", false));
 //# sourceMappingURL=IfcExpressionFunctions.js.map