@intlayer/config 9.3.2 → 9.4.0-canary.0

package/dist/types/defaultValues/build.d.ts

@@ -7,6 +7,8 @@ declare const CACHE = true;
 declare const TYPE_CHECKING = false;
 declare const MINIFY = false;
 declare const PURGE = false;
+declare const CHUNK_GROUPING = true;
+declare const DICTIONARIES_PRELOAD = true;
 //#endregion
-export { BUILD_MODE, CACHE, MINIFY, OPTIMIZE, OUTPUT_FORMAT, PURGE, TRAVERSE_PATTERN, TYPE_CHECKING };
+export { BUILD_MODE, CACHE, CHUNK_GROUPING, DICTIONARIES_PRELOAD, MINIFY, OPTIMIZE, OUTPUT_FORMAT, PURGE, TRAVERSE_PATTERN, TYPE_CHECKING };
 //# sourceMappingURL=build.d.ts.map

package/dist/types/defaultValues/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","names":[],"sources":["../../../src/defaultValues/build.ts"],"mappings":";cAAa;cAEA;cAEA;cA0BA;cAEA;cAEA;cAEA;cAEA"}
+{"version":3,"file":"build.d.ts","names":[],"sources":["../../../src/defaultValues/build.ts"],"mappings":";cAAa;cAEA;cAEA;cA0BA;cAEA;cAEA;cAEA;cAEA;cAEA;cAEA"}

package/dist/types/defaultValues/dictionary.d.ts

@@ -4,6 +4,43 @@ declare const FILL = true;
 declare const LOCATION: DictionaryLocation;
 declare const CONTENT_AUTO_TRANSFORMATION = false;
 declare const IMPORT_MODE = "static";
+/**
+ * Directory the per-locale JSON chunks of `importMode: 'dynamic'` are written
+ * under, relative to `system.dynamicDictionariesDir`.
+ *
+ * Plain dictionaries land at `<subdir>/<key>/<locale>.json`, qualified ones
+ * (collections, variants) nest one directory per dimension in between. The
+ * static first segment is required by Turbopack, and build-tool plugins match
+ * module ids against this layout — hence the shared constant rather than a
+ * literal repeated on both sides.
+ */
+declare const DYNAMIC_DICTIONARIES_JSON_SUBDIR = "json";
+/**
+ * Marker property carrying the ordered qualifier dimensions on a dynamic loader
+ * map. Its presence distinguishes a qualified group loader map (a nested tree
+ * of chunks) from a plain dynamic loader map (one chunk per `locale`). Prefixed
+ * and unlikely to collide with a real locale code.
+ */
+declare const QUALIFIER_DYNAMIC_TYPES_KEY = "__intlayerQualifierTypes";
+/**
+ * Marker property carrying the dictionary a generated dynamic entry point
+ * already resolved for the browsing locale, before any component rendered.
+ *
+ * Build-tool plugins prepend a top-level `await` to those entry points, so the
+ * chunk that statically imports one only finishes evaluating once the awaited
+ * locale chunk has landed. A read during render then finds the content in place
+ * instead of suspending.
+ */
+declare const PRELOADED_DYNAMIC_KEY = "__intlayerPreloaded";
+/**
+ * Name of the local binding a generated dynamic entry point holds its loader
+ * map in, before exporting it as default.
+ *
+ * The preload preamble is appended to that generated source and mutates the
+ * binding, so the code generator and the build plugins have to agree on the
+ * name — hence the shared constant rather than a literal repeated in both.
+ */
+declare const DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER = "content";
 //#endregion
-export { CONTENT_AUTO_TRANSFORMATION, FILL, IMPORT_MODE, LOCATION };
+export { CONTENT_AUTO_TRANSFORMATION, DYNAMIC_DICTIONARIES_JSON_SUBDIR, DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER, FILL, IMPORT_MODE, LOCATION, PRELOADED_DYNAMIC_KEY, QUALIFIER_DYNAMIC_TYPES_KEY };
 //# sourceMappingURL=dictionary.d.ts.map

package/dist/types/defaultValues/dictionary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dictionary.d.ts","names":[],"sources":["../../../src/defaultValues/dictionary.ts"],"mappings":";;cAEa;cACA,UAAU;cACV;cACA"}
+{"version":3,"file":"dictionary.d.ts","names":[],"sources":["../../../src/defaultValues/dictionary.ts"],"mappings":";;cAEa;cACA,UAAU;cACV;cACA;;;;;;;;;;;cAYA;;;;;;;cAQA;;;;;;;;;;cAWA;;;;;;;;;cAUA"}

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

