@platforma-sdk/workflow-tengo 2.13.6 → 2.15.0

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

@@ -1,6 +1,6 @@
-/**
- * Working with a single p-column
- */
+
+
+
 
 ll := import("@platforma-sdk/workflow-tengo:ll")
 oop := import("@platforma-sdk/workflow-tengo:oop")
@@ -8,18 +8,18 @@ json := import("json")
 smart := import("@platforma-sdk/workflow-tengo:smart")
 constants := import("@platforma-sdk/workflow-tengo:pframes.constants")
 
-/**
- * Returns true if given resource is a p-column resource map data
- */
+
+
+
 isResourceMap := func(r) {
 	return smart.isResource(r) && r.info().Type.Name == constants.RTYPE_P_COLUMN_DATA_RESOURCE_MAP.Name
 }
 
-/**
- * Creates a builder for a resource map p-column's data.
- *
- * @param keyLength: int - key length
- */
+
+
+
+
+
 resourceMapBuilder := func(keyLength) {
 	r := smart.structBuilder(
 		constants.RTYPE_P_COLUMN_DATA_RESOURCE_MAP,
@@ -43,13 +43,13 @@ resourceMapBuilder := func(keyLength) {
 	return self
 }
 
-/**
- * Convert map object to a p-column resource map.
- *
- * @param map - tengo map
- * @param keyLength: int - length of the partitioned key
- * @param keyParser: func - function to parse string map keys and return array of p-column keys
- */
+
+
+
+
+
+
+
 fromMap := func(map, keyLength, keyParser) {
 	b := resourceMapBuilder(keyLength)
 

package/dist/tengo/lib/pframes.remove-nulls.lib.tengo

@@ -0,0 +1,36 @@
+ll := import("@platforma-sdk/workflow-tengo:ll")
+assets := import("@platforma-sdk/workflow-tengo:assets")
+render := import("@platforma-sdk/workflow-tengo:render")
+smart := import("@platforma-sdk/workflow-tengo:smart")
+
+
+removeNullsTemplate := assets.importTemplate("@platforma-sdk/workflow-tengo:pframes.remove-nulls")
+
+
+
+
+
+
+
+removeNulls := func(dataMap, ...opts) {
+    ll.assert(smart.isReference(dataMap), "expected resource or field, got %v", dataMap)
+
+
+    isEph := false
+    if len(opts) > 0 {
+        isEph = opts[0]
+    }
+
+
+    result := render.createUniversal(removeNullsTemplate, isEph, {
+        map: dataMap
+    })
+
+
+    return result.output("result")
+}
+
+
+export ll.toStrict({
+    removeNulls: removeNulls
+})

package/dist/tengo/lib/pframes.spec.lib.tengo

@@ -1,20 +1,20 @@
-/**
- * PFrames spec library:
- *  - well known domains, annotations and column names.
- *  - utility methods to manipulate column and axis spec
- */
+
+
+
+
+
 
 ll := import("@platforma-sdk/workflow-tengo:ll")
 maps := import("@platforma-sdk/workflow-tengo:maps")
 validation := import("@platforma-sdk/workflow-tengo:validation")
 json := import("json")
 
-//
-// Common schemas
-//
+
+
+
 
 P_AXIS_SPEC_SCHEMA := {
-	// `__options__,closed`: ``, // commented out to keep the room for future schema modifications
+
 	`type`: `string,regex=Int|Long|Float|Double|String`,
 	`name`: `string`,
 	`domain,?`: { any: `string` },
@@ -23,7 +23,7 @@ P_AXIS_SPEC_SCHEMA := {
 }
 
 P_COLUMN_SPEC_SCHEMA := {
-	// `__options__,closed`: ``, // commented out to keep the room for future schema modifications
+
 	`kind`: `string,regex=PColumn`,
 	`valueType`: `string`,
 	`name`: `string`,
@@ -35,42 +35,42 @@ P_COLUMN_SPEC_SCHEMA := {
 
 KIND_P_COLUMN := "PColumn"
 
-//
-// Column / axis names
-//
 
-/** Column containing labels for axis keys */
+
+
+
+
 N_LABEL := "pl7.app/label"
 
-//
-// Column / axis domains
-//
 
-/** Domain marking column or axis as block-specific, value must contain block id */
+
+
+
+
 D_BLOCK := "pl7.app/block"
 
-//
-// Column / axis annotations
-//
 
-/** Annotation with axis or column label */
+
+
+
+
 A_LABEL := "pl7.app/label"
-/**
- * Annotation containing trace of operations resulting in a corresponding column.
- *
- * Value must containe JSON encoded array of structures:
- *   {
- *      type: string       - type of the step, often equals to block package name (i.e. milaboratories.mixcr-clonotyping)
- *      label: string      - string representation of the operation often a block title
- *      importance: number - higher the number higher the change label from trace step will be used to derive column label
- *      id: string         - unique identifier of operation, often a block id
- *   }
- */
+
+
+
+
+
+
+
+
+
+
+
 A_TRACE := "pl7.app/trace"
 
-//
-// Format methods
-//
+
+
+
 
 normalizeColumnSpec := func(spec) {
 	if is_undefined(spec.axesSpec) {
@@ -80,9 +80,9 @@ normalizeColumnSpec := func(spec) {
 	return spec
 }
 
-//
-// Matchers
-//
+
+
+
 
 _P_MATCHER_SCHEMA := {
 	`__options__,closed`: ``,
@@ -118,11 +118,11 @@ _checkAxisMatch := func(axisSpec, matcher) {
 	return true
 }
 
-/**
- * For a given array of axes specs returns the index of matching axis:
- *   - if multiple matches are found - panics
- *   - if axis not found and matcher is not optional - panics
- */
+
+
+
+
+
 matchAxis := func(axesSpec, matcher) {
 	validation.assertType(axesSpec, [ P_AXIS_SPEC_SCHEMA ])
 	matcher = _normalizeMatcher(matcher)
@@ -142,33 +142,33 @@ matchAxis := func(axesSpec, matcher) {
 	return found
 }
 
-/**
- * Matches axes specs against matchers and returns array of matched indices.
- *
- * Example matchers:
- *   - "pl7.app/sequencing/readIndex"
- *   - { name: "pl7.app/sequencing/readIndex" }
- *   - { type: "String", name: "pl7.app/sequencing/lane" }
- *   - { type: "String", name: "pl7.app/sequencing/lane", optional: true }
- *   - { type: "String", name: "pl7.app/rna-seq/geneId", domain: { "pl7.app/species": "homo-sapiens" } }
- *
- * @param axesSpec: AxisSpec[] Array of axis specifications to match against
- * @param matchers: (string|AxisMatcher)[] Array of matchers, each can be either:
- *   - string: Simple name matcher e.g. "pl7.app/sequencing/readIndex"
- *   - AxisMatcher: Object with matching criteria:
- *     - name: string - Axis name to match
- *     - type?: string - Optional axis type to match
- *     - domain?: Record<string,string> - Optional domain criteria
- *     - optional?: boolean - If true, won't panic when no match found
- * @param opts?: object Optional parameters:
- *   - keepUnmatched?: boolean - Whether to include unmatched indices (-1) in result
- * @returns number[] Array of matched indices in same order as matchers. Contains -1 for
- *          unmatched optional matchers if keepUnmatched is true.
- * @panics
- *   - If multiple axes match a single matcher
- *   - If no match found for non-optional matcher
- *   - If multiple matchers match the same axis
- */
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 matchAxes := func(axesSpec, matchers, ...opts) {
 	keepUnmatched := false
 	if len(opts) == 1 {
@@ -195,9 +195,9 @@ matchAxes := func(axesSpec, matchers, ...opts) {
 	return result
 }
 
-//
-// Utility methods
-//
+
+
+
 
 _TRACE_STEP_SCHEMA := {
 	`type`: `string`,
@@ -209,14 +209,14 @@ _TRACE_STEP_SCHEMA := {
 
 _TRACE_SCHEMA := [_TRACE_STEP_SCHEMA]
 
-/**
- * Calculates content of pl7.app/trace annotation, given input column spec, or annotations section
- * of specs, or directly content of pl7.app/trace from the input column spec.
- *
- * Basically validates and adds provided steps.
- */
+
+
+
+
+
+
 makeTrace := func(input, ...steps) {
-	// validating input step structure
+
 	validation.assertType(steps, _TRACE_SCHEMA)
 
 	currentTraceContent := undefined
@@ -231,7 +231,7 @@ makeTrace := func(input, ...steps) {
 	currentTrace := []
 	if !is_undefined(currentTraceContent) {
 		currentTrace = json.decode(currentTraceContent)
-		// validating trace we just parsed
+
 		validation.assertType(currentTrace, _TRACE_SCHEMA)
 	}
 
@@ -241,7 +241,7 @@ makeTrace := func(input, ...steps) {
 	return ll.toStrict({
 		value: currentTrace,
 		valueStr: currentTraceStr,
-		/** Injects trace information into column spec */
+
 		inject: func(spec) {
 			validation.assertType(spec, P_COLUMN_SPEC_SCHEMA)
 			return maps.deepMerge(spec, {annotations: {"pl7.app/trace": currentTraceStr}})