@evotecit/canopyx 0.1.2 → 0.2.0

package/JavaScript/protocol.d.ts

@@ -8,7 +8,9 @@ export type SortDirection = "asc" | "desc";
 export interface CanopyBadge { text: string; tone?: string; title?: string; }
 /** Ordered visual history metadata; raw cell values still drive queries and exports. */
 export interface CellPeriod { period: string; value?: number | null; state?: string | null; tone?: string; }
-export interface CanopyCell {
+import type { StructuredCell, RecordPanelDefinition } from "./records.js";
+/** A cell: a value with display text, tooltip, tone and badges; it may hold a structured value or a record link (records.d.ts). */
+export interface CanopyCell extends StructuredCell {
   value?: CellValue;
   text?: string;
   /** Alternate flat-grid search text, independent of display, typed queries and export. */
@@ -20,6 +22,8 @@ export interface CanopyCell {
   secondary?: string;
   /** At most 4096 ordered periods for a flat-grid history presenter. */
   series?: CellPeriod[];
+  /** Sort key when it differs from the value (text or a number); filters, value lists, search and display keep reading value and text. */
+  sort?: string | number;
 }
 export type Cell = CellValue | CanopyCell;
 
@@ -51,6 +55,8 @@ interface NodeDefinition {
   badges?: CanopyBadge[];
   flags?: string[];
   data?: Record<string, string>;
+  /** Values of the view's record fields (record.fields), shown in the record drawer only. */
+  fields?: Record<string, Cell>;
   expanded?: boolean;
   className?: string;
 }
@@ -67,6 +73,85 @@ export interface CanopyColumn {
   sortable?: boolean;
   hidden?: boolean;
   editable?: boolean;
+  /** Fit the visible rows' content (the tree tools part measures it); width is the fallback until then. Otherwise width is preferred. */
+  autoWidth?: boolean;
+  /** The width stays during fitting; the reader can still resize the column. */
+  fixed?: boolean;
+  /** Share of spare width, given before the tree column. */
+  flex?: number;
+  /** What content measuring reads. Default content. */
+  autoSize?: "content" | "header" | "none";
+  /** How the column gives way when narrow: 0-1 essential, 10000+ optional; or the named levels. */
+  priority?: "essential" | "normal" | "optional" | number;
+  /** Retained during responsive fitting. */
+  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;
+  /** 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. */
+  renderer?: string;
+  /** The record drawer section of the column. */
+  section?: string;
+  /** false keeps the column out of the record drawer. Default true. */
+  drawer?: boolean;
+}
+/** Per-control tree toolbar switches in the view document; an absent switch keeps its control. */
+export interface TreeToolbarControls {
+  filters?: boolean;
+  columns?: boolean;
+  views?: boolean;
+  export?: boolean;
+  more?: boolean;
+  /** The match navigator and the Highlight matches switch of a view with searchHighlight. */
+  matches?: boolean;
+  /** The Layout menu of a view with layout options. */
+  layout?: boolean;
+}
+/** Search-hit highlighting (docs/search-highlight.md). true in a view document uses every default. */
+export interface SearchHighlightOptions {
+  /** Marks shown when the view opens; the reader can switch them. Default true. */
+  enabled?: boolean;
+  /** Mark quick-search text. Default true. */
+  search?: boolean;
+  /** Mark the values a flat grid's column filters match, styled apart from search hits. Default true. */
+  filters?: boolean;
+  /** Compare case exactly when marking. Default false: the search's own case folding. */
+  matchCase?: boolean;
+  /** A letter with accents matches its base letter when marking. Default false. */
+  ignoreAccents?: boolean;
+  /** The shortest term that is marked, 1..32. Default 1. */
+  minLength?: number;
+  /** A tone per column id for its filter hits. */
+  filterTones?: Record<string, string>;
+}
+/** How a view lays out its columns (docs/layout-modes.md). Trees offer fit and scroll. */
+export type LayoutMode = "fit" | "scroll" | "cards";
+/** Row spacing; "default" is the Normal density. */
+export type LayoutDensity = "compact" | "default" | "comfortable";
+/** The Layout menu of a view: the layouts the reader can choose, and the starting layout and density. */
+export interface LayoutOptions<M extends LayoutMode = LayoutMode> {
+  mode?: M;
+  modes?: readonly M[];
+  density?: LayoutDensity;
+}
+/** The reader's layout choice, as saved state keeps it. */
+export interface LayoutState { mode: LayoutMode; density: LayoutDensity; }
+/** The current layout and the layouts the view offers. */
+export interface LayoutInfo extends LayoutState { readonly modes: readonly LayoutMode[]; }
+/** The match count: total matches (in the loaded rows while complete is false) and the 1-based current match, or 0. */
+export interface MatchInfo { readonly enabled: boolean; readonly total: number; readonly current: number; readonly complete: boolean; }
+/** Search highlighting and layout methods of every tree and flat grid; they reject when the view does not declare the feature. */
+export interface ViewModeMethods {
+  getLayout(): LayoutInfo;
+  /** Switches the layout and/or density, keeping the query, selection, focus and the first row in view. */
+  setLayout(change: Partial<LayoutState>): Promise<LayoutInfo>;
+  getMatches(): MatchInfo;
+  /** The Highlight matches switch. */
+  setSearchHighlight(enabled: boolean): Promise<void>;
+  /** Moves to the next match and scrolls its row into view; focus (default true) focuses its cell. False when nothing matches. */
+  nextMatch(options?: { focus?: boolean }): Promise<boolean>;
+  previousMatch(options?: { focus?: boolean }): Promise<boolean>;
 }
 export interface CanopyFilter {
   id: string;
@@ -104,10 +189,10 @@ export type InlineNode = LeafNode | DetailNode | InlineBranch<InlineNode>;
 
 /** Names accepted by the interactive runtime; omitted translations use English. */
 export type LabelName =
-  | "gridPaging" | "gridPageRange" | "gridPageNumber" | "gridPageLength" | "gridFirstPage" | "gridPreviousPage" | "gridNextPage" | "gridLastPage"
+  | "gridPaging" | "gridPageRange" | "gridPageNumber" | "gridPageLength" | "gridFirstPage" | "gridPreviousPage" | "gridNextPage" | "gridLastPage" | "gridPageInfo" | "gridPageInfoFiltered" | "gridPageButton"
   | "gridUnknownCount" | "gridMatchedCount" | "gridCursorRange"
   | "gridResultCount" | "gridClearQuery" | "gridRemoveSearch" | "gridGroupedFilters" | "gridRemoveGroup" | "gridRemoveCondition"
-  | "gridExport" | "gridFilteredResults" | "gridSelectedRows" | "gridAllResults" | "gridDownloadCsv" | "gridCopy" | "gridDetails"
+  | "gridExport" | "gridFilteredResults" | "gridSelectedRows" | "gridAllResults" | "gridVisibleRows" | "gridAllRows" | "gridDownloadCsv" | "gridCopy" | "gridDetails"
   | "searchPlaceholder" | "searchResults" | "searchResultCount" | "searchResultCountOfTotal"
   | "searchResultCountOfMany" | "searchNoResults" | "searchTooShort" | "searchWordTooShort" | "searchFailed"
   | "columns" | "visibleColumns" | "resizeColumn" | "columnWidth" | "loading" | "loadError" | "queryFailed"
@@ -125,8 +210,10 @@ export type LabelName =
   | "gridRenameView" | "gridDefaultView" | "gridClearDefaultView" | "gridDefaultViewName" | "gridNoDefaultView" | "gridDefaultViewOption"
   | "gridSelection" | "gridSelectPage" | "gridSelectMatching" | "gridClearSelection" | "gridSelectionCount"
   | "gridSelectionQueryCount" | "gridSelectionQueryUnknown" | "gridSelectRecord"
-  | "gridGroupHeading" | "gridGroupMissing" | "gridGroupExpand" | "gridGroupCollapse" | "gridSummary" | "gridGroupOrder"
-  | "gridExportProgress" | "gridExportReading" | "gridExportCancelled" | "gridCancelExport" | "gridPrint"
+  | "gridGroupHeading" | "gridGroupMissing" | "gridGroupExpand" | "gridGroupCollapse" | "gridSummary" | "gridGroupOrder" | "gridAggregateCount" | "gridAggregateSum" | "gridAggregateAverage" | "gridAggregateMinimum" | "gridAggregateMaximum" | "gridGroupBy" | "gridUngroup" | "gridGroupDrop" | "gridExpandAll" | "gridCollapseAll" | "gridExpandLevel" | "gridCollapseLevel" | "gridGroupMove" | "gridGroupSortBy" | "gridGroupSortValue" | "gridGroupSortAggregate" | "gridSelectGroup" | "gridAggregateDistinct" | "gridShowDetail" | "gridHideDetail" | "gridDetailOf" | "gridDetailFailed"
+  | "gridExportProgress" | "gridExportReading" | "gridExportCancelled" | "gridCancelExport" | "gridNoExportColumns" | "gridPrint"
+  | "matchesHighlight" | "matchesCount" | "matchesPosition" | "matchesNone" | "matchesLoaded" | "matchesPrevious" | "matchesNext" | "matchesAnnounce"
+  | "layoutMenu" | "layoutFit" | "layoutScroll" | "layoutCards" | "layoutDensity" | "layoutCompact" | "layoutNormal" | "layoutComfortable" | "layoutChanged" | "layoutSort"
   | "gridFitContent"
   | "gridUnpin"
   | "gridWhere"
@@ -140,7 +227,37 @@ export type LabelName =
   | "gridOfTheseAreTrue"
   | "gridOfThese"
   | "gridGroupCount"
-  | "gridMore" | "gridDone" | "gridClearAll" | "gridRows" | "gridResultNoun" | "gridSearchNoun" | "gridChart" | "gridColumnMenu" | "gridSortAscending" | "gridSortDescending" | "gridClearSort" | "gridFilterColumn" | "gridHideColumn" | "gridGroupedBy" | "gridRemoveGrouping" | "gridSelectAllValues" | "gridFilterValues" | "gridAddCondition" | "gridAddGroup" | "gridAnd" | "gridOr" | "gridEditAsText" | "gridFilterText" | "gridDeepFilters" | "gridToday" | "gridYesterday" | "gridLastSevenDays" | "gridLastThirtyDays" | "gridThisMonth" | "gridDateRange" | "gridEmpty" | "gridEmptyReason" | "gridNoMatches" | "gridNoMatchesReason" | "gridRetry" | "gridLoadFailed" | "gridAll" | "gridPageOf" | "gridStatusCount" | "gridDetailsSection" | "gridPreviousRecord" | "gridNextRecord" | "gridShowMore" | "gridNoData" | "gridPeriodRange" | "gridHealthy";
+  // The editing part's labels (docs/editing.md).
+  | "gridEditCell" | "gridEditSave" | "gridEditCancel" | "gridEditDiscard" | "gridEditUndo" | "gridEditRedo" | "gridEditEdited" | "gridEditChanges"
+  | "gridEditErrors" | "gridEditSaving" | "gridEditSaved" | "gridEditFailed" | "gridEditRequired" | "gridEditNumber" | "gridEditDate" | "gridEditMin"
+  | "gridEditMax" | "gridEditStep" | "gridEditMinLength" | "gridEditMaxLength" | "gridEditPattern" | "gridEditChoice" | "gridEditConflict" | "gridEditRejected"
+  | "gridEditNotSaved" | "gridEditNoMatches" | "gridEditSearching" | "gridEditUndone" | "gridEditRedone" | "gridEditNone"
+  | "gridMore" | "gridDone" | "gridClearAll" | "gridRows" | "gridResultNoun" | "gridSearchNoun" | "gridChart" | "gridColumnMenu" | "gridSortAscending" | "gridSortDescending" | "gridClearSort" | "gridFilterColumn" | "gridHideColumn" | "gridGroupedBy" | "gridRemoveGrouping" | "gridSelectAllValues" | "gridFilterValues" | "gridAddCondition" | "gridAddGroup" | "gridAnd" | "gridOr" | "gridEditAsText" | "gridFilterText" | "gridDeepFilters" | "gridToday" | "gridYesterday" | "gridLastSevenDays" | "gridLastThirtyDays" | "gridThisMonth" | "gridDateRange" | "gridEmpty" | "gridEmptyReason" | "gridNoMatches" | "gridNoMatchesReason" | "gridRetry" | "gridLoadFailed" | "gridAll" | "gridPageOf" | "gridStatusCount" | "gridDetailsSection" | "gridPreviousRecord" | "gridNextRecord" | "gridShowMore" | "gridNoData" | "gridPeriodRange" | "gridHealthy"
+  /** Conditional formatting (the formatting and rule editor parts of flat grids); trees ignore them. */
+  | "formatRules" | "formatLegend" | "formatUpTo" | "formatAbove" | "formatHiddenFlagged" | "formatRule" | "formatAddRule" | "formatEditRule"
+  | "formatDeleteRule" | "formatMoveUp" | "formatMoveDown" | "formatEnableRule" | "formatNoRules" | "formatName" | "formatDescription" | "formatOnlyRowsWhere"
+  | "formatEveryRow" | "formatNone" | "formatApplyTo" | "formatTargetCell" | "formatTargetRow" | "formatTargetColumns" | "formatStyle" | "formatHighlight"
+  | "formatDataBar" | "formatColorScale" | "formatBands" | "formatTone" | "formatEmphasis" | "formatFill" | "formatTextOnly" | "formatStrong"
+  | "formatIcon" | "formatNoIcon" | "formatAutomatic" | "formatBadge" | "formatCue" | "formatLowest" | "formatMidpoint" | "formatHighest"
+  | "formatAddBand" | "formatRemoveBand" | "formatSave" | "formatCancel" | "formatShowLegend" | "formatInvalid" | "formatMatchCase" | "formatToneDanger"
+  | "formatToneWarning" | "formatToneSuccess" | "formatToneInfo" | "formatToneNeutral" | "formatToneMuted" | "formatNotContains" | "formatEndsWith" | "formatNotIn"
+  | "formatBetween" | "formatLike" | "formatMatches" | "formatOlderThan" | "formatWithinLast" | "formatNotLike" | "formatNotMatches" | "formatBetweenExclusive"
+  /** Cell ranges and the clipboard (docs/cell-ranges.md). */
+  | "gridCellRangeSelected" | "gridCellRangesSelected" | "gridCellRangeCleared" | "gridCopyCells" | "gridCopyCellsWithHeaders" | "gridPasteCells"
+  | "gridSelectAllCells" | "gridCellsCopied" | "gridCellsPasted" | "gridPasteRefused" | "gridPasteReadOnly" | "gridPasteType" | "gridPasteReport"
+  | "gridPasteCell" | "gridFillHandle" | "gridCellsFilled" | "gridCellMenu" | "gridClearCellRanges"
+  /** Linked views (docs/linked-views.md). */
+  | "linkFilteredBy" | "linkRemoveFilter" | "linkFiltered" | "linkHighlighted" | "linkHighlightedRows" | "linkCleared"
+  /** 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"
+  | "calendarAgenda" | "calendarYear" | "calendarTimeline" | "calendarGoTo" | "calendarAllDay" | "calendarMore" | "calendarMoreLabel" | "calendarDayEvents"
+  | "calendarNoEvents" | "calendarEvents" | "calendarShowing" | "calendarRepeats" | "calendarTruncated" | "calendarLoading" | "calendarLoadError" | "calendarNow"
+  | "calendarZoom" | "calendarZoomHour" | "calendarZoomDay" | "calendarZoomWeek" | "calendarZoomMonth" | "calendarZoomQuarter" | "calendarResources" | "calendarCapacity"
+  | "calendarCapacityAt" | "calendarBusy" | "calendarOverlaps" | "calendarUnavailable" | "calendarOutsideHours" | "calendarConflict" | "calendarNotAllowed" | "calendarMoved"
+  | "calendarResized" | "calendarSeriesMoved" | "calendarSeriesTime" | "calendarMoveHelp" | "calendarEdit" | "calendarSaveFailed" | "calendarExport" | "calendarTimeRange" | "calendarSelected"
+  | "calendarLane" | "calendarHighlighted";
 export type CanopyLabels = Partial<Record<LabelName, string>>;
 
 export interface InlineSourceDefinition { kind: "inline"; }
@@ -169,8 +286,20 @@ interface ViewDefinitionBase {
   filters?: CanopyFilter[];
   timeZone?: TimeZone;
   pinTreeColumn?: boolean;
+  /** Marks the search box's words in the tree column (docs/search-highlight.md). */
+  searchHighlight?: boolean | SearchHighlightOptions;
+  /** The Layout menu: fit and scroll, and the density (docs/layout-modes.md). */
+  layout?: LayoutOptions<"fit" | "scroll">;
+  /** Per-control toolbar switches (the search box is the search property). */
+  toolbar?: TreeToolbarControls;
+  /** Identities of registered export formats the Export menu offers after CSV, in order. */
+  exportFormats?: string[];
+  /** A tree whose visible rows fit is as tall as its rows; false keeps the host height. Default true. */
+  autoHeight?: boolean;
   stateKey?: string;
   deepLink?: boolean;
+  /** The record panel of the tree's drawer (records.d.ts, docs/record-panel.md). */
+  record?: RecordPanelDefinition;
   labels?: CanopyLabels;
   dragDrop?: boolean;
   contextActions?: ContextAction[];
@@ -221,6 +350,10 @@ export interface ViewState {
   filters: string[];
   timeZone: TimeZone;
   pinTreeColumn: boolean;
+  /** The reader's layout, in a view with layout options. */
+  layout?: LayoutState;
+  /** The reader's Highlight matches switch, in a view with searchHighlight. */
+  highlight?: boolean;
   focus: string[] | null;
   anchor: { path: string[]; offset: number } | null;
   checkboxes?: CheckMode;

package/JavaScript/records.d.ts

@@ -0,0 +1,136 @@
+// The record panel (docs/record-panel.md): structured values, record-only fields, the record drawer's layout, record links,
+// records loaded on demand (the gridRecord exchange) and the extension points of the drawer.
+import type { Cell, CellValue } from "./protocol.js";
+
+/** A link from a value to another record: of the value's own view, or of the grid or tree with id view. */
+export interface RecordRef {
+  readonly id: string;
+  readonly view?: string;
+  /** A tree record's id path from a top-level node, ending with id, so the tree can expand to it. */
+  readonly path?: readonly string[];
+}
+/** One named value of an object value. */
+export interface RecordFieldValue { readonly name: string; readonly value: Cell; readonly kind?: "number" | "datetime"; }
+/** A field's value before and after a change. Lists (items) on both sides mark the items removed and added. */
+export interface RecordChange { readonly name: string; readonly before: Cell; readonly after: Cell; readonly kind?: "number" | "datetime"; }
+/** One timeline event. */
+export interface RecordEvent {
+  readonly time?: string; readonly summary: string; readonly actor?: string; readonly kind?: string; readonly tone?: string;
+  readonly ref?: RecordRef; readonly changes?: readonly RecordChange[];
+}
+/** A column of a collection: a grid column (rows) or a tree column (roots). */
+export interface RecordListColumn {
+  readonly id: string; readonly title: string; readonly kind?: "text" | "number" | "datetime"; readonly width?: number;
+  readonly sortable?: boolean; readonly presenter?: unknown; readonly [option: string]: unknown;
+}
+/** A row of a collection. */
+export interface RecordListRow { readonly id: string; readonly cells: Readonly<Record<string, Cell>>; readonly [field: string]: unknown; }
+/** The grid whose records a collection's rows are: rows open their record there, and Open all in grid filters it. */
+export interface RecordTarget {
+  readonly view: string; readonly column?: string; readonly values?: readonly CellValue[];
+  readonly filters?: readonly { readonly column: string; readonly operator: string; readonly values: readonly CellValue[] }[];
+}
+/** A collection of records: rows (or tree roots), the total when rows are the first ones, and the target grid. */
+export interface RecordList {
+  readonly columns: readonly RecordListColumn[];
+  readonly rows?: readonly RecordListRow[];
+  readonly roots?: readonly unknown[];
+  readonly total?: number; readonly pageLength?: number; readonly pageSize?: number;
+  readonly target?: RecordTarget;
+}
+/** The structured members a cell object may carry (at most one of items, fields, records, events and changes) and a link. */
+export interface StructuredCell {
+  /** A list value: chips in the panel; the structured presenter summarises it in the grid. */
+  items?: Cell[];
+  /** An object value: a nested property list. */
+  fields?: RecordFieldValue[];
+  /** A collection: a nested grid or tree, cards on phones, a table in print. */
+  records?: RecordList;
+  /** A timeline. */
+  events?: RecordEvent[];
+  /** Before/after values. */
+  changes?: RecordChange[];
+  /** A link to another record. */
+  ref?: RecordRef;
+}
+
+/** A record-only field: a value the drawer shows that is not a grid column. */
+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;
+}
+export interface RecordSectionDefinition {
+  readonly id: string; readonly label: string; readonly fields?: readonly string[]; readonly collapsed?: boolean;
+  /** A plugin's drawerSections entry or the host's recordSections entry that draws content above the fields. */
+  readonly renderer?: string; readonly sections?: readonly RecordSectionDefinition[];
+}
+export interface RecordTabDefinition { readonly id: string; readonly label: string; readonly sections: readonly string[]; }
+/** The view's record panel (view.record). */
+export interface RecordPanelDefinition {
+  readonly fields?: readonly RecordFieldDefinition[];
+  readonly header?: { readonly status?: string; readonly facts?: readonly string[] };
+  readonly sections?: readonly RecordSectionDefinition[];
+  readonly tabs?: readonly RecordTabDefinition[];
+  /** Empty fields hide until the reader shows them. Default true. */
+  readonly hideEmpty?: boolean;
+  /** A jump list of sections; absent shows it from four sections. */
+  readonly jumpList?: boolean;
+  /** Record deep links (#record=<view>:<id>, or the key given). */
+  readonly deepLink?: true | { readonly key?: string };
+  readonly source?: { readonly kind: "inline" | "host" } | { readonly kind: "sidecar"; readonly base: string; readonly shards: number };
+  readonly actions?: { readonly copy?: boolean; readonly print?: boolean; readonly export?: boolean; readonly link?: boolean };
+}
+
+/** The request for a record's details: the record, a collection field's next rows (field, offset, limit), or its row too. */
+export interface GridRecordQuery {
+  readonly protocol: "canopyx/2"; readonly type: "gridRecordQuery"; readonly view: string; readonly id: string;
+  readonly revision?: string; readonly field?: string; readonly offset?: number; readonly limit?: number; readonly row?: true;
+}
+/** A record's details. Plain objects with cells, fields and row are accepted as well. */
+export interface GridRecord {
+  readonly protocol?: "canopyx/2"; readonly type?: "gridRecord"; readonly view?: string; readonly id?: string; readonly revision?: string;
+  readonly cells?: Readonly<Record<string, Cell>>; readonly fields?: Readonly<Record<string, Cell>>;
+  readonly row?: RecordListRow;
+}
+/** Loads a record's details when its drawer opens (the loadRecord option, or a hosted source's record hook). */
+export type RecordLoader = (request: GridRecordQuery, options: { signal: AbortSignal }) => GridRecord | null | PromiseLike<GridRecord | null>;
+/** The context of a drawer section renderer. */
+export interface RecordSectionContext {
+  readonly section: string; readonly view: string; readonly api: unknown; readonly labels: Readonly<Record<string, string>>;
+  readonly signal: AbortSignal; readonly payload: GridRecord | null;
+  /** Every field's value, columns and record fields, by id. */
+  readonly values: Readonly<Record<string, Cell | undefined>>;
+  /** True while the record prints. */
+  readonly print: boolean; readonly width: number;
+  onDispose(cleanup: () => void): void;
+}
+/** Draws a drawer section's content (a chart, for example) into element. */
+export type RecordSectionRenderer = (record: Readonly<{ id: string; cells?: Readonly<Record<string, Cell>>; fields?: Readonly<Record<string, Cell>>; label?: string }>,
+  element: HTMLElement, context: RecordSectionContext) => void | PromiseLike<void>;
+/** An action of the record panel's actions menu. */
+export interface RecordAction {
+  readonly label: string;
+  run(context: { readonly record: Readonly<{ id: string; cells?: Readonly<Record<string, Cell>>; fields?: Readonly<Record<string, Cell>> }>; readonly view: string; readonly api: unknown;
+    readonly payload: GridRecord | null; readonly signal: AbortSignal }): void | PromiseLike<void>;
+}
+/** The canopyx:openAll event's detail (and onOpenAll's argument): cancel it to filter the target grid yourself. */
+export interface RecordOpenAll {
+  readonly view: string; readonly ids: readonly string[]; readonly field: string; readonly record: string; readonly total: number;
+  readonly filters: readonly { readonly column: string; readonly operator: string; readonly values: readonly CellValue[] }[] | null;
+}
+/** Options that open a record (openRecord). */
+export interface OpenRecordOptions { readonly returnFocus?: Element | null; readonly path?: readonly string[]; readonly tab?: string; }
+/** Host options of the record panel, on grids and trees. */
+export interface RecordPanelOptions {
+  /** Loads a record's details when its drawer opens; used whatever the declared source. */
+  loadRecord?: RecordLoader;
+  /** Section renderers by name, beside the plugins' drawerSections. */
+  recordSections?: Readonly<Record<string, RecordSectionRenderer>>;
+  /** Actions of the record actions menu, after the built-in ones. */
+  recordActions?: readonly RecordAction[];
+  /** Open all in grid: return false (or cancel canopyx:openAll) to handle it yourself. */
+  onOpenAll?: (event: RecordOpenAll) => boolean | void;
+  /** Print one record: return false (or cancel canopyx:recordPrint) to print the sheet yourself. */
+  onRecordPrint?: (event: { readonly id: string; readonly element: HTMLElement; readonly dispose: () => void }) => boolean | void;
+}

package/README.md

@@ -19,14 +19,15 @@ Turn application data into searchable trees, sortable tables and standalone HTML
 - **HTML reports** that include their own runtime and data and can be opened from disk or a file share.
 - **Application views** backed by paged or cursor-based data sources, with selection and detail callbacks.
 - **Email and print tables** rendered from the same .NET view without JavaScript.
+- **Calendars and resource timelines** of the same records: month, week, day, agenda and year views, resources grouped as a tree with capacity per group, recurring events, drag to reschedule through the grid's editing, and iCalendar export.
 
-![File explorer in the light theme, with sizes, dates, owners and an expanded detail row](https://cdn.jsdelivr.net/npm/@evotecit/canopyx@0.1.2/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.2.0/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.1.2/docs/images/tree-grid-dark.png) | ![Static outline table](https://cdn.jsdelivr.net/npm/@evotecit/canopyx@0.1.2/docs/images/static-outline.png) |
+| ![File explorer in the dark theme](https://cdn.jsdelivr.net/npm/@evotecit/canopyx@0.2.0/docs/images/tree-grid-dark.png) | ![Static outline table](https://cdn.jsdelivr.net/npm/@evotecit/canopyx@0.2.0/docs/images/static-outline.png) |
 
 ## Features
 
@@ -34,12 +35,13 @@ The same explorer in the dark theme, alongside its script-free output for email
 | --- | --- | --- |
 | Navigation | Expandable branches, path search and lazy children | Continuous or paged records, offset or cursor navigation |
 | Querying | Search, sibling sorting and named filters | Search, multi-column sorting, typed filters and condition groups |
-| Columns | Resize and hide | Resize, hide, reorder, pin and fit to content |
-| Selection | Single/multiple selection and hierarchical checkboxes | Single/multiple selection with stable record IDs |
-| Presentation | Badges, details, custom cells and light/dark themes | Links, progress, wrapped text, row highlighting and light/dark themes |
-| Delivery | Single HTML file, sidecar bundle or hosted data | Single HTML file or hosted data |
+| Columns | Resize and hide | Resize, hide, reorder, pin, fit to content and group under multi-level headers |
+| Selection | Single/multiple selection and hierarchical checkboxes | Single/multiple selection with stable record IDs, and cell ranges with copy, paste and a fill handle |
+| Presentation | Badges, details, custom cells and light/dark themes | Links, progress, wrapped text, row highlighting, conditional formatting and light/dark themes |
+| Grouping and details | Nested branches and detail rows | Multi-level row groups with labelled aggregates, and expandable detail rows holding a template, HTML or a nested grid or tree |
+| Delivery | Single HTML file, sidecar bundle or hosted data | Single HTML file, row-chunk sidecar bundle or hosted data |
 
-Both views use virtual rows and support keyboard navigation. Reporting grids also provide grouping, aggregates, saved views, CSV export and row copying. English labels are built in; Polish, German and Spanish packs are included.
+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.
 
 ## Installation
 
@@ -59,6 +61,8 @@ dotnet add package CanopyX.Html
 
 Neither .NET package adds third-party runtime dependencies. Generating a report from C# needs no Node.js, npm or JavaScript build step.
 
+To serve a hosted grid from your own data, add `CanopyX.Data` (server-side paging, sorting, filtering, value lists, multi-level summaries, streamed export and commits of edited rows over `IQueryable<T>` or your own provider) and, in ASP.NET Core, `CanopyX.AspNetCore` for the endpoints. See [Server-side data for .NET](docs/remote-dotnet.md).
+
 ### JavaScript
 
 ```shell
@@ -184,15 +188,63 @@ The stylesheet import uses your application's asset pipeline. For a page without
 
 Module imports are safe on the server; mounting a view requires a browser. The included TypeScript declarations describe the view, data-source and event APIs.
 
+### Enhance a table, or start from records or a URL
+
+A page that already has an HTML table needs one call. The table's headers, rows, `data-order` and `data-search` values, row ids, caption and footer become a grid with search, filters, sorting, numbered pages and export, and the table stays the script-free fallback:
+
+```html
+<link rel="stylesheet" href="canopyx-grid.css">
+<script src="canopyx-grid.js"></script>
+<script>CanopyX.enhance("#servers", { pageLength: 10, stateSave: true });</script>
+```
+
+`CanopyX.grid(element, { data, columns })` builds the same grid from plain records with field paths and render functions, and `url` reads records from an address once or, with `serverSide`, asks it for every page. See [docs/enhance.md](docs/enhance.md) and [docs/paging.md](docs/paging.md).
+
+### Extend it with plugins
+
+`CanopyX.use(plugin)` adds cell renderers that columns choose by name, toolbar buttons, menu entries, export formats and event handlers to every grid and tree on the page; the `plugins` option adds them to one view. Optional features load as separate parts only when a view needs them, so serve the `canopyx-*.js` files beside the runtime (the .NET writers do). See [docs/plugins.md](docs/plugins.md).
+
+### Edit data in a grid
+
+Mark flat-grid columns `editable` and give them typed editors (text, number, date and time, select, toggle, lookup) and validation. Readers edit in the cells (or in the record drawer on phones) with undo and redo; changes stay marked until your callbacks or data source save them through row or batch commits, which report each row's result. CanopyX never writes data itself. See [docs/editing.md](docs/editing.md).
+
+### Format cells by rule
+
+`formatRules` (in .NET, `CanopyDataGridView.FormatRules`) tints cells and rows, adds icons, badges and cues, and draws data bars, colour scales and threshold bands, with conditions from the filter builder. Readers can change the rules in a rule editor, and their rules are kept in saved views. See [docs/conditional-formatting.md](docs/conditional-formatting.md).
+
+### Show records as a calendar
+
+Give a grid a `calendar` (in .NET, `CanopyDataGridView.Calendar`, or `grid.Calendar().Start(x => x.Starts).End(x => x.Ends)` on a typed grid) and its records show as a month, week, day, N-day, agenda or year calendar, or, with resources, a resource timeline whose resources are a CanopyX tree. The grid's search, filters, facets, saved views, record panel, linked views, live data and editing keep working on the same records; recurring events, time zones with correct DST, iCalendar export and print come with it. See [docs/calendar.md](docs/calendar.md) and [docs/resource-timeline.md](docs/resource-timeline.md).
+
+### Link views together
+
+A chart, a list or another grid can filter a grid or tree (`setExternalFilter`, shown as a removable chip and sent to a host source in its query) or highlight its rows (`setHighlight`), and a view with `linkEvents` reports its selection and own conditions as neutral `canopyx:linkchange` payloads. See [docs/linked-views.md](docs/linked-views.md).
+
 ### Translate the controls
 
-Import labels from `@evotecit/canopyx/locales/pl`, `/locales/de` or `/locales/es` and pass them as `labels` in your view definition. In C#, set the view's `Labels` to `CanopyLabels.Polish()`, `German()` or `Spanish()` before writing the page.
+Import labels from `@evotecit/canopyx/locales/pl`, `/locales/de`, `/locales/es`, `/locales/fr` or `/locales/it` and pass them as `labels` in your view definition. In C#, set the view's `Labels` to `CanopyLabels.Polish()`, `German()`, `Spanish()`, `French()` or `Italian()` before writing the page.
+
+### Strict security policies and accessibility
+
+CanopyX runs under a Content Security Policy without `'unsafe-inline'` or `'unsafe-eval'`: set `CanopyHtmlOptions.Nonce` in C#, or give the runtime script a nonce, and the parts the runtime loads later carry it too. It also works with Trusted Types (`trusted-types canopyx`), writes host strings as text, and escapes CSV fields that could start a spreadsheet formula. See [docs/security.md](docs/security.md). The keyboard model, ARIA roles, forced colours, reduced motion, zoom reflow and target sizes, and what the tests check, are in [docs/accessibility.md](docs/accessibility.md).
 
 ## Working with larger datasets
 
 Virtual rows keep the rendered DOM small. Tree bundles split data into sidecar files, and hosted sources let your application fetch records as the reader navigates. Flat-grid queries filter and sort the complete dataset before paging; loading one page does not mean the rest of the results are available in the browser.
 
-CSV export and copying distinguish filtered results, selected records and all records. For Office files, large exports or application actions, connect your own callbacks to the view.
+`CanopyX.Data` answers a hosted grid's queries on the server, so a table over millions of database rows pages, sorts, filters, groups, counts value lists and exports without loading the result into the browser, and saves the rows readers edit through a writer the host controls ([docs/remote-dotnet.md](docs/remote-dotnet.md)).
+
+Large single-file reports need no switch for their rows: grids of more than 5,000 rows are written as compact row data that the browser decodes chunk by chunk after the first rows have painted, gzip-compressed when large (`RowData` and its `Format` choose otherwise). Views can mount only when they come into view (`MountWhenVisible`), and grid bundles load their rows from sidecar files (`SaveHtmlBundle`). See [docs/large-data.md](docs/large-data.md) for when to use which, with measured numbers.
+
+CSV export and copying distinguish filtered results, selected records and all records. Register your own export formats, such as an Excel or PDF writer, with `CanopyX.registerExportFormat`, and they join the grid's Export menu with the same scope choice, progress and cancellation; tree grids export their visible, selected or all rows through the same writers. For application actions, connect your own callbacks to the view.
+
+## Documentation
+
+- [Features](docs/features.md): everything the tree and data grids do, grouped by capability.
+- [Recipes](docs/recipes.md): short how-tos for server data, cell values, export, phones, grouping, saved views and translations.
+- [Authoring reference](docs/authoring.md), [column layout](docs/column-layout.md), [label packs](docs/labels.md) and the [data protocol](docs/data-protocol.md).
+- [Planned work](TODO.md): remaining capabilities, consumers and acceptance gates.
+- [Testing and benchmarks](docs/testing.md): the required correctness loop and explicit performance measurements.
 
 ## Community and license
 

package/README.nuget.md

@@ -27,7 +27,7 @@ Turn application data into searchable trees, sortable tables and standalone HTML
 | Presentation | Badges, details, custom cells and light/dark themes | Links, progress, wrapped text, row highlighting and light/dark themes |
 | Delivery | Single HTML file, sidecar bundle or hosted data | Single HTML file or hosted data |
 
-Both views use virtual rows and support keyboard navigation. Reporting grids also provide grouping, aggregates, saved views, CSV export and row copying. English labels are built in; Polish, German and Spanish packs are included.
+Both views use virtual rows and support keyboard navigation. Reporting grids also provide grouping, aggregates, saved views, CSV export and row copying. English labels are built in; Polish, German, Spanish, French and Italian packs are included.
 
 ## Installation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evotecit/canopyx",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Interactive tree grids and data tables with virtual rows, search, filters and offline HTML reports.",
   "type": "module",
   "license": "MIT",
@@ -32,6 +32,49 @@
     "./reporting.js": "./CanopyX.Html/Assets/canopyx-reporting.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",
+    "./pager.js": "./CanopyX.Html/Assets/canopyx-pager.js",
+    "./pager.css": "./CanopyX.Html/Assets/canopyx-pager.css",
+    "./enhance.js": "./CanopyX.Html/Assets/canopyx-enhance.js",
+    "./data.js": "./CanopyX.Html/Assets/canopyx-data.js",
+    "./editing.js": "./CanopyX.Html/Assets/canopyx-editing.js",
+    "./editing.css": "./CanopyX.Html/Assets/canopyx-editing.css",
+    "./column-groups.js": "./CanopyX.Html/Assets/canopyx-column-groups.js",
+    "./column-groups.css": "./CanopyX.Html/Assets/canopyx-column-groups.css",
+    "./cell-range.js": "./CanopyX.Html/Assets/canopyx-cell-range.js",
+    "./cell-range.css": "./CanopyX.Html/Assets/canopyx-cell-range.css",
+    "./tree-tools.js": "./CanopyX.Html/Assets/canopyx-tree-tools.js",
+    "./tree-tools.css": "./CanopyX.Html/Assets/canopyx-tree-tools.css",
+    "./links.js": "./CanopyX.Html/Assets/canopyx-links.js",
+    "./search.js": "./CanopyX.Html/Assets/canopyx-search.js",
+    "./formatting.js": "./CanopyX.Html/Assets/canopyx-formatting.js",
+    "./formatting.css": "./CanopyX.Html/Assets/canopyx-formatting.css",
+    "./format-editor.js": "./CanopyX.Html/Assets/canopyx-format-editor.js",
+    "./format-editor.css": "./CanopyX.Html/Assets/canopyx-format-editor.css",
+    "./link.js": "./CanopyX.Html/Assets/canopyx-link.js",
+    "./link.css": "./CanopyX.Html/Assets/canopyx-link.css",
+    "./detail-rows.js": "./CanopyX.Html/Assets/canopyx-detail-rows.js",
+    "./detail-rows.css": "./CanopyX.Html/Assets/canopyx-detail-rows.css",
+    "./grouping.js": "./CanopyX.Html/Assets/canopyx-grouping.js",
+    "./grouping.css": "./CanopyX.Html/Assets/canopyx-grouping.css",
+    "./highlight.js": "./CanopyX.Html/Assets/canopyx-highlight.js",
+    "./highlight.css": "./CanopyX.Html/Assets/canopyx-highlight.css",
+    "./layouts.js": "./CanopyX.Html/Assets/canopyx-layouts.js",
+    "./layouts.css": "./CanopyX.Html/Assets/canopyx-layouts.css",
+    "./record-panel.js": "./CanopyX.Html/Assets/canopyx-record-panel.js",
+    "./record-panel.css": "./CanopyX.Html/Assets/canopyx-record-panel.css",
+    "./live.js": "./CanopyX.Html/Assets/canopyx-live.js",
+    "./live.css": "./CanopyX.Html/Assets/canopyx-live.css",
+    "./facets.js": "./CanopyX.Html/Assets/canopyx-facets.js",
+    "./facets.css": "./CanopyX.Html/Assets/canopyx-facets.css",
+    "./calendar.js": "./CanopyX.Html/Assets/canopyx-calendar.js",
+    "./calendar.css": "./CanopyX.Html/Assets/canopyx-calendar.css",
+    "./calendar-recurrence.js": "./CanopyX.Html/Assets/canopyx-calendar-recurrence.js",
+    "./calendar-edit.js": "./CanopyX.Html/Assets/canopyx-calendar-edit.js",
+    "./calendar-ics.js": "./CanopyX.Html/Assets/canopyx-calendar-ics.js",
+    "./timeline.js": "./CanopyX.Html/Assets/canopyx-timeline.js",
+    "./timeline.css": "./CanopyX.Html/Assets/canopyx-timeline.css",
     "./locales/pl": {
       "types": "./JavaScript/locales/pl.d.ts",
       "import": "./JavaScript/locales/pl.mjs"
@@ -44,9 +87,19 @@
       "types": "./JavaScript/locales/es.d.ts",
       "import": "./JavaScript/locales/es.mjs"
     },
+    "./locales/fr": {
+      "types": "./JavaScript/locales/fr.d.ts",
+      "import": "./JavaScript/locales/fr.mjs"
+    },
+    "./locales/it": {
+      "types": "./JavaScript/locales/it.d.ts",
+      "import": "./JavaScript/locales/it.mjs"
+    },
     "./locales/pl.js": "./CanopyX.Html/Assets/canopyx-labels-pl.js",
     "./locales/de.js": "./CanopyX.Html/Assets/canopyx-labels-de.js",
-    "./locales/es.js": "./CanopyX.Html/Assets/canopyx-labels-es.js"
+    "./locales/es.js": "./CanopyX.Html/Assets/canopyx-labels-es.js",
+    "./locales/fr.js": "./CanopyX.Html/Assets/canopyx-labels-fr.js",
+    "./locales/it.js": "./CanopyX.Html/Assets/canopyx-labels-it.js"
   },
   "files": [
     "docs/images/*.png",
@@ -66,7 +119,50 @@
     "CanopyX.Html/Assets/canopyx-reporting.js",
     "CanopyX.Html/Assets/canopyx-reporting.css",
     "CanopyX.Html/Assets/canopyx-filter-editor.js",
-    "CanopyX.Html/Assets/canopyx-filter-editor.css"
+    "CanopyX.Html/Assets/canopyx-filter-editor.css",
+    "CanopyX.Html/Assets/canopyx-export.js",
+    "CanopyX.Html/Assets/canopyx-history.js",
+    "CanopyX.Html/Assets/canopyx-pager.js",
+    "CanopyX.Html/Assets/canopyx-pager.css",
+    "CanopyX.Html/Assets/canopyx-enhance.js",
+    "CanopyX.Html/Assets/canopyx-data.js",
+    "CanopyX.Html/Assets/canopyx-editing.js",
+    "CanopyX.Html/Assets/canopyx-editing.css",
+    "CanopyX.Html/Assets/canopyx-column-groups.js",
+    "CanopyX.Html/Assets/canopyx-column-groups.css",
+    "CanopyX.Html/Assets/canopyx-cell-range.js",
+    "CanopyX.Html/Assets/canopyx-cell-range.css",
+    "CanopyX.Html/Assets/canopyx-tree-tools.js",
+    "CanopyX.Html/Assets/canopyx-tree-tools.css",
+    "CanopyX.Html/Assets/canopyx-links.js",
+    "CanopyX.Html/Assets/canopyx-search.js",
+    "CanopyX.Html/Assets/canopyx-formatting.js",
+    "CanopyX.Html/Assets/canopyx-formatting.css",
+    "CanopyX.Html/Assets/canopyx-format-editor.js",
+    "CanopyX.Html/Assets/canopyx-format-editor.css",
+    "CanopyX.Html/Assets/canopyx-link.js",
+    "CanopyX.Html/Assets/canopyx-link.css",
+    "CanopyX.Html/Assets/canopyx-detail-rows.js",
+    "CanopyX.Html/Assets/canopyx-detail-rows.css",
+    "CanopyX.Html/Assets/canopyx-grouping.js",
+    "CanopyX.Html/Assets/canopyx-grouping.css",
+    "CanopyX.Html/Assets/canopyx-highlight.js",
+    "CanopyX.Html/Assets/canopyx-highlight.css",
+    "CanopyX.Html/Assets/canopyx-layouts.js",
+    "CanopyX.Html/Assets/canopyx-layouts.css",
+    "CanopyX.Html/Assets/canopyx-record-panel.js",
+    "CanopyX.Html/Assets/canopyx-record-panel.css",
+    "CanopyX.Html/Assets/canopyx-live.js",
+    "CanopyX.Html/Assets/canopyx-live.css",
+    "CanopyX.Html/Assets/canopyx-facets.js",
+    "CanopyX.Html/Assets/canopyx-facets.css",
+    "CanopyX.Html/Assets/canopyx-calendar.js",
+    "CanopyX.Html/Assets/canopyx-calendar.css",
+    "CanopyX.Html/Assets/canopyx-calendar-recurrence.js",
+    "CanopyX.Html/Assets/canopyx-calendar-edit.js",
+    "CanopyX.Html/Assets/canopyx-calendar-ics.js",
+    "CanopyX.Html/Assets/canopyx-timeline.js",
+    "CanopyX.Html/Assets/canopyx-timeline.css"
   ],
   "keywords": [
     "treegrid",