@smarthr/i18n 0.2.0 → 0.2.1

package/lib/get-locale/getLocale.d.ts

@@ -0,0 +1,38 @@
+/**
+ * サポートされているロケール一覧：
+ *
+ * ja-JP: 日本語
+ * en-US: 英語
+ * ko-KR: 韓国語
+ * zh-Hant-TW: 繁体中文
+ * zh-Hans-CN: 簡体中文
+ * vi-VN: ベトナム語
+ * pt-BR: ポルトガル語
+ * ja-JP-x-easy: やさしい日本語
+ * id-ID: インドネシア語
+ */
+declare const SUPPORTED_LOCALES: readonly ["ja-JP", "en-US", "ko-KR", "zh-Hant-TW", "zh-Hans-CN", "vi-VN", "pt-BR", "ja-JP-x-easy", "id-ID"];
+export type Locale = (typeof SUPPORTED_LOCALES)[number];
+/**
+ * 対応する言語コードを判定して返します。
+ *
+ * 判定優先順位:
+ * 1. shouldReturnDefaultLanguage が true の場合はデフォルト言語
+ * 2. currentLocale が supportedLocales に含まれていればそれを返す
+ * 3. cookieKey で指定したcookieの値が supportedLocales に含まれていればそれを返す
+ * 4. ブラウザの言語設定(navigator.languages)に対応するものがあればそれを返す
+ * 5. どれにも該当しなければデフォルト言語
+ *
+ * @param params.currentLocale - 現在の言語コード（DBの値や固定値など、nullの場合はスキップ）
+ * @param params.supportedLocales - アプリが対応する言語コード配列
+ * @param params.shouldReturnDefaultLanguage - 常にデフォルト言語を返す場合にtrue
+ * @param params.cookieKey - 取得するcookieのキー（省略時は'selectedLocale'）
+ * @returns 判定された言語コード
+ */
+export declare function getLocale(params: {
+    currentLocale: Locale | null;
+    supportedLocales: Locale[];
+    shouldReturnDefaultLanguage?: boolean;
+    cookieKey?: string;
+}): Locale;
+export {};

