Compare commits

...

25 Commits

Author SHA1 Message Date
13923d9feb v3.35.0
Some checks failed
Default (tags) / security (push) Failing after 1s
Default (tags) / test (push) Failing after 1s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-01-12 18:00:16 +00:00
e981ddf2d6 feat(dees-statsgrid): add cpuCores tile type with column spanning, rendering, demo and docs 2026-01-12 18:00:16 +00:00
b478ae3071 v3.34.1
Some checks failed
Default (tags) / security (push) Failing after 1s
Default (tags) / test (push) Failing after 1s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-01-12 01:29:04 +00:00
d329d0b171 fix(deps): move @design.estate/dees-wcctools from devDependencies to dependencies 2026-01-12 01:29:04 +00:00
74c39482de v3.34.0
Some checks failed
Default (tags) / security (push) Failing after 18s
Default (tags) / test (push) Failing after 12s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-01-07 18:42:00 +00:00
51611d76dd feat(dees-input-toggle): Add DeesInputToggle component (toggle switch) with demo and exports; integrate into inputs and DeesForm 2026-01-07 18:42:00 +00:00
496084f870 v3.33.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-06 00:45:10 +00:00
c7bff04ae5 feat(dees-statsgrid): add multiPercentage tile type to stats grid 2026-01-06 00:45:10 +00:00
e71efd409b update 2026-01-05 12:07:05 +00:00
43db777f2c v3.32.0
Some checks failed
Default (tags) / security (push) Failing after 12s
Default (tags) / test (push) Failing after 12s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-01-04 17:09:18 +00:00
9bd1734d09 feat(demo): add demoGroup metadata to components and update related dependencies 2026-01-04 17:09:18 +00:00
aafdb4af72 v3.31.0
Some checks failed
Default (tags) / security (push) Failing after 15s
Default (tags) / test (push) Failing after 14s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-01-04 10:16:50 +00:00
67a24ddf26 feat(dees-input-list): enhance drag-and-drop reordering for dees-input-list and migrate tests to chromium runner 2026-01-04 10:16:50 +00:00
2a928886b9 v3.30.1
Some checks failed
Default (tags) / security (push) Failing after 15s
Default (tags) / test (push) Failing after 15s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-01-04 09:21:02 +00:00
4d192654df fix(dees-statsgrid): refine spacing, sizing, and colors in dees-statsgrid for a tighter, more compact appearance 2026-01-04 09:21:02 +00:00
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
95 changed files with 4890 additions and 406 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 125 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 125 KiB

View File

@@ -1,5 +1,104 @@
# Changelog
## 2026-01-12 - 3.35.0 - feat(dees-statsgrid)
add cpuCores tile type with column spanning, rendering, demo and docs
- Introduce ICpuCore and coresData on IStatsTile to represent per-core usage
- Implement renderCpuCores with responsive vertical bars, color thresholds (low/medium/high) and average usage header
- Add columnSpan support for tiles and apply it to grid items (style grid-column: span N)
- Add demo entries (8/16/32 core examples), Randomize grid action and updated demo layout
- Document StatsGrid enhancements in readme.hints.md (usage examples and available tile types)
- Bump devDependencies (@git.zone/tsbuild, @git.zone/tsbundle, @types/node), simplify build script to use tsbundle, and add @git.zone/tsbundle config in npmextra.json
## 2026-01-12 - 3.34.1 - fix(deps)
move @design.estate/dees-wcctools from devDependencies to dependencies
- Promoted @design.estate/dees-wcctools@^3.7.1 to runtime dependencies so it will be installed in production builds.
## 2026-01-07 - 3.34.0 - feat(dees-input-toggle)
Add DeesInputToggle component (toggle switch) with demo and exports; integrate into inputs and DeesForm
- New UI input component: ts_web/elements/00group-input/dees-input-toggle/dees-input-toggle.ts — toggle switch with pointer drag, keyboard support, value syncing and DeesInputBase integration.
- Interactive demo added: ts_web/elements/00group-input/dees-input-toggle/dees-input-toggle.demo.ts demonstrating usage, batch operations and event handling.
- Module exports updated: added ts_web/elements/00group-input/dees-input-toggle/index.ts and exported from ts_web/elements/00group-input/index.ts.
- DeesForm integration: imported DeesInputToggle and added it to the form components array and input union types in ts_web/elements/00group-form/dees-form/dees-form.ts
## 2026-01-06 - 3.33.0 - feat(dees-statsgrid)
add multiPercentage tile type to stats grid
- Add new 'multiPercentage' type to IStatsTile (percentages: [{label, value, color?}])
- Implement renderMultiPercentage() to render up to 3 percentage items with label, value and colored progress bars
- Add CSS styles for multi-percentage layout, bars, labels and values
- Update demo to replace 'Error Rate' tile with a 'Resource Usage' multiPercentage example (CPU, Memory, Disk)
- Change is additive and backward-compatible with existing tile types
## 2026-01-04 - 3.32.0 - feat(demo)
add demoGroup metadata to components and update related dependencies
- Add public static demoGroup properties to many components to categorize demos (groups added: App UI, Button, Chart, Data View, Form, Input, PDF, Simple, Workspace).
- Bump package deps/devDeps: @design.estate/dees-domtools -> ^2.3.7, @design.estate/dees-element -> ^2.1.5, @design.estate/dees-wcctools -> ^3.7.1.
- Clean up package.json deps (removed duplicate entries and removed 'lit' dependency).
- Refactor dees-pdf-viewer to use consolidated directives import (directives.keyed and directives.repeat) instead of separate keyed/repeat imports.
## 2026-01-04 - 3.31.0 - feat(dees-input-list)
enhance drag-and-drop reordering for dees-input-list and migrate tests to chromium runner
- Add rich drag state to dees-input-list: dragStartY, dragCurrentY, targetIndex, itemHeight and originalItemRects for accurate hit detection.
- Introduce bound global drag handlers and centralized global drag end/cleanup logic (handleGlobalDragOver / handleGlobalDragEnd).
- Improve drag visuals and animations: 'dragging', 'move-up', 'move-down' transforms, box-shadow, and smoother transitions; prevent hover styling while dragging.
- Move reorder logic away from per-item drop to global drag end to avoid race/positioning issues and ensure consistent reflow and cleanup.
- Migrate many browser test files to chromium-specific variants (added *.chromium.ts) and remove duplicate browser test counterparts.
## 2026-01-04 - 3.30.1 - fix(dees-statsgrid)
refine spacing, sizing, and colors in dees-statsgrid for a tighter, more compact appearance
- Reduce global spacing and sizing variables (grid-gap 16→12, tile-padding 24→16, header-spacing 16→12, content-min-height 48→40, description-spacing 12→8, border-radius 8→6).
- Adjust typographic scale (value-font-size 30→26, unit-font-size 16→14, label-font-size 13→12, title-font-size 14→13).
- Switch color tokens to neutral hex values and tighten hover/box-shadow (tile border and backgrounds updated from HSL to hex, hover bg to #fafafa/#0d0d0d, border-color and shadow reduced).
- Downsize graphical elements: gauge and SVG dimensions (width 140→120, height 80→70), stroke-widths 8→6, radius 48→40.
- Slim down percentage bar and trend visuals (percentage bar height 8→6, border-radius 4→3, trend stroke-width 2→1.5, trend fill moved to RGBA).
- No functional or API changes — purely visual/CSS and SVG adjustments.
## 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

View File

@@ -49,5 +49,15 @@
},
"@ship.zone/szci": {
"npmGlobalTools": []
},
"@git.zone/tsbundle": {
"bundles": [
{
"from": "./ts_web/index.ts",
"to": "./dist_bundle/bundle.js",
"outputMode": "bundle",
"bundler": "esbuild"
}
]
}
}

View File

