@evotecit/canopyx 0.3.11 → 0.3.15

package/JavaScript/protocol.d.ts

@@ -64,6 +64,8 @@ interface NodeDefinition {
 export interface CanopyColumn {
   id: string;
   title: string;
+  /** Full header explanation shown as a tooltip and accessibility description. Defaults to title. */
+  headerDescription?: string;
   width: number;
   /** Minimum manual width in CSS pixels; defaults to 40. */
   minWidth?: number;
@@ -87,6 +89,17 @@ export interface CanopyColumn {
   alwaysVisible?: boolean;
   /** Hover tooltip: "auto" shows a cell's full value while it is cut off; a declared column id shows that column's text. */
   tooltip?: string;
+  /** Wrap text; maxLines is 1..12, default 2. Automatic row heights measure the visible lines. */
+  wrap?: boolean;
+  maxLines?: number;
+  /** Host-authored labels keyed by exact raw category token; query and group identities stay raw. */
+  valueLabels?: Readonly<Record<string, string>>;
+  /** Declared tokens precede unknown ordinal tokens in ascending order; null keeps the missing-value policy. */
+  valueOrder?: readonly string[];
+  /** Semantic tones keyed by raw category token. */
+  valueTones?: Readonly<Record<string, string>>;
+  /** Ordered first-match rules color plain numeric text; labels explain the rule in tooltips and the drawer. */
+  numericTones?: readonly { operator: "atMost" | "atLeast" | "below" | "above"; value: number; tone: string; label: string }[];
   /** The tree column pins left by default and null lets it scroll; other columns pin left (after the tree column) or right. */
   pinned?: "left" | "right" | null;
   /** The name of a cell renderer a plugin registers (cellRenderers); an unregistered name keeps the built-in painter. */
@@ -251,7 +264,7 @@ export type LabelName =
   /** The record panel (docs/record-panel.md). */
   | "recordBack" | "recordBackTo" | "recordTrail" | "recordShowing" | "recordTabs" | "recordSections" | "recordOtherFields" | "recordShowEmpty" | "recordHideEmpty" | "recordActions" | "recordCopyValues" | "recordCopyJson" | "recordCopyLink" | "recordCopied" | "recordPrint" | "recordExportCsv" | "recordExportJson" | "recordOpenAll" | "recordLoadMore" | "recordCount" | "recordItems" | "recordMore" | "recordShowAll" | "recordRetry" | "recordLoadFailed" | "recordUnavailable" | "recordField" | "recordValue" | "recordSection" | "recordBefore" | "recordAfter" | "recordAdded" | "recordRemoved" | "recordChanged"
   /** The calendar and resource timeline (the calendar and timeline parts of flat grids). */
-  | "calendarToday" | "calendarPrevious" | "calendarNext" | "calendarViews" | "calendarMonth" | "calendarWeek" | "calendarDay" | "calendarDays"
+  | "calendarEditOccurrence" | "calendarRemoveOccurrence" | "calendarOccurrenceScope" | "calendarSharedResources" | "calendarResourceWindow" | "calendarToday" | "calendarPrevious" | "calendarNext" | "calendarViews" | "calendarMonth" | "calendarWeek" | "calendarDay" | "calendarDays"
   | "calendarAgenda" | "calendarYear" | "calendarTimeline" | "calendarGoTo" | "calendarAllDay" | "calendarMore" | "calendarMoreLabel" | "calendarDayEvents"
   | "calendarNoEvents" | "calendarEvents" | "calendarShowing" | "calendarRepeats" | "calendarTruncated" | "calendarLoading" | "calendarLoadError" | "calendarNow"
   | "calendarZoom" | "calendarZoomHour" | "calendarZoomDay" | "calendarZoomWeek" | "calendarZoomMonth" | "calendarZoomQuarter" | "calendarResources" | "calendarCapacity"

package/JavaScript/records.d.ts

@@ -59,6 +59,8 @@ export interface RecordFieldDefinition {
   readonly id: string; readonly title: string; readonly kind?: "text" | "number" | "datetime";
   /** A flat-grid presenter descriptor (the grid runtimes apply it). */
   readonly presenter?: unknown; readonly wrap?: boolean; readonly section?: string;
+  /** Visible wrapped lines, from 1 to 12. Default 2; the full value remains available in its tooltip. */
+  readonly maxLines?: number;
 }
 export interface RecordSectionDefinition {
   readonly id: string; readonly label: string; readonly fields?: readonly string[]; readonly collapsed?: boolean;

package/README.md

@@ -24,13 +24,13 @@ Turn application data into searchable trees, sortable tables and standalone HTML
 - **Change views**: a text diff (inline or side by side, word marks, folded regions, windowed rows), a change list with kind badges, folders, hashes and risk flags, and how a change reached its replicas ([docs/changes.md](docs/changes.md)).
 - **Guided flows** for setup and edit tasks: steps with typed fields, conditions as data, validation, a review page with change links, secrets that never echo, and one proposal to the host ([docs/flow.md](docs/flow.md)).
 
-![File explorer in the light theme, with sizes, dates, owners and an expanded detail row](https://cdn.jsdelivr.net/npm/@evotecit/canopyx@0.3.11/docs/images/tree-grid-light.png)
+![File explorer in the light theme, with sizes, dates, owners and an expanded detail row](https://cdn.jsdelivr.net/npm/@evotecit/canopyx@0.3.15/docs/images/tree-grid-light.png)
 
 The same explorer in the dark theme, alongside its script-free output for email and print:
 
 | Dark theme | Static outline |
 | --- | --- |
-| ![File explorer in the dark theme](https://cdn.jsdelivr.net/npm/@evotecit/canopyx@0.3.11/docs/images/tree-grid-dark.png) | ![Static outline table](https://cdn.jsdelivr.net/npm/@evotecit/canopyx@0.3.11/docs/images/static-outline.png) |
+| ![File explorer in the dark theme](https://cdn.jsdelivr.net/npm/@evotecit/canopyx@0.3.15/docs/images/tree-grid-dark.png) | ![Static outline table](https://cdn.jsdelivr.net/npm/@evotecit/canopyx@0.3.15/docs/images/static-outline.png) |
 
 ## Features
 
@@ -46,6 +46,8 @@ The same explorer in the dark theme, alongside its script-free output for email
 
 Both views use virtual rows and support keyboard navigation. Both can mark search and filter matches with a match count and next/previous navigation ([search highlighting](docs/search-highlight.md)), and let readers switch between fitting the width, scrolling sideways and (on grids) cards, in three densities ([layout modes](docs/layout-modes.md)). Reporting grids also provide multi-level grouping with aggregates, detail rows, saved views, CSV export and row copying (see [docs/grouping.md](docs/grouping.md)). Grids and trees can open each record in a record panel: record-only fields in tabs and sections, lists, objects and nested collections, links between records, timelines, record deep links, and copy, print and export of one record, with details loaded on demand for large reports (see [docs/record-panel.md](docs/record-panel.md)). English labels are built in; Polish, German, Spanish, French and Italian packs are included.
 
+CanopyX reads the shared `--hfx-*` design roles for colours, fonts, radii and density, and includes standalone defaults. Use `data-hfx-style` and `data-hfx-mode` on a containing element to theme a page; `data-hfx-density="compact"` selects 32px rows and `"comfortable"` selects 40px rows. See [theming](docs/architecture.md#theming) for custom roles and the migration from `--cx-*` colour variables.
+
 ## Installation
 
 ### .NET
@@ -141,6 +143,8 @@ Event snapshots without a key column opt in to `CanopyGridRowIdentity.Ordinal`;
 
 Grid fitting reserves readable header and content minimums before preferred whitespace. Spare width restores headers first, then preferred widths, then ordinary column growth. Headers yield with a full-title tooltip only when their capped minimums cannot collectively fit; content that still needs more room scrolls horizontally. Auto height includes the actual horizontal scrollbar gutter. The [column-fitting algorithm](docs/column-fitting.md) and `report-grid-layout.html` example describe the policy.
 
+Grids can show page totals and all-matching totals in declarative footer rows, including the script-free fallback. Columns support safe CSS classes, logical alignment, selector-based defaults, alternate sort keys and direction cycles. Plugins can add filter operators, sort comparators and custom aggregates. See [column options and footers](docs/data-protocol.md#column-defaults-ordering-hooks-and-footer-rows), and the generated `grid-footers.html`, `grid-footers-dark.html` and `grid-footers-static.html` examples.
+
 ### Render a table for email or print
 
 ```csharp

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evotecit/canopyx",
-  "version": "0.3.11",
+  "version": "0.3.15",
   "description": "Interactive tree grids and data tables with virtual rows, search, filters and offline HTML reports.",
   "type": "module",
   "license": "MIT",
@@ -36,10 +36,13 @@
     },
     "./reporting.css": "./CanopyX.Html/Assets/canopyx-reporting.css",
     "./reporting.js": "./CanopyX.Html/Assets/canopyx-reporting.js",
+    "./presenters.js": "./CanopyX.Html/Assets/canopyx-presenters.js",
     "./filter-editor.js": "./CanopyX.Html/Assets/canopyx-filter-editor.js",
     "./filter-editor.css": "./CanopyX.Html/Assets/canopyx-filter-editor.css",
     "./export.js": "./CanopyX.Html/Assets/canopyx-export.js",
     "./history.js": "./CanopyX.Html/Assets/canopyx-history.js",
+    "./grid-options.js": "./CanopyX.Html/Assets/canopyx-grid-options.js",
+    "./grid-options.css": "./CanopyX.Html/Assets/canopyx-grid-options.css",
     "./pager.js": "./CanopyX.Html/Assets/canopyx-pager.js",
     "./pager.css": "./CanopyX.Html/Assets/canopyx-pager.css",
     "./enhance.js": "./CanopyX.Html/Assets/canopyx-enhance.js",
@@ -132,10 +135,13 @@
     "CanopyX.Html/Assets/canopyx-reporting-module.mjs",
     "CanopyX.Html/Assets/canopyx-reporting.js",
     "CanopyX.Html/Assets/canopyx-reporting.css",
+    "CanopyX.Html/Assets/canopyx-presenters.js",
     "CanopyX.Html/Assets/canopyx-filter-editor.js",
     "CanopyX.Html/Assets/canopyx-filter-editor.css",
     "CanopyX.Html/Assets/canopyx-export.js",
     "CanopyX.Html/Assets/canopyx-history.js",
+    "CanopyX.Html/Assets/canopyx-grid-options.js",
+    "CanopyX.Html/Assets/canopyx-grid-options.css",
     "CanopyX.Html/Assets/canopyx-pager.js",
     "CanopyX.Html/Assets/canopyx-pager.css",
     "CanopyX.Html/Assets/canopyx-enhance.js",