@okf/ootils 1.28.0 → 1.28.1

package/dist/browser.d.mts

@@ -1260,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
@@ -1272,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_buildDocHierarchyConfig, _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

@@ -1260,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
@@ -1272,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_buildDocHierarchyConfig, _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.js

@@ -35,7 +35,8 @@ __export(browser_exports, {
   extractAllBlocksFromTpl: () => extractAllBlocksFromTpl,
   extractAndOrganizeBlocks: () => extractAndOrganizeBlocks,
   genCleanCamelCaseId: () => genCleanCamelCaseId,
-  genCleanIdForContentTypeAndValuePaths: () => genCleanIdForContentTypeAndValuePaths,
+  genCleanContentTypeId: () => genCleanContentTypeId,
+  genCleanValuePath: () => genCleanValuePath,
   genTagId: () => genTagId,
   generateFilterKey: () => generateFilterKey,
   getFilterKeyForBlock: () => getFilterKeyForBlock,
@@ -2127,20 +2128,33 @@ var autoGenFilterConfigsFromTpl = ({
 };
 
 // src/utils/genCleanCamelCaseId.ts
-var genCleanCamelCaseId = (id) => {
+var genCleanCamelCaseId = (id, options) => {
   if (!id || typeof id !== "string") return id;
-  const isAlreadyClean = /^\p{Ll}[\p{L}\p{N}]*$/u.test(id) || /^a\d[\p{L}\p{N}]*$/u.test(id);
-  if (isAlreadyClean) return id;
+  const { stripNonAlphanumeric = false, maxLength } = options || {};
+  const baseClean = /^\p{Ll}[\p{L}\p{N}]*$/u.test(id) || /^a\d[\p{L}\p{N}]*$/u.test(id);
+  const withinMaxLength = maxLength ? id.length <= maxLength : true;
+  const hasNoNonAlpha = stripNonAlphanumeric ? /^[a-zA-Z0-9]+$/.test(id) : true;
+  if (baseClean && withinMaxLength && hasNoNonAlpha) return id;
   const words = id.split(/[^\p{L}\p{N}]+/u).filter(Boolean);
   if (words.length === 0) return "a";
-  const result = words.map((word, i) => {
+  let result = words.map((word, i) => {
     const lower = word.toLowerCase();
     return i === 0 ? lower : lower.charAt(0).toUpperCase() + lower.slice(1);
   }).join("");
-  return /^\d/.test(result) ? "a" + result : result;
+  if (/^\d/.test(result)) result = "a" + result;
+  if (stripNonAlphanumeric) {
+    result = result.replace(/[^a-zA-Z0-9]/g, "");
+  }
+  if (maxLength) {
+    result = result.slice(0, maxLength);
+  }
+  return result;
 };
 
-// src/utils/genCleanIdForContentTypeAndValuePaths.ts
+// src/utils/genCleanContentTypeId.ts
+var genCleanContentTypeId = (text) => genCleanCamelCaseId(text, { stripNonAlphanumeric: true, maxLength: 40 });
+
+// src/utils/genCleanValuePath.ts
 var CHARS = "abcdefghijklmnopqrstuvwxyz0123456789";
 function genShortId(length = 4) {
   let result = "";
@@ -2149,11 +2163,15 @@ function genShortId(length = 4) {
   }
   return result;
 }
-var genCleanIdForContentTypeAndValuePaths = (text, maxLength = 10, shortIdLength = 4) => {
+var genCleanValuePath = (text) => {
+  const maxLength = 10;
+  const shortIdLength = 4;
   if (!text || typeof text !== "string") return text;
+  const idempotencyPattern = new RegExp(`^[a-z][a-z0-9]*_[a-z0-9]{${shortIdLength}}$`);
+  if (idempotencyPattern.test(text)) return text;
   let cleaned = text.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
   if (!cleaned) {
-    throw new Error(`[genCleanIdForContentTypeAndValuePaths] Input "${text}" contains no alphanumeric characters`);
+    throw new Error(`[genCleanValuePath] Input "${text}" contains no alphanumeric characters`);
   }
   if (/^\d/.test(cleaned)) cleaned = "a" + cleaned;
   const truncated = cleaned.slice(0, maxLength);
@@ -2176,7 +2194,8 @@ var genCleanIdForContentTypeAndValuePaths = (text, maxLength = 10, shortIdLength
   extractAllBlocksFromTpl,
   extractAndOrganizeBlocks,
   genCleanCamelCaseId,
-  genCleanIdForContentTypeAndValuePaths,
+  genCleanContentTypeId,
+  genCleanValuePath,
   genTagId,
   generateFilterKey,
   getFilterKeyForBlock,

package/dist/browser.mjs

@@ -2070,20 +2070,33 @@ var autoGenFilterConfigsFromTpl = ({
 };
 
 // src/utils/genCleanCamelCaseId.ts
-var genCleanCamelCaseId = (id) => {
+var genCleanCamelCaseId = (id, options) => {
   if (!id || typeof id !== "string") return id;
-  const isAlreadyClean = /^\p{Ll}[\p{L}\p{N}]*$/u.test(id) || /^a\d[\p{L}\p{N}]*$/u.test(id);
-  if (isAlreadyClean) return id;
+  const { stripNonAlphanumeric = false, maxLength } = options || {};
+  const baseClean = /^\p{Ll}[\p{L}\p{N}]*$/u.test(id) || /^a\d[\p{L}\p{N}]*$/u.test(id);
+  const withinMaxLength = maxLength ? id.length <= maxLength : true;
+  const hasNoNonAlpha = stripNonAlphanumeric ? /^[a-zA-Z0-9]+$/.test(id) : true;
+  if (baseClean && withinMaxLength && hasNoNonAlpha) return id;
   const words = id.split(/[^\p{L}\p{N}]+/u).filter(Boolean);
   if (words.length === 0) return "a";
-  const result = words.map((word, i) => {
+  let result = words.map((word, i) => {
     const lower = word.toLowerCase();
     return i === 0 ? lower : lower.charAt(0).toUpperCase() + lower.slice(1);
   }).join("");
-  return /^\d/.test(result) ? "a" + result : result;
+  if (/^\d/.test(result)) result = "a" + result;
+  if (stripNonAlphanumeric) {
+    result = result.replace(/[^a-zA-Z0-9]/g, "");
+  }
+  if (maxLength) {
+    result = result.slice(0, maxLength);
+  }
+  return result;
 };
 
-// src/utils/genCleanIdForContentTypeAndValuePaths.ts
+// src/utils/genCleanContentTypeId.ts
+var genCleanContentTypeId = (text) => genCleanCamelCaseId(text, { stripNonAlphanumeric: true, maxLength: 40 });
+
+// src/utils/genCleanValuePath.ts
 var CHARS = "abcdefghijklmnopqrstuvwxyz0123456789";
 function genShortId(length = 4) {
   let result = "";
@@ -2092,11 +2105,15 @@ function genShortId(length = 4) {
   }
   return result;
 }
-var genCleanIdForContentTypeAndValuePaths = (text, maxLength = 10, shortIdLength = 4) => {
+var genCleanValuePath = (text) => {
+  const maxLength = 10;
+  const shortIdLength = 4;
   if (!text || typeof text !== "string") return text;
+  const idempotencyPattern = new RegExp(`^[a-z][a-z0-9]*_[a-z0-9]{${shortIdLength}}$`);
+  if (idempotencyPattern.test(text)) return text;
   let cleaned = text.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
   if (!cleaned) {
-    throw new Error(`[genCleanIdForContentTypeAndValuePaths] Input "${text}" contains no alphanumeric characters`);
+    throw new Error(`[genCleanValuePath] Input "${text}" contains no alphanumeric characters`);
   }
   if (/^\d/.test(cleaned)) cleaned = "a" + cleaned;
   const truncated = cleaned.slice(0, maxLength);
@@ -2118,7 +2135,8 @@ export {
   extractAllBlocksFromTpl,
   extractAndOrganizeBlocks,
   genCleanCamelCaseId,
-  genCleanIdForContentTypeAndValuePaths,
+  genCleanContentTypeId,
+  genCleanValuePath,
   genTagId,
   generateFilterKey,
   getFilterKeyForBlock,

package/dist/node.d.mts

@@ -1267,11 +1267,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
@@ -1279,16 +1298,19 @@ 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;
 
 declare class MongoConnector {
     static getInstance(): any;
@@ -2020,4 +2042,4 @@ declare function GET_GLOBAL_BULLMQ_CONFIG({ env, redisCredentials }: {
     };
 }): Object;
 
-export { AIChatSchema, AnnosElasticSyncProducer, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, ChunksElasticSyncProducer, ElasticSearchConnector, FILTER_IDS, GET_GLOBAL_BULLMQ_CONFIG, GeneratedEntitiesSchema, GeneratedTopicsSchema, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, SecretManagerConnector, TEMP_removeDuplicateFilters, TplSchema, UI_CONTENT, WorkerManager, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genCleanIdForContentTypeAndValuePaths, genTagId, generateFilterKey, getAIChatModelByTenant, getAnnotationsModelByTenant, getDbByTenant, getFilterKeyForBlock, getGeneratedEntitiesModelByTenant, getGeneratedTopicsModelByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getTplModelByTenant, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };
+export { AIChatSchema, AnnosElasticSyncProducer, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, ChunksElasticSyncProducer, ElasticSearchConnector, FILTER_IDS, GET_GLOBAL_BULLMQ_CONFIG, GeneratedEntitiesSchema, GeneratedTopicsSchema, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, SecretManagerConnector, TEMP_removeDuplicateFilters, TplSchema, UI_CONTENT, WorkerManager, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genCleanContentTypeId, genCleanValuePath, genTagId, generateFilterKey, getAIChatModelByTenant, getAnnotationsModelByTenant, getDbByTenant, getFilterKeyForBlock, getGeneratedEntitiesModelByTenant, getGeneratedTopicsModelByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getTplModelByTenant, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/node.d.ts

@@ -1267,11 +1267,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
@@ -1279,16 +1298,19 @@ 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;
 
 declare class MongoConnector {
     static getInstance(): any;
@@ -2020,4 +2042,4 @@ declare function GET_GLOBAL_BULLMQ_CONFIG({ env, redisCredentials }: {
     };
 }): Object;
 
-export { AIChatSchema, AnnosElasticSyncProducer, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, ChunksElasticSyncProducer, ElasticSearchConnector, FILTER_IDS, GET_GLOBAL_BULLMQ_CONFIG, GeneratedEntitiesSchema, GeneratedTopicsSchema, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, SecretManagerConnector, TEMP_removeDuplicateFilters, TplSchema, UI_CONTENT, WorkerManager, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genCleanIdForContentTypeAndValuePaths, genTagId, generateFilterKey, getAIChatModelByTenant, getAnnotationsModelByTenant, getDbByTenant, getFilterKeyForBlock, getGeneratedEntitiesModelByTenant, getGeneratedTopicsModelByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getTplModelByTenant, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };
+export { AIChatSchema, AnnosElasticSyncProducer, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, ChunksElasticSyncProducer, ElasticSearchConnector, FILTER_IDS, GET_GLOBAL_BULLMQ_CONFIG, GeneratedEntitiesSchema, GeneratedTopicsSchema, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, SecretManagerConnector, TEMP_removeDuplicateFilters, TplSchema, UI_CONTENT, WorkerManager, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genCleanContentTypeId, genCleanValuePath, genTagId, generateFilterKey, getAIChatModelByTenant, getAnnotationsModelByTenant, getDbByTenant, getFilterKeyForBlock, getGeneratedEntitiesModelByTenant, getGeneratedTopicsModelByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getTplModelByTenant, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/node.js

@@ -1949,7 +1949,8 @@ __export(node_exports, {
   extractAllBlocksFromTpl: () => extractAllBlocksFromTpl,
   extractAndOrganizeBlocks: () => extractAndOrganizeBlocks,
   genCleanCamelCaseId: () => genCleanCamelCaseId,
-  genCleanIdForContentTypeAndValuePaths: () => genCleanIdForContentTypeAndValuePaths,
+  genCleanContentTypeId: () => genCleanContentTypeId,
+  genCleanValuePath: () => genCleanValuePath,
   genTagId: () => genTagId,
   generateFilterKey: () => generateFilterKey,
   getAIChatModelByTenant: () => import_getModelByTenant2.getAIChatModelByTenant,
@@ -3721,20 +3722,33 @@ var autoGenFilterConfigsFromTpl = ({
 };
 
 // src/utils/genCleanCamelCaseId.ts
-var genCleanCamelCaseId = (id) => {
+var genCleanCamelCaseId = (id, options) => {
   if (!id || typeof id !== "string") return id;
-  const isAlreadyClean = /^\p{Ll}[\p{L}\p{N}]*$/u.test(id) || /^a\d[\p{L}\p{N}]*$/u.test(id);
-  if (isAlreadyClean) return id;
+  const { stripNonAlphanumeric = false, maxLength } = options || {};
+  const baseClean = /^\p{Ll}[\p{L}\p{N}]*$/u.test(id) || /^a\d[\p{L}\p{N}]*$/u.test(id);
+  const withinMaxLength = maxLength ? id.length <= maxLength : true;
+  const hasNoNonAlpha = stripNonAlphanumeric ? /^[a-zA-Z0-9]+$/.test(id) : true;
+  if (baseClean && withinMaxLength && hasNoNonAlpha) return id;
   const words = id.split(/[^\p{L}\p{N}]+/u).filter(Boolean);
   if (words.length === 0) return "a";
-  const result = words.map((word, i) => {
+  let result = words.map((word, i) => {
     const lower = word.toLowerCase();
     return i === 0 ? lower : lower.charAt(0).toUpperCase() + lower.slice(1);
   }).join("");
-  return /^\d/.test(result) ? "a" + result : result;
+  if (/^\d/.test(result)) result = "a" + result;
+  if (stripNonAlphanumeric) {
+    result = result.replace(/[^a-zA-Z0-9]/g, "");
+  }
+  if (maxLength) {
+    result = result.slice(0, maxLength);
+  }
+  return result;
 };
 
-// src/utils/genCleanIdForContentTypeAndValuePaths.ts
+// src/utils/genCleanContentTypeId.ts
+var genCleanContentTypeId = (text) => genCleanCamelCaseId(text, { stripNonAlphanumeric: true, maxLength: 40 });
+
+// src/utils/genCleanValuePath.ts
 var CHARS = "abcdefghijklmnopqrstuvwxyz0123456789";
 function genShortId(length = 4) {
   let result = "";
@@ -3743,11 +3757,15 @@ function genShortId(length = 4) {
   }
   return result;
 }
-var genCleanIdForContentTypeAndValuePaths = (text, maxLength = 10, shortIdLength = 4) => {
+var genCleanValuePath = (text) => {
+  const maxLength = 10;
+  const shortIdLength = 4;
   if (!text || typeof text !== "string") return text;
+  const idempotencyPattern = new RegExp(`^[a-z][a-z0-9]*_[a-z0-9]{${shortIdLength}}$`);
+  if (idempotencyPattern.test(text)) return text;
   let cleaned = text.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
   if (!cleaned) {
-    throw new Error(`[genCleanIdForContentTypeAndValuePaths] Input "${text}" contains no alphanumeric characters`);
+    throw new Error(`[genCleanValuePath] Input "${text}" contains no alphanumeric characters`);
   }
   if (/^\d/.test(cleaned)) cleaned = "a" + cleaned;
   const truncated = cleaned.slice(0, maxLength);
@@ -4171,7 +4189,8 @@ var import_GET_GLOBAL_BULLMQ_CONFIG = __toESM(require_GET_GLOBAL_BULLMQ_CONFIG()
   extractAllBlocksFromTpl,
   extractAndOrganizeBlocks,
   genCleanCamelCaseId,
-  genCleanIdForContentTypeAndValuePaths,
+  genCleanContentTypeId,
+  genCleanValuePath,
   genTagId,
   generateFilterKey,
   getAIChatModelByTenant,

package/dist/node.mjs

@@ -3663,20 +3663,33 @@ var autoGenFilterConfigsFromTpl = ({
 };
 
 // src/utils/genCleanCamelCaseId.ts
-var genCleanCamelCaseId = (id) => {
+var genCleanCamelCaseId = (id, options) => {
   if (!id || typeof id !== "string") return id;
-  const isAlreadyClean = /^\p{Ll}[\p{L}\p{N}]*$/u.test(id) || /^a\d[\p{L}\p{N}]*$/u.test(id);
-  if (isAlreadyClean) return id;
+  const { stripNonAlphanumeric = false, maxLength } = options || {};
+  const baseClean = /^\p{Ll}[\p{L}\p{N}]*$/u.test(id) || /^a\d[\p{L}\p{N}]*$/u.test(id);
+  const withinMaxLength = maxLength ? id.length <= maxLength : true;
+  const hasNoNonAlpha = stripNonAlphanumeric ? /^[a-zA-Z0-9]+$/.test(id) : true;
+  if (baseClean && withinMaxLength && hasNoNonAlpha) return id;
   const words = id.split(/[^\p{L}\p{N}]+/u).filter(Boolean);
   if (words.length === 0) return "a";
-  const result = words.map((word, i) => {
+  let result = words.map((word, i) => {
     const lower = word.toLowerCase();
     return i === 0 ? lower : lower.charAt(0).toUpperCase() + lower.slice(1);
   }).join("");
-  return /^\d/.test(result) ? "a" + result : result;
+  if (/^\d/.test(result)) result = "a" + result;
+  if (stripNonAlphanumeric) {
+    result = result.replace(/[^a-zA-Z0-9]/g, "");
+  }
+  if (maxLength) {
+    result = result.slice(0, maxLength);
+  }
+  return result;
 };
 
-// src/utils/genCleanIdForContentTypeAndValuePaths.ts
+// src/utils/genCleanContentTypeId.ts
+var genCleanContentTypeId = (text) => genCleanCamelCaseId(text, { stripNonAlphanumeric: true, maxLength: 40 });
+
+// src/utils/genCleanValuePath.ts
 var CHARS = "abcdefghijklmnopqrstuvwxyz0123456789";
 function genShortId(length = 4) {
   let result = "";
@@ -3685,11 +3698,15 @@ function genShortId(length = 4) {
   }
   return result;
 }
-var genCleanIdForContentTypeAndValuePaths = (text, maxLength = 10, shortIdLength = 4) => {
+var genCleanValuePath = (text) => {
+  const maxLength = 10;
+  const shortIdLength = 4;
   if (!text || typeof text !== "string") return text;
+  const idempotencyPattern = new RegExp(`^[a-z][a-z0-9]*_[a-z0-9]{${shortIdLength}}$`);
+  if (idempotencyPattern.test(text)) return text;
   let cleaned = text.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
   if (!cleaned) {
-    throw new Error(`[genCleanIdForContentTypeAndValuePaths] Input "${text}" contains no alphanumeric characters`);
+    throw new Error(`[genCleanValuePath] Input "${text}" contains no alphanumeric characters`);
   }
   if (/^\d/.test(cleaned)) cleaned = "a" + cleaned;
   const truncated = cleaned.slice(0, maxLength);
@@ -4128,7 +4145,8 @@ export {
   extractAllBlocksFromTpl,
   extractAndOrganizeBlocks,
   genCleanCamelCaseId,
-  genCleanIdForContentTypeAndValuePaths,
+  genCleanContentTypeId,
+  genCleanValuePath,
   genTagId,
   generateFilterKey,
   export_getAIChatModelByTenant as getAIChatModelByTenant,

package/dist/universal.d.mts

@@ -1260,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
@@ -1272,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_buildDocHierarchyConfig, _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/universal.d.ts

@@ -1260,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
@@ -1272,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_buildDocHierarchyConfig, _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/universal.js

@@ -35,7 +35,8 @@ __export(universal_exports, {
   extractAllBlocksFromTpl: () => extractAllBlocksFromTpl,
   extractAndOrganizeBlocks: () => extractAndOrganizeBlocks,
   genCleanCamelCaseId: () => genCleanCamelCaseId,
-  genCleanIdForContentTypeAndValuePaths: () => genCleanIdForContentTypeAndValuePaths,
+  genCleanContentTypeId: () => genCleanContentTypeId,
+  genCleanValuePath: () => genCleanValuePath,
   genTagId: () => genTagId,
   generateFilterKey: () => generateFilterKey,
   getFilterKeyForBlock: () => getFilterKeyForBlock,
@@ -2127,20 +2128,33 @@ var autoGenFilterConfigsFromTpl = ({
 };
 
 // src/utils/genCleanCamelCaseId.ts
-var genCleanCamelCaseId = (id) => {
+var genCleanCamelCaseId = (id, options) => {
   if (!id || typeof id !== "string") return id;
-  const isAlreadyClean = /^\p{Ll}[\p{L}\p{N}]*$/u.test(id) || /^a\d[\p{L}\p{N}]*$/u.test(id);
-  if (isAlreadyClean) return id;
+  const { stripNonAlphanumeric = false, maxLength } = options || {};
+  const baseClean = /^\p{Ll}[\p{L}\p{N}]*$/u.test(id) || /^a\d[\p{L}\p{N}]*$/u.test(id);
+  const withinMaxLength = maxLength ? id.length <= maxLength : true;
+  const hasNoNonAlpha = stripNonAlphanumeric ? /^[a-zA-Z0-9]+$/.test(id) : true;
+  if (baseClean && withinMaxLength && hasNoNonAlpha) return id;
   const words = id.split(/[^\p{L}\p{N}]+/u).filter(Boolean);
   if (words.length === 0) return "a";
-  const result = words.map((word, i) => {
+  let result = words.map((word, i) => {
     const lower = word.toLowerCase();
     return i === 0 ? lower : lower.charAt(0).toUpperCase() + lower.slice(1);
   }).join("");
-  return /^\d/.test(result) ? "a" + result : result;
+  if (/^\d/.test(result)) result = "a" + result;
+  if (stripNonAlphanumeric) {
+    result = result.replace(/[^a-zA-Z0-9]/g, "");
+  }
+  if (maxLength) {
+    result = result.slice(0, maxLength);
+  }
+  return result;
 };
 
-// src/utils/genCleanIdForContentTypeAndValuePaths.ts
+// src/utils/genCleanContentTypeId.ts
+var genCleanContentTypeId = (text) => genCleanCamelCaseId(text, { stripNonAlphanumeric: true, maxLength: 40 });
+
+// src/utils/genCleanValuePath.ts
 var CHARS = "abcdefghijklmnopqrstuvwxyz0123456789";
 function genShortId(length = 4) {
   let result = "";
@@ -2149,11 +2163,15 @@ function genShortId(length = 4) {
   }
   return result;
 }
-var genCleanIdForContentTypeAndValuePaths = (text, maxLength = 10, shortIdLength = 4) => {
+var genCleanValuePath = (text) => {
+  const maxLength = 10;
+  const shortIdLength = 4;
   if (!text || typeof text !== "string") return text;
+  const idempotencyPattern = new RegExp(`^[a-z][a-z0-9]*_[a-z0-9]{${shortIdLength}}$`);
+  if (idempotencyPattern.test(text)) return text;
   let cleaned = text.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
   if (!cleaned) {
-    throw new Error(`[genCleanIdForContentTypeAndValuePaths] Input "${text}" contains no alphanumeric characters`);
+    throw new Error(`[genCleanValuePath] Input "${text}" contains no alphanumeric characters`);
   }
   if (/^\d/.test(cleaned)) cleaned = "a" + cleaned;
   const truncated = cleaned.slice(0, maxLength);
@@ -2176,7 +2194,8 @@ var genCleanIdForContentTypeAndValuePaths = (text, maxLength = 10, shortIdLength
   extractAllBlocksFromTpl,
   extractAndOrganizeBlocks,
   genCleanCamelCaseId,
-  genCleanIdForContentTypeAndValuePaths,
+  genCleanContentTypeId,
+  genCleanValuePath,
   genTagId,
   generateFilterKey,
   getFilterKeyForBlock,

package/dist/universal.mjs

@@ -2070,20 +2070,33 @@ var autoGenFilterConfigsFromTpl = ({
 };
 
 // src/utils/genCleanCamelCaseId.ts
-var genCleanCamelCaseId = (id) => {
+var genCleanCamelCaseId = (id, options) => {
   if (!id || typeof id !== "string") return id;
-  const isAlreadyClean = /^\p{Ll}[\p{L}\p{N}]*$/u.test(id) || /^a\d[\p{L}\p{N}]*$/u.test(id);
-  if (isAlreadyClean) return id;
+  const { stripNonAlphanumeric = false, maxLength } = options || {};
+  const baseClean = /^\p{Ll}[\p{L}\p{N}]*$/u.test(id) || /^a\d[\p{L}\p{N}]*$/u.test(id);
+  const withinMaxLength = maxLength ? id.length <= maxLength : true;
+  const hasNoNonAlpha = stripNonAlphanumeric ? /^[a-zA-Z0-9]+$/.test(id) : true;
+  if (baseClean && withinMaxLength && hasNoNonAlpha) return id;
   const words = id.split(/[^\p{L}\p{N}]+/u).filter(Boolean);
   if (words.length === 0) return "a";
-  const result = words.map((word, i) => {
+  let result = words.map((word, i) => {
     const lower = word.toLowerCase();
     return i === 0 ? lower : lower.charAt(0).toUpperCase() + lower.slice(1);
   }).join("");
-  return /^\d/.test(result) ? "a" + result : result;
+  if (/^\d/.test(result)) result = "a" + result;
+  if (stripNonAlphanumeric) {
+    result = result.replace(/[^a-zA-Z0-9]/g, "");
+  }
+  if (maxLength) {
+    result = result.slice(0, maxLength);
+  }
+  return result;
 };
 
-// src/utils/genCleanIdForContentTypeAndValuePaths.ts
+// src/utils/genCleanContentTypeId.ts
+var genCleanContentTypeId = (text) => genCleanCamelCaseId(text, { stripNonAlphanumeric: true, maxLength: 40 });
+
+// src/utils/genCleanValuePath.ts
 var CHARS = "abcdefghijklmnopqrstuvwxyz0123456789";
 function genShortId(length = 4) {
   let result = "";
@@ -2092,11 +2105,15 @@ function genShortId(length = 4) {
   }
   return result;
 }
-var genCleanIdForContentTypeAndValuePaths = (text, maxLength = 10, shortIdLength = 4) => {
+var genCleanValuePath = (text) => {
+  const maxLength = 10;
+  const shortIdLength = 4;
   if (!text || typeof text !== "string") return text;
+  const idempotencyPattern = new RegExp(`^[a-z][a-z0-9]*_[a-z0-9]{${shortIdLength}}$`);
+  if (idempotencyPattern.test(text)) return text;
   let cleaned = text.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
   if (!cleaned) {
-    throw new Error(`[genCleanIdForContentTypeAndValuePaths] Input "${text}" contains no alphanumeric characters`);
+    throw new Error(`[genCleanValuePath] Input "${text}" contains no alphanumeric characters`);
   }
   if (/^\d/.test(cleaned)) cleaned = "a" + cleaned;
   const truncated = cleaned.slice(0, maxLength);
@@ -2118,7 +2135,8 @@ export {
   extractAllBlocksFromTpl,
   extractAndOrganizeBlocks,
   genCleanCamelCaseId,
-  genCleanIdForContentTypeAndValuePaths,
+  genCleanContentTypeId,
+  genCleanValuePath,
   genTagId,
   generateFilterKey,
   getFilterKeyForBlock,

package/package.json

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