package/lib/get-locale/getLocale.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLocale = getLocale;
+/**
+ * サポートされているロケール一覧：
+ *
+ * ja-JP: 日本語
+ * en-US: 英語
+ * ko-KR: 韓国語
+ * zh-Hant-TW: 繁体中文
+ * zh-Hans-CN: 簡体中文
+ * vi-VN: ベトナム語
+ * pt-BR: ポルトガル語
+ * ja-JP-x-easy: やさしい日本語
+ * id-ID: インドネシア語
+ */
+var SUPPORTED_LOCALES = [
+    'ja-JP',
+    'en-US',
+    'ko-KR',
+    'zh-Hant-TW',
+    'zh-Hans-CN',
+    'vi-VN',
+    'pt-BR',
+    'ja-JP-x-easy',
+    'id-ID',
+];
+var DEFAULT_LANGUAGE = 'ja-JP';
+/**
+ * 対応する言語コードを判定して返します。
+ *
+ * 判定優先順位:
+ * 1. shouldReturnDefaultLanguage が true の場合はデフォルト言語
+ * 2. currentLocale が supportedLocales に含まれていればそれを返す
+ * 3. cookieKey で指定したcookieの値が supportedLocales に含まれていればそれを返す
+ * 4. ブラウザの言語設定(navigator.languages)に対応するものがあればそれを返す
+ * 5. どれにも該当しなければデフォルト言語
+ *
+ * @param params.currentLocale - 現在の言語コード（DBの値や固定値など、nullの場合はスキップ）
+ * @param params.supportedLocales - アプリが対応する言語コード配列
+ * @param params.shouldReturnDefaultLanguage - 常にデフォルト言語を返す場合にtrue
+ * @param params.cookieKey - 取得するcookieのキー（省略時は'selectedLocale'）
+ * @returns 判定された言語コード
+ */
+function getLocale(params) {
+    var currentLocale = params.currentLocale, supportedLocales = params.supportedLocales, _a = params.shouldReturnDefaultLanguage, shouldReturnDefaultLanguage = _a === void 0 ? false : _a, _b = params.cookieKey, cookieKey = _b === void 0 ? 'selectedLocale' : _b;
+    // デフォルト言語を返すべき場合
+    if (shouldReturnDefaultLanguage)
+        return DEFAULT_LANGUAGE;
+    if (currentLocale === null)
+        return DEFAULT_LANGUAGE;
+    if (supportedLocales.includes(currentLocale))
+        return currentLocale;
+    // サーバーサイドのエラー回避
+    if (typeof window === 'undefined')
+        return DEFAULT_LANGUAGE;
+    // cookieから言語コードを取得
+    var cookieLocale = getCookieLocale(cookieKey);
+    // cookieに言語コードが存在する場合、対応する言語コードを返す
+    if (cookieLocale && supportedLocales.includes(cookieLocale))
+        return cookieLocale;
+    // ブラウザの言語設定を取得し、最も優先度が高い有効な言語を返却する
+    var browserLanguages = getBrowserLanguages().map(function (lang) { return lang.toLowerCase(); });
+    for (var _i = 0, browserLanguages_1 = browserLanguages; _i < browserLanguages_1.length; _i++) {
+        var lang = browserLanguages_1[_i];
+        var convertedLang = convertLang(lang);
+        if (supportedLocales.includes(convertedLang)) {
+            return convertedLang;
+        }
+    }
+    return DEFAULT_LANGUAGE;
+}
+// ブラウザの言語設定を取得
+// navigator.languages: ユーザーがブラウザに設定している優先言語リスト。最初の要素が最も優先度が高い
+// 例: ['ja-JP', 'en-US', 'en'] -> 日本語を優先し、次に英語（米国）、最後に英語全般
+// navigator.languages が存在しないブラウザの場合は navigator.language（単一の設定）を使用
+var getBrowserLanguages = function () {
+    if (navigator.languages && navigator.languages.length > 0) {
+        return navigator.languages;
+    }
+    return navigator.language ? [navigator.language] : [];
+};
+var convertLang = function (lang) {
+    // jaから始まる場合はjaに変換
+    if (lang.startsWith('ja'))
+        return 'ja-JP';
+    // idから始まる場合はidに変換
+    if (lang.startsWith('id'))
+        return 'id-ID';
+    // enから始まる場合はen-usに変換
+    if (lang.startsWith('en'))
+        return 'en-US';
+    // ptから始まる場合はptに変換
+    if (lang.startsWith('pt'))
+        return 'pt-BR';
+    // viから始まる場合はviに変換
+    if (lang.startsWith('vi'))
+        return 'vi-VN';
+    // koから始まる場合はkoに変換
+    if (lang.startsWith('ko'))
+        return 'ko-KR';
+    // zh-cn, zh-hansから始まる場合はzh-cnに変換
+    if (lang.startsWith('zh-cn') || lang.startsWith('zh-hans'))
+        return 'zh-Hans-CN';
+    // zh-tw, zh-hant, zh-hkから始まる場合はzh-twに変換
+    if (lang.startsWith('zh-tw') || lang.startsWith('zh-hant') || lang.startsWith('zh-hk'))
+        return 'zh-Hant-TW';
+    // 上記のチェックに当てはまらなかったzhから始まるものはzh-cnに変換
+    if (lang.startsWith('zh'))
+        return 'zh-Hans-CN';
+    return DEFAULT_LANGUAGE;
+};
+/**
+ * cookieから指定されたキーの値を取得し、有効なロケールの場合のみ返す
+ */
+var getCookieLocale = function (cookieKey) {
+    var _a;
+    // サーバーサイドではcookieが利用できないためnullを返す
+    if (typeof document === 'undefined')
+        return null;
+    // cookieの値を取得
+    var cookieValue = (_a = document.cookie
+        .split('; ')
+        .find(function (row) { return row.startsWith("".concat(cookieKey, "=")); })) === null || _a === void 0 ? void 0 : _a.split('=')[1];
+    // cookieの値が存在しない場合はnullを返す
+    if (!cookieValue)
+        return null;
+    // 有効なロケールの場合のみ返す
+    return validateLocale(cookieValue) ? cookieValue : null;
+};
+var validateLocale = function (locale) { return SUPPORTED_LOCALES.includes(locale); };
+//# sourceMappingURL=getLocale.js.map

package/lib/get-locale/getLocale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getLocale.js","sourceRoot":"","sources":["../../src/get-locale/getLocale.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -0,0 +1,4 @@
+export { type Locale, getLocale } from './get-locale/getLocale';
+export { useIntl } from './use-intl/useIntl';
+export { useNextIntl } from './use-intl/useNextIntl';
+export { useIntlImpl } from './use-intl/useIntlImpl';

