@xrift/world-components 0.33.3 → 0.35.0

package/dist/components/MsdfText/index.d.ts

@@ -0,0 +1,24 @@
+import { type TextProperties } from '@react-three/uikit';
+type TextProps = TextProperties;
+interface Props extends Omit<TextProps, 'children'> {
+    children: string;
+    /** フォント URL（デフォルト: Noto Sans JP Regular） */
+    fontUrl?: string;
+    /** MSDF テクスチャサイズ（デフォルト: [2048, 2048]） */
+    textureSize?: [number, number];
+}
+/**
+ * MSDF フォントで日本語テキストを表示するコンポーネント。
+ * children の文字列から必要な文字セットを自動導出し、
+ * フォント読み込み・Suspense を内部で処理する。
+ *
+ * @example
+ * ```tsx
+ * <MsdfText fontSize={48} color={0x666666}>
+ *   URLを入力してください
+ * </MsdfText>
+ * ```
+ */
+export declare const MsdfText: import("react").MemoExoticComponent<(props: Props) => import("react/jsx-runtime").JSX.Element>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/components/MsdfText/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/MsdfText/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAG9D,KAAK,SAAS,GAAG,cAAc,CAAA;AAE/B,UAAU,KAAM,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IACjD,QAAQ,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yCAAyC;IACzC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAqBD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,QAAQ,8CAAgB,KAAK,6CAIxC,CAAA"}

package/dist/components/MsdfText/index.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { memo, Suspense, useMemo } from 'react';
+import { Text } from '@react-three/uikit';
+import { FontReadyContainer } from '../../fonts/FontReadyContainer';
+const InnerText = memo(({ children, fontUrl, textureSize, ...textProps }) => {
+    const texts = useMemo(() => [children], [children]);
+    return (_jsx(FontReadyContainer, { texts: texts, fontUrl: fontUrl, textureSize: textureSize, children: _jsx(Text, { ...textProps, children: children }) }));
+});
+InnerText.displayName = 'MsdfText.Inner';
+/**
+ * MSDF フォントで日本語テキストを表示するコンポーネント。
+ * children の文字列から必要な文字セットを自動導出し、
+ * フォント読み込み・Suspense を内部で処理する。
+ *
+ * @example
+ * ```tsx
+ * <MsdfText fontSize={48} color={0x666666}>
+ *   URLを入力してください
+ * </MsdfText>
+ * ```
+ */
+export const MsdfText = memo((props) => (_jsx(Suspense, { fallback: null, children: _jsx(InnerText, { ...props }) })));
+MsdfText.displayName = 'MsdfText';
+//# sourceMappingURL=index.js.map

package/dist/components/MsdfText/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/MsdfText/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/C,OAAO,EAAE,IAAI,EAAuB,MAAM,oBAAoB,CAAA;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAYnE,MAAM,SAAS,GAAG,IAAI,CACpB,CAAC,EACC,QAAQ,EACR,OAAO,EACP,WAAW,EACX,GAAG,SAAS,EACN,EAAE,EAAE;IACV,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;IAEnD,OAAO,CACL,KAAC,kBAAkB,IAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,YAC1E,KAAC,IAAI,OAAK,SAAS,YAAG,QAAQ,GAAQ,GACnB,CACtB,CAAA;AACH,CAAC,CACF,CAAA;AAED,SAAS,CAAC,WAAW,GAAG,gBAAgB,CAAA;AAExC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,KAAY,EAAE,EAAE,CAAC,CAC7C,KAAC,QAAQ,IAAC,QAAQ,EAAE,IAAI,YACtB,KAAC,SAAS,OAAK,KAAK,GAAI,GACf,CACZ,CAAC,CAAA;AAEF,QAAQ,CAAC,WAAW,GAAG,UAAU,CAAA"}

package/dist/components/TroikaText/index.d.ts

@@ -0,0 +1,4 @@
+import type { Props } from './types';
+export type { Props as TroikaTextProps };
+export declare const TroikaText: import("react").MemoExoticComponent<({ children, fontSize, color, font, maxWidth, textAlign, lineHeight, letterSpacing, anchorX, anchorY, ...contentProps }: Props) => import("react/jsx-runtime").JSX.Element>;
+//# sourceMappingURL=index.d.ts.map

package/dist/components/TroikaText/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/TroikaText/index.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAKpC,YAAY,EAAE,KAAK,IAAI,eAAe,EAAE,CAAA;AAExC,eAAO,MAAM,UAAU,+JAalB,KAAK,6CAoDT,CAAA"}

package/dist/components/TroikaText/index.js

@@ -0,0 +1,50 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Children, memo, useRef, useState, useEffect, useLayoutEffect, useMemo } from 'react';
+import { Content } from '@react-three/uikit';
+import { Text as TroikaTextMesh, preloadFont } from 'troika-three-text';
+import { suspend } from 'suspend-react';
+import { useThree } from '@react-three/fiber';
+const DEFAULT_FONT_URL = 'https://cdn.jsdelivr.net/fontsource/fonts/noto-sans-jp@latest/japanese-400-normal.ttf';
+export const TroikaText = memo(({ children, fontSize = 16, color, font, maxWidth, textAlign, lineHeight, letterSpacing, anchorX = 'left', anchorY = 'top', ...contentProps }) => {
+    const resolvedFont = font ?? DEFAULT_FONT_URL;
+    const contentRef = useRef(null);
+    const invalidate = useThree(({ invalidate }) => invalidate);
+    const [troikaMesh] = useState(() => new TroikaTextMesh());
+    // フォントプリロード（Suspense 対応 — drei と同じパターン）
+    suspend(() => new Promise((res) => preloadFont({ font: resolvedFont }, () => res())), ['troika-font', resolvedFont]);
+    // children からテキスト文字列を抽出（drei と同じパターン）
+    const text = useMemo(() => {
+        let t = '';
+        Children.forEach(children, (child) => {
+            if (typeof child === 'string' || typeof child === 'number')
+                t += child;
+        });
+        return t;
+    }, [children]);
+    // troika プロパティを設定して sync（毎レンダリング）
+    useLayoutEffect(() => {
+        troikaMesh.text = text;
+        troikaMesh.font = resolvedFont;
+        troikaMesh.fontSize = fontSize;
+        if (color != null)
+            troikaMesh.color = color;
+        if (maxWidth != null)
+            troikaMesh.maxWidth = maxWidth;
+        if (textAlign != null)
+            troikaMesh.textAlign = textAlign;
+        if (lineHeight != null)
+            troikaMesh.lineHeight = lineHeight;
+        if (letterSpacing != null)
+            troikaMesh.letterSpacing = letterSpacing;
+        troikaMesh.anchorX = anchorX;
+        troikaMesh.anchorY = anchorY;
+        troikaMesh.sync(() => {
+            invalidate();
+            contentRef.current?.notifyAncestorsChanged();
+        });
+    });
+    useEffect(() => () => troikaMesh.dispose(), [troikaMesh]);
+    return (_jsx(Content, { ref: contentRef, keepAspectRatio: false, ...contentProps, children: _jsx("primitive", { object: troikaMesh }) }));
+});
+TroikaText.displayName = 'TroikaText';
+//# sourceMappingURL=index.js.map

package/dist/components/TroikaText/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/TroikaText/index.tsx"],"names":[],"mappings":"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"}

package/dist/components/TroikaText/types.d.ts

