Compare commits

...

35 Commits

Author SHA1 Message Date
264e460365 v3.40.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-27 11:36:24 +00:00
bfda6b75e7 feat(dees-tile): unify tile badge styling and markup; replace component-specific badge classes with shared tile-badge classes and update related imports/tests 2026-01-27 11:36:24 +00:00
825a74b810 v3.39.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-27 11:10:39 +00:00
f6bf0f8a45 fix(dees-tile-note): use horizontal pointer position to scroll note body by computing percentage from clientX and element width instead of clientY and height 2026-01-27 11:10:39 +00:00
66661e05a9 v3.39.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-27 10:57:42 +00:00
162688cdb5 feat(components): add large set of new UI components and demos, reorganize groups, and bump a few dependencies 2026-01-27 10:57:42 +00:00
8158b791c7 v3.38.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-26 01:28:31 +00:00
ed8167385f feat(appui): add app shell and bottom bar APIs, new input components, and update README component listings and docs 2026-01-26 01:28:31 +00:00
b472057e9d v3.37.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-25 13:51:54 +00:00
1bbf853043 fix(editor): fix monaco/editor layout, update dev deps, simplify watch script and remove Playwright snapshots 2026-01-25 13:51:54 +00:00
8ff52fc562 v3.37.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-13 20:45:50 +00:00
5dd0367df0 feat(dees-button,dees-statsgrid): add unified icon property and icon-position support to dees-button; add partition and disk tile types to dees-statsgrid 2026-01-13 20:45:50 +00:00
1982c40337 v3.36.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 23:41:43 +00:00
d2925871fd feat(dees-chart-log): add xterm search addon support and enhance chart log demo with structured/raw (Docker-like) logs and themeable styles 2026-01-12 23:41:43 +00:00
13ed06872a v3.35.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 22:29:18 +00:00
909e49dbd7 fix(dees-statsgrid): center CPU core bars when they occupy less than ~66% of the tile and switch bar fills to absolute positioning for correct alignment and smoother transitions 2026-01-12 22:29:18 +00:00
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
296 changed files with 12087 additions and 2944 deletions

1
.gitignore vendored
View File

@@ -17,3 +17,4 @@ dist/
dist_*/ dist_*/
# custom # custom
.playwright-mcp/

Binary file not shown.

Before

Width:  |  Height:  |  Size: 125 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 76 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 46 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 89 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 89 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 88 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 72 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 74 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 74 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 66 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 43 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 125 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 58 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 56 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 56 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 59 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 74 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 102 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 53 KiB

View File

@@ -1,5 +1,153 @@
# Changelog # Changelog
## 2026-01-27 - 3.40.0 - feat(dees-tile)
unify tile badge styling and markup; replace component-specific badge classes with shared tile-badge classes and update related imports/tests
- Add shared badge styles: .tile-badge-corner, .tile-badge-topright, .tile-badge and layout rules in dees-tile-shared/styles.ts
- Update tile components (audio, video, image, folder, note, pdf) to use new badge markup and remove duplicated badge CSS
- Shift badge positioning when a tile label is present (.tile-container:has(.tile-label))
- Remove older per-component badge rules (duration-badge, item-count-badge, dimension-badge, note-language/note-line-indicator, preview-page-indicator) and replace with unified classes
- Update tests to import dees-contextmenu and dees-dashboardgrid from new 00group-overlay / 00group-layout paths to reflect folder reorganization
## 2026-01-27 - 3.39.1 - fix(dees-tile-note)
use horizontal pointer position to scroll note body by computing percentage from clientX and element width instead of clientY and height
- Changed ts_web/elements/00group-media/dees-tile-note/component.ts: use x = e.clientX - rect.left and percentage = x / rect.width to drive scrollTop calculation instead of using vertical coordinates
- Fixes incorrect scroll mapping where vertical mouse position was used for horizontal scrolling interaction
## 2026-01-27 - 3.39.0 - feat(components)
add large set of new UI components and demos, reorganize groups, and bump a few dependencies
- Add Media viewers: dees-image-viewer, dees-audio-viewer, dees-video-viewer, DeesPdf/DeesPdfViewer and related PDF utilities (CanvasPool, PdfManager) and demos
- Introduce dees-preview composite that auto-detects content and delegates to appropriate viewers
- New Tile system (DeesTileBase) and tile components: dees-tile-pdf, dees-tile-image, dees-tile-audio, dees-tile-video, dees-tile-note, dees-tile-folder plus demos
- Add dashboard/grid system: dees-dashboardgrid with drag/resize, collision resolution, layout helpers, demos and utilities
- Data view additions: dees-table with lucene-like query parser, column utilities, and dees-statsgrid enhancements (including cpuCores visualization)
- New feedback & overlay components: dees-toast, dees-actionbar, dees-progressbar, dees-spinner, dees-badge and supporting demos/interfaces
- Many layout and utility components added or improved: dees-panel, dees-chips, dees-heading, dees-label, dees-pagination, dees-stepper, and associated demos
- Refactor project structure: components organized into 00group-* directories and demo metadata migrated from demoGroup to demoGroups (string[]); many import path updates to match new grouping
- Deprecations/notes: dees-pdf-preview and legacy dees-pdf marked as deprecated in favor of new viewers/tiles
- Dependency bumps in package.json: @design.estate/dees-wcctools -> ^3.8.0, @git.zone/tstest -> ^3.1.8
## 2026-01-26 - 3.38.0 - feat(appui)
add app shell and bottom bar APIs, new input components, and update README component listings and docs
- README: updated components count (80+ → 70+), reorganized categories (added App Shell / Pre-built Templates, renamed Workspace/IDE) and improved typography
- Document listing: added DeesActionbar, DeesInputToggle, DeesInputCode, DeesAppuiBottombar and other component entries
- Menu item interface: added closeable and onClose properties for dismissible menu items
- IViewDefinition: expanded content type to accept element constructors and async content, added badgeVariant and cache flags
- New interfaces added: IBottomBarWidget, IBottomBarAction, IViewActivationContext to support bottom bar widgets/actions and view activation context
## 2026-01-25 - 3.37.1 - fix(editor)
fix monaco/editor layout, update dev deps, simplify watch script and remove Playwright snapshots
- Make dees-input-code host and inner wrappers flex so Monaco editor grows to fill available height (set flex, min-height and height:100% where needed).
- Set dees-workspace-monaco and editor-wrapper to stretch so the embedded Monaco editor fills the component.
- Bump dev dependencies: @git.zone/tsbuild -> ^4.1.2, @git.zone/tsbundle -> ^2.8.3, @git.zone/tstest -> ^3.1.7, @git.zone/tswatch -> ^3.0.1; also bump @types/node -> ^25.0.10 and lucide -> ^0.563.0.
- Change npm script: watch from "tswatch element" to "tswatch" and add @git.zone/tswatch preset in npmextra.json.
- Add .playwright-mcp/ to .gitignore and remove many Playwright screenshot/test artifact PNGs to keep repo tidy.
## 2026-01-13 - 3.37.0 - feat(dees-button,dees-statsgrid)
add unified icon property and icon-position support to dees-button; add partition and disk tile types to dees-statsgrid
- dees-button: introduce icon (string) and iconPosition ('left'|'right') properties; extractLightDom() migrates legacy <dees-icon> slotted usage into properties and supports icon-only buttons
- dees-button: render left/right icon, hide text for icon-only size; preserve backward compatibility for old type mappings
- Demo updates: convert iconFA attributes to new icon syntax (e.g. 'fa:plus', 'lucide:Search') and add new icon-via-property examples and event logging
- dees-statsgrid: add IPartitionData and IDiskData interfaces and new tile types 'partition' and 'disk' with rendering, styles and thresholds (usage, filesystem, mountpoint, capacity, iops, health)
- dees-statsgrid.demo: add Disk & Storage demo panel with sample partition and disk tiles and configuration notes
- misc: added/updated many demo images and metadata to reflect new icon/tile features
## 2026-01-12 - 3.36.0 - feat(dees-chart-log)
add xterm search addon support and enhance chart log demo with structured/raw (Docker-like) logs and themeable styles
- Add IXtermSearchAddon and IXtermSearchAddonBundle types and integrate xterm-addon-search loading in DeesServiceLibLoader with caching and preload support
- Expose new types in services index and add xtermAddonSearch version to CDN_VERSIONS
- Enhance dees-chart-log demo: separate structured and raw (docker) log panels, add Docker/ANSI log templates, start/stop controls for each simulation, and raw log writing
- Switch demo styling to cssManager theme-aware CSS, and import css helpers from dees-element
- Add many .playwright-mcp PNG assets used by demos/tests
## 2026-01-12 - 3.35.1 - fix(dees-statsgrid)
center CPU core bars when they occupy less than ~66% of the tile and switch bar fills to absolute positioning for correct alignment and smoother transitions
- Add .cpu-cores-bars.centered CSS rule to horizontally center the bars when appropriate.
- Compute shouldCenter by estimating max bars width (cores * 24px + gaps) and comparing to estimated tile content width (accounts for columnSpan, minTileWidth, gap and ~32px padding), using a 66.6% threshold.
- Change .cpu-core-bar-container to position: relative and .cpu-core-bar-fill to position: absolute (bottom:0; left:0; right:0) to ensure correct vertical alignment and smoother height transitions.
## 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) ## 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 set min-height: 0 on .maingrid > dees-appui-maincontent to prevent layout overflow in flex container

View File

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

View File

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

3246
pnpm-lock.yaml generated

File diff suppressed because it is too large Load Diff

View File

