@linkdesk/plugin-sdk 0.1.99 → 0.1.101

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.
@@ -35,6 +35,12 @@
35
35
  --sent-echo: #0078D4;
36
36
  --status-connected: #4EC9B0;
37
37
  --status-disconnected: #6A6A6A;
38
+ /* 内容面可读性(2026-11-22 壳主题 token)+墨色——dev-host 无引擎,直接吃兜底面;
39
+ dev-host.test.ts 生成式对账要求壳有它必在场,且页面自身 var() 必须都在兜底集内 */
40
+ --surface-reading: var(--bg-card);
41
+ --surface-reading-strong: var(--bg-card);
42
+ --surface-media-scrim: var(--bg-window);
43
+ --surface-ink: var(--text-primary);
38
44
  --scrollbar-thumb: rgba(255, 255, 255, 0.15);
39
45
  --scrollbar-thumb-hover: rgba(255, 255, 255, 0.25);
40
46
  --tab-hover-bg: #353535;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@linkdesk/plugin-sdk",
3
- "version": "0.1.99",
3
+ "version": "0.1.101",
4
4
  "description": "@linkdesk/plugin-sdk——LinkDesk 插件作者 SDK(对标 @types/vscode):window.linkdesk.* 类型 + 一键 build(.linkdesk-plugin) + dev 宿主 + plugin.json 验证 + eslint 门禁(E6#54d)。作者 npm i 后零壳源码依赖。",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -1,109 +1,110 @@
