@hadoku/watchparty-ui

中文文档
0.45.102发布于 2026/11/17MITTypeScriptES Module近 30 天下载 2.3万

为Hadoku Watch Party应用程序反应UI组件.

中文使用文档
文档目录10 节
  1. 安装
  2. 使用量
  3. 基本设置
  4. 配置
  5. 发展
  6. 出版
  7. 发展说明
  8. 运行时服务器集成( 第2阶段)
  9. CSS 重置/飞行前
  10. 黑暗主题锁定/ 扩展干扰

@wolffm/ watchparty-ii (英语)

为Hadoku Watch Party应用程序反应UI组件.

安装

这个软件包被发布到 GitHub 软件包中. 要安装 :

  1. 配置 npm 以使用 GitHub 软件包 通过创建/更新 .npmrc数字 :
@wolffm:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
  1. 安装软件包数字 :
npm install @wolffm/watchparty-ui
# or
pnpm add @wolffm/watchparty-ui

使用量

基本设置

import { WatchPartyProvider, WatchPartyRoom } from '@wolffm/watchparty-ui';
import '@wolffm/watchparty-ui/dist/style.css';

function App() {
  return (
    <WatchPartyProvider serverOrigin="https://your-server.com">
      <WatchPartyRoom defaultRoomKey="your-room-key" />
    </WatchPartyProvider>
  );
}

配置

UI组件可以通过道具配置 :

  • serverOrigin: WebSocket 服务器 URL( 默认 ): /(中文(简体) )
  • defaultRoomKey: 在挂载上加入的房间( 可选)

发展

要在本地进行这套软件包的工作:

# Install dependencies
pnpm install

# Run dev server
pnpm dev

# Build for production
pnpm build

出版

此软件包在每次按下时自动发布到 GitHub 软件包 main 这影响了UI代码.

这个版本是CI的,从来没有承诺的: publish-packages.yml 将其设置为登记簿最新上方的一个补丁(WolffM/hadoku-actions/next-version),仅在CI工作空间中,与 @wolffm/rooms-protocol 财务报告和审定财务报表 @wolffm/rooms-server。从不手工编辑.


发展说明

0阶段脚手架(反应19 + Vite)已就位.

密钥配置 :

  • 基础路径 : /watchparty/
  • 路由器基名 : /watchparty
  • 尾风 + Zustand + socket.io-客户端

运行时服务器集成( 第2阶段)

UI现在自动加入一个占位键 demo 当用户按下身份抽屉里的"Join Room"时. 它会发出一个苏克特。 内线 join 载荷 { room_key:'demo', leader_key?, name, sprite }。 。 。 .

通过环境配置不同的后端来源( 如果 UI 服务于不同的主机) :

VITE_SERVER_ORIGIN=https://api.example.com

如果省略,客户端会相对当前来源进行连接( I)/watchparty/ws) (中文(简体) ).

复制加盟被压制( 如果 me.clientId ) (已经有人居住. 一旦一个房间选择 / 创建 UX 存在, 此临时流量将被替换 .

CSS 重置/飞行前

Tailwind v4 预飞被禁用,以消除对遗留的供应商选择器的操纵台警告. 在 src/styles.css。该主题使用 CSS 变量 @wolffm/themes 绘图于 @theme 块.

黑暗主题锁定/ 扩展干扰

该应用程序执行一个永久的黑暗主题来避免由"黑暗阅读"等扩展来进行颜色倒置:

  • 已添加 <meta name="color-scheme" content="dark"> 打开 data-theme="dark" 打开 <html>。 。 。 .
  • 设定 data-darkreader-skip 打开 <html> 财务报告和审定财务报表 <body> 提示黑暗读者不要变形.
  • 已宣布为稳定颜色的 CSS 变量 (--wp-*和 color-scheme: dark 以减热.
  • 明确的黑色背景确保扩展切换时不会闪出 .

如果需要未来的光线模式,请引入一个可控主题开关并删除 data-darkreader-skip 有选择地而不是允许无控制的扩展突变.

版本与发布记录

@hadoku/watchparty-ui 共发布 127 个版本,首次发布于 2026/10/28;过去 12 个月发布了 127 个版本。

版本发布日期距今
0.45.102latest2026/11/17今天
0.45.1012026/11/17今天
0.45.1002026/11/17今天
0.45.992026/11/17今天
0.45.982026/11/17今天
0.45.972026/11/17今天

关于 @hadoku/watchparty-ui 的常见问题

@hadoku/watchparty-ui 是什么?

为Hadoku Watch Party应用程序反应UI组件.

如何安装 @hadoku/watchparty-ui?

在项目目录运行 npm install @hadoku/watchparty-ui,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^19.2.0)、react-dom(^19.2.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@hadoku/watchparty-ui 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@hadoku/watchparty-ui 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@hadoku/watchparty-ui 可以商用吗?

@hadoku/watchparty-ui 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@hadoku/watchparty-ui 的下载量有多少?

根据 npm 官方下载统计,@hadoku/watchparty-ui 在 2026/10/17 – 2026/11/15 这 30 天内被下载 23,137 次,日均约 771 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@hadoku/watchparty-ui 还在维护吗?

最新版本 0.45.102 发布于 2026/11/17(今天);至今共发布 127 个版本,其中过去 12 个月发布了 127 个;首次发布于 2026/10/28。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。