@okf/ootils 1.27.0 → 1.28.1

package/dist/browser.d.mts

@@ -1020,6 +1020,51 @@ declare const _self_managed_buildAnnoHierarchyConfig: ({ annotationTagsCount, }:
     };
 } | null;
 
+/**
+ * Builds a consolidated docHierarchyType config for self-managed tenants.
+ *
+ * Produces a single filter config that contains:
+ * - commonFilters: filters present in ALL selected templates
+ * - sharedAcrossMultiple: groups of filters shared by 2+ (but not all) templates
+ * - perDataset: each template's complete filter list + rollup configs
+ * - commonDocumentFilters: Author, Published Date, etc.
+ *
+ * This is consumed by DocHierarchyFilter on the frontend to render the
+ * drilldown-based document filter UI.
+ */
+declare const _self_managed_buildDocHierarchyConfig: ({ combinedDocumentBlocks, docRollupBlocks, selectedTpls, allTpls, commonDocumentFilters, flatDocFilters, }: {
+    combinedDocumentBlocks: any[];
+    docRollupBlocks: any[];
+    selectedTpls: any[];
+    allTpls: any[];
+    commonDocumentFilters: any[];
+    flatDocFilters?: boolean;
+}) => {
+    filterId: string;
+    display: string;
+    filterKey: string;
+    source: {
+        filterType: string;
+        flatDocFilters: boolean;
+        commonFilters: any[];
+        sharedAcrossMultiple: {
+            contentTypes: any;
+            display: any;
+            filters: any[];
+        }[];
+        commonDocumentFilters: any[];
+        perDataset: {
+            contentType: any;
+            display: any;
+            filters: any[];
+            rollups: any[];
+        }[];
+    };
+    target: {
+        filterType: string;
+    };
+} | null;
+
 /**
  * TEMP_removeDuplicateFilters - Removes duplicate rollup and tag-type filters
  *
@@ -1114,6 +1159,37 @@ declare const autoGenFilterConfigsFromTpl: ({ selectedTpls, allTpls, filterScope
         sectionId: string;
         configs: any[];
     }[];
+} | {
+    sectionId: string;
+    configs: {
+        sectionId: string;
+        configs: {
+            filterId: string;
+            display: string;
+            filterKey: string;
+            source: {
+                filterType: string;
+                flatDocFilters: boolean;
+                commonFilters: any[];
+                sharedAcrossMultiple: {
+                    contentTypes: any;
+                    display: any;
+                    filters: any[];
+                }[];
+                commonDocumentFilters: any[];
+                perDataset: {
+                    contentType: any;
+                    display: any;
+                    filters: any[];
+                    rollups: any[];
+                }[];
+            };
+            target: {
+                filterType: string;
+            };
+        }[];
+    }[];
+    sectionTitle?: undefined;
 } | {
     sectionId: string;
     sectionTitle: string;
@@ -1184,11 +1260,30 @@ declare const UI_CONTENT: {
     };
 };
 
-declare const genCleanCamelCaseId: (id: string) => string;
+interface GenCleanCamelCaseIdOptions {
+    /** Strip all non-alphanumeric chars (A-Z, a-z, 0-9 only). Default: false */
+    stripNonAlphanumeric?: boolean;
+    /** Truncate result to this max length. Default: no limit */
+    maxLength?: number;
+}
+declare const genCleanCamelCaseId: (id: string, options?: GenCleanCamelCaseIdOptions) => string;
+
+/**
+ * Generates a clean, deterministic contentType ID from text.
+ * Wraps genCleanCamelCaseId with stripNonAlphanumeric + maxLength 40.
+ *
+ * Idempotent: running twice produces the same output.
+ *
+ * @example
+ * genCleanContentTypeId("My Articles!")  => "myArticles"
+ * genCleanContentTypeId("myArticles")    => "myArticles" (idempotent)
+ * genCleanContentTypeId("123 Test")      => "a123Test"
+ */
+declare const genCleanContentTypeId: (text: string) => string;
 
 /**
  * Generates a clean, short, unique ID from text input.
- * Used for both contentType IDs and block valuePaths.
+ * Used for block valuePaths in templates.
  *
  * 1. Strips all characters except A-Z, a-z, 0-9
  * 2. Lowercases the result
@@ -1196,15 +1291,18 @@ declare const genCleanCamelCaseId: (id: string) => string;
  * 4. Truncates to maxLength (default 10)
  * 5. Appends _{random id} (default 4 chars)
  *
+ * Idempotent: if input already matches the output pattern
+ * (lowercase alphanumeric + _hash suffix), returns as-is.
+ *
  * @param text - The input text to convert
- * @param maxLength - Max characters before the random suffix (default 10, use 20 for contentType)
+ * @param maxLength - Max characters before the random suffix (default 10)
  * @param shortIdLength - Length of the random suffix (default 4)
  *
  * @example
- * genCleanIdForContentTypeAndValuePaths("Author Name")        => "authorname_x7k2"
- * genCleanIdForContentTypeAndValuePaths("My Articles!", 20)   => "myarticles_m3p1"
- * genCleanIdForContentTypeAndValuePaths("123 Test")           => "a123test_ab4d"
+ * genCleanValuePath("Author Name")       => "authorname_x7k2"
+ * genCleanValuePath("authorname_x7k2")   => "authorname_x7k2" (idempotent)
+ * genCleanValuePath("123 Test")           => "a123test_ab4d"
  */
