@terreno/ui 57.9.0 → 57.11.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 (181) hide show
  1. package/LICENSE +1 -0
  2. package/README.md +2 -0
  3. package/dist/Button.d.ts.map +1 -1
  4. package/dist/Button.js +20 -5
  5. package/dist/Button.js.map +1 -1
  6. package/dist/Common.d.ts +74 -1
  7. package/dist/Common.d.ts.map +1 -1
  8. package/dist/Common.js.map +1 -1
  9. package/dist/DataTable.js +1 -1
  10. package/dist/DataTable.js.map +1 -1
  11. package/dist/DateTimeActionSheet.js +1 -1
  12. package/dist/DateTimeActionSheet.js.map +1 -1
  13. package/dist/DateTimeField.d.ts.map +1 -1
  14. package/dist/DateTimeField.js +91 -18
  15. package/dist/DateTimeField.js.map +1 -1
  16. package/dist/FilePickerButton.d.ts +15 -1
  17. package/dist/FilePickerButton.d.ts.map +1 -1
  18. package/dist/FilePickerButton.js +26 -9
  19. package/dist/FilePickerButton.js.map +1 -1
  20. package/dist/GPTChat.d.ts +57 -1
  21. package/dist/GPTChat.d.ts.map +1 -1
  22. package/dist/GPTChat.js +199 -7
  23. package/dist/GPTChat.js.map +1 -1
  24. package/dist/HtmlFrame.d.ts +11 -0
  25. package/dist/HtmlFrame.d.ts.map +1 -0
  26. package/dist/HtmlFrame.js +29 -0
  27. package/dist/HtmlFrame.js.map +1 -0
  28. package/dist/SplitPage.d.ts +2 -2
  29. package/dist/SplitPage.d.ts.map +1 -1
  30. package/dist/SplitPage.js +17 -5
  31. package/dist/SplitPage.js.map +1 -1
  32. package/dist/Text.d.ts +1 -1
  33. package/dist/Text.d.ts.map +1 -1
  34. package/dist/Text.js +2 -2
  35. package/dist/Text.js.map +1 -1
  36. package/dist/asks/AskCard.d.ts +34 -0
  37. package/dist/asks/AskCard.d.ts.map +1 -0
  38. package/dist/asks/AskCard.js +91 -0
  39. package/dist/asks/AskCard.js.map +1 -0
  40. package/dist/asks/AskChoice.d.ts +11 -0
  41. package/dist/asks/AskChoice.d.ts.map +1 -0
  42. package/dist/asks/AskChoice.js +146 -0
  43. package/dist/asks/AskChoice.js.map +1 -0
  44. package/dist/asks/AskConfirm.d.ts +15 -0
  45. package/dist/asks/AskConfirm.d.ts.map +1 -0
  46. package/dist/asks/AskConfirm.js +17 -0
  47. package/dist/asks/AskConfirm.js.map +1 -0
  48. package/dist/asks/AskFiles.d.ts +18 -0
  49. package/dist/asks/AskFiles.d.ts.map +1 -0
  50. package/dist/asks/AskFiles.js +149 -0
  51. package/dist/asks/AskFiles.js.map +1 -0
  52. package/dist/asks/AskForm.d.ts +27 -0
  53. package/dist/asks/AskForm.d.ts.map +1 -0
  54. package/dist/asks/AskForm.js +146 -0
  55. package/dist/asks/AskForm.js.map +1 -0
  56. package/dist/asks/AskMarkdown.d.ts +25 -0
  57. package/dist/asks/AskMarkdown.d.ts.map +1 -0
  58. package/dist/asks/AskMarkdown.js +73 -0
  59. package/dist/asks/AskMarkdown.js.map +1 -0
  60. package/dist/asks/SimpleAskCard.d.ts +23 -0
  61. package/dist/asks/SimpleAskCard.d.ts.map +1 -0
  62. package/dist/asks/SimpleAskCard.js +32 -0
  63. package/dist/asks/SimpleAskCard.js.map +1 -0
  64. package/dist/asks/askControls.d.ts +33 -0
  65. package/dist/asks/askControls.d.ts.map +1 -0
  66. package/dist/asks/askControls.js +30 -0
  67. package/dist/asks/askControls.js.map +1 -0
  68. package/dist/asks/askFileRefs.d.ts +26 -0
  69. package/dist/asks/askFileRefs.d.ts.map +1 -0
  70. package/dist/asks/askFileRefs.js +75 -0
  71. package/dist/asks/askFileRefs.js.map +1 -0
  72. package/dist/asks/askFormDraft.d.ts +60 -0
  73. package/dist/asks/askFormDraft.d.ts.map +1 -0
  74. package/dist/asks/askFormDraft.js +224 -0
  75. package/dist/asks/askFormDraft.js.map +1 -0
  76. package/dist/asks/askSummary.d.ts +10 -0
  77. package/dist/asks/askSummary.d.ts.map +1 -0
  78. package/dist/asks/askSummary.js +138 -0
  79. package/dist/asks/askSummary.js.map +1 -0
  80. package/dist/asks/askTypes.d.ts +21 -0
  81. package/dist/asks/askTypes.d.ts.map +1 -0
  82. package/dist/asks/askTypes.js +2 -0
  83. package/dist/asks/askTypes.js.map +1 -0
  84. package/dist/asks/simpleCardButtonVariants.d.ts +5 -0
  85. package/dist/asks/simpleCardButtonVariants.d.ts.map +1 -0
  86. package/dist/asks/simpleCardButtonVariants.js +8 -0
  87. package/dist/asks/simpleCardButtonVariants.js.map +1 -0
  88. package/dist/blocks/BlocksError.d.ts +8 -0
  89. package/dist/blocks/BlocksError.d.ts.map +1 -0
  90. package/dist/blocks/BlocksError.js +14 -0
  91. package/dist/blocks/BlocksError.js.map +1 -0
  92. package/dist/blocks/BlocksView.d.ts +10 -0
  93. package/dist/blocks/BlocksView.d.ts.map +1 -0
  94. package/dist/blocks/BlocksView.js +90 -0
  95. package/dist/blocks/BlocksView.js.map +1 -0
  96. package/dist/blocks/blockRenderers.d.ts +25 -0
  97. package/dist/blocks/blockRenderers.d.ts.map +1 -0
  98. package/dist/blocks/blockRenderers.js +136 -0
  99. package/dist/blocks/blockRenderers.js.map +1 -0
  100. package/dist/blocks/datasetToPoints.d.ts +22 -0
  101. package/dist/blocks/datasetToPoints.d.ts.map +1 -0
  102. package/dist/blocks/datasetToPoints.js +28 -0
  103. package/dist/blocks/datasetToPoints.js.map +1 -0
  104. package/dist/blocks/useBlockSelections.d.ts +6 -0
  105. package/dist/blocks/useBlockSelections.d.ts.map +1 -0
  106. package/dist/blocks/useBlockSelections.js +10 -0
  107. package/dist/blocks/useBlockSelections.js.map +1 -0
  108. package/dist/blocks/useResolvedDatasets.d.ts +18 -0
  109. package/dist/blocks/useResolvedDatasets.d.ts.map +1 -0
  110. package/dist/blocks/useResolvedDatasets.js +59 -0
  111. package/dist/blocks/useResolvedDatasets.js.map +1 -0
  112. package/dist/blocks/useResolvedImages.d.ts +15 -0
  113. package/dist/blocks/useResolvedImages.d.ts.map +1 -0
  114. package/dist/blocks/useResolvedImages.js +66 -0
  115. package/dist/blocks/useResolvedImages.js.map +1 -0
  116. package/dist/index.d.ts +6 -1
  117. package/dist/index.d.ts.map +1 -1
  118. package/dist/index.js +4 -1
  119. package/dist/index.js.map +1 -1
  120. package/dist/lazyBoundaries/heavyOptionalExports.d.ts +6 -0
  121. package/dist/lazyBoundaries/heavyOptionalExports.d.ts.map +1 -1
  122. package/dist/lazyBoundaries/heavyOptionalExports.js +4 -0
  123. package/dist/lazyBoundaries/heavyOptionalExports.js.map +1 -1
  124. package/dist/table/TableHeaderCell.js +1 -1
  125. package/dist/table/TableHeaderCell.js.map +1 -1
  126. package/package.json +2 -1
  127. package/src/Button.test.tsx +101 -0
  128. package/src/Button.tsx +35 -5
  129. package/src/Common.ts +73 -0
  130. package/src/DataTable.tsx +1 -1
  131. package/src/DateTimeActionSheet.tsx +1 -1
  132. package/src/DateTimeField.test.tsx +185 -2
  133. package/src/DateTimeField.tsx +107 -17
  134. package/src/DonutChart.test.tsx +5 -10
  135. package/src/FilePickerButton.test.tsx +56 -3
  136. package/src/FilePickerButton.tsx +83 -17
  137. package/src/GPTChat.test.tsx +758 -2
  138. package/src/GPTChat.tsx +517 -7
  139. package/src/HtmlFrame.tsx +60 -0
  140. package/src/LineChart.test.tsx +5 -10
  141. package/src/SplitPage.test.tsx +55 -0
  142. package/src/SplitPage.tsx +13 -7
  143. package/src/Text.test.tsx +22 -0
  144. package/src/Text.tsx +10 -1
  145. package/src/__snapshots__/Button.test.tsx.snap +1 -1
  146. package/src/__snapshots__/SplitPage.test.tsx.snap +14 -0
  147. package/src/asks/AskCard.test.tsx +1428 -0
  148. package/src/asks/AskCard.tsx +240 -0
  149. package/src/asks/AskChoice.tsx +368 -0
  150. package/src/asks/AskConfirm.tsx +42 -0
  151. package/src/asks/AskFiles.test.tsx +347 -0
  152. package/src/asks/AskFiles.tsx +246 -0
  153. package/src/asks/AskForm.tsx +334 -0
  154. package/src/asks/AskMarkdown.tsx +176 -0
  155. package/src/asks/SimpleAskCard.test.tsx +253 -0
  156. package/src/asks/SimpleAskCard.tsx +82 -0
  157. package/src/asks/askControls.tsx +98 -0
  158. package/src/asks/askFileRefs.test.ts +155 -0
  159. package/src/asks/askFileRefs.ts +98 -0
  160. package/src/asks/askFormDraft.test.ts +347 -0
  161. package/src/asks/askFormDraft.ts +309 -0
  162. package/src/asks/askSummary.test.ts +255 -0
  163. package/src/asks/askSummary.ts +160 -0
  164. package/src/asks/askTypes.ts +25 -0
  165. package/src/asks/asksUseTerrenoComponents.test.ts +55 -0
  166. package/src/asks/simpleCardButtonVariants.ts +14 -0
  167. package/src/blocks/BlocksError.tsx +28 -0
  168. package/src/blocks/BlocksView.test.tsx +607 -0
  169. package/src/blocks/BlocksView.tsx +125 -0
  170. package/src/blocks/blockRenderers.tsx +288 -0
  171. package/src/blocks/datasetToPoints.test.ts +31 -0
  172. package/src/blocks/datasetToPoints.ts +48 -0
  173. package/src/blocks/useBlockSelections.ts +13 -0
  174. package/src/blocks/useResolvedDatasets.ts +78 -0
  175. package/src/blocks/useResolvedImages.ts +81 -0
  176. package/src/bunSetup.ts +0 -6
  177. package/src/index.tsx +7 -0
  178. package/src/isolated/HtmlFrame.isolated.tsx +54 -0
  179. package/src/lazyBoundaries/heavyOptionalExports.test.tsx +2 -0
  180. package/src/lazyBoundaries/heavyOptionalExports.tsx +14 -0
  181. package/src/table/TableHeaderCell.tsx +1 -1