@@ -1,11 +1,11 @@
 import { ANALYTICS_ENABLED, ANALYTICS_FLUSH_INTERVAL, ANALYTICS_SAMPLE_RATE } from "./analytics.js";
-import { BUILD_MODE, CACHE, MINIFY, OPTIMIZE, OUTPUT_FORMAT, PURGE, TRAVERSE_PATTERN, TYPE_CHECKING } from "./build.js";
+import { BUILD_MODE, CACHE, CHUNK_GROUPING, DICTIONARIES_PRELOAD, MINIFY, OPTIMIZE, OUTPUT_FORMAT, PURGE, TRAVERSE_PATTERN, TYPE_CHECKING } from "./build.js";
 import { COMPILER_DICTIONARY_KEY_PREFIX, COMPILER_ENABLED, COMPILER_NO_METADATA, COMPILER_SAVE_COMPONENTS } from "./compiler.js";
 import { CODE_DIR, CONTENT_DIR, EXCLUDED_PATHS, FILE_EXTENSIONS, I18NEXT_DICTIONARIES_DIR, REACT_INTL_MESSAGES_DIR, WATCH } from "./content.js";
-import { CONTENT_AUTO_TRANSFORMATION, FILL, IMPORT_MODE, LOCATION } from "./dictionary.js";
+import { CONTENT_AUTO_TRANSFORMATION, DYNAMIC_DICTIONARIES_JSON_SUBDIR, DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER, FILL, IMPORT_MODE, LOCATION, PRELOADED_DYNAMIC_KEY, QUALIFIER_DYNAMIC_TYPES_KEY } from "./dictionary.js";
 import { APPLICATION_URL, BACKEND_URL, CMS_URL, DICTIONARY_PRIORITY_STRATEGY, EDITOR_URL, IS_ENABLED, LIVE_SYNC, LIVE_SYNC_PORT, PORT } from "./editor.js";
 import { DEFAULT_LOCALE, LOCALES, REQUIRED_LOCALES, STRICT_MODE } from "./internationalization.js";
 import { MODE, PREFIX } from "./log.js";
 import { BASE_PATH, COOKIE_NAME, ENABLE_PROXY, HEADER_NAME, LOCALE_STORAGE_NAME, ROUTING_MODE, SERVER_SET_COOKIE, STORAGE } from "./routing.js";
 import { CACHE_DIR, CONFIG_DIR, DICTIONARIES_DIR, DYNAMIC_DICTIONARIES_DIR, FETCH_DICTIONARIES_DIR, MAIN_DIR, MASKS_DIR, MODULE_AUGMENTATION_DIR, REMOTE_DICTIONARIES_DIR, TEMP_DIR, TYPES_DIR, UNMERGED_DICTIONARIES_DIR } from "./system.js";
