i18nya 0.1.0

package/astro-i18nya/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "astro-i18nya",
+  "module": "src/index.ts",
+  "type": "module",
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@astrojs/react": "^4.4.2",
+    "astro": "^5.16.0",
+    "i18nya": "^0.1.0",
+    "react": "^19.2.0"
+  }
+}

package/astro-i18nya/src/Trans.tsx

@@ -0,0 +1,86 @@
+//? https://react.i18next.com/latest/trans-component
+// do something similar to ↑
+
+import { Children, cloneElement, isValidElement } from "react";
+import type { FunctionComponent, ReactNode } from "react";
+
+type Props = {
+  children: ReactNode;
+  t: string;
+};
+
+/**
+ * A fake version of `<Trans>` in `react-i18next` with *very different* behaviour.
+ *
+ * You feed in a list of empty elements in `<Trans>`. The structure will follow the translation strings.
+ *
+ * @example ```tsx
+ * <Trans t={t("test", { user: "John" })}>
+ *   <b />
+ *   <a href="https://example.com" />
+ * </Trans>
+ * ```
+ * With `"test": "Hello <1>{{user}}</1>, welcome to <2><1>my site</1></2>."`, the above element will become:
+ * ```tsx
+ * <b>Hello John</b>, welcome to <a href="https://example.com"><b>my site</b></a>.
+ * ```
+ *
+ * @param children the list of tags.
+ * @param t return value of t()
+ * @returns ReactNode
+ */
+export default (({ children, t }: Props) => {
+  // find /<\/(\d+)>/g, where group 1 parse to int is largest
+  const maxTagId = t
+    .match(/<\/(\d+)>/g)
+    ?.reduce((acc, cur) => Math.max(acc, parseInt(cur.slice(2, -1))), 0);
+  const inputs = Children.toArray(children).filter((c) => isValidElement(c));
+  if (maxTagId ?? 0 > inputs.length) {
+    return t; // syntax error
+  }
+
+  const elms: ReactNode[] = []; // resulting list of elements
+  const tagStack = [];
+  for (let ch_idx = 0; ch_idx < t.length; ) {
+    if (t.substring(ch_idx, ch_idx + 2) == "\\<") {
+      elms.push("<");
+      ch_idx += 2;
+      continue;
+    }
+    if (t.substring(ch_idx, ch_idx + 2) == "</") {
+      let j = 0;
+      while (t[++j + ch_idx] != ">" && j + ch_idx < t.length);
+      const tag = Number.parseInt(t.substring(ch_idx++ + 1, (ch_idx += j)));
+      if (Number.isNaN(tag)) {
+        elms.push(t.substring(ch_idx - j - 1, ch_idx));
+        continue;
+      }
+      let { p, l } = tagStack.pop();
+      if (tag != p) {
+        return t; // syntax error
+      }
+      elms.push(
+        cloneElement(inputs[p - 1], {}, ...elms.splice(l, elms.length - l)),
+      );
+      continue;
+    }
+    if (t[ch_idx] == "<") {
+      let j = 0;
+      while (t[++j + ch_idx] != ">" && j + ch_idx < t.length);
+      const tag = Number.parseInt(t.substring(ch_idx++, (ch_idx += j)));
+      if (Number.isNaN(tag)) {
+        elms.push(t.substring(ch_idx - j - 1, ch_idx));
+        continue;
+      }
+      tagStack.push({ p: tag, l: elms.length });
+      elms.push(""); // in order to splice later, contents inside a new tag element must start fresh
+      continue;
+    }
+    if (typeof elms[elms.length - 1] === "string") {
+      elms[elms.length - 1] += t[ch_idx++];
+    } else {
+      elms.push(t[ch_idx++]);
+    }
+  }
+  return <>{elms}</>;
+}) satisfies FunctionComponent<Props>;

package/astro-i18nya/src/index.ts

@@ -0,0 +1,24 @@
+import type { I18Nya } from "i18nya";
+import type { AstroIntegration } from "astro";
+import react from "@astrojs/react";
+import Trans from "./Trans";
+import { listLang, getLangName } from "./util";
+export { Trans, listLang, getLangName };
+
+export default function (i18nya: I18Nya): AstroIntegration {
+  return {
+    name: "astro-i18nya",
+    hooks: {
+      "astro:config:setup": ({ updateConfig }) => {
+        updateConfig({
+          i18n: {
+            defaultLocale: i18nya.config.defaultLang,
+            locales: Object.keys(i18nya.translations),
+          },
+          // required for <Trans>
+          integrations: [react({ experimentalReactChildren: true })],
+        });
+      },
+    },
+  };
+}

package/astro-i18nya/src/util.ts

