@milaboratories/pl-model-common 1.19.7 → 1.19.9

package/dist/plid.d.ts

@@ -8,4 +8,3 @@ export type PlId = z.infer<typeof PlId>;
 export declare function uniquePlId(): PlId;
 export declare function plId(bytes: Uint8Array): PlId;
 export declare function digestPlId(data: string): Promise<PlId>;
-//# sourceMappingURL=plid.d.ts.map

package/dist/plid.js

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { base32Encode } from './base32_encode.js';
+
+/** Number of raw bytes in the PlId. */
+const PlIdBytes = 15;
+/** Characters in string representation */
+const PlIdLength = 24; // = 15 bytes * 8 bits / 5 bits per char in base32
+const PlId = z
+    .string()
+    .length(PlIdLength)
+    .regex(/[ABCDEFGHIJKLMNOPQRSTUVWXYZ234567]/) // RFC4648
+    .brand('PlId');
+function uniquePlId() {
+    const data = new Uint8Array(PlIdBytes);
+    crypto.getRandomValues(data);
+    return PlId.parse(base32Encode(data, 'RFC4648'));
+}
+function plId(bytes) {
+    if (bytes.length !== PlIdBytes)
+        throw new Error(`Wrong number of bytes: ${bytes.length}`);
+    return PlId.parse(base32Encode(bytes, 'RFC4648'));
+}
+async function digestPlId(data) {
+    const encoder = new TextEncoder();
+    const bytes = await crypto.subtle.digest('SHA-256', encoder.encode(data));
+    return plId(new Uint8Array(bytes.slice(0, 15)));
+}
+
+export { PlId, PlIdBytes, PlIdLength, digestPlId, plId, uniquePlId };
+//# sourceMappingURL=plid.js.map

package/dist/plid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plid.js","sources":["../src/plid.ts"],"sourcesContent":["import { z } from 'zod';\nimport { base32Encode } from './base32_encode';\n\n/** Number of raw bytes in the PlId. */\nexport const PlIdBytes = 15;\n/** Characters in string representation */\nexport const PlIdLength = 24; // = 15 bytes * 8 bits / 5 bits per char in base32\n\nexport const PlId = z\n  .string()\n  .length(PlIdLength)\n  .regex(/[ABCDEFGHIJKLMNOPQRSTUVWXYZ234567]/) // RFC4648\n  .brand('PlId');\nexport type PlId = z.infer<typeof PlId>;\n\nexport function uniquePlId(): PlId {\n  const data = new Uint8Array(PlIdBytes);\n  crypto.getRandomValues(data);\n  return PlId.parse(base32Encode(data, 'RFC4648'));\n}\n\nexport function plId(bytes: Uint8Array): PlId {\n  if (bytes.length !== PlIdBytes) throw new Error(`Wrong number of bytes: ${bytes.length}`);\n  return PlId.parse(base32Encode(bytes, 'RFC4648'));\n}\n\nexport async function digestPlId(data: string): Promise<PlId> {\n  const encoder = new TextEncoder();\n  const bytes = await crypto.subtle.digest('SHA-256', encoder.encode(data));\n  return plId(new Uint8Array(bytes.slice(0, 15)));\n}\n"],"names":[],"mappings":";;;AAGA;AACO,MAAM,SAAS,GAAG;AACzB;AACO,MAAM,UAAU,GAAG,GAAG;AAEtB,MAAM,IAAI,GAAG;AACjB,KAAA,MAAM;KACN,MAAM,CAAC,UAAU;AACjB,KAAA,KAAK,CAAC,oCAAoC,CAAC;KAC3C,KAAK,CAAC,MAAM;SAGC,UAAU,GAAA;AACxB,IAAA,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC;AACtC,IAAA,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAClD;AAEM,SAAU,IAAI,CAAC,KAAiB,EAAA;AACpC,IAAA,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,CAAA,uBAAA,EAA0B,KAAK,CAAC,MAAM,CAAA,CAAE,CAAC;IACzF,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AACnD;AAEO,eAAe,UAAU,CAAC,IAAY,EAAA;AAC3C,IAAA,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE;AACjC,IAAA,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACzE,IAAA,OAAO,IAAI,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AACjD;;;;"}

package/dist/pool/entry.d.ts

@@ -13,4 +13,3 @@ export type ResultCollection<O> = {
     /** False means that current collection is not fully loaded due to some computations still taking place */
     readonly isComplete: boolean;
 };
-//# sourceMappingURL=entry.d.ts.map

package/dist/pool/index.d.ts

@@ -1,4 +1,3 @@
 export * from './entry';
 export * from './spec';
 export * from './query';
-//# sourceMappingURL=index.d.ts.map

package/dist/pool/query.cjs

@@ -0,0 +1,49 @@
+'use strict';
+
+var spec = require('./spec.cjs');
+
+function assertNever(x) {
+    throw new Error('Unexpected object: ' + x); // This is ok, because this is a possible runtime error
+}
+function executePSpecPredicate(predicate, spec$1) {
+    switch (predicate.type) {
+        case 'and':
+            for (const operator of predicate.operands)
+                if (!executePSpecPredicate(operator, spec$1))
+                    return false;
+            return true;
+        case 'or':
+            for (const operator of predicate.operands)
+                if (executePSpecPredicate(operator, spec$1))
+                    return true;
+            return false;
+        case 'not':
+            return !executePSpecPredicate(predicate.operand, spec$1);
+        case 'name':
+            return spec.isPColumnSpec(spec$1) && spec$1.name === predicate.name;
+        case 'name_pattern':
+            return spec.isPColumnSpec(spec$1) && Boolean(spec$1.name.match(predicate.pattern));
+        case 'annotation':
+            return (spec.isPColumnSpec(spec$1)
+                && spec$1.annotations !== undefined
+                && spec$1.annotations[predicate.annotation] === predicate.value);
+        case 'annotation_pattern':
+            return (spec.isPColumnSpec(spec$1)
+                && spec$1.annotations !== undefined
+                && spec$1.annotations[predicate.annotation] !== undefined
+                && Boolean(spec$1.annotations[predicate.annotation].match(predicate.pattern)));
+        case 'has_axes':
+            return (spec.isPColumnSpec(spec$1)
+                && predicate.axes.every((matcher) => spec$1.axesSpec.some((axisSpec) => (matcher.type === undefined || matcher.type === axisSpec.type)
+                    && (matcher.name === undefined || matcher.name === axisSpec.name)
+                    && (matcher.domain === undefined
+                        || Object.keys(matcher.domain).length === 0
+                        || (axisSpec.domain !== undefined
+                            && Object.entries(matcher.domain).every(([domain, domainValue]) => axisSpec.domain[domain] === domainValue))))));
+        default:
+            assertNever(predicate);
+    }
+}
+
+exports.executePSpecPredicate = executePSpecPredicate;
+//# sourceMappingURL=query.cjs.map

