svelte-intlayer 9.1.0 → 9.1.2

package/dist/client/intlayerContext.d.ts

@@ -1,7 +1,18 @@
-import type { LocalesValues } from '@intlayer/types/module_augmentation';
+import type { LocalesValues, ProviderVariant } from '@intlayer/types/module_augmentation';
 export interface IntlayerContextType {
     locale: LocalesValues;
     setLocale: (locale: LocalesValues) => void;
+    /**
+     * Ambient variant applied to every dictionary read below the provider, the
+     * same way `locale` is. Overridden per call by an explicit selector.
+     *
+     * Accepts a name (`'school1'`), an ordered preference chain
+     * (`['school1', 'default']`), or a per-key map
+     * (`{ key1: 'school1', default: 'base' }`). A plain object is always the
+     * per-key map; nest a structured variant as `{ default: { id: 'prod_abc' } }`.
+     */
+    variant?: ProviderVariant;
+    setVariant?: (variant: ProviderVariant | undefined) => void;
     isCookieEnabled?: boolean;
 }
 export declare const setIntlayerContext: (context: IntlayerContextType) => void;

package/dist/client/setupIntlayer.svelte.d.ts

@@ -1,4 +1,4 @@
-import type { LocalesValues } from '@intlayer/types/module_augmentation';
+import type { LocalesValues, ProviderVariant } from '@intlayer/types/module_augmentation';
 /**
  * Setups Intlayer in your Svelte application.
  *
@@ -6,6 +6,13 @@ import type { LocalesValues } from '@intlayer/types/module_augmentation';
  * It should be called at the root of your application (e.g., in a top-level layout).
  *
  * @param initialLocale - The initial locale to use.
+ * @param variant - Ambient variant applied to every dictionary read below this
+ *   setup — for a dimension fixed for the whole session (tenant, school type,
+ *   plan tier…) that no component should have to pass by hand. Accepts a name
+ *   (`'school1'`), an ordered preference chain (`['school1', 'default']`), or a
+ *   per-key map (`{ key1: 'school1', default: 'base' }`). A plain object is
+ *   always the per-key map; nest a structured variant as
+ *   `{ default: { id: 'prod_abc' } }`. A call-site selector always wins.
  * @returns An object containing the reactive locale and a setter function.
  *
  * @example
@@ -13,10 +20,14 @@ import type { LocalesValues } from '@intlayer/types/module_augmentation';
  * <script>
  *   import { setupIntlayer } from 'svelte-intlayer';
  *   const { locale } = setupIntlayer('en');
+ *   // ambient variant for the whole app
+ *   setupIntlayer('en', 'school1');
  * </script>
  * ```
  */
