Compare commits

...

19 Commits

Author SHA1 Message Date
a634c2e237 v3.30.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-03 12:40:11 +00:00
9b0b448cb1 feat(appui): add dees-appui-bottombar component with config, programmatic API, demo and docs 2026-01-03 12:40:11 +00:00
ba4aa912af v3.29.3
Some checks failed
Default (tags) / security (push) Failing after 14s
Default (tags) / test (push) Failing after 16s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-01-03 02:50:37 +00:00
ca4f994b55 fix(elements/appui): prevent scroll chaining on app UI components by adding overscroll-behavior: contain 2026-01-03 02:50:37 +00:00
74844492eb v3.29.2
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-03 02:45:32 +00:00
c42cedbf94 fix(dees-appui): set min-height: 0 on .maingrid > dees-appui-maincontent to prevent layout overflow in flex container 2026-01-03 02:45:32 +00:00
749725f091 v3.29.1
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-03 02:33:01 +00:00
f3a8ad057a fix(dees-appui): prevent main grid overflow by adding overflow:hidden; and add Playwright scroll containment screenshots 2026-01-03 02:33:01 +00:00
7b8918705e v3.29.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
2026-01-03 02:09:13 +00:00
8313c24c9d feat(docs): add documentation for new input components, activity log features, theming, and expand DeesAppui docs 2026-01-03 02:09:13 +00:00
c3444aac01 v3.28.1
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-03 01:58:19 +00:00
8e5168d299 fix(appui): adjust layout and spacing in app UI components: fix activity log overflow, contain main content overscroll, and refine secondary menu padding/transition 2026-01-03 01:58:19 +00:00
57b323b53c feat: add interfaces for secondary menu items with various types and functionalities 2026-01-03 01:24:36 +00:00
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
58 changed files with 3028 additions and 432 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 125 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 125 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 69 KiB

View File

@@ -1,5 +1,79 @@
# Changelog # Changelog
## 2026-01-03 - 3.30.0 - feat(appui)
add dees-appui-bottombar component with config, programmatic API, demo and docs
- Adds a new dees-appui-bottombar web component (ts_web/elements/00group-appui/dees-appui-bottombar/) implementing widget and action management (add/update/remove/get/clear).
- Introduces bottom bar types and API in ts_web/elements/interfaces/appconfig.ts (IBottomBarWidget, IBottomBarAction, IBottomBarConfig, IBottomBarAPI) and extends the app config/type to include bottomBar and bottomBar APIs.
- Integrates the bottom bar into dees-appui: imports and registers component, renders conditionally, exposes bottomBar proxy API, visibility controls (set/getBottomBarVisible), and wires initial config to populate widgets/actions.
- Updates layout/styles (reduces main grid height to account for 24px fixed bottom bar and adds bottombar-hidden attribute handling) and exports component from the appui index.
- Adds interactive demos (dees-appui-bottombar.demo.ts and integration demo) and documents usage and API in readme.hints.md.
## 2026-01-03 - 3.29.3 - fix(elements/appui)
prevent scroll chaining on app UI components by adding overscroll-behavior: contain
- Added CSS overscroll-behavior: contain to activity log, main menu, secondary menu, profile dropdown, and tabs components to prevent scroll chaining and unintended body scrolling on touch/trackpad.
- Styling-only change; no public API or behavioral changes beyond scroll handling.
- Bump patch version from 3.29.2 to 3.29.3.
## 2026-01-03 - 3.29.2 - fix(dees-appui)
set min-height: 0 on .maingrid > dees-appui-maincontent to prevent layout overflow in flex container
- Added min-height: 0 to .maingrid > dees-appui-maincontent in ts_web/elements/00group-appui/dees-appui/dees-appui.ts to prevent unwanted growth/overflow when used inside a flex container.
- Pure CSS/layout fix — no API or behavior changes to components.
## 2026-01-03 - 3.29.1 - fix(dees-appui)
prevent main grid overflow by adding overflow:hidden; and add Playwright scroll containment screenshots
- Add overflow: hidden to .maingrid in ts_web/elements/00group-appui/dees-appui/dees-appui.ts to prevent content from escaping during grid-template-columns transitions.
- Add Playwright artifacts: .playwright-mcp/after-scroll.png and .playwright-mcp/scroll-containment-check.png (screenshots for scroll containment testing).
## 2026-01-03 - 3.29.0 - feat(docs)
add documentation for new input components, activity log features, theming, and expand DeesAppui docs
- Updated top-level README to reflect component count increase (75+ → 80+) and added many new component docs
- Added documentation and examples for DeesInputList (sortable list input) and DeesInputProfilepicture (cropping, upload, processing)
- Introduced DeesTheme documentation with usage examples and CSS custom property overrides
- Expanded DeesAppui readme with architecture overview, activity log panel docs, activity entry types, and navigation/secondary menu guidance
- Documented activity log APIs and controls (activityLog.add, addMany, clear, getEntries, filter, search) and new control API helpers (setActivityLogVisible, toggleActivityLog, getActivityLogVisible)
- Updated Appbar examples to include activity log toggle properties (.showActivityLogToggle, .activityLogCount, .activityLogActive) and @activity-toggle event
- Added interface docs (IViewDefinition, IActivityEntry) and updated menu/secondary menu type references
- Changes are documentation-focused (README/element readmes); no source code logic changes shown in this diff
## 2026-01-03 - 3.28.1 - fix(appui)
adjust layout and spacing in app UI components: fix activity log overflow, contain main content overscroll, and refine secondary menu padding/transition
- ts_web/elements/00group-appui/dees-appui-activitylog: removed host max-width, added overflow:hidden and set .maincontainer width to 280px to prevent horizontal overflow
- ts_web/elements/00group-appui/dees-appui-maincontent: added overscroll-behavior: contain to .content-area to prevent scroll chaining/overscroll
- ts_web/elements/00group-appui/dees-appui-secondarymenu: updated .groupHeader padding and hover border behavior, increased group icon size from 14px to 16px, and added margin + transition tweaks to .groupItems for smoother collapse/expand
## 2026-01-02 - 3.28.0 - feat(dees-appui)
Rename DeesAppuiBase to DeesAppui and migrate related API, exports, demos and docs
- Renamed public component/tag and TypeScript types: DeesAppuiBase -> DeesAppui and TDeesAppuiBase -> TDeesAppui; updated IViewActivationContext.appui type accordingly
- Moved/rewired view registry implementation from dees-appui-base to dees-appui and updated module exports
- Updated README and demo files to reference DeesAppui and new readme paths (removed dees-appui-base docs/demo)
- Replaced dependency/imports of '@webcontainer/api' with '@tempfix/webcontainer__api' (package.json and source imports)
- Changed tsconfig.json: skipLibCheck set from true to false
## 2026-01-01 - 3.27.1 - fix(dees-actionbar)
always render actionbar wrapper and delay adding visible class to ensure grid/opacity animations run reliably
- Always render the actionbar wrapper (.actionbar-item and .actionbar-content) instead of returning early so grid-template-rows and opacity transitions can animate.
- Use optional chaining for current bar access (bar?.type, bar?.timeout) to avoid runtime errors when no bar is present.
- Adjust styles and structure: set :host display:block; move background/border to .actionbar-item; add .actionbar-content with min-height/opacity and transitions.
- Make processQueue asynchronous and await updateComplete, then add the 'visible' class inside requestAnimationFrame so the CSS transition is triggered after render.
## 2026-01-01 - 3.27.0 - feat(services)
introduce DeesServiceLibLoader to lazy-load heavy client libraries from CDN and update components to use it
- Add DeesServiceLibLoader singleton (ts_web/services/DeesServiceLibLoader.ts) to lazily load and cache libraries via jsDelivr ESM: xterm, xterm-addon-fit, highlight.js, ApexCharts, and Tiptap.
- Inject xterm CSS dynamically to avoid shipping xterm styles in the initial bundle.
- Expose helper methods preloadAll() and isLoaded(), and typed bundle interfaces (IXtermBundle, IXtermFitAddonBundle, ITiptapBundle).
- Update components to use runtime-loaded modules: dees-chart-area, dees-dataview-codebox, dees-input-richtext, wysiwyg code block, dees-workspace-terminal, terminal-tab-manager, dees-workspace-terminal-preview.
- TerminalTabManager now requires setXtermModules(...) before creating tabs and will throw if not initialized; workspace terminal now initializes and passes the loaded modules.
- Replace direct runtime imports of heavy libs with typed imports and runtime-loaded bundles to reduce initial bundle size and improve load performance.
## 2026-01-01 - 3.26.1 - fix(dees-actionbar) ## 2026-01-01 - 3.26.1 - fix(dees-actionbar)
animate actionbar hide using grid-template-rows and wait for animation before clearing state animate actionbar hide using grid-template-rows and wait for animation before clearing state

View File

