rosetta-i18n 1.0.0-beta.1 → 1.0.0-beta.2

package/README.md

@@ -25,6 +25,7 @@ npx rosetta check     # CI gate: fails if anything is stale or broken (no API ke
 ## Contents
 
 - [Quick start](#quick-start)
+- [Set up with your AI agent](#set-up-with-your-ai-agent)
 - [How it works](#how-it-works)
 - [Configuration](#configuration)
 - [Commands](#commands)
@@ -33,6 +34,7 @@ npx rosetta check     # CI gate: fails if anything is stale or broken (no API ke
 - [Coming from Lingo.dev](#coming-from-lingodev)
 - [Library API](#library-api)
 - [React & Next.js](#react--nextjs)
+- [Locale routing & cookies](#locale-routing--cookies)
 - [Development](#development)
 
 ## Quick start
@@ -68,6 +70,26 @@ Already have translations? The first `push` **adopts** them — it records them
 the lockfile without retranslating, so it's free. Only strings that are missing,
 changed, or broken go to the model.
 
+## Set up with your AI agent
+
+Copy this into your coding agent (Claude Code, Cursor, Codex, opencode, …) from your
+project root:
+
+```text
+Set up Rosetta (npm: rosetta-i18n) for translations in this repo. Follow https://raw.githubusercontent.com/ian/rosetta/main/skills/rosetta/SKILL.md step by step: discover our locale files and current translation setup and report back, configure .rosetta/config.json, adopt our existing translations with `rosetta status` + `rosetta push` (list any translations it flags as broken), add tests and CI, remove the old translation tooling, document the workflow in AGENTS.md, and open one PR. Ask me before running `push --force`, before any large translation run, and before choosing how translations land if it's unclear.
+```
+
+- For agents that can't fetch URLs, use the full, self-contained prompt in
+  [`docs/agent-prompt.md`](docs/agent-prompt.md).
+- To give your agent Rosetta know-how for everyday requests ("add a German string",
+  "why is the i18n job red?"), install the skill:
+
+  ```bash
+  mkdir -p .claude/skills/rosetta && curl -fsSL https://raw.githubusercontent.com/ian/rosetta/main/skills/rosetta/SKILL.md -o .claude/skills/rosetta/SKILL.md
+  ```
+
+  Other agents: [`docs/agent-prompt.md#install-the-skill`](docs/agent-prompt.md#install-the-skill).
+
 ## How it works
 
 Rosetta keeps a lockfile, `.rosetta/lock.json`, that records — for every file,
@@ -534,6 +556,119 @@ the route handler or Server Action above.
 > Node-only workflow (`push`, `check`, …, which read and write files), so prefer the
 > `next` entrypoint in edge code.
 
+## Locale routing & cookies
+
+Translating strings is half the job. Knowing *which* locale a request is in — and
+switching cleanly — is the other half, and it's where most apps hand-roll fragile
+middleware, server actions, and `router.refresh()` races. Rosetta ships the runtime
+layer too: `rosetta-i18n/locale` (core), `/react`, `/next`, `/astro`.
+
+The model is one-directional and needs no client-side guessing:
+
+1. a **locale-prefixed URL** (`/ja/pricing`) is authoritative,
+2. then a **forced header** (`x-rosetta-locale`, set by middleware),
+3. then the **cookie**,
+4. then the **default locale**.
+
+**Switching writes the cookie and navigates to the localized URL**, so the URL and the
+cookie always agree. A full-page navigation makes it a single request with no
+refresh-after-push race.
+
+### Config (plain data)
+
+```ts
+// i18n/config.ts
+import type { LocaleConfig } from "rosetta-i18n/locale";
+
+export const localeConfig: LocaleConfig = {
+	locales: ["en", "ja", "de", "es"],
+	defaultLocale: "en",
+	// Only these paths have localized variants; everything else stays bare.
+	localizedPaths: ["/", "/pricing", "/agents"],
+	localizedPathPrefixes: ["/blog/", "/help/", "/vs/"],
+};
+```
+
+The core also exports the pure helpers (`resolveLocale`, `stripLocale`, `localizePath`,
+`planSwitch`, `serializeLocaleCookie`, …) if you're wiring your own framework.
+
+### React
+
+```tsx
+"use client";
+import { LocaleProvider, LocaleSwitcher } from "rosetta-i18n/react";
+
+export function App({ locale, children }: { locale: string; children: React.ReactNode }) {
+	return (
+		<LocaleProvider config={localeConfig} locale={locale}>
+			{/* or render={({ locales, locale, switchTo, labelFor }) => …} */}
+			<LocaleSwitcher />
+			{children}
+		</LocaleProvider>
+	);
+}
+```
+
+Hooks: `useLocale()`, `useLocales()`, `useLocaleSwitch()`, `useLocaleContext()`.
+`switchTo(locale)` writes the cookie and navigates (full page by default; pass
+`navigate` to hook a router, `persist` to save server-side).
+
+### Next.js (App Router)
+
+```ts
+// middleware.ts
+import { createLocaleMiddleware } from "rosetta-i18n/next";
+import { localeConfig } from "./i18n/config";
+
+export const middleware = createLocaleMiddleware(localeConfig);
+export const config = { matcher: ["/((?!_next|favicon.ico|.*\\..*).*)"] };
+```
+
+```tsx
+// app/layout.tsx
+import { RosettaProvider } from "rosetta-i18n/next";
+import { localeConfig } from "@/i18n/config";
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+	return (
+		<html>
+			<body>
+				<RosettaProvider config={localeConfig}>{children}</RosettaProvider>
+			</body>
+		</html>
+	);
+}
+```
+
+`RosettaProvider` reads the locale the middleware forced (`getServerLocale(config)`)
+and provides it to the client. Persist the choice for signed-in users with a server
+action:
+
+```ts
+// app/locale-actions.ts
+"use server";
+import { createSetLocaleAction } from "rosetta-i18n/next";
+import { localeConfig } from "@/i18n/config";
+
+export const setLocale = createSetLocaleAction(localeConfig, {
+	persist: (locale) => updateUserProfile(userId, { locale }),
+});
+```
+
+### Astro
+
+```ts
+// src/middleware.ts
+import { createAstroLocaleMiddleware } from "rosetta-i18n/astro";
+import { localeConfig } from "../i18n/config";
+
+export const onRequest = createAstroLocaleMiddleware(localeConfig);
+```
+
+The middleware sets `Astro.locals.locale` (read it with `getAstroLocale(Astro, config)`)
+and rewrites prefixed URLs. For a switcher, render the React `<LocaleSwitcher>` as an
+island wrapped in `<LocaleProvider locale={Astro.locals.locale} config={localeConfig}>`.
+
 ## Legacy `translate-catalog`
 
 The 0.x one-shot command still works but is deprecated and will be removed in v2:
@@ -593,6 +728,9 @@ Source lives in `src/`: the translation engine in `src/rosetta.ts`, validation i
 in `src/cli.ts`. `rollup` produces `dist/esm`; `tsc` emits declarations to
 `dist/types`.
 
+The website lives in `site/` (Astro, deployed to Cloudflare Pages); see
+[`site/README.md`](site/README.md).
+
 ## License
 
 MIT © Ian Hunter

package/dist/esm/astro.js

@@ -0,0 +1,103 @@
+const LOCALE_HEADER = "x-rosetta-locale";
+const DEFAULT_LOCALE_COOKIE = "locale";
+const ONE_YEAR_SECONDS = 60 * 60 * 24 * 365;
+function localeCookieName(config) {
+  return config.cookieName ?? DEFAULT_LOCALE_COOKIE;
+}
+function localeCookieOptions(config) {
+  return {
+    path: "/",
+    maxAge: config.cookieMaxAgeSeconds ?? ONE_YEAR_SECONDS,
+    sameSite: "lax"
+  };
+}
+function isLocale(config, value) {
+  return typeof value === "string" && config.locales.includes(value);
+}
+function localeFromPath(config, pathname) {
+  const segment = pathname.split("/")[1];
+  return segment && isLocale(config, segment) ? segment : null;
+}
+function stripLocale(config, pathname) {
+  const locale = localeFromPath(config, pathname);
+  if (!locale) return { locale: null, path: pathname || "/" };
+  const rest = pathname.slice(locale.length + 1);
+  return { locale, path: rest || "/" };
+}
+function resolveLocale(config, input) {
+  const fromPath = localeFromPath(config, input.pathname);
+  if (fromPath) {
+    return {
+      locale: fromPath,
+      path: stripLocale(config, input.pathname).path,
+      source: "url"
+    };
+  }
+  if (isLocale(config, input.header)) {
+    return { locale: input.header, path: input.pathname, source: "header" };
+  }
+  if (isLocale(config, input.cookie)) {
+    return { locale: input.cookie, path: input.pathname, source: "cookie" };
+  }
+  return {
+    locale: config.defaultLocale,
+    path: input.pathname,
+    source: "default"
+  };
+}
+function serializeLocaleCookie(config, locale) {
+  const options = localeCookieOptions(config);
+  return `${localeCookieName(config)}=${encodeURIComponent(locale)}; Path=${options.path}; Max-Age=${options.maxAge}; SameSite=${capitalize(options.sameSite)}`;
+}
+function parseCookie(header, name) {
+  if (!header) return null;
+  for (const part of header.split(";")) {
+    const [key, ...rest] = part.trim().split("=");
+    if (key === name) return decodeURIComponent(rest.join("="));
+  }
+  return null;
+}
+function capitalize(value) {
+  return value.charAt(0).toUpperCase() + value.slice(1);
+}
+
+function createAstroLocaleMiddleware(config) {
+  return async function onRequest(context, next) {
+    const url = new URL(context.request.url);
+    const resolved = resolveLocale(config, {
+      pathname: url.pathname,
+      header: context.request.headers.get(LOCALE_HEADER),
+      cookie: parseCookie(
+        context.request.headers.get("cookie"),
+        localeCookieName(config)
+      )
+    });
+    context.locals.locale = resolved.locale;
+    if (resolved.source === "url") {
+      const target = new URL(url);
+      target.pathname = resolved.path;
+      const response2 = await context.rewrite(target);
+      response2.headers.set(LOCALE_HEADER, resolved.locale);
+      response2.headers.append(
+        "Set-Cookie",
+        serializeLocaleCookie(config, resolved.locale)
+      );
+      return response2;
+    }
+    const response = await next();
+    if (resolved.source === "cookie" || resolved.source === "default") {
+      response.headers.append(
+        "Set-Cookie",
+        serializeLocaleCookie(config, resolved.locale)
+      );
+    }
+    return response;
+  };
+}
+function getAstroLocale(context, config) {
+  const locale = context.locals.locale;
+  return isLocale(config, locale) ? locale : config.defaultLocale;
+}
+
+export { createAstroLocaleMiddleware, getAstroLocale };
+//# sourceMappingURL=astro.js.map

package/dist/esm/astro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"astro.js","sources":["../../src/locale/core.ts","../../src/locale/astro.ts"],"sourcesContent":["/**\n * Runtime locale layer — framework-agnostic core.\n *\n * The translation engine answers \"how do I translate these strings?\". This\n * module answers \"which locale is this request in, and how do I switch?\" — the\n * routing + cookie model that the React, Next, and Astro adapters are thin\n * wrappers around.\n *\n * The config is deliberately plain data (no functions) so the exact same object\n * can cross the server → client boundary. Resolution is deterministic and\n * one-directional:\n *\n *   1. a locale-prefixed URL (`/ja/pricing`) is authoritative,\n *   2. then a forced header (`x-rosetta-locale`, set by middleware),\n *   3. then the persisted cookie,\n *   4. then the default locale.\n *\n * Switching sets the cookie *and* navigates to the localized URL, so the URL and\n * the cookie always agree. There is no client-side guessing, no\n * refresh-after-push race, and no way for a stale request to re-pin the locale.\n */\n\nexport const LOCALE_HEADER = \"x-rosetta-locale\";\nexport const DEFAULT_LOCALE_COOKIE = \"locale\";\nexport const ONE_YEAR_SECONDS = 60 * 60 * 24 * 365;\n\nexport interface LocaleConfig {\n\t/** Every locale, including the default. Order is the switcher order. */\n\tlocales: readonly string[];\n\t/** The locale served without a URL prefix. */\n\tdefaultLocale: string;\n\t/** Cookie that persists the choice. Default `\"locale\"`. */\n\tcookieName?: string;\n\t/** Cookie max-age in seconds. Default one year. */\n\tcookieMaxAgeSeconds?: number;\n\t/** Prefix the default locale too (`/en/...`). Default `false`. */\n\tprefixDefaultLocale?: boolean;\n\t/**\n\t * Canonical (unprefixed) paths that have localized variants — exact matches.\n\t * Omit both this and `localizedPathPrefixes` to localize every path.\n\t */\n\tlocalizedPaths?: readonly string[];\n\t/** Canonical paths that have localized variants — prefix matches (e.g. `/blog/`). */\n\tlocalizedPathPrefixes?: readonly string[];\n}\n\nexport type LocaleSource = \"url\" | \"header\" | \"cookie\" | \"default\";\n\nexport interface ResolvedLocale {\n\tlocale: string;\n\t/** The canonical, unprefixed path for this request. */\n\tpath: string;\n\tsource: LocaleSource;\n}\n\nexport interface LocaleCookieOptions {\n\tpath: string;\n\tmaxAge: number;\n\tsameSite: \"lax\";\n}\n\nexport interface LocaleSwitchPlan {\n\t/** Localized URL to navigate to. */\n\thref: string;\n\t/** Cookie to persist the choice. */\n\tcookie: { name: string; value: string; options: LocaleCookieOptions };\n}\n\nexport function localeCookieName(config: LocaleConfig): string {\n\treturn config.cookieName ?? DEFAULT_LOCALE_COOKIE;\n}\n\nexport function localeCookieOptions(config: LocaleConfig): LocaleCookieOptions {\n\treturn {\n\t\tpath: \"/\",\n\t\tmaxAge: config.cookieMaxAgeSeconds ?? ONE_YEAR_SECONDS,\n\t\tsameSite: \"lax\",\n\t};\n}\n\nexport function isLocale(\n\tconfig: LocaleConfig,\n\tvalue: unknown,\n): value is string {\n\treturn typeof value === \"string\" && config.locales.includes(value);\n}\n\nexport function isLocalizedPath(\n\tconfig: LocaleConfig,\n\tpathname: string,\n): boolean {\n\tconst hasRules =\n\t\t(config.localizedPaths?.length ?? 0) > 0 ||\n\t\t(config.localizedPathPrefixes?.length ?? 0) > 0;\n\tif (!hasRules) return true;\n\tif (config.localizedPaths?.includes(pathname)) return true;\n\treturn (\n\t\tconfig.localizedPathPrefixes?.some(\n\t\t\t(prefix) => pathname === prefix || pathname.startsWith(prefix),\n\t\t) ?? false\n\t);\n}\n\n/** The leading locale segment of a path, if it is one we know. */\nexport function localeFromPath(\n\tconfig: LocaleConfig,\n\tpathname: string,\n): string | null {\n\tconst segment = pathname.split(\"/\")[1];\n\treturn segment && isLocale(config, segment) ? segment : null;\n}\n\n/** Strip a leading locale segment, returning the canonical path. */\nexport function stripLocale(\n\tconfig: LocaleConfig,\n\tpathname: string,\n): { locale: string | null; path: string } {\n\tconst locale = localeFromPath(config, pathname);\n\tif (!locale) return { locale: null, path: pathname || \"/\" };\n\tconst rest = pathname.slice(locale.length + 1);\n\treturn { locale, path: rest || \"/\" };\n}\n\n/**\n * Prefix a canonical path for a locale. The default locale stays bare unless\n * `prefixDefaultLocale` is set.\n */\nexport function localizePath(\n\tconfig: LocaleConfig,\n\tpathname: string,\n\tlocale: string,\n): string {\n\tif (locale === config.defaultLocale && !config.prefixDefaultLocale) {\n\t\treturn pathname;\n\t}\n\treturn pathname === \"/\" ? `/${locale}` : `/${locale}${pathname}`;\n}\n\n/** The URL to navigate to when switching `pathname` to `locale`. */\nexport function switchHref(\n\tconfig: LocaleConfig,\n\tpathname: string,\n\tlocale: string,\n): string {\n\tconst { path } = stripLocale(config, pathname);\n\treturn localizePath(config, path, locale);\n}\n\n/**\n * Resolve the active locale for a request. Precedence: URL prefix → forced\n * header → cookie → default. `path` is always the canonical (unprefixed) path.\n */\nexport function resolveLocale(\n\tconfig: LocaleConfig,\n\tinput: { pathname: string; header?: string | null; cookie?: string | null },\n): ResolvedLocale {\n\tconst fromPath = localeFromPath(config, input.pathname);\n\tif (fromPath) {\n\t\treturn {\n\t\t\tlocale: fromPath,\n\t\t\tpath: stripLocale(config, input.pathname).path,\n\t\t\tsource: \"url\",\n\t\t};\n\t}\n\tif (isLocale(config, input.header)) {\n\t\treturn { locale: input.header, path: input.pathname, source: \"header\" };\n\t}\n\tif (isLocale(config, input.cookie)) {\n\t\treturn { locale: input.cookie, path: input.pathname, source: \"cookie\" };\n\t}\n\treturn {\n\t\tlocale: config.defaultLocale,\n\t\tpath: input.pathname,\n\t\tsource: \"default\",\n\t};\n}\n\n/** The `Set-Cookie` value that persists `locale`. */\nexport function serializeLocaleCookie(\n\tconfig: LocaleConfig,\n\tlocale: string,\n): string {\n\tconst options = localeCookieOptions(config);\n\treturn `${localeCookieName(config)}=${encodeURIComponent(locale)}; Path=${\n\t\toptions.path\n\t}; Max-Age=${options.maxAge}; SameSite=${capitalize(options.sameSite)}`;\n}\n\n/** Read a single cookie value from a `Cookie:` header. */\nexport function parseCookie(\n\theader: string | null | undefined,\n\tname: string,\n): string | null {\n\tif (!header) return null;\n\tfor (const part of header.split(\";\")) {\n\t\tconst [key, ...rest] = part.trim().split(\"=\");\n\t\tif (key === name) return decodeURIComponent(rest.join(\"=\"));\n\t}\n\treturn null;\n}\n\n/**\n * Everything a client needs to switch locale: set `cookie`, navigate to `href`.\n * Returns `null` when the current path has no localized variant (legal pages,\n * API routes, …), so the switcher can no-op instead of linking to a 404.\n */\nexport function planSwitch(\n\tconfig: LocaleConfig,\n\tpathname: string,\n\tlocale: string,\n): LocaleSwitchPlan | null {\n\tconst { path } = stripLocale(config, pathname);\n\tif (!isLocalizedPath(config, path)) return null;\n\treturn {\n\t\thref: localizePath(config, path, locale),\n\t\tcookie: {\n\t\t\tname: localeCookieName(config),\n\t\t\tvalue: locale,\n\t\t\toptions: localeCookieOptions(config),\n\t\t},\n\t};\n}\n\nfunction capitalize(value: string): string {\n\treturn value.charAt(0).toUpperCase() + value.slice(1);\n}\n","/**\n * Astro adapter.\n *\n * Astro's middleware runs on every request, so it's the natural place to\n * resolve the locale, force it onto `Astro.locals.locale`, rewrite\n * locale-prefixed URLs to their canonical path, and persist the cookie.\n *\n * ```ts\n * // src/middleware.ts\n * import { defineMiddleware } from \"astro:middleware\";\n * import { createAstroLocaleMiddleware } from \"rosetta-i18n/astro\";\n * import { localeConfig } from \"../i18n/config\";\n *\n * export const onRequest = createAstroLocaleMiddleware(localeConfig);\n * ```\n *\n * For a client switch, render the React `<LocaleSwitcher>` as an island and\n * wrap it in `<LocaleProvider locale={Astro.locals.locale} config={localeConfig}>`.\n * Types are structural, so this module never depends on `astro`.\n */\n\nimport {\n\tisLocale,\n\tLOCALE_HEADER,\n\ttype LocaleConfig,\n\tlocaleCookieName,\n\tparseCookie,\n\tresolveLocale,\n\tserializeLocaleCookie,\n} from \"./core\";\n\nexport interface AstroLocaleContext {\n\trequest: Request;\n\tlocals: Record<string, unknown>;\n\t/** Astro's `context.rewrite()`. */\n\trewrite: (url: string | URL) => Promise<Response>;\n}\n\nexport type AstroMiddlewareNext = (rewrite?: URL) => Promise<Response>;\n\nexport function createAstroLocaleMiddleware(config: LocaleConfig) {\n\treturn async function onRequest(\n\t\tcontext: AstroLocaleContext,\n\t\tnext: AstroMiddlewareNext,\n\t): Promise<Response> {\n\t\tconst url = new URL(context.request.url);\n\t\tconst resolved = resolveLocale(config, {\n\t\t\tpathname: url.pathname,\n\t\t\theader: context.request.headers.get(LOCALE_HEADER),\n\t\t\tcookie: parseCookie(\n\t\t\t\tcontext.request.headers.get(\"cookie\"),\n\t\t\t\tlocaleCookieName(config),\n\t\t\t),\n\t\t});\n\n\t\tcontext.locals.locale = resolved.locale;\n\n\t\tif (resolved.source === \"url\") {\n\t\t\tconst target = new URL(url);\n\t\t\ttarget.pathname = resolved.path;\n\t\t\tconst response = await context.rewrite(target);\n\t\t\tresponse.headers.set(LOCALE_HEADER, resolved.locale);\n\t\t\tresponse.headers.append(\n\t\t\t\t\"Set-Cookie\",\n\t\t\t\tserializeLocaleCookie(config, resolved.locale),\n\t\t\t);\n\t\t\treturn response;\n\t\t}\n\n\t\tconst response = await next();\n\t\t// Persist only when the URL can't decide it (bare path) and the cookie\n\t\t// disagrees — never on a rewrite, where the URL is authoritative.\n\t\tif (resolved.source === \"cookie\" || resolved.source === \"default\") {\n\t\t\tresponse.headers.append(\n\t\t\t\t\"Set-Cookie\",\n\t\t\t\tserializeLocaleCookie(config, resolved.locale),\n\t\t\t);\n\t\t}\n\t\treturn response;\n\t};\n}\n\n/** Read the locale the middleware stored on `Astro.locals`. */\nexport function getAstroLocale(\n\tcontext: { locals: Record<string, unknown> },\n\tconfig: LocaleConfig,\n): string {\n\tconst locale = context.locals.locale;\n\treturn isLocale(config, locale) ? locale : config.defaultLocale;\n}\n"],"names":["response"],"mappings":"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"}

package/dist/esm/cli.js

@@ -2539,6 +2539,7 @@ async function cmdPush(ctx) {
     translator: io.translator,
     onLocale: (locale) => printPushLocale(ctx, locale)
   });
+  warnNoMatches(ctx, result.locales.length);
   if (ctx.json) {
     ctx.out(JSON.stringify(result, null, 2));
   } else if (estimate && result.estimate) {
@@ -2574,6 +2575,13 @@ async function cmdPush(ctx) {
   }
   return result.ok ? EXIT.ok : EXIT.failed;
 }
+function warnNoMatches(ctx, jobs) {
+  if (jobs === 0 && ctx.args.positionals.length > 0 && !ctx.json) {
+    ctx.io.stderr(
+      `warning: no configured source files match ${ctx.args.positionals.map((p) => `"${p}"`).join(", ")} (patterns match source paths like those in .rosetta/config.json files[].pattern).`
+    );
+  }
+}
 function printCheck(ctx, result) {
   for (const locale of result.locales) {
     if (locale.ok) {
@@ -2603,6 +2611,7 @@ function cmdCheck(ctx) {
     patterns: ctx.args.positionals,
     locales: list(ctx.args.flags.locale)
   });
+  warnNoMatches(ctx, result.locales.length);
   if (ctx.json) ctx.out(JSON.stringify(result, null, 2));
   else printCheck(ctx, result);
   return result.ok ? EXIT.ok : EXIT.stale;