-export declare const setupIntlayer: (initialLocale?: LocalesValues) => {
+export declare const setupIntlayer: (initialLocale?: LocalesValues, initialVariant?: ProviderVariant) => {
     readonly locale: any;
     setLocale: (newLocale: LocalesValues) => void;
+    readonly variant: ProviderVariant | undefined;
+    setVariant: (newVariant: ProviderVariant | undefined) => void;
 };

package/dist/client/setupIntlayer.svelte.js

@@ -11,6 +11,13 @@ import { intlayerStore } from './intlayerStore';
  * It should be called at the root of your application (e.g., in a top-level layout).
  *
  * @param initialLocale - The initial locale to use.
+ * @param variant - Ambient variant applied to every dictionary read below this
+ *   setup — for a dimension fixed for the whole session (tenant, school type,
+ *   plan tier…) that no component should have to pass by hand. Accepts a name
+ *   (`'school1'`), an ordered preference chain (`['school1', 'default']`), or a
+ *   per-key map (`{ key1: 'school1', default: 'base' }`). A plain object is
+ *   always the per-key map; nest a structured variant as
+ *   `{ default: { id: 'prod_abc' } }`. A call-site selector always wins.
  * @returns An object containing the reactive locale and a setter function.
  *
  * @example
@@ -18,16 +25,19 @@ import { intlayerStore } from './intlayerStore';
  * <script>
  *   import { setupIntlayer } from 'svelte-intlayer';
  *   const { locale } = setupIntlayer('en');
+ *   // ambient variant for the whole app
+ *   setupIntlayer('en', 'school1');
  * </script>
  * ```
  */
-export const setupIntlayer = (initialLocale) => {
+export const setupIntlayer = (initialLocale, initialVariant) => {
     setIntlayerIdentifier();
     useEditor();
     useAnalytics();
     // Create Reactive State (Svelte 5)
     // We make the locale a "rune" so updates propagate
     let locale = $state(initialLocale);
+    let variant = $state(initialVariant);
     // Keep intlayerStore in sync so useEditor can subscribe to it
     if (initialLocale) {
         intlayerStore.setLocale(initialLocale);
@@ -41,6 +51,12 @@ export const setupIntlayer = (initialLocale) => {
             locale = newLocale;
             intlayerStore.setLocale(newLocale);
         },
+        get variant() {
+            return variant;
+        },
+        setVariant: (newVariant) => {
+            variant = newVariant;
+        },
     };
     // Set the Context
     setIntlayerContext(contextValue);

package/dist/client/useDictionary.d.ts

@@ -1,5 +1,5 @@
 import type { Dictionary, DictionarySelectorForGroup, QualifiedDictionaryGroup, ResolveQualifiedDictionaryContent } from '@intlayer/types/dictionary';
-import type { DeclaredLocales, ExtractSelectorLocale, LocalesValues } from '@intlayer/types/module_augmentation';
+import type { DeclaredLocales, ExtractSelectorLocale } from '@intlayer/types/module_augmentation';
 import { type Readable } from 'svelte/store';
 import type { DeepTransformContent } from '../plugins';
 /**
@@ -10,4 +10,4 @@ import type { DeepTransformContent } from '../plugins';
  * @param localeOrSelector The target locale or selector (optional)
  * @returns Reactive store with transformed dictionary content
  */
-export declare const useDictionary: <const T extends Dictionary | QualifiedDictionaryGroup, const A extends LocalesValues | DictionarySelectorForGroup<T> = DeclaredLocales>(dictionary: T, localeOrSelector?: A) => Readable<DeepTransformContent<ResolveQualifiedDictionaryContent<T, A>, ExtractSelectorLocale<A>>>;
+export declare const useDictionary: <const T extends Dictionary | QualifiedDictionaryGroup, const A extends DeclaredLocales | DictionarySelectorForGroup<T> = DeclaredLocales>(dictionary: T, localeOrSelector?: A) => Readable<DeepTransformContent<ResolveQualifiedDictionaryContent<T, A>, ExtractSelectorLocale<A>>>;

package/dist/client/useDictionary.js

@@ -1,3 +1,4 @@
+import { resolveDictionaryArgument } from '@intlayer/core/dictionaryManipulator';
 import { derived } from 'svelte/store';
 import { getDictionary } from '../getDictionary';
 import { getIntlayerContext } from './intlayerContext';
@@ -12,17 +13,19 @@ import { intlayerStore } from './intlayerStore';
  */
 export const useDictionary = (dictionary, localeOrSelector) => {
     const context = getIntlayerContext();
-    const isSelector = process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false' &&
-        typeof localeOrSelector === 'object' &&
-        localeOrSelector !== null;
     // Create a derived store that reactively updates when locale changes
     return derived([intlayerStore], ([$store]) => {
         const contextLocale = context?.locale ?? $store.locale;
-        if (isSelector) {
-            return getDictionary(dictionary, {
-                ...localeOrSelector,
-                locale: localeOrSelector.locale ?? contextLocale,
-            });
+        if (process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false') {
+            // Layers the provider's locale and variant under the call-site argument.
+            // This is also the seam the build-time optimize transform lands on, which
+            // rewrites `useIntlayer('key', selector)` into `useDictionary(dict, …)`.
+            return getDictionary(dictionary, resolveDictionaryArgument({
+                localeOrSelector,
+                contextLocale,
+                contextVariant: context?.variant,
+                dictionaryKey: dictionary.key,
+            }));
         }
         return getDictionary(dictionary, (localeOrSelector ?? contextLocale));
     });

package/dist/client/useDictionaryDynamic.d.ts

@@ -1,6 +1,6 @@
 import { type QualifiedDynamicLoaderMap } from '@intlayer/core/dictionaryManipulator';
 import type { Dictionary } from '@intlayer/types/dictionary';
-import type { DictionaryKeys, DictionarySelectorForKey, LocalesValues, StrictModeLocaleMap } from '@intlayer/types/module_augmentation';
+import type { DeclaredLocales, DictionaryKeys, DictionarySelectorForKey, StrictModeLocaleMap } from '@intlayer/types/module_augmentation';
 import { type Readable } from 'svelte/store';
 import type { DeepTransformContent } from '../plugins';
 /**
@@ -15,7 +15,7 @@ import type { DeepTransformContent } from '../plugins';
  * @param localeOrSelector - Optional fixed locale or selector.
  * @returns Readable store with the loaded dictionary content.
  */
-export declare function useDictionaryDynamic<const T extends Dictionary, const K extends DictionaryKeys, const A extends LocalesValues | DictionarySelectorForKey<K> = LocalesValues>(dictionaryPromise: StrictModeLocaleMap<() => Promise<T>> | QualifiedDynamicLoaderMap, key: K, localeOrSelector?: A): Readable<DeepTransformContent<T['content']> & {
+export declare function useDictionaryDynamic<const T extends Dictionary, const K extends DictionaryKeys, const A extends DeclaredLocales | DictionarySelectorForKey<K> = DeclaredLocales>(dictionaryPromise: StrictModeLocaleMap<() => Promise<T>> | QualifiedDynamicLoaderMap, key: K, localeOrSelector?: A): Readable<DeepTransformContent<T['content']> & {
     isLoading: boolean;
     error: Error | null;
 }>;

package/dist/client/useDictionaryDynamic.js

@@ -1,4 +1,4 @@
-import { isQualifiedDynamicLoaderMap, resolveQualifiedDynamicContentAsync, } from '@intlayer/core/dictionaryManipulator';
+import { isQualifiedDynamicLoaderMap, resolveProviderVariant, resolveQualifiedDynamicContentAsync, } from '@intlayer/core/dictionaryManipulator';
 import { derived } from 'svelte/store';
 import { getDictionary } from '../getDictionary';
 import { getIntlayerContext } from './intlayerContext';
@@ -57,9 +57,15 @@ export function useDictionaryDynamic(dictionaryPromise, key, localeOrSelector) {
     const isSelector = process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false' &&
         typeof localeOrSelector === 'object' &&
         localeOrSelector !== null;
-    const selector = isSelector
+    const callSelector = isSelector
         ? localeOrSelector
         : undefined;
+    // Layers the provider's ambient variant under the call-site selector, so only
+    // the targeted chunk is loaded. A call-site variant always wins.
+    const variant = callSelector?.variant ?? resolveProviderVariant(context?.variant, key);
+    const selector = variant !== undefined
+        ? { ...callSelector, variant }
+        : callSelector;
     const explicitLocale = isSelector
         ? localeOrSelector.locale
         : localeOrSelector;

package/dist/client/useIntlayer.d.ts

@@ -1,4 +1,4 @@
-import type { DeclaredLocales, DictionaryKeys, DictionaryRegistryResult, DictionarySelectorForKey, ExtractSelectorLocale, LocalesValues } from '@intlayer/types/module_augmentation';
+import type { DeclaredLocales, DictionaryKeys, DictionaryRegistryResult, DictionarySelectorForKey, ExtractSelectorLocale } from '@intlayer/types/module_augmentation';
 import { type Readable } from 'svelte/store';
 import type { DeepTransformContent } from '../plugins';
 /**
@@ -26,4 +26,4 @@ import type { DeepTransformContent } from '../plugins';
  * <div>{$content.myField.value}</div>
  * ```
  */
-export declare const useIntlayer: <const T extends DictionaryKeys, const A extends LocalesValues | DictionarySelectorForKey<T> = DeclaredLocales>(key: T, localeOrSelector?: A) => Readable<DeepTransformContent<DictionaryRegistryResult<T, A>, ExtractSelectorLocale<A>>>;
+export declare const useIntlayer: <const T extends DictionaryKeys, const A extends DeclaredLocales | DictionarySelectorForKey<T> = DeclaredLocales>(key: T, localeOrSelector?: A) => Readable<DeepTransformContent<DictionaryRegistryResult<T, A>, ExtractSelectorLocale<A>>>;

package/dist/client/useIntlayer.js

@@ -1,3 +1,4 @@
+import { resolveDictionaryArgument } from '@intlayer/core/dictionaryManipulator';
 import { derived } from 'svelte/store';
 import { getIntlayer } from '../getIntlayer';
 import { getIntlayerContext } from './intlayerContext';
@@ -29,17 +30,17 @@ import { intlayerStore } from './intlayerStore';
  */
 export const useIntlayer = (key, localeOrSelector) => {
     const context = getIntlayerContext();
-    const isSelector = process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false' &&
-        typeof localeOrSelector === 'object' &&
-        localeOrSelector !== null;
     // Create a derived store that reactively updates when locale changes
     return derived([intlayerStore], ([$store]) => {
         const contextLocale = context?.locale ?? $store.locale;
-        if (isSelector) {
-            return getIntlayer(key, {
-                ...localeOrSelector,
-                locale: localeOrSelector.locale ?? contextLocale,
-            });
+        if (process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false') {
+            // Layers the provider's locale and variant under the call-site argument.
+            return getIntlayer(key, resolveDictionaryArgument({
+                localeOrSelector,
+                contextLocale,
+                contextVariant: context?.variant,
+                dictionaryKey: key,
+            }));
         }
         return getIntlayer(key, (localeOrSelector ?? contextLocale));
     });

package/dist/getDictionary.d.ts

@@ -1,5 +1,5 @@
 import type { Dictionary, DictionarySelectorForGroup, QualifiedDictionaryGroup, ResolveQualifiedDictionaryContent } from '@intlayer/types/dictionary';
-import type { DeclaredLocales, ExtractSelectorLocale, LocalesValues } from '@intlayer/types/module_augmentation';
+import type { DeclaredLocales, ExtractSelectorLocale } from '@intlayer/types/module_augmentation';
 import { type DeepTransformContent } from './plugins';
 /**
  * Get content for a dictionary (or qualified dictionary group) in Svelte
@@ -10,4 +10,4 @@ import { type DeepTransformContent } from './plugins';
  * @param localeOrSelector The target locale or selector (optional)
  * @returns Transformed dictionary content optimized for Svelte
  */
-export declare const getDictionary: <const T extends Dictionary | QualifiedDictionaryGroup, const A extends LocalesValues | DictionarySelectorForGroup<T> = DeclaredLocales>(dictionary: T, localeOrSelector?: A) => DeepTransformContent<ResolveQualifiedDictionaryContent<T, A>, ExtractSelectorLocale<A>>;
+export declare const getDictionary: <const T extends Dictionary | QualifiedDictionaryGroup, const A extends DeclaredLocales | DictionarySelectorForGroup<T> = DeclaredLocales>(dictionary: T, localeOrSelector?: A) => DeepTransformContent<ResolveQualifiedDictionaryContent<T, A>, ExtractSelectorLocale<A>>;

package/dist/getIntlayer.d.ts

@@ -1,4 +1,4 @@
-import type { DeclaredLocales, DictionaryKeys, DictionaryRegistryResult, DictionarySelectorForKey, ExtractSelectorLocale, LocalesValues } from '@intlayer/types/module_augmentation';
+import type { DeclaredLocales, DictionaryKeys, DictionaryRegistryResult, DictionarySelectorForKey, ExtractSelectorLocale } from '@intlayer/types/module_augmentation';
 import { type DeepTransformContent } from './plugins';
 /**
  * Get dictionary content by key for Svelte applications.
@@ -10,4 +10,4 @@ import { type DeepTransformContent } from './plugins';
  * @param localeOrSelector The target locale or selector (optional)
  * @returns Transformed dictionary content optimized for Svelte
  */
-export declare const getIntlayer: <const T extends DictionaryKeys, const A extends LocalesValues | DictionarySelectorForKey<T> = DeclaredLocales>(key: T, localeOrSelector?: A) => DeepTransformContent<DictionaryRegistryResult<T, A>, ExtractSelectorLocale<A>>;
+export declare const getIntlayer: <const T extends DictionaryKeys, const A extends DeclaredLocales | DictionarySelectorForKey<T> = DeclaredLocales>(key: T, localeOrSelector?: A) => DeepTransformContent<DictionaryRegistryResult<T, A>, ExtractSelectorLocale<A>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svelte-intlayer",
-  "version": "9.1.0",
+  "version": "9.1.2",
   "description": "Easily internationalize i18n your Svelte applications with type-safe multilingual content management.",
   "keywords": [
     "intlayer",
@@ -82,11 +82,11 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/api": "9.1.0",
-    "@intlayer/config": "9.1.0",
-    "@intlayer/core": "9.1.0",
-    "@intlayer/editor": "9.1.0",
-    "@intlayer/types": "9.1.0"
+    "@intlayer/api": "9.1.2",
+    "@intlayer/config": "9.1.2",
+    "@intlayer/core": "9.1.2",
+    "@intlayer/editor": "9.1.2",
+    "@intlayer/types": "9.1.2"
   },
   "devDependencies": {
     "@sveltejs/adapter-auto": "7.0.1",
@@ -108,7 +108,7 @@
     "svelte": ">=5.0.0"
   },
   "optionalDependencies": {
-    "@intlayer/analytics": "9.1.0"
+    "@intlayer/analytics": "9.1.2"
   },
   "engines": {
     "node": ">=14.18"