@appthen/vibe-workspace 0.1.0 → 0.1.1

package/PLUGIN_DEV.md

@@ -24,6 +24,14 @@ pnpm dev
 
 `pnpm install` 是首次准备依赖的步骤。依赖缓存准备好后，`dev`、`validate`、`test`、`build` 和 `pack` 不依赖 marketplace，可以离线完成。
 
+如果同时修改 `@appthen/vibe-workspace` 本身，不要为了本地调试发布 npm。可以在 SDK 仓库运行 `pnpm run build:lib -- --watch`，然后从扩展工作区运行：
+
+```bash
+pnpm dev -- --package-root /path/to/vibe-workspace
+```
+
+`--package-root` 会让本地 Workbench、扩展构建和模板运行时使用指定目录的 `dist`。只有要交付给其他开发者时才发布 npm。
+
 ## 2. 工作区结构
 
 ```text
@@ -71,6 +79,7 @@ pnpm pack -- acme.example
   "apiVersion": "1",
   "main": "./src/index.tsx",
   "sourceType": "umd",
+  "icon": "data:image/svg+xml,%3Csvg ...%3E%3C/svg%3E",
   "runtime": {
     "sidebarViewId": "sidebar.acme.example"
   },
@@ -92,6 +101,23 @@ pnpm pack -- acme.example
 - `runtime.sidebarViewId`：声明扩展侧边栏视图。
 - `runtime.autoActivate`：只用于必须在 Workbench 启动时注册的扩展能力，普通扩展不要开启。
 - `accessPolicy`：声明扩展自身的访问策略，会与租户和工作台策略合并。
+- `icon`：侧边栏和移动端导航图标。v1 使用小型 `data:image/svg+xml` 或 HTTPS 图片 URL；暂不支持从扩展包引用相对路径静态资源。
+
+图标建议使用不超过 32x32 的单色或双色 SVG data URL。需要多文件图片、字体或本地资源目录时，先上传到可信 CDN，再把 HTTPS URL 写入 Manifest；这样不会引入未定义的资源打包和 CDN 路径问题。
+
+## 5.1 工作台主题
+
+主题属于 Workbench 配置，不属于扩展激活副作用。离线工作区可以在 `themes/*.json` 定义主题，并在 `appthen-extension-workspace.json` 指定默认主题：
+
+```json
+{
+  "devWorkbench": {
+    "theme": "acme.sales"
+  }
+}
+```
+
+`pnpm dev` 会自动加载 `themes/` 下的 JSON。主题可通过 `extends` 继承 `vercel`、`dracula` 等内置主题；设置菜单中的主题替换会写入浏览器 localStorage，刷新后仍会保留。修改主题文件后重启 `pnpm dev` 以重新载入。
 
 ## 5. 编写扩展
 

package/README.md

@@ -30,6 +30,12 @@ appthen-extension publish [extensionId] --server <url> --tenant <tenantId>
 appthen-extension install <package-file> --server <url> --tenant <tenantId>
 ```
 
+开发 Workbench SDK 本身时，不需要发布 npm。先在 SDK 仓库执行 `pnpm run build:lib -- --watch`，再从扩展工作区指向本地 SDK：
+
+```bash
+pnpm dev -- --package-root /path/to/vibe-workspace
+```
+
 `publish` uploads and updates the tenant extension record. It does not mount the extension into a Workbench unless `--install-tenant` is provided. Workbench mounting and permissions are configured separately.
 
 ## Stable Extension API

package/dist/{Workbench-Dhd6kXGh.js → Workbench-Bh2vD56R.js}

@@ -1159,21 +1159,26 @@ class ThemeService {
   constructor() {
     this.currentTheme = DraculaTheme;
     this.listeners = [];
+    this.customThemes = /* @__PURE__ */ new Map();
     this.applyTheme(DraculaTheme);
   }
