@mousebomb/paseo-gilded-fortune 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.
- package/LICENSE +21 -0
- package/OVERVIEW.md +7 -0
- package/README.md +55 -2
- package/README.zh.md +65 -0
- package/index.client.ts +40 -0
- package/package.json +44 -4
- package/paseo-plugin.json +6 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 mousebomb
|
|
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/OVERVIEW.md
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
Gilded Fortune adds two themes to Paseo, Gilded Fortune and Gilded Fortune Light. One plugin provides both, so you can switch between a near-black warm brown interface and a parchment one under Settings → Appearance → Theme.
|
|
2
|
+
|
|
3
|
+
The themes use the eight color values Paseo exposes to plugins: background, foreground, raised, control, border, accent, mutedForeground, and ring. Paseo derives the remaining interface colors from them. The plugin does not modify Paseo's own files, so app updates keep the themes in place.
|
|
4
|
+
|
|
5
|
+
Turn the plugin on under Settings → Plugins, then select either theme under Settings → Appearance → Theme. It needs no account, network access, or extra configuration, and it reads or sends no data.
|
|
6
|
+
|
|
7
|
+
The plugin can set only those eight values. Other surfaces and colors that Paseo derives internally, including code syntax highlighting, are not controlled by this palette. The dark accent is a muted gilded gold rather than a bright one so it stays comfortable for long sessions, and the light accent is deliberately deep enough to keep body-text contrast on parchment.
|
package/README.md
CHANGED
|
@@ -1,3 +1,56 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Paseo Gilded Fortune themes
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
English | [中文](README.zh.md)
|
|
4
|
+
|
|
5
|
+
Two themes for [Paseo](https://github.com/getpaseo/paseo): **Gilded Fortune** (dark) and **Gilded Fortune Light** (parchment). Near-black warm brown surfaces, a muted gilded accent, cream body text — both ends built from one palette.
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
## Install
|
|
10
|
+
|
|
11
|
+
Requires Paseo 0.8 or newer. Pick one:
|
|
12
|
+
|
|
13
|
+
### npm
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
paseo plugin add npm:@mousebomb/paseo-gilded-fortune
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
### Git
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
paseo plugin add github:mousebomb/paseo-gilded-fortune
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
### From source
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
git clone https://github.com/mousebomb/paseo-gilded-fortune.git
|
|
29
|
+
cd paseo-gilded-fortune
|
|
30
|
+
npm install
|
|
31
|
+
npm run typecheck
|
|
32
|
+
npm test
|
|
33
|
+
paseo plugin add .
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
Then turn it on under **Settings → Plugins**, and pick **Gilded Fortune** or **Gilded Fortune Light** under **Settings → Appearance → Theme**.
|
|
37
|
+
|
|
38
|
+
Reload after editing:
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
paseo plugin reload gilded-fortune
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
## Design notes
|
|
45
|
+
|
|
46
|
+
- The plugin contributes only the eight colors Paseo exposes to themes; everything else is derived by the app, so updates never overwrite it.
|
|
47
|
+
- The dark accent is `#c8a63f` (55% saturation) rather than the source page's `#d4af37` (65%) — same hue and lightness, gentler over long sessions.
|
|
48
|
+
- The light accent has to sit at `#7a5f1a`; brighter golds drop below the 4.5:1 body-text threshold on parchment.
|
|
49
|
+
- `border` also paints the user message bubble, so it is one step deeper than the card surface (`#292517`), giving 13.4:1 against body text.
|
|
50
|
+
- The light `ring` is `#8f7429`: Paseo uses that token for both the selected sidebar row and faint text, so a mid tone keeps both usable. See `AGENTS.md`.
|
|
51
|
+
|
|
52
|
+
Full values and contrast ratios: [`design/palette.svg`](./design/palette.svg), generated by `design/gen_palette_svg.py`.
|
|
53
|
+
|
|
54
|
+
## License
|
|
55
|
+
|
|
56
|
+
MIT. The palette is derived from the author's own five-element "metal" (补金) page; no third-party palette license applies.
|
package/README.zh.md
ADDED
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
# Paseo Gilded Fortune 主题插件
|
|
2
|
+
|
|
3
|
+
[English](README.md) | 中文
|
|
4
|
+
|
|
5
|
+
为 [Paseo](https://github.com/getpaseo/paseo) 提供的 **金运亨通（Gilded Fortune）** 明暗双主题：近黑褐色底、压一档的鎏金强调色、奶油白正文，配一套同源推导的羊皮纸亮色版。
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
## 安装
|
|
10
|
+
|
|
11
|
+
需要 Paseo 0.8 或更高版本。以下三种方式**任选其一**：
|
|
12
|
+
|
|
13
|
+
### npm
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
paseo plugin add npm:@mousebomb/paseo-gilded-fortune
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
### Git
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
paseo plugin add github:mousebomb/paseo-gilded-fortune
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
### 源码安装（开发用）
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
git clone https://github.com/mousebomb/paseo-gilded-fortune.git
|
|
29
|
+
cd paseo-gilded-fortune
|
|
30
|
+
npm install
|
|
31
|
+
npm run typecheck
|
|
32
|
+
npm test
|
|
33
|
+
paseo plugin add .
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
安装后启用插件并选择主题：
|
|
37
|
+
|
|
38
|
+
1. **Settings → Plugins** → 打开 **Enable plugins**
|
|
39
|
+
2. **Settings → Appearance → Theme** → 选择 **Gilded Fortune** 或 **Gilded Fortune Light**
|
|
40
|
+
|
|
41
|
+
修改代码后热重载：
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
paseo plugin reload gilded-fortune
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
如果 `paseo` 命令不在 PATH：
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
/Applications/Paseo.app/Contents/Resources/bin/paseo plugin add .
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
## 设计要点
|
|
54
|
+
|
|
55
|
+
- 插件只贡献 Paseo 开放给主题的 8 个色值，界面其余颜色由 Paseo 自行推导，升级不会被覆盖
|
|
56
|
+
- 暗端金色用 `#c8a63f`（饱和度 55%），不是原页面的 `#d4af37`（65%）：同样的色相与明度，久看更稳
|
|
57
|
+
- 亮端强调金必须压到 `#7a5f1a`，否则与羊皮纸底对比不足 4.5:1
|
|
58
|
+
- `border` 字段同时承担用户气泡背景，所以取的是比卡片再深一档的 `#292517`，正文压上去 13.4:1
|
|
59
|
+
- 亮端 `ring` 取 `#8f7429`：它同时被 Paseo 用作选中行底色与弱化文字，取中间调让两个用途都不至于不可读（详见 `AGENTS.md`）
|
|
60
|
+
|
|
61
|
+
完整色值与对比度见 [`design/palette.svg`](./design/palette.svg)，生成脚本为 `design/gen_palette_svg.py`。
|
|
62
|
+
|
|
63
|
+
## License
|
|
64
|
+
|
|
65
|
+
MIT。主题配色由作者自建的五行「补金」运势页推导，无第三方色板版权依赖。
|
package/index.client.ts
ADDED
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import type { PluginClientContext } from "@getpaseo/plugin/client";
|
|
2
|
+
|
|
3
|
+
// 金运亨通（Gilded Fortune）：近黑褐底 + 压一档的鎏金强调色。
|
|
4
|
+
// 色板源自自建的五行「补金」运势页，暗端取其原色但把金色饱和度从 65% 压到 55%，
|
|
5
|
+
// 以便长时间编写/阅读；亮端由同一套色板推导，强调金必须压深到 #7a5f1a 才满足正文对比要求。
|
|
6
|
+
export default function contribute(client: PluginClientContext) {
|
|
7
|
+
client.addTheme({
|
|
8
|
+
id: "dark",
|
|
9
|
+
name: "Gilded Fortune",
|
|
10
|
+
appearance: "dark",
|
|
11
|
+
colors: {
|
|
12
|
+
background: "#17150f", // 页面背景（近黑褐）
|
|
13
|
+
foreground: "#f5efe0", // 正文（奶油白），对对比 15.9:1
|
|
14
|
+
raised: "#1e1b13", // 次级凸起层：助手气泡、卡片
|
|
15
|
+
control: "#221f15", // 控件背景：标题栏、输入框
|
|
16
|
+
border: "#292517", // surface3：用户气泡背景 + 卡片描边，正文压上去 13.4:1
|
|
17
|
+
accent: "#c8a63f", // 强调色：压一档的鎏金（原味 #d4af37 为 65% 饱和度）
|
|
18
|
+
mutedForeground: "#c9bfa5", // 次要文字，9.98:1
|
|
19
|
+
ring: "#d9c06b", // surface4：焦点环、滚动条、时间戳
|
|
20
|
+
},
|
|
21
|
+
});
|
|
22
|
+
|
|
23
|
+
client.addTheme({
|
|
24
|
+
id: "light",
|
|
25
|
+
name: "Gilded Fortune Light",
|
|
26
|
+
appearance: "light",
|
|
27
|
+
colors: {
|
|
28
|
+
background: "#f2ebda", // 羊皮纸底
|
|
29
|
+
foreground: "#1b1813", // 正文，14.9:1
|
|
30
|
+
raised: "#f8f3e6", // 更亮一层的卡片
|
|
31
|
+
control: "#ece4d0", // 控件/侧栏（比底略深）
|
|
32
|
+
border: "#e0d5bc", // 用户气泡背景，正文压上去 12.2:1
|
|
33
|
+
accent: "#7a5f1a", // 强调金：深金，5.08:1（#8a6d1f 仅 4.12，不达标）
|
|
34
|
+
mutedForeground: "#5f5745", // 次要文字，6.02:1
|
|
35
|
+
ring: "#8f7429", // 与 accent 同色相、深两档，充当选中行底色与弱化文字
|
|
36
|
+
},
|
|
37
|
+
});
|
|
38
|
+
|
|
39
|
+
return () => {};
|
|
40
|
+
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,46 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mousebomb/paseo-gilded-fortune",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"description": "
|
|
6
|
-
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"type": "module",
|
|
5
|
+
"description": "Gilded Fortune (金运亨通) dark and light themes for Paseo.",
|
|
6
|
+
"license": "MIT",
|
|
7
|
+
"repository": {
|
|
8
|
+
"type": "git",
|
|
9
|
+
"url": "git+https://github.com/mousebomb/paseo-gilded-fortune.git"
|
|
10
|
+
},
|
|
11
|
+
"homepage": "https://github.com/mousebomb/paseo-gilded-fortune#readme",
|
|
12
|
+
"bugs": {
|
|
13
|
+
"url": "https://github.com/mousebomb/paseo-gilded-fortune/issues"
|
|
14
|
+
},
|
|
15
|
+
"publishConfig": {
|
|
16
|
+
"access": "public"
|
|
17
|
+
},
|
|
18
|
+
"keywords": [
|
|
19
|
+
"paseo",
|
|
20
|
+
"paseo-plugin",
|
|
21
|
+
"theme",
|
|
22
|
+
"gilded-fortune",
|
|
23
|
+
"dark-theme",
|
|
24
|
+
"color-scheme"
|
|
25
|
+
],
|
|
26
|
+
"files": [
|
|
27
|
+
"index.client.ts",
|
|
28
|
+
"paseo-plugin.json",
|
|
29
|
+
"OVERVIEW.md",
|
|
30
|
+
"README.md",
|
|
31
|
+
"README.zh.md",
|
|
32
|
+
"LICENSE"
|
|
33
|
+
],
|
|
34
|
+
"scripts": {
|
|
35
|
+
"typecheck": "tsc --noEmit",
|
|
36
|
+
"test": "node --test test/*.test.ts"
|
|
37
|
+
},
|
|
38
|
+
"engines": {
|
|
39
|
+
"node": ">=22.18.0"
|
|
40
|
+
},
|
|
41
|
+
"devDependencies": {
|
|
42
|
+
"@getpaseo/plugin": "^0.13.2",
|
|
43
|
+
"@types/node": "^24.19.2",
|
|
44
|
+
"typescript": "^5.9.3"
|
|
45
|
+
}
|
|
46
|
+
}
|