Compare commits

..

31 Commits

Author SHA1 Message Date
c41268cd4e v3.28.0
Some checks failed
Default (tags) / security (push) Failing after 17s
Default (tags) / test (push) Failing after 12s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-01-02 21:40:49 +00:00
30ebc47eda feat(dees-appui): Rename DeesAppuiBase to DeesAppui and migrate related API, exports, demos and docs 2026-01-02 21:40:49 +00:00
3b137c43a8 v3.27.1
Some checks failed
Default (tags) / security (push) Failing after 16s
Default (tags) / test (push) Failing after 12s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-01-01 21:33:30 +00:00
87fb3d91c3 fix(dees-actionbar): always render actionbar wrapper and delay adding visible class to ensure grid/opacity animations run reliably 2026-01-01 21:33:30 +00:00
8d6bd20321 v3.27.0
Some checks failed
Default (tags) / security (push) Failing after 14s
Default (tags) / test (push) Failing after 15s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-01-01 20:25:05 +00:00
d7f3594dd4 feat(services): introduce DeesServiceLibLoader to lazy-load heavy client libraries from CDN and update components to use it 2026-01-01 20:25:05 +00:00
2a6457e192 v3.26.1
Some checks failed
Default (tags) / security (push) Failing after 15s
Default (tags) / test (push) Failing after 15s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-01-01 19:59:53 +00:00
979e1f7991 fix(dees-actionbar): animate actionbar hide using grid-template-rows and wait for animation before clearing state 2026-01-01 19:59:53 +00:00
bbb57f1b9f update 2026-01-01 18:33:05 +00:00
a218b6a0a1 v3.26.0
Some checks failed
Default (tags) / security (push) Failing after 14s
Default (tags) / test (push) Failing after 15s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-01-01 11:32:01 +00:00
a20d9ff138 feat(workspace): add external file change detection, conflict resolution UI, and diff editor 2026-01-01 11:32:01 +00:00
3a7c2fe781 v3.25.0
Some checks failed
Default (tags) / security (push) Failing after 14s
Default (tags) / test (push) Failing after 15s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-01-01 10:20:22 +00:00
22156d71dc feat(dees-actionbar): add action bar component and improve workspace package update handling 2026-01-01 10:20:22 +00:00
dce557d85b v3.24.0
Some checks failed
Default (tags) / security (push) Failing after 15s
Default (tags) / test (push) Failing after 16s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-01-01 08:09:30 +00:00
829c09a97b feat(workspace): add workspace bottom bar, terminal tab manager, and run-process integration 2026-01-01 08:09:30 +00:00
fc2661fb4c v3.23.0
Some checks failed
Default (tags) / security (push) Failing after 16s
Default (tags) / test (push) Failing after 11s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2025-12-31 18:24:10 +00:00
deb50dfde2 feat(workspace): add resizable file tree and terminal panes with draggable handles and public layout APIs 2025-12-31 18:24:10 +00:00
7ac0ac8b0a v3.22.0
Some checks failed
Default (tags) / security (push) Failing after 16s
Default (tags) / test (push) Failing after 11s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2025-12-31 17:03:27 +00:00
9fa48e511c feat(workspace): add resizable markdown editor/preview split with draggable handle and markdown outlet styling/demo 2025-12-31 17:03:27 +00:00
11c88f9749 v3.21.0
Some checks failed
Default (tags) / security (push) Failing after 13s
Default (tags) / test (push) Failing after 15s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2025-12-31 14:01:42 +00:00
d0bd4027bb feat(terminal): add dynamic bright/dark theming for terminal components and terminal preview 2025-12-31 14:01:42 +00:00
62de004350 v3.20.1
Some checks failed
Default (tags) / security (push) Failing after 17s
Default (tags) / test (push) Failing after 14s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2025-12-31 12:45:19 +00:00
cfe3490bcf fix(dees-workspace): fix demo wrapper and workspace layout; always render terminal preview 2025-12-31 12:45:19 +00:00
826689ec0e v3.20.0
Some checks failed
Default (tags) / security (push) Failing after 18s
Default (tags) / test (push) Failing after 16s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2025-12-31 12:37:14 +00:00
15bca09086 feat(workspace): rename editor components to workspace group and move terminal & TypeScript intellisense into workspace 2025-12-31 12:37:14 +00:00
08b302bd46 v3.19.1
Some checks failed
Default (tags) / security (push) Failing after 14s
Default (tags) / test (push) Failing after 14s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2025-12-31 11:02:58 +00:00
747a67d790 fix(intellisense): Debounce TypeScript/JavaScript IntelliSense processing and cache missing packages to reduce work and noisy logs 2025-12-31 11:02:58 +00:00
6ec05d6b4a v3.19.0
Some checks failed
Default (tags) / security (push) Failing after 14s
Default (tags) / test (push) Failing after 14s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2025-12-31 09:47:38 +00:00
77df2743c5 feat(dees-editor-workspace): improve TypeScript IntelliSense, auto-run workspace init commands, and watch node_modules for new packages 2025-12-31 09:47:38 +00:00
e4bdde1373 v3.18.0
Some checks failed
Default (tags) / security (push) Failing after 14s
Default (tags) / test (push) Failing after 14s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2025-12-31 08:53:01 +00:00
e193e28fe9 feat(filetree): add filesystem watch support to WebContainer environment and auto-refresh file tree; improve icon handling and context menu behavior 2025-12-31 08:53:01 +00:00
83 changed files with 7058 additions and 1897 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 76 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 89 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 89 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 88 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 72 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 74 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 74 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 58 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 56 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 56 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 59 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 74 KiB

