@geenius/i18n 0.1.0 → 0.3.0

package/README.md

@@ -1 +1,134 @@
-# ✦ geenius-i18n\n\n> Geenius I18n — Internationalization for Convex apps (React + SolidJS)\n\n---\n\n## Overview\nBuilt with Steve Jobs-level minimalism and Jony Ive-level craftsmanship, this package is designed to deliver unparalleled developer experience (DX) and rock-solid performance.\n\n## Installation\n\n```bash\npnpm add geenius-i18n\n```\n\n## Usage\n\n```typescript\nimport { init } from 'geenius-i18n';\n\n// Initialize the module with absolute precision\ninit({\n  mode: 'premium',\n});\n```\n\n## Architecture\n- **Zero-config**: It just works.\n- **Strictly Typed**: Fully written in TypeScript for flawless IntelliSense.\n- **Framework Agnostic**: seamlessly integrates into the Geenius ecosystem.\n\n---\n\n*Designed by Antigravity HQ*\n
+# @geenius/i18n
+
+Internationalization for Convex apps with React and SolidJS support.
+
+## Features
+
+- 14 built-in locales with metadata (name, native name, direction, flag)
+- RTL detection for Arabic and Hebrew
+- Pluralization with `_zero`, `_one`, `_other` suffixes
+- `{{variable}}` interpolation
+- Intl-based date, number, and currency formatting
+- localStorage locale persistence and browser detection
+- Convex backend schema for translation management
+- Admin dashboard components (Tailwind and vanilla CSS variants)
+
+## Packages
+
+| Package | Description |
+|---------|-------------|
+| `@geenius/i18n-shared` | Core types, utilities, locale data |
+| `@geenius/i18n-convex` | Convex schema and query/mutation factories |
+| `@geenius/i18n-react` | React hooks, components, admin pages (Tailwind) |
+| `@geenius/i18n-solidjs` | SolidJS primitives, components, admin pages |
+| `@geenius/i18n-react-css` | React components (vanilla CSS) |
+| `@geenius/i18n-solidjs-css` | SolidJS components (vanilla CSS) |
+
+## Quick Start
+
+### React
+
+```tsx
+import { I18nProvider, useI18n } from '@geenius/i18n/react'
+
+const translations = {
+  greeting: 'Hello {{name}}!',
+  items_zero: 'No items',
+  items_one: '1 item',
+  items_other: '{{count}} items',
+}
+
+function App() {
+  return (
+    <I18nProvider
+      config={{ defaultLocale: 'en', supportedLocales: ['en', 'es', 'fr'], persistLocale: true, detectBrowser: true }}
+      translations={translations}
+    >
+      <Dashboard />
+    </I18nProvider>
+  )
+}
+
+function Dashboard() {
+  const { t, locale, setLocale, formatDate, formatCurrency, isRTL } = useI18n()
+
+  return (
+    <div dir={isRTL ? 'rtl' : 'ltr'}>
+      <h1>{t('greeting', { name: 'Mehdi' })}</h1>
+      <p>{formatDate(new Date())}</p>
+      <p>{formatCurrency(49.99, 'USD')}</p>
+      <button onClick={() => setLocale('es')}>Switch to Spanish</button>
+    </div>
+  )
+}
+```
+
+### SolidJS
+
+```tsx
+import { I18nProvider, createI18n } from '@geenius/i18n/solidjs'
+
+function Dashboard() {
+  const { t, locale, setLocale } = createI18n()
+  return <h1>{t('greeting', { name: 'Mehdi' })}</h1>
+}
+```
+
+### Core Utilities
+
+```ts
+import { interpolate, t, plural, isRTL, formatDate, formatNumber, formatCurrency, detectLocale } from '@geenius/i18n/shared'
+
+interpolate('Hello {{name}}!', { name: 'Alice' })  // "Hello Alice!"
+isRTL('ar')  // true
+formatCurrency(42.99, 'EUR', 'de')  // "42,99 €"
+```
+
+### Convex Backend
+
+```ts
+import { schema, createI18nQueries, createI18nMutations } from '@geenius/i18n/convex'
+import { query, mutation } from './_generated/server'
+
+// Wire into your Convex project
+const { listTranslations, searchTranslations } = createI18nQueries(query)
+const { upsertTranslation, importTranslations } = createI18nMutations(mutation)
+
+export { listTranslations, searchTranslations, upsertTranslation, importTranslations }
+```
+
+### Config Builder
+
+```ts
+import { createI18nConfig, i18nPresets } from '@geenius/i18n/shared'
+
+// Builder pattern
+const config = createI18nConfig()
+  .withDefaultLocale('en')
+  .withSupportedLocales(['en', 'fr', 'de', 'es'])
+  .withFallbackLocale('en')
+  .withDebug(true)
+  .build()
+
+// Or use presets
+const simple = i18nPresets.simple('en')
+const multi = i18nPresets.multi()
+const global = i18nPresets.global()
+const dev = i18nPresets.development()
+```
+
+## Supported Locales
+
+English, French, German, Spanish, Portuguese, Italian, Dutch, Russian, Chinese, Japanese, Korean, Arabic (RTL), Hebrew (RTL), Turkish
+
+## Development
+
+```bash
+pnpm install
+pnpm build    # Build all packages
+pnpm test     # Run tests
+```
+
+## License
+
+MIT

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@geenius/i18n",
   "type": "module",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Geenius I18n — Internationalization for Convex apps (React + SolidJS)",
   "author": "Antigravity HQ",
   "license": "MIT",
