Initial implementation of localization

lib/i18n/getTranslation.ts

@@ -0,0 +1,59 @@
+import type messages from "../../messages/en/index";
+
+type Messages = typeof messages;
+
+/**
+ * Helper function to access nested translation keys from messages object
+ * This provides a type-safe way to access translations in server components
+ * without requiring the next-intl plugin configuration.
+ *
+ * @param messages - The messages object from messages/en/index
+ * @param key - Dot-separated key path (e.g., "heroBanner.title")
+ * @returns The translation string or the key if not found
+ */
+export function getTranslation(
+  messages: Messages,
+  key: string,
+): string {
+  const keys = key.split(".");
+  let value: any = messages;
+
+  for (const k of keys) {
+    if (value && typeof value === "object" && k in value) {
+      value = value[k as keyof typeof value];
+    } else {
+      // Fallback to key if path not found
+      return key;
+    }
+  }
+
+  return typeof value === "string" ? value : key;
+}
+
+/**
+ * Type-safe helper to get nested values from messages
+ * Usage: getNested(messages, "heroBanner", "title")
+ */
+export function getNested<T extends keyof Messages>(
+  messages: Messages,
+  namespace: T,
+  key: string,
+): string {
+  const namespaceObj = messages[namespace];
+  if (!namespaceObj || typeof namespaceObj !== "object") {
+    return key;
+  }
+
+  const keys = key.split(".");
+  let value: any = namespaceObj;
+
+  for (const k of keys) {
+    if (value && typeof value === "object" && k in value) {
+      value = value[k];
+    } else {
+      return key;
+    }
+  }
+
+  return typeof value === "string" ? value : key;
+}

lib/i18n/types.ts

@@ -0,0 +1,21 @@
+/**
+ * Type definitions for translation keys
+ * 
+ * These types provide type safety when accessing translation keys.
+ * The actual types are inferred from the JSON files in messages/en/
+ */
+
+// Import the message structure to ensure type safety
+import type messages from "../../messages/en/index";
+
+export type Messages = typeof messages;
+
+// Helper type for nested key paths
+export type NestedKeyOf<ObjectType extends object> = {
+  [Key in keyof ObjectType & (string | number)]: ObjectType[Key] extends object
+    ? `${Key}` | `${Key}.${NestedKeyOf<ObjectType[Key]>}`
+    : `${Key}`;
+}[keyof ObjectType & (string | number)];
+
+// Type for all possible translation keys
+export type TranslationKey = NestedKeyOf<Messages>;