npm - @onruntime/translations - Versions diffs - 0.1.0 - Mend

@onruntime/translations 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (22) hide show

package/README.md +285 -0
package/dist/chunk-5W5CCQME.cjs +48 -0
package/dist/chunk-X3HAZ4DT.js +44 -0
package/dist/index.cjs +33 -0
package/dist/index.d.cts +36 -0
package/dist/index.d.ts +36 -0
package/dist/index.js +30 -0
package/dist/next/index.cjs +96 -0
package/dist/next/index.d.cts +38 -0
package/dist/next/index.d.ts +38 -0
package/dist/next/index.js +88 -0
package/dist/react/index.cjs +72 -0
package/dist/react/index.d.cts +44 -0
package/dist/react/index.d.ts +44 -0
package/dist/react/index.js +57 -0
package/dist/types-BpDtTtSF.d.cts +11 -0
package/dist/types-BpDtTtSF.d.ts +11 -0
package/dist/vite/index.cjs +18 -0
package/dist/vite/index.d.cts +20 -0
package/dist/vite/index.d.ts +20 -0
package/dist/vite/index.js +16 -0
package/package.json +79 -0

package/README.md ADDED Viewed

@@ -0,0 +1,285 @@
+# @onruntime/translations
+Lightweight i18n library for React, Next.js, and React Native.
+## Examples
+- [Next.js App Router](https://github.com/onRuntime/onruntime/tree/master/examples/translations/next-app)
+- [Next.js Pages Router](https://github.com/onRuntime/onruntime/tree/master/examples/translations/next-pages)
+- [React + Vite](https://github.com/onRuntime/onruntime/tree/master/examples/translations/react)
+## Installation
+```bash
+pnpm add @onruntime/translations
+```
+## Usage
+### Next.js App Router
+#### 1. Create your translations config
+```typescript
+// lib/translations.ts
+import {
+  getTranslation as getTranslationCore,
+  type TranslationLoader,
+} from "@onruntime/translations";
+export const locales = ["en", "fr"];
+export const defaultLocale = locales[0];
+export const load: TranslationLoader = (locale, namespace) => {
+  try {
+    return require(`../locales/${locale}/${namespace}.json`);
+  } catch {
+    return undefined;
+  }
+};
+export const getTranslation = async (
+  params: Promise<{ lang: string }>,
+  namespace = "common",
+) => {
+  const { lang } = await params;
+  return getTranslationCore(load, lang, namespace);
+};
+```
+#### 2. Setup middleware
+```typescript
+// middleware.ts
+import { NextResponse } from "next/server";
+import type { NextRequest } from "next/server";
+import { locales, defaultLocale } from "@/lib/translations";
+export function middleware(request: NextRequest) {
+  const { pathname } = request.nextUrl;
+  const pathnameLocale = locales.find(
+    (locale) => pathname.startsWith(`/${locale}/`) || pathname === `/${locale}`,
+  );
+  if (pathnameLocale === defaultLocale) {
+    const newPathname = pathname.replace(`/${defaultLocale}`, "") || "/";
+    return NextResponse.redirect(new URL(newPathname, request.url));
+  }
+  if (pathnameLocale) return;
+  request.nextUrl.pathname = `/${defaultLocale}${pathname}`;
+  return NextResponse.rewrite(request.nextUrl);
+}
+export const config = {
+  matcher: ["/((?!_next|favicon.ico).*)"],
+};
+```
+#### 3. Setup layout with provider
+```typescript
+// app/[lang]/layout.tsx
+import type { ReactNode } from "react";
+import { AppTranslationProvider } from "@onruntime/translations/next";
+import { load, locales } from "@/lib/translations";
+export async function generateStaticParams() {
+  return locales.map((lang) => ({ lang }));
+}
+export default async function RootLayout({
+  children,
+  params,
+}: {
+  children: ReactNode;
+  params: Promise<{ lang: string }>;
+}) {
+  const { lang } = await params;
+  return (
+    <html lang={lang}>
+      <body>
+        <AppTranslationProvider locale={lang} locales={locales} load={load}>
+          {children}
+        </AppTranslationProvider>
+      </body>
+    </html>
+  );
+}
+```
+#### 4. Use in Server Components
+```typescript
+// app/[lang]/page.tsx
+import { Link } from "@onruntime/translations/next";
+import { getTranslation } from "@/lib/translations";
+export default async function Home({
+  params,
+}: {
+  params: Promise<{ lang: string }>;
+}) {
+  const { t, locale } = await getTranslation(params);
+  return (
+    <div>
+      <h1>{t("greeting", { name: "John" })}</h1>
+      <Link href="/about">{t("nav.about")}</Link>
+    </div>
+  );
+}
+```
+#### 5. Use in Client Components
+```typescript
+// app/[lang]/about/page.tsx
+"use client";
+import { useTranslation, useLocale } from "@onruntime/translations/react";
+import { Link } from "@onruntime/translations/next";
+export default function About() {
+  const { t } = useTranslation();
+  const { locale } = useLocale();
+  return (
+    <div>
+      <h1>{t("about.title")}</h1>
+      <p>Current locale: {locale}</p>
+      <Link href="/">{t("nav.home")}</Link>
+    </div>
+  );
+}
+```
+### Next.js Pages Router
+#### 1. Configure i18n in next.config.js
+```javascript
+// next.config.js
+module.exports = {
+  i18n: {
+    locales: ["en", "fr"],
+    defaultLocale: "en",
+  },
+};
+```
+#### 2. Setup provider in _app.tsx
+```typescript
+// pages/_app.tsx
+import type { AppProps } from "next/app";
+import { TranslationProvider } from "@onruntime/translations/next";
+export default function App({ Component, pageProps }: AppProps) {
+  return (
+    <TranslationProvider
+      load={(locale, ns) => {
+        try {
+          return require(`@/locales/${locale}/${ns}.json`);
+        } catch {
+          return undefined;
+        }
+      }}
+    >
+      <Component {...pageProps} />
+    </TranslationProvider>
+  );
+}
+```
+#### 3. Use in pages
+```typescript
+// pages/index.tsx
+import Link from "next/link";
+import { useTranslation } from "@onruntime/translations/react";
+export default function Home() {
+  const { t, locale } = useTranslation();
+  return (
+    <div>
+      <h1>{t("greeting", { name: "John" })}</h1>
+      <Link href="/about" locale="fr">
+        Switch to French
+      </Link>
+    </div>
+  );
+}
+```
+### React + Vite
+#### 1. Setup provider with Vite loader
+```typescript
+// src/app.tsx
+import { TranslationProvider } from "@onruntime/translations/react";
+import { createViteLoader } from "@onruntime/translations/vite";
+const modules = import.meta.glob("./locales/**/*.json", { eager: true });
+const load = createViteLoader(modules);
+const App = () => {
+  return (
+    <TranslationProvider defaultLocale="en" locales={["en", "fr"]} load={load}>
+      <Demo />
+    </TranslationProvider>
+  );
+};
+export default App;
+```
+#### 2. Use translations
+```typescript
+// src/components/demo.tsx
+import { useTranslation, useLocale } from "@onruntime/translations/react";
+export const Demo = () => {
+  const { t, locale } = useTranslation();
+  const { setLocale } = useLocale();
+  return (
+    <div>
+      <h1>{t("greeting", { name: "John" })}</h1>
+      <p>Current locale: {locale}</p>
+      <button onClick={() => setLocale(locale === "en" ? "fr" : "en")}>
+        Switch language
+      </button>
+    </div>
+  );
+};
+```
+### Translation files
+```json
+// locales/en/common.json
+{
+  "greeting": "Hello, {name}!",
+  "nav": {
+    "home": "Home",
+    "about": "About"
+  },
+  "about": {
+    "title": "About Us"
+  }
+}
+```
+## License
+MIT

package/dist/chunk-5W5CCQME.cjs ADDED Viewed

@@ -0,0 +1,48 @@
+"use client";
+'use strict';
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+// src/react/contexts/translation-context.tsx
+var TranslationContext = react.createContext(
+  null
+);
+var TranslationProvider = ({
+  children,
+  locales,
+  defaultLocale,
+  load,
+  keySplit = true
+}) => {
+  if (locales.length === 0) {
+    throw new Error("TranslationProvider: locales array must not be empty");
+  }
+  const resolvedDefaultLocale = defaultLocale ?? locales[0];
+  const [locale, setLocale] = react.useState(resolvedDefaultLocale);
+  const value = react.useMemo(
+    () => ({
+      locale,
+      locales,
+      defaultLocale: resolvedDefaultLocale,
+      setLocale,
+      load,
+      keySplit
+    }),
+    [locale, locales, resolvedDefaultLocale, load, keySplit]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(TranslationContext.Provider, { value, children });
+};
+var useTranslationContext = () => {
+  const context = react.useContext(TranslationContext);
+  if (!context) {
+    throw new Error(
+      "useTranslationContext must be used within a TranslationProvider"
+    );
+  }
+  return context;
+};
+exports.TranslationContext = TranslationContext;
+exports.TranslationProvider = TranslationProvider;
+exports.useTranslationContext = useTranslationContext;

package/dist/chunk-X3HAZ4DT.js ADDED Viewed

@@ -0,0 +1,44 @@
+"use client";
+import { createContext, useState, useMemo, useContext } from 'react';
+import { jsx } from 'react/jsx-runtime';
+// src/react/contexts/translation-context.tsx
+var TranslationContext = createContext(
+  null
+);
+var TranslationProvider = ({
+  children,
+  locales,
+  defaultLocale,
+  load,
+  keySplit = true
+}) => {
+  if (locales.length === 0) {
+    throw new Error("TranslationProvider: locales array must not be empty");
+  }
+  const resolvedDefaultLocale = defaultLocale ?? locales[0];
+  const [locale, setLocale] = useState(resolvedDefaultLocale);
+  const value = useMemo(
+    () => ({
+      locale,
+      locales,
+      defaultLocale: resolvedDefaultLocale,
+      setLocale,
+      load,
+      keySplit
+    }),
+    [locale, locales, resolvedDefaultLocale, load, keySplit]
+  );
+  return /* @__PURE__ */ jsx(TranslationContext.Provider, { value, children });
+};
+var useTranslationContext = () => {
+  const context = useContext(TranslationContext);
+  if (!context) {
+    throw new Error(
+      "useTranslationContext must be used within a TranslationProvider"
+    );
+  }
+  return context;
+};
+export { TranslationContext, TranslationProvider, useTranslationContext };

package/dist/index.cjs ADDED Viewed

@@ -0,0 +1,33 @@
+'use strict';
+// src/core/translate.ts
+var createTranslate = (translation, keySplit = true) => {
+  return (key, variables) => {
+    const keyList = keySplit ? key.split(".") : [key];
+    let parent = translation;
+    for (const k of keyList) {
+      if (parent && typeof parent === "object" && k in parent) {
+        parent = parent[k];
+      } else {
+        return key;
+      }
+    }
+    if (typeof parent === "string" && variables) {
+      return parent.replace(
+        /\{(\w+)\}/g,
+        (_, name) => String(variables[name] ?? `{${name}}`)
+      );
+    }
+    return typeof parent === "string" ? parent : key;
+  };
+};
+// src/core/loader.ts
+var getTranslation = (load, locale, namespace = "common") => {
+  const dictionary = load(locale, namespace);
+  const t = createTranslate(dictionary);
+  return { t, locale };
+};
+exports.createTranslate = createTranslate;
+exports.getTranslation = getTranslation;

package/dist/index.d.cts ADDED Viewed

@@ -0,0 +1,36 @@
+type TranslationValue = string | {
+    [key: string]: TranslationValue;
+};
+type TranslationDictionary = {
+    [key: string]: TranslationValue;
+};
+type TranslationVariables = Record<string, string | number>;
+type TranslateFunction = (key: string, variables?: TranslationVariables) => string;
+type TranslationLoader = (locale: string, namespace: string) => TranslationDictionary | undefined;
+type TranslationConfig = {
+    locale: string;
+    fallbackLocale?: string;
+    keySplit?: boolean;
+};
+/**
+ * Create a translation function for a given dictionary
+ */
+declare const createTranslate: (translation: TranslationDictionary | undefined, keySplit?: boolean) => TranslateFunction;
+/**
+ * Get translation function for server components or static usage
+ *
+ * @example
+ * ```tsx
+ * // Server Component
+ * const { t } = getTranslation(load, "en");
+ * return <h1>{t("greeting", { name: "John" })}</h1>;
+ * ```
+ */
+declare const getTranslation: (load: TranslationLoader, locale: string, namespace?: string) => {
+    t: TranslateFunction;
+    locale: string;
+};
+export { type TranslateFunction, type TranslationConfig, type TranslationDictionary, type TranslationLoader, type TranslationValue, type TranslationVariables, createTranslate, getTranslation };

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,36 @@
+type TranslationValue = string | {
+    [key: string]: TranslationValue;
+};
+type TranslationDictionary = {
+    [key: string]: TranslationValue;
+};
+type TranslationVariables = Record<string, string | number>;
+type TranslateFunction = (key: string, variables?: TranslationVariables) => string;
+type TranslationLoader = (locale: string, namespace: string) => TranslationDictionary | undefined;
+type TranslationConfig = {
+    locale: string;
+    fallbackLocale?: string;
+    keySplit?: boolean;
+};
+/**
+ * Create a translation function for a given dictionary
+ */
+declare const createTranslate: (translation: TranslationDictionary | undefined, keySplit?: boolean) => TranslateFunction;
+/**
+ * Get translation function for server components or static usage
+ *
+ * @example
+ * ```tsx
+ * // Server Component
+ * const { t } = getTranslation(load, "en");
+ * return <h1>{t("greeting", { name: "John" })}</h1>;
+ * ```
+ */
+declare const getTranslation: (load: TranslationLoader, locale: string, namespace?: string) => {
+    t: TranslateFunction;
+    locale: string;
+};
+export { type TranslateFunction, type TranslationConfig, type TranslationDictionary, type TranslationLoader, type TranslationValue, type TranslationVariables, createTranslate, getTranslation };

package/dist/index.js ADDED Viewed

@@ -0,0 +1,30 @@
+// src/core/translate.ts
+var createTranslate = (translation, keySplit = true) => {
+  return (key, variables) => {
+    const keyList = keySplit ? key.split(".") : [key];
+    let parent = translation;
+    for (const k of keyList) {
+      if (parent && typeof parent === "object" && k in parent) {
+        parent = parent[k];
+      } else {
+        return key;
+      }
+    }
+    if (typeof parent === "string" && variables) {
+      return parent.replace(
+        /\{(\w+)\}/g,
+        (_, name) => String(variables[name] ?? `{${name}}`)
+      );
+    }
+    return typeof parent === "string" ? parent : key;
+  };
+};
+// src/core/loader.ts
+var getTranslation = (load, locale, namespace = "common") => {
+  const dictionary = load(locale, namespace);
+  const t = createTranslate(dictionary);
+  return { t, locale };
+};
+export { createTranslate, getTranslation };

package/dist/next/index.cjs ADDED Viewed

@@ -0,0 +1,96 @@
+"use client";
+'use strict';
+var chunk5W5CCQME_cjs = require('../chunk-5W5CCQME.cjs');
+var react = require('react');
+var router = require('next/router');
+var jsxRuntime = require('react/jsx-runtime');
+var navigation = require('next/navigation');
+var NextLink = require('next/link');
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+var NextLink__default = /*#__PURE__*/_interopDefault(NextLink);
+var NextTranslationProvider = ({
+  children,
+  load,
+  keySplit = true
+}) => {
+  const router$1 = router.useRouter();
+  const locale = router$1.locale ?? "en";
+  const locales = router$1.locales ?? ["en"];
+  const defaultLocale = router$1.defaultLocale ?? "en";
+  const value = react.useMemo(
+    () => ({
+      locale,
+      locales,
+      defaultLocale,
+      setLocale: (newLocale) => {
+        router$1.push(router$1.pathname, router$1.asPath, { locale: newLocale });
+      },
+      load,
+      keySplit
+    }),
+    [locale, locales, defaultLocale, router$1, load, keySplit]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(chunk5W5CCQME_cjs.TranslationContext.Provider, { value, children });
+};
+var AppTranslationProvider = ({
+  children,
+  locale,
+  locales,
+  defaultLocale,
+  load,
+  keySplit = true
+}) => {
+  if (locales.length === 0) {
+    throw new Error("AppTranslationProvider: locales array must not be empty");
+  }
+  const router = navigation.useRouter();
+  const pathname = navigation.usePathname();
+  const value = react.useMemo(
+    () => ({
+      locale,
+      locales,
+      defaultLocale: defaultLocale ?? locales[0],
+      setLocale: (newLocale) => {
+        const segments = pathname.split("/");
+        segments[1] = newLocale;
+        router.push(segments.join("/"));
+      },
+      load,
+      keySplit
+    }),
+    [locale, locales, defaultLocale, pathname, router, load, keySplit]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(chunk5W5CCQME_cjs.TranslationContext.Provider, { value, children });
+};
+var Link = ({ href, locale, ...props }) => {
+  const { locale: currentLocale, defaultLocale } = chunk5W5CCQME_cjs.useTranslationContext();
+  const targetLocale = locale ?? currentLocale;
+  if (typeof href === "string") {
+    if (href.startsWith("http") || href.startsWith("//")) {
+      return /* @__PURE__ */ jsxRuntime.jsx(NextLink__default.default, { href, ...props });
+    }
+    if (targetLocale === defaultLocale) {
+      const cleanHref = href.startsWith("/") ? href : `/${href}`;
+      return /* @__PURE__ */ jsxRuntime.jsx(NextLink__default.default, { href: cleanHref, ...props });
+    }
+    const localizedHref2 = href.startsWith("/") ? `/${targetLocale}${href}` : `/${targetLocale}/${href}`;
+    return /* @__PURE__ */ jsxRuntime.jsx(NextLink__default.default, { href: localizedHref2, ...props });
+  }
+  const pathname = href.pathname ?? "/";
+  if (targetLocale === defaultLocale) {
+    return /* @__PURE__ */ jsxRuntime.jsx(NextLink__default.default, { href, ...props });
+  }
+  const localizedHref = {
+    ...href,
+    pathname: pathname.startsWith("/") ? `/${targetLocale}${pathname}` : `/${targetLocale}/${pathname}`
+  };
+  return /* @__PURE__ */ jsxRuntime.jsx(NextLink__default.default, { href: localizedHref, ...props });
+};
+exports.AppTranslationProvider = AppTranslationProvider;
+exports.Link = Link;
+exports.TranslationProvider = NextTranslationProvider;

package/dist/next/index.d.cts ADDED Viewed

@@ -0,0 +1,38 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode, ComponentProps } from 'react';
+import { T as TranslationLoader } from '../types-BpDtTtSF.cjs';
+import NextLink from 'next/link';
+type NextTranslationProviderProps = {
+    children: ReactNode;
+    load: TranslationLoader;
+    keySplit?: boolean;
+};
+/**
+ * Translation provider for Next.js applications
+ * Automatically uses locale info from Next.js router
+ */
+declare const NextTranslationProvider: ({ children, load, keySplit, }: NextTranslationProviderProps) => react_jsx_runtime.JSX.Element;
+type AppTranslationProviderProps = {
+    children: ReactNode;
+    locale: string;
+    locales: readonly string[];
+    defaultLocale?: string;
+    load: TranslationLoader;
+    keySplit?: boolean;
+};
+/**
+ * Translation provider for Next.js App Router
+ * Locale is passed from route params [lang]
+ */
+declare const AppTranslationProvider: ({ children, locale, locales, defaultLocale, load, keySplit, }: AppTranslationProviderProps) => react_jsx_runtime.JSX.Element;
+type LinkProps = ComponentProps<typeof NextLink>;
+/**
+ * Link component that automatically prefixes href with the current locale.
+ * For the default locale, no prefix is added (Pages Router behavior).
+ */
+declare const Link: ({ href, locale, ...props }: LinkProps) => react_jsx_runtime.JSX.Element;
+export { AppTranslationProvider, type AppTranslationProviderProps, Link, type LinkProps, NextTranslationProvider as TranslationProvider, type NextTranslationProviderProps as TranslationProviderProps };

package/dist/next/index.d.ts ADDED Viewed

@@ -0,0 +1,38 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode, ComponentProps } from 'react';
+import { T as TranslationLoader } from '../types-BpDtTtSF.js';
+import NextLink from 'next/link';
+type NextTranslationProviderProps = {
+    children: ReactNode;
+    load: TranslationLoader;
+    keySplit?: boolean;
+};
+/**
+ * Translation provider for Next.js applications
+ * Automatically uses locale info from Next.js router
+ */
+declare const NextTranslationProvider: ({ children, load, keySplit, }: NextTranslationProviderProps) => react_jsx_runtime.JSX.Element;
+type AppTranslationProviderProps = {
+    children: ReactNode;
+    locale: string;
+    locales: readonly string[];
+    defaultLocale?: string;
+    load: TranslationLoader;
+    keySplit?: boolean;
+};
+/**
+ * Translation provider for Next.js App Router
+ * Locale is passed from route params [lang]
+ */
+declare const AppTranslationProvider: ({ children, locale, locales, defaultLocale, load, keySplit, }: AppTranslationProviderProps) => react_jsx_runtime.JSX.Element;
+type LinkProps = ComponentProps<typeof NextLink>;
+/**
+ * Link component that automatically prefixes href with the current locale.
+ * For the default locale, no prefix is added (Pages Router behavior).
+ */
+declare const Link: ({ href, locale, ...props }: LinkProps) => react_jsx_runtime.JSX.Element;
+export { AppTranslationProvider, type AppTranslationProviderProps, Link, type LinkProps, NextTranslationProvider as TranslationProvider, type NextTranslationProviderProps as TranslationProviderProps };

package/dist/next/index.js ADDED Viewed

@@ -0,0 +1,88 @@
+"use client";
+import { TranslationContext, useTranslationContext } from '../chunk-X3HAZ4DT.js';
+import { useMemo } from 'react';
+import { useRouter } from 'next/router';
+import { jsx } from 'react/jsx-runtime';
+import { useRouter as useRouter$1, usePathname } from 'next/navigation';
+import NextLink from 'next/link';
+var NextTranslationProvider = ({
+  children,
+  load,
+  keySplit = true
+}) => {
+  const router = useRouter();
+  const locale = router.locale ?? "en";
+  const locales = router.locales ?? ["en"];
+  const defaultLocale = router.defaultLocale ?? "en";
+  const value = useMemo(
+    () => ({
+      locale,
+      locales,
+      defaultLocale,
+      setLocale: (newLocale) => {
+        router.push(router.pathname, router.asPath, { locale: newLocale });
+      },
+      load,
+      keySplit
+    }),
+    [locale, locales, defaultLocale, router, load, keySplit]
+  );
+  return /* @__PURE__ */ jsx(TranslationContext.Provider, { value, children });
+};
+var AppTranslationProvider = ({
+  children,
+  locale,
+  locales,
+  defaultLocale,
+  load,
+  keySplit = true
+}) => {
+  if (locales.length === 0) {
+    throw new Error("AppTranslationProvider: locales array must not be empty");
+  }
+  const router = useRouter$1();
+  const pathname = usePathname();
+  const value = useMemo(
+    () => ({
+      locale,
+      locales,
+      defaultLocale: defaultLocale ?? locales[0],
+      setLocale: (newLocale) => {
+        const segments = pathname.split("/");
+        segments[1] = newLocale;
+        router.push(segments.join("/"));
+      },
+      load,
+      keySplit
+    }),
+    [locale, locales, defaultLocale, pathname, router, load, keySplit]
+  );
+  return /* @__PURE__ */ jsx(TranslationContext.Provider, { value, children });
+};
+var Link = ({ href, locale, ...props }) => {
+  const { locale: currentLocale, defaultLocale } = useTranslationContext();
+  const targetLocale = locale ?? currentLocale;
+  if (typeof href === "string") {
+    if (href.startsWith("http") || href.startsWith("//")) {
+      return /* @__PURE__ */ jsx(NextLink, { href, ...props });
+    }
+    if (targetLocale === defaultLocale) {
+      const cleanHref = href.startsWith("/") ? href : `/${href}`;
+      return /* @__PURE__ */ jsx(NextLink, { href: cleanHref, ...props });
+    }
+    const localizedHref2 = href.startsWith("/") ? `/${targetLocale}${href}` : `/${targetLocale}/${href}`;
+    return /* @__PURE__ */ jsx(NextLink, { href: localizedHref2, ...props });
+  }
+  const pathname = href.pathname ?? "/";
+  if (targetLocale === defaultLocale) {
+    return /* @__PURE__ */ jsx(NextLink, { href, ...props });
+  }
+  const localizedHref = {
+    ...href,
+    pathname: pathname.startsWith("/") ? `/${targetLocale}${pathname}` : `/${targetLocale}/${pathname}`
+  };
+  return /* @__PURE__ */ jsx(NextLink, { href: localizedHref, ...props });
+};
+export { AppTranslationProvider, Link, NextTranslationProvider as TranslationProvider };

package/dist/react/index.cjs ADDED Viewed

@@ -0,0 +1,72 @@
+"use client";
+'use strict';
+var chunk5W5CCQME_cjs = require('../chunk-5W5CCQME.cjs');
+var react = require('react');
+// src/react/hooks/use-locale.ts
+var useLocale = () => {
+  const { locale, locales, setLocale } = chunk5W5CCQME_cjs.useTranslationContext();
+  return { locale, locales, setLocale };
+};
+// src/core/translate.ts
+var createTranslate = (translation, keySplit = true) => {
+  return (key, variables) => {
+    const keyList = keySplit ? key.split(".") : [key];
+    let parent = translation;
+    for (const k of keyList) {
+      if (parent && typeof parent === "object" && k in parent) {
+        parent = parent[k];
+      } else {
+        return key;
+      }
+    }
+    if (typeof parent === "string" && variables) {
+      return parent.replace(
+        /\{(\w+)\}/g,
+        (_, name) => String(variables[name] ?? `{${name}}`)
+      );
+    }
+    return typeof parent === "string" ? parent : key;
+  };
+};
+// src/react/hooks/use-translation-loader.ts
+var useTranslationLoader = (namespace) => {
+  const { locale, defaultLocale, load, keySplit } = chunk5W5CCQME_cjs.useTranslationContext();
+  const translation = react.useMemo(() => {
+    let dict = load(locale, namespace);
+    if (!dict && defaultLocale !== locale) {
+      dict = load(defaultLocale, namespace);
+    }
+    return dict;
+  }, [locale, defaultLocale, namespace, load]);
+  const t = react.useMemo(
+    () => createTranslate(translation, keySplit),
+    [translation, keySplit]
+  );
+  return { translation, t, locale };
+};
+// src/react/hooks/use-translation.ts
+var useTranslation = (namespace = "common") => {
+  const { t, locale } = useTranslationLoader(namespace);
+  return { t, locale };
+};
+Object.defineProperty(exports, "TranslationContext", {
+  enumerable: true,
+  get: function () { return chunk5W5CCQME_cjs.TranslationContext; }
+});
+Object.defineProperty(exports, "TranslationProvider", {
+  enumerable: true,
+  get: function () { return chunk5W5CCQME_cjs.TranslationProvider; }
+});
+Object.defineProperty(exports, "useTranslationContext", {
+  enumerable: true,
+  get: function () { return chunk5W5CCQME_cjs.useTranslationContext; }
+});
+exports.useLocale = useLocale;
+exports.useTranslation = useTranslation;
+exports.useTranslationLoader = useTranslationLoader;

package/dist/react/index.d.cts ADDED Viewed

@@ -0,0 +1,44 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { T as TranslationLoader, a as TranslationDictionary, b as TranslateFunction } from '../types-BpDtTtSF.cjs';
+type TranslationContextValue = {
+    locale: string;
+    locales: readonly string[];
+    defaultLocale: string;
+    setLocale: (locale: string) => void;
+    load: TranslationLoader;
+    keySplit?: boolean;
+};
+declare const TranslationContext: react.Context<TranslationContextValue | null>;
+type TranslationProviderProps = {
+    children: ReactNode;
+    locales: readonly string[];
+    defaultLocale?: string;
+    load: TranslationLoader;
+    keySplit?: boolean;
+};
+declare const TranslationProvider: ({ children, locales, defaultLocale, load, keySplit, }: TranslationProviderProps) => react_jsx_runtime.JSX.Element;
+declare const useTranslationContext: () => TranslationContextValue;
+declare const useLocale: () => {
+    locale: string;
+    locales: readonly string[];
+    setLocale: (locale: string) => void;
+};
+declare const useTranslationLoader: (namespace: string) => {
+    translation: TranslationDictionary | undefined;
+    t: TranslateFunction;
+    locale: string;
+};
+type UseTranslationResult = {
+    t: TranslateFunction;
+    locale: string;
+};
+declare const useTranslation: (namespace?: string) => UseTranslationResult;
+export { TranslationContext, type TranslationContextValue, TranslationProvider, type TranslationProviderProps, type UseTranslationResult, useLocale, useTranslation, useTranslationContext, useTranslationLoader };

package/dist/react/index.d.ts ADDED Viewed

@@ -0,0 +1,44 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { T as TranslationLoader, a as TranslationDictionary, b as TranslateFunction } from '../types-BpDtTtSF.js';
+type TranslationContextValue = {
+    locale: string;
+    locales: readonly string[];
+    defaultLocale: string;
+    setLocale: (locale: string) => void;
+    load: TranslationLoader;
+    keySplit?: boolean;
+};
+declare const TranslationContext: react.Context<TranslationContextValue | null>;
+type TranslationProviderProps = {
+    children: ReactNode;
+    locales: readonly string[];
+    defaultLocale?: string;
+    load: TranslationLoader;
+    keySplit?: boolean;
+};
+declare const TranslationProvider: ({ children, locales, defaultLocale, load, keySplit, }: TranslationProviderProps) => react_jsx_runtime.JSX.Element;
+declare const useTranslationContext: () => TranslationContextValue;
+declare const useLocale: () => {
+    locale: string;
+    locales: readonly string[];
+    setLocale: (locale: string) => void;
+};
+declare const useTranslationLoader: (namespace: string) => {
+    translation: TranslationDictionary | undefined;
+    t: TranslateFunction;
+    locale: string;
+};
+type UseTranslationResult = {
+    t: TranslateFunction;
+    locale: string;
+};
+declare const useTranslation: (namespace?: string) => UseTranslationResult;
+export { TranslationContext, type TranslationContextValue, TranslationProvider, type TranslationProviderProps, type UseTranslationResult, useLocale, useTranslation, useTranslationContext, useTranslationLoader };

package/dist/react/index.js ADDED Viewed

@@ -0,0 +1,57 @@
+"use client";
+import { useTranslationContext } from '../chunk-X3HAZ4DT.js';
+export { TranslationContext, TranslationProvider, useTranslationContext } from '../chunk-X3HAZ4DT.js';
+import { useMemo } from 'react';
+// src/react/hooks/use-locale.ts
+var useLocale = () => {
+  const { locale, locales, setLocale } = useTranslationContext();
+  return { locale, locales, setLocale };
+};
+// src/core/translate.ts
+var createTranslate = (translation, keySplit = true) => {
+  return (key, variables) => {
+    const keyList = keySplit ? key.split(".") : [key];
+    let parent = translation;
+    for (const k of keyList) {
+      if (parent && typeof parent === "object" && k in parent) {
+        parent = parent[k];
+      } else {
+        return key;
+      }
+    }
+    if (typeof parent === "string" && variables) {
+      return parent.replace(
+        /\{(\w+)\}/g,
+        (_, name) => String(variables[name] ?? `{${name}}`)
+      );
+    }
+    return typeof parent === "string" ? parent : key;
+  };
+};
+// src/react/hooks/use-translation-loader.ts
+var useTranslationLoader = (namespace) => {
+  const { locale, defaultLocale, load, keySplit } = useTranslationContext();
+  const translation = useMemo(() => {
+    let dict = load(locale, namespace);
+    if (!dict && defaultLocale !== locale) {
+      dict = load(defaultLocale, namespace);
+    }
+    return dict;
+  }, [locale, defaultLocale, namespace, load]);
+  const t = useMemo(
+    () => createTranslate(translation, keySplit),
+    [translation, keySplit]
+  );
+  return { translation, t, locale };
+};
+// src/react/hooks/use-translation.ts
+var useTranslation = (namespace = "common") => {
+  const { t, locale } = useTranslationLoader(namespace);
+  return { t, locale };
+};
+export { useLocale, useTranslation, useTranslationLoader };

package/dist/types-BpDtTtSF.d.cts ADDED Viewed

@@ -0,0 +1,11 @@
+type TranslationValue = string | {
+    [key: string]: TranslationValue;
+};
+type TranslationDictionary = {
+    [key: string]: TranslationValue;
+};
+type TranslationVariables = Record<string, string | number>;
+type TranslateFunction = (key: string, variables?: TranslationVariables) => string;
+type TranslationLoader = (locale: string, namespace: string) => TranslationDictionary | undefined;
+export type { TranslationLoader as T, TranslationDictionary as a, TranslateFunction as b };

package/dist/types-BpDtTtSF.d.ts ADDED Viewed

@@ -0,0 +1,11 @@
+type TranslationValue = string | {
+    [key: string]: TranslationValue;
+};
+type TranslationDictionary = {
+    [key: string]: TranslationValue;
+};
+type TranslationVariables = Record<string, string | number>;
+type TranslateFunction = (key: string, variables?: TranslationVariables) => string;
+type TranslationLoader = (locale: string, namespace: string) => TranslationDictionary | undefined;
+export type { TranslationLoader as T, TranslationDictionary as a, TranslateFunction as b };

package/dist/vite/index.cjs ADDED Viewed

@@ -0,0 +1,18 @@
+'use strict';
+// src/vite/loader.ts
+var createViteLoader = (modules, basePath = "./locales") => {
+  return (locale, namespace) => {
+    const path = `${basePath}/${locale}/${namespace}.json`;
+    const module = modules[path];
+    if (!module) {
+      return void 0;
+    }
+    if (typeof module === "object" && "default" in module) {
+      return module.default;
+    }
+    return module;
+  };
+};
+exports.createViteLoader = createViteLoader;

package/dist/vite/index.d.cts ADDED Viewed

@@ -0,0 +1,20 @@
+type TranslationValue = string | {
+    [key: string]: TranslationValue;
+};
+type TranslationDictionary = {
+    [key: string]: TranslationValue;
+};
+type TranslationLoader = (locale: string, namespace: string) => TranslationDictionary | undefined;
+/**
+ * Create a translation loader from Vite's import.meta.glob result
+ *
+ * @example
+ * ```ts
+ * const modules = import.meta.glob('./locales/*.json', { eager: true });
+ * const load = createViteLoader(modules);
+ * ```
+ */
+declare const createViteLoader: (modules: Record<string, unknown>, basePath?: string) => TranslationLoader;
+export { createViteLoader };

package/dist/vite/index.d.ts ADDED Viewed

@@ -0,0 +1,20 @@
+type TranslationValue = string | {
+    [key: string]: TranslationValue;
+};
+type TranslationDictionary = {
+    [key: string]: TranslationValue;
+};
+type TranslationLoader = (locale: string, namespace: string) => TranslationDictionary | undefined;
+/**
+ * Create a translation loader from Vite's import.meta.glob result
+ *
+ * @example
+ * ```ts
+ * const modules = import.meta.glob('./locales/*.json', { eager: true });
+ * const load = createViteLoader(modules);
+ * ```
+ */
+declare const createViteLoader: (modules: Record<string, unknown>, basePath?: string) => TranslationLoader;
+export { createViteLoader };

package/dist/vite/index.js ADDED Viewed

@@ -0,0 +1,16 @@
+// src/vite/loader.ts
+var createViteLoader = (modules, basePath = "./locales") => {
+  return (locale, namespace) => {
+    const path = `${basePath}/${locale}/${namespace}.json`;
+    const module = modules[path];
+    if (!module) {
+      return void 0;
+    }
+    if (typeof module === "object" && "default" in module) {
+      return module.default;
+    }
+    return module;
+  };
+};
+export { createViteLoader };

package/package.json ADDED Viewed

@@ -0,0 +1,79 @@
+{
+  "name": "@onruntime/translations",
+  "version": "0.1.0",
+  "description": "Lightweight i18n library for React, Next.js, and React Native",
+  "author": "onRuntime Studio <contact@onruntime.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/onRuntime/onruntime.git",
+    "directory": "packages/translations"
+  },
+  "homepage": "https://github.com/onRuntime/onruntime/tree/master/packages/translations#readme",
+  "bugs": {
+    "url": "https://github.com/onRuntime/onruntime/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js",
+      "require": "./dist/react/index.cjs"
+    },
+    "./next": {
+      "types": "./dist/next/index.d.ts",
+      "import": "./dist/next/index.js",
+      "require": "./dist/next/index.cjs"
+    },
+    "./vite": {
+      "types": "./dist/vite/index.d.ts",
+      "import": "./dist/vite/index.js",
+      "require": "./dist/vite/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    },
+    "react-native": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "@types/react": "^19",
+    "next": "^16.1.1",
+    "react": "^19.2.3",
+    "tsup": "^8",
+    "typescript": "^5"
+  },
+  "keywords": [
+    "i18n",
+    "translations",
+    "react",
+    "nextjs",
+    "react-native",
+    "internationalization"
+  ],
+  "license": "MIT"
+}