@@ -0,0 +1,19 @@
+import type { ReactNode } from 'react';
+import type { ContentProperties } from '@react-three/uikit';
+import type { ReactThreeFiber } from '@react-three/fiber';
+/** ContentProperties と衝突するプロパティを除外（troika 用に再定義する） */
+type ContentBaseProps = Omit<ContentProperties, 'children' | 'color' | 'fontSize' | 'letterSpacing' | 'lineHeight' | 'textAlign' | 'anchorX' | 'anchorY'>;
+export interface Props extends ContentBaseProps {
+    children: ReactNode;
+    fontSize?: number;
+    color?: ReactThreeFiber.Color;
+    font?: string;
+    maxWidth?: number;
+    textAlign?: 'left' | 'right' | 'center' | 'justify';
+    lineHeight?: number | 'normal';
+    letterSpacing?: number;
+    anchorX?: number | 'left' | 'center' | 'right';
+    anchorY?: number | 'top' | 'top-baseline' | 'middle' | 'bottom-baseline' | 'bottom';
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/components/TroikaText/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/TroikaText/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEzD,sDAAsD;AACtD,KAAK,gBAAgB,GAAG,IAAI,CAC1B,iBAAiB,EACf,UAAU,GACV,OAAO,GACP,UAAU,GACV,eAAe,GACf,YAAY,GACZ,WAAW,GACX,SAAS,GACT,SAAS,CACZ,CAAA;AAED,MAAM,WAAW,KAAM,SAAQ,gBAAgB;IAC7C,QAAQ,EAAE,SAAS,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,eAAe,CAAC,KAAK,CAAA;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAA;IACnD,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;IAC9C,OAAO,CAAC,EACJ,MAAM,GACN,KAAK,GACL,cAAc,GACd,QAAQ,GACR,iBAAiB,GACjB,QAAQ,CAAA;CACb"}

package/dist/components/TroikaText/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/components/TroikaText/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/components/TroikaText/types.ts"],"names":[],"mappings":""}

package/dist/contexts/AudioVolumeContext.d.ts

@@ -1,32 +1,42 @@
 import { type ReactNode } from 'react';
-export interface AudioVolumeContextValue {
+export interface VoiceVolumeOverrideContextValue {
     setOverride: (userId: string, volume: number) => void;
     clearOverride: (userId: string) => void;
     clearAll: () => void;
     getOverrides: () => ReadonlyMap<string, number>;
 }
+/** @deprecated Use VoiceVolumeOverrideContextValue instead */
+export type AudioVolumeContextValue = VoiceVolumeOverrideContextValue;
 /**
  * 開発環境用のデフォルト実装（no-op）
  * プラットフォーム側が実装を注入しない場合に使用される
  */
-export declare const createDefaultAudioVolumeImplementation: () => AudioVolumeContextValue;
+export declare const createDefaultVoiceVolumeOverrideImplementation: () => VoiceVolumeOverrideContextValue;
+/** @deprecated Use createDefaultVoiceVolumeOverrideImplementation instead */
+export declare const createDefaultAudioVolumeImplementation: () => VoiceVolumeOverrideContextValue;
 /**
  * 音量オーバーライド機能を提供する Context
  * xrift-frontend 側で実装を注入し、ワールド側で利用できる
  */
-export declare const AudioVolumeContext: import("react").Context<AudioVolumeContextValue | null>;
+export declare const VoiceVolumeOverrideContext: import("react").Context<VoiceVolumeOverrideContextValue | null>;
+/** @deprecated Use VoiceVolumeOverrideContext instead */
+export declare const AudioVolumeContext: import("react").Context<VoiceVolumeOverrideContextValue | null>;
 interface Props {
-    value: AudioVolumeContextValue;
+    value: VoiceVolumeOverrideContextValue;
     children: ReactNode;
 }
 /**
  * 音量オーバーライド機能を提供する ContextProvider
  */
+export declare const VoiceVolumeOverrideProvider: ({ value, children }: Props) => import("react/jsx-runtime").JSX.Element;
+/** @deprecated Use VoiceVolumeOverrideProvider instead */
 export declare const AudioVolumeProvider: ({ value, children }: Props) => import("react/jsx-runtime").JSX.Element;
 /**
  * 音量オーバーライドの Context を取得する hook
- * @throws {Error} AudioVolumeProvider の外で呼び出された場合
+ * @throws {Error} VoiceVolumeOverrideProvider の外で呼び出された場合
  */
-export declare const useAudioVolumeContext: () => AudioVolumeContextValue;
+export declare const useVoiceVolumeOverrideContext: () => VoiceVolumeOverrideContextValue;
+/** @deprecated Use useVoiceVolumeOverrideContext instead */
+export declare const useAudioVolumeContext: () => VoiceVolumeOverrideContextValue;
 export {};
 //# sourceMappingURL=AudioVolumeContext.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AudioVolumeContext.d.ts","sourceRoot":"","sources":["../../src/contexts/AudioVolumeContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAc,MAAM,OAAO,CAAA;AAEjE,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACrD,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,YAAY,EAAE,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChD;AAED;;;GAGG;AACH,eAAO,MAAM,sCAAsC,QAAO,uBAKxD,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,yDAAsD,CAAA;AAErF,UAAU,KAAK;IACb,KAAK,EAAE,uBAAuB,CAAA;IAC9B,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,qBAAqB,KAAK,4CAE7D,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAO,uBAMxC,CAAA"}
+{"version":3,"file":"AudioVolumeContext.d.ts","sourceRoot":"","sources":["../../src/contexts/AudioVolumeContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAc,MAAM,OAAO,CAAA;AAEjE,MAAM,WAAW,+BAA+B;IAC9C,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACrD,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,YAAY,EAAE,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChD;AAED,8DAA8D;AAC9D,MAAM,MAAM,uBAAuB,GAAG,+BAA+B,CAAA;AAErE;;;GAGG;AACH,eAAO,MAAM,8CAA8C,QAAO,+BAKhE,CAAA;AAEF,6EAA6E;AAC7E,eAAO,MAAM,sCAAsC,QARe,+BAQkC,CAAA;AAEpG;;;GAGG;AACH,eAAO,MAAM,0BAA0B,iEAA8D,CAAA;AAErG,yDAAyD;AACzD,eAAO,MAAM,kBAAkB,iEAA6B,CAAA;AAE5D,UAAU,KAAK;IACb,KAAK,EAAE,+BAA+B,CAAA;IACtC,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B,GAAI,qBAAqB,KAAK,4CAErE,CAAA;AAED,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB,wBALiC,KAAK,4CAKR,CAAA;AAE9D;;;GAGG;AACH,eAAO,MAAM,6BAA6B,QAAO,+BAMhD,CAAA;AAED,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB,QATe,+BASiB,CAAA"}

package/dist/contexts/AudioVolumeContext.js

@@ -4,32 +4,40 @@ import { createContext, useContext } from 'react';
  * 開発環境用のデフォルト実装（no-op）
  * プラットフォーム側が実装を注入しない場合に使用される
  */
-export const createDefaultAudioVolumeImplementation = () => ({
+export const createDefaultVoiceVolumeOverrideImplementation = () => ({
     setOverride: () => { },
     clearOverride: () => { },
     clearAll: () => { },
     getOverrides: () => new Map(),
 });
+/** @deprecated Use createDefaultVoiceVolumeOverrideImplementation instead */
+export const createDefaultAudioVolumeImplementation = createDefaultVoiceVolumeOverrideImplementation;
 /**
  * 音量オーバーライド機能を提供する Context
  * xrift-frontend 側で実装を注入し、ワールド側で利用できる
  */
-export const AudioVolumeContext = createContext(null);
+export const VoiceVolumeOverrideContext = createContext(null);
+/** @deprecated Use VoiceVolumeOverrideContext instead */
+export const AudioVolumeContext = VoiceVolumeOverrideContext;
 /**
  * 音量オーバーライド機能を提供する ContextProvider
  */
-export const AudioVolumeProvider = ({ value, children }) => {
-    return _jsx(AudioVolumeContext.Provider, { value: value, children: children });
+export const VoiceVolumeOverrideProvider = ({ value, children }) => {
+    return _jsx(VoiceVolumeOverrideContext.Provider, { value: value, children: children });
 };
+/** @deprecated Use VoiceVolumeOverrideProvider instead */
+export const AudioVolumeProvider = VoiceVolumeOverrideProvider;
 /**
  * 音量オーバーライドの Context を取得する hook
- * @throws {Error} AudioVolumeProvider の外で呼び出された場合
+ * @throws {Error} VoiceVolumeOverrideProvider の外で呼び出された場合
  */
-export const useAudioVolumeContext = () => {
-    const context = useContext(AudioVolumeContext);
+export const useVoiceVolumeOverrideContext = () => {
+    const context = useContext(VoiceVolumeOverrideContext);
     if (!context) {
-        throw new Error('useAudioVolumeContext must be used within AudioVolumeProvider');
+        throw new Error('useVoiceVolumeOverrideContext must be used within VoiceVolumeOverrideProvider');
     }
     return context;
 };
+/** @deprecated Use useVoiceVolumeOverrideContext instead */
+export const useAudioVolumeContext = useVoiceVolumeOverrideContext;
 //# sourceMappingURL=AudioVolumeContext.js.map

package/dist/contexts/AudioVolumeContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"AudioVolumeContext.js","sourceRoot":"","sources":["../../src/contexts/AudioVolumeContext.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAkB,UAAU,EAAE,MAAM,OAAO,CAAA;AASjE;;;GAGG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,GAA4B,EAAE,CAAC,CAAC;IACpF,WAAW,EAAE,GAAG,EAAE,GAAE,CAAC;IACrB,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC;IACvB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;IAClB,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE;CAC9B,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAiC,IAAI,CAAC,CAAA;AAOrF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAS,EAAE,EAAE;IAChE,OAAO,KAAC,kBAAkB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAA+B,CAAA;AAC5F,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAA4B,EAAE;IACjE,MAAM,OAAO,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAA;IAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAA;IAClF,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}
+{"version":3,"file":"AudioVolumeContext.js","sourceRoot":"","sources":["../../src/contexts/AudioVolumeContext.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAkB,UAAU,EAAE,MAAM,OAAO,CAAA;AAYjE;;;GAGG;AACH,MAAM,CAAC,MAAM,8CAA8C,GAAG,GAAoC,EAAE,CAAC,CAAC;IACpG,WAAW,EAAE,GAAG,EAAE,GAAE,CAAC;IACrB,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC;IACvB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;IAClB,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE;CAC9B,CAAC,CAAA;AAEF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,sCAAsC,GAAG,8CAA8C,CAAA;AAEpG;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,aAAa,CAAyC,IAAI,CAAC,CAAA;AAErG,yDAAyD;AACzD,MAAM,CAAC,MAAM,kBAAkB,GAAG,0BAA0B,CAAA;AAO5D;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAS,EAAE,EAAE;IACxE,OAAO,KAAC,0BAA0B,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAuC,CAAA;AAC5G,CAAC,CAAA;AAED,0DAA0D;AAC1D,MAAM,CAAC,MAAM,mBAAmB,GAAG,2BAA2B,CAAA;AAE9D;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAoC,EAAE;IACjF,MAAM,OAAO,GAAG,UAAU,CAAC,0BAA0B,CAAC,CAAA;IACtD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAA;IAClG,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED,4DAA4D;AAC5D,MAAM,CAAC,MAAM,qBAAqB,GAAG,6BAA6B,CAAA"}

package/dist/fonts/FontContext.d.ts

@@ -0,0 +1,9 @@
+import type { GenerateFontResult } from '@zappar/msdf-generator';
+interface FontContextValue {
+    fontFamilies: GenerateFontResult;
+}
+export declare const FontContext: import("react").Context<FontContextValue | null>;
+/** FontProvider 内では fontFamilies を返し、Provider 外では null を返す */
+export declare const useFontContext: () => FontContextValue | null;
+export {};
+//# sourceMappingURL=FontContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FontContext.d.ts","sourceRoot":"","sources":["../../src/fonts/FontContext.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAEhE,UAAU,gBAAgB;IACxB,YAAY,EAAE,kBAAkB,CAAA;CACjC;AAED,eAAO,MAAM,WAAW,kDAA+C,CAAA;AAEvE,8DAA8D;AAC9D,eAAO,MAAM,cAAc,QAAO,gBAAgB,GAAG,IAC5B,CAAA"}

package/dist/fonts/FontContext.js

@@ -0,0 +1,5 @@
+import { createContext, useContext } from 'react';
+export const FontContext = createContext(null);
+/** FontProvider 内では fontFamilies を返し、Provider 外では null を返す */
+export const useFontContext = () => useContext(FontContext);
+//# sourceMappingURL=FontContext.js.map

package/dist/fonts/FontContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FontContext.js","sourceRoot":"","sources":["../../src/fonts/FontContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAOjD,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAA0B,IAAI,CAAC,CAAA;AAEvE,8DAA8D;AAC9D,MAAM,CAAC,MAAM,cAAc,GAAG,GAA4B,EAAE,CAC1D,UAAU,CAAC,WAAW,CAAC,CAAA"}

package/dist/fonts/FontProvider.d.ts

@@ -0,0 +1,31 @@
+import { type ReactNode } from 'react';
+interface Props {
+    /** MSDF 生成に含めるテキスト配列。安定した参照の配列を渡すことを推奨。 */
+    texts: string[];
+    children: ReactNode;
+    /** フォント URL（デフォルト: Noto Sans JP Regular） */
+    fontUrl?: string;
+    /** MSDF テクスチャサイズ（デフォルト: [2048, 2048]） */
+    textureSize?: [number, number];
+}
+/**
+ * ツリー全体で MSDF アトラスを共有し、配下で日本語テキストを直接使えるようにする Provider。
+ *
+ * `texts` に含まれる文字から MSDF フォントを1回だけ生成し、
+ * `fontFamilies` を Container 経由で配下に適用する。
+ * Suspense 対応のため、親に `<Suspense>` が必要。
+ *
+ * @example
+ * ```tsx
+ * const ALL_TEXTS = ['URLを入力してください', '再接続中...']
+ *
+ * <Suspense fallback={null}>
+ *   <FontProvider texts={ALL_TEXTS}>
+ *     <Text fontSize={48}>URLを入力してください</Text>
+ *   </FontProvider>
+ * </Suspense>
+ * ```
+ */
+export declare const FontProvider: import("react").MemoExoticComponent<({ texts, fontUrl, textureSize, children }: Props) => import("react/jsx-runtime").JSX.Element>;
+export {};
+//# sourceMappingURL=FontProvider.d.ts.map

package/dist/fonts/FontProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FontProvider.d.ts","sourceRoot":"","sources":["../../src/fonts/FontProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAK1E,UAAU,KAAK;IACb,2CAA2C;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,EAAE,SAAS,CAAA;IACnB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yCAAyC;IACzC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,YAAY,kFACqB,KAAK,6CAuBlD,CAAA"}

package/dist/fonts/FontProvider.js

@@ -0,0 +1,40 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { memo, useMemo, useState, useEffect } from 'react';
+import { Container, Text } from '@react-three/uikit';
+import { FontContext } from './FontContext';
+import { useMsdfFont } from '../hooks/useMsdfFont';
+/**
+ * ツリー全体で MSDF アトラスを共有し、配下で日本語テキストを直接使えるようにする Provider。
+ *
+ * `texts` に含まれる文字から MSDF フォントを1回だけ生成し、
+ * `fontFamilies` を Container 経由で配下に適用する。
+ * Suspense 対応のため、親に `<Suspense>` が必要。
+ *
+ * @example
+ * ```tsx
+ * const ALL_TEXTS = ['URLを入力してください', '再接続中...']
+ *
+ * <Suspense fallback={null}>
+ *   <FontProvider texts={ALL_TEXTS}>
+ *     <Text fontSize={48}>URLを入力してください</Text>
+ *   </FontProvider>
+ * </Suspense>
+ * ```
+ */
+export const FontProvider = memo(({ texts, fontUrl, textureSize, children }) => {
+    const fontFamilies = useMsdfFont(texts, fontUrl, textureSize);
+    const value = useMemo(() => ({ fontFamilies }), [fontFamilies]);
+    // uikit はフォントテクスチャを非同期でロードするため、
+    // 初回レンダリングでデフォルトの inter フォントへフォールバックし
+    // "Missing glyph info" 警告が出る。スペースのみの Text で
+    // フォントロードをトリガーし、次フレームで children を表示する。
+    const [fontReady, setFontReady] = useState(false);
+    useEffect(() => {
+        setFontReady(false);
+        const id = requestAnimationFrame(() => setFontReady(true));
+        return () => cancelAnimationFrame(id);
+    }, [fontFamilies]);
+    return (_jsx(FontContext.Provider, { value: value, children: _jsx(Container, { fontFamilies: fontFamilies, children: fontReady ? children : _jsx(Text, { fontSize: 1, children: ' ' }) }) }));
+});
+FontProvider.displayName = 'FontProvider';
+//# sourceMappingURL=FontProvider.js.map

package/dist/fonts/FontProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FontProvider.js","sourceRoot":"","sources":["../../src/fonts/FontProvider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAkB,MAAM,OAAO,CAAA;AAC1E,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAYlD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAC9B,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAS,EAAE,EAAE;IACnD,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,CAAA;IAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAA;IAE/D,gCAAgC;IAChC,sCAAsC;IACtC,4CAA4C;IAC5C,uCAAuC;IACvC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACjD,SAAS,CAAC,GAAG,EAAE;QACb,YAAY,CAAC,KAAK,CAAC,CAAA;QACnB,MAAM,EAAE,GAAG,qBAAqB,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAA;QAC1D,OAAO,GAAG,EAAE,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAA;IACvC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAA;IAElB,OAAO,CACL,KAAC,WAAW,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAChC,KAAC,SAAS,IAAC,YAAY,EAAE,YAAY,YAClC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAC,IAAI,IAAC,QAAQ,EAAE,CAAC,YAAG,GAAG,GAAQ,GAC7C,GACS,CACxB,CAAA;AACH,CAAC,CACF,CAAA;AAED,YAAY,CAAC,WAAW,GAAG,cAAc,CAAA"}

package/dist/fonts/FontReadyContainer.d.ts

@@ -0,0 +1,35 @@
+import { type ComponentProps, type ReactNode } from 'react';
+import { Container } from '@react-three/uikit';
+type ContainerProps = ComponentProps<typeof Container>;
+interface Props extends Omit<ContainerProps, 'children'> {
+    /** MSDF 生成に含めるテキスト配列。安定した参照の配列を渡すことを推奨。 */
+    texts: string[];
+    children: ReactNode;
+    /** フォント URL（デフォルト: Noto Sans JP Regular） */
+    fontUrl?: string;
+    /** MSDF テクスチャサイズ（デフォルト: [2048, 2048]） */
+    textureSize?: [number, number];
+}
+/**
+ * 日本語 MSDF フォントの読み込み・ロード待ちを内包した Container。
+ *
+ * `texts` に含まれる文字からフォントを生成し、
+ * テクスチャのロードが完了してから children を表示する。
+ * Suspense 対応のため、親に `<Suspense>` が必要。
+ *
+ * 複数コンポーネントでアトラスを共有したい場合は `FontProvider` を使用。
+ *
+ * @example
+ * ```tsx
+ * const TEXTS = ['URLを入力してください']
+ *
+ * <Suspense fallback={null}>
+ *   <FontReadyContainer texts={TEXTS} sizeX={4} backgroundColor={0x000000}>
+ *     <Text fontSize={48}>URLを入力してください</Text>
+ *   </FontReadyContainer>
+ * </Suspense>
+ * ```
+ */
+export declare const FontReadyContainer: import("react").MemoExoticComponent<({ texts, children, fontUrl, textureSize, ...containerProps }: Props) => import("react/jsx-runtime").JSX.Element>;
+export {};
+//# sourceMappingURL=FontReadyContainer.d.ts.map

package/dist/fonts/FontReadyContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FontReadyContainer.d.ts","sourceRoot":"","sources":["../../src/fonts/FontReadyContainer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACtF,OAAO,EAAE,SAAS,EAAQ,MAAM,oBAAoB,CAAA;AAGpD,KAAK,cAAc,GAAG,cAAc,CAAC,OAAO,SAAS,CAAC,CAAA;AAEtD,UAAU,KAAM,SAAQ,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC;IACtD,2CAA2C;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,EAAE,SAAS,CAAA;IACnB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yCAAyC;IACzC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,kBAAkB,qGACkC,KAAK,6CAoBrE,CAAA"}

package/dist/fonts/FontReadyContainer.js

@@ -0,0 +1,40 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { memo, useState, useEffect } from 'react';
+import { Container, Text } from '@react-three/uikit';
+import { useMsdfFont } from '../hooks/useMsdfFont';
+/**
+ * 日本語 MSDF フォントの読み込み・ロード待ちを内包した Container。
+ *
+ * `texts` に含まれる文字からフォントを生成し、
+ * テクスチャのロードが完了してから children を表示する。
+ * Suspense 対応のため、親に `<Suspense>` が必要。
+ *
+ * 複数コンポーネントでアトラスを共有したい場合は `FontProvider` を使用。
+ *
+ * @example
+ * ```tsx
+ * const TEXTS = ['URLを入力してください']
+ *
+ * <Suspense fallback={null}>
+ *   <FontReadyContainer texts={TEXTS} sizeX={4} backgroundColor={0x000000}>
+ *     <Text fontSize={48}>URLを入力してください</Text>
+ *   </FontReadyContainer>
+ * </Suspense>
+ * ```
+ */
+export const FontReadyContainer = memo(({ texts, children, fontUrl, textureSize, ...containerProps }) => {
+    const fontFamilies = useMsdfFont(texts, fontUrl, textureSize);
+    // uikit はフォントテクスチャを非同期でロードするため、
+    // 初回レンダリングでデフォルトの inter フォントへフォールバックし
+    // "Missing glyph info" 警告が出る。スペースのみの Text で
+    // フォントロードをトリガーし、次フレームで children を表示する。
+    const [fontReady, setFontReady] = useState(false);
+    useEffect(() => {
+        setFontReady(false);
+        const id = requestAnimationFrame(() => setFontReady(true));
+        return () => cancelAnimationFrame(id);
+    }, [fontFamilies]);
+    return (_jsx(Container, { fontFamilies: fontFamilies, ...containerProps, children: fontReady ? children : _jsx(Text, { fontSize: 1, children: ' ' }) }));
+});
+FontReadyContainer.displayName = 'FontReadyContainer';
+//# sourceMappingURL=FontReadyContainer.js.map

package/dist/fonts/FontReadyContainer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FontReadyContainer.js","sourceRoot":"","sources":["../../src/fonts/FontReadyContainer.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAuC,MAAM,OAAO,CAAA;AACtF,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAclD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CACpC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,cAAc,EAAS,EAAE,EAAE;IACtE,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,CAAA;IAE7D,gCAAgC;IAChC,sCAAsC;IACtC,4CAA4C;IAC5C,uCAAuC;IACvC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACjD,SAAS,CAAC,GAAG,EAAE;QACb,YAAY,CAAC,KAAK,CAAC,CAAA;QACnB,MAAM,EAAE,GAAG,qBAAqB,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAA;QAC1D,OAAO,GAAG,EAAE,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAA;IACvC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAA;IAElB,OAAO,CACL,KAAC,SAAS,IAAC,YAAY,EAAE,YAAY,KAAM,cAAc,YACtD,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAC,IAAI,IAAC,QAAQ,EAAE,CAAC,YAAG,GAAG,GAAQ,GAC7C,CACb,CAAA;AACH,CAAC,CACF,CAAA;AAED,kBAAkB,CAAC,WAAW,GAAG,oBAAoB,CAAA"}

package/dist/fonts/constants.d.ts

@@ -1,7 +1,5 @@
 /** Noto Sans JP Regular (CDN) */
 export declare const JAPANESE_FONT_URL = "https://cdn.jsdelivr.net/fontsource/fonts/noto-sans-jp@latest/japanese-400-normal.ttf";
-/** MSDF 生成に含める文字セット（ひらがな・カタカナ・常用句読点・ASCII） */
-export declare const JAPANESE_CHARSET: string;
 /** MSDF テクスチャサイズ（日本語文字数に対応するため大きめ） */
 export declare const JAPANESE_TEXTURE_SIZE: [number, number];
 //# sourceMappingURL=constants.d.ts.map

package/dist/fonts/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/fonts/constants.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,eAAO,MAAM,iBAAiB,0FAC2D,CAAA;AAEzF,8CAA8C;AAC9C,eAAO,MAAM,gBAAgB,QAkBnB,CAAA;AAEV,sCAAsC;AACtC,eAAO,MAAM,qBAAqB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAgB,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/fonts/constants.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,eAAO,MAAM,iBAAiB,0FAC2D,CAAA;AAEzF,sCAAsC;AACtC,eAAO,MAAM,qBAAqB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAgB,CAAA"}

package/dist/fonts/constants.js

@@ -1,25 +1,5 @@
 /** Noto Sans JP Regular (CDN) */
 export const JAPANESE_FONT_URL = 'https://cdn.jsdelivr.net/fontsource/fonts/noto-sans-jp@latest/japanese-400-normal.ttf';
-/** MSDF 生成に含める文字セット（ひらがな・カタカナ・常用句読点・ASCII） */
-export const JAPANESE_CHARSET = [
-    // ASCII
-    ' !"#$%&\'()*+,-./0123456789:;<=>?@',
-    'ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`',
-    'abcdefghijklmnopqrstuvwxyz{|}~',
-    // ひらがな
-    'ぁあぃいぅうぇえぉおかがきぎくぐけげこごさざしじすずせぜそぞ',
-    'ただちぢっつづてでとどなにぬねのはばぱひびぴふぶぷへべぺほぼぽ',
-    'まみむめもゃやゅゆょよらりるれろゎわゐゑをん',
-    // カタカナ
-    'ァアィイゥウェエォオカガキギクグケゲコゴサザシジスズセゼソゾ',
-    'タダチヂッツヅテデトドナニヌネノハバパヒビピフブプヘベペホボポ',
-    'マミムメモャヤュユョヨラリルレロヮワヰヱヲンヴヵヶ',
-    // 日本語句読点・記号
-    '。、・「」『』（）〔〕【】〜ー―…‥々〇〈〉《》！？',
-    '　．，：；／￥＄＃＆＊＋−＝｜＜＞＿',
-    // 長音・半濁点
-    'ーｰ゛゜',
-].join('');
 /** MSDF テクスチャサイズ（日本語文字数に対応するため大きめ） */
 export const JAPANESE_TEXTURE_SIZE = [2048, 2048];
 //# sourceMappingURL=constants.js.map

package/dist/fonts/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/fonts/constants.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,MAAM,CAAC,MAAM,iBAAiB,GAC5B,uFAAuF,CAAA;AAEzF,8CAA8C;AAC9C,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,QAAQ;IACR,oCAAoC;IACpC,mCAAmC;IACnC,gCAAgC;IAChC,OAAO;IACP,gCAAgC;IAChC,iCAAiC;IACjC,wBAAwB;IACxB,OAAO;IACP,gCAAgC;IAChC,iCAAiC;IACjC,2BAA2B;IAC3B,YAAY;IACZ,4BAA4B;IAC5B,oBAAoB;IACpB,SAAS;IACT,MAAM;CACP,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAEV,sCAAsC;AACtC,MAAM,CAAC,MAAM,qBAAqB,GAAqB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/fonts/constants.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,MAAM,CAAC,MAAM,iBAAiB,GAC5B,uFAAuF,CAAA;AAEzF,sCAAsC;AACtC,MAAM,CAAC,MAAM,qBAAqB,GAAqB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA"}

package/dist/fonts/loadTTF.d.ts

@@ -0,0 +1,18 @@
+import { type GenerateFontResult } from '@zappar/msdf-generator';
+interface FontInput {
+    url: string;
+    charset: string;
+    fontSize?: number;
+    textureSize?: [number, number];
+    fieldRange?: number;
+    padding?: number;
+    fixOverlaps?: boolean;
+}
+/**
+ * TTF フォントを読み込み MSDF アトラスを生成する。
+ * `@zappar/msdf-generator` を static import することで、
+ * dynamic import がハングする Triplex 環境でも動作する。
+ */
+export declare const loadTTF: (input: FontInput) => Promise<GenerateFontResult>;
+export {};
+//# sourceMappingURL=loadTTF.d.ts.map

package/dist/fonts/loadTTF.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadTTF.d.ts","sourceRoot":"","sources":["../../src/fonts/loadTTF.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAGtE,UAAU,SAAS;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAUD;;;;GAIG;AACH,eAAO,MAAM,OAAO,GAAU,OAAO,SAAS,KAAG,OAAO,CAAC,kBAAkB,CAoB1E,CAAA"}

package/dist/fonts/loadTTF.js

@@ -0,0 +1,36 @@
+import { MSDF } from '@zappar/msdf-generator';
+import { FileLoader } from 'three';
+const DEFAULTS = {
+    fontSize: 48,
+    textureSize: [512, 512],
+    fieldRange: 4,
+    padding: 4,
+    fixOverlaps: true,
+};
+/**
+ * TTF フォントを読み込み MSDF アトラスを生成する。
+ * `@zappar/msdf-generator` を static import することで、
+ * dynamic import がハングする Triplex 環境でも動作する。
+ */
+export const loadTTF = async (input) => {
+    const loader = new FileLoader();
+    loader.setResponseType('arraybuffer');
+    const arrayBuffer = (await loader.loadAsync(input.url));
+    const generator = new MSDF();
+    try {
+        await generator.initialize();
+        return await generator.generate({
+            font: new Uint8Array(arrayBuffer),
+            charset: input.charset,
+            fontSize: input.fontSize ?? DEFAULTS.fontSize,
+            textureSize: input.textureSize ?? DEFAULTS.textureSize,
+            fieldRange: input.fieldRange ?? DEFAULTS.fieldRange,
+            padding: input.padding ?? DEFAULTS.padding,
+            fixOverlaps: input.fixOverlaps ?? DEFAULTS.fixOverlaps,
+        });
+    }
+    finally {
+        generator.dispose();
+    }
+};
+//# sourceMappingURL=loadTTF.js.map

package/dist/fonts/loadTTF.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadTTF.js","sourceRoot":"","sources":["../../src/fonts/loadTTF.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAA2B,MAAM,wBAAwB,CAAA;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAYlC,MAAM,QAAQ,GAAG;IACf,QAAQ,EAAE,EAAE;IACZ,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,CAAqB;IAC3C,UAAU,EAAE,CAAC;IACb,OAAO,EAAE,CAAC;IACV,WAAW,EAAE,IAAI;CACT,CAAA;AAEV;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,KAAgB,EAA+B,EAAE;IAC7E,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE,CAAA;IAC/B,MAAM,CAAC,eAAe,CAAC,aAAa,CAAC,CAAA;IACrC,MAAM,WAAW,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAgB,CAAA;IAEtE,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAA;IAC5B,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,UAAU,EAAE,CAAA;QAC5B,OAAO,MAAM,SAAS,CAAC,QAAQ,CAAC;YAC9B,IAAI,EAAE,IAAI,UAAU,CAAC,WAAW,CAAC;YACjC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ;YAC7C,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW;YACtD,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU;YACnD,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO;YAC1C,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW;SACvD,CAAC,CAAA;IACJ,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,OAAO,EAAE,CAAA;IACrB,CAAC;AACH,CAAC,CAAA"}

package/dist/fonts/useTTF.d.ts

@@ -0,0 +1,7 @@
+import type { GenerateFontResult } from '@zappar/msdf-generator';
+/**
+ * TTF フォントを MSDF 形式で読み込む Suspense 対応 hook。
+ * static import 版の loadTTF を使用するため Triplex でも動作する。
+ */
+export declare const useTTF: (url: string, charset: string, textureSize?: [number, number]) => GenerateFontResult;
+//# sourceMappingURL=useTTF.d.ts.map

package/dist/fonts/useTTF.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTTF.d.ts","sourceRoot":"","sources":["../../src/fonts/useTTF.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAKhE;;;GAGG;AACH,eAAO,MAAM,MAAM,GACjB,KAAK,MAAM,EACX,SAAS,MAAM,EACf,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,KAC7B,kBASA,CAAA"}

package/dist/fonts/useTTF.js

@@ -0,0 +1,9 @@
+import { suspend } from 'suspend-react';
+import { loadTTF } from './loadTTF';
+const cacheSymbol = Symbol('xrift-ttf');
+/**
+ * TTF フォントを MSDF 形式で読み込む Suspense 対応 hook。
+ * static import 版の loadTTF を使用するため Triplex でも動作する。
+ */
+export const useTTF = (url, charset, textureSize) => suspend(async (_key, url, charset, textureSize) => loadTTF({ url, charset, textureSize }), [cacheSymbol, url, charset, textureSize]);
+//# sourceMappingURL=useTTF.js.map

package/dist/fonts/useTTF.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTTF.js","sourceRoot":"","sources":["../../src/fonts/useTTF.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,CAAA;AAEvC;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,GAAW,EACX,OAAe,EACf,WAA8B,EACV,EAAE,CACtB,OAAO,CACL,KAAK,EACH,IAAY,EACZ,GAAW,EACX,OAAe,EACf,WAA8B,EAC9B,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,EAC3C,CAAC,WAAW,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,CAAC,CACzC,CAAA"}

package/dist/hooks/useAudioVolume.d.ts

@@ -1,10 +1,10 @@
-import { type AudioVolumeContextValue } from '../contexts/AudioVolumeContext';
+import { type VoiceVolumeOverrideContextValue } from '../contexts/AudioVolumeContext';
 /**
- * 特定ユーザーの音声ボリュームをオーバーライドするhook
+ * 特定ユーザーのボイスチャット音量をオーバーライドするhook
  * ワールド制作者が演壇やステージなどで特定ユーザーの音量を制御するために使用
  *
  * @example
- * const { setOverride, clearOverride } = useAudioVolume()
+ * const { setOverride, clearOverride } = useVoiceVolumeOverride()
  *
  * // 演壇に立った人の声を全体に届ける
  * setOverride(speakerUserId, 1.0)
@@ -12,5 +12,7 @@ import { type AudioVolumeContextValue } from '../contexts/AudioVolumeContext';
  * // オーバーライドを解除
  * clearOverride(speakerUserId)
  */
-export declare const useAudioVolume: () => AudioVolumeContextValue;
+export declare const useVoiceVolumeOverride: () => VoiceVolumeOverrideContextValue;
+/** @deprecated Use useVoiceVolumeOverride instead */
+export declare const useAudioVolume: () => VoiceVolumeOverrideContextValue;
 //# sourceMappingURL=useAudioVolume.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useAudioVolume.d.ts","sourceRoot":"","sources":["../../src/hooks/useAudioVolume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,uBAAuB,EAAyB,MAAM,gCAAgC,CAAA;AAEpG;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,QAAO,uBAEjC,CAAA"}
+{"version":3,"file":"useAudioVolume.d.ts","sourceRoot":"","sources":["../../src/hooks/useAudioVolume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,+BAA+B,EAAiC,MAAM,gCAAgC,CAAA;AAEpH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB,QAAO,+BAEzC,CAAA;AAED,qDAAqD;AACrD,eAAO,MAAM,cAAc,QALe,+BAKU,CAAA"}

package/dist/hooks/useAudioVolume.js

@@ -1,10 +1,10 @@
-import { useAudioVolumeContext } from '../contexts/AudioVolumeContext';
+import { useVoiceVolumeOverrideContext } from '../contexts/AudioVolumeContext';
 /**
- * 特定ユーザーの音声ボリュームをオーバーライドするhook
+ * 特定ユーザーのボイスチャット音量をオーバーライドするhook
  * ワールド制作者が演壇やステージなどで特定ユーザーの音量を制御するために使用
  *
  * @example
- * const { setOverride, clearOverride } = useAudioVolume()
+ * const { setOverride, clearOverride } = useVoiceVolumeOverride()
  *
  * // 演壇に立った人の声を全体に届ける
  * setOverride(speakerUserId, 1.0)
@@ -12,7 +12,9 @@ import { useAudioVolumeContext } from '../contexts/AudioVolumeContext';
  * // オーバーライドを解除
  * clearOverride(speakerUserId)
  */
-export const useAudioVolume = () => {
-    return useAudioVolumeContext();
+export const useVoiceVolumeOverride = () => {
+    return useVoiceVolumeOverrideContext();
 };
+/** @deprecated Use useVoiceVolumeOverride instead */
+export const useAudioVolume = useVoiceVolumeOverride;
 //# sourceMappingURL=useAudioVolume.js.map

package/dist/hooks/useAudioVolume.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAudioVolume.js","sourceRoot":"","sources":["../../src/hooks/useAudioVolume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AAEpG;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAA4B,EAAE;IAC1D,OAAO,qBAAqB,EAAE,CAAA;AAChC,CAAC,CAAA"}
+{"version":3,"file":"useAudioVolume.js","sourceRoot":"","sources":["../../src/hooks/useAudioVolume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,6BAA6B,EAAE,MAAM,gCAAgC,CAAA;AAEpH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAoC,EAAE;IAC1E,OAAO,6BAA6B,EAAE,CAAA;AACxC,CAAC,CAAA;AAED,qDAAqD;AACrD,MAAM,CAAC,MAAM,cAAc,GAAG,sBAAsB,CAAA"}

package/dist/hooks/useDefaultFont.d.ts

@@ -0,0 +1,21 @@
+import type { FontFamilies } from '@pmndrs/uikit';
+export type FontLocale = 'ja';
+/**
+ * UIKit 用の多言語 MSDF フォントをロードする hook
+ *
+ * @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

@@ -0,0 +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;AAyB7B;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,UAAU,EAAE,GACpB,YAAY,GAAG,SAAS,CAsB1B"}

package/dist/hooks/useDefaultFont.js

@@ -0,0 +1,52 @@
+import { useEffect, useState } from 'react';
+const FONT_REGISTRY = {
+    ja: {
+        baseUrl: 'https://public.xrift.net/fonts/msdf/NotoSansJP',
+        version: 2,
+    },
+};
+async function loadFont(locale) {
+    const config = FONT_REGISTRY[locale];
+    const url = `${config.baseUrl}/metrics.json?v=${config.version}`;
+    const res = await fetch(url);
+    const metrics = await res.json();
+    metrics.pages = [`${config.baseUrl}/atlas.png?v=${config.version}`];
+    return [locale, { normal: metrics }];
+}
+/**
+ * UIKit 用の多言語 MSDF フォントをロードする hook
+ *
+ * @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(',');
+    useEffect(() => {
+        if (key === '')
+            return;
+        let cancelled = false;
+        const targetLocales = key.split(',');
+        Promise.all(targetLocales.map(loadFont)).then((entries) => {
+            if (!cancelled) {
+                setFontFamilies(Object.fromEntries(entries));
+            }
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [key]);
+    return fontFamilies;
+}
+//# sourceMappingURL=useDefaultFont.js.map

package/dist/hooks/useDefaultFont.js.map

@@ -0,0 +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,KAAK,UAAU,QAAQ,CACrB,MAAkB;IAElB,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IACpC,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,OAAO,mBAAmB,MAAM,CAAC,OAAO,EAAE,CAAA;IAChE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;IAC5B,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;IAChC,OAAO,CAAC,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,gBAAgB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAA;IACnE,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;AACtC,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"}

package/dist/hooks/useJapaneseFont.d.ts

@@ -1,4 +1,7 @@
-export declare const useJapaneseFont: (options?: {
-    charset?: string;
-}) => import("@zappar/msdf-generator").FontFamily;
+/**
+ * 日本語フォントを MSDF 形式で読み込む hook。
+ * @param texts - 表示予定のテキスト配列。ここに含まれる漢字のみ MSDF 生成されるため、
+ *                表示する全テキストを渡すこと。安定した参照の配列を渡すことを推奨。
+ */
+export declare const useJapaneseFont: (texts: string[]) => import("@zappar/msdf-generator").FontFamily;
 //# sourceMappingURL=useJapaneseFont.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useJapaneseFont.d.ts","sourceRoot":"","sources":["../../src/hooks/useJapaneseFont.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,eAAe,GAAI,UAAU;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,gDAS7D,CAAA"}
+{"version":3,"file":"useJapaneseFont.d.ts","sourceRoot":"","sources":["../../src/hooks/useJapaneseFont.ts"],"names":[],"mappings":"AAcA;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,EAAE,gDAa9C,CAAA"}

package/dist/hooks/useJapaneseFont.js

@@ -1,13 +1,25 @@
+import { useMemo } from 'react';
+// useTTF は @react-three/uikit のメインエントリに含まれないため dist/use-ttf から直接インポート
 import { useTTF } from '@react-three/uikit/dist/use-ttf';
-import { JAPANESE_FONT_URL, JAPANESE_CHARSET, JAPANESE_TEXTURE_SIZE, } from '../fonts/constants';
-export const useJapaneseFont = (options) => {
-    const input = [
+import { JAPANESE_FONT_URL, JAPANESE_BASE_CHARSET, JAPANESE_TEXTURE_SIZE, } from '../fonts/constants';
+const deriveCharset = (texts) => {
+    const extra = [...new Set(texts.join(''))].join('');
+    return JAPANESE_BASE_CHARSET + extra;
+};
+/**
+ * 日本語フォントを MSDF 形式で読み込む hook。
+ * @param texts - 表示予定のテキスト配列。ここに含まれる漢字のみ MSDF 生成されるため、
+ *                表示する全テキストを渡すこと。安定した参照の配列を渡すことを推奨。
+ */
+export const useJapaneseFont = (texts) => {
+    const key = texts.join('\0');
+    const input = useMemo(() => [
         {
             url: JAPANESE_FONT_URL,
-            charset: options?.charset ?? JAPANESE_CHARSET,
+            charset: deriveCharset(texts),
             textureSize: JAPANESE_TEXTURE_SIZE,
         },
-    ];
+    ], [key]);
     return useTTF(input);
 };
 //# sourceMappingURL=useJapaneseFont.js.map

package/dist/hooks/useJapaneseFont.js.map

@@ -1 +1 @@
-{"version":3,"file":"useJapaneseFont.js","sourceRoot":"","sources":["../../src/hooks/useJapaneseFont.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,MAAM,iCAAiC,CAAA;AAC3E,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,oBAAoB,CAAA;AAE3B,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAA8B,EAAE,EAAE;IAChE,MAAM,KAAK,GAAmB;QAC5B;YACE,GAAG,EAAE,iBAAiB;YACtB,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,gBAAgB;YAC7C,WAAW,EAAE,qBAAqB;SACnC;KACF,CAAA;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;AACtB,CAAC,CAAA"}
+{"version":3,"file":"useJapaneseFont.js","sourceRoot":"","sources":["../../src/hooks/useJapaneseFont.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,sEAAsE;AACtE,OAAO,EAAE,MAAM,EAAqB,MAAM,iCAAiC,CAAA;AAC3E,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,oBAAoB,CAAA;AAE3B,MAAM,aAAa,GAAG,CAAC,KAAe,EAAU,EAAE;IAChD,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACnD,OAAO,qBAAqB,GAAG,KAAK,CAAA;AACtC,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAe,EAAE,EAAE;IACjD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC5B,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC;QACJ;YACE,GAAG,EAAE,iBAAiB;YACtB,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC;YAC7B,WAAW,EAAE,qBAAqB;SACnC;KACF,EACD,CAAC,GAAG,CAAC,CACN,CAAA;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;AACtB,CAAC,CAAA"}

package/dist/hooks/useMsdfFont.d.ts

@@ -0,0 +1,11 @@
+/**
+ * MSDF フォントを読み込む hook。
+ * MsdfText を使わず uikit のレイアウトを自分で組みたい場合に使用する。
+ *
+ * @param texts - 表示予定のテキスト配列。ここに含まれる文字が MSDF 生成される。
+ *                安定した参照の配列を渡すことを推奨。
+ * @param fontUrl - フォント URL（デフォルト: Noto Sans JP Regular）
+ * @param textureSize - MSDF テクスチャサイズ（デフォルト: [2048, 2048]）
+ */
+export declare const useMsdfFont: (texts: string[], fontUrl?: string, textureSize?: [number, number]) => import("@zappar/msdf-generator").FontFamily;
+//# sourceMappingURL=useMsdfFont.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useMsdfFont.d.ts","sourceRoot":"","sources":["../../src/hooks/useMsdfFont.ts"],"names":[],"mappings":"AAUA;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,GACtB,OAAO,MAAM,EAAE,EACf,UAAS,MAA0B,EACnC,cAAa,CAAC,MAAM,EAAE,MAAM,CAAyB,gDAMtD,CAAA"}

package/dist/hooks/useMsdfFont.js

@@ -0,0 +1,19 @@
+import { useMemo } from 'react';
+import { useTTF } from '../fonts/useTTF';
+import { JAPANESE_FONT_URL, JAPANESE_TEXTURE_SIZE, } from '../fonts/constants';
+const deriveCharset = (texts) => [...new Set(texts.join(''))].join('');
+/**
+ * MSDF フォントを読み込む hook。
+ * MsdfText を使わず uikit のレイアウトを自分で組みたい場合に使用する。
+ *
+ * @param texts - 表示予定のテキスト配列。ここに含まれる文字が MSDF 生成される。
+ *                安定した参照の配列を渡すことを推奨。
+ * @param fontUrl - フォント URL（デフォルト: Noto Sans JP Regular）
+ * @param textureSize - MSDF テクスチャサイズ（デフォルト: [2048, 2048]）
+ */
+export const useMsdfFont = (texts, fontUrl = JAPANESE_FONT_URL, textureSize = JAPANESE_TEXTURE_SIZE) => {
+    const key = texts.join('\0');
+    const charset = useMemo(() => deriveCharset(texts), [key]);
+    return useTTF(fontUrl, charset, textureSize);
+};
+//# sourceMappingURL=useMsdfFont.js.map

package/dist/hooks/useMsdfFont.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMsdfFont.js","sourceRoot":"","sources":["../../src/hooks/useMsdfFont.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,EACL,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,oBAAoB,CAAA;AAE3B,MAAM,aAAa,GAAG,CAAC,KAAe,EAAU,EAAE,CAChD,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAEvC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,KAAe,EACf,UAAkB,iBAAiB,EACnC,cAAgC,qBAAqB,EACrD,EAAE;IACF,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;IAE1D,OAAO,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,CAAA;AAC9C,CAAC,CAAA"}

package/dist/index.d.ts

@@ -10,7 +10,7 @@ export { WorldContext, WorldProvider, useWorldContext, createDefaultWorldImpleme
 export { TeleportContext, TeleportProvider, useTeleportContext, createDefaultTeleportImplementation, type TeleportContextValue, type TeleportDestination, } from './contexts/TeleportContext';
 export { InstanceEventContext, InstanceEventProvider, useInstanceEventContext, createDefaultInstanceEventImplementation, type InstanceEventContextValue, } from './contexts/InstanceEventContext';
 export { PlacementStateProvider, usePlacementState, type PlacementMode, type PlacementStateContextValue, } from './contexts/PlacementStateContext';
-export { AudioVolumeContext, AudioVolumeProvider, useAudioVolumeContext, createDefaultAudioVolumeImplementation, type AudioVolumeContextValue, } from './contexts/AudioVolumeContext';
+export { VoiceVolumeOverrideContext, VoiceVolumeOverrideProvider, useVoiceVolumeOverrideContext, createDefaultVoiceVolumeOverrideImplementation, type VoiceVolumeOverrideContextValue, AudioVolumeContext, AudioVolumeProvider, useAudioVolumeContext, createDefaultAudioVolumeImplementation, type AudioVolumeContextValue, } from './contexts/AudioVolumeContext';
 export { Interactable, type InteractableProps, } from './components/Interactable';
 export { Mirror, type MirrorProps } from './components/Mirror';
 export { Skybox, type SkyboxProps } from './components/Skybox';
@@ -33,9 +33,9 @@ export { useConfirm } from './hooks/useConfirm';
 export { useTeleport } from './hooks/useTeleport';
 export { useInstance } from './hooks/useInstance';
 export { useWorld } from './hooks/useWorld';
-export { useWebAudioVolume } from './hooks/useWebAudioVolume';
 export { useInstanceEvent } from './hooks/useInstanceEvent';
-export { useAudioVolume } from './hooks/useAudioVolume';
+export { useVoiceVolumeOverride, useAudioVolume } from './hooks/useAudioVolume';
+export { useDefaultFont, type FontLocale } from './hooks/useDefaultFont';
 export { LAYERS, type LayerName, type LayerNumber } from './constants/layers';
 export { type PlayerMovement, type Position3D, type Rotation3D, type VRTrackingData, type VRMovementDirection, } from './types/movement';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -11,7 +11,9 @@ export { WorldContext, WorldProvider, useWorldContext, createDefaultWorldImpleme
 export { TeleportContext, TeleportProvider, useTeleportContext, createDefaultTeleportImplementation, } from './contexts/TeleportContext';
 export { InstanceEventContext, InstanceEventProvider, useInstanceEventContext, createDefaultInstanceEventImplementation, } from './contexts/InstanceEventContext';
 export { PlacementStateProvider, usePlacementState, } from './contexts/PlacementStateContext';
-export { AudioVolumeContext, AudioVolumeProvider, useAudioVolumeContext, createDefaultAudioVolumeImplementation, } from './contexts/AudioVolumeContext';
+export { VoiceVolumeOverrideContext, VoiceVolumeOverrideProvider, useVoiceVolumeOverrideContext, createDefaultVoiceVolumeOverrideImplementation, 
+// Deprecated aliases
+AudioVolumeContext, AudioVolumeProvider, useAudioVolumeContext, createDefaultAudioVolumeImplementation, } from './contexts/AudioVolumeContext';
 // Components
 export { Interactable, } from './components/Interactable';
 export { Mirror } from './components/Mirror';
@@ -35,9 +37,9 @@ export { useConfirm } from './hooks/useConfirm';
 export { useTeleport } from './hooks/useTeleport';
 export { useInstance } from './hooks/useInstance';
 export { useWorld } from './hooks/useWorld';
-export { useWebAudioVolume } from './hooks/useWebAudioVolume';
 export { useInstanceEvent } from './hooks/useInstanceEvent';
-export { useAudioVolume } from './hooks/useAudioVolume';
+export { useVoiceVolumeOverride, useAudioVolume } from './hooks/useAudioVolume';
+export { useDefaultFont } from './hooks/useDefaultFont';
 // Constants
 export { LAYERS } from './constants/layers';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xrift/world-components",
-  "version": "0.33.3",
+  "version": "0.35.0",
   "description": "Shared components and utilities for Xrift worlds",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,7 +9,8 @@
   ],
   "scripts": {
     "build": "tsc",
-    "dev": "tsc --watch",
+    "dev": "vite",
+    "dev:build": "tsc --watch",
     "test": "vitest run",
     "test:watch": "vitest",
     "prepublishOnly": "npm run build"
@@ -58,6 +59,7 @@
     "@triplex/api": "^0.1.4",
     "@types/react": "^18.3.12",
     "@types/three": "^0.181.0",
+    "@vitejs/plugin-react": "^6.0.1",
     "jsdom": "^28.0.0",
     "react-dom": "^19.2.0",
     "three": "^0.181.0",