@xrift/world-components 0.35.3 → 0.35.4

package/dist/contexts/FontContext.d.ts

@@ -0,0 +1,17 @@
+import { type ReactNode } from 'react';
+import type { FontFamilies } from '@pmndrs/uikit';
+interface Props {
+    children: ReactNode;
+}
+/**
+ * フォントをプリロードし、ロード完了まで children をブロックする Provider。
+ * XRiftProvider 内で使用される。
+ */
+export declare function FontProvider({ children }: Props): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * ロード済みの FontFamilies を取得する hook。
+ * FontProvider 内では即座に返し、外では useDefaultFont にフォールバックする。
+ */
+export declare function useFont(): FontFamilies | undefined;
+export {};
+//# sourceMappingURL=FontContext.d.ts.map

package/dist/contexts/FontContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FontContext.d.ts","sourceRoot":"","sources":["../../src/contexts/FontContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAOjD,UAAU,KAAK;IACb,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,EAAE,KAAK,kDAK/C;AAED;;;GAGG;AACH,wBAAgB,OAAO,IAAI,YAAY,GAAG,SAAS,CAIlD"}

package/dist/contexts/FontContext.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from 'react';
+import { useDefaultFont } from '../hooks/useDefaultFont';
+const FontContext = createContext(null);
+const DEFAULT_LOCALES = ['ja'];
+/**
+ * フォントをプリロードし、ロード完了まで children をブロックする Provider。
+ * XRiftProvider 内で使用される。
+ */
+export function FontProvider({ children }) {
+    const fontFamilies = useDefaultFont(DEFAULT_LOCALES);
+    if (!fontFamilies)
+        return null;
+    return _jsx(FontContext.Provider, { value: fontFamilies, children: children });
+}
+/**
+ * ロード済みの FontFamilies を取得する hook。
+ * FontProvider 内では即座に返し、外では useDefaultFont にフォールバックする。
+ */
+export function useFont() {
+    const ctx = useContext(FontContext);
+    const fallback = useDefaultFont(DEFAULT_LOCALES);
+    return ctx ?? fallback;
+}
+//# sourceMappingURL=FontContext.js.map

package/dist/contexts/FontContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FontContext.js","sourceRoot":"","sources":["../../src/contexts/FontContext.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAA;AAEjE,OAAO,EAAE,cAAc,EAAmB,MAAM,yBAAyB,CAAA;AAEzE,MAAM,WAAW,GAAG,aAAa,CAAsB,IAAI,CAAC,CAAA;AAE5D,MAAM,eAAe,GAAiB,CAAC,IAAI,CAAC,CAAA;AAM5C;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,EAAE,QAAQ,EAAS;IAC9C,MAAM,YAAY,GAAG,cAAc,CAAC,eAAe,CAAC,CAAA;IACpD,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAA;IAE9B,OAAO,KAAC,WAAW,CAAC,QAAQ,IAAC,KAAK,EAAE,YAAY,YAAG,QAAQ,GAAwB,CAAA;AACrF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO;IACrB,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,CAAC,CAAA;IACnC,MAAM,QAAQ,GAAG,cAAc,CAAC,eAAe,CAAC,CAAA;IAChD,OAAO,GAAG,IAAI,QAAQ,CAAA;AACxB,CAAC"}

package/dist/hooks/useDefaultFont.d.ts

@@ -1,21 +1,12 @@
 import type { FontFamilies } from '@pmndrs/uikit';
 export type FontLocale = 'ja';
 /**
- * UIKit 用の多言語 MSDF フォントをロードする hook
+ * UIKit 用の多言語 MSDF フォントをロードする hook。
+ * ロード完了時に uikit のグローバルプロパティとしても登録されるため、
+ * Container に fontFamilies を明示的に渡さなくても fontFamily="ja" が使える。
  *
  * @param locales - ロードするフォントのロケール配列
  * @returns ロード完了後に FontFamilies を返す。ロード中は undefined
- *
- * @example
- * ```tsx
- * const fontFamilies = useDefaultFont(['ja'])
- *
- * return (
- *   <Container fontFamilies={fontFamilies}>
- *     <Text fontFamily="ja">こんにちは</Text>
- *   </Container>
- * )
- * ```
  */
 export declare function useDefaultFont(locales: FontLocale[]): FontFamilies | undefined;
 //# sourceMappingURL=useDefaultFont.d.ts.map

