@okf/ootils 1.40.0 → 1.41.1

package/dist/browser.d.mts

@@ -285,9 +285,10 @@ declare const collectMarkIdsInOrder: (editorState: any) => string[];
  *   }
  * ]
  */
-declare function getRollupPossibilities({ tagType, allTpls }: {
+declare function getRollupPossibilities({ tagType, allTpls, includeSelfHead, }: {
     tagType: string;
     allTpls: any[];
+    includeSelfHead?: boolean;
 }): any[];
 
 declare namespace BASE_BULLMQ_CONFIG {
@@ -1241,6 +1242,27 @@ declare const processAuthorAndCommonFilters: (allTpls: any[], filterScopes: stri
 
 declare const _self_managed_getFixedAnnoTagBlock: (selectedTpls: any[], annotationTagsCount: any) => any[];
 
+/**
+ * FOLLOWUP (consolidate the count->rollupPath rule into one source of truth):
+ *
+ * The rule "given annotationTagsCount, which self-managed anno rollupPaths exist"
+ * (subThemes>0 -> ['tags','subThemes']; subThemes>0 && themes>0 -> ['tags','subThemes','themes'])
+ * is currently duplicated in THREE places and will drift:
+ *   1. here (_self_managed_getFixedAnnoRollupBlocks)            -> filter blocks
+ *   2. _self_managed_buildAnnoHierarchyConfig                   -> anno hierarchy filter UI
+ *   3. okf-fe _extractAllAnnoBasedDimensionsAsOptions.js        -> reports dimension dropdown
+ *
+ * (#3 was added to fix a crash: the reports widget previously discovered these rollups
+ *  from publishing-segment tpls via getRollupPossibilities, but self-managed taxonomy lives
+ *  on `collections`-segment tpls which isTplAnnotationEnabled excludes -> empty list ->
+ *  unguarded .find('subThemes') returned undefined -> crash. The FE now builds them from the
+ *  count, mirroring this function.)
+ *
+ * Extract a pure helper here in ootils:
+ *   export const getSelfManagedAnnoRollupPaths = (annotationTagsCount): string[][] => [...]
+ * then have all three call sites consume it (each maps paths -> its own shape:
+ * filter-blocks / hierarchy levels / dropdown options). One rule, three presentations.
+ */
 declare const _self_managed_getFixedAnnoRollupBlocks: ({ selectedTpls, allTpls, annotationTagsCount }: {
     selectedTpls: any[];
     allTpls: any[];
@@ -1342,6 +1364,7 @@ declare const _self_managed_buildDocHierarchyConfig: ({ combinedDocumentBlocks,
             display: any;
             filters: any[];
             rollups: any[];
+            rollupDisplayMap: Record<string, string>;
         }[];
     };
     target: {
@@ -1501,6 +1524,7 @@ declare const autoGenFilterConfigsFromTpl: ({ selectedTpls, allTpls, filterScope
                     display: any;
                     filters: any[];
                     rollups: any[];
+                    rollupDisplayMap: Record<string, string>;
                 }[];
             };
             target: {

package/dist/browser.d.ts

@@ -285,9 +285,10 @@ declare const collectMarkIdsInOrder: (editorState: any) => string[];
  *   }
  * ]
  */
-declare function getRollupPossibilities({ tagType, allTpls }: {
+declare function getRollupPossibilities({ tagType, allTpls, includeSelfHead, }: {
     tagType: string;
     allTpls: any[];
+    includeSelfHead?: boolean;
 }): any[];
 
 declare namespace BASE_BULLMQ_CONFIG {
@@ -1241,6 +1242,27 @@ declare const processAuthorAndCommonFilters: (allTpls: any[], filterScopes: stri
 
 declare const _self_managed_getFixedAnnoTagBlock: (selectedTpls: any[], annotationTagsCount: any) => any[];
 
+/**
+ * FOLLOWUP (consolidate the count->rollupPath rule into one source of truth):
+ *
+ * The rule "given annotationTagsCount, which self-managed anno rollupPaths exist"
+ * (subThemes>0 -> ['tags','subThemes']; subThemes>0 && themes>0 -> ['tags','subThemes','themes'])
+ * is currently duplicated in THREE places and will drift:
+ *   1. here (_self_managed_getFixedAnnoRollupBlocks)            -> filter blocks
+ *   2. _self_managed_buildAnnoHierarchyConfig                   -> anno hierarchy filter UI
+ *   3. okf-fe _extractAllAnnoBasedDimensionsAsOptions.js        -> reports dimension dropdown
+ *
+ * (#3 was added to fix a crash: the reports widget previously discovered these rollups
+ *  from publishing-segment tpls via getRollupPossibilities, but self-managed taxonomy lives
+ *  on `collections`-segment tpls which isTplAnnotationEnabled excludes -> empty list ->
+ *  unguarded .find('subThemes') returned undefined -> crash. The FE now builds them from the
+ *  count, mirroring this function.)
+ *
+ * Extract a pure helper here in ootils:
+ *   export const getSelfManagedAnnoRollupPaths = (annotationTagsCount): string[][] => [...]
+ * then have all three call sites consume it (each maps paths -> its own shape:
+ * filter-blocks / hierarchy levels / dropdown options). One rule, three presentations.
+ */
 declare const _self_managed_getFixedAnnoRollupBlocks: ({ selectedTpls, allTpls, annotationTagsCount }: {
     selectedTpls: any[];
     allTpls: any[];
@@ -1342,6 +1364,7 @@ declare const _self_managed_buildDocHierarchyConfig: ({ combinedDocumentBlocks,
             display: any;
             filters: any[];
             rollups: any[];
+            rollupDisplayMap: Record<string, string>;
         }[];
     };
     target: {
@@ -1501,6 +1524,7 @@ declare const autoGenFilterConfigsFromTpl: ({ selectedTpls, allTpls, filterScope
                     display: any;
                     filters: any[];
                     rollups: any[];
+                    rollupDisplayMap: Record<string, string>;
                 }[];
             };
             target: {

package/dist/browser.js

@@ -722,7 +722,8 @@ var collectMarkIdsInOrder = (editorState) => {
 var MAX_DEPTH_ROLLUP_POSSIBILITIES = 10;
 function getRollupPossibilities({
   tagType,
-  allTpls
+  allTpls,
+  includeSelfHead = false
 }) {
   const thisTagTpl = allTpls.find((d) => d.kp_content_type === tagType);
   if (!thisTagTpl) return [];
@@ -754,7 +755,8 @@ function getRollupPossibilities({
         chains.push({
           rollupType: "tagType",
           tagTypeCollectionToRollup: tagType,
-          rollupPath: [...visited, startTagType, nextTagType]
+          rollupPath: [...visited, startTagType, nextTagType],
+          filterDisplay: block.props?.shortLabel || block.props?.label
         });
         if (visited.length < maxDepth - 1) {
           const nextChains = findTagChains(
@@ -800,7 +802,8 @@ function getRollupPossibilities({
     const directChain = {
       rollupType: "tagType",
       tagTypeCollectionToRollup: tagType,
-      rollupPath: [tagType, block.props.tagType]
+      rollupPath: [tagType, block.props.tagType],
+      filterDisplay: block.props?.shortLabel || block.props?.label
     };
     const deeperChains = findTagChains(
       block.props?.tagType,
@@ -809,7 +812,14 @@ function getRollupPossibilities({
     );
     return [directChain, ...deeperChains];
   });
-  return [...singleLevelValuePathRollups, ...nestedTagRollups];
+  const selfHeadRollup = includeSelfHead && nestedTagRollups.length > 0 && singleLevelValuePathRollups.length === 0 ? [
+    {
+      rollupType: "tagType",
+      tagTypeCollectionToRollup: tagType,
+      rollupPath: [tagType]
+    }
+  ] : [];
+  return [...singleLevelValuePathRollups, ...selfHeadRollup, ...nestedTagRollups];
 }
 
 // src/bullmq/GLOBAL_BULLMQ_CONFIG.js
@@ -1714,6 +1724,7 @@ var buildFilterConfigurations = ({ groups, type, selectedTpls, allTpls, isRollup
           if (isTerminalValuePath) {
             return element.filterDisplay || lastItemInPath;
           }
+          if (element.filterDisplay) return element.filterDisplay;
           const lastTag = rollupPath[rollupPath.length - 1];
           const lastTagTpl = allTpls.find(
             (tpl) => tpl.kp_content_type === lastTag
@@ -1758,6 +1769,7 @@ var buildFilterConfigurations = ({ groups, type, selectedTpls, allTpls, isRollup
             scope: section.filterScope
           };
         };
+        const isSelfTerminalTag = element.rollupPath.length === 1 && !isLastTagProfile && !isTerminalValuePath;
         return {
           filterId: `ROLLUP_${section.filterScope}_${element.rollupPath.join(
             "_"
@@ -1771,9 +1783,14 @@ var buildFilterConfigurations = ({ groups, type, selectedTpls, allTpls, isRollup
             scope: section.filterScope
           }),
           contentType: element.rollupPath[0],
-          path: `tags.${element.rollupPath[1]}`,
+          path: `tags.${isSelfTerminalTag ? element.rollupPath[0] : element.rollupPath[1]}`,
           source: getSourceConfig(),
-          target: {
+          target: isSelfTerminalTag ? {
+            filterType: "tagType",
+            tagType: element.rollupPath[0],
+            rollupPath: element.rollupPath,
+            ...isAnno && { isAnno: true }
+          } : {
             filterType: "nestedRollupTagType",
             rollupPath: element.rollupPath,
             ...isAnno && { isAnno: true }
@@ -1980,7 +1997,7 @@ var extractAndOrganizeBlocks = (selectedTpls, allTpls, { smTagTypesConfig } = {}
     return {
       contentType: tpl.kp_content_type,
       blocks: allBlocks.filter((block) => block.valuePath.startsWith("tags.") && ["TagsInputSingle", "TagsInputMulti"].includes(block.comp)).flatMap((block) => {
-        const possibilities = getRollupPossibilities({ tagType: block.props.tagType, allTpls });
+        const possibilities = getRollupPossibilities({ tagType: block.props.tagType, allTpls, includeSelfHead: true });
         return possibilities.map((p) => ({
           ...p,
           filterType: p.rollupPath ? "nestedRollupTagType" : "rollupValuePathType"
@@ -2313,13 +2330,16 @@ var buildTagTypeParentMap = (tagTypesInGroup, allTpls) => {
     const tagBlocks = blocks.filter(
       (block) => block.valuePath?.startsWith("tags.") && block.props?.tagType
     );
+    const referencedTagTypes = /* @__PURE__ */ new Set();
     for (const block of tagBlocks) {
       const referencedTagType = block.props.tagType;
       if (tagTypeSet.has(referencedTagType) && referencedTagType !== tagType) {
-        parentMap.set(tagType, referencedTagType);
-        break;
+        referencedTagTypes.add(referencedTagType);
       }
     }
+    if (referencedTagTypes.size === 1) {
+      parentMap.set(tagType, [...referencedTagTypes][0]);
+    }
   }
   for (const child of parentMap.keys()) {
     const visited = /* @__PURE__ */ new Set();
@@ -2393,6 +2413,34 @@ var sortFiltersHierarchically = (filters) => {
   return sorted;
 };
 
+// src/utils/autoGenFilterConfigsFromTpl/utils/deduplicateRollupTagFilters.ts
+var deduplicateRollupTagFilters = (rollups) => {
+  const tagTerminals = [];
+  const nonTag = [];
+  for (const r of rollups) {
+    const rp = r.target?.rollupPath;
+    if (rp?.length && !rp[rp.length - 1].startsWith("main.")) {
+      tagTerminals.push(r);
+    } else {
+      nonTag.push({ ...r, isTagRollup: false });
+    }
+  }
+  if (tagTerminals.length === 0) return nonTag;
+  const byTerminal = /* @__PURE__ */ new Map();
+  for (const r of tagTerminals) {
+    const terminal = r.target.rollupPath[r.target.rollupPath.length - 1];
+    const existing = byTerminal.get(terminal);
+    if (!existing || r.target.rollupPath.length < existing.target.rollupPath.length) {
+      byTerminal.set(terminal, r);
+    }
+  }
+  const dedupedTags = [...byTerminal.values()].map((r) => ({
+    ...r,
+    isTagRollup: true
+  }));
+  return [...nonTag, ...dedupedTags];
+};
+
 // src/utils/autoGenFilterConfigsFromTpl/utils/_self_managed_buildDocHierarchyConfig.ts
 var injectFilterOptionsBy = (filters) => filters.map(
   (f) => f.parentFilterId ? { ...f, source: { ...f.source, filterOptionsBy: { filterId: f.parentFilterId } } } : f
@@ -2499,24 +2547,34 @@ var _self_managed_buildDocHierarchyConfig = ({
     const dedupedFilters = filtersWithCommonFlag.filter(
       (f) => !rollupSourceKeys.has(JSON.stringify(f.source))
     );
-    const combined = [...dedupedFilters, ...rollupConfigs];
+    const dedupedRollupConfigs = deduplicateRollupTagFilters(rollupConfigs);
+    const combined = [...dedupedFilters, ...dedupedRollupConfigs];
     const combinedWithParents = injectFilterOptionsBy(
       sortFiltersHierarchically(
         attachParentFields(combined, allTpls)
       )
     );
-    const rollupFilterIds = new Set(rollupConfigs.map((r) => r.filterId));
+    const rollupFilterIds = new Set(dedupedRollupConfigs.map((r) => r.filterId));
     const filtersWithParents = combinedWithParents.filter(
       (f) => !rollupFilterIds.has(f.filterId)
     );
     const rollupsWithParents = combinedWithParents.filter(
       (f) => rollupFilterIds.has(f.filterId)
     );
+    const rollupContentTypes = new Set(
+      rollupsWithParents.filter((r) => r.target?.rollupPath).flatMap((r) => r.target.rollupPath)
+    );
+    const rollupDisplayMap = {};
+    for (const ct of rollupContentTypes) {
+      const t = allTpls.find((tp) => tp.kp_content_type === ct);
+      if (t?.general?.content?.title) rollupDisplayMap[ct] = t.general.content.title;
+    }
     return {
       contentType: tpl.kp_content_type,
       display: tplData?.general?.content?.title || tpl.kp_content_type,
       filters: filtersWithParents,
-      rollups: rollupsWithParents
+      rollups: rollupsWithParents,
+      rollupDisplayMap
     };
   });
   const filteredPerDataset = perDataset.filter(

package/dist/browser.mjs

@@ -652,7 +652,8 @@ var collectMarkIdsInOrder = (editorState) => {
 var MAX_DEPTH_ROLLUP_POSSIBILITIES = 10;
 function getRollupPossibilities({
   tagType,
-  allTpls
+  allTpls,
+  includeSelfHead = false
 }) {
   const thisTagTpl = allTpls.find((d) => d.kp_content_type === tagType);
   if (!thisTagTpl) return [];
@@ -684,7 +685,8 @@ function getRollupPossibilities({
         chains.push({
           rollupType: "tagType",
           tagTypeCollectionToRollup: tagType,
-          rollupPath: [...visited, startTagType, nextTagType]
+          rollupPath: [...visited, startTagType, nextTagType],
+          filterDisplay: block.props?.shortLabel || block.props?.label
         });
         if (visited.length < maxDepth - 1) {
           const nextChains = findTagChains(
@@ -730,7 +732,8 @@ function getRollupPossibilities({
     const directChain = {
       rollupType: "tagType",
       tagTypeCollectionToRollup: tagType,
-      rollupPath: [tagType, block.props.tagType]
+      rollupPath: [tagType, block.props.tagType],
+      filterDisplay: block.props?.shortLabel || block.props?.label
     };
     const deeperChains = findTagChains(
       block.props?.tagType,
@@ -739,7 +742,14 @@ function getRollupPossibilities({
     );
     return [directChain, ...deeperChains];
   });
-  return [...singleLevelValuePathRollups, ...nestedTagRollups];
+  const selfHeadRollup = includeSelfHead && nestedTagRollups.length > 0 && singleLevelValuePathRollups.length === 0 ? [
+    {
+      rollupType: "tagType",
+      tagTypeCollectionToRollup: tagType,
+      rollupPath: [tagType]
+    }
+  ] : [];
+  return [...singleLevelValuePathRollups, ...selfHeadRollup, ...nestedTagRollups];
 }
 
 // src/bullmq/GLOBAL_BULLMQ_CONFIG.js
@@ -1644,6 +1654,7 @@ var buildFilterConfigurations = ({ groups, type, selectedTpls, allTpls, isRollup
           if (isTerminalValuePath) {
             return element.filterDisplay || lastItemInPath;
           }
+          if (element.filterDisplay) return element.filterDisplay;
           const lastTag = rollupPath[rollupPath.length - 1];
           const lastTagTpl = allTpls.find(
             (tpl) => tpl.kp_content_type === lastTag
@@ -1688,6 +1699,7 @@ var buildFilterConfigurations = ({ groups, type, selectedTpls, allTpls, isRollup
             scope: section.filterScope
           };
         };
+        const isSelfTerminalTag = element.rollupPath.length === 1 && !isLastTagProfile && !isTerminalValuePath;
         return {
           filterId: `ROLLUP_${section.filterScope}_${element.rollupPath.join(
             "_"
@@ -1701,9 +1713,14 @@ var buildFilterConfigurations = ({ groups, type, selectedTpls, allTpls, isRollup
             scope: section.filterScope
           }),
           contentType: element.rollupPath[0],
-          path: `tags.${element.rollupPath[1]}`,
+          path: `tags.${isSelfTerminalTag ? element.rollupPath[0] : element.rollupPath[1]}`,
           source: getSourceConfig(),
-          target: {
+          target: isSelfTerminalTag ? {
+            filterType: "tagType",
+            tagType: element.rollupPath[0],
+            rollupPath: element.rollupPath,
+            ...isAnno && { isAnno: true }
+          } : {
             filterType: "nestedRollupTagType",
             rollupPath: element.rollupPath,
             ...isAnno && { isAnno: true }
@@ -1910,7 +1927,7 @@ var extractAndOrganizeBlocks = (selectedTpls, allTpls, { smTagTypesConfig } = {}
     return {
       contentType: tpl.kp_content_type,
       blocks: allBlocks.filter((block) => block.valuePath.startsWith("tags.") && ["TagsInputSingle", "TagsInputMulti"].includes(block.comp)).flatMap((block) => {
-        const possibilities = getRollupPossibilities({ tagType: block.props.tagType, allTpls });
+        const possibilities = getRollupPossibilities({ tagType: block.props.tagType, allTpls, includeSelfHead: true });
         return possibilities.map((p) => ({
           ...p,
           filterType: p.rollupPath ? "nestedRollupTagType" : "rollupValuePathType"
@@ -2243,13 +2260,16 @@ var buildTagTypeParentMap = (tagTypesInGroup, allTpls) => {
     const tagBlocks = blocks.filter(
       (block) => block.valuePath?.startsWith("tags.") && block.props?.tagType
     );
+    const referencedTagTypes = /* @__PURE__ */ new Set();
     for (const block of tagBlocks) {
       const referencedTagType = block.props.tagType;
       if (tagTypeSet.has(referencedTagType) && referencedTagType !== tagType) {
-        parentMap.set(tagType, referencedTagType);
-        break;
+        referencedTagTypes.add(referencedTagType);
       }
     }
+    if (referencedTagTypes.size === 1) {
+      parentMap.set(tagType, [...referencedTagTypes][0]);
+    }
   }
   for (const child of parentMap.keys()) {
     const visited = /* @__PURE__ */ new Set();
@@ -2323,6 +2343,34 @@ var sortFiltersHierarchically = (filters) => {
   return sorted;
 };
 
+// src/utils/autoGenFilterConfigsFromTpl/utils/deduplicateRollupTagFilters.ts
+var deduplicateRollupTagFilters = (rollups) => {
+  const tagTerminals = [];
+  const nonTag = [];
+  for (const r of rollups) {
+    const rp = r.target?.rollupPath;
+    if (rp?.length && !rp[rp.length - 1].startsWith("main.")) {
+      tagTerminals.push(r);
+    } else {
+      nonTag.push({ ...r, isTagRollup: false });
+    }
+  }
+  if (tagTerminals.length === 0) return nonTag;
+  const byTerminal = /* @__PURE__ */ new Map();
+  for (const r of tagTerminals) {
+    const terminal = r.target.rollupPath[r.target.rollupPath.length - 1];
+    const existing = byTerminal.get(terminal);
+    if (!existing || r.target.rollupPath.length < existing.target.rollupPath.length) {
+      byTerminal.set(terminal, r);
+    }
+  }
+  const dedupedTags = [...byTerminal.values()].map((r) => ({
+    ...r,
+    isTagRollup: true
+  }));
+  return [...nonTag, ...dedupedTags];
+};
+
 // src/utils/autoGenFilterConfigsFromTpl/utils/_self_managed_buildDocHierarchyConfig.ts
 var injectFilterOptionsBy = (filters) => filters.map(
   (f) => f.parentFilterId ? { ...f, source: { ...f.source, filterOptionsBy: { filterId: f.parentFilterId } } } : f
@@ -2429,24 +2477,34 @@ var _self_managed_buildDocHierarchyConfig = ({
     const dedupedFilters = filtersWithCommonFlag.filter(
       (f) => !rollupSourceKeys.has(JSON.stringify(f.source))
     );
-    const combined = [...dedupedFilters, ...rollupConfigs];
+    const dedupedRollupConfigs = deduplicateRollupTagFilters(rollupConfigs);
+    const combined = [...dedupedFilters, ...dedupedRollupConfigs];
     const combinedWithParents = injectFilterOptionsBy(
       sortFiltersHierarchically(
         attachParentFields(combined, allTpls)
       )
     );
-    const rollupFilterIds = new Set(rollupConfigs.map((r) => r.filterId));
+    const rollupFilterIds = new Set(dedupedRollupConfigs.map((r) => r.filterId));
     const filtersWithParents = combinedWithParents.filter(
       (f) => !rollupFilterIds.has(f.filterId)
     );
     const rollupsWithParents = combinedWithParents.filter(
       (f) => rollupFilterIds.has(f.filterId)
     );
+    const rollupContentTypes = new Set(
+      rollupsWithParents.filter((r) => r.target?.rollupPath).flatMap((r) => r.target.rollupPath)
+    );
+    const rollupDisplayMap = {};
+    for (const ct of rollupContentTypes) {
+      const t = allTpls.find((tp) => tp.kp_content_type === ct);
+      if (t?.general?.content?.title) rollupDisplayMap[ct] = t.general.content.title;
+    }
     return {
       contentType: tpl.kp_content_type,
       display: tplData?.general?.content?.title || tpl.kp_content_type,
       filters: filtersWithParents,
-      rollups: rollupsWithParents
+      rollups: rollupsWithParents,
+      rollupDisplayMap
     };
   });
   const filteredPerDataset = perDataset.filter(

package/dist/node.d.mts

@@ -293,9 +293,10 @@ declare const collectMarkIdsInOrder: (editorState: any) => string[];
  *   }
  * ]
  */
-declare function getRollupPossibilities({ tagType, allTpls }: {
+declare function getRollupPossibilities({ tagType, allTpls, includeSelfHead, }: {
     tagType: string;
     allTpls: any[];
+    includeSelfHead?: boolean;
 }): any[];
 
 declare namespace BASE_BULLMQ_CONFIG {
@@ -1249,6 +1250,27 @@ declare const processAuthorAndCommonFilters: (allTpls: any[], filterScopes: stri
 
 declare const _self_managed_getFixedAnnoTagBlock: (selectedTpls: any[], annotationTagsCount: any) => any[];
 
+/**
+ * FOLLOWUP (consolidate the count->rollupPath rule into one source of truth):
+ *
+ * The rule "given annotationTagsCount, which self-managed anno rollupPaths exist"
+ * (subThemes>0 -> ['tags','subThemes']; subThemes>0 && themes>0 -> ['tags','subThemes','themes'])
+ * is currently duplicated in THREE places and will drift:
+ *   1. here (_self_managed_getFixedAnnoRollupBlocks)            -> filter blocks
+ *   2. _self_managed_buildAnnoHierarchyConfig                   -> anno hierarchy filter UI
+ *   3. okf-fe _extractAllAnnoBasedDimensionsAsOptions.js        -> reports dimension dropdown
+ *
+ * (#3 was added to fix a crash: the reports widget previously discovered these rollups
+ *  from publishing-segment tpls via getRollupPossibilities, but self-managed taxonomy lives
+ *  on `collections`-segment tpls which isTplAnnotationEnabled excludes -> empty list ->
+ *  unguarded .find('subThemes') returned undefined -> crash. The FE now builds them from the
+ *  count, mirroring this function.)
+ *
+ * Extract a pure helper here in ootils:
+ *   export const getSelfManagedAnnoRollupPaths = (annotationTagsCount): string[][] => [...]
+ * then have all three call sites consume it (each maps paths -> its own shape:
+ * filter-blocks / hierarchy levels / dropdown options). One rule, three presentations.
+ */
 declare const _self_managed_getFixedAnnoRollupBlocks: ({ selectedTpls, allTpls, annotationTagsCount }: {
     selectedTpls: any[];
     allTpls: any[];
@@ -1350,6 +1372,7 @@ declare const _self_managed_buildDocHierarchyConfig: ({ combinedDocumentBlocks,
             display: any;
             filters: any[];
             rollups: any[];
+            rollupDisplayMap: Record<string, string>;
         }[];
     };
     target: {
@@ -1509,6 +1532,7 @@ declare const autoGenFilterConfigsFromTpl: ({ selectedTpls, allTpls, filterScope
                     display: any;
                     filters: any[];
                     rollups: any[];
+                    rollupDisplayMap: Record<string, string>;
                 }[];
             };
             target: {

package/dist/node.d.ts

@@ -293,9 +293,10 @@ declare const collectMarkIdsInOrder: (editorState: any) => string[];
  *   }
  * ]
  */
-declare function getRollupPossibilities({ tagType, allTpls }: {
+declare function getRollupPossibilities({ tagType, allTpls, includeSelfHead, }: {
     tagType: string;
     allTpls: any[];
+    includeSelfHead?: boolean;
 }): any[];
 
 declare namespace BASE_BULLMQ_CONFIG {
@@ -1249,6 +1250,27 @@ declare const processAuthorAndCommonFilters: (allTpls: any[], filterScopes: stri
 
 declare const _self_managed_getFixedAnnoTagBlock: (selectedTpls: any[], annotationTagsCount: any) => any[];
 
+/**
+ * FOLLOWUP (consolidate the count->rollupPath rule into one source of truth):
+ *
+ * The rule "given annotationTagsCount, which self-managed anno rollupPaths exist"
+ * (subThemes>0 -> ['tags','subThemes']; subThemes>0 && themes>0 -> ['tags','subThemes','themes'])
+ * is currently duplicated in THREE places and will drift:
+ *   1. here (_self_managed_getFixedAnnoRollupBlocks)            -> filter blocks
+ *   2. _self_managed_buildAnnoHierarchyConfig                   -> anno hierarchy filter UI
+ *   3. okf-fe _extractAllAnnoBasedDimensionsAsOptions.js        -> reports dimension dropdown
+ *
+ * (#3 was added to fix a crash: the reports widget previously discovered these rollups
+ *  from publishing-segment tpls via getRollupPossibilities, but self-managed taxonomy lives
+ *  on `collections`-segment tpls which isTplAnnotationEnabled excludes -> empty list ->
+ *  unguarded .find('subThemes') returned undefined -> crash. The FE now builds them from the
+ *  count, mirroring this function.)
+ *
+ * Extract a pure helper here in ootils:
+ *   export const getSelfManagedAnnoRollupPaths = (annotationTagsCount): string[][] => [...]
+ * then have all three call sites consume it (each maps paths -> its own shape:
+ * filter-blocks / hierarchy levels / dropdown options). One rule, three presentations.
+ */
 declare const _self_managed_getFixedAnnoRollupBlocks: ({ selectedTpls, allTpls, annotationTagsCount }: {
     selectedTpls: any[];
     allTpls: any[];
@@ -1350,6 +1372,7 @@ declare const _self_managed_buildDocHierarchyConfig: ({ combinedDocumentBlocks,
             display: any;
             filters: any[];
             rollups: any[];
+            rollupDisplayMap: Record<string, string>;
         }[];
     };
     target: {
@@ -1509,6 +1532,7 @@ declare const autoGenFilterConfigsFromTpl: ({ selectedTpls, allTpls, filterScope
                     display: any;
                     filters: any[];
                     rollups: any[];
+                    rollupDisplayMap: Record<string, string>;
                 }[];
             };
             target: {