@eigenpal/docx-editor-i18n 1.0.0 → 1.0.1

package/README.md

@@ -80,6 +80,20 @@ import { locales } from '@eigenpal/docx-editor-i18n';
 
 > Importing `locales` pulls every locale into your bundle. For a smaller bundle, import only the ones you need by name; `sideEffects: false` lets the rest tree-shake.
 
+## Per-locale subpaths
+
+For apps that pick the locale at runtime, the named exports above don't tree-shake — the bundler can't know which locale wins, so it ships them all. Use the per-locale subpaths instead. Each one bundles a single locale (~30KB) and code-splits cleanly:
+
+```ts
+// Static — bundler ships only this locale's strings
+import pl from '@eigenpal/docx-editor-i18n/pl';
+
+// Dynamic — splits into its own chunk, loaded on demand
+const pl = (await import('@eigenpal/docx-editor-i18n/pl')).default;
+```
+
+Subpaths ship for every locale: `/en`, `/de`, `/he`, `/pl`, `/pt-BR`, `/tr`, `/zh-CN`. Each also exports its locale as a named binding (`import { pl } from '@eigenpal/docx-editor-i18n/pl'`) for callers that prefer non-default imports.
+
 ## Types
 
 ```ts

package/dist/de.d.mts

@@ -0,0 +1,33 @@
+/**
+ * @eigenpal/docx-editor-i18n/de
+ *
+ * German (`de`) — direct locale subpath for per-locale code-splitting.
+ *
+ * ```ts
+ * // Static — bundler ships only this locale's strings
+ * import de from '@eigenpal/docx-editor-i18n/de';
+ *
+ * // Dynamic — splits into its own chunk, loaded on demand
+ * const de = (await import('@eigenpal/docx-editor-i18n/de')).default;
+ * ```
+ *
+ * For multi-locale apps, prefer the per-locale subpaths over importing
+ * `locales` from the package root — `locales` pulls every locale into
+ * the bundle.
+ *
+ * @packageDocumentation
+ * @public
+ */
+import { PartialLocaleStrings } from './index.mjs';
+
+/**
+ * German (`de`) locale strings. Community-maintained; null leaves fall back to English.
+ *
+ * Identical content to the named `de` export from the package root;
+ * this subpath just lets bundlers code-split it.
+ *
+ * @public
+ */
+declare const de: PartialLocaleStrings;
+
+export { de, de as default };

package/dist/de.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @eigenpal/docx-editor-i18n/de
+ *
+ * German (`de`) — direct locale subpath for per-locale code-splitting.
+ *
+ * ```ts
+ * // Static — bundler ships only this locale's strings
+ * import de from '@eigenpal/docx-editor-i18n/de';
+ *
+ * // Dynamic — splits into its own chunk, loaded on demand
+ * const de = (await import('@eigenpal/docx-editor-i18n/de')).default;
+ * ```
+ *
+ * For multi-locale apps, prefer the per-locale subpaths over importing
+ * `locales` from the package root — `locales` pulls every locale into
+ * the bundle.
+ *
+ * @packageDocumentation
+ * @public
+ */
+import { PartialLocaleStrings } from './index.js';
+
+/**
+ * German (`de`) locale strings. Community-maintained; null leaves fall back to English.
+ *
+ * Identical content to the named `de` export from the package root;
+ * this subpath just lets bundlers code-split it.
+ *
+ * @public
+ */
+declare const de: PartialLocaleStrings;
+
+export { de, de as default };