+  registerTheme(theme) {
+    if (!(theme == null ? void 0 : theme.id) || !theme.label || !theme.colors || !theme.type) return false;
+    this.customThemes.set(theme.id, theme);
+    this.listeners.forEach((l) => l());
+    return true;
+  }
+  registerThemes(themes) {
+    let changed = false;
+    themes.forEach((theme) => {
+      if (this.registerThemeWithoutNotify(theme)) changed = true;
+    });
+    if (changed) this.listeners.forEach((l) => l());
+  }
   setTheme(themeId) {
     console.log("[ThemeService] setTheme called with:", themeId);
-    if (themeId === "dracula" || themeId === "appthen") {
-      this.applyTheme(DraculaTheme);
-    } else if (themeId === "vercel") {
-      this.applyTheme(VercelTheme);
-    } else if (themeId === "appthen-light") {
-      this.applyTheme(AppThenLightTheme);
-    } else if (themeId === "vs-light") {
-      this.applyTheme(LightTheme);
-    } else {
-      this.applyTheme(DarkTheme);
-    }
+    const theme = this.resolveTheme(themeId) || DarkTheme;
+    this.applyTheme(theme);
   }
   setUserTheme(themeId) {
     this.setTheme(themeId);
@@ -1193,7 +1198,30 @@ class ThemeService {
     return this.currentTheme;
   }
   getAvailableThemes() {
-    return [DraculaTheme, VercelTheme, AppThenLightTheme, DarkTheme, LightTheme];
+    return [DraculaTheme, VercelTheme, AppThenLightTheme, DarkTheme, LightTheme, ...this.customThemes.values()].map((theme) => this.resolveTheme(theme.id) || theme);
+  }
+  registerThemeWithoutNotify(theme) {
+    if (!(theme == null ? void 0 : theme.id) || !theme.label || !theme.colors || !theme.type) return false;
+    const previous = this.customThemes.get(theme.id);
+    this.customThemes.set(theme.id, theme);
+    return JSON.stringify(previous) !== JSON.stringify(theme);
+  }
+  resolveTheme(themeId, seen = /* @__PURE__ */ new Set()) {
+    var _a2, _b;
+    const builtIn = [DraculaTheme, VercelTheme, AppThenLightTheme, DarkTheme, LightTheme].find((theme2) => theme2.id === themeId || themeId === "appthen" && theme2.id === "dracula" || themeId === "vs-light" && theme2.id === "light");
+    const theme = builtIn || this.customThemes.get(themeId);
+    if (!theme || seen.has(theme.id)) return theme;
+    if (!theme.extends) return theme;
+    seen.add(theme.id);
+    const parent = this.resolveTheme(theme.extends, seen);
+    if (!parent) return theme;
+    return {
+      ...parent,
+      ...theme,
+      colors: { ...parent.colors, ...theme.colors },
+      portalColors: { ...parent.portalColors, ...theme.portalColors },
+      monaco: { ...parent.monaco, ...theme.monaco, colors: { ...(_a2 = parent.monaco) == null ? void 0 : _a2.colors, ...(_b = theme.monaco) == null ? void 0 : _b.colors } }
+    };
   }
   applyTheme(theme) {
     this.currentTheme = theme;
@@ -136955,6 +136983,7 @@ function WorkbenchProvider({
   var _a2, _b, _c, _d, _e2, _f, _g, _h;
   const [state, dispatch2] = useReducer(workbenchReducer, initialState);
   useEffect(() => {
+    var _a3;
     if (config) {
       const resolvedConfig = config.scene || config.workbenchId !== "vibecoding" ? config : createVibeCodingWorkbenchConfig(config);
       const resolvedExtensions = resolveRuntimeExtensions(resolvedConfig);
@@ -136968,6 +136997,9 @@ function WorkbenchProvider({
           state.activeLeftExtensionId
         )
       });
+      if ((_a3 = resolvedConfig.themeCatalog) == null ? void 0 : _a3.length) {
+        themeService.registerThemes(resolvedConfig.themeCatalog);
+      }
       if (resolvedConfig.theme) {
         const themeId = themeService.getPreferredThemeId() || resolvedConfig.theme;
         console.log("[Workbench] Applying theme:", themeId);
@@ -137486,6 +137518,7 @@ function WorkbenchProvider({
     const loadWorkbenchConfig = async () => {
       console.log("[Workbench] Loading config for:", workbenchId);
       const applyResolvedConfig = (resolvedConfig) => {
+        var _a4;
         if (activeWorkbenchConfigKeyRef.current !== configKey) return;
         const resolvedExtensions = resolveRuntimeExtensions(resolvedConfig);
         dispatch2({ type: "SET_WORKBENCH_CONFIG", payload: resolvedConfig });
@@ -137498,6 +137531,9 @@ function WorkbenchProvider({
             state.activeLeftExtensionId
           )
         });
+        if ((_a4 = resolvedConfig.themeCatalog) == null ? void 0 : _a4.length) {
+          themeService.registerThemes(resolvedConfig.themeCatalog);
+        }
         if (resolvedConfig.theme) {
           const themeId = themeService.getPreferredThemeId() || resolvedConfig.theme;
           console.log("[Workbench] Applying theme:", themeId);
@@ -139503,7 +139539,7 @@ const WorkbenchSettingsMenu = ({
   onClose
 }) => {
   const [currentTheme, setCurrentTheme] = useState(themeService.getCurrentTheme());
-  const themes = useMemo(() => themeService.getAvailableThemes(), []);
+  const themes = themeService.getAvailableThemes();
   useEffect(() => {
     return themeService.onThemeChange(() => {
       setCurrentTheme(themeService.getCurrentTheme());
@@ -140990,4 +141026,4 @@ export {
   normalizeFileSrc as y,
   previewService as z
 };
-//# sourceMappingURL=Workbench-Dhd6kXGh.js.map
+//# sourceMappingURL=Workbench-Bh2vD56R.js.map