View File

@@ -1,5 +1,146 @@
# Changelog
## 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

View File

@@ -1,6 +1,6 @@
{
"name": "@design.estate/dees-catalog",
"version": "3.17.0",
"version": "3.28.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,7 +32,7 @@
"@tiptap/extension-underline": "^2.23.0",
"@tiptap/starter-kit": "^2.23.0",
"@tsclass/tsclass": "^9.3.0",
"@webcontainer/api": "1.6.1",
"@tempfix/webcontainer__api": "1.6.1",
"apexcharts": "^5.3.6",
"highlight.js": "11.11.1",
"ibantools": "^4.5.1",

16
pnpm-lock.yaml generated
View File

@@ -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.6.1
version: 1.6.1
apexcharts:
specifier: ^5.3.6
version: 5.3.6
@@ -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:
@@ -1760,9 +1763,6 @@ packages:
'@webcontainer/api@1.2.0':
resolution: {integrity: sha512-tzoKBd4lLdhHy5GHFpUkl+ndoSba8JqmB7x0ZQFnWfjbcbQOvKQfxA8MEMUYhgqjWHnbrWdAfnBEHz5f5lYG5A==}
'@webcontainer/api@1.6.1':
resolution: {integrity: sha512-2RS2KiIw32BY1Icf6M1DvqSmcon9XICZCDgS29QJb2NmF12ZY2V5Ia+949hMKB3Wno+P/Y8W+sPP59PZeXSELg==}
'@yr/monotone-cubic-spline@1.0.3':
resolution: {integrity: sha512-FQXkOta0XBSUPHndIKON2Y9JeQz5ZeMqLYZVVK93FliNBFm7LNMIZmY6FrMEB9XPcDbE2bekMbZD6kzDkxwYjA==}
@@ -6466,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
@@ -6814,8 +6816,6 @@ snapshots:
'@webcontainer/api@1.2.0': {}
'@webcontainer/api@1.6.1': {}
'@yr/monotone-cubic-spline@1.0.3': {}
accepts@1.3.8:

View File

@@ -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>
`;
```

View File

@@ -54,7 +54,7 @@ For developers working on this library, please refer to the [UI Components Playb
|----------|------------|
| **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) |
| **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) |
@@ -615,23 +615,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 +648,7 @@ class MyApp extends DeesElement {
}
render() {
return html`<dees-appui-base></dees-appui-base>`;
return html`<dees-appui></dees-appui>`;
}
}
```

View File

@@ -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', '00group-editor', 'dees-editor-monaco');
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;
}

View File

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

View File

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

View File

@@ -1,5 +1,5 @@
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 '@design.estate/dees-wcctools/demotools';
@@ -197,7 +197,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;
@@ -619,7 +619,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

View File

@@ -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;
// ==========================================
@@ -278,7 +278,7 @@ export class DeesAppuiBase extends DeesElement {
this.activitylogElement = this.shadowRoot!.querySelector('dees-appui-activitylog') as DeesAppuiActivitylog;
// 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() {

View File

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

View File

@@ -1,4 +1,4 @@
# DeesAppuiBase
# DeesAppui
A comprehensive application shell component providing a complete UI framework with navigation, menus, activity logging, and view management.
@@ -6,14 +6,14 @@ A comprehensive application shell component providing a complete UI framework wi
```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,7 +30,7 @@ class MyApp extends DeesElement {
}
render() {
return html`<dees-appui-base></dees-appui-base>`;
return html`<dees-appui></dees-appui>`;
}
}
```
@@ -329,7 +329,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 +421,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 +494,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;

View File

@@ -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;
}

View File

@@ -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';

View File

@@ -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 {
@@ -150,7 +151,10 @@ 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

View File

@@ -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;
}
}

View File

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

View File

@@ -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);
})
}
}

View File

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

View File

@@ -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;
}
}

View File

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

View File

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

View File

@@ -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';

View File

@@ -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');

View File

@@ -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 }) => {

View File

@@ -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
@@ -18,8 +19,9 @@ import { PROGRAMMING_LANGUAGES } from '../../wysiwyg.constants.js';
*/
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,28 +308,33 @@ 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);
// Get plain text content
const content = editor.textContent || '';
const language = block.metadata?.language || 'typescript';
// 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
if (result.value) {
editor.innerHTML = result.value;
// Restore cursor position if editor is focused
if (document.activeElement === editor && cursorPos !== null) {
requestAnimationFrame(() => {

View File

@@ -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> {

View File

@@ -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 ============
/**

View File

@@ -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) {
@@ -401,10 +401,10 @@ export class DeesSimpleAppDash extends DeesElement {
await this.closeTerminal();
return;
}
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)`;

