@milaboratories/pl-model-common 1.25.0 → 1.25.2

package/dist/pool/spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"spec.js","sources":["../../src/pool/spec.ts"],"sourcesContent":["import type { Branded } from \"../branding\";\nimport type { JoinEntry, PColumn, PColumnLazy, 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 type 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>(\n  pObj: PColumn<D1> | PColumnLazy<D1>,\n  cb: (d: D1) => D2,\n): PColumn<D2>;\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(typeof pObj.data === \"function\" ? pObj.data() : 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 \"artificialColumn\":\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;AAgBM,SAAU,cAAc,CAC5B,IAA6B,EAC7B,EAAiB,EAAA;IAEjB,OAAO,IAAI,KAAK;AACd,UAAE;AACF,UAAE;AACE,YAAA,GAAG,IAAI;YACP,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;SACpE;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,kBAAkB;AACrB,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;;;;"}
+{"version":3,"file":"spec.js","names":[],"sources":["../../src/pool/spec.ts"],"sourcesContent":["import type { Branded } from \"../branding\";\nimport type { JoinEntry, PColumn, PColumnLazy, 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 type 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>(\n  pObj: PColumn<D1> | PColumnLazy<D1>,\n  cb: (d: D1) => D2,\n): PColumn<D2>;\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(typeof pObj.data === \"function\" ? pObj.data() : 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 \"artificialColumn\":\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"],"mappings":";;;AAuCA,SAAgB,cAAc,MAAwC;AACpE,QAAO,KAAK,SAAS;;AAGvB,SAAgB,UAAa,KAAoC;AAC/D,QAAO,cAAc,IAAI,KAAK;;AAGhC,SAAgB,oBACd,GACmC;AACnC,QAAO,cAAc,EAAE,IAAI;;AAG7B,SAAgB,gBACd,GACkC;AAClC,QAAO,cAAc,EAAE,IAAI,KAAK;;AAGlC,SAAgB,cAAiB,KAA6B;AAC5D,KAAI,CAAC,UAAU,IAAI,CAAE,OAAM,IAAI,MAAM,yBAAyB,IAAI,KAAK,KAAK,GAAG;AAC/E,QAAO;;AAiBT,SAAgB,eACd,MACA,IACyB;AACzB,QAAO,SAAS,SACZ,SACA;EACE,GAAG;EACH,MAAM,GAAG,OAAO,KAAK,SAAS,aAAa,KAAK,MAAM,GAAG,KAAK,KAAK;EACpE;;AAGP,SAAgB,kBAAqB,OAA4C;CAC/E,MAAM,0BAAU,IAAI,KAA4B;CAChD,MAAM,iBAAiB,UAAiC;AACtD,UAAQ,MAAM,MAAd;GACE,KAAK;AACH,YAAQ,IAAI,MAAM,OAAO,IAAI,MAAM,OAAO;AAC1C;GACF,KAAK;AACH,YAAQ,IAAI,MAAM,OAAO,IAAI,MAAM,OAAO;AAC1C;GACF,KAAK;AACH,YAAQ,IAAI,MAAM,OAAO,IAAI,MAAM,OAAO;AAC1C;GACF,KAAK,eACH;GACF,KAAK;GACL,KAAK;AACH,SAAK,MAAM,KAAK,MAAM,QAAS,eAAc,EAAE;AAC/C;GACF,KAAK;AACH,kBAAc,MAAM,QAAQ;AAC5B,SAAK,MAAM,KAAK,MAAM,UAAW,eAAc,EAAE;AACjD;GACF,QACE,aAAY,MAAM;;;AAGxB,eAAc,MAAM;AACpB,QAAO,CAAC,GAAG,QAAQ,QAAQ,CAAC"}

package/dist/ref.cjs

@@ -1,90 +1,70 @@
-'use strict';
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+let zod = require("zod");
 
