@platforma-sdk/model 1.58.5 → 1.58.11

package/dist/block_storage_facade.d.ts

@@ -1,59 +1,14 @@
-/**
- * Block Storage Facade - Contract between bundled blocks and middle layer.
- *
- * ============================================================================
- * VERSIONING
- * ============================================================================
- *
- * Blocks declare their model API version via the `requiresModelAPIVersion` feature flag
- * (see BlockCodeKnownFeatureFlags). This determines how the middle layer manages block state:
- *
- * - Version 1: Legacy BlockModel - state is {args, uiState}, managed directly by middle layer
- * - Version 2: BlockModelV3 - uses blockStorage with VM-based callbacks (this facade)
- *
- * This facade (BlockStorageFacade) is used by blocks with `requiresModelAPIVersion: 2`.
- * The version number matches the model API version for clarity.
- *
- * ============================================================================
- * BACKWARD COMPATIBILITY WARNING
- * ============================================================================
- *
- * This file documents the FACADE between the SDK (bundled into blocks) and the
- * middle layer. Once a block is published, its SDK version is frozen. The middle
- * layer must support ALL previously released callback signatures indefinitely.
- *
- * RULES:
- * 1. NEVER change the signature of existing callbacks
- * 2. NEVER remove existing callbacks
- * 3. New callbacks CAN be added (old blocks won't register them, middle layer
- *    should handle missing callbacks gracefully)
- * 4. Callback return types can be EXTENDED (add optional fields) but not changed
- * 5. Callback parameter types should remain compatible (middle layer may need
- *    to handle both old and new formats)
- *
- * The facade consists of callbacks registered via `tryRegisterCallback()` with
- * the `__pl_` prefix. These are registered by the SDK when a block loads and
- * called by the middle layer to perform operations.
- *
- * ============================================================================
- * WHAT CAN BE CHANGED FREELY
- * ============================================================================
- *
- * - Middle layer code (lib/node/pl-middle-layer)
- * - SDK internal implementation (as long as callback contracts are preserved)
- * - SDK exports used ONLY by middle layer (not by blocks themselves)
- * - New SDK features that don't affect existing callbacks
- *
- * @module block_storage_facade
- */
-import type { MutateStoragePayload } from "./block_storage";
-import type { ConfigRenderLambda } from "./bconfig";
-import type { StringifiedJson } from "@milaboratories/pl-model-common";
+import { MutateStoragePayload } from "./block_storage.js";
+import { ConfigRenderLambda } from "./bconfig/lambdas.js";
+import "./bconfig/index.js";
+import { StringifiedJson } from "@milaboratories/pl-model-common";
+
+//#region src/block_storage_facade.d.ts
 /**
  * The current facade version. This value is used for `requiresModelAPIVersion`
  * feature flag in BlockModelV3.
  */
-export declare const BLOCK_STORAGE_FACADE_VERSION = 2;
+declare const BLOCK_STORAGE_FACADE_VERSION = 2;
 /**
  * All facade callback names as constants.
  * These are the source of truth - the interface is derived from these.
@@ -63,25 +18,25 @@ export declare const BLOCK_STORAGE_FACADE_VERSION = 2;
  * 2. Add the callback signature to FacadeCallbackTypes below
  * 3. The BlockStorageFacade type will automatically include it
  */
