@intlayer/config 8.7.6 → 8.7.8-canary.0

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

@@ -1 +1 @@
-{"version":3,"file":"buildBrowserConfiguration.mjs","names":[],"sources":["../../../src/configFile/buildBrowserConfiguration.ts"],"sourcesContent":["import type {\n  CustomIntlayerConfig,\n  CustomRoutingConfig,\n  EditorConfig,\n  InternationalizationConfig,\n  IntlayerConfig,\n  LogConfig,\n  LogFunctions,\n  RoutingConfig,\n} from '@intlayer/types/config';\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 { BASE_PATH, ROUTING_MODE, STORAGE } 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  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     * 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 * @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 ?? undefined,\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 ?? undefined,\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 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 { mode, prefix } = buildLogFields(customConfig?.log);\n\n  return {\n    internationalization: { locales, defaultLocale },\n    routing,\n    editor: editorPublic,\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    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  log: {\n    mode: config.log.mode,\n    prefix: config.log.prefix,\n  },\n});\n"],"mappings":";;;;;;;;;;;;;AAwEA,MAAa,mCACX,yBACgC;CAOhC,SAAS,qBAAqB,WAAW;CAWzC,iBACE,qBAAqB,mBACrB,qBAAqB,WACrB;CAUF,YAAY,qBAAqB;CAOjC,eAAe,qBAAqB;CACrC;;;;;;;AAQD,MAAa,sBACX,wBACkB;CAClB,MAAM,UAAU,qBAAqB,WAAW;AAEhD,QAAO;EAuBL,MAAM,qBAAqB;EAW3B,SAAS,qBAAqB,QAAQ;EAatC,UAAU,qBAAqB;EA6B/B,SAAS,qBAAqB;EAO9B,SAAS,qBAAqB;EAC/B;;;;;;;;;;;;AAaH,MAAa,qBACX,wBACiB;CACjB,MAAM,eAAe,qBAAqB;AAC1C,QAAO;EAQL,gBAAgB,qBAAqB;EASrC,WAAW,qBAAqB;EAKhC,QAAQ,qBAAqB;EAO7B,YAAY,qBAAqB;EAMjC,MAAM,qBAAqB;EAsB3B,SAAS,qBAAqB;EAW9B,UAAU,qBAAqB,YAAY;EAW3C,cAAc,qBAAqB,gBAAgB;EAYnD,4BACE,qBAAqB;EAWvB,UAAU,qBAAqB;EAO/B;EAOA,aACE,qBAAqB,eAAe,oBAAoB;EAC3D;;;;;;;;;AAUH,MAAa,kBACX,qBACA,kBACe;CAUf,MAAM,qBAAqB;CAS3B,QAAQ,qBAAqB,UAAU;CAKvC,OAAO,cAAc;CACrB,KAAK,cAAc;CACnB,MAAM,cAAc;CACpB,MAAM,cAAc;CACrB;;;;;;;;;;;;;;;;;;;;;;;AA4BD,MAAa,6BACX,iBAC0B;CAC1B,MAAM,EAAE,SAAS,kBAAkB,gCACjC,cAAc,qBACf;CACD,MAAM,UAAU,mBAAmB,cAAc,QAAQ;CACzD,MAAM,EACJ,UAAU,WACV,cAAc,eACd,GAAG,iBACD,kBAAkB,cAAc,OAAO;CAC3C,MAAM,EAAE,MAAM,WAAW,eAAe,cAAc,IAAI;AAE1D,QAAO;EACL,sBAAsB;GAAE;GAAS;GAAe;EAChD;EACA,QAAQ;EACR,KAAK;GAAE;GAAM;GAAQ;EACtB;;;;;;;;;;;;;AAcH,MAAa,+BACX,YAC2B;CAC3B,sBAAsB;EACpB,SAAS,OAAO,qBAAqB;EACrC,eAAe,OAAO,qBAAqB;EAC5C;CACD,SAAS;EACP,MAAM,OAAO,QAAQ;EACrB,SAAS,OAAO,QAAQ;EACxB,UAAU,OAAO,QAAQ;EACzB,SAAS,OAAO,QAAQ;EACzB;CACD,QAAQ;EACN,gBAAgB,OAAO,OAAO;EAC9B,WAAW,OAAO,OAAO;EACzB,QAAQ,OAAO,OAAO;EACtB,YAAY,OAAO,OAAO;EAC1B,MAAM,OAAO,OAAO;EACpB,SAAS,OAAO,OAAO;EACvB,4BAA4B,OAAO,OAAO;EAC1C,UAAU,OAAO,OAAO;EACxB,cAAc,OAAO,OAAO;EAC5B,aAAa,OAAO,OAAO;EAC5B;CACD,KAAK;EACH,MAAM,OAAO,IAAI;EACjB,QAAQ,OAAO,IAAI;EACpB;CACF"}
+{"version":3,"file":"buildBrowserConfiguration.mjs","names":[],"sources":["../../../src/configFile/buildBrowserConfiguration.ts"],"sourcesContent":["import type {\n  CustomIntlayerConfig,\n  CustomRoutingConfig,\n  EditorConfig,\n  InternationalizationConfig,\n  IntlayerConfig,\n  LogConfig,\n  LogFunctions,\n  RoutingConfig,\n} from '@intlayer/types/config';\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 { BASE_PATH, ROUTING_MODE, STORAGE } 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  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     * 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 * @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 ?? undefined,\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 ?? undefined,\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 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 { mode, prefix } = buildLogFields(customConfig?.log);\n\n  return {\n    internationalization: { locales, defaultLocale },\n    routing,\n    editor: editorPublic,\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    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  log: {\n    mode: config.log.mode,\n    prefix: config.log.prefix,\n  },\n});\n"],"mappings":";;;;;;;;;;;;;AAwEA,MAAa,mCACX,yBACgC;;;;;;;CAOhC,SAAS,qBAAqB,WAAW;;;;;;;;;;CAWzC,iBACE,qBAAqB,mBACrB,qBAAqB,WACrB;;;;;;;;;CAUF,YAAY,qBAAqB;;;;;;CAOjC,eAAe,qBAAqB;CACrC;;;;;;;AAQD,MAAa,sBACX,wBACkB;CAClB,MAAM,UAAU,qBAAqB,WAAW;AAEhD,QAAO;;;;;;;;;;;;;;;;;;;;;;;EAuBL,MAAM,qBAAqB;;;;;;;;;;EAW3B,SAAS,qBAAqB,QAAQ;;;;;;;;;;;;EAatC,UAAU,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6B/B,SAAS,qBAAqB;;;;;;EAO9B,SAAS,qBAAqB;EAC/B;;;;;;;;;;;;AAaH,MAAa,qBACX,wBACiB;CACjB,MAAM,eAAe,qBAAqB;AAC1C,QAAO;;;;;;;;EAQL,gBAAgB,qBAAqB;;;;;;;;EASrC,WAAW,qBAAqB;;;;EAKhC,QAAQ,qBAAqB;;;;;;EAO7B,YAAY,qBAAqB;;;;;EAMjC,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;EAsB3B,SAAS,qBAAqB;;;;;;;;;;EAW9B,UAAU,qBAAqB,YAAY;;;;;;;;;;EAW3C,cAAc,qBAAqB,gBAAgB;;;;;;;;;;;EAYnD,4BACE,qBAAqB;;;;;;;;;EAWvB,UAAU,qBAAqB;;;;;;EAO/B;;;;;;EAOA,aACE,qBAAqB,eAAe,oBAAoB;EAC3D;;;;;;;;;AAUH,MAAa,kBACX,qBACA,kBACe;;;;;;;;;;CAUf,MAAM,qBAAqB;;;;;;;;CAS3B,QAAQ,qBAAqB,UAAU;;;;CAKvC,OAAO,cAAc;CACrB,KAAK,cAAc;CACnB,MAAM,cAAc;CACpB,MAAM,cAAc;CACrB;;;;;;;;;;;;;;;;;;;;;;;AA4BD,MAAa,6BACX,iBAC0B;CAC1B,MAAM,EAAE,SAAS,kBAAkB,gCACjC,cAAc,qBACf;CACD,MAAM,UAAU,mBAAmB,cAAc,QAAQ;CACzD,MAAM,EACJ,UAAU,WACV,cAAc,eACd,GAAG,iBACD,kBAAkB,cAAc,OAAO;CAC3C,MAAM,EAAE,MAAM,WAAW,eAAe,cAAc,IAAI;AAE1D,QAAO;EACL,sBAAsB;GAAE;GAAS;GAAe;EAChD;EACA,QAAQ;EACR,KAAK;GAAE;GAAM;GAAQ;EACtB;;;;;;;;;;;;;AAcH,MAAa,+BACX,YAC2B;CAC3B,sBAAsB;EACpB,SAAS,OAAO,qBAAqB;EACrC,eAAe,OAAO,qBAAqB;EAC5C;CACD,SAAS;EACP,MAAM,OAAO,QAAQ;EACrB,SAAS,OAAO,QAAQ;EACxB,UAAU,OAAO,QAAQ;EACzB,SAAS,OAAO,QAAQ;EACzB;CACD,QAAQ;EACN,gBAAgB,OAAO,OAAO;EAC9B,WAAW,OAAO,OAAO;EACzB,QAAQ,OAAO,OAAO;EACtB,YAAY,OAAO,OAAO;EAC1B,MAAM,OAAO,OAAO;EACpB,SAAS,OAAO,OAAO;EACvB,4BAA4B,OAAO,OAAO;EAC1C,UAAU,OAAO,OAAO;EACxB,cAAc,OAAO,OAAO;EAC5B,aAAa,OAAO,OAAO;EAC5B;CACD,KAAK;EACH,MAAM,OAAO,IAAI;EACjB,QAAQ,OAAO,IAAI;EACpB;CACF"}