-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();
+//#region src/ref.ts
+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.
- */
+* 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);
+	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.
- */
+* 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,
-        };
+	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.
- */
+* 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;
-    }
+	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));
+	return ref1.blockId === ref2.blockId && ref1.name === ref2.name && (ignoreEnrichments || ref1.requireEnrichments === ref2.requireEnrichments);
 }
 
+//#endregion
 exports.PlRef = PlRef;
 exports.createPlRef = createPlRef;
 exports.isPlRef = isPlRef;
 exports.plRefsEqual = plRefsEqual;
 exports.withEnrichments = withEnrichments;
-//# sourceMappingURL=ref.cjs.map
+//# sourceMappingURL=ref.cjs.map

package/dist/ref.cjs.map

@@ -1 +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().describe(\"Upstream block id\"),\n    name: z.string().describe(\"Name of the output provided to the upstream block's output context\"),\n    requireEnrichments: z\n      .literal(true)\n      .optional()\n      .describe(\n        \"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  })\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 (\n    ref1.blockId === ref2.blockId &&\n    ref1.name === ref2.name &&\n    (ignoreEnrichments || ref1.requireEnrichments === ref2.requireEnrichments)\n  );\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;IAC1E,OAAO,EAAEA,KAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IACjD,IAAI,EAAEA,KAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;AAC/F,IAAA,kBAAkB,EAAEA;SACjB,OAAO,CAAC,IAAI;AACZ,SAAA,QAAQ;AACR,SAAA,QAAQ,CACP,qFAAqF;AACnF,QAAA,8FAA8F,CACjG;CACJ;AACA,KAAA,QAAQ,CACP,kFAAkF;IAChF,qFAAqF;AACrF,IAAA,kCAAkC;AAErC,KAAA,QAAQ;AAKX;;;;;AAKG;AACG,SAAU,OAAO,CAAC,KAAc,EAAA;AACpC,IAAA,QACE,OAAO,KAAK,KAAK,QAAQ;AACzB,QAAA,KAAK,KAAK,IAAI;AACd,QAAA,SAAS,IAAI,KAAK;QACjB,KAA8B,CAAC,OAAO,KAAK,IAAI;AAChD,QAAA,SAAS,IAAI,KAAK;QAClB,MAAM,IAAI,KAAK;AAEnB;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;AACtF,IAAA,QACE,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO;AAC7B,QAAA,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI;SACtB,iBAAiB,IAAI,IAAI,CAAC,kBAAkB,KAAK,IAAI,CAAC,kBAAkB,CAAC;AAE9E;;;;;;;;"}
+{"version":3,"file":"ref.cjs","names":["z"],"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().describe(\"Upstream block id\"),\n    name: z.string().describe(\"Name of the output provided to the upstream block's output context\"),\n    requireEnrichments: z\n      .literal(true)\n      .optional()\n      .describe(\n        \"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  })\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 (\n    ref1.blockId === ref2.blockId &&\n    ref1.name === ref2.name &&\n    (ignoreEnrichments || ref1.requireEnrichments === ref2.requireEnrichments)\n  );\n}\n"],"mappings":";;;;AAEA,MAAa,QAAQA,MAClB,OAAO;CACN,SAASA,MACN,QAAQ,KAAK,CACb,SAAS,8DAA8D;CAC1E,SAASA,MAAE,QAAQ,CAAC,SAAS,oBAAoB;CACjD,MAAMA,MAAE,QAAQ,CAAC,SAAS,qEAAqE;CAC/F,oBAAoBA,MACjB,QAAQ,KAAK,CACb,UAAU,CACV,SACC,kLAED;CACJ,CAAC,CACD,SACC,sMAGD,CACA,UAAU;;;;;;;AAWb,SAAgB,QAAQ,OAAgC;AACtD,QACE,OAAO,UAAU,YACjB,UAAU,QACV,aAAa,SACZ,MAA+B,YAAY,QAC5C,aAAa,SACb,UAAU;;;;;;;;;AAsBd,SAAgB,YAAY,SAAiB,MAAc,qBAA8B,OAAO;AAC9F,KAAI,mBACF,QAAO;EACL,SAAS;EACT;EACA;EACA,oBAAoB;EACrB;KAED,QAAO;EACL,SAAS;EACT;EACA;EACD;;;;;;;;;;;AAYL,SAAgB,gBAAgB,KAAY,qBAA8B,MAAa;AACrF,KAAI,mBACF,QAAO;EACL,GAAG;EACH,oBAAoB;EACrB;MACE;EACH,MAAM,EAAE,oBAAoB,GAAG,GAAG,SAAS;AAC3C,SAAO;;;;AAKX,SAAgB,YAAY,MAAa,MAAa,oBAA6B,OAAO;AACxF,QACE,KAAK,YAAY,KAAK,WACtB,KAAK,SAAS,KAAK,SAClB,qBAAqB,KAAK,uBAAuB,KAAK"}

