@okf/ootils 1.31.5 → 1.32.1

package/dist/universal.d.mts

@@ -1418,6 +1418,15 @@ declare const UI_CONTENT: {
  */
 declare const genCleanCamelCaseId: (id: string) => string;
 
+/**
+ * Convert a plain text string into the standard Lexical value shape
+ * used across the platform: { allText, isLexical, editorState }.
+ *
+ * If the value is already Lexical (has `isLexical: true`), returns it as-is.
+ * Each line in the text becomes its own paragraph node.
+ */
+declare const plainTextToLexical: (value: string | number | any) => any;
+
 /**
  * BlockDef — single source of truth for a tplBlock's cross-cutting configuration.
  *
@@ -1429,6 +1438,18 @@ interface BlockDef {
     compName: string;
     category: 'text' | 'selection' | 'tags' | 'date' | 'number' | 'media' | 'structural' | 'special';
     qualQuant: 'qual' | 'quant' | null;
+    /**
+     * Optional gate that downgrades a block instance from its declared qualQuant unless
+     * ALL conditions match. Used for blocks whose qual-ness depends on a per-instance prop
+     * (e.g. AudioInput is only qual when `props.transcription.enable === true`).
+     *
+     * Each condition is a dotted path into `block.props` with a required value.
+     * No conditions / undefined → block's qualQuant applies unconditionally.
+     */
+    qualConditions?: Array<{
+        propPath: string;
+        equals: any;
+    }>;
     /** Mongoose schema type — the actual value returned to compToTypeMap (e.g. { type: Object }) */
     mongoSchemaType: Record<string, any>;
     /** Elasticsearch mapping shape — used directly by generateMappingsFromTpl */
@@ -1440,8 +1461,6 @@ interface BlockDef {
         plainTextString?: string | null;
         /** Path appended to valuePath for ES/listing search (e.g. 'allText'). null = valuePath used directly. */
         searchField?: string | null;
-        /** Path to get display value for table/card rendering (e.g. 'allText'). null = value itself. */
-        displayValue?: string | null;
     };
     validation: {
         /** Name of the "is populated" validator fn (resolved by consumer) */
@@ -1559,6 +1578,9 @@ declare const MONGO_SCHEMA_PRESETS: {
     readonly string: {
         readonly type: StringConstructor;
     };
+    readonly array: {
+        readonly type: ArrayConstructor;
+    };
 };
 declare const ELASTIC_MAPPING_PRESETS: {
     readonly largeText: {
@@ -1569,6 +1591,26 @@ declare const ELASTIC_MAPPING_PRESETS: {
             };
         };
     };
+    readonly audioTranscription: {
+        readonly properties: {
+            readonly transcription: {
+                readonly properties: {
+                    readonly result: {
+                        readonly properties: {
+                            readonly finalText: {
+                                readonly properties: {
+                                    readonly allText: {
+                                        readonly type: "text";
+                                        readonly analyzer: "LargeTextAnalyzer";
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
 };
 declare const CHUNKING_PRESETS: {
     readonly lexicalSemantic: {
@@ -1609,8 +1651,24 @@ declare class BlockRegistry {
     getQualBlocks(): string[];
     /** Get compType strings for all quant blocks. */
     getQuantBlocks(): string[];
+    /**
+     * Returns true if a specific block instance should be treated as qualitative.
+     * Combines the static `qualQuant` flag with any per-instance `qualConditions`
+     * — e.g. AudioInput is only qual when `props.transcription.enable === true`.
+     */
+    isQualBlock(block: {
+        comp: string;
+        props?: any;
+    }): boolean;
     /** Check if a specific block has a specific capability. */
     hasCapability(compType: string, capability: keyof BlockCapabilities): boolean;
+    /**
+     * Returns true if the block stores its value as an array (Mongo schema type is Array).
+     * Useful for callers that need to know whether to query `valuePath.0` for existence
+     * vs just `valuePath` — empty arrays still pass `$exists: true` on the field itself.
+     * Returns false for unregistered blocks.
+     */
+    isArrayShaped(compType: string): boolean;
     /** Get all registered block descriptors. */
     getAll(): BlockDef[];
     /**
@@ -1657,4 +1715,4 @@ declare class BlockRegistry {
 /** Singleton instance — the one registry shared across the app. */
 declare const blockRegistry: BlockRegistry;
 
-export { BASE_BULLMQ_CONFIG, type BlockCapabilities, type BlockDef, BlockRegistry, CHUNKING_PRESETS, ELASTIC_MAPPING_PRESETS, FILTER_IDS, MONGO_SCHEMA_PRESETS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, blockRegistry, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genTagId, generateFilterKey, getFilterKeyForBlock, getPlatformContextContent, getRollupPossibilities, getRoutePathToContentTypeLanding, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToMyContent, getRoutePathToPublishedContent, getRoutePathToReviewDashboard, getRoutePathToTCI, getRoutePathToTagCategoryLanding, getVal, isTplAnnotationEnabled, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };
+export { BASE_BULLMQ_CONFIG, type BlockCapabilities, type BlockDef, BlockRegistry, CHUNKING_PRESETS, ELASTIC_MAPPING_PRESETS, FILTER_IDS, MONGO_SCHEMA_PRESETS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, blockRegistry, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genTagId, generateFilterKey, getFilterKeyForBlock, getPlatformContextContent, getRollupPossibilities, getRoutePathToContentTypeLanding, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToMyContent, getRoutePathToPublishedContent, getRoutePathToReviewDashboard, getRoutePathToTCI, getRoutePathToTagCategoryLanding, getVal, isTplAnnotationEnabled, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, plainTextToLexical, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/universal.d.ts

@@ -1418,6 +1418,15 @@ declare const UI_CONTENT: {
  */
 declare const genCleanCamelCaseId: (id: string) => string;
 
+/**
+ * Convert a plain text string into the standard Lexical value shape
+ * used across the platform: { allText, isLexical, editorState }.
+ *
+ * If the value is already Lexical (has `isLexical: true`), returns it as-is.
+ * Each line in the text becomes its own paragraph node.
+ */
+declare const plainTextToLexical: (value: string | number | any) => any;
+
 /**
  * BlockDef — single source of truth for a tplBlock's cross-cutting configuration.
  *
@@ -1429,6 +1438,18 @@ interface BlockDef {
     compName: string;
     category: 'text' | 'selection' | 'tags' | 'date' | 'number' | 'media' | 'structural' | 'special';
     qualQuant: 'qual' | 'quant' | null;
+    /**
+     * Optional gate that downgrades a block instance from its declared qualQuant unless
+     * ALL conditions match. Used for blocks whose qual-ness depends on a per-instance prop
+     * (e.g. AudioInput is only qual when `props.transcription.enable === true`).
+     *
+     * Each condition is a dotted path into `block.props` with a required value.
+     * No conditions / undefined → block's qualQuant applies unconditionally.
+     */
+    qualConditions?: Array<{
+        propPath: string;
+        equals: any;
+    }>;
     /** Mongoose schema type — the actual value returned to compToTypeMap (e.g. { type: Object }) */
     mongoSchemaType: Record<string, any>;
     /** Elasticsearch mapping shape — used directly by generateMappingsFromTpl */
@@ -1440,8 +1461,6 @@ interface BlockDef {
         plainTextString?: string | null;
         /** Path appended to valuePath for ES/listing search (e.g. 'allText'). null = valuePath used directly. */
         searchField?: string | null;
-        /** Path to get display value for table/card rendering (e.g. 'allText'). null = value itself. */
-        displayValue?: string | null;
     };
     validation: {
         /** Name of the "is populated" validator fn (resolved by consumer) */
@@ -1559,6 +1578,9 @@ declare const MONGO_SCHEMA_PRESETS: {
     readonly string: {
         readonly type: StringConstructor;
     };
+    readonly array: {
+        readonly type: ArrayConstructor;
+    };
 };
 declare const ELASTIC_MAPPING_PRESETS: {
     readonly largeText: {
@@ -1569,6 +1591,26 @@ declare const ELASTIC_MAPPING_PRESETS: {
             };
         };
     };
+    readonly audioTranscription: {
+        readonly properties: {
+            readonly transcription: {
+                readonly properties: {
+                    readonly result: {
+                        readonly properties: {
+                            readonly finalText: {
+                                readonly properties: {
+                                    readonly allText: {
+                                        readonly type: "text";
+                                        readonly analyzer: "LargeTextAnalyzer";
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
 };
 declare const CHUNKING_PRESETS: {
     readonly lexicalSemantic: {
@@ -1609,8 +1651,24 @@ declare class BlockRegistry {
     getQualBlocks(): string[];
     /** Get compType strings for all quant blocks. */
     getQuantBlocks(): string[];
+    /**
+     * Returns true if a specific block instance should be treated as qualitative.
+     * Combines the static `qualQuant` flag with any per-instance `qualConditions`
+     * — e.g. AudioInput is only qual when `props.transcription.enable === true`.
+     */
+    isQualBlock(block: {
+        comp: string;
+        props?: any;
+    }): boolean;
     /** Check if a specific block has a specific capability. */
     hasCapability(compType: string, capability: keyof BlockCapabilities): boolean;
+    /**
+     * Returns true if the block stores its value as an array (Mongo schema type is Array).
+     * Useful for callers that need to know whether to query `valuePath.0` for existence
+     * vs just `valuePath` — empty arrays still pass `$exists: true` on the field itself.
+     * Returns false for unregistered blocks.
+     */
+    isArrayShaped(compType: string): boolean;
     /** Get all registered block descriptors. */
     getAll(): BlockDef[];
     /**
@@ -1657,4 +1715,4 @@ declare class BlockRegistry {
 /** Singleton instance — the one registry shared across the app. */
 declare const blockRegistry: BlockRegistry;
 
-export { BASE_BULLMQ_CONFIG, type BlockCapabilities, type BlockDef, BlockRegistry, CHUNKING_PRESETS, ELASTIC_MAPPING_PRESETS, FILTER_IDS, MONGO_SCHEMA_PRESETS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, blockRegistry, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genTagId, generateFilterKey, getFilterKeyForBlock, getPlatformContextContent, getRollupPossibilities, getRoutePathToContentTypeLanding, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToMyContent, getRoutePathToPublishedContent, getRoutePathToReviewDashboard, getRoutePathToTCI, getRoutePathToTagCategoryLanding, getVal, isTplAnnotationEnabled, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };
+export { BASE_BULLMQ_CONFIG, type BlockCapabilities, type BlockDef, BlockRegistry, CHUNKING_PRESETS, ELASTIC_MAPPING_PRESETS, FILTER_IDS, MONGO_SCHEMA_PRESETS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, blockRegistry, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genTagId, generateFilterKey, getFilterKeyForBlock, getPlatformContextContent, getRollupPossibilities, getRoutePathToContentTypeLanding, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToMyContent, getRoutePathToPublishedContent, getRoutePathToReviewDashboard, getRoutePathToTCI, getRoutePathToTagCategoryLanding, getVal, isTplAnnotationEnabled, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, plainTextToLexical, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/universal.js

@@ -57,6 +57,7 @@ __export(universal_exports, {
   isTplAnnotationEnabled: () => isTplAnnotationEnabled,
   mergeAnnoDataIntoAnnotationsTags: () => mergeAnnoDataIntoAnnotationsTags,
   parseSpecialConfigSyntax: () => parseSpecialConfigSyntax,
+  plainTextToLexical: () => plainTextToLexical,
   processAuthorAndCommonFilters: () => processAuthorAndCommonFilters,
   recursivelyExtractBlocks: () => _recursExtractBlocks,
   segrigateDocs: () => segrigateDocs,
@@ -379,7 +380,8 @@ var _extractBlocksFromSomeBuilders = ({
 // src/blockRegistry/schemaPresets.ts
 var MONGO_SCHEMA_PRESETS = {
   object: { type: Object },
-  string: { type: String }
+  string: { type: String },
+  array: { type: Array }
 };
 var ELASTIC_MAPPING_PRESETS = {
   largeText: {
@@ -389,6 +391,29 @@ var ELASTIC_MAPPING_PRESETS = {
         analyzer: "LargeTextAnalyzer"
       }
     }
+  },
+  // Audio file value (array of one object) — only the transcription.result.finalText.allText
+  // is indexed as searchable text. finalText is stored in Lexical shape; allText is the
+  // plain text within it. Everything else on the audio object is ignored by ES.
+  audioTranscription: {
+    properties: {
+      transcription: {
+        properties: {
+          result: {
+            properties: {
+              finalText: {
+                properties: {
+                  allText: {
+                    type: "text",
+                    analyzer: "LargeTextAnalyzer"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
   }
 };
 var CHUNKING_PRESETS = {
@@ -430,8 +455,7 @@ var LexicalTextEditor = {
   // Field paths
   fieldPaths: {
     plainTextString: "allText",
-    searchField: "allText",
-    displayValue: "allText"
+    searchField: "allText"
   },
   // Validation
   validation: {
@@ -469,11 +493,72 @@ var LexicalTextEditor = {
   chunkingConfig: CHUNKING_PRESETS.lexicalSemantic
 };
 
+// src/blockRegistry/blocks/AudioInput.ts
+var AudioInput = {
+  compName: "AudioInput",
+  // Identity
+  category: "media",
+  qualQuant: "qual",
+  // Only qualitative when the tpl block has transcription turned on.
+  // A non-transcribed audio input has no text to analyze, so downstream
+  // qual widgets / search tools should skip it.
+  qualConditions: [
+    { propPath: "transcription.enable", equals: true }
+  ],
+  // Schema
+  mongoSchemaType: MONGO_SCHEMA_PRESETS.array,
+  esMapping: ELASTIC_MAPPING_PRESETS.audioTranscription,
+  // Capabilities
+  capabilities: {
+    // Text lives at transcription.result.finalText on the first (and only) audio item,
+    // derived by the Sarvam adapter into a single canonical field.
+    hasPlainText: true,
+    annotation: true,
+    aiAnnotation: true,
+    aiEnrichment: true,
+    searchable: true,
+    directDataImport: false,
+    csvExport: true,
+    // Translation already happens at the Sarvam level via translateToEnglish flag,
+    // so the autoTranslate pipeline doesn't need to touch this block.
+    translatable: false,
+    documentSummarizer: true,
+    // Transcription payloads can be large — strip from chunk/anno main snapshots
+    // and listing projections.
+    stripFromMainOnAnnoChunkSync: true,
+    excludeFromListingProjection: true
+  },
+  // Field paths
+  // `plainTextString` is the Mongo path consumed by getVal (supports the leading
+  // array index). `searchField` is the ES path — ES flattens arrays of objects
+  // so no index is needed there.
+  fieldPaths: {
+    plainTextString: "0.transcription.result.finalText.allText",
+    searchField: "transcription.result.finalText.allText"
+  },
+  // Validation
+  validation: {
+    populatedCheckFn: "valueArrayIsNotEmpty"
+  },
+  // CSV export — existing transformStructureComp switch routes AudioInput to
+  // formatMediaLinks (outputs audio URLs).
+  csvExport: {
+    transformFn: "formatMediaLinks"
+  },
+  // Chunking — finalText is long free-form speech, so semantic chunking applies.
+  chunkingConfig: CHUNKING_PRESETS.lexicalSemantic,
+  // Content block option — matches the current static entry exactly
+  contentBlockOption: {
+    display: "Audio Input"
+  }
+};
+
 // src/blockRegistry/registry.ts
 var BlockRegistry = class {
   constructor() {
     this.blocks = /* @__PURE__ */ new Map();
     this.register(LexicalTextEditor);
+    this.register(AudioInput);
   }
   /** Register a block descriptor. */
   register(descriptor) {
@@ -520,12 +605,36 @@ var BlockRegistry = class {
   getQuantBlocks() {
     return Array.from(this.blocks.values()).filter((b) => b.qualQuant === "quant").map((b) => b.compName);
   }
+  /**
+   * Returns true if a specific block instance should be treated as qualitative.
+   * Combines the static `qualQuant` flag with any per-instance `qualConditions`
+   * — e.g. AudioInput is only qual when `props.transcription.enable === true`.
+   */
+  isQualBlock(block) {
+    const def = this.blocks.get(block.comp);
+    if (!def || def.qualQuant !== "qual") return false;
+    if (!def.qualConditions?.length) return true;
+    return def.qualConditions.every((cond) => {
+      const value = cond.propPath.split(".").reduce((obj, key) => obj?.[key], block.props);
+      return value === cond.equals;
+    });
+  }
   /** Check if a specific block has a specific capability. */
   hasCapability(compType, capability) {
     const block = this.blocks.get(compType);
     if (!block) return false;
     return !!block.capabilities[capability];
   }
+  /**
+   * Returns true if the block stores its value as an array (Mongo schema type is Array).
+   * Useful for callers that need to know whether to query `valuePath.0` for existence
+   * vs just `valuePath` — empty arrays still pass `$exists: true` on the field itself.
+   * Returns false for unregistered blocks.
+   */
+  isArrayShaped(compType) {
+    const def = this.blocks.get(compType);
+    return def?.mongoSchemaType?.type === Array;
+  }
   /** Get all registered block descriptors. */
   getAll() {
     return Array.from(this.blocks.values());
@@ -2466,6 +2575,38 @@ var genCleanCamelCaseId = (id) => {
   if (/^\d/.test(result)) result = "a" + result;
   return result.slice(0, MAX_LENGTH);
 };
+
+// src/utils/plainTextToLexical.ts
+var plainTextToLexical = (value) => {
+  if (!value && value !== 0) return void 0;
+  if (value?.isLexical === true) return value;
+  if (typeof value !== "string" && typeof value !== "number") return void 0;
+  const text = String(value);
+  const lines = text.split(/\r?\n/);
+  const paragraphNodes = lines.map((line) => ({
+    type: "paragraph",
+    children: [
+      {
+        type: "text",
+        text: line
+      }
+    ]
+  }));
+  return {
+    allText: text,
+    isLexical: true,
+    editorState: {
+      root: {
+        children: paragraphNodes,
+        direction: "ltr",
+        format: "",
+        indent: 0,
+        type: "root",
+        version: 1
+      }
+    }
+  };
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BASE_BULLMQ_CONFIG,
@@ -2505,6 +2646,7 @@ var genCleanCamelCaseId = (id) => {
   isTplAnnotationEnabled,
   mergeAnnoDataIntoAnnotationsTags,
   parseSpecialConfigSyntax,
+  plainTextToLexical,
   processAuthorAndCommonFilters,
   recursivelyExtractBlocks,
   segrigateDocs,

package/dist/universal.mjs

@@ -312,7 +312,8 @@ var _extractBlocksFromSomeBuilders = ({
 // src/blockRegistry/schemaPresets.ts
 var MONGO_SCHEMA_PRESETS = {
   object: { type: Object },
-  string: { type: String }
+  string: { type: String },
+  array: { type: Array }
 };
 var ELASTIC_MAPPING_PRESETS = {
   largeText: {
@@ -322,6 +323,29 @@ var ELASTIC_MAPPING_PRESETS = {
         analyzer: "LargeTextAnalyzer"
       }
     }
+  },
+  // Audio file value (array of one object) — only the transcription.result.finalText.allText
+  // is indexed as searchable text. finalText is stored in Lexical shape; allText is the
+  // plain text within it. Everything else on the audio object is ignored by ES.
+  audioTranscription: {
+    properties: {
+      transcription: {
+        properties: {
+          result: {
+            properties: {
+              finalText: {
+                properties: {
+                  allText: {
+                    type: "text",
+                    analyzer: "LargeTextAnalyzer"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
   }
 };
 var CHUNKING_PRESETS = {
@@ -363,8 +387,7 @@ var LexicalTextEditor = {
   // Field paths
   fieldPaths: {
     plainTextString: "allText",
-    searchField: "allText",
-    displayValue: "allText"
+    searchField: "allText"
   },
   // Validation
   validation: {
@@ -402,11 +425,72 @@ var LexicalTextEditor = {
   chunkingConfig: CHUNKING_PRESETS.lexicalSemantic
 };
 
+// src/blockRegistry/blocks/AudioInput.ts
+var AudioInput = {
+  compName: "AudioInput",
+  // Identity
+  category: "media",
+  qualQuant: "qual",
+  // Only qualitative when the tpl block has transcription turned on.
+  // A non-transcribed audio input has no text to analyze, so downstream
+  // qual widgets / search tools should skip it.
+  qualConditions: [
+    { propPath: "transcription.enable", equals: true }
+  ],
+  // Schema
+  mongoSchemaType: MONGO_SCHEMA_PRESETS.array,
+  esMapping: ELASTIC_MAPPING_PRESETS.audioTranscription,
+  // Capabilities
+  capabilities: {
+    // Text lives at transcription.result.finalText on the first (and only) audio item,
+    // derived by the Sarvam adapter into a single canonical field.
+    hasPlainText: true,
+    annotation: true,
+    aiAnnotation: true,
+    aiEnrichment: true,
+    searchable: true,
+    directDataImport: false,
+    csvExport: true,
+    // Translation already happens at the Sarvam level via translateToEnglish flag,
+    // so the autoTranslate pipeline doesn't need to touch this block.
+    translatable: false,
+    documentSummarizer: true,
+    // Transcription payloads can be large — strip from chunk/anno main snapshots
+    // and listing projections.
+    stripFromMainOnAnnoChunkSync: true,
+    excludeFromListingProjection: true
+  },
+  // Field paths
+  // `plainTextString` is the Mongo path consumed by getVal (supports the leading
+  // array index). `searchField` is the ES path — ES flattens arrays of objects
+  // so no index is needed there.
+  fieldPaths: {
+    plainTextString: "0.transcription.result.finalText.allText",
+    searchField: "transcription.result.finalText.allText"
+  },
+  // Validation
+  validation: {
+    populatedCheckFn: "valueArrayIsNotEmpty"
+  },
+  // CSV export — existing transformStructureComp switch routes AudioInput to
+  // formatMediaLinks (outputs audio URLs).
+  csvExport: {
+    transformFn: "formatMediaLinks"
+  },
+  // Chunking — finalText is long free-form speech, so semantic chunking applies.
+  chunkingConfig: CHUNKING_PRESETS.lexicalSemantic,
+  // Content block option — matches the current static entry exactly
+  contentBlockOption: {
+    display: "Audio Input"
+  }
+};
+
 // src/blockRegistry/registry.ts
 var BlockRegistry = class {
   constructor() {
     this.blocks = /* @__PURE__ */ new Map();
     this.register(LexicalTextEditor);
+    this.register(AudioInput);
   }
   /** Register a block descriptor. */
   register(descriptor) {
@@ -453,12 +537,36 @@ var BlockRegistry = class {
   getQuantBlocks() {
     return Array.from(this.blocks.values()).filter((b) => b.qualQuant === "quant").map((b) => b.compName);
   }
+  /**
+   * Returns true if a specific block instance should be treated as qualitative.
+   * Combines the static `qualQuant` flag with any per-instance `qualConditions`
+   * — e.g. AudioInput is only qual when `props.transcription.enable === true`.
+   */
+  isQualBlock(block) {
+    const def = this.blocks.get(block.comp);
+    if (!def || def.qualQuant !== "qual") return false;
+    if (!def.qualConditions?.length) return true;
+    return def.qualConditions.every((cond) => {
+      const value = cond.propPath.split(".").reduce((obj, key) => obj?.[key], block.props);
+      return value === cond.equals;
+    });
+  }
   /** Check if a specific block has a specific capability. */
   hasCapability(compType, capability) {
     const block = this.blocks.get(compType);
     if (!block) return false;
     return !!block.capabilities[capability];
   }
+  /**
+   * Returns true if the block stores its value as an array (Mongo schema type is Array).
+   * Useful for callers that need to know whether to query `valuePath.0` for existence
+   * vs just `valuePath` — empty arrays still pass `$exists: true` on the field itself.
+   * Returns false for unregistered blocks.
+   */
+  isArrayShaped(compType) {
+    const def = this.blocks.get(compType);
+    return def?.mongoSchemaType?.type === Array;
+  }
   /** Get all registered block descriptors. */
   getAll() {
     return Array.from(this.blocks.values());
@@ -2399,6 +2507,38 @@ var genCleanCamelCaseId = (id) => {
   if (/^\d/.test(result)) result = "a" + result;
   return result.slice(0, MAX_LENGTH);
 };
+
+// src/utils/plainTextToLexical.ts
+var plainTextToLexical = (value) => {
+  if (!value && value !== 0) return void 0;
+  if (value?.isLexical === true) return value;
+  if (typeof value !== "string" && typeof value !== "number") return void 0;
+  const text = String(value);
+  const lines = text.split(/\r?\n/);
+  const paragraphNodes = lines.map((line) => ({
+    type: "paragraph",
+    children: [
+      {
+        type: "text",
+        text: line
+      }
+    ]
+  }));
+  return {
+    allText: text,
+    isLexical: true,
+    editorState: {
+      root: {
+        children: paragraphNodes,
+        direction: "ltr",
+        format: "",
+        indent: 0,
+        type: "root",
+        version: 1
+      }
+    }
+  };
+};
 export {
   BASE_BULLMQ_CONFIG,
   BlockRegistry,
@@ -2437,6 +2577,7 @@ export {
   isTplAnnotationEnabled,
   mergeAnnoDataIntoAnnotationsTags,
   parseSpecialConfigSyntax,
+  plainTextToLexical,
   processAuthorAndCommonFilters,
   _recursExtractBlocks as recursivelyExtractBlocks,
   segrigateDocs,

package/package.json

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