playbook_ui 15.3.0.pre.alpha.play249512047 → 15.3.0.pre.alpha.play262912095

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 (33) hide show
  1. checksums.yaml +4 -4
  2. data/app/pb_kits/playbook/pb_advanced_table/Components/RegularTableView.tsx +2 -1
  3. data/app/pb_kits/playbook/pb_advanced_table/Utilities/RowUtils.ts +1 -1
  4. data/app/pb_kits/playbook/pb_advanced_table/_advanced_table.scss +4 -4
  5. data/app/pb_kits/playbook/pb_advanced_table/advanced_table.test.jsx +68 -5
  6. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_background_control_rails.html.erb +4 -0
  7. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_background_control_rails.md +1 -1
  8. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_column_styling.jsx +3 -1
  9. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_column_styling.md +2 -0
  10. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_column_styling_column_headers.jsx +1 -1
  11. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_column_styling_rails.html.erb +1 -0
  12. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_column_styling_rails.md +2 -0
  13. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_padding_control.jsx +9 -1
  14. data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_padding_control.md +1 -1
  15. data/app/pb_kits/playbook/pb_advanced_table/flat_advanced_table.js +2 -2
  16. data/app/pb_kits/playbook/pb_advanced_table/index.js +7 -7
  17. data/app/pb_kits/playbook/pb_advanced_table/scss_partials/advanced_table_sticky_mixin.scss +2 -2
  18. data/app/pb_kits/playbook/pb_advanced_table/table_row.rb +32 -3
  19. data/app/pb_kits/playbook/pb_background/background.html.erb +10 -2
  20. data/app/pb_kits/playbook/pb_currency/_currency.tsx +20 -7
  21. data/app/pb_kits/playbook/pb_currency/currency.rb +35 -8
  22. data/app/pb_kits/playbook/pb_currency/currency.test.js +47 -0
  23. data/app/pb_kits/playbook/pb_currency/docs/_currency_variants.html.erb +1 -1
  24. data/app/pb_kits/playbook/pb_currency/docs/_currency_variants.jsx +1 -1
  25. data/app/pb_kits/playbook/pb_currency/docs/_currency_variants.md +1 -0
  26. data/app/pb_kits/playbook/pb_date_picker/date_picker.html.erb +11 -25
  27. data/dist/chunks/{_weekday_stacked-BFB3mjtE.js → _weekday_stacked-W1kKx2Gl.js} +1 -1
  28. data/dist/chunks/vendor.js +1 -1
  29. data/dist/playbook-doc.js +1 -1
  30. data/dist/playbook-rails.js +1 -1
  31. data/dist/playbook.css +1 -1
  32. data/lib/playbook/version.rb +1 -1
  33. metadata +4 -3
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 89525b2c53030f64515954ae6f1badd973e456e2f2549d5f921de84530f6880c
4
- data.tar.gz: 5b2f3e1c9daaef48d3b3c3286c9aaa2a081be42e1a86e11b066c1e7a8a153ddb
3
+ metadata.gz: 1421a383b2bc47999a9d91bd809be646df02ba56985ea34c30c1a86a91a0b778
4
+ data.tar.gz: eb79f292c2cccef9214abc3ff25b40cd3d77f6045230ac74717179584c917dcf
5
5
  SHA512:
6
- metadata.gz: 6fb5b48ffb1b6074b075de87f296ee4c1b9d994335b0d4578c87e5c3697f0814e6e15e35edf8a70f883fb0aaf653b3fd4801486134d59341ae8386056d20c26a
7
- data.tar.gz: 67de52130ab150e6b370f639ad9ed26a787d6c891630a5134a7459392c2d1e1be2c5ec8a5f5da5484ee4a038a23c89ffdea516635d973f6812004aadcae29edf
6
+ metadata.gz: ff3c9ce78d4d2364931c6213568080685aba5c15cc7365badd40e1a712a30fa9e6195c9ead12462bd3c9659b65eff7b418d02490052baede10ad673c6dba1ef4
7
+ data.tar.gz: f95f7db7d8d7682079a05e6e66de4bf0e025eb7e3d4df6dc2158896fd5f49881604721be7a0bb6c33dd0cb28a6cbc88a60e22a82e997fc6d80cbb337ab7d0a76
@@ -66,6 +66,7 @@ const TableCellRenderer = ({
66
66
  // Find the “owning” colDefinition by accessor. Needed for multi column logic
67
67
  const colDef = findColumnDefByAccessor(columnDefinitions ?? [], column.id)
68
68
  const cellAlignment = colDef?.columnStyling?.cellAlignment ?? "right"
69
+ const cellFontColor = colDef?.columnStyling?.fontColor
69
70
  const paddingValue = colDef?.columnStyling?.cellPadding ?? customRowStyle?.cellPadding
70
71
  const paddingClass = paddingValue ? `p_${paddingValue}` : undefined
71
72
 
@@ -88,7 +89,7 @@ const TableCellRenderer = ({
88
89
  : `${column.getStart("left")}px`
89
90
  : undefined,
90
91
  backgroundColor: i === 0 && customRowStyle?.backgroundColor,
91
- color: customRowStyle?.fontColor,
92
+ color: cellFontColor || customRowStyle?.fontColor,
92
93
  }}
93
94
  >
94
95
  {collapsibleTrail && i === 0 && row.depth > 0 && renderCollapsibleTrail(row.depth)}
@@ -17,7 +17,7 @@ export const getRowColorClass = (
17
17
  (inlineRowLoading && (rowHasNoChildren || row.getCanExpand()))
18
18
  );
19
19
 
20
- return row.getIsSelected() ? "bg-row-selection" : shouldShowExpandedBackground ? "bg-silver" : "bg-white";
20
+ return row.getIsSelected() ? "bg-row-selection" : shouldShowExpandedBackground ? "bg-silver" : "pb-bg-row-white";
21
21
  }
22
22
 
23
23
  /**
@@ -51,7 +51,7 @@
51
51
  background-color: lighten($silver, $opacity_7);
52
52
  }
53
53
 
54
- .bg-white {
54
+ .pb-bg-row-white {
55
55
  background-color: $white;
56
56
  }
57
57
 
@@ -278,7 +278,7 @@
278
278
  }
279
279
  }
280
280
 
281
- &.bg-white {
281
+ &.pb-bg-row-white {
282
282
  td:first-child {
283
283
  background-color: $white;
284
284
  }
@@ -756,7 +756,7 @@
756
756
  border-bottom-color: $border_dark !important;
757
757
  }
758
758
 
759
- .bg-white {
759
+ .pb-bg-row-white {
760
760
  background: $bg_dark_card;
761
761
  }
762
762
 
@@ -766,7 +766,7 @@
766
766
 
767
767
  // Dark mode virtualized rows
768
768
  .virtualized-table-row {
769
- &.bg-white {
769
+ &.pb-bg-row-white {
770
770
  background: $bg_dark_card !important;
771
771
 
772
772
  td:first-child {
@@ -308,10 +308,10 @@ test("Row toggle button exists and toggles subrows open and closed", () => {
308
308
  const kit = screen.getByTestId(testId)
309
309
  const rowButton = kit.querySelector(".gray-icon.expand-toggle-icon")
310
310
  expect(rowButton).toBeInTheDocument()
311
- const subRow1 = kit.querySelector(".bg-white.depth-sub-row-1")
311
+ const subRow1 = kit.querySelector(".pb-bg-row-white.depth-sub-row-1")
312
312
  expect(subRow1).not.toBeInTheDocument()
313
313
  rowButton.click()
314
- const subRow = kit.querySelector(".bg-white.depth-sub-row-1")
314
+ const subRow = kit.querySelector(".pb-bg-row-white.depth-sub-row-1")
315
315
  expect(subRow).toBeInTheDocument()
316
316
  })
317
317
 
@@ -328,13 +328,13 @@ test("toggleExpansionAll button exists and toggles subrows open and closed", asy
328
328
  const toggleButton = kit.querySelector(".gray-icon.toggle-all-icon");
329
329
  expect(toggleButton).toBeInTheDocument();
330
330
 
331
- const subRow1 = kit.querySelector(".bg-white.depth-sub-row-1");
331
+ const subRow1 = kit.querySelector(".pb-bg-row-white.depth-sub-row-1");
332
332
  expect(subRow1).not.toBeInTheDocument();
333
333
 
334
334
  toggleButton.click();
335
335
 
336
336
  await waitFor(() => {
337
- const subRow = kit.querySelector(".bg-white.depth-sub-row-1");
337
+ const subRow = kit.querySelector(".pb-bg-row-white.depth-sub-row-1");
338
338
  expect(subRow).toBeInTheDocument();
339
339
  })
340
340
  })
@@ -385,7 +385,7 @@ test("expandControl prop works as expected", () => {
385
385
  render (<AdvancedTableExpandControl/>)
386
386
 
387
387
  const kit = screen.getByTestId(testId)
388
- const subRow = kit.querySelector(".bg-white.depth-sub-row-1")
388
+ const subRow = kit.querySelector(".pb-bg-row-white.depth-sub-row-1")
389
389
  expect(subRow).toBeInTheDocument()
390
390
  })
391
391
 
@@ -740,6 +740,69 @@ test("columnStyling.cellPadding sets cell padding", () => {
740
740
  expect(firstEnrollmentCell).toHaveClass('p_none')
741
741
  });
742
742
 
743
+ test("columnStyling.fontColor sets cell font color", () => {
744
+ const styledColumnDefs = [
745
+ {
746
+ accessor: "year",
747
+ label: "Year",
748
+ cellAccessors: ["quarter", "month", "day"],
749
+ },
750
+ {
751
+ accessor: "newEnrollments",
752
+ label: "New Enrollments",
753
+ columnStyling: { fontColor: colors.category_1 },
754
+ },
755
+ {
756
+ accessor: "scheduledMeetings",
757
+ label: "Scheduled Meetings",
758
+ },
759
+ ];
760
+
761
+ render(
762
+ <AdvancedTable
763
+ columnDefinitions={styledColumnDefs}
764
+ data={{ testid: testId }}
765
+ tableData={MOCK_DATA}
766
+ />
767
+ );
768
+
769
+ const firstEnrollmentCell = screen.getAllByText("20")[0].closest("td");
770
+ expect(firstEnrollmentCell).toHaveStyle({ color: colors.category_1 });
771
+ });
772
+
773
+ test("columnStyling.fontColor works with background color", () => {
774
+ const styledColumnDefs = [
775
+ {
776
+ accessor: "year",
777
+ label: "Year",
778
+ cellAccessors: ["quarter", "month", "day"],
779
+ },
780
+ {
781
+ accessor: "newEnrollments",
782
+ label: "New Enrollments",
783
+ columnStyling: {
784
+ cellBackgroundColor: (row) => row.newEnrollments > 20 ? "success_secondary" : "warning_secondary",
785
+ fontColor: colors.white
786
+ },
787
+ },
788
+ {
789
+ accessor: "scheduledMeetings",
790
+ label: "Scheduled Meetings",
791
+ },
792
+ ];
793
+
794
+ render(
795
+ <AdvancedTable
796
+ columnDefinitions={styledColumnDefs}
797
+ data={{ testid: testId }}
798
+ tableData={MOCK_DATA}
799
+ />
800
+ );
801
+
802
+ const firstEnrollmentCell = screen.getAllByText("20")[0].closest("td");
803
+ expect(firstEnrollmentCell).toHaveStyle({ color: colors.white });
804
+ });
805
+
743
806
  test("renders virtualized table rows and header", () => {
744
807
  render(
745
808
  <AdvancedTable
@@ -26,6 +26,10 @@
26
26
  {
27
27
  accessor: "classCompletionRate",
28
28
  label: "Class Completion Rate",
29
+ column_styling: {
30
+ cell_background_color: "category_1",
31
+ font_color: "white"
32
+ }
29
33
  },
30
34
  {
31
35
  accessor: "graduatedStudents",
@@ -1 +1 @@
1
- `column_styling` can also be used to control the background color on all cells in a given column via the use of the `cell_background_color` key/value pair. Use `cell_background_color` to achieve custom background colors for individual cells as seen here.
1
+ `column_styling` can also be used to control the background color on all cells in a given column via the use of the `cell_background_color` key/value pair. Use `cell_background_color` to achieve custom background colors for individual cells as seen here. Use `font_color` to achieve better contrast between cell content and background for darker backgrounds.
@@ -1,7 +1,8 @@
1
1
  import React from "react"
2
- import AdvancedTable from '../../pb_advanced_table/_advanced_table'
2
+ import { AdvancedTable, colors } from "playbook-ui"
3
3
  import MOCK_DATA from "./advanced_table_mock_data.json"
4
4
 
5
+
5
6
  const AdvancedTableColumnStyling = (props) => {
6
7
  const columnDefinitions = [
7
8
  {
@@ -34,6 +35,7 @@ const AdvancedTableColumnStyling = (props) => {
34
35
  {
35
36
  accessor: "graduatedStudents",
36
37
  label: "Graduated Students",
38
+ columnStyling:{fontColor: colors.data_8},
37
39
  },
38
40
  ]
39
41
 
@@ -4,4 +4,6 @@ The `columnStyling` prop is an optional item that can be used within `columnDefi
4
4
 
5
5
  2) `cellAlignment`: This will allow you to control alignment of content within all cells in the given column. This is set to right aligned by default. you can set this to `left`, `right` or `center`.
6
6
 
7
+ 3) `fontColor`: This will allow you to control the font color for a given column.
8
+
7
9
  `columnStyling` can be used within the columnDefinition of all the columns or some of them, as shown. Each column has its own individual control in this way.
@@ -1,5 +1,5 @@
1
1
  import React from "react";
2
- import AdvancedTable from '../../pb_advanced_table/_advanced_table';
2
+ import { AdvancedTable } from "playbook-ui";
3
3
  import MOCK_DATA from "./advanced_table_mock_data.json";
4
4
 
5
5
  const AdvancedTableColumnStylingColumnHeaders = (props) => {
@@ -29,6 +29,7 @@
29
29
  {
30
30
  accessor: "graduatedStudents",
31
31
  label: "Graduated Students",
32
+ column_styling: { font_color: "red" }
32
33
  }
33
34
  ] %>
34
35
 
@@ -4,4 +4,6 @@ The `column_styling` prop is an optional item that can be used within `column_de
4
4
 
5
5
  2) `cell_alignment`: This will allow you to control alignment of content within all cells in the given column. This is set to right aligned by default. you can set this to `left`, `right` or `center`.
6
6
 
7
+ 3) `font_color`: This will allow you to control the font color for a given column.
8
+
7
9
  `column_styling` can be used within the column_definition of all the columns or some of them, as shown. Each column has its own individual control in this way.
@@ -22,7 +22,6 @@ const AdvancedTablePaddingControl = (props) => {
22
22
  {value}
23
23
  </Background>
24
24
  ),
25
-
26
25
  },
27
26
  {
28
27
  accessor: "scheduledMeetings",
@@ -39,6 +38,15 @@ const AdvancedTablePaddingControl = (props) => {
39
38
  {
40
39
  accessor: "classCompletionRate",
41
40
  label: "Class Completion Rate",
41
+ columnStyling:{cellPadding: "none", fontColor: "white"},
42
+ customRenderer: (row, value) => (
43
+ <Background
44
+ backgroundColor={"category_1"}
45
+ padding="xs"
46
+ >
47
+ {value}
48
+ </Background>
49
+ ),
42
50
  },
43
51
  {
44
52
  accessor: "graduatedStudents",
@@ -1,3 +1,3 @@
1
1
  `columnStyling` can also be used to control padding on all cells in a given column via the use of the `cellPadding` key/value pair. `cellPadding` lets you use 'xxs', 'xs', 'sm', 'md', 'lg', 'xl' and 'none'.
2
2
 
3
- This control can be used in conjunction with the `customRenderer` item within each columnDefinition to achieve custom background colors for individual cells as seen here.
3
+ This control can be used in conjunction with the `customRenderer` item within each columnDefinition to achieve custom background colors for individual cells as seen here. Use `fontColor` to achieve better contrast between cell content and background for darker backgrounds.
@@ -51,7 +51,7 @@ export default class PbFlatAdvancedTable extends PbEnhancedElement {
51
51
 
52
52
  const tr = rowCb.closest("tr");
53
53
  tr?.classList.toggle("bg-row-selection", rowCb.checked);
54
- tr?.classList.toggle("bg-white", !rowCb.checked);
54
+ tr?.classList.toggle("pb-bg-row-white", !rowCb.checked);
55
55
  }
56
56
 
57
57
  if (allCb) {
@@ -62,7 +62,7 @@ export default class PbFlatAdvancedTable extends PbEnhancedElement {
62
62
  cb.checked = checked;
63
63
  const tr = cb.closest("tr");
64
64
  tr?.classList.toggle("bg-row-selection", checked);
65
- tr?.classList.toggle("bg-white", !checked);
65
+ tr?.classList.toggle("pb-bg-row-white", !checked);
66
66
  const id = cb.id;
67
67
  if (checked) this.selectedRows.add(id);
68
68
  else this.selectedRows.delete(id);
@@ -76,7 +76,7 @@ export default class PbAdvancedTable extends PbEnhancedElement {
76
76
  // Only apply styling if the checkbox is inside a table row
77
77
  if (rowEl) {
78
78
  rowEl.classList.add("bg-row-selection");
79
- rowEl.classList.remove("bg-white", "bg-silver");
79
+ rowEl.classList.remove("pb-bg-row-white", "bg-silver");
80
80
  }
81
81
  } else {
82
82
  // Only apply styling if the checkbox is inside a table row
@@ -85,9 +85,9 @@ export default class PbAdvancedTable extends PbEnhancedElement {
85
85
 
86
86
  if (this.isRowExpanded(rowEl)) {
87
87
  rowEl.classList.remove("bg-silver");
88
- rowEl.classList.add("bg-white");
88
+ rowEl.classList.add("pb-bg-row-white");
89
89
  } else {
90
- rowEl.classList.remove("bg-white");
90
+ rowEl.classList.remove("pb-bg-row-white");
91
91
  rowEl.classList.add("bg-silver");
92
92
  }
93
93
  }
@@ -120,7 +120,7 @@ export default class PbAdvancedTable extends PbEnhancedElement {
120
120
  if (isChecked) {
121
121
  PbAdvancedTable.selectedRows.add(rowId);
122
122
  rowEl.classList.add("bg-row-selection");
123
- rowEl.classList.remove("bg-white", "bg-silver");
123
+ rowEl.classList.remove("pb-bg-row-white", "bg-silver");
124
124
  } else {
125
125
  PbAdvancedTable.selectedRows.delete(rowId);
126
126
  }
@@ -130,9 +130,9 @@ export default class PbAdvancedTable extends PbEnhancedElement {
130
130
 
131
131
  if (this.isRowExpanded(rowEl)) {
132
132
  rowEl.classList.remove("bg-silver");
133
- rowEl.classList.add("bg-white");
133
+ rowEl.classList.add("pb-bg-row-white");
134
134
  } else {
135
- rowEl.classList.remove("bg-white");
135
+ rowEl.classList.remove("pb-bg-row-white");
136
136
  rowEl.classList.add("bg-silver");
137
137
  }
138
138
  }
@@ -407,7 +407,7 @@ export default class PbAdvancedTable extends PbEnhancedElement {
407
407
  const row = this.element.closest("tr");
408
408
  if (row) {
409
409
  row.classList.toggle("bg-silver", !isVisible);
410
- row.classList.toggle("bg-white", isVisible);
410
+ row.classList.toggle("pb-bg-row-white", isVisible);
411
411
  }
412
412
 
413
413
  this.addBorderRadiusOnLastVisibleRow();
@@ -52,7 +52,7 @@
52
52
  }
53
53
  }
54
54
 
55
- .bg-white {
55
+ .pb-bg-row-white {
56
56
  td:first-child,
57
57
  .sticky-left {
58
58
  background-color: $bg-main;
@@ -63,7 +63,7 @@
63
63
  &.bg-silver td:first-child {
64
64
  background-color: $bg-secondary;
65
65
  }
66
- &.bg-white td:first-child {
66
+ &.pb-bg-row-white td:first-child {
67
67
  background-color: $bg-main;
68
68
  }
69
69
  &.bg-row-selection td:first-child {
@@ -39,7 +39,7 @@ module Playbook
39
39
  end
40
40
 
41
41
  def classname
42
- generate_classname("pb_table_tr", "bg-white", subrow_depth_classname, separator: " ")
42
+ generate_classname("pb_table_tr", "pb-bg-row-white", subrow_depth_classname, separator: " ")
43
43
  end
44
44
 
45
45
  def td_classname(column, index)
@@ -79,15 +79,44 @@ module Playbook
79
79
  cell_background_color(column).present?
80
80
  end
81
81
 
82
+ def cell_font_color(column)
83
+ return nil unless column[:accessor].present?
84
+
85
+ orig_def = find_column_def_by_accessor(column_definitions, column[:accessor])
86
+ if orig_def && orig_def[:column_styling].is_a?(Hash) && orig_def[:column_styling][:font_color].present?
87
+ font_color = orig_def[:column_styling][:font_color]
88
+ if font_color.respond_to?(:call)
89
+ font_color.call(row)
90
+ else
91
+ font_color
92
+ end
93
+ end
94
+ end
95
+
82
96
  # Uses a regular table/table_cell component if there is no custom background color; if there is a cell_background_color uses a background component with tag "td"
83
97
  def cell_component_info(column, index, bg_color, font_color)
98
+ column_font_color = cell_font_color(column)
99
+ effective_font_color = column_font_color || font_color
100
+
84
101
  if has_custom_background_color?(column)
85
102
  custom_bg_color = cell_background_color(column)
86
103
  component_name = "background"
87
- component_props = { background_color: custom_bg_color, tag: "td", classname: td_classname(column, index) }
104
+ component_props = {
105
+ background_color: custom_bg_color,
106
+ tag: "td",
107
+ classname: td_classname(column, index),
108
+ }
109
+ component_props[:html_options] = { style: { color: effective_font_color } } if effective_font_color.present?
88
110
  else
89
111
  component_name = "table/table_cell"
90
- component_props = { html_options: { style: { "background-color": bg_color, color: font_color } }, classname: td_classname(column, index) }
112
+ style_hash = { "background-color": bg_color }
113
+ style_hash[:color] = effective_font_color if effective_font_color.present?
114
+ component_props = {
115
+ html_options: {
116
+ style: style_hash,
117
+ },
118
+ classname: td_classname(column, index),
119
+ }
91
120
  end
92
121
 
93
122
  { name: component_name, props: component_props }
@@ -1,3 +1,11 @@
1
+ <%
2
+ html_options_style = ""
3
+ if object.html_options[:style].is_a?(Hash)
4
+ html_options_style = object.html_options[:style].map { |k, v| "#{k.to_s.tr('_', '-')}: #{v}" }.join("; ")
5
+ elsif object.html_options[:style].is_a?(String)
6
+ html_options_style = object.html_options[:style]
7
+ end
8
+ %>
1
9
  <% if object.image_url.present? %>
2
10
  <%= pb_content_tag(object.tag,
3
11
  style: "background-image: url('#{object.image_url}');
@@ -9,8 +17,8 @@
9
17
  <% end %>
10
18
  <% else %>
11
19
  <%= pb_content_tag(object.tag,
12
- style: object.custom_background_color
20
+ style: "#{object.custom_background_color}#{html_options_style.present? ? "; #{html_options_style}" : ""}"
13
21
  ) do %>
14
22
  <%= content.presence %>
15
23
  <% end %>
16
- <% end %>
24
+ <% end %>
@@ -11,7 +11,7 @@ import Title from '../pb_title/_title'
11
11
  type CurrencyProps = {
12
12
  abbreviate?: boolean,
13
13
  align?: 'center' | 'left' | 'right',
14
- amount: string,
14
+ amount: string | number,
15
15
  aria?: {[key:string]:string},
16
16
  className?: string,
17
17
  dark?: boolean,
@@ -59,6 +59,19 @@ const Currency = (props: CurrencyProps): React.ReactElement => {
59
59
  commaSeparator = false,
60
60
  } = props
61
61
 
62
+ // Convert numeric input to string format
63
+ const convertAmount = (input: string | number): string => {
64
+ if (typeof input === 'number') {
65
+ if (input === 0 && !nullDisplay) {
66
+ return ""
67
+ }
68
+ return input.toFixed(2)
69
+ }
70
+ return input
71
+ }
72
+
73
+ const currencyAmount = convertAmount(amount)
74
+
62
75
  const emphasizedClass = emphasized ? '' : '_deemphasized'
63
76
 
64
77
  let variantClass
@@ -68,7 +81,7 @@ const Currency = (props: CurrencyProps): React.ReactElement => {
68
81
  variantClass = '_bold'
69
82
  }
70
83
 
71
- const [whole, decimal = '00'] = amount.split('.')
84
+ const [whole, decimal = '00'] = currencyAmount.split('.')
72
85
  const ariaProps = buildAriaProps(aria)
73
86
  const dataProps = buildDataProps(data)
74
87
  const htmlProps = buildHtmlProps(htmlOptions)
@@ -92,19 +105,19 @@ const Currency = (props: CurrencyProps): React.ReactElement => {
92
105
  return isAmount ? num.slice(0, -1) : isUnit ? num.slice(-1) : ''
93
106
  }
94
107
 
95
- const getMatchingDecimalAmount = decimals === "matching" ? amount : whole
108
+ const getMatchingDecimalAmount = decimals === "matching" ? currencyAmount : whole
96
109
  const getMatchingDecimalValue = decimals === "matching" ? '' : `.${decimal}`
97
110
 
98
111
  const formatAmount = (amount: string) => {
99
112
  if (!commaSeparator) return amount;
100
-
113
+
101
114
  const [wholePart, decimalPart] = amount.split('.');
102
115
  const formattedWhole = new Intl.NumberFormat('en-US').format(parseInt(wholePart));
103
116
  return decimalPart ? `${formattedWhole}.${decimalPart}` : formattedWhole;
104
117
  }
105
118
 
106
119
  const swapNegative = size === "sm" && symbol !== ""
107
- const handleNegative = amount.startsWith("-") && swapNegative ? "-" : ""
120
+ const handleNegative = currencyAmount.startsWith("-") && swapNegative ? "-" : ""
108
121
  const getAbsoluteAmount = (amountString: string) => amountString.replace(/^-/,'')
109
122
  const getAbbrOrFormatAmount = abbreviate ? getAbbreviatedValue('amount') : formatAmount(getMatchingDecimalAmount)
110
123
  const getAmount = swapNegative ? getAbsoluteAmount(getAbbrOrFormatAmount) : getAbbrOrFormatAmount
@@ -152,7 +165,7 @@ const Currency = (props: CurrencyProps): React.ReactElement => {
152
165
  >
153
166
  {handleNegative}{symbol}
154
167
  </Body>
155
-
168
+
156
169
  <Title
157
170
  className="pb_currency_value"
158
171
  dark={dark}
@@ -160,7 +173,7 @@ const Currency = (props: CurrencyProps): React.ReactElement => {
160
173
  >
161
174
  {getAmount}
162
175
  </Title>
163
-
176
+
164
177
  <Body
165
178
  className="unit"
166
179
  color="light"
@@ -17,8 +17,7 @@ module Playbook
17
17
  prop :symbol, type: Playbook::Props::String,
18
18
  default: "$"
19
19
 
20
- prop :amount, type: Playbook::Props::String,
21
- required: true
20
+ prop :amount, required: true
22
21
 
23
22
  prop :unit, type: Playbook::Props::String,
24
23
  required: false
@@ -92,7 +91,7 @@ module Playbook
92
91
  end
93
92
 
94
93
  def negative_sign
95
- amount.starts_with?("-") && swap_negative ? "-" : ""
94
+ currency_amount.starts_with?("-") && swap_negative ? "-" : ""
96
95
  end
97
96
 
98
97
  def body_props
@@ -117,10 +116,32 @@ module Playbook
117
116
  end
118
117
  end
119
118
 
119
+ def currency_amount
120
+ @currency_amount ||= convert_amount(amount)
121
+ end
122
+
120
123
  private
121
124
 
125
+ # Convert numeric input to string format
126
+ def convert_amount(input)
127
+ if input.is_a?(Numeric)
128
+ if input.zero? && null_display.nil?
129
+ ""
130
+ else
131
+ format("%.2f", input)
132
+ end
133
+ # Handle string representations of zero
134
+ elsif input.to_s.strip.match?(/^-?0+(\.0+)?$/) && null_display.nil?
135
+ ""
136
+ else
137
+ input.to_s
138
+ end
139
+ end
140
+
122
141
  def whole_value
123
- value = amount.split(".").first
142
+ return "" if currency_amount.blank?
143
+
144
+ value = currency_amount.split(".").first
124
145
  if comma_separator
125
146
  number_with_delimiter(value.gsub(",", ""))
126
147
  else
@@ -129,7 +150,9 @@ module Playbook
129
150
  end
130
151
 
131
152
  def decimal_value
132
- amount.split(".")[1] || "00"
153
+ return "00" if currency_amount.blank?
154
+
155
+ currency_amount.split(".")[1] || "00"
133
156
  end
134
157
 
135
158
  def units_element
@@ -147,7 +170,9 @@ module Playbook
147
170
  end
148
171
 
149
172
  def abbreviated_value(index = 0..-2)
150
- value = amount.split(".").first.gsub(",", "").to_i
173
+ return "" if currency_amount.blank?
174
+
175
+ value = currency_amount.split(".").first.gsub(",", "").to_i
151
176
  abbreviated_num = number_to_human(value, units: { thousand: "K", million: "M", billion: "B", trillion: "T" }).gsub(/\s+/, "")
152
177
  abbreviated_num[index]
153
178
  end
@@ -174,9 +199,11 @@ module Playbook
174
199
 
175
200
  if decimals == "matching"
176
201
  if comma_separator
177
- number_with_delimiter(amount.gsub(",", ""))
202
+ return "" if currency_amount.blank?
203
+
204
+ number_with_delimiter(currency_amount.gsub(",", ""))
178
205
  else
179
- amount
206
+ currency_amount
180
207
  end
181
208
  else
182
209
  whole_value
@@ -133,3 +133,50 @@ test('handles negative amounts correctly', () => {
133
133
  expect(screen.getByTestId('test-negative-no-symbol')).toHaveTextContent('-400.50')
134
134
  expect(screen.getByTestId('test-negative-medium-size')).toHaveTextContent('$-500.55')
135
135
  })
136
+
137
+ test('handles numeric amounts correctly', () => {
138
+ render(
139
+ <>
140
+ <Currency
141
+ amount={320}
142
+ data={{ testid: 'test-numeric-default' }}
143
+ />
144
+ <Currency
145
+ abbreviate
146
+ amount={3200000}
147
+ data={{ testid: 'test-numeric-millions' }}
148
+ />
149
+ <Currency
150
+ amount={123456.78}
151
+ commaSeparator
152
+ data={{ testid: 'test-numeric-comma-decimals' }}
153
+ />
154
+ <Currency
155
+ amount={400.50}
156
+ data={{ testid: 'test-numeric-no-symbol' }}
157
+ symbol=""
158
+ />
159
+ <Currency
160
+ amount={500.55}
161
+ data={{ testid: 'test-numeric-medium-size' }}
162
+ size="md"
163
+ />
164
+ <Currency
165
+ amount={-600.70}
166
+ data={{ testid: 'test-numeric-negative' }}
167
+ />
168
+ <Currency
169
+ amount={0.00}
170
+ data={{ testid: 'test-numeric-null' }}
171
+ />
172
+ </>
173
+ )
174
+
175
+ expect(screen.getByTestId('test-numeric-default')).toHaveTextContent('$320')
176
+ expect(screen.getByTestId('test-numeric-millions')).toHaveTextContent('$3.2M')
177
+ expect(screen.getByTestId('test-numeric-comma-decimals')).toHaveTextContent('$123,456.78')
178
+ expect(screen.getByTestId('test-numeric-no-symbol')).toHaveTextContent('400.50')
179
+ expect(screen.getByTestId('test-numeric-medium-size')).toHaveTextContent('$500.55')
180
+ expect(screen.getByTestId('test-numeric-negative')).toHaveTextContent('-$600.70')
181
+ expect(screen.getByTestId('test-numeric-null')).toHaveTextContent('$.00')
182
+ })