@bpmnkit/camunda-docspack 0.0.0

package/.llms/chunks/components.modeler.feel.builtin-functions.feel-built-in-functions-boolean.md

@@ -0,0 +1,67 @@
+# Boolean functions
+
+This document outlines current boolean functions and a few examples.
+
+
+## not(negand)
+
+Returns the logical negation of the given value.
+
+**Function signature**
+
+```feel
+not(negand: boolean): boolean
+```
+
+**Examples**
+
+```feel
+not(true)
+// false
+
+not(null)
+// null
+```
+
+
+## is defined(value)
+
+(Camunda extension)(Camunda extension)
+
+Checks if a given value is not `null`. If the value is `null` then the function returns `false`.
+Otherwise, the function returns `true`.
+
+The function requires one argument. Calling `is defined()` without an argument is invalid.
+
+**Function signature**
+
+```feel
+is defined(value: Any): boolean
+```
+
+**Examples**
+
+```feel
+is defined(1)
+// true
+
+is defined(null)
+// false
+
+is defined(x)
+// false - if no variable "x" exists
+
+is defined(x.y)
+// false - if no variable "x" exists or it doesn't have a property "y"
+
+is defined()
+// error - expected one argument
+```
+
+**Caution: Breaking change**
+
+This function worked differently in previous versions. It returned `true` if the value was `null`.
+Since this version, the function returns `false` if the value is `null`.
+
+---
+Source: https://docs.camunda.io/docs/next/components/modeler/feel/builtin-functions/feel-built-in-functions-boolean

package/.llms/chunks/components.modeler.feel.builtin-functions.feel-built-in-functions-context.context-merge-contexts.md

@@ -0,0 +1,28 @@
+# Context functions — context merge(contexts)
+
+Union the given contexts. Returns a new context that includes all entries of the given contexts.
+
+If an entry for the same key already exists in a context, it overrides the value. The entries are overridden in the same order as in the list of contexts.
+
+**Function signature**
+
+```feel
+context merge(contexts: list<context>): context
+```
+
+**Examples**
+
+```feel
+context merge([{x:1}, {y:2}])
+// {x:1, y:2}
+
+context merge([{x:1, y: 0}, {y:2}])
+// {x:1, y:2}
+```
+
+**Info**
+The function `context merge()` replaced the previous function `put all()` (Camunda Extension). The
+previous function is deprecated and should not be used anymore.
+
+---
+Source: https://docs.camunda.io/docs/next/components/modeler/feel/builtin-functions/feel-built-in-functions-context

package/.llms/chunks/components.modeler.feel.builtin-functions.feel-built-in-functions-context.context-put-context-keys-value.md

@@ -0,0 +1,31 @@
+# Context functions — context put(context, keys, value)
+
+Adds a new entry with the given value to the context. The path of the entry is defined by the keys. Returns a new context that includes the entry.
+
+If `keys` contains the keys `[k1, k2]` then it adds the nested entry `k1.k2 = value` to the context.
+
+If an entry for the same keys already exists in the context, it overrides the value.
+
+If `keys` are empty, it returns `null`.
+
+**Function signature**
+
+```feel
+context put(context: context, keys: list<string>, value: Any): context
+```
+
+**Examples**
+
+```feel
+context put({x:1}, ["y"], 2)
+// {x:1, y:2}
+
+context put({x:1, y: {z:0}}, ["y", "z"], 2)
+// {x:1, y: {z:2}}
+
+context put({x:1}, ["y", "z"], 2)
+// {x:1, y: {z:2}}
+```
+
+---
+Source: https://docs.camunda.io/docs/next/components/modeler/feel/builtin-functions/feel-built-in-functions-context

package/.llms/chunks/components.modeler.feel.builtin-functions.feel-built-in-functions-context.get-entries-context.md

@@ -0,0 +1,45 @@
+# Context functions — get entries(context)
+
+Returns the entries of the context as a list of key-value-pairs.
+
+**Function signature**
+
+```feel
+get entries(context: context): list<context>
+```
+
+The return value is a list of contexts. Each context contains two entries for "key" and "value".
+
+**Examples**
+
+```feel
+get entries({foo: 123})
+// [{key: "foo", value: 123}]
+```
+
+
+## context put(context, key, value)
+
+Adds a new entry with the given key and value to the context. Returns a new context that includes the entry.
+
+If an entry for the same key already exists in the context, it overrides the value.
+
+**Function signature**
+
+```feel
+context put(context: context, key: string, value: Any): context
+```
+
+**Examples**
+
+```feel
+context put({x:1}, "y", 2)
+// {x:1, y:2}
+```
+
+**Info**
+The function `context put()` replaced the previous function `put()` (Camunda Extension). The
+previous function is deprecated and should not be used anymore.
+
+---
+Source: https://docs.camunda.io/docs/next/components/modeler/feel/builtin-functions/feel-built-in-functions-context