package/dist/pool/query.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.cjs","sources":["../../src/pool/query.ts"],"sourcesContent":["import type { AxisId } from '../drivers';\nimport type { PObjectSpec } from './spec';\nimport { isPColumnSpec } from './spec';\n\nexport type PSpecPredicate =\n  | {\n    type: 'and' | 'or';\n    operands: PSpecPredicate[];\n  }\n  | {\n    type: 'not';\n    operand: PSpecPredicate;\n  }\n  | {\n    type: 'name';\n    name: string;\n  }\n  | {\n    type: 'name_pattern';\n    pattern: string;\n  }\n  | {\n    type: 'annotation';\n    annotation: string;\n    value: string;\n  }\n  | {\n    type: 'annotation_pattern';\n    annotation: string;\n    pattern: string;\n  }\n  | {\n    type: 'has_axes';\n    axes: Partial<AxisId>[];\n  };\n\nfunction assertNever(x: never): never {\n  throw new Error('Unexpected object: ' + x); // This is ok, because this is a possible runtime error\n}\n\nexport function executePSpecPredicate(\n  predicate: PSpecPredicate,\n  spec: PObjectSpec,\n): boolean {\n  switch (predicate.type) {\n    case 'and':\n      for (const operator of predicate.operands)\n        if (!executePSpecPredicate(operator, spec)) return false;\n      return true;\n    case 'or':\n      for (const operator of predicate.operands)\n        if (executePSpecPredicate(operator, spec)) return true;\n      return false;\n    case 'not':\n      return !executePSpecPredicate(predicate.operand, spec);\n    case 'name':\n      return isPColumnSpec(spec) && spec.name === predicate.name;\n    case 'name_pattern':\n      return isPColumnSpec(spec) && Boolean(spec.name.match(predicate.pattern));\n    case 'annotation':\n      return (\n        isPColumnSpec(spec)\n        && spec.annotations !== undefined\n        && spec.annotations[predicate.annotation] === predicate.value\n      );\n    case 'annotation_pattern':\n      return (\n        isPColumnSpec(spec)\n        && spec.annotations !== undefined\n        && spec.annotations[predicate.annotation] !== undefined\n        && Boolean(spec.annotations[predicate.annotation].match(predicate.pattern))\n      );\n    case 'has_axes':\n      return (\n        isPColumnSpec(spec)\n        && predicate.axes.every((matcher) =>\n          spec.axesSpec.some(\n            (axisSpec) =>\n              (matcher.type === undefined || matcher.type === axisSpec.type)\n              && (matcher.name === undefined || matcher.name === axisSpec.name)\n              && (matcher.domain === undefined\n                || Object.keys(matcher.domain).length === 0\n                || (axisSpec.domain !== undefined\n                  && Object.entries(matcher.domain).every(\n                    ([domain, domainValue]) =>\n                      axisSpec.domain![domain] === domainValue,\n                  ))),\n          ),\n        )\n      );\n    default:\n      assertNever(predicate);\n  }\n}\n"],"names":["spec","isPColumnSpec"],"mappings":";;;;AAoCA,SAAS,WAAW,CAAC,CAAQ,EAAA;IAC3B,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,CAAC,CAAC;AAC7C;AAEM,SAAU,qBAAqB,CACnC,SAAyB,EACzBA,MAAiB,EAAA;AAEjB,IAAA,QAAQ,SAAS,CAAC,IAAI;AACpB,QAAA,KAAK,KAAK;AACR,YAAA,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,QAAQ;AACvC,gBAAA,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAEA,MAAI,CAAC;AAAE,oBAAA,OAAO,KAAK;AAC1D,YAAA,OAAO,IAAI;AACb,QAAA,KAAK,IAAI;AACP,YAAA,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,QAAQ;AACvC,gBAAA,IAAI,qBAAqB,CAAC,QAAQ,EAAEA,MAAI,CAAC;AAAE,oBAAA,OAAO,IAAI;AACxD,YAAA,OAAO,KAAK;AACd,QAAA,KAAK,KAAK;YACR,OAAO,CAAC,qBAAqB,CAAC,SAAS,CAAC,OAAO,EAAEA,MAAI,CAAC;AACxD,QAAA,KAAK,MAAM;AACT,YAAA,OAAOC,kBAAa,CAACD,MAAI,CAAC,IAAIA,MAAI,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI;AAC5D,QAAA,KAAK,cAAc;AACjB,YAAA,OAAOC,kBAAa,CAACD,MAAI,CAAC,IAAI,OAAO,CAACA,MAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAC3E,QAAA,KAAK,YAAY;AACf,YAAA,QACEC,kBAAa,CAACD,MAAI;mBACfA,MAAI,CAAC,WAAW,KAAK;AACrB,mBAAAA,MAAI,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,SAAS,CAAC,KAAK;AAEjE,QAAA,KAAK,oBAAoB;AACvB,YAAA,QACEC,kBAAa,CAACD,MAAI;mBACfA,MAAI,CAAC,WAAW,KAAK;mBACrBA,MAAI,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK;AAC3C,mBAAA,OAAO,CAACA,MAAI,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAE/E,QAAA,KAAK,UAAU;AACb,YAAA,QACEC,kBAAa,CAACD,MAAI;AACf,mBAAA,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,KAC9BA,MAAI,CAAC,QAAQ,CAAC,IAAI,CAChB,CAAC,QAAQ,KACP,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI;AAC1D,wBAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI;AAC7D,wBAAC,OAAO,CAAC,MAAM,KAAK;2BAClB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK;AACvC,4BAAC,QAAQ,CAAC,MAAM,KAAK;AACnB,+BAAA,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CACrC,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,KACpB,QAAQ,CAAC,MAAO,CAAC,MAAM,CAAC,KAAK,WAAW,CAC3C,CAAC,CAAC,CACV,CACF;AAEL,QAAA;YACE,WAAW,CAAC,SAAS,CAAC;;AAE5B;;;;"}

package/dist/pool/query.d.ts

@@ -25,4 +25,3 @@ export type PSpecPredicate = {
     axes: Partial<AxisId>[];
 };
 export declare function executePSpecPredicate(predicate: PSpecPredicate, spec: PObjectSpec): boolean;
-//# sourceMappingURL=query.d.ts.map

package/dist/pool/query.js

@@ -0,0 +1,47 @@
+import { isPColumnSpec } from './spec.js';
+
+function assertNever(x) {
+    throw new Error('Unexpected object: ' + x); // This is ok, because this is a possible runtime error
+}
+function executePSpecPredicate(predicate, spec) {
+    switch (predicate.type) {
+        case 'and':
+            for (const operator of predicate.operands)
+                if (!executePSpecPredicate(operator, spec))
+                    return false;
+            return true;
+        case 'or':
+            for (const operator of predicate.operands)
+                if (executePSpecPredicate(operator, spec))
+                    return true;
+            return false;
+        case 'not':
+            return !executePSpecPredicate(predicate.operand, spec);
+        case 'name':
+            return isPColumnSpec(spec) && spec.name === predicate.name;
+        case 'name_pattern':
+            return isPColumnSpec(spec) && Boolean(spec.name.match(predicate.pattern));
+        case 'annotation':
+            return (isPColumnSpec(spec)
+                && spec.annotations !== undefined
+                && spec.annotations[predicate.annotation] === predicate.value);
+        case 'annotation_pattern':
+            return (isPColumnSpec(spec)
+                && spec.annotations !== undefined
+                && spec.annotations[predicate.annotation] !== undefined
+                && Boolean(spec.annotations[predicate.annotation].match(predicate.pattern)));
+        case 'has_axes':
+            return (isPColumnSpec(spec)
+                && predicate.axes.every((matcher) => spec.axesSpec.some((axisSpec) => (matcher.type === undefined || matcher.type === axisSpec.type)
+                    && (matcher.name === undefined || matcher.name === axisSpec.name)
+                    && (matcher.domain === undefined
+                        || Object.keys(matcher.domain).length === 0
+                        || (axisSpec.domain !== undefined
+                            && Object.entries(matcher.domain).every(([domain, domainValue]) => axisSpec.domain[domain] === domainValue))))));
+        default:
+            assertNever(predicate);
+    }
+}
+
+export { executePSpecPredicate };
+//# sourceMappingURL=query.js.map

package/dist/pool/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sources":["../../src/pool/query.ts"],"sourcesContent":["import type { AxisId } from '../drivers';\nimport type { PObjectSpec } from './spec';\nimport { isPColumnSpec } from './spec';\n\nexport type PSpecPredicate =\n  | {\n    type: 'and' | 'or';\n    operands: PSpecPredicate[];\n  }\n  | {\n    type: 'not';\n    operand: PSpecPredicate;\n  }\n  | {\n    type: 'name';\n    name: string;\n  }\n  | {\n    type: 'name_pattern';\n    pattern: string;\n  }\n  | {\n    type: 'annotation';\n    annotation: string;\n    value: string;\n  }\n  | {\n    type: 'annotation_pattern';\n    annotation: string;\n    pattern: string;\n  }\n  | {\n    type: 'has_axes';\n    axes: Partial<AxisId>[];\n  };\n\nfunction assertNever(x: never): never {\n  throw new Error('Unexpected object: ' + x); // This is ok, because this is a possible runtime error\n}\n\nexport function executePSpecPredicate(\n  predicate: PSpecPredicate,\n  spec: PObjectSpec,\n): boolean {\n  switch (predicate.type) {\n    case 'and':\n      for (const operator of predicate.operands)\n        if (!executePSpecPredicate(operator, spec)) return false;\n      return true;\n    case 'or':\n      for (const operator of predicate.operands)\n        if (executePSpecPredicate(operator, spec)) return true;\n      return false;\n    case 'not':\n      return !executePSpecPredicate(predicate.operand, spec);\n    case 'name':\n      return isPColumnSpec(spec) && spec.name === predicate.name;\n    case 'name_pattern':\n      return isPColumnSpec(spec) && Boolean(spec.name.match(predicate.pattern));\n    case 'annotation':\n      return (\n        isPColumnSpec(spec)\n        && spec.annotations !== undefined\n        && spec.annotations[predicate.annotation] === predicate.value\n      );\n    case 'annotation_pattern':\n      return (\n        isPColumnSpec(spec)\n        && spec.annotations !== undefined\n        && spec.annotations[predicate.annotation] !== undefined\n        && Boolean(spec.annotations[predicate.annotation].match(predicate.pattern))\n      );\n    case 'has_axes':\n      return (\n        isPColumnSpec(spec)\n        && predicate.axes.every((matcher) =>\n          spec.axesSpec.some(\n            (axisSpec) =>\n              (matcher.type === undefined || matcher.type === axisSpec.type)\n              && (matcher.name === undefined || matcher.name === axisSpec.name)\n              && (matcher.domain === undefined\n                || Object.keys(matcher.domain).length === 0\n                || (axisSpec.domain !== undefined\n                  && Object.entries(matcher.domain).every(\n                    ([domain, domainValue]) =>\n                      axisSpec.domain![domain] === domainValue,\n                  ))),\n          ),\n        )\n      );\n    default:\n      assertNever(predicate);\n  }\n}\n"],"names":[],"mappings":";;AAoCA,SAAS,WAAW,CAAC,CAAQ,EAAA;IAC3B,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,CAAC,CAAC;AAC7C;AAEM,SAAU,qBAAqB,CACnC,SAAyB,EACzB,IAAiB,EAAA;AAEjB,IAAA,QAAQ,SAAS,CAAC,IAAI;AACpB,QAAA,KAAK,KAAK;AACR,YAAA,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,QAAQ;AACvC,gBAAA,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,IAAI,CAAC;AAAE,oBAAA,OAAO,KAAK;AAC1D,YAAA,OAAO,IAAI;AACb,QAAA,KAAK,IAAI;AACP,YAAA,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,QAAQ;AACvC,gBAAA,IAAI,qBAAqB,CAAC,QAAQ,EAAE,IAAI,CAAC;AAAE,oBAAA,OAAO,IAAI;AACxD,YAAA,OAAO,KAAK;AACd,QAAA,KAAK,KAAK;YACR,OAAO,CAAC,qBAAqB,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC;AACxD,QAAA,KAAK,MAAM;AACT,YAAA,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI;AAC5D,QAAA,KAAK,cAAc;AACjB,YAAA,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAC3E,QAAA,KAAK,YAAY;AACf,YAAA,QACE,aAAa,CAAC,IAAI;mBACf,IAAI,CAAC,WAAW,KAAK;AACrB,mBAAA,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,SAAS,CAAC,KAAK;AAEjE,QAAA,KAAK,oBAAoB;AACvB,YAAA,QACE,aAAa,CAAC,IAAI;mBACf,IAAI,CAAC,WAAW,KAAK;mBACrB,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK;AAC3C,mBAAA,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAE/E,QAAA,KAAK,UAAU;AACb,YAAA,QACE,aAAa,CAAC,IAAI;AACf,mBAAA,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,KAC9B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAChB,CAAC,QAAQ,KACP,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI;AAC1D,wBAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI;AAC7D,wBAAC,OAAO,CAAC,MAAM,KAAK;2BAClB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK;AACvC,4BAAC,QAAQ,CAAC,MAAM,KAAK;AACnB,+BAAA,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CACrC,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,KACpB,QAAQ,CAAC,MAAO,CAAC,MAAM,CAAC,KAAK,WAAW,CAC3C,CAAC,CAAC,CACV,CACF;AAEL,QAAA;YACE,WAAW,CAAC,SAAS,CAAC;;AAE5B;;;;"}

package/dist/pool/spec.cjs

@@ -0,0 +1,67 @@
+'use strict';
+
+var util = require('../util.cjs');
+
+function isPColumnSpec(spec) {
+    return spec.kind === 'PColumn';
+}
+function isPColumn(obj) {
+    return isPColumnSpec(obj.spec);
+}
+function isPColumnSpecResult(r) {
+    return isPColumnSpec(r.obj);
+}
+function isPColumnResult(r) {
+    return isPColumnSpec(r.obj.spec);
+}
+function ensurePColumn(obj) {
+    if (!isPColumn(obj))
+        throw new Error(`not a PColumn (kind = ${obj.spec.kind})`);
+    return obj;
+}
+function mapPObjectData(pObj, cb) {
+    return pObj === undefined
+        ? undefined
+        : {
+            ...pObj,
+            data: cb(pObj.data),
+        };
+}
+function extractAllColumns(entry) {
+    const columns = new Map();
+    const addAllColumns = (entry) => {
+        switch (entry.type) {
+            case 'column':
+                columns.set(entry.column.id, entry.column);
+                return;
+            case 'slicedColumn':
+                columns.set(entry.column.id, entry.column);
+                return;
+            case 'inlineColumn':
+                return;
+            case 'full':
+            case 'inner':
+                for (const e of entry.entries)
+                    addAllColumns(e);
+                return;
+            case 'outer':
+                addAllColumns(entry.primary);
+                for (const e of entry.secondary)
+                    addAllColumns(e);
+                return;
+            default:
+                util.assertNever(entry);
+        }
+    };
+    addAllColumns(entry);
+    return [...columns.values()];
+}
+
+exports.ensurePColumn = ensurePColumn;
+exports.extractAllColumns = extractAllColumns;
+exports.isPColumn = isPColumn;
+exports.isPColumnResult = isPColumnResult;
+exports.isPColumnSpec = isPColumnSpec;
+exports.isPColumnSpecResult = isPColumnSpecResult;
+exports.mapPObjectData = mapPObjectData;
+//# sourceMappingURL=spec.cjs.map

package/dist/pool/spec.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.cjs","sources":["../../src/pool/spec.ts"],"sourcesContent":["import type { Branded } from '../branding';\nimport type { JoinEntry, PColumn, PColumnSpec } from '../drivers';\nimport { assertNever } from '../util';\nimport type { ResultPoolEntry } from './entry';\n\n/** Any object exported into the result pool by the block always have spec attached to it */\nexport interface PObjectSpec {\n  /** PObject kind discriminator */\n  readonly kind: string;\n\n  /** Name is common part of PObject identity */\n  readonly name: string;\n\n  /** Domain is a set of key-value pairs that can be used to identify the object */\n  readonly domain?: Record<string, string>;\n\n  /** Additional information attached to the object */\n  readonly annotations?: Record<string, string>;\n}\n\n/** Stable PObject id */\nexport type PObjectId = Branded<string, 'PColumnId'>;\n\n/**\n * Full PObject representation.\n *\n * @template Data type of the object referencing or describing the \"data\" part of the PObject\n * */\nexport interface PObject<Data> {\n  /** Fully rendered PObjects are assigned a stable identifier. */\n  readonly id: PObjectId;\n\n  /** PObject spec, allowing it to be found among other PObjects */\n  readonly spec: PObjectSpec;\n\n  /** A handle to data object */\n  readonly data: Data;\n}\n\nexport function isPColumnSpec(spec: PObjectSpec): spec is PColumnSpec {\n  return spec.kind === 'PColumn';\n}\n\nexport function isPColumn<T>(obj: PObject<T>): obj is PColumn<T> {\n  return isPColumnSpec(obj.spec);\n}\n\nexport function isPColumnSpecResult(\n  r: ResultPoolEntry<PObjectSpec>,\n): r is ResultPoolEntry<PColumnSpec> {\n  return isPColumnSpec(r.obj);\n}\n\nexport function isPColumnResult<T>(\n  r: ResultPoolEntry<PObject<T>>,\n): r is ResultPoolEntry<PColumn<T>> {\n  return isPColumnSpec(r.obj.spec);\n}\n\nexport function ensurePColumn<T>(obj: PObject<T>): PColumn<T> {\n  if (!isPColumn(obj)) throw new Error(`not a PColumn (kind = ${obj.spec.kind})`);\n  return obj;\n}\n\nexport function mapPObjectData<D1, D2>(pObj: PColumn<D1>, cb: (d: D1) => D2): PColumn<D2>;\nexport function mapPObjectData<D1, D2>(\n  pObj: PColumn<D1> | undefined,\n  cb: (d: D1) => D2\n): PColumn<D2> | undefined;\nexport function mapPObjectData<D1, D2>(pObj: PObject<D1>, cb: (d: D1) => D2): PObject<D2>;\nexport function mapPObjectData<D1, D2>(\n  pObj: PObject<D1> | undefined,\n  cb: (d: D1) => D2\n): PObject<D2> | undefined;\nexport function mapPObjectData<D1, D2>(\n  pObj: PObject<D1> | undefined,\n  cb: (d: D1) => D2,\n): PObject<D2> | undefined {\n  return pObj === undefined\n    ? undefined\n    : {\n        ...pObj,\n        data: cb(pObj.data),\n      };\n}\n\nexport function extractAllColumns<D>(entry: JoinEntry<PColumn<D>>): PColumn<D>[] {\n  const columns = new Map<PObjectId, PColumn<D>>();\n  const addAllColumns = (entry: JoinEntry<PColumn<D>>) => {\n    switch (entry.type) {\n      case 'column':\n        columns.set(entry.column.id, entry.column);\n        return;\n      case 'slicedColumn':\n        columns.set(entry.column.id, entry.column);\n        return;\n      case 'inlineColumn':\n        return;\n      case 'full':\n      case 'inner':\n        for (const e of entry.entries) addAllColumns(e);\n        return;\n      case 'outer':\n        addAllColumns(entry.primary);\n        for (const e of entry.secondary) addAllColumns(e);\n        return;\n      default:\n        assertNever(entry);\n    }\n  };\n  addAllColumns(entry);\n  return [...columns.values()];\n}\n"],"names":["assertNever"],"mappings":";;;;AAuCM,SAAU,aAAa,CAAC,IAAiB,EAAA;AAC7C,IAAA,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS;AAChC;AAEM,SAAU,SAAS,CAAI,GAAe,EAAA;AAC1C,IAAA,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC;AAChC;AAEM,SAAU,mBAAmB,CACjC,CAA+B,EAAA;AAE/B,IAAA,OAAO,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC;AAC7B;AAEM,SAAU,eAAe,CAC7B,CAA8B,EAAA;IAE9B,OAAO,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;AAClC;AAEM,SAAU,aAAa,CAAI,GAAe,EAAA;AAC9C,IAAA,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,CAAA,sBAAA,EAAyB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAA,CAAA,CAAG,CAAC;AAC/E,IAAA,OAAO,GAAG;AACZ;AAYM,SAAU,cAAc,CAC5B,IAA6B,EAC7B,EAAiB,EAAA;IAEjB,OAAO,IAAI,KAAK;AACd,UAAE;AACF,UAAE;AACE,YAAA,GAAG,IAAI;AACP,YAAA,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SACpB;AACP;AAEM,SAAU,iBAAiB,CAAI,KAA4B,EAAA;AAC/D,IAAA,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyB;AAChD,IAAA,MAAM,aAAa,GAAG,CAAC,KAA4B,KAAI;AACrD,QAAA,QAAQ,KAAK,CAAC,IAAI;AAChB,YAAA,KAAK,QAAQ;AACX,gBAAA,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC;gBAC1C;AACF,YAAA,KAAK,cAAc;AACjB,gBAAA,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC;gBAC1C;AACF,YAAA,KAAK,cAAc;gBACjB;AACF,YAAA,KAAK,MAAM;AACX,YAAA,KAAK,OAAO;AACV,gBAAA,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO;oBAAE,aAAa,CAAC,CAAC,CAAC;gBAC/C;AACF,YAAA,KAAK,OAAO;AACV,gBAAA,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC;AAC5B,gBAAA,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS;oBAAE,aAAa,CAAC,CAAC,CAAC;gBACjD;AACF,YAAA;gBACEA,gBAAW,CAAC,KAAK,CAAC;;AAExB,IAAA,CAAC;IACD,aAAa,CAAC,KAAK,CAAC;AACpB,IAAA,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;AAC9B;;;;;;;;;;"}

package/dist/pool/spec.d.ts

@@ -37,4 +37,3 @@ export declare function mapPObjectData<D1, D2>(pObj: PColumn<D1> | undefined, cb
 export declare function mapPObjectData<D1, D2>(pObj: PObject<D1>, cb: (d: D1) => D2): PObject<D2>;
 export declare function mapPObjectData<D1, D2>(pObj: PObject<D1> | undefined, cb: (d: D1) => D2): PObject<D2> | undefined;
 export declare function extractAllColumns<D>(entry: JoinEntry<PColumn<D>>): PColumn<D>[];
-//# sourceMappingURL=spec.d.ts.map

package/dist/pool/spec.js

@@ -0,0 +1,59 @@
+import { assertNever } from '../util.js';
+
+function isPColumnSpec(spec) {
+    return spec.kind === 'PColumn';
+}
+function isPColumn(obj) {
+    return isPColumnSpec(obj.spec);
+}
+function isPColumnSpecResult(r) {
+    return isPColumnSpec(r.obj);
+}
+function isPColumnResult(r) {
+    return isPColumnSpec(r.obj.spec);
+}
+function ensurePColumn(obj) {
+    if (!isPColumn(obj))
+        throw new Error(`not a PColumn (kind = ${obj.spec.kind})`);
+    return obj;
+}
+function mapPObjectData(pObj, cb) {
+    return pObj === undefined
+        ? undefined
+        : {
+            ...pObj,
+            data: cb(pObj.data),
+        };
+}
+function extractAllColumns(entry) {
+    const columns = new Map();
+    const addAllColumns = (entry) => {
+        switch (entry.type) {
+            case 'column':
+                columns.set(entry.column.id, entry.column);
+                return;
+            case 'slicedColumn':
+                columns.set(entry.column.id, entry.column);
+                return;
+            case 'inlineColumn':
+                return;
+            case 'full':
+            case 'inner':
+                for (const e of entry.entries)
+                    addAllColumns(e);
+                return;
+            case 'outer':
+                addAllColumns(entry.primary);
+                for (const e of entry.secondary)
+                    addAllColumns(e);
+                return;
+            default:
+                assertNever(entry);
+        }
+    };
+    addAllColumns(entry);
+    return [...columns.values()];
+}
+
+export { ensurePColumn, extractAllColumns, isPColumn, isPColumnResult, isPColumnSpec, isPColumnSpecResult, mapPObjectData };
+//# sourceMappingURL=spec.js.map

package/dist/pool/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sources":["../../src/pool/spec.ts"],"sourcesContent":["import type { Branded } from '../branding';\nimport type { JoinEntry, PColumn, PColumnSpec } from '../drivers';\nimport { assertNever } from '../util';\nimport type { ResultPoolEntry } from './entry';\n\n/** Any object exported into the result pool by the block always have spec attached to it */\nexport interface PObjectSpec {\n  /** PObject kind discriminator */\n  readonly kind: string;\n\n  /** Name is common part of PObject identity */\n  readonly name: string;\n\n  /** Domain is a set of key-value pairs that can be used to identify the object */\n  readonly domain?: Record<string, string>;\n\n  /** Additional information attached to the object */\n  readonly annotations?: Record<string, string>;\n}\n\n/** Stable PObject id */\nexport type PObjectId = Branded<string, 'PColumnId'>;\n\n/**\n * Full PObject representation.\n *\n * @template Data type of the object referencing or describing the \"data\" part of the PObject\n * */\nexport interface PObject<Data> {\n  /** Fully rendered PObjects are assigned a stable identifier. */\n  readonly id: PObjectId;\n\n  /** PObject spec, allowing it to be found among other PObjects */\n  readonly spec: PObjectSpec;\n\n  /** A handle to data object */\n  readonly data: Data;\n}\n\nexport function isPColumnSpec(spec: PObjectSpec): spec is PColumnSpec {\n  return spec.kind === 'PColumn';\n}\n\nexport function isPColumn<T>(obj: PObject<T>): obj is PColumn<T> {\n  return isPColumnSpec(obj.spec);\n}\n\nexport function isPColumnSpecResult(\n  r: ResultPoolEntry<PObjectSpec>,\n): r is ResultPoolEntry<PColumnSpec> {\n  return isPColumnSpec(r.obj);\n}\n\nexport function isPColumnResult<T>(\n  r: ResultPoolEntry<PObject<T>>,\n): r is ResultPoolEntry<PColumn<T>> {\n  return isPColumnSpec(r.obj.spec);\n}\n\nexport function ensurePColumn<T>(obj: PObject<T>): PColumn<T> {\n  if (!isPColumn(obj)) throw new Error(`not a PColumn (kind = ${obj.spec.kind})`);\n  return obj;\n}\n\nexport function mapPObjectData<D1, D2>(pObj: PColumn<D1>, cb: (d: D1) => D2): PColumn<D2>;\nexport function mapPObjectData<D1, D2>(\n  pObj: PColumn<D1> | undefined,\n  cb: (d: D1) => D2\n): PColumn<D2> | undefined;\nexport function mapPObjectData<D1, D2>(pObj: PObject<D1>, cb: (d: D1) => D2): PObject<D2>;\nexport function mapPObjectData<D1, D2>(\n  pObj: PObject<D1> | undefined,\n  cb: (d: D1) => D2\n): PObject<D2> | undefined;\nexport function mapPObjectData<D1, D2>(\n  pObj: PObject<D1> | undefined,\n  cb: (d: D1) => D2,\n): PObject<D2> | undefined {\n  return pObj === undefined\n    ? undefined\n    : {\n        ...pObj,\n        data: cb(pObj.data),\n      };\n}\n\nexport function extractAllColumns<D>(entry: JoinEntry<PColumn<D>>): PColumn<D>[] {\n  const columns = new Map<PObjectId, PColumn<D>>();\n  const addAllColumns = (entry: JoinEntry<PColumn<D>>) => {\n    switch (entry.type) {\n      case 'column':\n        columns.set(entry.column.id, entry.column);\n        return;\n      case 'slicedColumn':\n        columns.set(entry.column.id, entry.column);\n        return;\n      case 'inlineColumn':\n        return;\n      case 'full':\n      case 'inner':\n        for (const e of entry.entries) addAllColumns(e);\n        return;\n      case 'outer':\n        addAllColumns(entry.primary);\n        for (const e of entry.secondary) addAllColumns(e);\n        return;\n      default:\n        assertNever(entry);\n    }\n  };\n  addAllColumns(entry);\n  return [...columns.values()];\n}\n"],"names":[],"mappings":";;AAuCM,SAAU,aAAa,CAAC,IAAiB,EAAA;AAC7C,IAAA,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS;AAChC;AAEM,SAAU,SAAS,CAAI,GAAe,EAAA;AAC1C,IAAA,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC;AAChC;AAEM,SAAU,mBAAmB,CACjC,CAA+B,EAAA;AAE/B,IAAA,OAAO,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC;AAC7B;AAEM,SAAU,eAAe,CAC7B,CAA8B,EAAA;IAE9B,OAAO,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;AAClC;AAEM,SAAU,aAAa,CAAI,GAAe,EAAA;AAC9C,IAAA,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,CAAA,sBAAA,EAAyB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAA,CAAA,CAAG,CAAC;AAC/E,IAAA,OAAO,GAAG;AACZ;AAYM,SAAU,cAAc,CAC5B,IAA6B,EAC7B,EAAiB,EAAA;IAEjB,OAAO,IAAI,KAAK;AACd,UAAE;AACF,UAAE;AACE,YAAA,GAAG,IAAI;AACP,YAAA,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SACpB;AACP;AAEM,SAAU,iBAAiB,CAAI,KAA4B,EAAA;AAC/D,IAAA,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyB;AAChD,IAAA,MAAM,aAAa,GAAG,CAAC,KAA4B,KAAI;AACrD,QAAA,QAAQ,KAAK,CAAC,IAAI;AAChB,YAAA,KAAK,QAAQ;AACX,gBAAA,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC;gBAC1C;AACF,YAAA,KAAK,cAAc;AACjB,gBAAA,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC;gBAC1C;AACF,YAAA,KAAK,cAAc;gBACjB;AACF,YAAA,KAAK,MAAM;AACX,YAAA,KAAK,OAAO;AACV,gBAAA,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO;oBAAE,aAAa,CAAC,CAAC,CAAC;gBAC/C;AACF,YAAA,KAAK,OAAO;AACV,gBAAA,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC;AAC5B,gBAAA,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS;oBAAE,aAAa,CAAC,CAAC,CAAC;gBACjD;AACF,YAAA;gBACE,WAAW,CAAC,KAAK,CAAC;;AAExB,IAAA,CAAC;IACD,aAAa,CAAC,KAAK,CAAC;AACpB,IAAA,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;AAC9B;;;;"}

package/dist/ref.cjs

@@ -0,0 +1,88 @@
+'use strict';
+
+var zod = require('zod');
+
+const PlRef = zod.z
+    .object({
+    __isRef: zod.z
+        .literal(true)
+        .describe('Crucial marker for the block dependency tree reconstruction'),
+    blockId: zod.z.string()
+        .describe('Upstream block id'),
+    name: zod.z.string()
+        .describe('Name of the output provided to the upstream block\'s output context'),
+    requireEnrichments: zod.z.literal(true).optional()
+        .describe('True if current block that stores this reference in its args, may need enrichments '
+        + 'for the references value originating from the blocks in between current and referenced block'),
+})
+    .describe('Universal reference type, allowing to set block connections. It is crucial that '
+    + '{@link __isRef} is present and equal to true, internal logic relies on this marker '
+    + 'to build block dependency trees.')
+    .readonly();
+/**
+ * Type guard to check if a value is a PlRef.
+ *
+ * @param value - The value to check.
+ * @returns True if the value is a PlRef, false otherwise.
+ */
+function isPlRef(value) {
+    return (typeof value === 'object'
+        && value !== null
+        && '__isRef' in value
+        && value.__isRef === true
+        && 'blockId' in value
+        && 'name' in value);
+}
+/**
+ * Creates a PlRef with the given blockId and name.
+ *
+ * @param blockId - The blockId of the reference.
+ * @param name - The name of the reference.
+ * @param requireEnrichments - Whether the reference requires enrichments.
+ */
+function createPlRef(blockId, name, requireEnrichments = false) {
+    if (requireEnrichments)
+        return {
+            __isRef: true,
+            blockId,
+            name,
+            requireEnrichments: true,
+        };
+    else
+        return {
+            __isRef: true,
+            blockId,
+            name,
+        };
+}
+/**
+ * Creates a new PlRef based on an existing one, explicitly setting (default) or removing the
+ * requireEnrichments property.
+ *
+ * @param ref - The original PlRef object.
+ * @param requireEnrichments - If true, the `requireEnrichments: true` property is added
+ *   to the returned PlRef. If false, the `requireEnrichments` property is removed. Defaults to true.
+ * @returns A new PlRef object with the `requireEnrichments` property set or removed accordingly.
+ */
+function withEnrichments(ref, requireEnrichments = true) {
+    if (requireEnrichments)
+        return {
+            ...ref,
+            requireEnrichments: true,
+        };
+    else {
+        const { requireEnrichments: _, ...rest } = ref;
+        return rest;
+    }
+}
+/** Compare two PlRefs and returns true if they are qual */
+function plRefsEqual(ref1, ref2, ignoreEnrichments = false) {
+    return ref1.blockId === ref2.blockId && ref1.name === ref2.name && (ignoreEnrichments || ref1.requireEnrichments === ref2.requireEnrichments);
+}
+
+exports.PlRef = PlRef;
+exports.createPlRef = createPlRef;
+exports.isPlRef = isPlRef;
+exports.plRefsEqual = plRefsEqual;
+exports.withEnrichments = withEnrichments;
+//# sourceMappingURL=ref.cjs.map

package/dist/ref.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.cjs","sources":["../src/ref.ts"],"sourcesContent":["import { z } from 'zod';\n\nexport const PlRef = z\n  .object({\n    __isRef: z\n      .literal(true)\n      .describe('Crucial marker for the block dependency tree reconstruction'),\n    blockId: z.string()\n      .describe('Upstream block id'),\n    name: z.string()\n      .describe('Name of the output provided to the upstream block\\'s output context'),\n    requireEnrichments: z.literal(true).optional()\n      .describe('True if current block that stores this reference in its args, may need enrichments '\n        + 'for the references value originating from the blocks in between current and referenced block'),\n  })\n  .describe(\n    'Universal reference type, allowing to set block connections. It is crucial that '\n    + '{@link __isRef} is present and equal to true, internal logic relies on this marker '\n    + 'to build block dependency trees.',\n  )\n  .readonly();\nexport type PlRef = z.infer<typeof PlRef>;\n/** @deprecated use {@link PlRef} */\nexport type Ref = PlRef;\n\n/**\n * Type guard to check if a value is a PlRef.\n *\n * @param value - The value to check.\n * @returns True if the value is a PlRef, false otherwise.\n */\nexport function isPlRef(value: unknown): value is PlRef {\n  return (\n    typeof value === 'object'\n    && value !== null\n    && '__isRef' in value\n    && (value as { __isRef: unknown }).__isRef === true\n    && 'blockId' in value\n    && 'name' in value\n  );\n}\n\n/** Standard way how to communicate possible connections given specific\n * requirements for incoming data. */\nexport type Option = {\n  /** Fully rendered reference to be assigned for the intended field in block's\n   * args */\n  readonly ref: PlRef;\n\n  /** Label to be present for the user in i.e. drop-down list */\n  readonly label: string;\n};\n\n/**\n * Creates a PlRef with the given blockId and name.\n *\n * @param blockId - The blockId of the reference.\n * @param name - The name of the reference.\n * @param requireEnrichments - Whether the reference requires enrichments.\n */\nexport function createPlRef(blockId: string, name: string, requireEnrichments: boolean = false) {\n  if (requireEnrichments)\n    return {\n      __isRef: true,\n      blockId,\n      name,\n      requireEnrichments: true,\n    };\n  else\n    return {\n      __isRef: true,\n      blockId,\n      name,\n    };\n}\n\n/**\n * Creates a new PlRef based on an existing one, explicitly setting (default) or removing the\n * requireEnrichments property.\n *\n * @param ref - The original PlRef object.\n * @param requireEnrichments - If true, the `requireEnrichments: true` property is added\n *   to the returned PlRef. If false, the `requireEnrichments` property is removed. Defaults to true.\n * @returns A new PlRef object with the `requireEnrichments` property set or removed accordingly.\n */\nexport function withEnrichments(ref: PlRef, requireEnrichments: boolean = true): PlRef {\n  if (requireEnrichments)\n    return {\n      ...ref,\n      requireEnrichments: true,\n    };\n  else {\n    const { requireEnrichments: _, ...rest } = ref;\n    return rest;\n  }\n}\n\n/** Compare two PlRefs and returns true if they are qual */\nexport function plRefsEqual(ref1: PlRef, ref2: PlRef, ignoreEnrichments: boolean = false) {\n  return ref1.blockId === ref2.blockId && ref1.name === ref2.name && (ignoreEnrichments || ref1.requireEnrichments === ref2.requireEnrichments);\n}\n"],"names":["z"],"mappings":";;;;AAEO,MAAM,KAAK,GAAGA;AAClB,KAAA,MAAM,CAAC;AACN,IAAA,OAAO,EAAEA;SACN,OAAO,CAAC,IAAI;SACZ,QAAQ,CAAC,6DAA6D,CAAC;AAC1E,IAAA,OAAO,EAAEA,KAAC,CAAC,MAAM;SACd,QAAQ,CAAC,mBAAmB,CAAC;AAChC,IAAA,IAAI,EAAEA,KAAC,CAAC,MAAM;SACX,QAAQ,CAAC,qEAAqE,CAAC;IAClF,kBAAkB,EAAEA,KAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ;AACzC,SAAA,QAAQ,CAAC;AACN,UAAA,8FAA8F,CAAC;CACtG;AACA,KAAA,QAAQ,CACP;MACE;AACA,MAAA,kCAAkC;AAErC,KAAA,QAAQ;AAKX;;;;;AAKG;AACG,SAAU,OAAO,CAAC,KAAc,EAAA;AACpC,IAAA,QACE,OAAO,KAAK,KAAK;AACd,WAAA,KAAK,KAAK;AACV,WAAA,SAAS,IAAI;WACZ,KAA8B,CAAC,OAAO,KAAK;AAC5C,WAAA,SAAS,IAAI;WACb,MAAM,IAAI,KAAK;AAEtB;AAaA;;;;;;AAMG;AACG,SAAU,WAAW,CAAC,OAAe,EAAE,IAAY,EAAE,qBAA8B,KAAK,EAAA;AAC5F,IAAA,IAAI,kBAAkB;QACpB,OAAO;AACL,YAAA,OAAO,EAAE,IAAI;YACb,OAAO;YACP,IAAI;AACJ,YAAA,kBAAkB,EAAE,IAAI;SACzB;;QAED,OAAO;AACL,YAAA,OAAO,EAAE,IAAI;YACb,OAAO;YACP,IAAI;SACL;AACL;AAEA;;;;;;;;AAQG;SACa,eAAe,CAAC,GAAU,EAAE,qBAA8B,IAAI,EAAA;AAC5E,IAAA,IAAI,kBAAkB;QACpB,OAAO;AACL,YAAA,GAAG,GAAG;AACN,YAAA,kBAAkB,EAAE,IAAI;SACzB;SACE;QACH,MAAM,EAAE,kBAAkB,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG;AAC9C,QAAA,OAAO,IAAI;IACb;AACF;AAEA;AACM,SAAU,WAAW,CAAC,IAAW,EAAE,IAAW,EAAE,oBAA6B,KAAK,EAAA;IACtF,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,iBAAiB,IAAI,IAAI,CAAC,kBAAkB,KAAK,IAAI,CAAC,kBAAkB,CAAC;AAC/I;;;;;;;;"}

package/dist/ref.d.ts

@@ -64,4 +64,3 @@ export declare function createPlRef(blockId: string, name: string, requireEnrich
 export declare function withEnrichments(ref: PlRef, requireEnrichments?: boolean): PlRef;
 /** Compare two PlRefs and returns true if they are qual */
 export declare function plRefsEqual(ref1: PlRef, ref2: PlRef, ignoreEnrichments?: boolean): boolean;
-//# sourceMappingURL=ref.d.ts.map

package/dist/ref.js

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+
+const PlRef = z
+    .object({
+    __isRef: z
+        .literal(true)
+        .describe('Crucial marker for the block dependency tree reconstruction'),
+    blockId: z.string()
+        .describe('Upstream block id'),
+    name: z.string()
+        .describe('Name of the output provided to the upstream block\'s output context'),
+    requireEnrichments: z.literal(true).optional()
+        .describe('True if current block that stores this reference in its args, may need enrichments '
+        + 'for the references value originating from the blocks in between current and referenced block'),
+})
+    .describe('Universal reference type, allowing to set block connections. It is crucial that '
+    + '{@link __isRef} is present and equal to true, internal logic relies on this marker '
+    + 'to build block dependency trees.')
+    .readonly();
+/**
+ * Type guard to check if a value is a PlRef.
+ *
+ * @param value - The value to check.
+ * @returns True if the value is a PlRef, false otherwise.
+ */
+function isPlRef(value) {
+    return (typeof value === 'object'
+        && value !== null
+        && '__isRef' in value
+        && value.__isRef === true
+        && 'blockId' in value
+        && 'name' in value);
+}
+/**
+ * Creates a PlRef with the given blockId and name.
+ *
+ * @param blockId - The blockId of the reference.
+ * @param name - The name of the reference.
+ * @param requireEnrichments - Whether the reference requires enrichments.
+ */
+function createPlRef(blockId, name, requireEnrichments = false) {
+    if (requireEnrichments)
+        return {
+            __isRef: true,
+            blockId,
+            name,
+            requireEnrichments: true,
+        };
+    else
+        return {
+            __isRef: true,
+            blockId,
+            name,
+        };
+}
+/**
+ * Creates a new PlRef based on an existing one, explicitly setting (default) or removing the
+ * requireEnrichments property.
+ *
+ * @param ref - The original PlRef object.
+ * @param requireEnrichments - If true, the `requireEnrichments: true` property is added
+ *   to the returned PlRef. If false, the `requireEnrichments` property is removed. Defaults to true.
+ * @returns A new PlRef object with the `requireEnrichments` property set or removed accordingly.
+ */
+function withEnrichments(ref, requireEnrichments = true) {
+    if (requireEnrichments)
+        return {
+            ...ref,
+            requireEnrichments: true,
+        };
+    else {
+        const { requireEnrichments: _, ...rest } = ref;
+        return rest;
+    }
+}
+/** Compare two PlRefs and returns true if they are qual */
+function plRefsEqual(ref1, ref2, ignoreEnrichments = false) {
+    return ref1.blockId === ref2.blockId && ref1.name === ref2.name && (ignoreEnrichments || ref1.requireEnrichments === ref2.requireEnrichments);
+}
+
+export { PlRef, createPlRef, isPlRef, plRefsEqual, withEnrichments };
+//# sourceMappingURL=ref.js.map

package/dist/ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.js","sources":["../src/ref.ts"],"sourcesContent":["import { z } from 'zod';\n\nexport const PlRef = z\n  .object({\n    __isRef: z\n      .literal(true)\n      .describe('Crucial marker for the block dependency tree reconstruction'),\n    blockId: z.string()\n      .describe('Upstream block id'),\n    name: z.string()\n      .describe('Name of the output provided to the upstream block\\'s output context'),\n    requireEnrichments: z.literal(true).optional()\n      .describe('True if current block that stores this reference in its args, may need enrichments '\n        + 'for the references value originating from the blocks in between current and referenced block'),\n  })\n  .describe(\n    'Universal reference type, allowing to set block connections. It is crucial that '\n    + '{@link __isRef} is present and equal to true, internal logic relies on this marker '\n    + 'to build block dependency trees.',\n  )\n  .readonly();\nexport type PlRef = z.infer<typeof PlRef>;\n/** @deprecated use {@link PlRef} */\nexport type Ref = PlRef;\n\n/**\n * Type guard to check if a value is a PlRef.\n *\n * @param value - The value to check.\n * @returns True if the value is a PlRef, false otherwise.\n */\nexport function isPlRef(value: unknown): value is PlRef {\n  return (\n    typeof value === 'object'\n    && value !== null\n    && '__isRef' in value\n    && (value as { __isRef: unknown }).__isRef === true\n    && 'blockId' in value\n    && 'name' in value\n  );\n}\n\n/** Standard way how to communicate possible connections given specific\n * requirements for incoming data. */\nexport type Option = {\n  /** Fully rendered reference to be assigned for the intended field in block's\n   * args */\n  readonly ref: PlRef;\n\n  /** Label to be present for the user in i.e. drop-down list */\n  readonly label: string;\n};\n\n/**\n * Creates a PlRef with the given blockId and name.\n *\n * @param blockId - The blockId of the reference.\n * @param name - The name of the reference.\n * @param requireEnrichments - Whether the reference requires enrichments.\n */\nexport function createPlRef(blockId: string, name: string, requireEnrichments: boolean = false) {\n  if (requireEnrichments)\n    return {\n      __isRef: true,\n      blockId,\n      name,\n      requireEnrichments: true,\n    };\n  else\n    return {\n      __isRef: true,\n      blockId,\n      name,\n    };\n}\n\n/**\n * Creates a new PlRef based on an existing one, explicitly setting (default) or removing the\n * requireEnrichments property.\n *\n * @param ref - The original PlRef object.\n * @param requireEnrichments - If true, the `requireEnrichments: true` property is added\n *   to the returned PlRef. If false, the `requireEnrichments` property is removed. Defaults to true.\n * @returns A new PlRef object with the `requireEnrichments` property set or removed accordingly.\n */\nexport function withEnrichments(ref: PlRef, requireEnrichments: boolean = true): PlRef {\n  if (requireEnrichments)\n    return {\n      ...ref,\n      requireEnrichments: true,\n    };\n  else {\n    const { requireEnrichments: _, ...rest } = ref;\n    return rest;\n  }\n}\n\n/** Compare two PlRefs and returns true if they are qual */\nexport function plRefsEqual(ref1: PlRef, ref2: PlRef, ignoreEnrichments: boolean = false) {\n  return ref1.blockId === ref2.blockId && ref1.name === ref2.name && (ignoreEnrichments || ref1.requireEnrichments === ref2.requireEnrichments);\n}\n"],"names":[],"mappings":";;AAEO,MAAM,KAAK,GAAG;AAClB,KAAA,MAAM,CAAC;AACN,IAAA,OAAO,EAAE;SACN,OAAO,CAAC,IAAI;SACZ,QAAQ,CAAC,6DAA6D,CAAC;AAC1E,IAAA,OAAO,EAAE,CAAC,CAAC,MAAM;SACd,QAAQ,CAAC,mBAAmB,CAAC;AAChC,IAAA,IAAI,EAAE,CAAC,CAAC,MAAM;SACX,QAAQ,CAAC,qEAAqE,CAAC;IAClF,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ;AACzC,SAAA,QAAQ,CAAC;AACN,UAAA,8FAA8F,CAAC;CACtG;AACA,KAAA,QAAQ,CACP;MACE;AACA,MAAA,kCAAkC;AAErC,KAAA,QAAQ;AAKX;;;;;AAKG;AACG,SAAU,OAAO,CAAC,KAAc,EAAA;AACpC,IAAA,QACE,OAAO,KAAK,KAAK;AACd,WAAA,KAAK,KAAK;AACV,WAAA,SAAS,IAAI;WACZ,KAA8B,CAAC,OAAO,KAAK;AAC5C,WAAA,SAAS,IAAI;WACb,MAAM,IAAI,KAAK;AAEtB;AAaA;;;;;;AAMG;AACG,SAAU,WAAW,CAAC,OAAe,EAAE,IAAY,EAAE,qBAA8B,KAAK,EAAA;AAC5F,IAAA,IAAI,kBAAkB;QACpB,OAAO;AACL,YAAA,OAAO,EAAE,IAAI;YACb,OAAO;YACP,IAAI;AACJ,YAAA,kBAAkB,EAAE,IAAI;SACzB;;QAED,OAAO;AACL,YAAA,OAAO,EAAE,IAAI;YACb,OAAO;YACP,IAAI;SACL;AACL;AAEA;;;;;;;;AAQG;SACa,eAAe,CAAC,GAAU,EAAE,qBAA8B,IAAI,EAAA;AAC5E,IAAA,IAAI,kBAAkB;QACpB,OAAO;AACL,YAAA,GAAG,GAAG;AACN,YAAA,kBAAkB,EAAE,IAAI;SACzB;SACE;QACH,MAAM,EAAE,kBAAkB,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG;AAC9C,QAAA,OAAO,IAAI;IACb;AACF;AAEA;AACM,SAAU,WAAW,CAAC,IAAW,EAAE,IAAW,EAAE,oBAA6B,KAAK,EAAA;IACtF,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,iBAAiB,IAAI,IAAI,CAAC,kBAAkB,KAAK,IAAI,CAAC,kBAAkB,CAAC;AAC/I;;;;"}

package/dist/utag.d.ts

@@ -15,4 +15,3 @@ export interface ValueWithUTag<V> {
 export interface ValueWithUTagAndAuthor<V> extends ValueWithUTag<V> {
     readonly author?: AuthorMarker;
 }
-//# sourceMappingURL=utag.d.ts.map

package/dist/util.cjs

@@ -0,0 +1,8 @@
+'use strict';
+
+function assertNever(x) {
+    throw new Error('Unexpected object: ' + x); // This is ok, because this is a possible runtime error
+}
+
+exports.assertNever = assertNever;
+//# sourceMappingURL=util.cjs.map

package/dist/util.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.cjs","sources":["../src/util.ts"],"sourcesContent":["export function assertNever(x: never): never {\n  throw new Error('Unexpected object: ' + x); // This is ok, because this is a possible runtime error\n}\n"],"names":[],"mappings":";;AAAM,SAAU,WAAW,CAAC,CAAQ,EAAA;IAClC,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,CAAC,CAAC;AAC7C;;;;"}

package/dist/util.d.ts

@@ -1,2 +1 @@
 export declare function assertNever(x: never): never;
-//# sourceMappingURL=util.d.ts.map

package/dist/util.js

@@ -0,0 +1,6 @@
+function assertNever(x) {
+    throw new Error('Unexpected object: ' + x); // This is ok, because this is a possible runtime error
+}
+
+export { assertNever };
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sources":["../src/util.ts"],"sourcesContent":["export function assertNever(x: never): never {\n  throw new Error('Unexpected object: ' + x); // This is ok, because this is a possible runtime error\n}\n"],"names":[],"mappings":"AAAM,SAAU,WAAW,CAAC,CAAQ,EAAA;IAClC,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,CAAC,CAAC;AAC7C;;;;"}

package/dist/value_or_error.cjs

@@ -0,0 +1,8 @@
+'use strict';
+
+function mapValueInVOE(voe, cb) {
+    return voe.ok ? { ok: true, value: cb(voe.value) } : voe;
+}
+
+exports.mapValueInVOE = mapValueInVOE;
+//# sourceMappingURL=value_or_error.cjs.map

package/dist/value_or_error.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"value_or_error.cjs","sources":["../src/value_or_error.ts"],"sourcesContent":["export type ValueOrError<V, E> =\n  | {\n    ok: true;\n    value: V;\n  }\n  | {\n    ok: false;\n    error: E;\n  };\n\nexport function mapValueInVOE<V1, V2, E>(\n  voe: ValueOrError<V1, E>,\n  cb: (value: V1) => V2,\n): ValueOrError<V2, E> {\n  return voe.ok ? { ok: true, value: cb(voe.value) } : voe;\n}\n"],"names":[],"mappings":";;AAUM,SAAU,aAAa,CAC3B,GAAwB,EACxB,EAAqB,EAAA;IAErB,OAAO,GAAG,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,GAAG;AAC1D;;;;"}

package/dist/value_or_error.d.ts

@@ -6,4 +6,3 @@ export type ValueOrError<V, E> = {
     error: E;
 };
 export declare function mapValueInVOE<V1, V2, E>(voe: ValueOrError<V1, E>, cb: (value: V1) => V2): ValueOrError<V2, E>;
-//# sourceMappingURL=value_or_error.d.ts.map

package/dist/value_or_error.js

@@ -0,0 +1,6 @@
+function mapValueInVOE(voe, cb) {
+    return voe.ok ? { ok: true, value: cb(voe.value) } : voe;
+}
+
+export { mapValueInVOE };
+//# sourceMappingURL=value_or_error.js.map

package/dist/value_or_error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value_or_error.js","sources":["../src/value_or_error.ts"],"sourcesContent":["export type ValueOrError<V, E> =\n  | {\n    ok: true;\n    value: V;\n  }\n  | {\n    ok: false;\n    error: E;\n  };\n\nexport function mapValueInVOE<V1, V2, E>(\n  voe: ValueOrError<V1, E>,\n  cb: (value: V1) => V2,\n): ValueOrError<V2, E> {\n  return voe.ok ? { ok: true, value: cb(voe.value) } : voe;\n}\n"],"names":[],"mappings":"AAUM,SAAU,aAAa,CAC3B,GAAwB,EACxB,EAAqB,EAAA;IAErB,OAAO,GAAG,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,GAAG;AAC1D;;;;"}