@windrun-huaiin/lib 11.0.1 → 12.0.1

package/dist/common-app-config.d.ts

@@ -47,6 +47,7 @@ export declare function createCommonAppConfig(options?: {
     i18n: {
         locales: readonly string[];
         defaultLocale: string;
+        localPrefixAsNeeded: boolean;
         localeLabels: {
             [k: string]: "English" | "简体中文" | "日本語" | "한국어" | "Français" | "Deutsch" | "Español" | "Italiano" | "Português" | "Türkçe" | "Polski" | "Русский" | "العربية" | "हिन्दी" | "ไทย" | "Tiếng Việt";
         };

package/dist/common-app-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common-app-config.d.ts","sourceRoot":"","sources":["../src/common-app-config.ts"],"names":[],"mappings":"AACA,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;CAiBb,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAa7D,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE;IAE9C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;;;;;;;;;;;;;;;;;;;;;;;;;iBAqByB,SAAS,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgE1C;AAGD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC;gCACzD,MAAM,KAAG,MAAM,IAAI,CAAA,OAAO,UAAU,CAAC,OAAO,EAAC,MAAM,CAAC;6BAIvD,MAAM,KAAG,CAAA,OAAO,UAAU,CAAC,OAAO,EAAC,MAAM,CAAC;;;;;EAc3E;AAGD,eAAO,MAAM,cAAc;;iBAEK,MAAM,EAAE;uBAAyB,MAAM;;;iBAGnC,MAAM,EAAE;uBAAyB,MAAM;;;iBAG5B,MAAM,EAAE;uBAAyB,MAAM;;;iBAG/B,MAAM,EAAE;uBAAyB,MAAM;;;iBAGT,MAAM,EAAE;uBAAyB,MAAM;;;iBAGnG,MAAM,EAAE;uBAAyB,MAAM;;CAC/D,CAAC"}
+{"version":3,"file":"common-app-config.d.ts","sourceRoot":"","sources":["../src/common-app-config.ts"],"names":[],"mappings":"AACA,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;CAiBb,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAa7D,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE;IAE9C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;;;;;;;;;;;;;;;;;;;;;;;;;iBAqByB,SAAS,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiE1C;AAGD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC;gCACzD,MAAM,KAAG,MAAM,IAAI,CAAA,OAAO,UAAU,CAAC,OAAO,EAAC,MAAM,CAAC;6BAIvD,MAAM,KAAG,CAAA,OAAO,UAAU,CAAC,OAAO,EAAC,MAAM,CAAC;;;;;EAc3E;AAGD,eAAO,MAAM,cAAc;;iBAEK,MAAM,EAAE;uBAAyB,MAAM;;;iBAGnC,MAAM,EAAE;uBAAyB,MAAM;;;iBAG5B,MAAM,EAAE;uBAAyB,MAAM;;;iBAG/B,MAAM,EAAE;uBAAyB,MAAM;;;iBAGT,MAAM,EAAE;uBAAyB,MAAM;;;iBAGnG,MAAM,EAAE;uBAAyB,MAAM;;CAC/D,CAAC"}

package/dist/common-app-config.js

@@ -43,6 +43,7 @@ function createCommonAppConfig(options) {
         i18n: {
             locales: locales,
             defaultLocale,
+            localPrefixAsNeeded: process.env.NEXT_PUBLIC_I18N_LOCALE_PREFIX_AS_NEEDED !== 'false',
             localeLabels: getLocaleLabels(locales),
             detector: {
                 storageKey: process.env.NEXT_PUBLIC_I18N_STORAGE_KEY || 'language-preference-status',

package/dist/common-app-config.mjs

@@ -41,6 +41,7 @@ function createCommonAppConfig(options) {
         i18n: {
             locales: locales,
             defaultLocale,
+            localPrefixAsNeeded: process.env.NEXT_PUBLIC_I18N_LOCALE_PREFIX_AS_NEEDED !== 'false',
             localeLabels: getLocaleLabels(locales),
             detector: {
                 storageKey: process.env.NEXT_PUBLIC_I18N_STORAGE_KEY || 'language-preference-status',

package/dist/index.js

@@ -8,6 +8,7 @@ var commonAppConfig = require('./common-app-config.js');
 
 exports.cn = utils.cn;
 exports.formatTimestamp = utils.formatTimestamp;
+exports.getAsNeededLocalizedUrl = utils.getAsNeededLocalizedUrl;
 exports.handlePastePlainText = utils.handlePastePlainText;
 exports.viewLocalTime = utils.viewLocalTime;
 exports.getLLMText = llmUtils.getLLMText;

package/dist/index.mjs

@@ -1,3 +1,3 @@
-export { cn, formatTimestamp, handlePastePlainText, viewLocalTime } from './utils.mjs';
+export { cn, formatTimestamp, getAsNeededLocalizedUrl, handlePastePlainText, viewLocalTime } from './utils.mjs';
 export { getLLMText } from './llm-utils.mjs';
 export { LOCALE_PRESETS, createCommonAppConfig, createI18nHelpers } from './common-app-config.mjs';

package/dist/utils.d.ts

@@ -4,4 +4,5 @@ export declare function cn(...inputs: ClassValue[]): string;
 export declare function viewLocalTime(origin: Date | null): string;
 export declare function formatTimestamp(timestamp: string, formatter: string): string;
 export declare function handlePastePlainText(e: React.ClipboardEvent<HTMLElement>): void;
+export declare function getAsNeededLocalizedUrl(locale: string, path: string, localPrefixAsNeeded?: boolean, defaultLocale?: string): string;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,MAAM,CAAA;AAI5C,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,UAEhD;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,UA4BnE;AAGD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,QAgBxE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,MAAM,CAAA;AAI5C,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,UAEhD;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,UA4BnE;AAGD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,QAgBxE;AAkBD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,mBAAmB,GAAE,OAAc,EACnC,aAAa,GAAE,MAAa,GAC3B,MAAM,CAyBR"}

package/dist/utils.js

@@ -56,8 +56,46 @@ function handlePastePlainText(e) {
     selection.removeAllRanges();
     selection.addRange(range);
 }
+// Generates localized URL based on locale and locale prefix configuration
+// Supports both 'as-needed' and 'always' localePrefix configurations
+// Ensures URLs have proper trailing slash handling:
+// - Root path (domain only) has trailing slash: '/'
+// - All other paths have no trailing slash: '/blog', '/zh/blog', '/en'
+// @param locale - Current locale (e.g., 'en', 'zh', 'ja')
+// @param path - Base path (e.g., '/', '/blog', '/docs', or '' treated as '/')
+// @param localPrefixAsNeeded - Whether localePrefix is set to 'as-needed' (default: true)
+// @param defaultLocale - The default locale for the application (default: 'en')
+// @example
+//   getAsNeededLocalizedUrl('en', '/', true, 'en')       // Returns '/'
+//   getAsNeededLocalizedUrl('zh', '/', true, 'en')       // Returns '/zh'
+//   getAsNeededLocalizedUrl('en', '/blog', true, 'en')   // Returns '/blog'
+//   getAsNeededLocalizedUrl('zh', '/blog', true, 'en')   // Returns '/zh/blog'
+//   getAsNeededLocalizedUrl('en', '/blog/', true, 'en')  // Returns '/blog'
+//   getAsNeededLocalizedUrl('en', '/', false, 'en')      // Returns '/en'
+function getAsNeededLocalizedUrl(locale, path, localPrefixAsNeeded = true, defaultLocale = 'en') {
+    // Normalize path: empty string or undefined treated as '/'
+    let normalizedPath = (path || '/').trim();
+    // Ensure path starts with '/'
+    if (!normalizedPath.startsWith('/')) {
+        normalizedPath = '/' + normalizedPath;
+    }
+    // Remove trailing slashes except for root path '/'
+    if (normalizedPath !== '/' && normalizedPath.endsWith('/')) {
+        normalizedPath = normalizedPath.replace(/\/+$/, '');
+    }
+    // Return based on locale prefix configuration
+    if (localPrefixAsNeeded && locale === defaultLocale) {
+        return normalizedPath;
+    }
+    // Add locale prefix, but avoid double trailing slash when path is '/'
+    if (normalizedPath === '/') {
+        return `/${locale}`;
+    }
+    return `/${locale}${normalizedPath}`;
+}
 
 exports.cn = cn;
 exports.formatTimestamp = formatTimestamp;
+exports.getAsNeededLocalizedUrl = getAsNeededLocalizedUrl;
 exports.handlePastePlainText = handlePastePlainText;
 exports.viewLocalTime = viewLocalTime;

package/dist/utils.mjs

@@ -54,5 +54,42 @@ function handlePastePlainText(e) {
     selection.removeAllRanges();
     selection.addRange(range);
 }
+// Generates localized URL based on locale and locale prefix configuration
+// Supports both 'as-needed' and 'always' localePrefix configurations
+// Ensures URLs have proper trailing slash handling:
+// - Root path (domain only) has trailing slash: '/'
+// - All other paths have no trailing slash: '/blog', '/zh/blog', '/en'
+// @param locale - Current locale (e.g., 'en', 'zh', 'ja')
+// @param path - Base path (e.g., '/', '/blog', '/docs', or '' treated as '/')
+// @param localPrefixAsNeeded - Whether localePrefix is set to 'as-needed' (default: true)
+// @param defaultLocale - The default locale for the application (default: 'en')
+// @example
+//   getAsNeededLocalizedUrl('en', '/', true, 'en')       // Returns '/'
+//   getAsNeededLocalizedUrl('zh', '/', true, 'en')       // Returns '/zh'
+//   getAsNeededLocalizedUrl('en', '/blog', true, 'en')   // Returns '/blog'
+//   getAsNeededLocalizedUrl('zh', '/blog', true, 'en')   // Returns '/zh/blog'
+//   getAsNeededLocalizedUrl('en', '/blog/', true, 'en')  // Returns '/blog'
+//   getAsNeededLocalizedUrl('en', '/', false, 'en')      // Returns '/en'
+function getAsNeededLocalizedUrl(locale, path, localPrefixAsNeeded = true, defaultLocale = 'en') {
+    // Normalize path: empty string or undefined treated as '/'
+    let normalizedPath = (path || '/').trim();
+    // Ensure path starts with '/'
+    if (!normalizedPath.startsWith('/')) {
+        normalizedPath = '/' + normalizedPath;
+    }
+    // Remove trailing slashes except for root path '/'
+    if (normalizedPath !== '/' && normalizedPath.endsWith('/')) {
+        normalizedPath = normalizedPath.replace(/\/+$/, '');
+    }
+    // Return based on locale prefix configuration
+    if (localPrefixAsNeeded && locale === defaultLocale) {
+        return normalizedPath;
+    }
+    // Add locale prefix, but avoid double trailing slash when path is '/'
+    if (normalizedPath === '/') {
+        return `/${locale}`;
+    }
+    return `/${locale}${normalizedPath}`;
+}
 
-export { cn, formatTimestamp, handlePastePlainText, viewLocalTime };
+export { cn, formatTimestamp, getAsNeededLocalizedUrl, handlePastePlainText, viewLocalTime };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windrun-huaiin/lib",
-  "version": "11.0.1",
+  "version": "12.0.1",
   "description": "Common utilities and configuration",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/src/common-app-config.ts

@@ -58,6 +58,7 @@ export function createCommonAppConfig(options?: {
     i18n: {
       locales: locales as readonly string[],
       defaultLocale,
+      localPrefixAsNeeded: process.env.NEXT_PUBLIC_I18N_LOCALE_PREFIX_AS_NEEDED !== 'false',
       localeLabels: getLocaleLabels(locales),
       detector: {
         storageKey: process.env.NEXT_PUBLIC_I18N_STORAGE_KEY || 'language-preference-status',

package/src/utils.ts

@@ -39,7 +39,7 @@ export function formatTimestamp(timestamp: string, formatter: string) {
      console.error("Error formatting date:", error);
      return fail;
   }
-} 
+}
 
 // Only allow pasting plain text, prohibit style content
 export function handlePastePlainText(e: React.ClipboardEvent<HTMLElement>) {
@@ -58,4 +58,52 @@ export function handlePastePlainText(e: React.ClipboardEvent<HTMLElement>) {
   range.collapse(true);
   selection.removeAllRanges();
   selection.addRange(range);
+}
+
+// Generates localized URL based on locale and locale prefix configuration
+// Supports both 'as-needed' and 'always' localePrefix configurations
+// Ensures URLs have proper trailing slash handling:
+// - Root path (domain only) has trailing slash: '/'
+// - All other paths have no trailing slash: '/blog', '/zh/blog', '/en'
+// @param locale - Current locale (e.g., 'en', 'zh', 'ja')
+// @param path - Base path (e.g., '/', '/blog', '/docs', or '' treated as '/')
+// @param localPrefixAsNeeded - Whether localePrefix is set to 'as-needed' (default: true)
+// @param defaultLocale - The default locale for the application (default: 'en')
+// @example
+//   getAsNeededLocalizedUrl('en', '/', true, 'en')       // Returns '/'
+//   getAsNeededLocalizedUrl('zh', '/', true, 'en')       // Returns '/zh'
+//   getAsNeededLocalizedUrl('en', '/blog', true, 'en')   // Returns '/blog'
+//   getAsNeededLocalizedUrl('zh', '/blog', true, 'en')   // Returns '/zh/blog'
+//   getAsNeededLocalizedUrl('en', '/blog/', true, 'en')  // Returns '/blog'
+//   getAsNeededLocalizedUrl('en', '/', false, 'en')      // Returns '/en'
+export function getAsNeededLocalizedUrl(
+  locale: string,
+  path: string,
+  localPrefixAsNeeded: boolean = true,
+  defaultLocale: string = 'en'
+): string {
+  // Normalize path: empty string or undefined treated as '/'
+  let normalizedPath = (path || '/').trim();
+
+  // Ensure path starts with '/'
+  if (!normalizedPath.startsWith('/')) {
+    normalizedPath = '/' + normalizedPath;
+  }
+
+  // Remove trailing slashes except for root path '/'
+  if (normalizedPath !== '/' && normalizedPath.endsWith('/')) {
+    normalizedPath = normalizedPath.replace(/\/+$/, '');
+  }
+
+  // Return based on locale prefix configuration
+  if (localPrefixAsNeeded && locale === defaultLocale) {
+    return normalizedPath;
+  }
+
+  // Add locale prefix, but avoid double trailing slash when path is '/'
+  if (normalizedPath === '/') {
+    return `/${locale}`;
+  }
+
+  return `/${locale}${normalizedPath}`;
 }