@celljs/ta-screen-share 0.0.0-stage → 4.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.en.md ADDED
@@ -0,0 +1,13 @@
1
+ # Cell - Ta Screen Share
2
+
3
+ Remote desktop: seeing and working the screen of a computer; sharing conversations, pages and files is `@celljs/ta-share`.
4
+
5
+ A pi package that comes with Ta (on by default; turned off in Settings → Extensions of the web client): Remote desktop. Design record: [docs/design/ta-desktop-remote.md](../../docs/design/ta-desktop-remote.md).
6
+
7
+ - **The Remote desktop page**: under Discover and in Quick open (loaded when opened). It lists this computer, the remote hosts (the machines of `ssh://` directories) and the computers the user added (address:port); a tap opens the screen of one over the page.
8
+ - **On a phone**: as a trackpad by default — a finger slides the pointer, a tap clicks, two taps double click, a held finger right clicks, a tap then a held finger drags; two fingers scroll, pinched they zoom in (up to 4 times, to point exactly). The bar switches to tapping where you point, and has the keyboard (with a row of Ctrl, ⌥, ⌘, ⇧, Esc, Tab and the arrows over it; a modifier tapped goes with the next key, tapped twice it stays down), pasting text, fitting the screen and the picture (Auto, Sharp, Smooth). The touches of the picture are its own (`data-own-gestures`); back is a swipe from the left edge.
9
+ - **On a computer**: the mouse, the wheel and the keyboard go as they are; a pinch of the trackpad zooms the picture.
10
+ - **How it connects**: ta serve connects to the VNC server of the computer (RFB 3.8) through the ExecEnvironment of its machine (this one directly, a remote host through the exec-server over ssh); the page touches no port. ta serve cuts and scales the part the page looks at and sends it as JPEG tiles over the same connection, only those that changed. A password (of VNC, or the account of the Screen Sharing of macOS) is asked in every page, the first answer counts, and nothing is kept.
11
+ - **Who may**: in the first stage you alone, the owner of the Ta: every call of remote desktops is the owner's, and `desktop.view` / `desktop.control` are no action that can be given, by a role or on its own. One of your pages works it at a time, the one opened last or that takes it with Work it here.
12
+
13
+ The server side is `TaScreenShareServer` of ta serve (`ta-host/src/node/screen-share/`); this package has only a web extension.
package/README.md CHANGED
@@ -1,3 +1,13 @@
1
- # Temporary Holding Version
1
+ # Cell - Ta Screen Share
2
2
 
3
- 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.
3
+ 远程桌面:看和操作一台电脑的屏幕;分享对话、页面、文件是 `@celljs/ta-share`。
4
+
5
+ Ta 自带的 pi 包(默认开启,可在 Web 客户端的 设置 → 扩展 关闭):远程桌面。设计记录见 [docs/design/ta-desktop-remote.md](../../docs/design/ta-desktop-remote.md)。
6
+
7
+ - **"远程桌面"页**:在"发现"和快捷打开里(按需启动:点开才加载)。列出这台电脑、远程主机(`ssh://` 目录所在的机器)和用户添加的电脑(地址:端口),点一下全屏打开它的屏幕。
8
+ - **手机上**:默认触控板模式——手指滑动移动指针,轻点单击,连点两下双击,按住右键,轻点后按住拖动;两指滑动滚动,两指捏合放大画面(最多 4 倍,指哪点哪)。工具栏可切换成"指哪点哪"(直接点在手指处),还有键盘(上方一排 Ctrl、⌥、⌘、⇧、Esc、Tab、方向键,修饰键点一下作用于下一个键、点两下锁定)、粘贴文字、适应屏幕、画面质量(自动 / 清晰 / 流畅)。画面区域的手势归它自己(`data-own-gestures`),从屏幕左边缘右滑返回。
9
+ - **电脑上**:鼠标、滚轮、键盘直接发过去;触控板捏合缩放画面。
10
+ - **连接**:由 Ta 服务连电脑的 VNC(RFB 3.8),经那台机器的执行环境(本机直连,远程主机经 ssh 上的 exec-server),页面不碰任何端口;画面由 Ta 服务按页面看的区域裁剪、缩放后分块编成 JPEG,经同一条连接传过来,只传变化的块。要登录时(VNC 密码,或 macOS 屏幕共享的账号密码)在打开的屏幕上出一页登录表单(账号和密码一次填完;连这台电脑时账号已填好),所有页面都出,第一个回答生效;密码不对时 Ta 自动重连,表单上写明"账号或密码不对"再问,最多 5 次;勾着"记住密码"(默认勾上)且对方接受了,就存进保险箱,下次连接自动登录;存着的密码被拒时再弹框问。没开保险箱时不显示这一项,也不保存。
11
+ - **谁能用**:第一阶段只有你自己(Ta 的主人):远控的所有调用都只认所有者,`desktop.view` / `desktop.control` 不在可授予的动作里,任何角色和单项授权都给不了。你的多个页面里同一时刻只有一个在操作,后打开或点"在这里操作"的那个接过来。
12
+
13
+ 服务端是 Ta 服务的 `TaScreenShareServer`(`ta-host/src/node/screen-share/`),这个包只有 Web 扩展。
package/package.json CHANGED
@@ -1,6 +1,54 @@
1
1
  {
2
2
  "name": "@celljs/ta-screen-share",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "4.18.0",
4
+ "description": "A pi package for Ta: the desktops of other computers, seen and worked from a phone or another computer, over VNC through ta serve",
5
+ "keywords": [
6
+ "pi-package"
7
+ ],
8
+ "homepage": "https://github.com/cellbang/ta",
9
+ "bugs": {
10
+ "url": "https://github.com/cellbang/ta/issues"
11
+ },
12
+ "repository": {
13
+ "type": "git",
14
+ "url": "https://github.com/cellbang/cell.git"
15
+ },
16
+ "license": "MIT",
17
+ "files": [
18
+ "web",
19
+ "!**/*.map"
20
+ ],
21
+ "scripts": {
22
+ "build": "tsc -b && bun build web-src/index.tsx --format esm --target browser --outfile web/index.js",
23
+ "clean": "rm -rf lib web *.tsbuildinfo",
24
+ "test": "bun test ./lib",
25
+ "watch": "tsc -b -w --preserveWatchOutput"
26
+ },
27
+ "devDependencies": {
28
+ "@celljs/ta-protocol": "4.18.0",
29
+ "@celljs/ta-web": "4.18.0",
30
+ "@types/react": "^19.3.0"
31
+ },
32
+ "publishConfig": {
33
+ "access": "public"
34
+ },
35
+ "pi": {
36
+ "title": {
37
+ "en": "Remote desktop",
38
+ "zh-CN": "远程桌面",
39
+ "zh-TW": "遠端桌面",
40
+ "ja-JP": "リモートデスクトップ"
41
+ },
42
+ "summary": {
43
+ "en": "See and work the screen of this computer or another one from your phone or another computer: point, tap and type as if you were there.",
44
+ "zh-CN": "在手机或另一台电脑上看到并操作这台或别的电脑的屏幕:指哪点哪、打字,就像坐在它前面。",
45
+ "zh-TW": "在手機或另一台電腦上看到並操作這台或別的電腦的螢幕:指哪點哪、打字,就像坐在它前面。",
46
+ "ja-JP": "スマホや別のパソコンから、このパソコンや他のパソコンの画面を見て操作できます。その場にいるように指して、タップして、入力できます。"
47
+ },
48
+ "icon": "MonitorSmartphone",
49
+ "webActivation": "open",
50
+ "web": [
51
+ "./web/index.js"
52
+ ]
53
+ }
54
+ }