@aiquants/auth-react-router 0.11.0 → 0.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiquants/auth-react-router",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "React Router v7 / v8 auth adapter for @aiquants/auth-core: Google OAuth strategy factory (remix-auth), cookie session storage with DI test backdoor, a loader guard that authenticates at most once per request (token refresh + photo cache), auth route handlers, and a <GoogleForm> login button.",
   "sideEffects": [
     "**/*.css"
@@ -67,7 +67,7 @@
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^4.1.8",
-    "@aiquants/auth-core": "0.3.0"
+    "@aiquants/auth-core": "0.5.0"
   },
   "peerDependencies": {
     "react": ">=18",
@@ -75,7 +75,7 @@
     "react-router": "^7.0.0 || ^8.0.0",
     "remix-auth": "^4.0.0",
     "remix-auth-oauth2": "^3.0.0",
-    "@aiquants/auth-core": "^0.3.0"
+    "@aiquants/auth-core": "^0.5.0"
   },
   "engines": {
     "node": ">=18.0.0",

package/src/admin/format.ts

@@ -0,0 +1,49 @@
+/**
+ * @module admin/format
+ * @description Text helpers shared by the shell and the views.
+ * シェルとビューが共有する文言整形の補助。
+ *
+ * 数や名前を JSX で連結すると語順が英語に固定され、日付を実行環境任せで整形すると
+ * サーバーとブラウザで別の文字列になる (水和が壊れる)。どちらもラベル側の宣言に従わせる。
+ */
+import type { UserAdminLabels } from "./labels"
+
+/**
+ * Substitutes `{key}` placeholders in a label template.
+ * ラベルの雛形に含まれる `{key}` を差し替える処理。
+ *
+ * @param template Label text containing `{key}` placeholders. `{key}` を含むラベル文言。
+ * @param values Replacement values by key. キーごとの差し替え値。
+ * @returns The filled text. 差し替え済みの文言。
+ */
+export function fill(template: string, values: Record<string, string | number>): string {
+    return Object.entries(values).reduce((text, [key, value]) => text.replaceAll(`{${key}}`, String(value)), template)
+}
+
+/**
+ * Formats an ISO timestamp with the locale the labels declare, degrading instead of throwing.
+ * ISO 時刻を **ラベルが宣言したロケール** で整形する処理 (例外を投げず、読める形へ退避する)。
+ *
+ * `Intl.DateTimeFormat().format()` は不正な日時で `RangeError` を投げる (`toLocaleString()` が
+ * 「Invalid Date」を返すのとは違う)。この関数を呼ぶのはシェルの同期バナーであり、バナーは
+ * **全タブで描かれる**。上流の 1 行が壊れた時刻を持っていただけで、ユーザー管理面が丸ごと
+ * エラー境界へ落ちる。ロケール文字列が空でも同じく投げるため、そこも退避する。
+ *
+ * オフセットの無い ISO 文字列 (`2026-03-01T09:00:00`) は仕様上 **実行環境の時間帯** で解釈される。
+ * サーバーとブラウザで別の時刻になり水和が壊れるため、UTC として読む。
+ *
+ * @param iso ISO 8601 timestamp. ISO 8601 の時刻 (オフセット無しは UTC として解釈)。
+ * @param labels Resolved label set carrying locale and time zone. ロケールと時間帯を持つラベル。
+ * @returns Formatted text, or the input itself when it cannot be formatted. 整形済みの文言 (整形できない場合は入力そのもの)。
+ */
+export function formatDateTime(iso: string, labels: UserAdminLabels): string {
+    // オフセットが無ければ UTC を補う (実行環境の時間帯で解釈させない)
+    const normalized = /(?:Z|[+-]\d{2}:?\d{2})$/.test(iso) ? iso : `${iso}Z`
+    try {
+        return new Intl.DateTimeFormat(labels.locale, { timeZone: labels.timeZone, dateStyle: "medium", timeStyle: "short" }).format(new Date(normalized))
+    } catch {
+        // 不正な日時 (`RangeError: Invalid time value`) も、不正なロケール・時間帯も、ここで
+        // 受け止める。画面を落とすより生の値を見せる方がまだ役に立つ
+        return iso
+    }
+}