@@ -1,6 +1,6 @@
{ {
"name": "@design.estate/dees-catalog", "name": "@design.estate/dees-catalog",
"version": "3.26.1", "version": "3.30.0",
"private": false, "private": false,
"description": "A comprehensive library that provides dynamic web components for building sophisticated and modern web applications using JavaScript and TypeScript.", "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", "main": "dist_ts_web/index.js",
@@ -32,7 +32,7 @@
"@tiptap/extension-underline": "^2.23.0", "@tiptap/extension-underline": "^2.23.0",
"@tiptap/starter-kit": "^2.23.0", "@tiptap/starter-kit": "^2.23.0",
"@tsclass/tsclass": "^9.3.0", "@tsclass/tsclass": "^9.3.0",
"@webcontainer/api": "1.6.1", "@tempfix/webcontainer__api": "1.6.1",
"apexcharts": "^5.3.6", "apexcharts": "^5.3.6",
"highlight.js": "11.11.1", "highlight.js": "11.11.1",
"ibantools": "^4.5.1", "ibantools": "^4.5.1",

16
pnpm-lock.yaml generated
View File

@@ -35,6 +35,9 @@ importers:
'@push.rocks/smartstring': '@push.rocks/smartstring':
specifier: ^4.1.0 specifier: ^4.1.0
version: 4.1.0 version: 4.1.0
'@tempfix/webcontainer__api':
specifier: 1.6.1
version: 1.6.1
'@tiptap/core': '@tiptap/core':
specifier: ^2.23.0 specifier: ^2.23.0
version: 2.27.1(@tiptap/pm@2.27.1) version: 2.27.1(@tiptap/pm@2.27.1)
@@ -56,9 +59,6 @@ importers:
'@tsclass/tsclass': '@tsclass/tsclass':
specifier: ^9.3.0 specifier: ^9.3.0
version: 9.3.0 version: 9.3.0
'@webcontainer/api':
specifier: 1.6.1
version: 1.6.1
apexcharts: apexcharts:
specifier: ^5.3.6 specifier: ^5.3.6
version: 5.3.6 version: 5.3.6
@@ -1450,6 +1450,9 @@ packages:
'@tempfix/idb@8.0.3': '@tempfix/idb@8.0.3':
resolution: {integrity: sha512-hPJQKO7+oAIY+pDNImrZ9QAINbz9KmwT+yO4iRVwdPanok2YKpaUxdJzIvCUwY0YgAawlvYdffbLvRLV5hbs2g==} 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': '@tiptap/core@2.27.1':
resolution: {integrity: sha512-nkerkl8syHj44ZzAB7oA2GPmmZINKBKCa79FuNvmGJrJ4qyZwlkDzszud23YteFZEytbc87kVd/fP76ROS6sLg==} resolution: {integrity: sha512-nkerkl8syHj44ZzAB7oA2GPmmZINKBKCa79FuNvmGJrJ4qyZwlkDzszud23YteFZEytbc87kVd/fP76ROS6sLg==}
peerDependencies: peerDependencies:
@@ -1760,9 +1763,6 @@ packages:
'@webcontainer/api@1.2.0': '@webcontainer/api@1.2.0':
resolution: {integrity: sha512-tzoKBd4lLdhHy5GHFpUkl+ndoSba8JqmB7x0ZQFnWfjbcbQOvKQfxA8MEMUYhgqjWHnbrWdAfnBEHz5f5lYG5A==} 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': '@yr/monotone-cubic-spline@1.0.3':
resolution: {integrity: sha512-FQXkOta0XBSUPHndIKON2Y9JeQz5ZeMqLYZVVK93FliNBFm7LNMIZmY6FrMEB9XPcDbE2bekMbZD6kzDkxwYjA==} resolution: {integrity: sha512-FQXkOta0XBSUPHndIKON2Y9JeQz5ZeMqLYZVVK93FliNBFm7LNMIZmY6FrMEB9XPcDbE2bekMbZD6kzDkxwYjA==}
@@ -6466,6 +6466,8 @@ snapshots:
'@tempfix/idb@8.0.3': {} '@tempfix/idb@8.0.3': {}
'@tempfix/webcontainer__api@1.6.1': {}
'@tiptap/core@2.27.1(@tiptap/pm@2.27.1)': '@tiptap/core@2.27.1(@tiptap/pm@2.27.1)':
dependencies: dependencies:
'@tiptap/pm': 2.27.1 '@tiptap/pm': 2.27.1
@@ -6814,8 +6816,6 @@ snapshots:
'@webcontainer/api@1.2.0': {} '@webcontainer/api@1.2.0': {}
'@webcontainer/api@1.6.1': {}
'@yr/monotone-cubic-spline@1.0.3': {} '@yr/monotone-cubic-spline@1.0.3': {}
accepts@1.3.8: 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) ## 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: ### New Modules:
@@ -734,7 +734,7 @@ interface IRoutingConfig {
} }
``` ```
### New Public Methods on DeesAppuiBase: ### New Public Methods on DeesAppui:
```typescript ```typescript
// Configure with unified config // Configure with unified config
@@ -774,7 +774,7 @@ const config: IAppConfig = {
statePersistence: { enabled: true, storage: 'localStorage' }, statePersistence: { enabled: true, storage: 'localStorage' },
}; };
html`<dees-appui-base .config=${config}></dees-appui-base>`; html`<dees-appui .config=${config}></dees-appui>`;
``` ```
### Backward Compatibility: ### Backward Compatibility:
@@ -783,13 +783,13 @@ The existing property-based API still works:
```typescript ```typescript
html` html`
<dees-appui-base <dees-appui
.mainmenuGroups=${groups} .mainmenuGroups=${groups}
.secondarymenuGroups=${secondaryGroups} .secondarymenuGroups=${secondaryGroups}
@mainmenu-tab-select=${handler} @mainmenu-tab-select=${handler}
> >
<div slot="maincontent">...</div> <div slot="maincontent">...</div>
</dees-appui-base> </dees-appui>
`; `;
``` ```
@@ -800,4 +800,114 @@ html`
- **External Router Support**: Integrate with Angular Router or other frameworks - **External Router Support**: Integrate with Angular Router or other frameworks
- **State Persistence**: Save/restore collapsed menus, selections, and current view - **State Persistence**: Save/restore collapsed menus, selections, and current view
- **View-specific Menus**: Each view can define its own secondary menu and tabs - **View-specific Menus**: Each view can define its own secondary menu and tabs
- **Full Backward Compatibility**: Existing code continues to work - **Full Backward Compatibility**: Existing code continues to work
## AppUI Bottom Bar (2026-01-03)
Added a new `dees-appui-bottombar` component similar to `dees-workspace-bottombar`, providing a 24px fixed-height status bar at the bottom of the app shell.
### Features:
- **Generic status widgets**: Configurable widgets with icon, label, status colors, loading spinner
- **App-specific actions**: Quick action buttons with icons and tooltips
- **Always visible**: Fixed 24px height at the bottom of the app
- **Status colors**: idle, active (blue), success (green), warning (yellow), error (red)
- **Context menus**: Widgets can have right-click context menus
### New Interfaces (in `interfaces/appconfig.ts`):
```typescript
interface IBottomBarWidget {
id: string;
iconName?: string;
label?: string;
status?: 'idle' | 'active' | 'success' | 'warning' | 'error';
tooltip?: string;
loading?: boolean;
onClick?: () => void;
contextMenuItems?: IBottomBarContextMenuItem[];
position?: 'left' | 'right';
order?: number;
}
interface IBottomBarAction {
id: string;
iconName: string;
tooltip?: string;
onClick: () => void | Promise<void>;
disabled?: boolean;
position?: 'left' | 'right';
}
interface IBottomBarConfig {
visible?: boolean;
widgets?: IBottomBarWidget[];
actions?: IBottomBarAction[];
}
```
### Usage via configure():
```typescript
const config: IAppConfig = {
// ... other config
bottomBar: {
visible: true,
widgets: [
{
id: 'status',
iconName: 'lucide:activity',
label: 'System Online',
status: 'success',
tooltip: 'All systems operational',
onClick: () => console.log('Status clicked'),
},
{
id: 'notifications',
iconName: 'lucide:bell',
label: '3 notifications',
status: 'warning',
position: 'left',
},
{
id: 'version',
iconName: 'lucide:gitBranch',
label: 'v1.2.3',
position: 'right',
},
],
actions: [
{
id: 'terminal',
iconName: 'lucide:terminal',
tooltip: 'Open Terminal',
position: 'right',
onClick: () => console.log('Terminal clicked'),
},
],
},
};
```
### Programmatic API:
```typescript
// Add/update/remove widgets
appui.bottomBar.addWidget({ id: 'status', ... });
appui.bottomBar.updateWidget('status', { status: 'error', label: 'Error!' });
appui.bottomBar.removeWidget('status');
appui.bottomBar.clearWidgets();
// Add/remove actions
appui.bottomBar.addAction({ id: 'refresh', iconName: 'lucide:refreshCw', ... });
appui.bottomBar.removeAction('refresh');
appui.bottomBar.clearActions();
// Visibility control
appui.setBottomBarVisible(false);
appui.getBottomBarVisible();
```
### Files:
- `ts_web/elements/00group-appui/dees-appui-bottombar/dees-appui-bottombar.ts` - Main component
- `ts_web/elements/00group-appui/dees-appui-bottombar/dees-appui-bottombar.demo.ts` - Demo
- `ts_web/elements/interfaces/appconfig.ts` - New interfaces added

173
readme.md
View File

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

View File

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

View File

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

View File

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

View File

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

View File

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

View File

@@ -0,0 +1,210 @@
import { html } from '@design.estate/dees-element';
import type { DeesAppuiBottombar } from './dees-appui-bottombar.js';
import '@design.estate/dees-wcctools/demotools';
export const demoFunc = () => {
return html`
<dees-demowrapper>
<style>
.demo-container {
display: flex;
flex-direction: column;
gap: 24px;
padding: 24px;
background: #1a1a1a;
}
.demo-section {
display: flex;
flex-direction: column;
gap: 8px;
}
.demo-label {
font-size: 12px;
color: #737373;
font-family: 'Geist Sans', sans-serif;
}
.demo-bottombar-wrapper {
border: 1px solid hsl(0 0% 20%);
border-radius: 4px;
overflow: hidden;
}
</style>
<div class="demo-container">
<div class="demo-section">
<div class="demo-label">Bottom bar with status widgets and actions</div>
<div class="demo-bottombar-wrapper">
<dees-appui-bottombar
id="demo-bottombar"
></dees-appui-bottombar>
</div>
</div>
<div class="demo-section">
<div class="demo-label">Controls</div>
<div style="display: flex; gap: 8px; flex-wrap: wrap;">
<button onclick="addSuccessWidget()">Add Success Widget</button>
<button onclick="addWarningWidget()">Add Warning Widget</button>
<button onclick="addErrorWidget()">Add Error Widget</button>
<button onclick="addLoadingWidget()">Add Loading Widget</button>
<button onclick="addRightWidget()">Add Right Widget</button>
<button onclick="addAction()">Add Action</button>
<button onclick="clearAll()">Clear All</button>
</div>
</div>
</div>
<script type="module">
const bottombar = document.getElementById('demo-bottombar');
// Wait for component to initialize
await bottombar.updateComplete;
// Add initial widgets
bottombar.addWidget({
id: 'status',
iconName: 'lucide:activity',
label: 'System Online',
status: 'success',
tooltip: 'All systems operational',
onClick: () => console.log('Status clicked'),
contextMenuItems: [
{ name: 'View Details', iconName: 'lucide:info', action: () => alert('System details') },
{ divider: true },
{ name: 'Refresh Status', iconName: 'lucide:refreshCw', action: () => alert('Refreshing...') },
],
});
bottombar.addWidget({
id: 'notifications',
iconName: 'lucide:bell',
label: '3 notifications',
status: 'warning',
tooltip: 'You have unread notifications',
onClick: () => console.log('Notifications clicked'),
});
bottombar.addWidget({
id: 'version',
iconName: 'lucide:gitBranch',
label: 'v1.2.3',
tooltip: 'Current version',
position: 'right',
onClick: () => console.log('Version clicked'),
});
// Add initial actions
bottombar.addAction({
id: 'settings',
iconName: 'lucide:settings',
tooltip: 'Settings',
position: 'right',
onClick: () => alert('Settings clicked'),
});
bottombar.addAction({
id: 'help',
iconName: 'lucide:helpCircle',
tooltip: 'Help',
position: 'right',
onClick: () => alert('Help clicked'),
});
// Demo control functions
let widgetCounter = 0;
let actionCounter = 0;
window.addSuccessWidget = () => {
widgetCounter++;
bottombar.addWidget({
id: 'success-' + widgetCounter,
iconName: 'lucide:checkCircle',
label: 'Success ' + widgetCounter,
status: 'success',
tooltip: 'Success widget',
onClick: () => bottombar.removeWidget('success-' + widgetCounter),
});
};
window.addWarningWidget = () => {
widgetCounter++;
bottombar.addWidget({
id: 'warning-' + widgetCounter,
iconName: 'lucide:alertTriangle',
label: 'Warning ' + widgetCounter,
status: 'warning',
tooltip: 'Warning widget',
onClick: () => bottombar.removeWidget('warning-' + widgetCounter),
});
};
window.addErrorWidget = () => {
widgetCounter++;
bottombar.addWidget({
id: 'error-' + widgetCounter,
iconName: 'lucide:xCircle',
label: 'Error ' + widgetCounter,
status: 'error',
tooltip: 'Error widget',
onClick: () => bottombar.removeWidget('error-' + widgetCounter),
});
};
window.addLoadingWidget = () => {
widgetCounter++;
const id = 'loading-' + widgetCounter;
bottombar.addWidget({
id: id,
iconName: 'lucide:loader2',
label: 'Loading...',
status: 'active',
loading: true,
tooltip: 'Loading in progress',
});
// Simulate completion after 3 seconds
setTimeout(() => {
bottombar.updateWidget(id, {
iconName: 'lucide:check',
label: 'Done!',
status: 'success',
loading: false,
});
}, 3000);
};
window.addRightWidget = () => {
widgetCounter++;
bottombar.addWidget({
id: 'right-' + widgetCounter,
iconName: 'lucide:info',
label: 'Right ' + widgetCounter,
position: 'right',
onClick: () => bottombar.removeWidget('right-' + widgetCounter),
});
};
window.addAction = () => {
actionCounter++;
bottombar.addAction({
id: 'action-' + actionCounter,
iconName: 'lucide:zap',
tooltip: 'Action ' + actionCounter,
onClick: () => {
alert('Action ' + actionCounter + ' clicked');
bottombar.removeAction('action-' + actionCounter);
},
});
};
window.clearAll = () => {
bottombar.clearWidgets();
bottombar.clearActions();
widgetCounter = 0;
actionCounter = 0;
};
</script>
</dees-demowrapper>
`;
};

View File

@@ -0,0 +1,314 @@
import {
DeesElement,
type TemplateResult,
customElement,
html,
css,
cssManager,
state,
} from '@design.estate/dees-element';
import { themeDefaultStyles } from '../../00theme.js';
import '../../dees-icon/dees-icon.js';
import { DeesContextmenu } from '../../dees-contextmenu/dees-contextmenu.js';
import type {
IBottomBarWidget,
IBottomBarAction,
IBottomBarAPI,
} from '../../interfaces/appconfig.js';
import { demoFunc } from './dees-appui-bottombar.demo.js';
declare global {
interface HTMLElementTagNameMap {
'dees-appui-bottombar': DeesAppuiBottombar;
}
}
@customElement('dees-appui-bottombar')
export class DeesAppuiBottombar extends DeesElement implements IBottomBarAPI {
public static demo = demoFunc;
// INSTANCE PROPERTIES
@state()
accessor widgets: IBottomBarWidget[] = [];
@state()
accessor actions: IBottomBarAction[] = [];
public static styles = [
themeDefaultStyles,
cssManager.defaultStyles,
css`
:host {
display: block;
height: 24px;
flex-shrink: 0;
user-select: none;
}
.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;
}
/* Status colors matching dees-workspace-bottombar */
.widget.active {
color: ${cssManager.bdTheme('hsl(210 100% 45%)', 'hsl(210 100% 60%)')};
}
.widget.success {
color: ${cssManager.bdTheme('hsl(142 70% 35%)', 'hsl(142 70% 50%)')};
}
.widget.warning {
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;
}
.action-button {
display: flex;
align-items: center;
justify-content: center;
width: 20px;
height: 20px;
border-radius: 3px;
cursor: pointer;
transition: background 0.15s ease;
color: ${cssManager.bdTheme('hsl(0 0% 40%)', 'hsl(0 0% 60%)')};
}
.action-button:hover {
background: ${cssManager.bdTheme('hsl(0 0% 88%)', 'hsl(0 0% 12%)')};
color: ${cssManager.bdTheme('hsl(0 0% 20%)', 'hsl(0 0% 80%)')};
}
.action-button.disabled {
opacity: 0.5;
cursor: not-allowed;
}
.action-button.disabled:hover {
background: transparent;
color: ${cssManager.bdTheme('hsl(0 0% 40%)', 'hsl(0 0% 60%)')};
}
`,
];
public render(): TemplateResult {
const leftWidgets = this.widgets
.filter(w => w.position !== 'right')
.sort((a, b) => (a.order || 0) - (b.order || 0));
const rightWidgets = this.widgets
.filter(w => w.position === 'right')
.sort((a, b) => (a.order || 0) - (b.order || 0));
const leftActions = this.actions.filter(a => a.position === 'left');
const rightActions = this.actions.filter(a => a.position !== 'left');
return html`
<div class="bottom-bar">
<!-- Left actions -->
${leftActions.map(action => this.renderAction(action))}
<!-- Left widgets -->
${leftWidgets.map((widget, index) => html`
${index > 0 || leftActions.length > 0 ? html`<div class="widget-separator"></div>` : ''}
${this.renderWidget(widget)}
`)}
<div class="spacer"></div>
<!-- Right widgets -->
${rightWidgets.map((widget, index) => html`
${this.renderWidget(widget)}
${index < rightWidgets.length - 1 || rightActions.length > 0 ? html`<div class="widget-separator"></div>` : ''}
`)}
<!-- Right actions -->
${rightActions.map(action => this.renderAction(action))}
</div>
`;
}
private renderWidget(widget: IBottomBarWidget): TemplateResult {
const statusClass = widget.status && widget.status !== 'idle' ? widget.status : '';
const iconName = widget.iconName
? (widget.iconName.startsWith('lucide:') ? widget.iconName : `lucide:${widget.iconName}`)
: '';
return html`
<div
class="widget ${statusClass}"
title="${widget.tooltip || ''}"
@click=${() => widget.onClick?.()}
@contextmenu=${(e: MouseEvent) => this.handleWidgetContextMenu(e, widget)}
>
${iconName ? html`
<dees-icon
.icon=${iconName}
iconSize="12"
class="${widget.loading ? 'spinning' : ''}"
></dees-icon>
` : ''}
${widget.label ? html`<span>${widget.label}</span>` : ''}
</div>
`;
}
private renderAction(action: IBottomBarAction): TemplateResult {
const iconName = action.iconName.startsWith('lucide:')
? action.iconName
: `lucide:${action.iconName}`;
return html`
<div
class="action-button ${action.disabled ? 'disabled' : ''}"
title="${action.tooltip || ''}"
@click=${() => !action.disabled && action.onClick?.()}
>
<dees-icon
.icon=${iconName}
iconSize="12"
></dees-icon>
</div>
`;
}
private async handleWidgetContextMenu(e: MouseEvent, widget: IBottomBarWidget): Promise<void> {
if (!widget.contextMenuItems || widget.contextMenuItems.length === 0) return;
e.preventDefault();
const menuItems: Parameters<typeof DeesContextmenu.openContextMenuWithOptions>[1] = [];
for (const item of widget.contextMenuItems) {
if (item.divider) {
menuItems.push({ divider: true });
} else {
menuItems.push({
name: item.name,
iconName: item.iconName,
action: async () => { await item.action(); },
disabled: item.disabled,
});
}
}
await DeesContextmenu.openContextMenuWithOptions(e, menuItems);
}
// ==========================================
// API METHODS (implements IBottomBarAPI)
// ==========================================
/**
* Add a widget to the bottom bar
*/
public addWidget(widget: IBottomBarWidget): void {
// Remove existing widget with same ID if present
this.widgets = this.widgets.filter(w => w.id !== widget.id);
this.widgets = [...this.widgets, widget];
}
/**
* Update an existing widget by ID
*/
public updateWidget(id: string, update: Partial<IBottomBarWidget>): void {
this.widgets = this.widgets.map(w =>
w.id === id ? { ...w, ...update } : w
);
}
/**
* Remove a widget by ID
*/
public removeWidget(id: string): void {
this.widgets = this.widgets.filter(w => w.id !== id);
}
/**
* Get a widget by ID
*/
public getWidget(id: string): IBottomBarWidget | undefined {
return this.widgets.find(w => w.id === id);
}
/**
* Clear all widgets
*/
public clearWidgets(): void {
this.widgets = [];
}
/**
* Add an action button
*/
public addAction(action: IBottomBarAction): void {
this.actions = this.actions.filter(a => a.id !== action.id);
this.actions = [...this.actions, action];
}
/**
* Remove an action by ID
*/
public removeAction(id: string): void {
this.actions = this.actions.filter(a => a.id !== id);
}
/**
* Clear all actions
*/
public clearActions(): void {
this.actions = [];
}
}

View File

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

View File

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

View File

@@ -164,6 +164,7 @@ export class DeesAppuiMainmenu extends DeesElement {
flex: 1; flex: 1;
overflow-y: auto; overflow-y: auto;
overflow-x: hidden; overflow-x: hidden;
overscroll-behavior: contain;
padding: 8px 0; padding: 8px 0;
} }

View File

@@ -285,6 +285,7 @@ export class DeesAppuiProfileDropdown extends DeesElement {
max-width: calc(100vw - 32px); max-width: calc(100vw - 32px);
max-height: calc(100vh - 32px); max-height: calc(100vh - 32px);
overflow-y: auto; overflow-y: auto;
overscroll-behavior: contain;
} }
:host([isopen]) .dropdown { :host([isopen]) .dropdown {

View File

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

View File

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

View File

@@ -116,6 +116,7 @@ export class DeesAppuiTabs extends DeesElement {
font-size: 14px; font-size: 14px;
overflow-x: auto; overflow-x: auto;
overflow-y: hidden; overflow-y: hidden;
overscroll-behavior: contain;
scrollbar-width: thin; scrollbar-width: thin;
scrollbar-color: transparent transparent; scrollbar-color: transparent transparent;
height: 100%; height: 100%;

View File

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

View File

@@ -15,7 +15,8 @@ import type { DeesAppuiMainmenu } from '../dees-appui-mainmenu/dees-appui-mainme
import type { DeesAppuiSecondarymenu } from '../dees-appui-secondarymenu/dees-appui-secondarymenu.js'; import type { DeesAppuiSecondarymenu } from '../dees-appui-secondarymenu/dees-appui-secondarymenu.js';
import type { DeesAppuiMaincontent } from '../dees-appui-maincontent/dees-appui-maincontent.js'; import type { DeesAppuiMaincontent } from '../dees-appui-maincontent/dees-appui-maincontent.js';
import type { DeesAppuiActivitylog } from '../dees-appui-activitylog/dees-appui-activitylog.js'; import type { DeesAppuiActivitylog } from '../dees-appui-activitylog/dees-appui-activitylog.js';
import { demoFunc } from './dees-appui-base.demo.js'; import type { DeesAppuiBottombar } from '../dees-appui-bottombar/dees-appui-bottombar.js';
import { demoFunc } from './dees-appui.demo.js';
import { themeDefaultStyles } from '../../00theme.js'; import { themeDefaultStyles } from '../../00theme.js';
// View registry for managing views // View registry for managing views
@@ -23,6 +24,7 @@ import { ViewRegistry } from './view.registry.js';
// Import child components // Import child components
import '../dees-appui-appbar/index.js'; import '../dees-appui-appbar/index.js';
import '../dees-appui-bottombar/dees-appui-bottombar.js';
import '../dees-appui-mainmenu/dees-appui-mainmenu.js'; import '../dees-appui-mainmenu/dees-appui-mainmenu.js';
import '../dees-appui-secondarymenu/dees-appui-secondarymenu.js'; import '../dees-appui-secondarymenu/dees-appui-secondarymenu.js';
import '../dees-appui-maincontent/dees-appui-maincontent.js'; import '../dees-appui-maincontent/dees-appui-maincontent.js';
@@ -30,12 +32,12 @@ import '../dees-appui-activitylog/dees-appui-activitylog.js';
declare global { declare global {
interface HTMLElementTagNameMap { interface HTMLElementTagNameMap {
'dees-appui-base': DeesAppuiBase; 'dees-appui': DeesAppui;
} }
} }
@customElement('dees-appui-base') @customElement('dees-appui')
export class DeesAppuiBase extends DeesElement { export class DeesAppui extends DeesElement {
public static demo = demoFunc; public static demo = demoFunc;
// ========================================== // ==========================================
@@ -98,10 +100,10 @@ export class DeesAppuiBase extends DeesElement {
accessor secondarymenuHeading: string = ''; accessor secondarymenuHeading: string = '';
@property({ type: Array }) @property({ type: Array })
accessor secondarymenuGroups: interfaces.IMenuGroup[] = []; accessor secondarymenuGroups: interfaces.ISecondaryMenuGroup[] = [];
@property({ type: Object }) @property({ type: Object })
accessor secondarymenuSelectedItem: interfaces.IMenuItem | undefined = undefined; accessor secondarymenuSelectedItem: interfaces.ISecondaryMenuItemTab | undefined = undefined;
// Collapse states // Collapse states
@property({ type: Boolean }) @property({ type: Boolean })
@@ -126,6 +128,13 @@ export class DeesAppuiBase extends DeesElement {
@property({ type: Number }) @property({ type: Number })
accessor contentTabsAutoHideThreshold: number = 0; accessor contentTabsAutoHideThreshold: number = 0;
// Activity log visibility and count
@state()
accessor activityLogVisible: boolean = false;
@state()
accessor activityLogCount: number = 0;
// Properties for maincontent // Properties for maincontent
@property({ type: Array }) @property({ type: Array })
accessor maincontentTabs: interfaces.IMenuItem[] = []; accessor maincontentTabs: interfaces.IMenuItem[] = [];
@@ -149,6 +158,12 @@ export class DeesAppuiBase extends DeesElement {
@state() @state()
accessor activitylogElement: DeesAppuiActivitylog | undefined = undefined; accessor activitylogElement: DeesAppuiActivitylog | undefined = undefined;
@state()
accessor bottombarElement: DeesAppuiBottombar | undefined = undefined;
@state()
accessor bottombarVisible: boolean = true;
// Current view state // Current view state
@state() @state()
accessor currentView: interfaces.IViewDefinition | undefined = undefined; accessor currentView: interfaces.IViewDefinition | undefined = undefined;
@@ -172,11 +187,25 @@ export class DeesAppuiBase extends DeesElement {
.maingrid { .maingrid {
position: absolute; position: absolute;
top: 40px; top: 40px;
height: calc(100% - 40px); height: calc(100% - 40px - 24px);
width: 100%; width: 100%;
display: grid; display: grid;
grid-template-columns: auto auto 1fr 240px; /* grid-template-columns set dynamically in template */
grid-template-rows: 1fr; grid-template-rows: 1fr;
transition: grid-template-columns 0.3s ease, height 0.3s ease;
overflow: hidden;
}
:host([bottombar-hidden]) .maingrid {
height: calc(100% - 40px);
}
dees-appui-bottombar {
position: absolute;
bottom: 0;
left: 0;
right: 0;
z-index: 4;
} }
/* Z-index layering for proper stacking */ /* Z-index layering for proper stacking */
@@ -193,11 +222,25 @@ export class DeesAppuiBase extends DeesElement {
.maingrid > dees-appui-maincontent { .maingrid > dees-appui-maincontent {
position: relative; position: relative;
z-index: 1; z-index: 1;
min-height: 0;
} }
.maingrid > dees-appui-activitylog { .maingrid > dees-appui-activitylog {
position: relative; position: relative;
z-index: 1; z-index: 1;
overflow: hidden;
transition: opacity 0.3s ease, transform 0.3s ease;
}
.maingrid > dees-appui-activitylog.hidden {
opacity: 0;
transform: translateX(20px);
pointer-events: none;
}
.maingrid > dees-appui-activitylog.visible {
opacity: 1;
transform: translateX(0);
} }
/* View container for dynamically loaded views */ /* View container for dynamically loaded views */
@@ -221,14 +264,18 @@ export class DeesAppuiBase extends DeesElement {
.user=${this.appbarUser} .user=${this.appbarUser}
.profileMenuItems=${this.appbarProfileMenuItems} .profileMenuItems=${this.appbarProfileMenuItems}
.showSearch=${this.appbarShowSearch} .showSearch=${this.appbarShowSearch}
.showActivityLogToggle=${true}
.activityLogCount=${this.activityLogCount}
.activityLogActive=${this.activityLogVisible}
@menu-select=${(e: CustomEvent) => this.handleAppbarMenuSelect(e)} @menu-select=${(e: CustomEvent) => this.handleAppbarMenuSelect(e)}
@breadcrumb-navigate=${(e: CustomEvent) => this.handleAppbarBreadcrumbNavigate(e)} @breadcrumb-navigate=${(e: CustomEvent) => this.handleAppbarBreadcrumbNavigate(e)}
@search-click=${() => this.handleAppbarSearchClick()} @search-click=${() => this.handleAppbarSearchClick()}
@search-query=${(e: CustomEvent) => this.handleAppbarSearchQuery(e)} @search-query=${(e: CustomEvent) => this.handleAppbarSearchQuery(e)}
@user-menu-open=${() => this.handleAppbarUserMenuOpen()} @user-menu-open=${() => this.handleAppbarUserMenuOpen()}
@profile-menu-select=${(e: CustomEvent) => this.handleAppbarProfileMenuSelect(e)} @profile-menu-select=${(e: CustomEvent) => this.handleAppbarProfileMenuSelect(e)}
@activity-toggle=${() => this.toggleActivityLog()}
></dees-appui-appbar> ></dees-appui-appbar>
<div class="maingrid"> <div class="maingrid" style="grid-template-columns: auto auto 1fr ${this.activityLogVisible ? '280px' : '0px'};">
${this.mainmenuVisible ? html` ${this.mainmenuVisible ? html`
<dees-appui-mainmenu <dees-appui-mainmenu
.logoIcon=${this.mainmenuLogoIcon} .logoIcon=${this.mainmenuLogoIcon}
@@ -264,8 +311,13 @@ export class DeesAppuiBase extends DeesElement {
<div class="view-container"></div> <div class="view-container"></div>
<slot name="maincontent"></slot> <slot name="maincontent"></slot>
</dees-appui-maincontent> </dees-appui-maincontent>
<dees-appui-activitylog></dees-appui-activitylog> <dees-appui-activitylog
class="${this.activityLogVisible ? 'visible' : 'hidden'}"
></dees-appui-activitylog>
</div> </div>
${this.bottombarVisible ? html`
<dees-appui-bottombar></dees-appui-bottombar>
` : ''}
`; `;
} }
@@ -276,9 +328,17 @@ export class DeesAppuiBase extends DeesElement {
this.secondarymenu = this.shadowRoot!.querySelector('dees-appui-secondarymenu') as DeesAppuiSecondarymenu; this.secondarymenu = this.shadowRoot!.querySelector('dees-appui-secondarymenu') as DeesAppuiSecondarymenu;
this.maincontent = this.shadowRoot!.querySelector('dees-appui-maincontent') as DeesAppuiMaincontent; this.maincontent = this.shadowRoot!.querySelector('dees-appui-maincontent') as DeesAppuiMaincontent;
this.activitylogElement = this.shadowRoot!.querySelector('dees-appui-activitylog') as DeesAppuiActivitylog; this.activitylogElement = this.shadowRoot!.querySelector('dees-appui-activitylog') as DeesAppuiActivitylog;
this.bottombarElement = this.shadowRoot!.querySelector('dees-appui-bottombar') as DeesAppuiBottombar;
// Subscribe to activity log entry changes for badge count
if (this.activitylogElement) {
this.activitylogElement.entries$.subscribe((entries) => {
this.activityLogCount = entries.length;
});
}
// Set appui reference in view registry for lifecycle context // 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() { async disconnectedCallback() {
@@ -534,7 +594,7 @@ export class DeesAppuiBase extends DeesElement {
/** /**
* Set the secondary menu configuration * Set the secondary menu configuration
*/ */
public setSecondaryMenu(config: { heading?: string; groups: interfaces.IMenuGroup[] }): void { public setSecondaryMenu(config: { heading?: string; groups: interfaces.ISecondaryMenuGroup[] }): void {
if (config.heading !== undefined) { if (config.heading !== undefined) {
this.secondarymenuHeading = config.heading; this.secondarymenuHeading = config.heading;
} }
@@ -544,7 +604,7 @@ export class DeesAppuiBase extends DeesElement {
/** /**
* Update a specific secondary menu group * Update a specific secondary menu group
*/ */
public updateSecondaryMenuGroup(groupName: string, update: Partial<interfaces.IMenuGroup>): void { public updateSecondaryMenuGroup(groupName: string, update: Partial<interfaces.ISecondaryMenuGroup>): void {
this.secondarymenuGroups = this.secondarymenuGroups.map(group => this.secondarymenuGroups = this.secondarymenuGroups.map(group =>
group.name === groupName ? { ...group, ...update } : group group.name === groupName ? { ...group, ...update } : group
); );
@@ -555,7 +615,7 @@ export class DeesAppuiBase extends DeesElement {
*/ */
public addSecondaryMenuItem( public addSecondaryMenuItem(
groupName: string, groupName: string,
item: interfaces.IMenuGroup['items'][0] item: interfaces.ISecondaryMenuItem
): void { ): void {
this.secondarymenuGroups = this.secondarymenuGroups.map(group => { this.secondarymenuGroups = this.secondarymenuGroups.map(group => {
if (group.name === groupName) { if (group.name === groupName) {
@@ -569,13 +629,13 @@ export class DeesAppuiBase extends DeesElement {
} }
/** /**
* Set the selected secondary menu item by key * Set the selected secondary menu item by key (for tab items only)
*/ */
public setSecondaryMenuSelection(itemKey: string): void { public setSecondaryMenuSelection(itemKey: string): void {
for (const group of this.secondarymenuGroups) { for (const group of this.secondarymenuGroups) {
const item = group.items.find(i => i.key === itemKey); const item = group.items.find(i => 'key' in i && i.key === itemKey);
if (item) { if (item && (!('type' in item) || item.type === 'tab' || item.type === undefined)) {
this.secondarymenuSelectedItem = item; this.secondarymenuSelectedItem = item as interfaces.ISecondaryMenuItemTab;
return; return;
} }
} }
@@ -673,6 +733,93 @@ export class DeesAppuiBase extends DeesElement {
}; };
} }
/**
* Set activity log visibility
*/
public setActivityLogVisible(visible: boolean): void {
this.activityLogVisible = visible;
}
/**
* Toggle activity log visibility
*/
public toggleActivityLog(): void {
this.activityLogVisible = !this.activityLogVisible;
}
/**
* Get activity log visibility state
*/
public getActivityLogVisible(): boolean {
return this.activityLogVisible;
}
// ==========================================
// PROGRAMMATIC API: BOTTOM BAR
// ==========================================
/**
* Get the bottom bar API for widget/action management
*/
public get bottomBar(): interfaces.IBottomBarAPI {
if (!this.bottombarElement) {
// Return a deferred API that will work after firstUpdated
return {
addWidget: (widget) => {
this.updateComplete.then(() => this.bottombarElement?.addWidget(widget));
},
updateWidget: (id, update) => {
this.updateComplete.then(() => this.bottombarElement?.updateWidget(id, update));
},
removeWidget: (id) => {
this.updateComplete.then(() => this.bottombarElement?.removeWidget(id));
},
getWidget: (id) => this.bottombarElement?.getWidget(id),
clearWidgets: () => {
this.updateComplete.then(() => this.bottombarElement?.clearWidgets());
},
addAction: (action) => {
this.updateComplete.then(() => this.bottombarElement?.addAction(action));
},
removeAction: (id) => {
this.updateComplete.then(() => this.bottombarElement?.removeAction(id));
},
clearActions: () => {
this.updateComplete.then(() => this.bottombarElement?.clearActions());
},
};
}
return {
addWidget: (widget) => this.bottombarElement!.addWidget(widget),
updateWidget: (id, update) => this.bottombarElement!.updateWidget(id, update),
removeWidget: (id) => this.bottombarElement!.removeWidget(id),
getWidget: (id) => this.bottombarElement!.getWidget(id),
clearWidgets: () => this.bottombarElement!.clearWidgets(),
addAction: (action) => this.bottombarElement!.addAction(action),
removeAction: (id) => this.bottombarElement!.removeAction(id),
clearActions: () => this.bottombarElement!.clearActions(),
};
}
/**
* Set bottom bar visibility
*/
public setBottomBarVisible(visible: boolean): void {
this.bottombarVisible = visible;
if (!visible) {
this.setAttribute('bottombar-hidden', '');
} else {
this.removeAttribute('bottombar-hidden');
}
}
/**
* Get bottom bar visibility state
*/
public getBottomBarVisible(): boolean {
return this.bottombarVisible;
}
// ========================================== // ==========================================
// PROGRAMMATIC API: NAVIGATION // PROGRAMMATIC API: NAVIGATION
// ========================================== // ==========================================
@@ -785,6 +932,23 @@ export class DeesAppuiBase extends DeesElement {
} }
} }
// Apply bottom bar config
if (config.bottomBar) {
this.setBottomBarVisible(config.bottomBar.visible ?? true);
if (config.bottomBar.widgets) {
config.bottomBar.widgets.forEach(widget => {
this.bottomBar.addWidget(widget);
});
}
if (config.bottomBar.actions) {
config.bottomBar.actions.forEach(action => {
this.bottomBar.addAction(action);
});
}
}
// Setup domtools.router integration // Setup domtools.router integration
this.setupRouterIntegration(config); this.setupRouterIntegration(config);

View File

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

View File

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

View File

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

View File

@@ -1,7 +1,8 @@
// App UI Components // App UI Components
export * from './dees-appui-activitylog/index.js'; export * from './dees-appui-activitylog/index.js';
export * from './dees-appui-appbar/index.js'; export * from './dees-appui-appbar/index.js';
export * from './dees-appui-base/index.js'; export * from './dees-appui-bottombar/index.js';
export * from './dees-appui/index.js';
export * from './dees-appui-maincontent/index.js'; export * from './dees-appui-maincontent/index.js';
export * from './dees-appui-mainmenu/index.js'; export * from './dees-appui-mainmenu/index.js';
export * from './dees-appui-secondarymenu/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 { chartAreaStyles } from './styles.js';
import { renderChartArea } from './template.js'; import { renderChartArea } from './template.js';
import ApexCharts from 'apexcharts'; import type ApexCharts from 'apexcharts';
import { DeesServiceLibLoader } from '../../../services/index.js';
declare global { declare global {
interface HTMLElementTagNameMap { interface HTMLElementTagNameMap {
@@ -150,7 +151,10 @@ export class DeesChartArea extends DeesElement {
public async firstUpdated() { public async firstUpdated() {
await this.domtoolsPromise; await this.domtoolsPromise;
// Load ApexCharts from CDN
const ApexChartsLib = await DeesServiceLibLoader.getInstance().loadApexCharts();
// Wait for next animation frame to ensure layout is complete // Wait for next animation frame to ensure layout is complete
await new Promise(resolve => requestAnimationFrame(resolve)); await new Promise(resolve => requestAnimationFrame(resolve));
@@ -353,7 +357,7 @@ export class DeesChartArea extends DeesElement {
}; };
try { try {
this.chart = new ApexCharts(this.shadowRoot.querySelector('.chartContainer'), options); this.chart = new ApexChartsLib(this.shadowRoot.querySelector('.chartContainer'), options);
await this.chart.render(); await this.chart.render();
// Give the chart a moment to fully initialize before resizing // Give the chart a moment to fully initialize before resizing

View File

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

View File

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

View File

@@ -2,9 +2,10 @@ import { BaseBlockHandler, type IBlockEventHandlers } from '../block.base.js';
import type { IBlock } from '../../wysiwyg.types.js'; import type { IBlock } from '../../wysiwyg.types.js';
import { cssManager } from '@design.estate/dees-element'; import { cssManager } from '@design.estate/dees-element';
import { WysiwygSelection } from '../../wysiwyg.selection.js'; import { WysiwygSelection } from '../../wysiwyg.selection.js';
import hlight from 'highlight.js'; import type { HLJSApi } from 'highlight.js';
import { cssGeistFontFamily, cssMonoFontFamily } from '../../../../00fonts.js'; import { cssGeistFontFamily, cssMonoFontFamily } from '../../../../00fonts.js';
import { PROGRAMMING_LANGUAGES } from '../../wysiwyg.constants.js'; import { PROGRAMMING_LANGUAGES } from '../../wysiwyg.constants.js';
import { DeesServiceLibLoader } from '../../../../../services/index.js';
/** /**
* CodeBlockHandler with improved architecture * CodeBlockHandler with improved architecture
@@ -18,8 +19,9 @@ import { PROGRAMMING_LANGUAGES } from '../../wysiwyg.constants.js';
*/ */
export class CodeBlockHandler extends BaseBlockHandler { export class CodeBlockHandler extends BaseBlockHandler {
type = 'code'; type = 'code';
private highlightTimer: any = null; private highlightTimer: any = null;
private highlightJs: HLJSApi | null = null;
render(block: IBlock, isSelected: boolean): string { render(block: IBlock, isSelected: boolean): string {
const language = block.metadata?.language || 'typescript'; const language = block.metadata?.language || 'typescript';
@@ -306,28 +308,33 @@ export class CodeBlockHandler extends BaseBlockHandler {
return linesBeforeCursor.length - 1; // 0-indexed 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; const editor = element.querySelector('.code-editor') as HTMLElement;
if (!editor) return; if (!editor) return;
// Load highlight.js from CDN if not already loaded
if (!this.highlightJs) {
this.highlightJs = await DeesServiceLibLoader.getInstance().loadHighlightJs();
}
// Store cursor position // Store cursor position
const cursorPos = this.getCursorPosition(element); const cursorPos = this.getCursorPosition(element);
// Get plain text content // Get plain text content
const content = editor.textContent || ''; const content = editor.textContent || '';
const language = block.metadata?.language || 'typescript'; const language = block.metadata?.language || 'typescript';
// Apply highlighting // Apply highlighting
try { try {
const result = hlight.highlight(content, { const result = this.highlightJs.highlight(content, {
language: language, language: language,
ignoreIllegals: true ignoreIllegals: true,
}); });
// Only update if we have valid highlighted content // Only update if we have valid highlighted content
if (result.value) { if (result.value) {
editor.innerHTML = result.value; editor.innerHTML = result.value;
// Restore cursor position if editor is focused // Restore cursor position if editor is focused
if (document.activeElement === editor && cursorPos !== null) { if (document.activeElement === editor && cursorPos !== null) {
requestAnimationFrame(() => { requestAnimationFrame(() => {

View File

@@ -1,4 +1,4 @@
import * as webcontainer from '@webcontainer/api'; import * as webcontainer from '@tempfix/webcontainer__api';
import type { IExecutionEnvironment, IFileEntry, IFileWatcher, IProcessHandle } from '../interfaces/IExecutionEnvironment.js'; import type { IExecutionEnvironment, IFileEntry, IFileWatcher, IProcessHandle } from '../interfaces/IExecutionEnvironment.js';
/** /**

View File

@@ -7,9 +7,10 @@ import {
css, css,
cssManager, cssManager,
} from '@design.estate/dees-element'; } from '@design.estate/dees-element';
import { Terminal } from 'xterm'; import type { Terminal } from 'xterm';
import { FitAddon } from 'xterm-addon-fit'; import type { FitAddon } from 'xterm-addon-fit';
import { themeDefaultStyles } from '../../00theme.js'; import { themeDefaultStyles } from '../../00theme.js';
import { DeesServiceLibLoader } from '../../../services/index.js';
declare global { declare global {
interface HTMLElementTagNameMap { interface HTMLElementTagNameMap {
@@ -305,8 +306,15 @@ export class DeesWorkspaceTerminalPreview extends DeesElement {
const domtoolsInstance = await this.domtoolsPromise; const domtoolsInstance = await this.domtoolsPromise;
const isBright = domtoolsInstance.themeManager.goBrightBoolean; const isBright = domtoolsInstance.themeManager.goBrightBoolean;
// Create xterm terminal in read-only mode // Load xterm from CDN
this.terminal = new Terminal({ 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, convertEol: true,
cursorBlink: false, cursorBlink: false,
disableStdin: true, disableStdin: true,
@@ -323,7 +331,7 @@ export class DeesWorkspaceTerminalPreview extends DeesElement {
} }
}); });
this.fitAddon = new FitAddon(); this.fitAddon = new fitAddonBundle.FitAddon();
this.terminal.loadAddon(this.fitAddon); this.terminal.loadAddon(this.fitAddon);
this.terminal.open(container); this.terminal.open(container);
this.fitAddon.fit(); this.fitAddon.fit();

View File

@@ -10,8 +10,7 @@ import {
} from '@design.estate/dees-element'; } from '@design.estate/dees-element';
import * as domtools from '@design.estate/dees-domtools'; import * as domtools from '@design.estate/dees-domtools';
import { Terminal } from 'xterm'; import type { Terminal } from 'xterm';
import { FitAddon } from 'xterm-addon-fit';
import { themeDefaultStyles } from '../../00theme.js'; import { themeDefaultStyles } from '../../00theme.js';
import type { IExecutionEnvironment } from '../../00group-runtime/index.js'; import type { IExecutionEnvironment } from '../../00group-runtime/index.js';
import { WebContainerEnvironment } from '../../00group-runtime/index.js'; import { WebContainerEnvironment } from '../../00group-runtime/index.js';
@@ -24,6 +23,7 @@ import type {
ICreateTerminalTabOptions, ICreateTerminalTabOptions,
TTerminalTabType, TTerminalTabType,
} from './interfaces.js'; } from './interfaces.js';
import { DeesServiceLibLoader } from '../../../services/index.js';
declare global { declare global {
interface HTMLElementTagNameMap { interface HTMLElementTagNameMap {
@@ -495,6 +495,16 @@ export class DeesWorkspaceTerminal extends DeesElement {
} }
); );
// 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 // Create default shell tab
await this.createShellTab(); await this.createShellTab();
} }

View File

@@ -1,6 +1,7 @@
import { Terminal } from 'xterm'; import type { Terminal, ITerminalOptions } from 'xterm';
import { FitAddon } from 'xterm-addon-fit'; import type { FitAddon } from 'xterm-addon-fit';
import type { ITerminalTab, ICreateTerminalTabOptions, TTerminalTabType } from './interfaces.js'; import type { ITerminalTab, ICreateTerminalTabOptions, TTerminalTabType } from './interfaces.js';
import type { IXtermBundle, IXtermFitAddonBundle } from '../../../services/index.js';
/** /**
* Manages terminal tabs lifecycle and state * Manages terminal tabs lifecycle and state
@@ -8,6 +9,17 @@ import type { ITerminalTab, ICreateTerminalTabOptions, TTerminalTabType } from '
export class TerminalTabManager { export class TerminalTabManager {
private tabs: Map<string, ITerminalTab> = new Map(); private tabs: Map<string, ITerminalTab> = new Map();
private tabCounter: number = 0; 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 * Generate unique tab ID
@@ -96,11 +108,15 @@ export class TerminalTabManager {
* Create a new tab instance * Create a new tab instance
*/ */
createTab(options: ICreateTerminalTabOptions, isBright: boolean): ITerminalTab { 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 id = this.generateTabId();
const type = options.type; const type = options.type;
// Create xterm.js Terminal instance // Create xterm.js Terminal instance using CDN-loaded module
const terminal = new Terminal({ const terminal = new this.xtermBundle.Terminal({
convertEol: true, convertEol: true,
cursorBlink: true, cursorBlink: true,
theme: this.getTerminalTheme(isBright), theme: this.getTerminalTheme(isBright),
@@ -109,8 +125,8 @@ export class TerminalTabManager {
lineHeight: 1.2, lineHeight: 1.2,
}); });
// Create FitAddon // Create FitAddon using CDN-loaded module
const fitAddon = new FitAddon(); const fitAddon = new this.xtermFitAddonBundle.FitAddon();
terminal.loadAddon(fitAddon); terminal.loadAddon(fitAddon);
const tab: ITerminalTab = { const tab: ITerminalTab = {

View File

@@ -12,7 +12,7 @@ import * as domtools from '@design.estate/dees-domtools';
import { themeDefaultStyles } from '../../00theme.js'; import { themeDefaultStyles } from '../../00theme.js';
import type { IExecutionEnvironment, IFileWatcher } from '../../00group-runtime/index.js'; import type { IExecutionEnvironment, IFileWatcher } from '../../00group-runtime/index.js';
import { WebContainerEnvironment } from '../../00group-runtime/index.js'; import { WebContainerEnvironment } from '../../00group-runtime/index.js';
import type { FileSystemTree } from '@webcontainer/api'; import type { FileSystemTree } from '@tempfix/webcontainer__api';
import '../dees-workspace-monaco/dees-workspace-monaco.js'; import '../dees-workspace-monaco/dees-workspace-monaco.js';
import '../dees-workspace-filetree/dees-workspace-filetree.js'; import '../dees-workspace-filetree/dees-workspace-filetree.js';
import { DeesWorkspaceFiletree } from '../dees-workspace-filetree/dees-workspace-filetree.js'; import { DeesWorkspaceFiletree } from '../dees-workspace-filetree/dees-workspace-filetree.js';
@@ -182,7 +182,7 @@ testSmartPromise();
await env.mount(fileTree); await env.mount(fileTree);
})(); })();
// Create container element for proper 100% height like dees-appui-base // Create container element for proper 100% height like dees-appui
const containerElement = document.createElement('div'); const containerElement = document.createElement('div');
containerElement.style.cssText = 'position: absolute; top: 0; left: 0; height: 100%; width: 100%; overflow: hidden;'; containerElement.style.cssText = 'position: absolute; top: 0; left: 0; height: 100%; width: 100%; overflow: hidden;';

View File

@@ -128,22 +128,30 @@ export class DeesActionbar extends DeesElement {
cssManager.defaultStyles, cssManager.defaultStyles,
css` css`
:host { :host {
display: grid; display: block;
grid-template-rows: 0fr;
transition: grid-template-rows 0.2s ease-out;
}
:host(.visible) {
grid-template-rows: 1fr;
} }
.actionbar-item { .actionbar-item {
display: flex; display: grid;
flex-direction: column; grid-template-rows: 0fr;
min-height: 0; transition: grid-template-rows 0.2s ease-out;
background: ${cssManager.bdTheme('hsl(0 0% 96%)', 'hsl(0 0% 12%)')}; 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%)')}; 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; overflow: hidden;
min-height: 0;
opacity: 0;
transition: opacity 0.2s ease-out;
}
:host(.visible) .actionbar-content {
opacity: 1;
} }
.progress-bar { .progress-bar {
@@ -305,47 +313,48 @@ export class DeesActionbar extends DeesElement {
]; ];
public render(): TemplateResult { public render(): TemplateResult {
if (!this.currentBar) {
return html``;
}
const bar = this.currentBar; const bar = this.currentBar;
const type = bar.type || 'info'; const type = bar?.type || 'info';
const hasTimeout = bar.timeout && this.timeRemaining > 0; const hasTimeout = bar?.timeout && this.timeRemaining > 0;
// ALWAYS render wrapper - required for grid animation to work
return html` return html`
<div class="actionbar-item"> <div class="actionbar-item">
${hasTimeout ? html` <div class="actionbar-content">
<div class="progress-bar"> ${bar ? html`
<div ${hasTimeout ? html`
class="progress-bar-fill ${type}" <div class="progress-bar">
style="width: ${this.progressPercent}%" <div
></div> class="progress-bar-fill ${type}"
</div> style="width: ${this.progressPercent}%"
` : ''} ></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 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>
</div> </div>
`; `;
@@ -433,7 +442,7 @@ export class DeesActionbar extends DeesElement {
this.currentResolve = null; this.currentResolve = null;
} }
private processQueue(): void { private async processQueue(): Promise<void> {
if (this.queue.length === 0) { if (this.queue.length === 0) {
// Hide with animation - don't await, let it run async // Hide with animation - don't await, let it run async
this.hideCurrentBar(); this.hideCurrentBar();
@@ -444,7 +453,12 @@ export class DeesActionbar extends DeesElement {
this.currentBar = item.options; this.currentBar = item.options;
this.currentResolve = item.resolve; this.currentResolve = item.resolve;
this.isVisible = true; this.isVisible = true;
this.classList.add('visible');
// 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 // Setup timeout if configured
if (item.options.timeout) { if (item.options.timeout) {

View File

@@ -257,12 +257,13 @@ export class DeesIcon extends DeesElement {
* @returns Object with type and name properties * @returns Object with type and name properties
*/ */
private parseIconString(iconStr: string): { type: 'fa' | 'lucide', name: string } { private parseIconString(iconStr: string): { type: 'fa' | 'lucide', name: string } {
if (iconStr.startsWith('fa:')) { const lowerStr = iconStr.toLowerCase();
if (lowerStr.startsWith('fa:')) {
return { return {
type: 'fa', type: 'fa',
name: iconStr.substring(3) // Remove 'fa:' prefix name: iconStr.substring(3) // Remove 'fa:' prefix
}; };
} else if (iconStr.startsWith('lucide:')) { } else if (lowerStr.startsWith('lucide:')) {
return { return {
type: 'lucide', type: 'lucide',
name: iconStr.substring(7) // Remove 'lucide:' prefix name: iconStr.substring(7) // Remove 'lucide:' prefix

View File

@@ -2,9 +2,108 @@ import type { TemplateResult } from '@design.estate/dees-element';
import type { IAppBarMenuItem } from './appbarmenuitem.js'; import type { IAppBarMenuItem } from './appbarmenuitem.js';
import type { IMenuItem } from './tab.js'; import type { IMenuItem } from './tab.js';
import type { IMenuGroup } from './menugroup.js'; import type { IMenuGroup } from './menugroup.js';
import type { ISecondaryMenuGroup, ISecondaryMenuItem } from './secondarymenu.js';
// ==========================================
// BOTTOM BAR INTERFACES
// ==========================================
/**
* Bottom bar widget status for styling
*/
export type TBottomBarWidgetStatus = 'idle' | 'active' | 'success' | 'warning' | 'error';
/**
* Generic status widget for the bottom bar
*/
export interface IBottomBarWidget {
/** Unique identifier for the widget */
id: string;
/** Icon to display (lucide icon name) */
iconName?: string;
/** Text label to display */
label?: string;
/** Status affects styling (colors) */
status?: TBottomBarWidgetStatus;
/** Tooltip text */
tooltip?: string;
/** Whether the widget shows a loading spinner */
loading?: boolean;
/** Click handler for the widget */
onClick?: () => void;
/** Optional context menu items on right-click */
contextMenuItems?: IBottomBarContextMenuItem[];
/** Position: 'left' (default) or 'right' */
position?: 'left' | 'right';
/** Order within position group (lower = earlier) */
order?: number;
}
/**
* Context menu item for bottom bar widgets
*/
export interface IBottomBarContextMenuItem {
name: string;
iconName?: string;
action: () => void | Promise<void>;
disabled?: boolean;
divider?: boolean;
}
/**
* Bottom bar action (quick action button)
*/
export interface IBottomBarAction {
/** Unique identifier */
id: string;
/** Icon to display */
iconName: string;
/** Tooltip */
tooltip?: string;
/** Click handler */
onClick: () => void | Promise<void>;
/** Whether action is disabled */
disabled?: boolean;
/** Position: 'left' or 'right' (default) */
position?: 'left' | 'right';
}
/**
* Bottom bar configuration
*/
export interface IBottomBarConfig {
/** Whether bottom bar is visible */
visible?: boolean;
/** Initial widgets */
widgets?: IBottomBarWidget[];
/** Initial actions */
actions?: IBottomBarAction[];
}
/**
* Bottom bar programmatic API
*/
export interface IBottomBarAPI {
/** Add a widget */
addWidget: (widget: IBottomBarWidget) => void;
/** Update an existing widget by ID */
updateWidget: (id: string, update: Partial<IBottomBarWidget>) => void;
/** Remove a widget by ID */
removeWidget: (id: string) => void;
/** Get a widget by ID */
getWidget: (id: string) => IBottomBarWidget | undefined;
/** Clear all widgets */
clearWidgets: () => void;
/** Add an action button */
addAction: (action: IBottomBarAction) => void;
/** Remove an action by ID */
removeAction: (id: string) => void;
/** Clear all actions */
clearActions: () => void;
}
// Forward declaration for circular reference // Forward declaration for circular reference
export type TDeesAppuiBase = HTMLElement & { export type TDeesAppui = HTMLElement & {
setAppBarMenus: (menus: IAppBarMenuItem[]) => void; setAppBarMenus: (menus: IAppBarMenuItem[]) => void;
updateAppBarMenu: (name: string, update: Partial<IAppBarMenuItem>) => void; updateAppBarMenu: (name: string, update: Partial<IAppBarMenuItem>) => void;
setBreadcrumbs: (breadcrumbs: string | string[]) => void; setBreadcrumbs: (breadcrumbs: string | string[]) => void;
@@ -25,9 +124,9 @@ export type TDeesAppuiBase = HTMLElement & {
setContentTabsAutoHide: (enabled: boolean, threshold?: number) => void; setContentTabsAutoHide: (enabled: boolean, threshold?: number) => void;
setMainMenuBadge: (tabKey: string, badge: string | number) => void; setMainMenuBadge: (tabKey: string, badge: string | number) => void;
clearMainMenuBadge: (tabKey: string) => void; clearMainMenuBadge: (tabKey: string) => void;
setSecondaryMenu: (config: { heading?: string; groups: IMenuGroup[] }) => void; setSecondaryMenu: (config: { heading?: string; groups: ISecondaryMenuGroup[] }) => void;
updateSecondaryMenuGroup: (groupName: string, update: Partial<IMenuGroup>) => void; updateSecondaryMenuGroup: (groupName: string, update: Partial<ISecondaryMenuGroup>) => void;
addSecondaryMenuItem: (groupName: string, item: IMenuGroup['items'][0]) => void; addSecondaryMenuItem: (groupName: string, item: ISecondaryMenuItem) => void;
setSecondaryMenuSelection: (itemKey: string) => void; setSecondaryMenuSelection: (itemKey: string) => void;
clearSecondaryMenu: () => void; clearSecondaryMenu: () => void;
setContentTabs: (tabs: IMenuItem[]) => void; setContentTabs: (tabs: IMenuItem[]) => void;
@@ -36,8 +135,15 @@ export type TDeesAppuiBase = HTMLElement & {
selectContentTab: (tabKey: string) => void; selectContentTab: (tabKey: string) => void;
getSelectedContentTab: () => IMenuItem | undefined; getSelectedContentTab: () => IMenuItem | undefined;
activityLog: IActivityLogAPI; activityLog: IActivityLogAPI;
setActivityLogVisible: (visible: boolean) => void;
toggleActivityLog: () => void;
getActivityLogVisible: () => boolean;
navigateToView: (viewId: string, params?: Record<string, string>) => Promise<boolean>; navigateToView: (viewId: string, params?: Record<string, string>) => Promise<boolean>;
getCurrentView: () => IViewDefinition | undefined; getCurrentView: () => IViewDefinition | undefined;
// Bottom bar
bottomBar: IBottomBarAPI;
setBottomBarVisible: (visible: boolean) => void;
getBottomBarVisible: () => boolean;
}; };
/** /**
@@ -92,8 +198,8 @@ export interface IActivityLogAPI {
* View activation context passed to onActivate lifecycle hook * View activation context passed to onActivate lifecycle hook
*/ */
export interface IViewActivationContext { export interface IViewActivationContext {
/** Reference to the DeesAppuiBase instance */ /** Reference to the DeesAppui instance */
appui: TDeesAppuiBase; appui: TDeesAppui;
/** The view ID being activated */ /** The view ID being activated */
viewId: string; viewId: string;
/** Route parameters if any */ /** Route parameters if any */
@@ -136,7 +242,7 @@ export interface IViewDefinition {
| (() => TemplateResult) | (() => TemplateResult)
| (() => Promise<string | (new () => HTMLElement) | (() => TemplateResult)>); | (() => Promise<string | (new () => HTMLElement) | (() => TemplateResult)>);
/** Secondary menu items specific to this view */ /** Secondary menu items specific to this view */
secondaryMenu?: IMenuGroup[]; secondaryMenu?: ISecondaryMenuGroup[];
/** Content tabs specific to this view */ /** Content tabs specific to this view */
contentTabs?: IMenuItem[]; contentTabs?: IMenuItem[];
/** Optional route path (defaults to id). Supports params like 'settings/:section' */ /** Optional route path (defaults to id). Supports params like 'settings/:section' */
@@ -208,7 +314,7 @@ export interface IActivityLogConfig {
} }
/** /**
* Main unified configuration interface for dees-appui-base * Main unified configuration interface for dees-appui
*/ */
export interface IAppConfig { export interface IAppConfig {
/** Application branding */ /** Application branding */
@@ -229,6 +335,9 @@ export interface IAppConfig {
/** Activity log configuration */ /** Activity log configuration */
activityLog?: IActivityLogConfig; activityLog?: IActivityLogConfig;
/** Bottom bar configuration */
bottomBar?: IBottomBarConfig;
/** Event callbacks */ /** Event callbacks */
onViewChange?: (viewId: string, view: IViewDefinition) => void; onViewChange?: (viewId: string, view: IViewDefinition) => void;
onSearch?: (query: string) => void; onSearch?: (query: string) => void;

View File

@@ -2,3 +2,4 @@ export * from './tab.js';
export * from './appbarmenuitem.js'; export * from './appbarmenuitem.js';
export * from './menugroup.js'; export * from './menugroup.js';
export * from './appconfig.js'; export * from './appconfig.js';
export * from './secondarymenu.js';

View File

@@ -0,0 +1,93 @@
/**
* Secondary Menu Item Types
*
* Supports 8 item types:
* 1. Tab - selectable, stays highlighted (existing behavior)
* 2. Action - executes without selection (primary = blue)
* 3. Danger Action - red styling with optional confirmation
* 4. Filter - checkbox toggle, emits immediately
* 5. Multi-Filter - collapsible box with multiple checkboxes
* 6. Divider - visual separator
* 7. Header - non-interactive label
* 8. Link - opens URL
*/
// Base properties shared by interactive items
export interface ISecondaryMenuItemBase {
key: string;
iconName?: string;
disabled?: boolean;
hidden?: boolean;
}
// 1. Tab - existing behavior (selectable, stays highlighted)
export interface ISecondaryMenuItemTab extends ISecondaryMenuItemBase {
type?: 'tab'; // default if omitted for backward compatibility
action: () => void;
badge?: string | number;
badgeVariant?: 'default' | 'success' | 'warning' | 'error';
}
// 2 & 3. Action - executes without selection
export interface ISecondaryMenuItemAction extends ISecondaryMenuItemBase {
type: 'action';
action: () => void | Promise<void>;
variant?: 'primary' | 'danger'; // primary = blue (default), danger = red
confirmMessage?: string; // Shows confirmation dialog before executing
}
// 4. Single filter toggle
export interface ISecondaryMenuItemFilter extends ISecondaryMenuItemBase {
type: 'filter';
active: boolean;
onToggle: (active: boolean) => void;
}
// 5. Multi-select filter group (collapsible)
export interface ISecondaryMenuItemMultiFilter extends ISecondaryMenuItemBase {
type: 'multiFilter';
collapsed?: boolean; // Accordion state
options: Array<{
key: string;
label: string;
checked: boolean;
iconName?: string;
}>;
onChange: (selectedKeys: string[]) => void;
}
// 6. Divider
export interface ISecondaryMenuItemDivider {
type: 'divider';
}
// 7. Header/Label
export interface ISecondaryMenuItemHeader {
type: 'header';
label: string;
}
// 8. External link
export interface ISecondaryMenuItemLink extends ISecondaryMenuItemBase {
type: 'link';
href: string;
external?: boolean; // Opens in new tab (default: true if href starts with http)
}
// Union type for all secondary menu items
export type ISecondaryMenuItem =
| ISecondaryMenuItemTab
| ISecondaryMenuItemAction
| ISecondaryMenuItemFilter
| ISecondaryMenuItemMultiFilter
| ISecondaryMenuItemDivider
| ISecondaryMenuItemHeader
| ISecondaryMenuItemLink;
// Group interface for secondary menu
export interface ISecondaryMenuGroup {
name: string;
iconName?: string;
collapsed?: boolean;
items: ISecondaryMenuItem[];
}

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", "moduleResolution": "NodeNext",
"esModuleInterop": true, "esModuleInterop": true,
"verbatimModuleSyntax": true, "verbatimModuleSyntax": true,
"skipLibCheck": true "skipLibCheck": false
}, },
"exclude": [ "exclude": [
"dist_*/**/*.d.ts" "dist_*/**/*.d.ts"