@wxn0brp/falcon-frame-lang 0.0.2 → 0.1.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 wxn0brP
+Copyright (c) 2026 wxn0brP
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -17,7 +17,7 @@ This package provides easy-to-use internationalization (i18n) functionality for
 ## Installation
 
 ```bash
-yarn add github:wxn0brP/FalconFrame-lang#dist
+npm i @wxn0brp/falcon-frame-lang @wxn0brp/falcon-frame
 ```
 
 ## Usage
@@ -26,22 +26,27 @@ yarn add github:wxn0brP/FalconFrame-lang#dist
 
 ```typescript
 import { createLangRouter } from "@wxn0brp/falcon-frame-lang";
+import { FalconFrame } from "@wxn0brp/falcon-frame";
+
+const app = new FalconFrame();
 
 const config = {
     meta: {
         "home": { title: "Home Page" },
         "about": { title: "About Us" }
-    },
+    },                            // Meta data for specific pages
     dir: "public",                // Directory containing HTML files (default: "public")
     layout: "public/layout.html", // Layout file path (default: "public/layout.html")
     langDir: "public/lang",       // Directory containing language JSON files (default: "public/lang")
-    getSpecific: (name: string) => {
+    disableCache: false,          // Disable caching of language data
+    getSpecific: async (name: string) => {
         // Return specific data for the given page name
         return {};
     }
 };
 
 const langRouter = createLangRouter(config);
+app.use("/:name", langRouter);
 ```
 
 ### Language Files

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { RouteHandler } from "@wxn0brp/falcon-frame";
+import { Config } from "./types.js";
+export declare function createLangRouter(cfg: Partial<Config>): RouteHandler;

package/dist/index.js

@@ -0,0 +1,58 @@
+import { renderHTML } from "@wxn0brp/falcon-frame";
+import { getLang, getLangData } from "./lang.js";
+export function createLangRouter(cfg) {
+    const config = {
+        dir: "public",
+        layout: "public/layout.html",
+        langDir: "public/lang",
+        disableCache: false,
+        meta: undefined,
+        getSpecific: () => ({}),
+        ...cfg
+    };
+    if (!config.dir.endsWith("/"))
+        config.dir += "/";
+    if (!config.langDir.endsWith("/"))
+        config.langDir += "/";
+    return async (req, res, next) => {
+        const name = req.params.name;
+        let meta = {};
+        if (config.meta) {
+            meta = config.meta[name] || config.meta["*"];
+            if (!meta)
+                return next();
+        }
+        const lang = getLang(req);
+        const langData = getLangData(req, config, lang);
+        const mapLangData = Object.keys(langData).reduce((acc, key) => {
+            const _key = "t_" + key.replaceAll("-", "_").replaceAll(".", "_").replaceAll(" ", "_");
+            acc[_key] = langData[key];
+            return acc;
+        }, {});
+        const dataObj = {
+            lang,
+            name,
+            ...(mapLangData || {}),
+            ...(await config.getSpecific?.(name) || {})
+        };
+        if (meta?.title)
+            dataObj.title = meta.title;
+        const html = renderHTML(config.dir + name + ".html", dataObj, [], res.FF);
+        res.ct("text/html; charset=utf-8");
+        res.end(translateHtml(html, langData, lang));
+    };
+}
+function translateHtml(html, langData, lang = "en") {
+    html = html.replace(/<([^>]*?)\s+translate\s*=\s*["']([^"']+)["']([^>]*?)>(.*?)<\/[^>]*?>/gs, (fullMatch, beforeTranslate, translateValue, afterTranslate) => {
+        let translatedText = langData[translateValue] || translateValue;
+        return `<${beforeTranslate} translate="${translateValue}" ${afterTranslate}>${translatedText}</${fullMatch.match(/<\/(\w+)/)[1]}>`;
+    });
+    html = html.replace(/(<[^>]*?)\s+translate-([a-z-]+)=["']([^"']+)["']([^>]*>)/gi, (_, beforeTag, attrName, attrValue, afterTag) => {
+        const translatedValue = langData[attrValue] || attrValue;
+        return `${beforeTag} translate-${attrName}="${attrValue}" ${attrName}="${translatedValue}"${afterTag}`;
+    });
+    html = html.replace(/<html\s+lang=["']([^"']+)["']>/gi, () => {
+        return `<html lang="${lang}">`;
+    });
+    return html;
+}