@@ -8,14 +8,24 @@ import {
8
8
  type mock as MockType,
9
9
  mock,
10
10
  } from "bun:test";
11
- import {act, userEvent} from "@testing-library/react-native";
11
+ import {act, fireEvent, userEvent} from "@testing-library/react-native";
12
12
  import {assert} from "chai";
13
13
  import {DateTime} from "luxon";
14
+ import {useState} from "react";
14
15
  import type {ReactTestInstance} from "react-test-renderer";
15
-
16
+ import type {DateTimeFieldProps} from "./Common";
16
17
  import {DateTimeField} from "./DateTimeField";
17
18
  import {renderWithTheme, setupComponentTest, teardownComponentTest} from "./test-utils";
18
19
 
20
+ /** A parent that passes every emitted value back, as a form does. */
21
+ const ControlledDateTimeField = ({
22
+ initialValue,
23
+ ...props
24
+ }: Omit<DateTimeFieldProps, "onChange" | "value"> & {initialValue: string}): React.ReactElement => {
25
+ const [value, setValue] = useState(initialValue);
26
+ return <DateTimeField {...props} onChange={setValue} value={value} />;
27
+ };
28
+
19
29
  const setDesktop = () => {
20
30
  mock.module("./MediaQuery", () => ({
21
31
  isNarrowViewport: () => false,
@@ -460,6 +470,179 @@ describe("DateTimeField", () => {
460
470
  });
461
471
  });
462
472
 
473
+ describe("onEntryStatusChange", () => {
474
+ it("reports an unfinished date as invalid, a complete one as valid, and a cleared one as empty", async () => {
475
+ const user = userEvent.setup();
476
+ const onEntryStatusChange = mock((_status: string) => {});
477
+ const {getByPlaceholderText} = renderWithTheme(
478
+ <DateTimeField
479
+ onChange={mockOnChange}
480
+ onEntryStatusChange={onEntryStatusChange}
481
+ type="date"
482
+ value=""
483
+ />
484
+ );
485
+ await user.type(getByPlaceholderText("MM"), "0");
486
+ expect(onEntryStatusChange).toHaveBeenLastCalledWith("invalid");
487
+
488
+ await user.clear(getByPlaceholderText("MM"));
489
+ expect(onEntryStatusChange).toHaveBeenLastCalledWith("empty");
490
+
491
+ await user.type(getByPlaceholderText("MM"), "10");
492
+ await user.type(getByPlaceholderText("DD"), "15");
493
+ await user.type(getByPlaceholderText("YYYY"), "202");
494
+ expect(onEntryStatusChange).toHaveBeenLastCalledWith("invalid");
495
+ await user.type(getByPlaceholderText("YYYY"), "6");
496
+ expect(onEntryStatusChange).toHaveBeenLastCalledWith("valid");
497
+ });
498
+
499
+ it("reports a datetime whose hour is cleared as invalid without throwing", async () => {
500
+ const user = userEvent.setup();
501
+ const onEntryStatusChange = mock((_status: string) => {});
502
+ const {getByPlaceholderText} = renderWithTheme(
503
+ <DateTimeField
504
+ onChange={mockOnChange}
505
+ onEntryStatusChange={onEntryStatusChange}
506
+ timezone="America/New_York"
507
+ type="datetime"
508
+ value="2023-05-15T15:30:00.000Z"
509
+ />
510
+ );
511
+ await user.clear(getByPlaceholderText("hh"));
512
+ expect(onEntryStatusChange).toHaveBeenLastCalledWith("invalid");
513
+ });
514
+
515
+ it("reports a single-digit hour typed into an empty datetime hour as valid", async () => {
516
+ const user = userEvent.setup();
517
+ const onEntryStatusChange = mock((_status: string) => {});
518
+ const {getByPlaceholderText} = renderWithTheme(
519
+ <DateTimeField
520
+ onChange={mockOnChange}
521
+ onEntryStatusChange={onEntryStatusChange}
522
+ timezone="America/New_York"
523
+ type="datetime"
524
+ value=""
525
+ />
526
+ );
527
+ await user.type(getByPlaceholderText("MM"), "10");
528
+ await user.type(getByPlaceholderText("DD"), "15");
529
+ await user.type(getByPlaceholderText("YYYY"), "2026");
530
+ await user.type(getByPlaceholderText("mm"), "30");
531
+ act(() => {
532
+ fireEvent.changeText(getByPlaceholderText("hh"), "4");
533
+ });
534
+ expect(onEntryStatusChange).toHaveBeenLastCalledWith("valid");
535
+ });
536
+
537
+ it("reports a time without an hour as invalid", async () => {
538
+ const user = userEvent.setup();
539
+ const onEntryStatusChange = mock((_status: string) => {});
540
+ const {getByPlaceholderText} = renderWithTheme(
541
+ <DateTimeField
542
+ onChange={mockOnChange}
543
+ onEntryStatusChange={onEntryStatusChange}
544
+ timezone="America/New_York"
545
+ type="time"
546
+ value="2023-05-15T15:30:00.000Z"
547
+ />
548
+ );
549
+ await user.clear(getByPlaceholderText("hh"));
550
+ expect(onEntryStatusChange).toHaveBeenLastCalledWith("invalid");
551
+ await user.type(getByPlaceholderText("hh"), "4");
552
+ expect(onEntryStatusChange).toHaveBeenLastCalledWith("valid");
553
+ });
554
+
555
+ it("reports an on-the-hour time whose hour is cleared as invalid until the minute is cleared too", async () => {
556
+ const user = userEvent.setup();
557
+ const onEntryStatusChange = mock((_status: string) => {});
558
+ const {getByPlaceholderText} = renderWithTheme(
559
+ <DateTimeField
560
+ onChange={mockOnChange}
561
+ onEntryStatusChange={onEntryStatusChange}
562
+ timezone="America/New_York"
563
+ type="time"
564
+ value="2023-05-15T13:00:00.000Z"
565
+ />
566
+ );
567
+ expect(getByPlaceholderText("mm").props.value).toBe("00");
568
+ await user.clear(getByPlaceholderText("hh"));
569
+ expect(onEntryStatusChange).toHaveBeenLastCalledWith("invalid");
570
+ await user.clear(getByPlaceholderText("mm"));
571
+ expect(onEntryStatusChange).toHaveBeenLastCalledWith("empty");
572
+ });
573
+
574
+ it("reports a noon datetime cleared except for its minute as invalid until the minute is cleared too", async () => {
575
+ const user = userEvent.setup();
576
+ const onEntryStatusChange = mock((_status: string) => {});
577
+ const {getByPlaceholderText} = renderWithTheme(
578
+ <DateTimeField
579
+ onChange={mockOnChange}
580
+ onEntryStatusChange={onEntryStatusChange}
581
+ timezone="America/New_York"
582
+ type="datetime"
583
+ value="2023-05-15T16:00:00.000Z"
584
+ />
585
+ );
586
+ expect(getByPlaceholderText("hh").props.value).toBe("12");
587
+ for (const placeholder of ["MM", "DD", "YYYY", "hh"]) {
588
+ await user.clear(getByPlaceholderText(placeholder));
589
+ }
590
+ expect(onEntryStatusChange).toHaveBeenLastCalledWith("invalid");
591
+ await user.clear(getByPlaceholderText("mm"));
592
+ expect(onEntryStatusChange).toHaveBeenLastCalledWith("empty");
593
+ });
594
+
595
+ it("reports a controlled time cleared minute first, then hour, as empty", async () => {
596
+ const user = userEvent.setup();
597
+ const onEntryStatusChange = mock((_status: string) => {});
598
+ const {getByPlaceholderText} = renderWithTheme(
599
+ <ControlledDateTimeField
600
+ initialValue="2023-05-15T13:30:00.000Z"
601
+ onEntryStatusChange={onEntryStatusChange}
602
+ timezone="America/New_York"
603
+ type="time"
604
+ />
605
+ );
606
+ await user.clear(getByPlaceholderText("mm"));
607
+ expect(getByPlaceholderText("mm").props.value).toBe("00");
608
+ expect(onEntryStatusChange).toHaveBeenLastCalledWith("valid");
609
+ await user.clear(getByPlaceholderText("hh"));
610
+ expect(onEntryStatusChange).toHaveBeenLastCalledWith("empty");
611
+ });
612
+
613
+ it("reports a controlled datetime cleared minute first, then the rest, as empty", async () => {
614
+ const user = userEvent.setup();
615
+ const onEntryStatusChange = mock((_status: string) => {});
616
+ const {getByPlaceholderText} = renderWithTheme(
617
+ <ControlledDateTimeField
618
+ initialValue="2026-10-01T13:30:00.000Z"
619
+ onEntryStatusChange={onEntryStatusChange}
620
+ timezone="America/New_York"
621
+ type="datetime"
622
+ />
623
+ );
624
+ for (const placeholder of ["mm", "MM", "DD", "YYYY", "hh"]) {
625
+ await user.clear(getByPlaceholderText(placeholder));
626
+ }
627
+ expect(onEntryStatusChange).toHaveBeenLastCalledWith("empty");
628
+ });
629
+
630
+ it("emits nothing when the hour of an on-the-hour time is cleared without onEntryStatusChange", async () => {
631
+ const user = userEvent.setup();
632
+ const onChange = mock((_value: string) => {});
633
+ const {getByPlaceholderText} = renderWithTheme(
634
+ <DateTimeField
635
+ onChange={onChange}
636
+ timezone="America/New_York"
637
+ type="time"
638
+ value="2023-05-15T13:00:00.000Z"
639
+ />
640
+ );
641
+ await user.clear(getByPlaceholderText("hh"));
642
+ expect(onChange).not.toHaveBeenCalled();
643
+ });
644
+ });
645
+
463
646
  describe("time type field validation", () => {
464
647
  it("should validate hour fields for time type", async () => {
465
648
  const user = userEvent.setup();
@@ -1,4 +1,4 @@
1
- import {FontAwesome6} from "@expo/vector-icons";
1
+ import FontAwesome6 from "@expo/vector-icons/FontAwesome6";
2
2
  import {DateTime} from "luxon";
3
3
  import React, {type FC, useCallback, useEffect, useMemo, useRef, useState} from "react";
4
4
  import {Pressable, TextInput, View} from "react-native";
@@ -18,6 +18,13 @@ import {useTheme} from "./Theme";
18
18
  import {TimezonePicker} from "./TimezonePicker";
19
19
  import {resolveFieldTestIDsFromProps} from "./testing/resolveTestId";
20
20
 
21
+ /** The state each segment index edits, per field type. */
22
+ const SEGMENT_NAMES = {
23
+ date: ["month", "day", "year"],
24
+ datetime: ["month", "day", "year", "hour", "minute"],
25
+ time: ["hour", "minute"],
26
+ } as const;
27
+
21
28
  interface SeparatorProps {
22
29
  type: "date" | "time";
23
30
  }
@@ -418,6 +425,7 @@ export const DateTimeField: FC<DateTimeFieldProps> = ({
418
425
  title,
419
426
  value,
420
427
  onChange,
428
+ onEntryStatusChange,
421
429
  timezone: providedTimezone,
422
430
  onTimezoneChange,
423
431
  errorText,
@@ -436,6 +444,18 @@ export const DateTimeField: FC<DateTimeFieldProps> = ({
436
444
  const [year, setYear] = useState("");
437
445
  const [hour, setHour] = useState("");
438
446
  const [minute, setMinute] = useState("");
447
+ // Whether the minute's "00" came from the user clearing the segment rather than from a value.
448
+ const isMinuteClearedRef = useRef(false);
449
+ // The last value this field emitted, so a controlled parent passing it back is not taken as
450
+ // an external change.
451
+ const lastEmittedRef = useRef<string | undefined>(undefined);
452
+ const emitChange = useCallback(
453
+ (next: string): void => {
454
+ lastEmittedRef.current = next;
455
+ onChange(next);
456
+ },
457
+ [onChange]
458
+ );
439
459
  const [fieldErrors, setFieldErrors] = useState<Record<number, string | undefined>>({});
440
460
  const [localTimezone, setLocalTimezone] = useState(
441
461
  providedTimezone ?? DateTime.local().zoneName ?? "UTC"
@@ -574,10 +594,13 @@ export const DateTimeField: FC<DateTimeFieldProps> = ({
574
594
  const hourVal = override?.hour ?? hour;
575
595
  let date: DateTime;
576
596
  if (type === "datetime") {
577
- if (!monthVal || !dayVal || !yearVal || !hour || !minuteVal) {
597
+ if (!monthVal || !dayVal || !yearVal || !hourVal || !minuteVal) {
578
598
  return undefined;
579
599
  }
580
600
  let hourNum = parseInt(hourVal, 10);
601
+ if (Number.isNaN(hourNum)) {
602
+ return undefined;
603
+ }
581
604
  if (ampPmVal === "pm" && hourNum !== 12) {
582
605
  hourNum += 12;
583
606
  } else if (ampPmVal === "am" && hourNum === 12) {
@@ -616,10 +639,13 @@ export const DateTimeField: FC<DateTimeFieldProps> = ({
616
639
  }
617
640
  );
618
641
  } else {
619
- if (!hour || !minuteVal) {
642
+ if (!hourVal || !minuteVal) {
643
+ return undefined;
644
+ }
645
+ let hourNum = parseInt(hourVal, 10);
646
+ if (Number.isNaN(hourNum)) {
620
647
  return undefined;
621
648
  }
622
- let hourNum = parseInt(hour, 10);
623
649
  if (ampPmVal === "pm" && hourNum !== 12) {
624
650
  hourNum += 12;
625
651
  } else if (ampPmVal === "am" && hourNum === 12) {
@@ -647,6 +673,37 @@ export const DateTimeField: FC<DateTimeFieldProps> = ({
647
673
  [amPm, month, day, year, hour, minute, timezone, type]
648
674
  );
649
675
 
676
+ /**
677
+ * Tells `onEntryStatusChange` what the segments hold after a typed change: nothing, an entry
678
+ * that is unfinished or has a segment error, or a complete value. Clearing the minute segment
679
+ * resets it to "00", so a "00" minute counts as empty only when the user cleared it; the "00"
680
+ * of an on-the-hour value is still part of the entry.
681
+ */
682
+ const reportEntryStatus = useCallback(
683
+ (
684
+ override: {day?: string; hour?: string; minute?: string; month?: string; year?: string},
685
+ errors: Record<number, string | undefined>
686
+ ): void => {
687
+ if (!onEntryStatusChange) {
688
+ return;
689
+ }
690
+ const next = {day, hour, minute, month, year, ...override};
691
+ const dateParts = type === "time" ? [] : [next.month, next.day, next.year];
692
+ const timeParts = type === "date" ? [] : [next.hour];
693
+ const hasMinute =
694
+ type !== "date" &&
695
+ next.minute !== "" &&
696
+ !(next.minute === "00" && isMinuteClearedRef.current);
697
+ if (![...dateParts, ...timeParts].some(Boolean) && !hasMinute) {
698
+ onEntryStatusChange("empty");
699
+ return;
700
+ }
701
+ const hasError = Object.values(errors).some((error) => error !== undefined);
702
+ onEntryStatusChange(!hasError && getISOFromFields(override) ? "valid" : "invalid");
703
+ },
704
+ [onEntryStatusChange, day, hour, minute, month, year, type, getISOFromFields]
705
+ );
706
+
650
707
  /**
651
708
  * Handles text changes in any {@link DateTimeSegment} input.
652
709
  * Strips non-numeric characters, validates the value, updates local state,
@@ -665,14 +722,21 @@ export const DateTimeField: FC<DateTimeFieldProps> = ({
665
722
  // This lets users freely edit or clear the minute field without breaking the time format.
666
723
  const finalValue = numericValue === "" ? "00" : numericValue.slice(-2);
667
724
  const minuteNum = parseInt(finalValue, 10);
725
+ isMinuteClearedRef.current = numericValue === "";
668
726
 
669
727
  // Update the minute state so the UI reflects the latest input,
670
728
  // even if it's temporarily invalid
671
729
  // This allows the user to freely edit or clear the field.
672
730
  setMinute(finalValue);
673
731
 
732
+ const isValidMinute = !Number.isNaN(minuteNum) && minuteNum >= 0 && minuteNum <= 59;
733
+ reportEntryStatus(
734
+ {minute: finalValue},
735
+ {...fieldErrors, [index]: isValidMinute ? undefined : "Minute must be between 0 and 59"}
736
+ );
737
+
674
738
  // Only update ref and result if it's a valid minute value
675
- if (!Number.isNaN(minuteNum) && minuteNum >= 0 && minuteNum <= 59) {
739
+ if (isValidMinute) {
676
740
  pendingValueRef.current = {minute: finalValue};
677
741
  setFieldErrors((prev) => ({...prev, [index]: undefined}));
678
742
 
@@ -681,7 +745,7 @@ export const DateTimeField: FC<DateTimeFieldProps> = ({
681
745
  if (result) {
682
746
  const currentValueUTC = value ? DateTime.fromISO(value).toUTC().toISO() : undefined;
683
747
  if (result !== currentValueUTC) {
684
- onChange(result);
748
+ emitChange(result);
685
749
  }
686
750
  }
687
751
  } else {
@@ -700,6 +764,10 @@ export const DateTimeField: FC<DateTimeFieldProps> = ({
700
764
 
701
765
  const error = validateField(index, finalValue);
702
766
  setFieldErrors((prev) => ({...prev, [index]: error}));
767
+ const segmentName = SEGMENT_NAMES[type][index];
768
+ if (segmentName) {
769
+ reportEntryStatus({[segmentName]: finalValue}, {...fieldErrors, [index]: error});
770
+ }
703
771
 
704
772
  if (type === "date" || type === "datetime") {
705
773
  if (index === 0) {
@@ -744,7 +812,7 @@ export const DateTimeField: FC<DateTimeFieldProps> = ({
744
812
  if (result) {
745
813
  const currentValueUTC = value ? DateTime.fromISO(value).toUTC().toISO() : undefined;
746
814
  if (result !== currentValueUTC) {
747
- onChange(result);
815
+ emitChange(result);
748
816
  }
749
817
  }
750
818
  }
@@ -756,7 +824,19 @@ export const DateTimeField: FC<DateTimeFieldProps> = ({
756
824
  inputRefs.current[index + 1]?.focus();
757
825
  }
758
826
  },
759
- [type, getFieldConfigs, getISOFromFields, onChange, value, validateField, month, day, year]
827
+ [
828
+ type,
829
+ getFieldConfigs,
830
+ getISOFromFields,
831
+ emitChange,
832
+ value,
833
+ validateField,
834
+ month,
835
+ day,
836
+ year,
837
+ fieldErrors,
838
+ reportEntryStatus,
839
+ ]
760
840
  );
761
841
 
762
842
  /**
@@ -768,7 +848,8 @@ export const DateTimeField: FC<DateTimeFieldProps> = ({
768
848
  (inputDate: string) => {
769
849
  // Handle clear case - empty string should clear the field
770
850
  if (!inputDate || inputDate === "") {
771
- onChange("");
851
+ emitChange("");
852
+ onEntryStatusChange?.("empty");
772
853
  setShowDate(false);
773
854
  return;
774
855
  }
@@ -794,6 +875,7 @@ export const DateTimeField: FC<DateTimeFieldProps> = ({
794
875
  hourNum = hourNum === 0 ? 12 : hourNum;
795
876
  setHour(hourNum.toString().padStart(2, "0"));
796
877
  setMinute(parsedDate.minute.toString().padStart(2, "0"));
878
+ isMinuteClearedRef.current = false;
797
879
  }
798
880
 
799
881
  // Normalize emitted value to ISO (UTC for date-only)
@@ -804,10 +886,11 @@ export const DateTimeField: FC<DateTimeFieldProps> = ({
804
886
  .set({millisecond: 0, second: 0})
805
887
  .toISO()
806
888
  : parsedDate.set({millisecond: 0, second: 0}).toUTC().toISO();
807
- onChange(normalized ?? "");
889
+ emitChange(normalized ?? "");
890
+ onEntryStatusChange?.("valid");
808
891
  setShowDate(false);
809
892
  },
810
- [onChange, type]
893
+ [emitChange, onEntryStatusChange, type]
811
894
  );
812
895
 
813
896
  /**
@@ -820,13 +903,14 @@ export const DateTimeField: FC<DateTimeFieldProps> = ({
820
903
  // Compare in UTC to avoid timezone issues
821
904
  const currentValueUTC = value ? DateTime.fromISO(value).toUTC().toISO() : undefined;
822
905
  if (iso && iso !== currentValueUTC) {
823
- onChange(iso);
906
+ emitChange(iso);
824
907
  }
908
+ reportEntryStatus({...pendingValueRef.current}, fieldErrors);
825
909
 
826
910
  // Clear the pending value after processing
827
911
  pendingValueRef.current = undefined;
828
912
  },
829
- [getISOFromFields, onChange, value]
913
+ [getISOFromFields, emitChange, value, reportEntryStatus, fieldErrors]
830
914
  );
831
915
 
832
916
  // Handle external value changes
@@ -865,6 +949,12 @@ export const DateTimeField: FC<DateTimeFieldProps> = ({
865
949
  hourNum = hourNum === 0 ? 12 : hourNum;
866
950
  setHour(hourNum.toString().padStart(2, "0"));
867
951
  setMinute(parsedDate.minute.toString().padStart(2, "0"));
952
+ const lastEmitted = lastEmittedRef.current
953
+ ? DateTime.fromISO(lastEmittedRef.current)
954
+ : undefined;
955
+ if (!lastEmitted?.isValid || lastEmitted.toMillis() !== parsedDate.toMillis()) {
956
+ isMinuteClearedRef.current = false;
957
+ }
868
958
  }
869
959
  }, [value, type, timezone]);
870
960
 
@@ -936,10 +1026,10 @@ export const DateTimeField: FC<DateTimeFieldProps> = ({
936
1026
  const iso = getISOFromFields({amPm: newAmPm});
937
1027
  const currentValueUTC = value ? DateTime.fromISO(value).toUTC().toISO() : undefined;
938
1028
  if (iso && iso !== currentValueUTC) {
939
- onChange(iso);
1029
+ emitChange(iso);
940
1030
  }
941
1031
  },
942
- [getISOFromFields, value, onChange]
1032
+ [getISOFromFields, value, emitChange]
943
1033
  );
944
1034
 
945
1035
  /** Handles timezone changes from the TimezonePicker, recomputes and emits the ISO value. */
@@ -953,10 +1043,10 @@ export const DateTimeField: FC<DateTimeFieldProps> = ({
953
1043
  const iso = getISOFromFields({timezone: tz});
954
1044
  const currentValueUTC = value ? DateTime.fromISO(value).toUTC().toISO() : undefined;
955
1045
  if (iso && iso !== currentValueUTC) {
956
- onChange(iso);
1046
+ emitChange(iso);
957
1047
  }
958
1048
  },
959
- [getISOFromFields, value, onChange, onTimezoneChange]
1049
+ [getISOFromFields, value, emitChange, onTimezoneChange]
960
1050
  );
961
1051
 
962
1052
  const openActionSheet = useCallback((): void => {
@@ -1,7 +1,6 @@
1
- import {describe, expect, it, spyOn} from "bun:test";
1
+ import {describe, expect, it} from "bun:test";
2
2
  import {act, fireEvent} from "@testing-library/react-native";
3
3
  import {assert} from "chai";
4
- import {Linking} from "react-native";
5
4
 
6
5
  import {DonutChart} from "./DonutChart";
7
6
  import {renderWithTheme} from "./test-utils";
@@ -178,17 +177,13 @@ describe("DonutChart", () => {
178
177
  expect(queryByTestId("chart.tooltip")).toBeNull();
179
178
  });
180
179
 
181
- it("does not open URLs from slice legend labels", async () => {
182
- const openURLSpy = spyOn(Linking, "openURL").mockImplementation(() => Promise.resolve(true));
180
+ it("does not open URLs from slice legend labels", () => {
183
181
  const {getByText} = renderWithTheme(
184
182
  <DonutChart data={[{label: "https://evil.example", value: 10}]} />
185
183
  );
186
184
 
187
- await act(async () => {
188
- fireEvent.press(getByText("https://evil.example"));
189
- });
190
-
191
- expect(openURLSpy).not.toHaveBeenCalled();
192
- openURLSpy.mockRestore();
185
+ // The suite shares one Linking mock, so a spy on openURL also records calls
186
+ // from other files. A label is inert when it has no press handler.
187
+ expect(getByText("https://evil.example").props.onPress).toBeUndefined();
193
188
  });
194
189
  });
@@ -1,5 +1,5 @@
1
1
  import {afterAll, beforeEach, describe, expect, it, mock} from "bun:test";
2
- import {fireEvent, waitFor} from "@testing-library/react-native";
2
+ import {fireEvent, waitFor, within} from "@testing-library/react-native";
3
3
  import {Platform, Pressable} from "react-native";
4
4
 
5
5
  // Override the IconButton mock so the onClick fires when pressed.
@@ -35,12 +35,12 @@ import {FilePickerButton, type SelectedFile} from "./FilePickerButton";
35
35
  import {renderWithTheme} from "./test-utils";
36
36
 
37
37
  interface ImagePickerResult {
38
- assets: Array<{fileName?: string; mimeType?: string; uri: string}>;
38
+ assets: Array<{fileName?: string; fileSize?: number; mimeType?: string; uri: string}>;
39
39
  canceled: boolean;
40
40
  }
41
41
 
42
42
  interface DocumentPickerResult {
43
- assets: Array<{mimeType?: string; name: string; uri: string}>;
43
+ assets: Array<{mimeType?: string; name: string; size?: number; uri: string}>;
44
44
  canceled: boolean;
45
45
  }
46
46
 
@@ -168,6 +168,59 @@ describe("FilePickerButton", () => {
168
168
  expect(empty.files).toHaveLength(0);
169
169
  });
170
170
 
171
+ it("shows a labelled button when text is set", () => {
172
+ const {getByTestId} = renderWithTheme(
173
+ <FilePickerButton onFilesSelected={() => {}} text="Choose files" />
174
+ );
175
+ expect(within(getByTestId("file-picker-button")).getByText("Choose files")).toBeTruthy();
176
+ });
177
+
178
+ it("opens the document picker with the given types directly when images are off", async () => {
179
+ documentPickerResult = {
180
+ assets: [{mimeType: "text/csv", name: "day.csv", size: 42, uri: "file:///day.csv"}],
181
+ canceled: false,
182
+ };
183
+ const files: SelectedFile[][] = [];
184
+ const {getByTestId, queryByText} = renderWithTheme(
185
+ <FilePickerButton
186
+ documentTypes={["text/csv"]}
187
+ includeImages={false}
188
+ onFilesSelected={(selected) => files.push(selected)}
189
+ text="Choose files"
190
+ />
191
+ );
192
+
193
+ fireEvent.press(getByTestId("file-picker-button"));
194
+
195
+ await waitFor(() => expect(files).toHaveLength(1));
196
+ expect(queryByText("Photo Library")).toBeNull();
197
+ expect(getDocumentAsync).toHaveBeenCalledWith({multiple: false, type: ["text/csv"]});
198
+ expect(files[0]).toEqual([
199
+ {mimeType: "text/csv", name: "day.csv", size: 42, uri: "file:///day.csv"},
200
+ ]);
201
+ });
202
+
203
+ it("opens the photo library directly when there are no document types", async () => {
204
+ imagePickerResult = {
205
+ assets: [
206
+ {fileName: "pic.png", fileSize: 2048, mimeType: "image/png", uri: "file:///pic.png"},
207
+ ],
208
+ canceled: false,
209
+ };
210
+ const files: SelectedFile[][] = [];
211
+ const {getByTestId} = renderWithTheme(
212
+ <FilePickerButton documentTypes={[]} onFilesSelected={(selected) => files.push(selected)} />
213
+ );
214
+
215
+ fireEvent.press(getByTestId("file-picker-button"));
216
+
217
+ await waitFor(() => expect(files).toHaveLength(1));
218
+ expect(getDocumentAsync).not.toHaveBeenCalled();
219
+ expect(files[0]).toEqual([
220
+ {mimeType: "image/png", name: "pic.png", size: 2048, uri: "file:///pic.png"},
221
+ ]);
222
+ });
223
+
171
224
  it("opens a browser file input for documents on web and returns data URLs", async () => {
172
225
  const listeners: Record<string, () => void | Promise<void>> = {};
173
226
  const file = {name: "notes.txt", type: "text/plain"};