package/dist/ref.d.ts

@@ -1,38 +1,39 @@
 import { z } from "zod";
-export declare const PlRef: z.ZodReadonly<z.ZodObject<{
-    __isRef: z.ZodLiteral<true>;
-    blockId: z.ZodString;
-    name: z.ZodString;
-    requireEnrichments: z.ZodOptional<z.ZodLiteral<true>>;
+
+//#region src/ref.d.ts
+declare const PlRef: z.ZodReadonly<z.ZodObject<{
+  __isRef: z.ZodLiteral<true>;
+  blockId: z.ZodString;
+  name: z.ZodString;
+  requireEnrichments: z.ZodOptional<z.ZodLiteral<true>>;
 }, "strip", z.ZodTypeAny, {
-    __isRef: true;
-    blockId: string;
-    name: string;
-    requireEnrichments?: true | undefined;
+  __isRef: true;
+  blockId: string;
+  name: string;
+  requireEnrichments?: true | undefined;
 }, {
-    __isRef: true;
-    blockId: string;
-    name: string;
-    requireEnrichments?: true | undefined;
+  __isRef: true;
+  blockId: string;
+  name: string;
+  requireEnrichments?: true | undefined;
 }>>;
-export type PlRef = z.infer<typeof PlRef>;
+type PlRef = z.infer<typeof PlRef>;
 /** @deprecated use {@link PlRef} */
-export type Ref = PlRef;
+type Ref = PlRef;
 /**
  * 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.
  */
-export declare function isPlRef(value: unknown): value is PlRef;
+declare function isPlRef(value: unknown): value is PlRef;
 /** Standard way how to communicate possible connections given specific
  * requirements for incoming data. */
-export type Option = {
-    /** Fully rendered reference to be assigned for the intended field in block's
-     * args */
-    readonly ref: PlRef;
-    /** Label to be present for the user in i.e. drop-down list */
-    readonly label: string;
+type Option = {
+  /** Fully rendered reference to be assigned for the intended field in block's
+   * args */
+  readonly ref: PlRef; /** Label to be present for the user in i.e. drop-down list */
+  readonly label: string;
 };
 /**
  * Creates a PlRef with the given blockId and name.
@@ -41,16 +42,16 @@ export type Option = {
  * @param name - The name of the reference.
  * @param requireEnrichments - Whether the reference requires enrichments.
  */
-export declare function createPlRef(blockId: string, name: string, requireEnrichments?: boolean): {
-    __isRef: boolean;
-    blockId: string;
-    name: string;
-    requireEnrichments: boolean;
+declare function createPlRef(blockId: string, name: string, requireEnrichments?: boolean): {
+  __isRef: boolean;
+  blockId: string;
+  name: string;
+  requireEnrichments: boolean;
 } | {
-    __isRef: boolean;
-    blockId: string;
-    name: string;
-    requireEnrichments?: undefined;
+  __isRef: boolean;
+  blockId: string;
+  name: string;
+  requireEnrichments?: undefined;
 };
 /**
  * Creates a new PlRef based on an existing one, explicitly setting (default) or removing the
@@ -61,7 +62,9 @@ export declare function createPlRef(blockId: string, name: string, requireEnrich
  *   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.
  */
-export declare function withEnrichments(ref: PlRef, requireEnrichments?: boolean): PlRef;
+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;
+declare function plRefsEqual(ref1: PlRef, ref2: PlRef, ignoreEnrichments?: boolean): boolean;
+//#endregion
+export { Option, PlRef, Ref, createPlRef, isPlRef, plRefsEqual, withEnrichments };
 //# sourceMappingURL=ref.d.ts.map

package/dist/ref.js

@@ -1,84 +1,65 @@
-import { z } from 'zod';
+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();
+//#region src/ref.ts
+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.
- */
+* 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);
+	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.
- */
+* 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,
-        };
+	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.
- */
+* 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;
-    }
+	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));
+	return ref1.blockId === ref2.blockId && ref1.name === ref2.name && (ignoreEnrichments || ref1.requireEnrichments === ref2.requireEnrichments);
 }
 