package/lib/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useIntlImpl = exports.useNextIntl = exports.useIntl = exports.getLocale = void 0;
+var getLocale_1 = require("./get-locale/getLocale");
+Object.defineProperty(exports, "getLocale", { enumerable: true, get: function () { return getLocale_1.getLocale; } });
+var useIntl_1 = require("./use-intl/useIntl");
+Object.defineProperty(exports, "useIntl", { enumerable: true, get: function () { return useIntl_1.useIntl; } });
+var useNextIntl_1 = require("./use-intl/useNextIntl");
+Object.defineProperty(exports, "useNextIntl", { enumerable: true, get: function () { return useNextIntl_1.useNextIntl; } });
+var useIntlImpl_1 = require("./use-intl/useIntlImpl");
+Object.defineProperty(exports, "useIntlImpl", { enumerable: true, get: function () { return useIntlImpl_1.useIntlImpl; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,oDAA+D;AAAzC,sGAAA,SAAS,OAAA;AAC/B,8CAA4C;AAAnC,kGAAA,OAAO,OAAA;AAChB,sDAAoD;AAA3C,0GAAA,WAAW,OAAA;AACpB,sDAAoD;AAA3C,0GAAA,WAAW,OAAA"}

package/lib/use-intl/useIntl.d.ts

@@ -0,0 +1,19 @@
+import { type Messages } from 'use-intl';
+/**
+ * use-intlを利用して国際化（i18n）ユーティリティを提供するカスタムReactフックです。
+ *
+ * @template OwnMessages - 翻訳に使用するメッセージの型。デフォルトは `Messages` です。
+ * @returns メッセージを整形する`formatMessage`関数を含むオブジェクトを返します。
+ *
+ * @example
+ * const intl = useIntl<MyMessages>();
+ * const greeting = intl.formatMessage({ id: 'greeting' });
+ */
+export declare const useIntl: <OwnMessages extends Messages = Messages>() => {
+    formatMessage: <TargetKey extends { [Key in keyof OwnMessages & string]: OwnMessages[Key] extends string ? Key : `${Key}.${{ [Key_1 in keyof OwnMessages[Key] & string]: OwnMessages[Key][Key_1] extends string ? Key_1 : `${Key_1}.${{ [Key_2 in keyof OwnMessages[Key][Key_1] & string]: OwnMessages[Key][Key_1][Key_2] extends string ? Key_2 : `${Key_2}.${{ [Key_3 in keyof OwnMessages[Key][Key_1][Key_2] & string]: OwnMessages[Key][Key_1][Key_2][Key_3] extends string ? Key_3 : `${Key_3}.${{ [Key_4 in keyof OwnMessages[Key][Key_1][Key_2][Key_3] & string]: OwnMessages[Key][Key_1][Key_2][Key_3][Key_4] extends string ? Key_4 : `${Key_4}.${{ [Key_5 in keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4] & string]: OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5] extends string ? Key_5 : `${Key_5}.${{ [Key_6 in keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5] & string]: OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6] extends string ? Key_6 : `${Key_6}.${{ [Key_7 in keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6] & string]: OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7] extends string ? Key_7 : `${Key_7}.${{ [Key_8 in keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7] & string]: OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7][Key_8] extends string ? Key_8 : `${Key_8}.${{ [Key_9 in keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7][Key_8] & string]: OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7][Key_8][Key_9] extends string ? Key_9 : `${Key_9}.${{ [Key_10 in keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7][Key_8][Key_9] & string]: OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7][Key_8][Key_9][Key_10] extends string ? Key_10 : `${Key_10}.${/*elided*/ any[keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7][Key_8][Key_9][Key_10] & string]}`; }[keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7][Key_8][Key_9] & string]}`; }[keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7][Key_8] & string]}`; }[keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7] & string]}`; }[keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6] & string]}`; }[keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5] & string]}`; }[keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4] & string]}`; }[keyof OwnMessages[Key][Key_1][Key_2][Key_3] & string]}`; }[keyof OwnMessages[Key][Key_1][Key_2] & string]}`; }[keyof OwnMessages[Key][Key_1] & string]}`; }[keyof OwnMessages[Key] & string]}`; }[keyof OwnMessages & string] = never, Strict extends boolean | undefined = true>(id: [Strict] extends [true] ? TargetKey : string, options?: {
+        strict?: Strict | undefined;
+        values?: {
+            [x: string]: string | number | Date | ((chunks: import("react").ReactNode) => import("react").ReactNode);
+        };
+    } | undefined) => any;
+};