package/.llms/chunks/components.modeler.feel.builtin-functions.feel-built-in-functions-context.md

@@ -0,0 +1,57 @@
+# Context functions
+
+This document outlines context functions and a few examples.
+
+
+## get value(context, key)
+
+Returns the value of the context entry with the given key.
+
+**Function signature**
+
+```feel
+get value(context: context, key: string): Any
+```
+
+**Examples**
+
+```feel
+get value({foo: 123}, "foo")
+// 123
+
+get value({a: 1}, "b")
+// null
+```
+
+
+## get value(context, keys)
+
+(Camunda extension)(Camunda extension)
+
+Returns the value of the context entry for a context path defined by the given keys.
+
+If `keys` contains the keys `[k1, k2]` then it returns the value at the nested entry `k1.k2` of the context.
+
+If `keys` are empty or the nested entry defined by the keys doesn't exist in the context, it returns `null`.
+
+**Function signature**
+
+```feel
+get value(context: context, keys: list<string>): Any
+```
+
+**Examples**
+
+```feel
+get value({x:1, y: {z:0}}, ["y", "z"])
+// 0
+
+get value({x: {y: {z:0}}}, ["x", "y"])
+// {z:0}
+
+get value({a: {b: 3}}, ["b"])
+// null
+```
+
+---
+Source: https://docs.camunda.io/docs/next/components/modeler/feel/builtin-functions/feel-built-in-functions-context

package/.llms/chunks/components.modeler.feel.builtin-functions.feel-built-in-functions-conversion.context-entries.md