@@ -19,19 +19,32 @@
     "solidjs",
     "geenius"
   ],
+  "files": [
+    "packages/shared/dist",
+    "packages/react/dist",
+    "packages/solidjs/dist",
+    "packages/convex/dist",
+    "packages/react-css/dist",
+    "packages/solidjs-css/dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
   "scripts": {
     "dev": "pnpm -r --parallel type-check",
     "build": "pnpm -r build",
     "clean": "pnpm -r clean",
     "lint": "pnpm -r --parallel type-check",
-    "test": "echo \"No tests configured yet\" && exit 0",
+    "test": "pnpm -r test",
     "type-check": "pnpm -r type-check",
     "format": "prettier --write \"packages/*/src/**/*.{ts,tsx}\"",
     "version:patch": "pnpm -r exec -- npm version patch --no-git-tag-version && npm version patch -m 'v%s'",
     "version:minor": "pnpm -r exec -- npm version minor --no-git-tag-version && npm version minor -m 'v%s'",
     "version:major": "pnpm -r exec -- npm version major --no-git-tag-version && npm version major -m 'v%s'",
     "release": "git push && git push --tags",
-    "publish:all": "pnpm -r publish --access public"
+    "publish:all": "pnpm -r publish --access public",
+    "publish:root": "npm publish --access public",
+    "prepublishOnly": "pnpm build"
   },
   "devDependencies": {
     "prettier": "^3.8.1",

package/packages/convex/dist/index.d.ts

@@ -0,0 +1,62 @@
+import * as convex_server from 'convex/server';
+import * as convex_values from 'convex/values';
+
+declare const _default: convex_server.SchemaDefinition<{
+    i18n_translations: convex_server.TableDefinition<convex_values.VObject<{
+        lastEditedBy?: string | undefined;
+        locale: string;
+        namespace: string;
+        key: string;
+        value: string;
+        updatedAt: string;
+        createdAt: string;
+    }, {
+        locale: convex_values.VString<string, "required">;
+        namespace: convex_values.VString<string, "required">;
+        key: convex_values.VString<string, "required">;
+        value: convex_values.VString<string, "required">;
+        lastEditedBy: convex_values.VString<string | undefined, "optional">;
+        updatedAt: convex_values.VString<string, "required">;
+        createdAt: convex_values.VString<string, "required">;
+    }, "required", "locale" | "namespace" | "key" | "value" | "lastEditedBy" | "updatedAt" | "createdAt">, {
+        by_locale_ns: ["locale", "namespace", "_creationTime"];
+        by_key: ["key", "_creationTime"];
+    }, {}, {}>;
+    i18n_missing_keys: convex_server.TableDefinition<convex_values.VObject<{
+        locale: string;
+        namespace: string;
+        key: string;
+        detectedAt: string;
+        count: number;
+    }, {
+        locale: convex_values.VString<string, "required">;
+        namespace: convex_values.VString<string, "required">;
+        key: convex_values.VString<string, "required">;
+        detectedAt: convex_values.VString<string, "required">;
+        count: convex_values.VFloat64<number, "required">;
+    }, "required", "locale" | "namespace" | "key" | "detectedAt" | "count">, {
+        by_locale: ["locale", "_creationTime"];
+        by_key: ["key", "_creationTime"];
+    }, {}, {}>;
+}, true>;
+
+type QueryFn = (...args: any[]) => any;
+declare function createI18nQueries(query: QueryFn): {
+    listTranslations: any;
+    getTranslation: any;
+    listLocaleStats: any;
+    listMissingKeys: any;
+    searchTranslations: any;
+};
+
+type MutationFn = (...args: any[]) => any;
+declare function createI18nMutations(mutation: MutationFn): {
+    upsertTranslation: any;
+    deleteTranslation: any;
+    importTranslations: any;
+    reportMissingKey: any;
+    clearMissingKey: any;
+    bulkUpsert: any;
+};
+
+export { createI18nMutations, createI18nQueries, _default as schema };

package/packages/convex/dist/index.js

@@ -0,0 +1,157 @@
+// src/schema.ts
+import { defineSchema, defineTable } from "convex/server";
+import { v } from "convex/values";
+var schema_default = defineSchema({
+  i18n_translations: defineTable({
+    locale: v.string(),
+    namespace: v.string(),
+    key: v.string(),
+    value: v.string(),
+    lastEditedBy: v.optional(v.string()),
+    updatedAt: v.string(),
+    createdAt: v.string()
+  }).index("by_locale_ns", ["locale", "namespace"]).index("by_key", ["key"]),
+  i18n_missing_keys: defineTable({
+    locale: v.string(),
+    namespace: v.string(),
+    key: v.string(),
+    detectedAt: v.string(),
+    count: v.number()
+  }).index("by_locale", ["locale"]).index("by_key", ["key"])
+});
+
+// src/queries.ts
+import { v as v2 } from "convex/values";
+function createI18nQueries(query) {
+  const listTranslations = query({
+    args: { locale: v2.string(), namespace: v2.optional(v2.string()) },
+    handler: async (ctx, args) => {
+      if (args.namespace) return ctx.db.query("i18n_translations").withIndex("by_locale_ns", (q) => q.eq("locale", args.locale).eq("namespace", args.namespace)).collect();
+      return ctx.db.query("i18n_translations").withIndex("by_locale_ns", (q) => q.eq("locale", args.locale)).collect();
+    }
+  });
+  const getTranslation = query({
+    args: { locale: v2.string(), key: v2.string(), namespace: v2.optional(v2.string()) },
+    handler: async (ctx, args) => {
+      const results = await ctx.db.query("i18n_translations").withIndex("by_key", (q) => q.eq("key", args.key)).collect();
+      return results.find((r) => r.locale === args.locale && (!args.namespace || r.namespace === args.namespace)) ?? null;
+    }
+  });
+  const listLocaleStats = query({
+    args: {},
+    handler: async (ctx) => {
+      const all = await ctx.db.query("i18n_translations").collect();
+      const missing = await ctx.db.query("i18n_missing_keys").collect();
+      const localeMap = /* @__PURE__ */ new Map();
+      const missingMap = /* @__PURE__ */ new Map();
+      for (const t of all) localeMap.set(t.locale, (localeMap.get(t.locale) ?? 0) + 1);
+      for (const m of missing) missingMap.set(m.locale, (missingMap.get(m.locale) ?? 0) + 1);
+      const stats = [];
+      for (const [locale, total] of localeMap) {
+        const miss = missingMap.get(locale) ?? 0;
+        stats.push({ locale, totalKeys: total, missingKeys: miss, coverage: total > 0 ? Math.round((total - miss) / total * 100) : 0 });
+      }
+      return stats;
+    }
+  });
+  const listMissingKeys = query({
+    args: { locale: v2.optional(v2.string()), limit: v2.optional(v2.number()) },
+    handler: async (ctx, args) => {
+      if (args.locale) return ctx.db.query("i18n_missing_keys").withIndex("by_locale", (q) => q.eq("locale", args.locale)).take(args.limit ?? 100);
+      return ctx.db.query("i18n_missing_keys").order("desc").take(args.limit ?? 100);
+    }
+  });
+  const searchTranslations = query({
+    args: { query: v2.string(), locale: v2.optional(v2.string()) },
+    handler: async (ctx, args) => {
+      let items = await ctx.db.query("i18n_translations").collect();
+      if (args.locale) items = items.filter((i) => i.locale === args.locale);
+      const q = args.query.toLowerCase();
+      return items.filter((i) => i.key.toLowerCase().includes(q) || i.value.toLowerCase().includes(q)).slice(0, 50);
+    }
+  });
+  return { listTranslations, getTranslation, listLocaleStats, listMissingKeys, searchTranslations };
+}
+
+// src/mutations.ts
+import { v as v3 } from "convex/values";
+function createI18nMutations(mutation) {
+  const upsertTranslation = mutation({
+    args: { locale: v3.string(), namespace: v3.string(), key: v3.string(), value: v3.string(), editedBy: v3.optional(v3.string()) },
+    handler: async (ctx, args) => {
+      const existing = await ctx.db.query("i18n_translations").withIndex("by_key", (q) => q.eq("key", args.key)).collect();
+      const match = existing.find((e) => e.locale === args.locale && e.namespace === args.namespace);
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      if (match) {
+        await ctx.db.patch(match._id, { value: args.value, lastEditedBy: args.editedBy, updatedAt: now });
+      } else {
+        await ctx.db.insert("i18n_translations", { locale: args.locale, namespace: args.namespace, key: args.key, value: args.value, lastEditedBy: args.editedBy, updatedAt: now, createdAt: now });
+      }
+    }
+  });
+  const deleteTranslation = mutation({
+    args: { locale: v3.string(), key: v3.string(), namespace: v3.optional(v3.string()) },
+    handler: async (ctx, args) => {
+      const items = await ctx.db.query("i18n_translations").withIndex("by_key", (q) => q.eq("key", args.key)).collect();
+      for (const item of items) {
+        if (item.locale === args.locale && (!args.namespace || item.namespace === args.namespace)) await ctx.db.delete(item._id);
+      }
+    }
+  });
+  const importTranslations = mutation({
+    args: { locale: v3.string(), namespace: v3.string(), dict: v3.any() },
+    handler: async (ctx, args) => {
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      const entries = args.dict;
+      for (const [key, value] of Object.entries(entries)) {
+        const existing = await ctx.db.query("i18n_translations").withIndex("by_key", (q) => q.eq("key", key)).collect();
+        const match = existing.find((e) => e.locale === args.locale && e.namespace === args.namespace);
+        if (match) {
+          await ctx.db.patch(match._id, { value, updatedAt: now });
+        } else {
+          await ctx.db.insert("i18n_translations", { locale: args.locale, namespace: args.namespace, key, value, updatedAt: now, createdAt: now });
+        }
+      }
+    }
+  });
+  const reportMissingKey = mutation({
+    args: { locale: v3.string(), namespace: v3.string(), key: v3.string() },
+    handler: async (ctx, args) => {
+      const existing = await ctx.db.query("i18n_missing_keys").withIndex("by_key", (q) => q.eq("key", args.key)).collect();
+      const match = existing.find((e) => e.locale === args.locale && e.namespace === args.namespace);
+      if (match) {
+        await ctx.db.patch(match._id, { count: match.count + 1 });
+      } else {
+        await ctx.db.insert("i18n_missing_keys", { ...args, detectedAt: (/* @__PURE__ */ new Date()).toISOString(), count: 1 });
+      }
+    }
+  });
+  const clearMissingKey = mutation({
+    args: { id: v3.id("i18n_missing_keys") },
+    handler: async (ctx, args) => {
+      await ctx.db.delete(args.id);
+    }
+  });
+  const bulkUpsert = mutation({
+    args: { items: v3.array(v3.object({ locale: v3.string(), namespace: v3.string(), key: v3.string(), value: v3.string() })) },
+    handler: async (ctx, args) => {
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      for (const item of args.items) {
+        const existing = await ctx.db.query("i18n_translations").withIndex("by_key", (q) => q.eq("key", item.key)).collect();
+        const match = existing.find((e) => e.locale === item.locale && e.namespace === item.namespace);
+        if (match) {
+          await ctx.db.patch(match._id, { value: item.value, updatedAt: now });
+        } else {
+          await ctx.db.insert("i18n_translations", { ...item, updatedAt: now, createdAt: now });
+        }
+      }
+    }
+  });
+  return { upsertTranslation, deleteTranslation, importTranslations, reportMissingKey, clearMissingKey, bulkUpsert };
+}
+export {
+  createI18nMutations,
+  createI18nQueries,
+  schema_default as schema
+};
+//# sourceMappingURL=index.js.map

package/packages/convex/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema.ts","../src/queries.ts","../src/mutations.ts"],"sourcesContent":["import { defineSchema, defineTable } from 'convex/server'\nimport { v } from 'convex/values'\n\nexport default defineSchema({\n  i18n_translations: defineTable({\n    locale: v.string(),\n    namespace: v.string(),\n    key: v.string(),\n    value: v.string(),\n    lastEditedBy: v.optional(v.string()),\n    updatedAt: v.string(),\n    createdAt: v.string(),\n  })\n    .index('by_locale_ns', ['locale', 'namespace'])\n    .index('by_key', ['key']),\n\n  i18n_missing_keys: defineTable({\n    locale: v.string(),\n    namespace: v.string(),\n    key: v.string(),\n    detectedAt: v.string(),\n    count: v.number(),\n  })\n    .index('by_locale', ['locale'])\n    .index('by_key', ['key']),\n})\n","import { v } from 'convex/values'\n\ntype QueryFn = (...args: any[]) => any\n\nexport function createI18nQueries(query: QueryFn) {\n  const listTranslations = query({\n    args: { locale: v.string(), namespace: v.optional(v.string()) },\n    handler: async (ctx: any, args: { locale: string; namespace?: string }) => {\n      if (args.namespace) return ctx.db.query('i18n_translations').withIndex('by_locale_ns', (q: any) => q.eq('locale', args.locale).eq('namespace', args.namespace!)).collect()\n      return ctx.db.query('i18n_translations').withIndex('by_locale_ns', (q: any) => q.eq('locale', args.locale)).collect()\n    },\n  })\n\n  const getTranslation = query({\n    args: { locale: v.string(), key: v.string(), namespace: v.optional(v.string()) },\n    handler: async (ctx: any, args: { locale: string; key: string; namespace?: string }) => {\n      const results = await ctx.db.query('i18n_translations').withIndex('by_key', (q: any) => q.eq('key', args.key)).collect()\n      return results.find((r: any) => r.locale === args.locale && (!args.namespace || r.namespace === args.namespace)) ?? null\n    },\n  })\n\n  const listLocaleStats = query({\n    args: {},\n    handler: async (ctx: any) => {\n      const all = await ctx.db.query('i18n_translations').collect()\n      const missing = await ctx.db.query('i18n_missing_keys').collect()\n      const localeMap = new Map<string, number>()\n      const missingMap = new Map<string, number>()\n      for (const t of all) localeMap.set(t.locale, (localeMap.get(t.locale) ?? 0) + 1)\n      for (const m of missing) missingMap.set(m.locale, (missingMap.get(m.locale) ?? 0) + 1)\n      const stats: { locale: string; totalKeys: number; missingKeys: number; coverage: number }[] = []\n      for (const [locale, total] of localeMap) {\n        const miss = missingMap.get(locale) ?? 0\n        stats.push({ locale, totalKeys: total, missingKeys: miss, coverage: total > 0 ? Math.round(((total - miss) / total) * 100) : 0 })\n      }\n      return stats\n    },\n  })\n\n  const listMissingKeys = query({\n    args: { locale: v.optional(v.string()), limit: v.optional(v.number()) },\n    handler: async (ctx: any, args: { locale?: string; limit?: number }) => {\n      if (args.locale) return ctx.db.query('i18n_missing_keys').withIndex('by_locale', (q: any) => q.eq('locale', args.locale!)).take(args.limit ?? 100)\n      return ctx.db.query('i18n_missing_keys').order('desc').take(args.limit ?? 100)\n    },\n  })\n\n  const searchTranslations = query({\n    args: { query: v.string(), locale: v.optional(v.string()) },\n    handler: async (ctx: any, args: { query: string; locale?: string }) => {\n      let items = await ctx.db.query('i18n_translations').collect()\n      if (args.locale) items = items.filter((i: any) => i.locale === args.locale)\n      const q = args.query.toLowerCase()\n      return items.filter((i: any) => i.key.toLowerCase().includes(q) || i.value.toLowerCase().includes(q)).slice(0, 50)\n    },\n  })\n\n  return { listTranslations, getTranslation, listLocaleStats, listMissingKeys, searchTranslations }\n}\n","import { v } from 'convex/values'\n\ntype MutationFn = (...args: any[]) => any\n\nexport function createI18nMutations(mutation: MutationFn) {\n  const upsertTranslation = mutation({\n    args: { locale: v.string(), namespace: v.string(), key: v.string(), value: v.string(), editedBy: v.optional(v.string()) },\n    handler: async (ctx: any, args: { locale: string; namespace: string; key: string; value: string; editedBy?: string }) => {\n      const existing = await ctx.db.query('i18n_translations').withIndex('by_key', (q: any) => q.eq('key', args.key)).collect()\n      const match = existing.find((e: any) => e.locale === args.locale && e.namespace === args.namespace)\n      const now = new Date().toISOString()\n      if (match) { await ctx.db.patch(match._id, { value: args.value, lastEditedBy: args.editedBy, updatedAt: now }) }\n      else { await ctx.db.insert('i18n_translations', { locale: args.locale, namespace: args.namespace, key: args.key, value: args.value, lastEditedBy: args.editedBy, updatedAt: now, createdAt: now }) }\n    },\n  })\n\n  const deleteTranslation = mutation({\n    args: { locale: v.string(), key: v.string(), namespace: v.optional(v.string()) },\n    handler: async (ctx: any, args: { locale: string; key: string; namespace?: string }) => {\n      const items = await ctx.db.query('i18n_translations').withIndex('by_key', (q: any) => q.eq('key', args.key)).collect()\n      for (const item of items) {\n        if (item.locale === args.locale && (!args.namespace || item.namespace === args.namespace)) await ctx.db.delete(item._id)\n      }\n    },\n  })\n\n  const importTranslations = mutation({\n    args: { locale: v.string(), namespace: v.string(), dict: v.any() },\n    handler: async (ctx: any, args: { locale: string; namespace: string; dict: any }) => {\n      const now = new Date().toISOString()\n      const entries = args.dict as Record<string, string>\n      for (const [key, value] of Object.entries(entries)) {\n        const existing = await ctx.db.query('i18n_translations').withIndex('by_key', (q: any) => q.eq('key', key)).collect()\n        const match = existing.find((e: any) => e.locale === args.locale && e.namespace === args.namespace)\n        if (match) { await ctx.db.patch(match._id, { value, updatedAt: now }) }\n        else { await ctx.db.insert('i18n_translations', { locale: args.locale, namespace: args.namespace, key, value, updatedAt: now, createdAt: now }) }\n      }\n    },\n  })\n\n  const reportMissingKey = mutation({\n    args: { locale: v.string(), namespace: v.string(), key: v.string() },\n    handler: async (ctx: any, args: { locale: string; namespace: string; key: string }) => {\n      const existing = await ctx.db.query('i18n_missing_keys').withIndex('by_key', (q: any) => q.eq('key', args.key)).collect()\n      const match = existing.find((e: any) => e.locale === args.locale && e.namespace === args.namespace)\n      if (match) { await ctx.db.patch(match._id, { count: match.count + 1 }) }\n      else { await ctx.db.insert('i18n_missing_keys', { ...args, detectedAt: new Date().toISOString(), count: 1 }) }\n    },\n  })\n\n  const clearMissingKey = mutation({\n    args: { id: v.id('i18n_missing_keys') },\n    handler: async (ctx: any, args: { id: any }) => { await ctx.db.delete(args.id) },\n  })\n\n  const bulkUpsert = mutation({\n    args: { items: v.array(v.object({ locale: v.string(), namespace: v.string(), key: v.string(), value: v.string() })) },\n    handler: async (ctx: any, args: { items: Array<{ locale: string; namespace: string; key: string; value: string }> }) => {\n      const now = new Date().toISOString()\n      for (const item of args.items) {\n        const existing = await ctx.db.query('i18n_translations').withIndex('by_key', (q: any) => q.eq('key', item.key)).collect()\n        const match = existing.find((e: any) => e.locale === item.locale && e.namespace === item.namespace)\n        if (match) { await ctx.db.patch(match._id, { value: item.value, updatedAt: now }) }\n        else { await ctx.db.insert('i18n_translations', { ...item, updatedAt: now, createdAt: now }) }\n      }\n    },\n  })\n\n  return { upsertTranslation, deleteTranslation, importTranslations, reportMissingKey, clearMissingKey, bulkUpsert }\n}\n"],"mappings":"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","names":["v","v"]}

package/packages/react/README.md

@@ -1 +1 @@
-# ✦ @geenius-i18n/react\n\n> Geenius I18n — React components & hooks\n\n---\n\n## Overview\nBuilt with Steve Jobs-level minimalism and Jony Ive-level craftsmanship, this package is designed to deliver unparalleled developer experience (DX) and rock-solid performance.\n\n## Installation\n\n```bash\npnpm add @geenius-i18n/react\n```\n\n## Usage\n\n```typescript\nimport { init } from '@geenius-i18n/react';\n\n// Initialize the module with absolute precision\ninit({\n  mode: 'premium',\n});\n```\n\n## Architecture\n- **Zero-config**: It just works.\n- **Strictly Typed**: Fully written in TypeScript for flawless IntelliSense.\n- **Framework Agnostic**: seamlessly integrates into the Geenius ecosystem.\n\n---\n\n*Designed by Antigravity HQ*\n
+# ✦ @geenius/i18n-react\n\n> Geenius I18n — React components & hooks\n\n---\n\n## Overview\nBuilt with Steve Jobs-level minimalism and Jony Ive-level craftsmanship, this package is designed to deliver unparalleled developer experience (DX) and rock-solid performance.\n\n## Installation\n\n```bash\npnpm add @geenius/i18n-react\n```\n\n## Usage\n\n```typescript\nimport { init } from '@geenius/i18n-react';\n\n// Initialize the module with absolute precision\ninit({\n  mode: 'premium',\n});\n```\n\n## Architecture\n- **Zero-config**: It just works.\n- **Strictly Typed**: Fully written in TypeScript for flawless IntelliSense.\n- **Framework Agnostic**: seamlessly integrates into the Geenius ecosystem.\n\n---\n\n*Designed by Antigravity HQ*\n

package/packages/react/dist/index.d.ts

@@ -0,0 +1,100 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import react__default from 'react';
+import * as _geenius_i18n_shared from '@geenius/i18n-shared';
+import { I18nConfig, TranslationDict, Locale, Direction, I18nNamespace, TranslationEntry, MissingKey, LocaleStat } from '@geenius/i18n-shared';
+export { Direction, I18nConfig, I18nNamespace, Locale, LocaleInfo, LocaleStat, MissingKey, TranslationDict, TranslationEntry } from '@geenius/i18n-shared';
+
+interface I18nContextValue {
+    locale: Locale;
+    direction: Direction;
+    isRTL: boolean;
+    setLocale: (l: Locale) => void;
+    t: (key: string, params?: Record<string, string | number>) => string;
+    formatDate: (date: Date | string, opts?: Intl.DateTimeFormatOptions) => string;
+    formatNumber: (n: number, opts?: Intl.NumberFormatOptions) => string;
+    formatCurrency: (amount: number, currency: string) => string;
+}
+declare function I18nProvider({ children, config, translations }: {
+    children: react__default.ReactNode;
+    config: I18nConfig;
+    translations?: TranslationDict;
+}): react_jsx_runtime.JSX.Element;
+declare function useI18n(): I18nContextValue;
+
+declare function useLocaleDetect(supportedLocales: Locale[]): {
+    detectedLocale: Locale;
+    isDetecting: boolean;
+};
+
+declare function useTranslations(locale: Locale, namespace: I18nNamespace): {
+    dict: TranslationDict;
+    isLoading: boolean;
+    t: (key: string, params?: Record<string, string | number>) => string;
+};
+
+declare function useI18nAdmin(data: {
+    translations?: TranslationEntry[];
+    missingKeys?: MissingKey[];
+    localeStats?: LocaleStat[];
+}, mutations: {
+    upsert: (locale: string, ns: string, key: string, value: string) => Promise<void>;
+    deleteKey: (locale: string, key: string) => Promise<void>;
+    importDict: (locale: string, ns: string, dict: Record<string, string>) => Promise<void>;
+    clearMissing: (id: string) => Promise<void>;
+}): {
+    upsert: (locale: string, ns: string, key: string, value: string) => Promise<void>;
+    deleteKey: (locale: string, key: string) => Promise<void>;
+    importDict: (locale: string, ns: string, dict: Record<string, string>) => Promise<void>;
+    clearMissing: (id: string) => Promise<void>;
+    translations: TranslationEntry[];
+    missingKeys: MissingKey[];
+    localeStats: LocaleStat[];
+    search: string;
+    setSearch: react.Dispatch<react.SetStateAction<string>>;
+    isLoading: boolean;
+};
+
+declare function LocaleSwitcher({ locales, current, onChange }: {
+    locales: Locale[];
+    current: Locale;
+    onChange: (l: Locale) => void;
+}): react_jsx_runtime.JSX.Element;
+declare function RTLWrapper({ children, locale }: {
+    children: react__default.ReactNode;
+    locale?: Locale;
+}): react_jsx_runtime.JSX.Element;
+declare function TranslationEditor({ onSave, initialKey, initialLocale, namespaces }: {
+    onSave: (locale: string, ns: string, key: string, value: string) => void;
+    initialKey?: string;
+    initialLocale?: Locale;
+    namespaces?: string[];
+}): react_jsx_runtime.JSX.Element;
+declare function TranslationTable({ translations, locale, onUpdate, onDelete }: {
+    translations: TranslationEntry[];
+    locale: Locale;
+    onUpdate?: (key: string, value: string) => void;
+    onDelete?: (key: string) => void;
+}): react_jsx_runtime.JSX.Element;
+declare function MissingKeyAlert({ count, locale }: {
+    count: number;
+    locale: Locale;
+}): react_jsx_runtime.JSX.Element | null;
+declare function LocaleStatsCard({ stats }: {
+    stats: LocaleStat[];
+}): react_jsx_runtime.JSX.Element;
+
+interface I18nAdminPageProps {
+    translations?: TranslationEntry[];
+    missingKeys?: MissingKey[];
+    localeStats?: LocaleStat[];
+    mutations: Parameters<typeof useI18nAdmin>[1];
+}
+declare function I18nAdminPage({ translations, missingKeys, localeStats, mutations }: I18nAdminPageProps): react_jsx_runtime.JSX.Element;
+
+declare function LocalePreviewPage({ config, translations }: {
+    config?: Partial<_geenius_i18n_shared.I18nConfig>;
+    translations?: TranslationDict;
+}): react_jsx_runtime.JSX.Element;
+
+export { I18nAdminPage, I18nProvider, LocalePreviewPage, LocaleStatsCard, LocaleSwitcher, MissingKeyAlert, RTLWrapper, TranslationEditor, TranslationTable, useI18n, useI18nAdmin, useLocaleDetect, useTranslations };