arrakis-background 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 the Arrakis authors
+
+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.

package/README.md

@@ -1,3 +1,59 @@
-# Temporary Holding Version
+# Arrakis
 
-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.
+English | [简体中文](README.zh-CN.md)
+
+A native DeepSeek Harness UI bundle: the existing Three.js dune renderer, a restrained violet blank-home background, and a replacement mark. Install it through DSH's Plugins screen; it does not wrap, copy, or rebuild the harness.
+
+## Install in DSH
+
+1. Open **Plugins → Add plugin** in native DSH.
+2. Enter `arrakis-background` for a registry release, or `file:/absolute/path/arrakis-background-0.1.1.tgz` for a local package.
+3. Complete installation, then open **New Session**. Use DSH's dark appearance for the dark graphite surface.
+4. Toggle **Arrakis** in Plugins to enable or disable it. Disabling removes the dunes and restores the native marks.
+
+The equivalent native CLI is:
+
+```sh
+dsh plugin --profile web add arrakis-background
+dsh web
+```
+
+For a local tarball, replace the package name with its absolute `file:` spec. A local package does not need registry publication. A registry spec requires a published release. Do not use a separate Vite preview to qualify the installed DSH UI.
+
+## What changes
+
+- The procedural GPU scene mounts only on the blank home through `conversation.hero.frame`; it is not a screenshot background.
+- The hero and sidebar mark overrides use priority −1 and are disposed with the plugin. The stock branding plugin remains available underneath.
+- The background layer has `pointer-events: none` and is hidden from assistive technology.
+- The native composer, keyboard shortcuts, commands, attachments, access selector, model/effort picker, send/cancel behavior, session list and account actions remain DSH-owned.
+- This bundle adds no provider, authentication flow, image-upload support, or per-turn telemetry. Attachment preview does not establish provider image support.
+
+## Requirements and limits
+
+The native installation was exercised against DSH `0.2.2-rc.1` at `fcc0ad4621`, using Node 24. The package requires Node `^22.19.0 || >=24.0.0` and a browser with WebGL 2. Compatibility with other DSH revisions is not certified. Rendering requires a real graphics context; without one, the native controls remain available and the background initialization reports a diagnostic.
+
+The renderer has a quality-dependent DPR cap, resize handling, visibility throttling, reduced-motion behavior, and disposal cleanup. Changing terrain tessellation takes effect on remount, not through a live quality change. No screenshot, input, or account data is sent by this bundle.
+
+## Development
+
+```sh
+npm ci
+npm test
+npm pack
+```
+
+`npm pack` builds the Cordis client and ships only the declared package files. Keep `src/arrakis.js` as the renderer source and `src/cordis-client.js` as the native slot adapter; do not hand-edit `lib/client.js`.
+
+The source-only demo is available with `npm run dev`. Its `1`–`4` shortcuts and `window.arrakis` are development controls, not DSH product controls.
+
+## Renderer source API
+
+For source-development integrations, `createArrakisBackground({ mount, quality, accent, secondary, background, intensity, speed, parallax, fog, contourSpacing })` creates one renderer. Quality choices are `low`, `balanced`, and `ultra`. The returned instance offers `setMode`, `emit`, `configure`, `pause`, `resume`, and `destroy`.
+
+Modes are `idle`, `thinking`, `tools`, and `handoff`. Event names are `inference:start`, `inference:end`, `tool:start`, `tool:end`, `handoff`, `handoff:end`, `session:idle`, and `pulse`. Source integrations may dispatch `arrakis:activity` on their own renderer container. The native DSH bundle does not wire these to live conversation events.
+
+The npm package exports the native Cordis entry and client bundle; it does not expose the renderer source as a separate public import.
+
+## Third-party notices
+
+The distributed client includes Three.js. Its original license is retained in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).

package/README.zh-CN.md