-export declare const BlockStorageFacadeCallbacks: {
-    readonly StorageApplyUpdate: "__pl_storage_applyUpdate";
-    readonly StorageDebugView: "__pl_storage_debugView";
-    readonly StorageMigrate: "__pl_storage_migrate";
-    readonly ArgsDerive: "__pl_args_derive";
-    readonly PrerunArgsDerive: "__pl_prerunArgs_derive";
-    readonly StorageInitial: "__pl_storage_initial";
+declare const BlockStorageFacadeCallbacks: {
+  readonly StorageApplyUpdate: "__pl_storage_applyUpdate";
+  readonly StorageDebugView: "__pl_storage_debugView";
+  readonly StorageMigrate: "__pl_storage_migrate";
+  readonly ArgsDerive: "__pl_args_derive";
+  readonly PrerunArgsDerive: "__pl_prerunArgs_derive";
+  readonly StorageInitial: "__pl_storage_initial";
 };
 /**
  * Lambda handles for facade callbacks.
  * Used by the middle layer to invoke callbacks via executeSingleLambda().
  */
-export declare const BlockStorageFacadeHandles: {
-    __pl_storage_applyUpdate: ConfigRenderLambda<unknown>;
-    __pl_storage_debugView: ConfigRenderLambda<unknown>;
-    __pl_storage_migrate: ConfigRenderLambda<unknown>;
-    __pl_args_derive: ConfigRenderLambda<unknown>;
-    __pl_prerunArgs_derive: ConfigRenderLambda<unknown>;
-    __pl_storage_initial: ConfigRenderLambda<unknown>;
+declare const BlockStorageFacadeHandles: {
+  __pl_storage_applyUpdate: ConfigRenderLambda<unknown>;
+  __pl_storage_debugView: ConfigRenderLambda<unknown>;
+  __pl_storage_migrate: ConfigRenderLambda<unknown>;
+  __pl_args_derive: ConfigRenderLambda<unknown>;
+  __pl_prerunArgs_derive: ConfigRenderLambda<unknown>;
+  __pl_storage_initial: ConfigRenderLambda<unknown>;
 };
 /**
  * The complete facade interface between bundled blocks (SDK) and middle layer.
@@ -103,66 +58,68 @@ export declare const BlockStorageFacadeHandles: {
  * - Parameter descriptions
  * - Return value description
  */
-export interface BlockStorageFacade {
-    /**
-     * Apply state update to storage.
-     * Called when UI updates block state (setState) or plugin data.
-     * @param currentStorageJson - Current storage as JSON string
-     * @param payload - Update payload with operation type and value
-     * @returns Updated storage as JSON string
-     */
-    [BlockStorageFacadeCallbacks.StorageApplyUpdate]: (currentStorageJson: StringifiedJson, payload: MutateStoragePayload) => StringifiedJson;
-    /**
-     * Get debug view of storage.
-     * Called by developer tools to inspect storage state.
-     * @param storageJson - Storage as JSON string (or undefined for new blocks)
-     * @returns JSON string containing StorageDebugView
-     */
-    [BlockStorageFacadeCallbacks.StorageDebugView]: (storageJson: StringifiedJson | undefined) => StringifiedJson;
-    /**
-     * Run storage migration.
-     * Called when block loads to migrate data to latest version.
-     * @param currentStorageJson - Current storage as JSON string (or undefined for new blocks)
-     * @returns Migration result - either error or success with new storage
-     */
-    [BlockStorageFacadeCallbacks.StorageMigrate]: (currentStorageJson: StringifiedJson | undefined) => {
-        error: string;
-    } | {
-        error?: undefined;
-        newStorageJson: StringifiedJson;
-        info: string;
-    };
-    /**
-     * Derive args from storage.
-     * Called to get block configuration args from storage.
-     * @param storageJson - Storage as JSON string
-     * @returns Args derivation result - either error or derived value
-     */
-    [BlockStorageFacadeCallbacks.ArgsDerive]: (storageJson: StringifiedJson) => {
-        error: string;
-    } | {
-        error?: undefined;
-        value: unknown;
-    };
-    /**
-     * Derive prerunArgs from storage.
-     * Called to get prerun args; falls back to args callback if not registered.
-     * @param storageJson - Storage as JSON string
-     * @returns Args derivation result - either error or derived value
-     */
-    [BlockStorageFacadeCallbacks.PrerunArgsDerive]: (storageJson: StringifiedJson) => {
-        error: string;
-    } | {
-        error?: undefined;
-        value: unknown;
-    };
-    /**
-     * Get initial storage JSON for new blocks.
-     * Called when creating a new block to get complete initial storage.
-     * @returns Initial storage as JSON string
-     */
-    [BlockStorageFacadeCallbacks.StorageInitial]: () => StringifiedJson;
+interface BlockStorageFacade {
+  /**
+   * Apply state update to storage.
+   * Called when UI updates block state (setState) or plugin data.
+   * @param currentStorageJson - Current storage as JSON string
+   * @param payload - Update payload with operation type and value
+   * @returns Updated storage as JSON string
+   */
+  [BlockStorageFacadeCallbacks.StorageApplyUpdate]: (currentStorageJson: StringifiedJson, payload: MutateStoragePayload) => StringifiedJson;
+  /**
+   * Get debug view of storage.
+   * Called by developer tools to inspect storage state.
+   * @param storageJson - Storage as JSON string (or undefined for new blocks)
+   * @returns JSON string containing StorageDebugView
+   */
+  [BlockStorageFacadeCallbacks.StorageDebugView]: (storageJson: StringifiedJson | undefined) => StringifiedJson;
+  /**
+   * Run storage migration.
+   * Called when block loads to migrate data to latest version.
+   * @param currentStorageJson - Current storage as JSON string (or undefined for new blocks)
+   * @returns Migration result - either error or success with new storage
+   */
+  [BlockStorageFacadeCallbacks.StorageMigrate]: (currentStorageJson: StringifiedJson | undefined) => {
+    error: string;
+  } | {
+    error?: undefined;
+    newStorageJson: StringifiedJson;
+    info: string;
+  };
+  /**
+   * Derive args from storage.
+   * Called to get block configuration args from storage.
+   * @param storageJson - Storage as JSON string
+   * @returns Args derivation result - either error or derived value
+   */
+  [BlockStorageFacadeCallbacks.ArgsDerive]: (storageJson: StringifiedJson) => {
+    error: string;
+  } | {
+    error?: undefined;
+    value: unknown;
+  };
+  /**
+   * Derive prerunArgs from storage.
+   * Called to get prerun args; falls back to args callback if not registered.
+   * @param storageJson - Storage as JSON string
+   * @returns Args derivation result - either error or derived value
+   */
+  [BlockStorageFacadeCallbacks.PrerunArgsDerive]: (storageJson: StringifiedJson) => {
+    error: string;
+  } | {
+    error?: undefined;
+    value: unknown;
+  };
+  /**
+   * Get initial storage JSON for new blocks.
+   * Called when creating a new block to get complete initial storage.
+   * @returns Initial storage as JSON string
+   */
+  [BlockStorageFacadeCallbacks.StorageInitial]: () => StringifiedJson;
 }
 /** Register all facade callbacks at once. Ensures all required callbacks are provided. */
-export declare function registerFacadeCallbacks(callbacks: BlockStorageFacade): void;
+declare function registerFacadeCallbacks(callbacks: BlockStorageFacade): void;
+//#endregion
+export { BLOCK_STORAGE_FACADE_VERSION, BlockStorageFacade, BlockStorageFacadeCallbacks, BlockStorageFacadeHandles, registerFacadeCallbacks };
 //# sourceMappingURL=block_storage_facade.d.ts.map

package/dist/block_storage_facade.js

@@ -1,99 +1,45 @@
-import { createRenderLambda, tryRegisterCallback } from './internal.js';
+import { createRenderLambda, tryRegisterCallback } from "./internal.js";
 
+//#region src/block_storage_facade.ts
 /**
- * Block Storage Facade - Contract between bundled blocks and middle layer.
- *
- * ============================================================================
- * VERSIONING
- * ============================================================================
- *
- * Blocks declare their model API version via the `requiresModelAPIVersion` feature flag
- * (see BlockCodeKnownFeatureFlags). This determines how the middle layer manages block state:
- *
- * - Version 1: Legacy BlockModel - state is {args, uiState}, managed directly by middle layer
- * - Version 2: BlockModelV3 - uses blockStorage with VM-based callbacks (this facade)
- *
- * This facade (BlockStorageFacade) is used by blocks with `requiresModelAPIVersion: 2`.
- * The version number matches the model API version for clarity.
- *
- * ============================================================================
- * BACKWARD COMPATIBILITY WARNING
- * ============================================================================
- *
- * This file documents the FACADE between the SDK (bundled into blocks) and the
- * middle layer. Once a block is published, its SDK version is frozen. The middle
- * layer must support ALL previously released callback signatures indefinitely.
- *
- * RULES:
- * 1. NEVER change the signature of existing callbacks
- * 2. NEVER remove existing callbacks
- * 3. New callbacks CAN be added (old blocks won't register them, middle layer
- *    should handle missing callbacks gracefully)
- * 4. Callback return types can be EXTENDED (add optional fields) but not changed
- * 5. Callback parameter types should remain compatible (middle layer may need
- *    to handle both old and new formats)
- *
- * The facade consists of callbacks registered via `tryRegisterCallback()` with
- * the `__pl_` prefix. These are registered by the SDK when a block loads and
- * called by the middle layer to perform operations.
- *
- * ============================================================================
- * WHAT CAN BE CHANGED FREELY
- * ============================================================================
- *
- * - Middle layer code (lib/node/pl-middle-layer)
- * - SDK internal implementation (as long as callback contracts are preserved)
- * - SDK exports used ONLY by middle layer (not by blocks themselves)
- * - New SDK features that don't affect existing callbacks
- *
- * @module block_storage_facade
- */
-// =============================================================================
-// Facade Version
-// =============================================================================
-/**
- * The current facade version. This value is used for `requiresModelAPIVersion`
- * feature flag in BlockModelV3.
- */
+* The current facade version. This value is used for `requiresModelAPIVersion`
+* feature flag in BlockModelV3.
+*/
 const BLOCK_STORAGE_FACADE_VERSION = 2;
-// =============================================================================
-// Facade Callback Names
-// =============================================================================
 /**
- * All facade callback names as constants.
- * These are the source of truth - the interface is derived from these.
- *
- * IMPORTANT: When adding a new callback:
- * 1. Add the constant here
- * 2. Add the callback signature to FacadeCallbackTypes below
- * 3. The BlockStorageFacade type will automatically include it
- */
+* All facade callback names as constants.
+* These are the source of truth - the interface is derived from these.
+*
+* IMPORTANT: When adding a new callback:
+* 1. Add the constant here
+* 2. Add the callback signature to FacadeCallbackTypes below
+* 3. The BlockStorageFacade type will automatically include it
+*/
 const BlockStorageFacadeCallbacks = {
-    StorageApplyUpdate: "__pl_storage_applyUpdate",
-    StorageDebugView: "__pl_storage_debugView",
-    StorageMigrate: "__pl_storage_migrate",
-    ArgsDerive: "__pl_args_derive",
-    PrerunArgsDerive: "__pl_prerunArgs_derive",
-    StorageInitial: "__pl_storage_initial",
+	StorageApplyUpdate: "__pl_storage_applyUpdate",
+	StorageDebugView: "__pl_storage_debugView",
+	StorageMigrate: "__pl_storage_migrate",
+	ArgsDerive: "__pl_args_derive",
+	PrerunArgsDerive: "__pl_prerunArgs_derive",
+	StorageInitial: "__pl_storage_initial"
 };
 /**
- * Creates a map of lambda handles from a callbacks constant object.
- * Keys are the callback string values (e.g., '__pl_storage_applyUpdate').
- */
+* Creates a map of lambda handles from a callbacks constant object.
+* Keys are the callback string values (e.g., '__pl_storage_applyUpdate').
+*/
 function createFacadeHandles(callbacks) {
-    return Object.fromEntries(Object.values(callbacks).map((handle) => [handle, createRenderLambda({ handle })]));
+	return Object.fromEntries(Object.values(callbacks).map((handle) => [handle, createRenderLambda({ handle })]));
 }
 /**
- * Lambda handles for facade callbacks.
- * Used by the middle layer to invoke callbacks via executeSingleLambda().
- */
+* Lambda handles for facade callbacks.
+* Used by the middle layer to invoke callbacks via executeSingleLambda().
+*/
 const BlockStorageFacadeHandles = createFacadeHandles(BlockStorageFacadeCallbacks);
 /** Register all facade callbacks at once. Ensures all required callbacks are provided. */
 function registerFacadeCallbacks(callbacks) {
-    for (const key of Object.values(BlockStorageFacadeCallbacks)) {
-        tryRegisterCallback(key, callbacks[key]);
-    }
+	for (const key of Object.values(BlockStorageFacadeCallbacks)) tryRegisterCallback(key, callbacks[key]);
 }
 
+//#endregion
 export { BLOCK_STORAGE_FACADE_VERSION, BlockStorageFacadeCallbacks, BlockStorageFacadeHandles, registerFacadeCallbacks };
-//# sourceMappingURL=block_storage_facade.js.map
+//# sourceMappingURL=block_storage_facade.js.map

package/dist/block_storage_facade.js.map

@@ -1 +1 @@
-{"version":3,"file":"block_storage_facade.js","sources":["../src/block_storage_facade.ts"],"sourcesContent":["/**\n * Block Storage Facade - Contract between bundled blocks and middle layer.\n *\n * ============================================================================\n * VERSIONING\n * ============================================================================\n *\n * Blocks declare their model API version via the `requiresModelAPIVersion` feature flag\n * (see BlockCodeKnownFeatureFlags). This determines how the middle layer manages block state:\n *\n * - Version 1: Legacy BlockModel - state is {args, uiState}, managed directly by middle layer\n * - Version 2: BlockModelV3 - uses blockStorage with VM-based callbacks (this facade)\n *\n * This facade (BlockStorageFacade) is used by blocks with `requiresModelAPIVersion: 2`.\n * The version number matches the model API version for clarity.\n *\n * ============================================================================\n * BACKWARD COMPATIBILITY WARNING\n * ============================================================================\n *\n * This file documents the FACADE between the SDK (bundled into blocks) and the\n * middle layer. Once a block is published, its SDK version is frozen. The middle\n * layer must support ALL previously released callback signatures indefinitely.\n *\n * RULES:\n * 1. NEVER change the signature of existing callbacks\n * 2. NEVER remove existing callbacks\n * 3. New callbacks CAN be added (old blocks won't register them, middle layer\n *    should handle missing callbacks gracefully)\n * 4. Callback return types can be EXTENDED (add optional fields) but not changed\n * 5. Callback parameter types should remain compatible (middle layer may need\n *    to handle both old and new formats)\n *\n * The facade consists of callbacks registered via `tryRegisterCallback()` with\n * the `__pl_` prefix. These are registered by the SDK when a block loads and\n * called by the middle layer to perform operations.\n *\n * ============================================================================\n * WHAT CAN BE CHANGED FREELY\n * ============================================================================\n *\n * - Middle layer code (lib/node/pl-middle-layer)\n * - SDK internal implementation (as long as callback contracts are preserved)\n * - SDK exports used ONLY by middle layer (not by blocks themselves)\n * - New SDK features that don't affect existing callbacks\n *\n * @module block_storage_facade\n */\n\nimport type { MutateStoragePayload } from \"./block_storage\";\nimport type { ConfigRenderLambda } from \"./bconfig\";\nimport { createRenderLambda, tryRegisterCallback } from \"./internal\";\nimport type { StringifiedJson } from \"@milaboratories/pl-model-common\";\n\n// =============================================================================\n// Facade Version\n// =============================================================================\n\n/**\n * The current facade version. This value is used for `requiresModelAPIVersion`\n * feature flag in BlockModelV3.\n */\nexport const BLOCK_STORAGE_FACADE_VERSION = 2;\n\n// =============================================================================\n// Facade Callback Names\n// =============================================================================\n\n/**\n * All facade callback names as constants.\n * These are the source of truth - the interface is derived from these.\n *\n * IMPORTANT: When adding a new callback:\n * 1. Add the constant here\n * 2. Add the callback signature to FacadeCallbackTypes below\n * 3. The BlockStorageFacade type will automatically include it\n */\nexport const BlockStorageFacadeCallbacks = {\n  StorageApplyUpdate: \"__pl_storage_applyUpdate\",\n  StorageDebugView: \"__pl_storage_debugView\",\n  StorageMigrate: \"__pl_storage_migrate\",\n  ArgsDerive: \"__pl_args_derive\",\n  PrerunArgsDerive: \"__pl_prerunArgs_derive\",\n  StorageInitial: \"__pl_storage_initial\",\n} as const;\n\n/**\n * Creates a map of lambda handles from a callbacks constant object.\n * Keys are the callback string values (e.g., '__pl_storage_applyUpdate').\n */\nfunction createFacadeHandles<T extends Record<string, string>>(\n  callbacks: T,\n): { [K in T[keyof T]]: ConfigRenderLambda } {\n  return Object.fromEntries(\n    Object.values(callbacks).map((handle) => [handle, createRenderLambda({ handle })]),\n  ) as { [K in T[keyof T]]: ConfigRenderLambda };\n}\n\n/**\n * Lambda handles for facade callbacks.\n * Used by the middle layer to invoke callbacks via executeSingleLambda().\n */\nexport const BlockStorageFacadeHandles = createFacadeHandles(BlockStorageFacadeCallbacks);\n\n// =============================================================================\n// Facade Interface (source of truth for callback signatures)\n// =============================================================================\n\n/**\n * The complete facade interface between bundled blocks (SDK) and middle layer.\n *\n * This interface defines ALL callbacks that a block registers. The middle layer\n * calls these callbacks to perform storage operations.\n *\n * ALL types are inlined to simplify versioning - when a callback changes,\n * the entire signature is visible in one place.\n *\n * BACKWARD COMPATIBILITY:\n * - This interface can only be EXTENDED, never shrunk\n * - Existing callback signatures MUST NOT change\n * - Middle layer should use Partial<BlockStorageFacade> when dealing with\n *   blocks of unknown version (older blocks may not have all callbacks)\n *\n * Each callback is documented with:\n * - Purpose and when it's called\n * - Parameter descriptions\n * - Return value description\n */\nexport interface BlockStorageFacade {\n  /**\n   * Apply state update to storage.\n   * Called when UI updates block state (setState) or plugin data.\n   * @param currentStorageJson - Current storage as JSON string\n   * @param payload - Update payload with operation type and value\n   * @returns Updated storage as JSON string\n   */\n  [BlockStorageFacadeCallbacks.StorageApplyUpdate]: (\n    currentStorageJson: StringifiedJson,\n    payload: MutateStoragePayload,\n  ) => StringifiedJson;\n\n  /**\n   * Get debug view of storage.\n   * Called by developer tools to inspect storage state.\n   * @param storageJson - Storage as JSON string (or undefined for new blocks)\n   * @returns JSON string containing StorageDebugView\n   */\n  [BlockStorageFacadeCallbacks.StorageDebugView]: (\n    storageJson: StringifiedJson | undefined,\n  ) => StringifiedJson;\n\n  /**\n   * Run storage migration.\n   * Called when block loads to migrate data to latest version.\n   * @param currentStorageJson - Current storage as JSON string (or undefined for new blocks)\n   * @returns Migration result - either error or success with new storage\n   */\n  [BlockStorageFacadeCallbacks.StorageMigrate]: (currentStorageJson: StringifiedJson | undefined) =>\n    | { error: string }\n    | {\n        error?: undefined;\n        newStorageJson: StringifiedJson;\n        info: string;\n      };\n\n  /**\n   * Derive args from storage.\n   * Called to get block configuration args from storage.\n   * @param storageJson - Storage as JSON string\n   * @returns Args derivation result - either error or derived value\n   */\n  [BlockStorageFacadeCallbacks.ArgsDerive]: (\n    storageJson: StringifiedJson,\n  ) => { error: string } | { error?: undefined; value: unknown };\n\n  /**\n   * Derive prerunArgs from storage.\n   * Called to get prerun args; falls back to args callback if not registered.\n   * @param storageJson - Storage as JSON string\n   * @returns Args derivation result - either error or derived value\n   */\n  [BlockStorageFacadeCallbacks.PrerunArgsDerive]: (\n    storageJson: StringifiedJson,\n  ) => { error: string } | { error?: undefined; value: unknown };\n\n  /**\n   * Get initial storage JSON for new blocks.\n   * Called when creating a new block to get complete initial storage.\n   * @returns Initial storage as JSON string\n   */\n  [BlockStorageFacadeCallbacks.StorageInitial]: () => StringifiedJson;\n}\n\n/** Register all facade callbacks at once. Ensures all required callbacks are provided. */\nexport function registerFacadeCallbacks(callbacks: BlockStorageFacade): void {\n  for (const key of Object.values(BlockStorageFacadeCallbacks)) {\n    tryRegisterCallback(key, callbacks[key] as (...args: any[]) => any);\n  }\n}\n"],"names":[],"mappings":";;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CG;AAOH;AACA;AACA;AAEA;;;AAGG;AACI,MAAM,4BAA4B,GAAG;AAE5C;AACA;AACA;AAEA;;;;;;;;AAQG;AACI,MAAM,2BAA2B,GAAG;AACzC,IAAA,kBAAkB,EAAE,0BAA0B;AAC9C,IAAA,gBAAgB,EAAE,wBAAwB;AAC1C,IAAA,cAAc,EAAE,sBAAsB;AACtC,IAAA,UAAU,EAAE,kBAAkB;AAC9B,IAAA,gBAAgB,EAAE,wBAAwB;AAC1C,IAAA,cAAc,EAAE,sBAAsB;;AAGxC;;;AAGG;AACH,SAAS,mBAAmB,CAC1B,SAAY,EAAA;AAEZ,IAAA,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CACtC;AAChD;AAEA;;;AAGG;MACU,yBAAyB,GAAG,mBAAmB,CAAC,2BAA2B;AA2FxF;AACM,SAAU,uBAAuB,CAAC,SAA6B,EAAA;IACnE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,2BAA2B,CAAC,EAAE;QAC5D,mBAAmB,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,CAA4B,CAAC;IACrE;AACF;;;;"}
+{"version":3,"file":"block_storage_facade.js","names":[],"sources":["../src/block_storage_facade.ts"],"sourcesContent":["/**\n * Block Storage Facade - Contract between bundled blocks and middle layer.\n *\n * ============================================================================\n * VERSIONING\n * ============================================================================\n *\n * Blocks declare their model API version via the `requiresModelAPIVersion` feature flag\n * (see BlockCodeKnownFeatureFlags). This determines how the middle layer manages block state:\n *\n * - Version 1: Legacy BlockModel - state is {args, uiState}, managed directly by middle layer\n * - Version 2: BlockModelV3 - uses blockStorage with VM-based callbacks (this facade)\n *\n * This facade (BlockStorageFacade) is used by blocks with `requiresModelAPIVersion: 2`.\n * The version number matches the model API version for clarity.\n *\n * ============================================================================\n * BACKWARD COMPATIBILITY WARNING\n * ============================================================================\n *\n * This file documents the FACADE between the SDK (bundled into blocks) and the\n * middle layer. Once a block is published, its SDK version is frozen. The middle\n * layer must support ALL previously released callback signatures indefinitely.\n *\n * RULES:\n * 1. NEVER change the signature of existing callbacks\n * 2. NEVER remove existing callbacks\n * 3. New callbacks CAN be added (old blocks won't register them, middle layer\n *    should handle missing callbacks gracefully)\n * 4. Callback return types can be EXTENDED (add optional fields) but not changed\n * 5. Callback parameter types should remain compatible (middle layer may need\n *    to handle both old and new formats)\n *\n * The facade consists of callbacks registered via `tryRegisterCallback()` with\n * the `__pl_` prefix. These are registered by the SDK when a block loads and\n * called by the middle layer to perform operations.\n *\n * ============================================================================\n * WHAT CAN BE CHANGED FREELY\n * ============================================================================\n *\n * - Middle layer code (lib/node/pl-middle-layer)\n * - SDK internal implementation (as long as callback contracts are preserved)\n * - SDK exports used ONLY by middle layer (not by blocks themselves)\n * - New SDK features that don't affect existing callbacks\n *\n * @module block_storage_facade\n */\n\nimport type { MutateStoragePayload } from \"./block_storage\";\nimport type { ConfigRenderLambda } from \"./bconfig\";\nimport { createRenderLambda, tryRegisterCallback } from \"./internal\";\nimport type { StringifiedJson } from \"@milaboratories/pl-model-common\";\n\n// =============================================================================\n// Facade Version\n// =============================================================================\n\n/**\n * The current facade version. This value is used for `requiresModelAPIVersion`\n * feature flag in BlockModelV3.\n */\nexport const BLOCK_STORAGE_FACADE_VERSION = 2;\n\n// =============================================================================\n// Facade Callback Names\n// =============================================================================\n\n/**\n * All facade callback names as constants.\n * These are the source of truth - the interface is derived from these.\n *\n * IMPORTANT: When adding a new callback:\n * 1. Add the constant here\n * 2. Add the callback signature to FacadeCallbackTypes below\n * 3. The BlockStorageFacade type will automatically include it\n */\nexport const BlockStorageFacadeCallbacks = {\n  StorageApplyUpdate: \"__pl_storage_applyUpdate\",\n  StorageDebugView: \"__pl_storage_debugView\",\n  StorageMigrate: \"__pl_storage_migrate\",\n  ArgsDerive: \"__pl_args_derive\",\n  PrerunArgsDerive: \"__pl_prerunArgs_derive\",\n  StorageInitial: \"__pl_storage_initial\",\n} as const;\n\n/**\n * Creates a map of lambda handles from a callbacks constant object.\n * Keys are the callback string values (e.g., '__pl_storage_applyUpdate').\n */\nfunction createFacadeHandles<T extends Record<string, string>>(\n  callbacks: T,\n): { [K in T[keyof T]]: ConfigRenderLambda } {\n  return Object.fromEntries(\n    Object.values(callbacks).map((handle) => [handle, createRenderLambda({ handle })]),\n  ) as { [K in T[keyof T]]: ConfigRenderLambda };\n}\n\n/**\n * Lambda handles for facade callbacks.\n * Used by the middle layer to invoke callbacks via executeSingleLambda().\n */\nexport const BlockStorageFacadeHandles = createFacadeHandles(BlockStorageFacadeCallbacks);\n\n// =============================================================================\n// Facade Interface (source of truth for callback signatures)\n// =============================================================================\n\n/**\n * The complete facade interface between bundled blocks (SDK) and middle layer.\n *\n * This interface defines ALL callbacks that a block registers. The middle layer\n * calls these callbacks to perform storage operations.\n *\n * ALL types are inlined to simplify versioning - when a callback changes,\n * the entire signature is visible in one place.\n *\n * BACKWARD COMPATIBILITY:\n * - This interface can only be EXTENDED, never shrunk\n * - Existing callback signatures MUST NOT change\n * - Middle layer should use Partial<BlockStorageFacade> when dealing with\n *   blocks of unknown version (older blocks may not have all callbacks)\n *\n * Each callback is documented with:\n * - Purpose and when it's called\n * - Parameter descriptions\n * - Return value description\n */\nexport interface BlockStorageFacade {\n  /**\n   * Apply state update to storage.\n   * Called when UI updates block state (setState) or plugin data.\n   * @param currentStorageJson - Current storage as JSON string\n   * @param payload - Update payload with operation type and value\n   * @returns Updated storage as JSON string\n   */\n  [BlockStorageFacadeCallbacks.StorageApplyUpdate]: (\n    currentStorageJson: StringifiedJson,\n    payload: MutateStoragePayload,\n  ) => StringifiedJson;\n\n  /**\n   * Get debug view of storage.\n   * Called by developer tools to inspect storage state.\n   * @param storageJson - Storage as JSON string (or undefined for new blocks)\n   * @returns JSON string containing StorageDebugView\n   */\n  [BlockStorageFacadeCallbacks.StorageDebugView]: (\n    storageJson: StringifiedJson | undefined,\n  ) => StringifiedJson;\n\n  /**\n   * Run storage migration.\n   * Called when block loads to migrate data to latest version.\n   * @param currentStorageJson - Current storage as JSON string (or undefined for new blocks)\n   * @returns Migration result - either error or success with new storage\n   */\n  [BlockStorageFacadeCallbacks.StorageMigrate]: (currentStorageJson: StringifiedJson | undefined) =>\n    | { error: string }\n    | {\n        error?: undefined;\n        newStorageJson: StringifiedJson;\n        info: string;\n      };\n\n  /**\n   * Derive args from storage.\n   * Called to get block configuration args from storage.\n   * @param storageJson - Storage as JSON string\n   * @returns Args derivation result - either error or derived value\n   */\n  [BlockStorageFacadeCallbacks.ArgsDerive]: (\n    storageJson: StringifiedJson,\n  ) => { error: string } | { error?: undefined; value: unknown };\n\n  /**\n   * Derive prerunArgs from storage.\n   * Called to get prerun args; falls back to args callback if not registered.\n   * @param storageJson - Storage as JSON string\n   * @returns Args derivation result - either error or derived value\n   */\n  [BlockStorageFacadeCallbacks.PrerunArgsDerive]: (\n    storageJson: StringifiedJson,\n  ) => { error: string } | { error?: undefined; value: unknown };\n\n  /**\n   * Get initial storage JSON for new blocks.\n   * Called when creating a new block to get complete initial storage.\n   * @returns Initial storage as JSON string\n   */\n  [BlockStorageFacadeCallbacks.StorageInitial]: () => StringifiedJson;\n}\n\n/** Register all facade callbacks at once. Ensures all required callbacks are provided. */\nexport function registerFacadeCallbacks(callbacks: BlockStorageFacade): void {\n  for (const key of Object.values(BlockStorageFacadeCallbacks)) {\n    tryRegisterCallback(key, callbacks[key] as (...args: any[]) => any);\n  }\n}\n"],"mappings":";;;;;;;AA8DA,MAAa,+BAA+B;;;;;;;;;;AAe5C,MAAa,8BAA8B;CACzC,oBAAoB;CACpB,kBAAkB;CAClB,gBAAgB;CAChB,YAAY;CACZ,kBAAkB;CAClB,gBAAgB;CACjB;;;;;AAMD,SAAS,oBACP,WAC2C;AAC3C,QAAO,OAAO,YACZ,OAAO,OAAO,UAAU,CAAC,KAAK,WAAW,CAAC,QAAQ,mBAAmB,EAAE,QAAQ,CAAC,CAAC,CAAC,CACnF;;;;;;AAOH,MAAa,4BAA4B,oBAAoB,4BAA4B;;AA4FzF,SAAgB,wBAAwB,WAAqC;AAC3E,MAAK,MAAM,OAAO,OAAO,OAAO,4BAA4B,CAC1D,qBAAoB,KAAK,UAAU,KAAgC"}

package/dist/components/PFrameForGraphs.cjs

@@ -1,36 +1,38 @@
-'use strict';
-
-var plModelCommon = require('@milaboratories/pl-model-common');
-var columns = require('../pframe_utils/columns.cjs');
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_axes = require('../pframe_utils/axes.cjs');
+const require_columns = require('../pframe_utils/columns.cjs');
+let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
 
+//#region src/components/PFrameForGraphs.ts
 function isHiddenFromGraphColumn(column) {
-    return !!plModelCommon.readAnnotationJson(column, plModelCommon.Annotation.HideDataFromGraphs);
+	return !!(0, _milaboratories_pl_model_common.readAnnotationJson)(column, _milaboratories_pl_model_common.Annotation.HideDataFromGraphs);
 }
 function isHiddenFromUIColumn(column) {
-    return !!plModelCommon.readAnnotationJson(column, plModelCommon.Annotation.HideDataFromUi);
+	return !!(0, _milaboratories_pl_model_common.readAnnotationJson)(column, _milaboratories_pl_model_common.Annotation.HideDataFromUi);
 }
 /**
- The aim of createPFrameForGraphs: to create pframe with block’s columns and all compatible columns from result pool
- (including linker columns and all label columns).
- Block’s columns are added to pframe as is.
- Other columns are added basing on set of axes of block’s columns, considering available with linker columns.
- Compatible columns must have at least one axis from block’s axes set. This axis of the compatible column from
- result pool must satisfy matchAxisId (it can have less domain keys than in block’s axis, but without conflicting values
- among existing ones).
- In requests to pframe (calculateTableData) columns must have strictly the same axes. For compatibility in case
- of partially matched axis we add to pframe a copy of this column with modified axis (with filled missed domains)
- and modified label (with added domain values in case if more than one copy with different domains exist).
- */
+The aim of createPFrameForGraphs: to create pframe with block’s columns and all compatible columns from result pool
+(including linker columns and all label columns).
+Block’s columns are added to pframe as is.
+Other columns are added basing on set of axes of block’s columns, considering available with linker columns.
+Compatible columns must have at least one axis from block’s axes set. This axis of the compatible column from
+result pool must satisfy matchAxisId (it can have less domain keys than in block’s axis, but without conflicting values
+among existing ones).
+In requests to pframe (calculateTableData) columns must have strictly the same axes. For compatibility in case
+of partially matched axis we add to pframe a copy of this column with modified axis (with filled missed domains)
+and modified label (with added domain values in case if more than one copy with different domains exist).
+*/
 function createPFrameForGraphs(ctx, blockColumns) {
-    const suitableSpec = (spec) => !isHiddenFromUIColumn(spec) && !isHiddenFromGraphColumn(spec);
-    // if current block doesn't produce own columns then use all columns from result pool
-    if (!blockColumns) {
-        return ctx.createPFrame(columns.getAllRelatedColumns(ctx, suitableSpec));
-    }
-    return ctx.createPFrame(columns.getRelatedColumns(ctx, { columns: blockColumns, predicate: suitableSpec }));
+	const suitableSpec = (spec) => !isHiddenFromUIColumn(spec) && !isHiddenFromGraphColumn(spec);
+	if (!blockColumns) return ctx.createPFrame(require_columns.getAllRelatedColumns(ctx, suitableSpec));
+	return ctx.createPFrame(require_columns.getRelatedColumns(ctx, {
+		columns: blockColumns,
+		predicate: suitableSpec
+	}));
 }
 
+//#endregion
 exports.createPFrameForGraphs = createPFrameForGraphs;
 exports.isHiddenFromGraphColumn = isHiddenFromGraphColumn;
 exports.isHiddenFromUIColumn = isHiddenFromUIColumn;
-//# sourceMappingURL=PFrameForGraphs.cjs.map
+//# sourceMappingURL=PFrameForGraphs.cjs.map

package/dist/components/PFrameForGraphs.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"PFrameForGraphs.cjs","sources":["../../src/components/PFrameForGraphs.ts"],"sourcesContent":["import type { PColumn, PColumnSpec, PFrameHandle } from \"@milaboratories/pl-model-common\";\nimport { Annotation, readAnnotationJson } from \"@milaboratories/pl-model-common\";\nimport type { PColumnDataUniversal, RenderCtxBase } from \"../render\";\nimport { getAllRelatedColumns, getRelatedColumns } from \"../pframe_utils/columns\";\nexport type { AxesVault } from \"../pframe_utils/axes\";\nexport { enrichCompatible, getAvailableWithLinkersAxes } from \"../pframe_utils/axes\";\n\nexport function isHiddenFromGraphColumn(column: PColumnSpec): boolean {\n  return !!readAnnotationJson(column, Annotation.HideDataFromGraphs);\n}\n\nexport function isHiddenFromUIColumn(column: PColumnSpec): boolean {\n  return !!readAnnotationJson(column, Annotation.HideDataFromUi);\n}\n\n/**\n The aim of createPFrameForGraphs: to create pframe with block’s columns and all compatible columns from result pool\n (including linker columns and all label columns).\n Block’s columns are added to pframe as is.\n Other columns are added basing on set of axes of block’s columns, considering available with linker columns.\n Compatible columns must have at least one axis from block’s axes set. This axis of the compatible column from\n result pool must satisfy matchAxisId (it can have less domain keys than in block’s axis, but without conflicting values\n among existing ones).\n In requests to pframe (calculateTableData) columns must have strictly the same axes. For compatibility in case\n of partially matched axis we add to pframe a copy of this column with modified axis (with filled missed domains)\n and modified label (with added domain values in case if more than one copy with different domains exist).\n */\nexport function createPFrameForGraphs<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  blockColumns?: PColumn<PColumnDataUniversal>[],\n): PFrameHandle | undefined {\n  const suitableSpec = (spec: PColumnSpec) =>\n    !isHiddenFromUIColumn(spec) && !isHiddenFromGraphColumn(spec);\n  // if current block doesn't produce own columns then use all columns from result pool\n  if (!blockColumns) {\n    return ctx.createPFrame(getAllRelatedColumns(ctx, suitableSpec));\n  }\n\n  return ctx.createPFrame(\n    getRelatedColumns(ctx, { columns: blockColumns, predicate: suitableSpec }),\n  );\n}\n"],"names":["readAnnotationJson","Annotation","getAllRelatedColumns","getRelatedColumns"],"mappings":";;;;;AAOM,SAAU,uBAAuB,CAAC,MAAmB,EAAA;IACzD,OAAO,CAAC,CAACA,gCAAkB,CAAC,MAAM,EAAEC,wBAAU,CAAC,kBAAkB,CAAC;AACpE;AAEM,SAAU,oBAAoB,CAAC,MAAmB,EAAA;IACtD,OAAO,CAAC,CAACD,gCAAkB,CAAC,MAAM,EAAEC,wBAAU,CAAC,cAAc,CAAC;AAChE;AAEA;;;;;;;;;;;AAWG;AACG,SAAU,qBAAqB,CACnC,GAAwB,EACxB,YAA8C,EAAA;AAE9C,IAAA,MAAM,YAAY,GAAG,CAAC,IAAiB,KACrC,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC;;IAE/D,IAAI,CAAC,YAAY,EAAE;QACjB,OAAO,GAAG,CAAC,YAAY,CAACC,4BAAoB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAClE;AAEA,IAAA,OAAO,GAAG,CAAC,YAAY,CACrBC,yBAAiB,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAC3E;AACH;;;;;;"}
+{"version":3,"file":"PFrameForGraphs.cjs","names":["Annotation","getAllRelatedColumns","getRelatedColumns"],"sources":["../../src/components/PFrameForGraphs.ts"],"sourcesContent":["import type { PColumn, PColumnSpec, PFrameHandle } from \"@milaboratories/pl-model-common\";\nimport { Annotation, readAnnotationJson } from \"@milaboratories/pl-model-common\";\nimport type { PColumnDataUniversal, RenderCtxBase } from \"../render\";\nimport { getAllRelatedColumns, getRelatedColumns } from \"../pframe_utils/columns\";\nexport type { AxesVault } from \"../pframe_utils/axes\";\nexport { enrichCompatible, getAvailableWithLinkersAxes } from \"../pframe_utils/axes\";\n\nexport function isHiddenFromGraphColumn(column: PColumnSpec): boolean {\n  return !!readAnnotationJson(column, Annotation.HideDataFromGraphs);\n}\n\nexport function isHiddenFromUIColumn(column: PColumnSpec): boolean {\n  return !!readAnnotationJson(column, Annotation.HideDataFromUi);\n}\n\n/**\n The aim of createPFrameForGraphs: to create pframe with block’s columns and all compatible columns from result pool\n (including linker columns and all label columns).\n Block’s columns are added to pframe as is.\n Other columns are added basing on set of axes of block’s columns, considering available with linker columns.\n Compatible columns must have at least one axis from block’s axes set. This axis of the compatible column from\n result pool must satisfy matchAxisId (it can have less domain keys than in block’s axis, but without conflicting values\n among existing ones).\n In requests to pframe (calculateTableData) columns must have strictly the same axes. For compatibility in case\n of partially matched axis we add to pframe a copy of this column with modified axis (with filled missed domains)\n and modified label (with added domain values in case if more than one copy with different domains exist).\n */\nexport function createPFrameForGraphs<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  blockColumns?: PColumn<PColumnDataUniversal>[],\n): PFrameHandle | undefined {\n  const suitableSpec = (spec: PColumnSpec) =>\n    !isHiddenFromUIColumn(spec) && !isHiddenFromGraphColumn(spec);\n  // if current block doesn't produce own columns then use all columns from result pool\n  if (!blockColumns) {\n    return ctx.createPFrame(getAllRelatedColumns(ctx, suitableSpec));\n  }\n\n  return ctx.createPFrame(\n    getRelatedColumns(ctx, { columns: blockColumns, predicate: suitableSpec }),\n  );\n}\n"],"mappings":";;;;;;AAOA,SAAgB,wBAAwB,QAA8B;AACpE,QAAO,CAAC,yDAAoB,QAAQA,2CAAW,mBAAmB;;AAGpE,SAAgB,qBAAqB,QAA8B;AACjE,QAAO,CAAC,yDAAoB,QAAQA,2CAAW,eAAe;;;;;;;;;;;;;;AAehE,SAAgB,sBACd,KACA,cAC0B;CAC1B,MAAM,gBAAgB,SACpB,CAAC,qBAAqB,KAAK,IAAI,CAAC,wBAAwB,KAAK;AAE/D,KAAI,CAAC,aACH,QAAO,IAAI,aAAaC,qCAAqB,KAAK,aAAa,CAAC;AAGlE,QAAO,IAAI,aACTC,kCAAkB,KAAK;EAAE,SAAS;EAAc,WAAW;EAAc,CAAC,CAC3E"}

package/dist/components/PFrameForGraphs.d.ts

@@ -1,9 +1,12 @@
-import type { PColumn, PColumnSpec, PFrameHandle } from "@milaboratories/pl-model-common";
-import type { PColumnDataUniversal, RenderCtxBase } from "../render";
-export type { AxesVault } from "../pframe_utils/axes";
-export { enrichCompatible, getAvailableWithLinkersAxes } from "../pframe_utils/axes";
-export declare function isHiddenFromGraphColumn(column: PColumnSpec): boolean;
-export declare function isHiddenFromUIColumn(column: PColumnSpec): boolean;
+import { PColumnDataUniversal } from "../render/internal.js";
+import { RenderCtxBase } from "../render/api.js";
+import "../render/index.js";
+import { AxesVault, enrichCompatible, getAvailableWithLinkersAxes } from "../pframe_utils/axes.js";
+import { PColumn, PColumnSpec, PFrameHandle } from "@milaboratories/pl-model-common";
+
+//#region src/components/PFrameForGraphs.d.ts
+declare function isHiddenFromGraphColumn(column: PColumnSpec): boolean;
+declare function isHiddenFromUIColumn(column: PColumnSpec): boolean;
 /**
  The aim of createPFrameForGraphs: to create pframe with block’s columns and all compatible columns from result pool
  (including linker columns and all label columns).
@@ -16,5 +19,7 @@ export declare function isHiddenFromUIColumn(column: PColumnSpec): boolean;
  of partially matched axis we add to pframe a copy of this column with modified axis (with filled missed domains)
  and modified label (with added domain values in case if more than one copy with different domains exist).
  */
-export declare function createPFrameForGraphs<A, U>(ctx: RenderCtxBase<A, U>, blockColumns?: PColumn<PColumnDataUniversal>[]): PFrameHandle | undefined;
+declare function createPFrameForGraphs<A, U>(ctx: RenderCtxBase<A, U>, blockColumns?: PColumn<PColumnDataUniversal>[]): PFrameHandle | undefined;
+//#endregion
+export { createPFrameForGraphs, isHiddenFromGraphColumn, isHiddenFromUIColumn };
 //# sourceMappingURL=PFrameForGraphs.d.ts.map

package/dist/components/PFrameForGraphs.js

@@ -1,32 +1,35 @@
-import { readAnnotationJson, Annotation } from '@milaboratories/pl-model-common';
-import { getAllRelatedColumns, getRelatedColumns } from '../pframe_utils/columns.js';
+import { enrichCompatible, getAvailableWithLinkersAxes } from "../pframe_utils/axes.js";
+import { getAllRelatedColumns, getRelatedColumns } from "../pframe_utils/columns.js";
+import { Annotation, readAnnotationJson } from "@milaboratories/pl-model-common";
 
+//#region src/components/PFrameForGraphs.ts
 function isHiddenFromGraphColumn(column) {
-    return !!readAnnotationJson(column, Annotation.HideDataFromGraphs);
+	return !!readAnnotationJson(column, Annotation.HideDataFromGraphs);
 }
 function isHiddenFromUIColumn(column) {
-    return !!readAnnotationJson(column, Annotation.HideDataFromUi);
+	return !!readAnnotationJson(column, Annotation.HideDataFromUi);
 }
 /**
- The aim of createPFrameForGraphs: to create pframe with block’s columns and all compatible columns from result pool
- (including linker columns and all label columns).
- Block’s columns are added to pframe as is.
- Other columns are added basing on set of axes of block’s columns, considering available with linker columns.
- Compatible columns must have at least one axis from block’s axes set. This axis of the compatible column from
- result pool must satisfy matchAxisId (it can have less domain keys than in block’s axis, but without conflicting values
- among existing ones).
- In requests to pframe (calculateTableData) columns must have strictly the same axes. For compatibility in case
- of partially matched axis we add to pframe a copy of this column with modified axis (with filled missed domains)
- and modified label (with added domain values in case if more than one copy with different domains exist).
- */
+The aim of createPFrameForGraphs: to create pframe with block’s columns and all compatible columns from result pool
+(including linker columns and all label columns).
+Block’s columns are added to pframe as is.
+Other columns are added basing on set of axes of block’s columns, considering available with linker columns.
+Compatible columns must have at least one axis from block’s axes set. This axis of the compatible column from
+result pool must satisfy matchAxisId (it can have less domain keys than in block’s axis, but without conflicting values
+among existing ones).
+In requests to pframe (calculateTableData) columns must have strictly the same axes. For compatibility in case
+of partially matched axis we add to pframe a copy of this column with modified axis (with filled missed domains)
+and modified label (with added domain values in case if more than one copy with different domains exist).
+*/
 function createPFrameForGraphs(ctx, blockColumns) {
-    const suitableSpec = (spec) => !isHiddenFromUIColumn(spec) && !isHiddenFromGraphColumn(spec);
-    // if current block doesn't produce own columns then use all columns from result pool
-    if (!blockColumns) {
-        return ctx.createPFrame(getAllRelatedColumns(ctx, suitableSpec));
-    }
-    return ctx.createPFrame(getRelatedColumns(ctx, { columns: blockColumns, predicate: suitableSpec }));
+	const suitableSpec = (spec) => !isHiddenFromUIColumn(spec) && !isHiddenFromGraphColumn(spec);
+	if (!blockColumns) return ctx.createPFrame(getAllRelatedColumns(ctx, suitableSpec));
+	return ctx.createPFrame(getRelatedColumns(ctx, {
+		columns: blockColumns,
+		predicate: suitableSpec
+	}));
 }
 
+//#endregion
 export { createPFrameForGraphs, isHiddenFromGraphColumn, isHiddenFromUIColumn };
-//# sourceMappingURL=PFrameForGraphs.js.map
+//# sourceMappingURL=PFrameForGraphs.js.map

package/dist/components/PFrameForGraphs.js.map

@@ -1 +1 @@
-{"version":3,"file":"PFrameForGraphs.js","sources":["../../src/components/PFrameForGraphs.ts"],"sourcesContent":["import type { PColumn, PColumnSpec, PFrameHandle } from \"@milaboratories/pl-model-common\";\nimport { Annotation, readAnnotationJson } from \"@milaboratories/pl-model-common\";\nimport type { PColumnDataUniversal, RenderCtxBase } from \"../render\";\nimport { getAllRelatedColumns, getRelatedColumns } from \"../pframe_utils/columns\";\nexport type { AxesVault } from \"../pframe_utils/axes\";\nexport { enrichCompatible, getAvailableWithLinkersAxes } from \"../pframe_utils/axes\";\n\nexport function isHiddenFromGraphColumn(column: PColumnSpec): boolean {\n  return !!readAnnotationJson(column, Annotation.HideDataFromGraphs);\n}\n\nexport function isHiddenFromUIColumn(column: PColumnSpec): boolean {\n  return !!readAnnotationJson(column, Annotation.HideDataFromUi);\n}\n\n/**\n The aim of createPFrameForGraphs: to create pframe with block’s columns and all compatible columns from result pool\n (including linker columns and all label columns).\n Block’s columns are added to pframe as is.\n Other columns are added basing on set of axes of block’s columns, considering available with linker columns.\n Compatible columns must have at least one axis from block’s axes set. This axis of the compatible column from\n result pool must satisfy matchAxisId (it can have less domain keys than in block’s axis, but without conflicting values\n among existing ones).\n In requests to pframe (calculateTableData) columns must have strictly the same axes. For compatibility in case\n of partially matched axis we add to pframe a copy of this column with modified axis (with filled missed domains)\n and modified label (with added domain values in case if more than one copy with different domains exist).\n */\nexport function createPFrameForGraphs<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  blockColumns?: PColumn<PColumnDataUniversal>[],\n): PFrameHandle | undefined {\n  const suitableSpec = (spec: PColumnSpec) =>\n    !isHiddenFromUIColumn(spec) && !isHiddenFromGraphColumn(spec);\n  // if current block doesn't produce own columns then use all columns from result pool\n  if (!blockColumns) {\n    return ctx.createPFrame(getAllRelatedColumns(ctx, suitableSpec));\n  }\n\n  return ctx.createPFrame(\n    getRelatedColumns(ctx, { columns: blockColumns, predicate: suitableSpec }),\n  );\n}\n"],"names":[],"mappings":";;;AAOM,SAAU,uBAAuB,CAAC,MAAmB,EAAA;IACzD,OAAO,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,UAAU,CAAC,kBAAkB,CAAC;AACpE;AAEM,SAAU,oBAAoB,CAAC,MAAmB,EAAA;IACtD,OAAO,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,UAAU,CAAC,cAAc,CAAC;AAChE;AAEA;;;;;;;;;;;AAWG;AACG,SAAU,qBAAqB,CACnC,GAAwB,EACxB,YAA8C,EAAA;AAE9C,IAAA,MAAM,YAAY,GAAG,CAAC,IAAiB,KACrC,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC;;IAE/D,IAAI,CAAC,YAAY,EAAE;QACjB,OAAO,GAAG,CAAC,YAAY,CAAC,oBAAoB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAClE;AAEA,IAAA,OAAO,GAAG,CAAC,YAAY,CACrB,iBAAiB,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAC3E;AACH;;;;"}
+{"version":3,"file":"PFrameForGraphs.js","names":[],"sources":["../../src/components/PFrameForGraphs.ts"],"sourcesContent":["import type { PColumn, PColumnSpec, PFrameHandle } from \"@milaboratories/pl-model-common\";\nimport { Annotation, readAnnotationJson } from \"@milaboratories/pl-model-common\";\nimport type { PColumnDataUniversal, RenderCtxBase } from \"../render\";\nimport { getAllRelatedColumns, getRelatedColumns } from \"../pframe_utils/columns\";\nexport type { AxesVault } from \"../pframe_utils/axes\";\nexport { enrichCompatible, getAvailableWithLinkersAxes } from \"../pframe_utils/axes\";\n\nexport function isHiddenFromGraphColumn(column: PColumnSpec): boolean {\n  return !!readAnnotationJson(column, Annotation.HideDataFromGraphs);\n}\n\nexport function isHiddenFromUIColumn(column: PColumnSpec): boolean {\n  return !!readAnnotationJson(column, Annotation.HideDataFromUi);\n}\n\n/**\n The aim of createPFrameForGraphs: to create pframe with block’s columns and all compatible columns from result pool\n (including linker columns and all label columns).\n Block’s columns are added to pframe as is.\n Other columns are added basing on set of axes of block’s columns, considering available with linker columns.\n Compatible columns must have at least one axis from block’s axes set. This axis of the compatible column from\n result pool must satisfy matchAxisId (it can have less domain keys than in block’s axis, but without conflicting values\n among existing ones).\n In requests to pframe (calculateTableData) columns must have strictly the same axes. For compatibility in case\n of partially matched axis we add to pframe a copy of this column with modified axis (with filled missed domains)\n and modified label (with added domain values in case if more than one copy with different domains exist).\n */\nexport function createPFrameForGraphs<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  blockColumns?: PColumn<PColumnDataUniversal>[],\n): PFrameHandle | undefined {\n  const suitableSpec = (spec: PColumnSpec) =>\n    !isHiddenFromUIColumn(spec) && !isHiddenFromGraphColumn(spec);\n  // if current block doesn't produce own columns then use all columns from result pool\n  if (!blockColumns) {\n    return ctx.createPFrame(getAllRelatedColumns(ctx, suitableSpec));\n  }\n\n  return ctx.createPFrame(\n    getRelatedColumns(ctx, { columns: blockColumns, predicate: suitableSpec }),\n  );\n}\n"],"mappings":";;;;;AAOA,SAAgB,wBAAwB,QAA8B;AACpE,QAAO,CAAC,CAAC,mBAAmB,QAAQ,WAAW,mBAAmB;;AAGpE,SAAgB,qBAAqB,QAA8B;AACjE,QAAO,CAAC,CAAC,mBAAmB,QAAQ,WAAW,eAAe;;;;;;;;;;;;;;AAehE,SAAgB,sBACd,KACA,cAC0B;CAC1B,MAAM,gBAAgB,SACpB,CAAC,qBAAqB,KAAK,IAAI,CAAC,wBAAwB,KAAK;AAE/D,KAAI,CAAC,aACH,QAAO,IAAI,aAAa,qBAAqB,KAAK,aAAa,CAAC;AAGlE,QAAO,IAAI,aACT,kBAAkB,KAAK;EAAE,SAAS;EAAc,WAAW;EAAc,CAAC,CAC3E"}