package/lib/use-intl/useIntl.js

@@ -0,0 +1,19 @@
+"use strict";
+'use client';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useIntl = void 0;
+var use_intl_1 = require("use-intl");
+var useIntlImpl_1 = require("./useIntlImpl");
+/**
+ * use-intlを利用して国際化（i18n）ユーティリティを提供するカスタムReactフックです。
+ *
+ * @template OwnMessages - 翻訳に使用するメッセージの型。デフォルトは `Messages` です。
+ * @returns メッセージを整形する`formatMessage`関数を含むオブジェクトを返します。
+ *
+ * @example
+ * const intl = useIntl<MyMessages>();
+ * const greeting = intl.formatMessage({ id: 'greeting' });
+ */
+var useIntl = function () { return (0, useIntlImpl_1.useIntlImpl)(use_intl_1.useTranslations); };
+exports.useIntl = useIntl;
+//# sourceMappingURL=useIntl.js.map

package/lib/use-intl/useIntl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIntl.js","sourceRoot":"","sources":["../../src/use-intl/useIntl.tsx"],"names":[],"mappings":";AAAA,YAAY,CAAA;;;AACZ,qCAAyD;AAEzD,6CAA2C;AAE3C;;;;;;;;;GASG;AACI,IAAM,OAAO,GAAG,cAA+C,OAAA,IAAA,yBAAW,EAAc,0BAAe,CAAC,EAAzC,CAAyC,CAAA;AAAlG,QAAA,OAAO,WAA2F"}

package/lib/use-intl/useIntlImpl.d.ts

@@ -0,0 +1,50 @@
+import { type ReactNode } from 'react';
+/**
+ * next-intl / use-intl のuseTranslationsから利用する rich APIのvaluesの型定義です。
+ */
+type Values = Record<string, string | number | Date>;
+type TagFunction = (chunks: ReactNode) => ReactNode;
+type OptionValues = Record<string, Values[string] | TagFunction>;
+/**
+ * 与えられた辞書型(Dictionary)の全てのキーを「ドット区切りの文字列」として再帰的に抽出する型です。
+ *
+ * 例えば、以下のような辞書型があるとします:
+ *
+ * type Messages = {
+ *   hello: string;
+ *   user: {
+ *     name: string;
+ *     profile: {
+ *       age: string;
+ *     };
+ *   };
+ * }
+ *
+ * この場合、TargetKeys<Messages>は次のようなユニオン型になります:
+ *
+ * "hello" | "user.name" | "user.profile.age"
+ *
+ * - 文字列型(string)の値を持つキーはそのまま抽出されます。
+ * - オブジェクト型の場合は、キーをドットで連結して再帰的に展開します。
+ */
+type TargetKeys<Dictionary> = {
+    [Key in keyof Dictionary & string]: Dictionary[Key] extends string ? Key : `${Key}.${TargetKeys<Dictionary[Key]>}`;
+}[keyof Dictionary & string];
+/**
+ * 国際化（i18n）のメッセージフォーマッターを提供するカスタムフックです。
+ *
+ * @template Messages - 翻訳メッセージの型を表します。
+ * @param useTranslations - 翻訳関数`t`を返すuse-intlまたはnext-intlのフックです。
+ * @returns メッセージを整形する`formatMessage`関数を含むオブジェクトを返します。
+ *
+ * @example
+ * const { formatMessage } = useIntlImpl<MyMessages>(useTranslations);
+ * const message = formatMessage('greeting', { values: { name: 'Alice' } });
+ */
+export declare const useIntlImpl: <Messages>(useTranslations: any) => {
+    formatMessage: <TargetKey extends TargetKeys<Messages> = never, Strict extends boolean | undefined = true>(id: [Strict] extends [true] ? TargetKey : string, options?: {
+        strict?: Strict;
+        values?: OptionValues;
+    }) => any;
+};
+export {};

package/lib/use-intl/useIntlImpl.js

