@starci/hfs 1.0.0

package/templates/fe/skeleton/apps/__app__/src/app/[locale]/page.tsx

@@ -0,0 +1,27 @@
+import type { Metadata } from "next"
+import { getTranslations, setRequestLocale } from "next-intl/server"
+
+interface HomePageProps {
+    readonly params: Promise<{ readonly locale: string }>
+}
+
+/** The document title comes from the catalog of the requested locale. */
+export const generateMetadata = async ({ params }: HomePageProps): Promise<Metadata> => {
+    const { locale } = await params
+    const t = await getTranslations({ locale, namespace: "home" })
+    return { title: t("title") }
+}
+
+/** The first page of the app; a server component, so no catalog is shipped for it. */
+const HomePage = async ({ params }: HomePageProps) => {
+    const { locale } = await params
+    setRequestLocale(locale)
+    const t = await getTranslations("home")
+    return (
+        <main>
+            <h1>{t("title")}</h1>
+        </main>
+    )
+}
+
+export default HomePage

package/templates/fe/skeleton/apps/__app__/src/app/global-error.tsx

@@ -0,0 +1,24 @@
+"use client"
+
+import { DEFAULT_LOCALE } from "../modules/i18n/config"
+import messages from "../modules/i18n/messages/vi.json"
+
+interface GlobalErrorProps {
+    readonly reset: () => void
+}
+
+/** Last-resort boundary above the locale layout: it has no provider, so it reads the default catalog directly. */
+const GlobalError = ({ reset }: GlobalErrorProps) => (
+    <html lang={DEFAULT_LOCALE}>
+        <body>
+            <main role="alert">
+                <h1>{messages.errors.global.title}</h1>
+                <button type="button" onClick={reset}>
+                    {messages.errors.global.retry}
+                </button>
+            </main>
+        </body>
+    </html>
+)
+
+export default GlobalError

package/templates/fe/skeleton/apps/__app__/src/app/globals.css

@@ -0,0 +1 @@
+@import "tailwindcss";

package/templates/fe/skeleton/apps/__app__/src/app/health/live/route.spec.ts

@@ -0,0 +1,10 @@
+import { describe, expect, it } from "vitest"
+import { GET } from "./route"
+
+describe("GET /health/live", () => {
+    it("answers the { status, info, error, details } shape from process-local state", async () => {
+        const response = GET()
+        expect(response.status).toBe(200)
+        await expect(response.json()).resolves.toEqual({ status: "ok", info: {}, error: {}, details: {} })
+    })
+})

package/templates/fe/skeleton/apps/__app__/src/app/health/live/route.ts

@@ -0,0 +1,5 @@
+/** Liveness is answered per request, never prerendered at build time. */
+export const dynamic = "force-dynamic"
+
+/** Liveness probe: `{ status, info, error, details }` from process-local state; it never touches a dependency. */
+export const GET = (): Response => Response.json({ status: "ok", info: {}, error: {}, details: {} })

package/templates/fe/skeleton/apps/__app__/src/modules/i18n/config.ts

@@ -0,0 +1,8 @@
+/** The locales the {{app}} app serves; every catalog under `messages/` has the same keys. */
+export const LOCALES = ["vi"] as const
+
+/** A served locale. */
+export type Locale = (typeof LOCALES)[number]
+
+/** The locale served at the unprefixed path. */
+export const DEFAULT_LOCALE: Locale = "vi"

package/templates/fe/skeleton/apps/__app__/src/modules/i18n/messages/vi.json

@@ -0,0 +1,19 @@
+{
+  "home": {
+    "title": "Trang chủ"
+  },
+  "notFound": {
+    "title": "Không tìm thấy trang",
+    "home": "Về trang chủ"
+  },
+  "errors": {
+    "page": {
+      "title": "Đã xảy ra lỗi",
+      "retry": "Thử lại"
+    },
+    "global": {
+      "title": "Đã xảy ra lỗi nghiêm trọng",
+      "retry": "Thử lại"
+    }
+  }
+}

package/templates/fe/skeleton/apps/__app__/src/modules/i18n/messages.spec.ts

