@xndrjs/i18n-react 0.8.1 → 0.8.2-alpha.0

package/src/codegen/emit/react-bindings-file.ts

@@ -1,223 +0,0 @@
-import path from "node:path";
-
-export const GENERATED_FILE_BANNER = "// Automatically generated code. Do not edit manually.\n";
-
-export type ImportExtension = "none" | ".ts" | ".js";
-
-export function importExtensionSuffix(importExtension: ImportExtension): string {
-  return importExtension === "none" ? "" : importExtension;
-}
-
-export function toModuleBasename(filePath: string): string {
-  return path.basename(filePath).replace(/\.tsx?$/, "");
-}
-
-export function toRelativeModuleImport(
-  moduleBasename: string,
-  importExtension: ImportExtension
-): string {
-  return `./${moduleBasename}${importExtensionSuffix(importExtension)}`;
-}
-
-export interface ReactBindingsFileOptions {
-  factoryName: string;
-  paramsTypeName: string;
-  schemaTypeName: string;
-  localeTypeName: string;
-  instanceImport: string;
-  typesImport: string;
-  /** When `"fetch"`, {@link I18nRoot} requires `fetchImpl`. */
-  loaderStrategy?: "import" | "fetch";
-}
-
-/** When `Ns` is `[]`, reject every `t(...)` call so refactoring can clear namespaces and re-add only what is used. */
-function formatMultiScopedTType(
-  schemaTypeName: string,
-  paramsTypeName: string,
-  localeTypeName: string
-): string {
-  const emptyBranch = `(namespace: never, key: never, ...args: never[]) => string`;
-  return (
-    `type ScopedT<Ns extends readonly AppNamespace[]> = Ns extends readonly []\n` +
-    `  ? ${emptyBranch}\n` +
-    `  : I18nScopeMultiForLocale<\n` +
-    `  SchemaForNamespaces<${schemaTypeName}, Ns>,\n` +
-    `  ParamsForNamespaces<${schemaTypeName}, ${paramsTypeName}, Ns>,\n` +
-    `  ${localeTypeName},\n` +
-    `  ${localeTypeName}\n` +
-    `>["t"];\n\n`
-  );
-}
-
-function formatI18nRoot(options: {
-  factoryName: string;
-  localeTypeName: string;
-  loaderStrategy: "import" | "fetch";
-}): string {
-  const { factoryName, localeTypeName, loaderStrategy } = options;
-
-  if (loaderStrategy === "fetch") {
-    return (
-      `export function I18nRoot({\n` +
-      `  locale,\n` +
-      `  children,\n` +
-      `  state,\n` +
-      `  dictionary,\n` +
-      `  fetchImpl,\n` +
-      `}: {\n` +
-      `  locale: ${localeTypeName};\n` +
-      `  children: ReactNode;\n` +
-      `  state?: I18nCreateInput | undefined;\n` +
-      `  dictionary?: Record<string, unknown> | undefined;\n` +
-      `  fetchImpl: FetchArtifact;\n` +
-      `}) {\n` +
-      `  return (\n` +
-      `    <I18nRootProvider\n` +
-      `      createI18n={${factoryName}}\n` +
-      `      locale={locale}\n` +
-      `      fetchImpl={fetchImpl}\n` +
-      `      {...(state !== undefined ? { state } : {})}\n` +
-      `      {...(dictionary !== undefined ? { dictionary } : {})}\n` +
-      `    >\n` +
-      `      {children}\n` +
-      `    </I18nRootProvider>\n` +
-      `  );\n` +
-      `}\n`
-    );
-  }
-
-  return (
-    `export function I18nRoot({\n` +
-    `  locale,\n` +
-    `  children,\n` +
-    `  state,\n` +
-    `  dictionary,\n` +
-    `}: {\n` +
-    `  locale: ${localeTypeName};\n` +
-    `  children: ReactNode;\n` +
-    `  state?: I18nCreateInput | undefined;\n` +
-    `  dictionary?: Record<string, unknown> | undefined;\n` +
-    `}) {\n` +
-    `  return (\n` +
-    `    <I18nRootProvider\n` +
-    `      createI18n={${factoryName}}\n` +
-    `      locale={locale}\n` +
-    `      {...(state !== undefined ? { state } : {})}\n` +
-    `      {...(dictionary !== undefined ? { dictionary } : {})}\n` +
-    `    >\n` +
-    `      {children}\n` +
-    `    </I18nRootProvider>\n` +
-    `  );\n` +
-    `}\n`
-  );
-}
-
-/**
- * Emits typed root + withI18n / I18n for split-by-locale or custom delivery.
- * Every namespace loads through the handle + namespaceLoaders.
- * Partition→area mapping for custom delivery is injected into the handle by core codegen.
- */
-export function formatReactBindingsFile(options: ReactBindingsFileOptions): string {
-  const {
-    factoryName,
-    localeTypeName,
-    instanceImport,
-    paramsTypeName,
-    schemaTypeName,
-    typesImport,
-    loaderStrategy = "import",
-  } = options;
-
-  const createInputImport =
-    loaderStrategy === "fetch"
-      ? `import type { FetchArtifact, I18nCreateInput } from "@xndrjs/i18n";\n`
-      : `import type { I18nCreateInput } from "@xndrjs/i18n";\n`;
-
-  return (
-    `${GENERATED_FILE_BANNER}` +
-    `"use client";\n\n` +
-    `import {\n` +
-    `  type ForwardedRef,\n` +
-    `  type ForwardRefExoticComponent,\n` +
-    `  type ReactNode,\n` +
-    `  type RefAttributes,\n` +
-    `} from "react";\n` +
-    `import {\n` +
-    `  createI18nLoadGate,\n` +
-    `  I18nRootProvider,\n` +
-    `  useI18nRootContext,\n` +
-    `} from "@xndrjs/i18n-react";\n` +
-    createInputImport +
-    `import type {\n` +
-    `  I18nScopeMultiForLocale,\n` +
-    `  ParamsForNamespaces,\n` +
-    `  SchemaForNamespaces,\n` +
-    `} from "@xndrjs/i18n";\n` +
-    `import { ${factoryName} } from "${instanceImport}";\n` +
-    `import type { ${paramsTypeName}, ${schemaTypeName}, ${localeTypeName} } from "${typesImport}";\n` +
-    `\n` +
-    `export function useI18nRoot(): ReturnType<typeof ${factoryName}> {\n` +
-    `  return useI18nRootContext().handle as ReturnType<typeof ${factoryName}>;\n` +
-    `}\n\n` +
-    `type AppNamespace = keyof ${schemaTypeName} & string;\n\n` +
-    formatMultiScopedTType(schemaTypeName, paramsTypeName, localeTypeName) +
-    `type I18nInjected<Ns extends readonly AppNamespace[]> = {\n` +
-    `  t: ScopedT<Ns>;\n` +
-    `  locale: ${localeTypeName};\n` +
-    `  pendingLocale?: ${localeTypeName};\n` +
-    `  error?: unknown;\n` +
-    `  retry?: () => void;\n` +
-    `};\n` +
-    `export type I18nProps<Ns extends readonly AppNamespace[]> = I18nInjected<Ns>;\n\n` +
-    `export type WithI18nFallback<P extends object> = ReactNode | ((props: P) => ReactNode);\n\n` +
-    `const gate = createI18nLoadGate({\n` +
-    `  useLoadArgs: () => {\n` +
-    `    const root = useI18nRootContext();\n` +
-    `    const { handle, coordinator, locale } = root;\n` +
-    `    return {\n` +
-    `      coordinator,\n` +
-    `      engineRef: handle,\n` +
-    `      partition: locale,\n` +
-    `      locale,\n` +
-    `      load: (namespaces: readonly string[]) =>\n` +
-    `        handle.load({\n` +
-    `          namespaces: namespaces as [AppNamespace, ...AppNamespace[]],\n` +
-    `          locale,\n` +
-    `        }),\n` +
-    `      tryResolveSync: (namespaces: readonly string[]) =>\n` +
-    `        handle.peek({\n` +
-    `          namespaces: namespaces as [AppNamespace, ...AppNamespace[]],\n` +
-    `          locale,\n` +
-    `        }),\n` +
-    `    };\n` +
-    `  },\n` +
-    `});\n\n` +
-    `export function withI18n<\n` +
-    `  P extends object = object,\n` +
-    `  R = never,\n` +
-    `  const Ns extends readonly AppNamespace[] = readonly AppNamespace[],\n` +
-    `>(\n` +
-    `  options: {\n` +
-    `    namespaces: Ns;\n` +
-    `    fallback?: WithI18nFallback<P>;\n` +
-    `    renderError?: (args: { error: unknown; retry: () => void; props: P }) => ReactNode;\n` +
-    `  },\n` +
-    `  render: (props: P, i18n: I18nProps<Ns>, ref?: ForwardedRef<R>) => ReactNode\n` +
-    `): ForwardRefExoticComponent<P & RefAttributes<R>> {\n` +
-    `  return gate.withI18n(options, render as never) as ForwardRefExoticComponent<\n` +
-    `    P & RefAttributes<R>\n` +
-    `  >;\n` +
-    `}\n\n` +
-    `export function I18n<\n` +
-    `  const Ns extends readonly AppNamespace[],\n` +
-    `>(props: {\n` +
-    `  namespaces: Ns;\n` +
-    `  fallback?: ReactNode;\n` +
-    `  renderError?: (args: { error: unknown; retry: () => void }) => ReactNode;\n` +
-    `  children: (value: I18nProps<Ns>) => ReactNode;\n` +
-    `}) {\n` +
-    `  return gate.I18n(props as never);\n` +
-    `}\n\n` +
-    formatI18nRoot({ factoryName, localeTypeName, loaderStrategy })
-  );
-}