@@ -0,0 +1,47 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useIntlImpl = void 0;
+var jsx_runtime_1 = require("react/jsx-runtime");
+var react_1 = require("react");
+/**
+ * 国際化（i18n）のメッセージフォーマッターを提供するカスタムフックです。
+ *
+ * @template Messages - 翻訳メッセージの型を表します。
+ * @param useTranslations - 翻訳関数`t`を返すuse-intlまたはnext-intlのフックです。
+ * @returns メッセージを整形する`formatMessage`関数を含むオブジェクトを返します。
+ *
+ * @example
+ * const { formatMessage } = useIntlImpl<MyMessages>(useTranslations);
+ * const message = formatMessage('greeting', { values: { name: 'Alice' } });
+ */
+var useIntlImpl = function (useTranslations) {
+    var t = useTranslations();
+    /**
+     * 指定されたメッセージIDと任意の値を使って、メッセージを整形します。
+     *
+     * @param id - 整形するメッセージのキー。`strict`が`true`の場合はメッセージキーの厳密な型、そうでない場合は任意の文字列が許可されます。
+     * @param options - オプションの設定オブジェクト。
+     * @param options.strict - `true`の場合、メッセージキーの厳密な型チェックを行います。
+     * @param options.values - メッセージ内で補間する値。use-intl / next-intlのrichメソッドのフォーマットに対応しています。
+     * @returns 整形されたメッセージ。
+     */
+    var formatMessage = (0, react_1.useCallback)(function (id, options) {
+        return t.rich(id, __assign(__assign({}, options === null || options === void 0 ? void 0 : options.values), { br: function () { return (0, jsx_runtime_1.jsx)("br", {}); } }));
+    }, [t]);
+    return {
+        formatMessage: formatMessage,
+    };
+};
+exports.useIntlImpl = useIntlImpl;
+//# sourceMappingURL=useIntlImpl.js.map

package/lib/use-intl/useIntlImpl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIntlImpl.js","sourceRoot":"","sources":["../../src/use-intl/useIntlImpl.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,+BAAmD;AAmCnD;;;;;;;;;;GAUG;AACI,IAAM,WAAW,GAAG,UAAY,eAAoB;IACzD,IAAM,CAAC,GAAG,eAAe,EAAE,CAAA;IAE3B;;;;;;;;OAQG;IACH,IAAM,aAAa,GAAG,IAAA,mBAAW,EAC/B,UACE,EAAgD,EAChD,OAGC;QAED,OAAA,CAAC,CAAC,IAAI,CAAC,EAAE,wBACJ,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM,KAClB,EAAE,EAAE,cAAM,OAAA,gCAAM,EAAN,CAAM,IAChB;IAHF,CAGE,EACJ,CAAC,CAAC,CAAC,CACJ,CAAA;IAED,OAAO;QACL,aAAa,eAAA;KACd,CAAA;AACH,CAAC,CAAA;AA9BY,QAAA,WAAW,eA8BvB"}

package/lib/use-intl/useNextIntl.d.ts

