@intlayer/config 9.3.3 → 9.4.0-canary.0

package/README.md

@@ -327,4 +327,4 @@ Contribute on [GitHub](https://github.com/aymericzip/intlayer), [GitLab](https:/
 
 If you like Intlayer, give us a ⭐ on GitHub. It helps others discover the project! [See why GitHub Stars matter](https://github.com/aymericzip/intlayer/blob/main/CONTRIBUTING.md#why-github-stars-matter-).
 
-[![Star History Chart](https://api.star-history.com/svg?repos=aymericzip/intlayer&type=Date)](https://star-history.com/#aymericzip/intlayer&Date)
+[![Star History Chart](https://star-history.dera.page/svg?repos=aymericzip/intlayer&type=Date)](https://star-history.dera.page/#aymericzip/intlayer&Date)

package/dist/cjs/bundle/index.cjs

@@ -2,8 +2,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_utils_alias = require('../utils/alias.cjs');
 const require_configFile_getConfiguration = require('../configFile/getConfiguration.cjs');
-const require_envVars_envVars = require('../envVars/envVars.cjs');
 const require_bundle_logBundle = require('./logBundle.cjs');
+const require_envVars_envVars = require('../envVars/envVars.cjs');
 let node_path = require("node:path");
 let node_fs_promises = require("node:fs/promises");
 let _intlayer_types_package_json = require("@intlayer/types/package.json");

package/dist/cjs/configFile/buildBrowserConfiguration.cjs

@@ -282,20 +282,27 @@ const buildEditorFields = (customConfiguration) => {
 /**
 * Build the analytics section of the Intlayer configuration.
 *
-* Analytics is strictly opt-in: `enabled` defaults to `false` and, even when
-* enabled, the runtime additionally requires a project key (`editor.clientId`)
-* for attribution before collecting anything.
+* Analytics is opt-out: `enabled` defaults to `true`, so installing the
+* optional `@intlayer/analytics` package is enough to turn it on. The runtime
+* additionally requires a project key (`editor.clientId`) for attribution
+* before collecting anything.
+*
+* An explicit `enabled` value always wins, so a project whose package manager
+* hides the package from the project root can still opt back in.
 *
 * @param customConfiguration - Partial user-supplied analytics config.
+* @param isPackageInstalled - Whether `@intlayer/analytics` is installed in the
+*   project. Browser callers cannot resolve packages and pass `true`, letting
+*   the runtime dynamic `import()` fail silently when it is absent.
 * @returns A fully-defaulted {@link AnalyticsConfig}.
 */
-const buildAnalyticsFields = (customConfiguration) => ({
+const buildAnalyticsFields = (customConfiguration, isPackageInstalled = true) => ({
 	/**
 	* Enables analytics collection (page views, content exposures, A/B events).
 	*
-	* Default: false
+	* Default: true, as soon as `@intlayer/analytics` is installed.
 	*/
-	enabled: customConfiguration?.enabled ?? false,
+	enabled: customConfiguration?.enabled ?? (true && isPackageInstalled),
 	/**
 	* Milliseconds between automatic batched flushes to the backend.
 	*

package/dist/cjs/configFile/buildBrowserConfiguration.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"buildBrowserConfiguration.cjs","names":["LOCALES","REQUIRED_LOCALES","STORAGE","getStorageAttributes","PREFIX"],"sources":["../../../src/configFile/buildBrowserConfiguration.ts"],"sourcesContent":["import type {\n  AnalyticsConfig,\n  CustomIntlayerConfig,\n  CustomRoutingConfig,\n  EditorConfig,\n  InternationalizationConfig,\n  IntlayerConfig,\n  LogConfig,\n  LogFunctions,\n  RoutingConfig,\n} from '@intlayer/types/config';\nimport {\n  ANALYTICS_ENABLED,\n  ANALYTICS_FLUSH_INTERVAL,\n  ANALYTICS_SAMPLE_RATE,\n} from '../defaultValues/analytics';\nimport {\n  APPLICATION_URL,\n  BACKEND_URL,\n  CMS_URL,\n  DICTIONARY_PRIORITY_STRATEGY,\n  EDITOR_URL,\n  IS_ENABLED,\n  LIVE_SYNC,\n  LIVE_SYNC_PORT,\n  PORT,\n} from '../defaultValues/editor';\nimport {\n  DEFAULT_LOCALE,\n  LOCALES,\n  REQUIRED_LOCALES,\n  STRICT_MODE,\n} from '../defaultValues/internationalization';\nimport { MODE, PREFIX } from '../defaultValues/log';\nimport {\n  BASE_PATH,\n  ENABLE_PROXY,\n  ROUTING_MODE,\n  STORAGE,\n} from '../defaultValues/routing';\nimport { getStorageAttributes } from '../utils/getStorageAttributes';\n\n// ---------------------------------------------------------------------------\n// Type\n// ---------------------------------------------------------------------------\n\n/**\n * Browser-safe subset of {@link IntlayerConfig}.\n *\n * Excludes server-only fields (`system`, `content`, `build`, `compiler`,\n * `dictionary`, `ai`) and sensitive editor credentials (`clientId`,\n * `clientSecret`) that must never be shipped to the browser.\n */\nexport type BrowserIntlayerConfig = {\n  internationalization: Pick<\n    InternationalizationConfig,\n    'locales' | 'defaultLocale'\n  >;\n  routing: RoutingConfig;\n  editor: Omit<EditorConfig, 'clientId' | 'clientSecret'>;\n  analytics: AnalyticsConfig;\n  log: Pick<LogConfig, 'mode' | 'prefix'>;\n};\n\ndeclare global {\n  interface Window {\n    /** Browser-safe Intlayer configuration injected by a build plugin or `installIntlayer`. */\n    INTLAYER_CONFIG?: BrowserIntlayerConfig;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Shared field builders (browser-safe — no Node.js APIs)\n//\n// These functions are re-used by both `buildBrowserConfiguration` (browser)\n// and `buildConfigurationFields` (server) to avoid duplication.\n// ---------------------------------------------------------------------------\n\n/**\n * Build the internationalization section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied internationalization config.\n * @returns A fully-defaulted {@link InternationalizationConfig}.\n */\nexport const buildInternationalizationFields = (\n  customConfiguration?: Partial<InternationalizationConfig>\n): InternationalizationConfig => ({\n  /**\n   * Locales available in the application\n   *\n   * Default: ['en']\n   *\n   */\n  locales: customConfiguration?.locales ?? LOCALES,\n\n  /**\n   * Locales required by TypeScript to ensure strong implementations of internationalized content using typescript.\n   *\n   * Default: []\n   *\n   * If empty, all locales are required in `strict` mode.\n   *\n   * Ensure required locales are also defined in the `locales` field.\n   */\n  requiredLocales:\n    customConfiguration?.requiredLocales ??\n    customConfiguration?.locales ??\n    REQUIRED_LOCALES,\n\n  /**\n   * Ensure strong implementations of internationalized content using typescript.\n   * - If set to \"strict\", the translation `t` function will require each declared locales to be defined. If one locale is missing, or if a locale is not declared in your config, it will throw an error.\n   * - If set to \"inclusive\", the translation `t` function will require each declared locales to be defined. If one locale is missing, it will throw a warning. But will accept if a locale is not declared in your config, but exist.\n   * - If set to \"loose\", the translation `t` function will accept any existing locale.\n   *\n   * Default: \"inclusive\"\n   */\n  strictMode: customConfiguration?.strictMode ?? STRICT_MODE,\n\n  /**\n   * Default locale of the application for fallback\n   *\n   * Default: 'en'\n   */\n  defaultLocale: customConfiguration?.defaultLocale ?? DEFAULT_LOCALE,\n});\n\n/**\n * Build the routing section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied routing config.\n * @returns A fully-defaulted {@link RoutingConfig}.\n */\nexport const buildRoutingFields = (\n  customConfiguration?: Partial<CustomRoutingConfig>\n): RoutingConfig => {\n  const storage = customConfiguration?.storage ?? STORAGE;\n\n  return {\n    /**\n     * URL routing mode for locale handling\n     *\n     * Controls how locales are represented in application URLs:\n     * - 'prefix-no-default': Prefix all locales except the default locale (default)\n     *    - en → /dashboard\n     *    - fr → /fr/dashboard\n     *\n     * - 'prefix-all': Prefix all locales including the default locale\n     *    - en → /en/dashboard\n     *    - fr → /fr/dashboard\n     *\n     * - 'search-params': Use search parameters for locale handling\n     *    - en → /dashboard?locale=en\n     *    - fr → /fr/dashboard?locale=fr\n     *\n     * - 'no-prefix': No locale prefixing in URLs\n     *    - en → /dashboard\n     *    - fr → /dashboard\n     *\n     * Default: 'prefix-no-default'\n     */\n    mode: customConfiguration?.mode ?? ROUTING_MODE,\n\n    /**\n     * Enables the Intlayer locale-routing proxy (middleware).\n     *\n     * When enabled, the build-tool integration (e.g. the `intlayer()` Vite plugin)\n     * automatically wires the locale-detection / redirect / rewrite middleware in\n     * development, preview, and production SSR.\n     *\n     * - `undefined` (auto, default): the proxy runs, but development and preview\n     *   servers ignore the stored locale (cookie / header) as a redirect source.\n     * - `true`: full proxy behaviour in every environment.\n     * - `false`: no locale routing; the proxy is not registered.\n     *\n     * Default: undefined (auto)\n     */\n    enableProxy: customConfiguration?.enableProxy ?? ENABLE_PROXY,\n\n    /**\n     * Configuration for storing the locale in the client (localStorage or sessionStorage)\n     *\n     * If false, the locale will not be stored by the middleware.\n     * If true, the locale storage will consider all default values. (cookie and header)\n     *\n     * Default: ['cookie', 'header']\n     *\n     */\n    storage: getStorageAttributes(storage),\n\n    /**\n     * Base path of the application URL\n     *\n     * Default: ''\n     *\n     * Example:\n     * - If the application is hosted at https://example.com/my-app\n     * - The base path is '/my-app'\n     * - The URL will be https://example.com/my-app/en\n     * - If the base path is not set, the URL will be https://example.com/en\n     */\n    basePath: customConfiguration?.basePath ?? BASE_PATH,\n\n    /**\n     * Custom URL rewriting rules that override the default routing mode for specific paths.\n     * Allows you to define locale-specific paths that differ from the standard routing behavior.\n     * Supports dynamic route parameters using `[param]` syntax.\n     *\n     * Default: undefined\n     *\n     * Example:\n     * ```typescript\n     * rewrite: {\n     *   \"/about\": {\n     *     en: \"/about\",\n     *     fr: \"/a-propos\",\n     *   },\n     *   \"/product/[slug]\": {\n     *     en: \"/product/[slug]\",\n     *     fr: \"/produit/[slug]\",\n     *   },\n     * }\n     * ```\n     *\n     * Note:\n     * - The rewrite rules take precedence over the default `mode` behavior.\n     * - If a path matches a rewrite rule, the localized path from the rewrite configuration will be used.\n     * - Dynamic route parameters are supported using bracket notation (e.g., `[slug]`, `[id]`).\n     * - Works with both Next.js and Vite applications.\n     */\n    rewrite: customConfiguration?.rewrite,\n\n    /**\n     * Maps locales to specific domain hostnames for domain-based routing.\n     *\n     * Default: undefined\n     */\n    domains: customConfiguration?.domains,\n  };\n};\n\n/**\n * Build the editor section of the Intlayer configuration.\n *\n * Returns the **full** {@link EditorConfig} including sensitive fields\n * (`clientId`, `clientSecret`). The browser-safe {@link BrowserIntlayerConfig}\n * omits those fields when exposing config to the client.\n *\n * `clientId` / `clientSecret` are never inferred from the environment: the\n * configuration file is the single source of truth. A project that wants to\n * authenticate from its `.env` file must wire the variables explicitly, e.g.\n * `clientId: process.env.INTLAYER_CLIENT_ID`. Commenting those lines out is\n * therefore enough to disable every credentialed behaviour (remote dictionary\n * fetching, CMS access) even when the variables remain defined in the\n * environment.\n *\n * @param customConfiguration - Partial user-supplied editor config.\n * @returns A fully-defaulted {@link EditorConfig}.\n */\nexport const buildEditorFields = (\n  customConfiguration?: Partial<EditorConfig>\n): EditorConfig => {\n  const liveSyncPort = customConfiguration?.liveSyncPort ?? LIVE_SYNC_PORT;\n  return {\n    /**\n     * URL of the application. Used to restrict the origin of the editor for security reasons.\n     *\n     * > '*' means that the editor is accessible from any origin\n     *\n     * Default: '*'\n     */\n    applicationURL: customConfiguration?.applicationURL || APPLICATION_URL,\n\n    /**\n     * URL of the editor server. Used to restrict the origin of the editor for security reasons.\n     *\n     * > '*' means that the editor is accessible from any origin\n     *\n     * Default: '*'\n     */\n    editorURL: customConfiguration?.editorURL || EDITOR_URL,\n\n    /**\n     * URL of the CMS server. Used to restrict the origin of the editor for security reasons.\n     */\n    cmsURL: customConfiguration?.cmsURL || CMS_URL,\n\n    /**\n     * URL of the editor server\n     *\n     * Default: 'https://back.intlayer.org'\n     */\n    backendURL: customConfiguration?.backendURL || BACKEND_URL,\n\n    /** Port of the editor server\n     *\n     * Default: 8000\n     */\n    port: customConfiguration?.port ?? PORT,\n\n    /**\n     * Indicates if the application interact with the visual editor\n     *\n     * Default: false;\n     *\n     * If true, the editor will be able to interact with the application.\n     * If false, the editor will not be able to interact with the application.\n     * In any case, the editor can only be enabled by the visual editor.\n     * Disabling the editor for specific environments is a way to enforce the security.\n     *\n     * Usage:\n     * ```js\n     * {\n     *  // Other configurations\n     *  editor: {\n     *   enabled: process.env.NODE_ENV !== 'production',\n     *  }\n     * };\n     * ```\n     */\n    enabled: customConfiguration?.enabled ?? IS_ENABLED,\n\n    /**\n     * clientId and clientSecret allow the intlayer packages to authenticate with the backend using oAuth2 authentication.\n     * An access token is use to authenticate the user related to the project.\n     * To get an access token, go to https://app.intlayer.org/project and create an account.\n     *\n     * Default: undefined\n     *\n     * > Important: The clientId and clientSecret should be kept secret and not shared publicly. Please ensure to keep them in a secure location, such as environment variables.\n     */\n    clientId: customConfiguration?.clientId,\n\n    /**\n     * clientId and clientSecret allow the intlayer packages to authenticate with the backend using oAuth2 authentication.\n     * An access token is use to authenticate the user related to the project.\n     * To get an access token, go to https://app.intlayer.org/project and create an account.\n     *\n     * Default: undefined\n     *\n     * > Important: The clientId and clientSecret should be kept secret and not shared publicly. Please ensure to keep them in a secure location, such as environment variables.\n     */\n    clientSecret: customConfiguration?.clientSecret,\n\n    /**\n     * Strategy for prioritizing dictionaries. If a dictionary is both present online and locally, the content will be merge.\n     * However, is a field is defined in both dictionary, this setting determines which fields takes the priority over the other.\n     *\n     * Default: 'local_first'\n     *\n     * The strategy for prioritizing dictionaries. It can be either 'local_first' or 'distant_first'.\n     * - 'local_first': The first dictionary found in the locale is used.\n     * - 'distant_first': The first dictionary found in the distant locales is used.\n     */\n    dictionaryPriorityStrategy:\n      customConfiguration?.dictionaryPriorityStrategy ??\n      DICTIONARY_PRIORITY_STRATEGY,\n\n    /**\n     * Indicates if the application should hot reload the locale configurations when a change is detected.\n     * For example, when a new dictionary is added or updated, the application will update the content tu display in the page.\n     *\n     * The hot reload is only available for clients of the `enterprise` plan.\n     *\n     * Default: false\n     */\n    liveSync: customConfiguration?.liveSync ?? LIVE_SYNC,\n\n    /**\n     * Port of the live sync server\n     *\n     * Default: 4000\n     */\n    liveSyncPort,\n\n    /**\n     * URL of the live sync server in case of remote live sync server\n     *\n     * Default: `http://localhost:${LIVE_SYNC_PORT}`\n     */\n    liveSyncURL:\n      customConfiguration?.liveSyncURL ?? `http://localhost:${liveSyncPort}`,\n  };\n};\n\n/**\n * Build the analytics section of the Intlayer configuration.\n *\n * Analytics is strictly opt-in: `enabled` defaults to `false` and, even when\n * enabled, the runtime additionally requires a project key (`editor.clientId`)\n * for attribution before collecting anything.\n *\n * @param customConfiguration - Partial user-supplied analytics config.\n * @returns A fully-defaulted {@link AnalyticsConfig}.\n */\nexport const buildAnalyticsFields = (\n  customConfiguration?: Partial<AnalyticsConfig>\n): AnalyticsConfig => ({\n  /**\n   * Enables analytics collection (page views, content exposures, A/B events).\n   *\n   * Default: false\n   */\n  enabled: customConfiguration?.enabled ?? ANALYTICS_ENABLED,\n\n  /**\n   * Milliseconds between automatic batched flushes to the backend.\n   *\n   * Default: 20000\n   */\n  flushInterval: customConfiguration?.flushInterval ?? ANALYTICS_FLUSH_INTERVAL,\n\n  /**\n   * Fraction of sessions to record, from 0 (none) to 1 (all).\n   *\n   * Default: 1\n   */\n  sampleRate: customConfiguration?.sampleRate ?? ANALYTICS_SAMPLE_RATE,\n});\n\n/**\n * Build the log section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied log config.\n * @param logFunctions - Optional custom log function overrides (server-only).\n * @returns A fully-defaulted {@link LogConfig}.\n */\nexport const buildLogFields = (\n  customConfiguration?: Partial<LogConfig>,\n  logFunctions?: LogFunctions\n): LogConfig => ({\n  /**\n   * Indicates if the logger is enabled\n   *\n   * Default: 'prefix-no-default'\n   *\n   * If 'default', the logger is enabled and can be used.\n   * If 'verbose', the logger will be enabled and can be used, but will log more information.\n   * If 'disabled', the logger is disabled and cannot be used.\n   */\n  mode: customConfiguration?.mode ?? MODE,\n\n  /**\n   * Prefix of the logger\n   *\n   * Default: '[intlayer]'\n   *\n   * The prefix of the logger.\n   */\n  prefix: customConfiguration?.prefix ?? PREFIX,\n\n  /**\n   * Functions to log\n   */\n  error: logFunctions?.error,\n  log: logFunctions?.log,\n  info: logFunctions?.info,\n  warn: logFunctions?.warn,\n});\n\n// ---------------------------------------------------------------------------\n// Browser configuration builders\n// ---------------------------------------------------------------------------\n\n/**\n * Build a browser-safe {@link BrowserIntlayerConfig} from a raw user config.\n *\n * Applies defaults for every field and strips all server-only or sensitive\n * information (`system`, `content`, `build`, `compiler`, `dictionary`, `ai`,\n * `editor.clientId`, `editor.clientSecret`).\n *\n * This is the browser counterpart of `buildConfigurationFields`. It is safe\n * to call in browser environments because it has no Node.js dependencies.\n *\n * @param customConfig - Optional partial user-supplied Intlayer config.\n * @returns A browser-safe configuration object ready for `window.INTLAYER_CONFIG`.\n *\n * @example\n * ```ts\n * import { buildBrowserConfiguration } from '@intlayer/config/client';\n *\n * window.INTLAYER_CONFIG = buildBrowserConfiguration({\n *   internationalization: { locales: ['en', 'fr'], defaultLocale: 'en' },\n * });\n * ```\n */\nexport const buildBrowserConfiguration = (\n  customConfig?: CustomIntlayerConfig\n): BrowserIntlayerConfig => {\n  const { locales, defaultLocale } = buildInternationalizationFields(\n    customConfig?.internationalization\n  );\n  const routing = buildRoutingFields(customConfig?.routing);\n  const {\n    clientId: _clientId,\n    clientSecret: _clientSecret,\n    ...editorPublic\n  } = buildEditorFields(customConfig?.editor);\n  const analytics = buildAnalyticsFields(customConfig?.analytics);\n  const { mode, prefix } = buildLogFields(customConfig?.log);\n\n  return {\n    internationalization: { locales, defaultLocale },\n    routing,\n    editor: editorPublic,\n    analytics,\n    log: { mode, prefix },\n  };\n};\n\n/**\n * Extract a {@link BrowserIntlayerConfig} from an already-built full\n * {@link IntlayerConfig}.\n *\n * Used by build plugins (`vite-intlayer`, `withIntlayer`) which already hold\n * the full server-side config and need to inject the browser-safe subset at\n * compile time via a bundler `define`.\n *\n * @param config - A fully-built server-side Intlayer configuration.\n * @returns The browser-safe subset of that configuration.\n */\nexport const extractBrowserConfiguration = (\n  config: IntlayerConfig\n): BrowserIntlayerConfig => ({\n  internationalization: {\n    locales: config.internationalization.locales,\n    defaultLocale: config.internationalization.defaultLocale,\n  },\n  routing: {\n    mode: config.routing.mode,\n    enableProxy: config.routing.enableProxy,\n    storage: config.routing.storage,\n    basePath: config.routing.basePath,\n    rewrite: config.routing.rewrite,\n  },\n  editor: {\n    applicationURL: config.editor.applicationURL,\n    editorURL: config.editor.editorURL,\n    cmsURL: config.editor.cmsURL,\n    backendURL: config.editor.backendURL,\n    port: config.editor.port,\n    enabled: config.editor.enabled,\n    dictionaryPriorityStrategy: config.editor.dictionaryPriorityStrategy,\n    liveSync: config.editor.liveSync,\n    liveSyncPort: config.editor.liveSyncPort,\n    liveSyncURL: config.editor.liveSyncURL,\n  },\n  analytics: buildAnalyticsFields(config.analytics),\n  log: {\n    mode: config.log.mode,\n    prefix: config.log.prefix,\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"buildBrowserConfiguration.cjs","names":["LOCALES","REQUIRED_LOCALES","STORAGE","getStorageAttributes","PREFIX"],"sources":["../../../src/configFile/buildBrowserConfiguration.ts"],"sourcesContent":["import type {\n  AnalyticsConfig,\n  CustomIntlayerConfig,\n  CustomRoutingConfig,\n  EditorConfig,\n  InternationalizationConfig,\n  IntlayerConfig,\n  LogConfig,\n  LogFunctions,\n  RoutingConfig,\n} from '@intlayer/types/config';\nimport {\n  ANALYTICS_ENABLED,\n  ANALYTICS_FLUSH_INTERVAL,\n  ANALYTICS_SAMPLE_RATE,\n} from '../defaultValues/analytics';\nimport {\n  APPLICATION_URL,\n  BACKEND_URL,\n  CMS_URL,\n  DICTIONARY_PRIORITY_STRATEGY,\n  EDITOR_URL,\n  IS_ENABLED,\n  LIVE_SYNC,\n  LIVE_SYNC_PORT,\n  PORT,\n} from '../defaultValues/editor';\nimport {\n  DEFAULT_LOCALE,\n  LOCALES,\n  REQUIRED_LOCALES,\n  STRICT_MODE,\n} from '../defaultValues/internationalization';\nimport { MODE, PREFIX } from '../defaultValues/log';\nimport {\n  BASE_PATH,\n  ENABLE_PROXY,\n  ROUTING_MODE,\n  STORAGE,\n} from '../defaultValues/routing';\nimport { getStorageAttributes } from '../utils/getStorageAttributes';\n\n// ---------------------------------------------------------------------------\n// Type\n// ---------------------------------------------------------------------------\n\n/**\n * Browser-safe subset of {@link IntlayerConfig}.\n *\n * Excludes server-only fields (`system`, `content`, `build`, `compiler`,\n * `dictionary`, `ai`) and sensitive editor credentials (`clientId`,\n * `clientSecret`) that must never be shipped to the browser.\n */\nexport type BrowserIntlayerConfig = {\n  internationalization: Pick<\n    InternationalizationConfig,\n    'locales' | 'defaultLocale'\n  >;\n  routing: RoutingConfig;\n  editor: Omit<EditorConfig, 'clientId' | 'clientSecret'>;\n  analytics: AnalyticsConfig;\n  log: Pick<LogConfig, 'mode' | 'prefix'>;\n};\n\ndeclare global {\n  interface Window {\n    /** Browser-safe Intlayer configuration injected by a build plugin or `installIntlayer`. */\n    INTLAYER_CONFIG?: BrowserIntlayerConfig;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Shared field builders (browser-safe — no Node.js APIs)\n//\n// These functions are re-used by both `buildBrowserConfiguration` (browser)\n// and `buildConfigurationFields` (server) to avoid duplication.\n// ---------------------------------------------------------------------------\n\n/**\n * Build the internationalization section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied internationalization config.\n * @returns A fully-defaulted {@link InternationalizationConfig}.\n */\nexport const buildInternationalizationFields = (\n  customConfiguration?: Partial<InternationalizationConfig>\n): InternationalizationConfig => ({\n  /**\n   * Locales available in the application\n   *\n   * Default: ['en']\n   *\n   */\n  locales: customConfiguration?.locales ?? LOCALES,\n\n  /**\n   * Locales required by TypeScript to ensure strong implementations of internationalized content using typescript.\n   *\n   * Default: []\n   *\n   * If empty, all locales are required in `strict` mode.\n   *\n   * Ensure required locales are also defined in the `locales` field.\n   */\n  requiredLocales:\n    customConfiguration?.requiredLocales ??\n    customConfiguration?.locales ??\n    REQUIRED_LOCALES,\n\n  /**\n   * Ensure strong implementations of internationalized content using typescript.\n   * - If set to \"strict\", the translation `t` function will require each declared locales to be defined. If one locale is missing, or if a locale is not declared in your config, it will throw an error.\n   * - If set to \"inclusive\", the translation `t` function will require each declared locales to be defined. If one locale is missing, it will throw a warning. But will accept if a locale is not declared in your config, but exist.\n   * - If set to \"loose\", the translation `t` function will accept any existing locale.\n   *\n   * Default: \"inclusive\"\n   */\n  strictMode: customConfiguration?.strictMode ?? STRICT_MODE,\n\n  /**\n   * Default locale of the application for fallback\n   *\n   * Default: 'en'\n   */\n  defaultLocale: customConfiguration?.defaultLocale ?? DEFAULT_LOCALE,\n});\n\n/**\n * Build the routing section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied routing config.\n * @returns A fully-defaulted {@link RoutingConfig}.\n */\nexport const buildRoutingFields = (\n  customConfiguration?: Partial<CustomRoutingConfig>\n): RoutingConfig => {\n  const storage = customConfiguration?.storage ?? STORAGE;\n\n  return {\n    /**\n     * URL routing mode for locale handling\n     *\n     * Controls how locales are represented in application URLs:\n     * - 'prefix-no-default': Prefix all locales except the default locale (default)\n     *    - en → /dashboard\n     *    - fr → /fr/dashboard\n     *\n     * - 'prefix-all': Prefix all locales including the default locale\n     *    - en → /en/dashboard\n     *    - fr → /fr/dashboard\n     *\n     * - 'search-params': Use search parameters for locale handling\n     *    - en → /dashboard?locale=en\n     *    - fr → /fr/dashboard?locale=fr\n     *\n     * - 'no-prefix': No locale prefixing in URLs\n     *    - en → /dashboard\n     *    - fr → /dashboard\n     *\n     * Default: 'prefix-no-default'\n     */\n    mode: customConfiguration?.mode ?? ROUTING_MODE,\n\n    /**\n     * Enables the Intlayer locale-routing proxy (middleware).\n     *\n     * When enabled, the build-tool integration (e.g. the `intlayer()` Vite plugin)\n     * automatically wires the locale-detection / redirect / rewrite middleware in\n     * development, preview, and production SSR.\n     *\n     * - `undefined` (auto, default): the proxy runs, but development and preview\n     *   servers ignore the stored locale (cookie / header) as a redirect source.\n     * - `true`: full proxy behaviour in every environment.\n     * - `false`: no locale routing; the proxy is not registered.\n     *\n     * Default: undefined (auto)\n     */\n    enableProxy: customConfiguration?.enableProxy ?? ENABLE_PROXY,\n\n    /**\n     * Configuration for storing the locale in the client (localStorage or sessionStorage)\n     *\n     * If false, the locale will not be stored by the middleware.\n     * If true, the locale storage will consider all default values. (cookie and header)\n     *\n     * Default: ['cookie', 'header']\n     *\n     */\n    storage: getStorageAttributes(storage),\n\n    /**\n     * Base path of the application URL\n     *\n     * Default: ''\n     *\n     * Example:\n     * - If the application is hosted at https://example.com/my-app\n     * - The base path is '/my-app'\n     * - The URL will be https://example.com/my-app/en\n     * - If the base path is not set, the URL will be https://example.com/en\n     */\n    basePath: customConfiguration?.basePath ?? BASE_PATH,\n\n    /**\n     * Custom URL rewriting rules that override the default routing mode for specific paths.\n     * Allows you to define locale-specific paths that differ from the standard routing behavior.\n     * Supports dynamic route parameters using `[param]` syntax.\n     *\n     * Default: undefined\n     *\n     * Example:\n     * ```typescript\n     * rewrite: {\n     *   \"/about\": {\n     *     en: \"/about\",\n     *     fr: \"/a-propos\",\n     *   },\n     *   \"/product/[slug]\": {\n     *     en: \"/product/[slug]\",\n     *     fr: \"/produit/[slug]\",\n     *   },\n     * }\n     * ```\n     *\n     * Note:\n     * - The rewrite rules take precedence over the default `mode` behavior.\n     * - If a path matches a rewrite rule, the localized path from the rewrite configuration will be used.\n     * - Dynamic route parameters are supported using bracket notation (e.g., `[slug]`, `[id]`).\n     * - Works with both Next.js and Vite applications.\n     */\n    rewrite: customConfiguration?.rewrite,\n\n    /**\n     * Maps locales to specific domain hostnames for domain-based routing.\n     *\n     * Default: undefined\n     */\n    domains: customConfiguration?.domains,\n  };\n};\n\n/**\n * Build the editor section of the Intlayer configuration.\n *\n * Returns the **full** {@link EditorConfig} including sensitive fields\n * (`clientId`, `clientSecret`). The browser-safe {@link BrowserIntlayerConfig}\n * omits those fields when exposing config to the client.\n *\n * `clientId` / `clientSecret` are never inferred from the environment: the\n * configuration file is the single source of truth. A project that wants to\n * authenticate from its `.env` file must wire the variables explicitly, e.g.\n * `clientId: process.env.INTLAYER_CLIENT_ID`. Commenting those lines out is\n * therefore enough to disable every credentialed behaviour (remote dictionary\n * fetching, CMS access) even when the variables remain defined in the\n * environment.\n *\n * @param customConfiguration - Partial user-supplied editor config.\n * @returns A fully-defaulted {@link EditorConfig}.\n */\nexport const buildEditorFields = (\n  customConfiguration?: Partial<EditorConfig>\n): EditorConfig => {\n  const liveSyncPort = customConfiguration?.liveSyncPort ?? LIVE_SYNC_PORT;\n  return {\n    /**\n     * URL of the application. Used to restrict the origin of the editor for security reasons.\n     *\n     * > '*' means that the editor is accessible from any origin\n     *\n     * Default: '*'\n     */\n    applicationURL: customConfiguration?.applicationURL || APPLICATION_URL,\n\n    /**\n     * URL of the editor server. Used to restrict the origin of the editor for security reasons.\n     *\n     * > '*' means that the editor is accessible from any origin\n     *\n     * Default: '*'\n     */\n    editorURL: customConfiguration?.editorURL || EDITOR_URL,\n\n    /**\n     * URL of the CMS server. Used to restrict the origin of the editor for security reasons.\n     */\n    cmsURL: customConfiguration?.cmsURL || CMS_URL,\n\n    /**\n     * URL of the editor server\n     *\n     * Default: 'https://back.intlayer.org'\n     */\n    backendURL: customConfiguration?.backendURL || BACKEND_URL,\n\n    /** Port of the editor server\n     *\n     * Default: 8000\n     */\n    port: customConfiguration?.port ?? PORT,\n\n    /**\n     * Indicates if the application interact with the visual editor\n     *\n     * Default: false;\n     *\n     * If true, the editor will be able to interact with the application.\n     * If false, the editor will not be able to interact with the application.\n     * In any case, the editor can only be enabled by the visual editor.\n     * Disabling the editor for specific environments is a way to enforce the security.\n     *\n     * Usage:\n     * ```js\n     * {\n     *  // Other configurations\n     *  editor: {\n     *   enabled: process.env.NODE_ENV !== 'production',\n     *  }\n     * };\n     * ```\n     */\n    enabled: customConfiguration?.enabled ?? IS_ENABLED,\n\n    /**\n     * clientId and clientSecret allow the intlayer packages to authenticate with the backend using oAuth2 authentication.\n     * An access token is use to authenticate the user related to the project.\n     * To get an access token, go to https://app.intlayer.org/project and create an account.\n     *\n     * Default: undefined\n     *\n     * > Important: The clientId and clientSecret should be kept secret and not shared publicly. Please ensure to keep them in a secure location, such as environment variables.\n     */\n    clientId: customConfiguration?.clientId,\n\n    /**\n     * clientId and clientSecret allow the intlayer packages to authenticate with the backend using oAuth2 authentication.\n     * An access token is use to authenticate the user related to the project.\n     * To get an access token, go to https://app.intlayer.org/project and create an account.\n     *\n     * Default: undefined\n     *\n     * > Important: The clientId and clientSecret should be kept secret and not shared publicly. Please ensure to keep them in a secure location, such as environment variables.\n     */\n    clientSecret: customConfiguration?.clientSecret,\n\n    /**\n     * Strategy for prioritizing dictionaries. If a dictionary is both present online and locally, the content will be merge.\n     * However, is a field is defined in both dictionary, this setting determines which fields takes the priority over the other.\n     *\n     * Default: 'local_first'\n     *\n     * The strategy for prioritizing dictionaries. It can be either 'local_first' or 'distant_first'.\n     * - 'local_first': The first dictionary found in the locale is used.\n     * - 'distant_first': The first dictionary found in the distant locales is used.\n     */\n    dictionaryPriorityStrategy:\n      customConfiguration?.dictionaryPriorityStrategy ??\n      DICTIONARY_PRIORITY_STRATEGY,\n\n    /**\n     * Indicates if the application should hot reload the locale configurations when a change is detected.\n     * For example, when a new dictionary is added or updated, the application will update the content tu display in the page.\n     *\n     * The hot reload is only available for clients of the `enterprise` plan.\n     *\n     * Default: false\n     */\n    liveSync: customConfiguration?.liveSync ?? LIVE_SYNC,\n\n    /**\n     * Port of the live sync server\n     *\n     * Default: 4000\n     */\n    liveSyncPort,\n\n    /**\n     * URL of the live sync server in case of remote live sync server\n     *\n     * Default: `http://localhost:${LIVE_SYNC_PORT}`\n     */\n    liveSyncURL:\n      customConfiguration?.liveSyncURL ?? `http://localhost:${liveSyncPort}`,\n  };\n};\n\n/**\n * Build the analytics section of the Intlayer configuration.\n *\n * Analytics is opt-out: `enabled` defaults to `true`, so installing the\n * optional `@intlayer/analytics` package is enough to turn it on. The runtime\n * additionally requires a project key (`editor.clientId`) for attribution\n * before collecting anything.\n *\n * An explicit `enabled` value always wins, so a project whose package manager\n * hides the package from the project root can still opt back in.\n *\n * @param customConfiguration - Partial user-supplied analytics config.\n * @param isPackageInstalled - Whether `@intlayer/analytics` is installed in the\n *   project. Browser callers cannot resolve packages and pass `true`, letting\n *   the runtime dynamic `import()` fail silently when it is absent.\n * @returns A fully-defaulted {@link AnalyticsConfig}.\n */\nexport const buildAnalyticsFields = (\n  customConfiguration?: Partial<AnalyticsConfig>,\n  isPackageInstalled = true\n): AnalyticsConfig => ({\n  /**\n   * Enables analytics collection (page views, content exposures, A/B events).\n   *\n   * Default: true, as soon as `@intlayer/analytics` is installed.\n   */\n  enabled:\n    customConfiguration?.enabled ?? (ANALYTICS_ENABLED && isPackageInstalled),\n\n  /**\n   * Milliseconds between automatic batched flushes to the backend.\n   *\n   * Default: 20000\n   */\n  flushInterval: customConfiguration?.flushInterval ?? ANALYTICS_FLUSH_INTERVAL,\n\n  /**\n   * Fraction of sessions to record, from 0 (none) to 1 (all).\n   *\n   * Default: 1\n   */\n  sampleRate: customConfiguration?.sampleRate ?? ANALYTICS_SAMPLE_RATE,\n});\n\n/**\n * Build the log section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied log config.\n * @param logFunctions - Optional custom log function overrides (server-only).\n * @returns A fully-defaulted {@link LogConfig}.\n */\nexport const buildLogFields = (\n  customConfiguration?: Partial<LogConfig>,\n  logFunctions?: LogFunctions\n): LogConfig => ({\n  /**\n   * Indicates if the logger is enabled\n   *\n   * Default: 'prefix-no-default'\n   *\n   * If 'default', the logger is enabled and can be used.\n   * If 'verbose', the logger will be enabled and can be used, but will log more information.\n   * If 'disabled', the logger is disabled and cannot be used.\n   */\n  mode: customConfiguration?.mode ?? MODE,\n\n  /**\n   * Prefix of the logger\n   *\n   * Default: '[intlayer]'\n   *\n   * The prefix of the logger.\n   */\n  prefix: customConfiguration?.prefix ?? PREFIX,\n\n  /**\n   * Functions to log\n   */\n  error: logFunctions?.error,\n  log: logFunctions?.log,\n  info: logFunctions?.info,\n  warn: logFunctions?.warn,\n});\n\n// ---------------------------------------------------------------------------\n// Browser configuration builders\n// ---------------------------------------------------------------------------\n\n/**\n * Build a browser-safe {@link BrowserIntlayerConfig} from a raw user config.\n *\n * Applies defaults for every field and strips all server-only or sensitive\n * information (`system`, `content`, `build`, `compiler`, `dictionary`, `ai`,\n * `editor.clientId`, `editor.clientSecret`).\n *\n * This is the browser counterpart of `buildConfigurationFields`. It is safe\n * to call in browser environments because it has no Node.js dependencies.\n *\n * @param customConfig - Optional partial user-supplied Intlayer config.\n * @returns A browser-safe configuration object ready for `window.INTLAYER_CONFIG`.\n *\n * @example\n * ```ts\n * import { buildBrowserConfiguration } from '@intlayer/config/client';\n *\n * window.INTLAYER_CONFIG = buildBrowserConfiguration({\n *   internationalization: { locales: ['en', 'fr'], defaultLocale: 'en' },\n * });\n * ```\n */\nexport const buildBrowserConfiguration = (\n  customConfig?: CustomIntlayerConfig\n): BrowserIntlayerConfig => {\n  const { locales, defaultLocale } = buildInternationalizationFields(\n    customConfig?.internationalization\n  );\n  const routing = buildRoutingFields(customConfig?.routing);\n  const {\n    clientId: _clientId,\n    clientSecret: _clientSecret,\n    ...editorPublic\n  } = buildEditorFields(customConfig?.editor);\n  const analytics = buildAnalyticsFields(customConfig?.analytics);\n  const { mode, prefix } = buildLogFields(customConfig?.log);\n\n  return {\n    internationalization: { locales, defaultLocale },\n    routing,\n    editor: editorPublic,\n    analytics,\n    log: { mode, prefix },\n  };\n};\n\n/**\n * Extract a {@link BrowserIntlayerConfig} from an already-built full\n * {@link IntlayerConfig}.\n *\n * Used by build plugins (`vite-intlayer`, `withIntlayer`) which already hold\n * the full server-side config and need to inject the browser-safe subset at\n * compile time via a bundler `define`.\n *\n * @param config - A fully-built server-side Intlayer configuration.\n * @returns The browser-safe subset of that configuration.\n */\nexport const extractBrowserConfiguration = (\n  config: IntlayerConfig\n): BrowserIntlayerConfig => ({\n  internationalization: {\n    locales: config.internationalization.locales,\n    defaultLocale: config.internationalization.defaultLocale,\n  },\n  routing: {\n    mode: config.routing.mode,\n    enableProxy: config.routing.enableProxy,\n    storage: config.routing.storage,\n    basePath: config.routing.basePath,\n    rewrite: config.routing.rewrite,\n  },\n  editor: {\n    applicationURL: config.editor.applicationURL,\n    editorURL: config.editor.editorURL,\n    cmsURL: config.editor.cmsURL,\n    backendURL: config.editor.backendURL,\n    port: config.editor.port,\n    enabled: config.editor.enabled,\n    dictionaryPriorityStrategy: config.editor.dictionaryPriorityStrategy,\n    liveSync: config.editor.liveSync,\n    liveSyncPort: config.editor.liveSyncPort,\n    liveSyncURL: config.editor.liveSyncURL,\n  },\n  analytics: buildAnalyticsFields(config.analytics),\n  log: {\n    mode: config.log.mode,\n    prefix: config.log.prefix,\n  },\n});\n"],"mappings":"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"}

package/dist/cjs/configFile/buildConfigurationFields.cjs

@@ -5,6 +5,7 @@ const require_defaultValues_content = require('../defaultValues/content.cjs');
 const require_defaultValues_dictionary = require('../defaultValues/dictionary.cjs');
 const require_defaultValues_system = require('../defaultValues/system.cjs');
 const require_utils_ESMxCJSHelpers = require('../utils/ESMxCJSHelpers.cjs');
+const require_utils_isPackageInstalled = require('../utils/isPackageInstalled.cjs');
 const require_configFile_buildBrowserConfiguration = require('./buildBrowserConfiguration.cjs');
 const require_configFile_configurationSchema = require('./configurationSchema.cjs');
 let node_fs = require("node:fs");
@@ -13,6 +14,11 @@ let node_path = require("node:path");
 //#region src/configFile/buildConfigurationFields.ts
 let storedConfiguration;
 /**
+* Optional companion package whose presence in the project dependency tree
+* opts the application into analytics collection.
+*/
+const ANALYTICS_PACKAGE_NAME = "@intlayer/analytics";
+/**
 * Build the `system` section of the Intlayer configuration.
 *
 * Resolves all directory paths (dictionaries, types, cache, …) relative to
@@ -594,7 +600,7 @@ const buildConfigurationFields = (customConfiguration, baseDir, logFunctions) =>
 		routing: browserConfig.routing,
 		internationalization: internationalizationConfig,
 		editor: editorConfig,
-		analytics: require_configFile_buildBrowserConfiguration.buildAnalyticsFields(customConfiguration?.analytics),
+		analytics: require_configFile_buildBrowserConfiguration.buildAnalyticsFields(customConfiguration?.analytics, require_utils_isPackageInstalled.isPackageInstalled(ANALYTICS_PACKAGE_NAME, systemConfig.baseDir)),
 		log: logConfig,
 		system: systemConfig,
 		content: contentConfig,

package/dist/cjs/configFile/buildConfigurationFields.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"buildConfigurationFields.cjs","names":["getProjectRequire","isAbsolute","join","statSync","dirname","FILE_EXTENSIONS","CONTENT_DIR","CODE_DIR","EXCLUDED_PATHS","TRAVERSE_PATTERN","OUTPUT_FORMAT","intlayerConfigSchema","buildBrowserConfiguration","buildInternationalizationFields","buildEditorFields","buildLogFields","buildAnalyticsFields"],"sources":["../../../src/configFile/buildConfigurationFields.ts"],"sourcesContent":["import { statSync } from 'node:fs';\nimport { dirname, isAbsolute, join } from 'node:path';\nimport type {\n  AiConfig,\n  BuildConfig,\n  CompilerConfig,\n  ContentConfig,\n  CustomIntlayerConfig,\n  DictionaryConfig,\n  IntlayerConfig,\n  LogFunctions,\n  SystemConfig,\n} from '@intlayer/types/config';\nimport {\n  BUILD_MODE,\n  CACHE,\n  CHUNK_GROUPING,\n  DICTIONARIES_PRELOAD,\n  MINIFY,\n  OUTPUT_FORMAT,\n  PURGE,\n  TRAVERSE_PATTERN,\n  TYPE_CHECKING,\n} from '../defaultValues/build';\nimport {\n  COMPILER_DICTIONARY_KEY_PREFIX,\n  COMPILER_ENABLED,\n  COMPILER_NO_METADATA,\n  COMPILER_SAVE_COMPONENTS,\n} from '../defaultValues/compiler';\nimport {\n  CODE_DIR,\n  CONTENT_DIR,\n  EXCLUDED_PATHS,\n  FILE_EXTENSIONS,\n  WATCH,\n} from '../defaultValues/content';\nimport {\n  CONTENT_AUTO_TRANSFORMATION,\n  FILL,\n  IMPORT_MODE,\n  LOCATION,\n} from '../defaultValues/dictionary';\nimport {\n  CACHE_DIR,\n  CONFIG_DIR,\n  DICTIONARIES_DIR,\n  DYNAMIC_DICTIONARIES_DIR,\n  FETCH_DICTIONARIES_DIR,\n  MAIN_DIR,\n  MODULE_AUGMENTATION_DIR,\n  REMOTE_DICTIONARIES_DIR,\n  TEMP_DIR,\n  TYPES_DIR,\n  UNMERGED_DICTIONARIES_DIR,\n} from '../defaultValues/system';\nimport { getProjectRequire } from '../utils';\nimport {\n  buildAnalyticsFields,\n  buildBrowserConfiguration,\n  buildEditorFields,\n  buildInternationalizationFields,\n  buildLogFields,\n} from './buildBrowserConfiguration';\nimport { intlayerConfigSchema } from './configurationSchema';\n\nexport {\n  type BrowserIntlayerConfig,\n  buildAnalyticsFields,\n  buildBrowserConfiguration,\n  buildEditorFields,\n  buildInternationalizationFields,\n  buildLogFields,\n  buildRoutingFields,\n  extractBrowserConfiguration,\n} from './buildBrowserConfiguration';\n\nlet storedConfiguration: IntlayerConfig;\n\n// ---------------------------------------------------------------------------\n// Server-only field builders (Node.js — not browser-safe)\n// ---------------------------------------------------------------------------\n\n/**\n * Build the `system` section of the Intlayer configuration.\n *\n * Resolves all directory paths (dictionaries, types, cache, …) relative to\n * the project base directory, using Node.js `require.resolve` where available\n * and falling back to `path.join` otherwise.\n *\n * @param baseDir - Project root directory. Defaults to `process.cwd()`.\n * @param customConfiguration - Partial user-supplied system config.\n * @returns A fully-resolved {@link SystemConfig}.\n */\nconst buildSystemFields = (\n  baseDir?: string,\n  customConfiguration?: Partial<SystemConfig>\n): SystemConfig => {\n  const projectBaseDir = baseDir ?? process.cwd();\n\n  const optionalJoinBaseDir = (pathInput: string) => {\n    let absolutePath: string;\n\n    try {\n      const requireFunction = getProjectRequire(projectBaseDir);\n      try {\n        absolutePath = requireFunction.resolve(pathInput, {\n          paths: [projectBaseDir],\n        });\n      } catch (err) {\n        if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n          absolutePath = requireFunction.resolve(`${pathInput}/package.json`, {\n            paths: [projectBaseDir],\n          });\n        } else {\n          throw err;\n        }\n      }\n    } catch {\n      absolutePath = isAbsolute(pathInput)\n        ? pathInput\n        : join(projectBaseDir, pathInput);\n    }\n\n    try {\n      const stats = statSync(absolutePath);\n      if (stats.isFile()) {\n        return dirname(absolutePath);\n      }\n    } catch {\n      if (/\\.[a-z0-9]+$/i.test(absolutePath)) {\n        return dirname(absolutePath);\n      }\n    }\n\n    return absolutePath;\n  };\n\n  const dictionariesDir = optionalJoinBaseDir(\n    customConfiguration?.dictionariesDir ?? DICTIONARIES_DIR\n  );\n\n  return {\n    baseDir: projectBaseDir,\n    moduleAugmentationDir: optionalJoinBaseDir(\n      customConfiguration?.moduleAugmentationDir ?? MODULE_AUGMENTATION_DIR\n    ),\n    unmergedDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.unmergedDictionariesDir ?? UNMERGED_DICTIONARIES_DIR\n    ),\n    remoteDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.remoteDictionariesDir ?? REMOTE_DICTIONARIES_DIR\n    ),\n    dictionariesDir,\n    dynamicDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.dynamicDictionariesDir ?? DYNAMIC_DICTIONARIES_DIR\n    ),\n    fetchDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.fetchDictionariesDir ?? FETCH_DICTIONARIES_DIR\n    ),\n    typesDir: optionalJoinBaseDir(customConfiguration?.typesDir ?? TYPES_DIR),\n    mainDir: optionalJoinBaseDir(customConfiguration?.mainDir ?? MAIN_DIR),\n    configDir: optionalJoinBaseDir(\n      customConfiguration?.configDir ?? CONFIG_DIR\n    ),\n    cacheDir: optionalJoinBaseDir(customConfiguration?.cacheDir ?? CACHE_DIR),\n    tempDir: optionalJoinBaseDir(customConfiguration?.tempDir ?? TEMP_DIR),\n  };\n};\n\n/**\n * Build the `content` section of the Intlayer configuration.\n *\n * Resolves content and code directories relative to the project base using\n * `require.resolve`, falling back to `path.join`.\n *\n * @param systemConfig - Already-built system configuration (provides `baseDir`).\n * @param customConfiguration - Partial user-supplied content config.\n * @returns A fully-resolved {@link ContentConfig}.\n */\nconst buildContentFields = (\n  systemConfig: SystemConfig,\n  customConfiguration?: Partial<ContentConfig>\n): ContentConfig => {\n  const fileExtensions = customConfiguration?.fileExtensions ?? FILE_EXTENSIONS;\n\n  const optionalJoinBaseDir = (pathInput: string) => {\n    let absolutePath: string;\n\n    try {\n      const requireFunction = getProjectRequire(systemConfig.baseDir);\n      try {\n        absolutePath = requireFunction.resolve(pathInput, {\n          paths: [systemConfig.baseDir],\n        });\n      } catch (err) {\n        if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n          absolutePath = requireFunction.resolve(`${pathInput}/package.json`, {\n            paths: [systemConfig.baseDir],\n          });\n        } else {\n          throw err;\n        }\n      }\n    } catch {\n      try {\n        try {\n          absolutePath = require.resolve(pathInput, {\n            paths: [systemConfig.baseDir],\n          });\n        } catch (err) {\n          if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n            absolutePath = require.resolve(`${pathInput}/package.json`, {\n              paths: [systemConfig.baseDir],\n            });\n          } else {\n            throw err;\n          }\n        }\n      } catch {\n        absolutePath = isAbsolute(pathInput)\n          ? pathInput\n          : join(systemConfig.baseDir, pathInput);\n      }\n    }\n\n    try {\n      const stats = statSync(absolutePath);\n      if (stats.isFile()) {\n        return dirname(absolutePath);\n      }\n    } catch {\n      if (/\\.[a-z0-9]+$/i.test(absolutePath)) {\n        return dirname(absolutePath);\n      }\n    }\n\n    return absolutePath;\n  };\n\n  const contentDir = (customConfiguration?.contentDir ?? CONTENT_DIR).map(\n    optionalJoinBaseDir\n  );\n  const codeDir = (customConfiguration?.codeDir ?? CODE_DIR).map(\n    optionalJoinBaseDir\n  );\n\n  return {\n    fileExtensions,\n    contentDir,\n    codeDir,\n    excludedPath: customConfiguration?.excludedPath ?? EXCLUDED_PATHS,\n    watch: customConfiguration?.watch ?? WATCH,\n    formatCommand: customConfiguration?.formatCommand,\n  };\n};\n\n/**\n * Build the `ai` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied AI config.\n * @returns A fully-defaulted {@link AiConfig}.\n */\nconst buildAiFields = (customConfiguration?: Partial<AiConfig>): AiConfig => ({\n  /**\n   * AI configuration\n   */\n  provider: customConfiguration?.provider,\n\n  /**\n   * API key\n   */\n  apiKey: customConfiguration?.apiKey,\n\n  /**\n   * API model\n   */\n  model: customConfiguration?.model,\n\n  /**\n   * Temperature\n   */\n  temperature: customConfiguration?.temperature,\n\n  /**\n   * Application context\n   *\n   * Default: undefined\n   *\n   * The application context.\n   *\n   * Example: `'My application context'`\n   *\n   * Note: Can be used to provide additional context about the application to the AI model. You can add more rules (e.g. \"You should not transform urls\").\n   */\n  applicationContext: customConfiguration?.applicationContext,\n\n  /**\n   * Base URL for the AI API\n   *\n   * Default: undefined\n   *\n   * The base URL for the AI API.\n   *\n   * Example: `'http://localhost:5000'`\n   *\n   * Note: Can be used to point to a local, or custom AI API endpoint.\n   */\n  baseURL: customConfiguration?.baseURL,\n\n  /**\n   * Data serialization\n   *\n   * Options:\n   * - \"json\": The industry standard. Highly reliable and structured, but consumes more tokens.\n   * - \"toon\": An optimized format designed to reduce token consumption (cost-effective). However, it may slightly increase the risk of output inconsistency compared to standard JSON\n   *\n   * Default: `\"json\"`\n   */\n  dataSerialization: customConfiguration?.dataSerialization,\n});\n\n/**\n * Build the `build` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied build config.\n * @returns A fully-defaulted {@link BuildConfig}.\n */\nconst buildBuildFields = (\n  customConfiguration?: Partial<BuildConfig>\n): BuildConfig => ({\n  /**\n   * Indicates the mode of the build\n   *\n   * Default: 'auto'\n   *\n   * If 'auto', the build will be enabled automatically when the application is built.\n   * If 'manual', the build will be set only when the build command is executed.\n   *\n   * Can be used to disable dictionaries build, for instance when execution on Node.js environment should be avoided.\n   */\n  mode: customConfiguration?.mode ?? BUILD_MODE,\n\n  /**\n   * Indicates if the build should be optimized\n   *\n   * Default: process.env.NODE_ENV === 'production'\n   *\n   * If true, the build will be optimized.\n   * If false, the build will not be optimized.\n   *\n   * Intlayer will replace all calls of dictionaries to optimize chunking. That way the final bundle will import only the dictionaries that are used.\n   * All imports will stay as static import to avoid async processing when loading the dictionaries.\n   *\n   * Note:\n   * - Intlayer will replace all call of `useIntlayer` with the defined mode by the `importMode` option.\n   * - Intlayer will replace all call of `getIntlayer` with `getDictionary`.\n   * - This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.\n   * - In most cases, \"dynamic\" will be used for React applications, \"async\" for Vue.js applications.\n   * - Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.\n   */\n  optimize: customConfiguration?.optimize,\n\n  /**\n   * Indicates the mode of import to use for the dictionaries.\n   *\n   * Available modes:\n   * - \"static\": The dictionaries are imported statically.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionary`.\n   * - \"dynamic\": The dictionaries are imported dynamically in a synchronous component using the suspense API.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionaryDynamic`.\n   * - \"live\": The dictionaries are imported dynamically using the live sync API.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionaryDynamic`.\n   *   Live mode will use the live sync API to fetch the dictionaries. If the API call fails, the dictionaries will be imported dynamically as \"dynamic\" mode.\n   *\n   * Default: \"static\"\n   *\n   * By default, when a dictionary is loaded, it imports content for all locales as it's imported statically.\n   *\n   * Note:\n   * - Dynamic imports rely on Suspense and may slightly impact rendering performance.\n   * - If disabled all locales will be loaded at once, even if they are not used.\n   * - This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.\n   * - Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will not impact the `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` and `useDictionaryDynamic` functions. You can still use them to refine you code on manual optimization.\n   * - The \"live\" allows to sync the dictionaries to the live sync server.\n   *\n   * @deprecated Use `dictionary.importMode` instead.\n   */\n  importMode: customConfiguration?.importMode,\n\n  /**\n   * Minify the dictionaries to reduce the bundle size.\n   *\n   * Default: false\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will be ignore if `editor.enabled` is true.\n   * - If there is edge cases where the minification is not working properly, the dictionary will be not minified.\n   */\n  minify: customConfiguration?.minify ?? MINIFY,\n\n  /**\n   * Purge the unused keys in a dictionaries\n   *\n   * Default: false\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will be ignored if `editor.enabled` is true.\n   */\n  purge: customConfiguration?.purge ?? PURGE,\n\n  /**\n   * Group the per-locale dictionary chunks by the code-split boundary that uses\n   * them, so a lazily loaded page fetches its content in one request.\n   *\n   * Default: true\n   *\n   * Note:\n   * - Only applies to dictionaries using `importMode: 'dynamic'`.\n   * - Only applies to the client build, and only when bundling (not in dev).\n   */\n  chunkGrouping: customConfiguration?.chunkGrouping ?? CHUNK_GROUPING,\n\n  /**\n   * Load a dictionary together with the chunk that uses it, instead of fetching\n   * it once that chunk renders — so a reader renders synchronously rather than\n   * suspending, and navigating no longer flashes a loading state.\n   *\n   * Default: true\n   *\n   * Note:\n   * - Only applies to dictionaries using `importMode: 'dynamic'`.\n   * - Only applies to the client build; the server keeps loading on demand.\n   * - Requires a bundler supporting top-level await (Vite, esbuild).\n   */\n  dictionariesPreload:\n    customConfiguration?.dictionariesPreload ?? DICTIONARIES_PRELOAD,\n\n  /**\n   * Pattern to traverse the code to optimize.\n   *\n   * Allows to avoid to traverse the code that is not relevant to the optimization.\n   * Improve build performance.\n   *\n   * Default: ['**\\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\\/node_modules/**']\n   *\n   * Example: `['src/**\\/*.{ts,tsx}', '../ui-library/**\\/*.{ts,tsx}']`\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - Use glob pattern.\n   */\n  traversePattern: customConfiguration?.traversePattern ?? TRAVERSE_PATTERN,\n\n  /**\n   * Output format of the dictionaries\n   *\n   * Can be set on large projects to improve build performance.\n   *\n   * Default: ['cjs', 'esm']\n   *\n   * The output format of the dictionaries. It can be either 'cjs' or 'esm'.\n   * - 'cjs': The dictionaries are outputted as CommonJS modules.\n   * - 'esm': The dictionaries are outputted as ES modules.\n   */\n  outputFormat: customConfiguration?.outputFormat ?? OUTPUT_FORMAT,\n\n  /**\n   * Cache\n   */\n  cache: customConfiguration?.cache ?? CACHE,\n\n  /**\n   * Require function\n   */\n  require: customConfiguration?.require,\n\n  /**\n   * Indicates if the build should check TypeScript types\n   *\n   * Default: `false`\n   *\n   * If true, the build will check TypeScript types and log errors.\n   * Note: This can slow down the build.\n   */\n  checkTypes: customConfiguration?.checkTypes ?? TYPE_CHECKING,\n});\n\n/**\n * Build the `compiler` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied compiler config.\n * @returns A fully-defaulted {@link CompilerConfig}.\n */\nconst buildCompilerFields = (\n  customConfiguration?: Partial<CompilerConfig>\n): CompilerConfig => ({\n  /**\n   * Indicates if the compiler should be enabled\n   */\n  enabled: customConfiguration?.enabled ?? COMPILER_ENABLED,\n\n  /**\n   * Prefix for the extracted dictionary keys\n   */\n  dictionaryKeyPrefix:\n    customConfiguration?.dictionaryKeyPrefix ?? COMPILER_DICTIONARY_KEY_PREFIX,\n\n  /**\n   * Pattern to traverse the code to optimize.\n   *\n   * @deprecated use `build.traversePattern` instead\n   */\n  transformPattern: customConfiguration?.transformPattern,\n\n  /**\n   * Pattern to exclude from the optimization.\n   *\n   * @deprecated use `build.traversePattern` instead\n   */\n  excludePattern: customConfiguration?.excludePattern,\n\n  /**\n   * Defines the output files path. Replaces `outputDir`.\n   *\n   * - `./` paths are resolved relative to the component directory.\n   * - `/` paths are resolved relative to the project root (`baseDir`).\n   *\n   * - Including the `{{locale}}` variable in the path will trigger the generation of separate dictionaries per locale.\n   *\n   * @example:\n   * ```ts\n   * {\n   *   // Create Multilingual .content.ts files close to the component\n   *   output: ({ fileName, extension }) => `./${fileName}${extension}`,\n   *\n   *   // output: './{{fileName}}{{extension}}', // Equivalent using template string\n   * }\n   * ```\n   *\n   * ```ts\n   * {\n   *   // Create centralize per-locale JSON at the root of the project\n   *   output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,\n   *\n   *   // output: '/locales/{{locale}}/{{key}}.content.json', // Equivalent using template string\n   * }\n   * ```\n   *\n   * ```ts\n   * {\n   *   // Create per-locale JSON files with locale-specific output paths\n   *   output: {\n   *     en: ({ fileName, locale }) => `${fileName}.${locale}.content.json`,\n   *     fr: '{{fileName}}.{{locale}}.content.json',\n   *     es: false, // skip this locale\n   *   },\n   * }\n   * ```\n   *\n   * Variable list:\n   *   - `fileName`: The name of the file.\n   *   - `key`: The key of the content.\n   *   - `locale`: The locale of the content.\n   *   - `extension`: The extension of the file.\n   *   - `componentFileName`: The name of the component file.\n   *   - `componentExtension`: The extension of the component file.\n   *   - `format`: The format of the dictionary.\n   *   - `componentFormat`: The format of the component dictionary.\n   *   - `componentDirPath`: The directory path of the component.\n   */\n  output: customConfiguration?.output,\n\n  /**\n   * Indicates if the metadata should be saved in the file.\n   *\n   * If true, the compiler will not save the metadata of the dictionaries.\n   *\n   * If `true`:\n   *\n   * ```json\n   * {\n   *   \"key\": \"value\"\n   * }\n   * ```\n   *\n   * If `false`:\n   *\n   * ```json\n   * {\n   *   \"key\": \"value\",\n   *   \"content\": {\n   *      \"key\": \"value\"\n   *   }\n   * }\n   * ```\n   *\n   * Default: `false`\n   *\n   * Note: Useful if used with loadJSON plugin\n   */\n  noMetadata: customConfiguration?.noMetadata ?? COMPILER_NO_METADATA,\n\n  /**\n   * Indicates if the components should be saved after being transformed.\n   */\n  saveComponents:\n    customConfiguration?.saveComponents ?? COMPILER_SAVE_COMPONENTS,\n});\n\n/**\n * Build the `dictionary` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied dictionary config.\n * @returns A fully-defaulted {@link DictionaryConfig}.\n */\nconst buildDictionaryFields = (\n  customConfiguration?: Partial<DictionaryConfig>\n): DictionaryConfig => {\n  const contentAutoTransformation =\n    customConfiguration?.contentAutoTransformation ??\n    CONTENT_AUTO_TRANSFORMATION;\n\n  return {\n    /**\n     * Indicate how the dictionary should be filled using AI.\n     *\n     * Default: `true`\n     *\n     * - If `true`, will consider the `compiler.output` field.\n     * - If `false`, will skip the fill process.\n     *\n     * - `./` paths are resolved relative to the component directory.\n     * - `/` paths are resolved relative to the project root (`baseDir`).\n     *\n     * - If includes `{{locale}}` variable in the path, will trigger the generation of separate dictionaries per locale.\n     *\n     * Example:\n     * ```ts\n     * {\n     *   // Create Multilingual .content.ts files close to the component\n     *   fill: ({ fileName, extension }) => `./${fileName}${extension}`,\n     *\n     *   // fill: './{{fileName}}{{extension}}', // Equivalent using template string\n     * }\n     * ```\n     *\n     * ```ts\n     * {\n     *   // Create centralize per-locale JSON at the root of the project\n     *   fill: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,\n     *\n     *   // fill: '/locales/{{locale}}/{{key}}.content.json', // Equivalent using template string\n     * }\n     * ```\n     *\n     * ```ts\n     * {\n     *   // Create custom output based on the locale\n     *   fill: {\n     *     en: ({ key }) => `/locales/en/${key}.content.json`,\n     *     fr: '/locales/fr/{{key}}.content.json',\n     *     es: false,\n     *     de: true,\n     *   },\n     * }\n     * ```\n     *\n     *\n     * Variable list:\n     *   - `fileName`: The name of the file.\n     *   - `key`: The key of the content.\n     *   - `locale`: The locale of the content.\n     *   - `extension`: The extension of the file.\n     *   - `componentFileName`: The name of the component file.\n     *   - `componentExtension`: The extension of the component file.\n     *   - `format`: The format of the dictionary.\n     *   - `componentFormat`: The format of the component dictionary.\n     *   - `componentDirPath`: The directory path of the component.\n     */\n    fill: customConfiguration?.fill ?? FILL,\n\n    /**\n     * Indicates if the content of the dictionary should be automatically transformed.\n     *\n     * Default: `false`\n     */\n    contentAutoTransformation:\n      typeof contentAutoTransformation === 'object'\n        ? {\n            markdown: contentAutoTransformation.markdown ?? false,\n            html: contentAutoTransformation.html ?? false,\n            insertion: contentAutoTransformation.insertion ?? false,\n          }\n        : contentAutoTransformation,\n\n    /**\n     * The location of the dictionary.\n     *\n     * Default: `\"local\"`\n     */\n    location: customConfiguration?.location ?? LOCATION,\n\n    /**\n     * Transform the dictionary in a per-locale dictionary.\n     * Each field declared in a per-locale dictionary will be transformed in a translation node.\n     * If missing, the dictionary will be treated as a multilingual dictionary.\n     */\n    locale: customConfiguration?.locale,\n\n    /**\n     * The title of the dictionary.\n     */\n    title: customConfiguration?.title,\n\n    /**\n     * The description of the dictionary.\n     */\n    description: customConfiguration?.description,\n\n    /**\n     * Tags to categorize the dictionaries.\n     */\n    tags: customConfiguration?.tags,\n\n    /**\n     * The priority of the dictionary.\n     */\n    priority: customConfiguration?.priority,\n\n    /**\n     * Indicates the mode of import to use for the dictionary.\n     *\n     * Available modes:\n     * - \"static\": The dictionaries are imported statically.\n     * - \"dynamic\": The dictionaries are imported dynamically in a synchronous component using the suspense API.\n     * - \"live\": The dictionaries are imported dynamically using the live sync API.\n     *\n     * Default: `\"static\"`\n     */\n    importMode: customConfiguration?.importMode ?? IMPORT_MODE,\n\n    /**\n     * The default message format for all dictionaries in the project.\n     *\n     * Default: 'intlayer'\n     */\n    format: customConfiguration?.format,\n  };\n};\n\n// ---------------------------------------------------------------------------\n// Main export\n// ---------------------------------------------------------------------------\n\n/**\n * Build the complete Intlayer configuration by merging user-supplied values\n * with defaults.\n *\n * Internally this function:\n * 1. Calls {@link buildBrowserConfiguration} to produce the browser-safe\n *    subset (internationalization, routing, editor public fields, log, metadata).\n * 2. Extends the result with full server-side fields:\n *    - `internationalization` — adds `requiredLocales` and `strictMode`.\n *    - `editor` — adds `clientId` and `clientSecret`.\n *    - `log` — adds custom log functions.\n *    - `system`, `content`, `ai`, `build`, `compiler`, `dictionary`.\n *\n * @param customConfiguration - Optional user-supplied configuration object.\n * @param baseDir - Project root directory. Defaults to `process.cwd()`.\n * @param logFunctions - Optional custom logging functions.\n * @returns A fully-built {@link IntlayerConfig}.\n */\nexport const buildConfigurationFields = (\n  customConfiguration?: CustomIntlayerConfig,\n  baseDir?: string,\n  logFunctions?: LogFunctions\n): IntlayerConfig => {\n  if (customConfiguration) {\n    const result = intlayerConfigSchema.safeParse(customConfiguration);\n\n    if (!result.success) {\n      const logError = logFunctions?.error ?? console.error;\n\n      for (const issue of result.error.issues) {\n        logError(`${issue.path.join('.')}: ${issue.message}`);\n      }\n    }\n  }\n\n  // build browser-safe config (shared defaults, no Node.js deps)\n  const browserConfig = buildBrowserConfiguration(customConfiguration);\n\n  // extend shared fields with server-only additions\n  const internationalizationConfig = buildInternationalizationFields(\n    customConfiguration?.internationalization\n  );\n\n  const editorConfig = buildEditorFields(customConfiguration?.editor);\n\n  const logConfig = buildLogFields(customConfiguration?.log, logFunctions);\n\n  // build server-only fields\n  const systemConfig = buildSystemFields(baseDir, customConfiguration?.system);\n\n  const contentConfig = buildContentFields(\n    systemConfig,\n    customConfiguration?.content\n  );\n\n  storedConfiguration = {\n    // Shared browser fields\n    routing: browserConfig.routing,\n    // Full (extended) shared fields\n    internationalization: internationalizationConfig,\n    editor: editorConfig,\n    analytics: buildAnalyticsFields(customConfiguration?.analytics),\n    log: logConfig,\n    // Server-only fields\n    system: systemConfig,\n    content: contentConfig,\n    ai: buildAiFields(customConfiguration?.ai),\n    build: buildBuildFields(customConfiguration?.build),\n    compiler: buildCompilerFields(customConfiguration?.compiler),\n    dictionary: buildDictionaryFields(customConfiguration?.dictionary),\n    plugins: customConfiguration?.plugins,\n    schemas: customConfiguration?.schemas,\n  } as IntlayerConfig;\n\n  return storedConfiguration;\n};\n"],"mappings":"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"}
+{"version":3,"file":"buildConfigurationFields.cjs","names":["getProjectRequire","isAbsolute","join","statSync","dirname","FILE_EXTENSIONS","CONTENT_DIR","CODE_DIR","EXCLUDED_PATHS","TRAVERSE_PATTERN","OUTPUT_FORMAT","intlayerConfigSchema","buildBrowserConfiguration","buildInternationalizationFields","buildEditorFields","buildLogFields","buildAnalyticsFields","isPackageInstalled"],"sources":["../../../src/configFile/buildConfigurationFields.ts"],"sourcesContent":["import { statSync } from 'node:fs';\nimport { dirname, isAbsolute, join } from 'node:path';\nimport type {\n  AiConfig,\n  BuildConfig,\n  CompilerConfig,\n  ContentConfig,\n  CustomIntlayerConfig,\n  DictionaryConfig,\n  IntlayerConfig,\n  LogFunctions,\n  SystemConfig,\n} from '@intlayer/types/config';\nimport {\n  BUILD_MODE,\n  CACHE,\n  CHUNK_GROUPING,\n  DICTIONARIES_PRELOAD,\n  MINIFY,\n  OUTPUT_FORMAT,\n  PURGE,\n  TRAVERSE_PATTERN,\n  TYPE_CHECKING,\n} from '../defaultValues/build';\nimport {\n  COMPILER_DICTIONARY_KEY_PREFIX,\n  COMPILER_ENABLED,\n  COMPILER_NO_METADATA,\n  COMPILER_SAVE_COMPONENTS,\n} from '../defaultValues/compiler';\nimport {\n  CODE_DIR,\n  CONTENT_DIR,\n  EXCLUDED_PATHS,\n  FILE_EXTENSIONS,\n  WATCH,\n} from '../defaultValues/content';\nimport {\n  CONTENT_AUTO_TRANSFORMATION,\n  FILL,\n  IMPORT_MODE,\n  LOCATION,\n} from '../defaultValues/dictionary';\nimport {\n  CACHE_DIR,\n  CONFIG_DIR,\n  DICTIONARIES_DIR,\n  DYNAMIC_DICTIONARIES_DIR,\n  FETCH_DICTIONARIES_DIR,\n  MAIN_DIR,\n  MODULE_AUGMENTATION_DIR,\n  REMOTE_DICTIONARIES_DIR,\n  TEMP_DIR,\n  TYPES_DIR,\n  UNMERGED_DICTIONARIES_DIR,\n} from '../defaultValues/system';\nimport { getProjectRequire, isPackageInstalled } from '../utils';\nimport {\n  buildAnalyticsFields,\n  buildBrowserConfiguration,\n  buildEditorFields,\n  buildInternationalizationFields,\n  buildLogFields,\n} from './buildBrowserConfiguration';\nimport { intlayerConfigSchema } from './configurationSchema';\n\nexport {\n  type BrowserIntlayerConfig,\n  buildAnalyticsFields,\n  buildBrowserConfiguration,\n  buildEditorFields,\n  buildInternationalizationFields,\n  buildLogFields,\n  buildRoutingFields,\n  extractBrowserConfiguration,\n} from './buildBrowserConfiguration';\n\nlet storedConfiguration: IntlayerConfig;\n\n/**\n * Optional companion package whose presence in the project dependency tree\n * opts the application into analytics collection.\n */\nconst ANALYTICS_PACKAGE_NAME = '@intlayer/analytics';\n\n// ---------------------------------------------------------------------------\n// Server-only field builders (Node.js — not browser-safe)\n// ---------------------------------------------------------------------------\n\n/**\n * Build the `system` section of the Intlayer configuration.\n *\n * Resolves all directory paths (dictionaries, types, cache, …) relative to\n * the project base directory, using Node.js `require.resolve` where available\n * and falling back to `path.join` otherwise.\n *\n * @param baseDir - Project root directory. Defaults to `process.cwd()`.\n * @param customConfiguration - Partial user-supplied system config.\n * @returns A fully-resolved {@link SystemConfig}.\n */\nconst buildSystemFields = (\n  baseDir?: string,\n  customConfiguration?: Partial<SystemConfig>\n): SystemConfig => {\n  const projectBaseDir = baseDir ?? process.cwd();\n\n  const optionalJoinBaseDir = (pathInput: string) => {\n    let absolutePath: string;\n\n    try {\n      const requireFunction = getProjectRequire(projectBaseDir);\n      try {\n        absolutePath = requireFunction.resolve(pathInput, {\n          paths: [projectBaseDir],\n        });\n      } catch (err) {\n        if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n          absolutePath = requireFunction.resolve(`${pathInput}/package.json`, {\n            paths: [projectBaseDir],\n          });\n        } else {\n          throw err;\n        }\n      }\n    } catch {\n      absolutePath = isAbsolute(pathInput)\n        ? pathInput\n        : join(projectBaseDir, pathInput);\n    }\n\n    try {\n      const stats = statSync(absolutePath);\n      if (stats.isFile()) {\n        return dirname(absolutePath);\n      }\n    } catch {\n      if (/\\.[a-z0-9]+$/i.test(absolutePath)) {\n        return dirname(absolutePath);\n      }\n    }\n\n    return absolutePath;\n  };\n\n  const dictionariesDir = optionalJoinBaseDir(\n    customConfiguration?.dictionariesDir ?? DICTIONARIES_DIR\n  );\n\n  return {\n    baseDir: projectBaseDir,\n    moduleAugmentationDir: optionalJoinBaseDir(\n      customConfiguration?.moduleAugmentationDir ?? MODULE_AUGMENTATION_DIR\n    ),\n    unmergedDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.unmergedDictionariesDir ?? UNMERGED_DICTIONARIES_DIR\n    ),\n    remoteDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.remoteDictionariesDir ?? REMOTE_DICTIONARIES_DIR\n    ),\n    dictionariesDir,\n    dynamicDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.dynamicDictionariesDir ?? DYNAMIC_DICTIONARIES_DIR\n    ),\n    fetchDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.fetchDictionariesDir ?? FETCH_DICTIONARIES_DIR\n    ),\n    typesDir: optionalJoinBaseDir(customConfiguration?.typesDir ?? TYPES_DIR),\n    mainDir: optionalJoinBaseDir(customConfiguration?.mainDir ?? MAIN_DIR),\n    configDir: optionalJoinBaseDir(\n      customConfiguration?.configDir ?? CONFIG_DIR\n    ),\n    cacheDir: optionalJoinBaseDir(customConfiguration?.cacheDir ?? CACHE_DIR),\n    tempDir: optionalJoinBaseDir(customConfiguration?.tempDir ?? TEMP_DIR),\n  };\n};\n\n/**\n * Build the `content` section of the Intlayer configuration.\n *\n * Resolves content and code directories relative to the project base using\n * `require.resolve`, falling back to `path.join`.\n *\n * @param systemConfig - Already-built system configuration (provides `baseDir`).\n * @param customConfiguration - Partial user-supplied content config.\n * @returns A fully-resolved {@link ContentConfig}.\n */\nconst buildContentFields = (\n  systemConfig: SystemConfig,\n  customConfiguration?: Partial<ContentConfig>\n): ContentConfig => {\n  const fileExtensions = customConfiguration?.fileExtensions ?? FILE_EXTENSIONS;\n\n  const optionalJoinBaseDir = (pathInput: string) => {\n    let absolutePath: string;\n\n    try {\n      const requireFunction = getProjectRequire(systemConfig.baseDir);\n      try {\n        absolutePath = requireFunction.resolve(pathInput, {\n          paths: [systemConfig.baseDir],\n        });\n      } catch (err) {\n        if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n          absolutePath = requireFunction.resolve(`${pathInput}/package.json`, {\n            paths: [systemConfig.baseDir],\n          });\n        } else {\n          throw err;\n        }\n      }\n    } catch {\n      try {\n        try {\n          absolutePath = require.resolve(pathInput, {\n            paths: [systemConfig.baseDir],\n          });\n        } catch (err) {\n          if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n            absolutePath = require.resolve(`${pathInput}/package.json`, {\n              paths: [systemConfig.baseDir],\n            });\n          } else {\n            throw err;\n          }\n        }\n      } catch {\n        absolutePath = isAbsolute(pathInput)\n          ? pathInput\n          : join(systemConfig.baseDir, pathInput);\n      }\n    }\n\n    try {\n      const stats = statSync(absolutePath);\n      if (stats.isFile()) {\n        return dirname(absolutePath);\n      }\n    } catch {\n      if (/\\.[a-z0-9]+$/i.test(absolutePath)) {\n        return dirname(absolutePath);\n      }\n    }\n\n    return absolutePath;\n  };\n\n  const contentDir = (customConfiguration?.contentDir ?? CONTENT_DIR).map(\n    optionalJoinBaseDir\n  );\n  const codeDir = (customConfiguration?.codeDir ?? CODE_DIR).map(\n    optionalJoinBaseDir\n  );\n\n  return {\n    fileExtensions,\n    contentDir,\n    codeDir,\n    excludedPath: customConfiguration?.excludedPath ?? EXCLUDED_PATHS,\n    watch: customConfiguration?.watch ?? WATCH,\n    formatCommand: customConfiguration?.formatCommand,\n  };\n};\n\n/**\n * Build the `ai` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied AI config.\n * @returns A fully-defaulted {@link AiConfig}.\n */\nconst buildAiFields = (customConfiguration?: Partial<AiConfig>): AiConfig => ({\n  /**\n   * AI configuration\n   */\n  provider: customConfiguration?.provider,\n\n  /**\n   * API key\n   */\n  apiKey: customConfiguration?.apiKey,\n\n  /**\n   * API model\n   */\n  model: customConfiguration?.model,\n\n  /**\n   * Temperature\n   */\n  temperature: customConfiguration?.temperature,\n\n  /**\n   * Application context\n   *\n   * Default: undefined\n   *\n   * The application context.\n   *\n   * Example: `'My application context'`\n   *\n   * Note: Can be used to provide additional context about the application to the AI model. You can add more rules (e.g. \"You should not transform urls\").\n   */\n  applicationContext: customConfiguration?.applicationContext,\n\n  /**\n   * Base URL for the AI API\n   *\n   * Default: undefined\n   *\n   * The base URL for the AI API.\n   *\n   * Example: `'http://localhost:5000'`\n   *\n   * Note: Can be used to point to a local, or custom AI API endpoint.\n   */\n  baseURL: customConfiguration?.baseURL,\n\n  /**\n   * Data serialization\n   *\n   * Options:\n   * - \"json\": The industry standard. Highly reliable and structured, but consumes more tokens.\n   * - \"toon\": An optimized format designed to reduce token consumption (cost-effective). However, it may slightly increase the risk of output inconsistency compared to standard JSON\n   *\n   * Default: `\"json\"`\n   */\n  dataSerialization: customConfiguration?.dataSerialization,\n});\n\n/**\n * Build the `build` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied build config.\n * @returns A fully-defaulted {@link BuildConfig}.\n */\nconst buildBuildFields = (\n  customConfiguration?: Partial<BuildConfig>\n): BuildConfig => ({\n  /**\n   * Indicates the mode of the build\n   *\n   * Default: 'auto'\n   *\n   * If 'auto', the build will be enabled automatically when the application is built.\n   * If 'manual', the build will be set only when the build command is executed.\n   *\n   * Can be used to disable dictionaries build, for instance when execution on Node.js environment should be avoided.\n   */\n  mode: customConfiguration?.mode ?? BUILD_MODE,\n\n  /**\n   * Indicates if the build should be optimized\n   *\n   * Default: process.env.NODE_ENV === 'production'\n   *\n   * If true, the build will be optimized.\n   * If false, the build will not be optimized.\n   *\n   * Intlayer will replace all calls of dictionaries to optimize chunking. That way the final bundle will import only the dictionaries that are used.\n   * All imports will stay as static import to avoid async processing when loading the dictionaries.\n   *\n   * Note:\n   * - Intlayer will replace all call of `useIntlayer` with the defined mode by the `importMode` option.\n   * - Intlayer will replace all call of `getIntlayer` with `getDictionary`.\n   * - This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.\n   * - In most cases, \"dynamic\" will be used for React applications, \"async\" for Vue.js applications.\n   * - Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.\n   */\n  optimize: customConfiguration?.optimize,\n\n  /**\n   * Indicates the mode of import to use for the dictionaries.\n   *\n   * Available modes:\n   * - \"static\": The dictionaries are imported statically.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionary`.\n   * - \"dynamic\": The dictionaries are imported dynamically in a synchronous component using the suspense API.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionaryDynamic`.\n   * - \"live\": The dictionaries are imported dynamically using the live sync API.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionaryDynamic`.\n   *   Live mode will use the live sync API to fetch the dictionaries. If the API call fails, the dictionaries will be imported dynamically as \"dynamic\" mode.\n   *\n   * Default: \"static\"\n   *\n   * By default, when a dictionary is loaded, it imports content for all locales as it's imported statically.\n   *\n   * Note:\n   * - Dynamic imports rely on Suspense and may slightly impact rendering performance.\n   * - If disabled all locales will be loaded at once, even if they are not used.\n   * - This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.\n   * - Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will not impact the `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` and `useDictionaryDynamic` functions. You can still use them to refine you code on manual optimization.\n   * - The \"live\" allows to sync the dictionaries to the live sync server.\n   *\n   * @deprecated Use `dictionary.importMode` instead.\n   */\n  importMode: customConfiguration?.importMode,\n\n  /**\n   * Minify the dictionaries to reduce the bundle size.\n   *\n   * Default: false\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will be ignore if `editor.enabled` is true.\n   * - If there is edge cases where the minification is not working properly, the dictionary will be not minified.\n   */\n  minify: customConfiguration?.minify ?? MINIFY,\n\n  /**\n   * Purge the unused keys in a dictionaries\n   *\n   * Default: false\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will be ignored if `editor.enabled` is true.\n   */\n  purge: customConfiguration?.purge ?? PURGE,\n\n  /**\n   * Group the per-locale dictionary chunks by the code-split boundary that uses\n   * them, so a lazily loaded page fetches its content in one request.\n   *\n   * Default: true\n   *\n   * Note:\n   * - Only applies to dictionaries using `importMode: 'dynamic'`.\n   * - Only applies to the client build, and only when bundling (not in dev).\n   */\n  chunkGrouping: customConfiguration?.chunkGrouping ?? CHUNK_GROUPING,\n\n  /**\n   * Load a dictionary together with the chunk that uses it, instead of fetching\n   * it once that chunk renders — so a reader renders synchronously rather than\n   * suspending, and navigating no longer flashes a loading state.\n   *\n   * Default: true\n   *\n   * Note:\n   * - Only applies to dictionaries using `importMode: 'dynamic'`.\n   * - Only applies to the client build; the server keeps loading on demand.\n   * - Requires a bundler supporting top-level await (Vite, esbuild).\n   */\n  dictionariesPreload:\n    customConfiguration?.dictionariesPreload ?? DICTIONARIES_PRELOAD,\n\n  /**\n   * Pattern to traverse the code to optimize.\n   *\n   * Allows to avoid to traverse the code that is not relevant to the optimization.\n   * Improve build performance.\n   *\n   * Default: ['**\\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\\/node_modules/**']\n   *\n   * Example: `['src/**\\/*.{ts,tsx}', '../ui-library/**\\/*.{ts,tsx}']`\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - Use glob pattern.\n   */\n  traversePattern: customConfiguration?.traversePattern ?? TRAVERSE_PATTERN,\n\n  /**\n   * Output format of the dictionaries\n   *\n   * Can be set on large projects to improve build performance.\n   *\n   * Default: ['cjs', 'esm']\n   *\n   * The output format of the dictionaries. It can be either 'cjs' or 'esm'.\n   * - 'cjs': The dictionaries are outputted as CommonJS modules.\n   * - 'esm': The dictionaries are outputted as ES modules.\n   */\n  outputFormat: customConfiguration?.outputFormat ?? OUTPUT_FORMAT,\n\n  /**\n   * Cache\n   */\n  cache: customConfiguration?.cache ?? CACHE,\n\n  /**\n   * Require function\n   */\n  require: customConfiguration?.require,\n\n  /**\n   * Indicates if the build should check TypeScript types\n   *\n   * Default: `false`\n   *\n   * If true, the build will check TypeScript types and log errors.\n   * Note: This can slow down the build.\n   */\n  checkTypes: customConfiguration?.checkTypes ?? TYPE_CHECKING,\n});\n\n/**\n * Build the `compiler` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied compiler config.\n * @returns A fully-defaulted {@link CompilerConfig}.\n */\nconst buildCompilerFields = (\n  customConfiguration?: Partial<CompilerConfig>\n): CompilerConfig => ({\n  /**\n   * Indicates if the compiler should be enabled\n   */\n  enabled: customConfiguration?.enabled ?? COMPILER_ENABLED,\n\n  /**\n   * Prefix for the extracted dictionary keys\n   */\n  dictionaryKeyPrefix:\n    customConfiguration?.dictionaryKeyPrefix ?? COMPILER_DICTIONARY_KEY_PREFIX,\n\n  /**\n   * Pattern to traverse the code to optimize.\n   *\n   * @deprecated use `build.traversePattern` instead\n   */\n  transformPattern: customConfiguration?.transformPattern,\n\n  /**\n   * Pattern to exclude from the optimization.\n   *\n   * @deprecated use `build.traversePattern` instead\n   */\n  excludePattern: customConfiguration?.excludePattern,\n\n  /**\n   * Defines the output files path. Replaces `outputDir`.\n   *\n   * - `./` paths are resolved relative to the component directory.\n   * - `/` paths are resolved relative to the project root (`baseDir`).\n   *\n   * - Including the `{{locale}}` variable in the path will trigger the generation of separate dictionaries per locale.\n   *\n   * @example:\n   * ```ts\n   * {\n   *   // Create Multilingual .content.ts files close to the component\n   *   output: ({ fileName, extension }) => `./${fileName}${extension}`,\n   *\n   *   // output: './{{fileName}}{{extension}}', // Equivalent using template string\n   * }\n   * ```\n   *\n   * ```ts\n   * {\n   *   // Create centralize per-locale JSON at the root of the project\n   *   output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,\n   *\n   *   // output: '/locales/{{locale}}/{{key}}.content.json', // Equivalent using template string\n   * }\n   * ```\n   *\n   * ```ts\n   * {\n   *   // Create per-locale JSON files with locale-specific output paths\n   *   output: {\n   *     en: ({ fileName, locale }) => `${fileName}.${locale}.content.json`,\n   *     fr: '{{fileName}}.{{locale}}.content.json',\n   *     es: false, // skip this locale\n   *   },\n   * }\n   * ```\n   *\n   * Variable list:\n   *   - `fileName`: The name of the file.\n   *   - `key`: The key of the content.\n   *   - `locale`: The locale of the content.\n   *   - `extension`: The extension of the file.\n   *   - `componentFileName`: The name of the component file.\n   *   - `componentExtension`: The extension of the component file.\n   *   - `format`: The format of the dictionary.\n   *   - `componentFormat`: The format of the component dictionary.\n   *   - `componentDirPath`: The directory path of the component.\n   */\n  output: customConfiguration?.output,\n\n  /**\n   * Indicates if the metadata should be saved in the file.\n   *\n   * If true, the compiler will not save the metadata of the dictionaries.\n   *\n   * If `true`:\n   *\n   * ```json\n   * {\n   *   \"key\": \"value\"\n   * }\n   * ```\n   *\n   * If `false`:\n   *\n   * ```json\n   * {\n   *   \"key\": \"value\",\n   *   \"content\": {\n   *      \"key\": \"value\"\n   *   }\n   * }\n   * ```\n   *\n   * Default: `false`\n   *\n   * Note: Useful if used with loadJSON plugin\n   */\n  noMetadata: customConfiguration?.noMetadata ?? COMPILER_NO_METADATA,\n\n  /**\n   * Indicates if the components should be saved after being transformed.\n   */\n  saveComponents:\n    customConfiguration?.saveComponents ?? COMPILER_SAVE_COMPONENTS,\n});\n\n/**\n * Build the `dictionary` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied dictionary config.\n * @returns A fully-defaulted {@link DictionaryConfig}.\n */\nconst buildDictionaryFields = (\n  customConfiguration?: Partial<DictionaryConfig>\n): DictionaryConfig => {\n  const contentAutoTransformation =\n    customConfiguration?.contentAutoTransformation ??\n    CONTENT_AUTO_TRANSFORMATION;\n\n  return {\n    /**\n     * Indicate how the dictionary should be filled using AI.\n     *\n     * Default: `true`\n     *\n     * - If `true`, will consider the `compiler.output` field.\n     * - If `false`, will skip the fill process.\n     *\n     * - `./` paths are resolved relative to the component directory.\n     * - `/` paths are resolved relative to the project root (`baseDir`).\n     *\n     * - If includes `{{locale}}` variable in the path, will trigger the generation of separate dictionaries per locale.\n     *\n     * Example:\n     * ```ts\n     * {\n     *   // Create Multilingual .content.ts files close to the component\n     *   fill: ({ fileName, extension }) => `./${fileName}${extension}`,\n     *\n     *   // fill: './{{fileName}}{{extension}}', // Equivalent using template string\n     * }\n     * ```\n     *\n     * ```ts\n     * {\n     *   // Create centralize per-locale JSON at the root of the project\n     *   fill: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,\n     *\n     *   // fill: '/locales/{{locale}}/{{key}}.content.json', // Equivalent using template string\n     * }\n     * ```\n     *\n     * ```ts\n     * {\n     *   // Create custom output based on the locale\n     *   fill: {\n     *     en: ({ key }) => `/locales/en/${key}.content.json`,\n     *     fr: '/locales/fr/{{key}}.content.json',\n     *     es: false,\n     *     de: true,\n     *   },\n     * }\n     * ```\n     *\n     *\n     * Variable list:\n     *   - `fileName`: The name of the file.\n     *   - `key`: The key of the content.\n     *   - `locale`: The locale of the content.\n     *   - `extension`: The extension of the file.\n     *   - `componentFileName`: The name of the component file.\n     *   - `componentExtension`: The extension of the component file.\n     *   - `format`: The format of the dictionary.\n     *   - `componentFormat`: The format of the component dictionary.\n     *   - `componentDirPath`: The directory path of the component.\n     */\n    fill: customConfiguration?.fill ?? FILL,\n\n    /**\n     * Indicates if the content of the dictionary should be automatically transformed.\n     *\n     * Default: `false`\n     */\n    contentAutoTransformation:\n      typeof contentAutoTransformation === 'object'\n        ? {\n            markdown: contentAutoTransformation.markdown ?? false,\n            html: contentAutoTransformation.html ?? false,\n            insertion: contentAutoTransformation.insertion ?? false,\n          }\n        : contentAutoTransformation,\n\n    /**\n     * The location of the dictionary.\n     *\n     * Default: `\"local\"`\n     */\n    location: customConfiguration?.location ?? LOCATION,\n\n    /**\n     * Transform the dictionary in a per-locale dictionary.\n     * Each field declared in a per-locale dictionary will be transformed in a translation node.\n     * If missing, the dictionary will be treated as a multilingual dictionary.\n     */\n    locale: customConfiguration?.locale,\n\n    /**\n     * The title of the dictionary.\n     */\n    title: customConfiguration?.title,\n\n    /**\n     * The description of the dictionary.\n     */\n    description: customConfiguration?.description,\n\n    /**\n     * Tags to categorize the dictionaries.\n     */\n    tags: customConfiguration?.tags,\n\n    /**\n     * The priority of the dictionary.\n     */\n    priority: customConfiguration?.priority,\n\n    /**\n     * Indicates the mode of import to use for the dictionary.\n     *\n     * Available modes:\n     * - \"static\": The dictionaries are imported statically.\n     * - \"dynamic\": The dictionaries are imported dynamically in a synchronous component using the suspense API.\n     * - \"live\": The dictionaries are imported dynamically using the live sync API.\n     *\n     * Default: `\"static\"`\n     */\n    importMode: customConfiguration?.importMode ?? IMPORT_MODE,\n\n    /**\n     * The default message format for all dictionaries in the project.\n     *\n     * Default: 'intlayer'\n     */\n    format: customConfiguration?.format,\n  };\n};\n\n// ---------------------------------------------------------------------------\n// Main export\n// ---------------------------------------------------------------------------\n\n/**\n * Build the complete Intlayer configuration by merging user-supplied values\n * with defaults.\n *\n * Internally this function:\n * 1. Calls {@link buildBrowserConfiguration} to produce the browser-safe\n *    subset (internationalization, routing, editor public fields, log, metadata).\n * 2. Extends the result with full server-side fields:\n *    - `internationalization` — adds `requiredLocales` and `strictMode`.\n *    - `editor` — adds `clientId` and `clientSecret`.\n *    - `log` — adds custom log functions.\n *    - `system`, `content`, `ai`, `build`, `compiler`, `dictionary`.\n *\n * @param customConfiguration - Optional user-supplied configuration object.\n * @param baseDir - Project root directory. Defaults to `process.cwd()`.\n * @param logFunctions - Optional custom logging functions.\n * @returns A fully-built {@link IntlayerConfig}.\n */\nexport const buildConfigurationFields = (\n  customConfiguration?: CustomIntlayerConfig,\n  baseDir?: string,\n  logFunctions?: LogFunctions\n): IntlayerConfig => {\n  if (customConfiguration) {\n    const result = intlayerConfigSchema.safeParse(customConfiguration);\n\n    if (!result.success) {\n      const logError = logFunctions?.error ?? console.error;\n\n      for (const issue of result.error.issues) {\n        logError(`${issue.path.join('.')}: ${issue.message}`);\n      }\n    }\n  }\n\n  // build browser-safe config (shared defaults, no Node.js deps)\n  const browserConfig = buildBrowserConfiguration(customConfiguration);\n\n  // extend shared fields with server-only additions\n  const internationalizationConfig = buildInternationalizationFields(\n    customConfiguration?.internationalization\n  );\n\n  const editorConfig = buildEditorFields(customConfiguration?.editor);\n\n  const logConfig = buildLogFields(customConfiguration?.log, logFunctions);\n\n  // build server-only fields\n  const systemConfig = buildSystemFields(baseDir, customConfiguration?.system);\n\n  const contentConfig = buildContentFields(\n    systemConfig,\n    customConfiguration?.content\n  );\n\n  storedConfiguration = {\n    // Shared browser fields\n    routing: browserConfig.routing,\n    // Full (extended) shared fields\n    internationalization: internationalizationConfig,\n    editor: editorConfig,\n    analytics: buildAnalyticsFields(\n      customConfiguration?.analytics,\n      isPackageInstalled(ANALYTICS_PACKAGE_NAME, systemConfig.baseDir)\n    ),\n    log: logConfig,\n    // Server-only fields\n    system: systemConfig,\n    content: contentConfig,\n    ai: buildAiFields(customConfiguration?.ai),\n    build: buildBuildFields(customConfiguration?.build),\n    compiler: buildCompilerFields(customConfiguration?.compiler),\n    dictionary: buildDictionaryFields(customConfiguration?.dictionary),\n    plugins: customConfiguration?.plugins,\n    schemas: customConfiguration?.schemas,\n  } as IntlayerConfig;\n\n  return storedConfiguration;\n};\n"],"mappings":"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"}

package/dist/cjs/defaultValues/analytics.cjs

@@ -2,9 +2,10 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 //#region src/defaultValues/analytics.ts
 /**
 * Default values for the `analytics` configuration block.
-* Analytics is strictly opt-in — disabled unless the user enables it.
+* Analytics is opt-out — enabled unless the user disables it, and only
+* effective once the optional `@intlayer/analytics` package is installed.
 */
-const ANALYTICS_ENABLED = false;
+const ANALYTICS_ENABLED = true;
 const ANALYTICS_FLUSH_INTERVAL = 2e4;
 const ANALYTICS_SAMPLE_RATE = 1;
 

package/dist/cjs/defaultValues/analytics.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.cjs","names":[],"sources":["../../../src/defaultValues/analytics.ts"],"sourcesContent":["/**\n * Default values for the `analytics` configuration block.\n * Analytics is strictly opt-in — disabled unless the user enables it.\n */\nexport const ANALYTICS_ENABLED = false;\nexport const ANALYTICS_FLUSH_INTERVAL = 20_000;\nexport const ANALYTICS_SAMPLE_RATE = 1;\n"],"mappings":";;;;;;AAIA,MAAa,oBAAoB;AACjC,MAAa,2BAA2B;AACxC,MAAa,wBAAwB"}
+{"version":3,"file":"analytics.cjs","names":[],"sources":["../../../src/defaultValues/analytics.ts"],"sourcesContent":["/**\n * Default values for the `analytics` configuration block.\n * Analytics is opt-out — enabled unless the user disables it, and only\n * effective once the optional `@intlayer/analytics` package is installed.\n */\nexport const ANALYTICS_ENABLED = true;\nexport const ANALYTICS_FLUSH_INTERVAL = 20_000;\nexport const ANALYTICS_SAMPLE_RATE = 1;\n"],"mappings":";;;;;;;AAKA,MAAa,oBAAoB;AACjC,MAAa,2BAA2B;AACxC,MAAa,wBAAwB"}

package/dist/cjs/envVars/envVars.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"envVars.cjs","names":[],"sources":["../../../src/envVars/envVars.ts"],"sourcesContent":["import type { IntlayerConfig } from '@intlayer/types/config';\n\n/**\n * Converts a camelCase node-type string to SCREAMING_SNAKE_CASE so that\n * the generated env-var name matches what the plugin source files check.\n *\n * @example\n * toScreamingSnakeCase('reactNode')  // 'REACT_NODE'\n * toScreamingSnakeCase('markdown')   // 'MARKDOWN'\n */\nconst toScreamingSnakeCase = (str: string): string =>\n  str\n    .replace(/([A-Z])/g, '_$1')\n    .toUpperCase()\n    .replace(/^_/, ''); // strip any leading underscore\n\n/**\n * Converts a list of unused NodeType keys into env-var definitions.\n * Set to `\"false\"` so bundlers can eliminate the corresponding plugin code.\n *\n * @example\n * formatNodeTypeToEnvVar(['enumeration'])\n * // { 'INTLAYER_NODE_TYPE_ENUMERATION': '\"false\"' }\n *\n * formatNodeTypeToEnvVar(['reactNode'], (k) => `process.env.${k}`, (v) => `\"${v}\"`)\n * // { 'process.env.INTLAYER_NODE_TYPE_REACT_NODE': '\"false\"' }\n */\nexport const formatNodeTypeToEnvVar = (\n  nodeTypes: string[],\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> =>\n  nodeTypes.reduce(\n    (acc, nodeType) => {\n      acc[wrapKey(`INTLAYER_NODE_TYPE_${toScreamingSnakeCase(nodeType)}`)] =\n        wrapValue('false');\n      return acc;\n    },\n    {} as Record<string, string>\n  );\n\n/**\n * Returns the env-var definition disabling the dictionary-selector resolution\n * path (collections, variants) when no built dictionary declares\n * a qualifier. Set to `\"false\"` so bundlers can dead-code-eliminate the\n * selector branch in `getIntlayer` / `useIntlayer`.\n *\n * Emits nothing when selectors are used, leaving the runtime default in place.\n *\n * @example\n * formatDictionarySelectorEnvVar(false)\n * // { INTLAYER_DICTIONARY_SELECTOR: '\"false\"' }\n *\n * formatDictionarySelectorEnvVar(true)\n * // {}\n *\n * formatDictionarySelectorEnvVar(false, (k) => `process.env.${k}`, (v) => `\"${v}\"`)\n * // { 'process.env.INTLAYER_DICTIONARY_SELECTOR': '\"false\"' }\n */\nexport const formatDictionarySelectorEnvVar = (\n  hasDictionarySelector: boolean,\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> =>\n  hasDictionarySelector\n    ? {}\n    : { [wrapKey('INTLAYER_DICTIONARY_SELECTOR')]: wrapValue('false') };\n\n/**\n * Returns the env-var definition selecting the local `nest()` resolver, which\n * reads the nest targets the optimizer attached to each dictionary instead of\n * looking them up in the global registry.\n *\n * Emit it only when the optimize transform actually runs, since it is that\n * transform which injects the attachment. Setting it to `\"true\"` lets bundlers\n * dead-code-eliminate the registry-based resolver, and with it the\n * `@intlayer/dictionaries-entry` import — which is what allows the dictionaries\n * entry to be emptied while nesting keeps working.\n *\n * @example\n * formatOptimizedNestingEnvVar(true)\n * // { INTLAYER_OPTIMIZED_NESTING: '\"true\"' }\n *\n * formatOptimizedNestingEnvVar(false)\n * // {}\n *\n * formatOptimizedNestingEnvVar(true, (k) => `process.env.${k}`, (v) => `\"${v}\"`)\n * // { 'process.env.INTLAYER_OPTIMIZED_NESTING': '\"true\"' }\n */\nexport const formatOptimizedNestingEnvVar = (\n  isOptimized: boolean,\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> =>\n  isOptimized\n    ? { [wrapKey('INTLAYER_OPTIMIZED_NESTING')]: wrapValue('true') }\n    : {};\n\n/**\n * Returns env-var definitions for the full Intlayer config to be injected at\n * build time. Allows bundlers to dead-code-eliminate unused routing modes,\n * rewrite logic, storage mechanisms, and editor code.\n *\n * @example\n * getConfigEnvVars(config)\n * // { INTLAYER_ROUTING_MODE: '\"prefix-no-default\"', INTLAYER_ROUTING_REWRITE_RULES: '\"false\"', ... }\n *\n * getConfigEnvVars(config, true)\n * // { 'process.env.INTLAYER_ROUTING_MODE': '\"prefix-no-default\"', ... }\n */\nexport const getConfigEnvVars = (\n  config: IntlayerConfig,\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> => {\n  const { routing, editor, analytics } = config;\n\n  const envVars: Record<string, string> = {\n    [wrapKey('INTLAYER_ROUTING_MODE')]: wrapValue(routing.mode),\n  };\n\n  // Only the two explicit states are emitted. An absent variable means the\n  // option was left unset, which `resolveProxyMode` reads as auto mode — it\n  // then defers to the configuration value available at runtime.\n  if (routing.enableProxy === false) {\n    envVars[wrapKey('INTLAYER_ROUTING_ENABLE_PROXY')] = wrapValue('false');\n  } else if (routing.enableProxy === true) {\n    envVars[wrapKey('INTLAYER_ROUTING_ENABLE_PROXY')] = wrapValue('true');\n  }\n\n  if (!routing.rewrite) {\n    envVars[wrapKey('INTLAYER_ROUTING_REWRITE_RULES')] = wrapValue('false');\n  }\n\n  if (!routing.domains || Object.keys(routing.domains).length === 0) {\n    envVars[wrapKey('INTLAYER_ROUTING_DOMAINS')] = wrapValue('false');\n  }\n\n  if (!routing.storage.cookies || routing.storage.cookies.length === 0) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_COOKIES')] = wrapValue('false');\n  }\n\n  if (\n    !routing.storage.localStorage ||\n    routing.storage.localStorage.length === 0\n  ) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_LOCALSTORAGE')] =\n      wrapValue('false');\n  }\n\n  if (\n    !routing.storage.sessionStorage ||\n    routing.storage.sessionStorage.length === 0\n  ) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_SESSIONSTORAGE')] =\n      wrapValue('false');\n  }\n\n  if (!routing.storage.headers || routing.storage.headers.length === 0) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_HEADERS')] = wrapValue('false');\n  }\n\n  if (editor?.enabled === false) {\n    envVars[wrapKey('INTLAYER_EDITOR_ENABLED')] = wrapValue('false');\n  }\n\n  // Analytics is strictly opt-in (`analytics.enabled === true`) and requires a\n  // project key (`editor.clientId`) for attribution. Otherwise, disable it so\n  // bundlers dead-code-eliminate the whole `@intlayer/analytics` integration\n  // (providers + node plugins).\n  if (analytics?.enabled !== true || !editor?.clientId) {\n    envVars[wrapKey('INTLAYER_ANALYTICS_ENABLED')] = wrapValue('false');\n  }\n\n  return envVars;\n};\n"],"mappings":";;;;;;;;;;AAUA,MAAM,wBAAwB,QAC5B,IACG,QAAQ,YAAY,KAAK,CAAC,CAC1B,YAAY,CAAC,CACb,QAAQ,MAAM,EAAE;;;;;;;;;;;;AAarB,MAAa,0BACX,WACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UAE/B,UAAU,QACP,KAAK,aAAa;CACjB,IAAI,QAAQ,sBAAsB,qBAAqB,QAAQ,GAAG,KAChE,UAAU,OAAO;CACnB,OAAO;AACT,GACA,CAAC,CACH;;;;;;;;;;;;;;;;;;;AAoBF,MAAa,kCACX,uBACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UAE/B,wBACI,CAAC,IACD,GAAG,QAAQ,8BAA8B,IAAI,UAAU,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;AAuBtE,MAAa,gCACX,aACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UAE/B,cACI,GAAG,QAAQ,4BAA4B,IAAI,UAAU,MAAM,EAAE,IAC7D,CAAC;;;;;;;;;;;;;AAcP,MAAa,oBACX,QACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UACJ;CAC3B,MAAM,EAAE,SAAS,QAAQ,cAAc;CAEvC,MAAM,UAAkC,GACrC,QAAQ,uBAAuB,IAAI,UAAU,QAAQ,IAAI,EAC5D;CAKA,IAAI,QAAQ,gBAAgB,OAC1B,QAAQ,QAAQ,+BAA+B,KAAK,UAAU,OAAO;MAChE,IAAI,QAAQ,gBAAgB,MACjC,QAAQ,QAAQ,+BAA+B,KAAK,UAAU,MAAM;CAGtE,IAAI,CAAC,QAAQ,SACX,QAAQ,QAAQ,gCAAgC,KAAK,UAAU,OAAO;CAGxE,IAAI,CAAC,QAAQ,WAAW,OAAO,KAAK,QAAQ,OAAO,CAAC,CAAC,WAAW,GAC9D,QAAQ,QAAQ,0BAA0B,KAAK,UAAU,OAAO;CAGlE,IAAI,CAAC,QAAQ,QAAQ,WAAW,QAAQ,QAAQ,QAAQ,WAAW,GACjE,QAAQ,QAAQ,kCAAkC,KAAK,UAAU,OAAO;CAG1E,IACE,CAAC,QAAQ,QAAQ,gBACjB,QAAQ,QAAQ,aAAa,WAAW,GAExC,QAAQ,QAAQ,uCAAuC,KACrD,UAAU,OAAO;CAGrB,IACE,CAAC,QAAQ,QAAQ,kBACjB,QAAQ,QAAQ,eAAe,WAAW,GAE1C,QAAQ,QAAQ,yCAAyC,KACvD,UAAU,OAAO;CAGrB,IAAI,CAAC,QAAQ,QAAQ,WAAW,QAAQ,QAAQ,QAAQ,WAAW,GACjE,QAAQ,QAAQ,kCAAkC,KAAK,UAAU,OAAO;CAG1E,IAAI,QAAQ,YAAY,OACtB,QAAQ,QAAQ,yBAAyB,KAAK,UAAU,OAAO;CAOjE,IAAI,WAAW,YAAY,QAAQ,CAAC,QAAQ,UAC1C,QAAQ,QAAQ,4BAA4B,KAAK,UAAU,OAAO;CAGpE,OAAO;AACT"}
+{"version":3,"file":"envVars.cjs","names":[],"sources":["../../../src/envVars/envVars.ts"],"sourcesContent":["import type { IntlayerConfig } from '@intlayer/types/config';\n\n/**\n * Converts a camelCase node-type string to SCREAMING_SNAKE_CASE so that\n * the generated env-var name matches what the plugin source files check.\n *\n * @example\n * toScreamingSnakeCase('reactNode')  // 'REACT_NODE'\n * toScreamingSnakeCase('markdown')   // 'MARKDOWN'\n */\nconst toScreamingSnakeCase = (str: string): string =>\n  str\n    .replace(/([A-Z])/g, '_$1')\n    .toUpperCase()\n    .replace(/^_/, ''); // strip any leading underscore\n\n/**\n * Converts a list of unused NodeType keys into env-var definitions.\n * Set to `\"false\"` so bundlers can eliminate the corresponding plugin code.\n *\n * @example\n * formatNodeTypeToEnvVar(['enumeration'])\n * // { 'INTLAYER_NODE_TYPE_ENUMERATION': '\"false\"' }\n *\n * formatNodeTypeToEnvVar(['reactNode'], (k) => `process.env.${k}`, (v) => `\"${v}\"`)\n * // { 'process.env.INTLAYER_NODE_TYPE_REACT_NODE': '\"false\"' }\n */\nexport const formatNodeTypeToEnvVar = (\n  nodeTypes: string[],\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> =>\n  nodeTypes.reduce(\n    (acc, nodeType) => {\n      acc[wrapKey(`INTLAYER_NODE_TYPE_${toScreamingSnakeCase(nodeType)}`)] =\n        wrapValue('false');\n      return acc;\n    },\n    {} as Record<string, string>\n  );\n\n/**\n * Returns the env-var definition disabling the dictionary-selector resolution\n * path (collections, variants) when no built dictionary declares\n * a qualifier. Set to `\"false\"` so bundlers can dead-code-eliminate the\n * selector branch in `getIntlayer` / `useIntlayer`.\n *\n * Emits nothing when selectors are used, leaving the runtime default in place.\n *\n * @example\n * formatDictionarySelectorEnvVar(false)\n * // { INTLAYER_DICTIONARY_SELECTOR: '\"false\"' }\n *\n * formatDictionarySelectorEnvVar(true)\n * // {}\n *\n * formatDictionarySelectorEnvVar(false, (k) => `process.env.${k}`, (v) => `\"${v}\"`)\n * // { 'process.env.INTLAYER_DICTIONARY_SELECTOR': '\"false\"' }\n */\nexport const formatDictionarySelectorEnvVar = (\n  hasDictionarySelector: boolean,\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> =>\n  hasDictionarySelector\n    ? {}\n    : { [wrapKey('INTLAYER_DICTIONARY_SELECTOR')]: wrapValue('false') };\n\n/**\n * Returns the env-var definition selecting the local `nest()` resolver, which\n * reads the nest targets the optimizer attached to each dictionary instead of\n * looking them up in the global registry.\n *\n * Emit it only when the optimize transform actually runs, since it is that\n * transform which injects the attachment. Setting it to `\"true\"` lets bundlers\n * dead-code-eliminate the registry-based resolver, and with it the\n * `@intlayer/dictionaries-entry` import — which is what allows the dictionaries\n * entry to be emptied while nesting keeps working.\n *\n * @example\n * formatOptimizedNestingEnvVar(true)\n * // { INTLAYER_OPTIMIZED_NESTING: '\"true\"' }\n *\n * formatOptimizedNestingEnvVar(false)\n * // {}\n *\n * formatOptimizedNestingEnvVar(true, (k) => `process.env.${k}`, (v) => `\"${v}\"`)\n * // { 'process.env.INTLAYER_OPTIMIZED_NESTING': '\"true\"' }\n */\nexport const formatOptimizedNestingEnvVar = (\n  isOptimized: boolean,\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> =>\n  isOptimized\n    ? { [wrapKey('INTLAYER_OPTIMIZED_NESTING')]: wrapValue('true') }\n    : {};\n\n/**\n * Returns env-var definitions for the full Intlayer config to be injected at\n * build time. Allows bundlers to dead-code-eliminate unused routing modes,\n * rewrite logic, storage mechanisms, and editor code.\n *\n * @example\n * getConfigEnvVars(config)\n * // { INTLAYER_ROUTING_MODE: '\"prefix-no-default\"', INTLAYER_ROUTING_REWRITE_RULES: '\"false\"', ... }\n *\n * getConfigEnvVars(config, true)\n * // { 'process.env.INTLAYER_ROUTING_MODE': '\"prefix-no-default\"', ... }\n */\nexport const getConfigEnvVars = (\n  config: IntlayerConfig,\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> => {\n  const { routing, editor, analytics } = config;\n\n  const envVars: Record<string, string> = {\n    [wrapKey('INTLAYER_ROUTING_MODE')]: wrapValue(routing.mode),\n  };\n\n  // Only the two explicit states are emitted. An absent variable means the\n  // option was left unset, which `resolveProxyMode` reads as auto mode — it\n  // then defers to the configuration value available at runtime.\n  if (routing.enableProxy === false) {\n    envVars[wrapKey('INTLAYER_ROUTING_ENABLE_PROXY')] = wrapValue('false');\n  } else if (routing.enableProxy === true) {\n    envVars[wrapKey('INTLAYER_ROUTING_ENABLE_PROXY')] = wrapValue('true');\n  }\n\n  if (!routing.rewrite) {\n    envVars[wrapKey('INTLAYER_ROUTING_REWRITE_RULES')] = wrapValue('false');\n  }\n\n  if (!routing.domains || Object.keys(routing.domains).length === 0) {\n    envVars[wrapKey('INTLAYER_ROUTING_DOMAINS')] = wrapValue('false');\n  }\n\n  if (!routing.storage.cookies || routing.storage.cookies.length === 0) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_COOKIES')] = wrapValue('false');\n  }\n\n  if (\n    !routing.storage.localStorage ||\n    routing.storage.localStorage.length === 0\n  ) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_LOCALSTORAGE')] =\n      wrapValue('false');\n  }\n\n  if (\n    !routing.storage.sessionStorage ||\n    routing.storage.sessionStorage.length === 0\n  ) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_SESSIONSTORAGE')] =\n      wrapValue('false');\n  }\n\n  if (!routing.storage.headers || routing.storage.headers.length === 0) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_HEADERS')] = wrapValue('false');\n  }\n\n  if (editor?.enabled === false) {\n    envVars[wrapKey('INTLAYER_EDITOR_ENABLED')] = wrapValue('false');\n  }\n\n  // Analytics is opt-out: `analytics.enabled` defaults to `true` and is\n  // resolved to `false` when the optional `@intlayer/analytics` package is not\n  // installed. It also requires a project key (`editor.clientId`) for\n  // attribution. Otherwise, disable it so bundlers dead-code-eliminate the\n  // whole `@intlayer/analytics` integration (providers + node plugins).\n  if (analytics?.enabled !== true || !editor?.clientId) {\n    envVars[wrapKey('INTLAYER_ANALYTICS_ENABLED')] = wrapValue('false');\n  }\n\n  return envVars;\n};\n"],"mappings":";;;;;;;;;;AAUA,MAAM,wBAAwB,QAC5B,IACG,QAAQ,YAAY,KAAK,CAAC,CAC1B,YAAY,CAAC,CACb,QAAQ,MAAM,EAAE;;;;;;;;;;;;AAarB,MAAa,0BACX,WACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UAE/B,UAAU,QACP,KAAK,aAAa;CACjB,IAAI,QAAQ,sBAAsB,qBAAqB,QAAQ,GAAG,KAChE,UAAU,OAAO;CACnB,OAAO;AACT,GACA,CAAC,CACH;;;;;;;;;;;;;;;;;;;AAoBF,MAAa,kCACX,uBACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UAE/B,wBACI,CAAC,IACD,GAAG,QAAQ,8BAA8B,IAAI,UAAU,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;AAuBtE,MAAa,gCACX,aACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UAE/B,cACI,GAAG,QAAQ,4BAA4B,IAAI,UAAU,MAAM,EAAE,IAC7D,CAAC;;;;;;;;;;;;;AAcP,MAAa,oBACX,QACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UACJ;CAC3B,MAAM,EAAE,SAAS,QAAQ,cAAc;CAEvC,MAAM,UAAkC,GACrC,QAAQ,uBAAuB,IAAI,UAAU,QAAQ,IAAI,EAC5D;CAKA,IAAI,QAAQ,gBAAgB,OAC1B,QAAQ,QAAQ,+BAA+B,KAAK,UAAU,OAAO;MAChE,IAAI,QAAQ,gBAAgB,MACjC,QAAQ,QAAQ,+BAA+B,KAAK,UAAU,MAAM;CAGtE,IAAI,CAAC,QAAQ,SACX,QAAQ,QAAQ,gCAAgC,KAAK,UAAU,OAAO;CAGxE,IAAI,CAAC,QAAQ,WAAW,OAAO,KAAK,QAAQ,OAAO,CAAC,CAAC,WAAW,GAC9D,QAAQ,QAAQ,0BAA0B,KAAK,UAAU,OAAO;CAGlE,IAAI,CAAC,QAAQ,QAAQ,WAAW,QAAQ,QAAQ,QAAQ,WAAW,GACjE,QAAQ,QAAQ,kCAAkC,KAAK,UAAU,OAAO;CAG1E,IACE,CAAC,QAAQ,QAAQ,gBACjB,QAAQ,QAAQ,aAAa,WAAW,GAExC,QAAQ,QAAQ,uCAAuC,KACrD,UAAU,OAAO;CAGrB,IACE,CAAC,QAAQ,QAAQ,kBACjB,QAAQ,QAAQ,eAAe,WAAW,GAE1C,QAAQ,QAAQ,yCAAyC,KACvD,UAAU,OAAO;CAGrB,IAAI,CAAC,QAAQ,QAAQ,WAAW,QAAQ,QAAQ,QAAQ,WAAW,GACjE,QAAQ,QAAQ,kCAAkC,KAAK,UAAU,OAAO;CAG1E,IAAI,QAAQ,YAAY,OACtB,QAAQ,QAAQ,yBAAyB,KAAK,UAAU,OAAO;CAQjE,IAAI,WAAW,YAAY,QAAQ,CAAC,QAAQ,UAC1C,QAAQ,QAAQ,4BAA4B,KAAK,UAAU,OAAO;CAGpE,OAAO;AACT"}

package/dist/cjs/utils/index.cjs

@@ -13,6 +13,7 @@ const require_utils_extractErrorMessage = require('./extractErrorMessage.cjs');
 const require_utils_getDictionarySelectorUsage = require('./getDictionarySelectorUsage.cjs');
 const require_utils_getStorageAttributes = require('./getStorageAttributes.cjs');
 const require_utils_getUsedNodeTypes = require('./getUsedNodeTypes.cjs');
+const require_utils_isPackageInstalled = require('./isPackageInstalled.cjs');
 const require_utils_logStack = require('./logStack.cjs');
 const require_utils_parseFilePathPattern = require('./parseFilePathPattern.cjs');
 const require_utils_pathSecurity = require('./pathSecurity.cjs');
@@ -49,6 +50,7 @@ exports.getUnusedNodeTypesAsync = require_utils_getUsedNodeTypes.getUnusedNodeTy
 exports.getUsedNodeTypes = require_utils_getUsedNodeTypes.getUsedNodeTypes;
 exports.getUsedNodeTypesAsync = require_utils_getUsedNodeTypes.getUsedNodeTypesAsync;
 exports.isESModule = require_utils_ESMxCJSHelpers.isESModule;
+exports.isPackageInstalled = require_utils_isPackageInstalled.isPackageInstalled;
 exports.kebabCaseToCamelCase = require_utils_stringFormatter_kebabCaseToCamelCase.kebabCaseToCamelCase;
 exports.logStack = require_utils_logStack.logStack;
 exports.normalizePath = require_utils_normalizePath.normalizePath;

package/dist/cjs/utils/isPackageInstalled.cjs

@@ -0,0 +1,39 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_utils_ESMxCJSHelpers = require('./ESMxCJSHelpers.cjs');
+
+//#region src/utils/isPackageInstalled.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.
+*/
+const isPackageInstalled = (packageName, baseDir) => {
+	try {
+		const projectRequire = require_utils_ESMxCJSHelpers.getProjectRequire(baseDir);
+		try {
+			projectRequire.resolve(`${packageName}/package.json`);
+		} catch {
+			projectRequire.resolve(packageName);
+		}
+		return true;
+	} catch {
+		return false;
+	}
+};
+
+//#endregion
+exports.isPackageInstalled = isPackageInstalled;
+//# sourceMappingURL=isPackageInstalled.cjs.map

package/dist/cjs/utils/isPackageInstalled.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"isPackageInstalled.cjs","names":["getProjectRequire"],"sources":["../../../src/utils/isPackageInstalled.ts"],"sourcesContent":["import { getProjectRequire } from './ESMxCJSHelpers';\n\n/**\n * Checks whether a package can be resolved from the user project.\n *\n * Used to detect optional companion packages (e.g. `@intlayer/analytics`)\n * whose mere presence in the dependency tree opts the project into a feature.\n *\n * Resolution is attempted on the package manifest first, so packages that\n * expose no root entry point — or whose entry point cannot be loaded in the\n * current module format — are still detected.\n *\n * Note: resolution starts at the project root, so a package installed only as\n * a transitive dependency may stay invisible under strict package managers\n * (pnpm). Callers should treat a `false` result as a default, not as a veto.\n *\n * @param packageName - Name of the package to look up, e.g. `'@intlayer/analytics'`.\n * @param baseDir - Directory the resolution starts from. Defaults to the current working directory.\n * @returns `true` when the package is installed in the project, `false` otherwise.\n */\nexport const isPackageInstalled = (\n  packageName: string,\n  baseDir?: string\n): boolean => {\n  try {\n    const projectRequire = getProjectRequire(baseDir);\n\n    try {\n      projectRequire.resolve(`${packageName}/package.json`);\n    } catch {\n      projectRequire.resolve(packageName);\n    }\n\n    return true;\n  } catch {\n    return false;\n  }\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAoBA,MAAa,sBACX,aACA,YACY;CACZ,IAAI;EACF,MAAM,iBAAiBA,+CAAkB,OAAO;EAEhD,IAAI;GACF,eAAe,QAAQ,GAAG,YAAY,cAAc;EACtD,QAAQ;GACN,eAAe,QAAQ,WAAW;EACpC;EAEA,OAAO;CACT,QAAQ;EACN,OAAO;CACT;AACF"}

package/dist/esm/bundle/index.mjs

@@ -1,7 +1,7 @@
 import { getAlias } from "../utils/alias.mjs";
 import { getConfiguration } from "../configFile/getConfiguration.mjs";
-import { getConfigEnvVars } from "../envVars/envVars.mjs";
 import { BundleLogger } from "./logBundle.mjs";
+import { getConfigEnvVars } from "../envVars/envVars.mjs";
 import { isAbsolute, join, resolve } from "node:path";
 import { mkdir, rm, writeFile } from "node:fs/promises";
 import configPackageJson from "@intlayer/types/package.json" with { type: "json" };

package/dist/esm/configFile/buildBrowserConfiguration.mjs

@@ -281,20 +281,27 @@ const buildEditorFields = (customConfiguration) => {
 /**
 * Build the analytics section of the Intlayer configuration.
 *
-* Analytics is strictly opt-in: `enabled` defaults to `false` and, even when
-* enabled, the runtime additionally requires a project key (`editor.clientId`)
-* for attribution before collecting anything.
+* Analytics is opt-out: `enabled` defaults to `true`, so installing the
+* optional `@intlayer/analytics` package is enough to turn it on. The runtime
+* additionally requires a project key (`editor.clientId`) for attribution
+* before collecting anything.
+*
+* An explicit `enabled` value always wins, so a project whose package manager
+* hides the package from the project root can still opt back in.
 *
 * @param customConfiguration - Partial user-supplied analytics config.
+* @param isPackageInstalled - Whether `@intlayer/analytics` is installed in the
+*   project. Browser callers cannot resolve packages and pass `true`, letting
+*   the runtime dynamic `import()` fail silently when it is absent.
 * @returns A fully-defaulted {@link AnalyticsConfig}.
 */
-const buildAnalyticsFields = (customConfiguration) => ({
+const buildAnalyticsFields = (customConfiguration, isPackageInstalled = true) => ({
 	/**
 	* Enables analytics collection (page views, content exposures, A/B events).
 	*
-	* Default: false
+	* Default: true, as soon as `@intlayer/analytics` is installed.
 	*/
-	enabled: customConfiguration?.enabled ?? false,
+	enabled: customConfiguration?.enabled ?? (true && isPackageInstalled),
 	/**
 	* Milliseconds between automatic batched flushes to the backend.
 	*

package/dist/esm/configFile/buildBrowserConfiguration.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"buildBrowserConfiguration.mjs","names":[],"sources":["../../../src/configFile/buildBrowserConfiguration.ts"],"sourcesContent":["import type {\n  AnalyticsConfig,\n  CustomIntlayerConfig,\n  CustomRoutingConfig,\n  EditorConfig,\n  InternationalizationConfig,\n  IntlayerConfig,\n  LogConfig,\n  LogFunctions,\n  RoutingConfig,\n} from '@intlayer/types/config';\nimport {\n  ANALYTICS_ENABLED,\n  ANALYTICS_FLUSH_INTERVAL,\n  ANALYTICS_SAMPLE_RATE,\n} from '../defaultValues/analytics';\nimport {\n  APPLICATION_URL,\n  BACKEND_URL,\n  CMS_URL,\n  DICTIONARY_PRIORITY_STRATEGY,\n  EDITOR_URL,\n  IS_ENABLED,\n  LIVE_SYNC,\n  LIVE_SYNC_PORT,\n  PORT,\n} from '../defaultValues/editor';\nimport {\n  DEFAULT_LOCALE,\n  LOCALES,\n  REQUIRED_LOCALES,\n  STRICT_MODE,\n} from '../defaultValues/internationalization';\nimport { MODE, PREFIX } from '../defaultValues/log';\nimport {\n  BASE_PATH,\n  ENABLE_PROXY,\n  ROUTING_MODE,\n  STORAGE,\n} from '../defaultValues/routing';\nimport { getStorageAttributes } from '../utils/getStorageAttributes';\n\n// ---------------------------------------------------------------------------\n// Type\n// ---------------------------------------------------------------------------\n\n/**\n * Browser-safe subset of {@link IntlayerConfig}.\n *\n * Excludes server-only fields (`system`, `content`, `build`, `compiler`,\n * `dictionary`, `ai`) and sensitive editor credentials (`clientId`,\n * `clientSecret`) that must never be shipped to the browser.\n */\nexport type BrowserIntlayerConfig = {\n  internationalization: Pick<\n    InternationalizationConfig,\n    'locales' | 'defaultLocale'\n  >;\n  routing: RoutingConfig;\n  editor: Omit<EditorConfig, 'clientId' | 'clientSecret'>;\n  analytics: AnalyticsConfig;\n  log: Pick<LogConfig, 'mode' | 'prefix'>;\n};\n\ndeclare global {\n  interface Window {\n    /** Browser-safe Intlayer configuration injected by a build plugin or `installIntlayer`. */\n    INTLAYER_CONFIG?: BrowserIntlayerConfig;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Shared field builders (browser-safe — no Node.js APIs)\n//\n// These functions are re-used by both `buildBrowserConfiguration` (browser)\n// and `buildConfigurationFields` (server) to avoid duplication.\n// ---------------------------------------------------------------------------\n\n/**\n * Build the internationalization section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied internationalization config.\n * @returns A fully-defaulted {@link InternationalizationConfig}.\n */\nexport const buildInternationalizationFields = (\n  customConfiguration?: Partial<InternationalizationConfig>\n): InternationalizationConfig => ({\n  /**\n   * Locales available in the application\n   *\n   * Default: ['en']\n   *\n   */\n  locales: customConfiguration?.locales ?? LOCALES,\n\n  /**\n   * Locales required by TypeScript to ensure strong implementations of internationalized content using typescript.\n   *\n   * Default: []\n   *\n   * If empty, all locales are required in `strict` mode.\n   *\n   * Ensure required locales are also defined in the `locales` field.\n   */\n  requiredLocales:\n    customConfiguration?.requiredLocales ??\n    customConfiguration?.locales ??\n    REQUIRED_LOCALES,\n\n  /**\n   * Ensure strong implementations of internationalized content using typescript.\n   * - If set to \"strict\", the translation `t` function will require each declared locales to be defined. If one locale is missing, or if a locale is not declared in your config, it will throw an error.\n   * - If set to \"inclusive\", the translation `t` function will require each declared locales to be defined. If one locale is missing, it will throw a warning. But will accept if a locale is not declared in your config, but exist.\n   * - If set to \"loose\", the translation `t` function will accept any existing locale.\n   *\n   * Default: \"inclusive\"\n   */\n  strictMode: customConfiguration?.strictMode ?? STRICT_MODE,\n\n  /**\n   * Default locale of the application for fallback\n   *\n   * Default: 'en'\n   */\n  defaultLocale: customConfiguration?.defaultLocale ?? DEFAULT_LOCALE,\n});\n\n/**\n * Build the routing section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied routing config.\n * @returns A fully-defaulted {@link RoutingConfig}.\n */\nexport const buildRoutingFields = (\n  customConfiguration?: Partial<CustomRoutingConfig>\n): RoutingConfig => {\n  const storage = customConfiguration?.storage ?? STORAGE;\n\n  return {\n    /**\n     * URL routing mode for locale handling\n     *\n     * Controls how locales are represented in application URLs:\n     * - 'prefix-no-default': Prefix all locales except the default locale (default)\n     *    - en → /dashboard\n     *    - fr → /fr/dashboard\n     *\n     * - 'prefix-all': Prefix all locales including the default locale\n     *    - en → /en/dashboard\n     *    - fr → /fr/dashboard\n     *\n     * - 'search-params': Use search parameters for locale handling\n     *    - en → /dashboard?locale=en\n     *    - fr → /fr/dashboard?locale=fr\n     *\n     * - 'no-prefix': No locale prefixing in URLs\n     *    - en → /dashboard\n     *    - fr → /dashboard\n     *\n     * Default: 'prefix-no-default'\n     */\n    mode: customConfiguration?.mode ?? ROUTING_MODE,\n\n    /**\n     * Enables the Intlayer locale-routing proxy (middleware).\n     *\n     * When enabled, the build-tool integration (e.g. the `intlayer()` Vite plugin)\n     * automatically wires the locale-detection / redirect / rewrite middleware in\n     * development, preview, and production SSR.\n     *\n     * - `undefined` (auto, default): the proxy runs, but development and preview\n     *   servers ignore the stored locale (cookie / header) as a redirect source.\n     * - `true`: full proxy behaviour in every environment.\n     * - `false`: no locale routing; the proxy is not registered.\n     *\n     * Default: undefined (auto)\n     */\n    enableProxy: customConfiguration?.enableProxy ?? ENABLE_PROXY,\n\n    /**\n     * Configuration for storing the locale in the client (localStorage or sessionStorage)\n     *\n     * If false, the locale will not be stored by the middleware.\n     * If true, the locale storage will consider all default values. (cookie and header)\n     *\n     * Default: ['cookie', 'header']\n     *\n     */\n    storage: getStorageAttributes(storage),\n\n    /**\n     * Base path of the application URL\n     *\n     * Default: ''\n     *\n     * Example:\n     * - If the application is hosted at https://example.com/my-app\n     * - The base path is '/my-app'\n     * - The URL will be https://example.com/my-app/en\n     * - If the base path is not set, the URL will be https://example.com/en\n     */\n    basePath: customConfiguration?.basePath ?? BASE_PATH,\n\n    /**\n     * Custom URL rewriting rules that override the default routing mode for specific paths.\n     * Allows you to define locale-specific paths that differ from the standard routing behavior.\n     * Supports dynamic route parameters using `[param]` syntax.\n     *\n     * Default: undefined\n     *\n     * Example:\n     * ```typescript\n     * rewrite: {\n     *   \"/about\": {\n     *     en: \"/about\",\n     *     fr: \"/a-propos\",\n     *   },\n     *   \"/product/[slug]\": {\n     *     en: \"/product/[slug]\",\n     *     fr: \"/produit/[slug]\",\n     *   },\n     * }\n     * ```\n     *\n     * Note:\n     * - The rewrite rules take precedence over the default `mode` behavior.\n     * - If a path matches a rewrite rule, the localized path from the rewrite configuration will be used.\n     * - Dynamic route parameters are supported using bracket notation (e.g., `[slug]`, `[id]`).\n     * - Works with both Next.js and Vite applications.\n     */\n    rewrite: customConfiguration?.rewrite,\n\n    /**\n     * Maps locales to specific domain hostnames for domain-based routing.\n     *\n     * Default: undefined\n     */\n    domains: customConfiguration?.domains,\n  };\n};\n\n/**\n * Build the editor section of the Intlayer configuration.\n *\n * Returns the **full** {@link EditorConfig} including sensitive fields\n * (`clientId`, `clientSecret`). The browser-safe {@link BrowserIntlayerConfig}\n * omits those fields when exposing config to the client.\n *\n * `clientId` / `clientSecret` are never inferred from the environment: the\n * configuration file is the single source of truth. A project that wants to\n * authenticate from its `.env` file must wire the variables explicitly, e.g.\n * `clientId: process.env.INTLAYER_CLIENT_ID`. Commenting those lines out is\n * therefore enough to disable every credentialed behaviour (remote dictionary\n * fetching, CMS access) even when the variables remain defined in the\n * environment.\n *\n * @param customConfiguration - Partial user-supplied editor config.\n * @returns A fully-defaulted {@link EditorConfig}.\n */\nexport const buildEditorFields = (\n  customConfiguration?: Partial<EditorConfig>\n): EditorConfig => {\n  const liveSyncPort = customConfiguration?.liveSyncPort ?? LIVE_SYNC_PORT;\n  return {\n    /**\n     * URL of the application. Used to restrict the origin of the editor for security reasons.\n     *\n     * > '*' means that the editor is accessible from any origin\n     *\n     * Default: '*'\n     */\n    applicationURL: customConfiguration?.applicationURL || APPLICATION_URL,\n\n    /**\n     * URL of the editor server. Used to restrict the origin of the editor for security reasons.\n     *\n     * > '*' means that the editor is accessible from any origin\n     *\n     * Default: '*'\n     */\n    editorURL: customConfiguration?.editorURL || EDITOR_URL,\n\n    /**\n     * URL of the CMS server. Used to restrict the origin of the editor for security reasons.\n     */\n    cmsURL: customConfiguration?.cmsURL || CMS_URL,\n\n    /**\n     * URL of the editor server\n     *\n     * Default: 'https://back.intlayer.org'\n     */\n    backendURL: customConfiguration?.backendURL || BACKEND_URL,\n\n    /** Port of the editor server\n     *\n     * Default: 8000\n     */\n    port: customConfiguration?.port ?? PORT,\n\n    /**\n     * Indicates if the application interact with the visual editor\n     *\n     * Default: false;\n     *\n     * If true, the editor will be able to interact with the application.\n     * If false, the editor will not be able to interact with the application.\n     * In any case, the editor can only be enabled by the visual editor.\n     * Disabling the editor for specific environments is a way to enforce the security.\n     *\n     * Usage:\n     * ```js\n     * {\n     *  // Other configurations\n     *  editor: {\n     *   enabled: process.env.NODE_ENV !== 'production',\n     *  }\n     * };\n     * ```\n     */\n    enabled: customConfiguration?.enabled ?? IS_ENABLED,\n\n    /**\n     * clientId and clientSecret allow the intlayer packages to authenticate with the backend using oAuth2 authentication.\n     * An access token is use to authenticate the user related to the project.\n     * To get an access token, go to https://app.intlayer.org/project and create an account.\n     *\n     * Default: undefined\n     *\n     * > Important: The clientId and clientSecret should be kept secret and not shared publicly. Please ensure to keep them in a secure location, such as environment variables.\n     */\n    clientId: customConfiguration?.clientId,\n\n    /**\n     * clientId and clientSecret allow the intlayer packages to authenticate with the backend using oAuth2 authentication.\n     * An access token is use to authenticate the user related to the project.\n     * To get an access token, go to https://app.intlayer.org/project and create an account.\n     *\n     * Default: undefined\n     *\n     * > Important: The clientId and clientSecret should be kept secret and not shared publicly. Please ensure to keep them in a secure location, such as environment variables.\n     */\n    clientSecret: customConfiguration?.clientSecret,\n\n    /**\n     * Strategy for prioritizing dictionaries. If a dictionary is both present online and locally, the content will be merge.\n     * However, is a field is defined in both dictionary, this setting determines which fields takes the priority over the other.\n     *\n     * Default: 'local_first'\n     *\n     * The strategy for prioritizing dictionaries. It can be either 'local_first' or 'distant_first'.\n     * - 'local_first': The first dictionary found in the locale is used.\n     * - 'distant_first': The first dictionary found in the distant locales is used.\n     */\n    dictionaryPriorityStrategy:\n      customConfiguration?.dictionaryPriorityStrategy ??\n      DICTIONARY_PRIORITY_STRATEGY,\n\n    /**\n     * Indicates if the application should hot reload the locale configurations when a change is detected.\n     * For example, when a new dictionary is added or updated, the application will update the content tu display in the page.\n     *\n     * The hot reload is only available for clients of the `enterprise` plan.\n     *\n     * Default: false\n     */\n    liveSync: customConfiguration?.liveSync ?? LIVE_SYNC,\n\n    /**\n     * Port of the live sync server\n     *\n     * Default: 4000\n     */\n    liveSyncPort,\n\n    /**\n     * URL of the live sync server in case of remote live sync server\n     *\n     * Default: `http://localhost:${LIVE_SYNC_PORT}`\n     */\n    liveSyncURL:\n      customConfiguration?.liveSyncURL ?? `http://localhost:${liveSyncPort}`,\n  };\n};\n\n/**\n * Build the analytics section of the Intlayer configuration.\n *\n * Analytics is strictly opt-in: `enabled` defaults to `false` and, even when\n * enabled, the runtime additionally requires a project key (`editor.clientId`)\n * for attribution before collecting anything.\n *\n * @param customConfiguration - Partial user-supplied analytics config.\n * @returns A fully-defaulted {@link AnalyticsConfig}.\n */\nexport const buildAnalyticsFields = (\n  customConfiguration?: Partial<AnalyticsConfig>\n): AnalyticsConfig => ({\n  /**\n   * Enables analytics collection (page views, content exposures, A/B events).\n   *\n   * Default: false\n   */\n  enabled: customConfiguration?.enabled ?? ANALYTICS_ENABLED,\n\n  /**\n   * Milliseconds between automatic batched flushes to the backend.\n   *\n   * Default: 20000\n   */\n  flushInterval: customConfiguration?.flushInterval ?? ANALYTICS_FLUSH_INTERVAL,\n\n  /**\n   * Fraction of sessions to record, from 0 (none) to 1 (all).\n   *\n   * Default: 1\n   */\n  sampleRate: customConfiguration?.sampleRate ?? ANALYTICS_SAMPLE_RATE,\n});\n\n/**\n * Build the log section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied log config.\n * @param logFunctions - Optional custom log function overrides (server-only).\n * @returns A fully-defaulted {@link LogConfig}.\n */\nexport const buildLogFields = (\n  customConfiguration?: Partial<LogConfig>,\n  logFunctions?: LogFunctions\n): LogConfig => ({\n  /**\n   * Indicates if the logger is enabled\n   *\n   * Default: 'prefix-no-default'\n   *\n   * If 'default', the logger is enabled and can be used.\n   * If 'verbose', the logger will be enabled and can be used, but will log more information.\n   * If 'disabled', the logger is disabled and cannot be used.\n   */\n  mode: customConfiguration?.mode ?? MODE,\n\n  /**\n   * Prefix of the logger\n   *\n   * Default: '[intlayer]'\n   *\n   * The prefix of the logger.\n   */\n  prefix: customConfiguration?.prefix ?? PREFIX,\n\n  /**\n   * Functions to log\n   */\n  error: logFunctions?.error,\n  log: logFunctions?.log,\n  info: logFunctions?.info,\n  warn: logFunctions?.warn,\n});\n\n// ---------------------------------------------------------------------------\n// Browser configuration builders\n// ---------------------------------------------------------------------------\n\n/**\n * Build a browser-safe {@link BrowserIntlayerConfig} from a raw user config.\n *\n * Applies defaults for every field and strips all server-only or sensitive\n * information (`system`, `content`, `build`, `compiler`, `dictionary`, `ai`,\n * `editor.clientId`, `editor.clientSecret`).\n *\n * This is the browser counterpart of `buildConfigurationFields`. It is safe\n * to call in browser environments because it has no Node.js dependencies.\n *\n * @param customConfig - Optional partial user-supplied Intlayer config.\n * @returns A browser-safe configuration object ready for `window.INTLAYER_CONFIG`.\n *\n * @example\n * ```ts\n * import { buildBrowserConfiguration } from '@intlayer/config/client';\n *\n * window.INTLAYER_CONFIG = buildBrowserConfiguration({\n *   internationalization: { locales: ['en', 'fr'], defaultLocale: 'en' },\n * });\n * ```\n */\nexport const buildBrowserConfiguration = (\n  customConfig?: CustomIntlayerConfig\n): BrowserIntlayerConfig => {\n  const { locales, defaultLocale } = buildInternationalizationFields(\n    customConfig?.internationalization\n  );\n  const routing = buildRoutingFields(customConfig?.routing);\n  const {\n    clientId: _clientId,\n    clientSecret: _clientSecret,\n    ...editorPublic\n  } = buildEditorFields(customConfig?.editor);\n  const analytics = buildAnalyticsFields(customConfig?.analytics);\n  const { mode, prefix } = buildLogFields(customConfig?.log);\n\n  return {\n    internationalization: { locales, defaultLocale },\n    routing,\n    editor: editorPublic,\n    analytics,\n    log: { mode, prefix },\n  };\n};\n\n/**\n * Extract a {@link BrowserIntlayerConfig} from an already-built full\n * {@link IntlayerConfig}.\n *\n * Used by build plugins (`vite-intlayer`, `withIntlayer`) which already hold\n * the full server-side config and need to inject the browser-safe subset at\n * compile time via a bundler `define`.\n *\n * @param config - A fully-built server-side Intlayer configuration.\n * @returns The browser-safe subset of that configuration.\n */\nexport const extractBrowserConfiguration = (\n  config: IntlayerConfig\n): BrowserIntlayerConfig => ({\n  internationalization: {\n    locales: config.internationalization.locales,\n    defaultLocale: config.internationalization.defaultLocale,\n  },\n  routing: {\n    mode: config.routing.mode,\n    enableProxy: config.routing.enableProxy,\n    storage: config.routing.storage,\n    basePath: config.routing.basePath,\n    rewrite: config.routing.rewrite,\n  },\n  editor: {\n    applicationURL: config.editor.applicationURL,\n    editorURL: config.editor.editorURL,\n    cmsURL: config.editor.cmsURL,\n    backendURL: config.editor.backendURL,\n    port: config.editor.port,\n    enabled: config.editor.enabled,\n    dictionaryPriorityStrategy: config.editor.dictionaryPriorityStrategy,\n    liveSync: config.editor.liveSync,\n    liveSyncPort: config.editor.liveSyncPort,\n    liveSyncURL: config.editor.liveSyncURL,\n  },\n  analytics: buildAnalyticsFields(config.analytics),\n  log: {\n    mode: config.log.mode,\n    prefix: config.log.prefix,\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"buildBrowserConfiguration.mjs","names":[],"sources":["../../../src/configFile/buildBrowserConfiguration.ts"],"sourcesContent":["import type {\n  AnalyticsConfig,\n  CustomIntlayerConfig,\n  CustomRoutingConfig,\n  EditorConfig,\n  InternationalizationConfig,\n  IntlayerConfig,\n  LogConfig,\n  LogFunctions,\n  RoutingConfig,\n} from '@intlayer/types/config';\nimport {\n  ANALYTICS_ENABLED,\n  ANALYTICS_FLUSH_INTERVAL,\n  ANALYTICS_SAMPLE_RATE,\n} from '../defaultValues/analytics';\nimport {\n  APPLICATION_URL,\n  BACKEND_URL,\n  CMS_URL,\n  DICTIONARY_PRIORITY_STRATEGY,\n  EDITOR_URL,\n  IS_ENABLED,\n  LIVE_SYNC,\n  LIVE_SYNC_PORT,\n  PORT,\n} from '../defaultValues/editor';\nimport {\n  DEFAULT_LOCALE,\n  LOCALES,\n  REQUIRED_LOCALES,\n  STRICT_MODE,\n} from '../defaultValues/internationalization';\nimport { MODE, PREFIX } from '../defaultValues/log';\nimport {\n  BASE_PATH,\n  ENABLE_PROXY,\n  ROUTING_MODE,\n  STORAGE,\n} from '../defaultValues/routing';\nimport { getStorageAttributes } from '../utils/getStorageAttributes';\n\n// ---------------------------------------------------------------------------\n// Type\n// ---------------------------------------------------------------------------\n\n/**\n * Browser-safe subset of {@link IntlayerConfig}.\n *\n * Excludes server-only fields (`system`, `content`, `build`, `compiler`,\n * `dictionary`, `ai`) and sensitive editor credentials (`clientId`,\n * `clientSecret`) that must never be shipped to the browser.\n */\nexport type BrowserIntlayerConfig = {\n  internationalization: Pick<\n    InternationalizationConfig,\n    'locales' | 'defaultLocale'\n  >;\n  routing: RoutingConfig;\n  editor: Omit<EditorConfig, 'clientId' | 'clientSecret'>;\n  analytics: AnalyticsConfig;\n  log: Pick<LogConfig, 'mode' | 'prefix'>;\n};\n\ndeclare global {\n  interface Window {\n    /** Browser-safe Intlayer configuration injected by a build plugin or `installIntlayer`. */\n    INTLAYER_CONFIG?: BrowserIntlayerConfig;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Shared field builders (browser-safe — no Node.js APIs)\n//\n// These functions are re-used by both `buildBrowserConfiguration` (browser)\n// and `buildConfigurationFields` (server) to avoid duplication.\n// ---------------------------------------------------------------------------\n\n/**\n * Build the internationalization section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied internationalization config.\n * @returns A fully-defaulted {@link InternationalizationConfig}.\n */\nexport const buildInternationalizationFields = (\n  customConfiguration?: Partial<InternationalizationConfig>\n): InternationalizationConfig => ({\n  /**\n   * Locales available in the application\n   *\n   * Default: ['en']\n   *\n   */\n  locales: customConfiguration?.locales ?? LOCALES,\n\n  /**\n   * Locales required by TypeScript to ensure strong implementations of internationalized content using typescript.\n   *\n   * Default: []\n   *\n   * If empty, all locales are required in `strict` mode.\n   *\n   * Ensure required locales are also defined in the `locales` field.\n   */\n  requiredLocales:\n    customConfiguration?.requiredLocales ??\n    customConfiguration?.locales ??\n    REQUIRED_LOCALES,\n\n  /**\n   * Ensure strong implementations of internationalized content using typescript.\n   * - If set to \"strict\", the translation `t` function will require each declared locales to be defined. If one locale is missing, or if a locale is not declared in your config, it will throw an error.\n   * - If set to \"inclusive\", the translation `t` function will require each declared locales to be defined. If one locale is missing, it will throw a warning. But will accept if a locale is not declared in your config, but exist.\n   * - If set to \"loose\", the translation `t` function will accept any existing locale.\n   *\n   * Default: \"inclusive\"\n   */\n  strictMode: customConfiguration?.strictMode ?? STRICT_MODE,\n\n  /**\n   * Default locale of the application for fallback\n   *\n   * Default: 'en'\n   */\n  defaultLocale: customConfiguration?.defaultLocale ?? DEFAULT_LOCALE,\n});\n\n/**\n * Build the routing section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied routing config.\n * @returns A fully-defaulted {@link RoutingConfig}.\n */\nexport const buildRoutingFields = (\n  customConfiguration?: Partial<CustomRoutingConfig>\n): RoutingConfig => {\n  const storage = customConfiguration?.storage ?? STORAGE;\n\n  return {\n    /**\n     * URL routing mode for locale handling\n     *\n     * Controls how locales are represented in application URLs:\n     * - 'prefix-no-default': Prefix all locales except the default locale (default)\n     *    - en → /dashboard\n     *    - fr → /fr/dashboard\n     *\n     * - 'prefix-all': Prefix all locales including the default locale\n     *    - en → /en/dashboard\n     *    - fr → /fr/dashboard\n     *\n     * - 'search-params': Use search parameters for locale handling\n     *    - en → /dashboard?locale=en\n     *    - fr → /fr/dashboard?locale=fr\n     *\n     * - 'no-prefix': No locale prefixing in URLs\n     *    - en → /dashboard\n     *    - fr → /dashboard\n     *\n     * Default: 'prefix-no-default'\n     */\n    mode: customConfiguration?.mode ?? ROUTING_MODE,\n\n    /**\n     * Enables the Intlayer locale-routing proxy (middleware).\n     *\n     * When enabled, the build-tool integration (e.g. the `intlayer()` Vite plugin)\n     * automatically wires the locale-detection / redirect / rewrite middleware in\n     * development, preview, and production SSR.\n     *\n     * - `undefined` (auto, default): the proxy runs, but development and preview\n     *   servers ignore the stored locale (cookie / header) as a redirect source.\n     * - `true`: full proxy behaviour in every environment.\n     * - `false`: no locale routing; the proxy is not registered.\n     *\n     * Default: undefined (auto)\n     */\n    enableProxy: customConfiguration?.enableProxy ?? ENABLE_PROXY,\n\n    /**\n     * Configuration for storing the locale in the client (localStorage or sessionStorage)\n     *\n     * If false, the locale will not be stored by the middleware.\n     * If true, the locale storage will consider all default values. (cookie and header)\n     *\n     * Default: ['cookie', 'header']\n     *\n     */\n    storage: getStorageAttributes(storage),\n\n    /**\n     * Base path of the application URL\n     *\n     * Default: ''\n     *\n     * Example:\n     * - If the application is hosted at https://example.com/my-app\n     * - The base path is '/my-app'\n     * - The URL will be https://example.com/my-app/en\n     * - If the base path is not set, the URL will be https://example.com/en\n     */\n    basePath: customConfiguration?.basePath ?? BASE_PATH,\n\n    /**\n     * Custom URL rewriting rules that override the default routing mode for specific paths.\n     * Allows you to define locale-specific paths that differ from the standard routing behavior.\n     * Supports dynamic route parameters using `[param]` syntax.\n     *\n     * Default: undefined\n     *\n     * Example:\n     * ```typescript\n     * rewrite: {\n     *   \"/about\": {\n     *     en: \"/about\",\n     *     fr: \"/a-propos\",\n     *   },\n     *   \"/product/[slug]\": {\n     *     en: \"/product/[slug]\",\n     *     fr: \"/produit/[slug]\",\n     *   },\n     * }\n     * ```\n     *\n     * Note:\n     * - The rewrite rules take precedence over the default `mode` behavior.\n     * - If a path matches a rewrite rule, the localized path from the rewrite configuration will be used.\n     * - Dynamic route parameters are supported using bracket notation (e.g., `[slug]`, `[id]`).\n     * - Works with both Next.js and Vite applications.\n     */\n    rewrite: customConfiguration?.rewrite,\n\n    /**\n     * Maps locales to specific domain hostnames for domain-based routing.\n     *\n     * Default: undefined\n     */\n    domains: customConfiguration?.domains,\n  };\n};\n\n/**\n * Build the editor section of the Intlayer configuration.\n *\n * Returns the **full** {@link EditorConfig} including sensitive fields\n * (`clientId`, `clientSecret`). The browser-safe {@link BrowserIntlayerConfig}\n * omits those fields when exposing config to the client.\n *\n * `clientId` / `clientSecret` are never inferred from the environment: the\n * configuration file is the single source of truth. A project that wants to\n * authenticate from its `.env` file must wire the variables explicitly, e.g.\n * `clientId: process.env.INTLAYER_CLIENT_ID`. Commenting those lines out is\n * therefore enough to disable every credentialed behaviour (remote dictionary\n * fetching, CMS access) even when the variables remain defined in the\n * environment.\n *\n * @param customConfiguration - Partial user-supplied editor config.\n * @returns A fully-defaulted {@link EditorConfig}.\n */\nexport const buildEditorFields = (\n  customConfiguration?: Partial<EditorConfig>\n): EditorConfig => {\n  const liveSyncPort = customConfiguration?.liveSyncPort ?? LIVE_SYNC_PORT;\n  return {\n    /**\n     * URL of the application. Used to restrict the origin of the editor for security reasons.\n     *\n     * > '*' means that the editor is accessible from any origin\n     *\n     * Default: '*'\n     */\n    applicationURL: customConfiguration?.applicationURL || APPLICATION_URL,\n\n    /**\n     * URL of the editor server. Used to restrict the origin of the editor for security reasons.\n     *\n     * > '*' means that the editor is accessible from any origin\n     *\n     * Default: '*'\n     */\n    editorURL: customConfiguration?.editorURL || EDITOR_URL,\n\n    /**\n     * URL of the CMS server. Used to restrict the origin of the editor for security reasons.\n     */\n    cmsURL: customConfiguration?.cmsURL || CMS_URL,\n\n    /**\n     * URL of the editor server\n     *\n     * Default: 'https://back.intlayer.org'\n     */\n    backendURL: customConfiguration?.backendURL || BACKEND_URL,\n\n    /** Port of the editor server\n     *\n     * Default: 8000\n     */\n    port: customConfiguration?.port ?? PORT,\n\n    /**\n     * Indicates if the application interact with the visual editor\n     *\n     * Default: false;\n     *\n     * If true, the editor will be able to interact with the application.\n     * If false, the editor will not be able to interact with the application.\n     * In any case, the editor can only be enabled by the visual editor.\n     * Disabling the editor for specific environments is a way to enforce the security.\n     *\n     * Usage:\n     * ```js\n     * {\n     *  // Other configurations\n     *  editor: {\n     *   enabled: process.env.NODE_ENV !== 'production',\n     *  }\n     * };\n     * ```\n     */\n    enabled: customConfiguration?.enabled ?? IS_ENABLED,\n\n    /**\n     * clientId and clientSecret allow the intlayer packages to authenticate with the backend using oAuth2 authentication.\n     * An access token is use to authenticate the user related to the project.\n     * To get an access token, go to https://app.intlayer.org/project and create an account.\n     *\n     * Default: undefined\n     *\n     * > Important: The clientId and clientSecret should be kept secret and not shared publicly. Please ensure to keep them in a secure location, such as environment variables.\n     */\n    clientId: customConfiguration?.clientId,\n\n    /**\n     * clientId and clientSecret allow the intlayer packages to authenticate with the backend using oAuth2 authentication.\n     * An access token is use to authenticate the user related to the project.\n     * To get an access token, go to https://app.intlayer.org/project and create an account.\n     *\n     * Default: undefined\n     *\n     * > Important: The clientId and clientSecret should be kept secret and not shared publicly. Please ensure to keep them in a secure location, such as environment variables.\n     */\n    clientSecret: customConfiguration?.clientSecret,\n\n    /**\n     * Strategy for prioritizing dictionaries. If a dictionary is both present online and locally, the content will be merge.\n     * However, is a field is defined in both dictionary, this setting determines which fields takes the priority over the other.\n     *\n     * Default: 'local_first'\n     *\n     * The strategy for prioritizing dictionaries. It can be either 'local_first' or 'distant_first'.\n     * - 'local_first': The first dictionary found in the locale is used.\n     * - 'distant_first': The first dictionary found in the distant locales is used.\n     */\n    dictionaryPriorityStrategy:\n      customConfiguration?.dictionaryPriorityStrategy ??\n      DICTIONARY_PRIORITY_STRATEGY,\n\n    /**\n     * Indicates if the application should hot reload the locale configurations when a change is detected.\n     * For example, when a new dictionary is added or updated, the application will update the content tu display in the page.\n     *\n     * The hot reload is only available for clients of the `enterprise` plan.\n     *\n     * Default: false\n     */\n    liveSync: customConfiguration?.liveSync ?? LIVE_SYNC,\n\n    /**\n     * Port of the live sync server\n     *\n     * Default: 4000\n     */\n    liveSyncPort,\n\n    /**\n     * URL of the live sync server in case of remote live sync server\n     *\n     * Default: `http://localhost:${LIVE_SYNC_PORT}`\n     */\n    liveSyncURL:\n      customConfiguration?.liveSyncURL ?? `http://localhost:${liveSyncPort}`,\n  };\n};\n\n/**\n * Build the analytics section of the Intlayer configuration.\n *\n * Analytics is opt-out: `enabled` defaults to `true`, so installing the\n * optional `@intlayer/analytics` package is enough to turn it on. The runtime\n * additionally requires a project key (`editor.clientId`) for attribution\n * before collecting anything.\n *\n * An explicit `enabled` value always wins, so a project whose package manager\n * hides the package from the project root can still opt back in.\n *\n * @param customConfiguration - Partial user-supplied analytics config.\n * @param isPackageInstalled - Whether `@intlayer/analytics` is installed in the\n *   project. Browser callers cannot resolve packages and pass `true`, letting\n *   the runtime dynamic `import()` fail silently when it is absent.\n * @returns A fully-defaulted {@link AnalyticsConfig}.\n */\nexport const buildAnalyticsFields = (\n  customConfiguration?: Partial<AnalyticsConfig>,\n  isPackageInstalled = true\n): AnalyticsConfig => ({\n  /**\n   * Enables analytics collection (page views, content exposures, A/B events).\n   *\n   * Default: true, as soon as `@intlayer/analytics` is installed.\n   */\n  enabled:\n    customConfiguration?.enabled ?? (ANALYTICS_ENABLED && isPackageInstalled),\n\n  /**\n   * Milliseconds between automatic batched flushes to the backend.\n   *\n   * Default: 20000\n   */\n  flushInterval: customConfiguration?.flushInterval ?? ANALYTICS_FLUSH_INTERVAL,\n\n  /**\n   * Fraction of sessions to record, from 0 (none) to 1 (all).\n   *\n   * Default: 1\n   */\n  sampleRate: customConfiguration?.sampleRate ?? ANALYTICS_SAMPLE_RATE,\n});\n\n/**\n * Build the log section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied log config.\n * @param logFunctions - Optional custom log function overrides (server-only).\n * @returns A fully-defaulted {@link LogConfig}.\n */\nexport const buildLogFields = (\n  customConfiguration?: Partial<LogConfig>,\n  logFunctions?: LogFunctions\n): LogConfig => ({\n  /**\n   * Indicates if the logger is enabled\n   *\n   * Default: 'prefix-no-default'\n   *\n   * If 'default', the logger is enabled and can be used.\n   * If 'verbose', the logger will be enabled and can be used, but will log more information.\n   * If 'disabled', the logger is disabled and cannot be used.\n   */\n  mode: customConfiguration?.mode ?? MODE,\n\n  /**\n   * Prefix of the logger\n   *\n   * Default: '[intlayer]'\n   *\n   * The prefix of the logger.\n   */\n  prefix: customConfiguration?.prefix ?? PREFIX,\n\n  /**\n   * Functions to log\n   */\n  error: logFunctions?.error,\n  log: logFunctions?.log,\n  info: logFunctions?.info,\n  warn: logFunctions?.warn,\n});\n\n// ---------------------------------------------------------------------------\n// Browser configuration builders\n// ---------------------------------------------------------------------------\n\n/**\n * Build a browser-safe {@link BrowserIntlayerConfig} from a raw user config.\n *\n * Applies defaults for every field and strips all server-only or sensitive\n * information (`system`, `content`, `build`, `compiler`, `dictionary`, `ai`,\n * `editor.clientId`, `editor.clientSecret`).\n *\n * This is the browser counterpart of `buildConfigurationFields`. It is safe\n * to call in browser environments because it has no Node.js dependencies.\n *\n * @param customConfig - Optional partial user-supplied Intlayer config.\n * @returns A browser-safe configuration object ready for `window.INTLAYER_CONFIG`.\n *\n * @example\n * ```ts\n * import { buildBrowserConfiguration } from '@intlayer/config/client';\n *\n * window.INTLAYER_CONFIG = buildBrowserConfiguration({\n *   internationalization: { locales: ['en', 'fr'], defaultLocale: 'en' },\n * });\n * ```\n */\nexport const buildBrowserConfiguration = (\n  customConfig?: CustomIntlayerConfig\n): BrowserIntlayerConfig => {\n  const { locales, defaultLocale } = buildInternationalizationFields(\n    customConfig?.internationalization\n  );\n  const routing = buildRoutingFields(customConfig?.routing);\n  const {\n    clientId: _clientId,\n    clientSecret: _clientSecret,\n    ...editorPublic\n  } = buildEditorFields(customConfig?.editor);\n  const analytics = buildAnalyticsFields(customConfig?.analytics);\n  const { mode, prefix } = buildLogFields(customConfig?.log);\n\n  return {\n    internationalization: { locales, defaultLocale },\n    routing,\n    editor: editorPublic,\n    analytics,\n    log: { mode, prefix },\n  };\n};\n\n/**\n * Extract a {@link BrowserIntlayerConfig} from an already-built full\n * {@link IntlayerConfig}.\n *\n * Used by build plugins (`vite-intlayer`, `withIntlayer`) which already hold\n * the full server-side config and need to inject the browser-safe subset at\n * compile time via a bundler `define`.\n *\n * @param config - A fully-built server-side Intlayer configuration.\n * @returns The browser-safe subset of that configuration.\n */\nexport const extractBrowserConfiguration = (\n  config: IntlayerConfig\n): BrowserIntlayerConfig => ({\n  internationalization: {\n    locales: config.internationalization.locales,\n    defaultLocale: config.internationalization.defaultLocale,\n  },\n  routing: {\n    mode: config.routing.mode,\n    enableProxy: config.routing.enableProxy,\n    storage: config.routing.storage,\n    basePath: config.routing.basePath,\n    rewrite: config.routing.rewrite,\n  },\n  editor: {\n    applicationURL: config.editor.applicationURL,\n    editorURL: config.editor.editorURL,\n    cmsURL: config.editor.cmsURL,\n    backendURL: config.editor.backendURL,\n    port: config.editor.port,\n    enabled: config.editor.enabled,\n    dictionaryPriorityStrategy: config.editor.dictionaryPriorityStrategy,\n    liveSync: config.editor.liveSync,\n    liveSyncPort: config.editor.liveSyncPort,\n    liveSyncURL: config.editor.liveSyncURL,\n  },\n  analytics: buildAnalyticsFields(config.analytics),\n  log: {\n    mode: config.log.mode,\n    prefix: config.log.prefix,\n  },\n});\n"],"mappings":"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"}

package/dist/esm/configFile/buildConfigurationFields.mjs

@@ -5,6 +5,7 @@ import { CODE_DIR, CONTENT_DIR, EXCLUDED_PATHS, FILE_EXTENSIONS, WATCH } from ".
 import { CONTENT_AUTO_TRANSFORMATION, FILL, IMPORT_MODE, LOCATION } from "../defaultValues/dictionary.mjs";
 import { CACHE_DIR, CONFIG_DIR, DICTIONARIES_DIR, DYNAMIC_DICTIONARIES_DIR, FETCH_DICTIONARIES_DIR, MAIN_DIR, MODULE_AUGMENTATION_DIR, REMOTE_DICTIONARIES_DIR, TEMP_DIR, TYPES_DIR, UNMERGED_DICTIONARIES_DIR } from "../defaultValues/system.mjs";
 import { getProjectRequire } from "../utils/ESMxCJSHelpers.mjs";
+import { isPackageInstalled } from "../utils/isPackageInstalled.mjs";
 import { buildAnalyticsFields, buildBrowserConfiguration, buildEditorFields, buildInternationalizationFields, buildLogFields, buildRoutingFields, extractBrowserConfiguration } from "./buildBrowserConfiguration.mjs";
 import { intlayerConfigSchema } from "./configurationSchema.mjs";
 import { statSync } from "node:fs";
@@ -13,6 +14,11 @@ import { dirname, isAbsolute, join } from "node:path";
 //#region src/configFile/buildConfigurationFields.ts
 let storedConfiguration;
 /**
+* Optional companion package whose presence in the project dependency tree
+* opts the application into analytics collection.
+*/
+const ANALYTICS_PACKAGE_NAME = "@intlayer/analytics";
+/**
 * Build the `system` section of the Intlayer configuration.
 *
 * Resolves all directory paths (dictionaries, types, cache, …) relative to
@@ -594,7 +600,7 @@ const buildConfigurationFields = (customConfiguration, baseDir, logFunctions) =>
 		routing: browserConfig.routing,
 		internationalization: internationalizationConfig,
 		editor: editorConfig,
-		analytics: buildAnalyticsFields(customConfiguration?.analytics),
+		analytics: buildAnalyticsFields(customConfiguration?.analytics, isPackageInstalled(ANALYTICS_PACKAGE_NAME, systemConfig.baseDir)),
 		log: logConfig,
 		system: systemConfig,
 		content: contentConfig,

package/dist/esm/configFile/buildConfigurationFields.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"buildConfigurationFields.mjs","names":[],"sources":["../../../src/configFile/buildConfigurationFields.ts"],"sourcesContent":["import { statSync } from 'node:fs';\nimport { dirname, isAbsolute, join } from 'node:path';\nimport type {\n  AiConfig,\n  BuildConfig,\n  CompilerConfig,\n  ContentConfig,\n  CustomIntlayerConfig,\n  DictionaryConfig,\n  IntlayerConfig,\n  LogFunctions,\n  SystemConfig,\n} from '@intlayer/types/config';\nimport {\n  BUILD_MODE,\n  CACHE,\n  CHUNK_GROUPING,\n  DICTIONARIES_PRELOAD,\n  MINIFY,\n  OUTPUT_FORMAT,\n  PURGE,\n  TRAVERSE_PATTERN,\n  TYPE_CHECKING,\n} from '../defaultValues/build';\nimport {\n  COMPILER_DICTIONARY_KEY_PREFIX,\n  COMPILER_ENABLED,\n  COMPILER_NO_METADATA,\n  COMPILER_SAVE_COMPONENTS,\n} from '../defaultValues/compiler';\nimport {\n  CODE_DIR,\n  CONTENT_DIR,\n  EXCLUDED_PATHS,\n  FILE_EXTENSIONS,\n  WATCH,\n} from '../defaultValues/content';\nimport {\n  CONTENT_AUTO_TRANSFORMATION,\n  FILL,\n  IMPORT_MODE,\n  LOCATION,\n} from '../defaultValues/dictionary';\nimport {\n  CACHE_DIR,\n  CONFIG_DIR,\n  DICTIONARIES_DIR,\n  DYNAMIC_DICTIONARIES_DIR,\n  FETCH_DICTIONARIES_DIR,\n  MAIN_DIR,\n  MODULE_AUGMENTATION_DIR,\n  REMOTE_DICTIONARIES_DIR,\n  TEMP_DIR,\n  TYPES_DIR,\n  UNMERGED_DICTIONARIES_DIR,\n} from '../defaultValues/system';\nimport { getProjectRequire } from '../utils';\nimport {\n  buildAnalyticsFields,\n  buildBrowserConfiguration,\n  buildEditorFields,\n  buildInternationalizationFields,\n  buildLogFields,\n} from './buildBrowserConfiguration';\nimport { intlayerConfigSchema } from './configurationSchema';\n\nexport {\n  type BrowserIntlayerConfig,\n  buildAnalyticsFields,\n  buildBrowserConfiguration,\n  buildEditorFields,\n  buildInternationalizationFields,\n  buildLogFields,\n  buildRoutingFields,\n  extractBrowserConfiguration,\n} from './buildBrowserConfiguration';\n\nlet storedConfiguration: IntlayerConfig;\n\n// ---------------------------------------------------------------------------\n// Server-only field builders (Node.js — not browser-safe)\n// ---------------------------------------------------------------------------\n\n/**\n * Build the `system` section of the Intlayer configuration.\n *\n * Resolves all directory paths (dictionaries, types, cache, …) relative to\n * the project base directory, using Node.js `require.resolve` where available\n * and falling back to `path.join` otherwise.\n *\n * @param baseDir - Project root directory. Defaults to `process.cwd()`.\n * @param customConfiguration - Partial user-supplied system config.\n * @returns A fully-resolved {@link SystemConfig}.\n */\nconst buildSystemFields = (\n  baseDir?: string,\n  customConfiguration?: Partial<SystemConfig>\n): SystemConfig => {\n  const projectBaseDir = baseDir ?? process.cwd();\n\n  const optionalJoinBaseDir = (pathInput: string) => {\n    let absolutePath: string;\n\n    try {\n      const requireFunction = getProjectRequire(projectBaseDir);\n      try {\n        absolutePath = requireFunction.resolve(pathInput, {\n          paths: [projectBaseDir],\n        });\n      } catch (err) {\n        if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n          absolutePath = requireFunction.resolve(`${pathInput}/package.json`, {\n            paths: [projectBaseDir],\n          });\n        } else {\n          throw err;\n        }\n      }\n    } catch {\n      absolutePath = isAbsolute(pathInput)\n        ? pathInput\n        : join(projectBaseDir, pathInput);\n    }\n\n    try {\n      const stats = statSync(absolutePath);\n      if (stats.isFile()) {\n        return dirname(absolutePath);\n      }\n    } catch {\n      if (/\\.[a-z0-9]+$/i.test(absolutePath)) {\n        return dirname(absolutePath);\n      }\n    }\n\n    return absolutePath;\n  };\n\n  const dictionariesDir = optionalJoinBaseDir(\n    customConfiguration?.dictionariesDir ?? DICTIONARIES_DIR\n  );\n\n  return {\n    baseDir: projectBaseDir,\n    moduleAugmentationDir: optionalJoinBaseDir(\n      customConfiguration?.moduleAugmentationDir ?? MODULE_AUGMENTATION_DIR\n    ),\n    unmergedDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.unmergedDictionariesDir ?? UNMERGED_DICTIONARIES_DIR\n    ),\n    remoteDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.remoteDictionariesDir ?? REMOTE_DICTIONARIES_DIR\n    ),\n    dictionariesDir,\n    dynamicDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.dynamicDictionariesDir ?? DYNAMIC_DICTIONARIES_DIR\n    ),\n    fetchDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.fetchDictionariesDir ?? FETCH_DICTIONARIES_DIR\n    ),\n    typesDir: optionalJoinBaseDir(customConfiguration?.typesDir ?? TYPES_DIR),\n    mainDir: optionalJoinBaseDir(customConfiguration?.mainDir ?? MAIN_DIR),\n    configDir: optionalJoinBaseDir(\n      customConfiguration?.configDir ?? CONFIG_DIR\n    ),\n    cacheDir: optionalJoinBaseDir(customConfiguration?.cacheDir ?? CACHE_DIR),\n    tempDir: optionalJoinBaseDir(customConfiguration?.tempDir ?? TEMP_DIR),\n  };\n};\n\n/**\n * Build the `content` section of the Intlayer configuration.\n *\n * Resolves content and code directories relative to the project base using\n * `require.resolve`, falling back to `path.join`.\n *\n * @param systemConfig - Already-built system configuration (provides `baseDir`).\n * @param customConfiguration - Partial user-supplied content config.\n * @returns A fully-resolved {@link ContentConfig}.\n */\nconst buildContentFields = (\n  systemConfig: SystemConfig,\n  customConfiguration?: Partial<ContentConfig>\n): ContentConfig => {\n  const fileExtensions = customConfiguration?.fileExtensions ?? FILE_EXTENSIONS;\n\n  const optionalJoinBaseDir = (pathInput: string) => {\n    let absolutePath: string;\n\n    try {\n      const requireFunction = getProjectRequire(systemConfig.baseDir);\n      try {\n        absolutePath = requireFunction.resolve(pathInput, {\n          paths: [systemConfig.baseDir],\n        });\n      } catch (err) {\n        if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n          absolutePath = requireFunction.resolve(`${pathInput}/package.json`, {\n            paths: [systemConfig.baseDir],\n          });\n        } else {\n          throw err;\n        }\n      }\n    } catch {\n      try {\n        try {\n          absolutePath = require.resolve(pathInput, {\n            paths: [systemConfig.baseDir],\n          });\n        } catch (err) {\n          if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n            absolutePath = require.resolve(`${pathInput}/package.json`, {\n              paths: [systemConfig.baseDir],\n            });\n          } else {\n            throw err;\n          }\n        }\n      } catch {\n        absolutePath = isAbsolute(pathInput)\n          ? pathInput\n          : join(systemConfig.baseDir, pathInput);\n      }\n    }\n\n    try {\n      const stats = statSync(absolutePath);\n      if (stats.isFile()) {\n        return dirname(absolutePath);\n      }\n    } catch {\n      if (/\\.[a-z0-9]+$/i.test(absolutePath)) {\n        return dirname(absolutePath);\n      }\n    }\n\n    return absolutePath;\n  };\n\n  const contentDir = (customConfiguration?.contentDir ?? CONTENT_DIR).map(\n    optionalJoinBaseDir\n  );\n  const codeDir = (customConfiguration?.codeDir ?? CODE_DIR).map(\n    optionalJoinBaseDir\n  );\n\n  return {\n    fileExtensions,\n    contentDir,\n    codeDir,\n    excludedPath: customConfiguration?.excludedPath ?? EXCLUDED_PATHS,\n    watch: customConfiguration?.watch ?? WATCH,\n    formatCommand: customConfiguration?.formatCommand,\n  };\n};\n\n/**\n * Build the `ai` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied AI config.\n * @returns A fully-defaulted {@link AiConfig}.\n */\nconst buildAiFields = (customConfiguration?: Partial<AiConfig>): AiConfig => ({\n  /**\n   * AI configuration\n   */\n  provider: customConfiguration?.provider,\n\n  /**\n   * API key\n   */\n  apiKey: customConfiguration?.apiKey,\n\n  /**\n   * API model\n   */\n  model: customConfiguration?.model,\n\n  /**\n   * Temperature\n   */\n  temperature: customConfiguration?.temperature,\n\n  /**\n   * Application context\n   *\n   * Default: undefined\n   *\n   * The application context.\n   *\n   * Example: `'My application context'`\n   *\n   * Note: Can be used to provide additional context about the application to the AI model. You can add more rules (e.g. \"You should not transform urls\").\n   */\n  applicationContext: customConfiguration?.applicationContext,\n\n  /**\n   * Base URL for the AI API\n   *\n   * Default: undefined\n   *\n   * The base URL for the AI API.\n   *\n   * Example: `'http://localhost:5000'`\n   *\n   * Note: Can be used to point to a local, or custom AI API endpoint.\n   */\n  baseURL: customConfiguration?.baseURL,\n\n  /**\n   * Data serialization\n   *\n   * Options:\n   * - \"json\": The industry standard. Highly reliable and structured, but consumes more tokens.\n   * - \"toon\": An optimized format designed to reduce token consumption (cost-effective). However, it may slightly increase the risk of output inconsistency compared to standard JSON\n   *\n   * Default: `\"json\"`\n   */\n  dataSerialization: customConfiguration?.dataSerialization,\n});\n\n/**\n * Build the `build` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied build config.\n * @returns A fully-defaulted {@link BuildConfig}.\n */\nconst buildBuildFields = (\n  customConfiguration?: Partial<BuildConfig>\n): BuildConfig => ({\n  /**\n   * Indicates the mode of the build\n   *\n   * Default: 'auto'\n   *\n   * If 'auto', the build will be enabled automatically when the application is built.\n   * If 'manual', the build will be set only when the build command is executed.\n   *\n   * Can be used to disable dictionaries build, for instance when execution on Node.js environment should be avoided.\n   */\n  mode: customConfiguration?.mode ?? BUILD_MODE,\n\n  /**\n   * Indicates if the build should be optimized\n   *\n   * Default: process.env.NODE_ENV === 'production'\n   *\n   * If true, the build will be optimized.\n   * If false, the build will not be optimized.\n   *\n   * Intlayer will replace all calls of dictionaries to optimize chunking. That way the final bundle will import only the dictionaries that are used.\n   * All imports will stay as static import to avoid async processing when loading the dictionaries.\n   *\n   * Note:\n   * - Intlayer will replace all call of `useIntlayer` with the defined mode by the `importMode` option.\n   * - Intlayer will replace all call of `getIntlayer` with `getDictionary`.\n   * - This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.\n   * - In most cases, \"dynamic\" will be used for React applications, \"async\" for Vue.js applications.\n   * - Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.\n   */\n  optimize: customConfiguration?.optimize,\n\n  /**\n   * Indicates the mode of import to use for the dictionaries.\n   *\n   * Available modes:\n   * - \"static\": The dictionaries are imported statically.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionary`.\n   * - \"dynamic\": The dictionaries are imported dynamically in a synchronous component using the suspense API.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionaryDynamic`.\n   * - \"live\": The dictionaries are imported dynamically using the live sync API.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionaryDynamic`.\n   *   Live mode will use the live sync API to fetch the dictionaries. If the API call fails, the dictionaries will be imported dynamically as \"dynamic\" mode.\n   *\n   * Default: \"static\"\n   *\n   * By default, when a dictionary is loaded, it imports content for all locales as it's imported statically.\n   *\n   * Note:\n   * - Dynamic imports rely on Suspense and may slightly impact rendering performance.\n   * - If disabled all locales will be loaded at once, even if they are not used.\n   * - This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.\n   * - Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will not impact the `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` and `useDictionaryDynamic` functions. You can still use them to refine you code on manual optimization.\n   * - The \"live\" allows to sync the dictionaries to the live sync server.\n   *\n   * @deprecated Use `dictionary.importMode` instead.\n   */\n  importMode: customConfiguration?.importMode,\n\n  /**\n   * Minify the dictionaries to reduce the bundle size.\n   *\n   * Default: false\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will be ignore if `editor.enabled` is true.\n   * - If there is edge cases where the minification is not working properly, the dictionary will be not minified.\n   */\n  minify: customConfiguration?.minify ?? MINIFY,\n\n  /**\n   * Purge the unused keys in a dictionaries\n   *\n   * Default: false\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will be ignored if `editor.enabled` is true.\n   */\n  purge: customConfiguration?.purge ?? PURGE,\n\n  /**\n   * Group the per-locale dictionary chunks by the code-split boundary that uses\n   * them, so a lazily loaded page fetches its content in one request.\n   *\n   * Default: true\n   *\n   * Note:\n   * - Only applies to dictionaries using `importMode: 'dynamic'`.\n   * - Only applies to the client build, and only when bundling (not in dev).\n   */\n  chunkGrouping: customConfiguration?.chunkGrouping ?? CHUNK_GROUPING,\n\n  /**\n   * Load a dictionary together with the chunk that uses it, instead of fetching\n   * it once that chunk renders — so a reader renders synchronously rather than\n   * suspending, and navigating no longer flashes a loading state.\n   *\n   * Default: true\n   *\n   * Note:\n   * - Only applies to dictionaries using `importMode: 'dynamic'`.\n   * - Only applies to the client build; the server keeps loading on demand.\n   * - Requires a bundler supporting top-level await (Vite, esbuild).\n   */\n  dictionariesPreload:\n    customConfiguration?.dictionariesPreload ?? DICTIONARIES_PRELOAD,\n\n  /**\n   * Pattern to traverse the code to optimize.\n   *\n   * Allows to avoid to traverse the code that is not relevant to the optimization.\n   * Improve build performance.\n   *\n   * Default: ['**\\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\\/node_modules/**']\n   *\n   * Example: `['src/**\\/*.{ts,tsx}', '../ui-library/**\\/*.{ts,tsx}']`\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - Use glob pattern.\n   */\n  traversePattern: customConfiguration?.traversePattern ?? TRAVERSE_PATTERN,\n\n  /**\n   * Output format of the dictionaries\n   *\n   * Can be set on large projects to improve build performance.\n   *\n   * Default: ['cjs', 'esm']\n   *\n   * The output format of the dictionaries. It can be either 'cjs' or 'esm'.\n   * - 'cjs': The dictionaries are outputted as CommonJS modules.\n   * - 'esm': The dictionaries are outputted as ES modules.\n   */\n  outputFormat: customConfiguration?.outputFormat ?? OUTPUT_FORMAT,\n\n  /**\n   * Cache\n   */\n  cache: customConfiguration?.cache ?? CACHE,\n\n  /**\n   * Require function\n   */\n  require: customConfiguration?.require,\n\n  /**\n   * Indicates if the build should check TypeScript types\n   *\n   * Default: `false`\n   *\n   * If true, the build will check TypeScript types and log errors.\n   * Note: This can slow down the build.\n   */\n  checkTypes: customConfiguration?.checkTypes ?? TYPE_CHECKING,\n});\n\n/**\n * Build the `compiler` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied compiler config.\n * @returns A fully-defaulted {@link CompilerConfig}.\n */\nconst buildCompilerFields = (\n  customConfiguration?: Partial<CompilerConfig>\n): CompilerConfig => ({\n  /**\n   * Indicates if the compiler should be enabled\n   */\n  enabled: customConfiguration?.enabled ?? COMPILER_ENABLED,\n\n  /**\n   * Prefix for the extracted dictionary keys\n   */\n  dictionaryKeyPrefix:\n    customConfiguration?.dictionaryKeyPrefix ?? COMPILER_DICTIONARY_KEY_PREFIX,\n\n  /**\n   * Pattern to traverse the code to optimize.\n   *\n   * @deprecated use `build.traversePattern` instead\n   */\n  transformPattern: customConfiguration?.transformPattern,\n\n  /**\n   * Pattern to exclude from the optimization.\n   *\n   * @deprecated use `build.traversePattern` instead\n   */\n  excludePattern: customConfiguration?.excludePattern,\n\n  /**\n   * Defines the output files path. Replaces `outputDir`.\n   *\n   * - `./` paths are resolved relative to the component directory.\n   * - `/` paths are resolved relative to the project root (`baseDir`).\n   *\n   * - Including the `{{locale}}` variable in the path will trigger the generation of separate dictionaries per locale.\n   *\n   * @example:\n   * ```ts\n   * {\n   *   // Create Multilingual .content.ts files close to the component\n   *   output: ({ fileName, extension }) => `./${fileName}${extension}`,\n   *\n   *   // output: './{{fileName}}{{extension}}', // Equivalent using template string\n   * }\n   * ```\n   *\n   * ```ts\n   * {\n   *   // Create centralize per-locale JSON at the root of the project\n   *   output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,\n   *\n   *   // output: '/locales/{{locale}}/{{key}}.content.json', // Equivalent using template string\n   * }\n   * ```\n   *\n   * ```ts\n   * {\n   *   // Create per-locale JSON files with locale-specific output paths\n   *   output: {\n   *     en: ({ fileName, locale }) => `${fileName}.${locale}.content.json`,\n   *     fr: '{{fileName}}.{{locale}}.content.json',\n   *     es: false, // skip this locale\n   *   },\n   * }\n   * ```\n   *\n   * Variable list:\n   *   - `fileName`: The name of the file.\n   *   - `key`: The key of the content.\n   *   - `locale`: The locale of the content.\n   *   - `extension`: The extension of the file.\n   *   - `componentFileName`: The name of the component file.\n   *   - `componentExtension`: The extension of the component file.\n   *   - `format`: The format of the dictionary.\n   *   - `componentFormat`: The format of the component dictionary.\n   *   - `componentDirPath`: The directory path of the component.\n   */\n  output: customConfiguration?.output,\n\n  /**\n   * Indicates if the metadata should be saved in the file.\n   *\n   * If true, the compiler will not save the metadata of the dictionaries.\n   *\n   * If `true`:\n   *\n   * ```json\n   * {\n   *   \"key\": \"value\"\n   * }\n   * ```\n   *\n   * If `false`:\n   *\n   * ```json\n   * {\n   *   \"key\": \"value\",\n   *   \"content\": {\n   *      \"key\": \"value\"\n   *   }\n   * }\n   * ```\n   *\n   * Default: `false`\n   *\n   * Note: Useful if used with loadJSON plugin\n   */\n  noMetadata: customConfiguration?.noMetadata ?? COMPILER_NO_METADATA,\n\n  /**\n   * Indicates if the components should be saved after being transformed.\n   */\n  saveComponents:\n    customConfiguration?.saveComponents ?? COMPILER_SAVE_COMPONENTS,\n});\n\n/**\n * Build the `dictionary` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied dictionary config.\n * @returns A fully-defaulted {@link DictionaryConfig}.\n */\nconst buildDictionaryFields = (\n  customConfiguration?: Partial<DictionaryConfig>\n): DictionaryConfig => {\n  const contentAutoTransformation =\n    customConfiguration?.contentAutoTransformation ??\n    CONTENT_AUTO_TRANSFORMATION;\n\n  return {\n    /**\n     * Indicate how the dictionary should be filled using AI.\n     *\n     * Default: `true`\n     *\n     * - If `true`, will consider the `compiler.output` field.\n     * - If `false`, will skip the fill process.\n     *\n     * - `./` paths are resolved relative to the component directory.\n     * - `/` paths are resolved relative to the project root (`baseDir`).\n     *\n     * - If includes `{{locale}}` variable in the path, will trigger the generation of separate dictionaries per locale.\n     *\n     * Example:\n     * ```ts\n     * {\n     *   // Create Multilingual .content.ts files close to the component\n     *   fill: ({ fileName, extension }) => `./${fileName}${extension}`,\n     *\n     *   // fill: './{{fileName}}{{extension}}', // Equivalent using template string\n     * }\n     * ```\n     *\n     * ```ts\n     * {\n     *   // Create centralize per-locale JSON at the root of the project\n     *   fill: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,\n     *\n     *   // fill: '/locales/{{locale}}/{{key}}.content.json', // Equivalent using template string\n     * }\n     * ```\n     *\n     * ```ts\n     * {\n     *   // Create custom output based on the locale\n     *   fill: {\n     *     en: ({ key }) => `/locales/en/${key}.content.json`,\n     *     fr: '/locales/fr/{{key}}.content.json',\n     *     es: false,\n     *     de: true,\n     *   },\n     * }\n     * ```\n     *\n     *\n     * Variable list:\n     *   - `fileName`: The name of the file.\n     *   - `key`: The key of the content.\n     *   - `locale`: The locale of the content.\n     *   - `extension`: The extension of the file.\n     *   - `componentFileName`: The name of the component file.\n     *   - `componentExtension`: The extension of the component file.\n     *   - `format`: The format of the dictionary.\n     *   - `componentFormat`: The format of the component dictionary.\n     *   - `componentDirPath`: The directory path of the component.\n     */\n    fill: customConfiguration?.fill ?? FILL,\n\n    /**\n     * Indicates if the content of the dictionary should be automatically transformed.\n     *\n     * Default: `false`\n     */\n    contentAutoTransformation:\n      typeof contentAutoTransformation === 'object'\n        ? {\n            markdown: contentAutoTransformation.markdown ?? false,\n            html: contentAutoTransformation.html ?? false,\n            insertion: contentAutoTransformation.insertion ?? false,\n          }\n        : contentAutoTransformation,\n\n    /**\n     * The location of the dictionary.\n     *\n     * Default: `\"local\"`\n     */\n    location: customConfiguration?.location ?? LOCATION,\n\n    /**\n     * Transform the dictionary in a per-locale dictionary.\n     * Each field declared in a per-locale dictionary will be transformed in a translation node.\n     * If missing, the dictionary will be treated as a multilingual dictionary.\n     */\n    locale: customConfiguration?.locale,\n\n    /**\n     * The title of the dictionary.\n     */\n    title: customConfiguration?.title,\n\n    /**\n     * The description of the dictionary.\n     */\n    description: customConfiguration?.description,\n\n    /**\n     * Tags to categorize the dictionaries.\n     */\n    tags: customConfiguration?.tags,\n\n    /**\n     * The priority of the dictionary.\n     */\n    priority: customConfiguration?.priority,\n\n    /**\n     * Indicates the mode of import to use for the dictionary.\n     *\n     * Available modes:\n     * - \"static\": The dictionaries are imported statically.\n     * - \"dynamic\": The dictionaries are imported dynamically in a synchronous component using the suspense API.\n     * - \"live\": The dictionaries are imported dynamically using the live sync API.\n     *\n     * Default: `\"static\"`\n     */\n    importMode: customConfiguration?.importMode ?? IMPORT_MODE,\n\n    /**\n     * The default message format for all dictionaries in the project.\n     *\n     * Default: 'intlayer'\n     */\n    format: customConfiguration?.format,\n  };\n};\n\n// ---------------------------------------------------------------------------\n// Main export\n// ---------------------------------------------------------------------------\n\n/**\n * Build the complete Intlayer configuration by merging user-supplied values\n * with defaults.\n *\n * Internally this function:\n * 1. Calls {@link buildBrowserConfiguration} to produce the browser-safe\n *    subset (internationalization, routing, editor public fields, log, metadata).\n * 2. Extends the result with full server-side fields:\n *    - `internationalization` — adds `requiredLocales` and `strictMode`.\n *    - `editor` — adds `clientId` and `clientSecret`.\n *    - `log` — adds custom log functions.\n *    - `system`, `content`, `ai`, `build`, `compiler`, `dictionary`.\n *\n * @param customConfiguration - Optional user-supplied configuration object.\n * @param baseDir - Project root directory. Defaults to `process.cwd()`.\n * @param logFunctions - Optional custom logging functions.\n * @returns A fully-built {@link IntlayerConfig}.\n */\nexport const buildConfigurationFields = (\n  customConfiguration?: CustomIntlayerConfig,\n  baseDir?: string,\n  logFunctions?: LogFunctions\n): IntlayerConfig => {\n  if (customConfiguration) {\n    const result = intlayerConfigSchema.safeParse(customConfiguration);\n\n    if (!result.success) {\n      const logError = logFunctions?.error ?? console.error;\n\n      for (const issue of result.error.issues) {\n        logError(`${issue.path.join('.')}: ${issue.message}`);\n      }\n    }\n  }\n\n  // build browser-safe config (shared defaults, no Node.js deps)\n  const browserConfig = buildBrowserConfiguration(customConfiguration);\n\n  // extend shared fields with server-only additions\n  const internationalizationConfig = buildInternationalizationFields(\n    customConfiguration?.internationalization\n  );\n\n  const editorConfig = buildEditorFields(customConfiguration?.editor);\n\n  const logConfig = buildLogFields(customConfiguration?.log, logFunctions);\n\n  // build server-only fields\n  const systemConfig = buildSystemFields(baseDir, customConfiguration?.system);\n\n  const contentConfig = buildContentFields(\n    systemConfig,\n    customConfiguration?.content\n  );\n\n  storedConfiguration = {\n    // Shared browser fields\n    routing: browserConfig.routing,\n    // Full (extended) shared fields\n    internationalization: internationalizationConfig,\n    editor: editorConfig,\n    analytics: buildAnalyticsFields(customConfiguration?.analytics),\n    log: logConfig,\n    // Server-only fields\n    system: systemConfig,\n    content: contentConfig,\n    ai: buildAiFields(customConfiguration?.ai),\n    build: buildBuildFields(customConfiguration?.build),\n    compiler: buildCompilerFields(customConfiguration?.compiler),\n    dictionary: buildDictionaryFields(customConfiguration?.dictionary),\n    plugins: customConfiguration?.plugins,\n    schemas: customConfiguration?.schemas,\n  } as IntlayerConfig;\n\n  return storedConfiguration;\n};\n"],"mappings":"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"}
+{"version":3,"file":"buildConfigurationFields.mjs","names":[],"sources":["../../../src/configFile/buildConfigurationFields.ts"],"sourcesContent":["import { statSync } from 'node:fs';\nimport { dirname, isAbsolute, join } from 'node:path';\nimport type {\n  AiConfig,\n  BuildConfig,\n  CompilerConfig,\n  ContentConfig,\n  CustomIntlayerConfig,\n  DictionaryConfig,\n  IntlayerConfig,\n  LogFunctions,\n  SystemConfig,\n} from '@intlayer/types/config';\nimport {\n  BUILD_MODE,\n  CACHE,\n  CHUNK_GROUPING,\n  DICTIONARIES_PRELOAD,\n  MINIFY,\n  OUTPUT_FORMAT,\n  PURGE,\n  TRAVERSE_PATTERN,\n  TYPE_CHECKING,\n} from '../defaultValues/build';\nimport {\n  COMPILER_DICTIONARY_KEY_PREFIX,\n  COMPILER_ENABLED,\n  COMPILER_NO_METADATA,\n  COMPILER_SAVE_COMPONENTS,\n} from '../defaultValues/compiler';\nimport {\n  CODE_DIR,\n  CONTENT_DIR,\n  EXCLUDED_PATHS,\n  FILE_EXTENSIONS,\n  WATCH,\n} from '../defaultValues/content';\nimport {\n  CONTENT_AUTO_TRANSFORMATION,\n  FILL,\n  IMPORT_MODE,\n  LOCATION,\n} from '../defaultValues/dictionary';\nimport {\n  CACHE_DIR,\n  CONFIG_DIR,\n  DICTIONARIES_DIR,\n  DYNAMIC_DICTIONARIES_DIR,\n  FETCH_DICTIONARIES_DIR,\n  MAIN_DIR,\n  MODULE_AUGMENTATION_DIR,\n  REMOTE_DICTIONARIES_DIR,\n  TEMP_DIR,\n  TYPES_DIR,\n  UNMERGED_DICTIONARIES_DIR,\n} from '../defaultValues/system';\nimport { getProjectRequire, isPackageInstalled } from '../utils';\nimport {\n  buildAnalyticsFields,\n  buildBrowserConfiguration,\n  buildEditorFields,\n  buildInternationalizationFields,\n  buildLogFields,\n} from './buildBrowserConfiguration';\nimport { intlayerConfigSchema } from './configurationSchema';\n\nexport {\n  type BrowserIntlayerConfig,\n  buildAnalyticsFields,\n  buildBrowserConfiguration,\n  buildEditorFields,\n  buildInternationalizationFields,\n  buildLogFields,\n  buildRoutingFields,\n  extractBrowserConfiguration,\n} from './buildBrowserConfiguration';\n\nlet storedConfiguration: IntlayerConfig;\n\n/**\n * Optional companion package whose presence in the project dependency tree\n * opts the application into analytics collection.\n */\nconst ANALYTICS_PACKAGE_NAME = '@intlayer/analytics';\n\n// ---------------------------------------------------------------------------\n// Server-only field builders (Node.js — not browser-safe)\n// ---------------------------------------------------------------------------\n\n/**\n * Build the `system` section of the Intlayer configuration.\n *\n * Resolves all directory paths (dictionaries, types, cache, …) relative to\n * the project base directory, using Node.js `require.resolve` where available\n * and falling back to `path.join` otherwise.\n *\n * @param baseDir - Project root directory. Defaults to `process.cwd()`.\n * @param customConfiguration - Partial user-supplied system config.\n * @returns A fully-resolved {@link SystemConfig}.\n */\nconst buildSystemFields = (\n  baseDir?: string,\n  customConfiguration?: Partial<SystemConfig>\n): SystemConfig => {\n  const projectBaseDir = baseDir ?? process.cwd();\n\n  const optionalJoinBaseDir = (pathInput: string) => {\n    let absolutePath: string;\n\n    try {\n      const requireFunction = getProjectRequire(projectBaseDir);\n      try {\n        absolutePath = requireFunction.resolve(pathInput, {\n          paths: [projectBaseDir],\n        });\n      } catch (err) {\n        if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n          absolutePath = requireFunction.resolve(`${pathInput}/package.json`, {\n            paths: [projectBaseDir],\n          });\n        } else {\n          throw err;\n        }\n      }\n    } catch {\n      absolutePath = isAbsolute(pathInput)\n        ? pathInput\n        : join(projectBaseDir, pathInput);\n    }\n\n    try {\n      const stats = statSync(absolutePath);\n      if (stats.isFile()) {\n        return dirname(absolutePath);\n      }\n    } catch {\n      if (/\\.[a-z0-9]+$/i.test(absolutePath)) {\n        return dirname(absolutePath);\n      }\n    }\n\n    return absolutePath;\n  };\n\n  const dictionariesDir = optionalJoinBaseDir(\n    customConfiguration?.dictionariesDir ?? DICTIONARIES_DIR\n  );\n\n  return {\n    baseDir: projectBaseDir,\n    moduleAugmentationDir: optionalJoinBaseDir(\n      customConfiguration?.moduleAugmentationDir ?? MODULE_AUGMENTATION_DIR\n    ),\n    unmergedDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.unmergedDictionariesDir ?? UNMERGED_DICTIONARIES_DIR\n    ),\n    remoteDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.remoteDictionariesDir ?? REMOTE_DICTIONARIES_DIR\n    ),\n    dictionariesDir,\n    dynamicDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.dynamicDictionariesDir ?? DYNAMIC_DICTIONARIES_DIR\n    ),\n    fetchDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.fetchDictionariesDir ?? FETCH_DICTIONARIES_DIR\n    ),\n    typesDir: optionalJoinBaseDir(customConfiguration?.typesDir ?? TYPES_DIR),\n    mainDir: optionalJoinBaseDir(customConfiguration?.mainDir ?? MAIN_DIR),\n    configDir: optionalJoinBaseDir(\n      customConfiguration?.configDir ?? CONFIG_DIR\n    ),\n    cacheDir: optionalJoinBaseDir(customConfiguration?.cacheDir ?? CACHE_DIR),\n    tempDir: optionalJoinBaseDir(customConfiguration?.tempDir ?? TEMP_DIR),\n  };\n};\n\n/**\n * Build the `content` section of the Intlayer configuration.\n *\n * Resolves content and code directories relative to the project base using\n * `require.resolve`, falling back to `path.join`.\n *\n * @param systemConfig - Already-built system configuration (provides `baseDir`).\n * @param customConfiguration - Partial user-supplied content config.\n * @returns A fully-resolved {@link ContentConfig}.\n */\nconst buildContentFields = (\n  systemConfig: SystemConfig,\n  customConfiguration?: Partial<ContentConfig>\n): ContentConfig => {\n  const fileExtensions = customConfiguration?.fileExtensions ?? FILE_EXTENSIONS;\n\n  const optionalJoinBaseDir = (pathInput: string) => {\n    let absolutePath: string;\n\n    try {\n      const requireFunction = getProjectRequire(systemConfig.baseDir);\n      try {\n        absolutePath = requireFunction.resolve(pathInput, {\n          paths: [systemConfig.baseDir],\n        });\n      } catch (err) {\n        if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n          absolutePath = requireFunction.resolve(`${pathInput}/package.json`, {\n            paths: [systemConfig.baseDir],\n          });\n        } else {\n          throw err;\n        }\n      }\n    } catch {\n      try {\n        try {\n          absolutePath = require.resolve(pathInput, {\n            paths: [systemConfig.baseDir],\n          });\n        } catch (err) {\n          if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n            absolutePath = require.resolve(`${pathInput}/package.json`, {\n              paths: [systemConfig.baseDir],\n            });\n          } else {\n            throw err;\n          }\n        }\n      } catch {\n        absolutePath = isAbsolute(pathInput)\n          ? pathInput\n          : join(systemConfig.baseDir, pathInput);\n      }\n    }\n\n    try {\n      const stats = statSync(absolutePath);\n      if (stats.isFile()) {\n        return dirname(absolutePath);\n      }\n    } catch {\n      if (/\\.[a-z0-9]+$/i.test(absolutePath)) {\n        return dirname(absolutePath);\n      }\n    }\n\n    return absolutePath;\n  };\n\n  const contentDir = (customConfiguration?.contentDir ?? CONTENT_DIR).map(\n    optionalJoinBaseDir\n  );\n  const codeDir = (customConfiguration?.codeDir ?? CODE_DIR).map(\n    optionalJoinBaseDir\n  );\n\n  return {\n    fileExtensions,\n    contentDir,\n    codeDir,\n    excludedPath: customConfiguration?.excludedPath ?? EXCLUDED_PATHS,\n    watch: customConfiguration?.watch ?? WATCH,\n    formatCommand: customConfiguration?.formatCommand,\n  };\n};\n\n/**\n * Build the `ai` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied AI config.\n * @returns A fully-defaulted {@link AiConfig}.\n */\nconst buildAiFields = (customConfiguration?: Partial<AiConfig>): AiConfig => ({\n  /**\n   * AI configuration\n   */\n  provider: customConfiguration?.provider,\n\n  /**\n   * API key\n   */\n  apiKey: customConfiguration?.apiKey,\n\n  /**\n   * API model\n   */\n  model: customConfiguration?.model,\n\n  /**\n   * Temperature\n   */\n  temperature: customConfiguration?.temperature,\n\n  /**\n   * Application context\n   *\n   * Default: undefined\n   *\n   * The application context.\n   *\n   * Example: `'My application context'`\n   *\n   * Note: Can be used to provide additional context about the application to the AI model. You can add more rules (e.g. \"You should not transform urls\").\n   */\n  applicationContext: customConfiguration?.applicationContext,\n\n  /**\n   * Base URL for the AI API\n   *\n   * Default: undefined\n   *\n   * The base URL for the AI API.\n   *\n   * Example: `'http://localhost:5000'`\n   *\n   * Note: Can be used to point to a local, or custom AI API endpoint.\n   */\n  baseURL: customConfiguration?.baseURL,\n\n  /**\n   * Data serialization\n   *\n   * Options:\n   * - \"json\": The industry standard. Highly reliable and structured, but consumes more tokens.\n   * - \"toon\": An optimized format designed to reduce token consumption (cost-effective). However, it may slightly increase the risk of output inconsistency compared to standard JSON\n   *\n   * Default: `\"json\"`\n   */\n  dataSerialization: customConfiguration?.dataSerialization,\n});\n\n/**\n * Build the `build` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied build config.\n * @returns A fully-defaulted {@link BuildConfig}.\n */\nconst buildBuildFields = (\n  customConfiguration?: Partial<BuildConfig>\n): BuildConfig => ({\n  /**\n   * Indicates the mode of the build\n   *\n   * Default: 'auto'\n   *\n   * If 'auto', the build will be enabled automatically when the application is built.\n   * If 'manual', the build will be set only when the build command is executed.\n   *\n   * Can be used to disable dictionaries build, for instance when execution on Node.js environment should be avoided.\n   */\n  mode: customConfiguration?.mode ?? BUILD_MODE,\n\n  /**\n   * Indicates if the build should be optimized\n   *\n   * Default: process.env.NODE_ENV === 'production'\n   *\n   * If true, the build will be optimized.\n   * If false, the build will not be optimized.\n   *\n   * Intlayer will replace all calls of dictionaries to optimize chunking. That way the final bundle will import only the dictionaries that are used.\n   * All imports will stay as static import to avoid async processing when loading the dictionaries.\n   *\n   * Note:\n   * - Intlayer will replace all call of `useIntlayer` with the defined mode by the `importMode` option.\n   * - Intlayer will replace all call of `getIntlayer` with `getDictionary`.\n   * - This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.\n   * - In most cases, \"dynamic\" will be used for React applications, \"async\" for Vue.js applications.\n   * - Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.\n   */\n  optimize: customConfiguration?.optimize,\n\n  /**\n   * Indicates the mode of import to use for the dictionaries.\n   *\n   * Available modes:\n   * - \"static\": The dictionaries are imported statically.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionary`.\n   * - \"dynamic\": The dictionaries are imported dynamically in a synchronous component using the suspense API.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionaryDynamic`.\n   * - \"live\": The dictionaries are imported dynamically using the live sync API.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionaryDynamic`.\n   *   Live mode will use the live sync API to fetch the dictionaries. If the API call fails, the dictionaries will be imported dynamically as \"dynamic\" mode.\n   *\n   * Default: \"static\"\n   *\n   * By default, when a dictionary is loaded, it imports content for all locales as it's imported statically.\n   *\n   * Note:\n   * - Dynamic imports rely on Suspense and may slightly impact rendering performance.\n   * - If disabled all locales will be loaded at once, even if they are not used.\n   * - This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.\n   * - Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will not impact the `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` and `useDictionaryDynamic` functions. You can still use them to refine you code on manual optimization.\n   * - The \"live\" allows to sync the dictionaries to the live sync server.\n   *\n   * @deprecated Use `dictionary.importMode` instead.\n   */\n  importMode: customConfiguration?.importMode,\n\n  /**\n   * Minify the dictionaries to reduce the bundle size.\n   *\n   * Default: false\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will be ignore if `editor.enabled` is true.\n   * - If there is edge cases where the minification is not working properly, the dictionary will be not minified.\n   */\n  minify: customConfiguration?.minify ?? MINIFY,\n\n  /**\n   * Purge the unused keys in a dictionaries\n   *\n   * Default: false\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will be ignored if `editor.enabled` is true.\n   */\n  purge: customConfiguration?.purge ?? PURGE,\n\n  /**\n   * Group the per-locale dictionary chunks by the code-split boundary that uses\n   * them, so a lazily loaded page fetches its content in one request.\n   *\n   * Default: true\n   *\n   * Note:\n   * - Only applies to dictionaries using `importMode: 'dynamic'`.\n   * - Only applies to the client build, and only when bundling (not in dev).\n   */\n  chunkGrouping: customConfiguration?.chunkGrouping ?? CHUNK_GROUPING,\n\n  /**\n   * Load a dictionary together with the chunk that uses it, instead of fetching\n   * it once that chunk renders — so a reader renders synchronously rather than\n   * suspending, and navigating no longer flashes a loading state.\n   *\n   * Default: true\n   *\n   * Note:\n   * - Only applies to dictionaries using `importMode: 'dynamic'`.\n   * - Only applies to the client build; the server keeps loading on demand.\n   * - Requires a bundler supporting top-level await (Vite, esbuild).\n   */\n  dictionariesPreload:\n    customConfiguration?.dictionariesPreload ?? DICTIONARIES_PRELOAD,\n\n  /**\n   * Pattern to traverse the code to optimize.\n   *\n   * Allows to avoid to traverse the code that is not relevant to the optimization.\n   * Improve build performance.\n   *\n   * Default: ['**\\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\\/node_modules/**']\n   *\n   * Example: `['src/**\\/*.{ts,tsx}', '../ui-library/**\\/*.{ts,tsx}']`\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - Use glob pattern.\n   */\n  traversePattern: customConfiguration?.traversePattern ?? TRAVERSE_PATTERN,\n\n  /**\n   * Output format of the dictionaries\n   *\n   * Can be set on large projects to improve build performance.\n   *\n   * Default: ['cjs', 'esm']\n   *\n   * The output format of the dictionaries. It can be either 'cjs' or 'esm'.\n   * - 'cjs': The dictionaries are outputted as CommonJS modules.\n   * - 'esm': The dictionaries are outputted as ES modules.\n   */\n  outputFormat: customConfiguration?.outputFormat ?? OUTPUT_FORMAT,\n\n  /**\n   * Cache\n   */\n  cache: customConfiguration?.cache ?? CACHE,\n\n  /**\n   * Require function\n   */\n  require: customConfiguration?.require,\n\n  /**\n   * Indicates if the build should check TypeScript types\n   *\n   * Default: `false`\n   *\n   * If true, the build will check TypeScript types and log errors.\n   * Note: This can slow down the build.\n   */\n  checkTypes: customConfiguration?.checkTypes ?? TYPE_CHECKING,\n});\n\n/**\n * Build the `compiler` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied compiler config.\n * @returns A fully-defaulted {@link CompilerConfig}.\n */\nconst buildCompilerFields = (\n  customConfiguration?: Partial<CompilerConfig>\n): CompilerConfig => ({\n  /**\n   * Indicates if the compiler should be enabled\n   */\n  enabled: customConfiguration?.enabled ?? COMPILER_ENABLED,\n\n  /**\n   * Prefix for the extracted dictionary keys\n   */\n  dictionaryKeyPrefix:\n    customConfiguration?.dictionaryKeyPrefix ?? COMPILER_DICTIONARY_KEY_PREFIX,\n\n  /**\n   * Pattern to traverse the code to optimize.\n   *\n   * @deprecated use `build.traversePattern` instead\n   */\n  transformPattern: customConfiguration?.transformPattern,\n\n  /**\n   * Pattern to exclude from the optimization.\n   *\n   * @deprecated use `build.traversePattern` instead\n   */\n  excludePattern: customConfiguration?.excludePattern,\n\n  /**\n   * Defines the output files path. Replaces `outputDir`.\n   *\n   * - `./` paths are resolved relative to the component directory.\n   * - `/` paths are resolved relative to the project root (`baseDir`).\n   *\n   * - Including the `{{locale}}` variable in the path will trigger the generation of separate dictionaries per locale.\n   *\n   * @example:\n   * ```ts\n   * {\n   *   // Create Multilingual .content.ts files close to the component\n   *   output: ({ fileName, extension }) => `./${fileName}${extension}`,\n   *\n   *   // output: './{{fileName}}{{extension}}', // Equivalent using template string\n   * }\n   * ```\n   *\n   * ```ts\n   * {\n   *   // Create centralize per-locale JSON at the root of the project\n   *   output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,\n   *\n   *   // output: '/locales/{{locale}}/{{key}}.content.json', // Equivalent using template string\n   * }\n   * ```\n   *\n   * ```ts\n   * {\n   *   // Create per-locale JSON files with locale-specific output paths\n   *   output: {\n   *     en: ({ fileName, locale }) => `${fileName}.${locale}.content.json`,\n   *     fr: '{{fileName}}.{{locale}}.content.json',\n   *     es: false, // skip this locale\n   *   },\n   * }\n   * ```\n   *\n   * Variable list:\n   *   - `fileName`: The name of the file.\n   *   - `key`: The key of the content.\n   *   - `locale`: The locale of the content.\n   *   - `extension`: The extension of the file.\n   *   - `componentFileName`: The name of the component file.\n   *   - `componentExtension`: The extension of the component file.\n   *   - `format`: The format of the dictionary.\n   *   - `componentFormat`: The format of the component dictionary.\n   *   - `componentDirPath`: The directory path of the component.\n   */\n  output: customConfiguration?.output,\n\n  /**\n   * Indicates if the metadata should be saved in the file.\n   *\n   * If true, the compiler will not save the metadata of the dictionaries.\n   *\n   * If `true`:\n   *\n   * ```json\n   * {\n   *   \"key\": \"value\"\n   * }\n   * ```\n   *\n   * If `false`:\n   *\n   * ```json\n   * {\n   *   \"key\": \"value\",\n   *   \"content\": {\n   *      \"key\": \"value\"\n   *   }\n   * }\n   * ```\n   *\n   * Default: `false`\n   *\n   * Note: Useful if used with loadJSON plugin\n   */\n  noMetadata: customConfiguration?.noMetadata ?? COMPILER_NO_METADATA,\n\n  /**\n   * Indicates if the components should be saved after being transformed.\n   */\n  saveComponents:\n    customConfiguration?.saveComponents ?? COMPILER_SAVE_COMPONENTS,\n});\n\n/**\n * Build the `dictionary` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied dictionary config.\n * @returns A fully-defaulted {@link DictionaryConfig}.\n */\nconst buildDictionaryFields = (\n  customConfiguration?: Partial<DictionaryConfig>\n): DictionaryConfig => {\n  const contentAutoTransformation =\n    customConfiguration?.contentAutoTransformation ??\n    CONTENT_AUTO_TRANSFORMATION;\n\n  return {\n    /**\n     * Indicate how the dictionary should be filled using AI.\n     *\n     * Default: `true`\n     *\n     * - If `true`, will consider the `compiler.output` field.\n     * - If `false`, will skip the fill process.\n     *\n     * - `./` paths are resolved relative to the component directory.\n     * - `/` paths are resolved relative to the project root (`baseDir`).\n     *\n     * - If includes `{{locale}}` variable in the path, will trigger the generation of separate dictionaries per locale.\n     *\n     * Example:\n     * ```ts\n     * {\n     *   // Create Multilingual .content.ts files close to the component\n     *   fill: ({ fileName, extension }) => `./${fileName}${extension}`,\n     *\n     *   // fill: './{{fileName}}{{extension}}', // Equivalent using template string\n     * }\n     * ```\n     *\n     * ```ts\n     * {\n     *   // Create centralize per-locale JSON at the root of the project\n     *   fill: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,\n     *\n     *   // fill: '/locales/{{locale}}/{{key}}.content.json', // Equivalent using template string\n     * }\n     * ```\n     *\n     * ```ts\n     * {\n     *   // Create custom output based on the locale\n     *   fill: {\n     *     en: ({ key }) => `/locales/en/${key}.content.json`,\n     *     fr: '/locales/fr/{{key}}.content.json',\n     *     es: false,\n     *     de: true,\n     *   },\n     * }\n     * ```\n     *\n     *\n     * Variable list:\n     *   - `fileName`: The name of the file.\n     *   - `key`: The key of the content.\n     *   - `locale`: The locale of the content.\n     *   - `extension`: The extension of the file.\n     *   - `componentFileName`: The name of the component file.\n     *   - `componentExtension`: The extension of the component file.\n     *   - `format`: The format of the dictionary.\n     *   - `componentFormat`: The format of the component dictionary.\n     *   - `componentDirPath`: The directory path of the component.\n     */\n    fill: customConfiguration?.fill ?? FILL,\n\n    /**\n     * Indicates if the content of the dictionary should be automatically transformed.\n     *\n     * Default: `false`\n     */\n    contentAutoTransformation:\n      typeof contentAutoTransformation === 'object'\n        ? {\n            markdown: contentAutoTransformation.markdown ?? false,\n            html: contentAutoTransformation.html ?? false,\n            insertion: contentAutoTransformation.insertion ?? false,\n          }\n        : contentAutoTransformation,\n\n    /**\n     * The location of the dictionary.\n     *\n     * Default: `\"local\"`\n     */\n    location: customConfiguration?.location ?? LOCATION,\n\n    /**\n     * Transform the dictionary in a per-locale dictionary.\n     * Each field declared in a per-locale dictionary will be transformed in a translation node.\n     * If missing, the dictionary will be treated as a multilingual dictionary.\n     */\n    locale: customConfiguration?.locale,\n\n    /**\n     * The title of the dictionary.\n     */\n    title: customConfiguration?.title,\n\n    /**\n     * The description of the dictionary.\n     */\n    description: customConfiguration?.description,\n\n    /**\n     * Tags to categorize the dictionaries.\n     */\n    tags: customConfiguration?.tags,\n\n    /**\n     * The priority of the dictionary.\n     */\n    priority: customConfiguration?.priority,\n\n    /**\n     * Indicates the mode of import to use for the dictionary.\n     *\n     * Available modes:\n     * - \"static\": The dictionaries are imported statically.\n     * - \"dynamic\": The dictionaries are imported dynamically in a synchronous component using the suspense API.\n     * - \"live\": The dictionaries are imported dynamically using the live sync API.\n     *\n     * Default: `\"static\"`\n     */\n    importMode: customConfiguration?.importMode ?? IMPORT_MODE,\n\n    /**\n     * The default message format for all dictionaries in the project.\n     *\n     * Default: 'intlayer'\n     */\n    format: customConfiguration?.format,\n  };\n};\n\n// ---------------------------------------------------------------------------\n// Main export\n// ---------------------------------------------------------------------------\n\n/**\n * Build the complete Intlayer configuration by merging user-supplied values\n * with defaults.\n *\n * Internally this function:\n * 1. Calls {@link buildBrowserConfiguration} to produce the browser-safe\n *    subset (internationalization, routing, editor public fields, log, metadata).\n * 2. Extends the result with full server-side fields:\n *    - `internationalization` — adds `requiredLocales` and `strictMode`.\n *    - `editor` — adds `clientId` and `clientSecret`.\n *    - `log` — adds custom log functions.\n *    - `system`, `content`, `ai`, `build`, `compiler`, `dictionary`.\n *\n * @param customConfiguration - Optional user-supplied configuration object.\n * @param baseDir - Project root directory. Defaults to `process.cwd()`.\n * @param logFunctions - Optional custom logging functions.\n * @returns A fully-built {@link IntlayerConfig}.\n */\nexport const buildConfigurationFields = (\n  customConfiguration?: CustomIntlayerConfig,\n  baseDir?: string,\n  logFunctions?: LogFunctions\n): IntlayerConfig => {\n  if (customConfiguration) {\n    const result = intlayerConfigSchema.safeParse(customConfiguration);\n\n    if (!result.success) {\n      const logError = logFunctions?.error ?? console.error;\n\n      for (const issue of result.error.issues) {\n        logError(`${issue.path.join('.')}: ${issue.message}`);\n      }\n    }\n  }\n\n  // build browser-safe config (shared defaults, no Node.js deps)\n  const browserConfig = buildBrowserConfiguration(customConfiguration);\n\n  // extend shared fields with server-only additions\n  const internationalizationConfig = buildInternationalizationFields(\n    customConfiguration?.internationalization\n  );\n\n  const editorConfig = buildEditorFields(customConfiguration?.editor);\n\n  const logConfig = buildLogFields(customConfiguration?.log, logFunctions);\n\n  // build server-only fields\n  const systemConfig = buildSystemFields(baseDir, customConfiguration?.system);\n\n  const contentConfig = buildContentFields(\n    systemConfig,\n    customConfiguration?.content\n  );\n\n  storedConfiguration = {\n    // Shared browser fields\n    routing: browserConfig.routing,\n    // Full (extended) shared fields\n    internationalization: internationalizationConfig,\n    editor: editorConfig,\n    analytics: buildAnalyticsFields(\n      customConfiguration?.analytics,\n      isPackageInstalled(ANALYTICS_PACKAGE_NAME, systemConfig.baseDir)\n    ),\n    log: logConfig,\n    // Server-only fields\n    system: systemConfig,\n    content: contentConfig,\n    ai: buildAiFields(customConfiguration?.ai),\n    build: buildBuildFields(customConfiguration?.build),\n    compiler: buildCompilerFields(customConfiguration?.compiler),\n    dictionary: buildDictionaryFields(customConfiguration?.dictionary),\n    plugins: customConfiguration?.plugins,\n    schemas: customConfiguration?.schemas,\n  } as IntlayerConfig;\n\n  return storedConfiguration;\n};\n"],"mappings":"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"}

package/dist/esm/defaultValues/analytics.mjs

@@ -1,9 +1,10 @@
 //#region src/defaultValues/analytics.ts
 /**
 * Default values for the `analytics` configuration block.
-* Analytics is strictly opt-in — disabled unless the user enables it.
+* Analytics is opt-out — enabled unless the user disables it, and only
+* effective once the optional `@intlayer/analytics` package is installed.
 */
-const ANALYTICS_ENABLED = false;
+const ANALYTICS_ENABLED = true;
 const ANALYTICS_FLUSH_INTERVAL = 2e4;
 const ANALYTICS_SAMPLE_RATE = 1;
 

package/dist/esm/defaultValues/analytics.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.mjs","names":[],"sources":["../../../src/defaultValues/analytics.ts"],"sourcesContent":["/**\n * Default values for the `analytics` configuration block.\n * Analytics is strictly opt-in — disabled unless the user enables it.\n */\nexport const ANALYTICS_ENABLED = false;\nexport const ANALYTICS_FLUSH_INTERVAL = 20_000;\nexport const ANALYTICS_SAMPLE_RATE = 1;\n"],"mappings":";;;;;AAIA,MAAa,oBAAoB;AACjC,MAAa,2BAA2B;AACxC,MAAa,wBAAwB"}
+{"version":3,"file":"analytics.mjs","names":[],"sources":["../../../src/defaultValues/analytics.ts"],"sourcesContent":["/**\n * Default values for the `analytics` configuration block.\n * Analytics is opt-out — enabled unless the user disables it, and only\n * effective once the optional `@intlayer/analytics` package is installed.\n */\nexport const ANALYTICS_ENABLED = true;\nexport const ANALYTICS_FLUSH_INTERVAL = 20_000;\nexport const ANALYTICS_SAMPLE_RATE = 1;\n"],"mappings":";;;;;;AAKA,MAAa,oBAAoB;AACjC,MAAa,2BAA2B;AACxC,MAAa,wBAAwB"}

package/dist/esm/envVars/envVars.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"envVars.mjs","names":[],"sources":["../../../src/envVars/envVars.ts"],"sourcesContent":["import type { IntlayerConfig } from '@intlayer/types/config';\n\n/**\n * Converts a camelCase node-type string to SCREAMING_SNAKE_CASE so that\n * the generated env-var name matches what the plugin source files check.\n *\n * @example\n * toScreamingSnakeCase('reactNode')  // 'REACT_NODE'\n * toScreamingSnakeCase('markdown')   // 'MARKDOWN'\n */\nconst toScreamingSnakeCase = (str: string): string =>\n  str\n    .replace(/([A-Z])/g, '_$1')\n    .toUpperCase()\n    .replace(/^_/, ''); // strip any leading underscore\n\n/**\n * Converts a list of unused NodeType keys into env-var definitions.\n * Set to `\"false\"` so bundlers can eliminate the corresponding plugin code.\n *\n * @example\n * formatNodeTypeToEnvVar(['enumeration'])\n * // { 'INTLAYER_NODE_TYPE_ENUMERATION': '\"false\"' }\n *\n * formatNodeTypeToEnvVar(['reactNode'], (k) => `process.env.${k}`, (v) => `\"${v}\"`)\n * // { 'process.env.INTLAYER_NODE_TYPE_REACT_NODE': '\"false\"' }\n */\nexport const formatNodeTypeToEnvVar = (\n  nodeTypes: string[],\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> =>\n  nodeTypes.reduce(\n    (acc, nodeType) => {\n      acc[wrapKey(`INTLAYER_NODE_TYPE_${toScreamingSnakeCase(nodeType)}`)] =\n        wrapValue('false');\n      return acc;\n    },\n    {} as Record<string, string>\n  );\n\n/**\n * Returns the env-var definition disabling the dictionary-selector resolution\n * path (collections, variants) when no built dictionary declares\n * a qualifier. Set to `\"false\"` so bundlers can dead-code-eliminate the\n * selector branch in `getIntlayer` / `useIntlayer`.\n *\n * Emits nothing when selectors are used, leaving the runtime default in place.\n *\n * @example\n * formatDictionarySelectorEnvVar(false)\n * // { INTLAYER_DICTIONARY_SELECTOR: '\"false\"' }\n *\n * formatDictionarySelectorEnvVar(true)\n * // {}\n *\n * formatDictionarySelectorEnvVar(false, (k) => `process.env.${k}`, (v) => `\"${v}\"`)\n * // { 'process.env.INTLAYER_DICTIONARY_SELECTOR': '\"false\"' }\n */\nexport const formatDictionarySelectorEnvVar = (\n  hasDictionarySelector: boolean,\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> =>\n  hasDictionarySelector\n    ? {}\n    : { [wrapKey('INTLAYER_DICTIONARY_SELECTOR')]: wrapValue('false') };\n\n/**\n * Returns the env-var definition selecting the local `nest()` resolver, which\n * reads the nest targets the optimizer attached to each dictionary instead of\n * looking them up in the global registry.\n *\n * Emit it only when the optimize transform actually runs, since it is that\n * transform which injects the attachment. Setting it to `\"true\"` lets bundlers\n * dead-code-eliminate the registry-based resolver, and with it the\n * `@intlayer/dictionaries-entry` import — which is what allows the dictionaries\n * entry to be emptied while nesting keeps working.\n *\n * @example\n * formatOptimizedNestingEnvVar(true)\n * // { INTLAYER_OPTIMIZED_NESTING: '\"true\"' }\n *\n * formatOptimizedNestingEnvVar(false)\n * // {}\n *\n * formatOptimizedNestingEnvVar(true, (k) => `process.env.${k}`, (v) => `\"${v}\"`)\n * // { 'process.env.INTLAYER_OPTIMIZED_NESTING': '\"true\"' }\n */\nexport const formatOptimizedNestingEnvVar = (\n  isOptimized: boolean,\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> =>\n  isOptimized\n    ? { [wrapKey('INTLAYER_OPTIMIZED_NESTING')]: wrapValue('true') }\n    : {};\n\n/**\n * Returns env-var definitions for the full Intlayer config to be injected at\n * build time. Allows bundlers to dead-code-eliminate unused routing modes,\n * rewrite logic, storage mechanisms, and editor code.\n *\n * @example\n * getConfigEnvVars(config)\n * // { INTLAYER_ROUTING_MODE: '\"prefix-no-default\"', INTLAYER_ROUTING_REWRITE_RULES: '\"false\"', ... }\n *\n * getConfigEnvVars(config, true)\n * // { 'process.env.INTLAYER_ROUTING_MODE': '\"prefix-no-default\"', ... }\n */\nexport const getConfigEnvVars = (\n  config: IntlayerConfig,\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> => {\n  const { routing, editor, analytics } = config;\n\n  const envVars: Record<string, string> = {\n    [wrapKey('INTLAYER_ROUTING_MODE')]: wrapValue(routing.mode),\n  };\n\n  // Only the two explicit states are emitted. An absent variable means the\n  // option was left unset, which `resolveProxyMode` reads as auto mode — it\n  // then defers to the configuration value available at runtime.\n  if (routing.enableProxy === false) {\n    envVars[wrapKey('INTLAYER_ROUTING_ENABLE_PROXY')] = wrapValue('false');\n  } else if (routing.enableProxy === true) {\n    envVars[wrapKey('INTLAYER_ROUTING_ENABLE_PROXY')] = wrapValue('true');\n  }\n\n  if (!routing.rewrite) {\n    envVars[wrapKey('INTLAYER_ROUTING_REWRITE_RULES')] = wrapValue('false');\n  }\n\n  if (!routing.domains || Object.keys(routing.domains).length === 0) {\n    envVars[wrapKey('INTLAYER_ROUTING_DOMAINS')] = wrapValue('false');\n  }\n\n  if (!routing.storage.cookies || routing.storage.cookies.length === 0) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_COOKIES')] = wrapValue('false');\n  }\n\n  if (\n    !routing.storage.localStorage ||\n    routing.storage.localStorage.length === 0\n  ) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_LOCALSTORAGE')] =\n      wrapValue('false');\n  }\n\n  if (\n    !routing.storage.sessionStorage ||\n    routing.storage.sessionStorage.length === 0\n  ) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_SESSIONSTORAGE')] =\n      wrapValue('false');\n  }\n\n  if (!routing.storage.headers || routing.storage.headers.length === 0) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_HEADERS')] = wrapValue('false');\n  }\n\n  if (editor?.enabled === false) {\n    envVars[wrapKey('INTLAYER_EDITOR_ENABLED')] = wrapValue('false');\n  }\n\n  // Analytics is strictly opt-in (`analytics.enabled === true`) and requires a\n  // project key (`editor.clientId`) for attribution. Otherwise, disable it so\n  // bundlers dead-code-eliminate the whole `@intlayer/analytics` integration\n  // (providers + node plugins).\n  if (analytics?.enabled !== true || !editor?.clientId) {\n    envVars[wrapKey('INTLAYER_ANALYTICS_ENABLED')] = wrapValue('false');\n  }\n\n  return envVars;\n};\n"],"mappings":";;;;;;;;;AAUA,MAAM,wBAAwB,QAC5B,IACG,QAAQ,YAAY,KAAK,CAAC,CAC1B,YAAY,CAAC,CACb,QAAQ,MAAM,EAAE;;;;;;;;;;;;AAarB,MAAa,0BACX,WACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UAE/B,UAAU,QACP,KAAK,aAAa;CACjB,IAAI,QAAQ,sBAAsB,qBAAqB,QAAQ,GAAG,KAChE,UAAU,OAAO;CACnB,OAAO;AACT,GACA,CAAC,CACH;;;;;;;;;;;;;;;;;;;AAoBF,MAAa,kCACX,uBACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UAE/B,wBACI,CAAC,IACD,GAAG,QAAQ,8BAA8B,IAAI,UAAU,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;AAuBtE,MAAa,gCACX,aACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UAE/B,cACI,GAAG,QAAQ,4BAA4B,IAAI,UAAU,MAAM,EAAE,IAC7D,CAAC;;;;;;;;;;;;;AAcP,MAAa,oBACX,QACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UACJ;CAC3B,MAAM,EAAE,SAAS,QAAQ,cAAc;CAEvC,MAAM,UAAkC,GACrC,QAAQ,uBAAuB,IAAI,UAAU,QAAQ,IAAI,EAC5D;CAKA,IAAI,QAAQ,gBAAgB,OAC1B,QAAQ,QAAQ,+BAA+B,KAAK,UAAU,OAAO;MAChE,IAAI,QAAQ,gBAAgB,MACjC,QAAQ,QAAQ,+BAA+B,KAAK,UAAU,MAAM;CAGtE,IAAI,CAAC,QAAQ,SACX,QAAQ,QAAQ,gCAAgC,KAAK,UAAU,OAAO;CAGxE,IAAI,CAAC,QAAQ,WAAW,OAAO,KAAK,QAAQ,OAAO,CAAC,CAAC,WAAW,GAC9D,QAAQ,QAAQ,0BAA0B,KAAK,UAAU,OAAO;CAGlE,IAAI,CAAC,QAAQ,QAAQ,WAAW,QAAQ,QAAQ,QAAQ,WAAW,GACjE,QAAQ,QAAQ,kCAAkC,KAAK,UAAU,OAAO;CAG1E,IACE,CAAC,QAAQ,QAAQ,gBACjB,QAAQ,QAAQ,aAAa,WAAW,GAExC,QAAQ,QAAQ,uCAAuC,KACrD,UAAU,OAAO;CAGrB,IACE,CAAC,QAAQ,QAAQ,kBACjB,QAAQ,QAAQ,eAAe,WAAW,GAE1C,QAAQ,QAAQ,yCAAyC,KACvD,UAAU,OAAO;CAGrB,IAAI,CAAC,QAAQ,QAAQ,WAAW,QAAQ,QAAQ,QAAQ,WAAW,GACjE,QAAQ,QAAQ,kCAAkC,KAAK,UAAU,OAAO;CAG1E,IAAI,QAAQ,YAAY,OACtB,QAAQ,QAAQ,yBAAyB,KAAK,UAAU,OAAO;CAOjE,IAAI,WAAW,YAAY,QAAQ,CAAC,QAAQ,UAC1C,QAAQ,QAAQ,4BAA4B,KAAK,UAAU,OAAO;CAGpE,OAAO;AACT"}
+{"version":3,"file":"envVars.mjs","names":[],"sources":["../../../src/envVars/envVars.ts"],"sourcesContent":["import type { IntlayerConfig } from '@intlayer/types/config';\n\n/**\n * Converts a camelCase node-type string to SCREAMING_SNAKE_CASE so that\n * the generated env-var name matches what the plugin source files check.\n *\n * @example\n * toScreamingSnakeCase('reactNode')  // 'REACT_NODE'\n * toScreamingSnakeCase('markdown')   // 'MARKDOWN'\n */\nconst toScreamingSnakeCase = (str: string): string =>\n  str\n    .replace(/([A-Z])/g, '_$1')\n    .toUpperCase()\n    .replace(/^_/, ''); // strip any leading underscore\n\n/**\n * Converts a list of unused NodeType keys into env-var definitions.\n * Set to `\"false\"` so bundlers can eliminate the corresponding plugin code.\n *\n * @example\n * formatNodeTypeToEnvVar(['enumeration'])\n * // { 'INTLAYER_NODE_TYPE_ENUMERATION': '\"false\"' }\n *\n * formatNodeTypeToEnvVar(['reactNode'], (k) => `process.env.${k}`, (v) => `\"${v}\"`)\n * // { 'process.env.INTLAYER_NODE_TYPE_REACT_NODE': '\"false\"' }\n */\nexport const formatNodeTypeToEnvVar = (\n  nodeTypes: string[],\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> =>\n  nodeTypes.reduce(\n    (acc, nodeType) => {\n      acc[wrapKey(`INTLAYER_NODE_TYPE_${toScreamingSnakeCase(nodeType)}`)] =\n        wrapValue('false');\n      return acc;\n    },\n    {} as Record<string, string>\n  );\n\n/**\n * Returns the env-var definition disabling the dictionary-selector resolution\n * path (collections, variants) when no built dictionary declares\n * a qualifier. Set to `\"false\"` so bundlers can dead-code-eliminate the\n * selector branch in `getIntlayer` / `useIntlayer`.\n *\n * Emits nothing when selectors are used, leaving the runtime default in place.\n *\n * @example\n * formatDictionarySelectorEnvVar(false)\n * // { INTLAYER_DICTIONARY_SELECTOR: '\"false\"' }\n *\n * formatDictionarySelectorEnvVar(true)\n * // {}\n *\n * formatDictionarySelectorEnvVar(false, (k) => `process.env.${k}`, (v) => `\"${v}\"`)\n * // { 'process.env.INTLAYER_DICTIONARY_SELECTOR': '\"false\"' }\n */\nexport const formatDictionarySelectorEnvVar = (\n  hasDictionarySelector: boolean,\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> =>\n  hasDictionarySelector\n    ? {}\n    : { [wrapKey('INTLAYER_DICTIONARY_SELECTOR')]: wrapValue('false') };\n\n/**\n * Returns the env-var definition selecting the local `nest()` resolver, which\n * reads the nest targets the optimizer attached to each dictionary instead of\n * looking them up in the global registry.\n *\n * Emit it only when the optimize transform actually runs, since it is that\n * transform which injects the attachment. Setting it to `\"true\"` lets bundlers\n * dead-code-eliminate the registry-based resolver, and with it the\n * `@intlayer/dictionaries-entry` import — which is what allows the dictionaries\n * entry to be emptied while nesting keeps working.\n *\n * @example\n * formatOptimizedNestingEnvVar(true)\n * // { INTLAYER_OPTIMIZED_NESTING: '\"true\"' }\n *\n * formatOptimizedNestingEnvVar(false)\n * // {}\n *\n * formatOptimizedNestingEnvVar(true, (k) => `process.env.${k}`, (v) => `\"${v}\"`)\n * // { 'process.env.INTLAYER_OPTIMIZED_NESTING': '\"true\"' }\n */\nexport const formatOptimizedNestingEnvVar = (\n  isOptimized: boolean,\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> =>\n  isOptimized\n    ? { [wrapKey('INTLAYER_OPTIMIZED_NESTING')]: wrapValue('true') }\n    : {};\n\n/**\n * Returns env-var definitions for the full Intlayer config to be injected at\n * build time. Allows bundlers to dead-code-eliminate unused routing modes,\n * rewrite logic, storage mechanisms, and editor code.\n *\n * @example\n * getConfigEnvVars(config)\n * // { INTLAYER_ROUTING_MODE: '\"prefix-no-default\"', INTLAYER_ROUTING_REWRITE_RULES: '\"false\"', ... }\n *\n * getConfigEnvVars(config, true)\n * // { 'process.env.INTLAYER_ROUTING_MODE': '\"prefix-no-default\"', ... }\n */\nexport const getConfigEnvVars = (\n  config: IntlayerConfig,\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> => {\n  const { routing, editor, analytics } = config;\n\n  const envVars: Record<string, string> = {\n    [wrapKey('INTLAYER_ROUTING_MODE')]: wrapValue(routing.mode),\n  };\n\n  // Only the two explicit states are emitted. An absent variable means the\n  // option was left unset, which `resolveProxyMode` reads as auto mode — it\n  // then defers to the configuration value available at runtime.\n  if (routing.enableProxy === false) {\n    envVars[wrapKey('INTLAYER_ROUTING_ENABLE_PROXY')] = wrapValue('false');\n  } else if (routing.enableProxy === true) {\n    envVars[wrapKey('INTLAYER_ROUTING_ENABLE_PROXY')] = wrapValue('true');\n  }\n\n  if (!routing.rewrite) {\n    envVars[wrapKey('INTLAYER_ROUTING_REWRITE_RULES')] = wrapValue('false');\n  }\n\n  if (!routing.domains || Object.keys(routing.domains).length === 0) {\n    envVars[wrapKey('INTLAYER_ROUTING_DOMAINS')] = wrapValue('false');\n  }\n\n  if (!routing.storage.cookies || routing.storage.cookies.length === 0) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_COOKIES')] = wrapValue('false');\n  }\n\n  if (\n    !routing.storage.localStorage ||\n    routing.storage.localStorage.length === 0\n  ) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_LOCALSTORAGE')] =\n      wrapValue('false');\n  }\n\n  if (\n    !routing.storage.sessionStorage ||\n    routing.storage.sessionStorage.length === 0\n  ) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_SESSIONSTORAGE')] =\n      wrapValue('false');\n  }\n\n  if (!routing.storage.headers || routing.storage.headers.length === 0) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_HEADERS')] = wrapValue('false');\n  }\n\n  if (editor?.enabled === false) {\n    envVars[wrapKey('INTLAYER_EDITOR_ENABLED')] = wrapValue('false');\n  }\n\n  // Analytics is opt-out: `analytics.enabled` defaults to `true` and is\n  // resolved to `false` when the optional `@intlayer/analytics` package is not\n  // installed. It also requires a project key (`editor.clientId`) for\n  // attribution. Otherwise, disable it so bundlers dead-code-eliminate the\n  // whole `@intlayer/analytics` integration (providers + node plugins).\n  if (analytics?.enabled !== true || !editor?.clientId) {\n    envVars[wrapKey('INTLAYER_ANALYTICS_ENABLED')] = wrapValue('false');\n  }\n\n  return envVars;\n};\n"],"mappings":";;;;;;;;;AAUA,MAAM,wBAAwB,QAC5B,IACG,QAAQ,YAAY,KAAK,CAAC,CAC1B,YAAY,CAAC,CACb,QAAQ,MAAM,EAAE;;;;;;;;;;;;AAarB,MAAa,0BACX,WACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UAE/B,UAAU,QACP,KAAK,aAAa;CACjB,IAAI,QAAQ,sBAAsB,qBAAqB,QAAQ,GAAG,KAChE,UAAU,OAAO;CACnB,OAAO;AACT,GACA,CAAC,CACH;;;;;;;;;;;;;;;;;;;AAoBF,MAAa,kCACX,uBACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UAE/B,wBACI,CAAC,IACD,GAAG,QAAQ,8BAA8B,IAAI,UAAU,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;AAuBtE,MAAa,gCACX,aACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UAE/B,cACI,GAAG,QAAQ,4BAA4B,IAAI,UAAU,MAAM,EAAE,IAC7D,CAAC;;;;;;;;;;;;;AAcP,MAAa,oBACX,QACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UACJ;CAC3B,MAAM,EAAE,SAAS,QAAQ,cAAc;CAEvC,MAAM,UAAkC,GACrC,QAAQ,uBAAuB,IAAI,UAAU,QAAQ,IAAI,EAC5D;CAKA,IAAI,QAAQ,gBAAgB,OAC1B,QAAQ,QAAQ,+BAA+B,KAAK,UAAU,OAAO;MAChE,IAAI,QAAQ,gBAAgB,MACjC,QAAQ,QAAQ,+BAA+B,KAAK,UAAU,MAAM;CAGtE,IAAI,CAAC,QAAQ,SACX,QAAQ,QAAQ,gCAAgC,KAAK,UAAU,OAAO;CAGxE,IAAI,CAAC,QAAQ,WAAW,OAAO,KAAK,QAAQ,OAAO,CAAC,CAAC,WAAW,GAC9D,QAAQ,QAAQ,0BAA0B,KAAK,UAAU,OAAO;CAGlE,IAAI,CAAC,QAAQ,QAAQ,WAAW,QAAQ,QAAQ,QAAQ,WAAW,GACjE,QAAQ,QAAQ,kCAAkC,KAAK,UAAU,OAAO;CAG1E,IACE,CAAC,QAAQ,QAAQ,gBACjB,QAAQ,QAAQ,aAAa,WAAW,GAExC,QAAQ,QAAQ,uCAAuC,KACrD,UAAU,OAAO;CAGrB,IACE,CAAC,QAAQ,QAAQ,kBACjB,QAAQ,QAAQ,eAAe,WAAW,GAE1C,QAAQ,QAAQ,yCAAyC,KACvD,UAAU,OAAO;CAGrB,IAAI,CAAC,QAAQ,QAAQ,WAAW,QAAQ,QAAQ,QAAQ,WAAW,GACjE,QAAQ,QAAQ,kCAAkC,KAAK,UAAU,OAAO;CAG1E,IAAI,QAAQ,YAAY,OACtB,QAAQ,QAAQ,yBAAyB,KAAK,UAAU,OAAO;CAQjE,IAAI,WAAW,YAAY,QAAQ,CAAC,QAAQ,UAC1C,QAAQ,QAAQ,4BAA4B,KAAK,UAAU,OAAO;CAGpE,OAAO;AACT"}

package/dist/esm/utils/index.mjs

@@ -12,6 +12,7 @@ import { extractErrorMessage } from "./extractErrorMessage.mjs";
 import { getHasDictionarySelector } from "./getDictionarySelectorUsage.mjs";
 import { getStorageAttributes } from "./getStorageAttributes.mjs";
 import { getUnusedNodeTypes, getUnusedNodeTypesAsync, getUsedNodeTypes, getUsedNodeTypesAsync } from "./getUsedNodeTypes.mjs";
+import { isPackageInstalled } from "./isPackageInstalled.mjs";
 import { logStack } from "./logStack.mjs";
 import { parseFilePathPattern, parseStringPattern } from "./parseFilePathPattern.mjs";
 import { assertPathWithin } from "./pathSecurity.mjs";
@@ -22,4 +23,4 @@ import { camelCaseToSentence } from "./stringFormatter/camelCaseToSentence.mjs";
 import { kebabCaseToCamelCase } from "./stringFormatter/kebabCaseToCamelCase.mjs";
 import { toLowerCamelCase } from "./stringFormatter/toLowerCamelCase.mjs";
 
-export { BUILT_CONFIG_KEYS, 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, 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/esm/utils/isPackageInstalled.mjs

@@ -0,0 +1,38 @@
+import { getProjectRequire } from "./ESMxCJSHelpers.mjs";
+
+//#region src/utils/isPackageInstalled.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.
+*/
+const isPackageInstalled = (packageName, baseDir) => {
+	try {
+		const projectRequire = getProjectRequire(baseDir);
+		try {
+			projectRequire.resolve(`${packageName}/package.json`);
+		} catch {
+			projectRequire.resolve(packageName);
+		}
+		return true;
+	} catch {
+		return false;
+	}
+};
+
+//#endregion
+export { isPackageInstalled };
+//# sourceMappingURL=isPackageInstalled.mjs.map

package/dist/esm/utils/isPackageInstalled.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"isPackageInstalled.mjs","names":[],"sources":["../../../src/utils/isPackageInstalled.ts"],"sourcesContent":["import { getProjectRequire } from './ESMxCJSHelpers';\n\n/**\n * Checks whether a package can be resolved from the user project.\n *\n * Used to detect optional companion packages (e.g. `@intlayer/analytics`)\n * whose mere presence in the dependency tree opts the project into a feature.\n *\n * Resolution is attempted on the package manifest first, so packages that\n * expose no root entry point — or whose entry point cannot be loaded in the\n * current module format — are still detected.\n *\n * Note: resolution starts at the project root, so a package installed only as\n * a transitive dependency may stay invisible under strict package managers\n * (pnpm). Callers should treat a `false` result as a default, not as a veto.\n *\n * @param packageName - Name of the package to look up, e.g. `'@intlayer/analytics'`.\n * @param baseDir - Directory the resolution starts from. Defaults to the current working directory.\n * @returns `true` when the package is installed in the project, `false` otherwise.\n */\nexport const isPackageInstalled = (\n  packageName: string,\n  baseDir?: string\n): boolean => {\n  try {\n    const projectRequire = getProjectRequire(baseDir);\n\n    try {\n      projectRequire.resolve(`${packageName}/package.json`);\n    } catch {\n      projectRequire.resolve(packageName);\n    }\n\n    return true;\n  } catch {\n    return false;\n  }\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAoBA,MAAa,sBACX,aACA,YACY;CACZ,IAAI;EACF,MAAM,iBAAiB,kBAAkB,OAAO;EAEhD,IAAI;GACF,eAAe,QAAQ,GAAG,YAAY,cAAc;EACtD,QAAQ;GACN,eAAe,QAAQ,WAAW;EACpC;EAEA,OAAO;CACT,QAAQ;EACN,OAAO;CACT;AACF"}

package/dist/types/configFile/buildBrowserConfiguration.d.ts

@@ -56,14 +56,21 @@ declare const buildEditorFields: (customConfiguration?: Partial<EditorConfig>) =
 /**
  * Build the analytics section of the Intlayer configuration.
  *
- * Analytics is strictly opt-in: `enabled` defaults to `false` and, even when
- * enabled, the runtime additionally requires a project key (`editor.clientId`)
- * for attribution before collecting anything.
+ * Analytics is opt-out: `enabled` defaults to `true`, so installing the
+ * optional `@intlayer/analytics` package is enough to turn it on. The runtime
+ * additionally requires a project key (`editor.clientId`) for attribution
+ * before collecting anything.
+ *
+ * An explicit `enabled` value always wins, so a project whose package manager
+ * hides the package from the project root can still opt back in.
  *
  * @param customConfiguration - Partial user-supplied analytics config.
+ * @param isPackageInstalled - Whether `@intlayer/analytics` is installed in the
+ *   project. Browser callers cannot resolve packages and pass `true`, letting
+ *   the runtime dynamic `import()` fail silently when it is absent.
  * @returns A fully-defaulted {@link AnalyticsConfig}.
  */
-declare const buildAnalyticsFields: (customConfiguration?: Partial<AnalyticsConfig>) => AnalyticsConfig;
+declare const buildAnalyticsFields: (customConfiguration?: Partial<AnalyticsConfig>, isPackageInstalled?: boolean) => AnalyticsConfig;
 /**
  * Build the log section of the Intlayer configuration.
  *

package/dist/types/configFile/buildBrowserConfiguration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildBrowserConfiguration.d.ts","names":[],"sources":["../../../src/configFile/buildBrowserConfiguration.ts"],"mappings":";;;;;;;;;KAqDY;EACV,sBAAsB,KACpB;EAGF,SAAS;EACT,QAAQ,KAAK;EACb,WAAW;EACX,KAAK,KAAK;;QAGJ;YACI;;IAER,kBAAkB;;;;;;;;;cAiBT,kCAA+B,sBACpB,QAAQ,gCAC7B;;;;;;;cA+CU,qBAAkB,sBACP,QAAQ,yBAC7B;;;;;;;;;;;;;;;;;;;cA4HU,oBAAiB,sBACN,QAAQ,kBAC7B;;;;;;;;;;;cAsIU,uBAAoB,sBACT,QAAQ,qBAC7B;;;;;;;;cA8BU,iBAAc,sBACH,QAAQ,YAAU,eACzB,iBACd;;;;;;;;;;;;;;;;;;;;;;;cAwDU,4BAAyB,eACrB,yBACd;;;;;;;;;;;;cAiCU,8BAA2B,QAC9B,mBACP"}
+{"version":3,"file":"buildBrowserConfiguration.d.ts","names":[],"sources":["../../../src/configFile/buildBrowserConfiguration.ts"],"mappings":";;;;;;;;;KAqDY;EACV,sBAAsB,KACpB;EAGF,SAAS;EACT,QAAQ,KAAK;EACb,WAAW;EACX,KAAK,KAAK;;QAGJ;YACI;;IAER,kBAAkB;;;;;;;;;cAiBT,kCAA+B,sBACpB,QAAQ,gCAC7B;;;;;;;cA+CU,qBAAkB,sBACP,QAAQ,yBAC7B;;;;;;;;;;;;;;;;;;;cA4HU,oBAAiB,sBACN,QAAQ,kBAC7B;;;;;;;;;;;;;;;;;;cA6IU,uBAAoB,sBACT,QAAQ,kBAAgB,iCAE7C;;;;;;;;cA+BU,iBAAc,sBACH,QAAQ,YAAU,eACzB,iBACd;;;;;;;;;;;;;;;;;;;;;;;cAwDU,4BAAyB,eACrB,yBACd;;;;;;;;;;;;cAiCU,8BAA2B,QAC9B,mBACP"}

package/dist/types/configFile/buildConfigurationFields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildConfigurationFields.d.ts","names":[],"sources":["../../../src/configFile/buildConfigurationFields.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;cAywBa,2BAAwB,sBACb,sBAAoB,kBAC1B,eACD,iBACd"}
+{"version":3,"file":"buildConfigurationFields.d.ts","names":[],"sources":["../../../src/configFile/buildConfigurationFields.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;cA+wBa,2BAAwB,sBACb,sBAAoB,kBAC1B,eACD,iBACd"}

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

@@ -1,9 +1,10 @@
 //#region src/defaultValues/analytics.d.ts
 /**
  * Default values for the `analytics` configuration block.
- * Analytics is strictly opt-in — disabled unless the user enables it.
+ * Analytics is opt-out — enabled unless the user disables it, and only
+ * effective once the optional `@intlayer/analytics` package is installed.
  */
-declare const ANALYTICS_ENABLED = false;
+declare const ANALYTICS_ENABLED = true;
 declare const ANALYTICS_FLUSH_INTERVAL = 20000;
 declare const ANALYTICS_SAMPLE_RATE = 1;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"analytics.d.ts","names":[],"sources":["../../../src/defaultValues/analytics.ts"],"mappings":";;;;;cAIa;cACA;cACA"}
+{"version":3,"file":"analytics.d.ts","names":[],"sources":["../../../src/defaultValues/analytics.ts"],"mappings":";;;;;;cAKa;cACA;cACA"}

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.3",
+  "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": [
@@ -177,7 +177,7 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/types": "9.3.3",
+    "@intlayer/types": "9.4.0-canary.0",
     "defu": "6.1.7",
     "dotenv": "17.4.2",
     "esbuild": "0.28.2",