package/src/codegen/generate-react-bindings.ts

@@ -1,86 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { loadConfig } from "@xndrjs/i18n/codegen";
-import type { CodegenConfig } from "@xndrjs/i18n/codegen";
-import { resolveCodegenPaths } from "@xndrjs/i18n/codegen";
-import {
-  formatReactBindingsFile,
-  toModuleBasename,
-  toRelativeModuleImport,
-} from "./emit/react-bindings-file.js";
-import {
-  defaultReactConfigPath,
-  loadReactCodegenConfig,
-  resolveReactBindingsOutputPath,
-} from "./react-codegen-config.js";
-import { writeFileIfChanged } from "./write-file-if-changed.js";
-
-function readCliFlag(flag: string): string | undefined {
-  const index = process.argv.indexOf(flag);
-  if (index < 0) {
-    return undefined;
-  }
-  const value = process.argv[index + 1];
-  if (value === undefined || value.startsWith("-")) {
-    throw new Error(`[i18n-react Codegen Error] Missing value for ${flag}`);
-  }
-  return value;
-}
-
-/**
- * React bindings codegen CLI.
- *
- * Reads `i18n.codegen.json` from `@xndrjs/i18n` and optionally `i18n-react.codegen.json`.
- * Output path: `--out` > react config `output` > default next to instance under `output/`.
- */
-function main(): void {
-  const configPath = path.resolve(
-    process.cwd(),
-    readCliFlag("--config") ?? "i18n/i18n.codegen.json"
-  );
-  const projectRoot = path.dirname(configPath);
-
-  if (!fs.existsSync(configPath)) {
-    throw new Error(`[i18n-react Codegen Error] Config file not found: ${configPath}`);
-  }
-
-  const config: CodegenConfig = loadConfig(configPath);
-  const paths = resolveCodegenPaths(config);
-
-  const instanceImport = toRelativeModuleImport(toModuleBasename(paths.instanceOutput), "none");
-  const typesImport = toRelativeModuleImport(toModuleBasename(paths.typesOutput), "none");
-
-  const reactConfigPath = path.resolve(
-    projectRoot,
-    readCliFlag("--react-config") ?? defaultReactConfigPath(configPath)
-  );
-  const reactConfig = loadReactCodegenConfig(reactConfigPath);
-  const cliOut = readCliFlag("--out");
-  const reactOutputRelative = resolveReactBindingsOutputPath({
-    instanceOutput: paths.instanceOutput,
-    ...(cliOut ? { cliOut } : {}),
-    reactConfig,
-  });
-  const reactOutputPath = path.resolve(projectRoot, reactOutputRelative);
-
-  const content = formatReactBindingsFile({
-    factoryName: paths.factoryName,
-    paramsTypeName: paths.paramsTypeName,
-    schemaTypeName: paths.schemaTypeName,
-    localeTypeName: paths.localeTypeName,
-    instanceImport,
-    typesImport,
-    loaderStrategy: config.loaderStrategy ?? "import",
-  });
-
-  const written = writeFileIfChanged(reactOutputPath, content);
-  const displayPath = path.relative(projectRoot, reactOutputPath);
-
-  if (written) {
-    console.log(`[i18n-react Codegen] Wrote ${displayPath}`);
-  } else {
-    console.log(`[i18n-react Codegen] Unchanged ${displayPath}`);
-  }
-}
-
-main();

