dsh-plugin-tetris 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,26 @@
+MIT License
+
+Copyright (c) 2026 jayzhu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+The game engine in src/core/ is a TypeScript port of tetris-terminal
+(https://github.com/zlh124/tetris-terminal), which is also MIT licensed.

package/README.en.md

@@ -0,0 +1,63 @@
+<div align="center">
+
+# dsh-plugin-tetris
+
+**Play a round of Tetris in the DSH Web GUI while the agent is working.**
+
+[中文](README.md) | [English](README.en.md)
+
+| Mode menu | Playing |
+|:---:|:---:|
+| ![Mode menu](docs/menu.png) | ![Playing](docs/game.png) |
+
+</div>
+
+## Background
+
+While coding with DSH, waiting for the agent to finish leaves you with a few dozen idle
+seconds — so this became a plugin. The game panel lives in DSH's frame-level overlay and
+appears on its own when the agent starts working. A circular T-tetrimino icon stays in the
+bottom-right corner, and the panel opens right where that icon sits.
+
+The engine is not a throwaway: it is a line-by-line TypeScript port of my other project
+[**tetris-terminal**](https://github.com/zlh124/tetris-terminal) (a Python terminal Tetris).
+7-bag, SRS wall kicks, Hold, Ghost, T-Spin, Back-to-Back and the line-clear animation all
+match the terminal version, quirks included. The rules and feel came from there first.
+
+> If you enjoy this, go give [**tetris-terminal**](https://github.com/zlh124/tetris-terminal) a ⭐.
+
+## Controls
+
+| Key | Action |
+|---|---|
+| `←` `→` / `A` `D` | Move left / right |
+| `↑` / `W` / `X` | Rotate clockwise |
+| `Z` | Rotate counter-clockwise |
+| `↓` / `S` | Soft drop |
+| `Space` | Hard drop |
+| `C` | Hold |
+| `P` | Pause / resume |
+
+Click the board once before using the keyboard; a green ring shows it has focus. The
+"焦点联动" slider in the title bar toggles *pause on blur* and *focus returns when the
+conversation ends*.
+
+## Install
+
+```bash
+dsh plugin --profile web add dsh-plugin-tetris
+```
+
+No page refresh needed. Uninstall:
+
+```bash
+dsh plugin --profile web remove dsh-plugin-tetris
+```
+
+Working from source: `npm install && npm run build`, then
+`dsh plugin --profile web add link:"$PWD"`.
+
+## License
+
+MIT. The engine logic comes from [tetris-terminal](https://github.com/zlh124/tetris-terminal)
+(MIT, jayzhu).

package/README.md

@@ -1,3 +1,60 @@
-# Temporary Holding Version
+<div align="center">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# dsh-plugin-tetris
+
+**趁 agent 干活的时候，在 DSH Web GUI 里来一局俄罗斯方块。**
+
+[中文](README.md) | [English](README.en.md)
+
+| 模式菜单 | 对局 |
+|:---:|:---:|
+| ![模式菜单](docs/menu.png) | ![对局](docs/game.png) |
+
+</div>
+
+## 背景
+
+用 DSH 写代码的时候，等 agent 跑任务总有几十秒空档，于是把它做成了一个插件：
+游戏面板挂在 DSH 的框架级浮动层上，agent 开始工作时自动出现；右下角常驻一个圆形
+T 形方块图标，随时点开就能玩，面板会从图标的位置弹出。
+
+引擎不是随手写的——它是我另一个项目
+[**tetris-terminal**](https://github.com/zlh124/tetris-terminal)（Python 终端版俄罗斯方块）
+的逐行 TypeScript 移植：7-bag、SRS 墙踢、Hold、Ghost、T-Spin、B2B、消行动画都和终端版一致，
+连终端版的一些怪癖也一并保留了。规则和手感是它先做出来的。
+
+> 觉得好玩的话，去给 [**tetris-terminal**](https://github.com/zlh124/tetris-terminal) 点个 ⭐ 吧。
+
+## 操作
+
+| 键 | 动作 |
+|---|---|
+| `←` `→` / `A` `D` | 左右移动 |
+| `↑` / `W` / `X` | 顺时针旋转 |
+| `Z` | 逆时针旋转 |
+| `↓` / `S` | 软降 |
+| `空格` | 硬降 |
+| `C` | Hold |
+| `P` | 暂停 / 继续 |
+
+先点一下棋盘再用键盘；聚焦后棋盘会有一圈绿色描边。标题栏的「焦点联动」滑块控制
+"失焦自动暂停 + 对话结束把焦点交还游戏"。
+
+## 安装
+
+```bash
+dsh plugin --profile web add dsh-plugin-tetris
+```
+
+装完不需要刷新页面。卸载：
+
+```bash
+dsh plugin --profile web remove dsh-plugin-tetris
+```
+
+从源码开发：`npm install && npm run build`，然后
+`dsh plugin --profile web add link:"$PWD"`。
+
+## License
+
+MIT。引擎逻辑来自 [tetris-terminal](https://github.com/zlh124/tetris-terminal)（MIT, jayzhu）。

package/cordis.patch.yml

@@ -0,0 +1,12 @@
+# Bundle patch layer for dsh-plugin-tetris.
+#
+# Applied when this package is listed in the profile's `dsh.profile.bundles`
+# (`dsh plugin --profile web add link:<path>` appends it automatically), or when
+# the same `insert` row is added to the profile's own cordis.patch.yml.
+#
+# A `dsh.client` row is what the client-modules node half scans into the
+# browser roster, so this single row is all it takes to get the plugin into
+# window.__DSH_BOOT__ and served from /plugins/dsh-plugin-tetris/client.js.
+- insert:
+    - id: tetris
+      name: 'dsh-plugin-tetris'