-export { ANALYTICS_ENABLED, ANALYTICS_FLUSH_INTERVAL, ANALYTICS_SAMPLE_RATE, APPLICATION_URL, BACKEND_URL, BASE_PATH, BUILD_MODE, CACHE, CACHE_DIR, CMS_URL, CODE_DIR, COMPILER_DICTIONARY_KEY_PREFIX, COMPILER_ENABLED, COMPILER_NO_METADATA, COMPILER_SAVE_COMPONENTS, CONFIG_DIR, CONTENT_AUTO_TRANSFORMATION, CONTENT_DIR, COOKIE_NAME, DEFAULT_LOCALE, DICTIONARIES_DIR, DICTIONARY_PRIORITY_STRATEGY, DYNAMIC_DICTIONARIES_DIR, EDITOR_URL, ENABLE_PROXY, EXCLUDED_PATHS, FETCH_DICTIONARIES_DIR, FILE_EXTENSIONS, FILL, HEADER_NAME, I18NEXT_DICTIONARIES_DIR, IMPORT_MODE, IS_ENABLED, LIVE_SYNC, LIVE_SYNC_PORT, LOCALES, LOCALE_STORAGE_NAME, LOCATION, MAIN_DIR, MASKS_DIR, MINIFY, MODE, MODULE_AUGMENTATION_DIR, OPTIMIZE, OUTPUT_FORMAT, PORT, PREFIX, PURGE, REACT_INTL_MESSAGES_DIR, REMOTE_DICTIONARIES_DIR, REQUIRED_LOCALES, ROUTING_MODE, SERVER_SET_COOKIE, STORAGE, STRICT_MODE, TEMP_DIR, TRAVERSE_PATTERN, TYPES_DIR, TYPE_CHECKING, UNMERGED_DICTIONARIES_DIR, WATCH };
+export { ANALYTICS_ENABLED, ANALYTICS_FLUSH_INTERVAL, ANALYTICS_SAMPLE_RATE, APPLICATION_URL, BACKEND_URL, BASE_PATH, BUILD_MODE, CACHE, CACHE_DIR, CHUNK_GROUPING, CMS_URL, CODE_DIR, COMPILER_DICTIONARY_KEY_PREFIX, COMPILER_ENABLED, COMPILER_NO_METADATA, COMPILER_SAVE_COMPONENTS, CONFIG_DIR, CONTENT_AUTO_TRANSFORMATION, CONTENT_DIR, COOKIE_NAME, DEFAULT_LOCALE, DICTIONARIES_DIR, DICTIONARIES_PRELOAD, DICTIONARY_PRIORITY_STRATEGY, DYNAMIC_DICTIONARIES_DIR, DYNAMIC_DICTIONARIES_JSON_SUBDIR, DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER, EDITOR_URL, ENABLE_PROXY, EXCLUDED_PATHS, FETCH_DICTIONARIES_DIR, FILE_EXTENSIONS, FILL, HEADER_NAME, I18NEXT_DICTIONARIES_DIR, IMPORT_MODE, IS_ENABLED, LIVE_SYNC, LIVE_SYNC_PORT, LOCALES, LOCALE_STORAGE_NAME, LOCATION, MAIN_DIR, MASKS_DIR, MINIFY, MODE, MODULE_AUGMENTATION_DIR, OPTIMIZE, OUTPUT_FORMAT, PORT, PREFIX, PRELOADED_DYNAMIC_KEY, PURGE, QUALIFIER_DYNAMIC_TYPES_KEY, REACT_INTL_MESSAGES_DIR, REMOTE_DICTIONARIES_DIR, REQUIRED_LOCALES, ROUTING_MODE, SERVER_SET_COOKIE, STORAGE, STRICT_MODE, TEMP_DIR, TRAVERSE_PATTERN, TYPES_DIR, TYPE_CHECKING, UNMERGED_DICTIONARIES_DIR, WATCH };

package/dist/types/dictionaryPreload.d.ts

