@platforma-sdk/workflow-tengo 2.14.0 → 2.15.0

package/dist/tengo/lib/maps.lib.tengo

@@ -1,12 +1,12 @@
 ll := import("@platforma-sdk/workflow-tengo:ll")
 slices := import("@platforma-sdk/workflow-tengo:slices")
 
-/**
- * Returns a slice of keys of the map.
- *
- * @param map map[string]any - map to extract keys from
- * @return result: string[] - a slice of keys.
- */
+
+
+
+
+
+
 getKeys := func(map) {
 	res := []
 	for k, _ in map {
@@ -16,10 +16,10 @@ getKeys := func(map) {
 	return slices.quickSort(res)
 }
 
-/**
- * Returns true if map contains specified key.
- * Note: fallback implementation is O(N). You can remove it after 05.2025
- */
+
+
+
+
 containsKey := func(map, key) {
 	for k, _ in map {
 		if key == k {
@@ -30,7 +30,7 @@ containsKey := func(map, key) {
 	return false
 }
 
-// Load effective version of map key checker if it exists in controller's API
+
 plapi := import("plapi")
 if ll.methodExists(plapi, "mapHasKey") {
 	containsKey = func(map, key) {
@@ -38,13 +38,13 @@ if ll.methodExists(plapi, "mapHasKey") {
 	}
 }
 
-/**
- * Transforms all keys of the map with a function and returns a new map with these keys.
- *
- * @param map: map[key]any
- * @param fnK: func(key): newKey - a function that gets a key and returns a new key.
- * @return new map: map[newKey]any - a transformed map
- */
+
+
+
+
+
+
+
 mapKeys := func(map, fnK) {
 	newM := {}
 	for k, v in map {
@@ -54,7 +54,7 @@ mapKeys := func(map, fnK) {
 	return newM
 }
 
-// Map values
+
 mapValues := func(map, fnV) {
 	newM := {}
 	for k, v in map {
@@ -64,7 +64,7 @@ mapValues := func(map, fnV) {
 	return newM
 }
 
-// Map keys and values
+
 map := func(map, fn) {
 	newM := {}
 	for k, v in map {
@@ -98,16 +98,16 @@ filterKeysValues := func(map, predicateFnK, predicateFnV) {
 	return filter(map, func(k, v) { return predicateFnK(k) && predicateFnV(v) })
 }
 
-/**
- * Returns a deep copy of a map or an array.
- * Optionally removes keys having undefined value.
- *
- * @param obj 	- object to be cloned
- * @param ops 	- additional options
- *					{
- *						removeUndefs: boolean
- *					}
- */
+
+
+
+
+
+
+
+
+
+
 clone := func(obj, ...ops) {
 	removeUndefs := false
 	if len(ops) == 1 {
@@ -141,10 +141,10 @@ clone := func(obj, ...ops) {
 	return obj
 }
 
-/**
- * Do shallow merge of arbitrary number of maps.
- * Add {... key: undefined ...} to remove the "key" from the map collected from maps before.
- */
+
+
+
+
 merge := func(...maps) {
 	res := {}
 	for map in maps {
@@ -159,10 +159,10 @@ merge := func(...maps) {
 	return res
 }
 
-/**
- * Do deep merge of arbitrary number of maps.
- * Add {... key: undefined ...} to remove the "key" from the map collected from maps before.
- */
+
+
+
+
 deepMerge := undefined
 deepMerge = func(...maps) {
 	res := {}

package/dist/tengo/lib/objects.lib.tengo

@@ -1,12 +1,12 @@
-/**
- * Utilities for working with objects
- */
+
+
+
 
 ll := import("@platforma-sdk/workflow-tengo:ll")
 
-/**
- * Deletes entries with undefined values from object
- */
+
+
+
 deleteUndefined := func(obj) {
 	for k, v in obj {
 		if is_undefined(v) {

package/dist/tengo/lib/oop.lib.tengo

@@ -1,20 +1,20 @@
-/**
- * Utility functions for working with objects.
- */
+
+
+
 
 ll := import("@platforma-sdk/workflow-tengo:ll")
 
-/**
- * Inherit all methods and properties of a super object
- *
- * @param super a parent from which we get all methods
- * @param self an object in which we set all super methods
- * @return self
- */
+
+
+
+
+
+
+
 inherit := func(super, self) {
 	self["super"] = super
 
-	// inherit super methods
+
 	for k, v in super {
 		if self[k] == undefined {
 			self[k] = v

package/dist/tengo/lib/path.lib.tengo

@@ -3,53 +3,53 @@ text := import("text")
 slices := import("@platforma-sdk/workflow-tengo:slices")
 validation := import("@platforma-sdk/workflow-tengo:validation")
 
-/**
- * Joins path elements into a single path.
- *
- * @param elems: ...string - any number of elements.
- */
+
+
+
+
+
 join := func(...elems) {
 	validation.assertType(elems, ["string"])
 	return ll.filepathJoin(elems...)
 }
 
-/**
- * Like join, joins elements to a single path,
- * but can be used safely in regexps.
- *
- * @param elems: ...string - any number of elements.
- */
+
+
+
+
+
+
 regexpJoin := func(...elems) {
 	validation.assertType(elems, ["string"])
 	return ll.filepathRegexpJoin(elems...)
 }
 
-/**
- * Joins elements of the filepath and canonizes it, i.e.
- * semantically resolves ../ and ./ and changes slash
- * to a pathSeparator.
- *
- * @param elems: ...string - any number of elements.
- */
+
+
+
+
+
+
+
 canonize := func(...elems) {
 	validation.assertType(elems, ["string"])
 	return ll.filepathCanonize(elems...)
 }
 
-/**
- * Returns a path separator. "/" on Unix-like systems, "\\" on Windows.
- *
- * @return separator: string
- */
+
+
+
+
+
 separator := ll.pathSeparator
 
-/**
- * Trims a beginning of the file path following by a path separator.
- *
- * @param path: string - a file path
- * @param prefix: string - the beginning of the file path
- * @return trimmed path: string - a path without the beginning and a path separator.
- */
+
+
+
+
+
+
+
 trimPrefix := func(path, prefix) {
 	validation.assertType([path, prefix], ["string"])
 	return text.trim_prefix(path, prefix+separator)
@@ -65,29 +65,29 @@ _sepOrDefault := func(...sep) {
 	return sep[0]
 }
 
-/**
- * Splits a path to path components.
- * If it was a file name, the last component will be this name.
- *
- * @param path: string - the path
- * @param sep: string - an optional path separator.
- * @return components: []string - all directories and a file name at the end.
- */
+
+
+
+
+
+
+
+
 split := func(path, ...sep) {
 	sep = _sepOrDefault(sep...)
 
 	return text.split(path, sep)
 }
 
-/**
- * Gets all directories with their ancestors from the root.
- * For example, for dir1/dir2/dir3/abc.txt it gives:
- * ["dir1", "dir1/dir2", "dir1/dir2/dir3", "dir1/dir2/dir3/abc.txt"]
- *
- * @param path: string - the path
- * @param separator: string - an optional separator.
- * @return components: []string - all directories and a file name at the end from their root.
- */
+
+
+
+
+
+
+
+
+
 getBasenameDirs := func(path, ...sep) {
 	validation.assertType(path, "string")
 	sep = _sepOrDefault(sep...)
@@ -102,14 +102,14 @@ getBasenameDirs := func(path, ...sep) {
 	return dirTails
 }
 
-/**
- * Gets an extension to the last "." symbol,
- * or, if the name contains ".gz" or any other archive suffix,
- * then till the next from the last "." symbol.
- *
- * @param path: string - a path
- * @return extension: string - the extension without the leading "."
- */
+
+
+
+
+
+
+
+
 getExtension := func(path, ...sep) {
 	validation.assertType(path, "string")
 	ext := ""
@@ -137,11 +137,11 @@ getExtension := func(path, ...sep) {
 	return ext
 }
 
-/**
- * Checks if the path is correct.
- *
- * @param path: string - a path
- */
+
+
+
+
+
 assertIsValid := func(path) {
 	validation.assertType(path, "string")
 	if text.contains(path, "/") {

package/dist/tengo/lib/pframes.builder.lib.tengo

@@ -4,9 +4,9 @@ smart := import("@platforma-sdk/workflow-tengo:smart")
 pConstants := import("@platforma-sdk/workflow-tengo:pframes.constants")
 
 
-/**
- * Creates a builder for p-frame resource.
- */
+
+
+
 pFrameBuilder := func() {
 	r := smart.structBuilder(pConstants.RTYPE_P_FRAME)
 

package/dist/tengo/lib/pframes.constants.lib.tengo

@@ -1,32 +1,32 @@
-/**
- * Contain field names and other constant used in PFrames
- * libraries and templates.
- */
+
+
+
+
 
 ll := import("@platforma-sdk/workflow-tengo:ll")
 
-/**
- * Name of the field under which the iteration value like in "map" and "aggregate" is passed
- * to the iteration body template.
- */
+
+
+
+
 VALUE_FIELD_NAME := "__value__"
 
-/**
- * Name of the field under which the iteration key like in "map" and "aggregate" is passed
- * to the iteration body template.
- */
+
+
+
+
 KEY_FIELD_NAME := "__key__"
 
-/**
- * Name of the field under which the aggregation axes specification is passed
- * to the iteration body template.
- */
+
+
+
+
 AGGREGATION_AXES_SPEC_FIELD_NAME := "__aggregation_axes_spec__"
 
-/**
- * Name of the field under which the aggregation axes names are passed
- * to the iteration body template.
- */
+
+
+
+
 AGGREGATION_AXES_NAMES_FIELD_NAME := "__aggregation_axes_names__"
 
 RTYPE_P_FRAME :=  { Name: "PFrame", Version: "1" }

package/dist/tengo/lib/pframes.export-pcolumn.lib.tengo

@@ -5,15 +5,15 @@ file := import("@platforma-sdk/workflow-tengo:file")
 ll := import("@platforma-sdk/workflow-tengo:ll")
 assets := import("@platforma-sdk/workflow-tengo:assets")
 
-// reference to the template doing nested super-partitioned export
+
 nestedTpl := assets.importTemplate("@platforma-sdk/workflow-tengo:pframes.export-single-pcolumn")
 
-/** Implements core export logic for export-single-pcolumn and export-multiple-pcolumns templates */
+
 exportPColumnData := func(data) {
 	if data.checkResourceType(pConstants.RTYPE_P_COLUMN_DATA_RESOURCE_MAP_PARTITIONED) ||
 		data.checkResourceType(pConstants.RTYPE_P_COLUMN_DATA_JSON_SUPER_PARTITIONED) ||
 		data.checkResourceType(pConstants.RTYPE_P_COLUMN_DATA_BINARY_SUPER_PARTITIONED) {
-		// super-partitioned data
+
 
 		newData := smart.structBuilder(data.info().Type, data.info().Data)
 		for key, partData in data.inputs() {
@@ -24,7 +24,7 @@ exportPColumnData := func(data) {
 	} else if data.checkResourceType(pConstants.RTYPE_P_COLUMN_DATA_RESOURCE_MAP) ||
 		data.checkResourceType(pConstants.RTYPE_P_COLUMN_DATA_JSON_PARTITIONED) ||
 		data.checkResourceType(pConstants.RTYPE_P_COLUMN_DATA_BINARY_PARTITIONED) {
-		// data directly referencing blob objects
+
 
 		newData := smart.structBuilder(data.info().Type, data.info().Data)
 		for key, partData in data.inputs() {
@@ -33,7 +33,7 @@ exportPColumnData := func(data) {
 		return newData.lockAndBuild()
 
 	} else if data.checkResourceType(pConstants.RTYPE_P_COLUMN_DATA_JSON) {
-		// data embeds all information and needs no special exporting procedure
+
 
 		return data