package/dist/lang.d.ts

@@ -0,0 +1,6 @@
+import { AnotherCache } from "@wxn0brp/ac";
+import { FFRequest } from "@wxn0brp/falcon-frame";
+import { Config } from "./types.js";
+export declare const cache: AnotherCache<any, string>;
+export declare function getLang(req: FFRequest): string;
+export declare function getLangData(req: FFRequest, config: Config, lang?: string): Record<string, string>;

package/dist/lang.js

@@ -0,0 +1,25 @@
+import { AnotherCache } from "@wxn0brp/ac";
+import { existsSync, readFileSync } from "fs";
+export const cache = new AnotherCache();
+export function getLang(req) {
+    let lang = req.query.lang || req.cookies.lang || req.headers["accept-language"];
+    if (!lang)
+        return "en";
+    lang = lang.split(",")[0].split(";")[0].split("-")[0];
+    return lang;
+}
+export function getLangData(req, config, lang = getLang(req)) {
+    if (!config.disableCache && cache.has(lang))
+        return cache.get(lang);
+    const path = config.langDir + lang + ".json";
+    if (existsSync(path)) {
+        try {
+            const data = JSON.parse(readFileSync(path, "utf-8"));
+            if (!config.disableCache)
+                cache.set(lang, data);
+            return data;
+        }
+        catch { }
+    }
+    return {};
+}

package/dist/types.d.ts

@@ -0,0 +1,11 @@
+export interface Config {
+    meta: Record<string, {
+        title: string;
+        [key: string]: any;
+    }>;
+    dir: string;
+    layout: string;
+    langDir: string;
+    getSpecific: (name: string) => Promise<Record<string, any>> | Record<string, any>;
+    disableCache: boolean;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,51 +1,49 @@
 {
-    "name": "@wxn0brp/falcon-frame-lang",
-    "version": "0.0.2",
-    "main": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "description": "FalconFrame language middleware for multi-language support",
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/wxn0brP/FalconFrame-lang.git"
+  "name": "@wxn0brp/falcon-frame-lang",
+  "version": "0.1.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "description": "FalconFrame language middleware for multi-language support",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wxn0brP/FalconFrame-lang.git"
+  },
+  "homepage": "https://github.com/wxn0brP/FalconFrame",
+  "author": "wxn0brP",
+  "license": "MIT",
+  "type": "module",
+  "keywords": [
+    "falcon-frame",
+    "i18n",
+    "localization",
+    "translation",
+    "lang",
+    "language"
+  ],
+  "devDependencies": {
+    "@types/node": "*",
+    "@wxn0brp/ac": "^0.0.3",
+    "@wxn0brp/falcon-frame": "^0.7.0",
+    "tsc-alias": "*",
+    "typescript": "*"
+  },
+  "peerDependencies": {
+    "@wxn0brp/ac": ">=0.0.3",
+    "@wxn0brp/falcon-frame": ">=0.7.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     },
-    "homepage": "https://github.com/wxn0brP/FalconFrame",
-    "author": "wxn0brP",
-    "license": "MIT",
-    "type": "module",
-    "scripts": {
-        "build": "tsc && tsc-alias"
-    },
-    "keywords": [
-        "falcon-frame",
-        "i18n",
-        "localization",
-        "translation",
-        "lang",
-        "language"
-    ],
-    "devDependencies": {
-        "@types/node": "*",
-        "@wxn0brp/ac": "^0.0.2",
-        "@wxn0brp/falcon-frame": "^0.4.0",
-        "typescript": "*"
-    },
-    "peerDependencies": {
-        "@wxn0brp/ac": ">=0.0.2",
-        "@wxn0brp/falcon-frame": ">=0.4.0"
-    },
-    "files": [
-        "dist"
-    ],
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js",
-            "default": "./dist/index.js"
-        },
-        "./*": {
-            "types": "./dist/*.d.ts",
-            "import": "./dist/*.js",
-            "default": "./dist/*.js"
-        }
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
     }
-}
+  }
+}