-declare const genCleanIdForContentTypeAndValuePaths: (text: string, maxLength?: number, shortIdLength?: number) => string;
+declare const genCleanValuePath: (text: string) => string;
 
-export { BASE_BULLMQ_CONFIG, FILTER_IDS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genCleanIdForContentTypeAndValuePaths, genTagId, generateFilterKey, getFilterKeyForBlock, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };
+export { BASE_BULLMQ_CONFIG, FILTER_IDS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genCleanContentTypeId, genCleanValuePath, genTagId, generateFilterKey, getFilterKeyForBlock, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/browser.d.ts

@@ -1020,6 +1020,51 @@ declare const _self_managed_buildAnnoHierarchyConfig: ({ annotationTagsCount, }:
     };
 } | null;
 
+/**
+ * Builds a consolidated docHierarchyType config for self-managed tenants.
+ *
+ * Produces a single filter config that contains:
+ * - commonFilters: filters present in ALL selected templates
+ * - sharedAcrossMultiple: groups of filters shared by 2+ (but not all) templates
+ * - perDataset: each template's complete filter list + rollup configs
+ * - commonDocumentFilters: Author, Published Date, etc.
+ *
+ * This is consumed by DocHierarchyFilter on the frontend to render the
+ * drilldown-based document filter UI.
+ */
+declare const _self_managed_buildDocHierarchyConfig: ({ combinedDocumentBlocks, docRollupBlocks, selectedTpls, allTpls, commonDocumentFilters, flatDocFilters, }: {
+    combinedDocumentBlocks: any[];
+    docRollupBlocks: any[];
+    selectedTpls: any[];
+    allTpls: any[];
+    commonDocumentFilters: any[];
+    flatDocFilters?: boolean;
+}) => {
+    filterId: string;
+    display: string;
+    filterKey: string;
+    source: {
+        filterType: string;
+        flatDocFilters: boolean;
+        commonFilters: any[];
+        sharedAcrossMultiple: {
+            contentTypes: any;
+            display: any;
+            filters: any[];
+        }[];
+        commonDocumentFilters: any[];
+        perDataset: {
+            contentType: any;
+            display: any;
+            filters: any[];
+            rollups: any[];
+        }[];
+    };
+    target: {
+        filterType: string;
+    };
+} | null;
+
 /**
  * TEMP_removeDuplicateFilters - Removes duplicate rollup and tag-type filters
  *
@@ -1114,6 +1159,37 @@ declare const autoGenFilterConfigsFromTpl: ({ selectedTpls, allTpls, filterScope
         sectionId: string;
         configs: any[];
     }[];
+} | {
+    sectionId: string;
+    configs: {
+        sectionId: string;
+        configs: {
+            filterId: string;
+            display: string;
+            filterKey: string;
+            source: {
+                filterType: string;
+                flatDocFilters: boolean;
+                commonFilters: any[];
+                sharedAcrossMultiple: {
+                    contentTypes: any;
+                    display: any;
+                    filters: any[];
+                }[];
+                commonDocumentFilters: any[];
+                perDataset: {
+                    contentType: any;
+                    display: any;
+                    filters: any[];
+                    rollups: any[];
+                }[];
+            };
+            target: {
+                filterType: string;
+            };
+        }[];
+    }[];
+    sectionTitle?: undefined;
 } | {
     sectionId: string;
     sectionTitle: string;
@@ -1184,11 +1260,30 @@ declare const UI_CONTENT: {
     };
 };
 
-declare const genCleanCamelCaseId: (id: string) => string;
+interface GenCleanCamelCaseIdOptions {
+    /** Strip all non-alphanumeric chars (A-Z, a-z, 0-9 only). Default: false */
+    stripNonAlphanumeric?: boolean;
+    /** Truncate result to this max length. Default: no limit */
+    maxLength?: number;
+}
+declare const genCleanCamelCaseId: (id: string, options?: GenCleanCamelCaseIdOptions) => string;
+
+/**
+ * Generates a clean, deterministic contentType ID from text.
+ * Wraps genCleanCamelCaseId with stripNonAlphanumeric + maxLength 40.
+ *
+ * Idempotent: running twice produces the same output.
+ *
+ * @example
+ * genCleanContentTypeId("My Articles!")  => "myArticles"
+ * genCleanContentTypeId("myArticles")    => "myArticles" (idempotent)
+ * genCleanContentTypeId("123 Test")      => "a123Test"
+ */
+declare const genCleanContentTypeId: (text: string) => string;
 
 /**
  * Generates a clean, short, unique ID from text input.
- * Used for both contentType IDs and block valuePaths.
+ * Used for block valuePaths in templates.
  *
  * 1. Strips all characters except A-Z, a-z, 0-9
  * 2. Lowercases the result
@@ -1196,15 +1291,18 @@ declare const genCleanCamelCaseId: (id: string) => string;
  * 4. Truncates to maxLength (default 10)
  * 5. Appends _{random id} (default 4 chars)
  *
+ * Idempotent: if input already matches the output pattern
+ * (lowercase alphanumeric + _hash suffix), returns as-is.
+ *
  * @param text - The input text to convert
- * @param maxLength - Max characters before the random suffix (default 10, use 20 for contentType)
+ * @param maxLength - Max characters before the random suffix (default 10)
  * @param shortIdLength - Length of the random suffix (default 4)
  *
  * @example
- * genCleanIdForContentTypeAndValuePaths("Author Name")        => "authorname_x7k2"
- * genCleanIdForContentTypeAndValuePaths("My Articles!", 20)   => "myarticles_m3p1"
- * genCleanIdForContentTypeAndValuePaths("123 Test")           => "a123test_ab4d"
+ * genCleanValuePath("Author Name")       => "authorname_x7k2"
+ * genCleanValuePath("authorname_x7k2")   => "authorname_x7k2" (idempotent)
+ * genCleanValuePath("123 Test")           => "a123test_ab4d"
  */
-declare const genCleanIdForContentTypeAndValuePaths: (text: string, maxLength?: number, shortIdLength?: number) => string;
+declare const genCleanValuePath: (text: string) => string;
 
-export { BASE_BULLMQ_CONFIG, FILTER_IDS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genCleanIdForContentTypeAndValuePaths, genTagId, generateFilterKey, getFilterKeyForBlock, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };
+export { BASE_BULLMQ_CONFIG, FILTER_IDS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genCleanContentTypeId, genCleanValuePath, genTagId, generateFilterKey, getFilterKeyForBlock, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };