@okf/ootils 1.32.6 → 1.32.7

package/dist/browser.d.mts

@@ -1308,6 +1308,35 @@ declare const getFilterKeyForBlock: ({ block, scope }?: {
     scope?: string;
 }) => string | undefined;
 
+type AnnoFilterLevel = "themes" | "subThemes" | "tags";
+interface AnnoValueLike {
+    parentThemeId?: string | null;
+    parentSubThemeId?: string | null;
+}
+/**
+ * Why annoFilterBucketKey exists
+ * ------------------------------
+ * In sub-themes/tags annotation filters, one activeFilter holds values that
+ * span multiple ancestor groups (e.g. tags under different themes/sub-themes).
+ * Each ancestor group is rendered as its own sidebar block. Without per-bucket
+ * state, a single shared `intraFilterOperator` makes Match Any/All toggles
+ * trickle across blocks and AND/OR every value across every group together.
+ *
+ * The bucketKey identifies which ancestor group a value belongs to. Sub-themes
+ * and tags activeFilters carry `intraFilterOperator` as a map keyed by
+ * bucketKey, so each block has its own independent operator. The frontend
+ * grouping uses this for visual blocks; the backend uses it to build the
+ * per-bucket Mongo query.
+ *
+ * Themes are exempt — there's only one themes block per activeFilter, so they
+ * keep the simpler string `intraFilterOperator` (matching doc-filter behaviour).
+ *
+ * Pass the anno-hierarchy level name ("themes" / "subThemes" / "tags"). On the
+ * frontend this comes from LEVEL_META.level on each block. On the backend this
+ * is target.tagType / the leaf of rollupPath. Both carry it as that literal.
+ */
+declare const getAnnoFilterBucketKey: (level: AnnoFilterLevel | string, value?: AnnoValueLike) => string | null;
+
 /**
  * Automatically generates filter configurations from template structures.
  *
@@ -1802,4 +1831,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, plainTextToLexical, 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, getAnnoFilterBucketKey, 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/browser.d.ts

@@ -1308,6 +1308,35 @@ declare const getFilterKeyForBlock: ({ block, scope }?: {
     scope?: string;
 }) => string | undefined;
 
+type AnnoFilterLevel = "themes" | "subThemes" | "tags";
+interface AnnoValueLike {
+    parentThemeId?: string | null;
+    parentSubThemeId?: string | null;
+}
+/**
+ * Why annoFilterBucketKey exists
+ * ------------------------------
+ * In sub-themes/tags annotation filters, one activeFilter holds values that
+ * span multiple ancestor groups (e.g. tags under different themes/sub-themes).
+ * Each ancestor group is rendered as its own sidebar block. Without per-bucket
+ * state, a single shared `intraFilterOperator` makes Match Any/All toggles
+ * trickle across blocks and AND/OR every value across every group together.
+ *
+ * The bucketKey identifies which ancestor group a value belongs to. Sub-themes
+ * and tags activeFilters carry `intraFilterOperator` as a map keyed by
+ * bucketKey, so each block has its own independent operator. The frontend
+ * grouping uses this for visual blocks; the backend uses it to build the
+ * per-bucket Mongo query.
+ *
+ * Themes are exempt — there's only one themes block per activeFilter, so they
+ * keep the simpler string `intraFilterOperator` (matching doc-filter behaviour).
+ *
+ * Pass the anno-hierarchy level name ("themes" / "subThemes" / "tags"). On the
+ * frontend this comes from LEVEL_META.level on each block. On the backend this
+ * is target.tagType / the leaf of rollupPath. Both carry it as that literal.
+ */
+declare const getAnnoFilterBucketKey: (level: AnnoFilterLevel | string, value?: AnnoValueLike) => string | null;
+
 /**
  * Automatically generates filter configurations from template structures.
  *
@@ -1802,4 +1831,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, plainTextToLexical, 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, getAnnoFilterBucketKey, 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/browser.js

@@ -42,6 +42,7 @@ __export(browser_exports, {
   genCleanCamelCaseId: () => genCleanCamelCaseId,
   genTagId: () => genTagId,
   generateFilterKey: () => generateFilterKey,
+  getAnnoFilterBucketKey: () => getAnnoFilterBucketKey,
   getFilterKeyForBlock: () => getFilterKeyForBlock,
   getPlatformContextContent: () => getPlatformContextContent,
   getRollupPossibilities: () => getRollupPossibilities,
@@ -2503,6 +2504,15 @@ var getFilterKeyForBlock = ({ block, scope = "tags" } = {}) => {
   return void 0;
 };
 
+// src/utils/autoGenFilterConfigsFromTpl/utils/getAnnoFilterBucketKey.ts
+var getAnnoFilterBucketKey = (level, value = {}) => {
+  if (level === "subThemes") return value.parentThemeId || "__independent__";
+  if (level === "tags") {
+    return `${value.parentThemeId || "_"}::${value.parentSubThemeId || "_"}`;
+  }
+  return null;
+};
+
 // src/utils/autoGenFilterConfigsFromTpl/index.ts
 var autoGenFilterConfigsFromTpl = ({
   selectedTpls,
@@ -2689,6 +2699,7 @@ var plainTextToLexical = (value) => {
   genCleanCamelCaseId,
   genTagId,
   generateFilterKey,
+  getAnnoFilterBucketKey,
   getFilterKeyForBlock,
   getPlatformContextContent,
   getRollupPossibilities,

package/dist/browser.mjs

@@ -2435,6 +2435,15 @@ var getFilterKeyForBlock = ({ block, scope = "tags" } = {}) => {
   return void 0;
 };
 
+// src/utils/autoGenFilterConfigsFromTpl/utils/getAnnoFilterBucketKey.ts
+var getAnnoFilterBucketKey = (level, value = {}) => {
+  if (level === "subThemes") return value.parentThemeId || "__independent__";
+  if (level === "tags") {
+    return `${value.parentThemeId || "_"}::${value.parentSubThemeId || "_"}`;
+  }
+  return null;
+};
+
 // src/utils/autoGenFilterConfigsFromTpl/index.ts
 var autoGenFilterConfigsFromTpl = ({
   selectedTpls,
@@ -2620,6 +2629,7 @@ export {
   genCleanCamelCaseId,
   genTagId,
   generateFilterKey,
+  getAnnoFilterBucketKey,
   getFilterKeyForBlock,
   getPlatformContextContent,
   getRollupPossibilities,

package/dist/node.d.mts

@@ -1315,6 +1315,35 @@ declare const getFilterKeyForBlock: ({ block, scope }?: {
     scope?: string;
 }) => string | undefined;
 
+type AnnoFilterLevel = "themes" | "subThemes" | "tags";
+interface AnnoValueLike {
+    parentThemeId?: string | null;
+    parentSubThemeId?: string | null;
+}
+/**
+ * Why annoFilterBucketKey exists
+ * ------------------------------
+ * In sub-themes/tags annotation filters, one activeFilter holds values that
+ * span multiple ancestor groups (e.g. tags under different themes/sub-themes).
+ * Each ancestor group is rendered as its own sidebar block. Without per-bucket
+ * state, a single shared `intraFilterOperator` makes Match Any/All toggles
+ * trickle across blocks and AND/OR every value across every group together.
+ *
+ * The bucketKey identifies which ancestor group a value belongs to. Sub-themes
+ * and tags activeFilters carry `intraFilterOperator` as a map keyed by
+ * bucketKey, so each block has its own independent operator. The frontend
+ * grouping uses this for visual blocks; the backend uses it to build the
+ * per-bucket Mongo query.
+ *
+ * Themes are exempt — there's only one themes block per activeFilter, so they
+ * keep the simpler string `intraFilterOperator` (matching doc-filter behaviour).
+ *
+ * Pass the anno-hierarchy level name ("themes" / "subThemes" / "tags"). On the
+ * frontend this comes from LEVEL_META.level on each block. On the backend this
+ * is target.tagType / the leaf of rollupPath. Both carry it as that literal.
+ */
+declare const getAnnoFilterBucketKey: (level: AnnoFilterLevel | string, value?: AnnoValueLike) => string | null;
+
 /**
  * Automatically generates filter configurations from template structures.
  *
@@ -2543,4 +2572,4 @@ declare function GET_GLOBAL_BULLMQ_CONFIG({ env, redisCredentials }: {
     };
 }): Object;
 
-export { AIChatSchema, AnnosElasticSyncProducer, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, type BlockCapabilities, type BlockDef, BlockRegistry, CHUNKING_PRESETS, ChunksElasticSyncProducer, ELASTIC_MAPPING_PRESETS, ElasticSearchConnector, FILTER_IDS, GET_GLOBAL_BULLMQ_CONFIG, GeneratedEntitiesSchema, GeneratedTopicsSchema, MONGO_SCHEMA_PRESETS, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, SecretManagerConnector, TEMP_removeDuplicateFilters, TplSchema, UI_CONTENT, WorkerManager, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, blockRegistry, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genTagId, generateFilterKey, getAIChatModelByTenant, getAnnotationsModelByTenant, getDbByTenant, getFilterKeyForBlock, getGeneratedEntitiesModelByTenant, getGeneratedTopicsModelByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getRollupPossibilities, getRoutePathToContentTypeLanding, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToMyContent, getRoutePathToPublishedContent, getRoutePathToReviewDashboard, getRoutePathToTCI, getRoutePathToTagCategoryLanding, getTplModelByTenant, getVal, isTplAnnotationEnabled, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, plainTextToLexical, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };
+export { AIChatSchema, AnnosElasticSyncProducer, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, type BlockCapabilities, type BlockDef, BlockRegistry, CHUNKING_PRESETS, ChunksElasticSyncProducer, ELASTIC_MAPPING_PRESETS, ElasticSearchConnector, FILTER_IDS, GET_GLOBAL_BULLMQ_CONFIG, GeneratedEntitiesSchema, GeneratedTopicsSchema, MONGO_SCHEMA_PRESETS, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, SecretManagerConnector, TEMP_removeDuplicateFilters, TplSchema, UI_CONTENT, WorkerManager, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, blockRegistry, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genTagId, generateFilterKey, getAIChatModelByTenant, getAnnoFilterBucketKey, getAnnotationsModelByTenant, getDbByTenant, getFilterKeyForBlock, getGeneratedEntitiesModelByTenant, getGeneratedTopicsModelByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getRollupPossibilities, getRoutePathToContentTypeLanding, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToMyContent, getRoutePathToPublishedContent, getRoutePathToReviewDashboard, getRoutePathToTCI, getRoutePathToTagCategoryLanding, getTplModelByTenant, getVal, isTplAnnotationEnabled, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, plainTextToLexical, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/node.d.ts

@@ -1315,6 +1315,35 @@ declare const getFilterKeyForBlock: ({ block, scope }?: {
     scope?: string;
 }) => string | undefined;
 
+type AnnoFilterLevel = "themes" | "subThemes" | "tags";
+interface AnnoValueLike {
+    parentThemeId?: string | null;
+    parentSubThemeId?: string | null;
+}
+/**
+ * Why annoFilterBucketKey exists
+ * ------------------------------
+ * In sub-themes/tags annotation filters, one activeFilter holds values that
+ * span multiple ancestor groups (e.g. tags under different themes/sub-themes).
+ * Each ancestor group is rendered as its own sidebar block. Without per-bucket
+ * state, a single shared `intraFilterOperator` makes Match Any/All toggles
+ * trickle across blocks and AND/OR every value across every group together.
+ *
+ * The bucketKey identifies which ancestor group a value belongs to. Sub-themes
+ * and tags activeFilters carry `intraFilterOperator` as a map keyed by
+ * bucketKey, so each block has its own independent operator. The frontend
+ * grouping uses this for visual blocks; the backend uses it to build the
+ * per-bucket Mongo query.
+ *
+ * Themes are exempt — there's only one themes block per activeFilter, so they
+ * keep the simpler string `intraFilterOperator` (matching doc-filter behaviour).
+ *
+ * Pass the anno-hierarchy level name ("themes" / "subThemes" / "tags"). On the
+ * frontend this comes from LEVEL_META.level on each block. On the backend this
+ * is target.tagType / the leaf of rollupPath. Both carry it as that literal.
+ */
+declare const getAnnoFilterBucketKey: (level: AnnoFilterLevel | string, value?: AnnoValueLike) => string | null;
+
 /**
  * Automatically generates filter configurations from template structures.
  *
@@ -2543,4 +2572,4 @@ declare function GET_GLOBAL_BULLMQ_CONFIG({ env, redisCredentials }: {
     };
 }): Object;
 
-export { AIChatSchema, AnnosElasticSyncProducer, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, type BlockCapabilities, type BlockDef, BlockRegistry, CHUNKING_PRESETS, ChunksElasticSyncProducer, ELASTIC_MAPPING_PRESETS, ElasticSearchConnector, FILTER_IDS, GET_GLOBAL_BULLMQ_CONFIG, GeneratedEntitiesSchema, GeneratedTopicsSchema, MONGO_SCHEMA_PRESETS, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, SecretManagerConnector, TEMP_removeDuplicateFilters, TplSchema, UI_CONTENT, WorkerManager, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, blockRegistry, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genTagId, generateFilterKey, getAIChatModelByTenant, getAnnotationsModelByTenant, getDbByTenant, getFilterKeyForBlock, getGeneratedEntitiesModelByTenant, getGeneratedTopicsModelByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getRollupPossibilities, getRoutePathToContentTypeLanding, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToMyContent, getRoutePathToPublishedContent, getRoutePathToReviewDashboard, getRoutePathToTCI, getRoutePathToTagCategoryLanding, getTplModelByTenant, getVal, isTplAnnotationEnabled, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, plainTextToLexical, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };
+export { AIChatSchema, AnnosElasticSyncProducer, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, type BlockCapabilities, type BlockDef, BlockRegistry, CHUNKING_PRESETS, ChunksElasticSyncProducer, ELASTIC_MAPPING_PRESETS, ElasticSearchConnector, FILTER_IDS, GET_GLOBAL_BULLMQ_CONFIG, GeneratedEntitiesSchema, GeneratedTopicsSchema, MONGO_SCHEMA_PRESETS, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, SecretManagerConnector, TEMP_removeDuplicateFilters, TplSchema, UI_CONTENT, WorkerManager, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, blockRegistry, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genTagId, generateFilterKey, getAIChatModelByTenant, getAnnoFilterBucketKey, getAnnotationsModelByTenant, getDbByTenant, getFilterKeyForBlock, getGeneratedEntitiesModelByTenant, getGeneratedTopicsModelByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getRollupPossibilities, getRoutePathToContentTypeLanding, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToMyContent, getRoutePathToPublishedContent, getRoutePathToReviewDashboard, getRoutePathToTCI, getRoutePathToTagCategoryLanding, getTplModelByTenant, getVal, isTplAnnotationEnabled, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, plainTextToLexical, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/node.js

@@ -2069,6 +2069,7 @@ __export(node_exports, {
   genTagId: () => genTagId,
   generateFilterKey: () => generateFilterKey,
   getAIChatModelByTenant: () => import_getModelByTenant2.getAIChatModelByTenant,
+  getAnnoFilterBucketKey: () => getAnnoFilterBucketKey,
   getAnnotationsModelByTenant: () => import_getModelByTenant2.getAnnotationsModelByTenant,
   getDbByTenant: () => getDbByTenant,
   getFilterKeyForBlock: () => getFilterKeyForBlock,
@@ -4101,6 +4102,15 @@ var getFilterKeyForBlock = ({ block, scope = "tags" } = {}) => {
   return void 0;
 };
 
+// src/utils/autoGenFilterConfigsFromTpl/utils/getAnnoFilterBucketKey.ts
+var getAnnoFilterBucketKey = (level, value = {}) => {
+  if (level === "subThemes") return value.parentThemeId || "__independent__";
+  if (level === "tags") {
+    return `${value.parentThemeId || "_"}::${value.parentSubThemeId || "_"}`;
+  }
+  return null;
+};
+
 // src/utils/autoGenFilterConfigsFromTpl/index.ts
 var autoGenFilterConfigsFromTpl = ({
   selectedTpls,
@@ -4689,6 +4699,7 @@ var import_GET_GLOBAL_BULLMQ_CONFIG = __toESM(require_GET_GLOBAL_BULLMQ_CONFIG()
   genTagId,
   generateFilterKey,
   getAIChatModelByTenant,
+  getAnnoFilterBucketKey,
   getAnnotationsModelByTenant,
   getDbByTenant,
   getFilterKeyForBlock,

package/dist/node.mjs

@@ -4032,6 +4032,15 @@ var getFilterKeyForBlock = ({ block, scope = "tags" } = {}) => {
   return void 0;
 };
 
+// src/utils/autoGenFilterConfigsFromTpl/utils/getAnnoFilterBucketKey.ts
+var getAnnoFilterBucketKey = (level, value = {}) => {
+  if (level === "subThemes") return value.parentThemeId || "__independent__";
+  if (level === "tags") {
+    return `${value.parentThemeId || "_"}::${value.parentSubThemeId || "_"}`;
+  }
+  return null;
+};
+
 // src/utils/autoGenFilterConfigsFromTpl/index.ts
 var autoGenFilterConfigsFromTpl = ({
   selectedTpls,
@@ -4635,6 +4644,7 @@ export {
   genTagId,
   generateFilterKey,
   export_getAIChatModelByTenant as getAIChatModelByTenant,
+  getAnnoFilterBucketKey,
   export_getAnnotationsModelByTenant as getAnnotationsModelByTenant,
   getDbByTenant,
   getFilterKeyForBlock,

package/dist/universal.d.mts

@@ -1308,6 +1308,35 @@ declare const getFilterKeyForBlock: ({ block, scope }?: {
     scope?: string;
 }) => string | undefined;
 
+type AnnoFilterLevel = "themes" | "subThemes" | "tags";
+interface AnnoValueLike {
+    parentThemeId?: string | null;
+    parentSubThemeId?: string | null;
+}
+/**
+ * Why annoFilterBucketKey exists
+ * ------------------------------
+ * In sub-themes/tags annotation filters, one activeFilter holds values that
+ * span multiple ancestor groups (e.g. tags under different themes/sub-themes).
+ * Each ancestor group is rendered as its own sidebar block. Without per-bucket
+ * state, a single shared `intraFilterOperator` makes Match Any/All toggles
+ * trickle across blocks and AND/OR every value across every group together.
+ *
+ * The bucketKey identifies which ancestor group a value belongs to. Sub-themes
+ * and tags activeFilters carry `intraFilterOperator` as a map keyed by
+ * bucketKey, so each block has its own independent operator. The frontend
+ * grouping uses this for visual blocks; the backend uses it to build the
+ * per-bucket Mongo query.
+ *
+ * Themes are exempt — there's only one themes block per activeFilter, so they
+ * keep the simpler string `intraFilterOperator` (matching doc-filter behaviour).
+ *
+ * Pass the anno-hierarchy level name ("themes" / "subThemes" / "tags"). On the
+ * frontend this comes from LEVEL_META.level on each block. On the backend this
+ * is target.tagType / the leaf of rollupPath. Both carry it as that literal.
+ */
+declare const getAnnoFilterBucketKey: (level: AnnoFilterLevel | string, value?: AnnoValueLike) => string | null;
+
 /**
  * Automatically generates filter configurations from template structures.
  *
@@ -1802,4 +1831,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, plainTextToLexical, 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, getAnnoFilterBucketKey, 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

@@ -1308,6 +1308,35 @@ declare const getFilterKeyForBlock: ({ block, scope }?: {
     scope?: string;
 }) => string | undefined;
 
+type AnnoFilterLevel = "themes" | "subThemes" | "tags";
+interface AnnoValueLike {
+    parentThemeId?: string | null;
+    parentSubThemeId?: string | null;
+}
+/**
+ * Why annoFilterBucketKey exists
+ * ------------------------------
+ * In sub-themes/tags annotation filters, one activeFilter holds values that
+ * span multiple ancestor groups (e.g. tags under different themes/sub-themes).
+ * Each ancestor group is rendered as its own sidebar block. Without per-bucket
+ * state, a single shared `intraFilterOperator` makes Match Any/All toggles
+ * trickle across blocks and AND/OR every value across every group together.
+ *
+ * The bucketKey identifies which ancestor group a value belongs to. Sub-themes
+ * and tags activeFilters carry `intraFilterOperator` as a map keyed by
+ * bucketKey, so each block has its own independent operator. The frontend
+ * grouping uses this for visual blocks; the backend uses it to build the
+ * per-bucket Mongo query.
+ *
+ * Themes are exempt — there's only one themes block per activeFilter, so they
+ * keep the simpler string `intraFilterOperator` (matching doc-filter behaviour).
+ *
+ * Pass the anno-hierarchy level name ("themes" / "subThemes" / "tags"). On the
+ * frontend this comes from LEVEL_META.level on each block. On the backend this
+ * is target.tagType / the leaf of rollupPath. Both carry it as that literal.
+ */
+declare const getAnnoFilterBucketKey: (level: AnnoFilterLevel | string, value?: AnnoValueLike) => string | null;
+
 /**
  * Automatically generates filter configurations from template structures.
  *
@@ -1802,4 +1831,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, plainTextToLexical, 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, getAnnoFilterBucketKey, 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

@@ -42,6 +42,7 @@ __export(universal_exports, {
   genCleanCamelCaseId: () => genCleanCamelCaseId,
   genTagId: () => genTagId,
   generateFilterKey: () => generateFilterKey,
+  getAnnoFilterBucketKey: () => getAnnoFilterBucketKey,
   getFilterKeyForBlock: () => getFilterKeyForBlock,
   getPlatformContextContent: () => getPlatformContextContent,
   getRollupPossibilities: () => getRollupPossibilities,
@@ -2503,6 +2504,15 @@ var getFilterKeyForBlock = ({ block, scope = "tags" } = {}) => {
   return void 0;
 };
 
+// src/utils/autoGenFilterConfigsFromTpl/utils/getAnnoFilterBucketKey.ts
+var getAnnoFilterBucketKey = (level, value = {}) => {
+  if (level === "subThemes") return value.parentThemeId || "__independent__";
+  if (level === "tags") {
+    return `${value.parentThemeId || "_"}::${value.parentSubThemeId || "_"}`;
+  }
+  return null;
+};
+
 // src/utils/autoGenFilterConfigsFromTpl/index.ts
 var autoGenFilterConfigsFromTpl = ({
   selectedTpls,
@@ -2689,6 +2699,7 @@ var plainTextToLexical = (value) => {
   genCleanCamelCaseId,
   genTagId,
   generateFilterKey,
+  getAnnoFilterBucketKey,
   getFilterKeyForBlock,
   getPlatformContextContent,
   getRollupPossibilities,

package/dist/universal.mjs

@@ -2435,6 +2435,15 @@ var getFilterKeyForBlock = ({ block, scope = "tags" } = {}) => {
   return void 0;
 };
 
+// src/utils/autoGenFilterConfigsFromTpl/utils/getAnnoFilterBucketKey.ts
+var getAnnoFilterBucketKey = (level, value = {}) => {
+  if (level === "subThemes") return value.parentThemeId || "__independent__";
+  if (level === "tags") {
+    return `${value.parentThemeId || "_"}::${value.parentSubThemeId || "_"}`;
+  }
+  return null;
+};
+
 // src/utils/autoGenFilterConfigsFromTpl/index.ts
 var autoGenFilterConfigsFromTpl = ({
   selectedTpls,
@@ -2620,6 +2629,7 @@ export {
   genCleanCamelCaseId,
   genTagId,
   generateFilterKey,
+  getAnnoFilterBucketKey,
   getFilterKeyForBlock,
   getPlatformContextContent,
   getRollupPossibilities,

package/package.json

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