@@ -0,0 +1,25 @@
+# Conversion functions — context(entries)
+
+Constructs a context of the given list of key-value pairs. It is the reverse function to [get entries()](https://docs.camunda.io/docs/next/components/modeler/feel/builtin-functions/feel-built-in-functions-context#get-entriescontext).
+
+Each key-value pair must be a context with two entries: `key` and `value`. The entry with name `key` must have a value of the type `string`.
+
+It might override context entries if the keys are equal. The entries are overridden in the same order as the contexts in the given list.
+
+Returns `null` if one of the entries is not a context or if a context doesn't contain the required entries.
+
+**Function signature**
+
+```feel
+context(entries: list<context>): context
+```
+
+**Examples**
+
+```feel
+context([{"key":"a", "value":1}, {"key":"b", "value":2}])
+// {a:1, b:2}
+```
+
+---
+Source: https://docs.camunda.io/docs/next/components/modeler/feel/builtin-functions/feel-built-in-functions-conversion

package/.llms/chunks/components.modeler.feel.builtin-functions.feel-built-in-functions-conversion.date-and-time-date-time.md

@@ -0,0 +1,28 @@
+# Conversion functions — date and time(date, time)
+
+Returns a date and time from the given components.
+
+**Function signature**
+
+```feel
+date and time(date: date, time: time): date and time
+```
+
+```feel
+date and time(date: date and time, time: time): date and time
+```
+
+Returns a date and time value that consists of the date component of `date` combined with `time`.
+
+**Examples**
+
+```feel
+date and time(date("2012-12-24"),time("T23:59:00"))
+// date and time("2012-12-24T23:59:00")
+
+date and time(date and time("2012-12-25T11:00:00"),time("T23:59:00"))
+// date and time("2012-12-25T23:59:00")
+```
+
+---
+Source: https://docs.camunda.io/docs/next/components/modeler/feel/builtin-functions/feel-built-in-functions-conversion

package/.llms/chunks/components.modeler.feel.builtin-functions.feel-built-in-functions-conversion.date-and-time-date-timezone.md

@@ -0,0 +1,51 @@
+# Conversion functions — date and time(date, timezone)
+
+(Camunda extension)(Camunda extension)
+
+Returns the given date and time value at the given timezone.
+
+If `date` has a different timezone than `timezone` then it adjusts the time to match the local time of `timezone`.
+
+**Function signature**
+
+```feel
+date and time(date: date and time, timezone: string): date and time
+```
+
+**Examples**
+
+```feel
+date and time(@"2020-07-31T14:27:30@Europe/Berlin", "America/Los_Angeles")
+// date and time("2020-07-31T05:27:30@America/Los_Angeles")
+
+date and time(@"2020-07-31T14:27:30", "Z")
+// date and time("2020-07-31T12:27:30Z")
+```
+
+
+## duration(from)
+
+Parses the given string into a duration. The duration is either a days and time duration or a years and months duration.
+
+**Function signature**
+
+```feel
+duration(from: string): days and time duration
+```
+
+```feel
+duration(from: string): years and months duration
+```
+
+**Examples**
+
+```feel
+duration("P5D")
+// duration("P5D")
+
+duration("P32Y")
+// duration("P32Y")
+```
+
+---
+Source: https://docs.camunda.io/docs/next/components/modeler/feel/builtin-functions/feel-built-in-functions-conversion

package/.llms/chunks/components.modeler.feel.builtin-functions.feel-built-in-functions-conversion.date-from.md

@@ -0,0 +1,54 @@
+# Conversion functions — date(from)
+
+Returns a date from the given value.
+
+Returns `null` if the string is not a valid calendar date. For example, `"2024-06-31"` is invalid because June has
+only 30 days.
+
+**Function signature**
+
+```feel
+date(from: string): date
+```
+
+Parses the given string into a date.
+
+```feel
+date(from: date and time): date
+```
+
+Extracts the date component from the given date and time.
+
+**Examples**
+
+```feel
+date("2018-04-29")
+// date("2018-04-29")
+
+date(date and time("2012-12-25T11:00:00"))
+// date("2012-12-25")
+```
+
+
+## date(year, month, day)
+
+Returns a date from the given components.
+
+Returns `null` if the components don't represent a valid calendar date. For example, `2024,6,31` is invalid because
+June has only 30 days.
+
+**Function signature**
+
+```feel
+date(year: number, month: number, day: number): date
+```
+
+**Examples**
+
+```feel
+date(2012, 12, 25)
+// date("2012-12-25")
+```
+
+---
+Source: https://docs.camunda.io/docs/next/components/modeler/feel/builtin-functions/feel-built-in-functions-conversion

package/.llms/chunks/components.modeler.feel.builtin-functions.feel-built-in-functions-conversion.md

@@ -0,0 +1,49 @@
+# Conversion functions
+
+This document outlines conversion functions and a few examples.
+
+Convert a value into a different type.
+
+
+## string(from)
+
+Returns the given value as a string representation.
+
+**Function signature**
+
+```feel
+string(from: Any): string
+```
+
+**Examples**
+
+```feel
+string(1.1)
+// "1.1"
+
+string(date("2012-12-25"))
+// "2012-12-25"
+```
+
+
+## number(from)
+
+Parses the given string to a number.
+
+Returns `null` if the string is not a number.
+
+**Function signature**
+
+```feel
+number(from: string): number
+```
+
+**Examples**
+
+```feel
+number("1500.5")
+// 1500.5
+```
+
+---
+Source: https://docs.camunda.io/docs/next/components/modeler/feel/builtin-functions/feel-built-in-functions-conversion

package/.llms/chunks/components.modeler.feel.builtin-functions.feel-built-in-functions-conversion.number-from-grouping-separator.md

@@ -0,0 +1,41 @@
+# Conversion functions — number(from, grouping separator)
+
+Parses the given string to a number using the specified grouping separator.
+
+Returns `null` if the string is not a number.
+
+**Function signature**
+
+```feel
+number(from: string, grouping separator: string): number
+```
+
+**Examples**
+
+```feel
+number("1,500", ",")
+// 1500
+```
+
+
+## number(from, grouping separator, decimal separator)
+
+Parses the given string to a number using the specified grouping and decimal separators.
+
+Returns `null` if the string is not a number.
+
+**Function signature**
+
+```feel
+number(from: string, grouping separator: string, decimal separator: string): number
+```
+
+**Examples**
+
+```feel
+number("1 500.5", " ", ".")
+// 1500.5
+```
+
+---
+Source: https://docs.camunda.io/docs/next/components/modeler/feel/builtin-functions/feel-built-in-functions-conversion

package/.llms/chunks/components.modeler.feel.builtin-functions.feel-built-in-functions-conversion.time-from.md

@@ -0,0 +1,48 @@
+# Conversion functions — time(from)
+
+Returns a time from the given value.
+
+**Function signature**
+
+```feel
+time(from: string): time
+```
+
+Parses the given string into a time.
+
+```feel
+time(from: date and time): time
+```
+
+Extracts the time component from the given date and time.
+
+**Examples**
+
+```feel
+time("12:00:00")
+// time("12:00:00")
+
+time(date and time("2012-12-25T11:00:00"))
+// time("11:00:00")
+```
+
+
+## time(hour, minute, second)
+
+Returns a time from the given components.
+
+**Function signature**
+
+```feel
+time(hour: number, minute: number, second: number): time
+```
+
+**Examples**
+
+```feel
+time(23, 59, 0)
+// time("23:59:00")
+```
+
+---
+Source: https://docs.camunda.io/docs/next/components/modeler/feel/builtin-functions/feel-built-in-functions-conversion

package/.llms/chunks/components.modeler.feel.builtin-functions.feel-built-in-functions-conversion.time-hour-minute-second-offset.md

@@ -0,0 +1,51 @@
+# Conversion functions — time(hour, minute, second, offset)
+
+Returns a time from the given components, including a timezone offset.
+
+**Function signature**
+
+```feel
+time(hour: number, minute: number, second: number, offset: days and time duration): time
+```
+
+**Examples**
+
+```feel
+time(14, 30, 0, duration("PT1H"))
+// time("14:30:00+01:00")
+```
+
+
+## date and time(from)
+
+Parses the given string into a date and time. The function supports strings in the format `YYYY-MM-DDThh:mm:ss` with
+optional timezone information either as offset (e.g., `+01:00` or `Z`), as IANA timezone ID (e.g., `@Europe/Berlin`), or
+as a combination of both (e.g., `+01:00[Europe/Berlin]`).
+
+Returns `null` if the string is not a valid calendar date. For example, `"2024-06-31T10:00:00"` is invalid because
+June has only 30 days.
+
+**Function signature**
+
+```feel
+date and time(from: string): date and time
+```
+
+**Examples**
+
+```feel
+date and time("2018-04-29T09:30:00")
+// date and time("2018-04-29T09:30:00")
+
+date and time("2018-04-29T09:30:00+02:00")
+// date and time("2018-04-29T09:30:00+02:00")
+
+date and time("2018-04-29T09:30:00@Europe/Berlin")
+// date and time("2018-04-29T09:30:00@Europe/Berlin")
+
+date and time("2018-04-29T09:30:00+02:00[Europe/Berlin]")
+// date and time("2018-04-29T09:30:00@Europe/Berlin")
+```
+
+---
+Source: https://docs.camunda.io/docs/next/components/modeler/feel/builtin-functions/feel-built-in-functions-conversion

package/.llms/chunks/components.modeler.feel.builtin-functions.feel-built-in-functions-conversion.to-json-value.md

@@ -0,0 +1,33 @@
+# Conversion functions — to json(value)
+
+Converts a FEEL value into a JSON string. The function converts FEEL primitives, contexts, and lists into their
+corresponding JSON types. Temporal values are converted to their ISO 8601 string representation, including timezone
+information for date and time values (format: `2025-11-24T10:00:00+01:00[Europe/Berlin]`).
+
+**Function signature**
+
+```feel
+to json(value: Any): string
+```
+
+**Examples**
+
+```feel
+to json({a: 1, b: 2})
+// "{\"a\":1,\"b\":2}"
+
+to json(true)
+// "true"
+
+to json(@"2023-06-14")
+// "\"2023-06-14\""
+
+to json(@"2025-11-24T10:00:00@Europe/Berlin")
+// "\"2025-11-24T10:00:00+01:00[Europe/Berlin]\""
+
+to json(@"P3Y")
+// "\"P3Y\""
+```
+
+---
+Source: https://docs.camunda.io/docs/next/components/modeler/feel/builtin-functions/feel-built-in-functions-conversion

package/.llms/chunks/components.modeler.feel.builtin-functions.feel-built-in-functions-conversion.years-and-months-duration-from-to.md

@@ -0,0 +1,45 @@
+# Conversion functions — years and months duration(from, to)
+
+Returns the years and months duration between `from` and `to`.
+
+**Function signature**
+
+```feel
+years and months duration(from: date, to: date): years and months duration
+```
+
+**Examples**
+
+```feel
+years and months duration(date("2011-12-22"), date("2013-08-24"))
+// duration("P1Y8M")
+```
+
+
+## from json(value)
+
+Parses a JSON string into a FEEL value. The function converts JSON primitives, objects, and arrays into their corresponding FEEL types.
+
+Returns `null` if the string is not a valid JSON value.
+
+**Function signature**
+
+```feel
+from json(value: string): Any
+```
+
+**Examples**
+
+```feel
+from json("{\"a\": 1, \"b\": 2}")
+// {a: 1, b: 2}
+
+from json("true")
+// true
+
+from json("\"2023-06-14\"")
+// "2023-06-14"
+```
+
+---
+Source: https://docs.camunda.io/docs/next/components/modeler/feel/builtin-functions/feel-built-in-functions-conversion