@intlayer/config 9.3.1 → 9.3.3

package/dist/types/dictionaryPreload.d.ts

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

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

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

package/dist/types/extract/constants.d.ts

@@ -0,0 +1,11 @@
+//#region src/extract/constants.d.ts
+/**
+ * Attributes that should be extracted as translatable strings from JSX/HTML elements.
+ * This is the single source of truth shared across all Intlayer compiler packages
+ * (@intlayer/babel, @intlayer/vue-compiler, @intlayer/svelte-compiler, @intlayer/engine)
+ * and the `eslint-plugin-intlayer` `no-raw-text` rule.
+ */
+declare const ATTRIBUTES_TO_EXTRACT: readonly ['title', 'placeholder', 'alt', 'aria-label', 'label'];
+//#endregion
+export { ATTRIBUTES_TO_EXTRACT };
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/extract/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","names":[],"sources":["../../../src/extract/constants.ts"],"mappings":";;;;;;;cAMa"}

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

@@ -0,0 +1,3 @@
+import { ATTRIBUTES_TO_EXTRACT } from "./constants.js";
+import { shouldExtract } from "./shouldExtract.js";
+export { ATTRIBUTES_TO_EXTRACT, shouldExtract };

package/dist/types/extract/shouldExtract.d.ts

@@ -0,0 +1,15 @@
+//#region src/extract/shouldExtract.d.ts
+/**
+ * Checks whether the given text should be extracted as a translatable string.
+ *
+ * Filters out:
+ * - Empty strings
+ * - Emails
+ * - Single capitalized words (likely brand/proper nouns, e.g. "Intlayer")
+ * - Uncapitalized strings of 2 words or fewer (likely technical terms)
+ * - Dynamic content patterns like Vue bindings (`v-`) or object patterns (`{`)
+ */
+declare const shouldExtract: (text: string) => boolean;
+//#endregion
+export { shouldExtract };
+//# sourceMappingURL=shouldExtract.d.ts.map

package/dist/types/extract/shouldExtract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shouldExtract.d.ts","names":[],"sources":["../../../src/extract/shouldExtract.ts"],"mappings":";;;;;;;;;;;cAUa,gBAAa"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/config",
-  "version": "9.3.1",
+  "version": "9.3.3",
   "private": false,
   "description": "Retrieve Intlayer configurations and manage environment variables for both server-side and client-side environments.",
   "keywords": [
@@ -57,6 +57,11 @@
       "import": "./dist/esm/callers/index.mjs",
       "require": "./dist/cjs/callers/index.cjs"
     },
+    "./extract": {
+      "types": "./dist/types/extract/index.d.ts",
+      "import": "./dist/esm/extract/index.mjs",
+      "require": "./dist/cjs/extract/index.cjs"
+    },
     "./utils": {
       "types": "./dist/types/utils/index.d.ts",
       "require": "./dist/cjs/utils/index.cjs",
@@ -92,6 +97,11 @@
       "require": "./dist/cjs/defaultValues/index.cjs",
       "import": "./dist/esm/defaultValues/index.mjs"
     },
+    "./dictionaryPreload": {
+      "types": "./dist/types/dictionaryPreload.d.ts",
+      "require": "./dist/cjs/dictionaryPreload.cjs",
+      "import": "./dist/esm/dictionaryPreload.mjs"
+    },
     "./bundle": {
       "types": "./dist/types/bundle/index.d.ts",
       "require": "./dist/cjs/bundle/index.cjs",
@@ -116,6 +126,9 @@
       "utils": [
         "./dist/types/utils/index.d.ts"
       ],
+      "extract": [
+        "./dist/types/extract/index.d.ts"
+      ],
       "file": [
         "./dist/types/loadExternalFile/index.d.ts"
       ],
@@ -164,7 +177,7 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/types": "9.3.1",
+    "@intlayer/types": "9.3.3",
     "defu": "6.1.7",
     "dotenv": "17.4.2",
     "esbuild": "0.28.2",
@@ -179,7 +192,7 @@
     "rimraf": "6.1.3",
     "tsdown": "0.22.14",
     "typescript": "7.0.2",
-    "vitest": "4.1.10"
+    "vitest": "4.1.11"
   },
   "peerDependencies": {
     "react": ">=16.0.0"