package/dist/esm/configFile/buildConfigurationFields.mjs

@@ -101,12 +101,55 @@ const buildContentFields = (systemConfig, customConfiguration) => {
 * @returns A fully-defaulted {@link AiConfig}.
 */
 const buildAiFields = (customConfiguration) => ({
+	/**
+	* AI configuration
+	*/
 	provider: customConfiguration?.provider,
+	/**
+	* API key
+	*/
 	apiKey: customConfiguration?.apiKey,
+	/**
+	* API model
+	*/
 	model: customConfiguration?.model,
+	/**
+	* Temperature
+	*/
 	temperature: customConfiguration?.temperature,
+	/**
+	* Application context
+	*
+	* Default: undefined
+	*
+	* The application context.
+	*
+	* Example: `'My application context'`
+	*
+	* 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").
+	*/
 	applicationContext: customConfiguration?.applicationContext,
+	/**
+	* Base URL for the AI API
+	*
+	* Default: undefined
+	*
+	* The base URL for the AI API.
+	*
+	* Example: `'http://localhost:5000'`
+	*
+	* Note: Can be used to point to a local, or custom AI API endpoint.
+	*/
 	baseURL: customConfiguration?.baseURL,
+	/**
+	* Data serialization
+	*
+	* Options:
+	* - "json": The industry standard. Highly reliable and structured, but consumes more tokens.
+	* - "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
+	*
+	* Default: `"json"`
+	*/
 	dataSerialization: customConfiguration?.dataSerialization
 });
 /**
@@ -116,15 +159,128 @@ const buildAiFields = (customConfiguration) => ({
 * @returns A fully-defaulted {@link BuildConfig}.
 */
 const buildBuildFields = (customConfiguration) => ({
+	/**
+	* Indicates the mode of the build
+	*
+	* Default: 'auto'
+	*
+	* If 'auto', the build will be enabled automatically when the application is built.
+	* If 'manual', the build will be set only when the build command is executed.
+	*
+	* Can be used to disable dictionaries build, for instance when execution on Node.js environment should be avoided.
+	*/
 	mode: customConfiguration?.mode ?? "auto",
+	/**
+	* Indicates if the build should be optimized
+	*
+	* Default: process.env.NODE_ENV === 'production'
+	*
+	* If true, the build will be optimized.
+	* If false, the build will not be optimized.
+	*
+	* Intlayer will replace all calls of dictionaries to optimize chunking. That way the final bundle will import only the dictionaries that are used.
+	* All imports will stay as static import to avoid async processing when loading the dictionaries.
+	*
+	* Note:
+	* - Intlayer will replace all call of `useIntlayer` with the defined mode by the `importMode` option.
+	* - Intlayer will replace all call of `getIntlayer` with `getDictionary`.
+	* - This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.
+	* - In most cases, "dynamic" will be used for React applications, "async" for Vue.js applications.
+	* - Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.
+	*/
 	optimize: customConfiguration?.optimize,
+	/**
+	* Indicates the mode of import to use for the dictionaries.
+	*
+	* Available modes:
+	* - "static": The dictionaries are imported statically.
+	*   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionary`.
+	* - "dynamic": The dictionaries are imported dynamically in a synchronous component using the suspense API.
+	*   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionaryDynamic`.
+	* - "live": The dictionaries are imported dynamically using the live sync API.
+	*   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionaryDynamic`.
+	*   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.
+	*
+	* Default: "static"
+	*
+	* By default, when a dictionary is loaded, it imports content for all locales as it's imported statically.
+	*
+	* Note:
+	* - Dynamic imports rely on Suspense and may slightly impact rendering performance.
+	* - If disabled all locales will be loaded at once, even if they are not used.
+	* - This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.
+	* - Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.
+	* - This option will be ignored if `optimize` is disabled.
+	* - 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.
+	* - The "live" allows to sync the dictionaries to the live sync server.
+	*
+	* @deprecated Use `dictionary.importMode` instead.
+	*/
 	importMode: customConfiguration?.importMode,
+	/**
+	* Minify the dictionaries to reduce the bundle size.
+	*
+	* Default: false
+	*
+	* Note:
+	* - This option will be ignored if `optimize` is disabled.
+	* - This option will be ignore if `editor.enabled` is true.
+	* - If there is edge cases where the minification is not working properly, the dictionary will be not minified.
+	*/
 	minify: customConfiguration?.minify ?? false,
+	/**
+	* Purge the unused keys in a dictionaries
+	*
+	* Default: false
+	*
+	* Note:
+	* - This option will be ignored if `optimize` is disabled.
+	* - This option will be ignored if `editor.enabled` is true.
+	*/
 	purge: customConfiguration?.purge ?? false,
+	/**
+	* Pattern to traverse the code to optimize.
+	*
+	* Allows to avoid to traverse the code that is not relevant to the optimization.
+	* Improve build performance.
+	*
+	* Default: ['**\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\/node_modules/**']
+	*
+	* Example: `['src/**\/*.{ts,tsx}', '../ui-library/**\/*.{ts,tsx}']`
+	*
+	* Note:
+	* - This option will be ignored if `optimize` is disabled.
+	* - Use glob pattern.
+	*/
 	traversePattern: customConfiguration?.traversePattern ?? TRAVERSE_PATTERN,
+	/**
+	* Output format of the dictionaries
+	*
+	* Can be set on large projects to improve build performance.
+	*
+	* Default: ['cjs', 'esm']
+	*
+	* The output format of the dictionaries. It can be either 'cjs' or 'esm'.
+	* - 'cjs': The dictionaries are outputted as CommonJS modules.
+	* - 'esm': The dictionaries are outputted as ES modules.
+	*/
 	outputFormat: customConfiguration?.outputFormat ?? OUTPUT_FORMAT,
+	/**
+	* Cache
+	*/
 	cache: customConfiguration?.cache ?? true,
+	/**
+	* Require function
+	*/
 	require: customConfiguration?.require,
+	/**
+	* Indicates if the build should check TypeScript types
+	*
+	* Default: `false`
+	*
+	* If true, the build will check TypeScript types and log errors.
+	* Note: This can slow down the build.
+	*/
 	checkTypes: customConfiguration?.checkTypes ?? false
 });
 /**
@@ -134,12 +290,108 @@ const buildBuildFields = (customConfiguration) => ({
 * @returns A fully-defaulted {@link CompilerConfig}.
 */
 const buildCompilerFields = (customConfiguration) => ({
+	/**
+	* Indicates if the compiler should be enabled
+	*/
 	enabled: customConfiguration?.enabled ?? true,
+	/**
+	* Prefix for the extracted dictionary keys
+	*/
 	dictionaryKeyPrefix: customConfiguration?.dictionaryKeyPrefix ?? "",
+	/**
+	* Pattern to traverse the code to optimize.
+	*
+	* @deprecated use `build.traversePattern` instead
+	*/
 	transformPattern: customConfiguration?.transformPattern,
+	/**
+	* Pattern to exclude from the optimization.
+	*
+	* @deprecated use `build.traversePattern` instead
+	*/
 	excludePattern: customConfiguration?.excludePattern,
+	/**
+	* Defines the output files path. Replaces `outputDir`.
+	*
+	* - `./` paths are resolved relative to the component directory.
+	* - `/` paths are resolved relative to the project root (`baseDir`).
+	*
+	* - Including the `{{locale}}` variable in the path will trigger the generation of separate dictionaries per locale.
+	*
+	* @example:
+	* ```ts
+	* {
+	*   // Create Multilingual .content.ts files close to the component
+	*   output: ({ fileName, extension }) => `./${fileName}${extension}`,
+	*
+	*   // output: './{{fileName}}{{extension}}', // Equivalent using template string
+	* }
+	* ```
+	*
+	* ```ts
+	* {
+	*   // Create centralize per-locale JSON at the root of the project
+	*   output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,
+	*
+	*   // output: '/locales/{{locale}}/{{key}}.content.json', // Equivalent using template string
+	* }
+	* ```
+	*
+	* ```ts
+	* {
+	*   // Create per-locale JSON files with locale-specific output paths
+	*   output: {
+	*     en: ({ fileName, locale }) => `${fileName}.${locale}.content.json`,
+	*     fr: '{{fileName}}.{{locale}}.content.json',
+	*     es: false, // skip this locale
+	*   },
+	* }
+	* ```
+	*
+	* Variable list:
+	*   - `fileName`: The name of the file.
+	*   - `key`: The key of the content.
+	*   - `locale`: The locale of the content.
+	*   - `extension`: The extension of the file.
+	*   - `componentFileName`: The name of the component file.
+	*   - `componentExtension`: The extension of the component file.
+	*   - `format`: The format of the dictionary.
+	*   - `componentFormat`: The format of the component dictionary.
+	*   - `componentDirPath`: The directory path of the component.
+	*/
 	output: customConfiguration?.output,
+	/**
+	* Indicates if the metadata should be saved in the file.
+	*
+	* If true, the compiler will not save the metadata of the dictionaries.
+	*
+	* If `true`:
+	*
+	* ```json
+	* {
+	*   "key": "value"
+	* }
+	* ```
+	*
+	* If `false`:
+	*
+	* ```json
+	* {
+	*   "key": "value",
+	*   "content": {
+	*      "key": "value"
+	*   }
+	* }
+	* ```
+	*
+	* Default: `false`
+	*
+	* Note: Useful if used with loadJSON plugin
+	*/
 	noMetadata: customConfiguration?.noMetadata ?? false,
+	/**
+	* Indicates if the components should be saved after being transformed.
+	*/
 	saveComponents: customConfiguration?.saveComponents ?? false
 });
 /**
@@ -151,18 +403,111 @@ const buildCompilerFields = (customConfiguration) => ({
 const buildDictionaryFields = (customConfiguration) => {
 	const contentAutoTransformation = customConfiguration?.contentAutoTransformation ?? false;
 	return {
+		/**
+		* Indicate how the dictionary should be filled using AI.
+		*
+		* Default: `true`
+		*
+		* - If `true`, will consider the `compiler.output` field.
+		* - If `false`, will skip the fill process.
+		*
+		* - `./` paths are resolved relative to the component directory.
+		* - `/` paths are resolved relative to the project root (`baseDir`).
+		*
+		* - If includes `{{locale}}` variable in the path, will trigger the generation of separate dictionaries per locale.
+		*
+		* Example:
+		* ```ts
+		* {
+		*   // Create Multilingual .content.ts files close to the component
+		*   fill: ({ fileName, extension }) => `./${fileName}${extension}`,
+		*
+		*   // fill: './{{fileName}}{{extension}}', // Equivalent using template string
+		* }
+		* ```
+		*
+		* ```ts
+		* {
+		*   // Create centralize per-locale JSON at the root of the project
+		*   fill: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,
+		*
+		*   // fill: '/locales/{{locale}}/{{key}}.content.json', // Equivalent using template string
+		* }
+		* ```
+		*
+		* ```ts
+		* {
+		*   // Create custom output based on the locale
+		*   fill: {
+		*     en: ({ key }) => `/locales/en/${key}.content.json`,
+		*     fr: '/locales/fr/{{key}}.content.json',
+		*     es: false,
+		*     de: true,
+		*   },
+		* }
+		* ```
+		*
+		*
+		* Variable list:
+		*   - `fileName`: The name of the file.
+		*   - `key`: The key of the content.
+		*   - `locale`: The locale of the content.
+		*   - `extension`: The extension of the file.
+		*   - `componentFileName`: The name of the component file.
+		*   - `componentExtension`: The extension of the component file.
+		*   - `format`: The format of the dictionary.
+		*   - `componentFormat`: The format of the component dictionary.
+		*   - `componentDirPath`: The directory path of the component.
+		*/
 		fill: customConfiguration?.fill ?? true,
+		/**
+		* Indicates if the content of the dictionary should be automatically transformed.
+		*
+		* Default: `false`
+		*/
 		contentAutoTransformation: typeof contentAutoTransformation === "object" ? {
 			markdown: contentAutoTransformation.markdown ?? false,
 			html: contentAutoTransformation.html ?? false,
 			insertion: contentAutoTransformation.insertion ?? false
 		} : contentAutoTransformation,
+		/**
+		* The location of the dictionary.
+		*
+		* Default: `"local"`
+		*/
 		location: customConfiguration?.location ?? "local",
+		/**
+		* Transform the dictionary in a per-locale dictionary.
+		* Each field declared in a per-locale dictionary will be transformed in a translation node.
+		* If missing, the dictionary will be treated as a multilingual dictionary.
+		*/
 		locale: customConfiguration?.locale,
+		/**
+		* The title of the dictionary.
+		*/
 		title: customConfiguration?.title,
+		/**
+		* The description of the dictionary.
+		*/
 		description: customConfiguration?.description,
+		/**
+		* Tags to categorize the dictionaries.
+		*/
 		tags: customConfiguration?.tags,
+		/**
+		* The priority of the dictionary.
+		*/
 		priority: customConfiguration?.priority,
+		/**
+		* Indicates the mode of import to use for the dictionary.
+		*
+		* Available modes:
+		* - "static": The dictionaries are imported statically.
+		* - "dynamic": The dictionaries are imported dynamically in a synchronous component using the suspense API.
+		* - "live": The dictionaries are imported dynamically using the live sync API.
+		*
+		* Default: `"static"`
+		*/
 		importMode: customConfiguration?.importMode ?? "static"
 	};
 };

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  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  buildBrowserConfiguration,\n  buildEditorFields,\n  buildInternationalizationFields,\n  buildLogFields,\n} from './buildBrowserConfiguration';\nimport { intlayerConfigSchema } from './configurationSchema';\n\nexport {\n  type BrowserIntlayerConfig,\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      absolutePath = requireFunction.resolve(pathInput, {\n        paths: [projectBaseDir],\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      absolutePath = requireFunction.resolve(pathInput, {\n        paths: [systemConfig.baseDir],\n      });\n    } catch {\n      try {\n        absolutePath = require.resolve(pathInput, {\n          paths: [systemConfig.baseDir],\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   * 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\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    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  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  buildBrowserConfiguration,\n  buildEditorFields,\n  buildInternationalizationFields,\n  buildLogFields,\n} from './buildBrowserConfiguration';\nimport { intlayerConfigSchema } from './configurationSchema';\n\nexport {\n  type BrowserIntlayerConfig,\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      absolutePath = requireFunction.resolve(pathInput, {\n        paths: [projectBaseDir],\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      absolutePath = requireFunction.resolve(pathInput, {\n        paths: [systemConfig.baseDir],\n      });\n    } catch {\n      try {\n        absolutePath = require.resolve(pathInput, {\n          paths: [systemConfig.baseDir],\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   * 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\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    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/configFile/loadConfigurationFile.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"loadConfigurationFile.mjs","names":[],"sources":["../../../src/configFile/loadConfigurationFile.ts"],"sourcesContent":["import type { CustomIntlayerConfig } from '@intlayer/types/config';\nimport {\n  type LoadExternalFileOptions,\n  loadExternalFileSync,\n} from '../loadExternalFile/loadExternalFile';\nimport { configESMxCJSRequire } from '../utils/ESMxCJSHelpers';\n\nconst getAliases = (\n  options?: Omit<LoadExternalFileOptions, 'configuration'>\n) => {\n  // Can fail if CJS hot removed from the module (e.g. in Tanstack Start + Nitro)\n  try {\n    return {\n      ...options?.aliases,\n      // Replace intlayer with @intlayer/types to avoid circular dependency intlayer -> @intlayer/config -> intlayer\n      intlayer: configESMxCJSRequire.resolve('@intlayer/types'),\n    };\n  } catch {\n    return options?.aliases;\n  }\n};\n\n/**\n * Load the configuration file from the given path\n * Example of configuration file: intlayer.config.js\n *\n * Accepts JSON, JS, MJS and TS files as configuration\n */\nexport const loadConfigurationFile = (\n  configFilePath: string,\n  options?: Omit<LoadExternalFileOptions, 'configuration'>\n): CustomIntlayerConfig | undefined => {\n  const fileContent = loadExternalFileSync(configFilePath, {\n    ...options,\n    aliases: getAliases(options),\n  });\n\n  return fileContent;\n};\n"],"mappings":";;;;AAOA,MAAM,cACJ,YACG;AAEH,KAAI;AACF,SAAO;GACL,GAAG,SAAS;GAEZ,UAAU,qBAAqB,QAAQ,kBAAkB;GAC1D;SACK;AACN,SAAO,SAAS;;;;;;;;;AAUpB,MAAa,yBACX,gBACA,YACqC;AAMrC,QALoB,qBAAqB,gBAAgB;EACvD,GAAG;EACH,SAAS,WAAW,QAAQ;EAC7B,CAAC"}
+{"version":3,"file":"loadConfigurationFile.mjs","names":[],"sources":["../../../src/configFile/loadConfigurationFile.ts"],"sourcesContent":["import type { CustomIntlayerConfig } from '@intlayer/types/config';\nimport {\n  type LoadExternalFileOptions,\n  loadExternalFileSync,\n} from '../loadExternalFile/loadExternalFile';\nimport { configESMxCJSRequire } from '../utils/ESMxCJSHelpers';\n\nconst getAliases = (\n  options?: Omit<LoadExternalFileOptions, 'configuration'>\n) => {\n  // Can fail if CJS hot removed from the module (e.g. in Tanstack Start + Nitro)\n  try {\n    return {\n      ...options?.aliases,\n      // Replace intlayer with @intlayer/types to avoid circular dependency intlayer -> @intlayer/config -> intlayer\n      intlayer: configESMxCJSRequire.resolve('@intlayer/types'),\n    };\n  } catch {\n    return options?.aliases;\n  }\n};\n\n/**\n * Load the configuration file from the given path\n * Example of configuration file: intlayer.config.js\n *\n * Accepts JSON, JS, MJS and TS files as configuration\n */\nexport const loadConfigurationFile = (\n  configFilePath: string,\n  options?: Omit<LoadExternalFileOptions, 'configuration'>\n): CustomIntlayerConfig | undefined => {\n  const fileContent = loadExternalFileSync(configFilePath, {\n    ...options,\n    aliases: getAliases(options),\n  });\n\n  return fileContent;\n};\n"],"mappings":";;;;AAOA,MAAM,cACJ,YACG;AAEH,KAAI;AACF,SAAO;GACL,GAAG,SAAS;GAEZ,UAAU,qBAAqB,QAAQ,kBAAkB;GAC1D;SACK;AACN,SAAO,SAAS;;;;;;;;;AAUpB,MAAa,yBACX,gBACA,YACqC;AAMrC,QALoB,qBAAqB,gBAAgB;EACvD,GAAG;EACH,SAAS,WAAW,QAAQ;EAC7B,CAEiB"}

package/dist/esm/defaultValues/build.mjs

@@ -2,7 +2,7 @@
 const BUILD_MODE = "auto";
 const OPTIMIZE = void 0;
 const TRAVERSE_PATTERN = [
-	"**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}",
+	"**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte,astro}",
 	"!**/node_modules/**",
 	"!**/dist/**",
 	"!**/build/**",