1
- {
2
- "$schema": "http://json-schema.org/draft-07/schema#",
3
- "$id": "https://linkdesk.local/schemas/theme.schema.json",
4
- "title": "LinkDesk theme definition (ThemeRecipe)",
5
- "description": "Contract for the theme JSON file referenced by contributes.themes (modeled on plugin.schema.json; format errors are rejected on the spot). Mirrors the ThemeRecipe type in src/core/types/theme.ts; parsing semantics live in parseThemeRecipe. The new format requires colorways[] (the engine reads only the new format); appearance domains are sparse, and an omitted domain inherits the shell's :root default. Validated by scripts/check-theme-schema.mjs (part of the npm run check chain).",
6
- "type": "object",
7
- "required": ["id", "name", "type", "colorways"],
8
- "additionalProperties": false,
9
- "properties": {
10
- "$schema": {
11
- "type": "string",
12
- "description": "Editor IntelliSense reference (optional) — relative path ../../../public/schemas/theme.schema.json"
13
- },
14
- "id": {
15
- "type": "string",
16
- "description": "Theme id — globally unique (stored in app.theme; convention: the plugin's short name)"
17
- },
18
- "name": {
19
- "type": "string",
20
- "description": "Theme display name — shown in the theme picker and the window title"
21
- },
22
- "type": {
23
- "type": "string",
24
- "enum": ["light", "dark"],
25
- "description": "Base light/dark mode — dark is the :root base, light is the data-theme override layer"
26
- },
27
- "appearance": {
28
- "type": "object",
29
- "description": "Appearance domains (single value, sparse) — an omitted domain inherits the shell's :root default",
30
- "additionalProperties": false,
31
- "properties": {
32
- "radius": {
33
- "type": "object",
34
- "description": "Eight radius steps (key = step name, value = px; 999 = full pill)",
35
- "additionalProperties": false,
36
- "properties": {
37
- "xs": { "type": "number" },
38
- "sm": { "type": "number" },
39
- "md": { "type": "number" },
40
- "lg": { "type": "number" },
41
- "xl": { "type": "number" },
42
- "2xl": { "type": "number" },
43
- "pill": { "type": "number" },
44
- "full": { "type": "number" }
45
- }
46
- },
47
- "glass": {
48
- "type": "object",
49
- "description": "Glass and floating panel material (ThemeSurface) — default: no glass, no floating",
50
- "additionalProperties": false,
51
- "properties": {
52
- "type": { "type": "string", "enum": ["glass"], "description": "Glass recipe — default: no glass" },
53
- "blur": { "type": "number", "description": "Backdrop blur in px — 0 = off" },
54
- "saturate": { "type": "number", "description": "Saturation boost — 1 = off" },
55
- "tint": { "type": "string", "description": "Overlay tint color for the glass surface" },
56
- "opacity": { "type": "number", "description": "Glass surface opacity (compositing baseline) — 1 = opaque / 0 = fully transparent, background shows through" },
57
- "specular": { "type": "number", "description": "Liquid glass top highlight strength — 0 = off" },
58
- "specularColor": { "type": "string", "description": "Base color of the top highlight — default: white; alpha still comes from specular" },
59
- "morph": { "type": "number", "description": "Morph transition in ms — 0 = off" },
60
- "radius": { "type": "number", "description": "Floating corner radius in px — 0 = square corners flush to the edge" },
61
- "shadow": { "type": "boolean", "description": "Drop shadow lift — true = floating shadow (maps to --shadow-lift)" },
62
- "texture": { "type": "string", "description": "Path to a tileable texture image asset (paper texture)" },
63
- "textureOpacity": { "type": "number", "description": "Texture opacity — 1 = opaque" }
64
- }
65
- },
66
- "font": {
67
- "type": "object",
68
- "description": "Font domain — a system font family name or a relative asset path (asset → @font-face → family name)",
69
- "additionalProperties": false,
70
- "properties": {
71
- "ui": { "type": "string", "description": "UI font (--font-ui)" },
72
- "mono": { "type": "string", "description": "Monospace font (--font-mono)" }
73
- }
74
- },
75
- "background": {
76
- "type": "object",
77
- "description": "Image background domain (panorama = full window / zones = sliced)",
78
- "additionalProperties": false,
79
- "properties": {
80
- "image": { "type": "string", "description": "Image path — the author provides a resolvable URL; the engine wraps it in url() when writing --bg-image" },
81
- "opacity": { "type": "number", "description": "Image layer opacity — 1 = opaque" },
82
- "mask": { "type": "number", "description": "Image mask darkness (0-1) — 0 = no mask" },
83
- "maskColor": { "type": "string", "description": "Mask base color — default: black; alpha still comes from mask" },
84
- "mode": { "type": "string", "enum": ["panorama", "zones"], "description": "Slice mode — panorama (default) / zones (the same image sliced continuously)" }
85
- }
86
- }
87
- }
88
- },
89
- "colorways": {
90
- "type": "array",
91
- "description": "Colorway list (multi-value color domain, at least one entry)",
92
- "minItems": 1,
93
- "items": {
94
- "type": "object",
95
- "required": ["id", "name"],
96
- "additionalProperties": false,
97
- "properties": {
98
- "id": { "type": "string", "description": "Colorway id — globally unique (stored in the dynamic app.themeColor enum)" },
99
- "name": { "type": "string", "description": "Colorway display name" },
100
- "colors": {
101
- "type": "object",
102
- "description": "Color token set (key = contract token name without the -- prefix; value = a color string)",
103
- "additionalProperties": { "type": "string" }
104
- }
105
- }
106
- }
107
- }
108
- }
109
- }
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$id": "https://linkdesk.local/schemas/theme.schema.json",
4
+ "title": "LinkDesk theme definition (ThemeRecipe)",
5
+ "description": "Contract for the theme JSON file referenced by contributes.themes (modeled on plugin.schema.json; format errors are rejected on the spot). Mirrors the ThemeRecipe type in src/core/types/theme.ts; parsing semantics live in parseThemeRecipe. The new format requires colorways[] (the engine reads only the new format); appearance domains are sparse, and an omitted domain inherits the shell's :root default. Validated by scripts/check-theme-schema.mjs (part of the npm run check chain).",
6
+ "type": "object",
7
+ "required": ["id", "name", "type", "colorways"],
8
+ "additionalProperties": false,
9
+ "properties": {
10
+ "$schema": {
11
+ "type": "string",
12
+ "description": "Editor IntelliSense reference (optional) — relative path ../../../public/schemas/theme.schema.json"
13
+ },
14
+ "id": {
15
+ "type": "string",
16
+ "description": "Theme id — globally unique (stored in app.theme; convention: the plugin's short name)"
17
+ },
18
+ "name": {
19
+ "type": "string",
20
+ "description": "Theme display name — shown in the theme picker and the window title"
21
+ },
22
+ "type": {
23
+ "type": "string",
24
+ "enum": ["light", "dark"],
25
+ "description": "Base light/dark mode — dark is the :root base, light is the data-theme override layer"
26
+ },
27
+ "appearance": {
28
+ "type": "object",
29
+ "description": "Appearance domains (single value, sparse) — an omitted domain inherits the shell's :root default",
30
+ "additionalProperties": false,
31
+ "properties": {
32
+ "radius": {
33
+ "type": "object",
34
+ "description": "Eight radius steps (key = step name, value = px; 999 = full pill)",
35
+ "additionalProperties": false,
36
+ "properties": {
37
+ "xs": { "type": "number" },
38
+ "sm": { "type": "number" },
39
+ "md": { "type": "number" },
40
+ "lg": { "type": "number" },
41
+ "xl": { "type": "number" },
42
+ "2xl": { "type": "number" },
43
+ "pill": { "type": "number" },
44
+ "full": { "type": "number" }
45
+ }
46
+ },
47
+ "glass": {
48
+ "type": "object",
49
+ "description": "Glass and floating panel material (ThemeSurface) — default: no glass, no floating",
50
+ "additionalProperties": false,
51
+ "properties": {
52
+ "type": { "type": "string", "enum": ["glass"], "description": "Glass recipe — default: no glass" },
53
+ "blur": { "type": "number", "description": "Backdrop blur in px — 0 = off" },
54
+ "saturate": { "type": "number", "description": "Saturation boost — 1 = off" },
55
+ "tint": { "type": "string", "description": "Overlay tint color for the glass surface" },
56
+ "opacity": { "type": "number", "minimum": 0, "maximum": 1, "default": 0.5, "description": "Glass surface opacity — the surface alpha baseline. Follow-theme mode uses this value; a user-set app.glassOpacity overrides it in custom mode. 1 = opaque / 0 = fully see-through. Surface colors in colorways are treated as opaque base colors once glass is declared (their own alpha is ignored); themes without glass keep their per-surface alpha." },
57
+ "tintOpacity": { "type": "number", "minimum": 0, "maximum": 1, "description": "Tint overlay opacity (the glass tint layer) — defaults to opacity. Decouple tint thickness from the surface alpha (e.g. surface 0.55 + tintOpacity 0.275)." },
58
+ "specular": { "type": "number", "description": "Liquid glass top highlight strength — 0 = off" },
59
+ "specularColor": { "type": "string", "description": "Base color of the top highlight — default: white; alpha still comes from specular" },
60
+ "morph": { "type": "number", "description": "Morph transition in ms — 0 = off" },
61
+ "radius": { "type": "number", "description": "Floating corner radius in px — 0 = square corners flush to the edge" },
62
+ "shadow": { "type": "boolean", "description": "Drop shadow lift — true = floating shadow (maps to --shadow-lift)" },
63
+ "texture": { "type": "string", "description": "Path to a tileable texture image asset (paper texture)" },
64
+ "textureOpacity": { "type": "number", "description": "Texture opacity — 1 = opaque" }
65
+ }
66
+ },
67
+ "font": {
68
+ "type": "object",
69
+ "description": "Font domain — a system font family name or a relative asset path (asset → @font-face → family name)",
70
+ "additionalProperties": false,
71
+ "properties": {
72
+ "ui": { "type": "string", "description": "UI font (--font-ui)" },
73
+ "mono": { "type": "string", "description": "Monospace font (--font-mono)" }
74
+ }
75
+ },
76
+ "background": {
77
+ "type": "object",
78
+ "description": "Image background domain (panorama = full window / zones = sliced)",
79
+ "additionalProperties": false,
80
+ "properties": {
81
+ "image": { "type": "string", "description": "Image path — the author provides a resolvable URL; the engine wraps it in url() when writing --bg-image" },
82
+ "opacity": { "type": "number", "description": "Image layer opacity — 1 = opaque" },
83
+ "mask": { "type": "number", "description": "Image mask darkness (0-1) — 0 = no mask" },
84
+ "maskColor": { "type": "string", "description": "Mask base color — default: black; alpha still comes from mask" },
85
+ "mode": { "type": "string", "enum": ["panorama", "zones"], "description": "Slice mode — panorama (default) / zones (the same image sliced continuously)" }
86
+ }
87
+ }
88
+ }
89
+ },
90
+ "colorways": {
91
+ "type": "array",
92
+ "description": "Colorway list (multi-value color domain, at least one entry)",
93
+ "minItems": 1,
94
+ "items": {
95
+ "type": "object",
96
+ "required": ["id", "name"],
97
+ "additionalProperties": false,
98
+ "properties": {
99
+ "id": { "type": "string", "description": "Colorway id — globally unique (stored in the dynamic app.themeColor enum)" },
100
+ "name": { "type": "string", "description": "Colorway display name" },
101
+ "colors": {
102
+ "type": "object",
103
+ "description": "Color token set (key = contract token name without the -- prefix; value = a color string)",
104
+ "additionalProperties": { "type": "string" }
105
+ }
106
+ }
107
+ }
108
+ }
109
+ }
110
+ }