+//#endregion
 export { PlRef, createPlRef, isPlRef, plRefsEqual, withEnrichments };
-//# sourceMappingURL=ref.js.map
+//# sourceMappingURL=ref.js.map

package/dist/ref.js.map

@@ -1 +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().describe(\"Upstream block id\"),\n    name: z.string().describe(\"Name of the output provided to the upstream block's output context\"),\n    requireEnrichments: z\n      .literal(true)\n      .optional()\n      .describe(\n        \"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  })\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 (\n    ref1.blockId === ref2.blockId &&\n    ref1.name === ref2.name &&\n    (ignoreEnrichments || ref1.requireEnrichments === ref2.requireEnrichments)\n  );\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;IAC1E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IACjD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;AAC/F,IAAA,kBAAkB,EAAE;SACjB,OAAO,CAAC,IAAI;AACZ,SAAA,QAAQ;AACR,SAAA,QAAQ,CACP,qFAAqF;AACnF,QAAA,8FAA8F,CACjG;CACJ;AACA,KAAA,QAAQ,CACP,kFAAkF;IAChF,qFAAqF;AACrF,IAAA,kCAAkC;AAErC,KAAA,QAAQ;AAKX;;;;;AAKG;AACG,SAAU,OAAO,CAAC,KAAc,EAAA;AACpC,IAAA,QACE,OAAO,KAAK,KAAK,QAAQ;AACzB,QAAA,KAAK,KAAK,IAAI;AACd,QAAA,SAAS,IAAI,KAAK;QACjB,KAA8B,CAAC,OAAO,KAAK,IAAI;AAChD,QAAA,SAAS,IAAI,KAAK;QAClB,MAAM,IAAI,KAAK;AAEnB;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;AACtF,IAAA,QACE,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO;AAC7B,QAAA,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI;SACtB,iBAAiB,IAAI,IAAI,CAAC,kBAAkB,KAAK,IAAI,CAAC,kBAAkB,CAAC;AAE9E;;;;"}
+{"version":3,"file":"ref.js","names":[],"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().describe(\"Upstream block id\"),\n    name: z.string().describe(\"Name of the output provided to the upstream block's output context\"),\n    requireEnrichments: z\n      .literal(true)\n      .optional()\n      .describe(\n        \"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  })\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 (\n    ref1.blockId === ref2.blockId &&\n    ref1.name === ref2.name &&\n    (ignoreEnrichments || ref1.requireEnrichments === ref2.requireEnrichments)\n  );\n}\n"],"mappings":";;;AAEA,MAAa,QAAQ,EAClB,OAAO;CACN,SAAS,EACN,QAAQ,KAAK,CACb,SAAS,8DAA8D;CAC1E,SAAS,EAAE,QAAQ,CAAC,SAAS,oBAAoB;CACjD,MAAM,EAAE,QAAQ,CAAC,SAAS,qEAAqE;CAC/F,oBAAoB,EACjB,QAAQ,KAAK,CACb,UAAU,CACV,SACC,kLAED;CACJ,CAAC,CACD,SACC,sMAGD,CACA,UAAU;;;;;;;AAWb,SAAgB,QAAQ,OAAgC;AACtD,QACE,OAAO,UAAU,YACjB,UAAU,QACV,aAAa,SACZ,MAA+B,YAAY,QAC5C,aAAa,SACb,UAAU;;;;;;;;;AAsBd,SAAgB,YAAY,SAAiB,MAAc,qBAA8B,OAAO;AAC9F,KAAI,mBACF,QAAO;EACL,SAAS;EACT;EACA;EACA,oBAAoB;EACrB;KAED,QAAO;EACL,SAAS;EACT;EACA;EACD;;;;;;;;;;;AAYL,SAAgB,gBAAgB,KAAY,qBAA8B,MAAa;AACrF,KAAI,mBACF,QAAO;EACL,GAAG;EACH,oBAAoB;EACrB;MACE;EACH,MAAM,EAAE,oBAAoB,GAAG,GAAG,SAAS;AAC3C,SAAO;;;;AAKX,SAAgB,YAAY,MAAa,MAAa,oBAA6B,OAAO;AACxF,QACE,KAAK,YAAY,KAAK,WACtB,KAAK,SAAS,KAAK,SAClB,qBAAqB,KAAK,uBAAuB,KAAK"}

