dsh-theme-splat-ui 0.0.0-stage → 0.1.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.
Files changed (66) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/LICENSE +21 -0
  3. package/README.ja.md +160 -0
  4. package/README.ko.md +160 -0
  5. package/README.md +159 -2
  6. package/README.zh.md +160 -0
  7. package/THIRD_PARTY_NOTICES.md +50 -0
  8. package/assets/icon-256.png +0 -0
  9. package/cordis.patch.yml +5 -0
  10. package/docs/acceptance-results.json +343 -0
  11. package/docs/acceptance.md +50 -0
  12. package/docs/compatibility.md +34 -0
  13. package/docs/design.md +84 -0
  14. package/docs/screenshots/appearance-dark.png +0 -0
  15. package/docs/screenshots/appearance-light.png +0 -0
  16. package/docs/screenshots/attachment-dark.png +0 -0
  17. package/docs/screenshots/attachment-light.png +0 -0
  18. package/docs/screenshots/boot-light.png +0 -0
  19. package/docs/screenshots/composer-light.png +0 -0
  20. package/docs/screenshots/hero-dark.png +0 -0
  21. package/docs/screenshots/hero-light.png +0 -0
  22. package/docs/screenshots/input-menu-dark.png +0 -0
  23. package/docs/screenshots/input-menu-light.png +0 -0
  24. package/docs/screenshots/input-menu-mobile-dark.png +0 -0
  25. package/docs/screenshots/input-menu-mobile-light.png +0 -0
  26. package/docs/screenshots/plugin-disabled.png +0 -0
  27. package/docs/screenshots/plugin-reenabled.png +0 -0
  28. package/docs/screenshots/regression-tool-before.png +0 -0
  29. package/docs/screenshots/runtime-reading-dark.png +0 -0
  30. package/docs/screenshots/runtime-reading-light.png +0 -0
  31. package/docs/screenshots/runtime-reading-mobile-dark.png +0 -0
  32. package/docs/screenshots/runtime-reading-mobile-light.png +0 -0
  33. package/docs/screenshots/settings-dark.png +0 -0
  34. package/docs/screenshots/settings-light.png +0 -0
  35. package/docs/screenshots/settings-mobile-dark.png +0 -0
  36. package/docs/screenshots/settings-mobile-light.png +0 -0
  37. package/docs/screenshots/sidebar-light.png +0 -0
  38. package/docs/screenshots/theme-poster.webp +0 -0
  39. package/docs/screenshots/tool-result-dark.png +0 -0
  40. package/docs/screenshots/tool-result-light.png +0 -0
  41. package/docs/screenshots/tool-result-tail-dark.png +0 -0
  42. package/docs/screenshots/tool-result-tail-light.png +0 -0
  43. package/docs/screenshots/workspace-dark.png +0 -0
  44. package/docs/screenshots/workspace-light.png +0 -0
  45. package/lib/client.js +5211 -0
  46. package/lib/index.js +6 -0
  47. package/lib/palette.js +149 -0
  48. package/lib/tokens.js +381 -0
  49. package/lib/types/client/appearance.d.ts +78 -0
  50. package/lib/types/client/components/appearance-tab.d.ts +5 -0
  51. package/lib/types/client/components/brand.d.ts +9 -0
  52. package/lib/types/client/context.d.ts +47 -0
  53. package/lib/types/client/font-layer.d.ts +17 -0
  54. package/lib/types/client/index.d.ts +4 -0
  55. package/lib/types/client/install-appearance.d.ts +12 -0
  56. package/lib/types/client/install.d.ts +12 -0
  57. package/lib/types/client/slots.d.ts +9 -0
  58. package/lib/types/index.d.ts +2 -0
  59. package/lib/types/palette.d.ts +26 -0
  60. package/lib/types/tokens.d.ts +8 -0
  61. package/lib/types/types.d.ts +47 -0
  62. package/licenses/Nunito-OFL.txt +88 -0
  63. package/locale/en.json +6 -0
  64. package/locale/zh.json +6 -0
  65. package/package.json +118 -3
  66. package/screenshots.json +12 -0
