pareto 0.74.0 → 0.75.1

package/auto.pareto/auto.dependencies/pareto-pure/modules/testresult_2_testresult/glossary.data.ts

@@ -10,7 +10,7 @@ import {
     imp,
     integer,
     list,
-    member,
+    prop,
     nothing,
     optional,
     parametrizedType,
@@ -25,9 +25,9 @@ import {
     sInterface,
     sInterfaceMethod,
     sInterfaceReference,
-} from "pareto-pure/auto.dist/public/shorthands/cosmos_type_system.sh"
+} from "pareto-pure/auto.dist/public/shorthands/pareto_4gl_type_system.sh"
 
-import * as g_glossary from "pareto-pure/auto.dist/public/auto.glossaries/auto.cosmos__type__system"
+import * as g_glossary from "pareto-pure/auto.dist/public/auto.glossaries/auto.pareto_4gl_type_system"
 
 const d = pd.d
 
@@ -53,70 +53,70 @@ export const $: g_glossary.D.Glossary = {
             }),
             'data types': d({
                 "Library": type(group({
-                    "public": member(component(typeReference("Module Set"))),
-                    "private": member(component(typeReference("Module Set"))),
+                    "public": prop(component(typeReference("Module Set"))),
+                    "private": prop(component(typeReference("Module Set"))),
                 })),
                 "Module Set": type(dictionary(component(typeReference("Module")))),
                 "Module": type(dictionary(component(typeReference("Algorithm")))),
                 "Algorithm": type(group({
-                    "location": member(component(typeReference("Source Location"))),
-                    "tests": member(optional(dictionary(component(typeReference("Test"))))),
+                    "location": prop(component(typeReference("Source Location"))),
+                    "tests": prop(optional(dictionary(component(typeReference("Test"))))),
                 })),
                 "Source Location": type(group({
-                    "file": member(text()),
-                    "line": member(integer()),
-                    "column": member(integer()),
+                    "file": prop(text()),
+                    "line": prop(integer()),
+                    "column": prop(integer()),
                 })),
                 "Test": type(list(component(typeReference("Error")))),
                 "Error": type(stateGroup({
                     "content": component(typeReference("Compare Error"))
                 })),
                 "Compare Error": type(group({
-                    "location": member(component(typeReference("Source Location"))),
-                    "path": member(text()),
-                    "type": member(stateGroup({
+                    "location": prop(component(typeReference("Source Location"))),
+                    "path": prop(text()),
+                    "type": prop(stateGroup({
                         "wrong number": group({
-                            "found": member(integer()),
+                            "found": prop(integer()),
                         }),
                         "wrong text": group({
-                            "found": member(text()),
+                            "found": prop(text()),
                         }),
                         "wrong boolean": group({
-                            "found": member(boolean())
+                            "found": prop(boolean())
                         }),
                         "optional value expected not to be set": nothing(),
                         "optional value expected to be set": nothing(),
                         "not the right state": group({
-                            "found": member(text())
+                            "found": prop(text())
                         }),
                         "not enough elements": nothing(),
                         "too many elements": nothing(),
                         "superfluous entries": group({
-                            "keys": member(dictionary(nothing()))
+                            "keys": prop(dictionary(nothing()))
                         }),
                         "missing dictionary entry": group({
-                            "key": member(text()),
+                            "key": prop(text()),
                         }),
                     })),
 
                 })),
                 "Summary": type(group({
-                    "number of tests": member(integer()),
-                    "number of missing tests": member(integer()),
-                    "number of errors": member(integer()),
+                    "number of tests": prop(integer()),
+                    "number of missing tests": prop(integer()),
+                    "number of errors": prop(integer()),
                 })),
 
                 "String": type(text()),
 
                 "intLibrary": type(group({
-                    "public": member(component(typeReference("intModule Set"))),
-                    "private": member(component(typeReference("intModule Set"))),
+                    "public": prop(component(typeReference("intModule Set"))),
+                    "private": prop(component(typeReference("intModule Set"))),
                 })),
                 "intModule Set": type(dictionary(component(typeReference("intModule")))),
                 "intModule": type(dictionary(component(typeReference("intAlgorithm")))),
                 "intAlgorithm": type(group({
-                    "location": member(component(typeReference("Source Location"))),
-                    "status": member(stateGroup({
+                    "location": prop(component(typeReference("Source Location"))),
+                    "status": prop(stateGroup({
                         "no tests": nothing(),
                         "skipped": nothing(),
                         "has tests": dictionary(component(typeReference("intTest"))),
@@ -133,25 +133,25 @@ export const $: g_glossary.D.Glossary = {
                     "success": nothing(), // green
                 })),
                 "annotatedLibrary": type(group({
-                    "public": member(component(typeReference("annotatedModule Set"))),
-                    "private": member(component(typeReference("annotatedModule Set"))),
+                    "public": prop(component(typeReference("annotatedModule Set"))),
+                    "private": prop(component(typeReference("annotatedModule Set"))),
                 })),
                 "annotatedModule Set": type(group({
-                    "status": member(component(typeReference("annotatedStatus"))),
-                    "modules": member(dictionary(component(typeReference("annotatedModule")))),
+                    "status": prop(component(typeReference("annotatedStatus"))),
+                    "modules": prop(dictionary(component(typeReference("annotatedModule")))),
                 })),
                 "annotatedModule": type(group({
-                    "status": member(component(typeReference("annotatedStatus"))),
-                    "algorithms": member(dictionary(component(typeReference("annotatedAlgorithm")))),
+                    "status": prop(component(typeReference("annotatedStatus"))),
+                    "algorithms": prop(dictionary(component(typeReference("annotatedAlgorithm")))),
                 })),
                 "annotatedAlgorithm": type(group({
-                    "location": member(component(typeReference("Source Location"))),
-                    "status": member(component(typeReference("annotatedStatus"))),
-                    "tests": member(dictionary(component(typeReference("annotatedTest")))),
+                    "location": prop(component(typeReference("Source Location"))),
+                    "status": prop(component(typeReference("annotatedStatus"))),
+                    "tests": prop(dictionary(component(typeReference("annotatedTest")))),
                 })),
                 "annotatedTest": type(group({
-                    "status": member(component(typeReference("annotatedStatus"))),
-                    "errors": member(list(component(typeReference("Error")))),
+                    "status": prop(component(typeReference("annotatedStatus"))),
+                    "errors": prop(list(component(typeReference("Error")))),
                 })),
             }),
         },

package/auto.pareto/auto.dependencies/pareto-standard-library/$.data.ts

@@ -1,9 +1,9 @@
 import * as pd from 'pareto-core-data'
 
-import * as g_project from "pareto-pure/auto.dist/public/auto.glossaries/auto.cosmos__type__system"
+import * as g_project from "pareto-pure/auto.dist/public/auto.glossaries/auto.pareto_4gl_type_system"
 
 const d = pd.d
-import { } from "pareto-pure/auto.dist/public/shorthands/cosmos_type_system.sh"
+import { } from "pareto-pure/auto.dist/public/shorthands/pareto_4gl_type_system.sh"
 
 import { $ as d_array } from "./modules/array/api.data"
 import { $ as d_boolean } from "./modules/boolean/api.data"

package/auto.pareto/auto.dependencies/pareto-standard-library/modules/array/api.data.ts

@@ -1,20 +1,37 @@
 import * as pd from 'pareto-core-data'
 
-import { algorithm, algref, api } from "pareto-pure/auto.dist/public/shorthands/cosmos_type_system.sh"
+import { algorithm, algref, api } from "pareto-pure/auto.dist/public/shorthands/pareto_4gl_type_system.sh"
 
-import * as g_project from "pareto-pure/auto.dist/public/auto.glossaries/auto.cosmos__type__system"
+import * as g_project from "pareto-pure/auto.dist/public/auto.glossaries/auto.pareto_4gl_type_system"
 
 import { $ as glos } from "./glossary.data"
 
 export const $: g_project.D.API = api(
     glos,
     {
-        "flattenArrayOfArrays": algorithm("FlattenArrayOfArrays", {}),
-        "append": algorithm("Append", {}),
-        "prepend": algorithm("Prepend", {}),
-        "zip": algorithm("Zip", {}),
-        "flattenTree": algorithm("FlattenTree", {}),
-        "unsafeSortTopologically": algorithm("SortTopologically", {}),
+        "flattenArrayOfArrays": algorithm([
+            `flatten an array of arrays`,
+        ], "FlattenArrayOfArrays", {}),
+        "append": algorithm([
+            `append an element to the end of an array`,
+        ], "Append", {}),
+        "prepend": algorithm([
+            `prepend an element to the beginning of an array`
+        ], "Prepend", {}),
+        "zip": algorithm([
+            `zip two arrays together`,
+            `the length of the resulting array is the length of the shortest input array`
+        ], "Zip", {}),
+        "flattenTree": algorithm([
+            `flatten a tree of values`,
+            `every node can be either an array, nothing or a value`
+        ], "FlattenTree", {}),
+        "unsafeSortTopologically": algorithm([
+            `sort a dictionary topologically`,
+            `the dictionary entries contains a value and a dictionary without values (only keys) that represent the dependencies`,
+            `if a circular dependency is detected, a panic is thrown`,
+            `the result is an array of key/value pairs`
+        ], "SortTopologically", {}),
 
     }
 )

package/auto.pareto/auto.dependencies/pareto-standard-library/modules/array/glossary.data.ts

@@ -9,7 +9,7 @@ import {
     group,
     integer,
     list,
-    member,
+    prop,
     nothing,
     optional,
     parametrizedType,
@@ -19,9 +19,9 @@ import {
     type,
     typeParameter,
     typeReference,
-} from "pareto-pure/auto.dist/public/shorthands/cosmos_type_system.sh"
+} from "pareto-pure/auto.dist/public/shorthands/pareto_4gl_type_system.sh"
 
-import * as g_glossary from "pareto-pure/auto.dist/public/auto.glossaries/auto.cosmos__type__system"
+import * as g_glossary from "pareto-pure/auto.dist/public/auto.glossaries/auto.pareto_4gl_type_system"
 
 const d = pd.d
 
@@ -42,8 +42,8 @@ export const $: g_glossary.D.Glossary = {
                 "ZippedArray": parametrizedType(
                     { "Benchmark": null, "Focus": null },
                     list(group({
-                        "benchmark": member(component(typeParameter("Benchmark"))),
-                        "focus": member(component(typeParameter("Focus"))),
+                        "benchmark": prop(component(typeParameter("Benchmark"))),
+                        "focus": prop(component(typeParameter("Focus"))),
                     }))
                 ),
 
@@ -55,22 +55,22 @@ export const $: g_glossary.D.Glossary = {
                 "AppendParameters": parametrizedType(
                     { "Type": null },
                     group({
-                        "array": member(component(typeReference("Array", { "Type": typeParameter("Type") }))),
-                        "element": member(component(typeParameter("Type"))),
+                        "array": prop(component(typeReference("Array", { "Type": typeParameter("Type") }))),
+                        "element": prop(component(typeParameter("Type"))),
                     })
                 ),
                 "PrependParameters": parametrizedType(
                     { "Type": null },
                     group({
-                        "array": member(component(typeReference("Array", { "Type": typeParameter("Type") }))),
-                        "element": member(component(typeParameter("Type"))),
+                        "array": prop(component(typeReference("Array", { "Type": typeParameter("Type") }))),
+                        "element": prop(component(typeParameter("Type"))),
                     })
                 ),
                 "ArrayTuple": parametrizedType(
                     { "Benchmark": null, "Focus": null },
                     group({
-                        "benchmark": member(component(typeReference("Array", { "Type": typeParameter("Benchmark") }))),
-                        "focus": member(component(typeReference("Array", { "Type": typeParameter("Focus") }))),
+                        "benchmark": prop(component(typeReference("Array", { "Type": typeParameter("Benchmark") }))),
+                        "focus": prop(component(typeReference("Array", { "Type": typeParameter("Focus") }))),
                     })
                 ),
                 "Nested": parametrizedType({ "Type": null }, stateGroup({
@@ -80,20 +80,20 @@ export const $: g_glossary.D.Glossary = {
                 })),
                 // "Array": parametrizedType({ "Type": null }, list(component(typeReference("KeyValuePair", { "Type": typeParameter("Type") })))),
                 // "KeyValuePair": parametrizedType({ "Type": null }, group({
-                //     "key": member(text()),
-                //     "value": member(component(typeParameter("Type"))),
+                //     "key": prop(text()),
+                //     "value": prop(component(typeParameter("Type"))),
                 // })),
 
                 "DependencyDictionary": parametrizedType({ "Type": null }, dictionary(group({
-                    "value": member(component(typeParameter("Type"))),
-                    "dependencies": member(dictionary(nothing())),
+                    "value": prop(component(typeParameter("Type"))),
+                    "dependencies": prop(dictionary(nothing())),
                 }))),
 
 
                 "KeyValuePairArray": parametrizedType({ "Type": null }, list(component(typeReference("KeyValuePair", { "Type": typeParameter("Type") })))),
                 "KeyValuePair": parametrizedType({ "Type": null }, group({
-                    "key": member(text()),
-                    "value": member(component(typeParameter("Type"))),
+                    "key": prop(text()),
+                    "value": prop(component(typeParameter("Type"))),
                 })),
 
             }),

package/auto.pareto/auto.dependencies/pareto-standard-library/modules/boolean/api.data.ts

@@ -1,20 +1,34 @@
 import * as pd from 'pareto-core-data'
 
-import { algorithm, algref, api } from "pareto-pure/auto.dist/public/shorthands/cosmos_type_system.sh"
+import { algorithm, algref, api } from "pareto-pure/auto.dist/public/shorthands/pareto_4gl_type_system.sh"
 
-import * as g_project from "pareto-pure/auto.dist/public/auto.glossaries/auto.cosmos__type__system"
+import * as g_project from "pareto-pure/auto.dist/public/auto.glossaries/auto.pareto_4gl_type_system"
 
 import { $ as glos } from "./glossary.data"
 
 export const $: g_project.D.API = api(
     glos,
     {
-        "array and": algorithm("Array And", {}),
-        "array or": algorithm("Array Or", {}),
-        "array xor": algorithm("Array Xor", {}),
-        "and": algorithm("And", {}),
-        "or": algorithm("Or", {}),
-        "xor": algorithm("Xor", {}),
-        "not": algorithm("Not", {}),
+        "array and": algorithm([
+            `return true if all input values are true, false otherwise`,
+        ], "Array And", {}),
+        "array or": algorithm([
+            `return true if at least one of the input values is true, false otherwise`,
+        ], "Array Or", {}),
+        "array xor": algorithm([
+            `return true if an odd number of input values is true, false otherwise`,
+        ], "Array Xor", {}),
+        "and": algorithm([
+            `return true if both input values are true, false otherwise`,
+        ], "And", {}),
+        "or": algorithm([
+            `return true if at least one of the input values is true, false otherwise`,
+        ], "Or", {}),
+        "xor": algorithm([
+            `return true if exactly one of the input values is true, false otherwise`,
+        ], "Xor", {}),
+        "not": algorithm([
+            `return true if the input value is false, false otherwise`,
+        ], "Not", {}),
     }
 )

package/auto.pareto/auto.dependencies/pareto-standard-library/modules/boolean/glossary.data.ts

@@ -9,7 +9,7 @@ import {
     group,
     integer,
     list,
-    member,
+    prop,
     nothing,
     optional,
     parametrizedType,
@@ -19,9 +19,9 @@ import {
     type,
     typeParameter,
     typeReference,
-} from "pareto-pure/auto.dist/public/shorthands/cosmos_type_system.sh"
+} from "pareto-pure/auto.dist/public/shorthands/pareto_4gl_type_system.sh"
 
-import * as g_glossary from "pareto-pure/auto.dist/public/auto.glossaries/auto.cosmos__type__system"
+import * as g_glossary from "pareto-pure/auto.dist/public/auto.glossaries/auto.pareto_4gl_type_system"
 const d = pd.d
 
 export const $: g_glossary.D.Glossary = {
@@ -34,8 +34,8 @@ export const $: g_glossary.D.Glossary = {
             'data types': d({
                 "Boolean": type(boolean()),
                 "Pair Of Booleans": type(group({
-                    "yin": member(boolean()),
-                    "yang": member(boolean()),
+                    "yin": prop(boolean()),
+                    "yang": prop(boolean()),
                 })),
                 "Array Of Booleans": type(list(boolean())),
             }),

package/auto.pareto/auto.dependencies/pareto-standard-library/modules/buildInterfaceInitializers/api.data.ts

@@ -1,8 +1,8 @@
 import * as pd from 'pareto-core-data'
 
-import { algorithm, algref, api } from "pareto-pure/auto.dist/public/shorthands/cosmos_type_system.sh"
+import { algorithm, algref, api } from "pareto-pure/auto.dist/public/shorthands/pareto_4gl_type_system.sh"
 
-import * as g_project from "pareto-pure/auto.dist/public/auto.glossaries/auto.cosmos__type__system"
+import * as g_project from "pareto-pure/auto.dist/public/auto.glossaries/auto.pareto_4gl_type_system"
 
 import { $ as glos } from "./glossary.data"
 
@@ -13,10 +13,10 @@ export const $: g_project.D.API = api(
         // "buildUnsafeDictionary": algorithm("BuildUnsafeDictionary", {}),
         // "buildSafeDictionary": algorithm("BuildSafeDictionary", "DictionaryBuildStrategy", {}, {
         // }),
-        "createUnsafeDictionaryBuilder": algorithm("CreateUnsafeDictionaryBuilder", {}),
+        "createUnsafeDictionaryBuilder": algorithm([], "CreateUnsafeDictionaryBuilder", {}),
         //"createSafeDictionaryBuilder": algorithm("CreateSafeDictionaryBuilder", {}),
-        "createArrayBuilder": algorithm("CreateArrayBuilder", {}),
+        "createArrayBuilder": algorithm([], "CreateArrayBuilder", {}),
 
-        "createStringBuilder": algorithm("CreateStringBuilder", {}),
+        "createStringBuilder": algorithm([], "CreateStringBuilder", {}),
     }
 )

package/auto.pareto/auto.dependencies/pareto-standard-library/modules/buildInterfaceInitializers/glossary.data.ts

@@ -9,7 +9,7 @@ import {
     group,
     integer,
     list,
-    member,
+    prop,
     nothing,
     optional,
     parametrizedType,
@@ -28,9 +28,9 @@ import {
     sInterfaceMethod,
     streamconsumer,
 
-} from "pareto-pure/auto.dist/public/shorthands/cosmos_type_system.sh"
+} from "pareto-pure/auto.dist/public/shorthands/pareto_4gl_type_system.sh"
 
-import * as g_glossary from "pareto-pure/auto.dist/public/auto.glossaries/auto.cosmos__type__system"
+import * as g_glossary from "pareto-pure/auto.dist/public/auto.glossaries/auto.pareto_4gl_type_system"
 const d = pd.d
 
 export const $: g_glossary.D.Glossary = {
@@ -47,20 +47,20 @@ export const $: g_glossary.D.Glossary = {
                 "Simple String": type(text()),
 
                 "Array": parametrizedType({ "Type": null, "EndType": null }, group({
-                    "array": member(list(component(typeParameter("Type")))),
-                    "end": member(component(typeParameter("EndType"))),
+                    "array": prop(list(component(typeParameter("Type")))),
+                    "end": prop(component(typeParameter("EndType"))),
                 })),
                 "Dictionary": parametrizedType({ "Type": null, "EndType": null }, group({
-                    "dictionary": member(dictionary(component(typeParameter("Type")))),
-                    "end": member(component(typeParameter("EndType"))),
+                    "dictionary": prop(dictionary(component(typeParameter("Type")))),
+                    "end": prop(component(typeParameter("EndType"))),
                 })),
                 "String": parametrizedType({ "EndType": null }, group({
-                    "string": member(text()),
-                    "end": member(component(typeParameter("EndType"))),
+                    "string": prop(text()),
+                    "end": prop(component(typeParameter("EndType"))),
                 })),
                 "KeyValuePair": parametrizedType({ "Type": null }, group({
-                    "key": member(text()),
-                    "value": member(component(typeParameter("Type"))),
+                    "key": prop(text()),
+                    "value": prop(component(typeParameter("Type"))),
                 })),
 
                 "DictionaryBuildStrategy": type(stateGroup({

package/auto.pareto/auto.dependencies/pareto-standard-library/modules/dictionary/api.data.ts

@@ -1,53 +1,58 @@
 import * as pd from 'pareto-core-data'
 
-import { algorithm, algref, api } from "pareto-pure/auto.dist/public/shorthands/cosmos_type_system.sh"
+import { algorithm, algref, api } from "pareto-pure/auto.dist/public/shorthands/pareto_4gl_type_system.sh"
 
-import * as g_project from "pareto-pure/auto.dist/public/auto.glossaries/auto.cosmos__type__system"
+import * as g_project from "pareto-pure/auto.dist/public/auto.glossaries/auto.pareto_4gl_type_system"
 
 import { $ as glos } from "./glossary.data"
 
 export const $: g_project.D.API = api(
     glos,
     {
-        "decorateDictionaryEntriesWithKey": algorithm("DecorateDictionaryEntriesWithKey", {}),
+        "decorateDictionaryEntriesWithKey": algorithm([
+            `all dictionary entries are decorated with the key of the entry`,
+            `the key is added to the value of the entry`,
+        ], "DecorateDictionaryEntriesWithKey", {}),
 
-        "filter": algorithm("Filter", {}),
-        /**
-         * the keys of the outermost dictionary is combined with the key of the innermost dictionary
-         */
-        "flattenDictionaryOfDictionaries": algorithm("FlattenDictionaryOfDictionaries", {}),
-        /**
-         * 2 dictionaries are combined into 1 dictionary. is a key exists in both directories, only the entry of the last dictionary will be used.
-         */
-        "mergeAndOverwrite": algorithm("MergeAndOverwrite", {}),
-        /**
-         * 2 dictionaries are combined into 1 dictionary. is a key exists in both directories, only the entry of the first dictionary will be used.
-         */
-        "mergeAndIgnore": algorithm("MergeAndIgnore", {}),
-        /**
-         * a dictionary with containing entries with values and a key candidate is transformed
-         * into a dictionary where the new key of the entry is the candidate. If candidates are not unique
-         * the function panics
-         */
-        "unsafeRekey": algorithm("UnsafeRekey", {}),
-        /**
-         * 2 dictionaries are combined into 1 dictionary. If keys are not unique this function panics.
-         */
-        "unsafeMerge": algorithm("UnsafeMerge", {}),
-        /**
-         * a key/value pair is added to a dictionary resulting in a new dictionary.
-         * if the key is not unique the function panics
-         */
-        "unsafeAddEntry": algorithm("UnsafeAddEntry", {}),
-        /**
-         * prepends and appends strings to all keys in the dictionary
-         */
-        "wrapKeys": algorithm("WrapKeys", {}),
-        /**
-         * a focus dictionary is matched to a benchmark dictionary resulting in a result dictionary
-         * this last dictionary contains all entries found in the benchmark dictionary.
-         * each entry value is optionally supplemented with the value of the focus entry, if found.
-         */
-        "zip": algorithm("Zip", {}),
+        "filter": algorithm([
+            `a dictionary of optional values is filtered into a regular dictionary`,
+            `if the optional value is not set, the entry is not included in the result`,
+            `if the optional value is set, the entry is included in the result`,
+        ], "Filter", {}),
+        "flattenDictionaryOfDictionaries": algorithm([
+            `flatten a dictionary of dictionaries`,
+            `the keys of the outermost dictionary is combined with the key of the innermost dictionary`,
+            `a separator is added between the keys`,
+            `if the separator appears in the keys of the outermost dictionary, it is escaped to guarantee uniqueness`,
+        ], "FlattenDictionaryOfDictionaries", {}),
+        "mergeAndOverwrite": algorithm([
+            `2 dictionaries are combined into 1 dictionary`,
+            `is a key exists in both directories, only the entry of the secondary dictionary will be used`,
+        ], "MergeAndOverwrite", {}),
+        "mergeAndIgnore": algorithm([
+            `2 dictionaries are combined into 1 dictionary`,
+            `is a key exists in both directories, only the entry of the primary dictionary will be used`,
+        ], "MergeAndIgnore", {}),
+        "unsafeRekey": algorithm([
+            `a dictionary with containing entries with a value and a key candidate is transformed`,
+            `into a dictionary where the new key of the entry is the candidate`,
+            `if candidates are not unique the function panics`,
+        ],"UnsafeRekey", {}),
+        "unsafeMerge": algorithm([
+            `2 dictionaries are combined into 1 dictionary`,
+            `if a key exists in both directories, the function panics`,
+        ], "UnsafeMerge", {}),
+        "unsafeAddEntry": algorithm([
+            `a key/value pair is added to a dictionary resulting in a new dictionary`,
+            `if the key is not unique the function panics`,
+        ], "UnsafeAddEntry", {}),
+        "wrapKeys": algorithm([
+            `prepends and appends strings to all keys in the dictionary`,
+        ], "WrapKeys", {}),
+        "zip": algorithm([
+            `a focus dictionary is matched to a benchmark dictionary resulting in a result dictionary`,
+            `this last dictionary contains all entries found in the benchmark dictionary`,
+            `each entry value is optionally supplemented with the value of the focus entry, if found`,
+        ], "Zip", {}),
     }
 )