@intlayer/core 9.0.0-canary.1 → 9.0.0-canary.10

package/dist/types/localization/comparePaths.d.ts

@@ -0,0 +1,66 @@
+import { DeclaredLocales, LocalesValues } from "@intlayer/types/module_augmentation";
+
+//#region src/localization/comparePaths.d.ts
+/**
+ * Normalizes a URL or pathname into a canonical, locale-agnostic pathname so
+ * that two paths pointing to the same page compare equal — useful for
+ * highlighting the active navigation link.
+ *
+ * The normalization:
+ * - strips the locale segment (reusing {@link getPathWithoutLocale})
+ * - strips the protocol/host so absolute and relative inputs compare equally
+ * - drops the query string and hash
+ * - ensures a single leading slash
+ * - removes any trailing slash (except for the root path)
+ * - falls back to `'/'` for empty values
+ *
+ * Example:
+ *
+ * ```ts
+ * normalizePath('/ru/path')                    // '/path'
+ * normalizePath('/ru/path/')                   // '/path'
+ * normalizePath('ru/path')                     // '/path'
+ * normalizePath('/ru/')                        // '/'
+ * normalizePath('/ru')                         // '/'
+ * normalizePath('')                            // '/'
+ * normalizePath('https://example.com/ru/path') // '/path'
+ * ```
+ *
+ * @param inputUrl - The URL string or pathname to normalize.
+ * @param locales - Optional array of supported locales. Defaults to the
+ *   configured locales.
+ * @returns The normalized, locale-agnostic pathname.
+ */
+declare const normalizePath: <const L extends LocalesValues = DeclaredLocales>(inputUrl: string, locales?: L[]) => string;
+/**
+ * Compares two URLs or pathnames for equality, ignoring locale segment,
+ * protocol/host, query string, hash and trailing slashes.
+ *
+ * Both inputs are normalized through {@link normalizePath} before comparison,
+ * making this ideal for matching the current pathname against a navigation
+ * link's `href`.
+ *
+ * Example:
+ *
+ * ```ts
+ * comparePaths('/ru/path', '/path')   // true
+ * comparePaths('/ru/path/', '/path')  // true
+ * comparePaths('/ru/path', '/path/')  // true
+ * comparePaths('/ru/', '/')           // true
+ * comparePaths('/ru', '/')            // true
+ * comparePaths('ru/path', '/path')    // true
+ * comparePaths('', '/')               // true
+ * comparePaths('/ru', '')             // true
+ * comparePaths('/ru/path', '/other')  // false
+ * ```
+ *
+ * @param pathname - The first URL string or pathname to compare.
+ * @param href - The second URL string or pathname to compare.
+ * @param locales - Optional array of supported locales. Defaults to the
+ *   configured locales.
+ * @returns `true` when both inputs resolve to the same locale-agnostic path.
+ */
+declare const comparePaths: <const L extends LocalesValues = DeclaredLocales>(pathname: string, href: string, locales?: L[]) => boolean;
+//#endregion
+export { comparePaths, normalizePath };
+//# sourceMappingURL=comparePaths.d.ts.map

package/dist/types/localization/comparePaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparePaths.d.ts","names":[],"sources":["../../../src/localization/comparePaths.ts"],"mappings":";;;;;AAqCA;;;;;;;;;;;;;;;;AAiDA;;;;;;;;;;;;cAjDa,aAAA,mBAAiC,aAAA,GAAgB,eAAA,EAC5D,QAAA,UACA,OAAA,GAAU,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA+CC,YAAA,mBAAgC,aAAA,GAAgB,eAAA,EAC3D,QAAA,UACA,IAAA,UACA,OAAA,GAAU,CAAA"}

package/dist/types/localization/index.d.ts

@@ -1,3 +1,4 @@
+import { comparePaths, normalizePath } from "./comparePaths.js";
 import { GenerateSitemapOptions, SitemapUrlEntry, generateSitemap, generateSitemapUrl } from "./generateSitemap.js";
 import { getBrowserLocale } from "./getBrowserLocale.js";
 import { getHTMLTextDir } from "./getHTMLTextDir.js";
@@ -14,4 +15,4 @@ import { localeFlatMap, localeMap, localeRecord } from "./localeMapper.js";
 import { localeResolver } from "./localeResolver.js";
 import { LocalizedPathResult, getCanonicalPath, getInternalPath, getLocalizedPath, getRewritePath, getRewriteRules } from "./rewriteUtils.js";
 import { validatePrefix } from "./validatePrefix.js";
-export { type GenerateSitemapOptions, type GetPrefixOptions, type GetPrefixResult, type LocalizedPathResult, type SitemapUrlEntry, generateSitemap, generateSitemapUrl, getBrowserLocale, getCanonicalPath, getHTMLTextDir, getInternalPath, getLocale, getLocaleFromPath, getLocaleLang, getLocaleName, getLocalizedPath, getLocalizedUrl, getMultilingualUrls, getPathWithoutLocale, getPrefix, getRewritePath, getRewriteRules, localeDetector, localeFlatMap, localeMap, localeRecord, localeResolver, validatePrefix };
+export { type GenerateSitemapOptions, type GetPrefixOptions, type GetPrefixResult, type LocalizedPathResult, type SitemapUrlEntry, comparePaths, generateSitemap, generateSitemapUrl, getBrowserLocale, getCanonicalPath, getHTMLTextDir, getInternalPath, getLocale, getLocaleFromPath, getLocaleLang, getLocaleName, getLocalizedPath, getLocalizedUrl, getMultilingualUrls, getPathWithoutLocale, getPrefix, getRewritePath, getRewriteRules, localeDetector, localeFlatMap, localeMap, localeRecord, localeResolver, normalizePath, validatePrefix };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/core",
-  "version": "9.0.0-canary.1",
+  "version": "9.0.0-canary.10",
   "private": false,
   "description": "Includes core Intlayer functions like translation, dictionary, and utility functions shared across multiple packages.",
   "keywords": [
@@ -172,15 +172,15 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/api": "9.0.0-canary.1",
-    "@intlayer/config": "9.0.0-canary.1",
-    "@intlayer/dictionaries-entry": "9.0.0-canary.1",
-    "@intlayer/types": "9.0.0-canary.1",
-    "@intlayer/unmerged-dictionaries-entry": "9.0.0-canary.1",
+    "@intlayer/api": "9.0.0-canary.10",
+    "@intlayer/config": "9.0.0-canary.10",
+    "@intlayer/dictionaries-entry": "9.0.0-canary.10",
+    "@intlayer/types": "9.0.0-canary.10",
+    "@intlayer/unmerged-dictionaries-entry": "9.0.0-canary.10",
     "defu": "6.1.7"
   },
   "devDependencies": {
-    "@types/node": "25.9.3",
+    "@types/node": "25.9.4",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",