@@ -0,0 +1,59 @@
+# Arrakis
+
+[English](README.md) | 简体中文
+
+原生 DeepSeek Harness 界面插件包：复用现有 Three.js 沙丘渲染器，为空白首页提供克制的紫色沙丘背景和替换标记。通过 DSH 的“插件”界面安装；本插件不会包装、复制或重新构建宿主。
+
+## 在 DSH 中安装
+
+1. 在原生 DSH 中打开**插件 → 添加插件**。
+2. 安装已发布版本时输入 `arrakis-background`；安装本地包时输入 `file:/absolute/path/arrakis-background-0.1.1.tgz`。
+3. 完成安装后打开**新建会话**。在 DSH 中使用深色外观即可呈现深石墨色界面。
+4. 在“插件”中切换 **Arrakis** 的启用状态。禁用后沙丘消失，原生标记恢复。
+
+等效的原生命令行操作：
+
+```sh
+dsh plugin --profile web add arrakis-background
+dsh web
+```
+
+使用本地 tarball 时，将包名替换为绝对 `file:` 包规格。本地包无需发布到注册表；使用注册表包名则需要已有的发布版本。不能用单独的 Vite 预览代替已安装 DSH 界面的验证。
+
+## 改动范围
+
+- 程序化 GPU 场景仅通过 `conversation.hero.frame` 挂载到空白首页；背景不是截图。
+- 首页和侧栏的标记覆盖使用 −1 优先级，随插件卸载而释放；底层原生品牌插件保持可用。
+- 背景层设置 `pointer-events: none`，并对辅助技术隐藏。
+- 原生输入框、键盘快捷键、命令、附件、访问模式选择器、模型及推理强度选择器、发送与取消、会话列表和账户操作仍由 DSH 管理。
+- 本插件不增加模型提供方、身份认证流程、图片上传能力或逐轮遥测。附件预览成功并不证明模型提供方支持图片。
+
+## 要求与限制
+
+原生安装已在 DSH `0.2.2-rc.1`、提交 `fcc0ad4621` 和 Node 24 环境下验证。包要求 Node `^22.19.0 || >=24.0.0` 以及支持 WebGL 2 的浏览器。其他 DSH 修订版本的兼容性尚未认证。渲染需要真实图形上下文；缺少图形上下文时，原生控件仍可使用，背景初始化会输出诊断信息。
+
+渲染器包含随质量等级调整的 DPR 上限、尺寸变化处理、页面可见性节流、减少动态效果支持及释放清理。地形网格细分变化需要重新挂载，不会在实时切换质量时生效。本插件不发送截图、输入内容或账户数据。
+
+## 开发
+
+```sh
+npm ci
+npm test
+npm pack
+```
+
+`npm pack` 会构建 Cordis 客户端，且仅打包声明的文件。`src/arrakis.js` 是渲染器源文件，`src/cordis-client.js` 是原生槽位适配器；请勿手动编辑 `lib/client.js`。
+
+源代码演示通过 `npm run dev` 启动。其 `1`–`4` 快捷键和 `window.arrakis` 仅用于开发，不是 DSH 产品控件。
+
+## 渲染器源代码 API
+
+源代码集成可通过 `createArrakisBackground({ mount, quality, accent, secondary, background, intensity, speed, parallax, fog, contourSpacing })` 创建一个渲染器。质量选项为 `low`、`balanced`、`ultra`。返回实例提供 `setMode`、`emit`、`configure`、`pause`、`resume` 和 `destroy`。
+
+模式为 `idle`、`thinking`、`tools`、`handoff`。事件名为 `inference:start`、`inference:end`、`tool:start`、`tool:end`、`handoff`、`handoff:end`、`session:idle`、`pulse`。源代码集成可以在自己的渲染器容器上分发 `arrakis:activity`。原生 DSH 插件包没有将这些事件连接到实时会话。
+
+npm 包导出原生 Cordis 入口和客户端包，不将渲染器源代码作为单独的公开导入项。
+
+## 第三方许可声明
+
+分发的客户端包含 Three.js。其原始许可证保留在 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) 中。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,26 @@
+# Third-party notices / 第三方许可声明
+
+The client bundle contains Three.js. Its original license follows.
+客户端包包含 Three.js，以下保留其原始许可证。
+
+The MIT License
+
+Copyright © 2010-2026 three.js authors
+
+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.

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# Decoration overrides are disposable slot contributions; keep native branding available.
+- insert:
+    - id: arrakis-background
+      name: arrakis-background