@@ -0,0 +1,27 @@
+import { describe, expect, it } from "vitest"
+import vi from "./messages/vi.json"
+
+const leaves = (value: unknown, path = ""): string[] =>
+    typeof value === "object" && value !== null
+        ? Object.entries(value).flatMap(([key, child]) => leaves(child, path ? `${path}.${key}` : key))
+        : [path]
+
+const valueAt = (path: string): unknown => path.split(".").reduce<unknown>((node, key) => (node as Record<string, unknown>)[key], vi)
+
+describe("messages/vi.json", () => {
+    it("carries the strings the error, not-found and home routes render", () => {
+        expect(leaves(vi).sort()).toEqual([
+            "errors.global.retry",
+            "errors.global.title",
+            "errors.page.retry",
+            "errors.page.title",
+            "home.title",
+            "notFound.home",
+            "notFound.title",
+        ])
+    })
+
+    it("has no empty string", () => {
+        for (const path of leaves(vi)) expect(valueAt(path)).not.toBe("")
+    })
+})

package/templates/fe/skeleton/apps/__app__/src/modules/i18n/navigation.ts

@@ -0,0 +1,5 @@
+import { createNavigation } from "next-intl/navigation"
+import { routing } from "./routing"
+
+/** Locale-aware links and navigation; components import these instead of `next/link` and `next/navigation`. */
+export const { Link, redirect, usePathname, useRouter, getPathname } = createNavigation(routing)

package/templates/fe/skeleton/apps/__app__/src/modules/i18n/request.ts

@@ -0,0 +1,13 @@
+import { hasLocale } from "next-intl"
+import { getRequestConfig } from "next-intl/server"
+import { routing } from "./routing"
+
+/** Resolves the locale of a request and loads its catalog; an unknown locale falls back to the default. */
+export default getRequestConfig(async ({ requestLocale }) => {
+    const requested = await requestLocale
+    const locale = hasLocale(routing.locales, requested) ? requested : routing.defaultLocale
+    return {
+        locale,
+        messages: (await import(`./messages/${locale}.json`)).default,
+    }
+})

package/templates/fe/skeleton/apps/__app__/src/modules/i18n/routing.spec.ts

@@ -0,0 +1,10 @@
+import { describe, expect, it } from "vitest"
+import { routing } from "./routing"
+
+describe("routing", () => {
+    it("serves vi by default, without a prefix", () => {
+        expect(routing.defaultLocale).toBe("vi")
+        expect(routing.localePrefix).toBe("as-needed")
+        expect(routing.locales).toContain("vi")
+    })
+})

package/templates/fe/skeleton/apps/__app__/src/modules/i18n/routing.ts

@@ -0,0 +1,9 @@
+import { defineRouting } from "next-intl/routing"
+import { DEFAULT_LOCALE, LOCALES } from "./config"
+
+/** One routing table for the proxy, the navigation helpers and the request config: vi default, prefix only when not default. */
+export const routing = defineRouting({
+    locales: LOCALES,
+    defaultLocale: DEFAULT_LOCALE,
+    localePrefix: "as-needed",
+})

package/templates/fe/skeleton/apps/__app__/src/proxy.ts

@@ -0,0 +1,10 @@
+import createMiddleware from "next-intl/middleware"
+import { routing } from "./modules/i18n/routing"
+
+/** Negotiates the locale and redirects; the default locale (vi) is served without a prefix. */
+export default createMiddleware(routing)
+
+/** Everything except the API, the health probe, framework files and files with an extension. */
+export const config = {
+    matcher: ["/((?!api|health|_next|_vercel|.*\\..*).*)"],
+}

package/templates/fe/sonar-project.properties

@@ -0,0 +1,11 @@
+sonar.projectKey={{sonarKey}}
+sonar.host.url=https://sonar.starci.org
+sonar.sourceEncoding=UTF-8
+sonar.sources=apps
+sonar.tests=apps
+sonar.exclusions={{sonarExclusions}}
+sonar.test.inclusions=**/*.spec.ts,**/*.spec.tsx
+sonar.coverage.exclusions={{sonarCoverageExclusions}}
+sonar.javascript.lcov.reportPaths=coverage/lcov.info
+sonar.typescript.tsconfigPaths={{tsconfigPaths}}
+sonar.nodejs.maxspace=8192