@bpmn-io/feel-editor 1.9.0 → 1.10.0

package/dist/index.es.js

@@ -391,9 +391,14 @@ function completions({ variables = [], builtins = [] }) {
  * @typedef { 'expression' | 'unaryTests' } Dialect
  */
 
+/**
+ * @typedef { 'camunda' | undefined } ParserDialect
+ */
+
 /**
  * @param { {
  *   dialect?: Dialect,
+ *   parserDialect?: ParserDialect,
  *   context?: Record<string, any>,
  *   completions?: import('@codemirror/autocomplete').CompletionSource[]
  * } } options
@@ -409,7 +414,7 @@ function language(options) {
  *
  * @return {Record<string, any>}
  */
-function createContext(variables, builtins) {
+function createContext(variables) {
   return variables.slice().reverse().reduce((context, builtin) => {
     context[builtin.name] = () => {};
 
@@ -418,7 +423,8 @@ function createContext(variables, builtins) {
 }
 
 /**
- * @typedef { 'expression' | 'unaryTests' } Dialect
+ * @typedef { import('../language').Dialect } Dialect
+ * @typedef { import('../language').ParserDialect } ParserDialect
  * @typedef { import('..').Variable } Variable
  */
 
@@ -433,10 +439,15 @@ const builtinsFacet = Facet.define();
 const variablesFacet = Facet.define();
 
 /**
- * @type {Facet<dialect>}
+ * @type {Facet<Dialect>}
  */
 const dialectFacet = Facet.define();
 
+/**
+ * @type {Facet<ParserDialect>}
+ */
+const parserDialectFacet = Facet.define();
+
 /**
  * @typedef {object} Variable
  * @property {string} name name or key of the variable
@@ -451,6 +462,7 @@ const dialectFacet = Facet.define();
 /**
  * @typedef { {
  *   dialect?: import('../language').Dialect,
+ *   parserDialect?: import('../language').ParserDialect,
  *   variables?: Variable[],
  *   builtins?: Variable[]
  * } } CoreConfig
@@ -466,6 +478,7 @@ const dialectFacet = Facet.define();
  */
 function configure({
   dialect = 'expression',
+  parserDialect,
   variables = [],
   builtins = [],
   completions: completions$1 = completions({ builtins, variables })
@@ -477,8 +490,10 @@ function configure({
     dialectFacet.of(dialect),
     builtinsFacet.of(builtins),
     variablesFacet.of(variables),
+    parserDialectFacet.of(parserDialect),
     language({
       dialect,
+      parserDialect,
       context,
       completions: completions$1
     })
@@ -495,11 +510,13 @@ function get(state) {
   const builtins = state.facet(builtinsFacet)[0];
   const variables = state.facet(variablesFacet)[0];
   const dialect = state.facet(dialectFacet)[0];
+  const parserDialect = state.facet(parserDialectFacet)[0];
 
   return {
     builtins,
     variables,
-    dialect
+    dialect,
+    parserDialect
   };
 }
 
@@ -554,7 +571,7 @@ var camundaTags = [
 	},
 	{
 		name: "number(from)",
-		description: "<p>Parses the given string to a number.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">number(from: string): number\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">number(&quot;1500.5&quot;)\n// 1500.5\n</code></pre>\n"
+		description: "<p>Parses the given string to a number.</p>\n<p>Returns <code>null</code> if the string is not a number.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">number(from: string): number\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">number(&quot;1500.5&quot;)\n// 1500.5\n</code></pre>\n"
 	},
 	{
 		name: "context(entries)",
@@ -562,11 +579,11 @@ var camundaTags = [
 	},
 	{
 		name: "date(from)",
-		description: "<p>Returns a date from the given value.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">date(from: string): date\n</code></pre>\n<p>Parses the given string into a date.</p>\n<pre><code class=\"language-feel\">date(from: date and time): date\n</code></pre>\n<p>Extracts the date component from the given date and time.</p>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">date(&quot;2018-04-29&quot;)\n// date(&quot;2018-04-29&quot;)\n\ndate(date and time(&quot;2012-12-25T11:00:00&quot;))\n// date(&quot;2012-12-25&quot;)\n</code></pre>\n"
+		description: "<p>Returns a date from the given value.</p>\n<p>Returns <code>null</code> if the string is not a valid calendar date. For example, <code>&quot;2024-06-31&quot;</code> is invalid because June has\nonly 30 days.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">date(from: string): date\n</code></pre>\n<p>Parses the given string into a date.</p>\n<pre><code class=\"language-feel\">date(from: date and time): date\n</code></pre>\n<p>Extracts the date component from the given date and time.</p>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">date(&quot;2018-04-29&quot;)\n// date(&quot;2018-04-29&quot;)\n\ndate(date and time(&quot;2012-12-25T11:00:00&quot;))\n// date(&quot;2012-12-25&quot;)\n</code></pre>\n"
 	},
 	{
 		name: "date(year, month, day)",
-		description: "<p>Returns a date from the given components.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">date(year: number, month: number, day: number): date\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">date(2012, 12, 25)\n// date(&quot;2012-12-25&quot;)\n</code></pre>\n"
+		description: "<p>Returns a date from the given components.</p>\n<p>Returns <code>null</code> if the components don&#39;t represent a valid calendar date. For example, <code>2024,6,31</code> is invalid because\nJune has only 30 days.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">date(year: number, month: number, day: number): date\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">date(2012, 12, 25)\n// date(&quot;2012-12-25&quot;)\n</code></pre>\n"
 	},
 	{
 		name: "time(from)",
@@ -582,7 +599,7 @@ var camundaTags = [
 	},
 	{
 		name: "date and time(from)",
-		description: "<p>Parses the given string into a date and time.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">date and time(from: string): date and time\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">date and time(&quot;2018-04-29T09:30:00&quot;)\n// date and time(&quot;2018-04-29T09:30:00&quot;)\n</code></pre>\n"
+		description: "<p>Parses the given string into a date and time.</p>\n<p>Returns <code>null</code> if the string is not a valid calendar date. For example, <code>&quot;2024-06-31T10:00:00&quot;</code> is invalid because\nJune has only 30 days.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">date and time(from: string): date and time\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">date and time(&quot;2018-04-29T09:30:00&quot;)\n// date and time(&quot;2018-04-29T09:30:00&quot;)\n</code></pre>\n"
 	},
 	{
 		name: "date and time(date, time)",
@@ -712,6 +729,14 @@ var camundaTags = [
 		name: "string join(list, delimiter, prefix, suffix)",
 		description: "<p><em>Camunda Extension</em></p>\n<p>Joins a list of strings into a single string. This is similar to\nJava&#39;s <a href=\"https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/stream/Collectors.html#joining(java.lang.CharSequence,java.lang.CharSequence,java.lang.CharSequence)\">joining</a>\nfunction.</p>\n<p>If an item of the list is <code>null</code>, the item is ignored for the result string. If an item is\nneither a string nor <code>null</code>, the function returns <code>null</code> instead of a string.</p>\n<p>The resulting string starts with <code>prefix</code>, contains a <code>delimiter</code> between each element, and ends\nwith <code>suffix</code>.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">string join(list: list&lt;string&gt;, delimiter: string, prefix: string, suffix: string): string\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">string join([&quot;a&quot;,&quot;b&quot;,&quot;c&quot;], &quot;, &quot;, &quot;[&quot;, &quot;]&quot;)\n// &quot;[a, b, c]&quot;\n</code></pre>\n"
 	},
+	{
+		name: "is empty(list)",
+		description: "<p><em>Camunda Extension</em></p>\n<p>Returns <code>true</code> if the given list is empty. Otherwise, returns <code>false</code>.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">is empty(list: list): boolean\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">is empty([])\n// true\n\nis empty([1,2,3])\n// false\n</code></pre>\n"
+	},
+	{
+		name: "partition(list， size)",
+		description: "<p><em>Camunda Extension</em></p>\n<p>Returns consecutive sublists of a list, each of the same size (the final list may be smaller).</p>\n<p>If <code>size</code> is less than <code>0</code>, it returns <code>null</code>.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">partition(list: list, size: number): list\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">partition([1,2,3,4,5], 2)\n// [[1,2], [3,4], [5]]\n\npartition([], 2)\n// []\n\npartition([1,2], 0)\n// null\n</code></pre>\n"
+	},
 	{
 		name: "decimal(n, scale)",
 		description: "<p>Rounds the given value at the given scale.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">decimal(n: number, scale: number): number\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">decimal(1/3, 2)\n// .33\n\ndecimal(1.5, 0)\n// 2\n</code></pre>\n"
@@ -890,11 +915,11 @@ var camundaTags = [
 	},
 	{
 		name: "substring(string, start position)",
-		description: "<p>Returns a substring of the given value starting at <code>start position</code>.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">substring(string: string, start position: number): string\n</code></pre>\n<p>The <code>start position</code> starts at the index <code>1</code>. The last position is <code>-1</code>.</p>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">substring(&quot;foobar&quot;, 3)\n// &quot;obar&quot;\n</code></pre>\n"
+		description: "<p>Returns a substring of the given value starting at <code>start position</code>.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">substring(string: string, start position: number): string\n</code></pre>\n<p>The <code>start position</code> starts at the index <code>1</code>. The last position is <code>-1</code>.</p>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">substring(&quot;foobar&quot;, 3)\n// &quot;obar&quot;\n\nsubstring(&quot;foobar&quot;, -2)\n// &quot;ar&quot;\n</code></pre>\n"
 	},
 	{
 		name: "substring(string, start position, length)",
-		description: "<p>Returns a substring of the given value starting at <code>start position</code>.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">substring(string: string, start position: number, length: number): string\n</code></pre>\n<p>The <code>start position</code> starts at the index <code>1</code>. The last position is <code>-1</code>.</p>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">substring(&quot;foobar&quot;, 3, 3)\n// &quot;oba&quot;\n</code></pre>\n"
+		description: "<p>Returns a substring of the given value, starting at <code>start position</code> with the given <code>length</code>. If <code>length</code> is greater than\nthe remaining characters of the value, it returns all characters from <code>start position</code> until the end.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">substring(string: string, start position: number, length: number): string\n</code></pre>\n<p>The <code>start position</code> starts at the index <code>1</code>. The last position is <code>-1</code>.</p>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">substring(&quot;foobar&quot;, 3, 3)\n// &quot;oba&quot;\n\nsubstring(&quot;foobar&quot;, -3, 2)\n// &quot;ba&quot;\n\nsubstring(&quot;foobar&quot;, 3, 10)\n// &quot;obar&quot;\n</code></pre>\n"
 	},
 	{
 		name: "string length(string)",
@@ -952,6 +977,22 @@ var camundaTags = [
 		name: "extract(string, pattern)",
 		description: "<p><em>Camunda Extension</em></p>\n<p>Returns all matches of the pattern in the given string. Returns an empty list if the pattern doesn&#39;t\nmatch.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">extract(string: string, pattern: string): list&lt;string&gt;\n</code></pre>\n<p>The <code>pattern</code> is a string that contains a regular expression.</p>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">extract(&quot;references are 1234, 1256, 1378&quot;, &quot;12[0-9]*&quot;)\n// [&quot;1234&quot;,&quot;1256&quot;]\n</code></pre>\n"
 	},
+	{
+		name: "trim(string)",
+		description: "<p><em>Camunda Extension</em></p>\n<p>Returns the given string without leading and trailing spaces.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">trim(string: string): string\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">trim(&quot;  hello world  &quot;)\n// &quot;hello world&quot;\n\ntrim(&quot;hello   world &quot;)\n// &quot;hello   world&quot;\n</code></pre>\n"
+	},
+	{
+		name: "uuid()",
+		description: "<p><em>Camunda Extension</em></p>\n<p>Returns a UUID (Universally Unique Identifier) with 36 characters.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">uuid(): string\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">uuid()\n// &quot;7793aab1-d761-4d38-916b-b7270e309894&quot;\n</code></pre>\n"
+	},
+	{
+		name: "to base64(value)",
+		description: "<p><em>Camunda Extension</em></p>\n<p>Returns the given string encoded in Base64 format.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">to base64(value: string): string\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">to base64(&quot;FEEL&quot;)\n// &quot;RkVFTA==&quot;\n</code></pre>\n"
+	},
+	{
+		name: "is blank(string)",
+		description: "<p><em>Camunda Extension</em></p>\n<p>Returns <code>true</code> if the given string is blank (empty or contains only whitespaces).</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">is blank(string: string): boolean\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">is blank(&quot;&quot;)\n// true\n\nis blank(&quot; &quot;)\n// true\n\nis blank(&quot;hello world&quot;)\n// false\n</code></pre>\n"
+	},
 	{
 		name: "now()",
 		description: "<p>Returns the current date and time including the timezone.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">now(): date and time\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">now()\n// date and time(&quot;2020-07-31T14:27:30@Europe/Berlin&quot;)\n</code></pre>\n"
@@ -983,22 +1024,6 @@ var camundaTags = [
 	{
 		name: "last day of month(date)",
 		description: "<p><em>Camunda Extension</em></p>\n<p>Takes the month of the given date or date-time value and returns the last day of this month.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">last day of month(date: date): date\n</code></pre>\n<pre><code class=\"language-feel\">last day of month(date: date and time): date\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">last day of month(date(&quot;2022-10-01&quot;))\n// date(&quot;2022-10-31&quot;))\n\nlast day of month(date and time(&quot;2022-10-16T12:00:00&quot;))\n// date(&quot;2022-10-31&quot;))\n</code></pre>\n"
-	},
-	{
-		name: "is empty(list)",
-		description: "<p><em>Camunda Extension</em></p>\n<p>Returns true if the given list is empty. Otherwise, returns false.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">is empty(list: list): boolean</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">is empty([])\n// true\n\nis empty([1,2,3])\n// false\n</code></pre>"
-	},
-	{
-		name: "trim(string)",
-		description: "<p><em>Camunda Extension</em></p>\n<p>Returns the given string without leading and trailing spaces.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">trim(string: string): string</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">trim(\"  hello world  \")\n// \"hello world\"\n\ntrim(\"hello   world \")\n// \"hello   world\"\n</code></pre>"
-	},
-	{
-		name: "uuid()",
-		description: "<p><em>Camunda Extension</em></p>\n<p>Returns a UUID (Universally Unique Identifier) with 36 characters.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">uuid(): string</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">uuid()\n// \"7793aab1-d761-4d38-916b-b7270e309894\"\n</code></pre>"
-	},
-	{
-		name: "to base64(string)",
-		description: "<p><em>Camunda Extension</em></p>\n<p>Returns the given string encoded in Base64 format.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">to base64(value: string): string</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">to base64(\"FEEL\")\n// \"RkVFTA==\"\n</code></pre>"
 	}
 ];
 
@@ -1027,7 +1052,8 @@ function parseBuiltin(builtin) {
   const functionName = match[1];
   const functionArguments = match[2];
 
-  const params = functionArguments.split(', ').map(name => ({ name }));
+  // parameterless function matches as empty string
+  const params = functionArguments ? functionArguments.split(', ').map(name => ({ name })) : [];
 
   return {
     name: functionName,
@@ -1046,6 +1072,11 @@ const camunda = parseBuiltins(camundaTags);
  * @typedef { import('./core').Variable } Variable
  */
 
+/**
+ * @typedef { import('./language').Dialect } Dialect
+ * @typedef { import('./language').ParserDialect } ParserDialect
+ */
+
 /**
  * @typedef {object} Builtin
  * @property {string} name
@@ -1063,6 +1094,7 @@ const placeholderConf = new Compartment();
  * @param {DOMNode} config.container
  * @param {Extension[]} [config.extensions]
  * @param {Dialect} [config.dialect='expression']
+ * @param {ParserDialect} [config.parserDialect]
  * @param {DOMNode|String} [config.tooltipContainer]
  * @param {Function} [config.onChange]
  * @param {Function} [config.onKeyDown]
@@ -1071,12 +1103,11 @@ const placeholderConf = new Compartment();
  * @param {String} [config.value]
  * @param {Variable[]} [config.variables]
  * @param {Variable[]} [config.builtins]
- *
- * @returns {Object} editor
  */
 function FeelEditor({
   extensions: editorExtensions = [],
   dialect = 'expression',
+  parserDialect,
   container,
   contentAttributes = {},
   tooltipContainer,
@@ -1131,7 +1162,8 @@ function FeelEditor({
     coreConf.of(configure({
       dialect,
       builtins,
-      variables
+      variables,
+      parserDialect
     })),
     bracketMatching(),
     indentOnInput(),
@@ -1215,16 +1247,12 @@ FeelEditor.prototype.getSelection = function() {
  */
 FeelEditor.prototype.setVariables = function(variables) {
 
-  const {
-    dialect,
-    builtins
-  } = get(this._cmEditor.state);
+  const config = get(this._cmEditor.state);
 
   this._cmEditor.dispatch({
     effects: [
       coreConf.reconfigure(configure({
-        dialect,
-        builtins,
+        ...config,
         variables
       }))
     ]

package/dist/index.js

@@ -393,9 +393,14 @@ function completions({ variables = [], builtins = [] }) {
  * @typedef { 'expression' | 'unaryTests' } Dialect
  */
 
+/**
+ * @typedef { 'camunda' | undefined } ParserDialect
+ */
+
 /**
  * @param { {
  *   dialect?: Dialect,
+ *   parserDialect?: ParserDialect,
  *   context?: Record<string, any>,
  *   completions?: import('@codemirror/autocomplete').CompletionSource[]
  * } } options
@@ -411,7 +416,7 @@ function language(options) {
  *
  * @return {Record<string, any>}
  */
-function createContext(variables, builtins) {
+function createContext(variables) {
   return variables.slice().reverse().reduce((context, builtin) => {
     context[builtin.name] = () => {};
 
@@ -420,7 +425,8 @@ function createContext(variables, builtins) {
 }
 
 /**
- * @typedef { 'expression' | 'unaryTests' } Dialect
+ * @typedef { import('../language').Dialect } Dialect
+ * @typedef { import('../language').ParserDialect } ParserDialect
  * @typedef { import('..').Variable } Variable
  */
 
@@ -435,10 +441,15 @@ const builtinsFacet = state.Facet.define();
 const variablesFacet = state.Facet.define();
 
 /**
- * @type {Facet<dialect>}
+ * @type {Facet<Dialect>}
  */
 const dialectFacet = state.Facet.define();
 
+/**
+ * @type {Facet<ParserDialect>}
+ */
+const parserDialectFacet = state.Facet.define();
+
 /**
  * @typedef {object} Variable
  * @property {string} name name or key of the variable
@@ -453,6 +464,7 @@ const dialectFacet = state.Facet.define();
 /**
  * @typedef { {
  *   dialect?: import('../language').Dialect,
+ *   parserDialect?: import('../language').ParserDialect,
  *   variables?: Variable[],
  *   builtins?: Variable[]
  * } } CoreConfig
@@ -468,6 +480,7 @@ const dialectFacet = state.Facet.define();
  */
 function configure({
   dialect = 'expression',
+  parserDialect,
   variables = [],
   builtins = [],
   completions: completions$1 = completions({ builtins, variables })
@@ -479,8 +492,10 @@ function configure({
     dialectFacet.of(dialect),
     builtinsFacet.of(builtins),
     variablesFacet.of(variables),
+    parserDialectFacet.of(parserDialect),
     language({
       dialect,
+      parserDialect,
       context,
       completions: completions$1
     })
@@ -497,11 +512,13 @@ function get(state) {
   const builtins = state.facet(builtinsFacet)[0];
   const variables = state.facet(variablesFacet)[0];
   const dialect = state.facet(dialectFacet)[0];
+  const parserDialect = state.facet(parserDialectFacet)[0];
 
   return {
     builtins,
     variables,
-    dialect
+    dialect,
+    parserDialect
   };
 }
 
@@ -556,7 +573,7 @@ var camundaTags = [
 	},
 	{
 		name: "number(from)",
-		description: "<p>Parses the given string to a number.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">number(from: string): number\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">number(&quot;1500.5&quot;)\n// 1500.5\n</code></pre>\n"
+		description: "<p>Parses the given string to a number.</p>\n<p>Returns <code>null</code> if the string is not a number.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">number(from: string): number\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">number(&quot;1500.5&quot;)\n// 1500.5\n</code></pre>\n"
 	},
 	{
 		name: "context(entries)",
@@ -564,11 +581,11 @@ var camundaTags = [
 	},
 	{
 		name: "date(from)",
-		description: "<p>Returns a date from the given value.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">date(from: string): date\n</code></pre>\n<p>Parses the given string into a date.</p>\n<pre><code class=\"language-feel\">date(from: date and time): date\n</code></pre>\n<p>Extracts the date component from the given date and time.</p>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">date(&quot;2018-04-29&quot;)\n// date(&quot;2018-04-29&quot;)\n\ndate(date and time(&quot;2012-12-25T11:00:00&quot;))\n// date(&quot;2012-12-25&quot;)\n</code></pre>\n"
+		description: "<p>Returns a date from the given value.</p>\n<p>Returns <code>null</code> if the string is not a valid calendar date. For example, <code>&quot;2024-06-31&quot;</code> is invalid because June has\nonly 30 days.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">date(from: string): date\n</code></pre>\n<p>Parses the given string into a date.</p>\n<pre><code class=\"language-feel\">date(from: date and time): date\n</code></pre>\n<p>Extracts the date component from the given date and time.</p>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">date(&quot;2018-04-29&quot;)\n// date(&quot;2018-04-29&quot;)\n\ndate(date and time(&quot;2012-12-25T11:00:00&quot;))\n// date(&quot;2012-12-25&quot;)\n</code></pre>\n"
 	},
 	{
 		name: "date(year, month, day)",
-		description: "<p>Returns a date from the given components.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">date(year: number, month: number, day: number): date\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">date(2012, 12, 25)\n// date(&quot;2012-12-25&quot;)\n</code></pre>\n"
+		description: "<p>Returns a date from the given components.</p>\n<p>Returns <code>null</code> if the components don&#39;t represent a valid calendar date. For example, <code>2024,6,31</code> is invalid because\nJune has only 30 days.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">date(year: number, month: number, day: number): date\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">date(2012, 12, 25)\n// date(&quot;2012-12-25&quot;)\n</code></pre>\n"
 	},
 	{
 		name: "time(from)",
@@ -584,7 +601,7 @@ var camundaTags = [
 	},
 	{
 		name: "date and time(from)",
-		description: "<p>Parses the given string into a date and time.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">date and time(from: string): date and time\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">date and time(&quot;2018-04-29T09:30:00&quot;)\n// date and time(&quot;2018-04-29T09:30:00&quot;)\n</code></pre>\n"
+		description: "<p>Parses the given string into a date and time.</p>\n<p>Returns <code>null</code> if the string is not a valid calendar date. For example, <code>&quot;2024-06-31T10:00:00&quot;</code> is invalid because\nJune has only 30 days.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">date and time(from: string): date and time\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">date and time(&quot;2018-04-29T09:30:00&quot;)\n// date and time(&quot;2018-04-29T09:30:00&quot;)\n</code></pre>\n"
 	},
 	{
 		name: "date and time(date, time)",
@@ -714,6 +731,14 @@ var camundaTags = [
 		name: "string join(list, delimiter, prefix, suffix)",
 		description: "<p><em>Camunda Extension</em></p>\n<p>Joins a list of strings into a single string. This is similar to\nJava&#39;s <a href=\"https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/stream/Collectors.html#joining(java.lang.CharSequence,java.lang.CharSequence,java.lang.CharSequence)\">joining</a>\nfunction.</p>\n<p>If an item of the list is <code>null</code>, the item is ignored for the result string. If an item is\nneither a string nor <code>null</code>, the function returns <code>null</code> instead of a string.</p>\n<p>The resulting string starts with <code>prefix</code>, contains a <code>delimiter</code> between each element, and ends\nwith <code>suffix</code>.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">string join(list: list&lt;string&gt;, delimiter: string, prefix: string, suffix: string): string\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">string join([&quot;a&quot;,&quot;b&quot;,&quot;c&quot;], &quot;, &quot;, &quot;[&quot;, &quot;]&quot;)\n// &quot;[a, b, c]&quot;\n</code></pre>\n"
 	},
+	{
+		name: "is empty(list)",
+		description: "<p><em>Camunda Extension</em></p>\n<p>Returns <code>true</code> if the given list is empty. Otherwise, returns <code>false</code>.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">is empty(list: list): boolean\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">is empty([])\n// true\n\nis empty([1,2,3])\n// false\n</code></pre>\n"
+	},
+	{
+		name: "partition(list， size)",
+		description: "<p><em>Camunda Extension</em></p>\n<p>Returns consecutive sublists of a list, each of the same size (the final list may be smaller).</p>\n<p>If <code>size</code> is less than <code>0</code>, it returns <code>null</code>.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">partition(list: list, size: number): list\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">partition([1,2,3,4,5], 2)\n// [[1,2], [3,4], [5]]\n\npartition([], 2)\n// []\n\npartition([1,2], 0)\n// null\n</code></pre>\n"
+	},
 	{
 		name: "decimal(n, scale)",
 		description: "<p>Rounds the given value at the given scale.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">decimal(n: number, scale: number): number\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">decimal(1/3, 2)\n// .33\n\ndecimal(1.5, 0)\n// 2\n</code></pre>\n"
@@ -892,11 +917,11 @@ var camundaTags = [
 	},
 	{
 		name: "substring(string, start position)",
-		description: "<p>Returns a substring of the given value starting at <code>start position</code>.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">substring(string: string, start position: number): string\n</code></pre>\n<p>The <code>start position</code> starts at the index <code>1</code>. The last position is <code>-1</code>.</p>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">substring(&quot;foobar&quot;, 3)\n// &quot;obar&quot;\n</code></pre>\n"
+		description: "<p>Returns a substring of the given value starting at <code>start position</code>.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">substring(string: string, start position: number): string\n</code></pre>\n<p>The <code>start position</code> starts at the index <code>1</code>. The last position is <code>-1</code>.</p>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">substring(&quot;foobar&quot;, 3)\n// &quot;obar&quot;\n\nsubstring(&quot;foobar&quot;, -2)\n// &quot;ar&quot;\n</code></pre>\n"
 	},
 	{
 		name: "substring(string, start position, length)",
-		description: "<p>Returns a substring of the given value starting at <code>start position</code>.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">substring(string: string, start position: number, length: number): string\n</code></pre>\n<p>The <code>start position</code> starts at the index <code>1</code>. The last position is <code>-1</code>.</p>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">substring(&quot;foobar&quot;, 3, 3)\n// &quot;oba&quot;\n</code></pre>\n"
+		description: "<p>Returns a substring of the given value, starting at <code>start position</code> with the given <code>length</code>. If <code>length</code> is greater than\nthe remaining characters of the value, it returns all characters from <code>start position</code> until the end.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">substring(string: string, start position: number, length: number): string\n</code></pre>\n<p>The <code>start position</code> starts at the index <code>1</code>. The last position is <code>-1</code>.</p>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">substring(&quot;foobar&quot;, 3, 3)\n// &quot;oba&quot;\n\nsubstring(&quot;foobar&quot;, -3, 2)\n// &quot;ba&quot;\n\nsubstring(&quot;foobar&quot;, 3, 10)\n// &quot;obar&quot;\n</code></pre>\n"
 	},
 	{
 		name: "string length(string)",
@@ -954,6 +979,22 @@ var camundaTags = [
 		name: "extract(string, pattern)",
 		description: "<p><em>Camunda Extension</em></p>\n<p>Returns all matches of the pattern in the given string. Returns an empty list if the pattern doesn&#39;t\nmatch.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">extract(string: string, pattern: string): list&lt;string&gt;\n</code></pre>\n<p>The <code>pattern</code> is a string that contains a regular expression.</p>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">extract(&quot;references are 1234, 1256, 1378&quot;, &quot;12[0-9]*&quot;)\n// [&quot;1234&quot;,&quot;1256&quot;]\n</code></pre>\n"
 	},
+	{
+		name: "trim(string)",
+		description: "<p><em>Camunda Extension</em></p>\n<p>Returns the given string without leading and trailing spaces.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">trim(string: string): string\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">trim(&quot;  hello world  &quot;)\n// &quot;hello world&quot;\n\ntrim(&quot;hello   world &quot;)\n// &quot;hello   world&quot;\n</code></pre>\n"
+	},
+	{
+		name: "uuid()",
+		description: "<p><em>Camunda Extension</em></p>\n<p>Returns a UUID (Universally Unique Identifier) with 36 characters.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">uuid(): string\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">uuid()\n// &quot;7793aab1-d761-4d38-916b-b7270e309894&quot;\n</code></pre>\n"
+	},
+	{
+		name: "to base64(value)",
+		description: "<p><em>Camunda Extension</em></p>\n<p>Returns the given string encoded in Base64 format.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">to base64(value: string): string\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">to base64(&quot;FEEL&quot;)\n// &quot;RkVFTA==&quot;\n</code></pre>\n"
+	},
+	{
+		name: "is blank(string)",
+		description: "<p><em>Camunda Extension</em></p>\n<p>Returns <code>true</code> if the given string is blank (empty or contains only whitespaces).</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">is blank(string: string): boolean\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">is blank(&quot;&quot;)\n// true\n\nis blank(&quot; &quot;)\n// true\n\nis blank(&quot;hello world&quot;)\n// false\n</code></pre>\n"
+	},
 	{
 		name: "now()",
 		description: "<p>Returns the current date and time including the timezone.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">now(): date and time\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">now()\n// date and time(&quot;2020-07-31T14:27:30@Europe/Berlin&quot;)\n</code></pre>\n"
@@ -985,22 +1026,6 @@ var camundaTags = [
 	{
 		name: "last day of month(date)",
 		description: "<p><em>Camunda Extension</em></p>\n<p>Takes the month of the given date or date-time value and returns the last day of this month.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">last day of month(date: date): date\n</code></pre>\n<pre><code class=\"language-feel\">last day of month(date: date and time): date\n</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">last day of month(date(&quot;2022-10-01&quot;))\n// date(&quot;2022-10-31&quot;))\n\nlast day of month(date and time(&quot;2022-10-16T12:00:00&quot;))\n// date(&quot;2022-10-31&quot;))\n</code></pre>\n"
-	},
-	{
-		name: "is empty(list)",
-		description: "<p><em>Camunda Extension</em></p>\n<p>Returns true if the given list is empty. Otherwise, returns false.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">is empty(list: list): boolean</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">is empty([])\n// true\n\nis empty([1,2,3])\n// false\n</code></pre>"
-	},
-	{
-		name: "trim(string)",
-		description: "<p><em>Camunda Extension</em></p>\n<p>Returns the given string without leading and trailing spaces.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">trim(string: string): string</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">trim(\"  hello world  \")\n// \"hello world\"\n\ntrim(\"hello   world \")\n// \"hello   world\"\n</code></pre>"
-	},
-	{
-		name: "uuid()",
-		description: "<p><em>Camunda Extension</em></p>\n<p>Returns a UUID (Universally Unique Identifier) with 36 characters.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">uuid(): string</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">uuid()\n// \"7793aab1-d761-4d38-916b-b7270e309894\"\n</code></pre>"
-	},
-	{
-		name: "to base64(string)",
-		description: "<p><em>Camunda Extension</em></p>\n<p>Returns the given string encoded in Base64 format.</p>\n<p><strong>Function signature</strong></p>\n<pre><code class=\"language-feel\">to base64(value: string): string</code></pre>\n<p><strong>Examples</strong></p>\n<pre><code class=\"language-feel\">to base64(\"FEEL\")\n// \"RkVFTA==\"\n</code></pre>"
 	}
 ];
 
@@ -1029,7 +1054,8 @@ function parseBuiltin(builtin) {
   const functionName = match[1];
   const functionArguments = match[2];
 
-  const params = functionArguments.split(', ').map(name => ({ name }));
+  // parameterless function matches as empty string
+  const params = functionArguments ? functionArguments.split(', ').map(name => ({ name })) : [];
 
   return {
     name: functionName,
@@ -1048,6 +1074,11 @@ const camunda = parseBuiltins(camundaTags);
  * @typedef { import('./core').Variable } Variable
  */
 
+/**
+ * @typedef { import('./language').Dialect } Dialect
+ * @typedef { import('./language').ParserDialect } ParserDialect
+ */
+
 /**
  * @typedef {object} Builtin
  * @property {string} name
@@ -1065,6 +1096,7 @@ const placeholderConf = new state.Compartment();
  * @param {DOMNode} config.container
  * @param {Extension[]} [config.extensions]
  * @param {Dialect} [config.dialect='expression']
+ * @param {ParserDialect} [config.parserDialect]
  * @param {DOMNode|String} [config.tooltipContainer]
  * @param {Function} [config.onChange]
  * @param {Function} [config.onKeyDown]
@@ -1073,12 +1105,11 @@ const placeholderConf = new state.Compartment();
  * @param {String} [config.value]
  * @param {Variable[]} [config.variables]
  * @param {Variable[]} [config.builtins]
- *
- * @returns {Object} editor
  */
 function FeelEditor({
   extensions: editorExtensions = [],
   dialect = 'expression',
+  parserDialect,
   container,
   contentAttributes = {},
   tooltipContainer,
@@ -1133,7 +1164,8 @@ function FeelEditor({
     coreConf.of(configure({
       dialect,
       builtins,
-      variables
+      variables,
+      parserDialect
     })),
     language$1.bracketMatching(),
     language$1.indentOnInput(),
@@ -1217,16 +1249,12 @@ FeelEditor.prototype.getSelection = function() {
  */
 FeelEditor.prototype.setVariables = function(variables) {
 
-  const {
-    dialect,
-    builtins
-  } = get(this._cmEditor.state);
+  const config = get(this._cmEditor.state);
 
   this._cmEditor.dispatch({
     effects: [
       coreConf.reconfigure(configure({
-        dialect,
-        builtins,
+        ...config,
         variables
       }))
     ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmn-io/feel-editor",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Editor for FEEL expressions.",
   "files": [
     "dist"
@@ -17,6 +17,7 @@
     "lint": "eslint .",
     "pull:platform-docs": "git -C camunda-platform-docs pull || git clone git@github.com:camunda/camunda-platform-docs.git camunda-platform-docs",
     "start": "cross-env SINGLE_START=true npm run dev",
+    "start:camunda": "cross-env SINGLE_START=camunda npm run dev",
     "dev": "npm test -- --auto-watch --no-single-run",
     "prepare": "run-s build"
   },
@@ -47,31 +48,31 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@bpmn-io/feel-lint": "^1.3.0",
+    "@bpmn-io/feel-lint": "^1.4.0",
     "@codemirror/autocomplete": "^6.16.2",
-    "@codemirror/commands": "^6.6.0",
+    "@codemirror/commands": "^6.8.0",
     "@codemirror/language": "^6.10.2",
-    "@codemirror/lint": "^6.8.0",
-    "@codemirror/state": "^6.4.1",
-    "@codemirror/view": "^6.28.1",
-    "@lezer/highlight": "^1.2.0",
-    "lang-feel": "^2.1.1",
+    "@codemirror/lint": "^6.8.4",
+    "@codemirror/state": "^6.5.1",
+    "@codemirror/view": "^6.36.2",
+    "@lezer/highlight": "^1.2.1",
+    "lang-feel": "^2.3.0",
     "min-dom": "^4.2.1"
   },
   "devDependencies": {
-    "@babel/core": "^7.24.6",
-    "@rollup/plugin-commonjs": "^25.0.8",
+    "@babel/core": "^7.26.0",
+    "@rollup/plugin-commonjs": "^28.0.2",
     "@rollup/plugin-json": "^6.1.0",
-    "@testing-library/dom": "^9.3.4",
-    "@testing-library/user-event": "^14.5.2",
-    "babel-loader": "^9.1.3",
-    "babel-plugin-istanbul": "^6.1.1",
-    "chai": "^4.4.1",
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/user-event": "^14.6.1",
+    "babel-loader": "^9.2.1",
+    "babel-plugin-istanbul": "^7.0.0",
+    "chai": "^4.5.0",
     "cross-env": "^7.0.3",
     "eslint": "^8.57.0",
     "eslint-plugin-bpmn-io": "^1.0.0",
-    "glob": "^10.4.1",
-    "karma": "^6.4.3",
+    "glob": "^11.0.1",
+    "karma": "^6.4.4",
     "karma-chrome-launcher": "^3.2.0",
     "karma-coverage": "^2.2.1",
     "karma-debug-launcher": "^0.0.5",
@@ -80,14 +81,14 @@
     "karma-mocha": "^2.0.1",
     "karma-sinon-chai": "^2.0.2",
     "karma-webpack": "^5.0.1",
-    "marked": "^9.1.2",
-    "mocha": "^10.4.0",
+    "marked": "^9.1.6",
+    "mocha": "^10.8.2",
     "mocha-test-container-support": "^0.2.0",
     "npm-run-all": "^4.1.5",
     "puppeteer": "^23.1.1",
-    "rollup": "^4.18.0",
+    "rollup": "^4.31.0",
     "sinon": "^17.0.1",
     "sinon-chai": "^3.7.0",
-    "webpack": "^5.91.0"
+    "webpack": "^5.97.1"
   }
 }