@better-i18n/vite 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { betterI18n } from "./plugin.js";
+export type { BetterI18nPluginOptions } from "./plugin.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { betterI18n } from "./plugin.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,57 @@
+import type { Plugin } from "vite";
+export interface BetterI18nPluginOptions {
+    /**
+     * Project identifier in "org/project" format.
+     * This is the single source of truth — `BetterI18nProvider` reads it
+     * from the injected `<script>` tag, so you don't need to pass it as a prop.
+     *
+     * @example "acme/dashboard"
+     */
+    project: string;
+    /**
+     * Default locale when no locale is detected from URL, cookie, or Accept-Language.
+     * @default "en"
+     */
+    defaultLocale?: string;
+    /**
+     * Cookie name used to persist the user's locale preference.
+     * @default "locale"
+     */
+    localeCookie?: string;
+    /**
+     * CDN base URL override.
+     * @default "https://cdn.better-i18n.com"
+     */
+    cdnBaseUrl?: string;
+}
+/**
+ * Vite plugin for Better i18n — server-side translation injection.
+ *
+ * Fetches translations on the server (dev server or build) and injects
+ * them into the HTML as a `<script id="__better_i18n__">` tag.
+ * `BetterI18nProvider` reads this data synchronously on first render,
+ * eliminating FOUC (Flash of Untranslated Content).
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { betterI18n } from '@better-i18n/vite'
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     betterI18n({ project: 'acme/dashboard' }),
+ *     react(),
+ *   ],
+ * })
+ * ```
+ *
+ * Then in your app — no project/locale/messages props needed:
+ * ```tsx
+ * <BetterI18nProvider>
+ *   <LocaleDropdown />
+ *   <App />
+ * </BetterI18nProvider>
+ * ```
+ */
+export declare function betterI18n(options: BetterI18nPluginOptions): Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,MAAM,WAAW,uBAAuB;IACtC;;;;;;OAMG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CA8EnE"}

package/dist/plugin.js

@@ -0,0 +1,135 @@
+import { createI18nCore, normalizeLocale } from "@better-i18n/core";
+/**
+ * Vite plugin for Better i18n — server-side translation injection.
+ *
+ * Fetches translations on the server (dev server or build) and injects
+ * them into the HTML as a `<script id="__better_i18n__">` tag.
+ * `BetterI18nProvider` reads this data synchronously on first render,
+ * eliminating FOUC (Flash of Untranslated Content).
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { betterI18n } from '@better-i18n/vite'
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     betterI18n({ project: 'acme/dashboard' }),
+ *     react(),
+ *   ],
+ * })
+ * ```
+ *
+ * Then in your app — no project/locale/messages props needed:
+ * ```tsx
+ * <BetterI18nProvider>
+ *   <LocaleDropdown />
+ *   <App />
+ * </BetterI18nProvider>
+ * ```
+ */
+export function betterI18n(options) {
+    const { project, defaultLocale = "en", localeCookie = "locale", cdnBaseUrl, } = options;
+    // Singleton core instance — TtlCache shared across requests
+    const i18nCore = createI18nCore({
+        project,
+        defaultLocale,
+        cdnBaseUrl,
+    });
+    // Request-scoped locale detection (middleware → transformIndexHtml bridge)
+    const requestLocales = new Map();
+    return {
+        name: "better-i18n",
+        configureServer(server) {
+            // Middleware runs BEFORE Vite serves HTML — detects locale from request
+            server.middlewares.use((req, _res, next) => {
+                if (!req.url)
+                    return next();
+                const locale = detectLocaleFromRequest(req.headers.cookie, req.headers["accept-language"], req.url, localeCookie, defaultLocale);
+                requestLocales.set(req.url, locale);
+                next();
+            });
+        },
+        transformIndexHtml: {
+            order: "pre",
+            handler: async (_html, ctx) => {
+                // Resolve locale: middleware-detected → default
+                const requestUrl = ctx.originalUrl || ctx.path;
+                const locale = requestLocales.get(requestUrl) || defaultLocale;
+                requestLocales.delete(requestUrl);
+                // Fetch translations + languages server-side (TtlCache makes this fast)
+                const [messages, languages] = await Promise.all([
+                    i18nCore.getMessages(locale),
+                    i18nCore.getLanguages(),
+                ]);
+                // Inject as <script> tag — provider reads this synchronously
+                const payload = JSON.stringify({
+                    project,
+                    locale,
+                    messages,
+                    languages,
+                });
+                return {
+                    html: _html,
+                    tags: [
+                        {
+                            tag: "script",
+                            attrs: {
+                                id: "__better_i18n__",
+                                type: "application/json",
+                            },
+                            children: payload,
+                            injectTo: "head",
+                        },
+                    ],
+                };
+            },
+        },
+    };
+}
+// ─── Locale Detection ─────────────────────────────────────────────
+/**
+ * Detect locale from request context.
+ * Priority: URL path segment → cookie → Accept-Language → default
+ */
+function detectLocaleFromRequest(cookieHeader, acceptLanguageHeader, url, cookieName, defaultLocale) {
+    // 1. URL path locale (e.g., /tr/about → "tr")
+    const pathname = url.split("?")[0] || "/";
+    const segments = pathname.split("/").filter(Boolean);
+    const firstSegment = segments[0];
+    if (firstSegment && /^[a-z]{2}(-[a-z]{2,4})?$/i.test(firstSegment)) {
+        return normalizeLocale(firstSegment);
+    }
+    // 2. Cookie locale
+    const cookieLocale = parseCookieValue(cookieHeader, cookieName);
+    if (cookieLocale) {
+        return normalizeLocale(cookieLocale);
+    }
+    // 3. Accept-Language header (first match)
+    if (acceptLanguageHeader) {
+        const preferred = parseAcceptLanguageFirst(acceptLanguageHeader);
+        if (preferred) {
+            return normalizeLocale(preferred);
+        }
+    }
+    return defaultLocale;
+}
+/** Extract a single cookie value by name */
+function parseCookieValue(header, name) {
+    if (!header)
+        return null;
+    const match = header.match(new RegExp(`(?:^|;\\s*)${name}=([^;]*)`));
+    return match?.[1]?.trim() || null;
+}
+/** Extract the highest-priority language from Accept-Language header */
+function parseAcceptLanguageFirst(header) {
+    const first = header.split(",")[0];
+    if (!first)
+        return null;
+    const tag = first.split(";")[0]?.trim();
+    if (!tag || tag === "*")
+        return null;
+    // Return base language (e.g., "tr-TR" → "tr")
+    return tag.split("-")[0] || null;
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@better-i18n/vite",
+  "version": "0.1.0",
+  "description": "Vite plugin for Better i18n — SSR translation injection, zero FOUC",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/better-i18n/better-i18n.git",
+    "directory": "packages/vite"
+  },
+  "bugs": {
+    "url": "https://github.com/better-i18n/better-i18n/issues"
+  },
+  "homepage": "https://github.com/better-i18n/better-i18n/tree/main/packages/vite",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "i18n",
+    "localization",
+    "vite",
+    "vite-plugin",
+    "ssr",
+    "better-i18n"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "bun run build"
+  },
+  "dependencies": {
+    "@better-i18n/core": "^0.3.0"
+  },
+  "peerDependencies": {
+    "vite": ">=5.0.0"
+  },
+  "devDependencies": {
+    "vite": "^6.3.5",
+    "typescript": "~5.9.2"
+  }
+}