@linkdesk/plugin-sdk 0.1.79 → 0.1.81

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/dist/index.d.ts CHANGED
@@ -1,11 +1,18 @@
1
1
  /**
2
- * @linkdesk/plugin-sdk 公共出口(barrel)。
2
+ * @linkdesk/plugin-sdk 公共出口(barrel)——**构建面**(vite.config.ts / 校验脚本用)。
3
3
  *
4
4
  * 运行面:`defineLinkdeskPluginConfig()`(构建)+ validate 家族(plugin.json / 主题数据 / 图标主题数据;
5
5
  * E6#60 起主题/图标作者也走 npm 通道——validateThemeJson / validateIconThemeJson);
6
6
  * 类型面经 types.js 全量转发 @linkdesk/contracts(window.linkdesk.* 全局声明随契约进 program,E6#2b)。
7
7
  * validate 的内部 helper(collectI18nDecls/derivePluginId/SAFE_PLUGIN_ID 等)供 vite-config/packager
8
8
  * 跨模块复用,但**不进 barrel**——公共 API 面保持最小(对标 @types/vscode 只给类型+工具)。
9
+ *
10
+ * 🔴 **插件运行时代码(src/**)不许 import 本入口**——宿主命令面在子路径 `shell-commands.ts`
11
+ * (`import { SHELL_COMMANDS, openWith } from "@linkdesk/plugin-sdk/shell-commands"`)。
12
+ * 为什么:本入口 re-export `vite-config.js`,它静态 import `vite` / `@vitejs/plugin-react`——
13
+ * 插件源码一旦从本入口取值,整条构建链会被**打进插件 zip**(实测:rollup 的 node-entry 要解析
14
+ * 仅 macOS 有的 `fsevents` ⇒ Windows 上 build 直接红,且即使侥幸过了也是几 MB 的死代码)。
15
+ * 子路径只出「一个常量对象 + 一个 helper」,零重依赖。
9
16
  */
10
17
  export { defineLinkdeskPluginConfig } from "./vite-config.js";
11
18
  export type { LinkdeskPluginOptions } from "./vite-config.js";
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACzE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,mBAAmB,YAAY,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACzE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,mBAAmB,YAAY,CAAC"}
package/dist/index.js CHANGED
@@ -1,11 +1,18 @@
1
1
  /**
2
- * @linkdesk/plugin-sdk 公共出口(barrel)。
2
+ * @linkdesk/plugin-sdk 公共出口(barrel)——**构建面**(vite.config.ts / 校验脚本用)。
3
3
  *
4
4
  * 运行面:`defineLinkdeskPluginConfig()`(构建)+ validate 家族(plugin.json / 主题数据 / 图标主题数据;
5
5
  * E6#60 起主题/图标作者也走 npm 通道——validateThemeJson / validateIconThemeJson);
6
6
  * 类型面经 types.js 全量转发 @linkdesk/contracts(window.linkdesk.* 全局声明随契约进 program,E6#2b)。
7
7
  * validate 的内部 helper(collectI18nDecls/derivePluginId/SAFE_PLUGIN_ID 等)供 vite-config/packager
8
8
  * 跨模块复用,但**不进 barrel**——公共 API 面保持最小(对标 @types/vscode 只给类型+工具)。
9
+ *
10
+ * 🔴 **插件运行时代码(src/**)不许 import 本入口**——宿主命令面在子路径 `shell-commands.ts`
11
+ * (`import { SHELL_COMMANDS, openWith } from "@linkdesk/plugin-sdk/shell-commands"`)。
12
+ * 为什么:本入口 re-export `vite-config.js`,它静态 import `vite` / `@vitejs/plugin-react`——
13
+ * 插件源码一旦从本入口取值,整条构建链会被**打进插件 zip**(实测:rollup 的 node-entry 要解析
14
+ * 仅 macOS 有的 `fsevents` ⇒ Windows 上 build 直接红,且即使侥幸过了也是几 MB 的死代码)。
15
+ * 子路径只出「一个常量对象 + 一个 helper」,零重依赖。
9
16
  */
10
17
  export { defineLinkdeskPluginConfig } from "./vite-config.js";