@@ -801,3 +801,310 @@ html`
- **State Persistence**: Save/restore collapsed menus, selections, and current view - **State Persistence**: Save/restore collapsed menus, selections, and current view
- **View-specific Menus**: Each view can define its own secondary menu and tabs - **View-specific Menus**: Each view can define its own secondary menu and tabs
- **Full Backward Compatibility**: Existing code continues to work - **Full Backward Compatibility**: Existing code continues to work
## AppUI Bottom Bar (2026-01-03)
Added a new `dees-appui-bottombar` component similar to `dees-workspace-bottombar`, providing a 24px fixed-height status bar at the bottom of the app shell.
### Features:
- **Generic status widgets**: Configurable widgets with icon, label, status colors, loading spinner
- **App-specific actions**: Quick action buttons with icons and tooltips
- **Always visible**: Fixed 24px height at the bottom of the app
- **Status colors**: idle, active (blue), success (green), warning (yellow), error (red)
- **Context menus**: Widgets can have right-click context menus
### New Interfaces (in `interfaces/appconfig.ts`):
```typescript
interface IBottomBarWidget {
id: string;
iconName?: string;
label?: string;
status?: 'idle' | 'active' | 'success' | 'warning' | 'error';
tooltip?: string;
loading?: boolean;
onClick?: () => void;
contextMenuItems?: IBottomBarContextMenuItem[];
position?: 'left' | 'right';
order?: number;
}
interface IBottomBarAction {
id: string;
iconName: string;
tooltip?: string;
onClick: () => void | Promise<void>;
disabled?: boolean;
position?: 'left' | 'right';
}
interface IBottomBarConfig {
visible?: boolean;
widgets?: IBottomBarWidget[];
actions?: IBottomBarAction[];
}
```
### Usage via configure():
```typescript
const config: IAppConfig = {
// ... other config
bottomBar: {
visible: true,
widgets: [
{
id: 'status',
iconName: 'lucide:activity',
label: 'System Online',
status: 'success',
tooltip: 'All systems operational',
onClick: () => console.log('Status clicked'),
},
{
id: 'notifications',
iconName: 'lucide:bell',
label: '3 notifications',
status: 'warning',
position: 'left',
},
{
id: 'version',
iconName: 'lucide:gitBranch',
label: 'v1.2.3',
position: 'right',
},
],
actions: [
{
id: 'terminal',
iconName: 'lucide:terminal',
tooltip: 'Open Terminal',
position: 'right',
onClick: () => console.log('Terminal clicked'),
},
],
},
};
```
### Programmatic API:
```typescript
// Add/update/remove widgets
appui.bottomBar.addWidget({ id: 'status', ... });
appui.bottomBar.updateWidget('status', { status: 'error', label: 'Error!' });
appui.bottomBar.removeWidget('status');
appui.bottomBar.clearWidgets();
// Add/remove actions
appui.bottomBar.addAction({ id: 'refresh', iconName: 'lucide:refreshCw', ... });
appui.bottomBar.removeAction('refresh');
appui.bottomBar.clearActions();
// Visibility control
appui.setBottomBarVisible(false);
appui.getBottomBarVisible();
```
### Files:
- `ts_web/elements/00group-appui/dees-appui-bottombar/dees-appui-bottombar.ts` - Main component
- `ts_web/elements/00group-appui/dees-appui-bottombar/dees-appui-bottombar.demo.ts` - Demo
- `ts_web/elements/interfaces/appconfig.ts` - New interfaces added
## Media Components (2026-01-26)
New media viewer components and a unified preview composite component.
### Directory: `ts_web/elements/00group-media/`
#### dees-image-viewer
- Image display with zoom, pan, fit, and download controls
- Properties: `src`, `alt`, `fit` ('contain'|'cover'|'actual'), `showToolbar`
- Features: mouse wheel zoom, click-drag pan, double-click toggle, checkerboard transparency background
- Toolbar matches PDF viewer pattern (48px height, 32px buttons, 16px icons, 6px border-radius)
#### dees-audio-viewer
- Audio player with waveform visualization via Web Audio API
- Properties: `src`, `title`, `artist`, `showWaveform`, `autoplay`, `loop`
- Features: canvas waveform rendering, play/pause, seek, volume control, mute toggle, loop toggle
- Uses `HTMLAudioElement` for playback, `AudioContext.decodeAudioData` for waveform data
#### dees-video-viewer
- Video player with custom overlay controls
- Properties: `src`, `poster`, `showControls`, `autoplay`, `loop`, `muted`
- Features: custom controls bar with gradient, seekbar, volume slider, fullscreen toggle, auto-hide controls, 16:9 aspect ratio
### dees-preview (Composite Component)
- Auto-detects content type and delegates to the appropriate viewer
- Directory: `ts_web/elements/dees-preview/`
- Properties: `url`, `file` (File object), `base64`, `textContent`, `contentType` (override), `language`, `mimeType`, `filename`, `showToolbar`, `showFilename`
- Content type detection priority: explicit override → MIME type → file extension → fallback
- Renders: image→DeesImageViewer, pdf→DeesPdfViewer, code→DeesDataviewCodebox, audio→DeesAudioViewer, video→DeesVideoViewer, text→pre, unknown→placeholder
- Header bar with file type icon, filename, and type badge
### dees-dataview-codebox modification
- Removed `<dees-windowcontrols>` elements from the appbar (Step 1 of the plan)
- Now shows clean centered filename title bar without fake window buttons
### Icon Sizing Convention
- All `dees-icon` elements in buttons need explicit `font-size: 16px` CSS rule
- Toolbar buttons: 32px × 32px, border-radius: 6px
- Placeholder/error icons: `font-size: 32px`
- Pattern: `.button-class dees-icon { font-size: 16px; }`
## Tile Component System (2026-01-27)
A family of 200×260px content preview cards with a shared abstract base class. All tiles support lazy loading (IntersectionObserver with 200px margin), hover lift effect, click events, loading/error states, and three sizes (small: 150×195, default: 200×260, large: 250×325).
### Architecture
- **DeesTileBase** (`dees-tile-shared/DeesTileBase.ts`) — Abstract base class extending DeesElement
- Common properties: `clickable`, `loading`, `error`, `size`, `label`
- IntersectionObserver lazy loading via `onBecameVisible()` hook
- Click dispatch via `tile-click` CustomEvent (detail from `getTileClickDetail()`)
- Subclasses implement `renderTileContent(): TemplateResult`
### Components
| Tag | Class | Description |
|-----|-------|-------------|
| `dees-tile-pdf` | `DeesTilePdf` | PDF page thumbnail with hover-to-browse pages. Canvas-rendered via PDF.js/CanvasPool. |
| `dees-tile-image` | `DeesTileImage` | Image thumbnail with `object-fit: cover`, dimension detection on load |
| `dees-tile-audio` | `DeesTileAudio` | Music icon + mini waveform (AudioContext decode), duration badge |
| `dees-tile-video` | `DeesTileVideo` | Auto-captured first frame, duration badge, hover muted auto-preview |
| `dees-tile-note` | `DeesTileNote` | First ~12 lines of text in monospace, gradient fade, optional language badge |
| `dees-tile-folder` | `DeesTileFolder` | 2×2 grid of mini-previews (thumbnails or type icons), item count badge |
### Deprecations
- `dees-pdf-preview` → Use `dees-tile-pdf` instead. Old tag still works as a thin wrapper with console warning.
- `dees-pdf` deprecation comment updated to reference `DeesTilePdf`.
### File Structure
All tile components live in `ts_web/elements/00group-media/dees-tile-*/`:
- `component.ts` — Main component class
- `demo.ts` — Demo function
- `index.ts` — Re-export
- `styles.ts` — (PDF tile only) Component-specific styles
- Shared base: `dees-tile-shared/{DeesTileBase,styles,index}.ts`
### Interface: ITileFolderItem
```typescript
interface ITileFolderItem {
type: 'pdf' | 'image' | 'audio' | 'video' | 'note' | 'folder' | 'unknown';
thumbnailSrc?: string;
name: string;
}
```
## 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
## Component Group Taxonomy (2026-01-27)
All components are organized into `00group-*` directories with 14 groups visible in the wcctools sidebar. The `demoGroups` property (plural, `string[]`) replaces the old `demoGroup` (singular). Components can belong to multiple groups.
### Group Directories
| Directory | Group Name | Count |
|-----------|-----------|-------|
| `00group-appui` | App UI | 10 |
| `00group-button` | Button | 3 |
| `00group-chart` | Chart | 2 |
| `00group-dataview` | Data View | 4 |
| `00group-feedback` | Feedback | 6 |
| `00group-form` | Form | 2 |
| `00group-input` | Input | 18 |
| `00group-layout` | Layout | 7 |
| `00group-media` | Media | 14 (viewers + PDF + tiles) |
| `00group-overlay` | Overlay | 4 |
| `00group-simple` | Simple | 3 |
| `00group-utility` | Utility | 5 |
| `00group-workspace` | Workspace | 9 |
| `00group-runtime` | (internal) | - |
### Multi-Group Components
Some components appear in multiple groups via `demoGroups = ['Primary', 'Secondary']`:
- `dees-chart-log`: Chart, Workspace
- `dees-dataview-codebox`: Data View, Workspace
- `dees-input-code`: Input, Workspace
- `dees-input-wysiwyg`: Input, Workspace
- `dees-form-submit`: Form, Button
- `dees-preview`: Media, Data View
- `dees-pdf*` / `dees-tile-pdf`: Media, PDF
- `dees-stepper`: Layout, Form
- `dees-label`: Layout, Input
- `dees-toast`: Feedback, Overlay
- `dees-actionbar`: Feedback, Overlay
### Import Conventions
- Within same group: `import '../sibling-component/file.js'`
- Cross-group (from depth-2): `import '../../00group-X/component/file.js'`
- Shared utilities: `import '../../00plugins.js'`, `import '../../00theme.js'`, etc.
### Key Notes
- The old `demoGroup` property (singular, string) is fully removed
- All 79 components with demos use `demoGroups` (plural, string[])
- `00group-pdf` no longer exists; PDF components are in `00group-media`
- `dees-search` and `dees-tooltip` remain standalone (no demos)

406
readme.md
View File

@@ -1,6 +1,6 @@
# @design.estate/dees-catalog # @design.estate/dees-catalog
A comprehensive web components library built with TypeScript and LitElement, providing **80+ production-ready UI components** for building modern web applications with consistent design and behavior. 🚀 A comprehensive web components library built with TypeScript and LitElement, providing **70+ production-ready UI components** for building modern web applications with consistent design and behavior. 🚀
[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/) [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
[![LitElement](https://img.shields.io/badge/LitElement-4.0+-orange.svg)](https://lit.dev/) [![LitElement](https://img.shields.io/badge/LitElement-4.0+-orange.svg)](https://lit.dev/)
@@ -11,12 +11,13 @@ For reporting bugs, issues, or security vulnerabilities, please visit [community
## ✨ Features ## ✨ Features
- 🎨 **Consistent Design System** - Beautiful, cohesive components following modern UI/UX principles - 🎨 **Consistent Design System** Beautiful, cohesive components following modern UI/UX principles
- 🌙 **Dark/Light Theme Support** - All components automatically adapt to your theme - 🌙 **Dark/Light Theme Support** All components automatically adapt to your theme
- ⌨️ **Keyboard Accessible** - Full keyboard navigation and ARIA support - ⌨️ **Keyboard Accessible** Full keyboard navigation and ARIA support
- 📱 **Responsive** - Mobile-first design that works across all screen sizes - 📱 **Responsive** Mobile-first design that works across all screen sizes
- 🔧 **TypeScript-First** - Fully typed APIs with excellent IDE support - 🔧 **TypeScript-First** Fully typed APIs with excellent IDE support
- 🧩 **Modular** - Use only what you need, tree-shakeable architecture - 🧩 **Modular** Use only what you need, tree-shakeable architecture
- 🏗️ **Full App Shell**`dees-appui` provides a complete application framework with menus, routing, activity log, and bottom bar
## 📦 Installation ## 📦 Installation
@@ -52,16 +53,16 @@ For developers working on this library, please refer to the [UI Components Playb
| Category | Components | | Category | Components |
|----------|------------| |----------|------------|
| **Core UI** | [`DeesButton`](#deesbutton), [`DeesButtonExit`](#deesbuttonexit), [`DeesButtonGroup`](#deesbuttongroup), [`DeesBadge`](#deesbadge), [`DeesChips`](#deeschips), [`DeesHeading`](#deesheading), [`DeesHint`](#deeshint), [`DeesIcon`](#deesicon), [`DeesLabel`](#deeslabel), [`DeesPanel`](#deespanel), [`DeesSearchbar`](#deessearchbar), [`DeesSpinner`](#deesspinner), [`DeesToast`](#deestoast), [`DeesWindowcontrols`](#deeswindowcontrols) | | **Core UI** | [`DeesButton`](#deesbutton), [`DeesButtonExit`](#deesbuttonexit), [`DeesButtonGroup`](#deesbuttongroup), [`DeesBadge`](#deesbadge), [`DeesChips`](#deeschips), [`DeesHeading`](#deesheading), [`DeesHint`](#deeshint), [`DeesIcon`](#deesicon), [`DeesLabel`](#deeslabel), [`DeesPanel`](#deespanel), [`DeesSearchbar`](#deessearchbar), [`DeesSpinner`](#deesspinner), [`DeesToast`](#deestoast), [`DeesWindowcontrols`](#deeswindowcontrols), [`DeesActionbar`](#deesactionbar) |
| **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) | | **Forms** | [`DeesForm`](#deesform), [`DeesInputText`](#deesinputtext), [`DeesInputCheckbox`](#deesinputcheckbox), [`DeesInputDropdown`](#deesinputdropdown), [`DeesInputRadiogroup`](#deesinputradiogroup), [`DeesInputFileupload`](#deesinputfileupload), [`DeesInputIban`](#deesinputiban), [`DeesInputPhone`](#deesinputphone), [`DeesInputQuantitySelector`](#deesinputquantityselector), [`DeesInputMultitoggle`](#deesinputmultitoggle), [`DeesInputToggle`](#deesinputtoggle), [`DeesInputTags`](#deesinputtags), [`DeesInputTypelist`](#deesinputtypelist), [`DeesInputList`](#deesinputlist), [`DeesInputProfilepicture`](#deesinputprofilepicture), [`DeesInputRichtext`](#deesinputrichtext), [`DeesInputWysiwyg`](#deesinputwysiwyg), [`DeesInputDatepicker`](#deesinputdatepicker), [`DeesInputSearchselect`](#deesinputsearchselect), [`DeesInputCode`](#deesinputcode), [`DeesFormSubmit`](#deesformsubmit) |
| **Layout** | [`DeesAppui`](#deesappui), [`DeesAppuiMainmenu`](#deesappuimainmenu), [`DeesAppuiSecondarymenu`](#deesappuisecondarymenu), [`DeesAppuiMaincontent`](#deesappuimaincontent), [`DeesAppuiAppbar`](#deesappuiappbar), [`DeesAppuiActivitylog`](#deesappuiactivitylog), [`DeesAppuiProfiledropdown`](#deesappuiprofiledropdown), [`DeesAppuiTabs`](#deesappuitabs), [`DeesMobileNavigation`](#deesmobilenavigation), [`DeesDashboardGrid`](#deesdashboardgrid) | | **App Shell (Layout)** | [`DeesAppui`](#deesappui-), [`DeesAppuiMainmenu`](#deesappuimainmenu), [`DeesAppuiSecondarymenu`](#deesappuisecondarymenu), [`DeesAppuiMaincontent`](#deesappuimaincontent), [`DeesAppuiAppbar`](#deesappuiappbar), [`DeesAppuiActivitylog`](#deesappuiactivitylog), [`DeesAppuiBottombar`](#deesappuibottombar), [`DeesAppuiProfiledropdown`](#deesappuiprofiledropdown), [`DeesAppuiTabs`](#deesappuitabs), [`DeesMobileNavigation`](#deesmobilenavigation), [`DeesDashboardGrid`](#deesdashboardgrid) |
| **Data Display** | [`DeesTable`](#deestable), [`DeesDataviewCodebox`](#deesdataviewcodebox), [`DeesDataviewStatusobject`](#deesdataviewstatusobject), [`DeesPdf`](#deespdf), [`DeesStatsGrid`](#deesstatsgrid), [`DeesPagination`](#deespagination) | | **Data Display** | [`DeesTable`](#deestable), [`DeesDataviewCodebox`](#deesdataviewcodebox), [`DeesDataviewStatusobject`](#deesdataviewstatusobject), [`DeesPdf`](#deespdf), [`DeesStatsGrid`](#deesstatsgrid), [`DeesPagination`](#deespagination) |
| **Visualization** | [`DeesChartArea`](#deeschartarea), [`DeesChartLog`](#deeschartlog) | | **Visualization** | [`DeesChartArea`](#deeschartarea), [`DeesChartLog`](#deeschartlog) |
| **Dialogs & Overlays** | [`DeesModal`](#deesmodal), [`DeesContextmenu`](#deescontextmenu), [`DeesSpeechbubble`](#deesspeechbubble), [`DeesWindowlayer`](#deeswindowlayer) | | **Dialogs & Overlays** | [`DeesModal`](#deesmodal), [`DeesContextmenu`](#deescontextmenu), [`DeesSpeechbubble`](#deesspeechbubble), [`DeesWindowlayer`](#deeswindowlayer) |
| **Navigation** | [`DeesStepper`](#deesstepper), [`DeesProgressbar`](#deesprogressbar) | | **Navigation** | [`DeesStepper`](#deesstepper), [`DeesProgressbar`](#deesprogressbar) |
| **Development** | [`DeesEditor`](#deeseditor), [`DeesEditorMarkdown`](#deeseditormarkdown), [`DeesEditorMarkdownoutlet`](#deeseditormarkdownoutlet), [`DeesTerminal`](#deesterminal), [`DeesUpdater`](#deesupdater) | | **Workspace / IDE** | [`DeesEditor`](#deeseditor), [`DeesTerminal`](#deesterminal), [`DeesUpdater`](#deesupdater) |
| **Theming** | [`DeesTheme`](#deestheme) | | **Theming** | [`DeesTheme`](#deestheme) |
| **Auth & Utilities** | [`DeesSimpleAppdash`](#deessimpleappdash), [`DeesSimpleLogin`](#deessimplelogin) | | **Pre-built Templates** | [`DeesSimpleAppdash`](#deessimpleappdash), [`DeesSimpleLogin`](#deessimplelogin) |
| **Shopping** | [`DeesShoppingProductcard`](#deesshoppingproductcard) | | **Shopping** | [`DeesShoppingProductcard`](#deesshoppingproductcard) |
--- ---
@@ -117,14 +118,14 @@ Interactive chips/tags with selection capabilities.
Display icons from FontAwesome and Lucide icon libraries with library prefixes. Display icons from FontAwesome and Lucide icon libraries with library prefixes.
```typescript ```typescript
// FontAwesome icons - use 'fa:' prefix // FontAwesome icons use 'fa:' prefix
<dees-icon <dees-icon
icon="fa:check" // FontAwesome icon with fa: prefix icon="fa:check" // FontAwesome icon with fa: prefix
iconSize="24" // Size in pixels iconSize="24" // Size in pixels
color="#22c55e" // Optional: custom color color="#22c55e" // Optional: custom color
></dees-icon> ></dees-icon>
// Lucide icons - use 'lucide:' prefix // Lucide icons use 'lucide:' prefix
<dees-icon <dees-icon
icon="lucide:menu" // Lucide icon with lucide: prefix icon="lucide:menu" // Lucide icon with lucide: prefix
iconSize="24" // Size in pixels iconSize="24" // Size in pixels
@@ -134,7 +135,7 @@ Display icons from FontAwesome and Lucide icon libraries with library prefixes.
// Legacy API (deprecated but still supported) // Legacy API (deprecated but still supported)
<dees-icon <dees-icon
iconFA="check" // Without prefix - assumes FontAwesome iconFA="check" // Without prefix assumes FontAwesome
></dees-icon> ></dees-icon>
``` ```
@@ -287,6 +288,18 @@ Window control buttons (minimize, maximize, close) for desktop-like applications
></dees-windowcontrols> ></dees-windowcontrols>
``` ```
#### `DeesActionbar`
Floating action bar for contextual actions.
```typescript
<dees-actionbar
.actions=${[
{ icon: 'lucide:save', label: 'Save', action: () => handleSave() },
{ icon: 'lucide:trash', label: 'Delete', action: () => handleDelete() }
]}
></dees-actionbar>
```
--- ---
### Form Components ### Form Components
@@ -331,6 +344,18 @@ Checkbox input component for boolean values.
></dees-input-checkbox> ></dees-input-checkbox>
``` ```
#### `DeesInputToggle`
Toggle switch component for boolean on/off states.
```typescript
<dees-input-toggle
key="darkMode"
label="Enable Dark Mode"
.value=${true}
@change=${handleToggle}
></dees-input-toggle>
```
#### `DeesInputDropdown` #### `DeesInputDropdown`
Dropdown selection component with search and filtering capabilities. Dropdown selection component with search and filtering capabilities.
@@ -658,6 +683,19 @@ Advanced block-based editor with slash commands and rich content blocks.
- Collaborative editing ready - Collaborative editing ready
- Extensible block types - Extensible block types
#### `DeesInputCode`
Code input component for editing source code with syntax highlighting.
```typescript
<dees-input-code
key="snippet"
label="Code Snippet"
.value=${codeString}
language="typescript"
@change=${handleCodeChange}
></dees-input-code>
```
#### `DeesFormSubmit` #### `DeesFormSubmit`
Submit button component specifically designed for `DeesForm`. Submit button component specifically designed for `DeesForm`.
@@ -670,10 +708,10 @@ Submit button component specifically designed for `DeesForm`.
--- ---
### Layout Components ### App Shell (Layout) Components
#### `DeesAppui` #### `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, bottom bar, and view management.
> **Full API Documentation**: See [ts_web/elements/00group-appui/dees-appui/readme.md](./ts_web/elements/00group-appui/dees-appui/readme.md) for complete documentation including all programmatic APIs, view lifecycle hooks, and TypeScript interfaces. > **Full API Documentation**: See [ts_web/elements/00group-appui/dees-appui/readme.md](./ts_web/elements/00group-appui/dees-appui/readme.md) for complete documentation including all programmatic APIs, view lifecycle hooks, and TypeScript interfaces.
@@ -690,7 +728,6 @@ class MyApp extends DeesElement {
async firstUpdated() { async firstUpdated() {
this.appui = this.shadowRoot.querySelector('dees-appui'); this.appui = this.shadowRoot.querySelector('dees-appui');
// Configure with views and menu
this.appui.configure({ this.appui.configure({
branding: { logoIcon: 'lucide:box', logoText: 'My App' }, branding: { logoIcon: 'lucide:box', logoText: 'My App' },
views: [ views: [
@@ -700,7 +737,13 @@ class MyApp extends DeesElement {
mainMenu: { mainMenu: {
sections: [{ name: 'Main', views: ['dashboard', 'settings'] }] sections: [{ name: 'Main', views: ['dashboard', 'settings'] }]
}, },
defaultView: 'dashboard' defaultView: 'dashboard',
bottomBar: {
visible: true,
widgets: [
{ id: 'status', iconName: 'lucide:activity', label: 'Online', status: 'success' }
]
}
}); });
} }
@@ -710,43 +753,123 @@ class MyApp extends DeesElement {
} }
``` ```
**Key Features:** **Architecture Overview:**
- **Configure API**: Single `configure()` method for complete app setup
- **View Management**: Automatic view caching, lazy loading, and lifecycle hooks
- **Programmatic APIs**: Full control over AppBar, Main Menu, Secondary Menu, Content Tabs, and Activity Log
- **View Lifecycle Hooks**: `onActivate()`, `onDeactivate()`, and `canDeactivate()` for view components
- **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 ┌─────────────────────────────────────────────────────────────────────┐
- `setAppBarMenus()`, `setBreadcrumbs()`, `setUser()` - Control the app bar │ AppBar (dees-appui-appbar) │
- `setMainMenu()`, `setMainMenuSelection()`, `setMainMenuBadge()` - Control main navigation │ ├── Menus (File, Edit, View...) │
- `setMainMenuCollapsed()`, `setMainMenuVisible()` - Control main menu visibility │ ├── Breadcrumbs │
- `setSecondaryMenu()`, `setSecondaryMenuCollapsed()`, `setSecondaryMenuVisible()` - Control secondary menu │ ├── User Profile + Dropdown │
- `setContentTabs()`, `setContentTabsVisible()` - Control view-specific UI │ └── Activity Log Toggle │
- `activityLog.add()`, `activityLog.addMany()`, `activityLog.clear()` - Manage activity entries ├─────────────┬───────────────────────────────────┬───────────────────┤
- `setActivityLogVisible()`, `toggleActivityLog()`, `getActivityLogVisible()` - Control activity panel │ Main Menu │ Content Area │ Activity Log
│ (collapsed/ │ ├── Content Tabs │ (slide panel) │
│ expanded) │ │ (closable, from tables/lists)│ │
│ │ └── View Container │ │
│ ┌─────────┐ │ └── Active View │ │
│ │ 🏠 Home │ ├─────────────────────────────────┐ │ │
│ │ 📁 Files│ │ Secondary Menu │ │ │
│ │ ⚙ Set.. │ │ ├── Collapsible Groups │ │ │
│ │ │ │ │ ├── Tabs / Actions │ │ │
│ └─────────┘ │ │ ├── Filters / Links │ │ │
│ │ │ └── Dividers / Headers │ │ │
├─────────────┴──┴───────────────────────────────┴───────────────────┤
│ Bottom Bar (dees-appui-bottombar) — 24px status bar │
│ ├── Status widgets (left/right) │
│ └── Action buttons (left/right) │
└─────────────────────────────────────────────────────────────────────┘
```
**Configuration (`IAppConfig`):**
**View Visibility Control:**
```typescript ```typescript
// In your view's onActivate hook interface IAppConfig {
onActivate(context: IViewActivationContext) { branding?: { logoIcon?: string; logoText?: string };
// Hide secondary menu for a fullscreen view appBar?: IAppBarConfig;
context.appui.setSecondaryMenuVisible(false); views: IViewDefinition[];
mainMenu?: IMainMenuConfig;
// Hide content tabs defaultView?: string;
context.appui.setContentTabsVisible(false); activityLog?: IActivityLogConfig;
bottomBar?: IBottomBarConfig;
// Collapse main menu to give more space onViewChange?: (viewId: string, view: IViewDefinition) => void;
context.appui.setMainMenuCollapsed(true); onSearch?: (query: string) => void;
} }
``` ```
**Key Features:**
- 🔧 **Configure API** — Single `configure()` method for complete app setup
- 📄 **View Management** — Automatic view caching, lazy loading, and lifecycle hooks (`onActivate`, `onDeactivate`, `canDeactivate`)
- 🧭 **Hash-based Routing** — Automatic URL synchronization with view navigation and parameterized routes
- 📊 **Activity Log** — Slide-out panel with stacked entries, date grouping, search, and filtering
- 📌 **Bottom Status Bar** — Configurable widgets and actions with status colors and loading states
- 🎯 **RxJS Observables**`viewChanged$` and `viewLifecycle$` for reactive programming
- 🏷️ **TypeScript-first** — Typed `IViewActivationContext` passed to views on activation
**Programmatic APIs:**
| Area | Methods |
|------|---------|
| **Navigation** | `navigateToView(viewId, params?)`, `getCurrentView()`, `getViewRegistry()` |
| **App Bar** | `setAppBarMenus()`, `updateAppBarMenu()`, `setBreadcrumbs()`, `setUser()`, `setProfileMenuItems()`, `setSearchVisible()`, `onSearch()`, `setWindowControlsVisible()` |
| **Main Menu** | `setMainMenu()`, `updateMainMenuGroup()`, `addMainMenuItem()`, `removeMainMenuItem()`, `setMainMenuSelection()`, `setMainMenuCollapsed()`, `setMainMenuVisible()`, `setMainMenuBadge()`, `clearMainMenuBadge()` |
| **Secondary Menu** | `setSecondaryMenu()`, `updateSecondaryMenuGroup()`, `addSecondaryMenuItem()`, `setSecondaryMenuSelection()`, `setSecondaryMenuCollapsed()`, `setSecondaryMenuVisible()`, `clearSecondaryMenu()` |
| **Content Tabs** | `setContentTabs()`, `addContentTab()`, `removeContentTab()`, `selectContentTab()`, `getSelectedContentTab()`, `setContentTabsVisible()`, `setContentTabsAutoHide()` |
| **Activity Log** | `activityLog.add()`, `activityLog.addMany()`, `activityLog.clear()`, `activityLog.getEntries()`, `activityLog.filter()`, `activityLog.search()`, `setActivityLogVisible()`, `toggleActivityLog()`, `getActivityLogVisible()` |
| **Bottom Bar** | `bottomBar.addWidget()`, `bottomBar.updateWidget()`, `bottomBar.removeWidget()`, `bottomBar.getWidget()`, `bottomBar.clearWidgets()`, `bottomBar.addAction()`, `bottomBar.removeAction()`, `bottomBar.clearActions()`, `setBottomBarVisible()`, `getBottomBarVisible()` |
| **Observables** | `viewChanged$`, `viewLifecycle$` |
**View Lifecycle Hooks:**
```typescript
import { DeesElement, customElement } from '@design.estate/dees-element';
import type { IViewActivationContext, IViewLifecycle } from '@design.estate/dees-catalog';
@customElement('my-settings-view')
class MySettingsView extends DeesElement implements IViewLifecycle {
// Called when view becomes visible
async onActivate(context: IViewActivationContext) {
const { appui, viewId, params } = context;
// Set view-specific secondary menu
appui.setSecondaryMenu({
heading: 'Settings',
groups: [{ name: 'Options', items: [...] }]
});
// Control visibility of other shell parts
appui.setContentTabsVisible(false);
appui.setSecondaryMenuVisible(true);
}
// Called when navigating away
onDeactivate() { /* cleanup */ }
// Return false or a message string to block navigation
canDeactivate(): boolean | string {
if (this.hasUnsavedChanges) return 'You have unsaved changes. Leave anyway?';
return true;
}
}
```
**Secondary Menu Item Types:**
The secondary menu supports **8 distinct item types** for building rich contextual sidebars:
| Type | Description |
|------|-------------|
| **Tab** (default) | Selectable item that stays highlighted |
| **Action** | Executes on click without staying selected (blue styling) |
| **Filter** | Checkbox toggle for filtering |
| **MultiFilter** | Collapsible multi-select filter box |
| **Divider** | Visual separator line |
| **Header** | Non-interactive section label |
| **Link** | Opens an external URL |
| **Danger Action** | Red-styled action with optional confirmation |
#### `DeesAppuiMainmenu` #### `DeesAppuiMainmenu`
Main navigation menu component for application-wide navigation. Main navigation menu component for application-wide navigation. Supports collapsed (icon-only) mode.
```typescript ```typescript
<dees-appui-mainmenu <dees-appui-mainmenu
@@ -759,12 +882,12 @@ Main navigation menu component for application-wide navigation.
] ]
} }
]} ]}
collapsed // Optional: show collapsed version collapsed // Optional: show collapsed icon-only version
></dees-appui-mainmenu> ></dees-appui-mainmenu>
``` ```
#### `DeesAppuiSecondarymenu` #### `DeesAppuiSecondarymenu`
Secondary navigation component for sub-section selection with collapsible groups and badges. Secondary navigation component for sub-section selection with collapsible groups, badges, and 8 item types.
```typescript ```typescript
<dees-appui-secondarymenu <dees-appui-secondarymenu
@@ -806,28 +929,12 @@ Professional application bar component with hierarchical menus, breadcrumb navig
.menuItems=${[ .menuItems=${[
{ {
name: 'File', name: 'File',
action: async () => {}, // No-op for parent menu items action: async () => {},
submenu: [ submenu: [
{ { name: 'New File', shortcut: 'Cmd+N', iconName: 'file-plus', action: async () => handleNewFile() },
name: 'New File', { name: 'Open...', shortcut: 'Cmd+O', iconName: 'folder-open', action: async () => handleOpen() },
shortcut: 'Cmd+N', { divider: true },
iconName: 'file-plus', { name: 'Save', shortcut: 'Cmd+S', iconName: 'save', action: async () => handleSave(), disabled: true }
action: async () => handleNewFile()
},
{
name: 'Open...',
shortcut: 'Cmd+O',
iconName: 'folder-open',
action: async () => handleOpen()
},
{ divider: true }, // Menu separator
{
name: 'Save',
shortcut: 'Cmd+S',
iconName: 'save',
action: async () => handleSave(),
disabled: true // Disabled state
}
] ]
} }
]} ]}
@@ -849,12 +956,12 @@ Professional application bar component with hierarchical menus, breadcrumb navig
``` ```
**Key Features:** **Key Features:**
- **Hierarchical Menu System** - Top-level menus with dropdown submenus, icons, and keyboard shortcuts - **Hierarchical Menu System** Top-level menus with dropdown submenus, icons, and keyboard shortcuts
- **Keyboard Navigation** - Full keyboard support (Tab, Arrow keys, Enter, Escape) - **Keyboard Navigation** Full keyboard support (Tab, Arrow keys, Enter, Escape)
- **Breadcrumb Navigation** - Customizable breadcrumb trail with click events - **Breadcrumb Navigation** Customizable breadcrumb trail with click events
- **User Account Section** - Avatar with status indicator and profile dropdown - **User Account Section** Avatar with status indicator and profile dropdown
- **Activity Log Toggle** - Button with badge count to show/hide activity panel - **Activity Log Toggle** Button with badge count to show/hide activity panel
- **Accessibility** - Full ARIA support with menubar roles - **Accessibility** Full ARIA support with menubar roles
#### `DeesAppuiActivitylog` #### `DeesAppuiActivitylog`
Real-time activity log panel for displaying user actions and system events. Real-time activity log panel for displaying user actions and system events.
@@ -886,6 +993,61 @@ activityLog.search('settings'); // Search by message
- Animated slide-in/out panel - Animated slide-in/out panel
- Theme-aware styling - Theme-aware styling
#### `DeesAppuiBottombar`
A 24px fixed-height status bar at the bottom of the application shell. Supports status widgets and action buttons positioned left or right.
```typescript
// Configure via DeesAppui
appui.configure({
bottomBar: {
visible: true,
widgets: [
{
id: 'status',
iconName: 'lucide:activity',
label: 'System Online',
status: 'success', // 'idle' | 'active' | 'success' | 'warning' | 'error'
tooltip: 'All systems operational',
onClick: () => console.log('Status clicked'),
},
{
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 updates
appui.bottomBar.addWidget({ id: 'build', iconName: 'lucide:hammer', label: 'Building...', loading: true, status: 'active' });
appui.bottomBar.updateWidget('build', { label: 'Build complete', loading: false, status: 'success' });
appui.bottomBar.removeWidget('build');
appui.bottomBar.addAction({ id: 'refresh', iconName: 'lucide:refreshCw', onClick: () => location.reload() });
appui.bottomBar.removeAction('refresh');
appui.setBottomBarVisible(false);
```
**Key Features:**
- Configurable status widgets with icons, labels, and colored status indicators
- Loading spinner state for widgets
- Contextual actions with icon buttons
- Left/right positioning for both widgets and actions
- Tooltips on hover
- Context menu support per widget
#### `DeesAppuiTabs` #### `DeesAppuiTabs`
Reusable tab component with horizontal/vertical layout support. Reusable tab component with horizontal/vertical layout support.
@@ -1007,7 +1169,7 @@ A responsive grid component for displaying statistical data with various visuali
value: 125420, value: 125420,
unit: '$', unit: '$',
type: 'number', type: 'number',
icon: 'faDollarSign', icon: 'lucide:dollarSign',
description: '+12.5% from last month', description: '+12.5% from last month',
color: '#22c55e' color: '#22c55e'
}, },
@@ -1016,7 +1178,7 @@ A responsive grid component for displaying statistical data with various visuali
title: 'CPU Usage', title: 'CPU Usage',
value: 73, value: 73,
type: 'gauge', type: 'gauge',
icon: 'faMicrochip', icon: 'lucide:cpu',
gaugeOptions: { gaugeOptions: {
min: 0, max: 100, min: 0, max: 100,
thresholds: [ thresholds: [
@@ -1032,8 +1194,22 @@ A responsive grid component for displaying statistical data with various visuali
value: '1.2k', value: '1.2k',
unit: '/min', unit: '/min',
type: 'trend', type: 'trend',
icon: 'faServer', icon: 'lucide:server',
trendData: [45, 52, 38, 65, 72, 68, 75, 82, 79, 85, 88, 92] trendData: [45, 52, 38, 65, 72, 68, 75, 82, 79, 85, 88, 92]
},
{
id: 'cores',
title: 'CPU Cores',
value: 0,
type: 'cpuCores',
icon: 'lucide:cpu',
columnSpan: 2,
coresData: [
{ id: 0, usage: 45, label: '0' },
{ id: 1, usage: 72, label: '1' },
{ id: 2, usage: 30, label: '2' },
{ id: 3, usage: 88, label: '3' }
]
} }
]} ]}
.minTileWidth=${250} .minTileWidth=${250}
@@ -1041,6 +1217,8 @@ A responsive grid component for displaying statistical data with various visuali
></dees-statsgrid> ></dees-statsgrid>
``` ```
**Tile Types:** `number`, `gauge`, `percentage`, `trend`, `text`, `multiPercentage`, `cpuCores`
#### `DeesPagination` #### `DeesPagination`
Pagination component for navigating through large datasets. Pagination component for navigating through large datasets.
@@ -1189,7 +1367,7 @@ Progress indicator component for tracking completion status.
Theme provider component that wraps children and provides CSS custom properties for consistent theming. Theme provider component that wraps children and provides CSS custom properties for consistent theming.
```typescript ```typescript
// Basic usage - wrap your app // Basic usage wrap your app
<dees-theme> <dees-theme>
<my-app></my-app> <my-app></my-app>
</dees-theme> </dees-theme>
@@ -1217,7 +1395,7 @@ Theme provider component that wraps children and provides CSS custom properties
--- ---
### Development Components ### Workspace / IDE Components
#### `DeesEditor` #### `DeesEditor`
Code editor component with syntax highlighting and code completion, powered by Monaco Editor. Code editor component with syntax highlighting and code completion, powered by Monaco Editor.
@@ -1236,28 +1414,6 @@ Code editor component with syntax highlighting and code completion, powered by M
></dees-editor> ></dees-editor>
``` ```
#### `DeesEditorMarkdown`
Markdown editor component with live preview.
```typescript
<dees-editor-markdown
.value=${markdown}
@change=${handleMarkdownChange}
.options=${{ preview: true, toolbar: true, spellcheck: true }}
></dees-editor-markdown>
```
#### `DeesEditorMarkdownoutlet`
Markdown preview component for rendering markdown content.
```typescript
<dees-editor-markdownoutlet
.markdown=${markdownContent}
.theme=${'github'}
allowHtml={false}
></dees-editor-markdownoutlet>
```
#### `DeesTerminal` #### `DeesTerminal`
Terminal emulator component for command-line interface. Terminal emulator component for command-line interface.
@@ -1286,7 +1442,7 @@ Component for managing application updates and version control.
--- ---
### Auth & Utilities Components ### Pre-built Templates
#### `DeesSimpleAppdash` #### `DeesSimpleAppdash`
Simple application dashboard component for quick prototyping. Simple application dashboard component for quick prototyping.
@@ -1360,6 +1516,8 @@ interface IMenuItem {
action: () => void; action: () => void;
badge?: string | number; badge?: string | number;
badgeVariant?: 'default' | 'success' | 'warning' | 'error'; badgeVariant?: 'default' | 'success' | 'warning' | 'error';
closeable?: boolean;
onClose?: () => void;
} }
// Menu group interface for organized menus // Menu group interface for organized menus
@@ -1375,11 +1533,13 @@ interface IViewDefinition {
id: string; id: string;
name: string; name: string;
iconName?: string; iconName?: string;
content: string | HTMLElement | (() => TemplateResult); content: string | (new () => HTMLElement) | (() => TemplateResult) | (() => Promise<any>);
secondaryMenu?: ISecondaryMenuGroup[]; secondaryMenu?: ISecondaryMenuGroup[];
contentTabs?: IMenuItem[]; contentTabs?: IMenuItem[];
route?: string; route?: string;
badge?: string | number; badge?: string | number;
badgeVariant?: 'default' | 'success' | 'warning' | 'error';
cache?: boolean;
} }
// Activity log entry // Activity log entry
@@ -1392,6 +1552,36 @@ interface IActivityEntry {
iconName?: string; iconName?: string;
data?: Record<string, unknown>; data?: Record<string, unknown>;
} }
// Bottom bar widget
interface IBottomBarWidget {
id: string;
iconName?: string;
label?: string;
status?: 'idle' | 'active' | 'success' | 'warning' | 'error';
tooltip?: string;
loading?: boolean;
onClick?: () => void;
position?: 'left' | 'right';
order?: number;
}
// Bottom bar action button
interface IBottomBarAction {
id: string;
iconName: string;
tooltip?: string;
onClick: () => void | Promise<void>;
disabled?: boolean;
position?: 'left' | 'right';
}
// View activation context (passed to onActivate)
interface IViewActivationContext {
appui: DeesAppui;
viewId: string;
params?: Record<string, string>;
}
``` ```
--- ---

View File

View File

@@ -1,6 +1,6 @@
import { expect, tap } from '@git.zone/tstest/tapbundle'; import { expect, tap } from '@git.zone/tstest/tapbundle';
import { DeesContextmenu } from '../ts_web/elements/dees-contextmenu/dees-contextmenu.js'; import { DeesContextmenu } from '../ts_web/elements/00group-overlay/dees-contextmenu/dees-contextmenu.js';
import { demoFunc } from '../ts_web/elements/dees-contextmenu/dees-contextmenu.demo.js'; import { demoFunc } from '../ts_web/elements/00group-overlay/dees-contextmenu/dees-contextmenu.demo.js';
tap.test('should render context menu demo', async () => { tap.test('should render context menu demo', async () => {
// Create demo container // Create demo container

View File

@@ -1,5 +1,5 @@
import { expect, tap } from '@git.zone/tstest/tapbundle'; import { expect, tap } from '@git.zone/tstest/tapbundle';
import { DeesContextmenu } from '../ts_web/elements/dees-contextmenu/dees-contextmenu.js'; import { DeesContextmenu } from '../ts_web/elements/00group-overlay/dees-contextmenu/dees-contextmenu.js';
tap.test('should close all parent menus when clicking action in nested submenu', async () => { tap.test('should close all parent menus when clicking action in nested submenu', async () => {
let actionCalled = false; let actionCalled = false;

View File

@@ -1,5 +1,5 @@
import { expect, tap } from '@git.zone/tstest/tapbundle'; import { expect, tap } from '@git.zone/tstest/tapbundle';
import { DeesContextmenu } from '../ts_web/elements/dees-contextmenu/dees-contextmenu.js'; import { DeesContextmenu } from '../ts_web/elements/00group-overlay/dees-contextmenu/dees-contextmenu.js';
import { DeesElement, customElement, html } from '@design.estate/dees-element'; import { DeesElement, customElement, html } from '@design.estate/dees-element';
// Create a test element with shadow DOM // Create a test element with shadow DOM

View File

@@ -1,5 +1,5 @@
import { expect, tap } from '@git.zone/tstest/tapbundle'; import { expect, tap } from '@git.zone/tstest/tapbundle';
import { DeesContextmenu } from '../ts_web/elements/dees-contextmenu/dees-contextmenu.js'; import { DeesContextmenu } from '../ts_web/elements/00group-overlay/dees-contextmenu/dees-contextmenu.js';
tap.test('should show context menu with nested submenu', async () => { tap.test('should show context menu with nested submenu', async () => {
// Create a test element with context menu items // Create a test element with context menu items

View File

@@ -3,8 +3,8 @@ import { tap, expect } from '@git.zone/tstest/tapbundle';
import { import {
resolveWidgetPlacement, resolveWidgetPlacement,
collectCollisions, collectCollisions,
} from '../ts_web/elements/dees-dashboardgrid/layout.ts'; } from '../ts_web/elements/00group-layout/dees-dashboardgrid/layout.ts';
import type { DashboardWidget } from '../ts_web/elements/dees-dashboardgrid/types.ts'; import type { DashboardWidget } from '../ts_web/elements/00group-layout/dees-dashboardgrid/types.ts';
tap.test('dashboardgrid does not overlap widgets after swap attempt', async () => { tap.test('dashboardgrid does not overlap widgets after swap attempt', async () => {
const widgets: DashboardWidget[] = [ const widgets: DashboardWidget[] = [

View File

@@ -1,6 +1,6 @@
import { expect, tap } from '@git.zone/tstest/tapbundle'; import { expect, tap } from '@git.zone/tstest/tapbundle';
import { DeesInputWysiwyg } from '../ts_web/elements/00group-input/dees-input-wysiwyg/dees-input-wysiwyg.js'; import { DeesInputWysiwyg } from '../ts_web/elements/00group-input/dees-input-wysiwyg/dees-input-wysiwyg.js';
import { DeesContextmenu } from '../ts_web/elements/dees-contextmenu/dees-contextmenu.js'; import { DeesContextmenu } from '../ts_web/elements/00group-overlay/dees-contextmenu/dees-contextmenu.js';
tap.test('should change block type via context menu', async () => { tap.test('should change block type via context menu', async () => {
// Create WYSIWYG editor with a paragraph // Create WYSIWYG editor with a paragraph

View File

@@ -1,6 +1,6 @@
import { expect, tap } from '@git.zone/tstest/tapbundle'; import { expect, tap } from '@git.zone/tstest/tapbundle';
import { DeesInputWysiwyg } from '../ts_web/elements/00group-input/dees-input-wysiwyg/dees-input-wysiwyg.js'; import { DeesInputWysiwyg } from '../ts_web/elements/00group-input/dees-input-wysiwyg/dees-input-wysiwyg.js';
import { DeesContextmenu } from '../ts_web/elements/dees-contextmenu/dees-contextmenu.js'; import { DeesContextmenu } from '../ts_web/elements/00group-overlay/dees-contextmenu/dees-contextmenu.js';
tap.test('should show context menu on WYSIWYG blocks', async () => { tap.test('should show context menu on WYSIWYG blocks', async () => {
// Create WYSIWYG editor // Create WYSIWYG editor

View File

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

View File

@@ -10,8 +10,8 @@ import {
} from '@design.estate/dees-element'; } from '@design.estate/dees-element';
import * as domtools from '@design.estate/dees-domtools'; import * as domtools from '@design.estate/dees-domtools';
import { DeesContextmenu } from '../../dees-contextmenu/dees-contextmenu.js'; import { DeesContextmenu } from '../../00group-overlay/dees-contextmenu/dees-contextmenu.js';
import '../../dees-icon/dees-icon.js'; import '../../00group-utility/dees-icon/dees-icon.js';
import type { IActivityEntry, IActivityLogAPI } from '../../interfaces/appconfig.js'; import type { IActivityEntry, IActivityLogAPI } from '../../interfaces/appconfig.js';
import { demoFunc } from './dees-appui-activitylog.demo.js'; import { demoFunc } from './dees-appui-activitylog.demo.js';
import { themeDefaultStyles } from '../../00theme.js'; import { themeDefaultStyles } from '../../00theme.js';
@@ -20,6 +20,7 @@ import { themeDefaultStyles } from '../../00theme.js';
export class DeesAppuiActivitylog extends DeesElement implements IActivityLogAPI { export class DeesAppuiActivitylog extends DeesElement implements IActivityLogAPI {
// STATIC // STATIC
public static demo = demoFunc; public static demo = demoFunc;
public static demoGroups = ['App UI'];
// INSTANCE PROPERTIES // INSTANCE PROPERTIES
@state() @state()
@@ -122,6 +123,7 @@ export class DeesAppuiActivitylog extends DeesElement implements IActivityLogAPI
width: 100%; width: 100%;
padding: 8px 0; padding: 8px 0;
overflow-y: auto; overflow-y: auto;
overscroll-behavior: contain;
scrollbar-width: thin; scrollbar-width: thin;
scrollbar-color: ${cssManager.bdTheme('#d4d4d4', '#333333')} transparent; scrollbar-color: ${cssManager.bdTheme('#d4d4d4', '#333333')} transparent;
} }

View File

@@ -15,8 +15,8 @@ import { appuiAppbarStyles } from './styles.js';
import { renderAppuiAppbar } from './template.js'; import { renderAppuiAppbar } from './template.js';
// Import required components // Import required components
import '../../dees-icon/dees-icon.js'; import '../../00group-utility/dees-icon/dees-icon.js';
import '../../dees-windowcontrols/dees-windowcontrols.js'; import '../../00group-utility/dees-windowcontrols/dees-windowcontrols.js';
import '../dees-appui-profiledropdown/dees-appui-profiledropdown.js'; import '../dees-appui-profiledropdown/dees-appui-profiledropdown.js';
declare global { declare global {
@@ -28,6 +28,7 @@ declare global {
@customElement('dees-appui-appbar') @customElement('dees-appui-appbar')
export class DeesAppuiBar extends DeesElement { export class DeesAppuiBar extends DeesElement {
public static demo = demoFunc; public static demo = demoFunc;
public static demoGroups = ['App UI'];
// INSTANCE PROPERTIES // INSTANCE PROPERTIES
@property({ type: Array }) @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 '../../00group-utility/dees-icon/dees-icon.js';
import { DeesContextmenu } from '../../00group-overlay/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 demoGroups = ['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> </div>
</dees-appui-maincontent> </dees-appui-maincontent>
`; `;
public static demoGroups = ['App UI'];
// INSTANCE // INSTANCE
@property({ @property({

View File

@@ -11,7 +11,7 @@ import {
css, css,
cssManager, cssManager,
} from '@design.estate/dees-element'; } from '@design.estate/dees-element';
import { DeesContextmenu } from '../../dees-contextmenu/dees-contextmenu.js'; import { DeesContextmenu } from '../../00group-overlay/dees-contextmenu/dees-contextmenu.js';
import { demoFunc } from './dees-appui-mainmenu.demo.js'; import { demoFunc } from './dees-appui-mainmenu.demo.js';
import { themeDefaultStyles } from '../../00theme.js'; import { themeDefaultStyles } from '../../00theme.js';
@@ -22,6 +22,7 @@ import { themeDefaultStyles } from '../../00theme.js';
@customElement('dees-appui-mainmenu') @customElement('dees-appui-mainmenu')
export class DeesAppuiMainmenu extends DeesElement { export class DeesAppuiMainmenu extends DeesElement {
public static demo = demoFunc; public static demo = demoFunc;
public static demoGroups = ['App UI'];
// INSTANCE // INSTANCE
@@ -164,6 +165,7 @@ export class DeesAppuiMainmenu extends DeesElement {
flex: 1; flex: 1;
overflow-y: auto; overflow-y: auto;
overflow-x: hidden; overflow-x: hidden;
overscroll-behavior: contain;
padding: 8px 0; padding: 8px 0;
} }

View File

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

View File

@@ -1,8 +1,8 @@
import * as plugins from '../../00plugins.js'; import * as plugins from '../../00plugins.js';
import * as interfaces from '../../interfaces/index.js'; import * as interfaces from '../../interfaces/index.js';
import { DeesContextmenu } from '../../dees-contextmenu/dees-contextmenu.js'; import { DeesContextmenu } from '../../00group-overlay/dees-contextmenu/dees-contextmenu.js';
import '../../dees-icon/dees-icon.js'; import '../../00group-utility/dees-icon/dees-icon.js';
import { import {
DeesElement, DeesElement,
@@ -33,6 +33,7 @@ import { themeDefaultStyles } from '../../00theme.js';
@customElement('dees-appui-secondarymenu') @customElement('dees-appui-secondarymenu')
export class DeesAppuiSecondarymenu extends DeesElement { export class DeesAppuiSecondarymenu extends DeesElement {
public static demo = demoFunc; public static demo = demoFunc;
public static demoGroups = ['App UI'];
// INSTANCE // INSTANCE
@@ -201,6 +202,7 @@ export class DeesAppuiSecondarymenu extends DeesElement {
flex: 1; flex: 1;
overflow-y: auto; overflow-y: auto;
overflow-x: hidden; overflow-x: hidden;
overscroll-behavior: contain;
padding: 8px 0; padding: 8px 0;
} }

View File

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

View File

@@ -3,6 +3,8 @@ import type { DeesAppui } from './dees-appui.js';
import type { IAppConfig, IViewActivationContext } from '../../interfaces/appconfig.js'; import type { IAppConfig, IViewActivationContext } from '../../interfaces/appconfig.js';
import type * as interfaces from '../../interfaces/index.js'; import type * as interfaces from '../../interfaces/index.js';
import '@design.estate/dees-wcctools/demotools'; import '@design.estate/dees-wcctools/demotools';
import '../../00group-dataview/dees-statsgrid/dees-statsgrid.js';
import type { IStatsTile } from '../../00group-dataview/dees-statsgrid/dees-statsgrid.js';
// Demo view component with lifecycle hooks // Demo view component with lifecycle hooks
@customElement('demo-dashboard-view') @customElement('demo-dashboard-view')
@@ -12,6 +14,79 @@ class DemoDashboardView extends DeesElement {
private ctx: IViewActivationContext; 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) { onActivate(context: IViewActivationContext) {
this.ctx = context; this.ctx = context;
this.activated = true; this.activated = true;
@@ -83,21 +158,9 @@ class DemoDashboardView extends DeesElement {
} }
h1 { color: #fafafa; font-weight: 600; font-size: 24px; margin-bottom: 8px; } h1 { color: #fafafa; font-weight: 600; font-size: 24px; margin-bottom: 8px; }
p { color: #737373; margin-bottom: 32px; } p { color: #737373; margin-bottom: 32px; }
.grid { dees-statsgrid {
display: grid; margin-bottom: 32px;
grid-template-columns: repeat(3, 1fr);
gap: 16px;
} }
.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 { .ctx-actions {
margin-top: 32px; margin-top: 32px;
@@ -147,23 +210,10 @@ class DemoDashboardView extends DeesElement {
</style> </style>
<h1>Dashboard</h1> <h1>Dashboard</h1>
<p>Welcome back! Here's an overview of your system.</p> <p>Welcome back! Here's an overview of your system.</p>
<div class="grid"> <dees-statsgrid
<div class="card"> .tiles=${this.statsTiles}
<h3>Active Users</h3> @tile-action=${(e: CustomEvent) => console.log('Tile action:', e.detail)}
<div class="metric">1,234</div> ></dees-statsgrid>
<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>
<div class="ctx-actions"> <div class="ctx-actions">
<h2>Context Actions (ctx.appui)</h2> <h2>Context Actions (ctx.appui)</h2>
@@ -663,6 +713,44 @@ export const demoFunc = () => {
defaultView: 'dashboard', defaultView: 'dashboard',
bottomBar: {
visible: true,
widgets: [
{
id: 'status',
iconName: 'lucide:activity',
label: 'System Online',
status: 'success',
tooltip: 'All systems operational',
onClick: () => console.log('Status clicked'),
},
{
id: 'notifications',
iconName: 'lucide:bell',
label: '3 notifications',
status: 'warning',
tooltip: 'You have unread notifications',
onClick: () => console.log('Notifications clicked'),
},
{
id: 'version',
iconName: 'lucide:gitBranch',
label: 'v1.2.3',
position: 'right',
tooltip: 'Current version',
},
],
actions: [
{
id: 'terminal',
iconName: 'lucide:terminal',
tooltip: 'Open Terminal',
position: 'right',
onClick: () => console.log('Terminal clicked'),
},
],
},
onViewChange: (viewId, view) => { onViewChange: (viewId, view) => {
console.log(`View changed to: ${viewId} (${view.name})`); console.log(`View changed to: ${viewId} (${view.name})`);
}, },

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 { DeesAppuiSecondarymenu } from '../dees-appui-secondarymenu/dees-appui-secondarymenu.js';
import type { DeesAppuiMaincontent } from '../dees-appui-maincontent/dees-appui-maincontent.js'; import type { DeesAppuiMaincontent } from '../dees-appui-maincontent/dees-appui-maincontent.js';
import type { DeesAppuiActivitylog } from '../dees-appui-activitylog/dees-appui-activitylog.js'; import type { DeesAppuiActivitylog } from '../dees-appui-activitylog/dees-appui-activitylog.js';
import type { DeesAppuiBottombar } from '../dees-appui-bottombar/dees-appui-bottombar.js';
import { demoFunc } from './dees-appui.demo.js'; import { demoFunc } from './dees-appui.demo.js';
import { themeDefaultStyles } from '../../00theme.js'; import { themeDefaultStyles } from '../../00theme.js';
@@ -23,6 +24,7 @@ import { ViewRegistry } from './view.registry.js';
// Import child components // Import child components
import '../dees-appui-appbar/index.js'; import '../dees-appui-appbar/index.js';
import '../dees-appui-bottombar/dees-appui-bottombar.js';
import '../dees-appui-mainmenu/dees-appui-mainmenu.js'; import '../dees-appui-mainmenu/dees-appui-mainmenu.js';
import '../dees-appui-secondarymenu/dees-appui-secondarymenu.js'; import '../dees-appui-secondarymenu/dees-appui-secondarymenu.js';
import '../dees-appui-maincontent/dees-appui-maincontent.js'; import '../dees-appui-maincontent/dees-appui-maincontent.js';
@@ -37,6 +39,7 @@ declare global {
@customElement('dees-appui') @customElement('dees-appui')
export class DeesAppui extends DeesElement { export class DeesAppui extends DeesElement {
public static demo = demoFunc; public static demo = demoFunc;
public static demoGroups = ['App UI'];
// ========================================== // ==========================================
// REACTIVE OBSERVABLES (RxJS Subjects) // REACTIVE OBSERVABLES (RxJS Subjects)
@@ -156,6 +159,12 @@ export class DeesAppui extends DeesElement {
@state() @state()
accessor activitylogElement: DeesAppuiActivitylog | undefined = undefined; accessor activitylogElement: DeesAppuiActivitylog | undefined = undefined;
@state()
accessor bottombarElement: DeesAppuiBottombar | undefined = undefined;
@state()
accessor bottombarVisible: boolean = true;
// Current view state // Current view state
@state() @state()
accessor currentView: interfaces.IViewDefinition | undefined = undefined; accessor currentView: interfaces.IViewDefinition | undefined = undefined;
@@ -179,15 +188,27 @@ export class DeesAppui extends DeesElement {
.maingrid { .maingrid {
position: absolute; position: absolute;
top: 40px; top: 40px;
height: calc(100% - 40px); height: calc(100% - 40px - 24px);
width: 100%; width: 100%;
display: grid; display: grid;
/* grid-template-columns set dynamically in template */ /* grid-template-columns set dynamically in template */
grid-template-rows: 1fr; grid-template-rows: 1fr;
transition: grid-template-columns 0.3s ease; transition: grid-template-columns 0.3s ease, height 0.3s ease;
overflow: hidden; overflow: hidden;
} }
:host([bottombar-hidden]) .maingrid {
height: calc(100% - 40px);
}
dees-appui-bottombar {
position: absolute;
bottom: 0;
left: 0;
right: 0;
z-index: 4;
}
/* Z-index layering for proper stacking */ /* Z-index layering for proper stacking */
.maingrid > dees-appui-mainmenu { .maingrid > dees-appui-mainmenu {
position: relative; position: relative;
@@ -295,6 +316,9 @@ export class DeesAppui extends DeesElement {
class="${this.activityLogVisible ? 'visible' : 'hidden'}" class="${this.activityLogVisible ? 'visible' : 'hidden'}"
></dees-appui-activitylog> ></dees-appui-activitylog>
</div> </div>
${this.bottombarVisible ? html`
<dees-appui-bottombar></dees-appui-bottombar>
` : ''}
`; `;
} }
@@ -305,6 +329,7 @@ export class DeesAppui extends DeesElement {
this.secondarymenu = this.shadowRoot!.querySelector('dees-appui-secondarymenu') as DeesAppuiSecondarymenu; this.secondarymenu = this.shadowRoot!.querySelector('dees-appui-secondarymenu') as DeesAppuiSecondarymenu;
this.maincontent = this.shadowRoot!.querySelector('dees-appui-maincontent') as DeesAppuiMaincontent; this.maincontent = this.shadowRoot!.querySelector('dees-appui-maincontent') as DeesAppuiMaincontent;
this.activitylogElement = this.shadowRoot!.querySelector('dees-appui-activitylog') as DeesAppuiActivitylog; this.activitylogElement = this.shadowRoot!.querySelector('dees-appui-activitylog') as DeesAppuiActivitylog;
this.bottombarElement = this.shadowRoot!.querySelector('dees-appui-bottombar') as DeesAppuiBottombar;
// Subscribe to activity log entry changes for badge count // Subscribe to activity log entry changes for badge count
if (this.activitylogElement) { if (this.activitylogElement) {
@@ -730,6 +755,72 @@ export class DeesAppui extends DeesElement {
return this.activityLogVisible; return this.activityLogVisible;
} }
// ==========================================
// PROGRAMMATIC API: BOTTOM BAR
// ==========================================
/**
* Get the bottom bar API for widget/action management
*/
public get bottomBar(): interfaces.IBottomBarAPI {
if (!this.bottombarElement) {
// Return a deferred API that will work after firstUpdated
return {
addWidget: (widget) => {
this.updateComplete.then(() => this.bottombarElement?.addWidget(widget));
},
updateWidget: (id, update) => {
this.updateComplete.then(() => this.bottombarElement?.updateWidget(id, update));
},
removeWidget: (id) => {
this.updateComplete.then(() => this.bottombarElement?.removeWidget(id));
},
getWidget: (id) => this.bottombarElement?.getWidget(id),
clearWidgets: () => {
this.updateComplete.then(() => this.bottombarElement?.clearWidgets());
},
addAction: (action) => {
this.updateComplete.then(() => this.bottombarElement?.addAction(action));
},
removeAction: (id) => {
this.updateComplete.then(() => this.bottombarElement?.removeAction(id));
},
clearActions: () => {
this.updateComplete.then(() => this.bottombarElement?.clearActions());
},
};
}
return {
addWidget: (widget) => this.bottombarElement!.addWidget(widget),
updateWidget: (id, update) => this.bottombarElement!.updateWidget(id, update),
removeWidget: (id) => this.bottombarElement!.removeWidget(id),
getWidget: (id) => this.bottombarElement!.getWidget(id),
clearWidgets: () => this.bottombarElement!.clearWidgets(),
addAction: (action) => this.bottombarElement!.addAction(action),
removeAction: (id) => this.bottombarElement!.removeAction(id),
clearActions: () => this.bottombarElement!.clearActions(),
};
}
/**
* Set bottom bar visibility
*/
public setBottomBarVisible(visible: boolean): void {
this.bottombarVisible = visible;
if (!visible) {
this.setAttribute('bottombar-hidden', '');
} else {
this.removeAttribute('bottombar-hidden');
}
}
/**
* Get bottom bar visibility state
*/
public getBottomBarVisible(): boolean {
return this.bottombarVisible;
}
// ========================================== // ==========================================
// PROGRAMMATIC API: NAVIGATION // PROGRAMMATIC API: NAVIGATION
// ========================================== // ==========================================
@@ -842,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 // Setup domtools.router integration
this.setupRouterIntegration(config); this.setupRouterIntegration(config);

View File

@@ -1,6 +1,6 @@
import { html, css } from '@design.estate/dees-element'; import { html, css } from '@design.estate/dees-element';
import '../00group-button/dees-button/dees-button.js'; import '../00group-button/dees-button/dees-button.js';
import '../dees-panel/dees-panel.js'; import '../../00group-layout/dees-panel/dees-panel.js';
import '@design.estate/dees-wcctools/demotools'; import '@design.estate/dees-wcctools/demotools';
export const demoFunc = () => html` export const demoFunc = () => html`

View File

@@ -1,6 +1,6 @@
import * as plugins from '../00plugins.js'; import * as plugins from '../../00plugins.js';
import { zIndexRegistry } from '../00zindex.js'; import { zIndexRegistry } from '../../00zindex.js';
import { cssGeistFontFamily } from '../00fonts.js'; import { cssGeistFontFamily } from '../../00fonts.js';
import { import {
cssManager, cssManager,
css, css,
@@ -12,13 +12,14 @@ import {
property, property,
state, state,
} from '@design.estate/dees-element'; } from '@design.estate/dees-element';
import { DeesWindowLayer } from '../dees-windowlayer/dees-windowlayer.js'; import { DeesWindowLayer } from '../../00group-overlay/dees-windowlayer/dees-windowlayer.js';
import '../dees-icon/dees-icon.js'; import '../../00group-utility/dees-icon/dees-icon.js';
import { themeDefaultStyles } from '../00theme.js'; import { themeDefaultStyles } from '../../00theme.js';
@customElement('dees-mobilenavigation') @customElement('dees-mobilenavigation')
export class DeesMobilenavigation extends DeesElement { export class DeesMobilenavigation extends DeesElement {
// STATIC // STATIC
public static demoGroups = ['App UI'];
public static demo = () => html` public static demo = () => html`
<dees-button @click=${() => { <dees-button @click=${() => {
DeesMobilenavigation.createAndShow([ DeesMobilenavigation.createAndShow([

View File

@@ -1,9 +1,11 @@
// App UI Components // App UI Components
export * from './dees-appui-activitylog/index.js'; export * from './dees-appui-activitylog/index.js';
export * from './dees-appui-appbar/index.js'; export * from './dees-appui-appbar/index.js';
export * from './dees-appui-bottombar/index.js';
export * from './dees-appui/index.js'; export * from './dees-appui/index.js';
export * from './dees-appui-maincontent/index.js'; export * from './dees-appui-maincontent/index.js';
export * from './dees-appui-mainmenu/index.js'; export * from './dees-appui-mainmenu/index.js';
export * from './dees-appui-secondarymenu/index.js'; export * from './dees-appui-secondarymenu/index.js';
export * from './dees-appui-profiledropdown/index.js'; export * from './dees-appui-profiledropdown/index.js';
export * from './dees-appui-tabs/index.js'; export * from './dees-appui-tabs/index.js';
export * from './dees-mobilenavigation/index.js';

View File

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

View File

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

View File

@@ -1,10 +1,10 @@
import { html, css, cssManager, domtools } from '@design.estate/dees-element'; import { html, css, cssManager, domtools } from '@design.estate/dees-element';
import '@design.estate/dees-wcctools/demotools'; import '@design.estate/dees-wcctools/demotools';
import '../../dees-panel/dees-panel.js'; import '../../00group-layout/dees-panel/dees-panel.js';
import '../../00group-form/dees-form/dees-form.js'; import '../../00group-form/dees-form/dees-form.js';
import '../../00group-form/dees-form-submit/dees-form-submit.js'; import '../../00group-form/dees-form-submit/dees-form-submit.js';
import '../../00group-input/dees-input-text/dees-input-text.js'; import '../../00group-input/dees-input-text/dees-input-text.js';
import '../../dees-icon/dees-icon.js'; import '../../00group-utility/dees-icon/dees-icon.js';
import type { DeesButton } from '../dees-button/dees-button.js'; import type { DeesButton } from '../dees-button/dees-button.js';
export const demoFunc = () => html` export const demoFunc = () => html`
@@ -142,54 +142,95 @@ export const demoFunc = () => html`
<dees-panel .title=${'3. Buttons with Icons'} .subtitle=${'Combining icons with text for enhanced visual communication'}> <dees-panel .title=${'3. Buttons with Icons'} .subtitle=${'Combining icons with text for enhanced visual communication'}>
<div class="icon-row"> <div class="icon-row">
<dees-button> <dees-button>
<dees-icon iconFA="faPlus"></dees-icon> <dees-icon icon="fa:plus"></dees-icon>
Add Item Add Item
</dees-button> </dees-button>
<dees-button type="destructive"> <dees-button type="destructive">
<dees-icon iconFA="faTrash"></dees-icon> <dees-icon icon="fa:trash"></dees-icon>
Delete Delete
</dees-button> </dees-button>
<dees-button type="outline"> <dees-button type="outline">
<dees-icon iconFA="faDownload"></dees-icon> <dees-icon icon="lucide:Download"></dees-icon>
Download Download
</dees-button> </dees-button>
</div> </div>
<div class="icon-row"> <div class="icon-row">
<dees-button type="secondary" size="sm"> <dees-button type="secondary" size="sm">
<dees-icon iconFA="faCog"></dees-icon> <dees-icon icon="fa:gear"></dees-icon>
Settings Settings
</dees-button> </dees-button>
<dees-button type="ghost"> <dees-button type="ghost">
<dees-icon iconFA="faChevronLeft"></dees-icon> <dees-icon icon="fa:caretLeft"></dees-icon>
Back Back
</dees-button> </dees-button>
<dees-button type="ghost"> <dees-button type="ghost">
Next Next
<dees-icon iconFA="faChevronRight"></dees-icon> <dees-icon icon="fa:caretRight"></dees-icon>
</dees-button> </dees-button>
</div> </div>
<div class="icon-row"> <div class="icon-row">
<dees-button size="icon" type="default"> <dees-button size="icon" type="default">
<dees-icon iconFA="faPlus"></dees-icon> <dees-icon icon="fa:plus"></dees-icon>
</dees-button> </dees-button>
<dees-button size="icon" type="secondary"> <dees-button size="icon" type="secondary">
<dees-icon iconFA="faCog"></dees-icon> <dees-icon icon="fa:gear"></dees-icon>
</dees-button> </dees-button>
<dees-button size="icon" type="outline"> <dees-button size="icon" type="outline">
<dees-icon iconFA="faSearch"></dees-icon> <dees-icon icon="lucide:Search"></dees-icon>
</dees-button> </dees-button>
<dees-button size="icon" type="ghost"> <dees-button size="icon" type="ghost">
<dees-icon iconFA="faEllipsisV"></dees-icon> <dees-icon icon="lucide:MoreVertical"></dees-icon>
</dees-button> </dees-button>
<dees-button size="icon" type="destructive"> <dees-button size="icon" type="destructive">
<dees-icon iconFA="faTrash"></dees-icon> <dees-icon icon="fa:trash"></dees-icon>
</dees-button> </dees-button>
</div> </div>
</dees-panel> </dees-panel>
</dees-demowrapper> </dees-demowrapper>
<dees-demowrapper .runAfterRender=${async (elementArg: HTMLElement) => {
// Track icon property button clicks
const buttons = elementArg.querySelectorAll('dees-button');
buttons.forEach((button) => {
button.addEventListener('clicked', () => {
const icon = button.getAttribute('icon') || 'none';
const position = button.getAttribute('iconPosition') || 'left';
console.log(`Icon property button: icon=${icon}, position=${position}`);
});
});
}}>
<dees-panel .title=${'4. Icons via Property'} .subtitle=${'Simplified icon syntax using the icon property'}>
<div class="icon-row">
<dees-button icon="fa:plus">Add Item</dees-button>
<dees-button type="destructive" icon="fa:trash">Delete</dees-button>
<dees-button type="outline" icon="lucide:Download">Download</dees-button>
</div>
<div class="icon-row">
<dees-button type="secondary" size="sm" icon="fa:gear">Settings</dees-button>
<dees-button type="ghost" icon="fa:caretLeft">Back</dees-button>
<dees-button type="ghost" icon="fa:caretRight" iconPosition="right">Next</dees-button>
</div>
<div class="icon-row">
<dees-button size="icon" type="default" icon="fa:plus"></dees-button>
<dees-button size="icon" type="secondary" icon="lucide:Settings"></dees-button>
<dees-button size="icon" type="outline" icon="lucide:Search"></dees-button>
<dees-button size="icon" type="ghost" icon="lucide:MoreVertical"></dees-button>
<dees-button size="icon" type="destructive" icon="fa:trash"></dees-button>
</div>
<div style="margin-top: 16px;">
<div class="code-snippet">
&lt;dees-button icon="fa:plus"&gt;Add Item&lt;/dees-button&gt;<br>
&lt;dees-button icon="fa:caretRight" iconPosition="right"&gt;Next&lt;/dees-button&gt;
</div>
</div>
</dees-panel>
</dees-demowrapper>
<dees-demowrapper .runAfterRender=${async (elementArg: HTMLElement) => { <dees-demowrapper .runAfterRender=${async (elementArg: HTMLElement) => {
// Demonstrate status changes // Demonstrate status changes
const pendingButton = elementArg.querySelector('dees-button[status="pending"]'); const pendingButton = elementArg.querySelector('dees-button[status="pending"]');
@@ -215,7 +256,7 @@ export const demoFunc = () => html`
}); });
} }
}}> }}>
<dees-panel .title=${'4. Button States'} .subtitle=${'Different states to indicate button status and loading conditions'}> <dees-panel .title=${'5. Button States'} .subtitle=${'Different states to indicate button status and loading conditions'}>
<div class="button-group"> <div class="button-group">
<dees-button status="normal">Normal</dees-button> <dees-button status="normal">Normal</dees-button>
<dees-button status="pending">Processing...</dees-button> <dees-button status="pending">Processing...</dees-button>
@@ -260,7 +301,7 @@ export const demoFunc = () => html`
}); });
} }
}}> }}>
<dees-panel .title=${'5. Event Handling'} .subtitle=${'Interactive examples with click event handling'}> <dees-panel .title=${'6. Event Handling'} .subtitle=${'Interactive examples with click event handling'}>
<div class="button-group"> <div class="button-group">
<dees-button>Click Me</dees-button> <dees-button>Click Me</dees-button>
<dees-button type="secondary" .eventDetailData=${'custom-data-123'}> <dees-button type="secondary" .eventDetailData=${'custom-data-123'}>
@@ -303,7 +344,7 @@ export const demoFunc = () => html`
}); });
} }
}}> }}>
<dees-panel .title=${'6. Form Integration'} .subtitle=${'Buttons working within forms with automatic spacing'}> <dees-panel .title=${'7. Form Integration'} .subtitle=${'Buttons working within forms with automatic spacing'}>
<dees-form> <dees-form>
<dees-input-text label="Name" key="name" required></dees-input-text> <dees-input-text label="Name" key="name" required></dees-input-text>
<dees-input-text label="Email" key="email" type="email" required></dees-input-text> <dees-input-text label="Email" key="email" type="email" required></dees-input-text>
@@ -330,7 +371,7 @@ export const demoFunc = () => html`
} }
}); });
}}> }}>
<dees-panel .title=${'7. Backward Compatibility'} .subtitle=${'Old button types are automatically mapped to new variants'}> <dees-panel .title=${'8. Backward Compatibility'} .subtitle=${'Old button types are automatically mapped to new variants'}>
<div class="button-group"> <div class="button-group">
<dees-button type="normal">Normal → Default</dees-button> <dees-button type="normal">Normal → Default</dees-button>
<dees-button type="highlighted">Highlighted → Destructive</dees-button> <dees-button type="highlighted">Highlighted → Destructive</dees-button>
@@ -371,20 +412,20 @@ export const demoFunc = () => html`
}); });
} }
}}> }}>
<dees-panel .title=${'8. Advanced Examples'} .subtitle=${'Complex button configurations and real-world use cases'}> <dees-panel .title=${'9. Advanced Examples'} .subtitle=${'Complex button configurations and real-world use cases'}>
<div class="horizontal-group"> <div class="horizontal-group">
<div class="vertical-group"> <div class="vertical-group">
<h4 style="margin: 0 0 8px 0; font-size: 14px; font-weight: 500;">Action Group</h4> <h4 style="margin: 0 0 8px 0; font-size: 14px; font-weight: 500;">Action Group</h4>
<dees-button type="default" size="sm"> <dees-button type="default" size="sm">
<dees-icon iconFA="faSave"></dees-icon> <dees-icon icon="lucide:Save"></dees-icon>
Save Changes Save Changes
</dees-button> </dees-button>
<dees-button type="secondary" size="sm"> <dees-button type="secondary" size="sm">
<dees-icon iconFA="faUndo"></dees-icon> <dees-icon icon="lucide:Undo2"></dees-icon>
Discard Discard
</dees-button> </dees-button>
<dees-button type="ghost" size="sm"> <dees-button type="ghost" size="sm">
<dees-icon iconFA="faQuestionCircle"></dees-icon> <dees-icon icon="lucide:HelpCircle"></dees-icon>
Help Help
</dees-button> </dees-button>
</div> </div>
@@ -392,15 +433,15 @@ export const demoFunc = () => html`
<div class="vertical-group"> <div class="vertical-group">
<h4 style="margin: 0 0 8px 0; font-size: 14px; font-weight: 500;">Danger Zone</h4> <h4 style="margin: 0 0 8px 0; font-size: 14px; font-weight: 500;">Danger Zone</h4>
<dees-button type="destructive" size="sm"> <dees-button type="destructive" size="sm">
<dees-icon iconFA="faTrash"></dees-icon> <dees-icon icon="fa:trash"></dees-icon>
Delete Account Delete Account
</dees-button> </dees-button>
<dees-button type="outline" size="sm"> <dees-button type="outline" size="sm">
<dees-icon iconFA="faArchive"></dees-icon> <dees-icon icon="lucide:Archive"></dees-icon>
Archive Data Archive Data
</dees-button> </dees-button>
<dees-button type="ghost" size="sm" disabled> <dees-button type="ghost" size="sm" disabled>
<dees-icon iconFA="faBan"></dees-icon> <dees-icon icon="lucide:Ban"></dees-icon>
Not Available Not Available
</dees-button> </dees-button>
</div> </div>
@@ -409,8 +450,7 @@ export const demoFunc = () => html`
<div style="margin-top: 24px;"> <div style="margin-top: 24px;">
<h4 style="margin: 0 0 8px 0; font-size: 14px; font-weight: 500;">Code Example:</h4> <h4 style="margin: 0 0 8px 0; font-size: 14px; font-weight: 500;">Code Example:</h4>
<div class="code-snippet"> <div class="code-snippet">
&lt;dees-button type="default" size="sm" @clicked="\${handleClick}"&gt;<br> &lt;dees-button type="default" size="sm" icon="lucide:Save" @clicked="\${handleClick}"&gt;<br>
&nbsp;&nbsp;&lt;dees-icon iconFA="faSave"&gt;&lt;/dees-icon&gt;<br>
&nbsp;&nbsp;Save Changes<br> &nbsp;&nbsp;Save Changes<br>
&lt;/dees-button&gt; &lt;/dees-button&gt;
</div> </div>

View File

@@ -23,6 +23,7 @@ declare global {
@customElement('dees-button') @customElement('dees-button')
export class DeesButton extends DeesElement { export class DeesButton extends DeesElement {
public static demo = demoFunc; public static demo = demoFunc;
public static demoGroups = ['Button'];
@property({ @property({
reflect: true, reflect: true,
@@ -67,6 +68,12 @@ export class DeesButton extends DeesElement {
}) })
accessor insideForm: boolean = false; accessor insideForm: boolean = false;
@property({ type: String, reflect: true })
accessor icon: string;
@property({ type: String, reflect: true })
accessor iconPosition: 'left' | 'right' = 'left';
constructor() { constructor() {
super(); super();
} }
@@ -339,9 +346,62 @@ export class DeesButton extends DeesElement {
height: 18px; height: 18px;
} }
/* Text alignment */
.textbox {
display: flex;
align-items: center;
}
`, `,
]; ];
/**
* Extracts icon and text from light DOM and sets properties
*/
private extractLightDom(): void {
const iconElement = this.querySelector('dees-icon') as any;
// Get all text content from light DOM
const textContent = Array.from(this.childNodes)
.filter(node => node.nodeType === Node.TEXT_NODE)
.map(node => node.textContent?.trim())
.filter(Boolean)
.join(' ');
if (textContent && !this.text) {
this.text = textContent;
}
if (iconElement) {
// Get icon value
const iconValue = iconElement.icon || iconElement.getAttribute('icon') ||
(iconElement.iconFA ? `fa:${iconElement.iconFA}` : null);
if (iconValue) {
// Determine position based on DOM order
const children = Array.from(this.childNodes);
const iconIndex = children.indexOf(iconElement);
const textNodes = children.filter(node =>
node.nodeType === Node.TEXT_NODE && node.textContent?.trim()
);
if (textNodes.length > 0) {
const firstTextIndex = children.indexOf(textNodes[0]);
this.iconPosition = iconIndex < firstTextIndex ? 'left' : 'right';
}
// Set the icon property
this.icon = iconValue;
}
// Remove the light DOM icon element
iconElement.remove();
}
// Clear all remaining light DOM
this.innerHTML = '';
}
public render(): TemplateResult { public render(): TemplateResult {
// Map old types to new types for backward compatibility // Map old types to new types for backward compatibility
const typeMap: {[key: string]: string} = { const typeMap: {[key: string]: string} = {
@@ -354,6 +414,16 @@ export class DeesButton extends DeesElement {
const actualType = typeMap[this.type] || this.type; const actualType = typeMap[this.type] || this.type;
const actualSize = this.type === 'big' ? 'lg' : this.size; const actualSize = this.type === 'big' ? 'lg' : this.size;
const leftIcon = this.iconPosition === 'left' && this.icon
? html`<dees-icon .icon=${this.icon}></dees-icon>`
: '';
const rightIcon = this.iconPosition === 'right' && this.icon
? html`<dees-icon .icon=${this.icon}></dees-icon>`
: '';
// For icon-only buttons, hide the textbox
const isIconOnly = actualSize === 'icon' && this.icon;
return html` return html`
<div <div
class="button ${this.isHidden ? 'hidden' : ''} ${actualType} size-${actualSize} ${this.status} ${this.disabled class="button ${this.isHidden ? 'hidden' : ''} ${actualType} size-${actualSize} ${this.status} ${this.disabled
@@ -368,7 +438,9 @@ export class DeesButton extends DeesElement {
size="${actualSize === 'sm' ? 14 : actualSize === 'lg' ? 18 : 16}" size="${actualSize === 'sm' ? 14 : actualSize === 'lg' ? 18 : 16}"
></dees-spinner> ></dees-spinner>
`} `}
<div class="textbox">${this.text || html`<slot>Button</slot>`}</div> ${leftIcon}
${isIconOnly ? '' : html`<div class="textbox">${this.text || 'Button'}</div>`}
${rightIcon}
</div> </div>
`; `;
} }
@@ -389,6 +461,7 @@ export class DeesButton extends DeesElement {
} }
public async firstUpdated() { public async firstUpdated() {
// Don't set default text here as it interferes with slotted content // Extract light DOM content (icon + text) and set as properties
this.extractLightDom();
} }
} }

View File

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

View File

@@ -1,13 +1,15 @@
import { html } from '@design.estate/dees-element'; import { html, css, cssManager } from '@design.estate/dees-element';
import type { DeesChartLog } from '../dees-chart-log/dees-chart-log.js'; import type { DeesChartLog } from '../dees-chart-log/dees-chart-log.js';
import '@design.estate/dees-wcctools/demotools'; import '@design.estate/dees-wcctools/demotools';
export const demoFunc = () => { export const demoFunc = () => {
return html` return html`
<dees-demowrapper .runAfterRender=${async (elementArg: HTMLElement) => { <dees-demowrapper .runAfterRender=${async (elementArg: HTMLElement) => {
// Get the log element // Get the log elements
const logElement = elementArg.querySelector('dees-chart-log') as DeesChartLog; const structuredLog = elementArg.querySelector('#structured-log') as DeesChartLog;
let intervalId: number; const rawLog = elementArg.querySelector('#raw-log') as DeesChartLog;
let structuredIntervalId: number;
let rawIntervalId: number;
const serverSources = ['Server', 'Database', 'API', 'Auth', 'Cache', 'Queue', 'WebSocket', 'Scheduler']; const serverSources = ['Server', 'Database', 'API', 'Auth', 'Cache', 'Queue', 'WebSocket', 'Scheduler'];
@@ -49,9 +51,25 @@ export const demoFunc = () => {
], ],
}; };
// Docker-like raw log lines with ANSI colors
const dockerLogTemplates = [
'\x1b[90m2024-01-15T10:23:45.123Z\x1b[0m \x1b[36mINFO\x1b[0m [nginx] GET /api/health 200 - 2ms',
'\x1b[90m2024-01-15T10:23:45.456Z\x1b[0m \x1b[33mWARN\x1b[0m [redis] Connection pool running low: 3/10',
'\x1b[90m2024-01-15T10:23:45.789Z\x1b[0m \x1b[31mERROR\x1b[0m [mongodb] Query timeout after 30000ms',
'\x1b[90m2024-01-15T10:23:46.012Z\x1b[0m \x1b[36mINFO\x1b[0m [app] Processing batch job #{{jobId}}',
'\x1b[90m2024-01-15T10:23:46.345Z\x1b[0m \x1b[32mOK\x1b[0m [health] All services healthy',
'\x1b[90m2024-01-15T10:23:46.678Z\x1b[0m \x1b[36mINFO\x1b[0m [kafka] Message consumed from topic: events',
'\x1b[90m2024-01-15T10:23:47.001Z\x1b[0m \x1b[35mDEBUG\x1b[0m [grpc] Request received: GetUser(id={{userId}})',
'\x1b[90m2024-01-15T10:23:47.234Z\x1b[0m \x1b[31mERROR\x1b[0m [auth] Token validation failed: expired',
'\x1b[90m2024-01-15T10:23:47.567Z\x1b[0m \x1b[33mWARN\x1b[0m [rate-limit] IP {{ip}} approaching rate limit',
'\x1b[90m2024-01-15T10:23:47.890Z\x1b[0m \x1b[36mINFO\x1b[0m [websocket] Client connected: session={{session}}',
// Multi-line log entry like stack traces
'\x1b[31mError: Connection refused\x1b[0m\n at TcpConnection.connect (/app/node_modules/pg/lib/connection.js:12:15)\n at Pool.connect (/app/node_modules/pg/lib/pool.js:45:23)\n at async DatabaseService.query (/app/src/db/service.ts:89:12)',
];
const generateRandomLog = () => { const generateRandomLog = () => {
const levels: Array<'debug' | 'info' | 'warn' | 'error' | 'success'> = ['debug', 'info', 'warn', 'error', 'success']; const levels: Array<'debug' | 'info' | 'warn' | 'error' | 'success'> = ['debug', 'info', 'warn', 'error', 'success'];
const weights = [0.2, 0.5, 0.15, 0.1, 0.05]; // Weighted probability const weights = [0.2, 0.5, 0.15, 0.1, 0.05];
const random = Math.random(); const random = Math.random();
let cumulative = 0; let cumulative = 0;
@@ -92,17 +110,30 @@ export const demoFunc = () => {
.replace('{{port}}', String(3000 + Math.floor(Math.random() * 10))) .replace('{{port}}', String(3000 + Math.floor(Math.random() * 10)))
.replace('{{size}}', String(Math.floor(Math.random() * 500) + 100)); .replace('{{size}}', String(Math.floor(Math.random() * 500) + 100));
logElement.addLog(level, message, source); structuredLog.addLog(level, message, source);
}; };
const startSimulation = () => { const generateDockerLog = () => {
if (!intervalId) { const template = dockerLogTemplates[Math.floor(Math.random() * dockerLogTemplates.length)];
// Generate logs at random intervals between 500ms and 2500ms const now = new Date().toISOString();
const logLine = template
.replace(/2024-01-15T10:23:\d{2}\.\d{3}Z/g, now)
.replace('{{jobId}}', String(Math.floor(Math.random() * 10000)))
.replace('{{userId}}', String(Math.floor(Math.random() * 10000)))
.replace('{{ip}}', `192.168.1.${Math.floor(Math.random() * 255)}`)
.replace('{{session}}', Math.random().toString(36).substring(2, 11));
rawLog.writelnRaw(logLine);
};
const startStructuredSimulation = () => {
if (!structuredIntervalId) {
const scheduleNext = () => { const scheduleNext = () => {
generateRandomLog(); generateRandomLog();
const nextDelay = Math.random() * 2000 + 500; const nextDelay = Math.random() * 2000 + 500;
intervalId = window.setTimeout(() => { structuredIntervalId = window.setTimeout(() => {
if (intervalId) { if (structuredIntervalId) {
scheduleNext(); scheduleNext();
} }
}, nextDelay); }, nextDelay);
@@ -111,10 +142,32 @@ export const demoFunc = () => {
} }
}; };
const stopSimulation = () => { const stopStructuredSimulation = () => {
if (intervalId) { if (structuredIntervalId) {
window.clearTimeout(intervalId); window.clearTimeout(structuredIntervalId);
intervalId = null; structuredIntervalId = null;
}
};
const startRawSimulation = () => {
if (!rawIntervalId) {
const scheduleNext = () => {
generateDockerLog();
const nextDelay = Math.random() * 1000 + 200;
rawIntervalId = window.setTimeout(() => {
if (rawIntervalId) {
scheduleNext();
}
}, nextDelay);
};
scheduleNext();
}
};
const stopRawSimulation = () => {
if (rawIntervalId) {
window.clearTimeout(rawIntervalId);
rawIntervalId = null;
} }
}; };
@@ -122,49 +175,103 @@ export const demoFunc = () => {
const buttons = elementArg.querySelectorAll('dees-button'); const buttons = elementArg.querySelectorAll('dees-button');
buttons.forEach(button => { buttons.forEach(button => {
const text = button.textContent?.trim(); const text = button.textContent?.trim();
if (text === 'Add Single Log') { switch (text) {
case 'Add Structured Log':
button.addEventListener('click', () => generateRandomLog()); button.addEventListener('click', () => generateRandomLog());
} else if (text === 'Start Simulation') { break;
button.addEventListener('click', () => startSimulation()); case 'Start Structured':
} else if (text === 'Stop Simulation') { button.addEventListener('click', () => startStructuredSimulation());
button.addEventListener('click', () => stopSimulation()); break;
case 'Stop Structured':
button.addEventListener('click', () => stopStructuredSimulation());
break;
case 'Add Docker Log':
button.addEventListener('click', () => generateDockerLog());
break;
case 'Start Docker':
button.addEventListener('click', () => startRawSimulation());
break;
case 'Stop Docker':
button.addEventListener('click', () => stopRawSimulation());
break;
} }
}); });
}}> }}>
<style> <style>
${css`
.demoBox { .demoBox {
position: relative; position: relative;
background: #000000; background: ${cssManager.bdTheme('hsl(0 0% 95%)', 'hsl(0 0% 5%)')};
height: 100%; height: 100%;
width: 100%; width: 100%;
padding: 40px; padding: 40px;
box-sizing: border-box; box-sizing: border-box;
display: flex; display: flex;
flex-direction: column; flex-direction: column;
gap: 20px; gap: 24px;
}
.section {
display: flex;
flex-direction: column;
gap: 12px;
}
.section-title {
color: ${cssManager.bdTheme('hsl(0 0% 9%)', 'hsl(0 0% 95%)')};
font-size: 14px;
font-weight: 600;
font-family: 'Geist Sans', sans-serif;
}
.section-description {
color: ${cssManager.bdTheme('hsl(215.4 16.3% 46.9%)', 'hsl(215 20.2% 65.1%)')};
font-size: 12px;
font-family: 'Geist Sans', sans-serif;
} }
.controls { .controls {
display: flex; display: flex;
gap: 10px; gap: 10px;
flex-wrap: wrap; flex-wrap: wrap;
} }
.info { `}
color: #888;
font-size: 12px;
font-family: 'Geist Sans', sans-serif;
}
</style> </style>
<div class="demoBox"> <div class="demoBox">
<div class="controls"> <!-- Structured Logs Section -->
<dees-button>Add Single Log</dees-button> <div class="section">
<dees-button>Start Simulation</dees-button> <div class="section-title">Structured Logs (ILogEntry)</div>
<dees-button>Stop Simulation</dees-button> <div class="section-description">
Structured log entries with level, message, and source. Supports search and keyword highlighting.
</div>
<div class="controls">
<dees-button>Add Structured Log</dees-button>
<dees-button>Start Structured</dees-button>
<dees-button>Stop Structured</dees-button>
</div> </div>
<div class="info">Simulating realistic server logs with various levels and sources</div>
<dees-chart-log <dees-chart-log
id="structured-log"
.label=${'Production Server Logs'} .label=${'Production Server Logs'}
.highlightKeywords=${['error', 'failed', 'timeout']}
.showMetrics=${true}
></dees-chart-log> ></dees-chart-log>
</div> </div>
<!-- Raw Logs Section -->
<div class="section">
<div class="section-title">Raw Logs (Docker/Container Style)</div>
<div class="section-description">
Raw log output with ANSI escape sequences for real Docker/container logs.
</div>
<div class="controls">
<dees-button>Add Docker Log</dees-button>
<dees-button>Start Docker</dees-button>
<dees-button>Stop Docker</dees-button>
</div>
<dees-chart-log
id="raw-log"
.label=${'Docker Container Logs'}
.mode=${'raw'}
.showMetrics=${false}
></dees-chart-log>
</div>
</div>
</dees-demowrapper> </dees-demowrapper>
`; `;
}; };

View File

@@ -15,7 +15,7 @@ import type { HLJSApi } from 'highlight.js';
import * as smartstring from '@push.rocks/smartstring'; import * as smartstring from '@push.rocks/smartstring';
import * as domtools from '@design.estate/dees-domtools'; import * as domtools from '@design.estate/dees-domtools';
import { DeesContextmenu } from '../../dees-contextmenu/dees-contextmenu.js'; import { DeesContextmenu } from '../../00group-overlay/dees-contextmenu/dees-contextmenu.js';
import { DeesServiceLibLoader } from '../../../services/index.js'; import { DeesServiceLibLoader } from '../../../services/index.js';
declare global { declare global {
@@ -27,6 +27,7 @@ declare global {
@customElement('dees-dataview-codebox') @customElement('dees-dataview-codebox')
export class DeesDataviewCodebox extends DeesElement { export class DeesDataviewCodebox extends DeesElement {
public static demo = demoFunc; public static demo = demoFunc;
public static demoGroups = ['Data View', 'Workspace'];
@property() @property()
accessor progLang: string = 'typescript'; accessor progLang: string = 'typescript';
@@ -205,9 +206,7 @@ export class DeesDataviewCodebox extends DeesElement {
}}" }}"
> >
<div class="appbar"> <div class="appbar">
<dees-windowcontrols type="mac" position="left"></dees-windowcontrols>
<div class="fileName">index.ts</div> <div class="fileName">index.ts</div>
<dees-windowcontrols type="mac" position="right"></dees-windowcontrols>
</div> </div>
<div class="codegrid"> <div class="codegrid">
<div class="lineNumbers"> <div class="lineNumbers">

View File

@@ -15,7 +15,7 @@ import {
} from '@design.estate/dees-element'; } from '@design.estate/dees-element';
import * as tsclass from '@tsclass/tsclass'; import * as tsclass from '@tsclass/tsclass';
import { DeesContextmenu } from '../../dees-contextmenu/dees-contextmenu.js'; import { DeesContextmenu } from '../../00group-overlay/dees-contextmenu/dees-contextmenu.js';
import { themeDefaultStyles } from '../../00theme.js'; import { themeDefaultStyles } from '../../00theme.js';
declare global { declare global {
@@ -27,6 +27,7 @@ declare global {
@customElement('dees-dataview-statusobject') @customElement('dees-dataview-statusobject')
export class DeesDataviewStatusobject extends DeesElement { export class DeesDataviewStatusobject extends DeesElement {
public static demo = demoFunc; public static demo = demoFunc;
public static demoGroups = ['Data View'];
@property({ type: Object }) accessor statusObject: tsclass.code.IStatusObject; @property({ type: Object }) accessor statusObject: tsclass.code.IStatusObject;

View File

@@ -1,7 +1,16 @@
import { html, css, cssManager } from '@design.estate/dees-element'; import { html, css, cssManager } from '@design.estate/dees-element';
import '@design.estate/dees-wcctools/demotools'; import '@design.estate/dees-wcctools/demotools';
import '../dees-panel/dees-panel.js'; import '../../00group-layout/dees-panel/dees-panel.js';
import type { IStatsTile } from '../dees-statsgrid/dees-statsgrid.js'; import type { IStatsTile, ICpuCore, IPartitionData, IDiskData } 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 = () => { export const demoFunc = () => {
return html` return html`
@@ -334,7 +343,96 @@ export const demoFunc = () => {
></dees-statsgrid> ></dees-statsgrid>
</dees-panel> </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 <dees-statsgrid
id="interactive-grid" id="interactive-grid"
.tiles=${[ .tiles=${[
@@ -448,7 +546,7 @@ export const demoFunc = () => {
></dees-statsgrid> ></dees-statsgrid>
</dees-panel> </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[] = [ <div class="code-block">${`const tiles: IStatsTile[] = [
{ {
id: 'revenue', id: 'revenue',
@@ -503,6 +601,134 @@ html\`
></dees-statsgrid> ></dees-statsgrid>
\`;`}</div> \`;`}</div>
</dees-panel> </dees-panel>
<dees-panel .title=${'7. Disk & Storage Tiles'} .subtitle=${'Partition and physical disk visualization tiles'}>
<dees-statsgrid
.tiles=${[
{
id: 'root-partition',
title: 'Root Partition',
value: 0,
type: 'partition',
icon: 'lucide:folder-root',
partitionData: {
used: 698_341_425_152, // ~650 GB
total: 1_073_741_824_000, // ~1 TB
filesystem: 'ext4',
mountPoint: '/'
}
},
{
id: 'home-partition',
title: 'Home Partition',
value: 0,
type: 'partition',
icon: 'lucide:home',
partitionData: {
used: 214_748_364_800, // ~200 GB
total: 536_870_912_000, // ~500 GB
filesystem: 'ext4',
mountPoint: '/home'
}
},
{
id: 'data-partition',
title: 'Data Partition',
value: 0,
type: 'partition',
icon: 'lucide:database',
partitionData: {
used: 1_932_735_283_200, // ~1.8 TB (90% - critical)
total: 2_147_483_648_000, // ~2 TB
filesystem: 'xfs',
mountPoint: '/data'
}
},
{
id: 'nvme-ssd',
title: 'Primary NVMe',
value: 0,
type: 'disk',
icon: 'lucide:hard-drive',
columnSpan: 2,
diskData: {
capacity: 2_000_000_000_000, // 2 TB
model: 'Samsung 990 Pro',
type: 'nvme',
iops: {
read: 7450,
write: 6900
},
health: 98
}
},
{
id: 'sata-ssd',
title: 'Secondary SSD',
value: 0,
type: 'disk',
icon: 'lucide:hard-drive',
diskData: {
capacity: 1_000_000_000_000, // 1 TB
model: 'Crucial MX500',
type: 'ssd',
iops: {
read: 560,
write: 510
},
health: 85
}
},
{
id: 'hdd-storage',
title: 'Backup HDD',
value: 0,
type: 'disk',
icon: 'lucide:archive',
diskData: {
capacity: 8_000_000_000_000, // 8 TB
model: 'Seagate IronWolf',
type: 'hdd',
iops: {
read: 210,
write: 195
},
health: 42
}
}
]}
.minTileWidth=${280}
.gap=${16}
></dees-statsgrid>
<div class="tile-config">
<div class="config-section">
<div class="config-title">Partition Tile Properties</div>
<div class="config-description">
<ul style="margin: 8px 0; padding-left: 20px;">
<li><strong>partitionData.used:</strong> Used space in bytes (auto-formatted)</li>
<li><strong>partitionData.total:</strong> Total capacity in bytes</li>
<li><strong>partitionData.filesystem:</strong> Filesystem type (ext4, xfs, ntfs)</li>
<li><strong>partitionData.mountPoint:</strong> Mount point path (optional)</li>
</ul>
Color thresholds: Normal (&lt;75%), Warning (75-90%), Critical (&gt;90%)
</div>
</div>
<div class="config-section">
<div class="config-title">Disk Tile Properties</div>
<div class="config-description">
<ul style="margin: 8px 0; padding-left: 20px;">
<li><strong>diskData.capacity:</strong> Total capacity in bytes</li>
<li><strong>diskData.model:</strong> Disk model name (optional)</li>
<li><strong>diskData.type:</strong> Disk type: 'ssd', 'hdd', or 'nvme'</li>
<li><strong>diskData.iops:</strong> Read/write IOPS (optional)</li>
<li><strong>diskData.health:</strong> Health percentage 0-100 (optional)</li>
</ul>
Health thresholds: Good (70-100%), Warning (30-70%), Critical (&lt;30%)
</div>
</div>
</div>
</dees-panel>
</div> </div>
<script> <script>

File diff suppressed because it is too large Load Diff

Some files were not shown because too many files have changed in this diff Show More