@okf/ootils 1.3.5 → 1.3.6

package/dist/browser.d.mts

@@ -124,5 +124,31 @@ declare const extractAllBlocksFromTpl: ({ tpl, buildersWhitelist }: {
     tpl: Template;
     buildersWhitelist?: BuilderType[];
 }) => ExtractedBlock[];
+/**
+ * Recursively extracts blocks from a hierarchical data structure.
+ *
+ * This is the core traversal function that handles nested sections and blocks.
+ * It preserves two critical pieces of metadata:
+ *
+ * 1. **sectionStack**: Array of parent sections - Essential for display condition handling.
+ *    When sections have display conditions, we need to know which blocks belong to
+ *    hidden sections to exclude them from indexes and processing.
+ *
+ * 2. **blockPath**: Dot-notation path to the block's location - Required for precise updates.
+ *    Used when modifying block properties or updating valuePaths in display conditions.
+ *    See 'modifyValuesAndValuePaths' for detailed usage.
+ *
+ * @param {Object} params - Extraction parameters
+ * @param {Block[]} params.data - Array of blocks/sections to process
+ * @param {Function} params.cb - Callback function to handle each extracted block
+ * @param {Section[]} params.sectionStack - Current stack of parent sections
+ * @param {string} params.blockPathPrefix - Current path prefix for building blockPath
+ */
+declare const _recursExtractBlocks: ({ data, cb, sectionStack, blockPathPrefix }: {
+    data: Block[];
+    cb: (block: ExtractedBlock) => void;
+    sectionStack?: Section[];
+    blockPathPrefix?: string;
+}) => void;
 
-export { deleteVal, extractAllBlocksFromTpl, genTagId, getVal, setVal, toArray };
+export { deleteVal, extractAllBlocksFromTpl, genTagId, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };

package/dist/browser.d.ts

@@ -124,5 +124,31 @@ declare const extractAllBlocksFromTpl: ({ tpl, buildersWhitelist }: {
     tpl: Template;
     buildersWhitelist?: BuilderType[];
 }) => ExtractedBlock[];
+/**
+ * Recursively extracts blocks from a hierarchical data structure.
+ *
+ * This is the core traversal function that handles nested sections and blocks.
+ * It preserves two critical pieces of metadata:
+ *
+ * 1. **sectionStack**: Array of parent sections - Essential for display condition handling.
+ *    When sections have display conditions, we need to know which blocks belong to
+ *    hidden sections to exclude them from indexes and processing.
+ *
+ * 2. **blockPath**: Dot-notation path to the block's location - Required for precise updates.
+ *    Used when modifying block properties or updating valuePaths in display conditions.
+ *    See 'modifyValuesAndValuePaths' for detailed usage.
+ *
+ * @param {Object} params - Extraction parameters
+ * @param {Block[]} params.data - Array of blocks/sections to process
+ * @param {Function} params.cb - Callback function to handle each extracted block
+ * @param {Section[]} params.sectionStack - Current stack of parent sections
+ * @param {string} params.blockPathPrefix - Current path prefix for building blockPath
+ */
+declare const _recursExtractBlocks: ({ data, cb, sectionStack, blockPathPrefix }: {
+    data: Block[];
+    cb: (block: ExtractedBlock) => void;
+    sectionStack?: Section[];
+    blockPathPrefix?: string;
+}) => void;
 
-export { deleteVal, extractAllBlocksFromTpl, genTagId, getVal, setVal, toArray };
+export { deleteVal, extractAllBlocksFromTpl, genTagId, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };

package/dist/browser.js

@@ -24,6 +24,7 @@ __export(browser_exports, {
   extractAllBlocksFromTpl: () => extractAllBlocksFromTpl,
   genTagId: () => genTagId,
   getVal: () => getVal,
+  recursivelyExtractBlocks: () => _recursExtractBlocks,
   setVal: () => setVal,
   toArray: () => toArray
 });
@@ -309,6 +310,7 @@ var _extractBlocksFromSomeBuilders = ({
   extractAllBlocksFromTpl,
   genTagId,
   getVal,
+  recursivelyExtractBlocks,
   setVal,
   toArray
 });

package/dist/browser.mjs

@@ -277,6 +277,7 @@ export {
   extractAllBlocksFromTpl,
   genTagId,
   getVal,
+  _recursExtractBlocks as recursivelyExtractBlocks,
   setVal,
   toArray
 };

package/dist/node.d.mts

@@ -127,6 +127,32 @@ declare const extractAllBlocksFromTpl: ({ tpl, buildersWhitelist }: {
     tpl: Template$1;
     buildersWhitelist?: BuilderType[];
 }) => ExtractedBlock[];