@@ -0,0 +1,79 @@
+//#region src/dictionaryPreload.d.ts
+/**
+ * Matches a generated dynamic entry point, whose layout is
+ * `<dynamicDictionariesDir>/<key>.mjs`. The per-locale JSON chunks it imports
+ * live one directory deeper, under `json/`, and are deliberately excluded.
+ */
+declare const DYNAMIC_ENTRY_PATTERN: RegExp;
+/**
+ * Builds a filter matching only the generated dynamic entry points, for
+ * bundlers whose load hook is selected by a regular expression over the raw
+ * file path (esbuild).
+ *
+ * A hook registered on every `.mjs` would call back into JavaScript for each
+ * such file in the build, `node_modules` included, so the filter is anchored on
+ * the dictionaries directory name. It matches both path separators because
+ * esbuild tests the platform path, which is backslash-separated on Windows —
+ * the directory name itself never contains one.
+ *
+ * The name alone is not proof of location, so the callback must still confirm
+ * the full path lies inside `dynamicDictionariesDir`.
+ *
+ * @param dynamicDictionariesDir - Absolute dictionaries root, any separator.
+ */
+declare const createDynamicEntryFilter: (dynamicDictionariesDir: string) => RegExp;
+/**
+ * Specifier of the module the injected preamble reads the locale from, as the
+ * bundler plugins are expected to resolve it.
+ *
+ * Never emitted as-is: a generated entry point lives in the *application's*
+ * `.intlayer` directory, and an application depends on `intlayer` and its
+ * framework binding — not on `@intlayer/core` — so a bare specifier would
+ * resolve from a directory where the package is absent, or, worse, silently
+ * hit an unrelated copy hoisted higher up the tree.
+ */
+declare const PRELOAD_MODULE_SPECIFIER = "@intlayer/core/localization";
+/**
+ * Resolves {@link PRELOAD_MODULE_SPECIFIER} to an absolute id the injected
+ * preamble can import, from a package that actually depends on it.
+ *
+ * Deliberately not `require.resolve(PRELOAD_MODULE_SPECIFIER)`: that applies
+ * the `require` condition and lands on the package's CommonJS build, which the
+ * preamble would then pull into a *browser* bundle behind a CommonJS interop
+ * wrapper — a second copy of the module alongside the ESM one the application
+ * already imports, each with its own memoized locale. The manifest is resolved
+ * instead (a condition-free subpath) and its `import` entry read directly.
+ *
+ * @param requireFn - `require`, or `createRequire(import.meta.url)`, from the
+ *   plugin package.
+ * @returns Absolute path to the ESM build, falling back to whatever the
+ *   standard resolution yields if the package ever stops publishing one.
+ */
+declare const resolvePreloadModuleId: (requireFn: NodeRequire) => string;
+/** Why a generated entry point was left untransformed. */
+type PreloadSkipReason = 'qualified' | 'unrecognized-shape';
+type PreloadTransformResult = {
+  code: string;
+  skipped?: undefined;
+} | {
+  code?: undefined;
+  skipped: PreloadSkipReason;
+};
+/**
+ * Adds the browsing-locale preload to a generated dynamic entry point.
+ *
+ * Bundler-agnostic on purpose: the Vite plugin and the esbuild plugin apply the
+ * identical transform, and keeping one implementation means the emitted shape
+ * cannot drift between them. The caller decides *which* modules to hand over
+ * (the id is matched against the dynamic dictionaries directory) and how to
+ * report a skip.
+ *
+ * @param code - Source of the generated `<key>.mjs` entry point.
+ * @param preloadModuleId - Specifier the preamble imports the locale resolver
+ *   from, already resolved against the plugin package.
+ * @returns The transformed source, or the reason it was left alone.
+ */
+declare const addDynamicEntryPreload: (code: string, preloadModuleId: string) => PreloadTransformResult;
+//#endregion
+export { DYNAMIC_ENTRY_PATTERN, PRELOAD_MODULE_SPECIFIER, PreloadSkipReason, PreloadTransformResult, addDynamicEntryPreload, createDynamicEntryFilter, resolvePreloadModuleId };
+//# sourceMappingURL=dictionaryPreload.d.ts.map

package/dist/types/dictionaryPreload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionaryPreload.d.ts","names":[],"sources":["../../src/dictionaryPreload.ts"],"mappings":";;;;;;cAYa,uBAAqB;;;;;;;;;;;;;;;;;cAsBrB,2BAAwB,mCAElC;;;;;;;;;;;cAmBU;;;;;;;;;;;;;;;;;cA2BA,yBAAsB,WAAe;;KAuEtC;KAEA;EACN;EAAc;;EACd;EAAkB,SAAS;;;;;;;;;;;;;;;;cAgBpB,yBAAsB,cACrB,4BAEX"}

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

@@ -18,7 +18,8 @@ import { getExtension } from "./getExtension.js";
 import { getPackageJsonPath } from "./getPackageJsonPath.js";
 import { getStorageAttributes } from "./getStorageAttributes.js";
 import { PluginNodeType, getUnusedNodeTypes, getUnusedNodeTypesAsync, getUsedNodeTypes, getUsedNodeTypesAsync } from "./getUsedNodeTypes.js";
+import { isPackageInstalled } from "./isPackageInstalled.js";
 import { parseFilePathPattern, parseStringPattern } from "./parseFilePathPattern.js";
 import { assertPathWithin } from "./pathSecurity.js";
 import { RetryManagerOptions, retryManager } from "./retryManager.js";