package/src/codegen/react-codegen-config.test.ts

@@ -1,39 +0,0 @@
-import { describe, expect, it } from "vitest";
-import {
-  defaultReactBindingsOutput,
-  defaultReactConfigPath,
-  resolveReactBindingsOutputPath,
-} from "./react-codegen-config.js";
-
-describe("react-codegen-config", () => {
-  it("defaults output next to instanceOutput", () => {
-    expect(defaultReactBindingsOutput("generated/instance.generated.ts")).toBe(
-      "generated/react-bindings.generated.tsx"
-    );
-  });
-
-  it("prefers --out over react config and default", () => {
-    expect(
-      resolveReactBindingsOutputPath({
-        instanceOutput: "generated/instance.generated.ts",
-        cliOut: "custom/bindings.tsx",
-        reactConfig: { output: "ignored.tsx" },
-      })
-    ).toBe("custom/bindings.tsx");
-  });
-
-  it("uses react config output when --out is omitted", () => {
-    expect(
-      resolveReactBindingsOutputPath({
-        instanceOutput: "generated/instance.generated.ts",
-        reactConfig: { output: "generated/custom-react.tsx" },
-      })
-    ).toBe("generated/custom-react.tsx");
-  });
-
-  it("derives default react config path from i18n.codegen.json", () => {
-    expect(defaultReactConfigPath("/app/i18n/i18n.codegen.json")).toBe(
-      "/app/i18n/i18n-react.codegen.json"
-    );
-  });
-});