+/**
+ * Recursively extracts blocks from a hierarchical data structure.
+ *
+ * This is the core traversal function that handles nested sections and blocks.
+ * It preserves two critical pieces of metadata:
+ *
+ * 1. **sectionStack**: Array of parent sections - Essential for display condition handling.
+ *    When sections have display conditions, we need to know which blocks belong to
+ *    hidden sections to exclude them from indexes and processing.
+ *
+ * 2. **blockPath**: Dot-notation path to the block's location - Required for precise updates.
+ *    Used when modifying block properties or updating valuePaths in display conditions.
+ *    See 'modifyValuesAndValuePaths' for detailed usage.
+ *
+ * @param {Object} params - Extraction parameters
+ * @param {Block[]} params.data - Array of blocks/sections to process
+ * @param {Function} params.cb - Callback function to handle each extracted block
+ * @param {Section[]} params.sectionStack - Current stack of parent sections
+ * @param {string} params.blockPathPrefix - Current path prefix for building blockPath
+ */
+declare const _recursExtractBlocks: ({ data, cb, sectionStack, blockPathPrefix }: {
+    data: Block[];
+    cb: (block: ExtractedBlock) => void;
+    sectionStack?: Section[];
+    blockPathPrefix?: string;
+}) => void;
 
 interface DbConnections {
     [clusterName: string]: Connection;
@@ -269,4 +295,4 @@ declare const getAIConfigs: ({ tenant }: GetAIConfigsParams) => Promise<AIconfig
 declare const connectToRedis: () => Promise<void>;
 declare const getRedisClient: () => IORedis;
 
-export { connectToRedis, deleteVal, extractAllBlocksFromTpl, genTagId, getAIConfigs, getAnnotationsModelByTenant, getDbByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getRedisClient, getTpl, getTplModelByTenant, getVal, initializeGlobalConfig, multiConnectToMongoDB, setVal, toArray, updateGlobalConfig };
+export { connectToRedis, deleteVal, extractAllBlocksFromTpl, genTagId, getAIConfigs, getAnnotationsModelByTenant, getDbByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getRedisClient, getTpl, getTplModelByTenant, getVal, initializeGlobalConfig, multiConnectToMongoDB, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray, updateGlobalConfig };

package/dist/node.d.ts

@@ -127,6 +127,32 @@ declare const extractAllBlocksFromTpl: ({ tpl, buildersWhitelist }: {
     tpl: Template$1;
     buildersWhitelist?: BuilderType[];
 }) => ExtractedBlock[];
+/**
+ * Recursively extracts blocks from a hierarchical data structure.
+ *
+ * This is the core traversal function that handles nested sections and blocks.
+ * It preserves two critical pieces of metadata:
+ *
+ * 1. **sectionStack**: Array of parent sections - Essential for display condition handling.
+ *    When sections have display conditions, we need to know which blocks belong to
+ *    hidden sections to exclude them from indexes and processing.
+ *
+ * 2. **blockPath**: Dot-notation path to the block's location - Required for precise updates.
+ *    Used when modifying block properties or updating valuePaths in display conditions.
+ *    See 'modifyValuesAndValuePaths' for detailed usage.
+ *
+ * @param {Object} params - Extraction parameters
+ * @param {Block[]} params.data - Array of blocks/sections to process
+ * @param {Function} params.cb - Callback function to handle each extracted block
+ * @param {Section[]} params.sectionStack - Current stack of parent sections
+ * @param {string} params.blockPathPrefix - Current path prefix for building blockPath
+ */
+declare const _recursExtractBlocks: ({ data, cb, sectionStack, blockPathPrefix }: {
+    data: Block[];
+    cb: (block: ExtractedBlock) => void;
+    sectionStack?: Section[];
+    blockPathPrefix?: string;
+}) => void;
 
 interface DbConnections {
     [clusterName: string]: Connection;
@@ -269,4 +295,4 @@ declare const getAIConfigs: ({ tenant }: GetAIConfigsParams) => Promise<AIconfig
 declare const connectToRedis: () => Promise<void>;
 declare const getRedisClient: () => IORedis;
 
-export { connectToRedis, deleteVal, extractAllBlocksFromTpl, genTagId, getAIConfigs, getAnnotationsModelByTenant, getDbByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getRedisClient, getTpl, getTplModelByTenant, getVal, initializeGlobalConfig, multiConnectToMongoDB, setVal, toArray, updateGlobalConfig };
+export { connectToRedis, deleteVal, extractAllBlocksFromTpl, genTagId, getAIConfigs, getAnnotationsModelByTenant, getDbByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getRedisClient, getTpl, getTplModelByTenant, getVal, initializeGlobalConfig, multiConnectToMongoDB, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray, updateGlobalConfig };

package/dist/node.js

@@ -332,6 +332,7 @@ __export(node_exports, {
   getVal: () => getVal,
   initializeGlobalConfig: () => initializeGlobalConfig,
   multiConnectToMongoDB: () => multiConnectToMongoDB,
+  recursivelyExtractBlocks: () => _recursExtractBlocks,
   setVal: () => setVal,
   toArray: () => toArray,
   updateGlobalConfig: () => updateGlobalConfig
@@ -872,6 +873,7 @@ var getAIConfigs = async ({
   getVal,
   initializeGlobalConfig,
   multiConnectToMongoDB,
+  recursivelyExtractBlocks,
   setVal,
   toArray,
   updateGlobalConfig

package/dist/node.mjs

@@ -826,6 +826,7 @@ export {
   getVal,
   initializeGlobalConfig,
   multiConnectToMongoDB,
+  _recursExtractBlocks as recursivelyExtractBlocks,
   setVal,
   toArray,
   updateGlobalConfig

package/dist/universal.d.mts

@@ -124,5 +124,31 @@ declare const extractAllBlocksFromTpl: ({ tpl, buildersWhitelist }: {
     tpl: Template;
     buildersWhitelist?: BuilderType[];
 }) => ExtractedBlock[];
+/**
+ * Recursively extracts blocks from a hierarchical data structure.
+ *
+ * This is the core traversal function that handles nested sections and blocks.
+ * It preserves two critical pieces of metadata:
+ *
+ * 1. **sectionStack**: Array of parent sections - Essential for display condition handling.
+ *    When sections have display conditions, we need to know which blocks belong to
+ *    hidden sections to exclude them from indexes and processing.
+ *
+ * 2. **blockPath**: Dot-notation path to the block's location - Required for precise updates.
+ *    Used when modifying block properties or updating valuePaths in display conditions.
+ *    See 'modifyValuesAndValuePaths' for detailed usage.
+ *
+ * @param {Object} params - Extraction parameters
+ * @param {Block[]} params.data - Array of blocks/sections to process
+ * @param {Function} params.cb - Callback function to handle each extracted block
+ * @param {Section[]} params.sectionStack - Current stack of parent sections
+ * @param {string} params.blockPathPrefix - Current path prefix for building blockPath
+ */
+declare const _recursExtractBlocks: ({ data, cb, sectionStack, blockPathPrefix }: {
+    data: Block[];
+    cb: (block: ExtractedBlock) => void;
+    sectionStack?: Section[];
+    blockPathPrefix?: string;
+}) => void;
 
-export { deleteVal, extractAllBlocksFromTpl, genTagId, getVal, setVal, toArray };
+export { deleteVal, extractAllBlocksFromTpl, genTagId, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };

package/dist/universal.d.ts

@@ -124,5 +124,31 @@ declare const extractAllBlocksFromTpl: ({ tpl, buildersWhitelist }: {
     tpl: Template;
     buildersWhitelist?: BuilderType[];
 }) => ExtractedBlock[];
+/**
+ * Recursively extracts blocks from a hierarchical data structure.
+ *
+ * This is the core traversal function that handles nested sections and blocks.
+ * It preserves two critical pieces of metadata:
+ *
+ * 1. **sectionStack**: Array of parent sections - Essential for display condition handling.
+ *    When sections have display conditions, we need to know which blocks belong to
+ *    hidden sections to exclude them from indexes and processing.
+ *
+ * 2. **blockPath**: Dot-notation path to the block's location - Required for precise updates.
+ *    Used when modifying block properties or updating valuePaths in display conditions.
+ *    See 'modifyValuesAndValuePaths' for detailed usage.
+ *
+ * @param {Object} params - Extraction parameters
+ * @param {Block[]} params.data - Array of blocks/sections to process
+ * @param {Function} params.cb - Callback function to handle each extracted block
+ * @param {Section[]} params.sectionStack - Current stack of parent sections
+ * @param {string} params.blockPathPrefix - Current path prefix for building blockPath
+ */
+declare const _recursExtractBlocks: ({ data, cb, sectionStack, blockPathPrefix }: {
+    data: Block[];
+    cb: (block: ExtractedBlock) => void;
+    sectionStack?: Section[];
+    blockPathPrefix?: string;
+}) => void;
 
-export { deleteVal, extractAllBlocksFromTpl, genTagId, getVal, setVal, toArray };
+export { deleteVal, extractAllBlocksFromTpl, genTagId, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };

package/dist/universal.js

@@ -24,6 +24,7 @@ __export(universal_exports, {
   extractAllBlocksFromTpl: () => extractAllBlocksFromTpl,
   genTagId: () => genTagId,
   getVal: () => getVal,
+  recursivelyExtractBlocks: () => _recursExtractBlocks,
   setVal: () => setVal,
   toArray: () => toArray
 });
@@ -309,6 +310,7 @@ var _extractBlocksFromSomeBuilders = ({
   extractAllBlocksFromTpl,
   genTagId,
   getVal,
+  recursivelyExtractBlocks,
   setVal,
   toArray
 });

package/dist/universal.mjs

@@ -277,6 +277,7 @@ export {
   extractAllBlocksFromTpl,
   genTagId,
   getVal,
+  _recursExtractBlocks as recursivelyExtractBlocks,
   setVal,
   toArray
 };

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.3.5",
+  "version": "1.3.6",
   "description": "Utility functions for both browser and Node.js",
   "main": "dist/index.js",
   "module": "dist/index.mjs",