-export { BUILT_CONFIG_KEYS, BuiltConfigKey, CacheKey, GetAliasOptions, PluginNodeType, RetryManagerOptions, WindowsWithIntlayer, assertPathWithin, cacheDisk, cacheMemory, camelCaseToKebabCase, camelCaseToSentence, clearAllCache, clearCache, clearDiskCacheMemory, clearModuleCache, compareVersions, computeKeyId, configESMxCJSRequire, extractErrorMessage, getAlias, getCache, getExtension, getHasDictionarySelector, getPackageJsonPath, getProjectRequire, getStorageAttributes, getUnusedNodeTypes, getUnusedNodeTypesAsync, getUsedNodeTypes, getUsedNodeTypesAsync, isESModule, kebabCaseToCamelCase, logStack, normalizePath, parseFilePathPattern, parseStringPattern, retryManager, setCache, setIntlayerIdentifier, stableStringify, toLowerCamelCase };
+export { BUILT_CONFIG_KEYS, BuiltConfigKey, CacheKey, GetAliasOptions, PluginNodeType, RetryManagerOptions, WindowsWithIntlayer, assertPathWithin, cacheDisk, cacheMemory, camelCaseToKebabCase, camelCaseToSentence, clearAllCache, clearCache, clearDiskCacheMemory, clearModuleCache, compareVersions, computeKeyId, configESMxCJSRequire, extractErrorMessage, getAlias, getCache, getExtension, getHasDictionarySelector, getPackageJsonPath, getProjectRequire, getStorageAttributes, getUnusedNodeTypes, getUnusedNodeTypesAsync, getUsedNodeTypes, getUsedNodeTypesAsync, isESModule, isPackageInstalled, kebabCaseToCamelCase, logStack, normalizePath, parseFilePathPattern, parseStringPattern, retryManager, setCache, setIntlayerIdentifier, stableStringify, toLowerCamelCase };

package/dist/types/utils/isPackageInstalled.d.ts

@@ -0,0 +1,23 @@
+//#region src/utils/isPackageInstalled.d.ts
+/**
+ * Checks whether a package can be resolved from the user project.
+ *
+ * Used to detect optional companion packages (e.g. `@intlayer/analytics`)
+ * whose mere presence in the dependency tree opts the project into a feature.
+ *
+ * Resolution is attempted on the package manifest first, so packages that
+ * expose no root entry point — or whose entry point cannot be loaded in the
+ * current module format — are still detected.
+ *
+ * Note: resolution starts at the project root, so a package installed only as
+ * a transitive dependency may stay invisible under strict package managers
+ * (pnpm). Callers should treat a `false` result as a default, not as a veto.
+ *
+ * @param packageName - Name of the package to look up, e.g. `'@intlayer/analytics'`.
+ * @param baseDir - Directory the resolution starts from. Defaults to the current working directory.
+ * @returns `true` when the package is installed in the project, `false` otherwise.
+ */
+declare const isPackageInstalled: (packageName: string, baseDir?: string) => boolean;
+//#endregion
+export { isPackageInstalled };
+//# sourceMappingURL=isPackageInstalled.d.ts.map

package/dist/types/utils/isPackageInstalled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isPackageInstalled.d.ts","names":[],"sources":["../../../src/utils/isPackageInstalled.ts"],"mappings":";;;;;;;;;;;;;;;;;;;cAoBa,qBAAkB,qBACV"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/config",
-  "version": "9.3.2",
+  "version": "9.4.0-canary.0",
   "private": false,
   "description": "Retrieve Intlayer configurations and manage environment variables for both server-side and client-side environments.",
   "keywords": [
@@ -97,6 +97,11 @@
       "require": "./dist/cjs/defaultValues/index.cjs",
       "import": "./dist/esm/defaultValues/index.mjs"
     },
+    "./dictionaryPreload": {
+      "types": "./dist/types/dictionaryPreload.d.ts",
+      "require": "./dist/cjs/dictionaryPreload.cjs",
+      "import": "./dist/esm/dictionaryPreload.mjs"
+    },
     "./bundle": {
       "types": "./dist/types/bundle/index.d.ts",
       "require": "./dist/cjs/bundle/index.cjs",
@@ -172,7 +177,7 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/types": "9.3.2",
+    "@intlayer/types": "9.4.0-canary.0",
     "defu": "6.1.7",
     "dotenv": "17.4.2",
     "esbuild": "0.28.2",
@@ -187,7 +192,7 @@
     "rimraf": "6.1.3",
     "tsdown": "0.22.14",
     "typescript": "7.0.2",
-    "vitest": "4.1.10"
+    "vitest": "4.1.11"
   },
   "peerDependencies": {
     "react": ">=16.0.0"