@xh/hoist 90.0.0 → 90.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (172) hide show
  1. package/CHANGELOG.md +136 -54
  2. package/admin/columns/Tracking.ts +9 -3
  3. package/admin/tabs/activity/tracking/ActivityTrackingModel.ts +155 -47
  4. package/admin/tabs/activity/tracking/ActivityTrackingPanel.ts +25 -4
  5. package/admin/tabs/activity/tracking/chart/AggChartModel.ts +2 -3
  6. package/appcontainer/ImpersonationBarModel.ts +8 -5
  7. package/build/types/admin/tabs/activity/tracking/ActivityTrackingModel.d.ts +25 -5
  8. package/build/types/cmp/cubegrid/CubeGrid.d.ts +26 -0
  9. package/build/types/cmp/cubegrid/CubeGridModel.d.ts +103 -0
  10. package/build/types/cmp/cubegrid/CubeGridPivotModel.d.ts +181 -0
  11. package/build/types/cmp/cubegrid/Types.d.ts +85 -0
  12. package/build/types/cmp/cubegrid/index.d.ts +4 -0
  13. package/build/types/cmp/dataview/DataViewModel.d.ts +6 -10
  14. package/build/types/cmp/grid/GridModel.d.ts +8 -33
  15. package/build/types/cmp/grid/Types.d.ts +51 -1
  16. package/build/types/cmp/grid/columns/Column.d.ts +2 -1
  17. package/build/types/cmp/grid/columns/ColumnGroup.d.ts +6 -0
  18. package/build/types/cmp/grid/helpers/GridCountLabel.d.ts +6 -3
  19. package/build/types/cmp/grid/impl/ColumnWidthCalculator.d.ts +6 -0
  20. package/build/types/cmp/grid/impl/GridLikeModel.d.ts +3 -0
  21. package/build/types/cmp/grid/impl/MenuSupport.d.ts +13 -0
  22. package/build/types/cmp/pdfviewer/PdfViewer.d.ts +14 -0
  23. package/build/types/cmp/pdfviewer/PdfViewerModel.d.ts +150 -0
  24. package/build/types/cmp/pdfviewer/Types.d.ts +55 -0
  25. package/build/types/cmp/pdfviewer/impl/PdfFindInputModel.d.ts +14 -0
  26. package/build/types/cmp/pdfviewer/impl/PdfViewerToolbarModel.d.ts +34 -0
  27. package/build/types/cmp/pdfviewer/impl/ZoomOptions.d.ts +10 -0
  28. package/build/types/cmp/pdfviewer/index.d.ts +3 -0
  29. package/build/types/cmp/statcard/StatCard.d.ts +90 -0
  30. package/build/types/cmp/statcard/index.d.ts +1 -0
  31. package/build/types/cmp/store/StoreFilterField.d.ts +8 -9
  32. package/build/types/cmp/store/impl/StoreFilterFieldImplModel.d.ts +4 -4
  33. package/build/types/cmp/zoneGrid/ZoneGridModel.d.ts +6 -10
  34. package/build/types/core/types/Types.d.ts +6 -0
  35. package/build/types/data/Field.d.ts +8 -1
  36. package/build/types/data/Store.d.ts +12 -0
  37. package/build/types/data/cube/Cube.d.ts +2 -0
  38. package/build/types/data/cube/CubeField.d.ts +3 -2
  39. package/build/types/data/cube/Query.d.ts +66 -4
  40. package/build/types/data/cube/View.d.ts +82 -4
  41. package/build/types/data/cube/ViewRowData.d.ts +13 -0
  42. package/build/types/data/cube/aggregate/MedianAggregator.d.ts +19 -0
  43. package/build/types/data/cube/aggregate/SumIfSameAggregator.d.ts +30 -0
  44. package/build/types/data/cube/impl/RowCache.d.ts +5 -0
  45. package/build/types/data/cube/impl/RowDataGenerator.d.ts +26 -0
  46. package/build/types/data/cube/impl/ViewDiagnostics.d.ts +27 -0
  47. package/build/types/data/cube/pivot/PivotCellRow.d.ts +27 -0
  48. package/build/types/data/cube/pivot/PivotPath.d.ts +45 -0
  49. package/build/types/data/cube/pivot/impl/PivotCells.d.ts +111 -0
  50. package/build/types/data/cube/pivot/impl/PivotReference.d.ts +39 -0
  51. package/build/types/data/cube/pivot/impl/PivotStructure.d.ts +105 -0
  52. package/build/types/data/cube/row/BaseRow.d.ts +12 -0
  53. package/build/types/data/cube/row/LeafRow.d.ts +4 -4
  54. package/build/types/data/cube/row/ParentRow.d.ts +20 -4
  55. package/build/types/data/cube/row/RowUpdate.d.ts +2 -0
  56. package/build/types/data/index.d.ts +3 -0
  57. package/build/types/desktop/cmp/button/grid/ColAutosizeButton.d.ts +6 -3
  58. package/build/types/desktop/cmp/button/grid/ColChooserButton.d.ts +7 -3
  59. package/build/types/desktop/cmp/button/grid/ExpandToLevelButton.d.ts +6 -3
  60. package/build/types/desktop/cmp/button/grid/ExportButton.d.ts +6 -3
  61. package/build/types/desktop/cmp/grid/find/GridFindField.d.ts +8 -9
  62. package/build/types/desktop/cmp/grid/find/impl/GridFindFieldImplModel.d.ts +3 -4
  63. package/build/types/desktop/cmp/pdfviewer/impl/PdfViewerToolbar.d.ts +12 -0
  64. package/build/types/desktop/cmp/statcard/impl/StatCardInfoImpl.d.ts +12 -0
  65. package/build/types/dynamics/desktop.d.ts +2 -0
  66. package/build/types/dynamics/mobile.d.ts +1 -0
  67. package/build/types/icon/Icon.d.ts +12 -0
  68. package/build/types/kit/pdfjs/index.d.ts +23 -0
  69. package/build/types/kit/pdfjs/styles.d.ts +2 -0
  70. package/build/types/kit/swiper/index.d.ts +7 -7
  71. package/build/types/mobile/cmp/button/grid/ColAutosizeButton.d.ts +6 -3
  72. package/build/types/mobile/cmp/button/grid/ColChooserButton.d.ts +6 -3
  73. package/build/types/mobile/cmp/button/grid/ExpandCollapseButton.d.ts +4 -4
  74. package/build/types/mobile/cmp/button/grid/ExpandToLevelButton.d.ts +4 -4
  75. package/build/types/mobile/cmp/pdfviewer/impl/PdfViewerToolbar.d.ts +12 -0
  76. package/cmp/README.md +3 -0
  77. package/cmp/ag-grid/AgGrid.ts +25 -3
  78. package/cmp/cubegrid/CubeGrid.ts +60 -0
  79. package/cmp/cubegrid/CubeGridModel.ts +365 -0
  80. package/cmp/cubegrid/CubeGridPivotModel.ts +943 -0
  81. package/cmp/cubegrid/README.md +343 -0
  82. package/cmp/cubegrid/Types.ts +105 -0
  83. package/cmp/cubegrid/index.ts +10 -0
  84. package/cmp/dataview/DataViewModel.ts +13 -8
  85. package/cmp/grid/Grid.scss +21 -5
  86. package/cmp/grid/GridModel.ts +41 -47
  87. package/cmp/grid/Types.ts +58 -1
  88. package/cmp/grid/columns/Column.ts +3 -1
  89. package/cmp/grid/columns/ColumnGroup.ts +10 -0
  90. package/cmp/grid/helpers/GridCountLabel.ts +12 -5
  91. package/cmp/grid/impl/ColumnGroupHeader.ts +18 -4
  92. package/cmp/grid/impl/ColumnWidthCalculator.ts +24 -0
  93. package/cmp/grid/impl/GridLikeModel.ts +17 -0
  94. package/cmp/grid/impl/MenuSupport.ts +36 -20
  95. package/cmp/pdfviewer/PdfViewer.scss +48 -0
  96. package/cmp/pdfviewer/PdfViewer.ts +102 -0
  97. package/cmp/pdfviewer/PdfViewerModel.ts +641 -0
  98. package/cmp/pdfviewer/README.md +224 -0
  99. package/cmp/pdfviewer/Types.ts +72 -0
  100. package/cmp/pdfviewer/impl/PdfFindInputModel.ts +44 -0
  101. package/cmp/pdfviewer/impl/PdfViewerToolbarModel.ts +45 -0
  102. package/cmp/pdfviewer/impl/ZoomOptions.ts +36 -0
  103. package/cmp/pdfviewer/index.ts +9 -0
  104. package/cmp/statcard/StatCard.scss +181 -0
  105. package/cmp/statcard/StatCard.ts +320 -0
  106. package/cmp/statcard/index.ts +1 -0
  107. package/cmp/store/StoreFilterField.ts +8 -9
  108. package/cmp/store/impl/StoreFilterFieldImplModel.ts +14 -14
  109. package/cmp/zoneGrid/ZoneGridModel.ts +13 -8
  110. package/core/types/Types.ts +7 -0
  111. package/data/Field.ts +10 -0
  112. package/data/Store.ts +25 -2
  113. package/data/cube/Cube.ts +5 -0
  114. package/data/cube/CubeField.ts +5 -0
  115. package/data/cube/Query.ts +170 -17
  116. package/data/cube/README.md +77 -2
  117. package/data/cube/View.ts +211 -32
  118. package/data/cube/ViewRowData.ts +22 -0
  119. package/data/cube/aggregate/MedianAggregator.ts +88 -0
  120. package/data/cube/aggregate/SumIfSameAggregator.ts +128 -0
  121. package/data/cube/impl/RowCache.ts +32 -11
  122. package/data/cube/impl/RowDataGenerator.ts +96 -4
  123. package/data/cube/impl/ViewDiagnostics.ts +47 -0
  124. package/data/cube/pivot/PivotCellRow.ts +73 -0
  125. package/data/cube/pivot/PivotPath.ts +67 -0
  126. package/data/cube/pivot/impl/PivotCells.ts +538 -0
  127. package/data/cube/pivot/impl/PivotReference.ts +125 -0
  128. package/data/cube/pivot/impl/PivotStructure.ts +500 -0
  129. package/data/cube/row/BaseRow.ts +26 -0
  130. package/data/cube/row/LeafRow.ts +9 -8
  131. package/data/cube/row/ParentRow.ts +58 -25
  132. package/data/cube/row/RowUpdate.ts +8 -0
  133. package/data/index.ts +3 -0
  134. package/desktop/appcontainer/AppContainer.ts +5 -1
  135. package/desktop/cmp/button/grid/ColAutosizeButton.ts +21 -5
  136. package/desktop/cmp/button/grid/ColChooserButton.ts +11 -5
  137. package/desktop/cmp/button/grid/ExpandToLevelButton.ts +20 -5
  138. package/desktop/cmp/button/grid/ExportButton.ts +19 -7
  139. package/desktop/cmp/dash/canvas/DashCanvas.ts +26 -2
  140. package/desktop/cmp/grid/find/GridFindField.ts +8 -9
  141. package/desktop/cmp/grid/find/impl/GridFindFieldImplModel.ts +15 -16
  142. package/desktop/cmp/grid/impl/colchooser/ColChooserBucketModel.ts +1 -1
  143. package/desktop/cmp/pdfviewer/impl/PdfViewerToolbar.ts +190 -0
  144. package/desktop/cmp/statcard/impl/StatCardInfoImpl.ts +27 -0
  145. package/docs/README.md +6 -2
  146. package/docs/doc-registry.json +21 -5
  147. package/docs/upgrade-notes/v90-upgrade-notes.md +130 -0
  148. package/docs/version-compatibility.md +2 -1
  149. package/dynamics/desktop.ts +4 -0
  150. package/dynamics/mobile.ts +2 -0
  151. package/format/FormatNumber.ts +6 -2
  152. package/icon/Icon.ts +18 -0
  153. package/icon/index.ts +32 -0
  154. package/kit/README.md +2 -0
  155. package/kit/pdfjs/PdfJs.scss +25 -0
  156. package/kit/pdfjs/index.ts +103 -0
  157. package/kit/pdfjs/pdf_viewer.css +6481 -0
  158. package/kit/pdfjs/styles.ts +12 -0
  159. package/mcp/README.md +13 -0
  160. package/mcp/data/import-paths.ts +4 -8
  161. package/mcp/data/index-cache.ts +2 -1
  162. package/mcp/data/ts-registry.ts +8 -29
  163. package/mcp/util/paths.ts +26 -0
  164. package/mobile/appcontainer/AppContainer.ts +3 -1
  165. package/mobile/cmp/button/grid/ColAutosizeButton.ts +20 -5
  166. package/mobile/cmp/button/grid/ColChooserButton.ts +12 -5
  167. package/mobile/cmp/button/grid/ExpandCollapseButton.ts +10 -6
  168. package/mobile/cmp/button/grid/ExpandToLevelButton.ts +10 -6
  169. package/mobile/cmp/pdfviewer/impl/PdfViewerToolbar.ts +137 -0
  170. package/package.json +14 -8
  171. package/public/msal-redirect-bridge.min.js +1 -1
  172. package/styles/vars.scss +59 -0
