inline-i18n-multi-next 0.6.0 → 0.8.0

package/README.md

@@ -15,7 +15,7 @@ npm install inline-i18n-multi-next
 | Entry point | Environment | Key exports |
 |---|---|---|
 | `inline-i18n-multi-next/server` | Server Components | `it`, `t`, `configureI18n`, `generateLocaleParams`, `createMetadata`, `getAlternates`, `createI18nMiddleware` |
-| `inline-i18n-multi-next/client` | Client Components | `LocaleProvider`, `useLocale`, `useT`, `it`, `T`, `RichText`, `useRichText`, `useLoadDictionaries`, `useDetectedLocale`, `registerFormatter`, `clearFormatters`, `detectLocale`, `configure`, `resetConfig` |
+| `inline-i18n-multi-next/client` | Client Components | `LocaleProvider`, `useLocale`, `useT`, `useScopedT`, `it`, `T`, `RichText`, `useRichText`, `useLoadDictionaries`, `useDetectedLocale`, `registerFormatter`, `clearFormatters`, `detectLocale`, `clearICUCache`, `restoreLocale`, `configure`, `resetConfig`, `createScope` |
 
 ## Quick Start
 
@@ -229,6 +229,77 @@ export async function generateMetadata({ params }) {
 }
 ```
 
+## Plural Shorthand (v0.7.0)
+
+Concise plural syntax:
+
+```tsx
+// Server Component
+export default async function Page() {
+  return (
+    <p>
+      {await it({
+        en: '{count, p, item|items}',
+        ko: '{count}개',
+      }, { count: 5 })}
+    </p>
+  )
+}
+
+// Client Component - also supports 3-part (zero|singular|plural)
+<T en="{count, p, no items|item|items}" ko="{count, p, 없음|개|개}" count={0} />
+```
+
+## Locale Persistence (v0.7.0)
+
+Auto-save and restore locale:
+
+```tsx
+'use client'
+import { configure, restoreLocale } from 'inline-i18n-multi-next/client'
+
+configure({
+  persistLocale: { storage: 'cookie', key: 'LOCALE', expires: 365 }
+})
+
+// Restore on app init
+const saved = restoreLocale() // returns locale string or undefined
+```
+
+## Translation Scope (v0.8.0)
+
+Scope translations to a key prefix with `useScopedT`. Useful for large apps where each component only needs a subset of the dictionary.
+
+```tsx
+'use client'
+import { useScopedT } from 'inline-i18n-multi-next/client'
+
+export function Dashboard() {
+  const t = useScopedT('dashboard')
+  return (
+    <div>
+      <h1>{t('title')}</h1>     {/* resolves to 'dashboard.title' */}
+      <p>{t('subtitle')}</p>    {/* resolves to 'dashboard.subtitle' */}
+    </div>
+  )
+}
+```
+
+You can also create a reusable scope with `createScope`:
+
+```tsx
+'use client'
+import { useScopedT } from 'inline-i18n-multi-next/client'
+import { createScope } from 'inline-i18n-multi-next/client'
+
+const scope = createScope('settings.profile')
+
+export function ProfileForm() {
+  const t = useScopedT(scope)
+  return <label>{t('name')}</label>  {/* resolves to 'settings.profile.name' */}
+}
+```
+
 ## Custom Formatters
 
 Register custom ICU formatters via the core re-exports.

package/dist/client.d.mts

@@ -1 +1 @@
-export { CustomFormatter, DetectLocaleOptions, DetectSource, Dictionaries, Dictionary, Locale, LocaleProvider, PluralRules, RichText, RichTextSegment, T, TranslationVars, Translations, clearDictionaries, clearFormatters, detectLocale, en_de, en_es, en_fr, en_ja, en_zh, getDictionary, getLoadedLocales, getLocale, hasTranslation, isLoaded, it, it_de, it_es, it_fr, it_ja, it_zh, ja_es, ja_zh, loadAsync, loadDictionaries, loadDictionary, parseRichText, registerFormatter, setLocale, t, useDetectedLocale, useLoadDictionaries, useLocale, useRichText, useT, zh_es } from 'inline-i18n-multi-react';
+export { CustomFormatter, DetectLocaleOptions, DetectSource, Dictionaries, Dictionary, Locale, LocaleProvider, PluralRules, RichText, RichTextSegment, T, TranslationVars, Translations, clearDictionaries, clearFormatters, clearICUCache, createScope, detectLocale, en_de, en_es, en_fr, en_ja, en_zh, getDictionary, getLoadedLocales, getLocale, hasTranslation, isLoaded, it, it_de, it_es, it_fr, it_ja, it_zh, ja_es, ja_zh, loadAsync, loadDictionaries, loadDictionary, parseRichText, registerFormatter, restoreLocale, setLocale, t, useDetectedLocale, useLoadDictionaries, useLocale, useRichText, useScopedT, useT, zh_es } from 'inline-i18n-multi-react';

package/dist/client.d.ts

@@ -1 +1 @@
-export { CustomFormatter, DetectLocaleOptions, DetectSource, Dictionaries, Dictionary, Locale, LocaleProvider, PluralRules, RichText, RichTextSegment, T, TranslationVars, Translations, clearDictionaries, clearFormatters, detectLocale, en_de, en_es, en_fr, en_ja, en_zh, getDictionary, getLoadedLocales, getLocale, hasTranslation, isLoaded, it, it_de, it_es, it_fr, it_ja, it_zh, ja_es, ja_zh, loadAsync, loadDictionaries, loadDictionary, parseRichText, registerFormatter, setLocale, t, useDetectedLocale, useLoadDictionaries, useLocale, useRichText, useT, zh_es } from 'inline-i18n-multi-react';
+export { CustomFormatter, DetectLocaleOptions, DetectSource, Dictionaries, Dictionary, Locale, LocaleProvider, PluralRules, RichText, RichTextSegment, T, TranslationVars, Translations, clearDictionaries, clearFormatters, clearICUCache, createScope, detectLocale, en_de, en_es, en_fr, en_ja, en_zh, getDictionary, getLoadedLocales, getLocale, hasTranslation, isLoaded, it, it_de, it_es, it_fr, it_ja, it_zh, ja_es, ja_zh, loadAsync, loadDictionaries, loadDictionary, parseRichText, registerFormatter, restoreLocale, setLocale, t, useDetectedLocale, useLoadDictionaries, useLocale, useRichText, useScopedT, useT, zh_es } from 'inline-i18n-multi-react';

package/dist/client.js

@@ -24,6 +24,14 @@ Object.defineProperty(exports, "clearFormatters", {
   enumerable: true,
   get: function () { return inlineI18nMultiReact.clearFormatters; }
 });
+Object.defineProperty(exports, "clearICUCache", {
+  enumerable: true,
+  get: function () { return inlineI18nMultiReact.clearICUCache; }
+});
+Object.defineProperty(exports, "createScope", {
+  enumerable: true,
+  get: function () { return inlineI18nMultiReact.createScope; }
+});
 Object.defineProperty(exports, "detectLocale", {
   enumerable: true,
   get: function () { return inlineI18nMultiReact.detectLocale; }
@@ -120,6 +128,10 @@ Object.defineProperty(exports, "registerFormatter", {
   enumerable: true,
   get: function () { return inlineI18nMultiReact.registerFormatter; }
 });
+Object.defineProperty(exports, "restoreLocale", {
+  enumerable: true,
+  get: function () { return inlineI18nMultiReact.restoreLocale; }
+});
 Object.defineProperty(exports, "setLocale", {
   enumerable: true,
   get: function () { return inlineI18nMultiReact.setLocale; }
@@ -144,6 +156,10 @@ Object.defineProperty(exports, "useRichText", {
   enumerable: true,
   get: function () { return inlineI18nMultiReact.useRichText; }
 });
+Object.defineProperty(exports, "useScopedT", {
+  enumerable: true,
+  get: function () { return inlineI18nMultiReact.useScopedT; }
+});
 Object.defineProperty(exports, "useT", {
   enumerable: true,
   get: function () { return inlineI18nMultiReact.useT; }

package/dist/client.mjs

@@ -1,3 +1,3 @@
-export { LocaleProvider, RichText, T, clearDictionaries, clearFormatters, detectLocale, en_de, en_es, en_fr, en_ja, en_zh, getDictionary, getLoadedLocales, getLocale, hasTranslation, isLoaded, it, it_de, it_es, it_fr, it_ja, it_zh, ja_es, ja_zh, loadAsync, loadDictionaries, loadDictionary, parseRichText, registerFormatter, setLocale, t, useDetectedLocale, useLoadDictionaries, useLocale, useRichText, useT, zh_es } from 'inline-i18n-multi-react';
+export { LocaleProvider, RichText, T, clearDictionaries, clearFormatters, clearICUCache, createScope, detectLocale, en_de, en_es, en_fr, en_ja, en_zh, getDictionary, getLoadedLocales, getLocale, hasTranslation, isLoaded, it, it_de, it_es, it_fr, it_ja, it_zh, ja_es, ja_zh, loadAsync, loadDictionaries, loadDictionary, parseRichText, registerFormatter, restoreLocale, setLocale, t, useDetectedLocale, useLoadDictionaries, useLocale, useRichText, useScopedT, useT, zh_es } from 'inline-i18n-multi-react';
 //# sourceMappingURL=client.mjs.map
 //# sourceMappingURL=client.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "inline-i18n-multi-next",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Next.js integration for inline-i18n-multi",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -51,8 +51,8 @@
     "react": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "inline-i18n-multi": "0.6.0",
-    "inline-i18n-multi-react": "0.6.0"
+    "inline-i18n-multi": "0.8.0",
+    "inline-i18n-multi-react": "0.8.0"
   },
   "devDependencies": {
     "@types/react": "^19.0.2",