v3.35.1

changelog.md

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

npmextra.json

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

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@design.estate/dees-catalog",
-  "version": "3.34.0",
+  "version": "3.35.1",
   "private": false,
   "description": "A comprehensive library that provides dynamic web components for building sophisticated and modern web applications using JavaScript and TypeScript.",
   "main": "dist_ts_web/index.js",
@@ -8,7 +8,7 @@
   "type": "module",
   "scripts": {
     "test": "tstest test/ --web --verbose --timeout 30 --logfile",
-    "build": "tsbuild tsfolders --allowimplicitany && tsbundle element --production --bundler esbuild",
+    "build": "tsbuild tsfolders --allowimplicitany && tsbundle",
     "watch": "tswatch element",
     "buildDocs": "tsdoc",
     "postinstall": "node scripts/update-monaco-version.cjs"
@@ -18,6 +18,7 @@
   "dependencies": {
     "@design.estate/dees-domtools": "^2.3.7",
     "@design.estate/dees-element": "^2.1.5",
+    "@design.estate/dees-wcctools": "^3.7.1",
     "@fortawesome/fontawesome-svg-core": "^7.1.0",
     "@fortawesome/free-brands-svg-icons": "^7.1.0",
     "@fortawesome/free-regular-svg-icons": "^7.1.0",
@@ -43,13 +44,12 @@
     "xterm-addon-fit": "^0.8.0"
   },
   "devDependencies": {
-    "@design.estate/dees-wcctools": "^3.7.1",
+    "@git.zone/tsbuild": "^4.1.0",
-    "@git.zone/tsbuild": "^4.0.2",
+    "@git.zone/tsbundle": "^2.8.1",
-    "@git.zone/tsbundle": "^2.6.3",
     "@git.zone/tstest": "^3.1.4",
     "@git.zone/tswatch": "^2.3.13",
     "@push.rocks/projectinfo": "^5.0.2",
-    "@types/node": "^25.0.3"
+    "@types/node": "^25.0.6"
   },
   "files": [
     "ts/**/*",

readme.hints.md

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

ts_web/00_commitinfo_data.ts

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

ts_web/elements/dees-statsgrid/dees-statsgrid.demo.ts

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

ts_web/elements/dees-statsgrid/dees-statsgrid.ts

@@ -24,12 +24,21 @@ declare global {
   }
 }
 
+export interface ICpuCore {
+  id: string | number;
+  usage: number; // 0-100
+  label?: string;
+}
+
 export interface IStatsTile {
   id: string;
   title: string;
   value: number | string;
   unit?: string;
-  type: 'number' | 'gauge' | 'percentage' | 'trend' | 'text' | 'multiPercentage';
+  type: 'number' | 'gauge' | 'percentage' | 'trend' | 'text' | 'multiPercentage' | 'cpuCores';
+
+  // Layout options
+  columnSpan?: number; // Number of columns to span (default: 1)
 
   // For gauge type
   gaugeOptions?: {
@@ -48,6 +57,9 @@ export interface IStatsTile {
     color?: string;
   }>;
 
+  // For cpuCores type
+  coresData?: ICpuCore[];
+
   // Visual customization
   color?: string;
   icon?: string;
@@ -366,6 +378,113 @@ export class DeesStatsGrid extends DeesElement {
         border-radius: 2px;
       }
 
+      /* CPU Cores Styles */
+      .cpu-cores-wrapper {
+        width: 100%;
+        display: flex;
+        flex-direction: column;
+        flex: 1;
+        min-height: 80px;
+      }
+
+      .cpu-cores-header {
+        display: flex;
+        align-items: baseline;
+        gap: 8px;
+        margin-bottom: 12px;
+      }
+
+      .cpu-cores-value {
+        font-size: var(--value-font-size);
+        font-weight: 600;
+        color: ${cssManager.bdTheme('hsl(215.3 25% 8.8%)', 'hsl(210 40% 98%)')};
+        line-height: 1.1;
+        letter-spacing: -0.025em;
+      }
+
+      .cpu-cores-unit {
+        font-size: var(--unit-font-size);
+        font-weight: 400;
+        color: ${cssManager.bdTheme('hsl(215.4 16.3% 46.9%)', 'hsl(215 20.2% 65.1%)')};
+        letter-spacing: -0.01em;
+      }
+
+      .cpu-cores-label {
+        font-size: var(--label-font-size);
+        font-weight: 500;
+        color: ${cssManager.bdTheme('hsl(215.4 16.3% 56.9%)', 'hsl(215 20.2% 55.1%)')};
+        letter-spacing: -0.01em;
+        margin-left: auto;
+      }
+
+      .cpu-cores-bars {
+        display: flex;
+        align-items: flex-end;
+        gap: 3px;
+        flex: 1;
+        min-height: 60px;
+        padding: 4px 0;
+      }
+
+      .cpu-cores-bars.centered {
+        justify-content: center;
+      }
+
+      .cpu-core-bar-container {
+        flex: 1;
+        min-width: 6px;
+        max-width: 24px;
+        height: 100%;
+        display: flex;
+        flex-direction: column;
+        align-items: center;
+        gap: 4px;
+      }
+
+      .cpu-core-bar-wrapper {
+        flex: 1;
+        width: 100%;
+        background: ${cssManager.bdTheme('#e8e8e8', '#1a1a1a')};
+        border-radius: 2px;
+        position: relative;
+        overflow: hidden;
+        min-height: 40px;
+      }
+
+      .cpu-core-bar-fill {
+        position: absolute;
+        bottom: 0;
+        left: 0;
+        right: 0;
+        width: 100%;
+        background: ${cssManager.bdTheme('#666666', '#888888')};
+        transition: height 0.3s cubic-bezier(0.4, 0, 0.2, 1), background-color 0.3s ease;
+        border-radius: 2px 2px 0 0;
+      }
+
+      .cpu-core-bar-fill.low {
+        background: ${cssManager.bdTheme('hsl(142.1 76.2% 36.3%)', 'hsl(142.1 70.6% 45.3%)')};
+      }
+
+      .cpu-core-bar-fill.medium {
+        background: ${cssManager.bdTheme('hsl(45.4 93.4% 47.5%)', 'hsl(45.4 93.4% 47.5%)')};
+      }
+
+      .cpu-core-bar-fill.high {
+        background: ${cssManager.bdTheme('hsl(0 84.2% 60.2%)', 'hsl(0 84.2% 60.2%)')};
+      }
+
+      .cpu-core-label {
+        font-size: 9px;
+        font-weight: 500;
+        color: ${cssManager.bdTheme('hsl(215.4 16.3% 56.9%)', 'hsl(215 20.2% 55.1%)')};
+        text-align: center;
+        white-space: nowrap;
+        overflow: hidden;
+        text-overflow: ellipsis;
+        max-width: 100%;
+      }
+
       /* Trend Styles */
       .trend-container {
         width: 100%;
@@ -488,10 +607,12 @@ export class DeesStatsGrid extends DeesElement {
   private renderTile(tile: IStatsTile): TemplateResult {
     const hasActions = tile.actions && tile.actions.length > 0;
     const clickable = hasActions && tile.actions.length === 1;
+    const columnSpan = tile.columnSpan && tile.columnSpan > 1 ? tile.columnSpan : undefined;
 
     return html`
-      <div 
+      <div
         class="stats-tile ${clickable ? 'clickable' : ''}"
+        style="${columnSpan ? `grid-column: span ${columnSpan}` : ''}"
         @click=${clickable ? () => this.handleTileAction(tile.actions![0], tile) : undefined}
         @contextmenu=${hasActions ? (e: MouseEvent) => this.showContextMenu(e, tile) : undefined}
       >
@@ -535,6 +656,9 @@ export class DeesStatsGrid extends DeesElement {
       case 'multiPercentage':
         return this.renderMultiPercentage(tile);
 
+      case 'cpuCores':
+        return this.renderCpuCores(tile);
+
       case 'text':
         return html`
           <div class="text-value" style="${tile.color ? `color: ${tile.color}` : ''}">
@@ -699,6 +823,59 @@ export class DeesStatsGrid extends DeesElement {
     `;
   }
 
+  private renderCpuCores(tile: IStatsTile): TemplateResult {
+    if (!tile.coresData || tile.coresData.length === 0) {
+      return html`<div class="tile-value">${tile.value}</div>`;
+    }
+
+    const cores = tile.coresData;
+    const avgUsage = Math.round(cores.reduce((sum, core) => sum + core.usage, 0) / cores.length);
+
+    // Determine color class based on usage
+    const getColorClass = (usage: number): string => {
+      if (usage < 50) return 'low';
+      if (usage < 80) return 'medium';
+      return 'high';
+    };
+
+    // Calculate if bars should be centered (when they take up less than 66.6% of available width)
+    // Max bar width = cores * 24px + (cores - 1) * 3px gap
+    const maxBarsWidth = cores.length * 24 + (cores.length - 1) * 3;
+    // Estimate tile content width based on columnSpan and minTileWidth (subtract padding)
+    const columnSpan = tile.columnSpan || 1;
+    const estimatedTileWidth = (this.minTileWidth * columnSpan) + ((columnSpan - 1) * this.gap) - 32; // 32px for padding
+    const shouldCenter = maxBarsWidth < estimatedTileWidth * 0.666;
+
+    return html`
+      <div class="cpu-cores-wrapper">
+        <div class="cpu-cores-header">
+          <span class="cpu-cores-value">${avgUsage}</span>
+          <span class="cpu-cores-unit">%</span>
+          <span class="cpu-cores-label">${cores.length} cores</span>
+        </div>
+        <div class="cpu-cores-bars ${shouldCenter ? 'centered' : ''}">
+          ${cores.map(core => {
+            const usage = Math.min(100, Math.max(0, core.usage));
+            const colorClass = getColorClass(usage);
+            return html`
+              <div class="cpu-core-bar-container" title="Core ${core.label || core.id}: ${usage}%">
+                <div class="cpu-core-bar-wrapper">
+                  <div
+                    class="cpu-core-bar-fill ${colorClass}"
+                    style="height: ${usage}%"
+                  ></div>
+                </div>
+                ${cores.length <= 16 ? html`
+                  <span class="cpu-core-label">${core.label || core.id}</span>
+                ` : ''}
+              </div>
+            `;
+          })}
+        </div>
+      </div>
+    `;
+  }
+
   private async handleGridAction(action: plugins.tsclass.website.IMenuItem) {
     if (action.action) {
       await action.action();