package/dist/utag.d.ts

@@ -1,18 +1,22 @@
-import type { AuthorMarker } from "./author_marker";
+import { AuthorMarker } from "./author_marker.js";
+
+//#region src/utag.d.ts
 /** Value returned for changing states supporting reactive listening for changes */
-export interface ValueWithUTag<V> {
-    /** Value snapshot. */
-    readonly value: V;
-    /**
-     * Unique tag for the value snapshot.
-     *
-     * It can be used to synchronously detect if changes happened after current
-     * snapshot was retrieved, or asynchronously await next value snapshot,
-     * generated on underlying data changes.
-     * */
-    readonly uTag: string;
+interface ValueWithUTag<V> {
+  /** Value snapshot. */
+  readonly value: V;
+  /**
+   * Unique tag for the value snapshot.
+   *
+   * It can be used to synchronously detect if changes happened after current
+   * snapshot was retrieved, or asynchronously await next value snapshot,
+   * generated on underlying data changes.
+   * */
+  readonly uTag: string;
 }
-export interface ValueWithUTagAndAuthor<V> extends ValueWithUTag<V> {
-    readonly author?: AuthorMarker;
+interface ValueWithUTagAndAuthor<V> extends ValueWithUTag<V> {
+  readonly author?: AuthorMarker;
 }
+//#endregion
+export { ValueWithUTag, ValueWithUTagAndAuthor };
 //# sourceMappingURL=utag.d.ts.map

package/dist/util.cjs

@@ -1,16 +1,17 @@
-'use strict';
 
+//#region src/util.ts
 function assertNever(x) {
-    throw new Error("Unexpected object: " + x); // This is ok, because this is a possible runtime error
+	throw new Error("Unexpected object: " + x);
 }
 /**
- * Return unique entries of the array by the provided id
- * For each id, the last entry is kept
- */
+* Return unique entries of the array by the provided id
+* For each id, the last entry is kept
+*/
 function uniqueBy(array, makeId) {
-    return [...new Map(array.map((e) => [makeId(e), e])).values()];
+	return [...new Map(array.map((e) => [makeId(e), e])).values()];
 }
 
+//#endregion
 exports.assertNever = assertNever;
 exports.uniqueBy = uniqueBy;
-//# sourceMappingURL=util.cjs.map
+//# sourceMappingURL=util.cjs.map

package/dist/util.cjs.map

@@ -1 +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\n/**\n * Return unique entries of the array by the provided id\n * For each id, the last entry is kept\n */\nexport function uniqueBy<T>(array: T[], makeId: (entry: T) => string): T[] {\n  return [...new Map(array.map((e) => [makeId(e), e])).values()];\n}\n"],"names":[],"mappings":";;AAAM,SAAU,WAAW,CAAC,CAAQ,EAAA;IAClC,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,CAAC,CAAC;AAC7C;AAEA;;;AAGG;AACG,SAAU,QAAQ,CAAI,KAAU,EAAE,MAA4B,EAAA;AAClE,IAAA,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;AAChE;;;;;"}
+{"version":3,"file":"util.cjs","names":[],"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\n/**\n * Return unique entries of the array by the provided id\n * For each id, the last entry is kept\n */\nexport function uniqueBy<T>(array: T[], makeId: (entry: T) => string): T[] {\n  return [...new Map(array.map((e) => [makeId(e), e])).values()];\n}\n"],"mappings":";;AAAA,SAAgB,YAAY,GAAiB;AAC3C,OAAM,IAAI,MAAM,wBAAwB,EAAE;;;;;;AAO5C,SAAgB,SAAY,OAAY,QAAmC;AACzE,QAAO,CAAC,GAAG,IAAI,IAAI,MAAM,KAAK,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC"}

package/dist/util.d.ts

@@ -1,7 +1,10 @@
-export declare function assertNever(x: never): never;
+//#region src/util.d.ts
+declare function assertNever(x: never): never;
 /**
  * Return unique entries of the array by the provided id
  * For each id, the last entry is kept
  */
-export declare function uniqueBy<T>(array: T[], makeId: (entry: T) => string): T[];
+declare function uniqueBy<T>(array: T[], makeId: (entry: T) => string): T[];
+//#endregion
+export { assertNever, uniqueBy };
 //# sourceMappingURL=util.d.ts.map

package/dist/util.js

@@ -1,13 +1,15 @@
+//#region src/util.ts
 function assertNever(x) {
-    throw new Error("Unexpected object: " + x); // This is ok, because this is a possible runtime error
+	throw new Error("Unexpected object: " + x);
 }
 /**
- * Return unique entries of the array by the provided id
- * For each id, the last entry is kept
- */
+* Return unique entries of the array by the provided id
+* For each id, the last entry is kept
+*/
 function uniqueBy(array, makeId) {
-    return [...new Map(array.map((e) => [makeId(e), e])).values()];
+	return [...new Map(array.map((e) => [makeId(e), e])).values()];
 }
 
+//#endregion
 export { assertNever, uniqueBy };
-//# sourceMappingURL=util.js.map
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -1 +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\n/**\n * Return unique entries of the array by the provided id\n * For each id, the last entry is kept\n */\nexport function uniqueBy<T>(array: T[], makeId: (entry: T) => string): T[] {\n  return [...new Map(array.map((e) => [makeId(e), e])).values()];\n}\n"],"names":[],"mappings":"AAAM,SAAU,WAAW,CAAC,CAAQ,EAAA;IAClC,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,CAAC,CAAC;AAC7C;AAEA;;;AAGG;AACG,SAAU,QAAQ,CAAI,KAAU,EAAE,MAA4B,EAAA;AAClE,IAAA,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;AAChE;;;;"}
+{"version":3,"file":"util.js","names":[],"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\n/**\n * Return unique entries of the array by the provided id\n * For each id, the last entry is kept\n */\nexport function uniqueBy<T>(array: T[], makeId: (entry: T) => string): T[] {\n  return [...new Map(array.map((e) => [makeId(e), e])).values()];\n}\n"],"mappings":";AAAA,SAAgB,YAAY,GAAiB;AAC3C,OAAM,IAAI,MAAM,wBAAwB,EAAE;;;;;;AAO5C,SAAgB,SAAY,OAAY,QAAmC;AACzE,QAAO,CAAC,GAAG,IAAI,IAAI,MAAM,KAAK,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC"}

package/dist/value_or_error.cjs

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

package/dist/value_or_error.cjs.map

@@ -1 +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;;;;"}
+{"version":3,"file":"value_or_error.cjs","names":[],"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"],"mappings":";;AAUA,SAAgB,cACd,KACA,IACqB;AACrB,QAAO,IAAI,KAAK;EAAE,IAAI;EAAM,OAAO,GAAG,IAAI,MAAM;EAAE,GAAG"}