package/src/codegen/react-codegen-config.ts

@@ -1,70 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { z } from "zod";
-
-export const DEFAULT_REACT_BINDINGS_BASENAME = "react-bindings.generated.tsx";
-
-const reactCodegenConfigSchema = z
-  .object({
-    output: z.string().min(1).optional(),
-  })
-  .strict();
-
-export type ReactCodegenConfig = z.infer<typeof reactCodegenConfigSchema>;
-
-export function defaultReactBindingsOutput(instanceOutput: string): string {
-  return path.join(path.dirname(instanceOutput), DEFAULT_REACT_BINDINGS_BASENAME);
-}
-
-/** Loads optional `i18n-react.codegen.json` when present. */
-export function loadReactCodegenConfig(configPath: string): ReactCodegenConfig {
-  if (!fs.existsSync(configPath)) {
-    return {};
-  }
-
-  let raw: unknown;
-  try {
-    raw = JSON.parse(fs.readFileSync(configPath, "utf8"));
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    throw new Error(
-      `[i18n-react Codegen Error] Failed to parse react config JSON (${configPath}): ${message}`
-    );
-  }
-
-  const result = reactCodegenConfigSchema.safeParse(raw);
-  if (!result.success) {
-    const issueLines = result.error.issues.map((issue) => {
-      const issuePath = issue.path.length > 0 ? issue.path.join(".") : "(root)";
-      return `  - ${issuePath}: ${issue.message}`;
-    });
-    throw new Error(
-      ["[i18n-react Codegen Error] Invalid i18n-react.codegen.json:", ...issueLines].join("\n")
-    );
-  }
-
-  return result.data;
-}
-
-export function resolveReactBindingsOutputPath(options: {
-  instanceOutput: string;
-  cliOut?: string;
-  reactConfig?: ReactCodegenConfig;
-}): string {
-  if (options.cliOut !== undefined) {
-    return options.cliOut;
-  }
-  if (options.reactConfig?.output !== undefined) {
-    return options.reactConfig.output;
-  }
-  return defaultReactBindingsOutput(options.instanceOutput);
-}
-
-export function defaultReactConfigPath(i18nConfigPath: string): string {
-  const dir = path.dirname(i18nConfigPath);
-  const base = path.basename(i18nConfigPath, path.extname(i18nConfigPath));
-  if (base === "i18n.codegen") {
-    return path.join(dir, "i18n-react.codegen.json");
-  }
-  return path.join(dir, `${base}.react.codegen.json`);
-}

package/src/codegen/write-file-if-changed.ts

@@ -1,16 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-
-/** Writes only when content changed — stable mtimes for watchers. */
-export function writeFileIfChanged(absolutePath: string, content: string): boolean {
-  if (fs.existsSync(absolutePath)) {
-    const currentContent = fs.readFileSync(absolutePath, "utf8");
-    if (currentContent === content) {
-      return false;
-    }
-  }
-
-  fs.mkdirSync(path.dirname(absolutePath), { recursive: true });
-  fs.writeFileSync(absolutePath, content);
-  return true;
-}