vanilla-intlayer 8.9.3 → 8.9.4-canary.0

package/dist/cjs/client/useLocale.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useLocale.cjs","names":["getIntlayerClient","internationalization"],"sources":["../../../src/client/useLocale.ts"],"sourcesContent":["import { internationalization } from '@intlayer/config/built';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { getIntlayerClient } from './installIntlayer';\nimport { setLocaleInStorage } from './useLocaleStorage';\n\ntype UseLocaleProps = {\n  isCookieEnabled?: boolean;\n  onLocaleChange?: (locale: LocalesValues) => void;\n};\n\n/**\n * Get the current locale state and locale management utilities.\n *\n * Returns a plain object with the current `locale`, `defaultLocale`,\n * `availableLocales`, a `setLocale` function, and a `subscribe` function\n * to react to locale changes.\n *\n * @param props - Optional configuration.\n * @returns Locale state and management utilities.\n *\n * @example\n * ```ts\n * import { installIntlayer, useLocale } from 'vanilla-intlayer';\n *\n * installIntlayer('en');\n *\n * const { locale, availableLocales, setLocale, subscribe } = useLocale();\n *\n * const unsubscribe = subscribe((newLocale) => {\n *   console.log('Locale changed to', newLocale);\n * });\n *\n * document.querySelector('#lang-switcher').addEventListener('change', (e) => {\n *   setLocale(e.target.value);\n * });\n * ```\n */\nexport const useLocale = (\n  props: UseLocaleProps = {}\n): {\n  locale: DeclaredLocales;\n  defaultLocale: DeclaredLocales;\n  availableLocales: DeclaredLocales[];\n  setLocale: (newLocale: LocalesValues) => void;\n  subscribe: (callback: (locale: LocalesValues) => void) => () => void;\n} => {\n  const client = getIntlayerClient();\n  const { defaultLocale, locales: availableLocales } =\n    internationalization ?? {};\n\n  const setLocale = (newLocale: LocalesValues): void => {\n    if (!(availableLocales ?? []).map(String).includes(newLocale)) {\n      console.error(`Locale \"${newLocale}\" is not available.`);\n      return;\n    }\n\n    client.setLocale(newLocale);\n\n    setLocaleInStorage(\n      newLocale,\n      props.isCookieEnabled ?? client.isCookieEnabled ?? true\n    );\n\n    props.onLocaleChange?.(newLocale);\n  };\n\n  return {\n    locale: client.locale as DeclaredLocales,\n    defaultLocale: defaultLocale as DeclaredLocales,\n    availableLocales: (availableLocales ?? []) as DeclaredLocales[],\n    setLocale,\n    subscribe: (callback) => client.subscribe(callback),\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,MAAa,aACX,QAAwB,EAAE,KAOvB;CACH,MAAM,SAASA,kDAAmB;CAClC,MAAM,EAAE,eAAe,SAAS,qBAC9BC,+CAAwB,EAAE;CAE5B,MAAM,aAAa,cAAmC;EACpD,IAAI,EAAE,oBAAoB,EAAE,EAAE,IAAI,OAAO,CAAC,SAAS,UAAU,EAAE;GAC7D,QAAQ,MAAM,WAAW,UAAU,qBAAqB;GACxD;;EAGF,OAAO,UAAU,UAAU;EAE3B,mDACE,WACA,MAAM,mBAAmB,OAAO,mBAAmB,KACpD;EAED,MAAM,iBAAiB,UAAU;;CAGnC,OAAO;EACL,QAAQ,OAAO;EACA;EACf,kBAAmB,oBAAoB,EAAE;EACzC;EACA,YAAY,aAAa,OAAO,UAAU,SAAS;EACpD"}
+{"version":3,"file":"useLocale.cjs","names":["getIntlayerClient","internationalization"],"sources":["../../../src/client/useLocale.ts"],"sourcesContent":["import { internationalization } from '@intlayer/config/built';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { getIntlayerClient } from './installIntlayer';\nimport { setLocaleInStorage } from './useLocaleStorage';\n\nexport type UseLocaleProps = {\n  isCookieEnabled?: boolean;\n  onLocaleChange?: (locale: DeclaredLocales) => void;\n};\n\nexport type UseLocaleResult = {\n  locale: DeclaredLocales;\n  defaultLocale: DeclaredLocales;\n  availableLocales: DeclaredLocales[];\n  setLocale: (locale: LocalesValues) => void;\n  subscribe: (callback: (locale: LocalesValues) => void) => () => void;\n};\n\n/**\n * Get the current locale state and locale management utilities.\n *\n * Returns a plain object with the current `locale`, `defaultLocale`,\n * `availableLocales`, a `setLocale` function, and a `subscribe` function\n * to react to locale changes.\n *\n * @param props - Optional configuration.\n * @returns Locale state and management utilities.\n *\n * @example\n * ```ts\n * import { installIntlayer, useLocale } from 'vanilla-intlayer';\n *\n * installIntlayer('en');\n *\n * const { locale, availableLocales, setLocale, subscribe } = useLocale();\n *\n * const unsubscribe = subscribe((newLocale) => {\n *   console.log('Locale changed to', newLocale);\n * });\n *\n * document.querySelector('#lang-switcher').addEventListener('change', (e) => {\n *   setLocale(e.target.value);\n * });\n * ```\n */\nexport const useLocale = (props: UseLocaleProps = {}): UseLocaleResult => {\n  const client = getIntlayerClient();\n  const { defaultLocale, locales: availableLocales } =\n    internationalization ?? {};\n\n  const setLocale = (newLocale: LocalesValues): void => {\n    if (!(availableLocales ?? []).map(String).includes(newLocale)) {\n      console.error(`Locale \"${newLocale}\" is not available.`);\n      return;\n    }\n\n    client.setLocale(newLocale);\n\n    setLocaleInStorage(\n      newLocale,\n      props.isCookieEnabled ?? client.isCookieEnabled ?? true\n    );\n\n    props.onLocaleChange?.(newLocale as DeclaredLocales);\n  };\n\n  return {\n    locale: client.locale as DeclaredLocales,\n    defaultLocale: defaultLocale as DeclaredLocales,\n    availableLocales: (availableLocales ?? []) as DeclaredLocales[],\n    setLocale,\n    subscribe: (callback) => client.subscribe(callback),\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDA,MAAa,aAAa,QAAwB,EAAE,KAAsB;CACxE,MAAM,SAASA,kDAAmB;CAClC,MAAM,EAAE,eAAe,SAAS,qBAC9BC,+CAAwB,EAAE;CAE5B,MAAM,aAAa,cAAmC;EACpD,IAAI,EAAE,oBAAoB,EAAE,EAAE,IAAI,OAAO,CAAC,SAAS,UAAU,EAAE;GAC7D,QAAQ,MAAM,WAAW,UAAU,qBAAqB;GACxD;;EAGF,OAAO,UAAU,UAAU;EAE3B,mDACE,WACA,MAAM,mBAAmB,OAAO,mBAAmB,KACpD;EAED,MAAM,iBAAiB,UAA6B;;CAGtD,OAAO;EACL,QAAQ,OAAO;EACA;EACf,kBAAmB,oBAAoB,EAAE;EACzC;EACA,YAAY,aAAa,OAAO,UAAU,SAAS;EACpD"}

package/dist/esm/client/useLocale.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useLocale.mjs","names":[],"sources":["../../../src/client/useLocale.ts"],"sourcesContent":["import { internationalization } from '@intlayer/config/built';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { getIntlayerClient } from './installIntlayer';\nimport { setLocaleInStorage } from './useLocaleStorage';\n\ntype UseLocaleProps = {\n  isCookieEnabled?: boolean;\n  onLocaleChange?: (locale: LocalesValues) => void;\n};\n\n/**\n * Get the current locale state and locale management utilities.\n *\n * Returns a plain object with the current `locale`, `defaultLocale`,\n * `availableLocales`, a `setLocale` function, and a `subscribe` function\n * to react to locale changes.\n *\n * @param props - Optional configuration.\n * @returns Locale state and management utilities.\n *\n * @example\n * ```ts\n * import { installIntlayer, useLocale } from 'vanilla-intlayer';\n *\n * installIntlayer('en');\n *\n * const { locale, availableLocales, setLocale, subscribe } = useLocale();\n *\n * const unsubscribe = subscribe((newLocale) => {\n *   console.log('Locale changed to', newLocale);\n * });\n *\n * document.querySelector('#lang-switcher').addEventListener('change', (e) => {\n *   setLocale(e.target.value);\n * });\n * ```\n */\nexport const useLocale = (\n  props: UseLocaleProps = {}\n): {\n  locale: DeclaredLocales;\n  defaultLocale: DeclaredLocales;\n  availableLocales: DeclaredLocales[];\n  setLocale: (newLocale: LocalesValues) => void;\n  subscribe: (callback: (locale: LocalesValues) => void) => () => void;\n} => {\n  const client = getIntlayerClient();\n  const { defaultLocale, locales: availableLocales } =\n    internationalization ?? {};\n\n  const setLocale = (newLocale: LocalesValues): void => {\n    if (!(availableLocales ?? []).map(String).includes(newLocale)) {\n      console.error(`Locale \"${newLocale}\" is not available.`);\n      return;\n    }\n\n    client.setLocale(newLocale);\n\n    setLocaleInStorage(\n      newLocale,\n      props.isCookieEnabled ?? client.isCookieEnabled ?? true\n    );\n\n    props.onLocaleChange?.(newLocale);\n  };\n\n  return {\n    locale: client.locale as DeclaredLocales,\n    defaultLocale: defaultLocale as DeclaredLocales,\n    availableLocales: (availableLocales ?? []) as DeclaredLocales[],\n    setLocale,\n    subscribe: (callback) => client.subscribe(callback),\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,MAAa,aACX,QAAwB,EAAE,KAOvB;CACH,MAAM,SAAS,mBAAmB;CAClC,MAAM,EAAE,eAAe,SAAS,qBAC9B,wBAAwB,EAAE;CAE5B,MAAM,aAAa,cAAmC;EACpD,IAAI,EAAE,oBAAoB,EAAE,EAAE,IAAI,OAAO,CAAC,SAAS,UAAU,EAAE;GAC7D,QAAQ,MAAM,WAAW,UAAU,qBAAqB;GACxD;;EAGF,OAAO,UAAU,UAAU;EAE3B,mBACE,WACA,MAAM,mBAAmB,OAAO,mBAAmB,KACpD;EAED,MAAM,iBAAiB,UAAU;;CAGnC,OAAO;EACL,QAAQ,OAAO;EACA;EACf,kBAAmB,oBAAoB,EAAE;EACzC;EACA,YAAY,aAAa,OAAO,UAAU,SAAS;EACpD"}
+{"version":3,"file":"useLocale.mjs","names":[],"sources":["../../../src/client/useLocale.ts"],"sourcesContent":["import { internationalization } from '@intlayer/config/built';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { getIntlayerClient } from './installIntlayer';\nimport { setLocaleInStorage } from './useLocaleStorage';\n\nexport type UseLocaleProps = {\n  isCookieEnabled?: boolean;\n  onLocaleChange?: (locale: DeclaredLocales) => void;\n};\n\nexport type UseLocaleResult = {\n  locale: DeclaredLocales;\n  defaultLocale: DeclaredLocales;\n  availableLocales: DeclaredLocales[];\n  setLocale: (locale: LocalesValues) => void;\n  subscribe: (callback: (locale: LocalesValues) => void) => () => void;\n};\n\n/**\n * Get the current locale state and locale management utilities.\n *\n * Returns a plain object with the current `locale`, `defaultLocale`,\n * `availableLocales`, a `setLocale` function, and a `subscribe` function\n * to react to locale changes.\n *\n * @param props - Optional configuration.\n * @returns Locale state and management utilities.\n *\n * @example\n * ```ts\n * import { installIntlayer, useLocale } from 'vanilla-intlayer';\n *\n * installIntlayer('en');\n *\n * const { locale, availableLocales, setLocale, subscribe } = useLocale();\n *\n * const unsubscribe = subscribe((newLocale) => {\n *   console.log('Locale changed to', newLocale);\n * });\n *\n * document.querySelector('#lang-switcher').addEventListener('change', (e) => {\n *   setLocale(e.target.value);\n * });\n * ```\n */\nexport const useLocale = (props: UseLocaleProps = {}): UseLocaleResult => {\n  const client = getIntlayerClient();\n  const { defaultLocale, locales: availableLocales } =\n    internationalization ?? {};\n\n  const setLocale = (newLocale: LocalesValues): void => {\n    if (!(availableLocales ?? []).map(String).includes(newLocale)) {\n      console.error(`Locale \"${newLocale}\" is not available.`);\n      return;\n    }\n\n    client.setLocale(newLocale);\n\n    setLocaleInStorage(\n      newLocale,\n      props.isCookieEnabled ?? client.isCookieEnabled ?? true\n    );\n\n    props.onLocaleChange?.(newLocale as DeclaredLocales);\n  };\n\n  return {\n    locale: client.locale as DeclaredLocales,\n    defaultLocale: defaultLocale as DeclaredLocales,\n    availableLocales: (availableLocales ?? []) as DeclaredLocales[],\n    setLocale,\n    subscribe: (callback) => client.subscribe(callback),\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDA,MAAa,aAAa,QAAwB,EAAE,KAAsB;CACxE,MAAM,SAAS,mBAAmB;CAClC,MAAM,EAAE,eAAe,SAAS,qBAC9B,wBAAwB,EAAE;CAE5B,MAAM,aAAa,cAAmC;EACpD,IAAI,EAAE,oBAAoB,EAAE,EAAE,IAAI,OAAO,CAAC,SAAS,UAAU,EAAE;GAC7D,QAAQ,MAAM,WAAW,UAAU,qBAAqB;GACxD;;EAGF,OAAO,UAAU,UAAU;EAE3B,mBACE,WACA,MAAM,mBAAmB,OAAO,mBAAmB,KACpD;EAED,MAAM,iBAAiB,UAA6B;;CAGtD,OAAO;EACL,QAAQ,OAAO;EACA;EACf,kBAAmB,oBAAoB,EAAE;EACzC;EACA,YAAY,aAAa,OAAO,UAAU,SAAS;EACpD"}

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

@@ -2,7 +2,7 @@ import { IntlayerClient, createIntlayerClient, getIntlayerClient, installIntlaye
 import { WithOnChange, useDictionary } from "./useDictionary.js";
 import { useDictionaryDynamic } from "./useDictionaryDynamic.js";
 import { useIntlayer } from "./useIntlayer.js";
-import { useLocale } from "./useLocale.js";
+import { UseLocaleProps, UseLocaleResult, useLocale } from "./useLocale.js";
 import { localeCookie, localeInStorage, setLocaleCookie, setLocaleInStorage, useLocaleCookie, useLocaleStorage } from "./useLocaleStorage.js";
 import { useRewriteURL } from "./useRewriteURL.js";
-export { IntlayerClient, WithOnChange, createIntlayerClient, getIntlayerClient, installIntlayer, localeCookie, localeInStorage, setLocaleCookie, setLocaleInStorage, useDictionary, useDictionaryDynamic, useIntlayer, useLocale, useLocaleCookie, useLocaleStorage, useRewriteURL };
+export { IntlayerClient, UseLocaleProps, UseLocaleResult, WithOnChange, createIntlayerClient, getIntlayerClient, installIntlayer, localeCookie, localeInStorage, setLocaleCookie, setLocaleInStorage, useDictionary, useDictionaryDynamic, useIntlayer, useLocale, useLocaleCookie, useLocaleStorage, useRewriteURL };

package/dist/types/client/useLocale.d.ts

@@ -3,7 +3,14 @@ import { DeclaredLocales, LocalesValues } from "@intlayer/types/module_augmentat
 //#region src/client/useLocale.d.ts
 type UseLocaleProps = {
   isCookieEnabled?: boolean;
-  onLocaleChange?: (locale: LocalesValues) => void;
+  onLocaleChange?: (locale: DeclaredLocales) => void;
+};
+type UseLocaleResult = {
+  locale: DeclaredLocales;
+  defaultLocale: DeclaredLocales;
+  availableLocales: DeclaredLocales[];
+  setLocale: (locale: LocalesValues) => void;
+  subscribe: (callback: (locale: LocalesValues) => void) => () => void;
 };
 /**
  * Get the current locale state and locale management utilities.
@@ -32,13 +39,7 @@ type UseLocaleProps = {
  * });
  * ```
  */
-declare const useLocale: (props?: UseLocaleProps) => {
-  locale: DeclaredLocales;
-  defaultLocale: DeclaredLocales;
-  availableLocales: DeclaredLocales[];
-  setLocale: (newLocale: LocalesValues) => void;
-  subscribe: (callback: (locale: LocalesValues) => void) => () => void;
-};
+declare const useLocale: (props?: UseLocaleProps) => UseLocaleResult;
 //#endregion
-export { useLocale };
+export { UseLocaleProps, UseLocaleResult, useLocale };
 //# sourceMappingURL=useLocale.d.ts.map

package/dist/types/client/useLocale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useLocale.d.ts","names":[],"sources":["../../../src/client/useLocale.ts"],"mappings":";;;KAQK,cAAA;EACH,eAAA;EACA,cAAA,IAAkB,MAAA,EAAQ,aAAA;AAAA;;;;;;;;;AA8B5B;;;;;;;;;;;;;;;;;;;cAAa,SAAA,GACX,KAAA,GAAO,cAAA;EAEP,MAAA,EAAQ,eAAA;EACR,aAAA,EAAe,eAAA;EACf,gBAAA,EAAkB,eAAA;EAClB,SAAA,GAAY,SAAA,EAAW,aAAA;EACvB,SAAA,GAAY,QAAA,GAAW,MAAA,EAAQ,aAAA;AAAA"}
+{"version":3,"file":"useLocale.d.ts","names":[],"sources":["../../../src/client/useLocale.ts"],"mappings":";;;KAQY,cAAA;EACV,eAAA;EACA,cAAA,IAAkB,MAAA,EAAQ,eAAA;AAAA;AAAA,KAGhB,eAAA;EACV,MAAA,EAAQ,eAAA;EACR,aAAA,EAAe,eAAA;EACf,gBAAA,EAAkB,eAAA;EAClB,SAAA,GAAY,MAAA,EAAQ,aAAA;EACpB,SAAA,GAAY,QAAA,GAAW,MAAA,EAAQ,aAAA;AAAA;;AALjC;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA;cAAa,SAAA,GAAa,KAAA,GAAO,cAAA,KAAsB,eAAA"}

package/dist/types/index.d.ts

@@ -3,7 +3,7 @@ import { DeepTransformContent, HTMLPluginCond, IInterpreterPluginState, IInterpr
 import { WithOnChange, useDictionary } from "./client/useDictionary.js";
 import { useDictionaryDynamic } from "./client/useDictionaryDynamic.js";
 import { useIntlayer } from "./client/useIntlayer.js";
-import { useLocale } from "./client/useLocale.js";
+import { UseLocaleProps, UseLocaleResult, useLocale } from "./client/useLocale.js";
 import { localeCookie, localeInStorage, setLocaleCookie, setLocaleInStorage, useLocaleCookie, useLocaleStorage } from "./client/useLocaleStorage.js";
 import { useRewriteURL } from "./client/useRewriteURL.js";
 import { useEditor } from "./editor/useEditor.js";
@@ -16,5 +16,5 @@ declare module '@intlayer/core/interpreter' {
   interface IInterpreterPlugin<T, S, L extends LocalesValues> extends IInterpreterPluginVanilla<T, S, L> {}
 }
 //#endregion
-export { DeepTransformContent, HTMLPluginCond, IInterpreterPluginState, IInterpreterPluginVanilla, InsertionCond, IntlayerClient, IntlayerNode, IntlayerNodeCond, MarkdownCond, MarkdownStringCond, WithOnChange, createIntlayerClient, getDictionary, getIntlayer, getIntlayerClient, getPlugins, htmlPlugin, insertionPlugin, installIntlayer, intlayerNodePlugins, localeCookie, localeInStorage, markdownPlugin, markdownStringPlugin, setLocaleCookie, setLocaleInStorage, useDictionary, useDictionaryDynamic, useEditor, useIntlayer, useLocale, useLocaleCookie, useLocaleStorage, useRewriteURL };
+export { DeepTransformContent, HTMLPluginCond, IInterpreterPluginState, IInterpreterPluginVanilla, InsertionCond, IntlayerClient, IntlayerNode, IntlayerNodeCond, MarkdownCond, MarkdownStringCond, UseLocaleProps, UseLocaleResult, WithOnChange, createIntlayerClient, getDictionary, getIntlayer, getIntlayerClient, getPlugins, htmlPlugin, insertionPlugin, installIntlayer, intlayerNodePlugins, localeCookie, localeInStorage, markdownPlugin, markdownStringPlugin, setLocaleCookie, setLocaleInStorage, useDictionary, useDictionaryDynamic, useEditor, useIntlayer, useLocale, useLocaleCookie, useLocaleStorage, useRewriteURL };
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vanilla-intlayer",
-  "version": "8.9.3",
+  "version": "8.9.4-canary.0",
   "private": false,
   "description": "Easily internationalize i18n your Vanilla JS, HTML, and PHP applications with type-safe multilingual content management.",
   "keywords": [
@@ -101,14 +101,14 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/api": "8.9.3",
-    "@intlayer/config": "8.9.3",
-    "@intlayer/core": "8.9.3",
-    "@intlayer/editor": "8.9.3",
-    "@intlayer/types": "8.9.3"
+    "@intlayer/api": "8.9.4-canary.0",
+    "@intlayer/config": "8.9.4-canary.0",
+    "@intlayer/core": "8.9.4-canary.0",
+    "@intlayer/editor": "8.9.4-canary.0",
+    "@intlayer/types": "8.9.4-canary.0"
   },
   "devDependencies": {
-    "@types/node": "25.6.1",
+    "@types/node": "25.6.2",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",
@@ -118,7 +118,7 @@
     "vitest": "4.1.5"
   },
   "peerDependencies": {
-    "intlayer": "8.9.3"
+    "intlayer": "8.9.4-canary.0"
   },
   "peerDependenciesMeta": {
     "intlayer": {