View File

@@ -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();
}
}

View File

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

View File

@@ -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;
}
}
}

View File

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

View File

@@ -10,7 +10,7 @@ import {
} 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 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';
@@ -20,7 +20,7 @@ import { DeesInputText } from '../../00group-input/dees-input-text/dees-input-te
declare global {
interface HTMLElementTagNameMap {
'dees-editor-filetree': DeesEditorFiletree;
'dees-workspace-filetree': DeesWorkspaceFiletree;
}
}
@@ -30,11 +30,11 @@ interface ITreeNode extends IFileEntry {
level: number;
}
@customElement('dees-editor-filetree')
export class DeesEditorFiletree extends DeesElement {
@customElement('dees-workspace-filetree')
export class DeesWorkspaceFiletree extends DeesElement {
public static demo = () => html`
<div style="width: 300px; height: 400px; position: relative;">
<dees-editor-filetree></dees-editor-filetree>
<dees-workspace-filetree></dees-workspace-filetree>
</div>
`;
@@ -60,6 +60,15 @@ export class DeesEditorFiletree extends DeesElement {
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,
@@ -239,6 +248,7 @@ export class DeesEditorFiletree extends DeesElement {
display: flex;
align-items: center;
justify-content: center;
color: ${cssManager.bdTheme('hsl(0 0% 30%)', 'hsl(0 0% 70%)')};
}
.toolbar-button:hover {
@@ -439,26 +449,58 @@ export class DeesEditorFiletree extends DeesElement {
const menuItems = [];
if (node.type === 'directory') {
// Directory-specific options
menuItems.push(
{
name: 'New File',
iconName: 'lucide:filePlus',
iconName: 'filePlus',
action: async () => this.createNewFile(node.path),
},
{
name: 'New Folder',
iconName: 'lucide:folderPlus',
iconName: 'folderPlus',
action: async () => this.createNewFolder(node.path),
},
{ name: 'divider' }
{ divider: true }
);
}
menuItems.push({
name: 'Delete',
iconName: 'lucide:trash2',
action: async () => this.deleteItem(node),
});
// 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);
}
@@ -471,38 +513,48 @@ export class DeesEditorFiletree extends DeesElement {
e.preventDefault();
e.stopPropagation();
const menuItems = [
const menuItems: any[] = [
{
name: 'New File',
iconName: 'lucide:filePlus',
iconName: 'filePlus',
action: async () => this.createNewFile('/'),
},
{
name: 'New Folder',
iconName: 'lucide:folderPlus',
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) => {
let inputValue = '';
const modal = await DeesModal.createAndShow({
heading: options.heading,
width: 'small',
content: html`
<dees-input-text
.label=${options.label}
@changeSubject=${(e: CustomEvent) => {
inputValue = (e.target as DeesInputText).value;
}}
.value=${options.value || ''}
></dees-input-text>
`,
menuOptions: [
@@ -514,10 +566,15 @@ export class DeesEditorFiletree extends DeesElement {
},
},
{
name: 'Create',
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.trim() || null);
resolve(inputValue || null);
},
},
],
@@ -603,13 +660,225 @@ export class DeesEditorFiletree extends DeesElement {
}
}
/**
* 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') && this.executionEnvironment) {
await this.loadTree();
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;
}
}

View File

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

View File

@@ -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;
}
}

View File

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

View File

@@ -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>
`;

View File

@@ -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;
}
}

View File

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

View File

@@ -15,14 +15,14 @@ import type * as monaco from 'monaco-editor';
declare global {
interface HTMLElementTagNameMap {
'dees-editor-monaco': DeesEditorMonaco;
'dees-workspace-monaco': DeesWorkspaceMonaco;
}
}
@customElement('dees-editor-monaco')
export class DeesEditorMonaco extends DeesElement {
@customElement('dees-workspace-monaco')
export class DeesWorkspaceMonaco extends DeesElement {
// DEMO
public static demo = () => html`<dees-editor-monaco></dees-editor-monaco>`;
public static demo = () => html`<dees-workspace-monaco></dees-workspace-monaco>`;
// STATIC
public static monacoDeferred: ReturnType<typeof domtools.plugins.smartpromise.defer>;
@@ -98,17 +98,17 @@ export class DeesEditorMonaco extends DeesElement {
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();
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 = () => {
DeesEditorMonaco.monacoDeferred.resolve();
DeesWorkspaceMonaco.monacoDeferred.resolve();
};
document.head.appendChild(script);
}
await DeesEditorMonaco.monacoDeferred.promise;
await DeesWorkspaceMonaco.monacoDeferred.promise;
(window as any).require.config({
paths: { vs: `${monacoCdnBase}/min/vs` },
@@ -242,4 +242,53 @@ export class DeesEditorMonaco extends DeesElement {
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 });
}
}
}

View File

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

View File

@@ -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();
}
}
}

View File

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

View File

@@ -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;
}
}

View File

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

View File

@@ -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;
};
}

View File

@@ -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();
}
}

File diff suppressed because it is too large Load Diff

View File

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

View File

@@ -24,6 +24,7 @@ interface IMonacoTypeScriptAPI {
*/
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;
@@ -174,13 +175,19 @@ export class TypeScriptIntelliSenseManager {
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 {
const typesLoaded = await this.tryLoadPackageTypes(packageName);
let typesLoaded = await this.tryLoadPackageTypes(packageName);
if (!typesLoaded) {
await this.tryLoadAtTypesPackage(packageName);
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);
}
this.loadedLibs.add(packageName);
} catch (error) {
console.warn(`Failed to load types for ${packageName}:`, error);
}
@@ -195,26 +202,25 @@ export class TypeScriptIntelliSenseManager {
try {
// Check package.json for types field
const packageJsonPath = `${basePath}/package.json`;
if (await this.executionEnvironment.exists(packageJsonPath)) {
const packageJson = JSON.parse(
await this.executionEnvironment.readFile(packageJsonPath)
);
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) {
const fullTypesPath = `${basePath}/${typesPath}`;
if (await this.executionEnvironment.exists(fullTypesPath)) {
const content = await this.executionEnvironment.readFile(fullTypesPath);
ts.typescriptDefaults.addExtraLib(
content,
`file://${fullTypesPath}`
);
return true;
}
// 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
// Try common locations - if any exist, load all .d.ts files
const commonPaths = [
`${basePath}/index.d.ts`,
`${basePath}/dist/index.d.ts`,
@@ -223,24 +229,62 @@ export class TypeScriptIntelliSenseManager {
for (const dtsPath of commonPaths) {
if (await this.executionEnvironment.exists(dtsPath)) {
const content = await this.executionEnvironment.readFile(dtsPath);
ts.typescriptDefaults.addExtraLib(
content,
`file://${dtsPath}`
);
await this.loadAllDtsFilesFromPackage(basePath);
return true;
}
}
return false;
} catch {
} catch (error) {
console.error(`Failed to load package types for ${packageName}:`, error);
return false;
}
}
private async tryLoadAtTypesPackage(packageName: string): Promise<boolean> {
/**
* 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 false;
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('@')
@@ -252,11 +296,8 @@ export class TypeScriptIntelliSenseManager {
try {
const indexPath = `${basePath}/index.d.ts`;
if (await this.executionEnvironment.exists(indexPath)) {
const content = await this.executionEnvironment.readFile(indexPath);
ts.typescriptDefaults.addExtraLib(
content,
`file://${indexPath}`
);
// Load all .d.ts files from the @types package
await this.loadAllDtsFilesFromPackage(basePath);
return true;
}
return false;
@@ -270,8 +311,55 @@ export class TypeScriptIntelliSenseManager {
*/
public async processContentChange(content: string): Promise<void> {
const imports = this.parseImports(content);
for (const packageName of imports) {
await this.loadTypesForPackage(packageName);
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);
}
}
@@ -290,7 +378,10 @@ export class TypeScriptIntelliSenseManager {
const existingModel = this.monacoInstance.editor.getModel(uri);
if (existingModel) {
existingModel.setValue(content);
// 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);

View File

@@ -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';

View File

@@ -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;
}

View File

@@ -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();
}
}

View File

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

View File

@@ -246,7 +246,7 @@ export class DeesContextmenu extends DeesElement {
@mouseleave=${() => this.handleMenuItemLeave()}
>
${menuItem.iconName ? html`
<dees-icon .icon="${`lucide:${menuItem.iconName}`}"></dees-icon>
<dees-icon .icon="${menuItem.iconName}"></dees-icon>
` : ''}
<span class="menuitem-text">${menuItem.name}</span>
${menuItem.shortcut && !hasSubmenu ? html`
@@ -436,8 +436,9 @@ export class DeesContextmenu extends DeesElement {
}
// Only destroy window layer if this is not a submenu
// Don't await - let cleanup happen in background for instant visual feedback
if (this.windowLayer && !this.parentMenu) {
await this.windowLayer.destroy();
this.windowLayer.destroy();
}
this.style.opacity = '0';

View File

@@ -268,9 +268,9 @@ export class DeesIcon extends DeesElement {
name: iconStr.substring(7) // Remove 'lucide:' prefix
};
} else {
// For backward compatibility, assume FontAwesome if no prefix
// Default to Lucide when no prefix is provided
return {
type: 'fa',
type: 'lucide',
name: iconStr
};
}

View File

@@ -1,434 +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 { Terminal } from 'xterm';
import { FitAddon } from 'xterm-addon-fit';
import { themeDefaultStyles } from '../00theme.js';
import type { IExecutionEnvironment } from '../00group-runtime/index.js';
import { WebContainerEnvironment } from '../00group-runtime/index.js';
declare global {
interface HTMLElementTagNameMap {
'dees-terminal': DeesTerminal;
}
}
@customElement('dees-terminal')
export class DeesTerminal extends DeesElement {
public static demo = () => {
const env = new WebContainerEnvironment();
return html`<dees-terminal .executionEnvironment=${env}></dees-terminal>`;
};
// INSTANCE
private resizeObserver: ResizeObserver;
/**
* The execution environment (required).
* Use WebContainerEnvironment for browser-based execution.
*/
@property({ type: Object })
accessor executionEnvironment: IExecutionEnvironment | null = null;
@property()
accessor setupCommand = `pnpm install @serve.zone/cli && servezone cli\n`;
/**
* Environment variables to set in the shell
*/
@property()
accessor environmentVariables: { [key: string]: string } = {};
@property()
accessor background: string = '#000000';
/**
* 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.resizeObserver = new ResizeObserver((entries) => {
for (const entry of entries) {
// Handle the resize event
console.log(`Terminal Resized`);
this.handleResize();
}
});
}
public static styles = [
themeDefaultStyles,
cssManager.defaultStyles,
css`
/* TODO: Migrate hardcoded values to --dees-* CSS variables */
:host {
padding: 20px;
background: var(--dees-terminal-background, #000000);
position: absolute;
height: 100%;
width: 100%;
}
* {
box-sizing: border-box;
}
#container {
position: absolute;
height: calc(100% - 40px);
width: calc(100% - 40px);
}
/**
* Copyright (c) 2014 The xterm.js authors. All rights reserved.
* Copyright (c) 2012-2013, Christopher Jeffrey (MIT License)
* https://github.com/chjj/term.js
* @license MIT
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*
* Originally forked from (with the author's permission):
* Fabrice Bellard's javascript vt100 for jslinux:
* http://bellard.org/jslinux/
* Copyright (c) 2011 Fabrice Bellard
* The original design remains. The terminal itself
* has been extended to include xterm CSI codes, among
* other features.
*/
/**
* Default styles for xterm.js
*/
.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;
/**
* The z-index of the helpers must be higher than the canvases in order for
* IMEs to appear on top.
*/
z-index: 5;
}
.xterm .xterm-helper-textarea {
padding: 0;
border: 0;
margin: 0;
/* Move textarea out of the screen to the far left, so that the cursor is not visible */
position: absolute;
opacity: 0;
left: -9999em;
top: 0;
width: 0;
height: 0;
z-index: -5;
/** Prevent wrapping so the IME appears against the textarea at the correct position */
white-space: nowrap;
overflow: hidden;
resize: none;
}
.xterm .composition-view {
/* TODO: Composition position got messed up somewhere */
background: var(--dees-terminal-background, #000000);
color: #fff;
display: none;
position: absolute;
white-space: nowrap;
z-index: 1;
}
.xterm .composition-view.active {
display: block;
}
.xterm .xterm-viewport {
/* On OS X this is required in order for the scroll bar to appear fully opaque */
background-color: var(--dees-terminal-background, #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 {
/* When mouse events are enabled (eg. tmux), revert to the standard pointer cursor */
cursor: default;
}
.xterm.xterm-cursor-pointer {
cursor: pointer;
}
.xterm.column-select.focus {
/* Column selection mode */
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 {
return html`
<div class="mainbox">
<div id="container"></div>
</div>
`;
}
private fitAddon: FitAddon;
private terminal: Terminal | null = null;
public async firstUpdated(
_changedProperties: Map<string | number | symbol, unknown>
): Promise<void> {
const domtools = await this.domtoolsPromise;
super.firstUpdated(_changedProperties);
// Sync CSS variable with background property
this.style.setProperty('--dees-terminal-background', this.background);
const container = this.shadowRoot.getElementById('container');
const term = new Terminal({
convertEol: true,
cursorBlink: true,
theme: {
background: this.background,
},
});
this.terminal = term;
this.fitAddon = new FitAddon();
term.loadAddon(this.fitAddon);
// Open the terminal in #terminal-container
term.open(container);
// Make the terminal's size and geometry fit the size of #terminal-container
this.fitAddon.fit();
// Check if execution environment is provided
if (!this.executionEnvironment) {
term.write('\x1b[31m'); // Red color
term.write('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n');
term.write(' ❌ No execution environment provided.\r\n');
term.write('\r\n');
term.write(' Pass an IExecutionEnvironment via the\r\n');
term.write(' \'executionEnvironment\' property.\r\n');
term.write('\r\n');
term.write(' Example:\r\n');
term.write(' const env = new WebContainerEnvironment();\r\n');
term.write(' <dees-terminal .executionEnvironment=${env}>\r\n');
term.write('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n');
term.write('\x1b[0m'); // Reset color
return;
}
term.write('Initializing execution environment...\r\n');
// Initialize the execution environment
try {
await this.executionEnvironment.init();
term.write('Environment ready. Starting shell...\r\n');
} catch (error) {
term.write('\x1b[31m'); // Red color
term.write(`\r\n❌ Failed to initialize environment: ${error}\r\n`);
term.write('\x1b[0m'); // Reset color
console.error('Failed to initialize execution environment:', error);
return;
}
// Spawn shell process
let shellProcess;
try {
shellProcess = await this.executionEnvironment.spawn('jsh');
} catch (error) {
term.write('\x1b[31m'); // Red color
term.write(`\r\n❌ Failed to spawn shell: ${error}\r\n`);
term.write('\x1b[0m'); // Reset color
console.error('Failed to spawn shell:', error);
return;
}
shellProcess.output.pipeTo(
new WritableStream({
write(data) {
term.write(data);
},
})
);
const input = shellProcess.input.getWriter();
term.onData((data) => {
input.write(data);
});
await this.waitForPrompt(term, '~/');
// Set environment variables if provided
if (Object.keys(this.environmentVariables).length > 0) {
await this.setEnvironmentVariables(this.environmentVariables);
input.write(`source source.env\n`);
await this.waitForPrompt(term, '~/');
}
// Run setup command if provided
if (this.setupCommand) {
input.write(this.setupCommand);
await this.waitForPrompt(term, '~/');
}
input.write(`clear && echo 'Terminal ready.'\n`);
this.environmentDeferred.resolve(this.executionEnvironment);
}
async connectedCallback(): Promise<void> {
await super.connectedCallback();
this.resizeObserver.observe(this);
}
async disconnectedCallback(): Promise<void> {
this.resizeObserver.unobserve(this);
await super.disconnectedCallback();
}
handleResize() {
this.fitAddon.fit();
}
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); // check every 100 ms
};
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`;
}
// Write the environment file using the filesystem API
await this.executionEnvironment.writeFile('/source.env', envFile);
}
/**
* Get the underlying execution environment.
* Useful for advanced operations like filesystem access.
*/
public getExecutionEnvironment(): IExecutionEnvironment | null {
return this.executionEnvironment;
}
}

View File

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

View File

@@ -6,7 +6,7 @@ export * from './00group-appui/index.js';
export * from './00group-button/index.js';
export * from './00group-chart/index.js';
export * from './00group-dataview/index.js';
export * from './00group-editor/index.js';
export * from './00group-workspace/index.js';
export * from './00group-form/index.js';
export * from './00group-input/index.js';
export * from './00group-pdf/index.js';
@@ -14,6 +14,7 @@ export * from './00group-runtime/index.js';
export * from './00group-simple/index.js';
// Standalone Components
export * from './dees-actionbar/index.js';
export * from './dees-badge/index.js';
export * from './dees-chips/index.js';
export * from './dees-contextmenu/index.js';
@@ -34,7 +35,7 @@ export * from './dees-spinner/index.js';
export * from './dees-statsgrid/index.js';
export * from './dees-stepper/index.js';
export * from './dees-table/index.js';
export * from './dees-terminal/index.js';
// dees-terminal is now part of 00group-workspace as dees-workspace-terminal
export * from './dees-toast/index.js';
export * from './dees-updater/index.js';
export * from './dees-windowcontrols/index.js';

View File

@@ -4,7 +4,7 @@ import type { IMenuItem } from './tab.js';
import type { IMenuGroup } from './menugroup.js';
// Forward declaration for circular reference
export type TDeesAppuiBase = HTMLElement & {
export type TDeesAppui = HTMLElement & {
setAppBarMenus: (menus: IAppBarMenuItem[]) => void;
updateAppBarMenu: (name: string, update: Partial<IAppBarMenuItem>) => void;
setBreadcrumbs: (breadcrumbs: string | string[]) => void;
@@ -92,8 +92,8 @@ export interface IActivityLogAPI {
* View activation context passed to onActivate lifecycle hook
*/
export interface IViewActivationContext {
/** Reference to the DeesAppuiBase instance */
appui: TDeesAppuiBase;
/** Reference to the DeesAppui instance */
appui: TDeesAppui;
/** The view ID being activated */
viewId: string;
/** Route parameters if any */
@@ -208,7 +208,7 @@ export interface IActivityLogConfig {
}
/**
* Main unified configuration interface for dees-appui-base
* Main unified configuration interface for dees-appui
*/
export interface IAppConfig {
/** Application branding */

View File

@@ -0,0 +1,285 @@
import { CDN_BASE, CDN_VERSIONS } from './versions.js';
// Type imports (no runtime overhead)
import type { Terminal, ITerminalOptions } from 'xterm';
import type { FitAddon } from 'xterm-addon-fit';
import type { HLJSApi } from 'highlight.js';
import type ApexChartsType from 'apexcharts';
import type { Editor, EditorOptions } from '@tiptap/core';
import type { StarterKitOptions } from '@tiptap/starter-kit';
import type { UnderlineOptions } from '@tiptap/extension-underline';
import type { TextAlignOptions } from '@tiptap/extension-text-align';
import type { LinkOptions } from '@tiptap/extension-link';
/**
* Bundle type for xterm and its addons
*/
export interface IXtermBundle {
Terminal: typeof Terminal;
}
/**
* Bundle type for xterm-addon-fit
*/
export interface IXtermFitAddonBundle {
FitAddon: typeof FitAddon;
}
/**
* Bundle type for Tiptap editor and extensions
*/
export interface ITiptapBundle {
Editor: typeof Editor;
StarterKit: { configure: (options?: Partial<StarterKitOptions>) => any };
Underline: { configure: (options?: Partial<UnderlineOptions>) => any };
TextAlign: { configure: (options?: Partial<TextAlignOptions>) => any };
Link: { configure: (options?: Partial<LinkOptions>) => any };
Typography: { configure: (options?: any) => any };
}
/**
* Singleton service for lazy-loading heavy libraries from CDN.
*
* This reduces initial bundle size by loading libraries only when needed.
* Libraries are cached after first load to avoid duplicate fetches.
*
* @example
* ```typescript
* const libLoader = DeesServiceLibLoader.getInstance();
* const xterm = await libLoader.loadXterm();
* const terminal = new xterm.Terminal({ ... });
* ```
*/
export class DeesServiceLibLoader {
private static instance: DeesServiceLibLoader;
// Cached library references
private xtermLib: IXtermBundle | null = null;
private xtermFitAddonLib: IXtermFitAddonBundle | null = null;
private highlightJsLib: HLJSApi | null = null;
private apexChartsLib: typeof ApexChartsType | null = null;
private tiptapLib: ITiptapBundle | null = null;
// Loading promises to prevent duplicate concurrent loads
private xtermLoadingPromise: Promise<IXtermBundle> | null = null;
private xtermFitAddonLoadingPromise: Promise<IXtermFitAddonBundle> | null = null;
private highlightJsLoadingPromise: Promise<HLJSApi> | null = null;
private apexChartsLoadingPromise: Promise<typeof ApexChartsType> | null = null;
private tiptapLoadingPromise: Promise<ITiptapBundle> | null = null;
private constructor() {}
/**
* Get the singleton instance of DeesServiceLibLoader
*/
public static getInstance(): DeesServiceLibLoader {
if (!DeesServiceLibLoader.instance) {
DeesServiceLibLoader.instance = new DeesServiceLibLoader();
}
return DeesServiceLibLoader.instance;
}
/**
* Load xterm terminal emulator from CDN
* @returns Promise resolving to xterm module with Terminal class
*/
public async loadXterm(): Promise<IXtermBundle> {
if (this.xtermLib) {
return this.xtermLib;
}
if (this.xtermLoadingPromise) {
return this.xtermLoadingPromise;
}
this.xtermLoadingPromise = (async () => {
const url = `${CDN_BASE}/xterm@${CDN_VERSIONS.xterm}/+esm`;
const module = await import(/* @vite-ignore */ url);
// Also load and inject xterm CSS
await this.injectXtermStyles();
this.xtermLib = {
Terminal: module.Terminal,
};
return this.xtermLib;
})();
return this.xtermLoadingPromise;
}
/**
* Load xterm-addon-fit from CDN
* @returns Promise resolving to FitAddon class
*/
public async loadXtermFitAddon(): Promise<IXtermFitAddonBundle> {
if (this.xtermFitAddonLib) {
return this.xtermFitAddonLib;
}
if (this.xtermFitAddonLoadingPromise) {
return this.xtermFitAddonLoadingPromise;
}
this.xtermFitAddonLoadingPromise = (async () => {
const url = `${CDN_BASE}/xterm-addon-fit@${CDN_VERSIONS.xtermAddonFit}/+esm`;
const module = await import(/* @vite-ignore */ url);
this.xtermFitAddonLib = {
FitAddon: module.FitAddon,
};
return this.xtermFitAddonLib;
})();
return this.xtermFitAddonLoadingPromise;
}
/**
* Inject xterm CSS styles into the document head
*/
private async injectXtermStyles(): Promise<void> {
const styleId = 'xterm-cdn-styles';
if (document.getElementById(styleId)) {
return; // Already injected
}
const cssUrl = `${CDN_BASE}/xterm@${CDN_VERSIONS.xterm}/css/xterm.css`;
const response = await fetch(cssUrl);
const cssText = await response.text();
const style = document.createElement('style');
style.id = styleId;
style.textContent = cssText;
document.head.appendChild(style);
}
/**
* Load highlight.js syntax highlighter from CDN
* @returns Promise resolving to highlight.js API
*/
public async loadHighlightJs(): Promise<HLJSApi> {
if (this.highlightJsLib) {
return this.highlightJsLib;
}
if (this.highlightJsLoadingPromise) {
return this.highlightJsLoadingPromise;
}
this.highlightJsLoadingPromise = (async () => {
const url = `${CDN_BASE}/highlight.js@${CDN_VERSIONS.highlightJs}/+esm`;
const module = await import(/* @vite-ignore */ url);
this.highlightJsLib = module.default;
return this.highlightJsLib;
})();
return this.highlightJsLoadingPromise;
}
/**
* Load ApexCharts charting library from CDN
* @returns Promise resolving to ApexCharts constructor
*/
public async loadApexCharts(): Promise<typeof ApexChartsType> {
if (this.apexChartsLib) {
return this.apexChartsLib;
}
if (this.apexChartsLoadingPromise) {
return this.apexChartsLoadingPromise;
}
this.apexChartsLoadingPromise = (async () => {
const url = `${CDN_BASE}/apexcharts@${CDN_VERSIONS.apexcharts}/+esm`;
const module = await import(/* @vite-ignore */ url);
this.apexChartsLib = module.default;
return this.apexChartsLib;
})();
return this.apexChartsLoadingPromise;
}
/**
* Load Tiptap rich text editor and extensions from CDN
* @returns Promise resolving to Tiptap bundle with Editor and extensions
*/
public async loadTiptap(): Promise<ITiptapBundle> {
if (this.tiptapLib) {
return this.tiptapLib;
}
if (this.tiptapLoadingPromise) {
return this.tiptapLoadingPromise;
}
this.tiptapLoadingPromise = (async () => {
const version = CDN_VERSIONS.tiptap;
// Load all Tiptap modules in parallel
const [
coreModule,
starterKitModule,
underlineModule,
textAlignModule,
linkModule,
typographyModule,
] = await Promise.all([
import(/* @vite-ignore */ `${CDN_BASE}/@tiptap/core@${version}/+esm`),
import(/* @vite-ignore */ `${CDN_BASE}/@tiptap/starter-kit@${version}/+esm`),
import(/* @vite-ignore */ `${CDN_BASE}/@tiptap/extension-underline@${version}/+esm`),
import(/* @vite-ignore */ `${CDN_BASE}/@tiptap/extension-text-align@${version}/+esm`),
import(/* @vite-ignore */ `${CDN_BASE}/@tiptap/extension-link@${version}/+esm`),
import(/* @vite-ignore */ `${CDN_BASE}/@tiptap/extension-typography@${version}/+esm`),
]);
this.tiptapLib = {
Editor: coreModule.Editor,
StarterKit: starterKitModule.default || starterKitModule.StarterKit,
Underline: underlineModule.default || underlineModule.Underline,
TextAlign: textAlignModule.default || textAlignModule.TextAlign,
Link: linkModule.default || linkModule.Link,
Typography: typographyModule.default || typographyModule.Typography,
};
return this.tiptapLib;
})();
return this.tiptapLoadingPromise;
}
/**
* Preload multiple libraries in parallel
* Useful for warming the cache before components are rendered
*/
public async preloadAll(): Promise<void> {
await Promise.all([
this.loadXterm(),
this.loadXtermFitAddon(),
this.loadHighlightJs(),
this.loadApexCharts(),
this.loadTiptap(),
]);
}
/**
* Check if a specific library is already loaded
*/
public isLoaded(library: 'xterm' | 'xtermFitAddon' | 'highlightJs' | 'apexCharts' | 'tiptap'): boolean {
switch (library) {
case 'xterm':
return this.xtermLib !== null;
case 'xtermFitAddon':
return this.xtermFitAddonLib !== null;
case 'highlightJs':
return this.highlightJsLib !== null;
case 'apexCharts':
return this.apexChartsLib !== null;
case 'tiptap':
return this.tiptapLib !== null;
default:
return false;
}
}
}

3
ts_web/services/index.ts Normal file
View File

@@ -0,0 +1,3 @@
export { DeesServiceLibLoader } from './DeesServiceLibLoader.js';
export type { IXtermBundle, IXtermFitAddonBundle, ITiptapBundle } from './DeesServiceLibLoader.js';
export { CDN_BASE, CDN_VERSIONS } from './versions.js';

View File

@@ -0,0 +1,17 @@
/**
* CDN versions for lazy-loaded libraries.
* Keep these in sync with package.json for type compatibility.
*/
export const CDN_VERSIONS = {
xterm: '5.3.0',
xtermAddonFit: '0.8.0',
highlightJs: '11.11.1',
apexcharts: '5.3.6',
tiptap: '2.23.0',
fontawesome: '7.1.0',
} as const;
/**
* Base CDN URL for jsdelivr ESM imports
*/
export const CDN_BASE = 'https://cdn.jsdelivr.net/npm';

View File

@@ -5,7 +5,7 @@
"moduleResolution": "NodeNext",
"esModuleInterop": true,
"verbatimModuleSyntax": true,
"skipLibCheck": true
"skipLibCheck": false
},
"exclude": [
"dist_*/**/*.d.ts"