@@ -247,6 +247,7 @@ export declare const iconFactories: {
247
247
  grid(p?: IconProps): any;
248
248
  gridLarge(p?: IconProps): any;
249
249
  gridPanel(p?: IconProps): any;
250
+ gridPivot(p?: IconProps): any;
250
251
  grip(p?: IconProps): any;
251
252
  hand(p?: IconProps): any;
252
253
  handshake(p?: IconProps): any;
@@ -272,6 +273,8 @@ export declare const iconFactories: {
272
273
  logout(p?: IconProps): any;
273
274
  magic(p?: IconProps): any;
274
275
  magnifyingGlass(p?: IconProps): any;
276
+ magnifyingGlassMinus(p?: IconProps): any;
277
+ magnifyingGlassPlus(p?: IconProps): any;
275
278
  mail(p?: IconProps): any;
276
279
  mapSigns(p?: IconProps): any;
277
280
  mask(p?: IconProps): any;
@@ -308,6 +311,7 @@ export declare const iconFactories: {
308
311
  reset(p?: IconProps): any;
309
312
  rocket(p?: IconProps): any;
310
313
  roles(p?: IconProps): any;
314
+ rotateRight(p?: IconProps): any;
311
315
  server(p?: IconProps): any;
312
316
  settings(p?: IconProps): any;
313
317
  shield(p?: IconProps): any;
@@ -407,6 +411,8 @@ export declare const aliasFactories: {
407
411
  sync(p?: IconProps): any;
408
412
  transaction(p?: IconProps): any;
409
413
  upload(p?: IconProps): any;
414
+ zoomIn(p?: IconProps): any;
415
+ zoomOut(p?: IconProps): any;
410
416
  };
411
417
  /**
412
418
  * Singleton class to provide factories for creating standard FontAwesome-based icons.
@@ -533,6 +539,7 @@ export declare const Icon: {
533
539
  grid(p?: IconProps): any;
534
540
  gridLarge(p?: IconProps): any;
535
541
  gridPanel(p?: IconProps): any;
542
+ gridPivot(p?: IconProps): any;
536
543
  grip(p?: IconProps): any;
537
544
  hand(p?: IconProps): any;
538
545
  handshake(p?: IconProps): any;
@@ -558,6 +565,8 @@ export declare const Icon: {
558
565
  logout(p?: IconProps): any;
559
566
  magic(p?: IconProps): any;
560
567
  magnifyingGlass(p?: IconProps): any;
568
+ magnifyingGlassMinus(p?: IconProps): any;
569
+ magnifyingGlassPlus(p?: IconProps): any;
561
570
  mail(p?: IconProps): any;
562
571
  mapSigns(p?: IconProps): any;
563
572
  mask(p?: IconProps): any;
@@ -594,6 +603,7 @@ export declare const Icon: {
594
603
  reset(p?: IconProps): any;
595
604
  rocket(p?: IconProps): any;
596
605
  roles(p?: IconProps): any;
606
+ rotateRight(p?: IconProps): any;
597
607
  server(p?: IconProps): any;
598
608
  settings(p?: IconProps): any;
599
609
  shield(p?: IconProps): any;
@@ -685,6 +695,8 @@ export declare const Icon: {
685
695
  sync(p?: IconProps): any;
686
696
  transaction(p?: IconProps): any;
687
697
  upload(p?: IconProps): any;
698
+ zoomIn(p?: IconProps): any;
699
+ zoomOut(p?: IconProps): any;
688
700
  /**
689
701
  * Return a Hoist element wrapper around a FontAwesome-based icon.
690
702
  *
@@ -0,0 +1,23 @@
1
+ import type * as PdfJsLibModule from 'pdfjs-dist/legacy/build/pdf.mjs';
2
+ import type * as PdfJsViewerLibModule from 'pdfjs-dist/legacy/web/pdf_viewer.mjs';
3
+ export type PdfJsLib = typeof PdfJsLibModule;
4
+ export type PdfJsViewerLib = typeof PdfJsViewerLibModule;
5
+ /** The pdf.js core and viewer component libraries, loaded on demand. */
6
+ export interface PdfJs {
7
+ lib: PdfJsLib;
8
+ viewer: PdfJsViewerLib;
9
+ /** Shared worker for parsing documents - pass to `getDocument()`. */
10
+ worker: InstanceType<PdfJsLib['PDFWorker']>;
11
+ /** Supplies wasm decoders and fonts to pdf.js - pass to `getDocument()`. */
12
+ BinaryDataFactory: any;
13
+ }
14
+ /**
15
+ * Load pdf.js on first use. Apps opt in by adding `pdfjs-dist` to their own dependencies -
16
+ * Hoist declares it as an optional peer dependency.
17
+ *
18
+ * The library, its worker, and its CSS are split into separate chunks by the app bundler and
19
+ * fetched only when a PDF is first displayed. No app-side bootstrap or build config is required.
20
+ *
21
+ * Uses the pdf.js "legacy" build, which supports a wider range of browsers than its modern build.
22
+ */
23
+ export declare function loadPdfJsAsync(): Promise<PdfJs>;
@@ -0,0 +1,2 @@
1
+ import './pdf_viewer.css';
2
+ import './PdfJs.scss';
@@ -12,23 +12,23 @@ export declare const swiper: import("@xh/hoist/core").ElementFactory<import("rea
12
12
  onAutoplayResume?: (swiper: import("swiper/types").Swiper) => void;
13
13
  onAutoplayTimeLeft?: (swiper: import("swiper/types").Swiper, timeLeft: number, percentage: number) => void;
14
14
  onAutoplay?: (swiper: import("swiper/types").Swiper) => void;
15
+ onKeyPress?: (swiper: import("swiper/types").Swiper, keyCode: string) => void;
15
16
  onHashChange?: (swiper: import("swiper/types").Swiper) => void;
16
17
  onHashSet?: (swiper: import("swiper/types").Swiper) => void;
17
- onKeyPress?: (swiper: import("swiper/types").Swiper, keyCode: string) => void;
18
- onScroll?: (swiper: import("swiper/types").Swiper, event: WheelEvent) => void;
19
- onScrollbarDragStart?: (swiper: import("swiper/types").Swiper, event: MouseEvent | TouchEvent | PointerEvent) => void;
20
- onScrollbarDragMove?: (swiper: import("swiper/types").Swiper, event: MouseEvent | TouchEvent | PointerEvent) => void;
21
- onScrollbarDragEnd?: (swiper: import("swiper/types").Swiper, event: MouseEvent | TouchEvent | PointerEvent) => void;
22
18
  onPaginationRender?: (swiper: import("swiper/types").Swiper, paginationEl: HTMLElement) => void;
23
19
  onPaginationUpdate?: (swiper: import("swiper/types").Swiper, paginationEl: HTMLElement) => void;
24
20
  onPaginationHide?: (swiper: import("swiper/types").Swiper) => void;
25
21
  onPaginationShow?: (swiper: import("swiper/types").Swiper) => void;
26
- onVirtualUpdate?: (swiper: import("swiper/types").Swiper) => void;
27
- onZoomChange?: (swiper: import("swiper/types").Swiper, scale: number, imageEl: HTMLElement, slideEl: HTMLElement) => void;
28
22
  onNavigationHide?: (swiper: import("swiper/types").Swiper) => void;
29
23
  onNavigationShow?: (swiper: import("swiper/types").Swiper) => void;
30
24
  onNavigationPrev?: (swiper: import("swiper/types").Swiper) => void;
31
25
  onNavigationNext?: (swiper: import("swiper/types").Swiper) => void;
26
+ onScroll?: (swiper: import("swiper/types").Swiper, event: WheelEvent) => void;
27
+ onZoomChange?: (swiper: import("swiper/types").Swiper, scale: number, imageEl: HTMLElement, slideEl: HTMLElement) => void;
28
+ onScrollbarDragStart?: (swiper: import("swiper/types").Swiper, event: MouseEvent | TouchEvent | PointerEvent) => void;
29
+ onScrollbarDragMove?: (swiper: import("swiper/types").Swiper, event: MouseEvent | TouchEvent | PointerEvent) => void;
30
+ onScrollbarDragEnd?: (swiper: import("swiper/types").Swiper, event: MouseEvent | TouchEvent | PointerEvent) => void;
31
+ onVirtualUpdate?: (swiper: import("swiper/types").Swiper) => void;
32
32
  onInit?: (swiper: import("swiper/types").Swiper) => any;
33
33
  onBeforeDestroy?: (swiper: import("swiper/types").Swiper) => void;
34
34
  onSlidesUpdated?: (swiper: import("swiper/types").Swiper) => void;
@@ -1,10 +1,13 @@
1
1
  import type { GridAutosizeOptions } from '@xh/hoist/cmp/grid';
2
- import { GridModel } from '@xh/hoist/cmp/grid';
2
+ import type { GridLikeModel } from '@xh/hoist/cmp/grid';
3
3
  import type { ButtonProps } from '@xh/hoist/mobile/cmp/button';
4
4
  import '@xh/hoist/mobile/register';
5
5
  export interface ColAutosizeButtonProps extends ButtonProps {
6
- /** GridModel to which this button should bind. Will find nearest in context if not provided. */
7
- gridModel?: GridModel;
6
+ /**
7
+ * GridModel, or a model wrapping one, to which this button should bind. Will find the
8
+ * nearest in context if not provided.
9
+ */
10
+ gridModel?: GridLikeModel;
8
11
  /** Options to override grid's default or configured autosize settings. */
9
12
  autosizeOptions?: Omit<GridAutosizeOptions, 'mode'>;
10
13
  }
@@ -1,9 +1,12 @@
1
- import { GridModel } from '@xh/hoist/cmp/grid';
1
+ import type { GridLikeModel } from '@xh/hoist/cmp/grid';
2
2
  import type { ButtonProps } from '@xh/hoist/mobile/cmp/button';
3
3
  import '@xh/hoist/mobile/register';
4
4
  export interface ColChooserButtonProps extends ButtonProps {
5
- /** GridModel to which this button should bind. Will find nearest in context if not provided. */
6
- gridModel?: GridModel;
5
+ /**
6
+ * GridModel, or a model wrapping one, to which this button should bind. Will find the
7
+ * nearest in context if not provided.
8
+ */
9
+ gridModel?: GridLikeModel;
7
10
  }
8
11
  /**
9
12
  * A convenience button to trigger the display of a ColChooser for user selection, discovery and
@@ -1,12 +1,12 @@
1
- import { GridModel } from '@xh/hoist/cmp/grid';
1
+ import type { GridLikeModel } from '@xh/hoist/cmp/grid';
2
2
  import type { ButtonProps } from '@xh/hoist/mobile/cmp/button';
3
3
  import '@xh/hoist/mobile/register';
4
4
  export interface ExpandCollapseButtonProps extends ButtonProps {
5
5
  /**
6
- * `GridModel` to which this button should bind.
7
- * Optional, will find nearest GridModel in context if not provided.
6
+ * GridModel, or a model wrapping one, to which this button should bind. Will find the
7
+ * nearest in context if not provided.
8
8
  */
9
- gridModel?: GridModel;
9
+ gridModel?: GridLikeModel;
10
10
  }
11
11
  /**
12
12
  * A convenience button to expand / collapse all rows in a grouped or tree Grid.
@@ -1,12 +1,12 @@
1
- import { GridModel } from '@xh/hoist/cmp/grid';
1
+ import type { GridLikeModel } from '@xh/hoist/cmp/grid';
2
2
  import '@xh/hoist/mobile/register';
3
3
  import type { MenuButtonProps } from '../../menu';
4
4
  export interface ExpandToLevelButtonProps extends MenuButtonProps {
5
5
  /**
6
- * `GridModel` to which this button should bind.
7
- * Optional, will find nearest GridModel in context if not provided.
6
+ * GridModel, or a model wrapping one, to which this button should bind. Will find the
7
+ * nearest in context if not provided.
8
8
  */
9
- gridModel?: GridModel;
9
+ gridModel?: GridLikeModel;
10
10
  }
11
11
  /**
12
12
  * A menu button to expand a multi-level grouped or tree grid out to a desired level.
@@ -0,0 +1,12 @@
1
+ import type { PdfViewerToolbarModel } from '@xh/hoist/cmp/pdfviewer/impl/PdfViewerToolbarModel';
2
+ import '@xh/hoist/mobile/register';
3
+ /**
4
+ * Mobile implementation of the PdfViewer toolbar.
5
+ *
6
+ * Note that this module is installed by the mobile AppContainer and must not import
7
+ * PdfViewerModel, even as a type. A runtime import would bring pdf.js into every app's build, and a
8
+ * type import would break `tsc` in apps without `pdfjs-dist`. See {@link PdfViewerToolbarModel}.
9
+ *
10
+ * @internal
11
+ */
12
+ export declare const pdfViewerToolbarImpl: import("@xh/hoist/core").ElementFactory<import("@xh/hoist/core").DefaultHoistProps<PdfViewerToolbarModel>>;
package/cmp/README.md CHANGED
@@ -149,6 +149,8 @@ techniques.
149
149
  | `/chart/` | Highcharts integration for data visualization |
150
150
  | `/treemap/` | Hierarchical treemap and split treemap visualizations |
151
151
  | `/zoneGrid/` | Multi-zone grid layout for complex record displays |
152
+ | `/cubegrid/` | Cube View as a tree grid, with pivot paths as nested column groups when pivoted. [See README](./cubegrid/README.md) |
153
+ | `/statcard/` | Tiles that call out key figures (StatCard), laid out in equal-width rows (StatCardStrip) |
152
154
 
153
155
  ### Layout and Containers
154
156
 
@@ -202,6 +204,7 @@ techniques.
202
204
  | `/clock/` | Real-time clock display |
203
205
  | `/error/` | Error boundary and error message display |
204
206
  | `/markdown/` | Markdown rendering component |
207
+ | `/pdfviewer/` | PDF document viewer built on pdf.js. [See README](./pdfviewer/README.md) |
205
208
  | `/pinpad/` | PIN entry interface |
206
209
  | `/relativetimestamp/` | Human-readable relative time display |
207
210
  | `/websocket/` | WebSocket indicator component |
@@ -10,7 +10,7 @@ import {createElement, hoistCmp, HoistModel, lookup, useLocalModel, uses, XH} fr
10
10
  import type {GridOptions} from '@xh/hoist/kit/ag-grid';
11
11
  import {AgGridReact} from '@xh/hoist/kit/ag-grid';
12
12
  import {logError} from '@xh/hoist/utils/js';
13
- import {splitLayoutProps} from '@xh/hoist/utils/react';
13
+ import {splitLayoutProps, useComposedRefs} from '@xh/hoist/utils/react';
14
14
  import classNames from 'classnames';
15
15
  import type {CSSProperties} from 'react';
16
16
  import './AgGrid.scss';
@@ -58,10 +58,11 @@ export const [AgGrid, agGrid] = hoistCmp.withFactory<AgGridProps>({
58
58
  } = model,
59
59
  {isDesktop} = XH;
60
60
 
61
- const impl = useLocalModel(AgGridLocalModel);
61
+ const impl = useLocalModel(AgGridLocalModel),
62
+ frameRef = useComposedRefs(ref, impl.wheelAxisLockRef);
62
63
 
63
64
  return frame({
64
- ref,
65
+ ref: frameRef,
65
66
  style: {
66
67
  '--ag-row-height': `${impl.rowHeight}px`,
67
68
  '--ag-header-height': `${impl.headerHeight}px`
@@ -166,6 +167,27 @@ class AgGridLocalModel extends HoistModel {
166
167
  ? AgGridCmp.getGroupRowHeightForSizingMode(this.model.sizingMode)
167
168
  : this.rowHeight;
168
169
 
170
+ // Lock each wheel event to its dominant axis, to stop trackpad gestures scrolling diagonally.
171
+ // Remove once fixed upstream - https://github.com/ag-grid/ag-grid/issues/15905
172
+ wheelAxisLockRef = (el: HTMLElement) => {
173
+ if (!el) return;
174
+ el.addEventListener('wheel', this.onWheel, {passive: false});
175
+ return () => el.removeEventListener('wheel', this.onWheel);
176
+ };
177
+
178
+ private onWheel = (e: WheelEvent) => {
179
+ const {deltaX, deltaY, deltaMode, ctrlKey, defaultPrevented, currentTarget, target} = e;
180
+ if (!deltaX || !deltaY || deltaMode || ctrlKey || defaultPrevented) return;
181
+
182
+ const viewport = (target as Element).closest?.('.ag-grid-viewport');
183
+ if (!viewport || !(currentTarget as Element).contains(viewport)) return;
184
+
185
+ e.preventDefault();
186
+ Math.abs(deltaX) > Math.abs(deltaY)
187
+ ? viewport.scrollBy({left: deltaX})
188
+ : viewport.scrollBy({top: deltaY});
189
+ };
190
+
169
191
  noteGridReady = agParams => {
170
192
  this.model.handleGridReady(agParams);
171
193
  this.componentProps.onGridReady?.(agParams);
@@ -0,0 +1,60 @@
1
+ /*
2
+ * This file belongs to Hoist, an application development toolkit
3
+ * developed by Extremely Heavy Industries (www.xh.io | info@xh.io)
4
+ *
5
+ * Copyright © 2026 Extremely Heavy Industries Inc.
6
+ */
7
+ import {errorMessage} from '@xh/hoist/cmp/error';
8
+ import {grid} from '@xh/hoist/cmp/grid';
9
+ import type {HoistProps, LayoutProps, TestSupportProps} from '@xh/hoist/core';
10
+ import {hoistCmp, uses} from '@xh/hoist/core';
11
+ import type {GridOptions} from '@xh/hoist/kit/ag-grid';
12
+ import {splitLayoutProps} from '@xh/hoist/utils/react';
13
+ import {CubeGridModel} from './CubeGridModel';
14
+
15
+ export interface CubeGridProps<M extends CubeGridModel = CubeGridModel>
16
+ extends HoistProps<M>, LayoutProps, TestSupportProps {
17
+ /**
18
+ * Options for ag-Grid's API.
19
+ *
20
+ * This constitutes an 'escape hatch' for applications that need to get to the underlying
21
+ * ag-Grid API. It should be used with care. Settings made here might be overwritten and/or
22
+ * interfere with the implementation of this component and its use of the ag-Grid API.
23
+ *
24
+ * Note that changes to these options after the component's initial render will be ignored.
25
+ */
26
+ agOptions?: GridOptions;
27
+ }
28
+
29
+ /**
30
+ * A CubeGrid is a specialized version of the Grid component, bound to a Cube View.
31
+ *
32
+ * It displays group rows down a tree column with the app's columns and, when the view's query
33
+ * pivots, pivot paths across nested column groups with optional docked summaries. See
34
+ * {@link CubeGridModel} for its configuration.
35
+ *
36
+ * While the view declines its data - see {@link ViewResult.exception} - an {@link ErrorMessage}
37
+ * renders in place of the grid.
38
+ */
39
+ export const [CubeGrid, cubeGrid] = hoistCmp.withFactory<CubeGridProps>({
40
+ displayName: 'CubeGrid',
41
+ model: uses(CubeGridModel),
42
+ className: 'xh-cube-grid',
43
+
44
+ render({model, className, testId, ...props}, ref) {
45
+ const [layoutProps] = splitLayoutProps(props),
46
+ {exception} = model.view.result;
47
+
48
+ if (exception)
49
+ return errorMessage({...layoutProps, className, testId, ref, error: exception});
50
+
51
+ return grid({
52
+ ...layoutProps,
53
+ className,
54
+ testId,
55
+ ref,
56
+ model: model.gridModel,
57
+ agOptions: props.agOptions
58
+ });
59
+ }
60
+ });