@linxai/3d-web 0.1.0 → 0.1.1

package/dist/index.d.mts

@@ -0,0 +1,87 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { CharacterViewProps, SceneConfig, OrbitControlsConfig } from '@linxai/3d-shared';
+export { AnimationConfig, AnimationStateConfig, AnimationStatesConfig, Character, CharacterViewProps, GridHelperConfig, LightConfig, ModelLoadConfig, OrbitControlsConfig, OverlayConfig, SceneConfig } from '@linxai/3d-shared';
+import { ReactNode, CSSProperties } from 'react';
+import { SceneBuilder } from '@linxai/3d-shared/internal';
+export { useGLTF as useModelLoader } from '@react-three/drei';
+
+/**
+ * 3D 角色查看器
+ */
+declare function CharacterView(props: CharacterViewProps): react_jsx_runtime.JSX.Element;
+
+interface Scene3DProps {
+    /** 子组件 */
+    children: ReactNode;
+    /** 场景配置 */
+    config?: SceneConfig;
+    /** OrbitControls 配置 */
+    controlsConfig?: OrbitControlsConfig;
+    /** Canvas 样式 */
+    style?: CSSProperties;
+    /** Canvas className */
+    className?: string;
+    /** 是否显示进度条 */
+    showProgress?: boolean;
+}
+declare function Scene3D(props: Scene3DProps): react_jsx_runtime.JSX.Element;
+
+interface CharacterOverlayProps {
+    /** 是否显示浮层 */
+    visible?: boolean;
+    /** 当前字幕文本 */
+    subtitle?: string;
+    /** 是否显示字幕 */
+    showSubtitle?: boolean;
+    /** 是否显示说话按钮 */
+    showSpeakButton?: boolean;
+    /** 是否正在连接/加载 */
+    isLoading?: boolean;
+    /** 是否已连接 */
+    isConnected?: boolean;
+    /** 开始说话回调 */
+    onStartSpeak?: () => void;
+    /** 停止说话回调 */
+    onStopSpeak?: () => void;
+    /** 按钮点击回调（用于外部控制连接状态） */
+    onButtonClick?: () => void;
+    /** 字幕样式 */
+    subtitleStyle?: React.CSSProperties;
+    /** 容器样式 */
+    style?: React.CSSProperties;
+}
+/**
+ * 角色浮层组件
+ * 包含说话控制按钮和字幕显示
+ *
+ * 纯 UI 组件，基于 props 驱动，不包含业务逻辑
+ */
+declare function CharacterOverlay({ visible, subtitle, showSubtitle, showSpeakButton, isLoading, isConnected, onStartSpeak, onStopSpeak, onButtonClick, subtitleStyle, style, }: CharacterOverlayProps): react_jsx_runtime.JSX.Element | null;
+
+interface SubtitleProps {
+    /** 字幕文本 */
+    text?: string;
+    /** 是否可见 */
+    visible?: boolean;
+    /** 容器样式 */
+    style?: React.CSSProperties;
+    /** 字幕框样式 */
+    boxStyle?: React.CSSProperties;
+    /** 文本样式 */
+    textStyle?: React.CSSProperties;
+    /** 底部偏移（默认 80px） */
+    bottomOffset?: number;
+}
+/**
+ * 字幕组件
+ * 带淡入淡出动画的字幕显示
+ */
+declare function Subtitle({ text, visible, style, boxStyle, textStyle, bottomOffset, }: SubtitleProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * Web 端场景构建器
+ * 装配 Web 平台特定的 Canvas 和 OrbitControls
+ */
+declare const WebSceneBuilder: SceneBuilder;
+
+export { CharacterOverlay, type CharacterOverlayProps, CharacterView, Scene3D, Subtitle, type SubtitleProps, WebSceneBuilder };

package/dist/index.d.ts

@@ -0,0 +1,87 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { CharacterViewProps, SceneConfig, OrbitControlsConfig } from '@linxai/3d-shared';
+export { AnimationConfig, AnimationStateConfig, AnimationStatesConfig, Character, CharacterViewProps, GridHelperConfig, LightConfig, ModelLoadConfig, OrbitControlsConfig, OverlayConfig, SceneConfig } from '@linxai/3d-shared';
+import { ReactNode, CSSProperties } from 'react';
+import { SceneBuilder } from '@linxai/3d-shared/internal';
+export { useGLTF as useModelLoader } from '@react-three/drei';
+
+/**
+ * 3D 角色查看器
+ */
+declare function CharacterView(props: CharacterViewProps): react_jsx_runtime.JSX.Element;
+
+interface Scene3DProps {
+    /** 子组件 */
+    children: ReactNode;
+    /** 场景配置 */
+    config?: SceneConfig;
+    /** OrbitControls 配置 */
+    controlsConfig?: OrbitControlsConfig;
+    /** Canvas 样式 */
+    style?: CSSProperties;
+    /** Canvas className */
+    className?: string;
+    /** 是否显示进度条 */
+    showProgress?: boolean;
+}
+declare function Scene3D(props: Scene3DProps): react_jsx_runtime.JSX.Element;
+
+interface CharacterOverlayProps {
+    /** 是否显示浮层 */
+    visible?: boolean;
+    /** 当前字幕文本 */
+    subtitle?: string;
+    /** 是否显示字幕 */
+    showSubtitle?: boolean;
+    /** 是否显示说话按钮 */
+    showSpeakButton?: boolean;
+    /** 是否正在连接/加载 */
+    isLoading?: boolean;
+    /** 是否已连接 */
+    isConnected?: boolean;
+    /** 开始说话回调 */
+    onStartSpeak?: () => void;
+    /** 停止说话回调 */
+    onStopSpeak?: () => void;
+    /** 按钮点击回调（用于外部控制连接状态） */
+    onButtonClick?: () => void;
+    /** 字幕样式 */
+    subtitleStyle?: React.CSSProperties;
+    /** 容器样式 */
+    style?: React.CSSProperties;
+}
+/**
+ * 角色浮层组件
+ * 包含说话控制按钮和字幕显示
+ *
+ * 纯 UI 组件，基于 props 驱动，不包含业务逻辑
+ */
+declare function CharacterOverlay({ visible, subtitle, showSubtitle, showSpeakButton, isLoading, isConnected, onStartSpeak, onStopSpeak, onButtonClick, subtitleStyle, style, }: CharacterOverlayProps): react_jsx_runtime.JSX.Element | null;
+
+interface SubtitleProps {
+    /** 字幕文本 */
+    text?: string;
+    /** 是否可见 */
+    visible?: boolean;
+    /** 容器样式 */
+    style?: React.CSSProperties;
+    /** 字幕框样式 */
+    boxStyle?: React.CSSProperties;
+    /** 文本样式 */
+    textStyle?: React.CSSProperties;
+    /** 底部偏移（默认 80px） */
+    bottomOffset?: number;
+}
+/**
+ * 字幕组件
+ * 带淡入淡出动画的字幕显示
+ */
+declare function Subtitle({ text, visible, style, boxStyle, textStyle, bottomOffset, }: SubtitleProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * Web 端场景构建器
+ * 装配 Web 平台特定的 Canvas 和 OrbitControls
+ */
+declare const WebSceneBuilder: SceneBuilder;
+
+export { CharacterOverlay, type CharacterOverlayProps, CharacterView, Scene3D, Subtitle, type SubtitleProps, WebSceneBuilder };