package/CHANGELOG.md ADDED
@@ -0,0 +1,19 @@
1
+ # 变更记录
2
+
3
+ ## 未发布
4
+
5
+ ## 0.1.0
6
+
7
+ - 将鱿鱼、章鱼及背景纹样统一为项目原创矢量素材,移除旧的官方光栅占位图。
8
+ - 外观面板采用正向画布墨量:纸白 20%、均衡 50%、涂地 100%,并提供恢复默认值。
9
+ - 更新真实宿主展示图、组件图鉴与宣传片;横版保留为 720p 粗剪。
10
+ - 适配 DSH `0.2.2-rc.5` 桌面端侧栏结构变更:兼容 `sidebar.session.action` 包装容器下的「新会话」洋红胶囊、将 Windows 侧栏底色精确限定至含 `[data-window-drag]` 的根节点以消除滚动区暗色遮罩、放宽 `nav[aria-label]` 后代选择器以保留分隔线与选中态。
11
+ - 完成上线前验证、展示站改版、发行包打包校验与 npm / GitHub Release 发布流水线就绪。
12
+ - 修正代码岛规则侵入浅色结果、原始工具载荷底色、纯文本预览与 toast 操作链接对比度;补入可复现夹具。
13
+ - 更新真实 DSH 日夜、390px、设置、工具结果、输入菜单、附件及停用/重启用验收证据,并复核正向墨量预设与站点安装入口。
14
+ - SPLAT-STREET 日夜主题:荧光绿、洋红墨迹、侧栏、广场欢迎页、输入卡片与代码阅读表面。
15
+ - 墨街外观设置:画布雾面预设和滑杆、装饰、网点、字体与 diff 语法选择,按客户端保存偏好。
16
+ - 设置页改为墨黑导航与纸面表单;选中项采用端正左端和右侧墨尾,保持完整的键盘聚焦提示。
17
+ - 修正下拉列表的重复边框、技能描述重叠、模型搜索框、窄屏菜单宽度和发送按钮底部间距。
18
+ - 修正浅色设置内框、标题斜纹、代码块操作栏与 Windows 浅色原生边框。
19
+ - 统一中文名称为“墨街”。
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Shirolin and dsh-theme-splat-ui contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.ja.md ADDED
@@ -0,0 +1,160 @@
1
+ <div align="center">
2
+
3
+ <img src="assets/icon-256.png" width="96" height="96" alt="SPLAT-STREET icon" />
4
+
5
+ # SPLAT-STREET · DSH テーマ
6
+
7
+ [English](README.md) · [简体中文](README.zh.md) · **日本語** · [한국어](README.ko.md) · [ショーケース&実機デモ](https://shirolin.github.io/dsh-theme-splat-ui/) · 作者:[Shirolin](https://github.com/Shirolin)
8
+
9
+ [![check](https://github.com/Shirolin/dsh-theme-splat-ui/actions/workflows/check.yml/badge.svg?branch=main)](https://github.com/Shirolin/dsh-theme-splat-ui/actions/workflows/check.yml)
10
+ [![pages](https://github.com/Shirolin/dsh-theme-splat-ui/actions/workflows/pages.yml/badge.svg?branch=main)](https://shirolin.github.io/dsh-theme-splat-ui/)
11
+ [![version](https://img.shields.io/badge/version-0.1.0-1edc00?labelColor=141413)](CHANGELOG.md)
12
+ [![npm](https://img.shields.io/npm/v/dsh-theme-splat-ui?color=1edc00&logo=npm&logoColor=white&labelColor=141413)](https://www.npmjs.com/package/dsh-theme-splat-ui)
13
+ [![DSH Target](https://img.shields.io/badge/DSH_Web-0.2.2--rc.1_·_Desktop_0.2.2--rc.5-ff2d8a?labelColor=141413)](docs/compatibility.md)
14
+ [![license: MIT](https://img.shields.io/badge/license-MIT-d3f510?labelColor=141413)](LICENSE)
15
+
16
+ [![Node.js](https://img.shields.io/badge/Node.js-%E2%89%A522.13.0-5FA04E?logo=nodedotjs&logoColor=white&labelColor=141413)](package.json)
17
+ [![pnpm](https://img.shields.io/badge/pnpm-11.1.2-F69220?logo=pnpm&logoColor=white&labelColor=141413)](package.json)
18
+ [![TypeScript](https://img.shields.io/badge/TypeScript-5.8.2-3178C6?logo=typescript&logoColor=white&labelColor=141413)](package.json)
19
+ [![esbuild](https://img.shields.io/badge/esbuild-0.25.6-FFCF00?logo=esbuild&logoColor=black&labelColor=141413)](package.json)
20
+ [![Biome](https://img.shields.io/badge/Biome-2.6.4-60A5FA?logo=biome&logoColor=white&labelColor=141413)](package.json)
21
+ [![ThemeRuntime](https://img.shields.io/badge/dsh--client--ui--theme-0.1.5--rc.3-1edc00?labelColor=141413)](docs/compatibility.md)
22
+
23
+ </div>
24
+
25
+ `SPLAT-STREET` は『スプラトゥーン2』のナワバリバトル言語を取り入れた DeepSeek Harness(Web)用テーマプラグインです。黒に近いサイドバーにマゼンタの「新規セッション」ピル、ライム/クリーム/マゼンタの3色ストライプキャンバスに白いイカ模様とインク飛沫・網点を重ね、空セッションのヒーローには街並みイラスト、起動画面にはスペシャルウェポンゲージ風ローダー、コンポーザーにはマゼンタのインク垂れ付き黒縁カードを採用しています。ダークモードでは同じネオンインクを保ったまま、背景をチャコールブラックに切り替えます。
26
+
27
+ オンラインショーケース・コンポーネント図鑑:https://shirolin.github.io/dsh-theme-splat-ui/
28
+
29
+ > [!NOTE]
30
+ > 非公式のファンテーマであり、任天堂株式会社および DeepSeek 公式とは一切関係ありません。本テーマではオリジナルのベクターイカ/タコ素材、ゲーム画面のスクリーンショットを参考に生成したモノクロ広場イラスト、および SVG 装飾を使用しています。素材の出典、ライセンス範囲、サードパーティ表記は [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) をご覧ください。本プラグインは DSH 公開の ThemeRuntime Token および Slot 拡張点を使用し、アップデート時にも安全にフォールバックします。
31
+
32
+ ---
33
+
34
+ ## プレビュー
35
+
36
+ ![SPLAT-STREET · DSH テーマ](docs/screenshots/theme-poster.webp)
37
+
38
+ > 2026年11月20日、隔離プロファイルの実際の DSH `0.2.2-rc.1` Web 環境へローカル `.tgz` をインストールして再検証・撮影しました。初期バージョンの検証対象は Web です。会話は決定的な検証用履歴であり、モデル呼び出しは行っていません。詳細は [検証範囲とエビデンス](docs/acceptance.md) を参照してください。
39
+
40
+ <details>
41
+ <summary>展開:ライト/ダークワークスペース・設定・リーディング・390px モバイル実機スクリーンショット</summary>
42
+
43
+ | ライトモード (Light) | ダークモード (Dark) |
44
+ | --- | --- |
45
+ | ![実機 DSH ライトワークスペース](docs/screenshots/workspace-light.png) | ![実機 DSH ダークワークスペース](docs/screenshots/workspace-dark.png) |
46
+ | ![実機 DSH ライト設定画面](docs/screenshots/settings-light.png) | ![実機 DSH ダーク設定画面](docs/screenshots/settings-dark.png) |
47
+ | ![ライトリーディング表示](docs/screenshots/runtime-reading-light.png) | ![ダークリーディング表示](docs/screenshots/runtime-reading-dark.png) |
48
+ | ![ライト 390px モバイル](docs/screenshots/runtime-reading-mobile-light.png) | ![ダーク 390px モバイル](docs/screenshots/runtime-reading-mobile-dark.png) |
49
+
50
+ </details>
51
+
52
+ 静的コンポーネント図鑑は `site/showcase/index.html`(公開ページ:https://shirolin.github.io/dsh-theme-splat-ui/showcase/ )にあり、バージョン固定の DOM フィクスチャと実際の DSH CSS から生成されています。スペシャルウェポンゲージ風の起動画面や境界ケースも図鑑で確認できます。
53
+
54
+ ---
55
+
56
+ ## 設計と主な特徴
57
+
58
+ - **昼夜2つのバトルフィールド**:ライトモードはライム/クリーム/マゼンタの3色ストライプに白イカスタンプ・飛沫・網点、右下に白イカ+バーコードステッカーを配置。ダークモードは同じ飛沫とイカ模様を抑えたチャコール地でネオンの発色を際立たせます。
59
+ - **主役になるサイドバー**:黒に近い背景、透過ブランドヘッダー(マゼンタイカ+白 `SPLAT-STREET`+ライム斜めストライプ)、独立したマゼンタの新規セッションボタン、インク尾付きのライム選択行(コントラスト確保のため黒文字)、下部のハザードストライプ、ハードシャドウ。
60
+ - **ヒーローシーン&スペシャルゲージ起動画面**:ハイカラスクエアのスクリーンショットを参考に生成・圧縮した透過 PNG 広場イラストを SVG に組み込み、`2` サイン、`SPLAT-STREET` テープ、インク装飾(夜間は左右のイカ)と `>>>` ブロックを配置。起動画面カードでは上部のイカスタンプを残し、進行リングを24分割のスペシャルウェポンゲージ風デザインにしています。
61
+ - **コンポーザー**:2.5px の黒枠線+内側ヘアライン、網点、ハードシャドウ、右上のマゼンタインク垂れ。添付ボタンは白い紙ディスク、送信ボタンはマゼンタの波紋付きライム円形ボタンです。
62
+ - **外観設定**:`設定 → プラグイン → 墨街外観` にて、「紙白 20% / 均衡 50% / 塗地 100%」プリセット、`0%–100%` のキャンバスインク濃度スライダー(`--splat-canvas-veil` に連動)、3種類のメイングリーン(デフォルト公式 `#1edc00` / ネオン `#9ae528` / ライム `#d3f510`)、diff シンタックス(ネオン/ネイティブ)、装飾・網点・フォント切替、リセットを提供。設定はクライアント側の `localStorage` に保存されます。
63
+ - **ビルド時埋め込み**:Nunito Latin WOFF2(400–900)および各種 SVG・PNG アセットはビルド時に `lib/client.js` へ埋め込まれるため、実行時の外部ダウンロードは不要です。
64
+
65
+ ---
66
+
67
+ ## インストール
68
+
69
+ 1つのプロファイルにつき、有効化するテーマプラグインは1つだけにすることを推奨します。
70
+
71
+ ### npm からインストール(推奨)
72
+
73
+ ```sh
74
+ cd <DSH_Profile_dir>
75
+ pnpm add dsh-theme-splat-ui
76
+ ```
77
+
78
+ インストール後、DSH サービス(またはデスクトップ版アプリ)を完全に再起動してページを再読み込みしてください。
79
+
80
+ ### GitHub Release / オフライン `.tgz`
81
+
82
+ [GitHub Releases](https://github.com/Shirolin/dsh-theme-splat-ui/releases) から `dsh-theme-splat-ui-<version>.tgz` をダウンロード(または本リポジトリで `pnpm run release 0.1.0` を実行)してインストールします:
83
+
84
+ ```sh
85
+ cd <DSH_Profile_dir>
86
+ pnpm add file:<download-dir>/dsh-theme-splat-ui-<version>.tgz
87
+ ```
88
+
89
+ ### リポジトリから直接インストール
90
+
91
+ ```sh
92
+ pnpm install
93
+ pnpm run build
94
+ cd <DSH_Profile_dir>
95
+ pnpm add file:<absolute-path-to-this-repo>
96
+ ```
97
+
98
+ `cordis.patch.yml` によりプロファイルのプラグイン一覧へマウントされ、`package.json` の `dsh.client.inject` が Theme / Renderer / Sidebar / Conversation の依存順序を宣言します。
99
+
100
+ ---
101
+
102
+ ## 開発と検証
103
+
104
+ 動作要件:**Node.js ≥ 22.13.0**、**pnpm 11.1.2**(主要ツールチェーン:`TypeScript 5.8.2`、`esbuild 0.25.6`、`Biome 2.6.4`、`lightningcss 1.29.2`)。詳細は [CONTRIBUTING.md](CONTRIBUTING.md) を参照してください。
105
+
106
+ ```sh
107
+ pnpm install --frozen-lockfile
108
+ pnpm run check # サイト検証 + 型チェック + ビルド + テスト + DSH 互換性チェック
109
+ pnpm run format:check # Biome フォーマット確認
110
+ pnpm run lint # Biome 静的解析
111
+ pnpm run check:fixtures -- --expect-dsh 0.2.2-rc.1
112
+ pnpm run showcase # site/showcase/generated/ の再生成
113
+ pnpm run audit # カバレッジ診断
114
+ pnpm run release 0.1.0
115
+ pnpm run install:local -- --dry-run
116
+ ```
117
+
118
+ `pnpm run demo` はデザインデモを `artifacts/demo/` に出力し、実機スクリーンショットは上書きしません。
119
+
120
+ サブパスエクスポート:
121
+
122
+ ```ts
123
+ import { SPLAT_UI_PALETTES } from 'dsh-theme-splat-ui/palette'
124
+ import { buildTokenOverrides, contrastRatio } from 'dsh-theme-splat-ui/tokens'
125
+ ```
126
+
127
+ ---
128
+
129
+ ## ドキュメント
130
+
131
+ - [デザイン言語と境界仕様 (docs/design.md)](docs/design.md):レイヤー設計、メイングリーンプリセット、コントラスト基準
132
+ - [DSH 互換性コントラクト (docs/compatibility.md)](docs/compatibility.md):公開 Slot、`data-*` / ARIA 接点とフォールバック仕様
133
+ - [検証範囲とエビデンス (docs/acceptance.md)](docs/acceptance.md):実機 DSH `0.2.2-rc.1` Web の検証結果とスクリーンショット範囲
134
+ - [変更履歴 (CHANGELOG.md)](CHANGELOG.md):バージョンごとの変更点と修正記録
135
+ - [サードパーティ表記 (THIRD_PARTY_NOTICES.md)](THIRD_PARTY_NOTICES.md):オリジナルベクター素材と非 MIT 素材の範囲
136
+
137
+ ---
138
+
139
+ ## 貢献とフィードバック
140
+
141
+ - PR の前に [CONTRIBUTING.md](CONTRIBUTING.md) を確認し、接点登録ルール・フィクスチャ検証手順に従ってください。
142
+ - 不具合報告や機能提案は [GitHub Issues](https://github.com/Shirolin/dsh-theme-splat-ui/issues) までお願いします。
143
+
144
+ ---
145
+
146
+ ## ライセンス
147
+
148
+ プロジェクトコードおよびオリジナルベクター素材は [MIT License](LICENSE) で配布されています。Nunito フォントは SIL Open Font License 1.1([licenses/Nunito-OFL.txt](licenses/Nunito-OFL.txt))の下で配布されています。その他素材の出典・MIT 対象外範囲・サードパーティ表記については [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) を参照してください。
149
+
150
+ ---
151
+
152
+ ## サポートと関連プロジェクト
153
+
154
+ このテーマが日々のコーディング環境を楽しくする助けになれば、**Star** での応援や以下のプラットフォームからのサポートをお待ちしています:
155
+
156
+ - **Afdian (愛発電)**:[https://ifdian.net/a/shirolin](https://ifdian.net/a/shirolin)
157
+ - **Ko-fi**:[https://ko-fi.com/shirolin](https://ko-fi.com/shirolin)
158
+ - **作者の関連プロジェクト**:
159
+ - [Animal Island UI](https://github.com/Shirolin/dsh-theme-animal-island-ui) —— どうぶつの森の手帳風 DeepSeek Harness テーマプラグイン。
160
+ - [PostPress(印推)](https://github.com/Shirolin/postpress) —— X(Twitter)の投稿やスレッドを紙カード風に整形するブラウザ拡張機能。
package/README.ko.md ADDED
@@ -0,0 +1,160 @@
1
+ <div align="center">
2
+
3
+ <img src="assets/icon-256.png" width="96" height="96" alt="SPLAT-STREET icon" />
4
+
5
+ # SPLAT-STREET · DSH 테마
6
+
7
+ [English](README.md) · [简体中文](README.zh.md) · [日本語](README.ja.md) · **한국어** · [쇼케이스 & 데모](https://shirolin.github.io/dsh-theme-splat-ui/) · 작성자: [Shirolin](https://github.com/Shirolin)
8
+
9
+ [![check](https://github.com/Shirolin/dsh-theme-splat-ui/actions/workflows/check.yml/badge.svg?branch=main)](https://github.com/Shirolin/dsh-theme-splat-ui/actions/workflows/check.yml)
10
+ [![pages](https://github.com/Shirolin/dsh-theme-splat-ui/actions/workflows/pages.yml/badge.svg?branch=main)](https://shirolin.github.io/dsh-theme-splat-ui/)
11
+ [![version](https://img.shields.io/badge/version-0.1.0-1edc00?labelColor=141413)](CHANGELOG.md)
12
+ [![npm](https://img.shields.io/npm/v/dsh-theme-splat-ui?color=1edc00&logo=npm&logoColor=white&labelColor=141413)](https://www.npmjs.com/package/dsh-theme-splat-ui)
13
+ [![DSH Target](https://img.shields.io/badge/DSH_Web-0.2.2--rc.1_·_Desktop_0.2.2--rc.5-ff2d8a?labelColor=141413)](docs/compatibility.md)
14
+ [![license: MIT](https://img.shields.io/badge/license-MIT-d3f510?labelColor=141413)](LICENSE)
15
+
16
+ [![Node.js](https://img.shields.io/badge/Node.js-%E2%89%A522.13.0-5FA04E?logo=nodedotjs&logoColor=white&labelColor=141413)](package.json)
17
+ [![pnpm](https://img.shields.io/badge/pnpm-11.1.2-F69220?logo=pnpm&logoColor=white&labelColor=141413)](package.json)
18
+ [![TypeScript](https://img.shields.io/badge/TypeScript-5.8.2-3178C6?logo=typescript&logoColor=white&labelColor=141413)](package.json)
19
+ [![esbuild](https://img.shields.io/badge/esbuild-0.25.6-FFCF00?logo=esbuild&logoColor=black&labelColor=141413)](package.json)
20
+ [![Biome](https://img.shields.io/badge/Biome-2.6.4-60A5FA?logo=biome&logoColor=white&labelColor=141413)](package.json)
21
+ [![ThemeRuntime](https://img.shields.io/badge/dsh--client--ui--theme-0.1.5--rc.3-1edc00?labelColor=141413)](docs/compatibility.md)
22
+
23
+ </div>
24
+
25
+ `SPLAT-STREET`는 스플래툰 2의 영역 배틀 감성을 바탕으로 만든 DeepSeek Harness(Web) 테마 플러그인입니다. 짙은 블랙 사이드바와 마젠타 '새 세션' 캡슐 버튼, 라임/크림/마젠타 3색 스트라이프 캔버스 위의 화이트 오징어 패턴·잉크 스플래시·망점 텍스처, 빈 세션 히어로 영역의 스트리트 일러스트, 스페셜 웨폰 게이지 스타일 부팅 로더, 마젠타 잉크가 흐르는 검은 테두리 컴포저 카드로 구성되어 있습니다. 다크 모드에서는 동일한 네온 잉크 컬러를 유지한 채 배경을 차콜 블랙 광장으로 전환합니다.
26
+
27
+ 온라인 쇼케이스 및 컴포넌트 도감: https://shirolin.github.io/dsh-theme-splat-ui/
28
+
29
+ > [!NOTE]
30
+ > 본 프로젝트는 비공식 팬 테마이며 Nintendo 및 DeepSeek 공식과 어떠한 제휴나 보증 관계도 없습니다. 프로젝트 오리지널 벡터 오징어/문어 아트워크, 게임 스크린샷을 참고해 생성한 단색 광장 일러스트, 그리고 SVG 장식을 사용합니다. 에셋 출처와 라이선스 범위, 서드파티 고지는 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)를 참고해 주세요. 플러그인은 DSH의 공개 ThemeRuntime 토큰과 Slot 확장 지점을 사용하며, 상위 업데이트 시에도 안전하게 폴백합니다.
31
+
32
+ ---
33
+
34
+ ## 미리보기
35
+
36
+ ![SPLAT-STREET · DSH 테마](docs/screenshots/theme-poster.webp)
37
+
38
+ > 2026년 11월 20일, 격리된 실제 DSH `0.2.2-rc.1` Web 프로필에 로컬 `.tgz` 패키지를 설치해 재검증 및 캡처한 화면입니다. 첫 릴리스의 검증 범위는 Web입니다. 대화 내용은 결정적 검증용 히스토리이며 실제 모델 호출은 수행하지 않았습니다. 자세한 범위와 증빙은 [검증 기록](docs/acceptance.md)을 확인하세요.
39
+
40
+ <details>
41
+ <summary>펼쳐 보기: 라이트 / 다크 워크스페이스, 설정, 읽기 화면 및 390px 모바일 스크린샷</summary>
42
+
43
+ | 라이트 모드 (Light) | 다크 모드 (Dark) |
44
+ | --- | --- |
45
+ | ![실제 DSH 라이트 워크스페이스](docs/screenshots/workspace-light.png) | ![실제 DSH 다크 워크스페이스](docs/screenshots/workspace-dark.png) |
46
+ | ![실제 DSH 라이트 설정](docs/screenshots/settings-light.png) | ![실제 DSH 다크 설정](docs/screenshots/settings-dark.png) |
47
+ | ![라이트 읽기 화면](docs/screenshots/runtime-reading-light.png) | ![다크 읽기 화면](docs/screenshots/runtime-reading-dark.png) |
48
+ | ![라이트 390px 모바일](docs/screenshots/runtime-reading-mobile-light.png) | ![다크 390px 모바일](docs/screenshots/runtime-reading-mobile-dark.png) |
49
+
50
+ </details>
51
+
52
+ 정적 컴포넌트 도감은 `site/showcase/index.html`(온라인 주소: https://shirolin.github.io/dsh-theme-splat-ui/showcase/ )에 있으며, 버전이 고정된 DOM 픽스처와 실제 DSH CSS로 생성되었습니다. 스페셜 게이지 부팅 화면과 엣지 케이스도 도감에서 확인할 수 있습니다.
53
+
54
+ ---
55
+
56
+ ## 설계 및 주요 기능
57
+
58
+ - **주야간 두 가지 배틀필드**: 라이트 모드는 라임/크림/마젠타 3색 스트라이프 위에 흰색 오징어 스탬프, 잉크 스플래시, 망점, 우측 하단 오징어 바코드 스티커를 배치합니다. 다크 모드는 차콜 배경 위에 어둡게 톤 다운된 스플래시와 오징어 패턴을 깔아 네온 강조색을 살립니다.
59
+ - **홈 터프 사이드바**: 짙은 블랙 배경, 투명 브랜드 헤더(마젠타 오징어 + 화이트 `SPLAT-STREET` + 라임 사선 스트라이프), 독립된 마젠타 새 세션 버튼, 잉크 꼬리가 달린 라임 선택 행(가독성을 위한 검은 글씨), 하단 해저드 스트라이프와 하드 오프셋 섀도우.
60
+ - **히어로 씬 & 스페셜 게이지 부팅 로더**: Inkopolis Square 게임 스크린샷을 참고해 생성·압축한 투명 PNG 광장 일러스트를 SVG에 삽입하고 `2` 사인, `SPLAT-STREET` 테이프, 잉크 장식(야간에는 좌우 오징어 추가)과 `>>>` 속도 블록을 배치했습니다. 부팅 카드는 상단 오징어 실을 유지하면서 진행 링을 24분할 스플래툰 스페셜 웨폰 게이지 디자인으로 구현했습니다.
61
+ - **컴포저**: 2.5px 검은 테두리와 내부 헤어라인, 망점, 하드 섀도우, 우상단 마젠타 잉크 드립. 첨부 버튼은 종이 디스크, 전송 버튼은 마젠타 리플이 들어간 라임 원형 버튼입니다.
62
+ - **외관 설정**: `설정 → 플러그인 → 墨街外观` 탭에서 페이퍼 20% / 밸런스 50% / 터프 100% 프리셋, `0%–100%` 캔버스 잉크 농도 슬라이더(`--splat-canvas-veil` 매핑), 3종 메인 그린 프리셋(기본 오피셜 `#1edc00` / 네온 `#9ae528` / 라임 `#d3f510`), diff 구문(네온/네이티브), 장식·망점·폰트 토글 및 초기화를 제공합니다. 설정은 클라이언트 `localStorage`에 저장됩니다.
63
+ - **빌드 타임 에셋 내장**: Nunito Latin WOFF2(400–900) 및 테마의 SVG·PNG 에셋은 빌드 시 `lib/client.js`에 내장되므로 런타임에 외부 다운로드가 필요하지 않습니다.
64
+
65
+ ---
66
+
67
+ ## 설치
68
+
69
+ 하나의 프로필에는 테마 플러그인을 하나만 활성화하는 것을 권장합니다.
70
+
71
+ ### npm으로 설치(권장)
72
+
73
+ ```sh
74
+ cd <DSH_Profile_dir>
75
+ pnpm add dsh-theme-splat-ui
76
+ ```
77
+
78
+ 설치 후 DSH 서비스(또는 데스크톱 앱)를 완전히 재시작하고 페이지를 새로고침하세요.
79
+
80
+ ### GitHub Release / 오프라인 `.tgz`
81
+
82
+ [GitHub Releases](https://github.com/Shirolin/dsh-theme-splat-ui/releases)에서 `dsh-theme-splat-ui-<version>.tgz`를 내려받거나(또는 저장소에서 `pnpm run release 0.1.0` 실행) 설치합니다:
83
+
84
+ ```sh
85
+ cd <DSH_Profile_dir>
86
+ pnpm add file:<download-dir>/dsh-theme-splat-ui-<version>.tgz
87
+ ```
88
+
89
+ ### 저장소에서 직접 설치
90
+
91
+ ```sh
92
+ pnpm install
93
+ pnpm run build
94
+ cd <DSH_Profile_dir>
95
+ pnpm add file:<absolute-path-to-this-repo>
96
+ ```
97
+
98
+ `cordis.patch.yml`이 프로필의 플러그인 목록에 패키지를 마운트하며, `package.json`의 `dsh.client.inject`가 Theme / Renderer / Sidebar / Conversation 의존 순서를 선언합니다.
99
+
100
+ ---
101
+
102
+ ## 개발 및 검증
103
+
104
+ 요구 환경: **Node.js ≥ 22.13.0**, **pnpm 11.1.2** (주요 툴체인: `TypeScript 5.8.2`, `esbuild 0.25.6`, `Biome 2.6.4`, `lightningcss 1.29.2`). 자세한 내용은 [CONTRIBUTING.md](CONTRIBUTING.md)를 참고하세요.
105
+
106
+ ```sh
107
+ pnpm install --frozen-lockfile
108
+ pnpm run check # 사이트 검사 + 타입 체크 + 빌드 + 테스트 + DSH 호환성 검사
109
+ pnpm run format:check # Biome 포맷 확인
110
+ pnpm run lint # Biome 정적 분석
111
+ pnpm run check:fixtures -- --expect-dsh 0.2.2-rc.1
112
+ pnpm run showcase # site/showcase/generated/ 재생성
113
+ pnpm run audit # 커버리지 진단
114
+ pnpm run release 0.1.0
115
+ pnpm run install:local -- --dry-run
116
+ ```
117
+
118
+ `pnpm run demo`는 디자인 데모를 `artifacts/demo/`에 출력하며, 실제 호스트 문서 스크린샷을 덮어쓰지 않습니다.
119
+
120
+ 서브패스 내보내기:
121
+
122
+ ```ts
123
+ import { SPLAT_UI_PALETTES } from 'dsh-theme-splat-ui/palette'
124
+ import { buildTokenOverrides, contrastRatio } from 'dsh-theme-splat-ui/tokens'
125
+ ```
126
+
127
+ ---
128
+
129
+ ## 문서
130
+
131
+ - [디자인 언어 및 스타일 경계 (docs/design.md)](docs/design.md): 레이어 구조, 메인 그린 프리셋, 대비 기준
132
+ - [DSH 호환성 규약 (docs/compatibility.md)](docs/compatibility.md): 공개 Slot, `data-*` / ARIA 접점 및 폴백 매트릭스
133
+ - [검증 범위 및 증빙 (docs/acceptance.md)](docs/acceptance.md): 실제 DSH `0.2.2-rc.1` Web 검증 결과 및 스크린샷 범위
134
+ - [변경 로그 (CHANGELOG.md)](CHANGELOG.md): 버전별 변경 및 수정 이력
135
+ - [서드파티 고지 (THIRD_PARTY_NOTICES.md)](THIRD_PARTY_NOTICES.md): 오리지널 벡터 및 비-MIT 에셋 출처
136
+
137
+ ---
138
+
139
+ ## 기여 및 피드백
140
+
141
+ - PR 전 [CONTRIBUTING.md](CONTRIBUTING.md)를 읽고 접점 등록 규칙과 픽스처 검증 절차를 확인해 주세요.
142
+ - 버그 리포트나 제안은 [GitHub Issues](https://github.com/Shirolin/dsh-theme-splat-ui/issues)로 전달해 주세요.
143
+
144
+ ---
145
+
146
+ ## 라이선스
147
+
148
+ 프로젝트 코드와 오리지널 벡터 에셋은 [MIT License](LICENSE)로 배포되며, Nunito 폰트는 SIL Open Font License 1.1([licenses/Nunito-OFL.txt](licenses/Nunito-OFL.txt))에 따라 배포됩니다. 기타 에셋 출처, MIT 제외 범위 및 서드파티 고지는 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)를 확인하세요.
149
+
150
+ ---
151
+
152
+ ## 후원 및 관련 프로젝트
153
+
154
+ 이 테마가 작업 환경을 더 즐겁게 만들어 준다면 저장소에 **Star**를 눌러주시거나 아래 채널을 통해 후원으로 응원해 주세요:
155
+
156
+ - **Afdian (爱发电)**: [https://ifdian.net/a/shirolin](https://ifdian.net/a/shirolin)
157
+ - **Ko-fi**: [https://ko-fi.com/shirolin](https://ko-fi.com/shirolin)
158
+ - **작성자의 다른 프로젝트**:
159
+ - [Animal Island UI](https://github.com/Shirolin/dsh-theme-animal-island-ui) — 동물의 숲 감성 다이어리 스타일의 DeepSeek Harness 테마 플러그인.
160
+ - [PostPress(印推)](https://github.com/Shirolin/postpress) — X(Twitter) 포스트와 스레드를 깔끔한 종이 카드 스타일로 변환하는 브라우저 확장 프로그램.
package/README.md CHANGED
@@ -1,3 +1,160 @@
1
- # Temporary Holding Version
1
+ <div align="center">
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
+ <img src="assets/icon-256.png" width="96" height="96" alt="SPLAT-STREET icon" />
4
+
5
+ # SPLAT-STREET · Theme for DSH
6
+
7
+ **English** · [简体中文](README.zh.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Showcase & Live Demo](https://shirolin.github.io/dsh-theme-splat-ui/) · Author: [Shirolin](https://github.com/Shirolin)
8
+
9
+ [![check](https://github.com/Shirolin/dsh-theme-splat-ui/actions/workflows/check.yml/badge.svg?branch=main)](https://github.com/Shirolin/dsh-theme-splat-ui/actions/workflows/check.yml)
10
+ [![pages](https://github.com/Shirolin/dsh-theme-splat-ui/actions/workflows/pages.yml/badge.svg?branch=main)](https://shirolin.github.io/dsh-theme-splat-ui/)
11
+ [![version](https://img.shields.io/badge/version-0.1.0-1edc00?labelColor=141413)](CHANGELOG.md)
12
+ [![npm](https://img.shields.io/npm/v/dsh-theme-splat-ui?color=1edc00&logo=npm&logoColor=white&labelColor=141413)](https://www.npmjs.com/package/dsh-theme-splat-ui)
13
+ [![DSH Target](https://img.shields.io/badge/DSH_Web-0.2.2--rc.1_·_Desktop_0.2.2--rc.5-ff2d8a?labelColor=141413)](docs/compatibility.md)
14
+ [![license: MIT](https://img.shields.io/badge/license-MIT-d3f510?labelColor=141413)](LICENSE)
15
+
16
+ [![Node.js](https://img.shields.io/badge/Node.js-%E2%89%A522.13.0-5FA04E?logo=nodedotjs&logoColor=white&labelColor=141413)](package.json)
17
+ [![pnpm](https://img.shields.io/badge/pnpm-11.1.2-F69220?logo=pnpm&logoColor=white&labelColor=141413)](package.json)
18
+ [![TypeScript](https://img.shields.io/badge/TypeScript-5.8.2-3178C6?logo=typescript&logoColor=white&labelColor=141413)](package.json)
19
+ [![esbuild](https://img.shields.io/badge/esbuild-0.25.6-FFCF00?logo=esbuild&logoColor=black&labelColor=141413)](package.json)
20
+ [![Biome](https://img.shields.io/badge/Biome-2.6.4-60A5FA?logo=biome&logoColor=white&labelColor=141413)](package.json)
21
+ [![ThemeRuntime](https://img.shields.io/badge/dsh--client--ui--theme-0.1.5--rc.3-1edc00?labelColor=141413)](docs/compatibility.md)
22
+
23
+ </div>
24
+
25
+ `SPLAT-STREET` is a DeepSeek Harness (Web) theme plugin built on Splatoon 2's turf-war language: a near-black sidebar with a transparent masthead and a magenta new-session pill, a tri-band lime/cream/pink canvas with white squid stamps, magenta/lime splashes and halftone, a free-floating ink-battle scene for the empty-session hero, a Special Weapon Gauge boot loader, and a black-rimmed composer with a magenta ink drip. Night mode keeps the same neon ink on a charcoal plaza.
26
+
27
+ Live showcase & promo site: https://shirolin.github.io/dsh-theme-splat-ui/
28
+
29
+ > [!NOTE]
30
+ > Unofficial fan theme, not affiliated with or endorsed by Nintendo or DeepSeek. The theme uses original project vector squid/octopus artwork, a monochrome plaza illustration generated using an Inkopolis Square game screenshot as a reference, and SVG decorations. See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) for asset sources, license boundaries, and third-party notices. The plugin consumes DSH's public ThemeRuntime tokens and slots and falls back safely across upstream updates.
31
+
32
+ ---
33
+
34
+ ## Preview
35
+
36
+ ![SPLAT-STREET · DSH Theme](docs/screenshots/theme-poster.webp)
37
+
38
+ > Revalidated and captured on November 20, 2026 in real DSH `0.2.2-rc.1` Web after installing the local tarball into an isolated profile. The first release is validated for Web. The conversation is deterministic acceptance history; no model was called. See [acceptance scope and evidence](docs/acceptance.md).
39
+
40
+ <details>
41
+ <summary>Expand: Light / Dark workspace, settings, reading, and 390px mobile screenshots (real DSH DOM)</summary>
42
+
43
+ | Light Mode | Dark Mode |
44
+ | --- | --- |
45
+ | ![Real light workspace](docs/screenshots/workspace-light.png) | ![Real dark workspace](docs/screenshots/workspace-dark.png) |
46
+ | ![Real light settings](docs/screenshots/settings-light.png) | ![Real dark settings](docs/screenshots/settings-dark.png) |
47
+ | ![Light reading surface](docs/screenshots/runtime-reading-light.png) | ![Dark reading surface](docs/screenshots/runtime-reading-dark.png) |
48
+ | ![Light 390px mobile](docs/screenshots/runtime-reading-mobile-light.png) | ![Dark 390px mobile](docs/screenshots/runtime-reading-mobile-dark.png) |
49
+
50
+ </details>
51
+
52
+ The static component catalogue (`site/showcase/index.html`, live at https://shirolin.github.io/dsh-theme-splat-ui/showcase/) is built from version-pinned DOM fixtures and real DSH CSS. Boot screens (with the Special Weapon Gauge loader) and edge cases can be inspected there interactively.
53
+
54
+ ---
55
+
56
+ ## Design & Architecture
57
+
58
+ - **Two battlefields**: a tri-band lime/cream/pink field with white squid stamps, magenta/lime splashes, halftone and a bottom-right squid-barcode sticker by day; a charcoal canvas with the same splashes and squids dimmed at night.
59
+ - **Sidebar as home turf**: near-black surface, transparent brand masthead (magenta squid + white `SPLAT-STREET` + lime diagonal stripes), a separate magenta new-session pill, lime selected row with a splat tail and black type for contrast, a bottom hazard stripe, and hard offset shadows.
60
+ - **Hero & Special Gauge boot loader**: an SVG Hero composition embedding a compressed transparent PNG plaza illustration derived from an Inkopolis Square screenshot reference, layered with a `2` sign, `SPLAT-STREET` tape, and ink decorations (flanking squids at night), paired with a white outlined headline and `>>>` speed block; the boot card keeps the top squid seal and styles the live progress ring as a 24-segment Splatoon Special Weapon Gauge.
61
+ - **Composer**: 2.5px black rim with an inner hairline, halftone, hard shadow, magenta drip; a paper attach disc and a lime send disc with a magenta ripple.
62
+ - **Appearance tab**: `Settings → Plugins → Ink Street appearance` with Paper 20% / Balanced 50% / Turf 100% presets, a `0%–100%` positive canvas ink-intensity slider (mapped to `--splat-canvas-veil`), three ink green presets (default Official `#1edc00` / Neon `#9ae528` / Lime `#d3f510`), diff syntax (neon/native), décor, grain and font toggles, and reset. Preferences are stored in the client's `localStorage`.
63
+ - **Build-time assets**: Nunito Latin WOFF2 (400–900) and the theme's SVG and PNG assets are embedded in `lib/client.js`, requiring no external network downloads at runtime.
64
+
65
+ ---
66
+
67
+ ## Install
68
+
69
+ Keep only one theme plugin enabled per profile.
70
+
71
+ ### From npm (recommended)
72
+
73
+ ```sh
74
+ cd <DSH_Profile_dir>
75
+ pnpm add dsh-theme-splat-ui
76
+ ```
77
+
78
+ Restart the DSH service completely (or restart DeepSeek Harness Desktop) and reload the page.
79
+
80
+ ### From GitHub Release / Offline `.tgz`
81
+
82
+ Download `dsh-theme-splat-ui-<version>.tgz` from [GitHub Releases](https://github.com/Shirolin/dsh-theme-splat-ui/releases) (or build locally via `pnpm run release 0.1.0`):
83
+
84
+ ```sh
85
+ cd <DSH_Profile_dir>
86
+ pnpm add file:<download-dir>/dsh-theme-splat-ui-<version>.tgz
87
+ ```
88
+
89
+ ### From this repository
90
+
91
+ ```sh
92
+ pnpm install
93
+ pnpm run build
94
+ cd <DSH_Profile_dir>
95
+ pnpm add file:<absolute-path-to-this-repo>
96
+ ```
97
+
98
+ `cordis.patch.yml` mounts the package into the profile's plugin list; `dsh.client.inject` in `package.json` declares dependency ordering for Theme / Renderer / Sidebar / Conversation.
99
+
100
+ ---
101
+
102
+ ## Development
103
+
104
+ Requires **Node.js ≥ 22.13.0** and **pnpm 11.1.2** (toolchain pinned in `package.json`: **TypeScript 5.8.2**, **esbuild 0.25.6**, **Biome 2.6.4**, **lightningcss 1.29.2**).
105
+
106
+ ```sh
107
+ pnpm install --frozen-lockfile
108
+ pnpm run check # site check + typecheck + build + tests + DSH compat check
109
+ pnpm run format:check # Biome formatting check
110
+ pnpm run lint # Biome static lint
111
+ pnpm run check:fixtures -- --expect-dsh 0.2.2-rc.1
112
+ pnpm run showcase # Rebuild site/showcase/generated/
113
+ pnpm run audit # Coverage diagnostics
114
+ pnpm run release 0.1.0
115
+ pnpm run install:local -- --dry-run
116
+ ```
117
+
118
+ `pnpm run demo` writes design demos to `artifacts/demo/` without overwriting real-host screenshots.
119
+
120
+ Subpath exports:
121
+
122
+ ```ts
123
+ import { SPLAT_UI_PALETTES } from 'dsh-theme-splat-ui/palette'
124
+ import { buildTokenOverrides, contrastRatio } from 'dsh-theme-splat-ui/tokens'
125
+ ```
126
+
127
+ ---
128
+
129
+ ## Documentation
130
+
131
+ - [Design Language & Palette Boundaries (docs/design.md)](docs/design.md): Layering, ink green presets, contrast gates, and component anatomy
132
+ - [DSH Compatibility Contract (docs/compatibility.md)](docs/compatibility.md): Public slots, `data-*` / ARIA seams, and fallback matrix
133
+ - [Acceptance Scope & Evidence (docs/acceptance.md)](docs/acceptance.md): Real DSH `0.2.2-rc.1` Web validation results and screenshot scope
134
+ - [Changelog (CHANGELOG.md)](CHANGELOG.md): Release and iteration notes
135
+ - [Third-Party Notices (THIRD_PARTY_NOTICES.md)](THIRD_PARTY_NOTICES.md): Original vector asset provenance and non-MIT boundaries
136
+
137
+ ---
138
+
139
+ ## Contributing & Security
140
+
141
+ - Read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request for seam registration rules, fixture commands, and release verification workflows.
142
+ - Please report bugs or regressions via [GitHub Issues](https://github.com/Shirolin/dsh-theme-splat-ui/issues).
143
+
144
+ ---
145
+
146
+ ## License & Attribution
147
+
148
+ Project source code and original vector artwork are licensed under the [MIT License](LICENSE). Bundled Nunito fonts are licensed under the [SIL Open Font License 1.1](licenses/Nunito-OFL.txt). See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) for non-MIT boundaries and asset attribution.
149
+
150
+ ---
151
+
152
+ ## Support & Related Projects
153
+
154
+ If this theme brightens up your coding sessions, consider starring the repository or supporting maintenance:
155
+
156
+ - **Afdian (爱发电)**: [https://ifdian.net/a/shirolin](https://ifdian.net/a/shirolin)
157
+ - **Ko-fi**: [https://ko-fi.com/shirolin](https://ko-fi.com/shirolin)
158
+ - **More from the author**:
159
+ - [Animal Island UI](https://github.com/Shirolin/dsh-theme-animal-island-ui) — An Animal Crossing–inspired stationery theme plugin for DeepSeek Harness.
160
+ - [PostPress(印推)](https://github.com/Shirolin/postpress) — A browser extension that formats X (Twitter) posts and threads into clean paper-styled cards.