@@ -0,0 +1,24 @@
+import type { I18Nya } from "i18nya";
+
+/**
+ * Obtain the language name.
+ * @param lang the language locale
+ * @param displayLang in what language should the name of the language be shown. By default, use native language names.
+ * @returns language name
+ */
+export const getLangName = (lang: string, displayLang?: string) =>
+  new Intl.DisplayNames([displayLang ?? lang], { type: "language" }).of(lang);
+
+/**
+ * List out available languages.
+ * @param i18nya return value of `init()` from `i18nya`
+ * @param displayLang in what language should the name of the language be shown. By default, use native language names.
+ * @returns a map of language locale → language name
+ */
+export const listLang = (i18nya: I18Nya, displayLang?: string) =>
+  new Map(
+    Object.keys(i18nya.translations).map((l) => [
+      l,
+      getLangName(l.replace("_", "-"), displayLang),
+    ]),
+  );

package/astro-i18nya/tsconfig.json

@@ -0,0 +1,33 @@
+{
+  "exclude": ["./dist"],
+  "compilerOptions": {
+    "rootDir": "./src",
+    "outDir": "./dist",
+
+    // Environment setup & latest features
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false
+  }
+}

package/babel.config.js

@@ -0,0 +1,6 @@
+module.exports = {
+  presets: [
+    ['@babel/preset-env', {targets: {node: 'current'}}],
+    '@babel/preset-typescript',
+  ],
+};

package/bun.lock

@@ -0,0 +1,20 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 0,
+  "workspaces": {
+    "": {
+      "name": "i18nya",
+      "devDependencies": {
+        "@types/node": "^24.10.1",
+        "typescript": "^5.9.3",
+      },
+    },
+  },
+  "packages": {
+    "@types/node": ["@types/node@24.10.1", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-GNWcUTRBgIRJD5zj+Tq0fKOJ5XZajIiBroOF0yvj2bSU1WvNdYS/dn9UxwsujGW4JX06dnHyjV2y9rRaybH0iQ=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
+  }
+}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export type I18NyaConfig = {
+    /** Path to directory containing language files */
+    langDir: string;
+    /** Locale ID for default language */
+    defaultLang: string;
+    fallbackLangs?: Record<string, string>;
+};
+export type I18Nya = {
+    translations: Record<string, Record<string, string>>;
+    makeT: (lang: string) => (key: string, its?: Interpolations) => string;
+    config: I18NyaConfig;
+};
+export type Interpolations = Record<string, string | {
+    toString(): string;
+}>;
+export declare const init: (config: I18NyaConfig) => Promise<I18Nya>;
+//# 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":"AAEA,MAAM,MAAM,YAAY,GAAG;IACzB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,cAAc,KAAK,MAAM,CAAC;IACvE,MAAM,EAAE,YAAY,CAAC;CACtB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,QAAQ,IAAI,MAAM,CAAA;CAAE,CAAC,CAAC;AAG7E,eAAO,MAAM,IAAI,GAAU,QAAQ,YAAY,oBA2B9C,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.init = void 0;
+const fs_1 = require("fs");
+const opts = { with: { type: "json" } };
+const init = async (config) => {
+    const { langDir, defaultLang: rootLang, fallbackLangs: fb = {}, } = config;
+    let i18nya = {
+        translations: {},
+        makeT: (l) => (k, its = {}) => {
+            let s;
+            for (; !(s = i18nya.translations[l]?.[k]); l = fb[l] ?? rootLang)
+                if (l === rootLang)
+                    return String(k);
+            for (const [k, v] of Object.entries(its))
+                s = s.replace(`{{${k}}}`, `${v}`);
+            return s;
+        },
+        config
+    };
+    for (const entry of (0, fs_1.readdirSync)(langDir, { withFileTypes: true })) {
+        if (entry.isFile() && entry.name.endsWith(".json")) {
+            const lang = entry.name.slice(0, -5);
+            const imp = await import(`${langDir}/${lang}.json`, opts);
+            i18nya.translations[lang] = imp.default;
+        }
+    }
+    return i18nya;
+};
+exports.init = init;
+//# 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,2BAAiC;AAiBjC,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;AAEjC,MAAM,IAAI,GAAG,KAAK,EAAE,MAAoB,EAAE,EAAE;IACjD,MAAM,EACJ,OAAO,EACP,WAAW,EAAE,QAAQ,EACrB,aAAa,EAAE,EAAE,GAAG,EAAE,GACvB,GAAG,MAAM,CAAC;IACX,IAAI,MAAM,GAAW;QACnB,YAAY,EAAE,EAAE;QAChB,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,EAAE,EAAE;YAC5B,IAAI,CAAqB,CAAC;YAC1B,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ;gBAC9D,IAAI,CAAC,KAAK,QAAQ;oBAChB,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;YACrB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;gBACtC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACpC,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM;KACP,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,IAAA,gBAAW,EAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAClE,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACrC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,OAAO,IAAI,IAAI,OAAO,EAAE,IAAI,CAAC,CAAC;YAC1D,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AA3BW,QAAA,IAAI,QA2Bf"}

package/examples/hello/__tests__/index.test.ts