11
18
  export { validatePluginJson } from "./validate.js";
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEzE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEzE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}
@@ -0,0 +1,26 @@
1
+ /**
2
+ * 宿主命令常量与调用 helper——插件调用**宿主级命令**的唯一合法写法。
3
+ *
4
+ * 为什么要有这一份:宿主命令 id 一旦被插件源码硬编码,改名就是全生态事故。
5
+ * 壳侧对应物是 `src/core/commands/shell/shellCommands.ts` 的 `SHELL_COMMANDS`——两边是
6
+ * **同名字面量**(壳不依赖本包,依赖方向不允许壳 import 它),相等由门禁腿
7
+ * `scripts/check-shell-command-constants.mjs` 逐字对账;作者文档见
8
+ * `@linkdesk/docs` 的「调用宿主命令」一节。
9
+ *
10
+ * 公开面纪律(对标 `index.ts` 头注「公共 API 面保持最小」):本模块只出**一个常量对象 + 一个 helper**;
11
+ * 类型走 `@linkdesk/contracts` 的 `types.js` 全量转发,⛔ 不在这里另写一份类型(那就是两套契约的开始)。
12
+ */
13
+ import type { OpenWithRequest } from "./types.js";
14
+ /** 宿主命令 id 常量表(与壳侧 `SHELL_COMMANDS` 逐字相等,改一边门禁即红)。 */
15
+ export declare const SHELL_COMMANDS: {
16
+ /** 「打开方式」选择器——入参 `OpenWithRequest`;面板升起,动作回执由宿主处理。 */
17
+ readonly openWith: "workbench.action.openWith";
18
+ };
19
+ /**
20
+ * 打开「打开方式」选择器——宿主升起面板,选中项的动作由宿主执行。
21
+ *
22
+ * `request.uri` 与 `request.ext` **至少给一个**:右键/编辑器入口给 `uri`(宿主自行算 ext),
23
+ * 设置页按类型入口只给 `ext`。宿主未就绪时静默 no-op(插件不应为宿主能力缺失做分支)。
24
+ */
25
+ export declare function openWith(request: OpenWithRequest): void;
26
+ //# sourceMappingURL=shell-commands.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shell-commands.d.ts","sourceRoot":"","sources":["../src/shell-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,sDAAsD;AACtD,eAAO,MAAM,cAAc;IACzB,sDAAsD;;CAE9C,CAAC;AAaX;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAGvD"}
@@ -0,0 +1,16 @@
1
+ /** 宿主命令 id 常量表(与壳侧 `SHELL_COMMANDS` 逐字相等,改一边门禁即红)。 */
2
+ export const SHELL_COMMANDS = {
3
+ /** 「打开方式」选择器——入参 `OpenWithRequest`;面板升起,动作回执由宿主处理。 */
4
+ openWith: "workbench.action.openWith",
5
+ };
6
+ /**
7
+ * 打开「打开方式」选择器——宿主升起面板,选中项的动作由宿主执行。
8
+ *
9
+ * `request.uri` 与 `request.ext` **至少给一个**:右键/编辑器入口给 `uri`(宿主自行算 ext),
10
+ * 设置页按类型入口只给 `ext`。宿主未就绪时静默 no-op(插件不应为宿主能力缺失做分支)。
11
+ */
12
+ export function openWith(request) {
13
+ const host = globalThis.linkdesk;
14
+ host?.commands?.executeCommand?.(SHELL_COMMANDS.openWith, request);
15
+ }
16
+ //# sourceMappingURL=shell-commands.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shell-commands.js","sourceRoot":"","sources":["../src/shell-commands.ts"],"names":[],"mappings":"AAcA,sDAAsD;AACtD,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,sDAAsD;IACtD,QAAQ,EAAE,2BAA2B;CAC7B,CAAC;AAaX;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAwB;IAC/C,MAAM,IAAI,GAAI,UAAyB,CAAC,QAAQ,CAAC;IACjD,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACrE,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@linkdesk/plugin-sdk",
3
- "version": "0.1.79",
3
+ "version": "0.1.81",
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",
@@ -10,6 +10,10 @@
10
10
  "types": "./dist/index.d.ts",
11
11
  "default": "./dist/index.js"
12
12
  },
13
+ "./shell-commands": {
14
+ "types": "./dist/shell-commands.d.ts",
15
+ "default": "./dist/shell-commands.js"
16
+ },
13
17
  "./eslint": {
14
18
  "types": "./dist/eslint/index.d.ts",
15
19
  "default": "./dist/eslint/index.js"
@@ -876,6 +876,28 @@
876
876
  "ldk-number-input-cell",
877
877
  "ldk-number-input-field",
878
878
  "ldk-number-input-unit",
879
+ "ldk-openwith",
880
+ "ldk-openwith--centered",
881
+ "ldk-openwith-act",
882
+ "ldk-openwith-acts",
883
+ "ldk-openwith-auto",
884
+ "ldk-openwith-cur",
885
+ "ldk-openwith-curtext",
886
+ "ldk-openwith-def",
887
+ "ldk-openwith-empty",
888
+ "ldk-openwith-file",
889
+ "ldk-openwith-head",
890
+ "ldk-openwith-ic",
891
+ "ldk-openwith-list",
892
+ "ldk-openwith-market",
893
+ "ldk-openwith-names",
894
+ "ldk-openwith-nm",
895
+ "ldk-openwith-pid",
896
+ "ldk-openwith-row",
897
+ "ldk-openwith-scrim",
898
+ "ldk-openwith-scrim--clear",
899
+ "ldk-openwith-title",
900
+ "ldk-openwith-x",
879
901
  "ldk-panel-content",
880
902
  "ldk-panel-empty",
881
903
  "ldk-panel-empty-big",