v3.29.0

changelog.md

@@ -1,5 +1,219 @@
 # Changelog
 
+## 2026-01-03 - 3.29.0 - feat(docs)
+add documentation for new input components, activity log features, theming, and expand DeesAppui docs
+
+- Updated top-level README to reflect component count increase (75+ → 80+) and added many new component docs
+- Added documentation and examples for DeesInputList (sortable list input) and DeesInputProfilepicture (cropping, upload, processing)
+- Introduced DeesTheme documentation with usage examples and CSS custom property overrides
+- Expanded DeesAppui readme with architecture overview, activity log panel docs, activity entry types, and navigation/secondary menu guidance
+- Documented activity log APIs and controls (activityLog.add, addMany, clear, getEntries, filter, search) and new control API helpers (setActivityLogVisible, toggleActivityLog, getActivityLogVisible)
+- Updated Appbar examples to include activity log toggle properties (.showActivityLogToggle, .activityLogCount, .activityLogActive) and @activity-toggle event
+- Added interface docs (IViewDefinition, IActivityEntry) and updated menu/secondary menu type references
+- Changes are documentation-focused (README/element readmes); no source code logic changes shown in this diff
+
+## 2026-01-03 - 3.28.1 - fix(appui)
+adjust layout and spacing in app UI components: fix activity log overflow, contain main content overscroll, and refine secondary menu padding/transition
+
+- ts_web/elements/00group-appui/dees-appui-activitylog: removed host max-width, added overflow:hidden and set .maincontainer width to 280px to prevent horizontal overflow
+- ts_web/elements/00group-appui/dees-appui-maincontent: added overscroll-behavior: contain to .content-area to prevent scroll chaining/overscroll
+- ts_web/elements/00group-appui/dees-appui-secondarymenu: updated .groupHeader padding and hover border behavior, increased group icon size from 14px to 16px, and added margin + transition tweaks to .groupItems for smoother collapse/expand
+
+## 2026-01-02 - 3.28.0 - feat(dees-appui)
+Rename DeesAppuiBase to DeesAppui and migrate related API, exports, demos and docs
+
+- Renamed public component/tag and TypeScript types: DeesAppuiBase -> DeesAppui and TDeesAppuiBase -> TDeesAppui; updated IViewActivationContext.appui type accordingly
+- Moved/rewired view registry implementation from dees-appui-base to dees-appui and updated module exports
+- Updated README and demo files to reference DeesAppui and new readme paths (removed dees-appui-base docs/demo)
+- Replaced dependency/imports of '@webcontainer/api' with '@tempfix/webcontainer__api' (package.json and source imports)
+- Changed tsconfig.json: skipLibCheck set from true to false
+
+## 2026-01-01 - 3.27.1 - fix(dees-actionbar)
+always render actionbar wrapper and delay adding visible class to ensure grid/opacity animations run reliably
+
+- Always render the actionbar wrapper (.actionbar-item and .actionbar-content) instead of returning early so grid-template-rows and opacity transitions can animate.
+- Use optional chaining for current bar access (bar?.type, bar?.timeout) to avoid runtime errors when no bar is present.
+- Adjust styles and structure: set :host display:block; move background/border to .actionbar-item; add .actionbar-content with min-height/opacity and transitions.
+- Make processQueue asynchronous and await updateComplete, then add the 'visible' class inside requestAnimationFrame so the CSS transition is triggered after render.
+
+## 2026-01-01 - 3.27.0 - feat(services)
+introduce DeesServiceLibLoader to lazy-load heavy client libraries from CDN and update components to use it
+
+- Add DeesServiceLibLoader singleton (ts_web/services/DeesServiceLibLoader.ts) to lazily load and cache libraries via jsDelivr ESM: xterm, xterm-addon-fit, highlight.js, ApexCharts, and Tiptap.
+- Inject xterm CSS dynamically to avoid shipping xterm styles in the initial bundle.
+- Expose helper methods preloadAll() and isLoaded(), and typed bundle interfaces (IXtermBundle, IXtermFitAddonBundle, ITiptapBundle).
+- Update components to use runtime-loaded modules: dees-chart-area, dees-dataview-codebox, dees-input-richtext, wysiwyg code block, dees-workspace-terminal, terminal-tab-manager, dees-workspace-terminal-preview.
+- TerminalTabManager now requires setXtermModules(...) before creating tabs and will throw if not initialized; workspace terminal now initializes and passes the loaded modules.
+- Replace direct runtime imports of heavy libs with typed imports and runtime-loaded bundles to reduce initial bundle size and improve load performance.
+
+## 2026-01-01 - 3.26.1 - fix(dees-actionbar)
+animate actionbar hide using grid-template-rows and wait for animation before clearing state
+
+- Switch host layout from block/max-height to grid using grid-template-rows for open/close transitions
+- Add min-height: 0 to .actionbar-item to prevent flex children overflow and collapsing
+- Introduce async hideCurrentBar() that removes 'visible', sets isVisible=false, waits 220ms then clears currentBar and currentResolve
+- processQueue() now calls hideCurrentBar() asynchronously instead of clearing state immediately
+
+## 2026-01-01 - 3.26.0 - feat(workspace)
+add external file change detection, conflict resolution UI, and diff editor
+
+- Watch open files for external changes with debounced file watchers (startWatchingFile/stopWatchingFile/stopAllFileWatchers).
+- Prompt the user when disk changes conflict with unsaved local edits via dees-actionbar (actions: Load from Disk, Save Local, Compare).
+- Introduce dees-workspace-diff-editor component and export it; support comparing and resolving diffs (diff-resolved / diff-closed events).
+- Add setContentExternal in dees-workspace-monaco to update editor content from external sources while optionally preserving cursor, selections and scroll position.
+- Start/stop file watchers when files are opened/closed and integrate diff view and actionbar into the workspace UI for seamless conflict handling.
+
+## 2026-01-01 - 3.25.0 - feat(dees-actionbar)
+add action bar component and improve workspace package update handling
+
+- Introduce dees-actionbar component (dees-actionbar.ts) with interfaces, queueing, timed auto-trigger and demo usage
+- Add actionbar.interfaces.ts and index export; export dees-actionbar from elements index
+- Enhance workspace bottombar: add pendingPackageUpdate flag, process-complete handler, and connected/disconnected listeners to auto-refresh package status after updates
+- Make pnpm outdated checking robust by streaming output via a reader and adding a 10s timeout to avoid hanging; handle timeout and stream cancellation
+- Update package update commands to include '--latest' for updatePackage and updateAllPackages, and show 'Checking...' label during checks
+- Add '@types/node' (^22.0.0) to devDependencies in the workspace package config
+
+## 2026-01-01 - 3.24.0 - feat(workspace)
+add workspace bottom bar, terminal tab manager, and run-process integration
+
+- Add dees-workspace-bottombar component and export; bottom bar emits run-process events to launch processes.
+- Introduce terminal interfaces (IRunProcessEventDetail, ITerminalTab, ICreateTerminalTabOptions, etc.) and a TerminalTabManager to manage multiple terminal tabs and lifecycle.
+- Integrate bottombar into dees-workspace: layout refactor (workspace-outer), move/adjust resize handles and panels, and handle @run-process to create terminal tabs and focus terminal panel.
+- Enhance dees-workspace-terminal: tabbed terminal UI, new public APIs (createProcessTab, writeToTab, sendInputToTab), theme updates, and improved disposal/cleanup behavior.
+- Update module exports to include bottombar and additional terminal sub-exports (interfaces, terminal-tab-manager).
+
+## 2025-12-31 - 3.23.0 - feat(workspace)
+add resizable file tree and terminal panes with draggable handles and public layout APIs
+
+- Introduce reactive state for currentFileTreeWidth, currentTerminalHeight, isDraggingFileTree and isDraggingTerminal
+- Add mouse event handlers (mousedown/move/up) to drag-resize the file tree and terminal with min/max clamping
+- Dispatch window resize event after resizing to notify Monaco/editor of layout changes
+- Clean up resize event listeners in disconnectedCallback
+- Initialize current sizes from component properties in firstUpdated
+- Expose public layout methods: setFileTreeWidth, setTerminalHeight, resetLayout
+
+## 2025-12-31 - 3.22.0 - feat(workspace)
+add resizable markdown editor/preview split with draggable handle and markdown outlet styling/demo
+
+- Introduce a flexible split layout for the workspace markdown editor with a draggable resize handle (splitRatio, minPanelSize, dragging state, mouse handlers and cleanup).
+- Enhance dees-workspace-markdown: switch from grid to flex, add resize handle UI, prevent pointer selection while dragging, notify Monaco on resize.
+- Add comprehensive styling and demo content for dees-workspace-markdownoutlet (dark/light themed markdown styles, syntax highlighting classes, and demo scenarios).
+- Fix typescript-intellisense monaco model update: only set model value when content actually changed to avoid cursor resets.
+- Add markdown outlet demo helper and numerous screenshot/image assets (.playwright-mcp) for demos/documentation.
+
+## 2025-12-31 - 3.21.0 - feat(terminal)
+add dynamic bright/dark theming for terminal components and terminal preview
+
+- Add bright/dark theme PNG assets under .playwright-mcp for previews.
+- Replace hardcoded terminal background/colors with cssManager.bdTheme in workspace terminal and preview styles.
+- Introduce getTerminalTheme helper to compute xterm theme for bright/dark modes.
+- Subscribe to themeManager.themeObservable and apply updates to xterm (terminal.options.theme) so terminals update live on theme change.
+- Remove hardcoded background property/CSS var and unused background accessor from workspace terminal.
+- Ensure proper cleanup: unsubscribe theme subscriptions and dispose terminals in disconnectedCallback.
+
+## 2025-12-31 - 3.20.1 - fix(dees-workspace)
+fix demo wrapper and workspace layout; always render terminal preview
+
+- Import @design.estate/dees-wcctools/demotools and wrap demo content in <dees-demowrapper>
+- Create an absolute-positioned container so the dees-workspace fills 100% height/width
+- Always render dees-workspace-terminal-preview (use empty command when none) to avoid conditional rendering issues
+- Set a fixed height (200px) for the terminal preview in the initializing state
+- Add Playwright demo asset .playwright-mcp/dees-workspace-demo-4k.png
+
+## 2025-12-31 - 3.20.0 - feat(workspace)
+rename editor components to workspace group and move terminal & TypeScript intellisense into workspace
+
+- Renamed components and modules from 00group-editor/dees-editor-* to 00group-workspace/dees-workspace-* (e.g. dees-editor-monaco -> dees-workspace-monaco).
+- Moved terminal implementation from dees-terminal to dees-workspace-terminal and updated related imports/usages.
+- Moved TypeScript intellisense manager into 00group-workspace and updated paths.
+- Updated ts_web elements index to export 00group-workspace instead of 00group-editor and adjusted internal imports accordingly.
+- Updated scripts/update-monaco-version.cjs to write MONACO_VERSION into the new workspace path and updated log tags.
+
+## 2025-12-31 - 3.19.1 - fix(intellisense)
+Debounce TypeScript/JavaScript IntelliSense processing and cache missing packages to reduce work and noisy logs
+
+- Add 500ms debounce in editor workspace to avoid parsing on every keystroke
+- Introduce notFoundPackages cache to skip repeated filesystem checks for packages without types
+- Clear not-found cache when scanning node_modules so newly installed packages are re-detected
+- Remove noisy console logs and make file/directory read errors non-fatal (ignored)
+- Simplify processContentChange signature (removed optional filePath) and remove manual diagnostic refresh logic
+
+## 2025-12-31 - 3.19.0 - feat(dees-editor-workspace)
+improve TypeScript IntelliSense, auto-run workspace init commands, and watch node_modules for new packages
+
+- Execute an onInit command from /npmextra.json on workspace initialization (e.g., run pnpm install).
+- Add npmextra.json and an import test file (importtest.ts) plus a sample dependency in the scaffold to test package imports.
+- Add node_modules watcher with debounce to auto-scan and load package types after installs.
+- Enhance TypeScript IntelliSense: recursively load all .d.ts files from packages and @types packages, add package.json as extra lib, and log progress/errors for debugging.
+- Change processContentChange signature to accept optional filePath and trigger a diagnostic refresh when new types are loaded.
+- Expose scanAndLoadNewPackageTypes to scan top-level and scoped packages and load their types.
+- Add start/stop logic for the node_modules watcher in workspace lifecycle to avoid leaks and handle cleanup.
+
+## 2025-12-31 - 3.18.0 - feat(filetree)
+add filesystem watch support to WebContainer environment and auto-refresh file tree; improve icon handling and context menu behavior
+
+- Add IFileWatcher interface and watch(...) signature to IExecutionEnvironment.
+- Implement watch(...) in WebContainerEnvironment using WebContainer's fs.watch and return a stop() handle.
+- dees-editor-filetree: start/stop file watcher, debounce auto-refresh on FS changes, cleanup on disconnect, and track last execution environment.
+- Add clipboard state (copy/cut) and related UI/menu enhancements for file operations (new file/folder, rename, delete, copy/paste).
+- dees-icon: default to Lucide icons when no prefix is provided.
+- dees-contextmenu: remove 'lucide:' prefix usage in templates and avoid awaiting windowLayer.destroy() to provide instant visual feedback.
+- Menu item shape adjusted (use { divider: true } for dividers) and various menu icon name updates.
+
+## 2025-12-31 - 3.17.0 - feat(editor)
+add file explorer toolbar, empty-space context menu, editor auto-save, save-all, and keyboard save shortcuts
+
+- Added filetree toolbar with New File / New Folder actions and toolbar styling
+- Added right-click context menu for empty filetree space to create files/folders
+- Implemented editor menu button with context menu (Auto Save toggle, Save, Save All)
+- Added auto-save toggle with 2s interval and cleanup on disconnect
+- Implemented Save and Save All APIs that persist files and update IntelliSense manager
+- Added keyboard shortcuts: Cmd/Ctrl+S to save active file and Cmd/Ctrl+Shift+S to save all
+- Made tabs scrollable with a tabs container and added an editor menu button
+
+## 2025-12-30 - 3.16.0 - feat(editor)
+improve TypeScript IntelliSense and module resolution for Monaco editor
+
+- Add file cache (fileCache) and getFileContent() for synchronous access to project files
+- Track and dispose Monaco extra libs (addedExtraLibs) and register project files via addExtraLib to enable TypeScript module resolution
+- Add addFileAsExtraLib logic to register .ts/.tsx files also under .js/.jsx paths so ESM imports resolve to TypeScript sources
+- Use ModuleResolutionKind.Bundler fallback to NodeJs and set compilerOptions (baseUrl '/', allowImportingTsExtensions, resolveJsonModule) to improve resolution
+- Adapt executionEnvironment API usage to readDir/readFile and check entry.type ('directory'|'file') instead of isDirectory/isFile
+- Add a debugging/screenshot asset: .playwright-mcp/module-resolution-fixed.png
+
+## 2025-12-30 - 3.15.0 - feat(editor)
+enable file-backed Monaco models and add Problems panel; lazy-init project TypeScript IntelliSense
+
+- dees-editor-monaco: add `filePath` property and create/get Monaco models with file:// URIs so editors are backed by real models; sync content into models and handle model switching when filePath changes; enable hover config and improved lifecycle handling.
+- dees-editor-workspace: add bottom 'Problems' panel and panel tabs (terminal/problems), diagnosticMarkers state, marker listener, UI for problem list, and navigation to file/position when a problem is clicked; initialize IntelliSense lazily when a file is opened.
+- typescript-intellisense: index project .ts/.js files from the virtual filesystem into Monaco models for cross-file resolution, enable allowNonTsExtensions and set eager model sync so TypeScript processes models eagerly.
+- General: improved handling for language changes, model language switching, and deferred initialization of the IntelliSense manager.
+- Add Playwright test images (workspace screenshots) used by CI/tests.
+
+## 2025-12-30 - 3.14.2 - fix(editor)
+bump monaco-editor to 0.55.1 and adapt TypeScript intellisense integration to the updated Monaco API
+
+- Bumped dependency monaco-editor from 0.52.2 to 0.55.1 in package.json.
+- Generated MONACO_VERSION module updated to 0.55.1 and moved target to ts_web/elements/00group-editor/dees-editor-monaco/version.ts.
+- Refactored TypeScript IntelliSense code to use a typed Monaco TS API (added IMonacoTypeScriptAPI, tsApi getter, and replaced direct monaco.languages.typescript.* calls).
+- Added test/workspace screenshot .playwright-mcp/workspace-test.png (binary asset).
+
+## 2025-12-30 - 3.14.1 - fix(build)
+bump @webcontainer/api and enable skipLibCheck to avoid type-check conflicts
+
+- Updated @webcontainer/api from 1.2.0 to 1.6.1
+- Added "skipLibCheck": true to tsconfig.json compilerOptions to suppress external library type errors
+- No breaking changes expected; this is a build/dev fix
+
+## 2025-12-30 - 3.14.0 - feat(editor)
+add modal prompts for file/folder creation, improve Monaco editor reactivity and add TypeScript IntelliSense support
+
+- Replace window.prompt for new file/folder with DeesModal + DeesInputText (showInputModal) to provide a focused modal input UX.
+- Monaco editor: add language property, handle external content updates without emitting change events (isUpdatingFromExternal), dispatch 'content-change' events, and apply language changes at runtime.
+- Add TypeScriptIntelliSenseManager to load .d.ts/type packages from the virtual filesystem (/node_modules), parse imports, load @types fallbacks, and add file models to Monaco for cross-file IntelliSense.
+- Workspace demo now mounts an initial TypeScript project and exposes initializationPromise to wait for external setup; workspace initializes IntelliSense and processes content changes to keep types up to date.
+- Export typescript-intellisense from workspace index so the manager is available to consumers.
+
 ## 2025-12-30 - 3.13.1 - fix(webcontainer)
 prevent double initialization and race conditions when booting WebContainer and loading editor workspace/file tree
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@design.estate/dees-catalog",
-  "version": "3.13.1",
+  "version": "3.29.0",
   "private": false,
   "description": "A comprehensive library that provides dynamic web components for building sophisticated and modern web applications using JavaScript and TypeScript.",
   "main": "dist_ts_web/index.js",
@@ -32,13 +32,13 @@
     "@tiptap/extension-underline": "^2.23.0",
     "@tiptap/starter-kit": "^2.23.0",
     "@tsclass/tsclass": "^9.3.0",
-    "@webcontainer/api": "1.2.0",
+    "@tempfix/webcontainer__api": "1.6.1",
     "apexcharts": "^5.3.6",
     "highlight.js": "11.11.1",
     "ibantools": "^4.5.1",
     "lit": "^3.3.1",
     "lucide": "^0.562.0",
-    "monaco-editor": "0.52.2",
+    "monaco-editor": "0.55.1",
     "pdfjs-dist": "^4.10.38",
     "xterm": "^5.3.0",
     "xterm-addon-fit": "^0.8.0"

pnpm-lock.yaml

@@ -35,6 +35,9 @@ importers:
       '@push.rocks/smartstring':
         specifier: ^4.1.0
         version: 4.1.0
+      '@tempfix/webcontainer__api':
+        specifier: 1.6.1
+        version: 1.6.1
       '@tiptap/core':
         specifier: ^2.23.0
         version: 2.27.1(@tiptap/pm@2.27.1)
@@ -56,9 +59,6 @@ importers:
       '@tsclass/tsclass':
         specifier: ^9.3.0
         version: 9.3.0
-      '@webcontainer/api':
-        specifier: 1.2.0
-        version: 1.2.0
       apexcharts:
         specifier: ^5.3.6
         version: 5.3.6
@@ -75,8 +75,8 @@ importers:
         specifier: ^0.562.0
         version: 0.562.0
       monaco-editor:
-        specifier: 0.52.2
-        version: 0.52.2
+        specifier: 0.55.1
+        version: 0.55.1
       pdfjs-dist:
         specifier: ^4.10.38
         version: 4.10.38
@@ -1450,6 +1450,9 @@ packages:
   '@tempfix/idb@8.0.3':
     resolution: {integrity: sha512-hPJQKO7+oAIY+pDNImrZ9QAINbz9KmwT+yO4iRVwdPanok2YKpaUxdJzIvCUwY0YgAawlvYdffbLvRLV5hbs2g==}
 
+  '@tempfix/webcontainer__api@1.6.1':
+    resolution: {integrity: sha512-Hgn3cwy0vPzjrVBqeVnY0jNZLaOCW7d+dxBe7Jv9YGHAjJ8udUMS+KbTywSv5paAfld3A/RN/iolmMzOwZxLTA==}
+
   '@tiptap/core@2.27.1':
     resolution: {integrity: sha512-nkerkl8syHj44ZzAB7oA2GPmmZINKBKCa79FuNvmGJrJ4qyZwlkDzszud23YteFZEytbc87kVd/fP76ROS6sLg==}
     peerDependencies:
@@ -2149,6 +2152,9 @@ packages:
     resolution: {integrity: sha512-l4gcSouhcgIKRvyy99RNVOgxXiicE+2jZoNmaNmZ6JXiGajBOJAesk1OBlJuM5k2c+eudGdLxDqXuPCKIj6kpw==}
     engines: {node: '>=6'}
 
+  dompurify@3.2.7:
+    resolution: {integrity: sha512-WhL/YuveyGXJaerVlMYGWhvQswa7myDG17P7Vu65EWC05o8vfeNbvNf4d/BOvH99+ZW+LlQsc1GDKMa1vNK6dw==}
+
   dunder-proto@1.0.1:
     resolution: {integrity: sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==}
     engines: {node: '>= 0.4'}
@@ -2771,6 +2777,11 @@ packages:
   markdown-table@3.0.4:
     resolution: {integrity: sha512-wiYz4+JrLyb/DqW2hkFJxP7Vd7JuTDm77fvbM8VfEQdmSMqcImWeeRbHwZjBjIFki/VaMK2BhFi7oUUZeM5bqw==}
 
+  marked@14.0.0:
+    resolution: {integrity: sha512-uIj4+faQ+MgHgwUW1l2PsPglZLOLOT1uErt06dAPtx2kjteLAkbsd/0FiYg/MGS+i7ZKLb7w2WClxHkzOOuryQ==}
+    engines: {node: '>= 18'}
+    hasBin: true
+
   matcher@5.0.0:
     resolution: {integrity: sha512-s2EMBOWtXFc8dgqvoAzKJXxNHibcdJMV0gwqKUaw9E2JBJuGUK7DrNKrA6g/i+v72TT16+6sVm5mS3thaMLQUw==}
     engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
@@ -2981,6 +2992,9 @@ packages:
   monaco-editor@0.52.2:
     resolution: {integrity: sha512-GEQWEZmfkOGLdd3XK8ryrfWz3AIP8YymVXiPHEdewrUq7mh0qrKrfHLNCXcbB6sTnMLnOZ3ztSiKcciFUkIJwQ==}
 
+  monaco-editor@0.55.1:
+    resolution: {integrity: sha512-jz4x+TJNFHwHtwuV9vA9rMujcZRb0CEilTEwG2rRSpe/A7Jdkuj8xPKttCgOh+v/lkHy7HsZ64oj+q3xoAFl9A==}
+
   mongodb-connection-string-url@3.0.2:
     resolution: {integrity: sha512-rMO7CGo/9BFwyZABcKAWL8UJwH/Kc2x0g72uhDWzG48URRax5TCIcJ7Rc3RZqffZzO/Gwff/jyKwCU9TN8gehA==}
 
@@ -6452,6 +6466,8 @@ snapshots:
 
   '@tempfix/idb@8.0.3': {}
 
+  '@tempfix/webcontainer__api@1.6.1': {}
+
   '@tiptap/core@2.27.1(@tiptap/pm@2.27.1)':
     dependencies:
       '@tiptap/pm': 2.27.1
@@ -7168,6 +7184,10 @@ snapshots:
     dependencies:
       '@leichtgewicht/ip-codec': 2.0.5
 
+  dompurify@3.2.7:
+    optionalDependencies:
+      '@types/trusted-types': 2.0.7
+
   dunder-proto@1.0.1:
     dependencies:
       call-bind-apply-helpers: 1.0.2
@@ -7887,6 +7907,8 @@ snapshots:
 
   markdown-table@3.0.4: {}
 
+  marked@14.0.0: {}
+
   matcher@5.0.0:
     dependencies:
       escape-string-regexp: 5.0.0
@@ -8268,6 +8290,11 @@ snapshots:
 
   monaco-editor@0.52.2: {}
 
+  monaco-editor@0.55.1:
+    dependencies:
+      dompurify: 3.2.7
+      marked: 14.0.0
+
   mongodb-connection-string-url@3.0.2:
     dependencies:
       '@types/whatwg-url': 11.0.5

readme.hints.md

@@ -684,7 +684,7 @@ According to Lit's documentation (https://lit.dev/docs/components/decorators/#de
 
 ## Enhanced AppUI API (2025-12-08)
 
-The `dees-appui-base` component has been enhanced with a unified configuration API for building real-world applications.
+The `dees-appui` component has been enhanced with a unified configuration API for building real-world applications.
 
 ### New Modules:
 
@@ -734,7 +734,7 @@ interface IRoutingConfig {
 }
 ```
 
-### New Public Methods on DeesAppuiBase:
+### New Public Methods on DeesAppui:
 
 ```typescript
 // Configure with unified config
@@ -774,7 +774,7 @@ const config: IAppConfig = {
   statePersistence: { enabled: true, storage: 'localStorage' },
 };
 
-html`<dees-appui-base .config=${config}></dees-appui-base>`;
+html`<dees-appui .config=${config}></dees-appui>`;
 ```
 
 ### Backward Compatibility:
@@ -783,13 +783,13 @@ The existing property-based API still works:
 
 ```typescript
 html`
-  <dees-appui-base
+  <dees-appui
     .mainmenuGroups=${groups}
     .secondarymenuGroups=${secondaryGroups}
     @mainmenu-tab-select=${handler}
   >
     <div slot="maincontent">...</div>
-  </dees-appui-base>
+  </dees-appui>
 `;
 ```
 

readme.md

@@ -1,6 +1,6 @@
 # @design.estate/dees-catalog
 
-A comprehensive web components library built with TypeScript and LitElement, providing **75+ UI components** for building modern web applications with consistent design and behavior. 🚀
+A comprehensive web components library built with TypeScript and LitElement, providing **80+ production-ready UI components** for building modern web applications with consistent design and behavior. 🚀
 
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
 [![LitElement](https://img.shields.io/badge/LitElement-4.0+-orange.svg)](https://lit.dev/)
@@ -53,13 +53,14 @@ For developers working on this library, please refer to the [UI Components Playb
 | Category | Components |
 |----------|------------|
 | **Core UI** | [`DeesButton`](#deesbutton), [`DeesButtonExit`](#deesbuttonexit), [`DeesButtonGroup`](#deesbuttongroup), [`DeesBadge`](#deesbadge), [`DeesChips`](#deeschips), [`DeesHeading`](#deesheading), [`DeesHint`](#deeshint), [`DeesIcon`](#deesicon), [`DeesLabel`](#deeslabel), [`DeesPanel`](#deespanel), [`DeesSearchbar`](#deessearchbar), [`DeesSpinner`](#deesspinner), [`DeesToast`](#deestoast), [`DeesWindowcontrols`](#deeswindowcontrols) |
-| **Forms** | [`DeesForm`](#deesform), [`DeesInputText`](#deesinputtext), [`DeesInputCheckbox`](#deesinputcheckbox), [`DeesInputDropdown`](#deesinputdropdown), [`DeesInputRadiogroup`](#deesinputradiogroup), [`DeesInputFileupload`](#deesinputfileupload), [`DeesInputIban`](#deesinputiban), [`DeesInputPhone`](#deesinputphone), [`DeesInputQuantitySelector`](#deesinputquantityselector), [`DeesInputMultitoggle`](#deesinputmultitoggle), [`DeesInputTags`](#deesinputtags), [`DeesInputTypelist`](#deesinputtypelist), [`DeesInputRichtext`](#deesinputrichtext), [`DeesInputWysiwyg`](#deesinputwysiwyg), [`DeesInputDatepicker`](#deesinputdatepicker), [`DeesInputSearchselect`](#deesinputsearchselect), [`DeesFormSubmit`](#deesformsubmit) |
-| **Layout** | [`DeesAppuiBase`](#deesappuibase), [`DeesAppuiMainmenu`](#deesappuimainmenu), [`DeesAppuiSecondarymenu`](#deesappuisecondarymenu), [`DeesAppuiMaincontent`](#deesappuimaincontent), [`DeesAppuiAppbar`](#deesappuiappbar), [`DeesAppuiActivitylog`](#deesappuiactivitylog), [`DeesAppuiProfiledropdown`](#deesappuiprofiledropdown), [`DeesAppuiTabs`](#deesappuitabs), [`DeesMobileNavigation`](#deesmobilenavigation), [`DeesDashboardGrid`](#deesdashboardgrid) |
+| **Forms** | [`DeesForm`](#deesform), [`DeesInputText`](#deesinputtext), [`DeesInputCheckbox`](#deesinputcheckbox), [`DeesInputDropdown`](#deesinputdropdown), [`DeesInputRadiogroup`](#deesinputradiogroup), [`DeesInputFileupload`](#deesinputfileupload), [`DeesInputIban`](#deesinputiban), [`DeesInputPhone`](#deesinputphone), [`DeesInputQuantitySelector`](#deesinputquantityselector), [`DeesInputMultitoggle`](#deesinputmultitoggle), [`DeesInputTags`](#deesinputtags), [`DeesInputTypelist`](#deesinputtypelist), [`DeesInputList`](#deesinputlist), [`DeesInputProfilepicture`](#deesinputprofilepicture), [`DeesInputRichtext`](#deesinputrichtext), [`DeesInputWysiwyg`](#deesinputwysiwyg), [`DeesInputDatepicker`](#deesinputdatepicker), [`DeesInputSearchselect`](#deesinputsearchselect), [`DeesFormSubmit`](#deesformsubmit) |
+| **Layout** | [`DeesAppui`](#deesappui), [`DeesAppuiMainmenu`](#deesappuimainmenu), [`DeesAppuiSecondarymenu`](#deesappuisecondarymenu), [`DeesAppuiMaincontent`](#deesappuimaincontent), [`DeesAppuiAppbar`](#deesappuiappbar), [`DeesAppuiActivitylog`](#deesappuiactivitylog), [`DeesAppuiProfiledropdown`](#deesappuiprofiledropdown), [`DeesAppuiTabs`](#deesappuitabs), [`DeesMobileNavigation`](#deesmobilenavigation), [`DeesDashboardGrid`](#deesdashboardgrid) |
 | **Data Display** | [`DeesTable`](#deestable), [`DeesDataviewCodebox`](#deesdataviewcodebox), [`DeesDataviewStatusobject`](#deesdataviewstatusobject), [`DeesPdf`](#deespdf), [`DeesStatsGrid`](#deesstatsgrid), [`DeesPagination`](#deespagination) |
 | **Visualization** | [`DeesChartArea`](#deeschartarea), [`DeesChartLog`](#deeschartlog) |
 | **Dialogs & Overlays** | [`DeesModal`](#deesmodal), [`DeesContextmenu`](#deescontextmenu), [`DeesSpeechbubble`](#deesspeechbubble), [`DeesWindowlayer`](#deeswindowlayer) |
 | **Navigation** | [`DeesStepper`](#deesstepper), [`DeesProgressbar`](#deesprogressbar) |
 | **Development** | [`DeesEditor`](#deeseditor), [`DeesEditorMarkdown`](#deeseditormarkdown), [`DeesEditorMarkdownoutlet`](#deeseditormarkdownoutlet), [`DeesTerminal`](#deesterminal), [`DeesUpdater`](#deesupdater) |
+| **Theming** | [`DeesTheme`](#deestheme) |
 | **Auth & Utilities** | [`DeesSimpleAppdash`](#deessimpleappdash), [`DeesSimpleLogin`](#deessimplelogin) |
 | **Shopping** | [`DeesShoppingProductcard`](#deesshoppingproductcard) |
 
@@ -482,6 +483,62 @@ Dynamic list input for managing arrays of typed values.
 ></dees-input-typelist>
 ```
 
+#### `DeesInputList`
+Advanced list input with drag-and-drop reordering, inline editing, and validation.
+
+```typescript
+<dees-input-list
+  key="items"
+  label="List Items"
+  placeholder="Add new item..."
+  .value=${['Item 1', 'Item 2', 'Item 3']}
+  maxItems={10}            // Optional: maximum items
+  minItems={1}             // Optional: minimum items
+  allowDuplicates={false}  // Optional: allow duplicate values
+  sortable={true}          // Optional: enable drag-and-drop reordering
+  confirmDelete={true}     // Optional: confirm before deletion
+  @change=${handleListChange}
+></dees-input-list>
+```
+
+**Key Features:**
+- Add, edit, and remove items inline
+- Drag-and-drop reordering with visual feedback
+- Optional duplicate prevention
+- Min/max item constraints
+- Delete confirmation dialog
+- Full keyboard support
+- Form validation integration
+
+#### `DeesInputProfilepicture`
+Profile picture input with cropping, zoom, and image processing.
+
+```typescript
+<dees-input-profilepicture
+  key="avatar"
+  label="Profile Picture"
+  shape="round"           // Options: round, square
+  size={120}              // Display size in pixels
+  .value=${imageBase64}   // Base64 encoded image or URL
+  allowUpload={true}      // Enable upload button
+  allowDelete={true}      // Enable delete button
+  maxFileSize={5242880}   // Max file size in bytes (5MB)
+  .acceptedFormats=${['image/jpeg', 'image/png', 'image/webp']}
+  outputSize={800}        // Output resolution in pixels
+  outputQuality={0.95}    // JPEG quality (0-1)
+  @change=${handleAvatarChange}
+></dees-input-profilepicture>
+```
+
+**Key Features:**
+- Interactive cropping modal with zoom and pan
+- Drag-and-drop file upload
+- Round or square output shapes
+- Configurable output size and quality
+- File size and format validation
+- Delete functionality
+- Preview on hover
+
 #### `DeesInputDatepicker`
 Date and time picker component with calendar interface and manual typing support.
 
@@ -615,23 +672,23 @@ Submit button component specifically designed for `DeesForm`.
 
 ### Layout Components
 
-#### `DeesAppuiBase`
+#### `DeesAppui`
 A comprehensive application shell component providing a complete UI framework with navigation, menus, activity logging, and view management.
 
-> **Full API Documentation**: See [ts_web/elements/00group-appui/dees-appui-base/readme.md](./ts_web/elements/00group-appui/dees-appui-base/readme.md) for complete documentation including all programmatic APIs, view lifecycle hooks, and TypeScript interfaces.
+> **Full API Documentation**: See [ts_web/elements/00group-appui/dees-appui/readme.md](./ts_web/elements/00group-appui/dees-appui/readme.md) for complete documentation including all programmatic APIs, view lifecycle hooks, and TypeScript interfaces.
 
 **Quick Start:**
 
 ```typescript
 import { html, DeesElement, customElement } from '@design.estate/dees-element';
-import { DeesAppuiBase } from '@design.estate/dees-catalog';
+import { DeesAppui } from '@design.estate/dees-catalog';
 
 @customElement('my-app')
 class MyApp extends DeesElement {
-  private appui: DeesAppuiBase;
+  private appui: DeesAppui;
 
   async firstUpdated() {
-    this.appui = this.shadowRoot.querySelector('dees-appui-base');
+    this.appui = this.shadowRoot.querySelector('dees-appui');
 
     // Configure with views and menu
     this.appui.configure({
@@ -648,7 +705,7 @@ class MyApp extends DeesElement {
   }
 
   render() {
-    return html`<dees-appui-base></dees-appui-base>`;
+    return html`<dees-appui></dees-appui>`;
   }
 }
 ```
@@ -661,6 +718,7 @@ class MyApp extends DeesElement {
 - **Hash-based Routing**: Automatic URL synchronization with view navigation
 - **RxJS Observables**: `viewChanged$` and `viewLifecycle$` for reactive programming
 - **TypeScript-first**: Typed `IViewActivationContext` passed to views on activation
+- **Activity Log Toggle**: Built-in appbar button to show/hide activity panel with entry count badge
 
 **Programmatic APIs include:**
 - `navigateToView(viewId, params?)` - Navigate between views
@@ -670,6 +728,7 @@ class MyApp extends DeesElement {
 - `setSecondaryMenu()`, `setSecondaryMenuCollapsed()`, `setSecondaryMenuVisible()` - Control secondary menu
 - `setContentTabs()`, `setContentTabsVisible()` - Control view-specific UI
 - `activityLog.add()`, `activityLog.addMany()`, `activityLog.clear()` - Manage activity entries
+- `setActivityLogVisible()`, `toggleActivityLog()`, `getActivityLogVisible()` - Control activity panel
 
 **View Visibility Control:**
 ```typescript
@@ -740,7 +799,7 @@ Main content area with tab management support.
 ```
 
 #### `DeesAppuiAppbar`
-Professional application bar component with hierarchical menus, breadcrumb navigation, and user account management.
+Professional application bar component with hierarchical menus, breadcrumb navigation, user account management, and activity log toggle.
 
 ```typescript
 <dees-appui-appbar
@@ -775,6 +834,9 @@ Professional application bar component with hierarchical menus, breadcrumb navig
   .breadcrumbs=${'Project > src > components'}
   .showWindowControls=${true}
   .showSearch=${true}
+  .showActivityLogToggle=${true}
+  .activityLogCount=${5}
+  .activityLogActive=${false}
   .user=${{
     name: 'John Doe',
     avatar: '/path/to/avatar.jpg',
@@ -782,6 +844,7 @@ Professional application bar component with hierarchical menus, breadcrumb navig
   }}
   @menu-select=${(e) => handleMenuSelect(e.detail.item)}
   @breadcrumb-navigate=${(e) => handleBreadcrumbClick(e.detail)}
+  @activity-toggle=${() => handleActivityToggle()}
 ></dees-appui-appbar>
 ```
 
@@ -789,9 +852,40 @@ Professional application bar component with hierarchical menus, breadcrumb navig
 - **Hierarchical Menu System** - Top-level menus with dropdown submenus, icons, and keyboard shortcuts
 - **Keyboard Navigation** - Full keyboard support (Tab, Arrow keys, Enter, Escape)
 - **Breadcrumb Navigation** - Customizable breadcrumb trail with click events
-- **User Account Section** - Avatar with status indicator
+- **User Account Section** - Avatar with status indicator and profile dropdown
+- **Activity Log Toggle** - Button with badge count to show/hide activity panel
 - **Accessibility** - Full ARIA support with menubar roles
 
+#### `DeesAppuiActivitylog`
+Real-time activity log panel for displaying user actions and system events.
+
+```typescript
+<dees-appui-activitylog></dees-appui-activitylog>
+
+// Programmatic API
+activityLog.add({
+  type: 'update',        // Options: login, logout, view, create, update, delete, custom
+  user: 'John Doe',
+  message: 'Updated project settings',
+  iconName: 'lucide:settings'  // Optional: custom icon
+});
+
+activityLog.addMany(entries);  // Add multiple entries
+activityLog.clear();           // Clear all entries
+activityLog.getEntries();      // Get all entries
+activityLog.filter({ user: 'John' });  // Filter by user/type
+activityLog.search('settings');        // Search by message
+```
+
+**Key Features:**
+- Stacked entry layout with icon, user, timestamp, and message
+- Date grouping (Today, Yesterday, etc.)
+- Search and filter functionality
+- Context menu for entry actions
+- Live streaming indicator
+- Animated slide-in/out panel
+- Theme-aware styling
+
 #### `DeesAppuiTabs`
 Reusable tab component with horizontal/vertical layout support.
 
@@ -1089,6 +1183,40 @@ Progress indicator component for tracking completion status.
 
 ---
 
+### Theming Components
+
+#### `DeesTheme`
+Theme provider component that wraps children and provides CSS custom properties for consistent theming.
+
+```typescript
+// Basic usage - wrap your app
+<dees-theme>
+  <my-app></my-app>
+</dees-theme>
+
+// With custom overrides
+<dees-theme
+  .customColors=${{
+    primary: '#007bff',
+    success: '#28a745'
+  }}
+  .customSpacing=${{
+    lg: '24px',
+    xl: '32px'
+  }}
+>
+  <my-section></my-section>
+</dees-theme>
+```
+
+**Key Features:**
+- Provides CSS custom properties for colors, spacing, radius, shadows, and transitions
+- Can be nested for section-specific theming
+- Works with dark/light mode
+- Overrides cascade to all child components
+
+---
+
 ### Development Components
 
 #### `DeesEditor`
@@ -1241,6 +1369,29 @@ interface IMenuGroup {
   collapsed?: boolean;
   iconName?: string;
 }
+
+// View definition for app navigation
+interface IViewDefinition {
+  id: string;
+  name: string;
+  iconName?: string;
+  content: string | HTMLElement | (() => TemplateResult);
+  secondaryMenu?: ISecondaryMenuGroup[];
+  contentTabs?: IMenuItem[];
+  route?: string;
+  badge?: string | number;
+}
+
+// Activity log entry
+interface IActivityEntry {
+  id?: string;
+  timestamp?: Date;
+  type: 'login' | 'logout' | 'view' | 'create' | 'update' | 'delete' | 'custom';
+  user: string;
+  message: string;
+  iconName?: string;
+  data?: Record<string, unknown>;
+}
 ```
 
 ---

scripts/update-monaco-version.cjs

@@ -11,7 +11,7 @@ function resolveMonacoPackageJson() {
     });
     return resolvedPath;
   } catch (error) {
-    console.error('[dees-editor] Unable to resolve monaco-editor/package.json');
+    console.error('[dees-workspace] Unable to resolve monaco-editor/package.json');
     throw error;
   }
 }
@@ -20,25 +20,25 @@ function getMonacoVersion() {
   const monacoPackagePath = resolveMonacoPackageJson();
   const monacoPackage = require(monacoPackagePath);
   if (!monacoPackage.version) {
-    throw new Error('[dees-editor] monaco-editor/package.json does not expose a version field');
+    throw new Error('[dees-workspace] monaco-editor/package.json does not expose a version field');
   }
   return monacoPackage.version;
 }
 
 function writeVersionModule(version) {
-  const targetDir = path.join(projectRoot, 'ts_web', 'elements', 'dees-editor');
+  const targetDir = path.join(projectRoot, 'ts_web', 'elements', '00group-workspace', 'dees-workspace-monaco');
   fs.mkdirSync(targetDir, { recursive: true });
   const targetFile = path.join(targetDir, 'version.ts');
   const fileContent = `// Auto-generated by scripts/update-monaco-version.cjs\nexport const MONACO_VERSION = '${version}';\n`;
   fs.writeFileSync(targetFile, fileContent, 'utf8');
-  console.log(`[dees-editor] Wrote ${path.relative(projectRoot, targetFile)} with monaco-editor@${version}`);
+  console.log(`[dees-workspace] Wrote ${path.relative(projectRoot, targetFile)} with monaco-editor@${version}`);
 }
 
 try {
   const version = getMonacoVersion();
   writeVersionModule(version);
 } catch (error) {
-  console.error('[dees-editor] Failed to update Monaco version module.');
+  console.error('[dees-workspace] Failed to update Monaco version module.');
   console.error(error instanceof Error ? error.message : error);
   process.exitCode = 1;
 }

ts_web/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@design.estate/dees-catalog',
-  version: '3.13.1',
+  version: '3.29.0',
   description: 'A comprehensive library that provides dynamic web components for building sophisticated and modern web applications using JavaScript and TypeScript.'
 }

ts_web/elements/00group-appui/dees-appui-activitylog/dees-appui-activitylog.ts

@@ -39,60 +39,91 @@ export class DeesAppuiActivitylog extends DeesElement implements IActivityLogAPI
     themeDefaultStyles,
     cssManager.defaultStyles,
     css`
-      /* TODO: Migrate hardcoded values to --dees-* CSS variables */
       :host {
-        color: ${cssManager.bdTheme('#09090b', '#fafafa')};
+        /* CSS Variables aligned with secondary menu */
+        --activitylog-bg: ${cssManager.bdTheme('#fafafa', '#0a0a0a')};
+        --activitylog-fg: ${cssManager.bdTheme('#525252', '#a3a3a3')};
+        --activitylog-fg-muted: ${cssManager.bdTheme('#737373', '#737373')};
+        --activitylog-fg-active: ${cssManager.bdTheme('#0a0a0a', '#fafafa')};
+        --activitylog-border: ${cssManager.bdTheme('#e5e5e5', '#1a1a1a')};
+        --activitylog-hover: ${cssManager.bdTheme('rgba(0, 0, 0, 0.04)', 'rgba(255, 255, 255, 0.06)')};
+        --activitylog-accent: ${cssManager.bdTheme('#78716c', '#b5a99a')};
+
+        color: var(--activitylog-fg);
         position: relative;
         display: block;
         width: 100%;
-        max-width: 320px;
         height: 100%;
-        background: ${cssManager.bdTheme('#fafafa', '#0a0a0a')};
-        font-family: 'Geist Mono', monospace;
-        border-left: 1px solid ${cssManager.bdTheme('#e5e7eb', '#27272a')};
+        background: var(--activitylog-bg);
+        font-family: 'Geist Sans', -apple-system, BlinkMacSystemFont, sans-serif;
+        border-left: 1px solid var(--activitylog-border);
         cursor: default;
-        box-shadow: ${cssManager.bdTheme(
-          '-4px 0 12px rgba(0, 0, 0, 0.02)',
-          '-4px 0 12px rgba(0, 0, 0, 0.2)'
-        )};
+        overflow: hidden;
       }
+
       .maincontainer {
         position: absolute;
         top: 0px;
         left: 0px;
         height: 100%;
-        width: 100%;
+        width: 280px;
       }
 
+      /* Header with streaming indicator */
       .topbar {
         position: absolute;
         top: 0px;
         height: 48px;
         width: 100%;
-        padding: 0px 16px;
-        background: ${cssManager.bdTheme('#ffffff', '#09090b')};
-        border-bottom: 1px solid ${cssManager.bdTheme('#e5e7eb', '#27272a')};
+        padding: 0px 12px;
+        background: var(--activitylog-bg);
+        border-bottom: 1px solid var(--activitylog-border);
         display: flex;
         align-items: center;
+        justify-content: space-between;
         box-sizing: border-box;
       }
 
       .topbar .heading {
         font-weight: 600;
         font-size: 14px;
-        font-family: 'Geist Sans', sans-serif;
-        color: ${cssManager.bdTheme('#09090b', '#fafafa')};
+        color: var(--activitylog-fg-active);
       }
 
+      .live-indicator {
+        display: flex;
+        align-items: center;
+        gap: 6px;
+        font-size: 10px;
+        font-weight: 500;
+        text-transform: uppercase;
+        letter-spacing: 0.05em;
+        color: var(--activitylog-fg-muted);
+      }
+
+      .live-indicator .dot {
+        width: 6px;
+        height: 6px;
+        background: ${cssManager.bdTheme('#22c55e', '#22c55e')};
+        border-radius: 50%;
+        animation: pulse 2s ease-in-out infinite;
+      }
+
+      @keyframes pulse {
+        0%, 100% { opacity: 0.5; transform: scale(0.9); }
+        50% { opacity: 1; transform: scale(1.1); }
+      }
+
+      /* Activity container */
       .activityContainer {
         position: absolute;
         top: 48px;
         bottom: 48px;
         width: 100%;
-        padding: 12px 0px;
+        padding: 8px 0;
         overflow-y: auto;
         scrollbar-width: thin;
-        scrollbar-color: ${cssManager.bdTheme('#e5e7eb', '#27272a')} transparent;
+        scrollbar-color: ${cssManager.bdTheme('#d4d4d4', '#333333')} transparent;
       }
 
       .activityContainer::-webkit-scrollbar {
@@ -104,82 +135,53 @@ export class DeesAppuiActivitylog extends DeesElement implements IActivityLogAPI
       }
 
       .activityContainer::-webkit-scrollbar-thumb {
-        background: ${cssManager.bdTheme('#e5e7eb', '#27272a')};
+        background: ${cssManager.bdTheme('#d4d4d4', '#333333')};
         border-radius: 3px;
       }
 
       .activityContainer::-webkit-scrollbar-thumb:hover {
-        background: ${cssManager.bdTheme('#d4d4d8', '#3f3f46')};
+        background: ${cssManager.bdTheme('#a3a3a3', '#525252')};
       }
 
       .empty-state {
         font-size: 13px;
         text-align: center;
-        padding: 32px 16px;
-        color: ${cssManager.bdTheme('#71717a', '#71717a')};
-        font-family: 'Geist Sans', sans-serif;
-      }
-
-      .streamingIndicator {
-        font-size: 11px;
-        text-align: center;
-        padding: 16px;
-        color: ${cssManager.bdTheme('#71717a', '#71717a')};
-        font-family: 'Geist Sans', sans-serif;
-        text-transform: uppercase;
-        letter-spacing: 0.05em;
-        font-weight: 500;
-        display: flex;
-        align-items: center;
-        justify-content: center;
-        gap: 8px;
-      }
-
-      .streamingIndicator::before {
-        content: '';
-        width: 6px;
-        height: 6px;
-        background: ${cssManager.bdTheme('#3b82f6', '#3b82f6')};
-        border-radius: 50%;
-        animation: pulse 2s ease-in-out infinite;
-      }
-
-      @keyframes pulse {
-        0%, 100% { opacity: 0.4; transform: scale(0.8); }
-        50% { opacity: 1; transform: scale(1.2); }
+        padding: 40px 16px;
+        color: var(--activitylog-fg-muted);
       }
 
+      /* Date separator - warm taupe styling */
       .date-separator {
-        padding: 12px 16px 8px;
-        font-size: 11px;
+        padding: 12px 12px 6px;
+        font-size: 10px;
         font-weight: 600;
         text-transform: uppercase;
-        letter-spacing: 0.05em;
-        color: ${cssManager.bdTheme('#71717a', '#71717a')};
-        background: ${cssManager.bdTheme('#f9fafb', '#09090b')};
-        border-bottom: 1px solid ${cssManager.bdTheme('#f4f4f5', '#18181b')};
+        letter-spacing: 0.5px;
+        color: var(--activitylog-accent);
         position: sticky;
         top: 0;
         z-index: 1;
+        background: var(--activitylog-bg);
       }
 
+      /* Activity entry - modern stacked layout */
       .activityentry {
-        min-height: 36px;
-        font-size: 13px;
-        padding: 10px 16px;
-        border-bottom: 1px solid ${cssManager.bdTheme('#f4f4f5', '#18181b')};
-        transition: all 0.15s ease;
+        font-size: 12px;
+        padding: 8px 12px;
+        margin: 2px 4px;
+        border-radius: 6px;
+        transition: background 0.15s ease;
         display: flex;
-        align-items: center;
-        gap: 8px;
+        align-items: flex-start;
+        gap: 10px;
         line-height: 1.4;
-        animation: fadeIn 0.3s ease-out;
+        animation: fadeIn 0.2s ease-out;
       }
 
       @keyframes fadeIn {
         from {
           opacity: 0;
-          transform: translateY(-4px);
+          transform: translateY(-2px);
         }
         to {
           opacity: 1;
@@ -187,88 +189,109 @@ export class DeesAppuiActivitylog extends DeesElement implements IActivityLogAPI
         }
       }
 
-      .activityentry:last-of-type {
-        border-bottom: none;
-      }
-
       .activityentry:hover {
-        background: ${cssManager.bdTheme('#f4f4f5', '#18181b')};
-      }
-
-      .timestamp {
-        color: ${cssManager.bdTheme('#71717a', '#71717a')};
-        font-weight: 500;
-        font-size: 12px;
-        font-variant-numeric: tabular-nums;
-        flex-shrink: 0;
-        min-width: 45px;
+        background: var(--activitylog-hover);
       }
 
       .activity-icon {
         width: 28px;
         height: 28px;
         border-radius: 6px;
-        background: ${cssManager.bdTheme('#f4f4f5', '#18181b')};
+        background: ${cssManager.bdTheme('rgba(0, 0, 0, 0.04)', 'rgba(255, 255, 255, 0.06)')};
         display: flex;
         align-items: center;
         justify-content: center;
         flex-shrink: 0;
-        font-size: 14px;
+        font-size: 13px;
+        color: var(--activitylog-fg-muted);
+        margin-top: 1px;
       }
 
       .activity-icon.login {
-        background: ${cssManager.bdTheme('rgba(34, 197, 94, 0.1)', 'rgba(34, 197, 94, 0.1)')};
-        color: ${cssManager.bdTheme('#16a34a', '#22c55e')};
+        background: ${cssManager.bdTheme('rgba(34, 197, 94, 0.08)', 'rgba(34, 197, 94, 0.12)')};
+        color: ${cssManager.bdTheme('#16a34a', '#4ade80')};
       }
 
       .activity-icon.logout {
-        background: ${cssManager.bdTheme('rgba(239, 68, 68, 0.1)', 'rgba(239, 68, 68, 0.1)')};
-        color: ${cssManager.bdTheme('#dc2626', '#ef4444')};
+        background: ${cssManager.bdTheme('rgba(239, 68, 68, 0.08)', 'rgba(239, 68, 68, 0.12)')};
+        color: ${cssManager.bdTheme('#dc2626', '#f87171')};
       }
 
       .activity-icon.view {
-        background: ${cssManager.bdTheme('rgba(59, 130, 246, 0.1)', 'rgba(59, 130, 246, 0.1)')};
-        color: ${cssManager.bdTheme('#2563eb', '#3b82f6')};
+        background: ${cssManager.bdTheme('rgba(59, 130, 246, 0.08)', 'rgba(59, 130, 246, 0.12)')};
+        color: ${cssManager.bdTheme('#2563eb', '#60a5fa')};
       }
 
       .activity-icon.create {
-        background: ${cssManager.bdTheme('rgba(168, 85, 247, 0.1)', 'rgba(168, 85, 247, 0.1)')};
-        color: ${cssManager.bdTheme('#9333ea', '#a855f7')};
+        background: ${cssManager.bdTheme('rgba(168, 85, 247, 0.08)', 'rgba(168, 85, 247, 0.12)')};
+        color: ${cssManager.bdTheme('#9333ea', '#c084fc')};
       }
 
       .activity-icon.update {
-        background: ${cssManager.bdTheme('rgba(251, 146, 60, 0.1)', 'rgba(251, 146, 60, 0.1)')};
+        background: ${cssManager.bdTheme('rgba(251, 146, 60, 0.08)', 'rgba(251, 146, 60, 0.12)')};
         color: ${cssManager.bdTheme('#ea580c', '#fb923c')};
       }
 
       .activity-icon.delete {
-        background: ${cssManager.bdTheme('rgba(239, 68, 68, 0.1)', 'rgba(239, 68, 68, 0.1)')};
-        color: ${cssManager.bdTheme('#dc2626', '#ef4444')};
+        background: ${cssManager.bdTheme('rgba(239, 68, 68, 0.08)', 'rgba(239, 68, 68, 0.12)')};
+        color: ${cssManager.bdTheme('#dc2626', '#f87171')};
       }
 
       .activity-icon.custom {
-        background: ${cssManager.bdTheme('rgba(100, 116, 139, 0.1)', 'rgba(100, 116, 139, 0.1)')};
+        background: ${cssManager.bdTheme('rgba(100, 116, 139, 0.08)', 'rgba(100, 116, 139, 0.12)')};
         color: ${cssManager.bdTheme('#475569', '#94a3b8')};
       }
 
-      .activity-text {
+      .activity-content {
         flex: 1;
-        color: ${cssManager.bdTheme('#18181b', '#e4e4e7')};
+        min-width: 0;
+        display: flex;
+        flex-direction: column;
+        gap: 2px;
+      }
+
+      .activity-header {
+        display: flex;
+        align-items: center;
+        gap: 6px;
       }
 
       .activity-user {
         font-weight: 600;
-        color: ${cssManager.bdTheme('#09090b', '#fafafa')};
+        font-size: 12px;
+        color: var(--activitylog-fg-active);
       }
 
+      .activity-separator {
+        color: var(--activitylog-fg-muted);
+        font-size: 10px;
+      }
+
+      .timestamp {
+        color: var(--activitylog-fg-muted);
+        font-weight: 400;
+        font-size: 11px;
+        font-variant-numeric: tabular-nums;
+        font-family: 'Geist Mono', monospace;
+      }
+
+      .activity-message {
+        color: var(--activitylog-fg);
+        font-size: 12px;
+        line-height: 1.5;
+        word-break: break-word;
+      }
+
+      /* Search box - refined styling */
       .searchbox {
         position: absolute;
         bottom: 0px;
         width: 100%;
         height: 48px;
-        background: ${cssManager.bdTheme('#ffffff', '#09090b')};
-        border-top: 1px solid ${cssManager.bdTheme('#e5e7eb', '#27272a')};
-        padding: 8px;
+        background: var(--activitylog-bg);
+        border-top: 1px solid var(--activitylog-border);
+        padding: 8px 12px;
+        box-sizing: border-box;
       }
 
       .search-wrapper {
@@ -282,64 +305,37 @@ export class DeesAppuiActivitylog extends DeesElement implements IActivityLogAPI
         left: 10px;
         top: 50%;
         transform: translateY(-50%);
-        color: ${cssManager.bdTheme('#71717a', '#71717a')};
-        font-size: 14px;
+        color: var(--activitylog-fg-muted);
+        font-size: 13px;
         pointer-events: none;
         transition: color 0.15s ease;
       }
 
       .searchbox input {
-        color: ${cssManager.bdTheme('#09090b', '#fafafa')};
-        background: ${cssManager.bdTheme('#f4f4f5', '#18181b')};
+        color: var(--activitylog-fg-active);
+        background: ${cssManager.bdTheme('rgba(0, 0, 0, 0.03)', 'rgba(255, 255, 255, 0.04)')};
         width: 100%;
         height: 100%;
-        border: 1px solid ${cssManager.bdTheme('#e5e7eb', '#27272a')};
+        border: 1px solid ${cssManager.bdTheme('rgba(0, 0, 0, 0.08)', 'rgba(255, 255, 255, 0.08)')};
         border-radius: 6px;
-        padding: 0 12px 0 36px;
+        padding: 0 12px 0 34px;
         font-family: 'Geist Sans', sans-serif;
-        font-size: 13px;
+        font-size: 12px;
         transition: all 0.15s ease;
       }
 
       .searchbox input::placeholder {
-        color: ${cssManager.bdTheme('#71717a', '#71717a')};
+        color: var(--activitylog-fg-muted);
       }
 
       .searchbox input:focus {
         outline: none;
-        border-color: ${cssManager.bdTheme('#3b82f6', '#3b82f6')};
-        box-shadow: 0 0 0 3px ${cssManager.bdTheme('rgba(59, 130, 246, 0.1)', 'rgba(59, 130, 246, 0.1)')};
+        border-color: ${cssManager.bdTheme('rgba(0, 0, 0, 0.15)', 'rgba(255, 255, 255, 0.15)')};
+        background: ${cssManager.bdTheme('rgba(0, 0, 0, 0.02)', 'rgba(255, 255, 255, 0.06)')};
       }
 
-      .searchbox input:focus ~ .search-icon,
       .search-wrapper:has(input:focus) .search-icon {
-        color: ${cssManager.bdTheme('#3b82f6', '#3b82f6')};
-      }
-
-      .bottomShadow {
-        position: absolute;
-        width: 100%;
-        height: 24px;
-        bottom: 48px;
-        background: ${cssManager.bdTheme(
-          'linear-gradient(180deg, transparent 0%, #fafafa 100%)',
-          'linear-gradient(180deg, transparent 0%, #0a0a0a 100%)'
-        )};
-        pointer-events: none;
-        opacity: 0.8;
-      }
-
-      .topShadow {
-        position: absolute;
-        width: 100%;
-        height: 24px;
-        top: 48px;
-        background: ${cssManager.bdTheme(
-          'linear-gradient(0deg, transparent 0%, #fafafa 100%)',
-          'linear-gradient(0deg, transparent 0%, #0a0a0a 100%)'
-        )};
-        pointer-events: none;
-        opacity: 0.8;
+        color: var(--activitylog-fg);
       }
     `,
   ];
@@ -355,12 +351,11 @@ export class DeesAppuiActivitylog extends DeesElement implements IActivityLogAPI
       <div class="maincontainer">
         <div class="topbar">
           <div class="heading">Activity Log</div>
+          ${filteredEntries.length > 0
+            ? html`<div class="live-indicator"><span class="dot"></span>Live</div>`
+            : ''}
         </div>
         <div class="activityContainer">
-          ${filteredEntries.length > 0
-            ? html`<div class="streamingIndicator">Live Updates</div>`
-            : ''}
-
           ${filteredEntries.length === 0
             ? html`<div class="empty-state">No activity entries</div>`
             : groupedEntries.map(
@@ -381,8 +376,6 @@ export class DeesAppuiActivitylog extends DeesElement implements IActivityLogAPI
             />
           </div>
         </div>
-        <div class="topShadow"></div>
-        <div class="bottomShadow"></div>
       </div>
     `;
   }
@@ -397,12 +390,16 @@ export class DeesAppuiActivitylog extends DeesElement implements IActivityLogAPI
         class="activityentry"
         @contextmenu=${(e: MouseEvent) => this.handleContextMenu(e, entry)}
       >
-        <span class="timestamp">${timeStr}</span>
         <div class="activity-icon ${entry.type}">
           <dees-icon .icon=${iconName}></dees-icon>
         </div>
-        <div class="activity-text">
-          <span class="activity-user">${entry.user}</span> ${entry.message}
+        <div class="activity-content">
+          <div class="activity-header">
+            <span class="activity-user">${entry.user}</span>
+            <span class="activity-separator">·</span>
+            <span class="timestamp">${timeStr}</span>
+          </div>
+          <div class="activity-message">${entry.message}</div>
         </div>
       </div>
     `;

ts_web/elements/00group-appui/dees-appui-appbar/component.ts

@@ -57,6 +57,16 @@ export class DeesAppuiBar extends DeesElement {
   @property({ type: Boolean })
   accessor showSearch: boolean = false;
 
+  // Activity log toggle
+  @property({ type: Boolean })
+  accessor showActivityLogToggle: boolean = false;
+
+  @property({ type: Number })
+  accessor activityLogCount: number = 0;
+
+  @property({ type: Boolean })
+  accessor activityLogActive: boolean = false;
+
   // STATE
   @state()
   accessor activeMenu: string | null = null;
@@ -206,6 +216,18 @@ export class DeesAppuiBar extends DeesElement {
           ></dees-appui-profiledropdown>
         </div>
       ` : ''}
+      ${this.showActivityLogToggle ? html`
+        <div
+          class="activity-toggle ${this.activityLogActive ? 'active' : ''}"
+          @click=${this.handleActivityToggle}
+          title="Activity Log"
+        >
+          <dees-icon .icon=${'lucide:activity'}></dees-icon>
+          ${this.activityLogCount > 0 ? html`
+            <span class="activity-badge">${this.activityLogCount > 99 ? '99+' : this.activityLogCount}</span>
+          ` : ''}
+        </div>
+      ` : ''}
     `;
   }
 
@@ -310,6 +332,13 @@ export class DeesAppuiBar extends DeesElement {
     }));
   }
 
+  private handleActivityToggle() {
+    this.dispatchEvent(new CustomEvent('activity-toggle', {
+      bubbles: true,
+      composed: true
+    }));
+  }
+
   private handleUserClick() {
     this.isProfileDropdownOpen = !this.isProfileDropdownOpen;
     

ts_web/elements/00group-appui/dees-appui-appbar/styles.ts

@@ -17,7 +17,7 @@ export const appuiAppbarStyles = [
         color: ${cssManager.bdTheme('#00000080', '#ffffff80')};
         font-size: var(--appbar-font-size);
         display: grid;
-        grid-template-columns: ${cssManager.cssGridColumns(3, 20)};
+        grid-template-columns: auto 1fr auto;
         -webkit-app-region: drag;
         user-select: none;
       }
@@ -233,6 +233,54 @@ export const appuiAppbarStyles = [
       .user-status.away {
         background: #ff9800;
       }
+
+      /* Activity log toggle button */
+      .activity-toggle {
+        display: flex;
+        align-items: center;
+        gap: 2px;
+        height: 28px;
+        padding: 0 8px;
+        border-radius: 6px;
+        cursor: default;
+        -webkit-app-region: no-drag;
+        color: ${cssManager.bdTheme('#00000060', '#ffffff60')};
+        border: 1px solid ${cssManager.bdTheme('rgba(0, 0, 0, 0.1)', 'rgba(255, 255, 255, 0.1)')};
+        transition: all 0.15s ease;
+      }
+
+      .activity-toggle:hover {
+        background: ${cssManager.bdTheme('#00000010', '#ffffff15')};
+        color: ${cssManager.bdTheme('#000000', '#ffffff')};
+        border-color: transparent;
+      }
+
+      .activity-toggle.active {
+        background: ${cssManager.bdTheme('#00000015', '#ffffff20')};
+        color: ${cssManager.bdTheme('#000000', '#ffffff')};
+        border-color: transparent;
+      }
+
+      .activity-toggle dees-icon {
+        font-size: 14px;
+      }
+
+      .activity-badge {
+        position: relative;
+        margin-left: 4px;
+        min-width: 16px;
+        height: 16px;
+        padding: 0 4px;
+        background: ${cssManager.bdTheme('#525252', '#525252')};
+        color: #fafafa;
+        font-size: 10px;
+        font-weight: 600;
+        border-radius: 8px;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        line-height: 1;
+      }
     `,
   ];
 

ts_web/elements/00group-appui/dees-appui-base/index.ts

@@ -1,2 +0,0 @@
-export * from './dees-appui-base.js';
-export * from './view.registry.js';

ts_web/elements/00group-appui/dees-appui-maincontent/dees-appui-maincontent.ts

@@ -85,6 +85,7 @@ export class DeesAppuiMaincontent extends DeesElement {
       .content-area {
         overflow: auto;
         min-height: 0;
+        overscroll-behavior: contain;
       }
 
       :host([notabs]) .topbar {

ts_web/elements/00group-appui/dees-appui-secondarymenu/dees-appui-secondarymenu.demo.ts

@@ -12,41 +12,102 @@ export const demoFunc = () => html`
     .demo-secondarymenu-container .spacer {
       flex: 1;
       background: #0f0f0f;
+      padding: 20px;
+      color: #a3a3a3;
+      font-family: 'Geist Sans', sans-serif;
+    }
+    .demo-secondarymenu-container .spacer h3 {
+      color: #fafafa;
+      margin-top: 0;
+    }
+    .demo-secondarymenu-container .spacer code {
+      background: #27272a;
+      padding: 2px 6px;
+      border-radius: 4px;
+      font-size: 12px;
+    }
+    .demo-secondarymenu-container .spacer ul {
+      line-height: 1.8;
     }
   </style>
   <div class="demo-secondarymenu-container">
     <dees-appui-secondarymenu
       .heading=${'Projects'}
       .groups=${[
+        // Group 1: Tab items (default behavior)
         {
-          name: 'Active',
-          iconName: 'lucide:folder',
+          name: 'Navigation',
+          iconName: 'lucide:compass',
           items: [
-            { key: 'Frontend App', iconName: 'code', action: () => console.log('Frontend'), badge: 3, badgeVariant: 'warning' },
-            { key: 'API Server', iconName: 'server', action: () => console.log('API'), badge: 'new', badgeVariant: 'success' },
-            { key: 'Database', iconName: 'database', action: () => console.log('Database') },
-          ]
+            { key: 'Dashboard', iconName: 'lucide:layoutDashboard', action: () => console.log('Dashboard clicked'), badge: 3, badgeVariant: 'warning' },
+            { key: 'Projects', iconName: 'lucide:folder', action: () => console.log('Projects clicked'), badge: 'new', badgeVariant: 'success' },
+            { key: 'Analytics', iconName: 'lucide:barChart2', action: () => console.log('Analytics clicked') },
+          ] as interfaces.ISecondaryMenuItemTab[]
         },
+        // Group 2: Actions
         {
-          name: 'Archived',
-          iconName: 'lucide:archive',
+          name: 'Actions',
+          iconName: 'lucide:zap',
+          items: [
+            { type: 'action', key: 'Create New', iconName: 'lucide:plus', action: () => alert('Create New clicked!') },
+            { type: 'action', key: 'Import Data', iconName: 'lucide:upload', action: () => alert('Import Data clicked!') },
+            { type: 'divider' },
+            { type: 'action', key: 'Delete All', iconName: 'lucide:trash2', variant: 'danger', confirmMessage: 'Are you sure you want to delete all items?', action: () => alert('Deleted!') },
+          ] as interfaces.ISecondaryMenuItem[]
+        },
+        // Group 3: Filters
+        {
+          name: 'Filters',
+          iconName: 'lucide:filter',
+          items: [
+            { type: 'header', label: 'Status' },
+            { type: 'filter', key: 'Show Active', iconName: 'lucide:checkCircle', active: true, onToggle: (active) => console.log('Show Active:', active) },
+            { type: 'filter', key: 'Show Archived', iconName: 'lucide:archive', active: false, onToggle: (active) => console.log('Show Archived:', active) },
+            { type: 'divider' },
+            { type: 'multiFilter', key: 'Categories', iconName: 'lucide:tag', collapsed: false, options: [
+              { key: 'frontend', label: 'Frontend', checked: true, iconName: 'lucide:monitor' },
+              { key: 'backend', label: 'Backend', checked: true, iconName: 'lucide:server' },
+              { key: 'devops', label: 'DevOps', checked: false, iconName: 'lucide:cloud' },
+              { key: 'design', label: 'Design', checked: false, iconName: 'lucide:palette' },
+            ], onChange: (keys) => console.log('Selected categories:', keys) },
+          ] as interfaces.ISecondaryMenuItem[]
+        },
+        // Group 4: Links and misc
+        {
+          name: 'Resources',
+          iconName: 'lucide:bookOpen',
           collapsed: true,
           items: [
-            { key: 'Legacy System', iconName: 'box', action: () => console.log('Legacy') },
-            { key: 'Old API', iconName: 'server', action: () => console.log('Old API') },
-          ]
-        },
-        {
-          name: 'Settings',
-          iconName: 'lucide:settings',
-          items: [
-            { key: 'Configuration', iconName: 'sliders', action: () => console.log('Config') },
-            { key: 'Integrations', iconName: 'plug', action: () => console.log('Integrations'), badge: 5, badgeVariant: 'error' },
-          ]
+            { type: 'header', label: 'Documentation' },
+            { type: 'link', key: 'API Reference', iconName: 'lucide:fileText', href: 'https://api.example.com/docs' },
+            { type: 'link', key: 'User Guide', iconName: 'lucide:book', href: 'https://docs.example.com/guide' },
+            { type: 'divider' },
+            { type: 'header', label: 'Support' },
+            { type: 'link', key: 'Help Center', iconName: 'lucide:helpCircle', href: '/help', external: false },
+            { type: 'link', key: 'GitHub Issues', iconName: 'lucide:github', href: 'https://github.com/example/issues' },
+          ] as interfaces.ISecondaryMenuItem[]
         }
-      ] as interfaces.IMenuGroup[]}
-      @item-select=${(e: CustomEvent) => console.log('Selected:', e.detail)}
+      ] as interfaces.ISecondaryMenuGroup[]}
+      @item-select=${(e: CustomEvent) => console.log('Tab selected:', e.detail)}
+      @action-click=${(e: CustomEvent) => console.log('Action clicked:', e.detail)}
+      @filter-toggle=${(e: CustomEvent) => console.log('Filter toggled:', e.detail)}
+      @multifilter-change=${(e: CustomEvent) => console.log('Multi-filter changed:', e.detail)}
+      @link-click=${(e: CustomEvent) => console.log('Link clicked:', e.detail)}
     ></dees-appui-secondarymenu>
-    <div class="spacer"></div>
+    <div class="spacer">
+      <h3>Secondary Menu Demo</h3>
+      <p>This demo showcases all 8 item types:</p>
+      <ul>
+        <li><code>tab</code> - Selectable items (Navigation group)</li>
+        <li><code>action</code> - Blue actions (Actions group)</li>
+        <li><code>action</code> with <code>variant: 'danger'</code> - Red danger action</li>
+        <li><code>filter</code> - Checkbox toggles (Filters group)</li>
+        <li><code>multiFilter</code> - Collapsible multi-select (Categories)</li>
+        <li><code>divider</code> - Visual separators</li>
+        <li><code>header</code> - Section labels</li>
+        <li><code>link</code> - External/internal links (Resources group)</li>
+      </ul>
+      <p>Try the collapse toggle on the left edge!</p>
+    </div>
   </div>
 `;

ts_web/elements/00group-appui/dees-appui-secondarymenu/dees-appui-secondarymenu.ts

@@ -19,7 +19,16 @@ import { themeDefaultStyles } from '../../00theme.js';
 
 /**
  * Secondary navigation menu for sub-navigation within MainMenu views
- * Supports collapsible groups, badges, and dynamic headings
+ *
+ * Supports 8 item types:
+ * 1. Tab - selectable, stays highlighted (default)
+ * 2. Action - executes without selection (blue)
+ * 3. Danger Action - red styling with optional confirmation
+ * 4. Filter - checkbox toggle
+ * 5. Multi-Filter - collapsible box with multiple checkboxes
+ * 6. Divider - visual separator
+ * 7. Header - non-interactive label
+ * 8. Link - opens URL
  */
 @customElement('dees-appui-secondarymenu')
 export class DeesAppuiSecondarymenu extends DeesElement {
@@ -31,22 +40,30 @@ export class DeesAppuiSecondarymenu extends DeesElement {
   @property({ type: String })
   accessor heading: string = 'Menu';
 
-  /** Grouped items with collapse support */
+  /** Grouped items with collapse support - supports new ISecondaryMenuGroup */
   @property({ type: Array })
-  accessor groups: interfaces.IMenuGroup[] = [];
+  accessor groups: interfaces.ISecondaryMenuGroup[] = [];
 
   /** Legacy flat list support for backward compatibility */
   @property({ type: Array })
   accessor selectionOptions: (interfaces.IMenuItem | { divider: true })[] = [];
 
-  /** Currently selected item */
+  /** Currently selected tab item */
   @property({ type: Object })
-  accessor selectedItem: interfaces.IMenuItem | null = null;
+  accessor selectedItem: interfaces.ISecondaryMenuItemTab | null = null;
 
   /** Internal state for collapsed groups */
   @state()
   accessor collapsedGroups: Set<string> = new Set();
 
+  /** Internal state for collapsed multi-filters */
+  @state()
+  accessor collapsedMultiFilters: Set<string> = new Set();
+
+  /** Render counter to force re-renders when items are mutated */
+  @state()
+  private accessor renderCounter: number = 0;
+
   /** Horizontal collapse state */
   @property({ type: Boolean, reflect: true })
   accessor collapsed: boolean = false;
@@ -80,6 +97,12 @@ export class DeesAppuiSecondarymenu extends DeesElement {
         --badge-error-bg: ${cssManager.bdTheme('#fee2e2', '#450a0a')};
         --badge-error-fg: ${cssManager.bdTheme('#991b1b', '#f87171')};
 
+        /* Action colors */
+        --action-primary: ${cssManager.bdTheme('#2563eb', '#3b82f6')};
+        --action-primary-hover: ${cssManager.bdTheme('#1d4ed8', '#60a5fa')};
+        --action-danger: ${cssManager.bdTheme('#dc2626', '#ef4444')};
+        --action-danger-hover: ${cssManager.bdTheme('#b91c1c', '#f87171')};
+
         position: relative;
         display: block;
         height: 100%;
@@ -212,7 +235,7 @@ export class DeesAppuiSecondarymenu extends DeesElement {
         display: flex;
         align-items: center;
         justify-content: space-between;
-        padding: 8px 8px;
+        padding: 8px 12px;
         cursor: pointer;
         border-radius: 6px;
         transition: background 0.15s ease, opacity 0.2s ease, max-height 0.25s ease;
@@ -220,7 +243,14 @@ export class DeesAppuiSecondarymenu extends DeesElement {
       }
 
       .groupHeader:hover {
-        background: var(--sidebar-hover);
+        border: 1px solid ${cssManager.bdTheme('rgba(140, 120, 100, 0.06)', 'rgba(180, 160, 140, 0.08)')};
+        padding: 7px 11px;
+      }
+
+      .groupHeader:not(.collapsed) {
+        background: ${cssManager.bdTheme('rgba(140, 120, 100, 0.06)', 'rgba(180, 160, 140, 0.08)')};
+        border: none;
+        padding: 8px 12px;
       }
 
       .groupHeader .groupTitle {
@@ -229,7 +259,7 @@ export class DeesAppuiSecondarymenu extends DeesElement {
         gap: 8px;
         font-size: 11px;
         font-weight: 600;
-        color: var(--sidebar-fg-muted);
+        color: ${cssManager.bdTheme('#78716c', '#b5a99a')};
         text-transform: uppercase;
         letter-spacing: 0.5px;
         white-space: nowrap;
@@ -237,14 +267,14 @@ export class DeesAppuiSecondarymenu extends DeesElement {
       }
 
       .groupHeader .groupTitle dees-icon {
-        font-size: 14px;
-        opacity: 0.7;
+        font-size: 16px;
+        color: ${cssManager.bdTheme('#78716c', '#b5a99a')};
       }
 
       .groupHeader .chevron {
         font-size: 12px;
         transition: transform 0.2s ease;
-        color: var(--sidebar-fg-muted);
+        color: ${cssManager.bdTheme('#78716c', '#b5a99a')};
       }
 
       .groupHeader.collapsed .chevron {
@@ -263,14 +293,16 @@ export class DeesAppuiSecondarymenu extends DeesElement {
       /* Group Items Container */
       .groupItems {
         overflow: hidden;
-        transition: max-height 0.25s ease, opacity 0.2s ease;
-        max-height: 500px;
+        transition: max-height 0.25s ease, opacity 0.2s ease, margin 0.25s ease;
+        max-height: 1000px;
         opacity: 1;
+        margin-bottom: 12px;
       }
 
       .groupItems.collapsed {
         max-height: 0;
         opacity: 0;
+        margin-bottom: 0;
       }
 
       /* Always show items when horizontally collapsed (regardless of group collapse state) */
@@ -279,7 +311,7 @@ export class DeesAppuiSecondarymenu extends DeesElement {
         opacity: 1;
       }
 
-      /* Menu Item */
+      /* Menu Item Base */
       .menuItem {
         position: relative;
         display: flex;
@@ -304,6 +336,12 @@ export class DeesAppuiSecondarymenu extends DeesElement {
         background: var(--sidebar-active);
       }
 
+      .menuItem.disabled {
+        opacity: 0.5;
+        cursor: not-allowed;
+        pointer-events: none;
+      }
+
       .menuItem.selected {
         background: var(--sidebar-active);
         color: var(--sidebar-fg-active);
@@ -340,6 +378,208 @@ export class DeesAppuiSecondarymenu extends DeesElement {
         transition: opacity 0.2s ease, width 0.25s ease;
       }
 
+      /* Action Item Styles */
+      .menuItem.action-primary {
+        color: var(--action-primary);
+      }
+
+      .menuItem.action-primary:hover {
+        color: var(--action-primary-hover);
+        background: ${cssManager.bdTheme('rgba(37, 99, 235, 0.08)', 'rgba(59, 130, 246, 0.12)')};
+      }
+
+      .menuItem.action-primary dees-icon {
+        opacity: 1;
+      }
+
+      .menuItem.action-danger {
+        color: var(--action-danger);
+      }
+
+      .menuItem.action-danger:hover {
+        color: var(--action-danger-hover);
+        background: ${cssManager.bdTheme('rgba(220, 38, 38, 0.08)', 'rgba(239, 68, 68, 0.12)')};
+      }
+
+      .menuItem.action-danger dees-icon {
+        opacity: 1;
+      }
+
+      /* Filter Item Styles */
+      .menuItem.filter {
+        justify-content: space-between;
+      }
+
+      .menuItem.filter .filter-checkbox {
+        width: 16px;
+        height: 16px;
+        border: 2px solid ${cssManager.bdTheme('#d4d4d4', '#525252')};
+        border-radius: 4px;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        transition: all 0.15s ease;
+        flex-shrink: 0;
+      }
+
+      .menuItem.filter .filter-checkbox.checked {
+        background: var(--sidebar-accent);
+        border-color: var(--sidebar-accent);
+      }
+
+      .menuItem.filter .filter-checkbox dees-icon {
+        font-size: 12px;
+        color: ${cssManager.bdTheme('#fafafa', '#0a0a0a')};
+        opacity: 1;
+      }
+
+      .menuItem.filter.active {
+        color: var(--sidebar-fg-active);
+      }
+
+      /* Multi-Filter Container */
+      .multiFilter {
+        margin: 4px 0;
+        border: 1px solid var(--sidebar-border);
+        border-radius: 8px;
+        overflow: hidden;
+        background: ${cssManager.bdTheme('rgba(0, 0, 0, 0.02)', 'rgba(255, 255, 255, 0.02)')};
+      }
+
+      .multiFilter-header {
+        display: flex;
+        align-items: center;
+        justify-content: space-between;
+        padding: 10px 12px;
+        cursor: pointer;
+        transition: background 0.15s ease;
+      }
+
+      .multiFilter-header:hover {
+        background: var(--sidebar-hover);
+      }
+
+      .multiFilter-header .multiFilter-title {
+        display: flex;
+        align-items: center;
+        gap: 8px;
+        font-size: 13px;
+        font-weight: 500;
+        color: var(--sidebar-fg-active);
+      }
+
+      .multiFilter-header .multiFilter-title dees-icon {
+        font-size: 16px;
+        opacity: 0.7;
+      }
+
+      .multiFilter-header .multiFilter-count {
+        font-size: 11px;
+        color: var(--sidebar-fg-muted);
+        background: var(--badge-default-bg);
+        padding: 2px 6px;
+        border-radius: 4px;
+      }
+
+      .multiFilter-header .chevron {
+        font-size: 12px;
+        transition: transform 0.2s ease;
+        color: var(--sidebar-fg-muted);
+      }
+
+      .multiFilter-header.collapsed .chevron {
+        transform: rotate(-90deg);
+      }
+
+      .multiFilter-options {
+        border-top: 1px solid var(--sidebar-border);
+        overflow: hidden;
+        transition: max-height 0.25s ease, opacity 0.2s ease;
+        max-height: 500px;
+        opacity: 1;
+      }
+
+      .multiFilter-options.collapsed {
+        max-height: 0;
+        opacity: 0;
+        border-top: none;
+      }
+
+      .multiFilter-option {
+        display: flex;
+        align-items: center;
+        gap: 10px;
+        padding: 8px 12px;
+        cursor: pointer;
+        transition: background 0.15s ease;
+        font-size: 13px;
+        color: var(--sidebar-fg);
+      }
+
+      .multiFilter-option:hover {
+        background: var(--sidebar-hover);
+        color: var(--sidebar-fg-active);
+      }
+
+      .multiFilter-option .option-checkbox {
+        width: 16px;
+        height: 16px;
+        border: 2px solid ${cssManager.bdTheme('#d4d4d4', '#525252')};
+        border-radius: 4px;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        transition: all 0.15s ease;
+        flex-shrink: 0;
+      }
+
+      .multiFilter-option .option-checkbox.checked {
+        background: var(--sidebar-accent);
+        border-color: var(--sidebar-accent);
+      }
+
+      .multiFilter-option .option-checkbox dees-icon {
+        font-size: 12px;
+        color: ${cssManager.bdTheme('#fafafa', '#0a0a0a')};
+      }
+
+      .multiFilter-option dees-icon.option-icon {
+        font-size: 14px;
+        opacity: 0.7;
+      }
+
+      /* Divider */
+      .menuDivider {
+        height: 1px;
+        background: var(--sidebar-border);
+        margin: 8px 12px;
+      }
+
+      :host([collapsed]) .menuDivider {
+        margin: 8px 4px;
+      }
+
+      /* Header/Label */
+      .menuHeader {
+        padding: 12px 12px 4px 12px;
+        font-size: 10px;
+        font-weight: 600;
+        color: var(--sidebar-fg-muted);
+        text-transform: uppercase;
+        letter-spacing: 0.5px;
+      }
+
+      :host([collapsed]) .menuHeader {
+        display: none;
+      }
+
+      /* Link Item */
+      .menuItem.link .external-icon {
+        font-size: 12px;
+        opacity: 0.5;
+        margin-left: auto;
+      }
+
       /* Collapsed menu item styles */
       :host([collapsed]) .menuItem {
         justify-content: center;
@@ -357,6 +597,15 @@ export class DeesAppuiSecondarymenu extends DeesElement {
         left: -4px;
       }
 
+      :host([collapsed]) .menuItem .filter-checkbox,
+      :host([collapsed]) .menuItem .external-icon {
+        display: none;
+      }
+
+      :host([collapsed]) .multiFilter {
+        display: none;
+      }
+
       /* Tooltip for collapsed state */
       .item-tooltip {
         position: absolute;
@@ -431,17 +680,17 @@ export class DeesAppuiSecondarymenu extends DeesElement {
         display: none;
       }
 
-      /* Divider */
+      /* Legacy options container */
+      .legacyOptions {
+        padding: 0 8px;
+      }
+
+      /* Divider (legacy) */
       .divider {
         height: 1px;
         background: var(--sidebar-border);
         margin: 8px 12px;
       }
-
-      /* Legacy options container */
-      .legacyOptions {
-        padding: 0 8px;
-      }
     `,
   ];
 
@@ -472,28 +721,58 @@ export class DeesAppuiSecondarymenu extends DeesElement {
             @click="${() => this.toggleGroup(group.name)}"
           >
             <span class="groupTitle">
-              ${group.iconName ? html`<dees-icon .icon="${group.iconName.startsWith('lucide:') ? group.iconName : `lucide:${group.iconName}`}"></dees-icon>` : ''}
+              ${group.iconName ? html`<dees-icon .icon="${this.normalizeIcon(group.iconName)}"></dees-icon>` : ''}
               ${group.name}
             </span>
             <dees-icon class="chevron" .icon="${'lucide:chevronDown'}"></dees-icon>
           </div>
           <div class="groupItems ${this.collapsedGroups.has(group.name) ? 'collapsed' : ''}">
-            ${group.items.map((item) => this.renderMenuItem(item, group))}
+            ${group.items.map((item) => this.renderItem(item, group))}
           </div>
         </div>
       `)}
     `;
   }
 
-  private renderMenuItem(item: interfaces.IMenuItem, group?: interfaces.IMenuGroup): TemplateResult {
+  private renderItem(item: interfaces.ISecondaryMenuItem, group?: interfaces.ISecondaryMenuGroup): TemplateResult {
+    // Check for hidden items
+    if ('hidden' in item && item.hidden) {
+      return html``;
+    }
+
+    // Determine item type
+    const itemType = 'type' in item ? item.type : 'tab';
+
+    switch (itemType) {
+      case 'action':
+        return this.renderActionItem(item as interfaces.ISecondaryMenuItemAction);
+      case 'filter':
+        return this.renderFilterItem(item as interfaces.ISecondaryMenuItemFilter);
+      case 'multiFilter':
+        return this.renderMultiFilterItem(item as interfaces.ISecondaryMenuItemMultiFilter);
+      case 'divider':
+        return this.renderDivider();
+      case 'header':
+        return this.renderHeader(item as interfaces.ISecondaryMenuItemHeader);
+      case 'link':
+        return this.renderLinkItem(item as interfaces.ISecondaryMenuItemLink);
+      case 'tab':
+      default:
+        return this.renderTabItem(item as interfaces.ISecondaryMenuItemTab, group);
+    }
+  }
+
+  private renderTabItem(item: interfaces.ISecondaryMenuItemTab, group?: interfaces.ISecondaryMenuGroup): TemplateResult {
     const isSelected = this.selectedItem?.key === item.key;
+    const isDisabled = item.disabled === true;
+
     return html`
       <div
-        class="menuItem ${isSelected ? 'selected' : ''}"
-        @click="${() => this.selectItem(item, group)}"
+        class="menuItem ${isSelected ? 'selected' : ''} ${isDisabled ? 'disabled' : ''}"
+        @click="${() => !isDisabled && this.selectTabItem(item, group)}"
         @contextmenu="${(e: MouseEvent) => this.handleContextMenu(e, item)}"
       >
-        ${item.iconName ? html`<dees-icon .icon="${item.iconName.startsWith('lucide:') ? item.iconName : `lucide:${item.iconName}`}"></dees-icon>` : ''}
+        ${item.iconName ? html`<dees-icon .icon="${this.normalizeIcon(item.iconName)}"></dees-icon>` : ''}
         <span class="itemLabel">${item.key}</span>
         ${item.badge !== undefined ? html`
           <span class="badge ${item.badgeVariant || 'default'}">${item.badge}</span>
@@ -503,6 +782,100 @@ export class DeesAppuiSecondarymenu extends DeesElement {
     `;
   }
 
+  private renderActionItem(item: interfaces.ISecondaryMenuItemAction): TemplateResult {
+    const variant = item.variant || 'primary';
+    const isDisabled = item.disabled === true;
+
+    return html`
+      <div
+        class="menuItem action-${variant} ${isDisabled ? 'disabled' : ''}"
+        @click="${() => !isDisabled && this.handleActionClick(item)}"
+      >
+        ${item.iconName ? html`<dees-icon .icon="${this.normalizeIcon(item.iconName)}"></dees-icon>` : ''}
+        <span class="itemLabel">${item.key}</span>
+        <span class="item-tooltip">${item.key}</span>
+      </div>
+    `;
+  }
+
+  private renderFilterItem(item: interfaces.ISecondaryMenuItemFilter): TemplateResult {
+    const isDisabled = item.disabled === true;
+
+    return html`
+      <div
+        class="menuItem filter ${item.active ? 'active' : ''} ${isDisabled ? 'disabled' : ''}"
+        @click="${() => !isDisabled && this.handleFilterToggle(item)}"
+      >
+        ${item.iconName ? html`<dees-icon .icon="${this.normalizeIcon(item.iconName)}"></dees-icon>` : ''}
+        <span class="itemLabel">${item.key}</span>
+        <div class="filter-checkbox ${item.active ? 'checked' : ''}">
+          ${item.active ? html`<dees-icon .icon="${'lucide:check'}"></dees-icon>` : ''}
+        </div>
+        <span class="item-tooltip">${item.key}</span>
+      </div>
+    `;
+  }
+
+  private renderMultiFilterItem(item: interfaces.ISecondaryMenuItemMultiFilter): TemplateResult {
+    const isCollapsed = this.collapsedMultiFilters.has(item.key);
+    const checkedCount = item.options.filter(opt => opt.checked).length;
+
+    return html`
+      <div class="multiFilter">
+        <div
+          class="multiFilter-header ${isCollapsed ? 'collapsed' : ''}"
+          @click="${() => this.toggleMultiFilter(item.key)}"
+        >
+          <span class="multiFilter-title">
+            ${item.iconName ? html`<dees-icon .icon="${this.normalizeIcon(item.iconName)}"></dees-icon>` : ''}
+            ${item.key}
+          </span>
+          ${checkedCount > 0 ? html`<span class="multiFilter-count">${checkedCount}</span>` : ''}
+          <dees-icon class="chevron" .icon="${'lucide:chevronDown'}"></dees-icon>
+        </div>
+        <div class="multiFilter-options ${isCollapsed ? 'collapsed' : ''}">
+          ${item.options.map(option => html`
+            <div
+              class="multiFilter-option"
+              @click="${() => this.handleMultiFilterOptionToggle(item, option.key)}"
+            >
+              <div class="option-checkbox ${option.checked ? 'checked' : ''}">
+                ${option.checked ? html`<dees-icon .icon="${'lucide:check'}"></dees-icon>` : ''}
+              </div>
+              ${option.iconName ? html`<dees-icon class="option-icon" .icon="${this.normalizeIcon(option.iconName)}"></dees-icon>` : ''}
+              <span>${option.label}</span>
+            </div>
+          `)}
+        </div>
+      </div>
+    `;
+  }
+
+  private renderDivider(): TemplateResult {
+    return html`<div class="menuDivider"></div>`;
+  }
+
+  private renderHeader(item: interfaces.ISecondaryMenuItemHeader): TemplateResult {
+    return html`<div class="menuHeader">${item.label}</div>`;
+  }
+
+  private renderLinkItem(item: interfaces.ISecondaryMenuItemLink): TemplateResult {
+    const isExternal = item.external ?? item.href.startsWith('http');
+    const isDisabled = item.disabled === true;
+
+    return html`
+      <div
+        class="menuItem link ${isDisabled ? 'disabled' : ''}"
+        @click="${() => !isDisabled && this.handleLinkClick(item)}"
+      >
+        ${item.iconName ? html`<dees-icon .icon="${this.normalizeIcon(item.iconName)}"></dees-icon>` : ''}
+        <span class="itemLabel">${item.key}</span>
+        ${isExternal ? html`<dees-icon class="external-icon" .icon="${'lucide:externalLink'}"></dees-icon>` : ''}
+        <span class="item-tooltip">${item.key}</span>
+      </div>
+    `;
+  }
+
   private renderLegacyOptions(): TemplateResult {
     return html`
       <div class="legacyOptions">
@@ -511,16 +884,25 @@ export class DeesAppuiSecondarymenu extends DeesElement {
             return html`<div class="divider"></div>`;
           }
           const item = option as interfaces.IMenuItem;
-          return this.renderMenuItem({
+          // Convert legacy IMenuItem to ISecondaryMenuItemTab
+          const tabItem: interfaces.ISecondaryMenuItemTab = {
             key: item.key,
             iconName: item.iconName,
             action: item.action,
-          });
+            badge: item.badge,
+            badgeVariant: item.badgeVariant,
+          };
+          return this.renderTabItem(tabItem);
         })}
       </div>
     `;
   }
 
+  // Helper to normalize icon names
+  private normalizeIcon(iconName: string): string {
+    return iconName.startsWith('lucide:') ? iconName : `lucide:${iconName}`;
+  }
+
   private toggleGroup(groupName: string): void {
     const newCollapsed = new Set(this.collapsedGroups);
     if (newCollapsed.has(groupName)) {
@@ -531,6 +913,16 @@ export class DeesAppuiSecondarymenu extends DeesElement {
     this.collapsedGroups = newCollapsed;
   }
 
+  private toggleMultiFilter(filterKey: string): void {
+    const newCollapsed = new Set(this.collapsedMultiFilters);
+    if (newCollapsed.has(filterKey)) {
+      newCollapsed.delete(filterKey);
+    } else {
+      newCollapsed.add(filterKey);
+    }
+    this.collapsedMultiFilters = newCollapsed;
+  }
+
   public toggleCollapse(): void {
     this.collapsed = !this.collapsed;
     this.dispatchEvent(new CustomEvent('collapse-change', {
@@ -540,7 +932,7 @@ export class DeesAppuiSecondarymenu extends DeesElement {
     }));
   }
 
-  private selectItem(item: interfaces.IMenuItem, group?: interfaces.IMenuGroup): void {
+  private selectTabItem(item: interfaces.ISecondaryMenuItemTab, group?: interfaces.ISecondaryMenuGroup): void {
     this.selectedItem = item;
     item.action();
 
@@ -551,7 +943,81 @@ export class DeesAppuiSecondarymenu extends DeesElement {
     }));
   }
 
-  private handleContextMenu(event: MouseEvent, item: interfaces.IMenuItem): void {
+  private async handleActionClick(item: interfaces.ISecondaryMenuItemAction): Promise<void> {
+    // Handle confirmation if required
+    if (item.confirmMessage) {
+      const confirmed = window.confirm(item.confirmMessage);
+      if (!confirmed) {
+        return;
+      }
+    }
+
+    await item.action();
+
+    this.dispatchEvent(new CustomEvent('action-click', {
+      detail: { item },
+      bubbles: true,
+      composed: true
+    }));
+  }
+
+  private handleFilterToggle(item: interfaces.ISecondaryMenuItemFilter): void {
+    const newActive = !item.active;
+    // Update the item's active state
+    item.active = newActive;
+    item.onToggle(newActive);
+
+    // Force re-render by incrementing the render counter
+    this.renderCounter++;
+
+    this.dispatchEvent(new CustomEvent('filter-toggle', {
+      detail: { item, active: newActive },
+      bubbles: true,
+      composed: true
+    }));
+  }
+
+  private handleMultiFilterOptionToggle(item: interfaces.ISecondaryMenuItemMultiFilter, optionKey: string): void {
+    // Update the option's checked state
+    const option = item.options.find(opt => opt.key === optionKey);
+    if (option) {
+      option.checked = !option.checked;
+    }
+
+    // Calculate the new selected keys
+    const selectedKeys = item.options
+      .filter(opt => opt.checked)
+      .map(opt => opt.key);
+
+    item.onChange(selectedKeys);
+
+    // Force re-render by incrementing the render counter
+    this.renderCounter++;
+
+    this.dispatchEvent(new CustomEvent('multifilter-change', {
+      detail: { item, selectedKeys },
+      bubbles: true,
+      composed: true
+    }));
+  }
+
+  private handleLinkClick(item: interfaces.ISecondaryMenuItemLink): void {
+    const isExternal = item.external ?? item.href.startsWith('http');
+
+    if (isExternal) {
+      window.open(item.href, '_blank', 'noopener,noreferrer');
+    } else {
+      window.location.href = item.href;
+    }
+
+    this.dispatchEvent(new CustomEvent('link-click', {
+      detail: { item },
+      bubbles: true,
+      composed: true
+    }));
+  }
+
+  private handleContextMenu(event: MouseEvent, item: interfaces.ISecondaryMenuItemTab): void {
     DeesContextmenu.openContextMenuWithOptions(event, [
       {
         name: 'View details',
@@ -572,26 +1038,52 @@ export class DeesAppuiSecondarymenu extends DeesElement {
     // Initialize collapsed state from group defaults
     if (this.groups.length > 0) {
       const initialCollapsed = new Set<string>();
+      const initialMultiFilterCollapsed = new Set<string>();
+
       this.groups.forEach(group => {
         if (group.collapsed) {
           initialCollapsed.add(group.name);
         }
-      });
-      this.collapsedGroups = initialCollapsed;
 
-      // Auto-select first item if none selected
-      if (!this.selectedItem && this.groups[0]?.items.length > 0) {
-        this.selectItem(this.groups[0].items[0], this.groups[0]);
+        // Check for collapsed multi-filters
+        group.items.forEach(item => {
+          if ('type' in item && item.type === 'multiFilter') {
+            const multiFilter = item as interfaces.ISecondaryMenuItemMultiFilter;
+            if (multiFilter.collapsed) {
+              initialMultiFilterCollapsed.add(multiFilter.key);
+            }
+          }
+        });
+      });
+
+      this.collapsedGroups = initialCollapsed;
+      this.collapsedMultiFilters = initialMultiFilterCollapsed;
+
+      // Auto-select first tab item if none selected
+      if (!this.selectedItem) {
+        for (const group of this.groups) {
+          for (const item of group.items) {
+            const itemType = 'type' in item ? item.type : 'tab';
+            if (itemType === 'tab' || itemType === undefined) {
+              const tabItem = item as interfaces.ISecondaryMenuItemTab;
+              if (!tabItem.disabled) {
+                this.selectTabItem(tabItem, group);
+                return;
+              }
+            }
+          }
+        }
       }
     } else if (this.selectionOptions.length > 0) {
       // Legacy mode: select first non-divider option
       const firstOption = this.selectionOptions.find(opt => !('divider' in opt)) as interfaces.IMenuItem;
       if (firstOption && !this.selectedItem) {
-        this.selectItem({
+        const tabItem: interfaces.ISecondaryMenuItemTab = {
           key: firstOption.key,
           iconName: firstOption.iconName,
           action: firstOption.action,
-        });
+        };
+        this.selectTabItem(tabItem);
       }
     }
   }

ts_web/elements/00group-appui/dees-appui/dees-appui.demo.ts

@@ -1,6 +1,7 @@
 import { html, css, DeesElement, customElement, state } from '@design.estate/dees-element';
-import type { DeesAppuiBase } from './dees-appui-base.js';
+import type { DeesAppui } from './dees-appui.js';
 import type { IAppConfig, IViewActivationContext } from '../../interfaces/appconfig.js';
+import type * as interfaces from '../../interfaces/index.js';
 import '@design.estate/dees-wcctools/demotools';
 
 // Demo view component with lifecycle hooks
@@ -16,7 +17,7 @@ class DemoDashboardView extends DeesElement {
     this.activated = true;
     console.log('Dashboard activated with context:', context);
 
-    // Set view-specific secondary menu
+    // Set view-specific secondary menu with new item types
     context.appui.setSecondaryMenu({
       heading: 'Dashboard',
       groups: [
@@ -24,17 +25,36 @@ class DemoDashboardView extends DeesElement {
           name: 'Quick Access',
           iconName: 'lucide:zap',
           items: [
-            { key: 'overview', iconName: 'layoutDashboard', action: () => console.log('Overview') },
-            { key: 'recent', iconName: 'clock', badge: 5, action: () => console.log('Recent') },
-          ]
+            { key: 'Overview', iconName: 'layoutDashboard', action: () => console.log('Overview') },
+            { key: 'Recent', iconName: 'clock', badge: 5, action: () => console.log('Recent') },
+            { type: 'divider' },
+            { type: 'action', key: 'Refresh Data', iconName: 'lucide:refreshCw', action: () => alert('Refreshing dashboard data...') },
+          ] as interfaces.ISecondaryMenuItem[]
+        },
+        {
+          name: 'Filters',
+          iconName: 'lucide:filter',
+          items: [
+            { type: 'header', label: 'Time Range' },
+            { type: 'filter', key: 'Live Updates', iconName: 'lucide:radio', active: true, onToggle: (active) => console.log('Live updates:', active) },
+            { type: 'filter', key: 'Show Archived', iconName: 'lucide:archive', active: false, onToggle: (active) => console.log('Show archived:', active) },
+            { type: 'divider' },
+            { type: 'multiFilter', key: 'Data Sources', iconName: 'lucide:database', options: [
+              { key: 'api', label: 'API Server', checked: true, iconName: 'lucide:server' },
+              { key: 'web', label: 'Web Traffic', checked: true, iconName: 'lucide:globe' },
+              { key: 'mobile', label: 'Mobile App', checked: false, iconName: 'lucide:smartphone' },
+            ], onChange: (keys) => console.log('Data sources:', keys) },
+          ] as interfaces.ISecondaryMenuItem[]
         },
         {
           name: 'Analytics',
           iconName: 'lucide:barChart3',
           items: [
-            { key: 'metrics', iconName: 'activity', action: () => console.log('Metrics') },
-            { key: 'reports', iconName: 'fileText', badge: 'new', badgeVariant: 'success', action: () => console.log('Reports') },
-          ]
+            { key: 'Metrics', iconName: 'activity', action: () => console.log('Metrics') },
+            { key: 'Reports', iconName: 'fileText', badge: 'new', badgeVariant: 'success', action: () => console.log('Reports') },
+            { type: 'divider' },
+            { type: 'link', key: 'Analytics Docs', iconName: 'lucide:externalLink', href: 'https://docs.example.com/analytics' },
+          ] as interfaces.ISecondaryMenuItem[]
         }
       ]
     });
@@ -197,7 +217,7 @@ class DemoSettingsView extends DeesElement {
   @state()
   accessor hasChanges: boolean = false;
 
-  private appui: DeesAppuiBase;
+  private appui: DeesAppui;
 
   onActivate(context: IViewActivationContext) {
     this.appui = context.appui as any;
@@ -322,11 +342,22 @@ class DemoProjectsView extends DeesElement {
       groups: [
         {
           name: 'My Projects',
+          iconName: 'lucide:folder',
           items: [
-            { key: 'active', iconName: 'folder', badge: 3, action: () => console.log('Active') },
-            { key: 'archived', iconName: 'archive', action: () => console.log('Archived') },
-            { key: 'shared', iconName: 'users', badge: 2, badgeVariant: 'warning', action: () => console.log('Shared') },
-          ]
+            { key: 'Active', iconName: 'folder', badge: 3, action: () => console.log('Active') },
+            { key: 'Archived', iconName: 'archive', action: () => console.log('Archived') },
+            { key: 'Shared', iconName: 'users', badge: 2, badgeVariant: 'warning', action: () => console.log('Shared') },
+          ] as interfaces.ISecondaryMenuItem[]
+        },
+        {
+          name: 'Quick Actions',
+          iconName: 'lucide:zap',
+          items: [
+            { type: 'action', key: 'New Project', iconName: 'lucide:folderPlus', action: () => alert('Create new project') },
+            { type: 'action', key: 'Import', iconName: 'lucide:download', action: () => alert('Import project') },
+            { type: 'divider' },
+            { type: 'link', key: 'Templates', iconName: 'lucide:layoutTemplate', href: 'https://templates.example.com' },
+          ] as interfaces.ISecondaryMenuItem[]
         }
       ]
     });
@@ -407,13 +438,40 @@ class DemoTasksView extends DeesElement {
       heading: 'Tasks',
       groups: [
         {
-          name: 'Filters',
+          name: 'Views',
+          iconName: 'lucide:eye',
           items: [
-            { key: 'all', iconName: 'list', badge: 12, action: () => console.log('All') },
-            { key: 'today', iconName: 'calendar', badge: 3, action: () => console.log('Today') },
-            { key: 'upcoming', iconName: 'clock', action: () => console.log('Upcoming') },
-            { key: 'completed', iconName: 'checkCircle', action: () => console.log('Completed') },
-          ]
+            { key: 'All Tasks', iconName: 'list', badge: 12, action: () => console.log('All') },
+            { key: 'Today', iconName: 'calendar', badge: 3, action: () => console.log('Today') },
+            { key: 'Upcoming', iconName: 'clock', action: () => console.log('Upcoming') },
+            { key: 'Completed', iconName: 'checkCircle', action: () => console.log('Completed') },
+          ] as interfaces.ISecondaryMenuItem[]
+        },
+        {
+          name: 'Filters',
+          iconName: 'lucide:filter',
+          items: [
+            { type: 'header', label: 'Priority' },
+            { type: 'multiFilter', key: 'Priority', iconName: 'lucide:flag', options: [
+              { key: 'high', label: 'High', checked: true, iconName: 'lucide:alertCircle' },
+              { key: 'medium', label: 'Medium', checked: true, iconName: 'lucide:minusCircle' },
+              { key: 'low', label: 'Low', checked: false, iconName: 'lucide:circle' },
+            ], onChange: (keys) => console.log('Priority filter:', keys) },
+            { type: 'divider' },
+            { type: 'header', label: 'Options' },
+            { type: 'filter', key: 'Show Subtasks', iconName: 'lucide:listTree', active: true, onToggle: (active) => console.log('Show subtasks:', active) },
+            { type: 'filter', key: 'Show Completed', iconName: 'lucide:checkSquare', active: false, onToggle: (active) => console.log('Show completed:', active) },
+          ] as interfaces.ISecondaryMenuItem[]
+        },
+        {
+          name: 'Actions',
+          iconName: 'lucide:zap',
+          items: [
+            { type: 'action', key: 'Add Task', iconName: 'lucide:plus', action: () => alert('Add new task') },
+            { type: 'action', key: 'Import Tasks', iconName: 'lucide:upload', action: () => alert('Import tasks') },
+            { type: 'divider' },
+            { type: 'action', key: 'Clear Completed', iconName: 'lucide:trash2', variant: 'danger', confirmMessage: 'Delete all completed tasks?', action: () => alert('Cleared completed tasks') },
+          ] as interfaces.ISecondaryMenuItem[]
         }
       ]
     });
@@ -619,7 +677,7 @@ export const demoFunc = () => {
   containerElement.className = 'demo-container';
   containerElement.style.cssText = 'position: absolute; top: 0; left: 0; height: 100%; width: 100%; overflow: hidden;';
 
-  const appuiElement = document.createElement('dees-appui-base') as DeesAppuiBase;
+  const appuiElement = document.createElement('dees-appui') as DeesAppui;
   containerElement.appendChild(appuiElement);
 
   // Initialize after element is connected

ts_web/elements/00group-appui/dees-appui/dees-appui.ts

@@ -15,7 +15,7 @@ import type { DeesAppuiMainmenu } from '../dees-appui-mainmenu/dees-appui-mainme
 import type { DeesAppuiSecondarymenu } from '../dees-appui-secondarymenu/dees-appui-secondarymenu.js';
 import type { DeesAppuiMaincontent } from '../dees-appui-maincontent/dees-appui-maincontent.js';
 import type { DeesAppuiActivitylog } from '../dees-appui-activitylog/dees-appui-activitylog.js';
-import { demoFunc } from './dees-appui-base.demo.js';
+import { demoFunc } from './dees-appui.demo.js';
 import { themeDefaultStyles } from '../../00theme.js';
 
 // View registry for managing views
@@ -30,12 +30,12 @@ import '../dees-appui-activitylog/dees-appui-activitylog.js';
 
 declare global {
   interface HTMLElementTagNameMap {
-    'dees-appui-base': DeesAppuiBase;
+    'dees-appui': DeesAppui;
   }
 }
 
-@customElement('dees-appui-base')
-export class DeesAppuiBase extends DeesElement {
+@customElement('dees-appui')
+export class DeesAppui extends DeesElement {
   public static demo = demoFunc;
 
   // ==========================================
@@ -98,10 +98,10 @@ export class DeesAppuiBase extends DeesElement {
   accessor secondarymenuHeading: string = '';
 
   @property({ type: Array })
-  accessor secondarymenuGroups: interfaces.IMenuGroup[] = [];
+  accessor secondarymenuGroups: interfaces.ISecondaryMenuGroup[] = [];
 
   @property({ type: Object })
-  accessor secondarymenuSelectedItem: interfaces.IMenuItem | undefined = undefined;
+  accessor secondarymenuSelectedItem: interfaces.ISecondaryMenuItemTab | undefined = undefined;
 
   // Collapse states
   @property({ type: Boolean })
@@ -126,6 +126,13 @@ export class DeesAppuiBase extends DeesElement {
   @property({ type: Number })
   accessor contentTabsAutoHideThreshold: number = 0;
 
+  // Activity log visibility and count
+  @state()
+  accessor activityLogVisible: boolean = false;
+
+  @state()
+  accessor activityLogCount: number = 0;
+
   // Properties for maincontent
   @property({ type: Array })
   accessor maincontentTabs: interfaces.IMenuItem[] = [];
@@ -175,8 +182,9 @@ export class DeesAppuiBase extends DeesElement {
         height: calc(100% - 40px);
         width: 100%;
         display: grid;
-        grid-template-columns: auto auto 1fr 240px;
+        /* grid-template-columns set dynamically in template */
         grid-template-rows: 1fr;
+        transition: grid-template-columns 0.3s ease;
       }
 
       /* Z-index layering for proper stacking */
@@ -198,6 +206,19 @@ export class DeesAppuiBase extends DeesElement {
       .maingrid > dees-appui-activitylog {
         position: relative;
         z-index: 1;
+        overflow: hidden;
+        transition: opacity 0.3s ease, transform 0.3s ease;
+      }
+
+      .maingrid > dees-appui-activitylog.hidden {
+        opacity: 0;
+        transform: translateX(20px);
+        pointer-events: none;
+      }
+
+      .maingrid > dees-appui-activitylog.visible {
+        opacity: 1;
+        transform: translateX(0);
       }
 
       /* View container for dynamically loaded views */
@@ -221,14 +242,18 @@ export class DeesAppuiBase extends DeesElement {
         .user=${this.appbarUser}
         .profileMenuItems=${this.appbarProfileMenuItems}
         .showSearch=${this.appbarShowSearch}
+        .showActivityLogToggle=${true}
+        .activityLogCount=${this.activityLogCount}
+        .activityLogActive=${this.activityLogVisible}
         @menu-select=${(e: CustomEvent) => this.handleAppbarMenuSelect(e)}
         @breadcrumb-navigate=${(e: CustomEvent) => this.handleAppbarBreadcrumbNavigate(e)}
         @search-click=${() => this.handleAppbarSearchClick()}
         @search-query=${(e: CustomEvent) => this.handleAppbarSearchQuery(e)}
         @user-menu-open=${() => this.handleAppbarUserMenuOpen()}
         @profile-menu-select=${(e: CustomEvent) => this.handleAppbarProfileMenuSelect(e)}
+        @activity-toggle=${() => this.toggleActivityLog()}
       ></dees-appui-appbar>
-      <div class="maingrid">
+      <div class="maingrid" style="grid-template-columns: auto auto 1fr ${this.activityLogVisible ? '280px' : '0px'};">
         ${this.mainmenuVisible ? html`
           <dees-appui-mainmenu
             .logoIcon=${this.mainmenuLogoIcon}
@@ -264,7 +289,9 @@ export class DeesAppuiBase extends DeesElement {
           <div class="view-container"></div>
           <slot name="maincontent"></slot>
         </dees-appui-maincontent>
-        <dees-appui-activitylog></dees-appui-activitylog>
+        <dees-appui-activitylog
+          class="${this.activityLogVisible ? 'visible' : 'hidden'}"
+        ></dees-appui-activitylog>
       </div>
     `;
   }
@@ -277,8 +304,15 @@ export class DeesAppuiBase extends DeesElement {
     this.maincontent = this.shadowRoot!.querySelector('dees-appui-maincontent') as DeesAppuiMaincontent;
     this.activitylogElement = this.shadowRoot!.querySelector('dees-appui-activitylog') as DeesAppuiActivitylog;
 
+    // Subscribe to activity log entry changes for badge count
+    if (this.activitylogElement) {
+      this.activitylogElement.entries$.subscribe((entries) => {
+        this.activityLogCount = entries.length;
+      });
+    }
+
     // Set appui reference in view registry for lifecycle context
-    this.viewRegistry.setAppuiRef(this as unknown as interfaces.TDeesAppuiBase);
+    this.viewRegistry.setAppuiRef(this as unknown as interfaces.TDeesAppui);
   }
 
   async disconnectedCallback() {
@@ -534,7 +568,7 @@ export class DeesAppuiBase extends DeesElement {
   /**
    * Set the secondary menu configuration
    */
-  public setSecondaryMenu(config: { heading?: string; groups: interfaces.IMenuGroup[] }): void {
+  public setSecondaryMenu(config: { heading?: string; groups: interfaces.ISecondaryMenuGroup[] }): void {
     if (config.heading !== undefined) {
       this.secondarymenuHeading = config.heading;
     }
@@ -544,7 +578,7 @@ export class DeesAppuiBase extends DeesElement {
   /**
    * Update a specific secondary menu group
    */
-  public updateSecondaryMenuGroup(groupName: string, update: Partial<interfaces.IMenuGroup>): void {
+  public updateSecondaryMenuGroup(groupName: string, update: Partial<interfaces.ISecondaryMenuGroup>): void {
     this.secondarymenuGroups = this.secondarymenuGroups.map(group =>
       group.name === groupName ? { ...group, ...update } : group
     );
@@ -555,7 +589,7 @@ export class DeesAppuiBase extends DeesElement {
    */
   public addSecondaryMenuItem(
     groupName: string,
-    item: interfaces.IMenuGroup['items'][0]
+    item: interfaces.ISecondaryMenuItem
   ): void {
     this.secondarymenuGroups = this.secondarymenuGroups.map(group => {
       if (group.name === groupName) {
@@ -569,13 +603,13 @@ export class DeesAppuiBase extends DeesElement {
   }
 
   /**
-   * Set the selected secondary menu item by key
+   * Set the selected secondary menu item by key (for tab items only)
    */
   public setSecondaryMenuSelection(itemKey: string): void {
     for (const group of this.secondarymenuGroups) {
-      const item = group.items.find(i => i.key === itemKey);
-      if (item) {
-        this.secondarymenuSelectedItem = item;
+      const item = group.items.find(i => 'key' in i && i.key === itemKey);
+      if (item && (!('type' in item) || item.type === 'tab' || item.type === undefined)) {
+        this.secondarymenuSelectedItem = item as interfaces.ISecondaryMenuItemTab;
         return;
       }
     }
@@ -673,6 +707,27 @@ export class DeesAppuiBase extends DeesElement {
     };
   }
 
+  /**
+   * Set activity log visibility
+   */
+  public setActivityLogVisible(visible: boolean): void {
+    this.activityLogVisible = visible;
+  }
+
+  /**
+   * Toggle activity log visibility
+   */
+  public toggleActivityLog(): void {
+    this.activityLogVisible = !this.activityLogVisible;
+  }
+
+  /**
+   * Get activity log visibility state
+   */
+  public getActivityLogVisible(): boolean {
+    return this.activityLogVisible;
+  }
+
   // ==========================================
   // PROGRAMMATIC API: NAVIGATION
   // ==========================================

ts_web/elements/00group-appui/dees-appui/index.ts

@@ -0,0 +1,2 @@
+export * from './dees-appui.js';
+export * from './view.registry.js';

ts_web/elements/00group-appui/dees-appui/readme.md

@@ -1,19 +1,19 @@
-# DeesAppuiBase
+# DeesAppui
 
-A comprehensive application shell component providing a complete UI framework with navigation, menus, activity logging, and view management.
+A comprehensive application shell component providing a complete UI framework with navigation, menus, activity logging, and view management. 🚀
 
 ## Quick Start
 
 ```typescript
 import { html, DeesElement, customElement } from '@design.estate/dees-element';
-import { DeesAppuiBase } from '@design.estate/dees-catalog';
+import { DeesAppui } from '@design.estate/dees-catalog';
 
 @customElement('my-app')
 class MyApp extends DeesElement {
-  private appui: DeesAppuiBase;
+  private appui: DeesAppui;
 
   async firstUpdated() {
-    this.appui = this.shadowRoot.querySelector('dees-appui-base');
+    this.appui = this.shadowRoot.querySelector('dees-appui');
 
     // Configure with views and menu
     this.appui.configure({
@@ -30,11 +30,39 @@ class MyApp extends DeesElement {
   }
 
   render() {
-    return html`<dees-appui-base></dees-appui-base>`;
+    return html`<dees-appui></dees-appui>`;
   }
 }
 ```
 
+## Architecture Overview
+
+The DeesAppui shell consists of several interconnected components:
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  AppBar (dees-appui-appbar)                                         │
+│  ├── Menus (File, Edit, View...)                                    │
+│  ├── Breadcrumbs                                                    │
+│  ├── User Profile + Dropdown                                        │
+│  └── Activity Log Toggle                                            │
+├─────────────┬───────────────────────────────────┬───────────────────┤
+│ Main Menu   │  Content Area                     │  Activity Log     │
+│ (collapsed/ │  ├── Content Tabs                 │  (slide panel)    │
+│  expanded)  │  │   (closable, from tables/lists)│                   │
+│             │  └── View Container               │                   │
+│ ┌─────────┐ │      └── Active View              │                   │
+│ │ 🏠 Home │ ├─────────────────────────────────┐ │                   │
+│ │ 📁 Files│ │ Secondary Menu                  │ │                   │
+│ │ ⚙ Settings ├── Collapsible Groups            │ │                   │
+│ │         │ │   ├── Item 1                    │ │                   │
+│ └─────────┘ │   ├── Item 2 (with badge)       │ │                   │
+│             │   └── Item 3                    │ │                   │
+└─────────────┴─────────────────────────────────┴───────────────────────┘
+```
+
+---
+
 ## Configuration API
 
 ### `configure(config: IAppConfig)`
@@ -155,74 +183,289 @@ appui.removeMainMenuItem('Main', 'tasks');
 
 // Selection
 appui.setMainMenuSelection('dashboard');
-appui.setMainMenuCollapsed(true);
+
+// Visibility control
+appui.setMainMenuCollapsed(true);     // Collapse to icon-only sidebar
+appui.setMainMenuVisible(false);       // Hide completely
 
 // Badges
 appui.setMainMenuBadge('inbox', 12);
 appui.clearMainMenuBadge('inbox');
 ```
 
-### Secondary Menu API
+---
 
-Views can control the secondary (contextual) menu.
+## Secondary Menu API 📋
+
+The secondary menu is a contextual sidebar that appears next to the main content area. It supports **collapsible groups** with icons and badges, making it perfect for:
+
+- **Settings pages** (grouped settings categories)
+- **File browsers** (folder trees)
+- **Project navigation** (grouped by category)
+- **Documentation** (chapters/sections)
+
+### Collapsible Groups
+
+Groups can be collapsed/expanded by clicking the group header. The state is visually indicated with an icon rotation.
 
 ```typescript
-// Set menu
+// Set secondary menu with collapsible groups
 appui.setSecondaryMenu({
   heading: 'Settings',
   groups: [
     {
       name: 'Account',
+      iconName: 'lucide:user',        // Group icon
+      collapsed: false,                // Initial state (default: false)
       items: [
-        { key: 'profile', iconName: 'lucide:user', action: () => {} },
-        { key: 'security', iconName: 'lucide:shield', action: () => {} },
+        { key: 'profile', iconName: 'lucide:user', action: () => showProfile() },
+        { key: 'security', iconName: 'lucide:shield', badge: '!', badgeVariant: 'warning', action: () => showSecurity() },
+        { key: 'billing', iconName: 'lucide:credit-card', action: () => showBilling() }
+      ]
+    },
+    {
+      name: 'Preferences',
+      iconName: 'lucide:settings',
+      collapsed: true,                 // Start collapsed
+      items: [
+        { key: 'notifications', iconName: 'lucide:bell', action: () => {} },
+        { key: 'appearance', iconName: 'lucide:palette', action: () => {} },
+        { key: 'language', iconName: 'lucide:globe', action: () => {} }
       ]
     }
   ]
 });
+```
 
-// Update group
-appui.updateSecondaryMenuGroup('Account', { items: newItems });
+### Secondary Menu Item Properties
 
-// Add item
-appui.addSecondaryMenuItem('Account', {
-  key: 'notifications',
-  iconName: 'lucide:bell',
-  action: () => {}
+```typescript
+interface ISecondaryMenuItem {
+  key: string;                    // Unique identifier
+  iconName?: string;              // Icon (e.g., 'lucide:user')
+  action: () => void;             // Click handler
+  badge?: string | number;        // Badge text/count
+  badgeVariant?: 'default' | 'success' | 'warning' | 'error';
+}
+
+interface ISecondaryMenuGroup {
+  name: string;                   // Group name (shown in header)
+  iconName?: string;              // Group icon
+  collapsed?: boolean;            // Initial collapsed state
+  items: ISecondaryMenuItem[];    // Items in this group
+}
+```
+
+### Updating Secondary Menu
+
+```typescript
+// Update a specific group
+appui.updateSecondaryMenuGroup('Account', {
+  items: [...newItems]
 });
 
-// Selection
+// Add item to a group
+appui.addSecondaryMenuItem('Account', {
+  key: 'api-keys',
+  iconName: 'lucide:key',
+  action: () => showApiKeys()
+});
+
+// Selection (highlights the item)
 appui.setSecondaryMenuSelection('profile');
 
+// Visibility control
+appui.setSecondaryMenuCollapsed(true);   // Collapse panel
+appui.setSecondaryMenuVisible(false);     // Hide completely
+
 // Clear
 appui.clearSecondaryMenu();
 ```
 
-### Content Tabs API
+### View-Specific Secondary Menus
 
-Control tabs in the main content area.
+Each view can define its own secondary menu that appears when the view is activated:
 
 ```typescript
-// Set tabs
-appui.setContentTabs([
-  { key: 'code', iconName: 'lucide:code', action: () => {} },
-  { key: 'preview', iconName: 'lucide:eye', action: () => {} }
-]);
+// In view definition
+{
+  id: 'settings',
+  name: 'Settings',
+  content: 'my-settings-view',
+  secondaryMenu: [
+    {
+      name: 'General',
+      items: [
+        { key: 'account', iconName: 'lucide:user', action: () => {} },
+        { key: 'security', iconName: 'lucide:shield', action: () => {} }
+      ]
+    }
+  ]
+}
 
-// Add/remove
-appui.addContentTab({ key: 'debug', iconName: 'lucide:bug', action: () => {} });
-appui.removeContentTab('debug');
-
-// Select
-appui.selectContentTab('preview');
-
-// Get current
-const current = appui.getSelectedContentTab();
+// Or set dynamically in view's onActivate hook
+onActivate(context: IViewActivationContext) {
+  context.appui.setSecondaryMenu({
+    heading: 'Project Files',
+    groups: [...]
+  });
+}
 ```
 
-### Activity Log API
+---
 
-Add activity entries to the right-side activity log.
+## Content Tabs API 📑
+
+Content tabs appear above the main view content. They're designed for **opening multiple items** from tables, lists, or other data sources—similar to browser tabs or IDE editor tabs.
+
+### Common Use Cases
+
+- **Table row details** - Click a row to open it as a tab
+- **Document editing** - Open multiple documents
+- **Entity inspection** - View customer, order, product details
+- **Multi-file editing** - Edit multiple configuration files
+
+### Closable Tabs
+
+Tabs can be closable, allowing users to open items, work with them, and close when done:
+
+```typescript
+// Set initial tabs
+appui.setContentTabs([
+  { key: 'overview', iconName: 'lucide:home', action: () => showOverview() },
+  { key: 'activity', iconName: 'lucide:activity', action: () => showActivity() }
+]);
+
+// Add a closable tab when user clicks a table row
+table.addEventListener('row-click', (e) => {
+  const item = e.detail.item;
+
+  appui.addContentTab({
+    key: `item-${item.id}`,
+    label: item.name,                      // Display label
+    iconName: 'lucide:file',
+    closable: true,                        // Allow closing
+    action: () => showItemDetails(item)
+  });
+
+  // Select the new tab
+  appui.selectContentTab(`item-${item.id}`);
+});
+
+// Handle tab close
+appui.addEventListener('tab-close', (e) => {
+  const tabKey = e.detail.key;
+  // Cleanup resources if needed
+  console.log(`Tab ${tabKey} closed`);
+});
+```
+
+### Tab Management
+
+```typescript
+// Add/remove tabs
+appui.addContentTab({
+  key: 'debug',
+  iconName: 'lucide:bug',
+  closable: true,
+  action: () => {}
+});
+appui.removeContentTab('debug');
+
+// Select tab
+appui.selectContentTab('preview');
+
+// Get current tab
+const current = appui.getSelectedContentTab();
+
+// Visibility control
+appui.setContentTabsVisible(false);        // Hide tab bar
+
+// Auto-hide when only one tab
+appui.setContentTabsAutoHide(true, 1);     // Hide when ≤ 1 tab
+```
+
+### Opening Items from Tables/Lists
+
+A common pattern is opening table rows as closable tabs:
+
+```typescript
+@customElement('my-customers-view')
+class MyCustomersView extends DeesElement {
+  private appui: DeesAppui;
+
+  onActivate(context: IViewActivationContext) {
+    this.appui = context.appui;
+
+    // Set base tabs
+    this.appui.setContentTabs([
+      { key: 'list', label: 'All Customers', iconName: 'lucide:users', action: () => this.showList() }
+    ]);
+  }
+
+  render() {
+    return html`
+      <dees-table
+        .data=${this.customers}
+        @row-dblclick=${this.openCustomerTab}
+      ></dees-table>
+    `;
+  }
+
+  openCustomerTab(e: CustomEvent) {
+    const customer = e.detail.item;
+    const tabKey = `customer-${customer.id}`;
+
+    // Check if tab already exists
+    const existingTab = this.appui.getSelectedContentTab();
+    if (existingTab?.key === tabKey) {
+      return; // Already viewing this customer
+    }
+
+    // Add new closable tab
+    this.appui.addContentTab({
+      key: tabKey,
+      label: customer.name,
+      iconName: 'lucide:user',
+      closable: true,
+      action: () => this.showCustomerDetails(customer)
+    });
+
+    this.appui.selectContentTab(tabKey);
+  }
+
+  showCustomerDetails(customer: Customer) {
+    // Render customer details
+    this.currentView = html`<customer-details .customer=${customer}></customer-details>`;
+  }
+
+  showList() {
+    this.currentView = html`<dees-table ...></dees-table>`;
+  }
+}
+```
+
+---
+
+## Activity Log API 📊
+
+The activity log is a slide-out panel on the right side showing user actions and system events.
+
+### Activity Log Toggle
+
+The appbar includes a toggle button with a badge showing the entry count:
+
+```typescript
+// Control visibility
+appui.setActivityLogVisible(true);     // Show panel
+appui.toggleActivityLog();             // Toggle state
+const isVisible = appui.getActivityLogVisible();
+
+// The toggle button automatically shows entry count
+// Add entries and the badge updates automatically
+```
+
+### Adding Entries
 
 ```typescript
 // Add single entry
@@ -234,19 +477,35 @@ appui.activityLog.add({
   data: { invoiceId: '123' }     // Optional metadata
 });
 
-// Add multiple
+// Add multiple entries (e.g., from backend)
 appui.activityLog.addMany([...entries]);
 
-// Clear
+// Clear all entries
 appui.activityLog.clear();
 
-// Query
+// Query entries
 const entries = appui.activityLog.getEntries();
 const filtered = appui.activityLog.filter({ user: 'John', type: 'create' });
 const searched = appui.activityLog.search('invoice');
 ```
 
-### Navigation API
+### Activity Entry Types
+
+Each type has a default icon that can be overridden:
+
+| Type | Default Icon | Use Case |
+|------|--------------|----------|
+| `login` | `lucide:log-in` | User sign-in |
+| `logout` | `lucide:log-out` | User sign-out |
+| `view` | `lucide:eye` | Page/item viewed |
+| `create` | `lucide:plus` | New item created |
+| `update` | `lucide:pencil` | Item modified |
+| `delete` | `lucide:trash` | Item deleted |
+| `custom` | `lucide:activity` | Custom events |
+
+---
+
+## Navigation API
 
 Navigate between views programmatically.
 
@@ -329,7 +588,7 @@ class MySettingsView extends DeesElement implements IViewLifecycle {
 
 ```typescript
 interface IViewActivationContext {
-  appui: DeesAppuiBase;           // Reference to the app shell
+  appui: DeesAppui;           // Reference to the app shell
   viewId: string;                  // The view ID being activated
   params?: Record<string, string>; // Route parameters
 }
@@ -421,14 +680,14 @@ appui.viewChanged$.subscribe((event) => {
 
 ```typescript
 import { html, DeesElement, customElement } from '@design.estate/dees-element';
-import { DeesAppuiBase, IViewActivationContext } from '@design.estate/dees-catalog';
+import { DeesAppui, IViewActivationContext } from '@design.estate/dees-catalog';
 
 @customElement('my-app')
 class MyApp extends DeesElement {
-  private appui: DeesAppuiBase;
+  private appui: DeesAppui;
 
   async firstUpdated() {
-    this.appui = this.shadowRoot.querySelector('dees-appui-base');
+    this.appui = this.shadowRoot.querySelector('dees-appui');
 
     this.appui.configure({
       branding: {
@@ -494,14 +753,14 @@ class MyApp extends DeesElement {
   }
 
   render() {
-    return html`<dees-appui-base></dees-appui-base>`;
+    return html`<dees-appui></dees-appui>`;
   }
 }
 
 // View with lifecycle hooks
 @customElement('crm-settings')
 class CrmSettings extends DeesElement {
-  private appui: DeesAppuiBase;
+  private appui: DeesAppui;
 
   onActivate(context: IViewActivationContext) {
     this.appui = context.appui;
@@ -512,6 +771,7 @@ class CrmSettings extends DeesElement {
       groups: [
         {
           name: 'Account',
+          iconName: 'lucide:user',
           items: [
             { key: 'profile', iconName: 'lucide:user', action: () => this.showSection('profile') },
             { key: 'security', iconName: 'lucide:shield', action: () => this.showSection('security') }
@@ -519,6 +779,8 @@ class CrmSettings extends DeesElement {
         },
         {
           name: 'Preferences',
+          iconName: 'lucide:settings',
+          collapsed: true,
           items: [
             { key: 'notifications', iconName: 'lucide:bell', action: () => this.showSection('notifications') }
           ]
@@ -557,4 +819,5 @@ All interfaces are exported from `@design.estate/dees-catalog`:
 - `IAppBarMenuItem` - App bar menu item
 - `IMainMenuConfig` - Main menu configuration
 - `ISecondaryMenuGroup` - Secondary menu group
-- `ITab` - Tab definition
+- `ISecondaryMenuItem` - Secondary menu item
+- `IMenuItem` - Tab/menu item definition

ts_web/elements/00group-appui/dees-appui/view.registry.ts

@@ -3,7 +3,7 @@ import type {
   IViewDefinition,
   IViewActivationContext,
   IViewLifecycle,
-  TDeesAppuiBase
+  TDeesAppui
 } from '../../interfaces/appconfig.js';
 
 /**
@@ -18,12 +18,12 @@ export class ViewRegistry {
   private views: Map<string, IViewDefinition> = new Map();
   private instances: Map<string, HTMLElement> = new Map();
   private currentViewId: string | null = null;
-  private appui: TDeesAppuiBase | null = null;
+  private appui: TDeesAppui | null = null;
 
   /**
    * Set the appui reference for view activation context
    */
-  public setAppuiRef(appui: TDeesAppuiBase): void {
+  public setAppuiRef(appui: TDeesAppui): void {
     this.appui = appui;
   }
 

ts_web/elements/00group-appui/index.ts

@@ -1,7 +1,7 @@
 // App UI Components
 export * from './dees-appui-activitylog/index.js';
 export * from './dees-appui-appbar/index.js';
-export * from './dees-appui-base/index.js';
+export * from './dees-appui/index.js';
 export * from './dees-appui-maincontent/index.js';
 export * from './dees-appui-mainmenu/index.js';
 export * from './dees-appui-secondarymenu/index.js';

ts_web/elements/00group-chart/dees-chart-area/component.ts

@@ -11,7 +11,8 @@ import { demoFunc } from './demo.js';
 import { chartAreaStyles } from './styles.js';
 import { renderChartArea } from './template.js';
 
-import ApexCharts from 'apexcharts';
+import type ApexCharts from 'apexcharts';
+import { DeesServiceLibLoader } from '../../../services/index.js';
 
 declare global {
   interface HTMLElementTagNameMap {
@@ -151,6 +152,9 @@ export class DeesChartArea extends DeesElement {
   public async firstUpdated() {
     await this.domtoolsPromise;
 
+    // Load ApexCharts from CDN
+    const ApexChartsLib = await DeesServiceLibLoader.getInstance().loadApexCharts();
+
     // Wait for next animation frame to ensure layout is complete
     await new Promise(resolve => requestAnimationFrame(resolve));
     
@@ -353,7 +357,7 @@ export class DeesChartArea extends DeesElement {
     };
     
     try {
-      this.chart = new ApexCharts(this.shadowRoot.querySelector('.chartContainer'), options);
+      this.chart = new ApexChartsLib(this.shadowRoot.querySelector('.chartContainer'), options);
       await this.chart.render();
       
       // Give the chart a moment to fully initialize before resizing

ts_web/elements/00group-dataview/dees-dataview-codebox/dees-dataview-codebox.ts

@@ -10,12 +10,13 @@ import {
 } from '@design.estate/dees-element';
 import { cssGeistFontFamily, cssMonoFontFamily } from '../../00fonts.js';
 
-import hlight from 'highlight.js';
+import type { HLJSApi } from 'highlight.js';
 
 import * as smartstring from '@push.rocks/smartstring';
 
 import * as domtools from '@design.estate/dees-domtools';
 import { DeesContextmenu } from '../../dees-contextmenu/dees-contextmenu.js';
+import { DeesServiceLibLoader } from '../../../services/index.js';
 
 declare global {
   interface HTMLElementTagNameMap {
@@ -229,6 +230,7 @@ export class DeesDataviewCodebox extends DeesElement {
   }
 
   private codeToDisplayStore = '';
+  private highlightJs: HLJSApi | null = null;
 
   public async updated(_changedProperties) {
     super.updated(_changedProperties);
@@ -250,11 +252,17 @@ export class DeesDataviewCodebox extends DeesElement {
       this.codeToDisplay = this.codeToDisplayStore;
     }
     await domtools.plugins.smartdelay.delayFor(0);
+
+    // Load highlight.js from CDN if not already loaded
+    if (!this.highlightJs) {
+      this.highlightJs = await DeesServiceLibLoader.getInstance().loadHighlightJs();
+    }
+
     const localCodeNode = this.shadowRoot.querySelector('code');
-    const html = hlight.highlight(this.codeToDisplayStore, {
+    const highlightedHtml = this.highlightJs.highlight(this.codeToDisplayStore, {
       language: this.progLang,
       ignoreIllegals: true,
     });
-    localCodeNode.innerHTML = html.value;
+    localCodeNode.innerHTML = highlightedHtml.value;
   }
 }

ts_web/elements/00group-editor/dees-editor-filetree/dees-editor-filetree.ts

@@ -1,538 +0,0 @@
-import {
-  DeesElement,
-  property,
-  html,
-  customElement,
-  type TemplateResult,
-  css,
-  cssManager,
-  state,
-} from '@design.estate/dees-element';
-import * as domtools from '@design.estate/dees-domtools';
-import { themeDefaultStyles } from '../../00theme.js';
-import type { IExecutionEnvironment, IFileEntry } from '../../00group-runtime/index.js';
-import '../../dees-icon/dees-icon.js';
-import '../../dees-contextmenu/dees-contextmenu.js';
-import { DeesContextmenu } from '../../dees-contextmenu/dees-contextmenu.js';
-
-declare global {
-  interface HTMLElementTagNameMap {
-    'dees-editor-filetree': DeesEditorFiletree;
-  }
-}
-
-interface ITreeNode extends IFileEntry {
-  children?: ITreeNode[];
-  expanded?: boolean;
-  level: number;
-}
-
-@customElement('dees-editor-filetree')
-export class DeesEditorFiletree extends DeesElement {
-  public static demo = () => html`
-    <div style="width: 300px; height: 400px; position: relative;">
-      <dees-editor-filetree></dees-editor-filetree>
-    </div>
-  `;
-
-  // INSTANCE
-  @property({ type: Object })
-  accessor executionEnvironment: IExecutionEnvironment | null = null;
-
-  @property({ type: String })
-  accessor rootPath: string = '/';
-
-  @property({ type: String })
-  accessor selectedPath: string = '';
-
-  @state()
-  accessor treeData: ITreeNode[] = [];
-
-  @state()
-  accessor isLoading: boolean = false;
-
-  @state()
-  accessor errorMessage: string = '';
-
-  private expandedPaths: Set<string> = new Set();
-  private loadTreeStarted: boolean = false;
-
-  public static styles = [
-    themeDefaultStyles,
-    cssManager.defaultStyles,
-    css`
-      :host {
-        display: block;
-        position: absolute;
-        top: 0;
-        left: 0;
-        right: 0;
-        bottom: 0;
-        overflow: auto;
-        background: ${cssManager.bdTheme('hsl(0 0% 98%)', 'hsl(0 0% 9%)')};
-        font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-        font-size: 13px;
-      }
-
-      .tree-container {
-        padding: 8px 0;
-      }
-
-      .tree-item {
-        display: flex;
-        align-items: center;
-        padding: 4px 8px;
-        cursor: pointer;
-        user-select: none;
-        border-radius: 4px;
-        margin: 1px 4px;
-        transition: background 0.1s ease;
-      }
-
-      .tree-item:hover {
-        background: ${cssManager.bdTheme('hsl(0 0% 93%)', 'hsl(0 0% 14%)')};
-      }
-
-      .tree-item.selected {
-        background: ${cssManager.bdTheme('hsl(210 100% 95%)', 'hsl(210 50% 20%)')};
-        color: ${cssManager.bdTheme('hsl(210 100% 40%)', 'hsl(210 100% 70%)')};
-      }
-
-      .tree-item.selected:hover {
-        background: ${cssManager.bdTheme('hsl(210 100% 92%)', 'hsl(210 50% 25%)')};
-      }
-
-      .indent {
-        display: inline-block;
-        width: 16px;
-        flex-shrink: 0;
-      }
-
-      .expand-icon {
-        width: 16px;
-        height: 16px;
-        display: flex;
-        align-items: center;
-        justify-content: center;
-        flex-shrink: 0;
-        color: ${cssManager.bdTheme('hsl(0 0% 50%)', 'hsl(0 0% 60%)')};
-        transition: transform 0.15s ease;
-      }
-
-      .expand-icon.expanded {
-        transform: rotate(90deg);
-      }
-
-      .expand-icon.hidden {
-        visibility: hidden;
-      }
-
-      .file-icon {
-        width: 16px;
-        height: 16px;
-        margin-right: 6px;
-        flex-shrink: 0;
-        display: flex;
-        align-items: center;
-        justify-content: center;
-      }
-
-      .file-icon dees-icon {
-        width: 16px;
-        height: 16px;
-      }
-
-      .file-icon.folder {
-        color: ${cssManager.bdTheme('hsl(45 80% 45%)', 'hsl(45 70% 55%)')};
-      }
-
-      .file-icon.file {
-        color: ${cssManager.bdTheme('hsl(0 0% 50%)', 'hsl(0 0% 60%)')};
-      }
-
-      .file-icon.typescript {
-        color: hsl(211 60% 48%);
-      }
-
-      .file-icon.javascript {
-        color: hsl(53 93% 54%);
-      }
-
-      .file-icon.json {
-        color: hsl(45 80% 50%);
-      }
-
-      .file-icon.html {
-        color: hsl(14 77% 52%);
-      }
-
-      .file-icon.css {
-        color: hsl(228 77% 59%);
-      }
-
-      .file-icon.markdown {
-        color: hsl(0 0% 50%);
-      }
-
-      .file-name {
-        flex: 1;
-        overflow: hidden;
-        text-overflow: ellipsis;
-        white-space: nowrap;
-        color: ${cssManager.bdTheme('hsl(0 0% 20%)', 'hsl(0 0% 85%)')};
-      }
-
-      .loading {
-        padding: 16px;
-        text-align: center;
-        color: ${cssManager.bdTheme('hsl(0 0% 50%)', 'hsl(0 0% 60%)')};
-      }
-
-      .error {
-        padding: 16px;
-        text-align: center;
-        color: hsl(0 70% 50%);
-      }
-
-      .empty {
-        padding: 16px;
-        text-align: center;
-        color: ${cssManager.bdTheme('hsl(0 0% 50%)', 'hsl(0 0% 60%)')};
-        font-style: italic;
-      }
-    `,
-  ];
-
-  public render(): TemplateResult {
-    if (!this.executionEnvironment) {
-      return html`
-        <div class="empty">
-          No execution environment provided.
-        </div>
-      `;
-    }
-
-    if (this.isLoading) {
-      return html`
-        <div class="loading">
-          Loading files...
-        </div>
-      `;
-    }
-
-    if (this.errorMessage) {
-      return html`
-        <div class="error">
-          ${this.errorMessage}
-        </div>
-      `;
-    }
-
-    if (this.treeData.length === 0) {
-      return html`
-        <div class="empty">
-          No files found.
-        </div>
-      `;
-    }
-
-    return html`
-      <div class="tree-container">
-        ${this.renderTree(this.treeData)}
-      </div>
-    `;
-  }
-
-  private renderTree(nodes: ITreeNode[]): TemplateResult[] {
-    return nodes.map(node => this.renderNode(node));
-  }
-
-  private renderNode(node: ITreeNode): TemplateResult {
-    const isDirectory = node.type === 'directory';
-    const isExpanded = this.expandedPaths.has(node.path);
-    const isSelected = node.path === this.selectedPath;
-    const iconClass = this.getFileIconClass(node);
-
-    return html`
-      <div
-        class="tree-item ${isSelected ? 'selected' : ''}"
-        style="padding-left: ${8 + node.level * 16}px"
-        @click=${(e: MouseEvent) => this.handleItemClick(e, node)}
-        @contextmenu=${(e: MouseEvent) => this.handleContextMenu(e, node)}
-      >
-        <span class="expand-icon ${isExpanded ? 'expanded' : ''} ${!isDirectory ? 'hidden' : ''}">
-          <dees-icon .icon=${'lucide:chevronRight'} iconSize="12"></dees-icon>
-        </span>
-        <span class="file-icon ${iconClass}">
-          <dees-icon .icon=${this.getFileIcon(node)} iconSize="16"></dees-icon>
-        </span>
-        <span class="file-name">${node.name}</span>
-      </div>
-      ${isDirectory && isExpanded && node.children
-        ? this.renderTree(node.children)
-        : ''}
-    `;
-  }
-
-  private getFileIcon(node: ITreeNode): string {
-    if (node.type === 'directory') {
-      return this.expandedPaths.has(node.path) ? 'lucide:folderOpen' : 'lucide:folder';
-    }
-
-    const ext = node.name.split('.').pop()?.toLowerCase();
-    switch (ext) {
-      case 'ts':
-      case 'tsx':
-        return 'lucide:fileCode';
-      case 'js':
-      case 'jsx':
-        return 'lucide:fileCode';
-      case 'json':
-        return 'lucide:fileJson';
-      case 'html':
-        return 'lucide:fileCode';
-      case 'css':
-      case 'scss':
-      case 'less':
-        return 'lucide:fileCode';
-      case 'md':
-        return 'lucide:fileText';
-      case 'png':
-      case 'jpg':
-      case 'jpeg':
-      case 'gif':
-      case 'svg':
-        return 'lucide:image';
-      default:
-        return 'lucide:file';
-    }
-  }
-
-  private getFileIconClass(node: ITreeNode): string {
-    if (node.type === 'directory') return 'folder';
-
-    const ext = node.name.split('.').pop()?.toLowerCase();
-    switch (ext) {
-      case 'ts':
-      case 'tsx':
-        return 'typescript';
-      case 'js':
-      case 'jsx':
-        return 'javascript';
-      case 'json':
-        return 'json';
-      case 'html':
-        return 'html';
-      case 'css':
-      case 'scss':
-      case 'less':
-        return 'css';
-      case 'md':
-        return 'markdown';
-      default:
-        return 'file';
-    }
-  }
-
-  private async handleItemClick(e: MouseEvent, node: ITreeNode) {
-    e.stopPropagation();
-
-    if (node.type === 'directory') {
-      await this.toggleDirectory(node);
-    } else {
-      this.selectedPath = node.path;
-      this.dispatchEvent(
-        new CustomEvent('file-select', {
-          detail: { path: node.path, name: node.name },
-          bubbles: true,
-          composed: true,
-        })
-      );
-    }
-  }
-
-  private async toggleDirectory(node: ITreeNode) {
-    if (this.expandedPaths.has(node.path)) {
-      this.expandedPaths.delete(node.path);
-    } else {
-      this.expandedPaths.add(node.path);
-      // Load children if not already loaded
-      if (!node.children || node.children.length === 0) {
-        await this.loadDirectoryContents(node);
-      }
-    }
-    this.requestUpdate();
-  }
-
-  private async loadDirectoryContents(node: ITreeNode) {
-    if (!this.executionEnvironment) return;
-
-    try {
-      const entries = await this.executionEnvironment.readDir(node.path);
-      node.children = this.sortEntries(entries).map(entry => ({
-        ...entry,
-        level: node.level + 1,
-        expanded: false,
-        children: entry.type === 'directory' ? [] : undefined,
-      }));
-    } catch (error) {
-      console.error(`Failed to load directory ${node.path}:`, error);
-    }
-  }
-
-  private async handleContextMenu(e: MouseEvent, node: ITreeNode) {
-    e.preventDefault();
-    e.stopPropagation();
-
-    const menuItems = [];
-
-    if (node.type === 'directory') {
-      menuItems.push(
-        {
-          name: 'New File',
-          iconName: 'lucide:filePlus',
-          action: async () => this.createNewFile(node.path),
-        },
-        {
-          name: 'New Folder',
-          iconName: 'lucide:folderPlus',
-          action: async () => this.createNewFolder(node.path),
-        },
-        { name: 'divider' }
-      );
-    }
-
-    menuItems.push({
-      name: 'Delete',
-      iconName: 'lucide:trash2',
-      action: async () => this.deleteItem(node),
-    });
-
-    await DeesContextmenu.openContextMenuWithOptions(e, menuItems);
-  }
-
-  private async createNewFile(parentPath: string) {
-    const fileName = prompt('Enter file name:');
-    if (!fileName || !this.executionEnvironment) return;
-
-    const newPath = parentPath === '/' ? `/${fileName}` : `${parentPath}/${fileName}`;
-    try {
-      await this.executionEnvironment.writeFile(newPath, '');
-      await this.refresh();
-      this.dispatchEvent(
-        new CustomEvent('file-created', {
-          detail: { path: newPath },
-          bubbles: true,
-          composed: true,
-        })
-      );
-    } catch (error) {
-      console.error('Failed to create file:', error);
-    }
-  }
-
-  private async createNewFolder(parentPath: string) {
-    const folderName = prompt('Enter folder name:');
-    if (!folderName || !this.executionEnvironment) return;
-
-    const newPath = parentPath === '/' ? `/${folderName}` : `${parentPath}/${folderName}`;
-    try {
-      await this.executionEnvironment.mkdir(newPath);
-      await this.refresh();
-      this.dispatchEvent(
-        new CustomEvent('folder-created', {
-          detail: { path: newPath },
-          bubbles: true,
-          composed: true,
-        })
-      );
-    } catch (error) {
-      console.error('Failed to create folder:', error);
-    }
-  }
-
-  private async deleteItem(node: ITreeNode) {
-    if (!this.executionEnvironment) return;
-
-    const confirmed = confirm(`Delete ${node.name}?`);
-    if (!confirmed) return;
-
-    try {
-      await this.executionEnvironment.rm(node.path, { recursive: node.type === 'directory' });
-      await this.refresh();
-      this.dispatchEvent(
-        new CustomEvent('item-deleted', {
-          detail: { path: node.path, type: node.type },
-          bubbles: true,
-          composed: true,
-        })
-      );
-    } catch (error) {
-      console.error('Failed to delete item:', error);
-    }
-  }
-
-  public async firstUpdated() {
-    await this.loadTree();
-  }
-
-  public async updated(changedProperties: Map<string, any>) {
-    if (changedProperties.has('executionEnvironment') && this.executionEnvironment) {
-      await this.loadTree();
-    }
-  }
-
-  private async loadTree() {
-    if (!this.executionEnvironment) return;
-
-    // Prevent double loading on initial render
-    if (this.loadTreeStarted) return;
-    this.loadTreeStarted = true;
-
-    this.isLoading = true;
-    this.errorMessage = '';
-
-    try {
-      // Wait for environment to be ready
-      if (!this.executionEnvironment.ready) {
-        await this.executionEnvironment.init();
-      }
-
-      const entries = await this.executionEnvironment.readDir(this.rootPath);
-      this.treeData = this.sortEntries(entries).map(entry => ({
-        ...entry,
-        level: 0,
-        expanded: false,
-        children: entry.type === 'directory' ? [] : undefined,
-      }));
-    } catch (error) {
-      this.errorMessage = `Failed to load files: ${error}`;
-      console.error('Failed to load file tree:', error);
-      // Reset flag to allow retry
-      this.loadTreeStarted = false;
-    } finally {
-      this.isLoading = false;
-    }
-  }
-
-  private sortEntries(entries: IFileEntry[]): IFileEntry[] {
-    return entries.sort((a, b) => {
-      // Directories first
-      if (a.type !== b.type) {
-        return a.type === 'directory' ? -1 : 1;
-      }
-      // Then alphabetically
-      return a.name.localeCompare(b.name);
-    });
-  }
-
-  public async refresh() {
-    this.expandedPaths.clear();
-    this.loadTreeStarted = false; // Reset to allow loading
-    await this.loadTree();
-  }
-
-  public selectFile(path: string) {
-    this.selectedPath = path;
-  }
-}

ts_web/elements/00group-editor/dees-editor-filetree/index.ts

@@ -1 +0,0 @@
-export * from './dees-editor-filetree.js';

ts_web/elements/00group-editor/dees-editor-markdown/dees-editor-markdown.ts

@@ -1,102 +0,0 @@
-import {
-  DeesElement,
-  property,
-  html,
-  customElement,
-  type TemplateResult,
-  css,
-  cssManager,
-  domtools
-} from '@design.estate/dees-element';
-import { themeDefaultStyles } from '../../00theme.js';
-import { DeesEditorMonaco } from '../dees-editor-monaco/dees-editor-monaco.js';
-
-const deferred = domtools.plugins.smartpromise.defer();
-
-declare global {
-  interface HTMLElementTagNameMap {
-    'dees-editormarkdown': DeesEditorMarkdown;
-  }
-}
-
-@customElement('dees-editormarkdown')
-export class DeesEditorMarkdown extends DeesElement {
-  public static demo = () => html`<dees-editormarkdown></dees-editormarkdown>`;
-
-  public static styles = [
-    themeDefaultStyles,
-    cssManager.defaultStyles,
-    css`
-      /* TODO: Migrate hardcoded values to --dees-* CSS variables */
-      .gridcontainer {
-        position: absolute;
-        height: 100%;
-        width: 100%;
-        display: grid;
-        grid-template-columns: 60% 40%;
-      }
-      .editorContainer {
-        position: relative;
-      }
-      .outletContainer {
-        background: #111;
-        color: #fff;
-        font-family: 'Roboto Slab';
-        padding: 20px;
-        overflow-y: scroll;
-      }
-    `,
-  ];
-
-  public render() {
-    return html`
-      <div class="gridcontainer">
-        <div class="editorContainer">
-          <dees-editor-monaco
-            .language=${'markdown'}
-            .content=${`# a test content
-
-This is test content that is of longer form an hopefully starts to wrap when I need it. And yes, it does perfectly. nice.
-
-Test | Hello
---- | ---
-Yeah | So good
-
-This is real asset I think. Why would we want to leave that on the table? Can you tell my that?
-
-Why are we here?
-
-Do you know?
-
-> note:
-There is something going on.
-
-\`\`\`typescript
-const hello = 'yes'
-\`\`\`
-`}
-            wordWrap="bounded"
-          ></dees-editor-monaco>
-        </div>
-        <div class="outletContainer">
-          <dees-editormarkdownoutlet></dees-editormarkdownoutlet>
-        </div>
-      </div>
-    `;
-  }
-
-  public async firstUpdated(_changedPropertiesArg) {
-    await super.firstUpdated(_changedPropertiesArg);
-    const editor = this.shadowRoot.querySelector('dees-editor-monaco') as DeesEditorMonaco;
-
-    // lets care about wiring the markdown stuff.
-    const markdownOutlet = this.shadowRoot.querySelector('dees-editormarkdownoutlet');
-    const smartmarkdownInstance = new domtools.plugins.smartmarkdown.SmartMarkdown();
-    const mdParsedResult = await smartmarkdownInstance.getMdParsedResultFromMarkdown('loading...')
-    editor.contentSubject.subscribe(async contentArg => {
-      await mdParsedResult.updateFromMarkdownString(contentArg)
-      const html = mdParsedResult.html;
-      markdownOutlet.updateHtmlText(html);
-    })
-  }
-}

ts_web/elements/00group-editor/dees-editor-markdown/index.ts

@@ -1 +0,0 @@
-export * from './dees-editor-markdown.js';

ts_web/elements/00group-editor/dees-editor-markdownoutlet/dees-editor-markdownoutlet.ts

@@ -1,42 +0,0 @@
-import { customElement, DeesElement, html, type TemplateResult } from '@design.estate/dees-element';
-
-declare global {
-  interface HTMLElementTagNameMap {
-    'dees-editormarkdownoutlet': DeesEditorMarkdownOutlet;
-  }
-}
-
-@customElement('dees-editormarkdownoutlet')
-export class DeesEditorMarkdownOutlet extends DeesElement {
-  // DEMO
-  public static demo = () => html`<dees-editormarkdownoutlet></dees-editormarkdownoutlet>`;
-
-  // INSTANCE
-  private outlet: HTMLElement;
-
-  public render(): TemplateResult {
-    return html`
-      <div class="outlet markdown-body">
-        <h1>Hi there</h1>
-      </div>
-    `;
-  }
-
-  public async firstUpdated(_changedProperties: Map<string | number | symbol, unknown>) {
-    await super.firstUpdated(_changedProperties);
-    const styleElement = document.createElement('style');
-    const cssText = await (
-      await fetch('https://unpkg.com/github-markdown-css@5.1.0/github-markdown-dark.css')
-    ).text();
-    styleElement.textContent = cssText;
-    this.shadowRoot.append(styleElement);
-  }
-
-  public async updateHtmlText(htmlTextArg: string) {
-    await this.updateComplete;
-    if (!this.outlet) {
-      this.outlet = this.shadowRoot.querySelector('.outlet');
-    }
-    this.outlet.innerHTML = htmlTextArg;
-  }
-}

ts_web/elements/00group-editor/dees-editor-markdownoutlet/index.ts

@@ -1 +0,0 @@
-export * from './dees-editor-markdownoutlet.js';

ts_web/elements/00group-editor/dees-editor-monaco/dees-editor-monaco.ts

@@ -1,153 +0,0 @@
-import {
-  DeesElement,
-  property,
-  html,
-  customElement,
-  type TemplateResult,
-  css,
-  cssManager,
-} from '@design.estate/dees-element';
-import * as domtools from '@design.estate/dees-domtools';
-import { MONACO_VERSION } from './version.js';
-import { themeDefaultStyles } from '../../00theme.js';
-
-import type * as monaco from 'monaco-editor';
-
-declare global {
-  interface HTMLElementTagNameMap {
-    'dees-editor-monaco': DeesEditorMonaco;
-  }
-}
-
-@customElement('dees-editor-monaco')
-export class DeesEditorMonaco extends DeesElement {
-  // DEMO
-  public static demo = () => html`<dees-editor-monaco></dees-editor-monaco>`;
-
-  // STATIC
-  public static monacoDeferred: ReturnType<typeof domtools.plugins.smartpromise.defer>;
-
-  // INSTANCE
-  public editorDeferred = domtools.plugins.smartpromise.defer<monaco.editor.IStandaloneCodeEditor>();
-  public language = 'typescript';
-
-  @property({
-    type: String
-  })
-  accessor content = "function hello() {\n\talert('Hello world!');\n}";
-
-  @property({
-    type: Object
-  })
-  accessor contentSubject = new domtools.plugins.smartrx.rxjs.Subject<string>();
-
-  @property({
-    type: Boolean
-  })
-  accessor wordWrap: monaco.editor.IStandaloneEditorConstructionOptions['wordWrap'] = 'off';
-
-  private monacoThemeSubscription: domtools.plugins.smartrx.rxjs.Subscription | null = null;
-
-  constructor() {
-    super();
-    domtools.DomTools.setupDomTools();
-  }
-
-  public static styles = [
-    themeDefaultStyles,
-    cssManager.defaultStyles,
-    css`
-      /* TODO: Migrate hardcoded values to --dees-* CSS variables */
-      :host {
-      }
-
-      * {
-        box-sizing: border-box;
-      }
-
-      #container {
-        position: absolute;
-        height: 100%;
-        width: 100%;
-      }
-    `,
-  ];
-
-  public render(): TemplateResult {
-    return html`
-      <div class="mainbox">
-        <div id="container"></div>
-      </div>
-    `;
-  }
-
-  public async firstUpdated(
-    _changedProperties: Map<string | number | symbol, unknown>
-  ): Promise<void> {
-    super.firstUpdated(_changedProperties);
-    const container = this.shadowRoot.getElementById('container');
-    const monacoCdnBase = `https://cdn.jsdelivr.net/npm/monaco-editor@${MONACO_VERSION}`;
-
-    if (!DeesEditorMonaco.monacoDeferred) {
-      DeesEditorMonaco.monacoDeferred = domtools.plugins.smartpromise.defer();
-      const scriptUrl = `${monacoCdnBase}/min/vs/loader.js`;
-      const script = document.createElement('script');
-      script.src = scriptUrl;
-      script.onload = () => {
-        DeesEditorMonaco.monacoDeferred.resolve();
-      };
-      document.head.appendChild(script);
-    }
-    await DeesEditorMonaco.monacoDeferred.promise;
-
-    (window as any).require.config({
-      paths: { vs: `${monacoCdnBase}/min/vs` },
-    });
-    (window as any).require(['vs/editor/editor.main'], async () => {
-      // Get current theme from domtools
-      const domtoolsInstance = await this.domtoolsPromise;
-      const isBright = domtoolsInstance.themeManager.goBrightBoolean;
-      const initialTheme = isBright ? 'vs' : 'vs-dark';
-
-      const editor = ((window as any).monaco.editor as typeof monaco.editor).create(container, {
-        value: this.content,
-        language: this.language,
-        theme: initialTheme,
-        useShadowDOM: true,
-        fontSize: 16,
-        automaticLayout: true,
-        wordWrap: this.wordWrap
-      });
-
-      // Subscribe to theme changes
-      this.monacoThemeSubscription = domtoolsInstance.themeManager.themeObservable.subscribe((goBright: boolean) => {
-        const newTheme = goBright ? 'vs' : 'vs-dark';
-        editor.updateOptions({ theme: newTheme });
-      });
-
-      this.editorDeferred.resolve(editor);
-    });
-    const css = await (
-      await fetch(`${monacoCdnBase}/min/vs/editor/editor.main.css`)
-    ).text();
-    const styleElement = document.createElement('style');
-    styleElement.textContent = css;
-    this.shadowRoot.append(styleElement);
-
-
-    // editor is setup let do the rest
-    const editor = await this.editorDeferred.promise;
-    editor.onDidChangeModelContent(async eventArg => {
-      this.contentSubject.next(editor.getValue());
-    });
-    this.contentSubject.next(editor.getValue());
-  }
-
-  public async disconnectedCallback(): Promise<void> {
-    await super.disconnectedCallback();
-    if (this.monacoThemeSubscription) {
-      this.monacoThemeSubscription.unsubscribe();
-      this.monacoThemeSubscription = null;
-    }
-  }
-}

ts_web/elements/00group-editor/dees-editor-monaco/index.ts

@@ -1 +0,0 @@
-export * from './dees-editor-monaco.js';

ts_web/elements/00group-editor/dees-editor-workspace/dees-editor-workspace.ts

@@ -1,601 +0,0 @@
-import {
-  DeesElement,
-  property,
-  html,
-  customElement,
-  type TemplateResult,
-  css,
-  cssManager,
-  state,
-} from '@design.estate/dees-element';
-import * as domtools from '@design.estate/dees-domtools';
-import { themeDefaultStyles } from '../../00theme.js';
-import type { IExecutionEnvironment } from '../../00group-runtime/index.js';
-import { WebContainerEnvironment } from '../../00group-runtime/index.js';
-import '../dees-editor-monaco/dees-editor-monaco.js';
-import '../dees-editor-filetree/dees-editor-filetree.js';
-import '../../dees-terminal/dees-terminal.js';
-import '../../dees-icon/dees-icon.js';
-import { DeesEditorMonaco } from '../dees-editor-monaco/dees-editor-monaco.js';
-
-declare global {
-  interface HTMLElementTagNameMap {
-    'dees-editor-workspace': DeesEditorWorkspace;
-  }
-}
-
-interface IOpenFile {
-  path: string;
-  name: string;
-  content: string;
-  modified: boolean;
-}
-
-@customElement('dees-editor-workspace')
-export class DeesEditorWorkspace extends DeesElement {
-  public static demo = () => {
-    const env = new WebContainerEnvironment();
-    return html`
-      <div style="width: 100%; height: 600px; position: relative;">
-        <dees-editor-workspace .executionEnvironment=${env}></dees-editor-workspace>
-      </div>
-    `;
-  };
-
-  // INSTANCE
-  @property({ type: Object })
-  accessor executionEnvironment: IExecutionEnvironment | null = null;
-
-  @property({ type: Boolean })
-  accessor showFileTree: boolean = true;
-
-  @property({ type: Boolean })
-  accessor showTerminal: boolean = true;
-
-  @property({ type: Number })
-  accessor fileTreeWidth: number = 250;
-
-  @property({ type: Number })
-  accessor terminalHeight: number = 200;
-
-  @state()
-  accessor openFiles: IOpenFile[] = [];
-
-  @state()
-  accessor activeFilePath: string = '';
-
-  @state()
-  accessor isTerminalCollapsed: boolean = false;
-
-  @state()
-  accessor isFileTreeCollapsed: boolean = false;
-
-  @state()
-  accessor isInitializing: boolean = true;
-
-  private editorElement: DeesEditorMonaco | null = null;
-  private initializationStarted: boolean = false;
-
-  public static styles = [
-    themeDefaultStyles,
-    cssManager.defaultStyles,
-    css`
-      :host {
-        display: block;
-        position: absolute;
-        top: 0;
-        left: 0;
-        right: 0;
-        bottom: 0;
-        background: ${cssManager.bdTheme('hsl(0 0% 96%)', 'hsl(0 0% 7%)')};
-        font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-      }
-
-      .workspace-container {
-        display: grid;
-        height: 100%;
-        width: 100%;
-      }
-
-      .workspace-container.with-filetree.with-terminal {
-        grid-template-columns: auto 1fr;
-        grid-template-rows: 1fr auto;
-        grid-template-areas:
-          "filetree editor"
-          "filetree terminal";
-      }
-
-      .workspace-container.with-filetree:not(.with-terminal) {
-        grid-template-columns: auto 1fr;
-        grid-template-rows: 1fr;
-        grid-template-areas: "filetree editor";
-      }
-
-      .workspace-container:not(.with-filetree).with-terminal {
-        grid-template-columns: 1fr;
-        grid-template-rows: 1fr auto;
-        grid-template-areas:
-          "editor"
-          "terminal";
-      }
-
-      .workspace-container:not(.with-filetree):not(.with-terminal) {
-        grid-template-columns: 1fr;
-        grid-template-rows: 1fr;
-        grid-template-areas: "editor";
-      }
-
-      .filetree-panel {
-        grid-area: filetree;
-        position: relative;
-        border-right: 1px solid ${cssManager.bdTheme('hsl(0 0% 85%)', 'hsl(0 0% 15%)')};
-        overflow: hidden;
-        transition: width 0.2s ease;
-      }
-
-      .filetree-panel.collapsed {
-        width: 0 !important;
-        border-right: none;
-      }
-
-      .editor-panel {
-        grid-area: editor;
-        position: relative;
-        display: flex;
-        flex-direction: column;
-        overflow: hidden;
-        background: ${cssManager.bdTheme('hsl(0 0% 100%)', 'hsl(0 0% 9%)')};
-      }
-
-      .terminal-panel {
-        grid-area: terminal;
-        position: relative;
-        border-top: 1px solid ${cssManager.bdTheme('hsl(0 0% 85%)', 'hsl(0 0% 15%)')};
-        overflow: hidden;
-        transition: height 0.2s ease;
-      }
-
-      .terminal-panel.collapsed {
-        height: 32px !important;
-      }
-
-      .panel-header {
-        height: 32px;
-        display: flex;
-        align-items: center;
-        justify-content: space-between;
-        padding: 0 8px;
-        background: ${cssManager.bdTheme('hsl(0 0% 95%)', 'hsl(0 0% 8%)')};
-        border-bottom: 1px solid ${cssManager.bdTheme('hsl(0 0% 85%)', 'hsl(0 0% 15%)')};
-        font-size: 12px;
-        font-weight: 500;
-        color: ${cssManager.bdTheme('hsl(0 0% 40%)', 'hsl(0 0% 60%)')};
-      }
-
-      .panel-header-title {
-        display: flex;
-        align-items: center;
-        gap: 6px;
-      }
-
-      .panel-header-actions {
-        display: flex;
-        align-items: center;
-        gap: 4px;
-      }
-
-      .panel-action {
-        width: 24px;
-        height: 24px;
-        display: flex;
-        align-items: center;
-        justify-content: center;
-        border-radius: 4px;
-        cursor: pointer;
-        color: ${cssManager.bdTheme('hsl(0 0% 50%)', 'hsl(0 0% 60%)')};
-        transition: all 0.15s ease;
-      }
-
-      .panel-action:hover {
-        background: ${cssManager.bdTheme('hsl(0 0% 88%)', 'hsl(0 0% 18%)')};
-        color: ${cssManager.bdTheme('hsl(0 0% 30%)', 'hsl(0 0% 80%)')};
-      }
-
-      .tabs-bar {
-        display: flex;
-        align-items: stretch;
-        height: 36px;
-        background: ${cssManager.bdTheme('hsl(0 0% 96%)', 'hsl(0 0% 8%)')};
-        border-bottom: 1px solid ${cssManager.bdTheme('hsl(0 0% 85%)', 'hsl(0 0% 15%)')};
-        overflow-x: auto;
-      }
-
-      .tab {
-        display: flex;
-        align-items: center;
-        gap: 6px;
-        padding: 0 12px;
-        min-width: 120px;
-        max-width: 200px;
-        border-right: 1px solid ${cssManager.bdTheme('hsl(0 0% 88%)', 'hsl(0 0% 12%)')};
-        cursor: pointer;
-        font-size: 12px;
-        color: ${cssManager.bdTheme('hsl(0 0% 50%)', 'hsl(0 0% 60%)')};
-        background: ${cssManager.bdTheme('hsl(0 0% 94%)', 'hsl(0 0% 10%)')};
-        transition: all 0.15s ease;
-      }
-
-      .tab:hover {
-        background: ${cssManager.bdTheme('hsl(0 0% 92%)', 'hsl(0 0% 12%)')};
-      }
-
-      .tab.active {
-        background: ${cssManager.bdTheme('hsl(0 0% 100%)', 'hsl(0 0% 9%)')};
-        color: ${cssManager.bdTheme('hsl(0 0% 20%)', 'hsl(0 0% 90%)')};
-        border-bottom: 2px solid ${cssManager.bdTheme('hsl(210 100% 50%)', 'hsl(210 100% 60%)')};
-      }
-
-      .tab-name {
-        flex: 1;
-        overflow: hidden;
-        text-overflow: ellipsis;
-        white-space: nowrap;
-      }
-
-      .tab-close {
-        width: 16px;
-        height: 16px;
-        display: flex;
-        align-items: center;
-        justify-content: center;
-        border-radius: 4px;
-        opacity: 0;
-        transition: all 0.15s ease;
-      }
-
-      .tab:hover .tab-close {
-        opacity: 1;
-      }
-
-      .tab-close:hover {
-        background: ${cssManager.bdTheme('hsl(0 0% 85%)', 'hsl(0 0% 25%)')};
-      }
-
-      .tab-modified {
-        width: 8px;
-        height: 8px;
-        border-radius: 50%;
-        background: ${cssManager.bdTheme('hsl(0 0% 50%)', 'hsl(0 0% 60%)')};
-      }
-
-      .editor-content {
-        flex: 1;
-        position: relative;
-      }
-
-      .terminal-content {
-        position: absolute;
-        top: 32px;
-        left: 0;
-        right: 0;
-        bottom: 0;
-      }
-
-      .empty-state {
-        display: flex;
-        flex-direction: column;
-        align-items: center;
-        justify-content: center;
-        height: 100%;
-        color: ${cssManager.bdTheme('hsl(0 0% 50%)', 'hsl(0 0% 50%)')};
-        font-size: 14px;
-        gap: 8px;
-      }
-
-      .empty-state dees-icon {
-        width: 48px;
-        height: 48px;
-        opacity: 0.5;
-      }
-
-      .initializing {
-        display: flex;
-        flex-direction: column;
-        align-items: center;
-        justify-content: center;
-        height: 100%;
-        color: ${cssManager.bdTheme('hsl(0 0% 50%)', 'hsl(0 0% 60%)')};
-        font-size: 14px;
-        gap: 12px;
-      }
-
-      dees-editor-filetree {
-        position: absolute;
-        top: 0;
-        left: 0;
-        right: 0;
-        bottom: 0;
-      }
-
-      dees-editor-monaco {
-        position: absolute;
-        top: 0;
-        left: 0;
-        right: 0;
-        bottom: 0;
-      }
-
-      dees-terminal {
-        position: absolute;
-        top: 0;
-        left: 0;
-        right: 0;
-        bottom: 0;
-      }
-    `,
-  ];
-
-  public render(): TemplateResult {
-    const containerClasses = [
-      'workspace-container',
-      this.showFileTree && !this.isFileTreeCollapsed ? 'with-filetree' : '',
-      this.showTerminal ? 'with-terminal' : '',
-    ].filter(Boolean).join(' ');
-
-    if (this.isInitializing) {
-      return html`
-        <div class="initializing">
-          <dees-icon .icon=${'lucide:loader2'} iconSize="32"></dees-icon>
-          <span>Initializing workspace...</span>
-        </div>
-      `;
-    }
-
-    return html`
-      <div class="${containerClasses}">
-        ${this.showFileTree ? html`
-          <div
-            class="filetree-panel ${this.isFileTreeCollapsed ? 'collapsed' : ''}"
-            style="width: ${this.isFileTreeCollapsed ? 0 : this.fileTreeWidth}px"
-          >
-            <dees-editor-filetree
-              .executionEnvironment=${this.executionEnvironment}
-              .selectedPath=${this.activeFilePath}
-              @file-select=${this.handleFileSelect}
-            ></dees-editor-filetree>
-          </div>
-        ` : ''}
-
-        <div class="editor-panel">
-          <div class="tabs-bar">
-            ${this.openFiles.map(file => html`
-              <div
-                class="tab ${file.path === this.activeFilePath ? 'active' : ''}"
-                @click=${() => this.activateFile(file.path)}
-              >
-                ${file.modified ? html`<span class="tab-modified"></span>` : ''}
-                <span class="tab-name">${file.name}</span>
-                <span class="tab-close" @click=${(e: Event) => this.closeFile(e, file.path)}>
-                  <dees-icon .icon=${'lucide:x'} iconSize="12"></dees-icon>
-                </span>
-              </div>
-            `)}
-          </div>
-          <div class="editor-content">
-            ${this.openFiles.length === 0 ? html`
-              <div class="empty-state">
-                <dees-icon .icon=${'lucide:fileCode'} iconSize="48"></dees-icon>
-                <span>Select a file to edit</span>
-              </div>
-            ` : html`
-              <dees-editor-monaco
-                .content=${this.getActiveFileContent()}
-                .language=${this.getLanguageFromPath(this.activeFilePath)}
-                @content-change=${this.handleContentChange}
-              ></dees-editor-monaco>
-            `}
-          </div>
-        </div>
-
-        ${this.showTerminal ? html`
-          <div
-            class="terminal-panel ${this.isTerminalCollapsed ? 'collapsed' : ''}"
-            style="height: ${this.isTerminalCollapsed ? 32 : this.terminalHeight}px"
-          >
-            <div class="panel-header">
-              <div class="panel-header-title">
-                <dees-icon .icon=${'lucide:terminal'} iconSize="14"></dees-icon>
-                Terminal
-              </div>
-              <div class="panel-header-actions">
-                <div class="panel-action" @click=${this.toggleTerminal}>
-                  <dees-icon
-                    .icon=${this.isTerminalCollapsed ? 'lucide:chevronUp' : 'lucide:chevronDown'}
-                    iconSize="14"
-                  ></dees-icon>
-                </div>
-              </div>
-            </div>
-            <div class="terminal-content">
-              <dees-terminal
-                .executionEnvironment=${this.executionEnvironment}
-                .setupCommand=${''}
-              ></dees-terminal>
-            </div>
-          </div>
-        ` : ''}
-      </div>
-    `;
-  }
-
-  public async firstUpdated() {
-    if (this.executionEnvironment) {
-      await this.initializeWorkspace();
-    }
-  }
-
-  public async updated(changedProperties: Map<string, any>) {
-    if (changedProperties.has('executionEnvironment') && this.executionEnvironment) {
-      await this.initializeWorkspace();
-    }
-  }
-
-  private async initializeWorkspace() {
-    if (!this.executionEnvironment) return;
-
-    // Prevent double initialization
-    if (this.initializationStarted) return;
-    this.initializationStarted = true;
-
-    this.isInitializing = true;
-
-    try {
-      if (!this.executionEnvironment.ready) {
-        await this.executionEnvironment.init();
-      }
-    } catch (error) {
-      console.error('Failed to initialize workspace:', error);
-      // Reset flag to allow retry
-      this.initializationStarted = false;
-    } finally {
-      this.isInitializing = false;
-    }
-  }
-
-  private async handleFileSelect(e: CustomEvent<{ path: string; name: string }>) {
-    const { path, name } = e.detail;
-    await this.openFile(path, name);
-  }
-
-  private async openFile(path: string, name: string) {
-    // Check if already open
-    const existingFile = this.openFiles.find(f => f.path === path);
-    if (existingFile) {
-      this.activeFilePath = path;
-      return;
-    }
-
-    // Load file content
-    if (!this.executionEnvironment) return;
-
-    try {
-      const content = await this.executionEnvironment.readFile(path);
-      this.openFiles = [
-        ...this.openFiles,
-        { path, name, content, modified: false },
-      ];
-      this.activeFilePath = path;
-    } catch (error) {
-      console.error(`Failed to open file ${path}:`, error);
-    }
-  }
-
-  private activateFile(path: string) {
-    this.activeFilePath = path;
-  }
-
-  private closeFile(e: Event, path: string) {
-    e.stopPropagation();
-
-    const fileIndex = this.openFiles.findIndex(f => f.path === path);
-    if (fileIndex === -1) return;
-
-    // Check for unsaved changes
-    const file = this.openFiles[fileIndex];
-    if (file.modified) {
-      const confirmed = confirm(`${file.name} has unsaved changes. Close anyway?`);
-      if (!confirmed) return;
-    }
-
-    this.openFiles = this.openFiles.filter(f => f.path !== path);
-
-    // If closing the active file, activate another one
-    if (this.activeFilePath === path) {
-      if (this.openFiles.length > 0) {
-        const newIndex = Math.min(fileIndex, this.openFiles.length - 1);
-        this.activeFilePath = this.openFiles[newIndex].path;
-      } else {
-        this.activeFilePath = '';
-      }
-    }
-  }
-
-  private getActiveFileContent(): string {
-    const file = this.openFiles.find(f => f.path === this.activeFilePath);
-    return file?.content || '';
-  }
-
-  private handleContentChange(e: CustomEvent) {
-    const newContent = e.detail;
-    const fileIndex = this.openFiles.findIndex(f => f.path === this.activeFilePath);
-    if (fileIndex === -1) return;
-
-    const file = this.openFiles[fileIndex];
-    if (file.content !== newContent) {
-      this.openFiles = [
-        ...this.openFiles.slice(0, fileIndex),
-        { ...file, content: newContent, modified: true },
-        ...this.openFiles.slice(fileIndex + 1),
-      ];
-    }
-  }
-
-  private getLanguageFromPath(path: string): string {
-    const ext = path.split('.').pop()?.toLowerCase();
-    const languageMap: Record<string, string> = {
-      ts: 'typescript',
-      tsx: 'typescript',
-      js: 'javascript',
-      jsx: 'javascript',
-      json: 'json',
-      html: 'html',
-      css: 'css',
-      scss: 'scss',
-      less: 'less',
-      md: 'markdown',
-      yaml: 'yaml',
-      yml: 'yaml',
-      xml: 'xml',
-      sql: 'sql',
-      py: 'python',
-      sh: 'shell',
-      bash: 'shell',
-    };
-    return languageMap[ext || ''] || 'plaintext';
-  }
-
-  private toggleTerminal() {
-    this.isTerminalCollapsed = !this.isTerminalCollapsed;
-  }
-
-  public async saveActiveFile(): Promise<void> {
-    const file = this.openFiles.find(f => f.path === this.activeFilePath);
-    if (!file || !this.executionEnvironment) return;
-
-    try {
-      await this.executionEnvironment.writeFile(file.path, file.content);
-      const fileIndex = this.openFiles.findIndex(f => f.path === this.activeFilePath);
-      this.openFiles = [
-        ...this.openFiles.slice(0, fileIndex),
-        { ...file, modified: false },
-        ...this.openFiles.slice(fileIndex + 1),
-      ];
-    } catch (error) {
-      console.error('Failed to save file:', error);
-    }
-  }
-
-  public async saveAllFiles(): Promise<void> {
-    if (!this.executionEnvironment) return;
-
-    for (const file of this.openFiles.filter(f => f.modified)) {
-      try {
-        await this.executionEnvironment.writeFile(file.path, file.content);
-      } catch (error) {
-        console.error(`Failed to save ${file.path}:`, error);
-      }
-    }
-
-    this.openFiles = this.openFiles.map(f => ({ ...f, modified: false }));
-  }
-}

ts_web/elements/00group-editor/dees-editor-workspace/index.ts

@@ -1 +0,0 @@
-export * from './dees-editor-workspace.js';

ts_web/elements/00group-editor/index.ts

@@ -1,6 +0,0 @@
-// Editor Components
-export * from './dees-editor-monaco/index.js';
-export * from './dees-editor-filetree/index.js';
-export * from './dees-editor-workspace/index.js';
-export * from './dees-editor-markdown/index.js';
-export * from './dees-editor-markdownoutlet/index.js';

ts_web/elements/00group-input/dees-input-code/dees-input-code.ts

@@ -12,8 +12,8 @@ import { themeDefaultStyles } from '../../00theme.js';
 import { DeesModal } from '../../dees-modal/dees-modal.js';
 import '../../dees-icon/dees-icon.js';
 import '../../dees-label/dees-label.js';
-import '../../00group-editor/dees-editor-monaco/dees-editor-monaco.js';
-import { DeesEditorMonaco } from '../../00group-editor/dees-editor-monaco/dees-editor-monaco.js';
+import '../../00group-workspace/dees-workspace-monaco/dees-workspace-monaco.js';
+import { DeesWorkspaceMonaco } from '../../00group-workspace/dees-workspace-monaco/dees-workspace-monaco.js';
 
 declare global {
   interface HTMLElementTagNameMap {
@@ -77,7 +77,7 @@ export class DeesInputCode extends DeesInputBase<string> {
   @state()
   accessor copySuccess: boolean = false;
 
-  private editorElement: DeesEditorMonaco | null = null;
+  private editorElement: DeesWorkspaceMonaco | null = null;
 
   public static styles = [
     themeDefaultStyles,
@@ -207,7 +207,7 @@ export class DeesInputCode extends DeesInputBase<string> {
         position: relative;
       }
 
-      dees-editor-monaco {
+      dees-workspace-monaco {
         display: block;
       }
 
@@ -295,12 +295,12 @@ export class DeesInputCode extends DeesInputBase<string> {
             </div>
           </div>
           <div class="editor-wrapper">
-            <dees-editor-monaco
+            <dees-workspace-monaco
               .content=${this.value}
               .language=${this.language}
               .wordWrap=${this.wordWrap}
               @content-change=${this.handleContentChange}
-            ></dees-editor-monaco>
+            ></dees-workspace-monaco>
           </div>
         </div>
       </div>
@@ -308,7 +308,7 @@ export class DeesInputCode extends DeesInputBase<string> {
   }
 
   async firstUpdated() {
-    this.editorElement = this.shadowRoot?.querySelector('dees-editor-monaco') as DeesEditorMonaco;
+    this.editorElement = this.shadowRoot?.querySelector('dees-workspace-monaco') as DeesWorkspaceMonaco;
     if (this.editorElement) {
       // Subscribe to content changes from the editor
       this.editorElement.contentSubject.subscribe((newContent: string) => {
@@ -386,7 +386,7 @@ export class DeesInputCode extends DeesInputBase<string> {
 
   public async openFullscreen() {
     const currentValue = this.value;
-    let modalEditorElement: DeesEditorMonaco | null = null;
+    let modalEditorElement: DeesWorkspaceMonaco | null = null;
 
     // Modal-specific state
     let modalLanguage = this.language;
@@ -579,11 +579,11 @@ export class DeesInputCode extends DeesInputBase<string> {
           </div>
         </div>
         <div class="modal-editor-wrapper">
-          <dees-editor-monaco
+          <dees-workspace-monaco
             .content=${currentValue}
             .language=${modalLanguage}
             .wordWrap=${modalWordWrap}
-          ></dees-editor-monaco>
+          ></dees-workspace-monaco>
         </div>
       `,
       menuOptions: [
@@ -597,7 +597,7 @@ export class DeesInputCode extends DeesInputBase<string> {
           name: 'Save & Close',
           action: async (modalRef) => {
             // Get the editor content from the modal
-            modalEditorElement = modalRef.shadowRoot?.querySelector('dees-editor-monaco') as DeesEditorMonaco;
+            modalEditorElement = modalRef.shadowRoot?.querySelector('dees-workspace-monaco') as DeesWorkspaceMonaco;
             if (modalEditorElement) {
               const editor = await modalEditorElement.editorDeferred.promise;
               const newValue = editor.getValue();
@@ -611,7 +611,7 @@ export class DeesInputCode extends DeesInputBase<string> {
 
     // Wait for modal to render
     await new Promise(resolve => setTimeout(resolve, 100));
-    modalEditorElement = modal.shadowRoot?.querySelector('dees-editor-monaco') as DeesEditorMonaco;
+    modalEditorElement = modal.shadowRoot?.querySelector('dees-workspace-monaco') as DeesWorkspaceMonaco;
 
     // Wire up toolbar event handlers
     const toolbar = modal.shadowRoot?.querySelector('.modal-toolbar');

ts_web/elements/00group-input/dees-input-richtext/component.ts

@@ -14,12 +14,8 @@ import {
   query,
 } from '@design.estate/dees-element';
 
-import { Editor } from '@tiptap/core';
-import StarterKit from '@tiptap/starter-kit';
-import Underline from '@tiptap/extension-underline';
-import TextAlign from '@tiptap/extension-text-align';
-import Link from '@tiptap/extension-link';
-import Typography from '@tiptap/extension-typography';
+import type { Editor } from '@tiptap/core';
+import { DeesServiceLibLoader, type ITiptapBundle } from '../../../services/index.js';
 
 declare global {
   interface HTMLElementTagNameMap {
@@ -63,6 +59,7 @@ export class DeesInputRichtext extends DeesInputBase<string> {
 
   private editorElement: HTMLElement;
   private linkInputElement: HTMLInputElement;
+  private tiptapBundle: ITiptapBundle | null = null;
 
   public editor: Editor;
 
@@ -233,13 +230,19 @@ export class DeesInputRichtext extends DeesInputBase<string> {
 
   public async firstUpdated() {
     await this.updateComplete;
+
+    // Load Tiptap from CDN
+    this.tiptapBundle = await DeesServiceLibLoader.getInstance().loadTiptap();
+
     this.editorElement = this.shadowRoot.querySelector('.editor-content');
     this.linkInputElement = this.shadowRoot.querySelector('.link-input input');
     this.initializeEditor();
   }
 
   private initializeEditor(): void {
-    if (this.disabled) return;
+    if (this.disabled || !this.tiptapBundle) return;
+
+    const { Editor, StarterKit, Underline, TextAlign, Link, Typography } = this.tiptapBundle;
 
     this.editor = new Editor({
       element: this.editorElement,
@@ -249,7 +252,7 @@ export class DeesInputRichtext extends DeesInputBase<string> {
             levels: [1, 2, 3],
           },
         }),
-        Underline,
+        Underline.configure({}),
         TextAlign.configure({
           types: ['heading', 'paragraph'],
         }),
@@ -259,7 +262,7 @@ export class DeesInputRichtext extends DeesInputBase<string> {
             class: 'editor-link',
           },
         }),
-        Typography,
+        Typography.configure({}),
       ],
       content: this.value || (this.placeholder ? `<p>${this.placeholder}</p>` : ''),
       onUpdate: ({ editor }) => {

ts_web/elements/00group-input/dees-input-wysiwyg/blocks/text/code.block.ts

@@ -2,9 +2,10 @@ import { BaseBlockHandler, type IBlockEventHandlers } from '../block.base.js';
 import type { IBlock } from '../../wysiwyg.types.js';
 import { cssManager } from '@design.estate/dees-element';
 import { WysiwygSelection } from '../../wysiwyg.selection.js';
-import hlight from 'highlight.js';
+import type { HLJSApi } from 'highlight.js';
 import { cssGeistFontFamily, cssMonoFontFamily } from '../../../../00fonts.js';
 import { PROGRAMMING_LANGUAGES } from '../../wysiwyg.constants.js';
+import { DeesServiceLibLoader } from '../../../../../services/index.js';
 
 /**
  * CodeBlockHandler with improved architecture
@@ -20,6 +21,7 @@ export class CodeBlockHandler extends BaseBlockHandler {
   type = 'code';
 
   private highlightTimer: any = null;
+  private highlightJs: HLJSApi | null = null;
   
   render(block: IBlock, isSelected: boolean): string {
     const language = block.metadata?.language || 'typescript';
@@ -306,10 +308,15 @@ export class CodeBlockHandler extends BaseBlockHandler {
     return linesBeforeCursor.length - 1; // 0-indexed
   }
   
-  private applyHighlighting(element: HTMLElement, block: IBlock): void {
+  private async applyHighlighting(element: HTMLElement, block: IBlock): Promise<void> {
     const editor = element.querySelector('.code-editor') as HTMLElement;
     if (!editor) return;
 
+    // Load highlight.js from CDN if not already loaded
+    if (!this.highlightJs) {
+      this.highlightJs = await DeesServiceLibLoader.getInstance().loadHighlightJs();
+    }
+
     // Store cursor position
     const cursorPos = this.getCursorPosition(element);
 
@@ -319,9 +326,9 @@ export class CodeBlockHandler extends BaseBlockHandler {
 
     // Apply highlighting
     try {
-      const result = hlight.highlight(content, { 
+      const result = this.highlightJs.highlight(content, {
         language: language,
-        ignoreIllegals: true 
+        ignoreIllegals: true,
       });
 
       // Only update if we have valid highlighted content

ts_web/elements/00group-runtime/environments/WebContainerEnvironment.ts

@@ -1,5 +1,5 @@
-import * as webcontainer from '@webcontainer/api';
-import type { IExecutionEnvironment, IFileEntry, IProcessHandle } from '../interfaces/IExecutionEnvironment.js';
+import * as webcontainer from '@tempfix/webcontainer__api';
+import type { IExecutionEnvironment, IFileEntry, IFileWatcher, IProcessHandle } from '../interfaces/IExecutionEnvironment.js';
 
 /**
  * WebContainer-based execution environment.
@@ -123,6 +123,22 @@ export class WebContainerEnvironment implements IExecutionEnvironment {
     }
   }
 
+  public watch(
+    path: string,
+    callback: (event: 'rename' | 'change', filename: string | null) => void,
+    options?: { recursive?: boolean }
+  ): IFileWatcher {
+    this.ensureReady();
+    const watcher = this.container!.fs.watch(
+      path,
+      { recursive: options?.recursive ?? false },
+      callback
+    );
+    return {
+      stop: () => watcher.close(),
+    };
+  }
+
   // ============ Process Execution ============
 
   public async spawn(command: string, args: string[] = []): Promise<IProcessHandle> {

ts_web/elements/00group-runtime/interfaces/IExecutionEnvironment.ts

@@ -7,6 +7,14 @@ export interface IFileEntry {
   path: string;
 }
 
+/**
+ * Handle to a file system watcher
+ */
+export interface IFileWatcher {
+  /** Stop watching for changes */
+  stop(): void;
+}
+
 /**
  * Handle to a spawned process with I/O streams
  */
@@ -68,6 +76,19 @@ export interface IExecutionEnvironment {
    */
   exists(path: string): Promise<boolean>;
 
+  /**
+   * Watch a file or directory for changes
+   * @param path - Absolute path to watch
+   * @param callback - Called when changes occur
+   * @param options - Optional: { recursive: true } to watch subdirectories
+   * @returns Watcher handle with stop() method
+   */
+  watch(
+    path: string,
+    callback: (event: 'rename' | 'change', filename: string | null) => void,
+    options?: { recursive?: boolean }
+  ): IFileWatcher;
+
   // ============ Process Execution ============
 
   /**

ts_web/elements/00group-simple/dees-simple-appdash/dees-simple-appdash.ts

@@ -14,7 +14,7 @@ import {
   domtools,
 } from '@design.estate/dees-element';
 import '../../dees-icon/dees-icon.js';
-import type { DeesTerminal } from '../../dees-terminal/dees-terminal.js';
+import type { DeesWorkspaceTerminal } from '../../00group-workspace/dees-workspace-terminal/dees-workspace-terminal.js';
 import { themeDefaultStyles } from '../../00theme.js';
 
 declare global {
@@ -393,7 +393,7 @@ export class DeesSimpleAppDash extends DeesElement {
     }
   }
   
-  public currentTerminal: DeesTerminal;
+  public currentTerminal: DeesWorkspaceTerminal;
   public async launchTerminal() {
     const domtools = await this.domtoolsPromise;
     if (this.currentTerminal) {
@@ -403,8 +403,8 @@ export class DeesSimpleAppDash extends DeesElement {
     }
 
     const maincontainer = this.shadowRoot.querySelector('.maincontainer');
-    const { DeesTerminal } = await import('../../dees-terminal/dees-terminal.js');
-    const terminal = new DeesTerminal();
+    const { DeesWorkspaceTerminal } = await import('../../00group-workspace/dees-workspace-terminal/dees-workspace-terminal.js');
+    const terminal = new DeesWorkspaceTerminal();
     terminal.setupCommand = this.terminalSetupCommand;
     this.currentTerminal = terminal;
     maincontainer.appendChild(terminal);
@@ -417,7 +417,6 @@ export class DeesSimpleAppDash extends DeesElement {
     terminal.style.opacity = '0';
     terminal.style.transform = 'translateY(8px) scale(0.99)';
     terminal.style.transition = 'all 0.25s cubic-bezier(0.4, 0, 0.2, 1)';
-    terminal.background = 'hsl(220 13% 8%)';
     terminal.style.boxShadow = '0 25px 50px -12px rgb(0 0 0 / 0.5), 0 0 0 1px rgb(255 255 255 / 0.05)';
     terminal.style.maxWidth = `calc(${maincontainer.clientWidth}px -240px)`;
     terminal.style.maxHeight = `calc(${maincontainer.clientHeight}px - 24px)`;

ts_web/elements/00group-workspace/dees-workspace-bottombar/dees-workspace-bottombar.ts

@@ -0,0 +1,548 @@
+import {
+  DeesElement,
+  property,
+  html,
+  customElement,
+  type TemplateResult,
+  css,
+  cssManager,
+  state,
+} from '@design.estate/dees-element';
+import { themeDefaultStyles } from '../../00theme.js';
+import type { IExecutionEnvironment } from '../../00group-runtime/index.js';
+import '../../dees-icon/dees-icon.js';
+import { DeesContextmenu } from '../../dees-contextmenu/dees-contextmenu.js';
+import type { IRunProcessEventDetail, ITerminalProcessCompleteEventDetail } from '../dees-workspace-terminal/interfaces.js';
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'dees-workspace-bottombar': DeesWorkspaceBottombar;
+  }
+}
+
+interface IOutdatedPackage {
+  name: string;
+  current: string;
+  wanted: string;
+  latest: string;
+  type: 'dependencies' | 'devDependencies';
+}
+
+@customElement('dees-workspace-bottombar')
+export class DeesWorkspaceBottombar extends DeesElement {
+  // INSTANCE
+  @property({ type: Object })
+  accessor executionEnvironment: IExecutionEnvironment | null = null;
+
+  // Script runner state
+  @state()
+  accessor scripts: Record<string, string> = {};
+
+  // Package checker state
+  @state()
+  accessor packageStatus: 'checking' | 'up-to-date' | 'updates-available' | 'error' | 'idle' = 'idle';
+
+  @state()
+  accessor outdatedPackages: IOutdatedPackage[] = [];
+
+  @state()
+  accessor isCheckingPackages: boolean = false;
+
+  // Track if we have a pending package update that should trigger refresh
+  private pendingPackageUpdate: boolean = false;
+
+  // Bound handler for process-complete events
+  private handleProcessComplete = (e: CustomEvent<ITerminalProcessCompleteEventDetail>) => {
+    // If we have a pending package update and a process completed, refresh
+    if (this.pendingPackageUpdate) {
+      this.pendingPackageUpdate = false;
+      // Small delay to let pnpm-lock.yaml update
+      setTimeout(() => this.checkPackages(), 500);
+    }
+  };
+
+  public static styles = [
+    themeDefaultStyles,
+    cssManager.defaultStyles,
+    css`
+      :host {
+        display: block;
+        height: 24px;
+        flex-shrink: 0;
+      }
+
+      .bottom-bar {
+        height: 24px;
+        display: flex;
+        align-items: center;
+        padding: 0 8px;
+        gap: 4px;
+        background: ${cssManager.bdTheme('hsl(0 0% 94%)', 'hsl(0 0% 6%)')};
+        border-top: 1px solid ${cssManager.bdTheme('hsl(0 0% 85%)', 'hsl(0 0% 15%)')};
+        font-size: 11px;
+        color: ${cssManager.bdTheme('hsl(0 0% 40%)', 'hsl(0 0% 60%)')};
+      }
+
+      .widget {
+        display: flex;
+        align-items: center;
+        gap: 4px;
+        padding: 2px 6px;
+        border-radius: 3px;
+        cursor: pointer;
+        transition: background 0.15s ease, color 0.15s ease;
+        white-space: nowrap;
+      }
+
+      .widget:hover {
+        background: ${cssManager.bdTheme('hsl(0 0% 88%)', 'hsl(0 0% 12%)')};
+        color: ${cssManager.bdTheme('hsl(0 0% 20%)', 'hsl(0 0% 80%)')};
+      }
+
+      .widget dees-icon {
+        flex-shrink: 0;
+      }
+
+      .widget-separator {
+        width: 1px;
+        height: 14px;
+        background: ${cssManager.bdTheme('hsl(0 0% 80%)', 'hsl(0 0% 20%)')};
+        margin: 0 4px;
+      }
+
+      .widget.running {
+        color: ${cssManager.bdTheme('hsl(210 100% 45%)', 'hsl(210 100% 60%)')};
+      }
+
+      .widget.up-to-date {
+        color: ${cssManager.bdTheme('hsl(142 70% 35%)', 'hsl(142 70% 50%)')};
+      }
+
+      .widget.updates-available {
+        color: ${cssManager.bdTheme('hsl(38 92% 45%)', 'hsl(38 92% 55%)')};
+      }
+
+      .widget.error {
+        color: ${cssManager.bdTheme('hsl(0 70% 50%)', 'hsl(0 70% 60%)')};
+      }
+
+      @keyframes spin {
+        from { transform: rotate(0deg); }
+        to { transform: rotate(360deg); }
+      }
+
+      .spinning {
+        animation: spin 1s linear infinite;
+      }
+
+      .spacer {
+        flex: 1;
+      }
+    `,
+  ];
+
+  public render(): TemplateResult {
+    return html`
+      <div class="bottom-bar">
+        <!-- Script Runner Widget -->
+        <div
+          class="widget"
+          @click=${this.handleScriptClick}
+          title="Run script"
+        >
+          <dees-icon
+            .icon=${'lucide:play'}
+            iconSize="12"
+          ></dees-icon>
+          <span>Scripts</span>
+        </div>
+
+        <div class="widget-separator"></div>
+
+        <!-- Package Checker Widget -->
+        <div
+          class="widget ${this.getPackageStatusClass()}"
+          @click=${this.handlePackageClick}
+          title="${this.getPackageTooltip()}"
+        >
+          <dees-icon
+            .icon=${this.getPackageIcon()}
+            iconSize="12"
+            class="${this.isCheckingPackages ? 'spinning' : ''}"
+          ></dees-icon>
+          <span>${this.getPackageStatusText()}</span>
+        </div>
+
+        <div class="spacer"></div>
+
+        <!-- Future widgets can be added here -->
+      </div>
+    `;
+  }
+
+  public async connectedCallback() {
+    await super.connectedCallback();
+    // Listen for process-complete events to refresh after package updates
+    window.addEventListener('process-complete', this.handleProcessComplete as EventListener);
+  }
+
+  public async disconnectedCallback() {
+    await super.disconnectedCallback();
+    window.removeEventListener('process-complete', this.handleProcessComplete as EventListener);
+  }
+
+  async firstUpdated() {
+    await this.loadScripts();
+    await this.checkPackages();
+  }
+
+  async updated(changedProperties: Map<string, any>) {
+    if (changedProperties.has('executionEnvironment') && this.executionEnvironment) {
+      await this.loadScripts();
+      await this.checkPackages();
+    }
+  }
+
+  // ========== Script Runner ==========
+
+  private async loadScripts(): Promise<void> {
+    if (!this.executionEnvironment) return;
+
+    try {
+      const packageJsonExists = await this.executionEnvironment.exists('/package.json');
+      if (!packageJsonExists) {
+        this.scripts = {};
+        return;
+      }
+
+      const content = await this.executionEnvironment.readFile('/package.json');
+      const packageJson = JSON.parse(content);
+      this.scripts = packageJson.scripts || {};
+    } catch (error) {
+      console.warn('Failed to load scripts from package.json:', error);
+      this.scripts = {};
+    }
+  }
+
+  private async handleScriptClick(e: MouseEvent): Promise<void> {
+    e.stopPropagation();
+
+    const scriptNames = Object.keys(this.scripts);
+    if (scriptNames.length === 0) {
+      return;
+    }
+
+    const menuItems = scriptNames.map(name => ({
+      name: name,
+      iconName: 'lucide:terminal' as const,
+      action: async () => {
+        await this.runScript(name);
+      },
+    }));
+
+    await DeesContextmenu.openContextMenuWithOptions(e, menuItems);
+  }
+
+  private async runScript(scriptName: string): Promise<void> {
+    if (!this.executionEnvironment) return;
+
+    // Emit run-process event for the workspace to create a terminal tab
+    const detail: IRunProcessEventDetail = {
+      type: 'script',
+      label: scriptName,
+      command: 'pnpm',
+      args: ['run', scriptName],
+      metadata: { scriptName },
+    };
+
+    this.dispatchEvent(new CustomEvent('run-process', {
+      bubbles: true,
+      composed: true,
+      detail,
+    }));
+  }
+
+  // ========== Package Checker ==========
+
+  private async checkPackages(): Promise<void> {
+    if (!this.executionEnvironment) {
+      this.packageStatus = 'idle';
+      return;
+    }
+
+    try {
+      const packageJsonExists = await this.executionEnvironment.exists('/package.json');
+      if (!packageJsonExists) {
+        this.packageStatus = 'idle';
+        return;
+      }
+
+      this.packageStatus = 'checking';
+      this.isCheckingPackages = true;
+
+      // Run pnpm outdated --json with timeout
+      const process = await this.executionEnvironment.spawn('pnpm', ['outdated', '--json']);
+
+      let output = '';
+
+      // Collect output asynchronously - don't await, stream may not close if no output
+      const outputReader = process.output.getReader();
+      const readOutput = async () => {
+        try {
+          while (true) {
+            const { done, value } = await outputReader.read();
+            if (done) break;
+            output += value;
+          }
+        } catch {
+          // Ignore stream errors
+        }
+      };
+      // Start reading but don't await - we'll use whatever we have when process exits
+      readOutput();
+
+      // Wait for process exit with timeout (10 seconds)
+      const exitCode = await Promise.race([
+        process.exit,
+        new Promise<number>((resolve) => setTimeout(() => resolve(-1), 10000)),
+      ]);
+
+      // Cancel reader when done
+      try {
+        await outputReader.cancel();
+      } catch {
+        // Ignore cancel errors
+      }
+
+      // Handle timeout
+      if (exitCode === -1) {
+        console.warn('Package check timed out');
+        this.packageStatus = 'error';
+        return;
+      }
+
+      // pnpm outdated returns exit code 1 if there are outdated packages
+      if (exitCode === 0) {
+        // No outdated packages
+        this.packageStatus = 'up-to-date';
+        this.outdatedPackages = [];
+      } else {
+        // Parse outdated packages
+        try {
+          const outdatedData = JSON.parse(output);
+          this.outdatedPackages = this.parseOutdatedPackages(outdatedData);
+          this.packageStatus = this.outdatedPackages.length > 0 ? 'updates-available' : 'up-to-date';
+        } catch {
+          // If parsing fails but exit code is 1, assume there are updates
+          this.packageStatus = 'updates-available';
+          this.outdatedPackages = [];
+        }
+      }
+    } catch (error) {
+      console.warn('Failed to check for package updates:', error);
+      this.packageStatus = 'error';
+    } finally {
+      this.isCheckingPackages = false;
+    }
+  }
+
+  private parseOutdatedPackages(data: any): IOutdatedPackage[] {
+    const packages: IOutdatedPackage[] = [];
+
+    // pnpm outdated --json returns an object with package names as keys
+    if (typeof data === 'object' && data !== null) {
+      for (const [name, info] of Object.entries(data)) {
+        const pkgInfo = info as any;
+        packages.push({
+          name,
+          current: pkgInfo.current || 'unknown',
+          wanted: pkgInfo.wanted || pkgInfo.current || 'unknown',
+          latest: pkgInfo.latest || pkgInfo.wanted || 'unknown',
+          type: pkgInfo.dependencyType === 'devDependencies' ? 'devDependencies' : 'dependencies',
+        });
+      }
+    }
+
+    return packages;
+  }
+
+  private async handlePackageClick(e: MouseEvent): Promise<void> {
+    e.stopPropagation();
+
+    const menuItems: Parameters<typeof DeesContextmenu.openContextMenuWithOptions>[1] = [];
+
+    // Refresh option - show output in terminal
+    menuItems.push({
+      name: this.isCheckingPackages ? 'Checking...' : 'Check for updates',
+      iconName: 'lucide:refreshCw',
+      action: async () => {
+        if (this.isCheckingPackages) return;
+
+        // Create terminal tab to show pnpm outdated output
+        const detail: IRunProcessEventDetail = {
+          type: 'package-update',
+          label: 'check packages',
+          command: 'pnpm',
+          args: ['outdated'],
+        };
+
+        this.dispatchEvent(new CustomEvent('run-process', {
+          bubbles: true,
+          composed: true,
+          detail,
+        }));
+
+        // Also refresh the widget status silently after a delay
+        setTimeout(() => this.checkPackages(), 3000);
+      },
+    });
+
+    if (this.outdatedPackages.length > 0) {
+      menuItems.push({ divider: true });
+
+      // Show outdated packages (max 10)
+      const displayPackages = this.outdatedPackages.slice(0, 10);
+      for (const pkg of displayPackages) {
+        menuItems.push({
+          name: `${pkg.name}: ${pkg.current} → ${pkg.latest}`,
+          iconName: 'lucide:package',
+          action: async () => {
+            // Update single package
+            await this.updatePackage(pkg.name);
+          },
+        });
+      }
+
+      if (this.outdatedPackages.length > 10) {
+        menuItems.push({
+          name: `... and ${this.outdatedPackages.length - 10} more`,
+          iconName: 'lucide:moreHorizontal',
+          action: async () => {},
+        });
+      }
+
+      menuItems.push({ divider: true });
+
+      menuItems.push({
+        name: 'Update all packages',
+        iconName: 'lucide:arrowUpCircle',
+        action: async () => {
+          await this.updateAllPackages();
+        },
+      });
+    }
+
+    await DeesContextmenu.openContextMenuWithOptions(e, menuItems);
+  }
+
+  private async updatePackage(packageName: string): Promise<void> {
+    if (!this.executionEnvironment) return;
+
+    // Mark that we have a pending update - will trigger refresh when complete
+    this.pendingPackageUpdate = true;
+
+    // Emit run-process event for the workspace to create a terminal tab
+    const detail: IRunProcessEventDetail = {
+      type: 'package-update',
+      label: `update ${packageName}`,
+      command: 'pnpm',
+      args: ['update', '--latest', packageName],
+      metadata: { packageName },
+    };
+
+    this.dispatchEvent(new CustomEvent('run-process', {
+      bubbles: true,
+      composed: true,
+      detail,
+    }));
+  }
+
+  private async updateAllPackages(): Promise<void> {
+    if (!this.executionEnvironment) return;
+
+    // Mark that we have a pending update - will trigger refresh when complete
+    this.pendingPackageUpdate = true;
+
+    // Emit run-process event for the workspace to create a terminal tab
+    const detail: IRunProcessEventDetail = {
+      type: 'package-update',
+      label: 'update all',
+      command: 'pnpm',
+      args: ['update', '--latest'],
+    };
+
+    this.dispatchEvent(new CustomEvent('run-process', {
+      bubbles: true,
+      composed: true,
+      detail,
+    }));
+  }
+
+  // ========== Helper Methods ==========
+
+  private getPackageStatusClass(): string {
+    if (this.isCheckingPackages) return '';
+    return this.packageStatus;
+  }
+
+  private getPackageIcon(): string {
+    if (this.isCheckingPackages) return 'lucide:loader2';
+
+    switch (this.packageStatus) {
+      case 'up-to-date':
+        return 'lucide:checkCircle';
+      case 'updates-available':
+        return 'lucide:alertCircle';
+      case 'error':
+        return 'lucide:xCircle';
+      default:
+        return 'lucide:package';
+    }
+  }
+
+  private getPackageStatusText(): string {
+    if (this.isCheckingPackages) return 'Checking...';
+
+    switch (this.packageStatus) {
+      case 'up-to-date':
+        return 'Up to date';
+      case 'updates-available':
+        return `${this.outdatedPackages.length} update${this.outdatedPackages.length !== 1 ? 's' : ''}`;
+      case 'error':
+        return 'Check failed';
+      default:
+        return 'Packages';
+    }
+  }
+
+  private getPackageTooltip(): string {
+    if (this.isCheckingPackages) return 'Checking for package updates...';
+
+    switch (this.packageStatus) {
+      case 'up-to-date':
+        return 'All packages are up to date';
+      case 'updates-available':
+        return `${this.outdatedPackages.length} package update${this.outdatedPackages.length !== 1 ? 's' : ''} available`;
+      case 'error':
+        return 'Failed to check for updates. Click to retry.';
+      default:
+        return 'Click to check for package updates';
+    }
+  }
+
+  // ========== Public Methods ==========
+
+  /**
+   * Manually trigger a package check
+   */
+  public async refreshPackageStatus(): Promise<void> {
+    await this.checkPackages();
+  }
+
+  /**
+   * Manually reload scripts from package.json
+   */
+  public async refreshScripts(): Promise<void> {
+    await this.loadScripts();
+  }
+}

ts_web/elements/00group-workspace/dees-workspace-bottombar/index.ts

@@ -0,0 +1 @@
+export * from './dees-workspace-bottombar.js';

ts_web/elements/00group-workspace/dees-workspace-diff-editor/dees-workspace-diff-editor.ts

@@ -0,0 +1,359 @@
+import {
+  DeesElement,
+  property,
+  html,
+  customElement,
+  type TemplateResult,
+  css,
+  cssManager,
+} from '@design.estate/dees-element';
+import * as domtools from '@design.estate/dees-domtools';
+import { MONACO_VERSION } from '../dees-workspace-monaco/version.js';
+import { themeDefaultStyles } from '../../00theme.js';
+import '../../00group-button/dees-button/dees-button.js';
+
+import type * as monaco from 'monaco-editor';
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'dees-workspace-diff-editor': DeesWorkspaceDiffEditor;
+  }
+}
+
+@customElement('dees-workspace-diff-editor')
+export class DeesWorkspaceDiffEditor extends DeesElement {
+  // DEMO
+  public static demo = () => html`
+    <dees-workspace-diff-editor
+      .originalContent=${'function hello() {\n  console.log("Hello");\n}'}
+      .modifiedContent=${'function hello() {\n  console.log("Hello World!");\n  return true;\n}'}
+      .language=${'typescript'}
+      .filePath=${'/demo/example.ts'}
+    ></dees-workspace-diff-editor>
+  `;
+
+  // INSTANCE
+  public diffEditorDeferred = domtools.plugins.smartpromise.defer<monaco.editor.IStandaloneDiffEditor>();
+
+  @property({ type: String })
+  accessor originalContent: string = '';
+
+  @property({ type: String })
+  accessor modifiedContent: string = '';
+
+  @property({ type: String })
+  accessor originalLabel: string = 'Disk Version';
+
+  @property({ type: String })
+  accessor modifiedLabel: string = 'Local Version';
+
+  @property({ type: String })
+  accessor language: string = 'typescript';
+
+  @property({ type: String })
+  accessor filePath: string = '';
+
+  private diffEditor: monaco.editor.IStandaloneDiffEditor | null = null;
+  private monacoThemeSubscription: domtools.plugins.smartrx.rxjs.Subscription | null = null;
+  private originalModel: monaco.editor.ITextModel | null = null;
+  private modifiedModel: monaco.editor.ITextModel | null = null;
+
+  constructor() {
+    super();
+    domtools.DomTools.setupDomTools();
+  }
+
+  public static styles = [
+    themeDefaultStyles,
+    cssManager.defaultStyles,
+    css`
+      :host {
+        display: block;
+        position: absolute;
+        top: 0;
+        left: 0;
+        right: 0;
+        bottom: 0;
+      }
+
+      * {
+        box-sizing: border-box;
+      }
+
+      .diff-wrapper {
+        display: flex;
+        flex-direction: column;
+        height: 100%;
+        width: 100%;
+      }
+
+      .diff-toolbar {
+        height: 48px;
+        display: flex;
+        align-items: center;
+        justify-content: space-between;
+        padding: 0 16px;
+        background: ${cssManager.bdTheme('hsl(0 0% 96%)', 'hsl(0 0% 12%)')};
+        border-bottom: 1px solid ${cssManager.bdTheme('hsl(0 0% 85%)', 'hsl(0 0% 20%)')};
+        flex-shrink: 0;
+      }
+
+      .diff-info {
+        display: flex;
+        align-items: center;
+        gap: 12px;
+        font-size: 14px;
+        color: ${cssManager.bdTheme('hsl(0 0% 30%)', 'hsl(0 0% 80%)')};
+      }
+
+      .diff-filename {
+        font-weight: 600;
+        color: ${cssManager.bdTheme('hsl(0 0% 20%)', 'hsl(0 0% 90%)')};
+      }
+
+      .diff-labels {
+        font-size: 12px;
+        color: ${cssManager.bdTheme('hsl(0 0% 50%)', 'hsl(0 0% 60%)')};
+      }
+
+      .diff-actions {
+        display: flex;
+        align-items: center;
+        gap: 8px;
+      }
+
+      .diff-container {
+        flex: 1;
+        min-height: 0;
+        width: 100%;
+      }
+
+      .nav-buttons {
+        display: flex;
+        gap: 4px;
+      }
+
+      .action-buttons {
+        display: flex;
+        gap: 8px;
+        margin-left: 16px;
+      }
+    `,
+  ];
+
+  public render(): TemplateResult {
+    const fileName = this.filePath.split('/').pop() || 'file';
+
+    return html`
+      <div class="diff-wrapper">
+        <div class="diff-toolbar">
+          <div class="diff-info">
+            <span class="diff-filename">${fileName}</span>
+            <span class="diff-labels">${this.originalLabel} ↔ ${this.modifiedLabel}</span>
+          </div>
+          <div class="diff-actions">
+            <div class="nav-buttons">
+              <dees-button
+                type="outline"
+                @click=${this.goToPreviousDiff}
+              >Previous</dees-button>
+              <dees-button
+                type="outline"
+                @click=${this.goToNextDiff}
+              >Next</dees-button>
+            </div>
+            <div class="action-buttons">
+              <dees-button
+                type="highlighted"
+                @click=${this.acceptLocal}
+              >Use Local</dees-button>
+              <dees-button
+                type="outline"
+                @click=${this.acceptDisk}
+              >Use Disk</dees-button>
+              <dees-button
+                type="outline"
+                @click=${this.close}
+              >Close</dees-button>
+            </div>
+          </div>
+        </div>
+        <div class="diff-container"></div>
+      </div>
+    `;
+  }
+
+  public async firstUpdated(): Promise<void> {
+    await super.firstUpdated(new Map());
+    await this.initDiffEditor();
+  }
+
+  private async initDiffEditor(): Promise<void> {
+    const container = this.shadowRoot?.querySelector('.diff-container') as HTMLElement;
+    if (!container) return;
+
+    const monacoCdnBase = `https://cdn.jsdelivr.net/npm/monaco-editor@${MONACO_VERSION}`;
+
+    // Wait for Monaco to be loaded (should already be loaded by dees-workspace-monaco)
+    let monacoInstance = (window as any).monaco as typeof monaco;
+
+    if (!monacoInstance) {
+      // Monaco not loaded yet, wait for it
+      await new Promise<void>((resolve) => {
+        const checkMonaco = setInterval(() => {
+          if ((window as any).monaco) {
+            clearInterval(checkMonaco);
+            resolve();
+          }
+        }, 100);
+      });
+      monacoInstance = (window as any).monaco as typeof monaco;
+    }
+
+    // Get current theme from domtools
+    const domtoolsInstance = await this.domtoolsPromise;
+    const isBright = domtoolsInstance.themeManager.goBrightBoolean;
+    const initialTheme = isBright ? 'vs' : 'vs-dark';
+
+    // Create unique URIs for models
+    const timestamp = Date.now();
+    const originalUri = monacoInstance.Uri.parse(`diff://original/${timestamp}${this.filePath}`);
+    const modifiedUri = monacoInstance.Uri.parse(`diff://modified/${timestamp}${this.filePath}`);
+
+    // Create models
+    this.originalModel = monacoInstance.editor.createModel(
+      this.originalContent,
+      this.language,
+      originalUri
+    );
+    this.modifiedModel = monacoInstance.editor.createModel(
+      this.modifiedContent,
+      this.language,
+      modifiedUri
+    );
+
+    // Create diff editor
+    this.diffEditor = monacoInstance.editor.createDiffEditor(container, {
+      automaticLayout: true,
+      readOnly: false, // Allow editing the modified (local) side
+      originalEditable: false, // Disk version is read-only
+      renderSideBySide: true,
+      ignoreTrimWhitespace: false,
+      fontSize: 14,
+      minimap: {
+        enabled: false,
+      },
+    });
+
+    // Set the theme
+    monacoInstance.editor.setTheme(initialTheme);
+
+    this.diffEditor.setModel({
+      original: this.originalModel,
+      modified: this.modifiedModel,
+    });
+
+    // Subscribe to theme changes
+    this.monacoThemeSubscription = domtoolsInstance.themeManager.themeObservable.subscribe(
+      (goBright: boolean) => {
+        const newTheme = goBright ? 'vs' : 'vs-dark';
+        monacoInstance.editor.setTheme(newTheme);
+      }
+    );
+
+    // Inject Monaco CSS if not already present
+    const cssId = 'monaco-diff-editor-css';
+    if (!this.shadowRoot?.getElementById(cssId)) {
+      const cssResponse = await fetch(`${monacoCdnBase}/min/vs/editor/editor.main.css`);
+      const cssText = await cssResponse.text();
+      const styleElement = document.createElement('style');
+      styleElement.id = cssId;
+      styleElement.textContent = cssText;
+      this.shadowRoot?.append(styleElement);
+    }
+
+    // Navigate to first diff after a short delay
+    setTimeout(() => {
+      try {
+        this.diffEditor?.revealFirstDiff();
+      } catch {
+        // Ignore if no diffs
+      }
+    }, 100);
+
+    this.diffEditorDeferred.resolve(this.diffEditor);
+  }
+
+  public goToNextDiff(): void {
+    try {
+      this.diffEditor?.goToDiff('next');
+    } catch {
+      // Ignore if no more diffs
+    }
+  }
+
+  public goToPreviousDiff(): void {
+    try {
+      this.diffEditor?.goToDiff('previous');
+    } catch {
+      // Ignore if no more diffs
+    }
+  }
+
+  public acceptLocal(): void {
+    // User wants to keep local version (potentially with edits made in diff view)
+    const modifiedContent = this.diffEditor?.getModifiedEditor().getValue() || this.modifiedContent;
+    this.dispatchEvent(
+      new CustomEvent('diff-resolved', {
+        detail: { action: 'use-local', content: modifiedContent },
+        bubbles: true,
+        composed: true,
+      })
+    );
+  }
+
+  public acceptDisk(): void {
+    // User wants disk version
+    this.dispatchEvent(
+      new CustomEvent('diff-resolved', {
+        detail: { action: 'use-disk', content: this.originalContent },
+        bubbles: true,
+        composed: true,
+      })
+    );
+  }
+
+  public close(): void {
+    this.dispatchEvent(
+      new CustomEvent('diff-closed', {
+        bubbles: true,
+        composed: true,
+      })
+    );
+  }
+
+  public async disconnectedCallback(): Promise<void> {
+    await super.disconnectedCallback();
+
+    if (this.monacoThemeSubscription) {
+      this.monacoThemeSubscription.unsubscribe();
+      this.monacoThemeSubscription = null;
+    }
+
+    // Dispose models
+    if (this.originalModel) {
+      this.originalModel.dispose();
+      this.originalModel = null;
+    }
+    if (this.modifiedModel) {
+      this.modifiedModel.dispose();
+      this.modifiedModel = null;
+    }
+
+    // Dispose editor
+    if (this.diffEditor) {
+      this.diffEditor.dispose();
+      this.diffEditor = null;
+    }
+  }
+}

ts_web/elements/00group-workspace/dees-workspace-diff-editor/index.ts

@@ -0,0 +1 @@
+export * from './dees-workspace-diff-editor.js';

ts_web/elements/00group-workspace/dees-workspace-filetree/dees-workspace-filetree.ts

@@ -0,0 +1,938 @@
+import {
+  DeesElement,
+  property,
+  html,
+  customElement,
+  type TemplateResult,
+  css,
+  cssManager,
+  state,
+} from '@design.estate/dees-element';
+import * as domtools from '@design.estate/dees-domtools';
+import { themeDefaultStyles } from '../../00theme.js';
+import type { IExecutionEnvironment, IFileEntry, IFileWatcher } from '../../00group-runtime/index.js';
+import '../../dees-icon/dees-icon.js';
+import '../../dees-contextmenu/dees-contextmenu.js';
+import { DeesContextmenu } from '../../dees-contextmenu/dees-contextmenu.js';
+import { DeesModal } from '../../dees-modal/dees-modal.js';
+import '../../00group-input/dees-input-text/dees-input-text.js';
+import { DeesInputText } from '../../00group-input/dees-input-text/dees-input-text.js';
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'dees-workspace-filetree': DeesWorkspaceFiletree;
+  }
+}
+
+interface ITreeNode extends IFileEntry {
+  children?: ITreeNode[];
+  expanded?: boolean;
+  level: number;
+}
+
+@customElement('dees-workspace-filetree')
+export class DeesWorkspaceFiletree extends DeesElement {
+  public static demo = () => html`
+    <div style="width: 300px; height: 400px; position: relative;">
+      <dees-workspace-filetree></dees-workspace-filetree>
+    </div>
+  `;
+
+  // INSTANCE
+  @property({ type: Object })
+  accessor executionEnvironment: IExecutionEnvironment | null = null;
+
+  @property({ type: String })
+  accessor rootPath: string = '/';
+
+  @property({ type: String })
+  accessor selectedPath: string = '';
+
+  @state()
+  accessor treeData: ITreeNode[] = [];
+
+  @state()
+  accessor isLoading: boolean = false;
+
+  @state()
+  accessor errorMessage: string = '';
+
+  private expandedPaths: Set<string> = new Set();
+  private loadTreeStarted: boolean = false;
+
+  // Clipboard state for copy/paste operations
+  private clipboardPath: string | null = null;
+  private clipboardOperation: 'copy' | 'cut' | null = null;
+
+  // File watcher for auto-refresh
+  private fileWatcher: IFileWatcher | null = null;
+  private refreshDebounceTimeout: ReturnType<typeof setTimeout> | null = null;
+  private lastExecutionEnvironment: IExecutionEnvironment | null = null;
+
+  public static styles = [
+    themeDefaultStyles,
+    cssManager.defaultStyles,
+    css`
+      :host {
+        display: block;
+        position: absolute;
+        top: 0;
+        left: 0;
+        right: 0;
+        bottom: 0;
+        overflow: auto;
+        background: ${cssManager.bdTheme('hsl(0 0% 98%)', 'hsl(0 0% 9%)')};
+        font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+        font-size: 13px;
+      }
+
+      .tree-container {
+        padding: 8px 0;
+      }
+
+      .tree-item {
+        display: flex;
+        align-items: center;
+        padding: 4px 8px;
+        cursor: pointer;
+        user-select: none;
+        border-radius: 4px;
+        margin: 1px 4px;
+        transition: background 0.1s ease;
+      }
+
+      .tree-item:hover {
+        background: ${cssManager.bdTheme('hsl(0 0% 93%)', 'hsl(0 0% 14%)')};
+      }
+
+      .tree-item.selected {
+        background: ${cssManager.bdTheme('hsl(210 100% 95%)', 'hsl(210 50% 20%)')};
+        color: ${cssManager.bdTheme('hsl(210 100% 40%)', 'hsl(210 100% 70%)')};
+      }
+
+      .tree-item.selected:hover {
+        background: ${cssManager.bdTheme('hsl(210 100% 92%)', 'hsl(210 50% 25%)')};
+      }
+
+      .indent {
+        display: inline-block;
+        width: 16px;
+        flex-shrink: 0;
+      }
+
+      .expand-icon {
+        width: 16px;
+        height: 16px;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        flex-shrink: 0;
+        color: ${cssManager.bdTheme('hsl(0 0% 50%)', 'hsl(0 0% 60%)')};
+        transition: transform 0.15s ease;
+      }
+
+      .expand-icon.expanded {
+        transform: rotate(90deg);
+      }
+
+      .expand-icon.hidden {
+        visibility: hidden;
+      }
+
+      .file-icon {
+        width: 16px;
+        height: 16px;
+        margin-right: 6px;
+        flex-shrink: 0;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+      }
+
+      .file-icon dees-icon {
+        width: 16px;
+        height: 16px;
+      }
+
+      .file-icon.folder {
+        color: ${cssManager.bdTheme('hsl(45 80% 45%)', 'hsl(45 70% 55%)')};
+      }
+
+      .file-icon.file {
+        color: ${cssManager.bdTheme('hsl(0 0% 50%)', 'hsl(0 0% 60%)')};
+      }
+
+      .file-icon.typescript {
+        color: hsl(211 60% 48%);
+      }
+
+      .file-icon.javascript {
+        color: hsl(53 93% 54%);
+      }
+
+      .file-icon.json {
+        color: hsl(45 80% 50%);
+      }
+
+      .file-icon.html {
+        color: hsl(14 77% 52%);
+      }
+
+      .file-icon.css {
+        color: hsl(228 77% 59%);
+      }
+
+      .file-icon.markdown {
+        color: hsl(0 0% 50%);
+      }
+
+      .file-name {
+        flex: 1;
+        overflow: hidden;
+        text-overflow: ellipsis;
+        white-space: nowrap;
+        color: ${cssManager.bdTheme('hsl(0 0% 20%)', 'hsl(0 0% 85%)')};
+      }
+
+      .loading {
+        padding: 16px;
+        text-align: center;
+        color: ${cssManager.bdTheme('hsl(0 0% 50%)', 'hsl(0 0% 60%)')};
+      }
+
+      .error {
+        padding: 16px;
+        text-align: center;
+        color: hsl(0 70% 50%);
+      }
+
+      .empty {
+        padding: 16px;
+        text-align: center;
+        color: ${cssManager.bdTheme('hsl(0 0% 50%)', 'hsl(0 0% 60%)')};
+        font-style: italic;
+      }
+
+      .filetree-toolbar {
+        display: flex;
+        align-items: center;
+        justify-content: space-between;
+        height: 36px;
+        padding: 0 12px;
+        border-bottom: 1px solid ${cssManager.bdTheme('hsl(0 0% 85%)', 'hsl(0 0% 15%)')};
+        background: ${cssManager.bdTheme('hsl(0 0% 96%)', 'hsl(0 0% 8%)')};
+        position: sticky;
+        top: 0;
+        z-index: 1;
+      }
+
+      .toolbar-title {
+        font-size: 11px;
+        font-weight: 600;
+        text-transform: uppercase;
+        letter-spacing: 0.5px;
+        color: ${cssManager.bdTheme('hsl(0 0% 40%)', 'hsl(0 0% 60%)')};
+      }
+
+      .toolbar-actions {
+        display: flex;
+        gap: 4px;
+      }
+
+      .toolbar-button {
+        padding: 4px;
+        border-radius: 4px;
+        cursor: pointer;
+        opacity: 0.7;
+        transition: opacity 0.15s, background 0.15s;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        color: ${cssManager.bdTheme('hsl(0 0% 30%)', 'hsl(0 0% 70%)')};
+      }
+
+      .toolbar-button:hover {
+        opacity: 1;
+        background: ${cssManager.bdTheme('hsl(0 0% 0% / 0.08)', 'hsl(0 0% 100% / 0.1)')};
+      }
+    `,
+  ];
+
+  public render(): TemplateResult {
+    if (!this.executionEnvironment) {
+      return html`
+        <div class="empty">
+          No execution environment provided.
+        </div>
+      `;
+    }
+
+    if (this.isLoading) {
+      return html`
+        <div class="loading">
+          Loading files...
+        </div>
+      `;
+    }
+
+    if (this.errorMessage) {
+      return html`
+        <div class="error">
+          ${this.errorMessage}
+        </div>
+      `;
+    }
+
+    return html`
+      <div class="filetree-toolbar">
+        <span class="toolbar-title">Explorer</span>
+        <div class="toolbar-actions">
+          <div class="toolbar-button" @click=${() => this.createNewFile('/')} title="New File">
+            <dees-icon .icon=${'lucide:filePlus'} iconSize="16"></dees-icon>
+          </div>
+          <div class="toolbar-button" @click=${() => this.createNewFolder('/')} title="New Folder">
+            <dees-icon .icon=${'lucide:folderPlus'} iconSize="16"></dees-icon>
+          </div>
+        </div>
+      </div>
+      ${this.treeData.length === 0
+        ? html`<div class="empty">No files found.</div>`
+        : html`
+            <div class="tree-container" @contextmenu=${this.handleEmptySpaceContextMenu}>
+              ${this.renderTree(this.treeData)}
+            </div>
+          `}
+    `;
+  }
+
+  private renderTree(nodes: ITreeNode[]): TemplateResult[] {
+    return nodes.map(node => this.renderNode(node));
+  }
+
+  private renderNode(node: ITreeNode): TemplateResult {
+    const isDirectory = node.type === 'directory';
+    const isExpanded = this.expandedPaths.has(node.path);
+    const isSelected = node.path === this.selectedPath;
+    const iconClass = this.getFileIconClass(node);
+
+    return html`
+      <div
+        class="tree-item ${isSelected ? 'selected' : ''}"
+        style="padding-left: ${8 + node.level * 16}px"
+        @click=${(e: MouseEvent) => this.handleItemClick(e, node)}
+        @contextmenu=${(e: MouseEvent) => this.handleContextMenu(e, node)}
+      >
+        <span class="expand-icon ${isExpanded ? 'expanded' : ''} ${!isDirectory ? 'hidden' : ''}">
+          <dees-icon .icon=${'lucide:chevronRight'} iconSize="12"></dees-icon>
+        </span>
+        <span class="file-icon ${iconClass}">
+          <dees-icon .icon=${this.getFileIcon(node)} iconSize="16"></dees-icon>
+        </span>
+        <span class="file-name">${node.name}</span>
+      </div>
+      ${isDirectory && isExpanded && node.children
+        ? this.renderTree(node.children)
+        : ''}
+    `;
+  }
+
+  private getFileIcon(node: ITreeNode): string {
+    if (node.type === 'directory') {
+      return this.expandedPaths.has(node.path) ? 'lucide:folderOpen' : 'lucide:folder';
+    }
+
+    const ext = node.name.split('.').pop()?.toLowerCase();
+    switch (ext) {
+      case 'ts':
+      case 'tsx':
+        return 'lucide:fileCode';
+      case 'js':
+      case 'jsx':
+        return 'lucide:fileCode';
+      case 'json':
+        return 'lucide:fileJson';
+      case 'html':
+        return 'lucide:fileCode';
+      case 'css':
+      case 'scss':
+      case 'less':
+        return 'lucide:fileCode';
+      case 'md':
+        return 'lucide:fileText';
+      case 'png':
+      case 'jpg':
+      case 'jpeg':
+      case 'gif':
+      case 'svg':
+        return 'lucide:image';
+      default:
+        return 'lucide:file';
+    }
+  }
+
+  private getFileIconClass(node: ITreeNode): string {
+    if (node.type === 'directory') return 'folder';
+
+    const ext = node.name.split('.').pop()?.toLowerCase();
+    switch (ext) {
+      case 'ts':
+      case 'tsx':
+        return 'typescript';
+      case 'js':
+      case 'jsx':
+        return 'javascript';
+      case 'json':
+        return 'json';
+      case 'html':
+        return 'html';
+      case 'css':
+      case 'scss':
+      case 'less':
+        return 'css';
+      case 'md':
+        return 'markdown';
+      default:
+        return 'file';
+    }
+  }
+
+  private async handleItemClick(e: MouseEvent, node: ITreeNode) {
+    e.stopPropagation();
+
+    if (node.type === 'directory') {
+      await this.toggleDirectory(node);
+    } else {
+      this.selectedPath = node.path;
+      this.dispatchEvent(
+        new CustomEvent('file-select', {
+          detail: { path: node.path, name: node.name },
+          bubbles: true,
+          composed: true,
+        })
+      );
+    }
+  }
+
+  private async toggleDirectory(node: ITreeNode) {
+    if (this.expandedPaths.has(node.path)) {
+      this.expandedPaths.delete(node.path);
+    } else {
+      this.expandedPaths.add(node.path);
+      // Load children if not already loaded
+      if (!node.children || node.children.length === 0) {
+        await this.loadDirectoryContents(node);
+      }
+    }
+    this.requestUpdate();
+  }
+
+  private async loadDirectoryContents(node: ITreeNode) {
+    if (!this.executionEnvironment) return;
+
+    try {
+      const entries = await this.executionEnvironment.readDir(node.path);
+      node.children = this.sortEntries(entries).map(entry => ({
+        ...entry,
+        level: node.level + 1,
+        expanded: false,
+        children: entry.type === 'directory' ? [] : undefined,
+      }));
+    } catch (error) {
+      console.error(`Failed to load directory ${node.path}:`, error);
+    }
+  }
+
+  private async handleContextMenu(e: MouseEvent, node: ITreeNode) {
+    e.preventDefault();
+    e.stopPropagation();
+
+    const menuItems = [];
+
+    if (node.type === 'directory') {
+      // Directory-specific options
+      menuItems.push(
+        {
+          name: 'New File',
+          iconName: 'filePlus',
+          action: async () => this.createNewFile(node.path),
+        },
+        {
+          name: 'New Folder',
+          iconName: 'folderPlus',
+          action: async () => this.createNewFolder(node.path),
+        },
+        { divider: true }
+      );
+    }
+
+    // Common options for both files and directories
+    menuItems.push(
+      {
+        name: 'Rename',
+        iconName: 'pencil',
+        action: async () => this.renameItem(node),
+      },
+      {
+        name: 'Duplicate',
+        iconName: 'files',
+        action: async () => this.duplicateItem(node),
+      },
+      {
+        name: 'Copy',
+        iconName: 'copy',
+        action: async () => this.copyItem(node),
+      }
+    );
+
+    // Paste option (only for directories and when clipboard has content)
+    if (node.type === 'directory' && this.clipboardPath) {
+      menuItems.push({
+        name: 'Paste',
+        iconName: 'clipboard',
+        action: async () => this.pasteItem(node.path),
+      });
+    }
+
+    menuItems.push(
+      { divider: true },
+      {
+        name: 'Delete',
+        iconName: 'trash2',
+        action: async () => this.deleteItem(node),
+      }
+    );
+
+    await DeesContextmenu.openContextMenuWithOptions(e, menuItems);
+  }
+
+  private async handleEmptySpaceContextMenu(e: MouseEvent) {
+    // Only trigger if clicking on the container itself, not a tree item
+    const target = e.target as HTMLElement;
+    if (target.closest('.tree-item')) return;
+
+    e.preventDefault();
+    e.stopPropagation();
+
+    const menuItems: any[] = [
+      {
+        name: 'New File',
+        iconName: 'filePlus',
+        action: async () => this.createNewFile('/'),
+      },
+      {
+        name: 'New Folder',
+        iconName: 'folderPlus',
+        action: async () => this.createNewFolder('/'),
+      },
+    ];
+
+    // Add Paste option if clipboard has content
+    if (this.clipboardPath) {
+      menuItems.push(
+        { divider: true },
+        {
+          name: 'Paste',
+          iconName: 'clipboard',
+          action: async () => this.pasteItem('/'),
+        }
+      );
+    }
+
+    await DeesContextmenu.openContextMenuWithOptions(e, menuItems);
+  }
+
+  private async showInputModal(options: {
+    heading: string;
+    label: string;
+    value?: string;
+    buttonName?: string;
+  }): Promise<string | null> {
+    return new Promise(async (resolve) => {
+      const modal = await DeesModal.createAndShow({
+        heading: options.heading,
+        width: 'small',
+        content: html`
+          <dees-input-text
+            .label=${options.label}
+            .value=${options.value || ''}
+          ></dees-input-text>
+        `,
+        menuOptions: [
+          {
+            name: 'Cancel',
+            action: async (modalRef) => {
+              await modalRef.destroy();
+              resolve(null);
+            },
+          },
+          {
+            name: options.buttonName || 'Create',
+            action: async (modalRef) => {
+              // Query the input element directly and read its value
+              const contentEl = modalRef.shadowRoot?.querySelector('.modal .content');
+              const inputElement = contentEl?.querySelector('dees-input-text') as DeesInputText | null;
+              const inputValue = inputElement?.value?.trim() || '';
+
+              await modalRef.destroy();
+              resolve(inputValue || null);
+            },
+          },
+        ],
+      });
+
+      // Focus the input after modal renders
+      await modal.updateComplete;
+      const contentEl = modal.shadowRoot?.querySelector('.modal .content');
+      if (contentEl) {
+        const inputElement = contentEl.querySelector('dees-input-text') as DeesInputText | null;
+        if (inputElement) {
+          await inputElement.updateComplete;
+          inputElement.focus();
+        }
+      }
+    });
+  }
+
+  private async createNewFile(parentPath: string) {
+    const fileName = await this.showInputModal({
+      heading: 'New File',
+      label: 'File name',
+    });
+    if (!fileName || !this.executionEnvironment) return;
+
+    const newPath = parentPath === '/' ? `/${fileName}` : `${parentPath}/${fileName}`;
+    try {
+      await this.executionEnvironment.writeFile(newPath, '');
+      await this.refresh();
+      this.dispatchEvent(
+        new CustomEvent('file-created', {
+          detail: { path: newPath },
+          bubbles: true,
+          composed: true,
+        })
+      );
+    } catch (error) {
+      console.error('Failed to create file:', error);
+    }
+  }
+
+  private async createNewFolder(parentPath: string) {
+    const folderName = await this.showInputModal({
+      heading: 'New Folder',
+      label: 'Folder name',
+    });
+    if (!folderName || !this.executionEnvironment) return;
+
+    const newPath = parentPath === '/' ? `/${folderName}` : `${parentPath}/${folderName}`;
+    try {
+      await this.executionEnvironment.mkdir(newPath);
+      await this.refresh();
+      this.dispatchEvent(
+        new CustomEvent('folder-created', {
+          detail: { path: newPath },
+          bubbles: true,
+          composed: true,
+        })
+      );
+    } catch (error) {
+      console.error('Failed to create folder:', error);
+    }
+  }
+
+  private async deleteItem(node: ITreeNode) {
+    if (!this.executionEnvironment) return;
+
+    const confirmed = confirm(`Delete ${node.name}?`);
+    if (!confirmed) return;
+
+    try {
+      await this.executionEnvironment.rm(node.path, { recursive: node.type === 'directory' });
+      await this.refresh();
+      this.dispatchEvent(
+        new CustomEvent('item-deleted', {
+          detail: { path: node.path, type: node.type },
+          bubbles: true,
+          composed: true,
+        })
+      );
+    } catch (error) {
+      console.error('Failed to delete item:', error);
+    }
+  }
+
+  /**
+   * Rename a file or folder
+   */
+  private async renameItem(node: ITreeNode) {
+    if (!this.executionEnvironment) return;
+
+    const newName = await this.showInputModal({
+      heading: 'Rename',
+      label: 'New name',
+      value: node.name,
+      buttonName: 'Rename',
+    });
+    if (!newName || newName === node.name) return;
+
+    // Calculate new path
+    const parentPath = node.path.substring(0, node.path.lastIndexOf('/')) || '/';
+    const newPath = parentPath === '/' ? `/${newName}` : `${parentPath}/${newName}`;
+
+    try {
+      if (node.type === 'file') {
+        // For files: read content, write to new path, delete old
+        const content = await this.executionEnvironment.readFile(node.path);
+        await this.executionEnvironment.writeFile(newPath, content);
+        await this.executionEnvironment.rm(node.path);
+      } else {
+        // For directories: recursively copy contents then delete old
+        await this.copyDirectoryContents(node.path, newPath);
+        await this.executionEnvironment.rm(node.path, { recursive: true });
+      }
+      await this.refresh();
+      this.dispatchEvent(
+        new CustomEvent('item-renamed', {
+          detail: { oldPath: node.path, newPath, type: node.type },
+          bubbles: true,
+          composed: true,
+        })
+      );
+    } catch (error) {
+      console.error('Failed to rename item:', error);
+    }
+  }
+
+  /**
+   * Duplicate a file or folder
+   */
+  private async duplicateItem(node: ITreeNode) {
+    if (!this.executionEnvironment) return;
+
+    const parentPath = node.path.substring(0, node.path.lastIndexOf('/')) || '/';
+    let newName: string;
+
+    if (node.type === 'file') {
+      // Add _copy before extension
+      const lastDot = node.name.lastIndexOf('.');
+      if (lastDot > 0) {
+        const baseName = node.name.substring(0, lastDot);
+        const ext = node.name.substring(lastDot);
+        newName = `${baseName}_copy${ext}`;
+      } else {
+        newName = `${node.name}_copy`;
+      }
+    } else {
+      newName = `${node.name}_copy`;
+    }
+
+    const newPath = parentPath === '/' ? `/${newName}` : `${parentPath}/${newName}`;
+
+    try {
+      if (node.type === 'file') {
+        const content = await this.executionEnvironment.readFile(node.path);
+        await this.executionEnvironment.writeFile(newPath, content);
+      } else {
+        await this.copyDirectoryContents(node.path, newPath);
+      }
+      await this.refresh();
+      this.dispatchEvent(
+        new CustomEvent('item-duplicated', {
+          detail: { sourcePath: node.path, newPath, type: node.type },
+          bubbles: true,
+          composed: true,
+        })
+      );
+    } catch (error) {
+      console.error('Failed to duplicate item:', error);
+    }
+  }
+
+  /**
+   * Copy item path to clipboard
+   */
+  private async copyItem(node: ITreeNode) {
+    this.clipboardPath = node.path;
+    this.clipboardOperation = 'copy';
+  }
+
+  /**
+   * Paste copied item to target directory
+   */
+  private async pasteItem(targetPath: string) {
+    if (!this.executionEnvironment || !this.clipboardPath) return;
+
+    // Get the name from clipboard path
+    const name = this.clipboardPath.split('/').pop() || 'pasted';
+    const newPath = targetPath === '/' ? `/${name}` : `${targetPath}/${name}`;
+
+    try {
+      // Check if source exists
+      if (!(await this.executionEnvironment.exists(this.clipboardPath))) {
+        console.error('Source file no longer exists');
+        this.clipboardPath = null;
+        this.clipboardOperation = null;
+        return;
+      }
+
+      // Check if it's a file or directory by trying to read as file
+      try {
+        const content = await this.executionEnvironment.readFile(this.clipboardPath);
+        await this.executionEnvironment.writeFile(newPath, content);
+      } catch {
+        // If reading fails, it's a directory
+        await this.copyDirectoryContents(this.clipboardPath, newPath);
+      }
+
+      await this.refresh();
+      this.dispatchEvent(
+        new CustomEvent('item-pasted', {
+          detail: { sourcePath: this.clipboardPath, targetPath: newPath },
+          bubbles: true,
+          composed: true,
+        })
+      );
+
+      // Clear clipboard after paste
+      this.clipboardPath = null;
+      this.clipboardOperation = null;
+    } catch (error) {
+      console.error('Failed to paste item:', error);
+    }
+  }
+
+  /**
+   * Recursively copy directory contents to a new path
+   */
+  private async copyDirectoryContents(sourcePath: string, destPath: string) {
+    if (!this.executionEnvironment) return;
+
+    // Create destination directory
+    await this.executionEnvironment.mkdir(destPath);
+
+    // Read source directory contents
+    const entries = await this.executionEnvironment.readDir(sourcePath);
+
+    for (const entry of entries) {
+      const srcEntryPath = sourcePath === '/' ? `/${entry.name}` : `${sourcePath}/${entry.name}`;
+      const destEntryPath = destPath === '/' ? `/${entry.name}` : `${destPath}/${entry.name}`;
+
+      if (entry.type === 'directory') {
+        await this.copyDirectoryContents(srcEntryPath, destEntryPath);
+      } else {
+        const content = await this.executionEnvironment.readFile(srcEntryPath);
+        await this.executionEnvironment.writeFile(destEntryPath, content);
+      }
+    }
+  }
+
+  public async firstUpdated() {
+    await this.loadTree();
+  }
+
+  public async updated(changedProperties: Map<string, any>) {
+    if (changedProperties.has('executionEnvironment')) {
+      // Stop watching the old environment
+      if (this.lastExecutionEnvironment !== this.executionEnvironment) {
+        this.stopFileWatcher();
+        this.lastExecutionEnvironment = this.executionEnvironment;
+      }
+
+      if (this.executionEnvironment) {
+        await this.loadTree();
+        this.startFileWatcher();
+      }
+    }
+  }
+
+  public async disconnectedCallback() {
+    await super.disconnectedCallback();
+    this.stopFileWatcher();
+    if (this.refreshDebounceTimeout) {
+      clearTimeout(this.refreshDebounceTimeout);
+      this.refreshDebounceTimeout = null;
+    }
+  }
+
+  private startFileWatcher() {
+    if (!this.executionEnvironment || this.fileWatcher) return;
+
+    try {
+      this.fileWatcher = this.executionEnvironment.watch(
+        '/',
+        (_event, _filename) => {
+          // Debounce refresh to avoid excessive updates
+          if (this.refreshDebounceTimeout) {
+            clearTimeout(this.refreshDebounceTimeout);
+          }
+          this.refreshDebounceTimeout = setTimeout(() => {
+            this.refresh();
+          }, 300);
+        },
+        { recursive: true }
+      );
+    } catch (error) {
+      console.warn('File watching not supported:', error);
+    }
+  }
+
+  private stopFileWatcher() {
+    if (this.fileWatcher) {
+      this.fileWatcher.stop();
+      this.fileWatcher = null;
+    }
+  }
+
+  private async loadTree() {
+    if (!this.executionEnvironment) return;
+
+    // Prevent double loading on initial render
+    if (this.loadTreeStarted) return;
+    this.loadTreeStarted = true;
+
+    this.isLoading = true;
+    this.errorMessage = '';
+
+    try {
+      // Wait for environment to be ready
+      if (!this.executionEnvironment.ready) {
+        await this.executionEnvironment.init();
+      }
+
+      const entries = await this.executionEnvironment.readDir(this.rootPath);
+      this.treeData = this.sortEntries(entries).map(entry => ({
+        ...entry,
+        level: 0,
+        expanded: false,
+        children: entry.type === 'directory' ? [] : undefined,
+      }));
+    } catch (error) {
+      this.errorMessage = `Failed to load files: ${error}`;
+      console.error('Failed to load file tree:', error);
+      // Reset flag to allow retry
+      this.loadTreeStarted = false;
+    } finally {
+      this.isLoading = false;
+    }
+  }
+
+  private sortEntries(entries: IFileEntry[]): IFileEntry[] {
+    return entries.sort((a, b) => {
+      // Directories first
+      if (a.type !== b.type) {
+        return a.type === 'directory' ? -1 : 1;
+      }
+      // Then alphabetically
+      return a.name.localeCompare(b.name);
+    });
+  }
+
+  public async refresh() {
+    this.expandedPaths.clear();
+    this.loadTreeStarted = false; // Reset to allow loading
+    await this.loadTree();
+  }
+
+  public selectFile(path: string) {
+    this.selectedPath = path;
+  }
+}

ts_web/elements/00group-workspace/dees-workspace-filetree/index.ts

@@ -0,0 +1 @@
+export * from './dees-workspace-filetree.js';

ts_web/elements/00group-workspace/dees-workspace-markdown/dees-workspace-markdown.ts

@@ -0,0 +1,255 @@
+import {
+  DeesElement,
+  property,
+  html,
+  customElement,
+  type TemplateResult,
+  css,
+  cssManager,
+  domtools,
+  state,
+} from '@design.estate/dees-element';
+import { themeDefaultStyles } from '../../00theme.js';
+import { DeesWorkspaceMonaco } from '../dees-workspace-monaco/dees-workspace-monaco.js';
+
+const deferred = domtools.plugins.smartpromise.defer();
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'dees-workspace-markdown': DeesWorkspaceMarkdown;
+  }
+}
+
+@customElement('dees-workspace-markdown')
+export class DeesWorkspaceMarkdown extends DeesElement {
+  public static demo = () => html`<dees-workspace-markdown></dees-workspace-markdown>`;
+
+  public static styles = [
+    themeDefaultStyles,
+    cssManager.defaultStyles,
+    css`
+      :host {
+        display: block;
+        position: relative;
+        width: 100%;
+        height: 100%;
+      }
+
+      .splitContainer {
+        position: absolute;
+        height: 100%;
+        width: 100%;
+        display: flex;
+        flex-direction: row;
+      }
+
+      .editorContainer {
+        position: relative;
+        height: 100%;
+        min-width: 100px;
+        overflow: hidden;
+      }
+
+      .resizeHandle {
+        width: 6px;
+        height: 100%;
+        background: ${cssManager.bdTheme('#e5e7eb', '#30363d')};
+        cursor: col-resize;
+        flex-shrink: 0;
+        transition: background 0.15s ease;
+        position: relative;
+      }
+
+      .resizeHandle:hover,
+      .resizeHandle.dragging {
+        background: ${cssManager.bdTheme('#3b82f6', '#58a6ff')};
+      }
+
+      .resizeHandle::after {
+        content: '';
+        position: absolute;
+        top: 50%;
+        left: 50%;
+        transform: translate(-50%, -50%);
+        width: 2px;
+        height: 32px;
+        background: ${cssManager.bdTheme('#9ca3af', '#6e7681')};
+        border-radius: 1px;
+        opacity: 0.6;
+      }
+
+      .resizeHandle:hover::after,
+      .resizeHandle.dragging::after {
+        background: ${cssManager.bdTheme('#ffffff', '#ffffff')};
+        opacity: 1;
+      }
+
+      .outletContainer {
+        position: relative;
+        height: 100%;
+        min-width: 100px;
+        background: ${cssManager.bdTheme('#ffffff', '#0d1117')};
+        color: ${cssManager.bdTheme('#24292f', '#e6edf3')};
+        font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Noto Sans', Helvetica, Arial, sans-serif;
+        padding: 20px;
+        overflow-y: auto;
+        box-sizing: border-box;
+      }
+
+      /* Prevent text selection while dragging */
+      .splitContainer.dragging {
+        user-select: none;
+      }
+
+      .splitContainer.dragging .editorContainer,
+      .splitContainer.dragging .outletContainer {
+        pointer-events: none;
+      }
+    `,
+  ];
+
+  /**
+   * Initial split ratio for the editor (left) panel.
+   * Value from 0 to 100 representing percentage width.
+   * Default is 50 (50/50 split).
+   */
+  @property({ type: Number })
+  accessor splitRatio: number = 50;
+
+  /**
+   * Minimum width percentage for either panel.
+   */
+  @property({ type: Number })
+  accessor minPanelSize: number = 10;
+
+  @state()
+  accessor currentSplitRatio: number = 50;
+
+  @state()
+  accessor isDragging: boolean = false;
+
+  private resizeHandleElement: HTMLElement;
+  private containerElement: HTMLElement;
+
+  public render() {
+    return html`
+      <div class="splitContainer ${this.isDragging ? 'dragging' : ''}">
+        <div class="editorContainer" style="width: ${this.currentSplitRatio}%">
+          <dees-workspace-monaco
+            .language=${'markdown'}
+            .content=${`# a test content
+
+This is test content that is of longer form an hopefully starts to wrap when I need it. And yes, it does perfectly. nice.
+
+Test | Hello
+--- | ---
+Yeah | So good
+
+This is real asset I think. Why would we want to leave that on the table? Can you tell my that?
+
+Why are we here?
+
+Do you know?
+
+> note:
+There is something going on.
+
+\`\`\`typescript
+const hello = 'yes'
+\`\`\`
+`}
+            wordWrap="bounded"
+          ></dees-workspace-monaco>
+        </div>
+        <div
+          class="resizeHandle ${this.isDragging ? 'dragging' : ''}"
+          @mousedown=${this.handleMouseDown}
+        ></div>
+        <div class="outletContainer" style="width: ${100 - this.currentSplitRatio}%">
+          <dees-workspace-markdownoutlet></dees-workspace-markdownoutlet>
+        </div>
+      </div>
+    `;
+  }
+
+  public async firstUpdated(_changedPropertiesArg) {
+    await super.firstUpdated(_changedPropertiesArg);
+
+    // Initialize current ratio from property
+    this.currentSplitRatio = this.splitRatio;
+
+    // Cache elements
+    this.containerElement = this.shadowRoot.querySelector('.splitContainer');
+    this.resizeHandleElement = this.shadowRoot.querySelector('.resizeHandle');
+
+    const editor = this.shadowRoot.querySelector('dees-workspace-monaco') as DeesWorkspaceMonaco;
+
+    // Wire up markdown rendering
+    const markdownOutlet = this.shadowRoot.querySelector('dees-workspace-markdownoutlet');
+    const smartmarkdownInstance = new domtools.plugins.smartmarkdown.SmartMarkdown();
+    const mdParsedResult = await smartmarkdownInstance.getMdParsedResultFromMarkdown('loading...')
+    editor.contentSubject.subscribe(async contentArg => {
+      await mdParsedResult.updateFromMarkdownString(contentArg)
+      const html = mdParsedResult.html;
+      markdownOutlet.updateHtmlText(html);
+    });
+  }
+
+  private handleMouseDown = (e: MouseEvent) => {
+    e.preventDefault();
+    this.isDragging = true;
+
+    document.addEventListener('mousemove', this.handleMouseMove);
+    document.addEventListener('mouseup', this.handleMouseUp);
+  };
+
+  private handleMouseMove = (e: MouseEvent) => {
+    if (!this.isDragging || !this.containerElement) return;
+
+    const containerRect = this.containerElement.getBoundingClientRect();
+    const containerWidth = containerRect.width;
+    const mouseX = e.clientX - containerRect.left;
+
+    // Calculate percentage, accounting for the resize handle width (6px)
+    let newRatio = (mouseX / containerWidth) * 100;
+
+    // Clamp to min/max
+    newRatio = Math.max(this.minPanelSize, Math.min(100 - this.minPanelSize, newRatio));
+
+    this.currentSplitRatio = newRatio;
+  };
+
+  private handleMouseUp = () => {
+    this.isDragging = false;
+    document.removeEventListener('mousemove', this.handleMouseMove);
+    document.removeEventListener('mouseup', this.handleMouseUp);
+
+    // Trigger resize on monaco editor
+    const editor = this.shadowRoot.querySelector('dees-workspace-monaco') as DeesWorkspaceMonaco;
+    if (editor) {
+      // Monaco needs to be notified of size changes
+      window.dispatchEvent(new Event('resize'));
+    }
+  };
+
+  async disconnectedCallback() {
+    await super.disconnectedCallback();
+    // Clean up event listeners
+    document.removeEventListener('mousemove', this.handleMouseMove);
+    document.removeEventListener('mouseup', this.handleMouseUp);
+  }
+
+  /**
+   * Programmatically set the split ratio
+   */
+  public setSplitRatio(ratio: number) {
+    this.currentSplitRatio = Math.max(this.minPanelSize, Math.min(100 - this.minPanelSize, ratio));
+  }
+
+  /**
+   * Reset to initial split ratio
+   */
+  public resetSplitRatio() {
+    this.currentSplitRatio = this.splitRatio;
+  }
+}

ts_web/elements/00group-workspace/dees-workspace-markdown/index.ts

@@ -0,0 +1 @@
+export * from './dees-workspace-markdown.js';

ts_web/elements/00group-workspace/dees-workspace-markdownoutlet/dees-workspace-markdownoutlet.demo.ts

@@ -0,0 +1,289 @@
+import { html, css } from '@design.estate/dees-element';
+import '@design.estate/dees-wcctools/demotools';
+import '../../dees-panel/dees-panel.js';
+import type { DeesWorkspaceMarkdownoutlet } from './dees-workspace-markdownoutlet.js';
+
+export const demoFunc = () => html`
+  <dees-demowrapper>
+    <style>
+      ${css`
+        .demo-container {
+          display: flex;
+          flex-direction: column;
+          gap: 24px;
+          padding: 24px;
+          max-width: 900px;
+          margin: 0 auto;
+        }
+      `}
+    </style>
+
+    <div class="demo-container">
+      <!-- Demo 1: Headings -->
+      <dees-panel
+        .title=${'Headings'}
+        .subtitle=${'All heading levels from H1 to H6'}
+        .runAfterRender=${async (panelEl: HTMLElement) => {
+          const outlet = panelEl.querySelector('dees-workspace-markdownoutlet') as DeesWorkspaceMarkdownoutlet;
+          await outlet?.updateHtmlText(`
+            <h1>Heading Level 1</h1>
+            <h2>Heading Level 2</h2>
+            <h3>Heading Level 3</h3>
+            <h4>Heading Level 4</h4>
+            <h5>Heading Level 5</h5>
+            <h6>Heading Level 6</h6>
+          `);
+        }}
+      >
+        <dees-workspace-markdownoutlet></dees-workspace-markdownoutlet>
+      </dees-panel>
+
+      <!-- Demo 2: Text Formatting -->
+      <dees-panel
+        .title=${'Text Formatting'}
+        .subtitle=${'Bold, italic, links, code, and keyboard input'}
+        .runAfterRender=${async (panelEl: HTMLElement) => {
+          const outlet = panelEl.querySelector('dees-workspace-markdownoutlet') as DeesWorkspaceMarkdownoutlet;
+          await outlet?.updateHtmlText(`
+            <p>This is a paragraph with <strong>bold text</strong> and <em>italic text</em>.</p>
+            <p>You can also use <strong><em>bold italic</em></strong> for emphasis.</p>
+            <p>Here's a <a href="#">link example</a> and some <code>inline code</code>.</p>
+            <p>Press <kbd>Ctrl</kbd> + <kbd>C</kbd> to copy text.</p>
+            <hr>
+            <p>Above is a horizontal rule separator.</p>
+          `);
+        }}
+      >
+        <dees-workspace-markdownoutlet></dees-workspace-markdownoutlet>
+      </dees-panel>
+
+      <!-- Demo 3: Lists -->
+      <dees-panel
+        .title=${'Lists'}
+        .subtitle=${'Ordered, unordered, and task lists'}
+        .runAfterRender=${async (panelEl: HTMLElement) => {
+          const outlet = panelEl.querySelector('dees-workspace-markdownoutlet') as DeesWorkspaceMarkdownoutlet;
+          await outlet?.updateHtmlText(`
+            <h3>Unordered List</h3>
+            <ul>
+              <li>First item</li>
+              <li>Second item
+                <ul>
+                  <li>Nested item 1</li>
+                  <li>Nested item 2</li>
+                </ul>
+              </li>
+              <li>Third item</li>
+            </ul>
+
+            <h3>Ordered List</h3>
+            <ol>
+              <li>Step one</li>
+              <li>Step two</li>
+              <li>Step three</li>
+            </ol>
+
+            <h3>Task List</h3>
+            <ul>
+              <li class="task-list-item"><input type="checkbox" checked disabled> Completed task</li>
+              <li class="task-list-item"><input type="checkbox" disabled> Pending task</li>
+              <li class="task-list-item"><input type="checkbox" disabled> Another task</li>
+            </ul>
+          `);
+        }}
+      >
+        <dees-workspace-markdownoutlet></dees-workspace-markdownoutlet>
+      </dees-panel>
+
+      <!-- Demo 4: Code Blocks -->
+      <dees-panel
+        .title=${'Code Blocks'}
+        .subtitle=${'Syntax highlighted code examples'}
+        .runAfterRender=${async (panelEl: HTMLElement) => {
+          const outlet = panelEl.querySelector('dees-workspace-markdownoutlet') as DeesWorkspaceMarkdownoutlet;
+          await outlet?.updateHtmlText(`
+            <p>Inline code: <code>const greeting = "Hello, World!";</code></p>
+
+            <h3>TypeScript Example</h3>
+            <pre><code><span class="hljs-keyword">import</span> { html, css } <span class="hljs-keyword">from</span> <span class="hljs-string">'@design.estate/dees-element'</span>;
+
+<span class="hljs-keyword">interface</span> <span class="hljs-title">IUser</span> {
+  <span class="hljs-attr">name</span>: <span class="hljs-built_in">string</span>;
+  <span class="hljs-attr">email</span>: <span class="hljs-built_in">string</span>;
+  <span class="hljs-attr">age</span>?: <span class="hljs-built_in">number</span>;
+}
+
+<span class="hljs-keyword">const</span> <span class="hljs-title">getUser</span> = <span class="hljs-keyword">async</span> (<span class="hljs-attr">id</span>: <span class="hljs-built_in">string</span>): <span class="hljs-built_in">Promise</span>&lt;IUser&gt; =&gt; {
+  <span class="hljs-keyword">const</span> response = <span class="hljs-keyword">await</span> fetch(\`/api/users/\${id}\`);
+  <span class="hljs-keyword">return</span> response.json();
+};</code></pre>
+
+            <h3>JSON Example</h3>
+            <pre><code>{
+  <span class="hljs-attr">"name"</span>: <span class="hljs-string">"dees-catalog"</span>,
+  <span class="hljs-attr">"version"</span>: <span class="hljs-string">"3.0.0"</span>,
+  <span class="hljs-attr">"dependencies"</span>: {
+    <span class="hljs-attr">"@design.estate/dees-element"</span>: <span class="hljs-string">"^2.0.0"</span>
+  }
+}</code></pre>
+          `);
+        }}
+      >
+        <dees-workspace-markdownoutlet></dees-workspace-markdownoutlet>
+      </dees-panel>
+
+      <!-- Demo 5: Tables -->
+      <dees-panel
+        .title=${'Tables'}
+        .subtitle=${'Styled tables with alternating rows'}
+        .runAfterRender=${async (panelEl: HTMLElement) => {
+          const outlet = panelEl.querySelector('dees-workspace-markdownoutlet') as DeesWorkspaceMarkdownoutlet;
+          await outlet?.updateHtmlText(`
+            <table>
+              <thead>
+                <tr>
+                  <th>Feature</th>
+                  <th>Status</th>
+                  <th>Priority</th>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <td>Dark mode support</td>
+                  <td>Completed</td>
+                  <td>High</td>
+                </tr>
+                <tr>
+                  <td>Responsive design</td>
+                  <td>In Progress</td>
+                  <td>Medium</td>
+                </tr>
+                <tr>
+                  <td>Accessibility</td>
+                  <td>Planned</td>
+                  <td>High</td>
+                </tr>
+                <tr>
+                  <td>Documentation</td>
+                  <td>In Progress</td>
+                  <td>Low</td>
+                </tr>
+              </tbody>
+            </table>
+          `);
+        }}
+      >
+        <dees-workspace-markdownoutlet></dees-workspace-markdownoutlet>
+      </dees-panel>
+
+      <!-- Demo 6: Blockquotes & Alerts -->
+      <dees-panel
+        .title=${'Blockquotes & Alerts'}
+        .subtitle=${'Quotes and GitHub-style alerts'}
+        .runAfterRender=${async (panelEl: HTMLElement) => {
+          const outlet = panelEl.querySelector('dees-workspace-markdownoutlet') as DeesWorkspaceMarkdownoutlet;
+          await outlet?.updateHtmlText(`
+            <blockquote>
+              <p>This is a standard blockquote. It's great for highlighting important information or quotes from other sources.</p>
+            </blockquote>
+
+            <div class="markdown-alert markdown-alert-note">
+              <p><strong>Note:</strong> This is an informational note to draw attention to important details.</p>
+            </div>
+
+            <div class="markdown-alert markdown-alert-tip">
+              <p><strong>Tip:</strong> Here's a helpful tip to improve your workflow.</p>
+            </div>
+
+            <div class="markdown-alert markdown-alert-important">
+              <p><strong>Important:</strong> This information is crucial for understanding the topic.</p>
+            </div>
+
+            <div class="markdown-alert markdown-alert-warning">
+              <p><strong>Warning:</strong> Be careful when performing this action.</p>
+            </div>
+
+            <div class="markdown-alert markdown-alert-caution">
+              <p><strong>Caution:</strong> This action may have unintended consequences.</p>
+            </div>
+          `);
+        }}
+      >
+        <dees-workspace-markdownoutlet></dees-workspace-markdownoutlet>
+      </dees-panel>
+
+      <!-- Demo 7: Full Document -->
+      <dees-panel
+        .title=${'Full Document'}
+        .subtitle=${'A complete markdown document example'}
+        .runAfterRender=${async (panelEl: HTMLElement) => {
+          const outlet = panelEl.querySelector('dees-workspace-markdownoutlet') as DeesWorkspaceMarkdownoutlet;
+          await outlet?.updateHtmlText(`
+            <h1>Getting Started Guide</h1>
+            <p>Welcome to the <strong>dees-catalog</strong> component library. This guide will help you get up and running quickly.</p>
+
+            <h2>Installation</h2>
+            <p>Install the package using your preferred package manager:</p>
+            <pre><code><span class="hljs-comment"># Using pnpm (recommended)</span>
+pnpm add @design.estate/dees-catalog
+
+<span class="hljs-comment"># Using npm</span>
+npm install @design.estate/dees-catalog</code></pre>
+
+            <h2>Basic Usage</h2>
+            <p>Import and use components in your TypeScript files:</p>
+            <pre><code><span class="hljs-keyword">import</span> { DeesButton } <span class="hljs-keyword">from</span> <span class="hljs-string">'@design.estate/dees-catalog'</span>;
+
+<span class="hljs-comment">// Use in your templates</span>
+html\`&lt;dees-button&gt;Click me&lt;/dees-button&gt;\`</code></pre>
+
+            <div class="markdown-alert markdown-alert-tip">
+              <p><strong>Tip:</strong> Check the demo showcase for live examples of all components.</p>
+            </div>
+
+            <h2>Available Components</h2>
+            <table>
+              <thead>
+                <tr>
+                  <th>Component</th>
+                  <th>Description</th>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <td><code>dees-button</code></td>
+                  <td>Primary button component</td>
+                </tr>
+                <tr>
+                  <td><code>dees-input-text</code></td>
+                  <td>Text input field</td>
+                </tr>
+                <tr>
+                  <td><code>dees-table</code></td>
+                  <td>Data table with sorting</td>
+                </tr>
+                <tr>
+                  <td><code>dees-modal</code></td>
+                  <td>Modal dialog</td>
+                </tr>
+              </tbody>
+            </table>
+
+            <h2>Next Steps</h2>
+            <ul>
+              <li>Explore the <a href="#">component documentation</a></li>
+              <li>Check out the <a href="#">theming guide</a></li>
+              <li>Join our <a href="#">community Discord</a></li>
+            </ul>
+
+            <blockquote>
+              <p>"The best component library is one that gets out of your way." — Design Systems Team</p>
+            </blockquote>
+          `);
+        }}
+      >
+        <dees-workspace-markdownoutlet></dees-workspace-markdownoutlet>
+      </dees-panel>
+    </div>
+  </dees-demowrapper>
+`;

ts_web/elements/00group-workspace/dees-workspace-markdownoutlet/dees-workspace-markdownoutlet.ts

@@ -0,0 +1,406 @@
+import {
+  customElement,
+  DeesElement,
+  html,
+  type TemplateResult,
+  css,
+  cssManager,
+} from '@design.estate/dees-element';
+import { themeDefaultStyles } from '../../00theme.js';
+import { demoFunc } from './dees-workspace-markdownoutlet.demo.js';
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'dees-workspace-markdownoutlet': DeesWorkspaceMarkdownoutlet;
+  }
+}
+
+@customElement('dees-workspace-markdownoutlet')
+export class DeesWorkspaceMarkdownoutlet extends DeesElement {
+  // DEMO
+  public static demo = demoFunc;
+
+  public static styles = [
+    themeDefaultStyles,
+    cssManager.defaultStyles,
+    css`
+      :host {
+        display: block;
+        font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Noto Sans', Helvetica, Arial, sans-serif;
+        font-size: 16px;
+        line-height: 1.6;
+        color: ${cssManager.bdTheme('#24292f', '#e6edf3')};
+      }
+
+      .outlet {
+        word-wrap: break-word;
+      }
+
+      /* Headings */
+      h1, h2, h3, h4, h5, h6 {
+        margin-top: 24px;
+        margin-bottom: 16px;
+        font-weight: 600;
+        line-height: 1.25;
+        color: ${cssManager.bdTheme('#1f2328', '#f0f6fc')};
+      }
+
+      h1 {
+        font-size: 2em;
+        padding-bottom: 0.3em;
+        border-bottom: 1px solid ${cssManager.bdTheme('#d1d9e0', '#30363d')};
+      }
+
+      h2 {
+        font-size: 1.5em;
+        padding-bottom: 0.3em;
+        border-bottom: 1px solid ${cssManager.bdTheme('#d1d9e0', '#30363d')};
+      }
+
+      h3 {
+        font-size: 1.25em;
+      }
+
+      h4 {
+        font-size: 1em;
+      }
+
+      h5 {
+        font-size: 0.875em;
+      }
+
+      h6 {
+        font-size: 0.85em;
+        color: ${cssManager.bdTheme('#656d76', '#8b949e')};
+      }
+
+      /* Paragraphs and text */
+      p {
+        margin-top: 0;
+        margin-bottom: 16px;
+      }
+
+      /* Links */
+      a {
+        color: ${cssManager.bdTheme('#0969da', '#58a6ff')};
+        text-decoration: none;
+      }
+
+      a:hover {
+        text-decoration: underline;
+      }
+
+      /* Strong and emphasis */
+      strong {
+        font-weight: 600;
+        color: ${cssManager.bdTheme('#1f2328', '#f0f6fc')};
+      }
+
+      em {
+        font-style: italic;
+      }
+
+      /* Lists */
+      ul, ol {
+        margin-top: 0;
+        margin-bottom: 16px;
+        padding-left: 2em;
+      }
+
+      li {
+        margin-top: 4px;
+      }
+
+      li + li {
+        margin-top: 4px;
+      }
+
+      ul ul, ul ol, ol ul, ol ol {
+        margin-top: 0;
+        margin-bottom: 0;
+      }
+
+      /* Blockquotes */
+      blockquote {
+        margin: 0 0 16px 0;
+        padding: 0 1em;
+        color: ${cssManager.bdTheme('#656d76', '#8b949e')};
+        border-left: 4px solid ${cssManager.bdTheme('#d1d9e0', '#30363d')};
+      }
+
+      blockquote > :first-child {
+        margin-top: 0;
+      }
+
+      blockquote > :last-child {
+        margin-bottom: 0;
+      }
+
+      /* Inline code */
+      code {
+        padding: 0.2em 0.4em;
+        margin: 0;
+        font-size: 85%;
+        font-family: ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, 'Liberation Mono', monospace;
+        background-color: ${cssManager.bdTheme('rgba(175, 184, 193, 0.2)', 'rgba(110, 118, 129, 0.4)')};
+        border-radius: 6px;
+        white-space: break-spaces;
+      }
+
+      /* Code blocks */
+      pre {
+        margin-top: 0;
+        margin-bottom: 16px;
+        padding: 16px;
+        overflow: auto;
+        font-size: 85%;
+        line-height: 1.45;
+        font-family: ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, 'Liberation Mono', monospace;
+        background-color: ${cssManager.bdTheme('#f6f8fa', '#161b22')};
+        border-radius: 6px;
+        word-wrap: normal;
+      }
+
+      pre code {
+        display: block;
+        padding: 0;
+        margin: 0;
+        overflow: visible;
+        line-height: inherit;
+        word-wrap: normal;
+        background-color: transparent;
+        border: 0;
+        font-size: 100%;
+        white-space: pre;
+      }
+
+      /* Tables */
+      table {
+        width: max-content;
+        max-width: 100%;
+        margin-top: 0;
+        margin-bottom: 16px;
+        border-spacing: 0;
+        border-collapse: collapse;
+        overflow: auto;
+        display: block;
+      }
+
+      table th {
+        font-weight: 600;
+        padding: 6px 13px;
+        border: 1px solid ${cssManager.bdTheme('#d1d9e0', '#30363d')};
+        background-color: ${cssManager.bdTheme('#f6f8fa', '#161b22')};
+        color: ${cssManager.bdTheme('#1f2328', '#e6edf3')};
+      }
+
+      table td {
+        padding: 6px 13px;
+        border: 1px solid ${cssManager.bdTheme('#d1d9e0', '#30363d')};
+        color: ${cssManager.bdTheme('#1f2328', '#e6edf3')};
+      }
+
+      table tr {
+        background-color: ${cssManager.bdTheme('#ffffff', '#0d1117')};
+        border-top: 1px solid ${cssManager.bdTheme('#d1d9e0', '#21262d')};
+      }
+
+      table tr:nth-child(2n) {
+        background-color: ${cssManager.bdTheme('#f6f8fa', '#161b22')};
+      }
+
+      /* Horizontal rules */
+      hr {
+        height: 4px;
+        padding: 0;
+        margin: 24px 0;
+        background-color: ${cssManager.bdTheme('#d1d9e0', '#30363d')};
+        border: 0;
+        border-radius: 2px;
+      }
+
+      /* Images */
+      img {
+        max-width: 100%;
+        box-sizing: border-box;
+        border-radius: 6px;
+      }
+
+      /* Task lists */
+      .task-list-item {
+        list-style-type: none;
+      }
+
+      .task-list-item input {
+        margin: 0 0.2em 0.25em -1.4em;
+        vertical-align: middle;
+      }
+
+      /* Definition lists */
+      dl {
+        padding: 0;
+      }
+
+      dl dt {
+        padding: 0;
+        margin-top: 16px;
+        font-size: 1em;
+        font-style: italic;
+        font-weight: 600;
+      }
+
+      dl dd {
+        padding: 0 16px;
+        margin-bottom: 16px;
+      }
+
+      /* Keyboard input */
+      kbd {
+        display: inline-block;
+        padding: 3px 5px;
+        font-size: 11px;
+        font-family: ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, 'Liberation Mono', monospace;
+        line-height: 10px;
+        color: ${cssManager.bdTheme('#1f2328', '#e6edf3')};
+        vertical-align: middle;
+        background-color: ${cssManager.bdTheme('#f6f8fa', '#161b22')};
+        border: 1px solid ${cssManager.bdTheme('#d1d9e0', '#30363d')};
+        border-radius: 6px;
+        box-shadow: inset 0 -1px 0 ${cssManager.bdTheme('#d1d9e0', '#30363d')};
+      }
+
+      /* Footnotes */
+      .footnotes {
+        font-size: 12px;
+        color: ${cssManager.bdTheme('#656d76', '#8b949e')};
+        border-top: 1px solid ${cssManager.bdTheme('#d1d9e0', '#30363d')};
+        padding-top: 16px;
+        margin-top: 32px;
+      }
+
+      /* Alerts/Admonitions */
+      .markdown-alert {
+        padding: 8px 16px;
+        margin-bottom: 16px;
+        border-left: 4px solid;
+        border-radius: 6px;
+      }
+
+      .markdown-alert-note {
+        border-color: ${cssManager.bdTheme('#0969da', '#58a6ff')};
+        background-color: ${cssManager.bdTheme('rgba(9, 105, 218, 0.1)', 'rgba(56, 139, 253, 0.1)')};
+      }
+
+      .markdown-alert-warning {
+        border-color: ${cssManager.bdTheme('#bf8700', '#d29922')};
+        background-color: ${cssManager.bdTheme('rgba(191, 135, 0, 0.1)', 'rgba(187, 128, 9, 0.1)')};
+      }
+
+      .markdown-alert-important {
+        border-color: ${cssManager.bdTheme('#8250df', '#a371f7')};
+        background-color: ${cssManager.bdTheme('rgba(130, 80, 223, 0.1)', 'rgba(163, 113, 247, 0.1)')};
+      }
+
+      .markdown-alert-caution {
+        border-color: ${cssManager.bdTheme('#cf222e', '#f85149')};
+        background-color: ${cssManager.bdTheme('rgba(207, 34, 46, 0.1)', 'rgba(248, 81, 73, 0.1)')};
+      }
+
+      .markdown-alert-tip {
+        border-color: ${cssManager.bdTheme('#1a7f37', '#3fb950')};
+        background-color: ${cssManager.bdTheme('rgba(26, 127, 55, 0.1)', 'rgba(46, 160, 67, 0.1)')};
+      }
+
+      /* Syntax highlighting for code blocks */
+      .hljs-comment,
+      .hljs-quote {
+        color: ${cssManager.bdTheme('#6a737d', '#8b949e')};
+      }
+
+      .hljs-keyword,
+      .hljs-selector-tag,
+      .hljs-addition {
+        color: ${cssManager.bdTheme('#d73a49', '#ff7b72')};
+      }
+
+      .hljs-number,
+      .hljs-string,
+      .hljs-meta .hljs-meta-string,
+      .hljs-literal,
+      .hljs-doctag,
+      .hljs-regexp {
+        color: ${cssManager.bdTheme('#032f62', '#a5d6ff')};
+      }
+
+      .hljs-title,
+      .hljs-section,
+      .hljs-name,
+      .hljs-selector-id,
+      .hljs-selector-class {
+        color: ${cssManager.bdTheme('#6f42c1', '#d2a8ff')};
+      }
+
+      .hljs-attribute,
+      .hljs-attr,
+      .hljs-variable,
+      .hljs-template-variable,
+      .hljs-class .hljs-title,
+      .hljs-type {
+        color: ${cssManager.bdTheme('#005cc5', '#79c0ff')};
+      }
+
+      .hljs-symbol,
+      .hljs-bullet,
+      .hljs-subst,
+      .hljs-meta,
+      .hljs-meta .hljs-keyword,
+      .hljs-selector-attr,
+      .hljs-selector-pseudo,
+      .hljs-link {
+        color: ${cssManager.bdTheme('#e36209', '#ffa657')};
+      }
+
+      .hljs-built_in,
+      .hljs-deletion {
+        color: ${cssManager.bdTheme('#b31d28', '#ffa198')};
+      }
+
+      .hljs-formula {
+        background-color: ${cssManager.bdTheme('#f6f8fa', '#161b22')};
+      }
+
+      .hljs-emphasis {
+        font-style: italic;
+      }
+
+      .hljs-strong {
+        font-weight: bold;
+      }
+    `,
+  ];
+
+  // INSTANCE
+  private outlet: HTMLElement;
+
+  public render(): TemplateResult {
+    return html`
+      <div class="outlet">
+        <h1>Markdown Preview</h1>
+        <p>Content will appear here when markdown is parsed.</p>
+      </div>
+    `;
+  }
+
+  public async firstUpdated(_changedProperties: Map<string | number | symbol, unknown>) {
+    await super.firstUpdated(_changedProperties);
+    this.outlet = this.shadowRoot.querySelector('.outlet');
+  }
+
+  public async updateHtmlText(htmlTextArg: string) {
+    await this.updateComplete;
+    if (!this.outlet) {
+      this.outlet = this.shadowRoot.querySelector('.outlet');
+    }
+    this.outlet.innerHTML = htmlTextArg;
+  }
+}

ts_web/elements/00group-workspace/dees-workspace-markdownoutlet/index.ts

@@ -0,0 +1 @@
+export * from './dees-workspace-markdownoutlet.js';

ts_web/elements/00group-workspace/dees-workspace-monaco/dees-workspace-monaco.ts

@@ -0,0 +1,294 @@
+import {
+  DeesElement,
+  property,
+  html,
+  customElement,
+  type TemplateResult,
+  css,
+  cssManager,
+} from '@design.estate/dees-element';
+import * as domtools from '@design.estate/dees-domtools';
+import { MONACO_VERSION } from './version.js';
+import { themeDefaultStyles } from '../../00theme.js';
+
+import type * as monaco from 'monaco-editor';
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'dees-workspace-monaco': DeesWorkspaceMonaco;
+  }
+}
+
+@customElement('dees-workspace-monaco')
+export class DeesWorkspaceMonaco extends DeesElement {
+  // DEMO
+  public static demo = () => html`<dees-workspace-monaco></dees-workspace-monaco>`;
+
+  // STATIC
+  public static monacoDeferred: ReturnType<typeof domtools.plugins.smartpromise.defer>;
+
+  // INSTANCE
+  public editorDeferred = domtools.plugins.smartpromise.defer<monaco.editor.IStandaloneCodeEditor>();
+
+  @property({
+    type: String
+  })
+  accessor content = "function hello() {\n\talert('Hello world!');\n}";
+
+  @property({
+    type: String
+  })
+  accessor language = 'typescript';
+
+  @property({
+    type: String
+  })
+  accessor filePath: string = '';
+
+  @property({
+    type: Object
+  })
+  accessor contentSubject = new domtools.plugins.smartrx.rxjs.Subject<string>();
+
+  @property({
+    type: Boolean
+  })
+  accessor wordWrap: monaco.editor.IStandaloneEditorConstructionOptions['wordWrap'] = 'off';
+
+  private monacoThemeSubscription: domtools.plugins.smartrx.rxjs.Subscription | null = null;
+  private isUpdatingFromExternal: boolean = false;
+
+  constructor() {
+    super();
+    domtools.DomTools.setupDomTools();
+  }
+
+  public static styles = [
+    themeDefaultStyles,
+    cssManager.defaultStyles,
+    css`
+      /* TODO: Migrate hardcoded values to --dees-* CSS variables */
+      :host {
+      }
+
+      * {
+        box-sizing: border-box;
+      }
+
+      #container {
+        position: absolute;
+        height: 100%;
+        width: 100%;
+      }
+    `,
+  ];
+
+  public render(): TemplateResult {
+    return html`
+      <div class="mainbox">
+        <div id="container"></div>
+      </div>
+    `;
+  }
+
+  public async firstUpdated(
+    _changedProperties: Map<string | number | symbol, unknown>
+  ): Promise<void> {
+    super.firstUpdated(_changedProperties);
+    const container = this.shadowRoot.getElementById('container');
+    const monacoCdnBase = `https://cdn.jsdelivr.net/npm/monaco-editor@${MONACO_VERSION}`;
+
+    if (!DeesWorkspaceMonaco.monacoDeferred) {
+      DeesWorkspaceMonaco.monacoDeferred = domtools.plugins.smartpromise.defer();
+      const scriptUrl = `${monacoCdnBase}/min/vs/loader.js`;
+      const script = document.createElement('script');
+      script.src = scriptUrl;
+      script.onload = () => {
+        DeesWorkspaceMonaco.monacoDeferred.resolve();
+      };
+      document.head.appendChild(script);
+    }
+    await DeesWorkspaceMonaco.monacoDeferred.promise;
+
+    (window as any).require.config({
+      paths: { vs: `${monacoCdnBase}/min/vs` },
+    });
+    (window as any).require(['vs/editor/editor.main'], async () => {
+      // Get current theme from domtools
+      const domtoolsInstance = await this.domtoolsPromise;
+      const isBright = domtoolsInstance.themeManager.goBrightBoolean;
+      const initialTheme = isBright ? 'vs' : 'vs-dark';
+
+      const monacoInstance = (window as any).monaco as typeof monaco;
+
+      // Create or get model with proper file URI for TypeScript IntelliSense
+      let model: monaco.editor.ITextModel | null = null;
+      if (this.filePath) {
+        const uri = monacoInstance.Uri.parse(`file://${this.filePath}`);
+        model = monacoInstance.editor.getModel(uri);
+        if (!model) {
+          model = monacoInstance.editor.createModel(this.content, this.language, uri);
+        } else {
+          model.setValue(this.content);
+        }
+      }
+
+      const editor = (monacoInstance.editor as typeof monaco.editor).create(container, {
+        model: model || undefined,
+        value: model ? undefined : this.content,
+        language: model ? undefined : this.language,
+        theme: initialTheme,
+        useShadowDOM: true,
+        fontSize: 16,
+        automaticLayout: true,
+        wordWrap: this.wordWrap,
+        hover: {
+          enabled: true,
+          delay: 300,
+          sticky: true,
+          above: false,
+        },
+      });
+
+      // Subscribe to theme changes
+      this.monacoThemeSubscription = domtoolsInstance.themeManager.themeObservable.subscribe((goBright: boolean) => {
+        const newTheme = goBright ? 'vs' : 'vs-dark';
+        editor.updateOptions({ theme: newTheme });
+      });
+
+      this.editorDeferred.resolve(editor);
+    });
+    const css = await (
+      await fetch(`${monacoCdnBase}/min/vs/editor/editor.main.css`)
+    ).text();
+    const styleElement = document.createElement('style');
+    styleElement.textContent = css;
+    this.shadowRoot.append(styleElement);
+
+
+    // editor is setup let do the rest
+    const editor = await this.editorDeferred.promise;
+    editor.onDidChangeModelContent(async eventArg => {
+      // Don't emit events when we're programmatically updating the content
+      if (this.isUpdatingFromExternal) return;
+
+      const value = editor.getValue();
+      this.contentSubject.next(value);
+      this.dispatchEvent(new CustomEvent('content-change', {
+        detail: value,
+        bubbles: true,
+        composed: true,
+      }));
+    });
+    this.contentSubject.next(editor.getValue());
+  }
+
+  public async updated(changedProperties: Map<string, any>): Promise<void> {
+    super.updated(changedProperties);
+
+    const monacoInstance = (window as any).monaco as typeof monaco;
+    if (!monacoInstance) return;
+
+    // Handle filePath changes - switch to different model
+    if (changedProperties.has('filePath') && this.filePath) {
+      const editor = await this.editorDeferred.promise;
+      const uri = monacoInstance.Uri.parse(`file://${this.filePath}`);
+      let model = monacoInstance.editor.getModel(uri);
+
+      if (!model) {
+        model = monacoInstance.editor.createModel(this.content, this.language, uri);
+      } else {
+        // Update model content if different
+        if (model.getValue() !== this.content) {
+          this.isUpdatingFromExternal = true;
+          model.setValue(this.content);
+          this.isUpdatingFromExternal = false;
+        }
+      }
+
+      // Switch editor to use this model
+      const currentModel = editor.getModel();
+      if (currentModel?.uri.toString() !== uri.toString()) {
+        editor.setModel(model);
+      }
+      return; // filePath change handles content too
+    }
+
+    // Handle content changes (when no filePath or filePath unchanged)
+    if (changedProperties.has('content')) {
+      const editor = await this.editorDeferred.promise;
+      const currentValue = editor.getValue();
+      if (currentValue !== this.content) {
+        this.isUpdatingFromExternal = true;
+        editor.setValue(this.content);
+        this.isUpdatingFromExternal = false;
+      }
+    }
+
+    // Handle language changes
+    if (changedProperties.has('language')) {
+      const editor = await this.editorDeferred.promise;
+      const model = editor.getModel();
+      if (model) {
+        monacoInstance.editor.setModelLanguage(model, this.language);
+      }
+    }
+  }
+
+  public async disconnectedCallback(): Promise<void> {
+    await super.disconnectedCallback();
+    if (this.monacoThemeSubscription) {
+      this.monacoThemeSubscription.unsubscribe();
+      this.monacoThemeSubscription = null;
+    }
+  }
+
+  /**
+   * Update content from external source with optional cursor preservation.
+   * Use this when the file content changes externally (e.g., file changed on disk).
+   * @param newContent The new content to set
+   * @param preserveCursor Whether to preserve cursor/scroll position (default: true)
+   */
+  public async setContentExternal(
+    newContent: string,
+    preserveCursor: boolean = true
+  ): Promise<void> {
+    const editor = await this.editorDeferred.promise;
+    const currentValue = editor.getValue();
+
+    if (currentValue === newContent) return;
+
+    // Save cursor state if preserving
+    const position = preserveCursor ? editor.getPosition() : null;
+    const selections = preserveCursor ? editor.getSelections() : null;
+    const scrollTop = preserveCursor ? editor.getScrollTop() : 0;
+    const scrollLeft = preserveCursor ? editor.getScrollLeft() : 0;
+
+    // Update content
+    this.isUpdatingFromExternal = true;
+    editor.setValue(newContent);
+    this.isUpdatingFromExternal = false;
+
+    // Restore cursor state if preserving
+    if (preserveCursor) {
+      if (position) {
+        // Clamp position to valid range
+        const model = editor.getModel();
+        const lineCount = model?.getLineCount() || 1;
+        const clampedLine = Math.min(position.lineNumber, lineCount);
+        const lineLength = model?.getLineMaxColumn(clampedLine) || 1;
+        const clampedColumn = Math.min(position.column, lineLength);
+        editor.setPosition({ lineNumber: clampedLine, column: clampedColumn });
+      }
+      if (selections && selections.length > 0) {
+        // Selections may be invalid after content change, wrap in try-catch
+        try {
+          editor.setSelections(selections);
+        } catch {
+          // Ignore invalid selections
+        }
+      }
+      editor.setScrollPosition({ scrollTop, scrollLeft });
+    }
+  }
+}

ts_web/elements/00group-workspace/dees-workspace-monaco/index.ts

@@ -0,0 +1 @@
+export * from './dees-workspace-monaco.js';

ts_web/elements/00group-workspace/dees-workspace-monaco/version.ts

@@ -1,2 +1,2 @@
 // Auto-generated by scripts/update-monaco-version.cjs
-export const MONACO_VERSION = '0.52.2';
+export const MONACO_VERSION = '0.55.1';

ts_web/elements/00group-workspace/dees-workspace-terminal-preview/dees-workspace-terminal-preview.ts

@@ -0,0 +1,403 @@
+import {
+  DeesElement,
+  property,
+  html,
+  customElement,
+  type TemplateResult,
+  css,
+  cssManager,
+} from '@design.estate/dees-element';
+import type { Terminal } from 'xterm';
+import type { FitAddon } from 'xterm-addon-fit';
+import { themeDefaultStyles } from '../../00theme.js';
+import { DeesServiceLibLoader } from '../../../services/index.js';
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'dees-workspace-terminal-preview': DeesWorkspaceTerminalPreview;
+  }
+}
+
+/**
+ * A read-only terminal preview component using xterm.js for rendering.
+ * Used during workspace initialization to show onInit command progress.
+ */
+@customElement('dees-workspace-terminal-preview')
+export class DeesWorkspaceTerminalPreview extends DeesElement {
+  public static demo = () => html`
+    <dees-workspace-terminal-preview
+      .command=${'pnpm install'}
+      .lines=${[
+        'Packages: +42',
+        'Progress: resolved 142, reused 140, downloaded 2, added 42, done',
+        '',
+        'dependencies:',
+        '+ @push.rocks/smartpromise 4.2.3',
+        '+ typescript 5.3.3',
+        '',
+        'Done in 2.3s'
+      ]}
+    ></dees-workspace-terminal-preview>
+  `;
+
+  /**
+   * The command being displayed (shown in header)
+   */
+  @property({ type: String })
+  accessor command: string = '';
+
+  /**
+   * Output lines to display
+   */
+  @property({ type: Array })
+  accessor lines: string[] = [];
+
+  private terminal: Terminal | null = null;
+  private fitAddon: FitAddon | null = null;
+  private lastLineCount: number = 0;
+  private resizeObserver: ResizeObserver | null = null;
+  private terminalThemeSubscription: any = null;
+
+  public static styles = [
+    themeDefaultStyles,
+    cssManager.defaultStyles,
+    css`
+      :host {
+        display: block;
+        height: 200px;
+      }
+
+      .terminal-preview {
+        height: 100%;
+        border-radius: 8px;
+        overflow: hidden;
+        background: ${cssManager.bdTheme('#ffffff', '#000000')};
+        border: 1px solid ${cssManager.bdTheme('hsl(0 0% 85%)', 'hsl(0 0% 20%)')};
+        display: flex;
+        flex-direction: column;
+      }
+
+      .terminal-header {
+        display: flex;
+        align-items: center;
+        gap: 8px;
+        padding: 8px 12px;
+        background: ${cssManager.bdTheme('hsl(0 0% 96%)', 'hsl(0 0% 10%)')};
+        font-size: 12px;
+        font-family: 'SF Mono', 'Monaco', 'Inconsolata', 'Fira Code', monospace;
+        color: ${cssManager.bdTheme('hsl(0 0% 40%)', 'hsl(0 0% 60%)')};
+        border-bottom: 1px solid ${cssManager.bdTheme('hsl(0 0% 85%)', 'hsl(0 0% 20%)')};
+        flex-shrink: 0;
+      }
+
+      .terminal-header-icon {
+        color: ${cssManager.bdTheme('hsl(0 0% 50%)', 'hsl(0 0% 50%)')};
+      }
+
+      .terminal-header-command {
+        color: ${cssManager.bdTheme('hsl(0 0% 20%)', 'hsl(0 0% 80%)')};
+        font-weight: 500;
+      }
+
+      .terminal-container {
+        flex: 1;
+        position: relative;
+        padding: 8px;
+      }
+
+      #xterm-container {
+        position: absolute;
+        top: 8px;
+        left: 8px;
+        right: 8px;
+        bottom: 8px;
+      }
+
+      /* xterm.js styles */
+      .xterm {
+        font-feature-settings: 'liga' 0;
+        position: relative;
+        user-select: none;
+        -ms-user-select: none;
+        -webkit-user-select: none;
+      }
+
+      .xterm.focus,
+      .xterm:focus {
+        outline: none;
+      }
+
+      .xterm .xterm-helpers {
+        position: absolute;
+        top: 0;
+        z-index: 5;
+      }
+
+      .xterm .xterm-helper-textarea {
+        padding: 0;
+        border: 0;
+        margin: 0;
+        position: absolute;
+        opacity: 0;
+        left: -9999em;
+        top: 0;
+        width: 0;
+        height: 0;
+        z-index: -5;
+        white-space: nowrap;
+        overflow: hidden;
+        resize: none;
+      }
+
+      .xterm .composition-view {
+        background: ${cssManager.bdTheme('#ffffff', '#000000')};
+        color: ${cssManager.bdTheme('#333333', '#ffffff')};
+        display: none;
+        position: absolute;
+        white-space: nowrap;
+        z-index: 1;
+      }
+
+      .xterm .composition-view.active {
+        display: block;
+      }
+
+      .xterm .xterm-viewport {
+        background-color: ${cssManager.bdTheme('#ffffff', '#000000')};
+        overflow-y: scroll;
+        cursor: default;
+        position: absolute;
+        right: 0;
+        left: 0;
+        top: 0;
+        bottom: 0;
+      }
+
+      .xterm .xterm-screen {
+        position: relative;
+      }
+
+      .xterm .xterm-screen canvas {
+        position: absolute;
+        left: 0;
+        top: 0;
+      }
+
+      .xterm .xterm-scroll-area {
+        visibility: hidden;
+      }
+
+      .xterm-char-measure-element {
+        display: inline-block;
+        visibility: hidden;
+        position: absolute;
+        top: 0;
+        left: -9999em;
+        line-height: normal;
+      }
+
+      .xterm {
+        cursor: text;
+      }
+
+      .xterm.enable-mouse-events {
+        cursor: default;
+      }
+
+      .xterm.xterm-cursor-pointer {
+        cursor: pointer;
+      }
+
+      .xterm.column-select.focus {
+        cursor: crosshair;
+      }
+
+      .xterm .xterm-accessibility,
+      .xterm .xterm-message {
+        position: absolute;
+        left: 0;
+        top: 0;
+        bottom: 0;
+        right: 0;
+        z-index: 10;
+        color: transparent;
+      }
+
+      .xterm .live-region {
+        position: absolute;
+        left: -9999px;
+        width: 1px;
+        height: 1px;
+        overflow: hidden;
+      }
+
+      .xterm-dim {
+        opacity: 0.5;
+      }
+
+      .xterm-underline {
+        text-decoration: underline;
+      }
+
+      /* Custom scrollbar for xterm viewport */
+      .xterm .xterm-viewport::-webkit-scrollbar {
+        width: 8px;
+      }
+
+      .xterm .xterm-viewport::-webkit-scrollbar-track {
+        background: ${cssManager.bdTheme('hsl(0 0% 96%)', 'hsl(0 0% 8%)')};
+      }
+
+      .xterm .xterm-viewport::-webkit-scrollbar-thumb {
+        background: ${cssManager.bdTheme('hsl(0 0% 80%)', 'hsl(0 0% 25%)')};
+        border-radius: 4px;
+      }
+
+      .xterm .xterm-viewport::-webkit-scrollbar-thumb:hover {
+        background: ${cssManager.bdTheme('hsl(0 0% 70%)', 'hsl(0 0% 35%)')};
+      }
+    `,
+  ];
+
+  public render(): TemplateResult {
+    return html`
+      <div class="terminal-preview">
+        <div class="terminal-header">
+          <span class="terminal-header-icon">$</span>
+          <span class="terminal-header-command">${this.command || 'Waiting...'}</span>
+        </div>
+        <div class="terminal-container">
+          <div id="xterm-container"></div>
+        </div>
+      </div>
+    `;
+  }
+
+  /**
+   * Get terminal theme colors based on bright/dark mode
+   */
+  private getTerminalTheme(isBright: boolean) {
+    return isBright
+      ? {
+          background: '#ffffff',
+          foreground: '#333333',
+          cursor: '#333333',
+          cursorAccent: '#ffffff',
+          selectionBackground: 'rgba(0, 0, 0, 0.2)',
+        }
+      : {
+          background: '#000000',
+          foreground: '#cccccc',
+          cursor: '#cccccc',
+          cursorAccent: '#000000',
+          selectionBackground: 'rgba(255, 255, 255, 0.2)',
+        };
+  }
+
+  public async firstUpdated(
+    _changedProperties: Map<string | number | symbol, unknown>
+  ): Promise<void> {
+    super.firstUpdated(_changedProperties);
+
+    const container = this.shadowRoot?.getElementById('xterm-container');
+    if (!container) return;
+
+    // Get current theme from domtools
+    const domtoolsInstance = await this.domtoolsPromise;
+    const isBright = domtoolsInstance.themeManager.goBrightBoolean;
+
+    // Load xterm from CDN
+    const libLoader = DeesServiceLibLoader.getInstance();
+    const [xtermBundle, fitAddonBundle] = await Promise.all([
+      libLoader.loadXterm(),
+      libLoader.loadXtermFitAddon(),
+    ]);
+
+    // Create xterm terminal in read-only mode using CDN-loaded module
+    this.terminal = new xtermBundle.Terminal({
+      convertEol: true,
+      cursorBlink: false,
+      disableStdin: true,
+      fontSize: 12,
+      fontFamily: "'SF Mono', 'Monaco', 'Inconsolata', 'Fira Code', monospace",
+      theme: this.getTerminalTheme(isBright),
+      scrollback: 1000,
+    });
+
+    // Subscribe to theme changes
+    this.terminalThemeSubscription = domtoolsInstance.themeManager.themeObservable.subscribe((goBright: boolean) => {
+      if (this.terminal) {
+        this.terminal.options.theme = this.getTerminalTheme(goBright);
+      }
+    });
+
+    this.fitAddon = new fitAddonBundle.FitAddon();
+    this.terminal.loadAddon(this.fitAddon);
+    this.terminal.open(container);
+    this.fitAddon.fit();
+
+    // Set up resize observer to refit terminal
+    this.resizeObserver = new ResizeObserver(() => {
+      if (this.fitAddon) {
+        this.fitAddon.fit();
+      }
+    });
+    this.resizeObserver.observe(container);
+
+    // Write any existing lines
+    this.writeNewLines();
+  }
+
+  public async updated(changedProperties: Map<string, any>) {
+    super.updated(changedProperties);
+
+    if (changedProperties.has('lines')) {
+      this.writeNewLines();
+    }
+  }
+
+  private writeNewLines() {
+    if (!this.terminal) return;
+
+    // Write only new lines since last update
+    const newLines = this.lines.slice(this.lastLineCount);
+    for (const line of newLines) {
+      this.terminal.writeln(line);
+    }
+    this.lastLineCount = this.lines.length;
+  }
+
+  public async disconnectedCallback(): Promise<void> {
+    if (this.resizeObserver) {
+      this.resizeObserver.disconnect();
+      this.resizeObserver = null;
+    }
+    if (this.terminalThemeSubscription) {
+      this.terminalThemeSubscription.unsubscribe();
+      this.terminalThemeSubscription = null;
+    }
+    if (this.terminal) {
+      this.terminal.dispose();
+      this.terminal = null;
+    }
+    await super.disconnectedCallback();
+  }
+
+  /**
+   * Add a new line to the output
+   */
+  public addLine(line: string) {
+    this.lines = [...this.lines, line];
+  }
+
+  /**
+   * Clear all output lines
+   */
+  public clear() {
+    this.lines = [];
+    this.lastLineCount = 0;
+    if (this.terminal) {
+      this.terminal.clear();
+    }
+  }
+}

ts_web/elements/00group-workspace/dees-workspace-terminal-preview/index.ts

@@ -0,0 +1 @@
+export * from './dees-workspace-terminal-preview.js';

ts_web/elements/00group-workspace/dees-workspace-terminal/dees-workspace-terminal.ts

@@ -0,0 +1,931 @@
+import {
+  DeesElement,
+  property,
+  html,
+  customElement,
+  type TemplateResult,
+  css,
+  cssManager,
+  state,
+} from '@design.estate/dees-element';
+import * as domtools from '@design.estate/dees-domtools';
+
+import type { Terminal } from 'xterm';
+import { themeDefaultStyles } from '../../00theme.js';
+import type { IExecutionEnvironment } from '../../00group-runtime/index.js';
+import { WebContainerEnvironment } from '../../00group-runtime/index.js';
+import '../../dees-icon/dees-icon.js';
+import '../../dees-actionbar/dees-actionbar.js';
+import type { DeesActionbar } from '../../dees-actionbar/dees-actionbar.js';
+import { TerminalTabManager } from './terminal-tab-manager.js';
+import type {
+  ITerminalTab,
+  ICreateTerminalTabOptions,
+  TTerminalTabType,
+} from './interfaces.js';
+import { DeesServiceLibLoader } from '../../../services/index.js';
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'dees-workspace-terminal': DeesWorkspaceTerminal;
+  }
+}
+
+@customElement('dees-workspace-terminal')
+export class DeesWorkspaceTerminal extends DeesElement {
+  public static demo = () => {
+    const env = new WebContainerEnvironment();
+    return html`<dees-workspace-terminal .executionEnvironment=${env}></dees-workspace-terminal>`;
+  };
+
+  // INSTANCE
+  private resizeObserver: ResizeObserver;
+  private tabManager: TerminalTabManager;
+
+  /**
+   * The execution environment (required).
+   * Use WebContainerEnvironment for browser-based execution.
+   */
+  @property({ type: Object })
+  accessor executionEnvironment: IExecutionEnvironment | null = null;
+
+  @property()
+  accessor setupCommand = '';
+
+  /**
+   * Environment variables to set in the shell
+   */
+  @property()
+  accessor environmentVariables: { [key: string]: string } = {};
+
+  /**
+   * Width of the tab bar in pixels
+   */
+  @property({ type: Number })
+  accessor tabBarWidth: number = 160;
+
+  /**
+   * Whether to show the tab bar
+   */
+  @property({ type: Boolean })
+  accessor showTabBar: boolean = true;
+
+  // Tab state
+  @state()
+  accessor tabs: ITerminalTab[] = [];
+
+  @state()
+  accessor activeTabId: string | null = null;
+
+  // Theme subscription for dynamic theme updates
+  private terminalThemeSubscription: any = null;
+  private isBright: boolean = false;
+
+  // Actionbar reference for terminal-context notifications
+  private terminalActionbar: DeesActionbar | null = null;
+
+  /**
+   * Promise that resolves when the environment is ready.
+   * @deprecated Use executionEnvironment directly
+   */
+  private environmentDeferred = new domtools.plugins.smartpromise.Deferred<IExecutionEnvironment>();
+  public environmentPromise = this.environmentDeferred.promise;
+
+  constructor() {
+    super();
+    this.tabManager = new TerminalTabManager();
+    this.resizeObserver = new ResizeObserver(() => {
+      this.handleResize();
+    });
+  }
+
+  public static styles = [
+    themeDefaultStyles,
+    cssManager.defaultStyles,
+    css`
+      :host {
+        background: ${cssManager.bdTheme('#ffffff', '#000000')};
+        position: absolute;
+        height: 100%;
+        width: 100%;
+        display: flex;
+        flex-direction: row;
+      }
+
+      * {
+        box-sizing: border-box;
+      }
+
+      .terminal-container {
+        display: flex;
+        flex-direction: row;
+        width: 100%;
+        height: 100%;
+      }
+
+      .terminal-content {
+        flex: 1;
+        display: flex;
+        flex-direction: column;
+        overflow: hidden;
+        background: ${cssManager.bdTheme('#ffffff', '#000000')};
+      }
+
+      #active-terminal-container {
+        flex: 1;
+        position: relative;
+        min-height: 0;
+        margin: 20px;
+      }
+
+      .terminal-content dees-actionbar {
+        flex-shrink: 0;
+      }
+
+      /* Tab bar on the right side */
+      .tab-bar {
+        display: flex;
+        flex-direction: column;
+        background: ${cssManager.bdTheme('hsl(0 0% 96%)', 'hsl(0 0% 7%)')};
+        border-left: 1px solid ${cssManager.bdTheme('hsl(0 0% 85%)', 'hsl(0 0% 15%)')};
+        flex-shrink: 0;
+        overflow: hidden;
+      }
+
+      .tab-bar-header {
+        display: flex;
+        align-items: center;
+        justify-content: space-between;
+        padding: 8px 10px;
+        border-bottom: 1px solid ${cssManager.bdTheme('hsl(0 0% 88%)', 'hsl(0 0% 12%)')};
+        font-size: 11px;
+        font-weight: 600;
+        text-transform: uppercase;
+        letter-spacing: 0.5px;
+        color: ${cssManager.bdTheme('hsl(0 0% 45%)', 'hsl(0 0% 55%)')};
+      }
+
+      .tab-bar-title {
+        white-space: nowrap;
+        overflow: hidden;
+        text-overflow: ellipsis;
+      }
+
+      .tab-bar-actions {
+        display: flex;
+        gap: 2px;
+      }
+
+      .tab-action {
+        width: 22px;
+        height: 22px;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        border-radius: 4px;
+        cursor: pointer;
+        color: ${cssManager.bdTheme('hsl(0 0% 50%)', 'hsl(0 0% 60%)')};
+        transition: all 0.15s ease;
+      }
+
+      .tab-action:hover {
+        background: ${cssManager.bdTheme('hsl(0 0% 88%)', 'hsl(0 0% 15%)')};
+        color: ${cssManager.bdTheme('hsl(0 0% 30%)', 'hsl(0 0% 80%)')};
+      }
+
+      .tab-list {
+        flex: 1;
+        overflow-y: auto;
+        padding: 4px;
+      }
+
+      .terminal-tab {
+        display: flex;
+        align-items: center;
+        gap: 8px;
+        padding: 8px 10px;
+        margin-bottom: 2px;
+        border-radius: 6px;
+        cursor: pointer;
+        font-size: 12px;
+        color: ${cssManager.bdTheme('hsl(0 0% 45%)', 'hsl(0 0% 60%)')};
+        transition: all 0.15s ease;
+      }
+
+      .terminal-tab:hover {
+        background: ${cssManager.bdTheme('hsl(0 0% 90%)', 'hsl(0 0% 12%)')};
+        color: ${cssManager.bdTheme('hsl(0 0% 25%)', 'hsl(0 0% 80%)')};
+      }
+
+      .terminal-tab.active {
+        background: ${cssManager.bdTheme('hsl(210 100% 95%)', 'hsl(210 30% 15%)')};
+        color: ${cssManager.bdTheme('hsl(210 100% 40%)', 'hsl(210 100% 70%)')};
+      }
+
+      .terminal-tab.exited {
+        opacity: 0.7;
+      }
+
+      .tab-icon {
+        flex-shrink: 0;
+      }
+
+      .tab-icon.running {
+        color: ${cssManager.bdTheme('hsl(142 70% 40%)', 'hsl(142 70% 55%)')};
+      }
+
+      .tab-label {
+        flex: 1;
+        overflow: hidden;
+        text-overflow: ellipsis;
+        white-space: nowrap;
+      }
+
+      .exit-badge {
+        font-size: 10px;
+        padding: 1px 5px;
+        border-radius: 8px;
+        font-weight: 600;
+        flex-shrink: 0;
+      }
+
+      .exit-badge.success {
+        background: ${cssManager.bdTheme('hsl(142 70% 90%)', 'hsl(142 30% 20%)')};
+        color: ${cssManager.bdTheme('hsl(142 70% 35%)', 'hsl(142 70% 60%)')};
+      }
+
+      .exit-badge.error {
+        background: ${cssManager.bdTheme('hsl(0 70% 93%)', 'hsl(0 30% 20%)')};
+        color: ${cssManager.bdTheme('hsl(0 70% 45%)', 'hsl(0 70% 60%)')};
+      }
+
+      .tab-close {
+        width: 18px;
+        height: 18px;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        border-radius: 4px;
+        opacity: 0;
+        transition: all 0.15s ease;
+        flex-shrink: 0;
+      }
+
+      .terminal-tab:hover .tab-close {
+        opacity: 0.6;
+      }
+
+      .tab-close:hover {
+        opacity: 1 !important;
+        background: ${cssManager.bdTheme('hsl(0 0% 85%)', 'hsl(0 0% 25%)')};
+        color: ${cssManager.bdTheme('hsl(0 70% 50%)', 'hsl(0 70% 60%)')};
+      }
+
+      .empty-state {
+        display: flex;
+        flex-direction: column;
+        align-items: center;
+        justify-content: center;
+        height: 100%;
+        color: ${cssManager.bdTheme('hsl(0 0% 50%)', 'hsl(0 0% 50%)')};
+        font-size: 13px;
+        gap: 8px;
+      }
+
+      /* xterm.js styles */
+      .xterm {
+        font-feature-settings: 'liga' 0;
+        position: relative;
+        user-select: none;
+        -ms-user-select: none;
+        -webkit-user-select: none;
+      }
+
+      .xterm.focus,
+      .xterm:focus {
+        outline: none;
+      }
+
+      .xterm .xterm-helpers {
+        position: absolute;
+        top: 0;
+        z-index: 5;
+      }
+
+      .xterm .xterm-helper-textarea {
+        padding: 0;
+        border: 0;
+        margin: 0;
+        position: absolute;
+        opacity: 0;
+        left: -9999em;
+        top: 0;
+        width: 0;
+        height: 0;
+        z-index: -5;
+        white-space: nowrap;
+        overflow: hidden;
+        resize: none;
+      }
+
+      .xterm .composition-view {
+        background: ${cssManager.bdTheme('#ffffff', '#000000')};
+        color: ${cssManager.bdTheme('#333333', '#ffffff')};
+        display: none;
+        position: absolute;
+        white-space: nowrap;
+        z-index: 1;
+      }
+
+      .xterm .composition-view.active {
+        display: block;
+      }
+
+      .xterm .xterm-viewport {
+        background-color: ${cssManager.bdTheme('#ffffff', '#000000')};
+        overflow-y: scroll;
+        cursor: default;
+        position: absolute;
+        right: 0;
+        left: 0;
+        top: 0;
+        bottom: 0;
+      }
+
+      .xterm .xterm-screen {
+        position: relative;
+      }
+
+      .xterm .xterm-screen canvas {
+        position: absolute;
+        left: 0;
+        top: 0;
+      }
+
+      .xterm .xterm-scroll-area {
+        visibility: hidden;
+      }
+
+      .xterm-char-measure-element {
+        display: inline-block;
+        visibility: hidden;
+        position: absolute;
+        top: 0;
+        left: -9999em;
+        line-height: normal;
+      }
+
+      .xterm {
+        cursor: text;
+      }
+
+      .xterm.enable-mouse-events {
+        cursor: default;
+      }
+
+      .xterm.xterm-cursor-pointer {
+        cursor: pointer;
+      }
+
+      .xterm.column-select.focus {
+        cursor: crosshair;
+      }
+
+      .xterm .xterm-accessibility,
+      .xterm .xterm-message {
+        position: absolute;
+        left: 0;
+        top: 0;
+        bottom: 0;
+        right: 0;
+        z-index: 10;
+        color: transparent;
+      }
+
+      .xterm .live-region {
+        position: absolute;
+        left: -9999px;
+        width: 1px;
+        height: 1px;
+        overflow: hidden;
+      }
+
+      .xterm-dim {
+        opacity: 0.5;
+      }
+
+      .xterm-underline {
+        text-decoration: underline;
+      }
+    `,
+  ];
+
+  public render(): TemplateResult {
+    const activeTab = this.activeTabId ? this.tabManager.getTab(this.activeTabId) : null;
+
+    return html`
+      <div class="terminal-container">
+        <!-- Main terminal area -->
+        <div class="terminal-content">
+          ${activeTab ? html`
+            <div id="active-terminal-container"></div>
+          ` : html`
+            <div class="empty-state">
+              <dees-icon .icon=${'lucide:terminal'} iconSize="32"></dees-icon>
+              <span>No terminal open</span>
+            </div>
+          `}
+          <dees-actionbar></dees-actionbar>
+        </div>
+
+        <!-- Vertical tab bar on the right -->
+        ${this.showTabBar ? html`
+          <div class="tab-bar" style="width: ${this.tabBarWidth}px">
+            <div class="tab-bar-header">
+              <span class="tab-bar-title">Terminals</span>
+              <div class="tab-bar-actions">
+                <div class="tab-action" @click=${this.handleAddTab} title="New Terminal">
+                  <dees-icon .icon=${'lucide:plus'} iconSize="14"></dees-icon>
+                </div>
+              </div>
+            </div>
+
+            <div class="tab-list">
+              ${this.tabs.map(tab => html`
+                <div
+                  class="terminal-tab ${tab.id === this.activeTabId ? 'active' : ''} ${tab.exited ? 'exited' : ''}"
+                  @click=${() => this.switchToTab(tab.id)}
+                >
+                  <dees-icon
+                    .icon=${tab.iconName}
+                    iconSize="14"
+                    class="tab-icon ${tab.process && !tab.exited ? 'running' : ''}"
+                  ></dees-icon>
+                  <span class="tab-label">${tab.label}</span>
+                  ${tab.exited ? html`
+                    <span class="exit-badge ${tab.exitCode === 0 ? 'success' : 'error'}">
+                      ${tab.exitCode}
+                    </span>
+                  ` : ''}
+                  ${tab.closeable ? html`
+                    <span class="tab-close" @click=${(e: Event) => this.handleTabClose(e, tab.id)}>
+                      <dees-icon .icon=${'lucide:x'} iconSize="12"></dees-icon>
+                    </span>
+                  ` : ''}
+                </div>
+              `)}
+            </div>
+          </div>
+        ` : ''}
+      </div>
+    `;
+  }
+
+  public async firstUpdated(): Promise<void> {
+    const domtoolsInstance = await this.domtoolsPromise;
+
+    // Get current theme
+    this.isBright = domtoolsInstance.themeManager.goBrightBoolean;
+
+    // Subscribe to theme changes
+    this.terminalThemeSubscription = domtoolsInstance.themeManager.themeObservable.subscribe(
+      (goBright: boolean) => {
+        this.isBright = goBright;
+        this.tabManager.updateAllThemes(goBright);
+      }
+    );
+
+    // Load xterm from CDN
+    const libLoader = DeesServiceLibLoader.getInstance();
+    const [xtermBundle, fitAddonBundle] = await Promise.all([
+      libLoader.loadXterm(),
+      libLoader.loadXtermFitAddon(),
+    ]);
+
+    // Initialize tab manager with loaded modules
+    this.tabManager.setXtermModules(xtermBundle, fitAddonBundle);
+
+    // Create default shell tab
+    await this.createShellTab();
+  }
+
+  async connectedCallback(): Promise<void> {
+    await super.connectedCallback();
+    // ResizeObserver is set up in attachTerminalToContainer when the container exists
+  }
+
+  async disconnectedCallback(): Promise<void> {
+    // Unobserve the terminal container
+    const container = this.shadowRoot?.getElementById('active-terminal-container');
+    if (container) {
+      this.resizeObserver.unobserve(container);
+    }
+    if (this.terminalThemeSubscription) {
+      this.terminalThemeSubscription.unsubscribe();
+      this.terminalThemeSubscription = null;
+    }
+    this.tabManager.disposeAll();
+    await super.disconnectedCallback();
+  }
+
+  // ========== Tab Management ==========
+
+  private async handleAddTab(): Promise<void> {
+    await this.createShellTab();
+  }
+
+  private handleTabClose(e: Event, tabId: string): void {
+    e.stopPropagation();
+    this.closeTab(tabId);
+  }
+
+  private switchToTab(tabId: string): void {
+    if (tabId === this.activeTabId) return;
+
+    const tab = this.tabManager.getTab(tabId);
+    if (!tab) return;
+
+    const previousTabId = this.activeTabId;
+
+    // Detach current terminal from DOM
+    if (this.activeTabId) {
+      this.detachActiveTerminal();
+    }
+
+    // Update active tab
+    this.activeTabId = tabId;
+    this.tabs = this.tabManager.getAllTabs();
+
+    // Wait for render then attach new terminal
+    this.updateComplete.then(() => {
+      this.attachTerminalToContainer(tab);
+
+      // Dispatch event
+      this.dispatchEvent(
+        new CustomEvent('tab-switched', {
+          bubbles: true,
+          composed: true,
+          detail: { tabId, previousTabId },
+        })
+      );
+    });
+  }
+
+  private detachActiveTerminal(): void {
+    const container = this.shadowRoot?.getElementById('active-terminal-container');
+    if (container) {
+      container.innerHTML = '';
+    }
+  }
+
+  private attachTerminalToContainer(tab: ITerminalTab): void {
+    const container = this.shadowRoot?.getElementById('active-terminal-container');
+    if (!container) return;
+
+    // Observe container for resize (handles actionbar appearing/disappearing)
+    // ResizeObserver.observe() is idempotent - safe to call multiple times
+    this.resizeObserver.observe(container);
+
+    // Clear container
+    container.innerHTML = '';
+
+    // Open terminal in container
+    tab.terminal.open(container);
+    tab.fitAddon.fit();
+    tab.terminal.focus();
+  }
+
+  private handleResize(): void {
+    if (this.activeTabId) {
+      const tab = this.tabManager.getTab(this.activeTabId);
+      if (tab) {
+        tab.fitAddon.fit();
+      }
+    }
+  }
+
+  // ========== Process Management ==========
+
+  private async spawnProcessForTab(
+    tab: ITerminalTab,
+    command: string,
+    args: string[] = []
+  ): Promise<void> {
+    if (!this.executionEnvironment) {
+      tab.terminal.write('\x1b[31m');
+      tab.terminal.write('❌ No execution environment available.\r\n');
+      tab.terminal.write('\x1b[0m');
+      return;
+    }
+
+    try {
+      // Initialize environment if needed
+      if (!this.executionEnvironment.ready) {
+        tab.terminal.write('Initializing environment...\r\n');
+        await this.executionEnvironment.init();
+      }
+
+      // Spawn process
+      const process = await this.executionEnvironment.spawn(command, args);
+
+      // Set up output piping
+      process.output.pipeTo(
+        new WritableStream({
+          write: (data) => {
+            tab.terminal.write(data);
+          },
+        })
+      );
+
+      // Set up input for interactive processes
+      const inputWriter = process.input.getWriter();
+      tab.terminal.onData((data) => {
+        inputWriter.write(data);
+      });
+
+      // Store process reference
+      this.tabManager.setTabProcess(tab.id, process, inputWriter);
+      this.tabs = this.tabManager.getAllTabs();
+
+      // Handle process exit
+      process.exit.then((exitCode) => {
+        this.handleProcessExit(tab.id, exitCode);
+      });
+    } catch (error) {
+      tab.terminal.write('\x1b[31m');
+      tab.terminal.write(`❌ Failed to spawn process: ${error}\r\n`);
+      tab.terminal.write('\x1b[0m');
+      console.error('Failed to spawn process:', error);
+    }
+  }
+
+  private handleProcessExit(tabId: string, exitCode: number): void {
+    const tab = this.tabManager.getTab(tabId);
+    if (!tab) return;
+
+    // Update tab state
+    this.tabManager.markTabExited(tabId, exitCode);
+
+    // Write exit message to terminal
+    const message =
+      exitCode === 0
+        ? '\r\n\x1b[32m[Process completed successfully]\x1b[0m\r\n'
+        : `\r\n\x1b[31m[Process exited with code ${exitCode}]\x1b[0m\r\n`;
+    tab.terminal.write(message);
+
+    // Update state to trigger re-render
+    this.tabs = this.tabManager.getAllTabs();
+
+    // Dispatch event
+    this.dispatchEvent(
+      new CustomEvent('process-complete', {
+        bubbles: true,
+        composed: true,
+        detail: { tabId, exitCode },
+      })
+    );
+
+    // Show actionbar to offer closing the tab (only if tab is closeable)
+    if (tab.closeable) {
+      this.showExitedTabActionbar(tabId, tab.label, exitCode);
+    }
+  }
+
+  /**
+   * Show actionbar offering to close an exited tab
+   */
+  private async showExitedTabActionbar(tabId: string, tabLabel: string, exitCode: number): Promise<void> {
+    const isSuccess = exitCode === 0;
+    const result = await this.showActionbar({
+      message: isSuccess
+        ? `"${tabLabel}" completed. Close tab?`
+        : `"${tabLabel}" exited (code ${exitCode}). Close tab?`,
+      type: isSuccess ? 'info' : 'warning',
+      icon: isSuccess ? 'lucide:checkCircle' : 'lucide:alertTriangle',
+      actions: [
+        { id: 'close', label: 'Close Tab', primary: true },
+        { id: 'keep', label: 'Keep Open' },
+      ],
+      timeout: { duration: 10000, defaultActionId: 'close' },
+      dismissible: true,
+    });
+
+    // Close tab if user clicked "Close Tab" or timeout triggered auto-close
+    if (result.actionId === 'close') {
+      this.closeTab(tabId);
+    }
+  }
+
+  // ========== Public API ==========
+
+  /**
+   * Create a new shell tab
+   */
+  public async createShellTab(label?: string): Promise<string> {
+    const tab = this.tabManager.createTab(
+      {
+        type: 'shell',
+        label: label || `bash ${this.tabManager.getTabCount() + 1}`,
+        closeable: this.tabManager.getTabCount() > 0, // First tab not closeable
+      },
+      this.isBright
+    );
+
+    this.tabs = this.tabManager.getAllTabs();
+
+    // Switch to new tab
+    this.switchToTab(tab.id);
+
+    // Wait for DOM update then spawn shell
+    await this.updateComplete;
+    await this.spawnProcessForTab(tab, 'jsh');
+
+    // Run setup command if this is the first tab
+    if (this.tabManager.getTabCount() === 1 && this.setupCommand) {
+      await this.waitForPrompt(tab.terminal, '~/');
+      if (tab.inputWriter) {
+        tab.inputWriter.write(this.setupCommand);
+      }
+    }
+
+    // Dispatch event
+    this.dispatchEvent(
+      new CustomEvent('tab-created', {
+        bubbles: true,
+        composed: true,
+        detail: { tabId: tab.id },
+      })
+    );
+
+    return tab.id;
+  }
+
+  /**
+   * Create a terminal tab for running a process
+   */
+  public async createProcessTab(options: ICreateTerminalTabOptions): Promise<string> {
+    const tab = this.tabManager.createTab(options, this.isBright);
+
+    this.tabs = this.tabManager.getAllTabs();
+
+    // Switch to new tab if requested (default: true)
+    if (options.switchToTab !== false) {
+      this.switchToTab(tab.id);
+    }
+
+    // Wait for DOM update
+    await this.updateComplete;
+
+    // Spawn process if command provided
+    if (options.command) {
+      await this.spawnProcessForTab(tab, options.command, options.args);
+    }
+
+    // Dispatch event
+    this.dispatchEvent(
+      new CustomEvent('tab-created', {
+        bubbles: true,
+        composed: true,
+        detail: { tabId: tab.id },
+      })
+    );
+
+    return tab.id;
+  }
+
+  /**
+   * Get the currently active tab
+   */
+  public getActiveTab(): ITerminalTab | null {
+    if (!this.activeTabId) return null;
+    return this.tabManager.getTab(this.activeTabId) || null;
+  }
+
+  /**
+   * Get all tabs
+   */
+  public getTabs(): ITerminalTab[] {
+    return this.tabManager.getAllTabs();
+  }
+
+  /**
+   * Switch to a specific tab by ID
+   */
+  public selectTab(tabId: string): boolean {
+    if (!this.tabManager.hasTab(tabId)) return false;
+    this.switchToTab(tabId);
+    return true;
+  }
+
+  /**
+   * Close a tab by ID
+   */
+  public closeTab(tabId: string): boolean {
+    const tab = this.tabManager.getTab(tabId);
+    if (!tab || !tab.closeable) return false;
+
+    // If closing active tab, switch to another
+    if (tabId === this.activeTabId) {
+      const allTabs = this.tabManager.getAllTabs();
+      const currentIndex = allTabs.findIndex((t) => t.id === tabId);
+      const nextTab = allTabs[currentIndex + 1] || allTabs[currentIndex - 1];
+
+      if (nextTab) {
+        this.switchToTab(nextTab.id);
+      } else {
+        this.activeTabId = null;
+        this.detachActiveTerminal();
+      }
+    }
+
+    // Close the tab
+    this.tabManager.closeTab(tabId);
+    this.tabs = this.tabManager.getAllTabs();
+
+    // Dispatch event
+    this.dispatchEvent(
+      new CustomEvent('tab-closed', {
+        bubbles: true,
+        composed: true,
+        detail: { tabId },
+      })
+    );
+
+    return true;
+  }
+
+  /**
+   * Write data to a tab's terminal
+   */
+  public writeToTab(tabId: string, data: string): boolean {
+    const tab = this.tabManager.getTab(tabId);
+    if (!tab) return false;
+    tab.terminal.write(data);
+    return true;
+  }
+
+  /**
+   * Send input to a tab's process (if interactive)
+   */
+  public sendInputToTab(tabId: string, data: string): boolean {
+    const tab = this.tabManager.getTab(tabId);
+    if (!tab || !tab.inputWriter) return false;
+    tab.inputWriter.write(data);
+    return true;
+  }
+
+  /**
+   * Show an actionbar notification in the terminal panel context.
+   * Use this for terminal-related decisions (e.g., retry failed process, kill process, etc.)
+   */
+  public async showActionbar(
+    options: Parameters<DeesActionbar['show']>[0]
+  ): Promise<ReturnType<DeesActionbar['show']>> {
+    if (!this.terminalActionbar) {
+      this.terminalActionbar = this.shadowRoot?.querySelector('dees-actionbar') as DeesActionbar;
+    }
+    return this.terminalActionbar?.show(options);
+  }
+
+  // ========== Utility Methods ==========
+
+  public async waitForPrompt(term: Terminal, prompt: string): Promise<void> {
+    return new Promise<void>((resolve) => {
+      const checkPrompt = () => {
+        const lines = term.buffer.active;
+        for (let i = 0; i < lines.length; i++) {
+          const line = lines.getLine(i);
+          if (line && line.translateToString().includes(prompt)) {
+            setTimeout(() => {
+              resolve();
+            }, 100);
+            return;
+          }
+        }
+        setTimeout(checkPrompt, 100);
+      };
+
+      checkPrompt();
+    });
+  }
+
+  public async setEnvironmentVariables(envArg: { [key: string]: string }): Promise<void> {
+    if (!this.executionEnvironment) {
+      throw new Error('No execution environment available');
+    }
+
+    let envFile = '';
+    for (const key in envArg) {
+      envFile += `export ${key}="${envArg[key]}"\n`;
+    }
+
+    await this.executionEnvironment.writeFile('/source.env', envFile);
+  }
+
+  /**
+   * Get the underlying execution environment.
+   */
+  public getExecutionEnvironment(): IExecutionEnvironment | null {
+    return this.executionEnvironment;
+  }
+}

ts_web/elements/00group-workspace/dees-workspace-terminal/index.ts

@@ -0,0 +1,3 @@
+export * from './dees-workspace-terminal.js';
+export * from './interfaces.js';
+export * from './terminal-tab-manager.js';

ts_web/elements/00group-workspace/dees-workspace-terminal/interfaces.ts

@@ -0,0 +1,126 @@
+import type { Terminal } from 'xterm';
+import type { FitAddon } from 'xterm-addon-fit';
+import type { IProcessHandle } from '../../00group-runtime/index.js';
+
+/**
+ * Type of terminal tab based on its source/purpose
+ */
+export type TTerminalTabType =
+  | 'shell'           // Default interactive shell (jsh)
+  | 'script'          // Script from package.json
+  | 'package-update'  // Package update process
+  | 'custom';         // External process from API
+
+/**
+ * Represents a single terminal tab instance
+ */
+export interface ITerminalTab {
+  /** Unique identifier for the tab */
+  id: string;
+
+  /** Display label for the tab */
+  label: string;
+
+  /** Icon name (lucide icon) */
+  iconName: string;
+
+  /** Type of terminal process */
+  type: TTerminalTabType;
+
+  /** Whether the tab can be closed */
+  closeable: boolean;
+
+  /** xterm.js Terminal instance */
+  terminal: Terminal;
+
+  /** FitAddon for this terminal */
+  fitAddon: FitAddon;
+
+  /** Process handle (if process is running) */
+  process: IProcessHandle | null;
+
+  /** Process input writer (for interactive terminals) */
+  inputWriter: WritableStreamDefaultWriter<string> | null;
+
+  /** Whether the process has exited */
+  exited: boolean;
+
+  /** Exit code (if process has exited) */
+  exitCode: number | null;
+
+  /** Timestamp when tab was created */
+  createdAt: number;
+
+  /** Optional metadata for script tabs */
+  metadata?: {
+    scriptName?: string;
+    packageName?: string;
+    command?: string;
+  };
+}
+
+/**
+ * Options for creating a new terminal tab
+ */
+export interface ICreateTerminalTabOptions {
+  /** Display label (auto-generated if not provided) */
+  label?: string;
+
+  /** Tab type */
+  type: TTerminalTabType;
+
+  /** Icon name override */
+  iconName?: string;
+
+  /** Whether the tab can be closed (default: true for non-shell) */
+  closeable?: boolean;
+
+  /** Command to spawn (default: 'jsh' for shell type) */
+  command?: string;
+
+  /** Command arguments */
+  args?: string[];
+
+  /** Additional metadata */
+  metadata?: ITerminalTab['metadata'];
+
+  /** Whether to switch to this tab after creation (default: true) */
+  switchToTab?: boolean;
+}
+
+/**
+ * Event detail for terminal tab events
+ */
+export interface ITerminalTabEventDetail {
+  tabId: string;
+}
+
+/**
+ * Event detail for tab switch events
+ */
+export interface ITerminalTabSwitchEventDetail {
+  tabId: string;
+  previousTabId: string | null;
+}
+
+/**
+ * Event detail for process completion
+ */
+export interface ITerminalProcessCompleteEventDetail {
+  tabId: string;
+  exitCode: number;
+}
+
+/**
+ * Event detail for run-process events from bottom bar
+ */
+export interface IRunProcessEventDetail {
+  type: TTerminalTabType;
+  label: string;
+  command: string;
+  args?: string[];
+  metadata?: {
+    scriptName?: string;
+    packageName?: string;
+  };
+}

ts_web/elements/00group-workspace/dees-workspace-terminal/terminal-tab-manager.ts

@@ -0,0 +1,259 @@
+import type { Terminal, ITerminalOptions } from 'xterm';
+import type { FitAddon } from 'xterm-addon-fit';
+import type { ITerminalTab, ICreateTerminalTabOptions, TTerminalTabType } from './interfaces.js';
+import type { IXtermBundle, IXtermFitAddonBundle } from '../../../services/index.js';
+
+/**
+ * Manages terminal tabs lifecycle and state
+ */
+export class TerminalTabManager {
+  private tabs: Map<string, ITerminalTab> = new Map();
+  private tabCounter: number = 0;
+  private xtermBundle: IXtermBundle | null = null;
+  private xtermFitAddonBundle: IXtermFitAddonBundle | null = null;
+
+  /**
+   * Initialize the manager with loaded xterm modules.
+   * Must be called before creating tabs.
+   */
+  public setXtermModules(xtermBundle: IXtermBundle, fitAddonBundle: IXtermFitAddonBundle): void {
+    this.xtermBundle = xtermBundle;
+    this.xtermFitAddonBundle = fitAddonBundle;
+  }
+
+  /**
+   * Generate unique tab ID
+   */
+  private generateTabId(): string {
+    this.tabCounter++;
+    return `terminal-${this.tabCounter}-${Date.now()}`;
+  }
+
+  /**
+   * Get default label for tab type
+   */
+  private getDefaultLabel(type: TTerminalTabType, metadata?: ITerminalTab['metadata']): string {
+    switch (type) {
+      case 'shell':
+        return 'bash';
+      case 'script':
+        return metadata?.scriptName || 'script';
+      case 'package-update':
+        return metadata?.packageName ? `update ${metadata.packageName}` : 'update';
+      case 'custom':
+        return metadata?.command || 'process';
+      default:
+        return 'terminal';
+    }
+  }
+
+  /**
+   * Get default icon for tab type
+   */
+  private getDefaultIcon(type: TTerminalTabType): string {
+    switch (type) {
+      case 'shell':
+        return 'lucide:terminal';
+      case 'script':
+        return 'lucide:play';
+      case 'package-update':
+        return 'lucide:packageCheck';
+      case 'custom':
+        return 'lucide:code';
+      default:
+        return 'lucide:terminal';
+    }
+  }
+
+  /**
+   * Get terminal theme configuration
+   */
+  private getTerminalTheme(isBright: boolean): any {
+    if (isBright) {
+      return {
+        background: '#ffffff',
+        foreground: '#333333',
+        cursor: '#333333',
+        cursorAccent: '#ffffff',
+        selection: 'rgba(0, 0, 0, 0.2)',
+        black: '#000000',
+        red: '#cd3131',
+        green: '#00bc00',
+        yellow: '#949800',
+        blue: '#0451a5',
+        magenta: '#bc05bc',
+        cyan: '#0598bc',
+        white: '#555555',
+        brightBlack: '#666666',
+        brightRed: '#cd3131',
+        brightGreen: '#14ce14',
+        brightYellow: '#b5ba00',
+        brightBlue: '#0451a5',
+        brightMagenta: '#bc05bc',
+        brightCyan: '#0598bc',
+        brightWhite: '#a5a5a5',
+      };
+    } else {
+      return {
+        background: '#000000',
+        foreground: '#ffffff',
+        cursor: '#ffffff',
+        cursorAccent: '#000000',
+        selection: 'rgba(255, 255, 255, 0.2)',
+      };
+    }
+  }
+
+  /**
+   * Create a new tab instance
+   */
+  createTab(options: ICreateTerminalTabOptions, isBright: boolean): ITerminalTab {
+    if (!this.xtermBundle || !this.xtermFitAddonBundle) {
+      throw new Error('TerminalTabManager: xterm modules not initialized. Call setXtermModules() first.');
+    }
+
+    const id = this.generateTabId();
+    const type = options.type;
+
+    // Create xterm.js Terminal instance using CDN-loaded module
+    const terminal = new this.xtermBundle.Terminal({
+      convertEol: true,
+      cursorBlink: true,
+      theme: this.getTerminalTheme(isBright),
+      fontFamily: 'Menlo, Monaco, "Courier New", monospace',
+      fontSize: 13,
+      lineHeight: 1.2,
+    });
+
+    // Create FitAddon using CDN-loaded module
+    const fitAddon = new this.xtermFitAddonBundle.FitAddon();
+    terminal.loadAddon(fitAddon);
+
+    const tab: ITerminalTab = {
+      id,
+      label: options.label || this.getDefaultLabel(type, options.metadata),
+      iconName: options.iconName || this.getDefaultIcon(type),
+      type,
+      closeable: options.closeable ?? (type !== 'shell'),
+      terminal,
+      fitAddon,
+      process: null,
+      inputWriter: null,
+      exited: false,
+      exitCode: null,
+      createdAt: Date.now(),
+      metadata: options.metadata,
+    };
+
+    this.tabs.set(id, tab);
+    return tab;
+  }
+
+  /**
+   * Get tab by ID
+   */
+  getTab(id: string): ITerminalTab | undefined {
+    return this.tabs.get(id);
+  }
+
+  /**
+   * Get all tabs as array (ordered by creation time)
+   */
+  getAllTabs(): ITerminalTab[] {
+    return Array.from(this.tabs.values()).sort((a, b) => a.createdAt - b.createdAt);
+  }
+
+  /**
+   * Get the number of tabs
+   */
+  getTabCount(): number {
+    return this.tabs.size;
+  }
+
+  /**
+   * Check if tab exists
+   */
+  hasTab(id: string): boolean {
+    return this.tabs.has(id);
+  }
+
+  /**
+   * Close and cleanup a tab
+   */
+  closeTab(id: string): boolean {
+    const tab = this.tabs.get(id);
+    if (!tab) return false;
+
+    // Kill process if still running
+    if (tab.process && !tab.exited) {
+      try {
+        tab.process.kill();
+      } catch (e) {
+        console.warn('Failed to kill process:', e);
+      }
+    }
+
+    // Dispose terminal
+    try {
+      tab.terminal.dispose();
+    } catch (e) {
+      console.warn('Failed to dispose terminal:', e);
+    }
+
+    this.tabs.delete(id);
+    return true;
+  }
+
+  /**
+   * Rename a tab
+   */
+  renameTab(id: string, newLabel: string): boolean {
+    const tab = this.tabs.get(id);
+    if (!tab) return false;
+
+    tab.label = newLabel;
+    return true;
+  }
+
+  /**
+   * Update tab process state to exited
+   */
+  markTabExited(id: string, exitCode: number): void {
+    const tab = this.tabs.get(id);
+    if (!tab) return;
+
+    tab.exited = true;
+    tab.exitCode = exitCode;
+  }
+
+  /**
+   * Set process for a tab
+   */
+  setTabProcess(id: string, process: ITerminalTab['process'], inputWriter: ITerminalTab['inputWriter']): void {
+    const tab = this.tabs.get(id);
+    if (!tab) return;
+
+    tab.process = process;
+    tab.inputWriter = inputWriter;
+  }
+
+  /**
+   * Update theme for all terminals
+   */
+  updateAllThemes(isBright: boolean): void {
+    const theme = this.getTerminalTheme(isBright);
+    for (const tab of this.tabs.values()) {
+      tab.terminal.options.theme = theme;
+    }
+  }
+
+  /**
+   * Dispose all tabs and cleanup
+   */
+  disposeAll(): void {
+    for (const [id] of this.tabs) {
+      this.closeTab(id);
+    }
+    this.tabs.clear();
+  }
+}

ts_web/elements/00group-workspace/dees-workspace/index.ts

@@ -0,0 +1,2 @@
+export * from './dees-workspace.js';
+export * from './typescript-intellisense.js';

ts_web/elements/00group-workspace/dees-workspace/typescript-intellisense.ts

@@ -0,0 +1,453 @@
+import type * as monaco from 'monaco-editor';
+import type { IExecutionEnvironment } from '../../00group-runtime/index.js';
+
+// Monaco TypeScript API types (runtime API still exists, types deprecated in 0.55+)
+interface IExtraLibDisposable {
+  dispose(): void;
+}
+
+interface IMonacoTypeScriptAPI {
+  typescriptDefaults: {
+    setCompilerOptions(options: Record<string, unknown>): void;
+    setDiagnosticsOptions(options: Record<string, unknown>): void;
+    addExtraLib(content: string, filePath?: string): IExtraLibDisposable;
+    setEagerModelSync(value: boolean): void;
+  };
+  ScriptTarget: { ES2020: number };
+  ModuleKind: { ESNext: number };
+  ModuleResolutionKind: { NodeJs: number; Bundler?: number };
+}
+
+/**
+ * Manages TypeScript IntelliSense by loading type definitions
+ * from the virtual filesystem into Monaco.
+ */
+export class TypeScriptIntelliSenseManager {
+  private loadedLibs: Set<string> = new Set();
+  private notFoundPackages: Set<string> = new Set(); // Packages checked but not found
+  private monacoInstance: typeof monaco | null = null;
+  private executionEnvironment: IExecutionEnvironment | null = null;
+
+  // Cache of file contents for synchronous access and module resolution
+  private fileCache: Map<string, string> = new Map();
+
+  // Track extra libs added for cleanup
+  private addedExtraLibs: Map<string, IExtraLibDisposable> = new Map();
+
+  /**
+   * Get TypeScript API with proper typing for Monaco 0.55+
+   */
+  private get tsApi(): IMonacoTypeScriptAPI | null {
+    if (!this.monacoInstance) return null;
+    return (this.monacoInstance.languages as any).typescript as IMonacoTypeScriptAPI;
+  }
+
+  /**
+   * Initialize with Monaco and execution environment
+   */
+  public async init(
+    monacoInst: typeof monaco,
+    env: IExecutionEnvironment
+  ): Promise<void> {
+    this.monacoInstance = monacoInst;
+    this.executionEnvironment = env;
+    this.configureCompilerOptions();
+    // Load all project TypeScript/JavaScript files into Monaco for cross-file resolution
+    await this.loadAllProjectFiles();
+  }
+
+  /**
+   * Recursively load all .ts/.js files from the virtual filesystem into Monaco
+   */
+  private async loadAllProjectFiles(): Promise<void> {
+    if (!this.executionEnvironment) return;
+    await this.loadFilesFromDirectory('/');
+  }
+
+  /**
+   * Recursively load files from a directory
+   */
+  private async loadFilesFromDirectory(dirPath: string): Promise<void> {
+    if (!this.executionEnvironment) return;
+
+    try {
+      const entries = await this.executionEnvironment.readDir(dirPath);
+
+      for (const entry of entries) {
+        const fullPath = dirPath === '/' ? `/${entry.name}` : `${dirPath}/${entry.name}`;
+
+        // Skip node_modules - too large and handled separately via addExtraLib
+        if (entry.name === 'node_modules') continue;
+
+        if (entry.type === 'directory') {
+          await this.loadFilesFromDirectory(fullPath);
+        } else if (entry.type === 'file') {
+          const ext = entry.name.split('.').pop()?.toLowerCase();
+          if (ext === 'ts' || ext === 'tsx' || ext === 'js' || ext === 'jsx') {
+            try {
+              const content = await this.executionEnvironment.readFile(fullPath);
+              this.addFileModel(fullPath, content);
+            } catch {
+              // Ignore files that can't be read
+            }
+          }
+        }
+      }
+    } catch {
+      // Directory might not exist or not be readable
+    }
+  }
+
+  private configureCompilerOptions(): void {
+    const ts = this.tsApi;
+    if (!ts) return;
+
+    ts.typescriptDefaults.setCompilerOptions({
+      target: ts.ScriptTarget.ES2020,
+      module: ts.ModuleKind.ESNext,
+      // Use Bundler resolution if available (Monaco 0.45+), fallback to NodeJs
+      moduleResolution: ts.ModuleResolutionKind.Bundler ?? ts.ModuleResolutionKind.NodeJs,
+      allowSyntheticDefaultImports: true,
+      esModuleInterop: true,
+      strict: true,
+      noEmit: true,
+      allowJs: true,
+      checkJs: false,
+      allowNonTsExtensions: true,
+      lib: ['es2020', 'dom', 'dom.iterable'],
+      // Set baseUrl to root for resolving absolute imports
+      baseUrl: '/',
+      // Allow importing .ts extensions directly (useful for some setups)
+      allowImportingTsExtensions: true,
+      // Resolve JSON modules
+      resolveJsonModule: true,
+    });
+
+    ts.typescriptDefaults.setDiagnosticsOptions({
+      noSemanticValidation: false,
+      noSyntaxValidation: false,
+    });
+
+    // Enable eager model sync so TypeScript immediately processes all models
+    // This is critical for cross-file IntelliSense to work without requiring edits
+    ts.typescriptDefaults.setEagerModelSync(true);
+  }
+
+  /**
+   * Parse imports from TypeScript/JavaScript content
+   */
+  public parseImports(content: string): string[] {
+    const imports: string[] = [];
+
+    // Match ES6 imports: import { x } from 'package' or import 'package'
+    const importRegex = /import\s+(?:[\w*{}\s,]+from\s+)?['"]([^'"]+)['"]/g;
+    let match: RegExpExecArray | null;
+
+    while ((match = importRegex.exec(content)) !== null) {
+      const importPath = match[1];
+      // Only process non-relative imports (npm packages)
+      if (!importPath.startsWith('.') && !importPath.startsWith('/')) {
+        const packageName = importPath.startsWith('@')
+          ? importPath.split('/').slice(0, 2).join('/') // @scope/package
+          : importPath.split('/')[0]; // package
+        imports.push(packageName);
+      }
+    }
+
+    // Match require calls: require('package')
+    const requireRegex = /require\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
+    while ((match = requireRegex.exec(content)) !== null) {
+      const importPath = match[1];
+      if (!importPath.startsWith('.') && !importPath.startsWith('/')) {
+        const packageName = importPath.startsWith('@')
+          ? importPath.split('/').slice(0, 2).join('/')
+          : importPath.split('/')[0];
+        imports.push(packageName);
+      }
+    }
+
+    return [...new Set(imports)];
+  }
+
+  /**
+   * Load type definitions for a package from virtual FS
+   */
+  public async loadTypesForPackage(packageName: string): Promise<void> {
+    if (!this.monacoInstance || !this.executionEnvironment) return;
+    if (this.loadedLibs.has(packageName)) return;
+    if (this.notFoundPackages.has(packageName)) return; // Skip packages we already checked
+
+    try {
+      let typesLoaded = await this.tryLoadPackageTypes(packageName);
+      if (!typesLoaded) {
+        typesLoaded = await this.tryLoadAtTypesPackage(packageName);
+      }
+      if (typesLoaded) {
+        this.loadedLibs.add(packageName);
+      } else {
+        // Cache that this package wasn't found to avoid repeated filesystem checks
+        this.notFoundPackages.add(packageName);
+      }
+    } catch (error) {
+      console.warn(`Failed to load types for ${packageName}:`, error);
+    }
+  }
+
+  private async tryLoadPackageTypes(packageName: string): Promise<boolean> {
+    const ts = this.tsApi;
+    if (!this.executionEnvironment || !ts) return false;
+
+    const basePath = `/node_modules/${packageName}`;
+
+    try {
+      // Check package.json for types field
+      const packageJsonPath = `${basePath}/package.json`;
+      const packageJsonExists = await this.executionEnvironment.exists(packageJsonPath);
+
+      if (packageJsonExists) {
+        const packageJsonContent = await this.executionEnvironment.readFile(packageJsonPath);
+        const packageJson = JSON.parse(packageJsonContent);
+
+        // Add package.json to Monaco so TypeScript can resolve the types field
+        ts.typescriptDefaults.addExtraLib(packageJsonContent, `file://${packageJsonPath}`);
+
+        const typesPath = packageJson.types || packageJson.typings;
+        if (typesPath) {
+          // Load all .d.ts files from the package, not just the entry point
+          // Modern packages often have multiple declaration files with imports
+          await this.loadAllDtsFilesFromPackage(basePath);
+          return true;
+        }
+      }
+
+      // Try common locations - if any exist, load all .d.ts files
+      const commonPaths = [
+        `${basePath}/index.d.ts`,
+        `${basePath}/dist/index.d.ts`,
+        `${basePath}/lib/index.d.ts`,
+      ];
+
+      for (const dtsPath of commonPaths) {
+        if (await this.executionEnvironment.exists(dtsPath)) {
+          await this.loadAllDtsFilesFromPackage(basePath);
+          return true;
+        }
+      }
+
+      return false;
+    } catch (error) {
+      console.error(`Failed to load package types for ${packageName}:`, error);
+      return false;
+    }
+  }
+
+  /**
+   * Recursively load all .d.ts files from a package directory
+   */
+  private async loadAllDtsFilesFromPackage(basePath: string): Promise<void> {
+    const ts = this.tsApi;
+    if (!this.executionEnvironment || !ts) return;
+
+    await this.loadDtsFilesFromDirectory(basePath);
+  }
+
+  /**
+   * Recursively load .d.ts files from a directory
+   */
+  private async loadDtsFilesFromDirectory(dirPath: string): Promise<void> {
+    const ts = this.tsApi;
+    if (!this.executionEnvironment || !ts) return;
+
+    try {
+      const entries = await this.executionEnvironment.readDir(dirPath);
+
+      for (const entry of entries) {
+        const fullPath = dirPath === '/' ? `/${entry.name}` : `${dirPath}/${entry.name}`;
+
+        // Skip nested node_modules (shouldn't happen in a package but be safe)
+        if (entry.name === 'node_modules') continue;
+
+        if (entry.type === 'directory') {
+          await this.loadDtsFilesFromDirectory(fullPath);
+        } else if (entry.type === 'file' && entry.name.endsWith('.d.ts')) {
+          try {
+            const content = await this.executionEnvironment.readFile(fullPath);
+            ts.typescriptDefaults.addExtraLib(content, `file://${fullPath}`);
+          } catch {
+            // Ignore files that can't be read
+          }
+        }
+      }
+    } catch {
+      // Directory might not be readable
+    }
+  }
+
+  private async tryLoadAtTypesPackage(packageName: string): Promise<boolean> {
+    if (!this.executionEnvironment) return false;
+
+    // Handle scoped packages: @scope/package -> @types/scope__package
+    const typesPackageName = packageName.startsWith('@')
+      ? `@types/${packageName.slice(1).replace('/', '__')}`
+      : `@types/${packageName}`;
+
+    const basePath = `/node_modules/${typesPackageName}`;
+
+    try {
+      const indexPath = `${basePath}/index.d.ts`;
+      if (await this.executionEnvironment.exists(indexPath)) {
+        // Load all .d.ts files from the @types package
+        await this.loadAllDtsFilesFromPackage(basePath);
+        return true;
+      }
+      return false;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * Process content change and load types for any new imports
+   */
+  public async processContentChange(content: string): Promise<void> {
+    const imports = this.parseImports(content);
+
+    for (const packageName of imports) {
+      if (!this.loadedLibs.has(packageName)) {
+        await this.loadTypesForPackage(packageName);
+      }
+    }
+  }
+
+  /**
+   * Scan node_modules for packages and load types for any not yet loaded.
+   * Called when node_modules changes (e.g., after pnpm install).
+   */
+  public async scanAndLoadNewPackageTypes(): Promise<void> {
+    if (!this.executionEnvironment) return;
+
+    // Clear not-found cache so newly installed packages can be detected
+    this.notFoundPackages.clear();
+
+    try {
+      // Check if node_modules exists
+      if (!await this.executionEnvironment.exists('/node_modules')) return;
+
+      // Read top-level node_modules
+      const entries = await this.executionEnvironment.readDir('/node_modules');
+
+      for (const entry of entries) {
+        if (entry.type !== 'directory') continue;
+
+        if (entry.name.startsWith('@')) {
+          // Scoped package - read subdirectories
+          try {
+            const scopedPath = `/node_modules/${entry.name}`;
+            const scopedEntries = await this.executionEnvironment.readDir(scopedPath);
+            for (const scopedEntry of scopedEntries) {
+              if (scopedEntry.type === 'directory') {
+                const packageName = `${entry.name}/${scopedEntry.name}`;
+                await this.loadTypesForPackage(packageName);
+              }
+            }
+          } catch {
+            // Skip if we can't read scoped directory
+          }
+        } else if (!entry.name.startsWith('.')) {
+          // Regular package
+          await this.loadTypesForPackage(entry.name);
+        }
+      }
+    } catch (error) {
+      console.warn('Failed to scan node_modules:', error);
+    }
+  }
+
+  /**
+   * Add a file model to Monaco for cross-file IntelliSense
+   * Also registers the file with TypeScript via addExtraLib for module resolution
+   */
+  public addFileModel(path: string, content: string): void {
+    if (!this.monacoInstance) return;
+
+    // Cache the content for sync access
+    this.fileCache.set(path, content);
+
+    // Create/update the editor model
+    const uri = this.monacoInstance.Uri.parse(`file://${path}`);
+    const existingModel = this.monacoInstance.editor.getModel(uri);
+
+    if (existingModel) {
+      // Only update if content actually changed (prevents cursor reset)
+      if (existingModel.getValue() !== content) {
+        existingModel.setValue(content);
+      }
+    } else {
+      const language = this.getLanguageFromPath(path);
+      this.monacoInstance.editor.createModel(content, language, uri);
+    }
+
+    // Also add as extra lib for TypeScript module resolution
+    // This is critical - TypeScript's resolver uses extra libs, not editor models
+    this.addFileAsExtraLib(path, content);
+  }
+
+  /**
+   * Add a file as an extra lib for TypeScript module resolution.
+   * This enables TypeScript to resolve imports to project files.
+   */
+  private addFileAsExtraLib(path: string, content: string): void {
+    const ts = this.tsApi;
+    if (!ts) return;
+
+    // Dispose existing lib if present (for updates)
+    const existing = this.addedExtraLibs.get(path);
+    if (existing) {
+      existing.dispose();
+    }
+
+    // Add the file with its actual path
+    const filePath = `file://${path}`;
+    const disposable = ts.typescriptDefaults.addExtraLib(content, filePath);
+    this.addedExtraLibs.set(path, disposable);
+
+    // For .ts files, also add with .js extension to handle ESM imports
+    // (e.g., import from './utils.js' should resolve to ./utils.ts)
+    if (path.endsWith('.ts') && !path.endsWith('.d.ts')) {
+      const jsPath = path.replace(/\.ts$/, '.js');
+      const jsFilePath = `file://${jsPath}`;
+      const jsDisposable = ts.typescriptDefaults.addExtraLib(content, jsFilePath);
+      this.addedExtraLibs.set(jsPath, jsDisposable);
+      this.fileCache.set(jsPath, content);
+    } else if (path.endsWith('.tsx')) {
+      const jsxPath = path.replace(/\.tsx$/, '.jsx');
+      const jsxFilePath = `file://${jsxPath}`;
+      const jsxDisposable = ts.typescriptDefaults.addExtraLib(content, jsxFilePath);
+      this.addedExtraLibs.set(jsxPath, jsxDisposable);
+      this.fileCache.set(jsxPath, content);
+    }
+  }
+
+  /**
+   * Get cached file content for synchronous access
+   */
+  public getFileContent(path: string): string | undefined {
+    return this.fileCache.get(path);
+  }
+
+  private getLanguageFromPath(path: string): string {
+    const ext = path.split('.').pop()?.toLowerCase();
+    switch (ext) {
+      case 'ts':
+      case 'tsx':
+        return 'typescript';
+      case 'js':
+      case 'jsx':
+        return 'javascript';
+      case 'json':
+        return 'json';
+      default:
+        return 'plaintext';
+    }
+  }
+}

ts_web/elements/00group-workspace/index.ts

@@ -0,0 +1,10 @@
+// Workspace Components
+export * from './dees-workspace/index.js';
+export * from './dees-workspace-monaco/index.js';
+export * from './dees-workspace-filetree/index.js';
+export * from './dees-workspace-terminal/index.js';
+export * from './dees-workspace-terminal-preview/index.js';
+export * from './dees-workspace-markdown/index.js';
+export * from './dees-workspace-markdownoutlet/index.js';
+export * from './dees-workspace-bottombar/index.js';
+export * from './dees-workspace-diff-editor/index.js';

ts_web/elements/dees-actionbar/actionbar.interfaces.ts

@@ -0,0 +1,54 @@
+/**
+ * Action button configuration for the action bar
+ */
+export interface IActionBarAction {
+  /** Unique identifier for the action */
+  id: string;
+  /** Button label text */
+  label: string;
+  /** Primary action gets highlighted styling and receives timeout trigger */
+  primary?: boolean;
+  /** Lucide icon name (optional) */
+  icon?: string;
+}
+
+/**
+ * Configuration options for showing an action bar
+ */
+export interface IActionBarOptions {
+  /** Message text to display */
+  message: string;
+  /** Lucide icon name for the message (optional) */
+  icon?: string;
+  /** Visual type affects coloring */
+  type?: 'info' | 'warning' | 'error' | 'question';
+  /** Action buttons to display */
+  actions: IActionBarAction[];
+  /** Timeout configuration (optional) */
+  timeout?: {
+    /** Duration in milliseconds before auto-triggering default action */
+    duration: number;
+    /** ID of the action to auto-trigger when timeout expires */
+    defaultActionId: string;
+  };
+  /** Whether to show a dismiss (X) button */
+  dismissible?: boolean;
+}
+
+/**
+ * Result returned when an action bar is resolved
+ */
+export interface IActionBarResult {
+  /** ID of the action that was triggered */
+  actionId: string;
+  /** Whether the action was triggered by timeout (true) or user click (false) */
+  timedOut: boolean;
+}
+
+/**
+ * Internal queue item for pending action bars
+ */
+export interface IActionBarQueueItem {
+  options: IActionBarOptions;
+  resolve: (result: IActionBarResult) => void;
+}

ts_web/elements/dees-actionbar/dees-actionbar.ts

@@ -0,0 +1,514 @@
+import {
+  customElement,
+  DeesElement,
+  type TemplateResult,
+  html,
+  css,
+  state,
+  cssManager,
+} from '@design.estate/dees-element';
+import { themeDefaultStyles } from '../00theme.js';
+import '../dees-icon/dees-icon.js';
+import type {
+  IActionBarOptions,
+  IActionBarResult,
+  IActionBarQueueItem,
+  IActionBarAction,
+} from './actionbar.interfaces.js';
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'dees-actionbar': DeesActionbar;
+  }
+}
+
+@customElement('dees-actionbar')
+export class DeesActionbar extends DeesElement {
+  // STATIC
+  public static demo = () => {
+    const getActionbar = (e: Event) => {
+      const button = e.currentTarget as HTMLElement;
+      const container = button.closest('.demo-container');
+      return container?.querySelector('dees-actionbar') as DeesActionbar | null;
+    };
+
+    const showActionBar = async (e: Event) => {
+      const actionbar = getActionbar(e);
+      if (!actionbar) return;
+      const result = await actionbar.show({
+        message: 'File changed externally. Reload?',
+        type: 'warning',
+        icon: 'lucide:alertTriangle',
+        actions: [
+          { id: 'reload', label: 'Reload', primary: true },
+          { id: 'ignore', label: 'Ignore' },
+        ],
+        timeout: { duration: 5000, defaultActionId: 'reload' },
+        dismissible: true,
+      });
+      console.log('Action bar result:', result);
+    };
+
+    const showErrorBar = async (e: Event) => {
+      const actionbar = getActionbar(e);
+      if (!actionbar) return;
+      const result = await actionbar.show({
+        message: 'Process failed with exit code 1',
+        type: 'error',
+        icon: 'lucide:xCircle',
+        actions: [
+          { id: 'retry', label: 'Retry', primary: true },
+          { id: 'dismiss', label: 'Dismiss' },
+        ],
+        timeout: { duration: 10000, defaultActionId: 'dismiss' },
+      });
+      console.log('Error bar result:', result);
+    };
+
+    const showQuestionBar = async (e: Event) => {
+      const actionbar = getActionbar(e);
+      if (!actionbar) return;
+      const result = await actionbar.show({
+        message: 'Save changes before closing?',
+        type: 'question',
+        icon: 'lucide:helpCircle',
+        actions: [
+          { id: 'save', label: 'Save', primary: true },
+          { id: 'discard', label: 'Discard' },
+          { id: 'cancel', label: 'Cancel' },
+        ],
+      });
+      console.log('Question bar result:', result);
+    };
+
+    return html`
+      <style>
+        .demo-container {
+          display: flex;
+          flex-direction: column;
+          height: 300px;
+          border: 1px solid #333;
+          border-radius: 8px;
+          overflow: hidden;
+        }
+        .demo-content {
+          flex: 1;
+          padding: 16px;
+          display: flex;
+          gap: 8px;
+          align-items: flex-start;
+        }
+      </style>
+      <div class="demo-container">
+        <div class="demo-content">
+          <dees-button @click=${showActionBar}>Warning</dees-button>
+          <dees-button @click=${showErrorBar}>Error</dees-button>
+          <dees-button @click=${showQuestionBar}>Question</dees-button>
+        </div>
+        <dees-actionbar></dees-actionbar>
+      </div>
+    `;
+  };
+
+  // Queue of pending action bars
+  private queue: IActionBarQueueItem[] = [];
+
+  // Current active bar state
+  @state() accessor currentBar: IActionBarOptions | null = null;
+  @state() accessor timeRemaining: number = 0;
+  @state() accessor progressPercent: number = 100;
+  @state() accessor isVisible: boolean = false;
+
+  // Timeout handling
+  private timeoutInterval: ReturnType<typeof setInterval> | null = null;
+  private currentResolve: ((result: IActionBarResult) => void) | null = null;
+
+  public static styles = [
+    themeDefaultStyles,
+    cssManager.defaultStyles,
+    css`
+      :host {
+        display: block;
+      }
+
+      .actionbar-item {
+        display: grid;
+        grid-template-rows: 0fr;
+        transition: grid-template-rows 0.2s ease-out;
+        background: ${cssManager.bdTheme('hsl(0 0% 96%)', 'hsl(0 0% 12%)')};
+        border-top: 1px solid ${cssManager.bdTheme('hsl(0 0% 88%)', 'hsl(0 0% 20%)')};
+      }
+
+      :host(.visible) .actionbar-item {
+        grid-template-rows: 1fr;
+      }
+
+      .actionbar-content {
+        overflow: hidden;
+        min-height: 0;
+        opacity: 0;
+        transition: opacity 0.2s ease-out;
+      }
+
+      :host(.visible) .actionbar-content {
+        opacity: 1;
+      }
+
+      .progress-bar {
+        height: 3px;
+        background: ${cssManager.bdTheme('hsl(0 0% 90%)', 'hsl(0 0% 18%)')};
+        overflow: hidden;
+      }
+
+      .progress-bar-fill {
+        height: 100%;
+        background: ${cssManager.bdTheme('hsl(210 100% 50%)', 'hsl(210 100% 60%)')};
+        transition: width 0.1s linear;
+      }
+
+      .progress-bar-fill.warning {
+        background: ${cssManager.bdTheme('hsl(38 92% 50%)', 'hsl(38 92% 55%)')};
+      }
+
+      .progress-bar-fill.error {
+        background: ${cssManager.bdTheme('hsl(0 70% 50%)', 'hsl(0 70% 55%)')};
+      }
+
+      .progress-bar-fill.question {
+        background: ${cssManager.bdTheme('hsl(270 70% 50%)', 'hsl(270 70% 60%)')};
+      }
+
+      .content {
+        display: flex;
+        align-items: center;
+        padding: 8px 12px;
+        gap: 12px;
+        min-height: 32px;
+      }
+
+      .message-section {
+        display: flex;
+        align-items: center;
+        gap: 8px;
+        flex: 1;
+        min-width: 0;
+      }
+
+      .message-icon {
+        flex-shrink: 0;
+        color: ${cssManager.bdTheme('hsl(0 0% 40%)', 'hsl(0 0% 60%)')};
+      }
+
+      .message-icon.info {
+        color: ${cssManager.bdTheme('hsl(210 100% 45%)', 'hsl(210 100% 60%)')};
+      }
+
+      .message-icon.warning {
+        color: ${cssManager.bdTheme('hsl(38 92% 45%)', 'hsl(38 92% 55%)')};
+      }
+
+      .message-icon.error {
+        color: ${cssManager.bdTheme('hsl(0 70% 50%)', 'hsl(0 70% 55%)')};
+      }
+
+      .message-icon.question {
+        color: ${cssManager.bdTheme('hsl(270 70% 50%)', 'hsl(270 70% 60%)')};
+      }
+
+      .message-text {
+        font-size: 13px;
+        color: ${cssManager.bdTheme('hsl(0 0% 20%)', 'hsl(0 0% 85%)')};
+        white-space: nowrap;
+        overflow: hidden;
+        text-overflow: ellipsis;
+      }
+
+      .actions-section {
+        display: flex;
+        align-items: center;
+        gap: 8px;
+        flex-shrink: 0;
+      }
+
+      .action-button {
+        display: flex;
+        align-items: center;
+        gap: 4px;
+        padding: 4px 10px;
+        border-radius: 4px;
+        font-size: 12px;
+        font-weight: 500;
+        cursor: pointer;
+        border: 1px solid transparent;
+        transition: all 0.15s ease;
+        white-space: nowrap;
+      }
+
+      .action-button.secondary {
+        background: transparent;
+        color: ${cssManager.bdTheme('hsl(0 0% 30%)', 'hsl(0 0% 70%)')};
+        border-color: ${cssManager.bdTheme('hsl(0 0% 80%)', 'hsl(0 0% 30%)')};
+      }
+
+      .action-button.secondary:hover {
+        background: ${cssManager.bdTheme('hsl(0 0% 92%)', 'hsl(0 0% 18%)')};
+      }
+
+      .action-button.primary {
+        background: ${cssManager.bdTheme('hsl(210 100% 50%)', 'hsl(210 100% 55%)')};
+        color: white;
+      }
+
+      .action-button.primary:hover {
+        background: ${cssManager.bdTheme('hsl(210 100% 45%)', 'hsl(210 100% 50%)')};
+      }
+
+      .action-button.primary.warning {
+        background: ${cssManager.bdTheme('hsl(38 92% 45%)', 'hsl(38 92% 50%)')};
+      }
+
+      .action-button.primary.warning:hover {
+        background: ${cssManager.bdTheme('hsl(38 92% 40%)', 'hsl(38 92% 45%)')};
+      }
+
+      .action-button.primary.error {
+        background: ${cssManager.bdTheme('hsl(0 70% 50%)', 'hsl(0 70% 55%)')};
+      }
+
+      .action-button.primary.error:hover {
+        background: ${cssManager.bdTheme('hsl(0 70% 45%)', 'hsl(0 70% 50%)')};
+      }
+
+      .action-button.primary.question {
+        background: ${cssManager.bdTheme('hsl(270 70% 50%)', 'hsl(270 70% 55%)')};
+      }
+
+      .action-button.primary.question:hover {
+        background: ${cssManager.bdTheme('hsl(270 70% 45%)', 'hsl(270 70% 50%)')};
+      }
+
+      .countdown {
+        font-size: 11px;
+        opacity: 0.8;
+        margin-left: 2px;
+      }
+
+      .dismiss-button {
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        width: 20px;
+        height: 20px;
+        border-radius: 4px;
+        cursor: pointer;
+        color: ${cssManager.bdTheme('hsl(0 0% 50%)', 'hsl(0 0% 50%)')};
+        transition: all 0.15s ease;
+      }
+
+      .dismiss-button:hover {
+        background: ${cssManager.bdTheme('hsl(0 0% 88%)', 'hsl(0 0% 22%)')};
+        color: ${cssManager.bdTheme('hsl(0 0% 30%)', 'hsl(0 0% 70%)')};
+      }
+    `,
+  ];
+
+  public render(): TemplateResult {
+    const bar = this.currentBar;
+    const type = bar?.type || 'info';
+    const hasTimeout = bar?.timeout && this.timeRemaining > 0;
+
+    // ALWAYS render wrapper - required for grid animation to work
+    return html`
+      <div class="actionbar-item">
+        <div class="actionbar-content">
+          ${bar ? html`
+            ${hasTimeout ? html`
+              <div class="progress-bar">
+                <div
+                  class="progress-bar-fill ${type}"
+                  style="width: ${this.progressPercent}%"
+                ></div>
+              </div>
+            ` : ''}
+            <div class="content">
+              <div class="message-section">
+                ${bar.icon ? html`
+                  <dees-icon
+                    class="message-icon ${type}"
+                    .icon=${bar.icon}
+                    iconSize="16"
+                  ></dees-icon>
+                ` : ''}
+                <span class="message-text">${bar.message}</span>
+              </div>
+              <div class="actions-section">
+                ${bar.actions.map(action => this.renderActionButton(action, bar, hasTimeout))}
+                ${bar.dismissible ? html`
+                  <div
+                    class="dismiss-button"
+                    @click=${() => this.handleDismiss()}
+                    title="Dismiss"
+                  >
+                    <dees-icon .icon=${'lucide:x'} iconSize="14"></dees-icon>
+                  </div>
+                ` : ''}
+              </div>
+            </div>
+          ` : ''}
+        </div>
+      </div>
+    `;
+  }
+
+  private renderActionButton(
+    action: IActionBarAction,
+    bar: IActionBarOptions,
+    hasTimeout: boolean | undefined
+  ): TemplateResult {
+    const isPrimary = action.primary;
+    const type = bar.type || 'info';
+    const isDefaultAction = bar.timeout?.defaultActionId === action.id;
+    const showCountdown = hasTimeout && isDefaultAction;
+    const seconds = Math.ceil(this.timeRemaining / 1000);
+
+    return html`
+      <button
+        class="action-button ${isPrimary ? `primary ${type}` : 'secondary'}"
+        @click=${() => this.handleAction(action.id, false)}
+      >
+        ${action.icon ? html`
+          <dees-icon .icon=${action.icon} iconSize="12"></dees-icon>
+        ` : ''}
+        <span>${action.label}</span>
+        ${showCountdown ? html`
+          <span class="countdown">(${seconds}s)</span>
+        ` : ''}
+      </button>
+    `;
+  }
+
+  // ========== Public API ==========
+
+  /**
+   * Show an action bar with the given options.
+   * Returns a promise that resolves when an action is taken.
+   */
+  public async show(options: IActionBarOptions): Promise<IActionBarResult> {
+    return new Promise((resolve) => {
+      // Add to queue
+      this.queue.push({ options, resolve });
+
+      // If no current bar, process queue
+      if (!this.currentBar) {
+        this.processQueue();
+      }
+    });
+  }
+
+  /**
+   * Dismiss the current action bar without triggering any action.
+   */
+  public dismiss(): void {
+    this.handleDismiss();
+  }
+
+  /**
+   * Clear all pending action bars in the queue.
+   */
+  public clearQueue(): void {
+    // Resolve all queued items with dismiss
+    for (const item of this.queue) {
+      item.resolve({ actionId: 'dismissed', timedOut: false });
+    }
+    this.queue = [];
+  }
+
+  // ========== Private Methods ==========
+
+  /**
+   * Hide the current actionbar with animation.
+   * Removes visible class first to trigger CSS transition, then clears content after animation.
+   */
+  private async hideCurrentBar(): Promise<void> {
+    // Remove visible class to start close animation
+    this.classList.remove('visible');
+    this.isVisible = false;
+
+    // Wait for animation to complete (200ms transition + buffer)
+    await new Promise(resolve => setTimeout(resolve, 220));
+
+    // Now safe to clear content
+    this.currentBar = null;
+    this.currentResolve = null;
+  }
+
+  private async processQueue(): Promise<void> {
+    if (this.queue.length === 0) {
+      // Hide with animation - don't await, let it run async
+      this.hideCurrentBar();
+      return;
+    }
+
+    const item = this.queue.shift()!;
+    this.currentBar = item.options;
+    this.currentResolve = item.resolve;
+    this.isVisible = true;
+
+    // Wait for Lit render, then add class on next frame to trigger animation
+    await this.updateComplete;
+    requestAnimationFrame(() => {
+      this.classList.add('visible');
+    });
+
+    // Setup timeout if configured
+    if (item.options.timeout) {
+      this.startTimeout(item.options.timeout.duration, item.options.timeout.defaultActionId);
+    }
+  }
+
+  private startTimeout(duration: number, defaultActionId: string): void {
+    this.timeRemaining = duration;
+    this.progressPercent = 100;
+
+    const startTime = Date.now();
+    const updateInterval = 50; // Update every 50ms for smooth animation
+
+    this.timeoutInterval = setInterval(() => {
+      const elapsed = Date.now() - startTime;
+      this.timeRemaining = Math.max(0, duration - elapsed);
+      this.progressPercent = (this.timeRemaining / duration) * 100;
+
+      if (this.timeRemaining <= 0) {
+        this.clearTimeoutInterval();
+        this.handleAction(defaultActionId, true);
+      }
+    }, updateInterval);
+  }
+
+  private clearTimeoutInterval(): void {
+    if (this.timeoutInterval) {
+      clearInterval(this.timeoutInterval);
+      this.timeoutInterval = null;
+    }
+  }
+
+  private handleAction(actionId: string, timedOut: boolean): void {
+    this.clearTimeoutInterval();
+
+    if (this.currentResolve) {
+      this.currentResolve({ actionId, timedOut });
+    }
+
+    // Process next item in queue
+    this.processQueue();
+  }
+
+  private handleDismiss(): void {
+    this.handleAction('dismissed', false);
+  }
+
+  public async disconnectedCallback(): Promise<void> {
+    await super.disconnectedCallback();
+    this.clearTimeoutInterval();
+  }
+}

ts_web/elements/dees-actionbar/index.ts

@@ -0,0 +1,2 @@
+export * from './dees-actionbar.js';
+export * from './actionbar.interfaces.js';