@@ -0,0 +1,25 @@
+import { init } from "../../../src/index";
+import path from "path";
+
+describe("i18nya init and makeT", () => {
+  it('should return correct value for "hello"', async () => {
+    const langDir = path.resolve(__dirname, "../langs");
+    const { makeT } = await init({ defaultLang: "en", langDir });
+
+    expect(makeT("en")("hello")).toBe("Hello, World!");
+  });
+
+  it("should return the key if translation is missing", async () => {
+    const langDir = path.resolve(__dirname, "../langs");
+    const { makeT } = await init({ defaultLang: "en", langDir });
+
+    expect(makeT("en")("missing_key")).toBe("missing_key");
+  });
+
+  it("should interpolate variables in translation", async () => {
+    const langDir = path.resolve(__dirname, "../langs");
+    const { makeT } = await init({ defaultLang: "en", langDir });
+
+    expect(makeT("en")("greet", { name: "Alice" })).toBe("Hello, Alice!");
+  });
+});

package/examples/hello/index.ts

@@ -0,0 +1,4 @@
+import { init } from '../../src/index';
+init({ defaultLang: 'en', langDir: './langs' }).then(({ makeT }) => {
+  console.log(makeT("en")("hello"));
+});

package/examples/hello/langs/en.json

@@ -0,0 +1,4 @@
+{
+  "hello": "Hello, World!",
+  "greet": "Hello, {{name}}!"
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "i18nya",
+  "version": "0.1.0",
+  "description": "i18n as small as a cat's paw",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/FyraLabs/i18nya.git"
+  },
+  "keywords": [
+    "internationalization",
+    "i18n",
+    "translation",
+    "localization",
+    "l10n",
+    "globalization"
+  ],
+  "author": "madonuko <mado@fyralabs.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/FyraLabs/i18nya/issues"
+  },
+  "homepage": "https://github.com/FyraLabs/i18nya#readme",
+  "devDependencies": {
+    "@babel/core": "^7.28.5",
+    "@babel/preset-env": "^7.28.5",
+    "@babel/preset-typescript": "^7.28.5",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.10.1",
+    "babel-jest": "^30.2.0",
+    "jest": "^30.2.0",
+    "typescript": "^5.9.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,47 @@
+import { readdirSync } from "fs";
+
+export type I18NyaConfig = {
+  /** Path to directory containing language files */
+  langDir: string;
+  /** Locale ID for default language */
+  defaultLang: string;
+  fallbackLangs?: Record<string, string>;
+};
+
+export type I18Nya = {
+  translations: Record<string, Record<string, string>>;
+  makeT: (lang: string) => (key: string, its?: Interpolations) => string;
+  config: I18NyaConfig;
+}
+
+export type Interpolations = Record<string, string | { toString(): string }>;
+const opts = { with: { type: "json" } };
+
+export const init = async (config: I18NyaConfig) => {
+  const {
+    langDir,
+    defaultLang: rootLang,
+    fallbackLangs: fb = {},
+  } = config;
+  let i18nya: I18Nya = {
+    translations: {},
+    makeT: (l) => (k, its = {}) => {
+      let s: string | undefined;
+      for (; !(s = i18nya.translations[l]?.[k]); l = fb[l] ?? rootLang)
+        if (l === rootLang)
+          return String(k);
+      for (const [k, v] of Object.entries(its))
+        s = s.replace(`{{${k}}}`, `${v}`);
+      return s;
+    },
+    config
+  };
+  for (const entry of readdirSync(langDir, { withFileTypes: true })) {
+    if (entry.isFile() && entry.name.endsWith(".json")) {
+      const lang = entry.name.slice(0, -5);
+      const imp = await import(`${langDir}/${lang}.json`, opts);
+      i18nya.translations[lang] = imp.default;
+    }
+  }
+  return i18nya;
+};

package/tsconfig.json

@@ -0,0 +1,48 @@
+{
+  "exclude": ["./dist", "./astro-i18nya", "./examples"],
+  // Visit https://aka.ms/tsconfig to read more about this file
+  "compilerOptions": {
+    // File Layout
+    "rootDir": "./src",
+    "outDir": "./dist",
+
+    // Environment Settings
+    // See also https://aka.ms/tsconfig/module
+    "module": "nodenext",
+    "target": "esnext",
+    // "types": [],
+    // For nodejs:
+    "lib": ["esnext"],
+    "types": ["node"],
+    // and npm install -D @types/node
+
+    // Other Outputs
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+
+    // Stricter Typechecking Options
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+
+    // Style Options
+    // "noImplicitReturns": true,
+    // "noImplicitOverride": true,
+    // "noUnusedLocals": true,
+    // "noUnusedParameters": true,
+    // "noFallthroughCasesInSwitch": true,
+    // "noPropertyAccessFromIndexSignature": true,
+
+    // Recommended Options
+    "strict": true,
+    "jsx": "react-jsx",
+    "verbatimModuleSyntax": false,
+    "isolatedModules": true,
+    "noUncheckedSideEffectImports": true,
+    "moduleDetection": "force",
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+
+    "esModuleInterop": true
+  }
+}