@@ -1,6 +1,6 @@
{
"name": "@design.estate/dees-catalog",
"version": "3.28.1",
"version": "3.35.0",
"private": false,
"description": "A comprehensive library that provides dynamic web components for building sophisticated and modern web applications using JavaScript and TypeScript.",
"main": "dist_ts_web/index.js",
@@ -8,7 +8,7 @@
"type": "module",
"scripts": {
"test": "tstest test/ --web --verbose --timeout 30 --logfile",
"build": "tsbuild tsfolders --allowimplicitany && tsbundle element --production --bundler esbuild",
"build": "tsbuild tsfolders --allowimplicitany && tsbundle",
"watch": "tswatch element",
"buildDocs": "tsdoc",
"postinstall": "node scripts/update-monaco-version.cjs"
@@ -16,8 +16,9 @@
"author": "Lossless GmbH",
"license": "MIT",
"dependencies": {
"@design.estate/dees-domtools": "^2.3.6",
"@design.estate/dees-element": "^2.1.3",
"@design.estate/dees-domtools": "^2.3.7",
"@design.estate/dees-element": "^2.1.5",
"@design.estate/dees-wcctools": "^3.7.1",
"@fortawesome/fontawesome-svg-core": "^7.1.0",
"@fortawesome/free-brands-svg-icons": "^7.1.0",
"@fortawesome/free-regular-svg-icons": "^7.1.0",
@@ -25,6 +26,7 @@
"@push.rocks/smarti18n": "^1.0.4",
"@push.rocks/smartpromise": "^4.2.0",
"@push.rocks/smartstring": "^4.1.0",
"@tempfix/webcontainer__api": "1.6.1",
"@tiptap/core": "^2.23.0",
"@tiptap/extension-link": "^2.23.0",
"@tiptap/extension-text-align": "^2.23.0",
@@ -32,11 +34,9 @@
"@tiptap/extension-underline": "^2.23.0",
"@tiptap/starter-kit": "^2.23.0",
"@tsclass/tsclass": "^9.3.0",
"@tempfix/webcontainer__api": "1.6.1",
"apexcharts": "^5.3.6",
"highlight.js": "11.11.1",
"ibantools": "^4.5.1",
"lit": "^3.3.1",
"lucide": "^0.562.0",
"monaco-editor": "0.55.1",
"pdfjs-dist": "^4.10.38",
@@ -44,13 +44,12 @@
"xterm-addon-fit": "^0.8.0"
},
"devDependencies": {
"@design.estate/dees-wcctools": "^3.4.0",
"@git.zone/tsbuild": "^4.0.2",
"@git.zone/tsbundle": "^2.6.3",
"@git.zone/tsbuild": "^4.1.0",
"@git.zone/tsbundle": "^2.8.1",
"@git.zone/tstest": "^3.1.4",
"@git.zone/tswatch": "^2.3.13",
"@push.rocks/projectinfo": "^5.0.2",
"@types/node": "^25.0.3"
"@types/node": "^25.0.6"
},
"files": [
"ts/**/*",

2012
pnpm-lock.yaml generated

File diff suppressed because it is too large Load Diff

View File

@@ -801,3 +801,176 @@ html`
- **State Persistence**: Save/restore collapsed menus, selections, and current view
- **View-specific Menus**: Each view can define its own secondary menu and tabs
- **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
## StatsGrid Enhancements (2026-01-12)
### Column Spanning
Tiles can now span multiple columns using the `columnSpan` property. This is useful for wider visualizations like the CPU cores tile.
```typescript
const tile: IStatsTile = {
id: 'wide-tile',
title: 'Wide Tile',
value: 100,
type: 'cpuCores',
columnSpan: 2, // Spans 2 columns
coresData: [...]
};
```
Note: On smaller screens where only 1 column fits, tiles will automatically fall back to single column width.
### CPU Cores Tile Type
New tile type `cpuCores` for visualizing multi-core CPU usage with vertical bars:
```typescript
interface ICpuCore {
id: string | number;
usage: number; // 0-100
label?: string;
}
const cpuTile: IStatsTile = {
id: 'cpu-cores',
title: 'CPU Cores',
value: 0, // Not used, avg is calculated from coresData
type: 'cpuCores',
icon: 'lucide:cpu',
columnSpan: 2, // Recommended for 8+ cores
coresData: [
{ id: 0, usage: 45, label: '0' },
{ id: 1, usage: 72, label: '1' },
// ... more cores
],
description: 'Intel i7 - 8 cores'
};
```
Features:
- Vertical bars showing individual core usage
- Color-coded: green (<50%), yellow (50-80%), red (>80%)
- Shows average usage in header
- Core labels shown for 16 or fewer cores
- Tooltips show exact usage per core
- Responsive: bars flex to fill available width
### Available Tile Types:
- `number` - Simple numeric display
- `gauge` - Semi-circular gauge with thresholds
- `percentage` - Progress bar (0-100%)
- `trend` - Sparkline with recent data
- `text` - Text value display
- `multiPercentage` - Multiple progress bars
- `cpuCores` - Vertical bar visualization for CPU cores

159
readme.md
View File

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

View File

View File

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

View File

@@ -20,6 +20,7 @@ import { themeDefaultStyles } from '../../00theme.js';
export class DeesAppuiActivitylog extends DeesElement implements IActivityLogAPI {
// STATIC
public static demo = demoFunc;
public static demoGroup = 'App UI';
// INSTANCE PROPERTIES
@state()
@@ -122,6 +123,7 @@ export class DeesAppuiActivitylog extends DeesElement implements IActivityLogAPI
width: 100%;
padding: 8px 0;
overflow-y: auto;
overscroll-behavior: contain;
scrollbar-width: thin;
scrollbar-color: ${cssManager.bdTheme('#d4d4d4', '#333333')} transparent;
}

View File

@@ -28,6 +28,7 @@ declare global {
@customElement('dees-appui-appbar')
export class DeesAppuiBar extends DeesElement {
public static demo = demoFunc;
public static demoGroup = 'App UI';
// INSTANCE PROPERTIES
@property({ type: Array })

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,315 @@
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;
public static demoGroup = 'App UI';
// 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

@@ -31,6 +31,7 @@ export class DeesAppuiMaincontent extends DeesElement {
</div>
</dees-appui-maincontent>
`;
public static demoGroup = 'App UI';
// INSTANCE
@property({

View File

@@ -22,6 +22,7 @@ import { themeDefaultStyles } from '../../00theme.js';
@customElement('dees-appui-mainmenu')
export class DeesAppuiMainmenu extends DeesElement {
public static demo = demoFunc;
public static demoGroup = 'App UI';
// INSTANCE
@@ -164,6 +165,7 @@ export class DeesAppuiMainmenu extends DeesElement {
flex: 1;
overflow-y: auto;
overflow-x: hidden;
overscroll-behavior: contain;
padding: 8px 0;
}

View File

@@ -35,6 +35,7 @@ export class DeesAppuiProfileDropdown extends DeesElement {
.isOpen=${true}
></dees-appui-profiledropdown>
`;
public static demoGroup = 'App UI';
@property({ type: Object })
accessor user: {
@@ -285,6 +286,7 @@ export class DeesAppuiProfileDropdown extends DeesElement {
max-width: calc(100vw - 32px);
max-height: calc(100vh - 32px);
overflow-y: auto;
overscroll-behavior: contain;
}
:host([isopen]) .dropdown {

View File

@@ -33,6 +33,7 @@ import { themeDefaultStyles } from '../../00theme.js';
@customElement('dees-appui-secondarymenu')
export class DeesAppuiSecondarymenu extends DeesElement {
public static demo = demoFunc;
public static demoGroup = 'App UI';
// INSTANCE
@@ -201,6 +202,7 @@ export class DeesAppuiSecondarymenu extends DeesElement {
flex: 1;
overflow-y: auto;
overflow-x: hidden;
overscroll-behavior: contain;
padding: 8px 0;
}

View File

@@ -18,6 +18,7 @@ import { themeDefaultStyles } from '../../00theme.js';
@customElement('dees-appui-tabs')
export class DeesAppuiTabs extends DeesElement {
public static demo = demoFunc;
public static demoGroup = 'App UI';
// INSTANCE
@property({
@@ -116,6 +117,7 @@ export class DeesAppuiTabs extends DeesElement {
font-size: 14px;
overflow-x: auto;
overflow-y: hidden;
overscroll-behavior: contain;
scrollbar-width: thin;
scrollbar-color: transparent transparent;
height: 100%;

View File

@@ -3,6 +3,8 @@ import type { DeesAppui } from './dees-appui.js';
import type { IAppConfig, IViewActivationContext } from '../../interfaces/appconfig.js';
import type * as interfaces from '../../interfaces/index.js';
import '@design.estate/dees-wcctools/demotools';
import '../../dees-statsgrid/dees-statsgrid.js';
import type { IStatsTile } from '../../dees-statsgrid/dees-statsgrid.js';
// Demo view component with lifecycle hooks
@customElement('demo-dashboard-view')
@@ -12,6 +14,79 @@ class DemoDashboardView extends DeesElement {
private ctx: IViewActivationContext;
private statsTiles: IStatsTile[] = [
{
id: 'users',
title: 'Active Users',
value: 1234,
type: 'number',
icon: 'lucide:users',
description: 'Online now',
color: '#22c55e'
},
{
id: 'api-calls',
title: 'API Calls',
value: 45200,
type: 'trend',
icon: 'lucide:activity',
description: '+12% from last hour',
color: '#3b82f6',
trendData: [32000, 35000, 38000, 41000, 39000, 42000, 45200]
},
{
id: 'health',
title: 'System Health',
value: 99.9,
unit: '%',
type: 'gauge',
icon: 'lucide:heart-pulse',
description: 'All systems operational',
color: '#10b981',
gaugeOptions: {
min: 0,
max: 100,
thresholds: [
{ value: 80, color: '#ef4444' },
{ value: 95, color: '#f59e0b' },
{ value: 100, color: '#10b981' }
]
}
},
{
id: 'response',
title: 'Avg Response',
value: 127,
unit: 'ms',
type: 'number',
icon: 'lucide:timer',
description: '-15ms from yesterday',
color: '#8b5cf6'
},
{
id: 'resources',
title: 'Resource Usage',
value: '',
type: 'multiPercentage',
icon: 'lucide:server',
percentages: [
{ label: 'CPU', value: 67, color: '#3b82f6' },
{ label: 'Memory', value: 84, color: '#8b5cf6' },
{ label: 'Disk', value: 45, color: '#10b981' }
]
},
{
id: 'requests',
title: 'Requests/sec',
value: 1850,
type: 'trend',
icon: 'lucide:zap',
description: 'Current throughput',
color: '#06b6d4',
trendData: [1200, 1400, 1350, 1600, 1750, 1680, 1850]
}
];
onActivate(context: IViewActivationContext) {
this.ctx = context;
this.activated = true;
@@ -83,21 +158,9 @@ class DemoDashboardView extends DeesElement {
}
h1 { color: #fafafa; font-weight: 600; font-size: 24px; margin-bottom: 8px; }
p { color: #737373; margin-bottom: 32px; }
.grid {
display: grid;
grid-template-columns: repeat(3, 1fr);
gap: 16px;
dees-statsgrid {
margin-bottom: 32px;
}
.card {
background: rgba(255,255,255,0.03);
border: 1px solid rgba(255,255,255,0.08);
border-radius: 8px;
padding: 20px;
}
.card h3 { color: #fafafa; font-size: 14px; font-weight: 600; margin-bottom: 8px; }
.metric { font-size: 32px; font-weight: 700; color: #fafafa; }
.status { display: inline-block; padding: 2px 8px; border-radius: 9px; font-size: 12px; }
.status.active { background: #14532d; color: #4ade80; }
.ctx-actions {
margin-top: 32px;
@@ -147,23 +210,10 @@ class DemoDashboardView extends DeesElement {
</style>
<h1>Dashboard</h1>
<p>Welcome back! Here's an overview of your system.</p>
<div class="grid">
<div class="card">
<h3>Active Users</h3>
<div class="metric">1,234</div>
<span class="status active">Online</span>
</div>
<div class="card">
<h3>API Calls</h3>
<div class="metric">45.2K</div>
<p style="color: #4ade80; font-size: 12px; margin: 0;">+12% from last hour</p>
</div>
<div class="card">
<h3>System Health</h3>
<div class="metric">99.9%</div>
<p style="color: #737373; font-size: 12px; margin: 0;">All systems operational</p>
</div>
</div>
<dees-statsgrid
.tiles=${this.statsTiles}
@tile-action=${(e: CustomEvent) => console.log('Tile action:', e.detail)}
></dees-statsgrid>
<div class="ctx-actions">
<h2>Context Actions (ctx.appui)</h2>
@@ -663,6 +713,44 @@ export const demoFunc = () => {
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) => {
console.log(`View changed to: ${viewId} (${view.name})`);
},

View File

@@ -15,6 +15,7 @@ import type { DeesAppuiMainmenu } from '../dees-appui-mainmenu/dees-appui-mainme
import type { DeesAppuiSecondarymenu } from '../dees-appui-secondarymenu/dees-appui-secondarymenu.js';
import type { DeesAppuiMaincontent } from '../dees-appui-maincontent/dees-appui-maincontent.js';
import type { DeesAppuiActivitylog } from '../dees-appui-activitylog/dees-appui-activitylog.js';
import type { DeesAppuiBottombar } from '../dees-appui-bottombar/dees-appui-bottombar.js';
import { demoFunc } from './dees-appui.demo.js';
import { themeDefaultStyles } from '../../00theme.js';
@@ -23,6 +24,7 @@ import { ViewRegistry } from './view.registry.js';
// Import child components
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-secondarymenu/dees-appui-secondarymenu.js';
import '../dees-appui-maincontent/dees-appui-maincontent.js';
@@ -37,6 +39,7 @@ declare global {
@customElement('dees-appui')
export class DeesAppui extends DeesElement {
public static demo = demoFunc;
public static demoGroup = 'App UI';
// ==========================================
// REACTIVE OBSERVABLES (RxJS Subjects)
@@ -156,6 +159,12 @@ export class DeesAppui extends DeesElement {
@state()
accessor activitylogElement: DeesAppuiActivitylog | undefined = undefined;
@state()
accessor bottombarElement: DeesAppuiBottombar | undefined = undefined;
@state()
accessor bottombarVisible: boolean = true;
// Current view state
@state()
accessor currentView: interfaces.IViewDefinition | undefined = undefined;
@@ -179,12 +188,25 @@ export class DeesAppui extends DeesElement {
.maingrid {
position: absolute;
top: 40px;
height: calc(100% - 40px);
height: calc(100% - 40px - 24px);
width: 100%;
display: grid;
/* grid-template-columns set dynamically in template */
grid-template-rows: 1fr;
transition: grid-template-columns 0.3s ease;
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 */
@@ -201,6 +223,7 @@ export class DeesAppui extends DeesElement {
.maingrid > dees-appui-maincontent {
position: relative;
z-index: 1;
min-height: 0;
}
.maingrid > dees-appui-activitylog {
@@ -293,6 +316,9 @@ export class DeesAppui extends DeesElement {
class="${this.activityLogVisible ? 'visible' : 'hidden'}"
></dees-appui-activitylog>
</div>
${this.bottombarVisible ? html`
<dees-appui-bottombar></dees-appui-bottombar>
` : ''}
`;
}
@@ -303,6 +329,7 @@ export class DeesAppui extends DeesElement {
this.secondarymenu = this.shadowRoot!.querySelector('dees-appui-secondarymenu') as DeesAppuiSecondarymenu;
this.maincontent = this.shadowRoot!.querySelector('dees-appui-maincontent') as DeesAppuiMaincontent;
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) {
@@ -728,6 +755,72 @@ export class DeesAppui extends DeesElement {
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
// ==========================================
@@ -840,6 +933,23 @@ export class DeesAppui 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
this.setupRouterIntegration(config);

View File

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

View File

@@ -1,6 +1,7 @@
// App UI Components
export * from './dees-appui-activitylog/index.js';
export * from './dees-appui-appbar/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-mainmenu/index.js';

View File

@@ -16,6 +16,7 @@ export class DeesButtonExit extends DeesElement {
public static demo = () => html`
<dees-button-exit></dees-button-exit>
`;
public static demoGroup = 'Button';
// INSTANCE
@property({

View File

@@ -21,6 +21,7 @@ declare global {
@customElement('dees-button-group')
export class DeesButtonGroup extends DeesElement {
public static demo = demoFunc;
public static demoGroup = 'Button';
@property()
accessor label: string = '';

View File

@@ -23,6 +23,7 @@ declare global {
@customElement('dees-button')
export class DeesButton extends DeesElement {
public static demo = demoFunc;
public static demoGroup = 'Button';
@property({
reflect: true,

View File

@@ -23,6 +23,7 @@ declare global {
@customElement('dees-chart-area')
export class DeesChartArea extends DeesElement {
public static demo = demoFunc;
public static demoGroup = 'Chart';
// instance
@state()

View File

@@ -29,6 +29,7 @@ export interface ILogEntry {
@customElement('dees-chart-log')
export class DeesChartLog extends DeesElement {
public static demo = demoFunc;
public static demoGroup = 'Chart';
@property()
accessor label: string = 'Server Logs';

View File

@@ -27,6 +27,7 @@ declare global {
@customElement('dees-dataview-codebox')
export class DeesDataviewCodebox extends DeesElement {
public static demo = demoFunc;
public static demoGroup = 'Data View';
@property()
accessor progLang: string = 'typescript';

View File

@@ -27,6 +27,7 @@ declare global {
@customElement('dees-dataview-statusobject')
export class DeesDataviewStatusobject extends DeesElement {
public static demo = demoFunc;
public static demoGroup = 'Data View';
@property({ type: Object }) accessor statusObject: tsclass.code.IStatusObject;

View File

@@ -19,6 +19,7 @@ declare global {
@customElement('dees-form-submit')
export class DeesFormSubmit extends DeesElement {
public static demo = demoFunc;
public static demoGroup = 'Form';
@property({
type: Boolean,

View File

@@ -19,6 +19,7 @@ import { DeesInputFileupload } from '../../00group-input/dees-input-fileupload/i
import { DeesInputIban } from '../../00group-input/dees-input-iban/dees-input-iban.js';
import { DeesInputMultitoggle } from '../../00group-input/dees-input-multitoggle/dees-input-multitoggle.js';
import { DeesInputPhone } from '../../00group-input/dees-input-phone/dees-input-phone.js';
import { DeesInputToggle } from '../../00group-input/dees-input-toggle/dees-input-toggle.js';
import { DeesInputTypelist } from '../../00group-input/dees-input-typelist/dees-input-typelist.js';
import { DeesFormSubmit } from '../dees-form-submit/dees-form-submit.js';
import { DeesTable } from '../../dees-table/index.js';
@@ -37,6 +38,7 @@ const FORM_INPUT_TYPES = [
DeesInputQuantitySelector,
DeesInputRadiogroup,
DeesInputText,
DeesInputToggle,
DeesInputTypelist,
DeesTable,
];
@@ -53,6 +55,7 @@ export type TFormInputElement =
| DeesInputQuantitySelector
| DeesInputRadiogroup
| DeesInputText
| DeesInputToggle
| DeesInputTypelist
| DeesTable<any>;
@@ -65,6 +68,7 @@ declare global {
@customElement('dees-form')
export class DeesForm extends DeesElement {
public static demo = demoFunc;
public static demoGroup = 'Form';
public name: string = 'myform';
public changeSubject = new domtools.plugins.smartrx.rxjs.Subject();

View File

@@ -21,6 +21,7 @@ declare global {
export class DeesInputCheckbox extends DeesInputBase<DeesInputCheckbox> {
// STATIC
public static demo = demoFunc;
public static demoGroup = 'Input';
// INSTANCE

View File

@@ -54,6 +54,7 @@ export class DeesInputCode extends DeesInputBase<string> {
.value=${'const greeting: string = "Hello World";\nconsole.log(greeting);'}
></dees-input-code>
`;
public static demoGroup = 'Input';
// INSTANCE
@property({ type: String })

View File

@@ -22,6 +22,7 @@ declare global {
@customElement('dees-input-datepicker')
export class DeesInputDatepicker extends DeesInputBase<DeesInputDatepicker> {
public static demo = demoFunc;
public static demoGroup = 'Input';
@property({ type: String })
accessor value: string = '';

View File

@@ -22,6 +22,7 @@ declare global {
@customElement('dees-input-dropdown')
export class DeesInputDropdown extends DeesInputBase<DeesInputDropdown> {
public static demo = demoFunc;
public static demoGroup = 'Input';
// INSTANCE

View File

@@ -21,6 +21,7 @@ declare global {
@customElement('dees-input-fileupload')
export class DeesInputFileupload extends DeesInputBase<DeesInputFileupload> {
public static demo = demoFunc;
public static demoGroup = 'Input';
@property({ attribute: false })
accessor value: File[] = [];

View File

@@ -17,6 +17,7 @@ import { themeDefaultStyles } from '../../00theme.js';
export class DeesInputIban extends DeesInputBase<DeesInputIban> {
// STATIC
public static demo = demoFunc;
public static demoGroup = 'Input';
// INSTANCE
@state()

View File

@@ -23,6 +23,7 @@ declare global {
export class DeesInputList extends DeesInputBase<DeesInputList> {
// STATIC
public static demo = demoFunc;
public static demoGroup = 'Input';
// INSTANCE
@property({ type: Array })
@@ -64,6 +65,26 @@ export class DeesInputList extends DeesInputBase<DeesInputList> {
@state()
accessor dragOverIndex: number = -1;
// Enhanced drag state for interactive reordering
@state()
accessor dragStartY: number = 0;
@state()
accessor dragCurrentY: number = 0;
@state()
accessor targetIndex: number = -1;
@state()
accessor itemHeight: number = 0;
// Bound event handlers for cleanup
private boundHandleGlobalDragOver: ((e: DragEvent) => void) | null = null;
private boundHandleGlobalDragEnd: (() => void) | null = null;
// Store original item positions for accurate hit detection (before transforms)
private originalItemRects: DOMRect[] = [];
public static styles = [
themeDefaultStyles,
...DeesInputBase.baseStyles,
@@ -113,7 +134,7 @@ export class DeesInputList extends DeesInputBase<DeesInputList> {
padding: 12px 16px;
border-bottom: 1px solid ${cssManager.bdTheme('hsl(0 0% 89.8%)', 'hsl(0 0% 14.9%)')};
background: ${cssManager.bdTheme('hsl(0 0% 100%)', 'hsl(0 0% 3.9%)')};
transition: all 0.15s ease;
transition: transform 0.2s ease, background 0.15s ease, box-shadow 0.15s ease;
position: relative;
overflow: hidden; /* Prevent animation from affecting scroll bounds */
}
@@ -122,20 +143,31 @@ export class DeesInputList extends DeesInputBase<DeesInputList> {
border-bottom: none;
}
.list-item:hover:not(.disabled) {
.list-items:not(.is-dragging) .list-item:hover:not(.disabled) {
background: ${cssManager.bdTheme('hsl(0 0% 97.5%)', 'hsl(0 0% 6.9%)')};
}
/* Dragging item - follows cursor */
.list-item.dragging {
opacity: 0.4;
background: ${cssManager.bdTheme('hsl(210 40% 96.1%)', 'hsl(215 20.2% 10.8%)')};
position: relative;
z-index: 100;
background: ${cssManager.bdTheme('hsl(210 40% 98%)', 'hsl(215 20.2% 12%)')};
box-shadow: 0 4px 12px ${cssManager.bdTheme('rgba(0, 0, 0, 0.15)', 'rgba(0, 0, 0, 0.4)')};
border-radius: 6px;
transition: box-shadow 0.15s ease, background 0.15s ease;
}
.list-item.drag-over {
background: ${cssManager.bdTheme('hsl(210 40% 93.1%)', 'hsl(215 20.2% 13.8%)')};
border-color: ${cssManager.bdTheme('hsl(222.2 47.4% 51.2%)', 'hsl(217.2 91.2% 59.8%)')};
/* Items that need to move up to make space */
.list-item.move-up {
transform: translateY(calc(-1 * var(--item-height, 48px)));
}
/* Items that need to move down to make space */
.list-item.move-down {
transform: translateY(var(--item-height, 48px));
}
.drag-handle {
display: flex;
align-items: center;
@@ -313,27 +345,9 @@ export class DeesInputList extends DeesInputBase<DeesInputList> {
background: ${cssManager.bdTheme('hsl(0 0% 79.8%)', 'hsl(0 0% 34.9%)')};
}
/* Animation for adding/removing items */
@keyframes slideIn {
from {
opacity: 0;
transform: translateY(-10px);
}
to {
opacity: 1;
transform: translateY(0);
}
}
.list-item {
animation: slideIn 0.2s ease;
}
/* Override any inherited contain/content-visibility that might cause scrolling issues */
.list-items, .list-item {
content-visibility: visible !important;
contain: none !important;
contain-intrinsic-size: auto !important;
/* Disable transitions during drop to prevent flash */
.list-items.dropping .list-item {
transition: none !important;
}
`,
];
@@ -347,12 +361,11 @@ export class DeesInputList extends DeesInputBase<DeesInputList> {
<div class="list-items">
${this.value.length > 0 ? this.value.map((item, index) => html`
<div
class="list-item ${this.draggedIndex === index ? 'dragging' : ''} ${this.dragOverIndex === index ? 'drag-over' : ''}"
class="list-item ${this.draggedIndex === index ? 'dragging' : ''}"
draggable="${this.sortable && !this.disabled}"
@dragstart=${(e: DragEvent) => this.handleDragStart(e, index)}
@dragend=${this.handleDragEnd}
@dragover=${(e: DragEvent) => this.handleDragOver(e, index)}
@dragleave=${this.handleDragLeave}
@drop=${(e: DragEvent) => this.handleDrop(e, index)}
>
${this.sortable && !this.disabled ? html`
@@ -547,48 +560,313 @@ export class DeesInputList extends DeesInputBase<DeesInputList> {
return confirm(message);
}
// Drag and drop handlers
// Drag and drop handlers - Interactive implementation
private handleDragStart(e: DragEvent, index: number) {
if (!this.sortable || this.disabled) return;
this.draggedIndex = index;
this.targetIndex = index;
e.dataTransfer!.effectAllowed = 'move';
e.dataTransfer!.setData('text/plain', index.toString());
// Hide the default drag image
const emptyImg = new Image();
emptyImg.src = 'data:image/gif;base64,R0lGODlhAQABAIAAAAUEBAAAACwAAAAAAQABAAACAkQBADs=';
e.dataTransfer!.setDragImage(emptyImg, 0, 0);
// Store initial mouse position
this.dragStartY = e.clientY;
this.dragCurrentY = e.clientY;
// Measure item height and store all original positions before any transforms
const listItems = this.shadowRoot?.querySelector('.list-items');
const allItems = Array.from(listItems?.querySelectorAll('.list-item') || []) as HTMLElement[];
if (allItems[index]) {
this.itemHeight = allItems[index].offsetHeight;
}
// Store original positions for accurate hit detection (before any transforms are applied)
this.originalItemRects = allItems.map(item => item.getBoundingClientRect());
// Add class to container
listItems?.classList.add('is-dragging');
// Set up global event listeners
this.boundHandleGlobalDragOver = this.handleGlobalDragOver.bind(this);
this.boundHandleGlobalDragEnd = this.handleGlobalDragEnd.bind(this);
document.addEventListener('dragover', this.boundHandleGlobalDragOver);
document.addEventListener('dragend', this.boundHandleGlobalDragEnd);
}
private handleGlobalDragOver(e: DragEvent) {
e.preventDefault();
if (this.draggedIndex === -1) return;
this.dragCurrentY = e.clientY;
// Calculate which position the item should move to
const listItems = this.shadowRoot?.querySelector('.list-items');
if (!listItems) return;
const items = Array.from(listItems.querySelectorAll('.list-item')) as HTMLElement[];
const draggedElement = items[this.draggedIndex];
if (!draggedElement) return;
// Apply transform to dragged item
const deltaY = this.dragCurrentY - this.dragStartY;
draggedElement.style.transform = `translateY(${deltaY}px)`;
// Calculate the dragged item's current center position
const draggedRect = this.originalItemRects[this.draggedIndex];
if (!draggedRect) return;
const draggedCenter = draggedRect.top + draggedRect.height / 2 + deltaY;
// Determine target index: swap when dragged item's center crosses another item's center
// Account for items that have already shifted (their visual position changed)
let newTargetIndex = this.draggedIndex;
for (let i = 0; i < items.length; i++) {
if (i === this.draggedIndex) continue;
const rect = this.originalItemRects[i];
if (!rect) continue;
// Adjust item center based on whether it has shifted
let itemCenter = rect.top + rect.height / 2;
// If item has moved, use its shifted position
if (items[i].classList.contains('move-up')) {
itemCenter -= this.itemHeight;
} else if (items[i].classList.contains('move-down')) {
itemCenter += this.itemHeight;
}
if (draggedCenter < itemCenter && i < this.draggedIndex) {
newTargetIndex = i;
break;
} else if (draggedCenter > itemCenter && i > this.draggedIndex) {
newTargetIndex = i;
}
}
// Update target index and apply move classes
if (newTargetIndex !== this.targetIndex) {
this.targetIndex = newTargetIndex;
this.updateItemPositions(items);
}
}
private updateItemPositions(items: HTMLElement[]) {
const draggedIdx = this.draggedIndex;
const targetIdx = this.targetIndex;
// Set CSS variable for item height
const listItems = this.shadowRoot?.querySelector('.list-items') as HTMLElement;
if (listItems) {
listItems.style.setProperty('--item-height', `${this.itemHeight}px`);
}
items.forEach((item, i) => {
if (i === draggedIdx) return; // Skip dragged item
item.classList.remove('move-up', 'move-down');
item.style.setProperty('--item-height', `${this.itemHeight}px`);
if (draggedIdx < targetIdx) {
// Dragging down: items between draggedIdx and targetIdx move up
if (i > draggedIdx && i <= targetIdx) {
item.classList.add('move-up');
}
} else if (draggedIdx > targetIdx) {
// Dragging up: items between targetIdx and draggedIdx move down
if (i >= targetIdx && i < draggedIdx) {
item.classList.add('move-down');
}
}
});
}
private handleGlobalDragEnd() {
// Clean up event listeners
if (this.boundHandleGlobalDragOver) {
document.removeEventListener('dragover', this.boundHandleGlobalDragOver);
this.boundHandleGlobalDragOver = null;
}
if (this.boundHandleGlobalDragEnd) {
document.removeEventListener('dragend', this.boundHandleGlobalDragEnd);
this.boundHandleGlobalDragEnd = null;
}
const listItems = this.shadowRoot?.querySelector('.list-items');
const items = listItems?.querySelectorAll('.list-item') as NodeListOf<HTMLElement>;
const draggedElement = items?.[this.draggedIndex];
// If no reorder needed, animate back and clean up
if (this.draggedIndex === -1 || this.targetIndex === -1 || this.draggedIndex === this.targetIndex) {
// Animate dragged item back to original position
if (draggedElement && this.draggedIndex !== -1) {
draggedElement.style.transition = 'transform 0.15s ease';
draggedElement.style.transform = 'translateY(0)';
let handled = false;
const onReturn = () => {
if (handled) return;
handled = true;
draggedElement.removeEventListener('transitionend', onReturn);
this.cleanupDragState(listItems, items);
};
draggedElement.addEventListener('transitionend', onReturn, { once: true });
setTimeout(onReturn, 200);
} else {
this.cleanupDragState(listItems, items);
}
return;
}
// Calculate final position for dragged item
const draggedRect = this.originalItemRects[this.draggedIndex];
const targetRect = this.originalItemRects[this.targetIndex];
if (!draggedRect || !targetRect || !draggedElement) {
this.cleanupDragState(listItems, items);
return;
}
// Calculate where dragged item needs to go
let finalY: number;
if (this.targetIndex > this.draggedIndex) {
// Moving down: go to bottom of target
finalY = targetRect.bottom - draggedRect.bottom;
} else {
// Moving up: go to top of target
finalY = targetRect.top - draggedRect.top;
}
// Animate dragged item to final position
draggedElement.style.transition = 'transform 0.15s ease';
draggedElement.style.transform = `translateY(${finalY}px)`;
// After animation completes, update data
let handled = false;
const onTransitionEnd = () => {
if (handled) return;
handled = true;
draggedElement.removeEventListener('transitionend', onTransitionEnd);
// Disable all transitions
listItems?.classList.add('dropping');
// Force reflow so dropping class takes effect immediately
void (listItems as HTMLElement)?.offsetHeight;
// Clean up all element state
items?.forEach(item => {
item.classList.remove('move-up', 'move-down', 'dragging');
item.style.removeProperty('transform');
item.style.removeProperty('transition');
});
// Update data
const newValue = [...this.value];
const [draggedItem] = newValue.splice(this.draggedIndex, 1);
newValue.splice(this.targetIndex, 0, draggedItem);
this.value = newValue;
this.emitChange();
// Reset state
this.draggedIndex = -1;
this.dragOverIndex = -1;
this.targetIndex = -1;
this.dragStartY = 0;
this.dragCurrentY = 0;
this.originalItemRects = [];
// After render, ensure no animation then re-enable transitions
this.updateComplete.then(() => {
// Set inline transition:none on fresh elements
const freshItems = this.shadowRoot?.querySelectorAll('.list-item') as NodeListOf<HTMLElement>;
freshItems?.forEach(item => {
item.style.transition = 'none';
});
// Force reflow
void (this.shadowRoot?.querySelector('.list-items') as HTMLElement)?.offsetHeight;
// Now re-enable transitions
requestAnimationFrame(() => {
freshItems?.forEach(item => {
item.style.removeProperty('transition');
});
listItems?.classList.remove('dropping', 'is-dragging');
});
});
};
draggedElement.addEventListener('transitionend', onTransitionEnd, { once: true });
// Fallback timeout in case transitionend doesn't fire
setTimeout(onTransitionEnd, 200);
}
private cleanupDragState(listItems: Element | null | undefined, items: NodeListOf<HTMLElement> | undefined) {
listItems?.classList.add('dropping');
// Force reflow so dropping class takes effect immediately
void (listItems as HTMLElement)?.offsetHeight;
items?.forEach(item => {
item.classList.remove('move-up', 'move-down', 'dragging');
item.style.removeProperty('transform');
item.style.removeProperty('transition');
});
this.draggedIndex = -1;
this.dragOverIndex = -1;
this.targetIndex = -1;
this.dragStartY = 0;
this.dragCurrentY = 0;
this.originalItemRects = [];
this.updateComplete.then(() => {
const freshItems = this.shadowRoot?.querySelectorAll('.list-item') as NodeListOf<HTMLElement>;
freshItems?.forEach(item => {
item.style.transition = 'none';
});
void (this.shadowRoot?.querySelector('.list-items') as HTMLElement)?.offsetHeight;
requestAnimationFrame(() => {
freshItems?.forEach(item => {
item.style.removeProperty('transition');
});
listItems?.classList.remove('dropping', 'is-dragging');
});
});
}
private handleDragEnd() {
this.draggedIndex = -1;
this.dragOverIndex = -1;
// This is called by the native dragend on the element
// The actual cleanup is done in handleGlobalDragEnd
this.handleGlobalDragEnd();
}
private handleDragOver(e: DragEvent, index: number) {
if (!this.sortable || this.disabled) return;
e.preventDefault();
e.dataTransfer!.dropEffect = 'move';
this.dragOverIndex = index;
// We handle positioning in handleGlobalDragOver now
}
private handleDragLeave() {
this.dragOverIndex = -1;
// No longer needed for visual feedback - handled by transform
}
private handleDrop(e: DragEvent, dropIndex: number) {
if (!this.sortable || this.disabled) return;
e.preventDefault();
const draggedIndex = parseInt(e.dataTransfer!.getData('text/plain'));
if (draggedIndex !== dropIndex) {
const newValue = [...this.value];
const [draggedItem] = newValue.splice(draggedIndex, 1);
newValue.splice(dropIndex, 0, draggedItem);
this.value = newValue;
this.emitChange();
}
this.draggedIndex = -1;
this.dragOverIndex = -1;
// The actual reorder happens in handleGlobalDragEnd
}
private emitChange() {

View File

@@ -22,6 +22,7 @@ declare global {
@customElement('dees-input-multitoggle')
export class DeesInputMultitoggle extends DeesInputBase<DeesInputMultitoggle> {
public static demo = demoFunc;
public static demoGroup = 'Input';
@property()

View File

@@ -22,6 +22,7 @@ declare global {
export class DeesInputPhone extends DeesInputBase<DeesInputPhone> {
// STATIC
public static demo = demoFunc;
public static demoGroup = 'Input';
// INSTANCE
@state()

View File

@@ -13,6 +13,7 @@ declare global {
@customElement('dees-input-quantityselector')
export class DeesInputQuantitySelector extends DeesInputBase<DeesInputQuantitySelector> {
public static demo = demoFunc;
public static demoGroup = 'Input';
// INSTANCE

View File

@@ -21,6 +21,7 @@ type RadioOption = string | { option: string; key: string; payload?: any };
@customElement('dees-input-radiogroup')
export class DeesInputRadiogroup extends DeesInputBase<string | object> {
public static demo = demoFunc;
public static demoGroup = 'Input';
// INSTANCE

View File

@@ -28,6 +28,7 @@ declare global {
@customElement('dees-input-richtext')
export class DeesInputRichtext extends DeesInputBase<string> {
public static demo = demoFunc;
public static demoGroup = 'Input';
// INSTANCE
@property({

View File

@@ -22,6 +22,7 @@ declare global {
export class DeesInputTags extends DeesInputBase<DeesInputTags> {
// STATIC
public static demo = demoFunc;
public static demoGroup = 'Input';
// INSTANCE
@property({ type: Array })

View File

@@ -22,6 +22,7 @@ declare global {
@customElement('dees-input-text')
export class DeesInputText extends DeesInputBase {
public static demo = demoFunc;
public static demoGroup = 'Input';
// INSTANCE
@property({

View File

@@ -0,0 +1,310 @@
import { html, css, cssManager } from '@design.estate/dees-element';
import '@design.estate/dees-wcctools/demotools';
import '../../dees-panel/dees-panel.js';
import type { DeesInputToggle } from './dees-input-toggle.js';
export const demoFunc = () => html`
<dees-demowrapper .runAfterRender=${async (elementArg: HTMLElement) => {
// Example of programmatic interaction
const toggleAllOnBtn = elementArg.querySelector('#toggle-all-on');
const toggleAllOffBtn = elementArg.querySelector('#toggle-all-off');
const featureToggles = elementArg.querySelectorAll('.feature-toggles dees-input-toggle');
if (toggleAllOnBtn && toggleAllOffBtn) {
toggleAllOnBtn.addEventListener('click', () => {
featureToggles.forEach((toggle: DeesInputToggle) => {
if (!toggle.disabled && !toggle.required) {
toggle.value = true;
}
});
});
toggleAllOffBtn.addEventListener('click', () => {
featureToggles.forEach((toggle: DeesInputToggle) => {
if (!toggle.disabled && !toggle.required) {
toggle.value = false;
}
});
});
}
}}>
<style>
${css`
.demo-container {
display: flex;
flex-direction: column;
gap: 24px;
padding: 24px;
max-width: 1200px;
margin: 0 auto;
}
dees-panel {
margin-bottom: 24px;
}
dees-panel:last-child {
margin-bottom: 0;
}
.toggle-group {
display: flex;
flex-direction: column;
gap: 16px;
}
.horizontal-toggles {
display: flex;
gap: 32px;
flex-wrap: wrap;
}
.interactive-section {
background: ${cssManager.bdTheme('hsl(210 40% 96.1%)', 'hsl(215 20.2% 16.8%)')};
border-radius: 8px;
padding: 16px;
margin-top: 16px;
}
.output-text {
font-family: monospace;
font-size: 13px;
color: ${cssManager.bdTheme('hsl(215.3 25% 26.7%)', 'hsl(210 40% 80%)')};
padding: 8px;
background: ${cssManager.bdTheme('hsl(210 40% 98%)', 'hsl(215 20.2% 11.8%)')};
border-radius: 4px;
min-height: 24px;
}
.settings-section {
background: ${cssManager.bdTheme('hsl(0 0% 97%)', 'hsl(0 0% 7%)')};
border: 1px solid ${cssManager.bdTheme('hsl(0 0% 89.8%)', 'hsl(0 0% 14.9%)')};
border-radius: 8px;
padding: 20px;
}
.button-group {
display: flex;
gap: 8px;
margin-bottom: 16px;
}
.feature-toggles {
background: ${cssManager.bdTheme('hsl(210 40% 96.1%)', 'hsl(215 20.2% 11.8%)')};
border: 1px solid ${cssManager.bdTheme('hsl(214.3 31.8% 91.4%)', 'hsl(215 20.2% 16.8%)')};
border-radius: 6px;
padding: 16px;
}
.section-title {
font-size: 16px;
font-weight: 600;
margin-bottom: 16px;
color: ${cssManager.bdTheme('hsl(215.3 25% 8.8%)', 'hsl(210 40% 98%)')};
}
.drag-hint {
font-size: 12px;
color: ${cssManager.bdTheme('hsl(0 0% 45.1%)', 'hsl(0 0% 63.9%)')};
margin-top: 8px;
font-style: italic;
}
`}
</style>
<div class="demo-container">
<dees-panel .title=${'Basic Toggle'} .subtitle=${'Simple on/off toggle switch with drag support'}>
<div class="toggle-group">
<dees-input-toggle
.label=${'Enable feature'}
.value=${false}
.key=${'basic'}
></dees-input-toggle>
<dees-input-toggle
.label=${'Active toggle'}
.value=${true}
.key=${'active'}
></dees-input-toggle>
<dees-input-toggle
.label=${'With description'}
.value=${false}
.description=${'This toggle has additional helper text explaining its purpose'}
.key=${'withDesc'}
></dees-input-toggle>
</div>
<p class="drag-hint">Tip: You can drag the toggle knob to switch states</p>
</dees-panel>
<dees-panel .title=${'Toggle States'} .subtitle=${'Different toggle states and configurations'}>
<div class="toggle-group">
<dees-input-toggle
.label=${'Default (off)'}
.value=${false}
></dees-input-toggle>
<dees-input-toggle
.label=${'Enabled (on)'}
.value=${true}
></dees-input-toggle>
<dees-input-toggle
.label=${'Disabled (off)'}
.value=${false}
.disabled=${true}
></dees-input-toggle>
<dees-input-toggle
.label=${'Disabled (on)'}
.value=${true}
.disabled=${true}
></dees-input-toggle>
<dees-input-toggle
.label=${'Required (always on)'}
.value=${true}
.required=${true}
.description=${'This toggle cannot be turned off'}
></dees-input-toggle>
</div>
</dees-panel>
<dees-panel .title=${'Horizontal Layout'} .subtitle=${'Toggles arranged horizontally for compact interfaces'}>
<div class="horizontal-toggles">
<dees-input-toggle
.label=${'WiFi'}
.value=${true}
.layoutMode=${'horizontal'}
></dees-input-toggle>
<dees-input-toggle
.label=${'Bluetooth'}
.value=${false}
.layoutMode=${'horizontal'}
></dees-input-toggle>
<dees-input-toggle
.label=${'GPS'}
.value=${true}
.layoutMode=${'horizontal'}
></dees-input-toggle>
<dees-input-toggle
.label=${'NFC'}
.value=${false}
.layoutMode=${'horizontal'}
></dees-input-toggle>
</div>
</dees-panel>
<dees-panel .title=${'Settings Example'} .subtitle=${'Toggles in a typical settings context'}>
<div class="settings-section">
<h4 class="section-title">Notification Settings</h4>
<div class="toggle-group">
<dees-input-toggle
.label=${'Push notifications'}
.value=${true}
.description=${'Receive push notifications on your device'}
.key=${'push'}
></dees-input-toggle>
<dees-input-toggle
.label=${'Email notifications'}
.value=${true}
.description=${'Get important updates via email'}
.key=${'email'}
></dees-input-toggle>
<dees-input-toggle
.label=${'Sound'}
.value=${false}
.description=${'Play a sound for notifications'}
.key=${'sound'}
></dees-input-toggle>
<dees-input-toggle
.label=${'Vibration'}
.value=${true}
.description=${'Vibrate for notifications'}
.key=${'vibration'}
></dees-input-toggle>
</div>
</div>
</dees-panel>
<dees-panel .title=${'Feature Toggles'} .subtitle=${'Batch operations on multiple toggles'}>
<div class="button-group">
<dees-button id="toggle-all-on" type="secondary">Enable All</dees-button>
<dees-button id="toggle-all-off" type="secondary">Disable All</dees-button>
</div>
<div class="feature-toggles">
<div class="toggle-group">
<dees-input-toggle
.label=${'Dark Mode'}
.value=${true}
.key=${'darkMode'}
></dees-input-toggle>
<dees-input-toggle
.label=${'Auto-save'}
.value=${true}
.key=${'autoSave'}
></dees-input-toggle>
<dees-input-toggle
.label=${'Spell check'}
.value=${false}
.key=${'spellCheck'}
></dees-input-toggle>
<dees-input-toggle
.label=${'Developer mode'}
.value=${false}
.key=${'devMode'}
></dees-input-toggle>
<dees-input-toggle
.label=${'Beta features'}
.value=${false}
.key=${'beta'}
></dees-input-toggle>
</div>
</div>
</dees-panel>
<dees-panel .title=${'Interactive Example'} .subtitle=${'Toggle to see value changes in real-time'}>
<div class="toggle-group">
<dees-input-toggle
.label=${'Airplane mode'}
.value=${false}
@newValue=${(event: CustomEvent) => {
const output = document.querySelector('#airplane-output');
if (output) {
output.textContent = `Airplane mode: ${event.detail ? 'ON' : 'OFF'}`;
}
}}
></dees-input-toggle>
<dees-input-toggle
.label=${'Do not disturb'}
.value=${false}
@newValue=${(event: CustomEvent) => {
const output = document.querySelector('#dnd-output');
if (output) {
output.textContent = `Do not disturb: ${event.detail ? 'ENABLED' : 'DISABLED'}`;
}
}}
></dees-input-toggle>
</div>
<div class="interactive-section">
<div id="airplane-output" class="output-text">Airplane mode: OFF</div>
<div id="dnd-output" class="output-text" style="margin-top: 8px;">Do not disturb: DISABLED</div>
</div>
</dees-panel>
</div>
</dees-demowrapper>
`;

View File

@@ -0,0 +1,372 @@
import {
customElement,
type TemplateResult,
property,
html,
css,
cssManager,
} from '@design.estate/dees-element';
import * as domtools from '@design.estate/dees-domtools';
import { DeesInputBase } from '../dees-input-base/dees-input-base.js';
import { demoFunc } from './dees-input-toggle.demo.js';
import { cssGeistFontFamily } from '../../00fonts.js';
import { themeDefaultStyles } from '../../00theme.js';
declare global {
interface HTMLElementTagNameMap {
'dees-input-toggle': DeesInputToggle;
}
}
@customElement('dees-input-toggle')
export class DeesInputToggle extends DeesInputBase<DeesInputToggle> {
// STATIC
public static demo = demoFunc;
public static demoGroup = 'Input';
// INSTANCE
@property({ type: Boolean, reflect: true })
accessor value: boolean = false;
/**
* Knob position tracking (0 = off, maxTravel = on)
*/
private currentX = 0;
/**
* Drag state
*/
private isDragging = false;
private hasDragged = false;
private startX = 0;
// Toggle dimensions
private readonly trackWidth = 36;
private readonly trackHeight = 20;
private readonly knobSize = 14;
private readonly padding = 2;
private readonly maxTravel = 16; // trackWidth - knobSize - (padding * 2) - border
constructor() {
super();
this.labelPosition = 'right'; // Toggle defaults to label on the right
}
public static styles = [
themeDefaultStyles,
...DeesInputBase.baseStyles,
cssManager.defaultStyles,
css`
* {
box-sizing: border-box;
}
:host {
position: relative;
cursor: default;
font-family: ${cssGeistFontFamily};
}
.maincontainer {
display: inline-flex;
align-items: flex-start;
gap: 8px;
cursor: pointer;
user-select: none;
transition: all 0.15s ease;
}
.toggle-track {
position: relative;
flex-shrink: 0;
height: 20px;
width: 36px;
border-radius: 10px;
background: ${cssManager.bdTheme('hsl(0 0% 100%)', 'hsl(0 0% 3.9%)')};
border: 1px solid ${cssManager.bdTheme('hsl(0 0% 89.8%)', 'hsl(0 0% 14.9%)')};
overflow: hidden;
transition: all 0.15s ease;
margin-top: 1px;
}
.maincontainer:hover .toggle-track {
border-color: ${cssManager.bdTheme('hsl(0 0% 79.8%)', 'hsl(0 0% 20.9%)')};
}
:host([value]) .toggle-track {
background: ${cssManager.bdTheme('hsl(222.2 47.4% 51.2%)', 'hsl(217.2 91.2% 59.8%)')};
border-color: ${cssManager.bdTheme('hsl(222.2 47.4% 51.2%)', 'hsl(217.2 91.2% 59.8%)')};
}
.toggle-track:focus-visible {
outline: none;
box-shadow: 0 0 0 3px ${cssManager.bdTheme('hsl(222.2 47.4% 51.2% / 0.1)', 'hsl(217.2 91.2% 59.8% / 0.1)')};
}
.toggle-knob {
position: absolute;
top: 2px;
width: 14px;
height: 14px;
border-radius: 7px;
background: ${cssManager.bdTheme('hsl(0 0% 63.9%)', 'hsl(0 0% 45.1%)')};
transition: left 0.15s ease, background 0.15s ease;
touch-action: none;
}
.toggle-knob.dragging {
transition: background 0.15s ease;
}
:host([value]) .toggle-knob {
background: white;
}
/* Disabled state */
.maincontainer.disabled {
cursor: not-allowed;
opacity: 0.5;
}
.toggle-track.disabled {
background: ${cssManager.bdTheme('hsl(0 0% 95.1%)', 'hsl(0 0% 14.9%)')};
border-color: ${cssManager.bdTheme('hsl(0 0% 89.8%)', 'hsl(0 0% 14.9%)')};
}
/* Required state (locked on) */
:host([required][value]) .toggle-track {
background: ${cssManager.bdTheme('hsl(222.2 47.4% 61.2%)', 'hsl(217.2 91.2% 49.8%)')};
border-color: ${cssManager.bdTheme('hsl(222.2 47.4% 61.2%)', 'hsl(217.2 91.2% 49.8%)')};
cursor: not-allowed;
}
:host([required][value]) .toggle-knob {
background: ${cssManager.bdTheme('hsl(0 0% 85%)', 'hsl(0 0% 70%)')};
}
/* Label */
.label-container {
display: flex;
flex-direction: column;
gap: 2px;
flex: 1;
}
.toggle-label {
font-size: 14px;
font-weight: 500;
line-height: 20px;
color: ${cssManager.bdTheme('hsl(0 0% 15%)', 'hsl(0 0% 90%)')};
transition: color 0.15s ease;
letter-spacing: -0.01em;
}
.maincontainer:hover .toggle-label {
color: ${cssManager.bdTheme('hsl(0 0% 9%)', 'hsl(0 0% 95%)')};
}
.maincontainer.disabled:hover .toggle-label {
color: ${cssManager.bdTheme('hsl(0 0% 15%)', 'hsl(0 0% 90%)')};
}
/* Description */
.description-text {
font-size: 12px;
color: ${cssManager.bdTheme('hsl(0 0% 45.1%)', 'hsl(0 0% 63.9%)')};
line-height: 1.5;
}
`,
];
public render(): TemplateResult {
return html`
<div class="input-wrapper">
<div class="maincontainer ${this.disabled ? 'disabled' : ''}" @click="${this.handleClick}">
<div
class="toggle-track ${this.disabled ? 'disabled' : ''}"
tabindex="${this.disabled ? '-1' : '0'}"
@keydown="${this.handleKeydown}"
>
<div
class="toggle-knob"
style="left: ${this.padding + this.currentX}px;"
@pointerdown="${this.onPointerDown}"
@pointermove="${this.onPointerMove}"
@pointerup="${this.onPointerUp}"
@pointercancel="${this.onPointerUp}"
></div>
</div>
<div class="label-container">
${this.label ? html`<div class="toggle-label">${this.label}</div>` : ''}
${this.description ? html`<div class="description-text">${this.description}</div>` : ''}
</div>
</div>
</div>
`;
}
public async firstUpdated(_changedProperties: Map<PropertyKey, unknown>) {
await super.firstUpdated(_changedProperties);
// Initialize knob position based on initial value
if (this.required && !this.value) {
this.value = true;
}
this.currentX = this.value ? this.maxTravel : 0;
this.requestUpdate();
}
/**
* Click handler - toggles the value
*/
private async handleClick(event: MouseEvent) {
if (this.isDragging || this.hasDragged) {
event.stopPropagation();
event.preventDefault();
return;
}
if (this.disabled) {
return;
}
if (this.required) {
// Bounce animation for required toggles
this.currentX = this.maxTravel;
this.requestUpdate();
await new Promise((r) => setTimeout(r, 10));
this.currentX = this.maxTravel - 3;
this.requestUpdate();
await domtools.plugins.smartdelay.delayFor(150);
this.currentX = this.maxTravel;
this.requestUpdate();
return;
}
event.stopPropagation();
event.preventDefault();
this.value = !this.value;
this.currentX = this.value ? this.maxTravel : 0;
this.requestUpdate();
this.dispatchEvent(
new CustomEvent('newValue', {
detail: this.value,
bubbles: true,
})
);
this.changeSubject.next(this);
domtools.plugins.smartdelay.delayFor(0).then(() => {
this.hasDragged = false;
});
}
/**
* Pointer down - start dragging
*/
private onPointerDown(event: PointerEvent) {
if (this.required || this.disabled) {
return;
}
this.isDragging = true;
this.startX = event.clientX - this.currentX;
(event.target as HTMLElement).setPointerCapture(event.pointerId);
}
/**
* Pointer move - track drag position
*/
private onPointerMove(event: PointerEvent) {
if (!this.isDragging) return;
const newX = event.clientX - this.startX;
this.hasDragged = true;
const toggleKnob = this.shadowRoot?.querySelector('.toggle-knob') as HTMLDivElement;
if (toggleKnob) {
toggleKnob.classList.add('dragging');
}
this.currentX = Math.max(0, Math.min(newX, this.maxTravel));
this.requestUpdate();
}
/**
* Pointer up - complete drag and snap to nearest side
*/
private onPointerUp(event: PointerEvent) {
if (!this.isDragging) return;
(event.target as HTMLElement).releasePointerCapture(event.pointerId);
this.isDragging = false;
if (!this.hasDragged) {
return;
}
const toggleKnob = this.shadowRoot?.querySelector('.toggle-knob') as HTMLDivElement;
if (toggleKnob) {
toggleKnob.classList.remove('dragging');
}
// Snap to nearest side based on midpoint
const midpoint = this.maxTravel / 2;
this.value = this.currentX > midpoint;
this.currentX = this.value ? this.maxTravel : 0;
this.requestUpdate();
this.dispatchEvent(
new CustomEvent('newValue', {
detail: this.value,
bubbles: true,
})
);
this.changeSubject.next(this);
domtools.plugins.smartdelay.delayFor(0).then(() => {
this.hasDragged = false;
});
}
/**
* Sync knob position when value is changed externally
*/
updated(changedProperties: Map<string, any>): void {
super.updated(changedProperties);
if (
changedProperties.has('value') &&
!this.isDragging &&
!this.hasDragged
) {
this.currentX = this.value ? this.maxTravel : 0;
this.requestUpdate();
}
}
/**
* Keyboard support
*/
private handleKeydown(event: KeyboardEvent) {
if (event.key === ' ' || event.key === 'Enter') {
event.preventDefault();
this.handleClick(event as unknown as MouseEvent);
}
}
// DeesInputBase interface implementation
public getValue(): boolean {
return this.value;
}
public setValue(valueArg: boolean): void {
this.value = valueArg;
}
public focus(): void {
const track = this.shadowRoot?.querySelector('.toggle-track');
if (track) {
(track as HTMLElement).focus();
}
}
}

View File

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

View File

@@ -16,6 +16,7 @@ import { themeDefaultStyles } from '../../00theme.js';
@customElement('dees-input-typelist')
export class DeesInputTypelist extends DeesInputBase<DeesInputTypelist> {
public static demo = demoFunc;
public static demoGroup = 'Input';
// INSTANCE

View File

@@ -39,6 +39,7 @@ declare global {
@customElement('dees-input-wysiwyg')
export class DeesInputWysiwyg extends DeesInputBase<string> {
public static demo = demoFunc;
public static demoGroup = 'Input';
@property({ type: String })
accessor value: string = '';

View File

@@ -15,6 +15,7 @@ export * from './dees-input-richtext/index.js';
export * from './dees-input-searchselect/index.js';
export * from './dees-input-tags/index.js';
export * from './dees-input-text/index.js';
export * from './dees-input-toggle/index.js';
export * from './dees-input-typelist/index.js';
export * from './dees-input-wysiwyg.js';
export * from './profilepicture/dees-input-profilepicture.js';

View File

@@ -25,6 +25,7 @@ export type ProfileShape = 'square' | 'round';
@customElement('dees-input-profilepicture')
export class DeesInputProfilePicture extends DeesInputBase<DeesInputProfilePicture> {
public static demo = demoFunc;
public static demoGroup = 'Input';
@property({ type: String })
accessor value: string = ''; // Base64 encoded image or URL

View File

@@ -15,6 +15,7 @@ declare global {
@customElement('dees-pdf-preview')
export class DeesPdfPreview extends DeesElement {
public static demo = demoFunc;
public static demoGroup = 'PDF';
public static styles = previewStyles;
@property({ type: String })

View File

@@ -1,6 +1,4 @@
import { DeesElement, property, html, customElement, type TemplateResult } from '@design.estate/dees-element';
import { keyed } from 'lit/directives/keyed.js';
import { repeat } from 'lit/directives/repeat.js';
import { DeesElement, property, html, customElement, type TemplateResult, directives } from '@design.estate/dees-element';
import { PdfManager } from '../dees-pdf-shared/PdfManager.js';
import { viewerStyles } from './styles.js';
import { demo as demoFunc } from './demo.js';
@@ -17,6 +15,7 @@ type RenderState = 'idle' | 'loading' | 'rendering-main' | 'rendering-thumbs' |
@customElement('dees-pdf-viewer')
export class DeesPdfViewer extends DeesElement {
public static demo = demoFunc;
public static demoGroup = 'PDF';
public static styles = viewerStyles;
@property({ type: String })
@@ -196,8 +195,8 @@ export class DeesPdfViewer extends DeesElement {
</button>
</div>
<div class="sidebar-content">
${keyed(this.documentId, html`
${repeat(
${directives.keyed(this.documentId, html`
${directives.repeat(
this.thumbnailData,
(item) => item.page,
(item) => html`
@@ -224,7 +223,7 @@ export class DeesPdfViewer extends DeesElement {
</div>
` : html`
<div class="pages-container">
${repeat(
${directives.repeat(
this.pageData,
(item) => item.page,
(item) => html`

View File

@@ -21,6 +21,7 @@ declare global {
export class DeesPdf extends DeesElement {
// DEMO
public static demo = () => html` <dees-pdf></dees-pdf> `;
public static demoGroup = 'PDF';
// INSTANCE

View File

@@ -33,6 +33,7 @@ export interface IView {
export class DeesSimpleAppDash extends DeesElement {
// STATIC
public static demo = demoFunc;
public static demoGroup = 'Simple';
// INSTANCE
@property()

View File

@@ -20,7 +20,8 @@ declare global {
@customElement('dees-simple-login')
export class DeesSimpleLogin extends DeesElement {
// STATIC
public static demo = demoFunc
public static demo = demoFunc;
public static demoGroup = 'Simple';
// INSTANCE
@property()

View File

@@ -31,6 +31,7 @@ export class DeesWorkspaceDiffEditor extends DeesElement {
.filePath=${'/demo/example.ts'}
></dees-workspace-diff-editor>
`;
public static demoGroup = 'Workspace';
// INSTANCE
public diffEditorDeferred = domtools.plugins.smartpromise.defer<monaco.editor.IStandaloneDiffEditor>();

View File

@@ -37,6 +37,7 @@ export class DeesWorkspaceFiletree extends DeesElement {
<dees-workspace-filetree></dees-workspace-filetree>
</div>
`;
public static demoGroup = 'Workspace';
// INSTANCE
@property({ type: Object })

View File

@@ -23,6 +23,7 @@ declare global {
@customElement('dees-workspace-markdown')
export class DeesWorkspaceMarkdown extends DeesElement {
public static demo = () => html`<dees-workspace-markdown></dees-workspace-markdown>`;
public static demoGroup = 'Workspace';
public static styles = [
themeDefaultStyles,

View File

@@ -19,6 +19,7 @@ declare global {
export class DeesWorkspaceMarkdownoutlet extends DeesElement {
// DEMO
public static demo = demoFunc;
public static demoGroup = 'Workspace';
public static styles = [
themeDefaultStyles,

View File

@@ -23,6 +23,7 @@ declare global {
export class DeesWorkspaceMonaco extends DeesElement {
// DEMO
public static demo = () => html`<dees-workspace-monaco></dees-workspace-monaco>`;
public static demoGroup = 'Workspace';
// STATIC
public static monacoDeferred: ReturnType<typeof domtools.plugins.smartpromise.defer>;

View File

@@ -39,6 +39,7 @@ export class DeesWorkspaceTerminalPreview extends DeesElement {
]}
></dees-workspace-terminal-preview>
`;
public static demoGroup = 'Workspace';
/**
* The command being displayed (shown in header)

View File

@@ -37,6 +37,7 @@ export class DeesWorkspaceTerminal extends DeesElement {
const env = new WebContainerEnvironment();
return html`<dees-workspace-terminal .executionEnvironment=${env}></dees-workspace-terminal>`;
};
public static demoGroup = 'Workspace';
// INSTANCE
private resizeObserver: ResizeObserver;

View File

@@ -197,6 +197,7 @@ testSmartPromise();
</dees-demowrapper>
`;
};
public static demoGroup = 'Workspace';
// INSTANCE
@property({ type: Object })

View File

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

View File

@@ -1,7 +1,16 @@
import { html, css, cssManager } from '@design.estate/dees-element';
import '@design.estate/dees-wcctools/demotools';
import '../dees-panel/dees-panel.js';
import type { IStatsTile } from '../dees-statsgrid/dees-statsgrid.js';
import type { IStatsTile, ICpuCore } from '../dees-statsgrid/dees-statsgrid.js';
// Helper function to generate random CPU core data
const generateCpuCores = (count: number): ICpuCore[] => {
return Array.from({ length: count }, (_, i) => ({
id: i,
usage: Math.round(Math.random() * 100),
label: `${i}`,
}));
};
export const demoFunc = () => {
return html`
@@ -334,7 +343,96 @@ export const demoFunc = () => {
></dees-statsgrid>
</dees-panel>
<dees-panel .title=${'4. Interactive Features'} .subtitle=${'Tiles with actions and real-time updates'}>
<dees-panel .title=${'4. CPU Cores Visualization'} .subtitle=${'Vertical bar visualization for multi-core CPU usage with column spanning'}>
<dees-statsgrid
id="cpu-cores-grid"
.tiles=${[
{
id: 'cpu-cores-8',
title: 'CPU Cores (8-core)',
value: 0,
type: 'cpuCores',
icon: 'lucide:cpu',
columnSpan: 2,
coresData: generateCpuCores(8),
description: 'Intel i7 - 8 cores'
},
{
id: 'memory',
title: 'Memory Usage',
value: 68,
type: 'percentage',
icon: 'lucide:database',
description: '13.6 GB of 20 GB'
},
{
id: 'cpu-cores-16',
title: 'CPU Cores (16-core)',
value: 0,
type: 'cpuCores',
icon: 'lucide:cpu',
columnSpan: 2,
coresData: generateCpuCores(16),
description: 'AMD Ryzen 9 - 16 cores'
},
{
id: 'network',
title: 'Network I/O',
value: 245,
unit: 'MB/s',
type: 'trend',
icon: 'lucide:network',
trendData: [200, 220, 235, 240, 238, 245],
description: 'throughput'
},
{
id: 'cpu-cores-32',
title: 'Server CPU (32-core)',
value: 0,
type: 'cpuCores',
icon: 'lucide:server',
columnSpan: 3,
coresData: generateCpuCores(32),
description: 'AMD EPYC - 32 cores'
},
{
id: 'disk',
title: 'Disk Usage',
value: 42,
type: 'percentage',
icon: 'lucide:hard-drive',
description: '420 GB of 1 TB'
}
]}
.gridActions=${[
{
name: 'Randomize',
iconName: 'lucide:shuffle',
action: async () => {
const grid = document.querySelector('#cpu-cores-grid') as any;
if (!grid) return;
const tiles = grid.tiles.map((tile: any) => {
if (tile.type === 'cpuCores' && tile.coresData) {
return {
...tile,
coresData: tile.coresData.map((core: any) => ({
...core,
usage: Math.round(Math.random() * 100)
}))
};
}
return tile;
});
grid.tiles = tiles;
}
}
]}
.minTileWidth=${250}
.gap=${16}
></dees-statsgrid>
</dees-panel>
<dees-panel .title=${'5. Interactive Features'} .subtitle=${'Tiles with actions and real-time updates'}>
<dees-statsgrid
id="interactive-grid"
.tiles=${[
@@ -448,7 +546,7 @@ export const demoFunc = () => {
></dees-statsgrid>
</dees-panel>
<dees-panel .title=${'5. Code Example'} .subtitle=${'How to implement a stats grid with TypeScript'}>
<dees-panel .title=${'6. Code Example'} .subtitle=${'How to implement a stats grid with TypeScript'}>
<div class="code-block">${`const tiles: IStatsTile[] = [
{
id: 'revenue',

View File

@@ -24,12 +24,21 @@ declare global {
}
}
export interface ICpuCore {
id: string | number;
usage: number; // 0-100
label?: string;
}
export interface IStatsTile {
id: string;
title: string;
value: number | string;
unit?: string;
type: 'number' | 'gauge' | 'percentage' | 'trend' | 'text';
type: 'number' | 'gauge' | 'percentage' | 'trend' | 'text' | 'multiPercentage' | 'cpuCores';
// Layout options
columnSpan?: number; // Number of columns to span (default: 1)
// For gauge type
gaugeOptions?: {
@@ -41,6 +50,16 @@ export interface IStatsTile {
// For trend type
trendData?: number[];
// For multiPercentage type
percentages?: Array<{
label: string;
value: number;
color?: string;
}>;
// For cpuCores type
coresData?: ICpuCore[];
// Visual customization
color?: string;
icon?: string;
@@ -88,16 +107,16 @@ export class DeesStatsGrid extends DeesElement {
/* CSS Variables for consistent spacing and sizing */
:host {
--grid-gap: 16px;
--tile-padding: 24px;
--header-spacing: 16px;
--content-min-height: 48px;
--value-font-size: 30px;
--unit-font-size: 16px;
--label-font-size: 13px;
--title-font-size: 14px;
--description-spacing: 12px;
--border-radius: 8px;
--grid-gap: 12px;
--tile-padding: 16px;
--header-spacing: 12px;
--content-min-height: 40px;
--value-font-size: 26px;
--unit-font-size: 14px;
--label-font-size: 12px;
--title-font-size: 13px;
--description-spacing: 8px;
--border-radius: 6px;
--transition-duration: 0.15s;
}
@@ -136,7 +155,7 @@ export class DeesStatsGrid extends DeesElement {
/* Tile Base Styles */
.stats-tile {
background: ${cssManager.bdTheme('#ffffff', '#09090b')};
border: 1px solid ${cssManager.bdTheme('hsl(214.3 31.8% 91.4%)', 'hsl(215 20.2% 11.8%)')};
border: 1px solid ${cssManager.bdTheme('#e0e0e0', '#202020')};
border-radius: var(--border-radius);
padding: var(--tile-padding);
transition: all var(--transition-duration) ease;
@@ -148,8 +167,8 @@ export class DeesStatsGrid extends DeesElement {
}
.stats-tile:hover {
background: ${cssManager.bdTheme('hsl(210 40% 98%)', 'hsl(215 20.2% 10.2%)')};
border-color: ${cssManager.bdTheme('hsl(214.3 31.8% 85%)', 'hsl(215 20.2% 16.8%)')};
background: ${cssManager.bdTheme('#fafafa', '#0d0d0d')};
border-color: ${cssManager.bdTheme('#d0d0d0', '#2a2a2a')};
}
.stats-tile.clickable {
@@ -158,7 +177,7 @@ export class DeesStatsGrid extends DeesElement {
.stats-tile.clickable:hover {
transform: translateY(-1px);
box-shadow: 0 2px 8px ${cssManager.bdTheme('rgba(0,0,0,0.04)', 'rgba(0,0,0,0.2)')};
box-shadow: 0 2px 6px ${cssManager.bdTheme('rgba(0,0,0,0.03)', 'rgba(0,0,0,0.15)')};
}
/* Tile Header */
@@ -191,7 +210,6 @@ export class DeesStatsGrid extends DeesElement {
min-height: var(--content-min-height);
display: flex;
flex-direction: column;
justify-content: center;
flex: 1;
}
@@ -230,10 +248,10 @@ export class DeesStatsGrid extends DeesElement {
}
.gauge-container {
width: 140px;
height: 80px;
width: 120px;
height: 70px;
position: relative;
margin-top: -10px;
margin-top: -8px;
}
.gauge-svg {
@@ -243,13 +261,13 @@ export class DeesStatsGrid extends DeesElement {
.gauge-background {
fill: none;
stroke: ${cssManager.bdTheme('hsl(214.3 31.8% 91.4%)', 'hsl(215 20.2% 21.8%)')};
stroke-width: 8;
stroke: ${cssManager.bdTheme('#e8e8e8', '#1a1a1a')};
stroke-width: 6;
}
.gauge-fill {
fill: none;
stroke-width: 8;
stroke-width: 6;
stroke-linecap: round;
transition: stroke-dashoffset 0.6s cubic-bezier(0.4, 0, 0.2, 1);
}
@@ -274,6 +292,9 @@ export class DeesStatsGrid extends DeesElement {
.percentage-wrapper {
width: 100%;
position: relative;
display: flex;
flex-direction: column;
flex: 1;
}
.percentage-value {
@@ -287,17 +308,175 @@ export class DeesStatsGrid extends DeesElement {
.percentage-bar {
width: 100%;
height: 8px;
background: ${cssManager.bdTheme('hsl(214.3 31.8% 91.4%)', 'hsl(215 20.2% 21.8%)')};
border-radius: 4px;
height: 6px;
background: ${cssManager.bdTheme('#e8e8e8', '#1a1a1a')};
border-radius: 3px;
overflow: hidden;
margin-top: auto;
}
.percentage-fill {
height: 100%;
background: ${cssManager.bdTheme('hsl(215.3 25% 8.8%)', 'hsl(210 40% 98%)')};
background: ${cssManager.bdTheme('#333333', '#e0e0e0')};
transition: width 0.6s cubic-bezier(0.4, 0, 0.2, 1);
border-radius: 4px;
border-radius: 3px;
}
/* Multi Percentage Styles */
.multi-percentage-wrapper {
width: 100%;
display: flex;
flex-direction: column;
flex: 1;
}
.multi-percentage-items {
display: flex;
flex-direction: column;
gap: 12px;
margin-top: auto;
}
.multi-percentage-item {
display: flex;
flex-direction: column;
gap: 4px;
}
.multi-percentage-header {
display: flex;
justify-content: space-between;
align-items: baseline;
}
.multi-percentage-label {
font-size: 11px;
font-weight: 500;
color: ${cssManager.bdTheme('hsl(215.4 16.3% 46.9%)', 'hsl(215 20.2% 65.1%)')};
letter-spacing: -0.01em;
}
.multi-percentage-value {
font-size: 13px;
font-weight: 600;
color: ${cssManager.bdTheme('hsl(215.3 25% 8.8%)', 'hsl(210 40% 98%)')};
letter-spacing: -0.01em;
}
.multi-percentage-bar {
width: 100%;
height: 4px;
background: ${cssManager.bdTheme('#e8e8e8', '#1a1a1a')};
border-radius: 2px;
overflow: hidden;
}
.multi-percentage-fill {
height: 100%;
background: ${cssManager.bdTheme('#333333', '#e0e0e0')};
transition: width 0.6s cubic-bezier(0.4, 0, 0.2, 1);
border-radius: 2px;
}
/* CPU Cores Styles */
.cpu-cores-wrapper {
width: 100%;
display: flex;
flex-direction: column;
flex: 1;
min-height: 80px;
}
.cpu-cores-header {
display: flex;
align-items: baseline;
gap: 8px;
margin-bottom: 12px;
}
.cpu-cores-value {
font-size: var(--value-font-size);
font-weight: 600;
color: ${cssManager.bdTheme('hsl(215.3 25% 8.8%)', 'hsl(210 40% 98%)')};
line-height: 1.1;
letter-spacing: -0.025em;
}
.cpu-cores-unit {
font-size: var(--unit-font-size);
font-weight: 400;
color: ${cssManager.bdTheme('hsl(215.4 16.3% 46.9%)', 'hsl(215 20.2% 65.1%)')};
letter-spacing: -0.01em;
}
.cpu-cores-label {
font-size: var(--label-font-size);
font-weight: 500;
color: ${cssManager.bdTheme('hsl(215.4 16.3% 56.9%)', 'hsl(215 20.2% 55.1%)')};
letter-spacing: -0.01em;
margin-left: auto;
}
.cpu-cores-bars {
display: flex;
align-items: flex-end;
gap: 3px;
flex: 1;
min-height: 60px;
padding: 4px 0;
}
.cpu-core-bar-container {
flex: 1;
min-width: 6px;
max-width: 24px;
height: 100%;
display: flex;
flex-direction: column;
align-items: center;
gap: 4px;
}
.cpu-core-bar-wrapper {
flex: 1;
width: 100%;
background: ${cssManager.bdTheme('#e8e8e8', '#1a1a1a')};
border-radius: 2px;
display: flex;
flex-direction: column;
justify-content: flex-end;
overflow: hidden;
min-height: 40px;
}
.cpu-core-bar-fill {
width: 100%;
background: ${cssManager.bdTheme('#666666', '#888888')};
transition: height 0.3s cubic-bezier(0.4, 0, 0.2, 1), background-color 0.3s ease;
border-radius: 2px 2px 0 0;
}
.cpu-core-bar-fill.low {
background: ${cssManager.bdTheme('hsl(142.1 76.2% 36.3%)', 'hsl(142.1 70.6% 45.3%)')};
}
.cpu-core-bar-fill.medium {
background: ${cssManager.bdTheme('hsl(45.4 93.4% 47.5%)', 'hsl(45.4 93.4% 47.5%)')};
}
.cpu-core-bar-fill.high {
background: ${cssManager.bdTheme('hsl(0 84.2% 60.2%)', 'hsl(0 84.2% 60.2%)')};
}
.cpu-core-label {
font-size: 9px;
font-weight: 500;
color: ${cssManager.bdTheme('hsl(215.4 16.3% 56.9%)', 'hsl(215 20.2% 55.1%)')};
text-align: center;
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
max-width: 100%;
}
/* Trend Styles */
@@ -306,6 +485,7 @@ export class DeesStatsGrid extends DeesElement {
display: flex;
flex-direction: column;
gap: 8px;
flex: 1;
}
.trend-header {
@@ -339,8 +519,9 @@ export class DeesStatsGrid extends DeesElement {
.trend-graph {
width: 100%;
height: 32px;
height: 28px;
position: relative;
margin-top: auto;
}
.trend-svg {
@@ -351,14 +532,14 @@ export class DeesStatsGrid extends DeesElement {
.trend-line {
fill: none;
stroke: ${cssManager.bdTheme('hsl(215.4 16.3% 66.9%)', 'hsl(215 20.2% 55.1%)')};
stroke-width: 2;
stroke: ${cssManager.bdTheme('#999999', '#666666')};
stroke-width: 1.5;
stroke-linejoin: round;
stroke-linecap: round;
}
.trend-area {
fill: ${cssManager.bdTheme('hsl(215.4 16.3% 66.9% / 0.1)', 'hsl(215 20.2% 55.1% / 0.08)')};
fill: ${cssManager.bdTheme('rgba(150, 150, 150, 0.08)', 'rgba(100, 100, 100, 0.08)')};
}
/* Text Value Styles */
@@ -420,10 +601,12 @@ export class DeesStatsGrid extends DeesElement {
private renderTile(tile: IStatsTile): TemplateResult {
const hasActions = tile.actions && tile.actions.length > 0;
const clickable = hasActions && tile.actions.length === 1;
const columnSpan = tile.columnSpan && tile.columnSpan > 1 ? tile.columnSpan : undefined;
return html`
<div
class="stats-tile ${clickable ? 'clickable' : ''}"
style="${columnSpan ? `grid-column: span ${columnSpan}` : ''}"
@click=${clickable ? () => this.handleTileAction(tile.actions![0], tile) : undefined}
@contextmenu=${hasActions ? (e: MouseEvent) => this.showContextMenu(e, tile) : undefined}
>
@@ -464,6 +647,12 @@ export class DeesStatsGrid extends DeesElement {
case 'trend':
return this.renderTrend(tile);
case 'multiPercentage':
return this.renderMultiPercentage(tile);
case 'cpuCores':
return this.renderCpuCores(tile);
case 'text':
return html`
<div class="text-value" style="${tile.color ? `color: ${tile.color}` : ''}">
@@ -482,11 +671,11 @@ export class DeesStatsGrid extends DeesElement {
const percentage = ((value - options.min) / (options.max - options.min)) * 100;
// SVG dimensions and calculations
const width = 140;
const height = 80;
const strokeWidth = 8;
const width = 120;
const height = 70;
const strokeWidth = 6;
const padding = strokeWidth / 2 + 2;
const radius = 48;
const radius = 40;
const centerX = width / 2;
const centerY = height - padding;
@@ -595,6 +784,84 @@ export class DeesStatsGrid extends DeesElement {
`;
}
private renderMultiPercentage(tile: IStatsTile): TemplateResult {
if (!tile.percentages || tile.percentages.length === 0) {
return html`<div class="tile-value">${tile.value}</div>`;
}
// Limit to 3 percentages
const items = tile.percentages.slice(0, 3);
return html`
<div class="multi-percentage-wrapper">
<div class="multi-percentage-items">
${items.map(item => {
const percentage = Math.min(100, Math.max(0, item.value));
return html`
<div class="multi-percentage-item">
<div class="multi-percentage-header">
<span class="multi-percentage-label">${item.label}</span>
<span class="multi-percentage-value">${percentage}%</span>
</div>
<div class="multi-percentage-bar">
<div
class="multi-percentage-fill"
style="width: ${percentage}%; ${item.color ? `background: ${item.color}` : ''}"
></div>
</div>
</div>
`;
})}
</div>
</div>
`;
}
private renderCpuCores(tile: IStatsTile): TemplateResult {
if (!tile.coresData || tile.coresData.length === 0) {
return html`<div class="tile-value">${tile.value}</div>`;
}
const cores = tile.coresData;
const avgUsage = Math.round(cores.reduce((sum, core) => sum + core.usage, 0) / cores.length);
// Determine color class based on usage
const getColorClass = (usage: number): string => {
if (usage < 50) return 'low';
if (usage < 80) return 'medium';
return 'high';
};
return html`
<div class="cpu-cores-wrapper">
<div class="cpu-cores-header">
<span class="cpu-cores-value">${avgUsage}</span>
<span class="cpu-cores-unit">%</span>
<span class="cpu-cores-label">${cores.length} cores</span>
</div>
<div class="cpu-cores-bars">
${cores.map(core => {
const usage = Math.min(100, Math.max(0, core.usage));
const colorClass = getColorClass(usage);
return html`
<div class="cpu-core-bar-container" title="Core ${core.label || core.id}: ${usage}%">
<div class="cpu-core-bar-wrapper">
<div
class="cpu-core-bar-fill ${colorClass}"
style="height: ${usage}%"
></div>
</div>
${cores.length <= 16 ? html`
<span class="cpu-core-label">${core.label || core.id}</span>
` : ''}
</div>
`;
})}
</div>
</div>
`;
}
private async handleGridAction(action: plugins.tsclass.website.IMenuItem) {
if (action.action) {
await action.action();

View File

@@ -4,6 +4,104 @@ import type { IMenuItem } from './tab.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
export type TDeesAppui = HTMLElement & {
setAppBarMenus: (menus: IAppBarMenuItem[]) => void;
@@ -42,6 +140,10 @@ export type TDeesAppui = HTMLElement & {
getActivityLogVisible: () => boolean;
navigateToView: (viewId: string, params?: Record<string, string>) => Promise<boolean>;
getCurrentView: () => IViewDefinition | undefined;
// Bottom bar
bottomBar: IBottomBarAPI;
setBottomBarVisible: (visible: boolean) => void;
getBottomBarVisible: () => boolean;
};
/**
@@ -233,6 +335,9 @@ export interface IAppConfig {
/** Activity log configuration */
activityLog?: IActivityLogConfig;
/** Bottom bar configuration */
bottomBar?: IBottomBarConfig;
/** Event callbacks */
onViewChange?: (viewId: string, view: IViewDefinition) => void;
onSearch?: (query: string) => void;