@embedpdf/plugin-i18n 2.0.0-next.0

package/dist/lib/reducer.d.ts

@@ -0,0 +1,5 @@
+import { Reducer } from '@embedpdf/core';
+import { I18nState } from './types';
+import { I18nAction } from './actions';
+export declare const initialState: I18nState;
+export declare const i18nReducer: Reducer<I18nState, I18nAction>;

package/dist/lib/types.d.ts

@@ -0,0 +1,104 @@
+import { BasePluginConfig, EventHook } from '@embedpdf/core';
+export type TranslationKey = string;
+export type LocaleCode = string;
+export type ParamResolver<TStore = any> = (context: {
+    state: TStore;
+    documentId?: string;
+}) => Record<string, string | number>;
+export interface TranslateOptions {
+    documentId?: string;
+    params?: Record<string, string | number>;
+    fallback?: string;
+}
+export type ScopedTranslateOptions = Omit<TranslateOptions, 'documentId'>;
+export type ParamResolvers<TStore = any> = Record<TranslationKey, ParamResolver<TStore>>;
+export interface TranslationDictionary {
+    [key: string]: string | TranslationDictionary;
+}
+export interface Locale {
+    code: LocaleCode;
+    name: string;
+    translations: TranslationDictionary;
+}
+export interface I18nPluginConfig extends BasePluginConfig {
+    defaultLocale: LocaleCode;
+    fallbackLocale?: LocaleCode;
+    locales: Locale[];
+    paramResolvers?: ParamResolvers;
+}
+export interface I18nState {
+    currentLocale: LocaleCode;
+    availableLocales: LocaleCode[];
+}
+export interface LocaleChangeEvent {
+    previousLocale: LocaleCode;
+    currentLocale: LocaleCode;
+}
+export interface TranslationParamsChangedData {
+    changedKeys: TranslationKey[];
+}
+export interface TranslationParamsChangedEvent {
+    documentId: string;
+    changedKeys: TranslationKey[];
+}
+export interface I18nScope {
+    /**
+     * Translate a key for this document
+     * @param key - Translation key
+     * @param options - Optional translation options (params, fallback)
+     *
+     * @example
+     * const scoped = i18n.forDocument(documentId);
+     * scoped.t('page.title')
+     * scoped.t('page.count', { params: { count: 5 } })
+     * scoped.t('unknown.key', { fallback: 'Default Text' })
+     */
+    t(key: TranslationKey, options?: ScopedTranslateOptions): string;
+    /**
+     * Event when translation params change for this document
+     */
+    onParamsChanged: EventHook<TranslationParamsChangedData>;
+}
+export interface I18nCapability {
+    /**
+     * Translate a key with optional context
+     * If a param resolver is registered for this key, it will be called automatically
+     *
+     * @param key - Translation key
+     * @param options - Optional translation options (documentId, params)
+     *
+     * @example
+     * // Simple global translation
+     * i18n.t('loading.viewer')
+     *
+     * // Global translation with params
+     * i18n.t('document.total', { params: { amount: 5 } })
+     *
+     * // Document-scoped with param resolver
+     * i18n.t('page.current', { documentId })
+     *
+     * // Document-scoped with explicit params
+     * i18n.t('welcome', { documentId, params: { name: 'User' } })
+     */
+    t(key: TranslationKey, options?: TranslateOptions): string;
+    /**
+     * Get document-scoped API
+     */
+    forDocument(documentId: string): I18nScope;
+    /**
+     * Register a param resolver dynamically
+     */
+    registerParamResolver(key: TranslationKey, resolver: ParamResolver): void;
+    /**
+     * Unregister a param resolver
+     */
+    unregisterParamResolver(key: TranslationKey): void;
+    setLocale(locale: LocaleCode): void;
+    getLocale(): LocaleCode;
+    getAvailableLocales(): LocaleCode[];
+    getLocaleInfo(code: LocaleCode): Locale | null;
+    registerLocale(locale: Locale): void;
+    hasLocale(code: LocaleCode): boolean;
+    onLocaleChange: EventHook<LocaleChangeEvent>;
+    onParamsChanged: EventHook<TranslationParamsChangedEvent>;
+}

package/dist/preact/adapter.d.ts

@@ -0,0 +1,5 @@
+export { Fragment } from 'preact';
+export { useEffect, useRef, useState, useCallback, useMemo, useReducer } from 'preact/hooks';
+export type { ComponentChildren as ReactNode } from 'preact';
+export type CSSProperties = import('preact').JSX.CSSProperties;
+export type HTMLAttributes<T = any> = import('preact').JSX.HTMLAttributes<T extends EventTarget ? T : never>;

package/dist/preact/core.d.ts

@@ -0,0 +1 @@
+export * from '@embedpdf/core/preact';

package/dist/preact/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@embedpdf/core/preact"),r=require("@embedpdf/plugin-i18n");require("preact");const t=require("preact/hooks"),a=()=>e.useCapability(r.I18nPlugin.id),n=e=>{const{provides:r}=a(),[,n]=t.useReducer(e=>e+1,0),o=t.useCallback((t,a)=>r?r.t(t,{documentId:e,params:null==a?void 0:a.params,fallback:null==a?void 0:a.fallback}):(null==a?void 0:a.fallback)??t,[r,e]);return t.useEffect(()=>{if(!r)return;const t=r.onLocaleChange(()=>{n()}),a=e?r.forDocument(e).onParamsChanged(()=>{n()}):r.onParamsChanged(()=>{n()});return()=>{t(),a()}},[r,e]),{translate:o,locale:(null==r?void 0:r.getLocale())??"en"}},o=(e,r,t)=>{const{translate:a}=n(t);return a(e,r)};exports.Translate=function({k:e,params:r,fallback:t,documentId:a,children:n}){const l=o(e,{params:r,fallback:t},a);return n?n(l):l},exports.useI18nCapability=a,exports.useI18nPlugin=()=>e.usePlugin(r.I18nPlugin.id),exports.useLocale=()=>{const{provides:e}=a(),[r,n]=t.useState(()=>(null==e?void 0:e.getLocale())??"en");return t.useEffect(()=>{if(!e)return;const r=e.onLocaleChange(({currentLocale:e})=>{n(e)});return n(e.getLocale()),r},[e]),r},exports.useTranslation=o,exports.useTranslations=n,Object.keys(r).forEach(e=>{"default"===e||Object.prototype.hasOwnProperty.call(exports,e)||Object.defineProperty(exports,e,{enumerable:!0,get:()=>r[e]})});
+//# sourceMappingURL=index.cjs.map