@@ -0,0 +1,22 @@
+import { type Messages } from 'next-intl';
+/**
+ * next-intlを利用して国際化（i18n）ユーティリティを提供するカスタムReactフックです。
+ *
+ * このフックはClient Componentsでのみ動作します。
+ * React Server ComponentsはアプリケーションコードでuseIntlImplを利用して専用のフックを実装してください。
+ *
+ * @template OwnMessages - 翻訳に使用するメッセージの型。デフォルトは `Messages` です。
+ * @returns メッセージを整形する`formatMessage`関数を含むオブジェクトを返します。
+ *
+ * @example
+ * const intl = useNextIntl<MyMessages>();
+ * const greeting = intl.formatMessage({ id: 'greeting' });
+ */
+export declare const useNextIntl: <OwnMessages extends Messages = Messages>() => {
+    formatMessage: <TargetKey extends { [Key in keyof OwnMessages & string]: OwnMessages[Key] extends string ? Key : `${Key}.${{ [Key_1 in keyof OwnMessages[Key] & string]: OwnMessages[Key][Key_1] extends string ? Key_1 : `${Key_1}.${{ [Key_2 in keyof OwnMessages[Key][Key_1] & string]: OwnMessages[Key][Key_1][Key_2] extends string ? Key_2 : `${Key_2}.${{ [Key_3 in keyof OwnMessages[Key][Key_1][Key_2] & string]: OwnMessages[Key][Key_1][Key_2][Key_3] extends string ? Key_3 : `${Key_3}.${{ [Key_4 in keyof OwnMessages[Key][Key_1][Key_2][Key_3] & string]: OwnMessages[Key][Key_1][Key_2][Key_3][Key_4] extends string ? Key_4 : `${Key_4}.${{ [Key_5 in keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4] & string]: OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5] extends string ? Key_5 : `${Key_5}.${{ [Key_6 in keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5] & string]: OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6] extends string ? Key_6 : `${Key_6}.${{ [Key_7 in keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6] & string]: OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7] extends string ? Key_7 : `${Key_7}.${{ [Key_8 in keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7] & string]: OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7][Key_8] extends string ? Key_8 : `${Key_8}.${{ [Key_9 in keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7][Key_8] & string]: OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7][Key_8][Key_9] extends string ? Key_9 : `${Key_9}.${{ [Key_10 in keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7][Key_8][Key_9] & string]: OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7][Key_8][Key_9][Key_10] extends string ? Key_10 : `${Key_10}.${/*elided*/ any[keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7][Key_8][Key_9][Key_10] & string]}`; }[keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7][Key_8][Key_9] & string]}`; }[keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7][Key_8] & string]}`; }[keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6][Key_7] & string]}`; }[keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5][Key_6] & string]}`; }[keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4][Key_5] & string]}`; }[keyof OwnMessages[Key][Key_1][Key_2][Key_3][Key_4] & string]}`; }[keyof OwnMessages[Key][Key_1][Key_2][Key_3] & string]}`; }[keyof OwnMessages[Key][Key_1][Key_2] & string]}`; }[keyof OwnMessages[Key][Key_1] & string]}`; }[keyof OwnMessages[Key] & string]}`; }[keyof OwnMessages & string] = never, Strict extends boolean | undefined = true>(id: [Strict] extends [true] ? TargetKey : string, options?: {
+        strict?: Strict | undefined;
+        values?: {
+            [x: string]: string | number | Date | ((chunks: import("react").ReactNode) => import("react").ReactNode);
+        };
+    } | undefined) => any;
+};

package/lib/use-intl/useNextIntl.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useNextIntl = void 0;
+var next_intl_1 = require("next-intl");
+var useIntlImpl_1 = require("./useIntlImpl");
+/**
+ * next-intlを利用して国際化（i18n）ユーティリティを提供するカスタムReactフックです。
+ *
+ * このフックはClient Componentsでのみ動作します。
+ * React Server ComponentsはアプリケーションコードでuseIntlImplを利用して専用のフックを実装してください。
+ *
+ * @template OwnMessages - 翻訳に使用するメッセージの型。デフォルトは `Messages` です。
+ * @returns メッセージを整形する`formatMessage`関数を含むオブジェクトを返します。
+ *
+ * @example
+ * const intl = useNextIntl<MyMessages>();
+ * const greeting = intl.formatMessage({ id: 'greeting' });
+ */
+var useNextIntl = function () { return (0, useIntlImpl_1.useIntlImpl)(next_intl_1.useTranslations); };
+exports.useNextIntl = useNextIntl;
+//# sourceMappingURL=useNextIntl.js.map

package/lib/use-intl/useNextIntl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNextIntl.js","sourceRoot":"","sources":["../../src/use-intl/useNextIntl.tsx"],"names":[],"mappings":";;;AAAA,uCAA0D;AAE1D,6CAA2C;AAE3C;;;;;;;;;;;;GAYG;AACI,IAAM,WAAW,GAAG,cAA+C,OAAA,IAAA,yBAAW,EAAc,2BAAe,CAAC,EAAzC,CAAyC,CAAA;AAAtG,QAAA,WAAW,eAA2F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smarthr/i18n",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "SmartHR's i18n utility",
   "author": "SmartHR",
   "homepage": "https://github.com/kufu/tamatebako/tree/master/packages/i18n",
@@ -38,5 +38,5 @@
     "react": "^19.1.0",
     "use-intl": "^4.3.4"
   },
-  "gitHead": "c258ee8be8942c4ddd8251af2b1b40d31bcb6dd2"
+  "gitHead": "cf84f56f02e0c316823e44a0519739d9569e5dc5"
 }