package/dist/hooks/useDefaultFont.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useDefaultFont.d.ts","sourceRoot":"","sources":["../../src/hooks/useDefaultFont.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAGjD,MAAM,MAAM,UAAU,GAAG,IAAI,CAAA;AAoC7B;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,UAAU,EAAE,GACpB,YAAY,GAAG,SAAS,CAsB1B"}
+{"version":3,"file":"useDefaultFont.d.ts","sourceRoot":"","sources":["../../src/hooks/useDefaultFont.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAGjD,MAAM,MAAM,UAAU,GAAG,IAAI,CAAA;AAwD7B;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,UAAU,EAAE,GACpB,YAAY,GAAG,SAAS,CAuC1B"}

package/dist/hooks/useDefaultFont.js

@@ -2,11 +2,13 @@ import { useEffect, useState } from 'react';
 const FONT_REGISTRY = {
     ja: {
         baseUrl: 'https://public.xrift.net/fonts/msdf/NotoSansJP',
-        version: 2,
+        version: 3,
     },
 };
 /** ロケールごとのキャッシュ（同じフォントの重複フェッチを防止） */
 const fontCache = new Map();
+/** 解決済みフォントデータのキャッシュ（同期アクセス用） */
+const resolvedCache = new Map();
 function loadFont(locale) {
     const cached = fontCache.get(locale);
     if (cached)
@@ -22,35 +24,55 @@ function loadFont(locale) {
     fontCache.set(locale, promise);
     return promise;
 }
+// モジュール読み込み時に全ロケールのフォントを事前フェッチし、
+// ロード完了後に uikit のグローバルプロパティとして登録する。
+// これにより、uikit コンポーネントのコンストラクタ実行時に star-inheritance 経由で
+// fontFamilies が即座に利用可能になり、"unknown font family" 警告を防ぐ。
+const fontReadyPromise = Promise.all(Object.keys(FONT_REGISTRY).map(loadFont)).then(async (entries) => {
+    const fontFamilies = Object.fromEntries(entries);
+    try {
+        const { setGlobalProperties } = await import('@pmndrs/uikit');
+        setGlobalProperties({ fontFamilies });
+    }
+    catch {
+        // @pmndrs/uikit が利用できない環境ではスキップ
+    }
+    return fontFamilies;
+});
 /**
- * UIKit 用の多言語 MSDF フォントをロードする hook
+ * UIKit 用の多言語 MSDF フォントをロードする hook。
+ * ロード完了時に uikit のグローバルプロパティとしても登録されるため、
+ * Container に fontFamilies を明示的に渡さなくても fontFamily="ja" が使える。
  *
  * @param locales - ロードするフォントのロケール配列
  * @returns ロード完了後に FontFamilies を返す。ロード中は undefined
- *
- * @example
- * ```tsx
- * const fontFamilies = useDefaultFont(['ja'])
- *
- * return (
- *   <Container fontFamilies={fontFamilies}>
- *     <Text fontFamily="ja">こんにちは</Text>
- *   </Container>
- * )
- * ```
  */
 export function useDefaultFont(locales) {
-    const [fontFamilies, setFontFamilies] = useState();
     const key = locales.slice().sort().join(',');
+    // 解決済みなら初期値として同期的に返す
+    const [fontFamilies, setFontFamilies] = useState(() => resolvedCache.get(key));
     useEffect(() => {
         if (key === '')
             return;
+        // すでに解決済みなら何もしない
+        if (resolvedCache.has(key)) {
+            setFontFamilies(resolvedCache.get(key));
+            return;
+        }
         let cancelled = false;
         const targetLocales = key.split(',');
-        Promise.all(targetLocales.map(loadFont)).then((entries) => {
-            if (!cancelled) {
-                setFontFamilies(Object.fromEntries(entries));
+        // fontReadyPromise を使用し、setGlobalProperties 完了後に解決する
+        fontReadyPromise.then((allFonts) => {
+            if (cancelled)
+                return;
+            const result = {};
+            for (const locale of targetLocales) {
+                if (locale in allFonts) {
+                    result[locale] = allFonts[locale];
+                }
             }
+            resolvedCache.set(key, result);
+            setFontFamilies(result);
         });
         return () => {
             cancelled = true;

package/dist/hooks/useDefaultFont.js.map

@@ -1 +1 @@
-{"version":3,"file":"useDefaultFont.js","sourceRoot":"","sources":["../../src/hooks/useDefaultFont.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAS3C,MAAM,aAAa,GAAmC;IACpD,EAAE,EAAE;QACF,OAAO,EAAE,gDAAgD;QACzD,OAAO,EAAE,CAAC;KACX;CACF,CAAA;AAED,qCAAqC;AACrC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAuD,CAAA;AAEhF,SAAS,QAAQ,CACf,MAAkB;IAElB,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACpC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IACpC,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,OAAO,mBAAmB,MAAM,CAAC,OAAO,EAAE,CAAA;IAChE,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC;SACvB,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;SACzB,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;QAChB,OAAO,CAAC,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,gBAAgB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAA;QACnE,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAmC,CAAA;IACxE,CAAC,CAAC,CAAA;IAEJ,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAqB;IAErB,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,EAA4B,CAAA;IAC5E,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAE5C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,GAAG,KAAK,EAAE;YAAE,OAAM;QAEtB,IAAI,SAAS,GAAG,KAAK,CAAA;QACrB,MAAM,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAA;QAEpD,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;YACxD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,eAAe,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAA;YAC9C,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAA;QAClB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;IAET,OAAO,YAAY,CAAA;AACrB,CAAC"}
+{"version":3,"file":"useDefaultFont.js","sourceRoot":"","sources":["../../src/hooks/useDefaultFont.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAS3C,MAAM,aAAa,GAAmC;IACpD,EAAE,EAAE;QACF,OAAO,EAAE,gDAAgD;QACzD,OAAO,EAAE,CAAC;KACX;CACF,CAAA;AAED,qCAAqC;AACrC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAuD,CAAA;AAEhF,iCAAiC;AACjC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAwB,CAAA;AAErD,SAAS,QAAQ,CACf,MAAkB;IAElB,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACpC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IACpC,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,OAAO,mBAAmB,MAAM,CAAC,OAAO,EAAE,CAAA;IAChE,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC;SACvB,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;SACzB,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;QAChB,OAAO,CAAC,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,gBAAgB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAA;QACnE,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAmC,CAAA;IACxE,CAAC,CAAC,CAAA;IAEJ,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,iCAAiC;AACjC,oCAAoC;AACpC,uDAAuD;AACvD,wDAAwD;AACxD,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CACjC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAC3D,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACvB,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAiB,CAAA;IAChE,IAAI,CAAC;QACH,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAA;QAC7D,mBAAmB,CAAC,EAAE,YAAY,EAAE,CAAC,CAAA;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,gCAAgC;IAClC,CAAC;IACD,OAAO,YAAY,CAAA;AACrB,CAAC,CAAC,CAAA;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAqB;IAErB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAE5C,qBAAqB;IACrB,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAC9C,GAAG,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAC7B,CAAA;IAED,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,GAAG,KAAK,EAAE;YAAE,OAAM;QAEtB,iBAAiB;QACjB,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,eAAe,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;YACvC,OAAM;QACR,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAA;QACrB,MAAM,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAA;QAEpD,qDAAqD;QACrD,gBAAgB,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YACjC,IAAI,SAAS;gBAAE,OAAM;YACrB,MAAM,MAAM,GAAiB,EAAE,CAAA;YAC/B,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;gBACnC,IAAI,MAAM,IAAI,QAAQ,EAAE,CAAC;oBACvB,MAAM,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAA;gBACnC,CAAC;YACH,CAAC;YACD,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;YAC9B,eAAe,CAAC,MAAM,CAAC,CAAA;QACzB,CAAC,CAAC,CAAA;QAEF,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAA;QAClB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;IAET,OAAO,YAAY,CAAA;AACrB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xrift/world-components",
-  "version": "0.35.3",
+  "version": "0.35.4",
   "description": "Shared components and utilities for Xrift worlds",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",