package/dist/preact/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../src/shared/hooks/use-i18n.ts","../../src/shared/components/translate.tsx"],"sourcesContent":["import { useCapability, usePlugin } from '@embedpdf/core/@framework';\nimport { I18nPlugin } from '@embedpdf/plugin-i18n';\nimport { useState, useEffect, useCallback, useReducer } from '@framework';\n\nexport const useI18nCapability = () => useCapability<I18nPlugin>(I18nPlugin.id);\nexport const useI18nPlugin = () => usePlugin<I18nPlugin>(I18nPlugin.id);\n\n/**\n * Hook to get a translate function for a component\n * Automatically updates all translations on locale or param changes\n *\n * @param documentId - Optional document ID for document-scoped translations\n * @returns translate function and current locale\n *\n * @example\n * const { translate } = useTranslations(documentId);\n * return (\n *   <div>\n *     <h1>{translate('page.title')}</h1>\n *     <p>{translate('page.count', { params: { count: 5 } })}</p>\n *     <p>{translate('unknown.key', { fallback: 'Default Text' })}</p>\n *   </div>\n * );\n */\nexport const useTranslations = (documentId?: string) => {\n  const { provides } = useI18nCapability();\n  const [, forceUpdate] = useReducer((x) => x + 1, 0);\n\n  // Create a stable translate function with options support\n  const translate = useCallback(\n    (\n      key: string,\n      options?: {\n        params?: Record<string, string | number>;\n        fallback?: string;\n      },\n    ): string => {\n      if (!provides) return options?.fallback ?? key;\n      return provides.t(key, { documentId, params: options?.params, fallback: options?.fallback });\n    },\n    [provides, documentId],\n  );\n\n  useEffect(() => {\n    if (!provides) return;\n\n    // Update on locale change (all translations need to refresh)\n    const unsubscribeLocale = provides.onLocaleChange(() => {\n      forceUpdate();\n    });\n\n    // Update on params change (for keys with param resolvers)\n    const unsubscribeParams = documentId\n      ? provides.forDocument(documentId).onParamsChanged(() => {\n          forceUpdate(); // Re-render component when any params change\n        })\n      : provides.onParamsChanged(() => {\n          forceUpdate(); // Global params change\n        });\n\n    return () => {\n      unsubscribeLocale();\n      unsubscribeParams();\n    };\n  }, [provides, documentId]);\n\n  return {\n    translate,\n    locale: provides?.getLocale() ?? 'en',\n  };\n};\n\n// Keep the old hook for single-key translations (useful for derived state)\nexport const useTranslation = (\n  key: string,\n  options?: {\n    params?: Record<string, string | number>;\n    fallback?: string;\n  },\n  documentId?: string,\n) => {\n  const { translate } = useTranslations(documentId);\n  return translate(key, options);\n};\n\n/**\n * Hook to get current locale\n */\nexport const useLocale = () => {\n  const { provides } = useI18nCapability();\n  const [locale, setLocale] = useState<string>(() => provides?.getLocale() ?? 'en');\n\n  useEffect(() => {\n    if (!provides) return;\n\n    const unsubscribe = provides.onLocaleChange(({ currentLocale }) => {\n      setLocale(currentLocale);\n    });\n\n    setLocale(provides.getLocale());\n\n    return unsubscribe;\n  }, [provides]);\n\n  return locale;\n};\n","import { ReactNode } from '@framework';\nimport { useTranslation } from '../hooks';\n\ninterface TranslateProps {\n  k: string; // translation key\n  params?: Record<string, string | number>;\n  fallback?: string; // Fallback string if translation not found\n  documentId?: string; // Optional document ID for document-scoped translations\n  children?: (translation: string) => ReactNode;\n}\n\n/**\n * Component for inline translation\n *\n * @example\n * // Global translation\n * <Translate k=\"loading.viewer\" />\n *\n * @example\n * // With explicit params\n * <Translate k=\"zoom.level\" params={{ level: 150 }} />\n *\n * @example\n * // With fallback\n * <Translate k=\"unknown.key\" fallback=\"Default Text\" />\n *\n * @example\n * // Document-scoped (uses param resolvers)\n * <Translate k=\"page.current\" documentId={documentId} />\n *\n * @example\n * // With render prop\n * <Translate k=\"zoom.level\" params={{ level: 150 }}>\n *   {(text) => <span className=\"font-bold\">{text}</span>}\n * </Translate>\n */\nexport function Translate({ k, params, fallback, documentId, children }: TranslateProps) {\n  const translation = useTranslation(k, { params, fallback }, documentId);\n\n  if (children) {\n    return children(translation);\n  }\n\n  return translation;\n}\n"],"names":["useI18nCapability","useCapability","I18nPlugin","id","useTranslations","documentId","provides","forceUpdate","useReducer","x","translate","useCallback","key","options","t","params","fallback","useEffect","unsubscribeLocale","onLocaleChange","unsubscribeParams","forDocument","onParamsChanged","locale","getLocale","useTranslation","k","children","translation","usePlugin","setLocale","useState","unsubscribe","currentLocale"],"mappings":"8MAIaA,EAAoB,IAAMC,gBAA0BC,EAAAA,WAAWC,IAoB/DC,EAAmBC,IAC9B,MAAMC,SAAEA,GAAaN,KACf,CAAGO,GAAeC,EAAAA,WAAYC,GAAMA,EAAI,EAAG,GAG3CC,EAAYC,EAAAA,YAChB,CACEC,EACAC,IAKKP,EACEA,EAASQ,EAAEF,EAAK,CAAEP,aAAYU,OAAQ,MAAAF,OAAA,EAAAA,EAASE,OAAQC,SAAU,MAAAH,OAAA,EAAAA,EAASG,YAD3D,MAAAH,OAAA,EAAAA,EAASG,WAAYJ,EAG7C,CAACN,EAAUD,IA0Bb,OAvBAY,EAAAA,UAAU,KACR,IAAKX,EAAU,OAGf,MAAMY,EAAoBZ,EAASa,eAAe,KAChDZ,MAIIa,EAAoBf,EACtBC,EAASe,YAAYhB,GAAYiB,gBAAgB,KAC/Cf,MAEFD,EAASgB,gBAAgB,KACvBf,MAGN,MAAO,KACLW,IACAE,MAED,CAACd,EAAUD,IAEP,CACLK,YACAa,cAAQjB,WAAUkB,cAAe,OAKxBC,EAAiB,CAC5Bb,EACAC,EAIAR,KAEA,MAAMK,UAAEA,GAAcN,EAAgBC,GACtC,OAAOK,EAAUE,EAAKC,sBC9CjB,UAAmBa,EAAEA,EAAAX,OAAGA,WAAQC,EAAAX,WAAUA,EAAAsB,SAAYA,IAC3D,MAAMC,EAAcH,EAAeC,EAAG,CAAEX,SAAQC,YAAYX,GAE5D,OAAIsB,EACKA,EAASC,GAGXA,CACT,oDDvC6B,IAAMC,YAAsB3B,EAAAA,WAAWC,sBAmF3C,KACvB,MAAMG,SAAEA,GAAaN,KACduB,EAAQO,GAAaC,EAAAA,SAAiB,KAAM,MAAAzB,OAAA,EAAAA,EAAUkB,cAAe,MAc5E,OAZAP,EAAAA,UAAU,KACR,IAAKX,EAAU,OAEf,MAAM0B,EAAc1B,EAASa,eAAe,EAAGc,oBAC7CH,EAAUG,KAKZ,OAFAH,EAAUxB,EAASkB,aAEZQ,GACN,CAAC1B,IAEGiB"}

package/dist/preact/index.d.ts

@@ -0,0 +1 @@
+export * from '../shared-preact';

package/dist/preact/index.js

@@ -0,0 +1,70 @@
+import { useCapability, usePlugin } from "@embedpdf/core/preact";
+import { I18nPlugin } from "@embedpdf/plugin-i18n";
+export * from "@embedpdf/plugin-i18n";
+import "preact";
+import { useReducer, useCallback, useEffect, useState } from "preact/hooks";
+const useI18nCapability = () => useCapability(I18nPlugin.id);
+const useI18nPlugin = () => usePlugin(I18nPlugin.id);
+const useTranslations = (documentId) => {
+  const { provides } = useI18nCapability();
+  const [, forceUpdate] = useReducer((x) => x + 1, 0);
+  const translate = useCallback(
+    (key, options) => {
+      if (!provides) return (options == null ? void 0 : options.fallback) ?? key;
+      return provides.t(key, { documentId, params: options == null ? void 0 : options.params, fallback: options == null ? void 0 : options.fallback });
+    },
+    [provides, documentId]
+  );
+  useEffect(() => {
+    if (!provides) return;
+    const unsubscribeLocale = provides.onLocaleChange(() => {
+      forceUpdate();
+    });
+    const unsubscribeParams = documentId ? provides.forDocument(documentId).onParamsChanged(() => {
+      forceUpdate();
+    }) : provides.onParamsChanged(() => {
+      forceUpdate();
+    });
+    return () => {
+      unsubscribeLocale();
+      unsubscribeParams();
+    };
+  }, [provides, documentId]);
+  return {
+    translate,
+    locale: (provides == null ? void 0 : provides.getLocale()) ?? "en"
+  };
+};
+const useTranslation = (key, options, documentId) => {
+  const { translate } = useTranslations(documentId);
+  return translate(key, options);
+};
+const useLocale = () => {
+  const { provides } = useI18nCapability();
+  const [locale, setLocale] = useState(() => (provides == null ? void 0 : provides.getLocale()) ?? "en");
+  useEffect(() => {
+    if (!provides) return;
+    const unsubscribe = provides.onLocaleChange(({ currentLocale }) => {
+      setLocale(currentLocale);
+    });
+    setLocale(provides.getLocale());
+    return unsubscribe;
+  }, [provides]);
+  return locale;
+};
+function Translate({ k, params, fallback, documentId, children }) {
+  const translation = useTranslation(k, { params, fallback }, documentId);
+  if (children) {
+    return children(translation);
+  }
+  return translation;
+}
+export {
+  Translate,
+  useI18nCapability,
+  useI18nPlugin,
+  useLocale,
+  useTranslation,
+  useTranslations
+};
+//# sourceMappingURL=index.js.map

package/dist/preact/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/shared/hooks/use-i18n.ts","../../src/shared/components/translate.tsx"],"sourcesContent":["import { useCapability, usePlugin } from '@embedpdf/core/@framework';\nimport { I18nPlugin } from '@embedpdf/plugin-i18n';\nimport { useState, useEffect, useCallback, useReducer } from '@framework';\n\nexport const useI18nCapability = () => useCapability<I18nPlugin>(I18nPlugin.id);\nexport const useI18nPlugin = () => usePlugin<I18nPlugin>(I18nPlugin.id);\n\n/**\n * Hook to get a translate function for a component\n * Automatically updates all translations on locale or param changes\n *\n * @param documentId - Optional document ID for document-scoped translations\n * @returns translate function and current locale\n *\n * @example\n * const { translate } = useTranslations(documentId);\n * return (\n *   <div>\n *     <h1>{translate('page.title')}</h1>\n *     <p>{translate('page.count', { params: { count: 5 } })}</p>\n *     <p>{translate('unknown.key', { fallback: 'Default Text' })}</p>\n *   </div>\n * );\n */\nexport const useTranslations = (documentId?: string) => {\n  const { provides } = useI18nCapability();\n  const [, forceUpdate] = useReducer((x) => x + 1, 0);\n\n  // Create a stable translate function with options support\n  const translate = useCallback(\n    (\n      key: string,\n      options?: {\n        params?: Record<string, string | number>;\n        fallback?: string;\n      },\n    ): string => {\n      if (!provides) return options?.fallback ?? key;\n      return provides.t(key, { documentId, params: options?.params, fallback: options?.fallback });\n    },\n    [provides, documentId],\n  );\n\n  useEffect(() => {\n    if (!provides) return;\n\n    // Update on locale change (all translations need to refresh)\n    const unsubscribeLocale = provides.onLocaleChange(() => {\n      forceUpdate();\n    });\n\n    // Update on params change (for keys with param resolvers)\n    const unsubscribeParams = documentId\n      ? provides.forDocument(documentId).onParamsChanged(() => {\n          forceUpdate(); // Re-render component when any params change\n        })\n      : provides.onParamsChanged(() => {\n          forceUpdate(); // Global params change\n        });\n\n    return () => {\n      unsubscribeLocale();\n      unsubscribeParams();\n    };\n  }, [provides, documentId]);\n\n  return {\n    translate,\n    locale: provides?.getLocale() ?? 'en',\n  };\n};\n\n// Keep the old hook for single-key translations (useful for derived state)\nexport const useTranslation = (\n  key: string,\n  options?: {\n    params?: Record<string, string | number>;\n    fallback?: string;\n  },\n  documentId?: string,\n) => {\n  const { translate } = useTranslations(documentId);\n  return translate(key, options);\n};\n\n/**\n * Hook to get current locale\n */\nexport const useLocale = () => {\n  const { provides } = useI18nCapability();\n  const [locale, setLocale] = useState<string>(() => provides?.getLocale() ?? 'en');\n\n  useEffect(() => {\n    if (!provides) return;\n\n    const unsubscribe = provides.onLocaleChange(({ currentLocale }) => {\n      setLocale(currentLocale);\n    });\n\n    setLocale(provides.getLocale());\n\n    return unsubscribe;\n  }, [provides]);\n\n  return locale;\n};\n","import { ReactNode } from '@framework';\nimport { useTranslation } from '../hooks';\n\ninterface TranslateProps {\n  k: string; // translation key\n  params?: Record<string, string | number>;\n  fallback?: string; // Fallback string if translation not found\n  documentId?: string; // Optional document ID for document-scoped translations\n  children?: (translation: string) => ReactNode;\n}\n\n/**\n * Component for inline translation\n *\n * @example\n * // Global translation\n * <Translate k=\"loading.viewer\" />\n *\n * @example\n * // With explicit params\n * <Translate k=\"zoom.level\" params={{ level: 150 }} />\n *\n * @example\n * // With fallback\n * <Translate k=\"unknown.key\" fallback=\"Default Text\" />\n *\n * @example\n * // Document-scoped (uses param resolvers)\n * <Translate k=\"page.current\" documentId={documentId} />\n *\n * @example\n * // With render prop\n * <Translate k=\"zoom.level\" params={{ level: 150 }}>\n *   {(text) => <span className=\"font-bold\">{text}</span>}\n * </Translate>\n */\nexport function Translate({ k, params, fallback, documentId, children }: TranslateProps) {\n  const translation = useTranslation(k, { params, fallback }, documentId);\n\n  if (children) {\n    return children(translation);\n  }\n\n  return translation;\n}\n"],"names":[],"mappings":";;;;;AAIO,MAAM,oBAAoB,MAAM,cAA0B,WAAW,EAAE;AACvE,MAAM,gBAAgB,MAAM,UAAsB,WAAW,EAAE;AAmB/D,MAAM,kBAAkB,CAAC,eAAwB;AACtD,QAAM,EAAE,SAAA,IAAa,kBAAA;AACrB,QAAM,CAAA,EAAG,WAAW,IAAI,WAAW,CAAC,MAAM,IAAI,GAAG,CAAC;AAGlD,QAAM,YAAY;AAAA,IAChB,CACE,KACA,YAIW;AACX,UAAI,CAAC,SAAU,SAAO,mCAAS,aAAY;AAC3C,aAAO,SAAS,EAAE,KAAK,EAAE,YAAY,QAAQ,mCAAS,QAAQ,UAAU,mCAAS,SAAA,CAAU;AAAA,IAC7F;AAAA,IACA,CAAC,UAAU,UAAU;AAAA,EAAA;AAGvB,YAAU,MAAM;AACd,QAAI,CAAC,SAAU;AAGf,UAAM,oBAAoB,SAAS,eAAe,MAAM;AACtD,kBAAA;AAAA,IACF,CAAC;AAGD,UAAM,oBAAoB,aACtB,SAAS,YAAY,UAAU,EAAE,gBAAgB,MAAM;AACrD,kBAAA;AAAA,IACF,CAAC,IACD,SAAS,gBAAgB,MAAM;AAC7B,kBAAA;AAAA,IACF,CAAC;AAEL,WAAO,MAAM;AACX,wBAAA;AACA,wBAAA;AAAA,IACF;AAAA,EACF,GAAG,CAAC,UAAU,UAAU,CAAC;AAEzB,SAAO;AAAA,IACL;AAAA,IACA,SAAQ,qCAAU,gBAAe;AAAA,EAAA;AAErC;AAGO,MAAM,iBAAiB,CAC5B,KACA,SAIA,eACG;AACH,QAAM,EAAE,UAAA,IAAc,gBAAgB,UAAU;AAChD,SAAO,UAAU,KAAK,OAAO;AAC/B;AAKO,MAAM,YAAY,MAAM;AAC7B,QAAM,EAAE,SAAA,IAAa,kBAAA;AACrB,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAiB,OAAM,qCAAU,gBAAe,IAAI;AAEhF,YAAU,MAAM;AACd,QAAI,CAAC,SAAU;AAEf,UAAM,cAAc,SAAS,eAAe,CAAC,EAAE,oBAAoB;AACjE,gBAAU,aAAa;AAAA,IACzB,CAAC;AAED,cAAU,SAAS,WAAW;AAE9B,WAAO;AAAA,EACT,GAAG,CAAC,QAAQ,CAAC;AAEb,SAAO;AACT;ACrEO,SAAS,UAAU,EAAE,GAAG,QAAQ,UAAU,YAAY,YAA4B;AACvF,QAAM,cAAc,eAAe,GAAG,EAAE,QAAQ,SAAA,GAAY,UAAU;AAEtE,MAAI,UAAU;AACZ,WAAO,SAAS,WAAW;AAAA,EAC7B;AAEA,SAAO;AACT;"}

package/dist/react/adapter.d.ts

@@ -0,0 +1,2 @@
+export { Fragment, useEffect, useRef, useState, useCallback, useMemo, useReducer } from 'react';
+export type { ReactNode, HTMLAttributes, CSSProperties } from 'react';

package/dist/react/core.d.ts

@@ -0,0 +1 @@
+export * from '@embedpdf/core/react';

package/dist/react/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@embedpdf/core/react"),r=require("@embedpdf/plugin-i18n"),t=require("react"),a=()=>e.useCapability(r.I18nPlugin.id),n=e=>{const{provides:r}=a(),[,n]=t.useReducer(e=>e+1,0),o=t.useCallback((t,a)=>r?r.t(t,{documentId:e,params:null==a?void 0:a.params,fallback:null==a?void 0:a.fallback}):(null==a?void 0:a.fallback)??t,[r,e]);return t.useEffect(()=>{if(!r)return;const t=r.onLocaleChange(()=>{n()}),a=e?r.forDocument(e).onParamsChanged(()=>{n()}):r.onParamsChanged(()=>{n()});return()=>{t(),a()}},[r,e]),{translate:o,locale:(null==r?void 0:r.getLocale())??"en"}},o=(e,r,t)=>{const{translate:a}=n(t);return a(e,r)};exports.Translate=function({k:e,params:r,fallback:t,documentId:a,children:n}){const l=o(e,{params:r,fallback:t},a);return n?n(l):l},exports.useI18nCapability=a,exports.useI18nPlugin=()=>e.usePlugin(r.I18nPlugin.id),exports.useLocale=()=>{const{provides:e}=a(),[r,n]=t.useState(()=>(null==e?void 0:e.getLocale())??"en");return t.useEffect(()=>{if(!e)return;const r=e.onLocaleChange(({currentLocale:e})=>{n(e)});return n(e.getLocale()),r},[e]),r},exports.useTranslation=o,exports.useTranslations=n,Object.keys(r).forEach(e=>{"default"===e||Object.prototype.hasOwnProperty.call(exports,e)||Object.defineProperty(exports,e,{enumerable:!0,get:()=>r[e]})});
+//# sourceMappingURL=index.cjs.map

package/dist/react/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../src/shared/hooks/use-i18n.ts","../../src/shared/components/translate.tsx"],"sourcesContent":["import { useCapability, usePlugin } from '@embedpdf/core/@framework';\nimport { I18nPlugin } from '@embedpdf/plugin-i18n';\nimport { useState, useEffect, useCallback, useReducer } from '@framework';\n\nexport const useI18nCapability = () => useCapability<I18nPlugin>(I18nPlugin.id);\nexport const useI18nPlugin = () => usePlugin<I18nPlugin>(I18nPlugin.id);\n\n/**\n * Hook to get a translate function for a component\n * Automatically updates all translations on locale or param changes\n *\n * @param documentId - Optional document ID for document-scoped translations\n * @returns translate function and current locale\n *\n * @example\n * const { translate } = useTranslations(documentId);\n * return (\n *   <div>\n *     <h1>{translate('page.title')}</h1>\n *     <p>{translate('page.count', { params: { count: 5 } })}</p>\n *     <p>{translate('unknown.key', { fallback: 'Default Text' })}</p>\n *   </div>\n * );\n */\nexport const useTranslations = (documentId?: string) => {\n  const { provides } = useI18nCapability();\n  const [, forceUpdate] = useReducer((x) => x + 1, 0);\n\n  // Create a stable translate function with options support\n  const translate = useCallback(\n    (\n      key: string,\n      options?: {\n        params?: Record<string, string | number>;\n        fallback?: string;\n      },\n    ): string => {\n      if (!provides) return options?.fallback ?? key;\n      return provides.t(key, { documentId, params: options?.params, fallback: options?.fallback });\n    },\n    [provides, documentId],\n  );\n\n  useEffect(() => {\n    if (!provides) return;\n\n    // Update on locale change (all translations need to refresh)\n    const unsubscribeLocale = provides.onLocaleChange(() => {\n      forceUpdate();\n    });\n\n    // Update on params change (for keys with param resolvers)\n    const unsubscribeParams = documentId\n      ? provides.forDocument(documentId).onParamsChanged(() => {\n          forceUpdate(); // Re-render component when any params change\n        })\n      : provides.onParamsChanged(() => {\n          forceUpdate(); // Global params change\n        });\n\n    return () => {\n      unsubscribeLocale();\n      unsubscribeParams();\n    };\n  }, [provides, documentId]);\n\n  return {\n    translate,\n    locale: provides?.getLocale() ?? 'en',\n  };\n};\n\n// Keep the old hook for single-key translations (useful for derived state)\nexport const useTranslation = (\n  key: string,\n  options?: {\n    params?: Record<string, string | number>;\n    fallback?: string;\n  },\n  documentId?: string,\n) => {\n  const { translate } = useTranslations(documentId);\n  return translate(key, options);\n};\n\n/**\n * Hook to get current locale\n */\nexport const useLocale = () => {\n  const { provides } = useI18nCapability();\n  const [locale, setLocale] = useState<string>(() => provides?.getLocale() ?? 'en');\n\n  useEffect(() => {\n    if (!provides) return;\n\n    const unsubscribe = provides.onLocaleChange(({ currentLocale }) => {\n      setLocale(currentLocale);\n    });\n\n    setLocale(provides.getLocale());\n\n    return unsubscribe;\n  }, [provides]);\n\n  return locale;\n};\n","import { ReactNode } from '@framework';\nimport { useTranslation } from '../hooks';\n\ninterface TranslateProps {\n  k: string; // translation key\n  params?: Record<string, string | number>;\n  fallback?: string; // Fallback string if translation not found\n  documentId?: string; // Optional document ID for document-scoped translations\n  children?: (translation: string) => ReactNode;\n}\n\n/**\n * Component for inline translation\n *\n * @example\n * // Global translation\n * <Translate k=\"loading.viewer\" />\n *\n * @example\n * // With explicit params\n * <Translate k=\"zoom.level\" params={{ level: 150 }} />\n *\n * @example\n * // With fallback\n * <Translate k=\"unknown.key\" fallback=\"Default Text\" />\n *\n * @example\n * // Document-scoped (uses param resolvers)\n * <Translate k=\"page.current\" documentId={documentId} />\n *\n * @example\n * // With render prop\n * <Translate k=\"zoom.level\" params={{ level: 150 }}>\n *   {(text) => <span className=\"font-bold\">{text}</span>}\n * </Translate>\n */\nexport function Translate({ k, params, fallback, documentId, children }: TranslateProps) {\n  const translation = useTranslation(k, { params, fallback }, documentId);\n\n  if (children) {\n    return children(translation);\n  }\n\n  return translation;\n}\n"],"names":["useI18nCapability","useCapability","I18nPlugin","id","useTranslations","documentId","provides","forceUpdate","useReducer","x","translate","useCallback","key","options","t","params","fallback","useEffect","unsubscribeLocale","onLocaleChange","unsubscribeParams","forDocument","onParamsChanged","locale","getLocale","useTranslation","k","children","translation","usePlugin","setLocale","useState","unsubscribe","currentLocale"],"mappings":"8KAIaA,EAAoB,IAAMC,gBAA0BC,EAAAA,WAAWC,IAoB/DC,EAAmBC,IAC9B,MAAMC,SAAEA,GAAaN,KACf,CAAGO,GAAeC,EAAAA,WAAYC,GAAMA,EAAI,EAAG,GAG3CC,EAAYC,EAAAA,YAChB,CACEC,EACAC,IAKKP,EACEA,EAASQ,EAAEF,EAAK,CAAEP,aAAYU,OAAQ,MAAAF,OAAA,EAAAA,EAASE,OAAQC,SAAU,MAAAH,OAAA,EAAAA,EAASG,YAD3D,MAAAH,OAAA,EAAAA,EAASG,WAAYJ,EAG7C,CAACN,EAAUD,IA0Bb,OAvBAY,EAAAA,UAAU,KACR,IAAKX,EAAU,OAGf,MAAMY,EAAoBZ,EAASa,eAAe,KAChDZ,MAIIa,EAAoBf,EACtBC,EAASe,YAAYhB,GAAYiB,gBAAgB,KAC/Cf,MAEFD,EAASgB,gBAAgB,KACvBf,MAGN,MAAO,KACLW,IACAE,MAED,CAACd,EAAUD,IAEP,CACLK,YACAa,cAAQjB,WAAUkB,cAAe,OAKxBC,EAAiB,CAC5Bb,EACAC,EAIAR,KAEA,MAAMK,UAAEA,GAAcN,EAAgBC,GACtC,OAAOK,EAAUE,EAAKC,sBC9CjB,UAAmBa,EAAEA,EAAAX,OAAGA,WAAQC,EAAAX,WAAUA,EAAAsB,SAAYA,IAC3D,MAAMC,EAAcH,EAAeC,EAAG,CAAEX,SAAQC,YAAYX,GAE5D,OAAIsB,EACKA,EAASC,GAGXA,CACT,oDDvC6B,IAAMC,YAAsB3B,EAAAA,WAAWC,sBAmF3C,KACvB,MAAMG,SAAEA,GAAaN,KACduB,EAAQO,GAAaC,EAAAA,SAAiB,KAAM,MAAAzB,OAAA,EAAAA,EAAUkB,cAAe,MAc5E,OAZAP,EAAAA,UAAU,KACR,IAAKX,EAAU,OAEf,MAAM0B,EAAc1B,EAASa,eAAe,EAAGc,oBAC7CH,EAAUG,KAKZ,OAFAH,EAAUxB,EAASkB,aAEZQ,GACN,CAAC1B,IAEGiB"}

package/dist/react/index.d.ts

@@ -0,0 +1 @@
+export * from '../shared-react';

package/dist/react/index.js

@@ -0,0 +1,69 @@
+import { useCapability, usePlugin } from "@embedpdf/core/react";
+import { I18nPlugin } from "@embedpdf/plugin-i18n";
+export * from "@embedpdf/plugin-i18n";
+import { useReducer, useCallback, useEffect, useState } from "react";
+const useI18nCapability = () => useCapability(I18nPlugin.id);
+const useI18nPlugin = () => usePlugin(I18nPlugin.id);
+const useTranslations = (documentId) => {
+  const { provides } = useI18nCapability();
+  const [, forceUpdate] = useReducer((x) => x + 1, 0);
+  const translate = useCallback(
+    (key, options) => {
+      if (!provides) return (options == null ? void 0 : options.fallback) ?? key;
+      return provides.t(key, { documentId, params: options == null ? void 0 : options.params, fallback: options == null ? void 0 : options.fallback });
+    },
+    [provides, documentId]
+  );
+  useEffect(() => {
+    if (!provides) return;
+    const unsubscribeLocale = provides.onLocaleChange(() => {
+      forceUpdate();
+    });
+    const unsubscribeParams = documentId ? provides.forDocument(documentId).onParamsChanged(() => {
+      forceUpdate();
+    }) : provides.onParamsChanged(() => {
+      forceUpdate();
+    });
+    return () => {
+      unsubscribeLocale();
+      unsubscribeParams();
+    };
+  }, [provides, documentId]);
+  return {
+    translate,
+    locale: (provides == null ? void 0 : provides.getLocale()) ?? "en"
+  };
+};
+const useTranslation = (key, options, documentId) => {
+  const { translate } = useTranslations(documentId);
+  return translate(key, options);
+};
+const useLocale = () => {
+  const { provides } = useI18nCapability();
+  const [locale, setLocale] = useState(() => (provides == null ? void 0 : provides.getLocale()) ?? "en");
+  useEffect(() => {
+    if (!provides) return;
+    const unsubscribe = provides.onLocaleChange(({ currentLocale }) => {
+      setLocale(currentLocale);
+    });
+    setLocale(provides.getLocale());
+    return unsubscribe;
+  }, [provides]);
+  return locale;
+};
+function Translate({ k, params, fallback, documentId, children }) {
+  const translation = useTranslation(k, { params, fallback }, documentId);
+  if (children) {
+    return children(translation);
+  }
+  return translation;
+}
+export {
+  Translate,
+  useI18nCapability,
+  useI18nPlugin,
+  useLocale,
+  useTranslation,
+  useTranslations
+};
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/shared/hooks/use-i18n.ts","../../src/shared/components/translate.tsx"],"sourcesContent":["import { useCapability, usePlugin } from '@embedpdf/core/@framework';\nimport { I18nPlugin } from '@embedpdf/plugin-i18n';\nimport { useState, useEffect, useCallback, useReducer } from '@framework';\n\nexport const useI18nCapability = () => useCapability<I18nPlugin>(I18nPlugin.id);\nexport const useI18nPlugin = () => usePlugin<I18nPlugin>(I18nPlugin.id);\n\n/**\n * Hook to get a translate function for a component\n * Automatically updates all translations on locale or param changes\n *\n * @param documentId - Optional document ID for document-scoped translations\n * @returns translate function and current locale\n *\n * @example\n * const { translate } = useTranslations(documentId);\n * return (\n *   <div>\n *     <h1>{translate('page.title')}</h1>\n *     <p>{translate('page.count', { params: { count: 5 } })}</p>\n *     <p>{translate('unknown.key', { fallback: 'Default Text' })}</p>\n *   </div>\n * );\n */\nexport const useTranslations = (documentId?: string) => {\n  const { provides } = useI18nCapability();\n  const [, forceUpdate] = useReducer((x) => x + 1, 0);\n\n  // Create a stable translate function with options support\n  const translate = useCallback(\n    (\n      key: string,\n      options?: {\n        params?: Record<string, string | number>;\n        fallback?: string;\n      },\n    ): string => {\n      if (!provides) return options?.fallback ?? key;\n      return provides.t(key, { documentId, params: options?.params, fallback: options?.fallback });\n    },\n    [provides, documentId],\n  );\n\n  useEffect(() => {\n    if (!provides) return;\n\n    // Update on locale change (all translations need to refresh)\n    const unsubscribeLocale = provides.onLocaleChange(() => {\n      forceUpdate();\n    });\n\n    // Update on params change (for keys with param resolvers)\n    const unsubscribeParams = documentId\n      ? provides.forDocument(documentId).onParamsChanged(() => {\n          forceUpdate(); // Re-render component when any params change\n        })\n      : provides.onParamsChanged(() => {\n          forceUpdate(); // Global params change\n        });\n\n    return () => {\n      unsubscribeLocale();\n      unsubscribeParams();\n    };\n  }, [provides, documentId]);\n\n  return {\n    translate,\n    locale: provides?.getLocale() ?? 'en',\n  };\n};\n\n// Keep the old hook for single-key translations (useful for derived state)\nexport const useTranslation = (\n  key: string,\n  options?: {\n    params?: Record<string, string | number>;\n    fallback?: string;\n  },\n  documentId?: string,\n) => {\n  const { translate } = useTranslations(documentId);\n  return translate(key, options);\n};\n\n/**\n * Hook to get current locale\n */\nexport const useLocale = () => {\n  const { provides } = useI18nCapability();\n  const [locale, setLocale] = useState<string>(() => provides?.getLocale() ?? 'en');\n\n  useEffect(() => {\n    if (!provides) return;\n\n    const unsubscribe = provides.onLocaleChange(({ currentLocale }) => {\n      setLocale(currentLocale);\n    });\n\n    setLocale(provides.getLocale());\n\n    return unsubscribe;\n  }, [provides]);\n\n  return locale;\n};\n","import { ReactNode } from '@framework';\nimport { useTranslation } from '../hooks';\n\ninterface TranslateProps {\n  k: string; // translation key\n  params?: Record<string, string | number>;\n  fallback?: string; // Fallback string if translation not found\n  documentId?: string; // Optional document ID for document-scoped translations\n  children?: (translation: string) => ReactNode;\n}\n\n/**\n * Component for inline translation\n *\n * @example\n * // Global translation\n * <Translate k=\"loading.viewer\" />\n *\n * @example\n * // With explicit params\n * <Translate k=\"zoom.level\" params={{ level: 150 }} />\n *\n * @example\n * // With fallback\n * <Translate k=\"unknown.key\" fallback=\"Default Text\" />\n *\n * @example\n * // Document-scoped (uses param resolvers)\n * <Translate k=\"page.current\" documentId={documentId} />\n *\n * @example\n * // With render prop\n * <Translate k=\"zoom.level\" params={{ level: 150 }}>\n *   {(text) => <span className=\"font-bold\">{text}</span>}\n * </Translate>\n */\nexport function Translate({ k, params, fallback, documentId, children }: TranslateProps) {\n  const translation = useTranslation(k, { params, fallback }, documentId);\n\n  if (children) {\n    return children(translation);\n  }\n\n  return translation;\n}\n"],"names":[],"mappings":";;;;AAIO,MAAM,oBAAoB,MAAM,cAA0B,WAAW,EAAE;AACvE,MAAM,gBAAgB,MAAM,UAAsB,WAAW,EAAE;AAmB/D,MAAM,kBAAkB,CAAC,eAAwB;AACtD,QAAM,EAAE,SAAA,IAAa,kBAAA;AACrB,QAAM,CAAA,EAAG,WAAW,IAAI,WAAW,CAAC,MAAM,IAAI,GAAG,CAAC;AAGlD,QAAM,YAAY;AAAA,IAChB,CACE,KACA,YAIW;AACX,UAAI,CAAC,SAAU,SAAO,mCAAS,aAAY;AAC3C,aAAO,SAAS,EAAE,KAAK,EAAE,YAAY,QAAQ,mCAAS,QAAQ,UAAU,mCAAS,SAAA,CAAU;AAAA,IAC7F;AAAA,IACA,CAAC,UAAU,UAAU;AAAA,EAAA;AAGvB,YAAU,MAAM;AACd,QAAI,CAAC,SAAU;AAGf,UAAM,oBAAoB,SAAS,eAAe,MAAM;AACtD,kBAAA;AAAA,IACF,CAAC;AAGD,UAAM,oBAAoB,aACtB,SAAS,YAAY,UAAU,EAAE,gBAAgB,MAAM;AACrD,kBAAA;AAAA,IACF,CAAC,IACD,SAAS,gBAAgB,MAAM;AAC7B,kBAAA;AAAA,IACF,CAAC;AAEL,WAAO,MAAM;AACX,wBAAA;AACA,wBAAA;AAAA,IACF;AAAA,EACF,GAAG,CAAC,UAAU,UAAU,CAAC;AAEzB,SAAO;AAAA,IACL;AAAA,IACA,SAAQ,qCAAU,gBAAe;AAAA,EAAA;AAErC;AAGO,MAAM,iBAAiB,CAC5B,KACA,SAIA,eACG;AACH,QAAM,EAAE,UAAA,IAAc,gBAAgB,UAAU;AAChD,SAAO,UAAU,KAAK,OAAO;AAC/B;AAKO,MAAM,YAAY,MAAM;AAC7B,QAAM,EAAE,SAAA,IAAa,kBAAA;AACrB,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAiB,OAAM,qCAAU,gBAAe,IAAI;AAEhF,YAAU,MAAM;AACd,QAAI,CAAC,SAAU;AAEf,UAAM,cAAc,SAAS,eAAe,CAAC,EAAE,oBAAoB;AACjE,gBAAU,aAAa;AAAA,IACzB,CAAC;AAED,cAAU,SAAS,WAAW;AAE9B,WAAO;AAAA,EACT,GAAG,CAAC,QAAQ,CAAC;AAEb,SAAO;AACT;ACrEO,SAAS,UAAU,EAAE,GAAG,QAAQ,UAAU,YAAY,YAA4B;AACvF,QAAM,cAAc,eAAe,GAAG,EAAE,QAAQ,SAAA,GAAY,UAAU;AAEtE,MAAI,UAAU;AACZ,WAAO,SAAS,WAAW;AAAA,EAC7B;AAEA,SAAO;AACT;"}

package/dist/shared/components/index.d.ts

@@ -0,0 +1 @@
+export * from './translate';

package/dist/shared/components/translate.d.ts

@@ -0,0 +1,35 @@
+import { ReactNode } from '../../react/adapter.ts';
+interface TranslateProps {
+    k: string;
+    params?: Record<string, string | number>;
+    fallback?: string;
+    documentId?: string;
+    children?: (translation: string) => ReactNode;
+}
+/**
+ * Component for inline translation
+ *
+ * @example
+ * // Global translation
+ * <Translate k="loading.viewer" />
+ *
+ * @example
+ * // With explicit params
+ * <Translate k="zoom.level" params={{ level: 150 }} />
+ *
+ * @example
+ * // With fallback
+ * <Translate k="unknown.key" fallback="Default Text" />
+ *
+ * @example
+ * // Document-scoped (uses param resolvers)
+ * <Translate k="page.current" documentId={documentId} />
+ *
+ * @example
+ * // With render prop
+ * <Translate k="zoom.level" params={{ level: 150 }}>
+ *   {(text) => <span className="font-bold">{text}</span>}
+ * </Translate>
+ */
+export declare function Translate({ k, params, fallback, documentId, children }: TranslateProps): ReactNode;
+export {};

package/dist/shared/hooks/index.d.ts

@@ -0,0 +1 @@
+export * from './use-i18n';

package/dist/shared/hooks/use-i18n.d.ts

@@ -0,0 +1,43 @@
+import { I18nPlugin } from '../../index.ts';
+export declare const useI18nCapability: () => {
+    provides: Readonly<import('../../index.ts').I18nCapability> | null;
+    isLoading: boolean;
+    ready: Promise<void>;
+};
+export declare const useI18nPlugin: () => {
+    plugin: I18nPlugin | null;
+    isLoading: boolean;
+    ready: Promise<void>;
+};
+/**
+ * Hook to get a translate function for a component
+ * Automatically updates all translations on locale or param changes
+ *
+ * @param documentId - Optional document ID for document-scoped translations
+ * @returns translate function and current locale
+ *
+ * @example
+ * const { translate } = useTranslations(documentId);
+ * return (
+ *   <div>
+ *     <h1>{translate('page.title')}</h1>
+ *     <p>{translate('page.count', { params: { count: 5 } })}</p>
+ *     <p>{translate('unknown.key', { fallback: 'Default Text' })}</p>
+ *   </div>
+ * );
+ */
+export declare const useTranslations: (documentId?: string) => {
+    translate: (key: string, options?: {
+        params?: Record<string, string | number>;
+        fallback?: string;
+    }) => string;
+    locale: string;
+};
+export declare const useTranslation: (key: string, options?: {
+    params?: Record<string, string | number>;
+    fallback?: string;
+}, documentId?: string) => string;
+/**
+ * Hook to get current locale
+ */
+export declare const useLocale: () => string;

package/dist/shared/index.d.ts

@@ -0,0 +1,3 @@
+export * from './hooks';
+export * from './components';
+export * from '../index.ts';

package/dist/shared-preact/components/index.d.ts

@@ -0,0 +1 @@
+export * from './translate';

package/dist/shared-preact/components/translate.d.ts

@@ -0,0 +1,35 @@
+import { ReactNode } from '../../preact/adapter.ts';
+interface TranslateProps {
+    k: string;
+    params?: Record<string, string | number>;
+    fallback?: string;
+    documentId?: string;
+    children?: (translation: string) => ReactNode;
+}
+/**
+ * Component for inline translation
+ *
+ * @example
+ * // Global translation
+ * <Translate k="loading.viewer" />
+ *
+ * @example
+ * // With explicit params
+ * <Translate k="zoom.level" params={{ level: 150 }} />
+ *
+ * @example
+ * // With fallback
+ * <Translate k="unknown.key" fallback="Default Text" />
+ *
+ * @example
+ * // Document-scoped (uses param resolvers)
+ * <Translate k="page.current" documentId={documentId} />
+ *
+ * @example
+ * // With render prop
+ * <Translate k="zoom.level" params={{ level: 150 }}>
+ *   {(text) => <span className="font-bold">{text}</span>}
+ * </Translate>
+ */
+export declare function Translate({ k, params, fallback, documentId, children }: TranslateProps): ReactNode;
+export {};

package/dist/shared-preact/hooks/index.d.ts

@@ -0,0 +1 @@
+export * from './use-i18n';

package/dist/shared-preact/hooks/use-i18n.d.ts

@@ -0,0 +1,43 @@
+import { I18nPlugin } from '../../lib/index.ts';
+export declare const useI18nCapability: () => {
+    provides: Readonly<import('../../lib/index.ts').I18nCapability> | null;
+    isLoading: boolean;
+    ready: Promise<void>;
+};
+export declare const useI18nPlugin: () => {
+    plugin: I18nPlugin | null;
+    isLoading: boolean;
+    ready: Promise<void>;
+};
+/**
+ * Hook to get a translate function for a component
+ * Automatically updates all translations on locale or param changes
+ *
+ * @param documentId - Optional document ID for document-scoped translations
+ * @returns translate function and current locale
+ *
+ * @example
+ * const { translate } = useTranslations(documentId);
+ * return (
+ *   <div>
+ *     <h1>{translate('page.title')}</h1>
+ *     <p>{translate('page.count', { params: { count: 5 } })}</p>
+ *     <p>{translate('unknown.key', { fallback: 'Default Text' })}</p>
+ *   </div>
+ * );
+ */
+export declare const useTranslations: (documentId?: string) => {
+    translate: (key: string, options?: {
+        params?: Record<string, string | number>;
+        fallback?: string;
+    }) => string;
+    locale: string;
+};
+export declare const useTranslation: (key: string, options?: {
+    params?: Record<string, string | number>;
+    fallback?: string;
+}, documentId?: string) => string;
+/**
+ * Hook to get current locale
+ */
+export declare const useLocale: () => string;

package/dist/shared-preact/index.d.ts

@@ -0,0 +1,3 @@
+export * from './hooks';
+export * from './components';
+export * from '../lib/index.ts';

package/dist/shared-react/components/index.d.ts

@@ -0,0 +1 @@
+export * from './translate';

package/dist/shared-react/components/translate.d.ts

@@ -0,0 +1,35 @@
+import { ReactNode } from '../../react/adapter.ts';
+interface TranslateProps {
+    k: string;
+    params?: Record<string, string | number>;
+    fallback?: string;
+    documentId?: string;
+    children?: (translation: string) => ReactNode;
+}
+/**
+ * Component for inline translation
+ *
+ * @example
+ * // Global translation
+ * <Translate k="loading.viewer" />
+ *
+ * @example
+ * // With explicit params
+ * <Translate k="zoom.level" params={{ level: 150 }} />
+ *
+ * @example
+ * // With fallback
+ * <Translate k="unknown.key" fallback="Default Text" />
+ *
+ * @example
+ * // Document-scoped (uses param resolvers)
+ * <Translate k="page.current" documentId={documentId} />
+ *
+ * @example
+ * // With render prop
+ * <Translate k="zoom.level" params={{ level: 150 }}>
+ *   {(text) => <span className="font-bold">{text}</span>}
+ * </Translate>
+ */
+export declare function Translate({ k, params, fallback, documentId, children }: TranslateProps): ReactNode;
+export {};

package/dist/shared-react/hooks/index.d.ts

@@ -0,0 +1 @@
+export * from './use-i18n';

package/dist/shared-react/hooks/use-i18n.d.ts

@@ -0,0 +1,43 @@
+import { I18nPlugin } from '../../lib/index.ts';
+export declare const useI18nCapability: () => {
+    provides: Readonly<import('../../lib/index.ts').I18nCapability> | null;
+    isLoading: boolean;
+    ready: Promise<void>;
+};
+export declare const useI18nPlugin: () => {
+    plugin: I18nPlugin | null;
+    isLoading: boolean;
+    ready: Promise<void>;
+};
+/**
+ * Hook to get a translate function for a component
+ * Automatically updates all translations on locale or param changes
+ *
+ * @param documentId - Optional document ID for document-scoped translations
+ * @returns translate function and current locale
+ *
+ * @example
+ * const { translate } = useTranslations(documentId);
+ * return (
+ *   <div>
+ *     <h1>{translate('page.title')}</h1>
+ *     <p>{translate('page.count', { params: { count: 5 } })}</p>
+ *     <p>{translate('unknown.key', { fallback: 'Default Text' })}</p>
+ *   </div>
+ * );
+ */
+export declare const useTranslations: (documentId?: string) => {
+    translate: (key: string, options?: {
+        params?: Record<string, string | number>;
+        fallback?: string;
+    }) => string;
+    locale: string;
+};
+export declare const useTranslation: (key: string, options?: {
+    params?: Record<string, string | number>;
+    fallback?: string;
+}, documentId?: string) => string;
+/**
+ * Hook to get current locale
+ */
+export declare const useLocale: () => string;

package/dist/shared-react/index.d.ts

@@ -0,0 +1,3 @@
+export * from './hooks';
+export * from './components';
+export * from '../lib/index.ts';

package/dist/svelte/components/Translate.svelte.d.ts

@@ -0,0 +1,9 @@
+interface TranslateProps {
+    k: string;
+    params?: Record<string, string | number>;
+    fallback?: string;
+    documentId?: string;
+}
+declare const Translate: import('svelte', { with: { "resolution-mode": "import" } }).Component<TranslateProps, {}, "">;
+type Translate = ReturnType<typeof Translate>;
+export default Translate;

package/dist/svelte/components/index.d.ts

@@ -0,0 +1 @@
+export { default as Translate } from './Translate.svelte';

package/dist/svelte/hooks/index.d.ts

@@ -0,0 +1 @@
+export * from './use-i18n.svelte';