@olenbetong/synergi-react 4.3.1 → 5.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 (123) hide show
  1. package/dist/styles/styles.css +1 -1
  2. package/dist/styles/styles.css.map +1 -1
  3. package/es/components/Checkbox/index.js +1 -9
  4. package/es/components/FilePond.js +3 -12
  5. package/es/components/ImageEditor/plugins/redactPlugin/useRedactTool.js +18 -14
  6. package/es/components/ImageEditor/useImageHistory.js +13 -1
  7. package/es/components/MergeProgressDialog/MergeProgressDialogDs.d.ts +7 -0
  8. package/es/components/MergeProgressDialog/MergeProgressDialogDs.js +20 -0
  9. package/es/components/MergeProgressDialog/index.d.ts +3 -8
  10. package/es/components/MergeProgressDialog/index.js +4 -133
  11. package/es/components/MergeProgressDialog/useMergeJob.d.ts +36 -0
  12. package/es/components/MergeProgressDialog/useMergeJob.js +142 -0
  13. package/es/components/Portal/index.js +20 -20
  14. package/es/components/ProgressBar/index.css +1 -1
  15. package/es/components/SplitContainer/index.js +3 -1
  16. package/es/components/Toolbar/index.js +6 -1
  17. package/es/elements/ElementLookupDialog/BarcodeScanner/BarcodeScanner.css +81 -0
  18. package/es/elements/ElementLookupDialog/BarcodeScanner/DeadIcon.d.ts +2 -2
  19. package/es/elements/ElementLookupDialog/BarcodeScanner/DeadIcon.js +1 -2
  20. package/es/elements/ElementLookupDialog/BarcodeScanner/Error.js +3 -29
  21. package/es/elements/ElementLookupDialog/BarcodeScanner/decoders/zxing.js +8 -0
  22. package/es/elements/ElementLookupDialog/BarcodeScanner/index.d.ts +1 -0
  23. package/es/elements/ElementLookupDialog/BarcodeScanner/index.js +3 -28
  24. package/es/elements/ElementLookupDialog/HIDScanner/useHIDScanner.js +3 -1
  25. package/es/elements-ds/DescriptionInput.d.ts +16 -0
  26. package/es/elements-ds/DescriptionInput.js +41 -0
  27. package/es/elements-ds/DuplicateElementDamage.d.ts +40 -0
  28. package/es/elements-ds/DuplicateElementDamage.js +57 -0
  29. package/es/elements-ds/ElementLookup.d.ts +23 -0
  30. package/es/elements-ds/ElementLookup.js +35 -0
  31. package/es/elements-ds/ElementLookupDialog.d.ts +7 -0
  32. package/es/elements-ds/ElementLookupDialog.js +84 -0
  33. package/es/elements-ds/FormFields.d.ts +43 -0
  34. package/es/elements-ds/FormFields.js +67 -0
  35. package/es/elements-ds/HIDScanner.d.ts +7 -0
  36. package/es/elements-ds/HIDScanner.js +36 -0
  37. package/es/elements-ds/ManualForm.d.ts +7 -0
  38. package/es/elements-ds/ManualForm.js +70 -0
  39. package/es/elements-ds/ProjectSelect.d.ts +28 -0
  40. package/es/elements-ds/ProjectSelect.js +45 -0
  41. package/es/elements-ds/elements-ds.css +157 -0
  42. package/es/elements-ds/index.d.ts +12 -0
  43. package/es/elements-ds/index.js +14 -0
  44. package/es/index.css +1 -1
  45. package/es/index.d.ts +2 -1
  46. package/es/index.js +2 -1
  47. package/es/mui/index.d.ts +1 -0
  48. package/es/mui/index.js +1 -0
  49. package/es/useTranslation/index.js +5 -3
  50. package/package.json +34 -15
  51. package/src/chrome/AppShell/AppShell.test.tsx +48 -0
  52. package/src/chrome/openReport.test.ts +50 -0
  53. package/src/colorScheme.test.ts +188 -0
  54. package/src/components/Checkbox/Checkbox.browser.test.tsx +116 -0
  55. package/src/components/Checkbox/index.tsx +1 -10
  56. package/src/components/ColorCard/ColorCard.test.tsx +34 -0
  57. package/src/components/DateNavigator/DateNavigator.test.tsx +175 -0
  58. package/src/components/FilePond.browser.test.tsx +389 -0
  59. package/src/components/FilePond.tsx +3 -12
  60. package/src/components/ImageEditor/ImageEditor.browser.test.tsx +286 -0
  61. package/src/components/ImageEditor/ImageEditor.test.tsx +299 -0
  62. package/src/components/ImageEditor/plugins/cropPlugin/useCropTool.test.ts +225 -0
  63. package/src/components/ImageEditor/plugins/plugins.browser.test.ts +252 -0
  64. package/src/components/ImageEditor/plugins/redactPlugin/useRedactTool.test.ts +89 -0
  65. package/src/components/ImageEditor/plugins/redactPlugin/useRedactTool.ts +16 -13
  66. package/src/components/ImageEditor/plugins/zoomPlugin/useZoomPan.test.ts +154 -0
  67. package/src/components/ImageEditor/useEdgeDetection.test.ts +96 -0
  68. package/src/components/ImageEditor/useImageHistory.test.ts +409 -0
  69. package/src/components/ImageEditor/useImageHistory.ts +10 -1
  70. package/src/components/ImageEditor/useOpenCV.test.ts +208 -0
  71. package/src/components/MergeProgressDialog/MergeProgressDialogDs.browser.test.tsx +156 -0
  72. package/src/components/MergeProgressDialog/MergeProgressDialogDs.tsx +92 -0
  73. package/src/components/MergeProgressDialog/index.tsx +5 -158
  74. package/src/components/MergeProgressDialog/useMergeJob.test.ts +326 -0
  75. package/src/components/MergeProgressDialog/useMergeJob.ts +170 -0
  76. package/src/components/PdfViewer/PdfViewer.browser.test.tsx +78 -0
  77. package/src/components/Portal/Portal.test.tsx +106 -0
  78. package/src/components/Portal/index.tsx +22 -25
  79. package/src/components/ProgressBar/index.scss +23 -54
  80. package/src/components/Sidebar/Sidebar.browser.test.tsx +57 -0
  81. package/src/components/Sidebar/Sidebar.test.tsx +123 -0
  82. package/src/components/SplitContainer/SplitContainer.browser.test.tsx +304 -0
  83. package/src/components/SplitContainer/index.tsx +3 -1
  84. package/src/components/Toolbar/Toolbar.test.tsx +216 -0
  85. package/src/components/Toolbar/ToolbarBreadcrumbs.browser.test.tsx +137 -0
  86. package/src/components/Toolbar/index.tsx +6 -1
  87. package/src/components/ValueToggleGroup/ValueToggleGroup.test.tsx +112 -0
  88. package/src/elements/ElementLookupDialog/BarcodeScanner/BarcodeScanner.browser.test.tsx +175 -0
  89. package/src/elements/ElementLookupDialog/BarcodeScanner/BarcodeScanner.css +81 -0
  90. package/src/elements/ElementLookupDialog/BarcodeScanner/DeadIcon.tsx +4 -4
  91. package/src/elements/ElementLookupDialog/BarcodeScanner/Error.tsx +7 -36
  92. package/src/elements/ElementLookupDialog/BarcodeScanner/decoders/zxing.ts +8 -0
  93. package/src/elements/ElementLookupDialog/BarcodeScanner/engines.browser.test.ts +225 -0
  94. package/src/elements/ElementLookupDialog/BarcodeScanner/index.tsx +20 -49
  95. package/src/elements/ElementLookupDialog/HIDScanner/useHIDScanner.test.ts +124 -0
  96. package/src/elements/ElementLookupDialog/HIDScanner/useHIDScanner.ts +2 -1
  97. package/src/elements/ElementLookupDialog/getElement.test.ts +133 -0
  98. package/src/elements/ElementLookupDialog/utils/Giai.test.ts +53 -0
  99. package/src/elements-ds/DamageForm.browser.test.tsx +530 -0
  100. package/src/elements-ds/DescriptionInput.tsx +114 -0
  101. package/src/elements-ds/DuplicateElementDamage.tsx +185 -0
  102. package/src/elements-ds/ElementLookup.tsx +114 -0
  103. package/src/elements-ds/ElementLookupDialog.browser.test.tsx +207 -0
  104. package/src/elements-ds/ElementLookupDialog.tsx +196 -0
  105. package/src/elements-ds/FormFields.tsx +176 -0
  106. package/src/elements-ds/HIDScanner.tsx +53 -0
  107. package/src/elements-ds/ManualForm.tsx +129 -0
  108. package/src/elements-ds/ProjectSelect.tsx +120 -0
  109. package/src/elements-ds/elements-ds.css +157 -0
  110. package/src/elements-ds/index.ts +16 -0
  111. package/src/i18n.test.ts +31 -0
  112. package/src/index.ts +5 -1
  113. package/src/mui/index.ts +1 -0
  114. package/src/test/fakeCamera.ts +98 -0
  115. package/src/test/fakeDataApi.ts +90 -0
  116. package/src/test/setup.browser.ts +21 -0
  117. package/src/test/setup.ts +15 -0
  118. package/src/useTranslation/index.ts +5 -3
  119. package/src/useTranslation/useTranslation.test.ts +128 -0
  120. package/es/elements/ElementLookupDialog/BarcodeScanner/decoders.test.d.ts +0 -1
  121. package/es/elements/ElementLookupDialog/BarcodeScanner/decoders.test.js +0 -103
  122. package/es/test/setup.d.ts +0 -1
  123. package/es/test/setup.js +0 -6
@@ -0,0 +1,157 @@
1
+ /*
2
+ * Styles for the Designsystemet element components. The package is not scanned by the apps'
3
+ * Tailwind, so everything is a plain class here.
4
+ */
5
+
6
+ @property --ob-hid-angle {
7
+ syntax: "<angle>";
8
+ inherits: false;
9
+ initial-value: 0deg;
10
+ }
11
+
12
+ @keyframes ObElementsHidScanner-move {
13
+ 0% {
14
+ --ob-hid-angle: 0deg;
15
+ }
16
+ 50% {
17
+ --ob-hid-angle: 180deg;
18
+ }
19
+ 100% {
20
+ --ob-hid-angle: 360deg;
21
+ }
22
+ }
23
+
24
+ .ObElementsHidScanner-root {
25
+ height: 100%;
26
+ min-height: 12rem;
27
+ display: flex;
28
+ align-items: center;
29
+ justify-content: center;
30
+ background-color: var(--ds-color-neutral-surface-tinted);
31
+
32
+ &[data-enabled] {
33
+ background-image: linear-gradient(
34
+ var(--ob-hid-angle),
35
+ var(--ds-color-neutral-border-default),
36
+ var(--ds-color-neutral-surface-active),
37
+ var(--ds-color-neutral-border-default)
38
+ );
39
+ animation: ObElementsHidScanner-move 8s linear infinite;
40
+ }
41
+ }
42
+
43
+ .ObElementsLookupDialog-body {
44
+ display: flex;
45
+ flex-direction: column;
46
+ padding: 0;
47
+ min-height: 0;
48
+ overflow: hidden;
49
+
50
+ /* One height for every tab, so the dialog does not jump when the tab changes. */
51
+ @media (min-width: 600px) {
52
+ height: min(40rem, 85dvh);
53
+ }
54
+ }
55
+
56
+ .ObElementsLookupDialog-tabs > [role="tablist"] > * {
57
+ flex: 1;
58
+ flex-direction: column;
59
+ }
60
+
61
+ .ObElementsLookupDialog-source {
62
+ flex: 1 2 14rem;
63
+ min-height: 0;
64
+ }
65
+
66
+ /* The manual form keeps its full height; the element list below gives way first. */
67
+ .ObElementsLookupDialog-manual {
68
+ flex: 0 1 auto;
69
+ min-height: 0;
70
+ padding: var(--ds-size-4);
71
+ overflow-y: auto;
72
+ }
73
+
74
+ .ObElementsLookupDialog-list {
75
+ flex: 3 1 6rem;
76
+ overflow-y: auto;
77
+ }
78
+
79
+ .ObElementsLookupDialog-item {
80
+ transition: background-color 200ms ease-out;
81
+
82
+ &[data-recent] {
83
+ background-color: var(--ds-color-brand-surface-active);
84
+ }
85
+ }
86
+
87
+ .ObElementsLookupDialog-actions,
88
+ .ObElements-buttons {
89
+ display: flex;
90
+ flex-wrap: wrap;
91
+ justify-content: flex-end;
92
+ gap: var(--ds-size-2);
93
+ }
94
+
95
+ .ObElements-form {
96
+ display: flex;
97
+ flex-direction: column;
98
+ align-items: stretch;
99
+ gap: var(--ds-size-4);
100
+ }
101
+
102
+ .ObElements-subtle {
103
+ color: var(--ds-color-neutral-text-subtle);
104
+ }
105
+
106
+ .ObElements-option {
107
+ display: flex;
108
+ flex-direction: column;
109
+
110
+ & > :last-child {
111
+ font-size: 0.875em;
112
+ color: var(--ds-color-neutral-text-subtle);
113
+ }
114
+ }
115
+
116
+ .ObElementsDuplicate-table {
117
+ width: 100%;
118
+
119
+ & td {
120
+ white-space: pre-line;
121
+ vertical-align: top;
122
+ }
123
+ }
124
+
125
+ .ObElementsDuplicate-cards {
126
+ display: flex;
127
+ flex-direction: column;
128
+ gap: var(--ds-size-3);
129
+ }
130
+
131
+ .ObElementsDuplicate-wide {
132
+ @media (max-width: 899.98px) {
133
+ display: none;
134
+ }
135
+ }
136
+
137
+ .ObElementsDuplicate-narrow {
138
+ @media (min-width: 900px) {
139
+ display: none;
140
+ }
141
+ }
142
+
143
+ .ObElementsDuplicate-card dl {
144
+ display: grid;
145
+ grid-template-columns: auto 1fr;
146
+ gap: var(--ds-size-1) var(--ds-size-3);
147
+ margin: 0;
148
+
149
+ & dt {
150
+ font-weight: 500;
151
+ }
152
+
153
+ & dd {
154
+ margin: 0;
155
+ white-space: pre-line;
156
+ }
157
+ }
@@ -0,0 +1,16 @@
1
+ // The element lookup and element damage components on Designsystemet, for apps on the 2026
2
+ // template. Nothing here imports MUI or appframe-mui; "@olenbetong/synergi-react/elements" keeps
3
+ // the MUI versions for the apps that still use them.
4
+ import "./elements-ds.css";
5
+
6
+ export * from "../elements/data/index.js";
7
+ export { dsReportProjects } from "../elements/data/dsReportProjects.js";
8
+ export type { AddElementSource, ElementDetails } from "../elements/ElementLookupDialog/getElement.js";
9
+ export * from "./DescriptionInput.js";
10
+ export * from "./DuplicateElementDamage.js";
11
+ export * from "./ElementLookup.js";
12
+ export * from "./ElementLookupDialog.js";
13
+ export * from "./FormFields.js";
14
+ export * from "./HIDScanner.js";
15
+ export * from "./ManualForm.js";
16
+ export * from "./ProjectSelect.js";
@@ -0,0 +1,31 @@
1
+ import { afterEach, describe, expect, it } from "vitest";
2
+
3
+ import { getLocalizedString, PROJECT } from "./i18n";
4
+
5
+ let globals = globalThis as { af?: unknown };
6
+
7
+ afterEach(() => {
8
+ delete globals.af;
9
+ });
10
+
11
+ describe("getLocalizedString", () => {
12
+ it("returns the text unchanged on a page without af", () => {
13
+ expect(getLocalizedString("Toggle menu")).toBe("Toggle menu");
14
+ });
15
+
16
+ it("uses the package's own project, which the 2026 templates render", () => {
17
+ globals.af = {
18
+ article: { id: "fleet-map", i18n: { "Toggle menu": "Vis meny (artikkel)" } },
19
+ i18n: { "synergi-react": { "Toggle menu": "Vis/skjul meny" } },
20
+ };
21
+
22
+ expect(PROJECT).toBe("synergi-react");
23
+ expect(getLocalizedString("Toggle menu")).toBe("Vis/skjul meny");
24
+ });
25
+
26
+ it("falls back to the article's strings on a legacy template", () => {
27
+ globals.af = { article: { id: "fleet-map", i18n: { "Toggle menu": "Vis meny" } } };
28
+
29
+ expect(getLocalizedString("Toggle menu")).toBe("Vis meny");
30
+ });
31
+ });
package/src/index.ts CHANGED
@@ -43,7 +43,11 @@ export {
43
43
  type SavedFilterTreeProps,
44
44
  } from "./filter/index.js";
45
45
  export { Card, LinkedList, LinkedListItem } from "./components/LinkedCardList/index.js";
46
- export { MergeProgressDialog, type MergeProgressDialogProps } from "./components/MergeProgressDialog/index.js";
46
+ export {
47
+ MergeProgressDialogDs,
48
+ type MergeProgressDialogDsProps,
49
+ } from "./components/MergeProgressDialog/MergeProgressDialogDs.js";
50
+ export { type MergeJobOptions, type MergePhase, useMergeJob } from "./components/MergeProgressDialog/useMergeJob.js";
47
51
  export { type OpenReportOptions, openReport } from "./chrome/openReport.js";
48
52
  export {
49
53
  BannerImage as PageBannerImage,
package/src/mui/index.ts CHANGED
@@ -1 +1,2 @@
1
1
  export { MuiThemeProvider, type MuiThemeProviderProps } from "./MuiThemeProvider.js";
2
+ export { MergeProgressDialog, type MergeProgressDialogProps } from "../components/MergeProgressDialog/index.js";
@@ -0,0 +1,98 @@
1
+ /*
2
+ * An emulated camera for browser tests: a canvas, repainted continuously, whose stream is what
3
+ * `navigator.mediaDevices.getUserMedia` returns. Put generated barcode labels in front of it with
4
+ * `show`, take them away with `clear`. Everything downstream of `getUserMedia` - the `<video>`,
5
+ * the frame loop, the decoder reading the pixels - is the real code.
6
+ */
7
+ import { prepareZXingModule, writeBarcode } from "zxing-wasm/writer";
8
+ import writerWasmUrl from "zxing-wasm/writer/zxing_writer.wasm?url";
9
+ import { vi } from "vitest";
10
+
11
+ prepareZXingModule({
12
+ overrides: {
13
+ locateFile: (path: string, prefix: string) => (path.endsWith(".wasm") ? writerWasmUrl : prefix + path),
14
+ },
15
+ });
16
+
17
+ /** Group separator: some labels put it between the GIAI company prefix and asset reference. */
18
+ export const GS = "\u001d";
19
+
20
+ /**
21
+ * A GS1 DataMatrix for a GIAI (AI 8004), as a conformant label prints it: no separator inside
22
+ * the element string, so a reader sees `8004` + company prefix + asset reference.
23
+ */
24
+ export function createGs1Label(companyPrefix: string, assetReference: string) {
25
+ return createDataMatrix(`(8004)${companyPrefix}${assetReference}`, "gs1");
26
+ }
27
+
28
+ /** A plain DataMatrix whose content separates prefix and reference with GS, the legacy layout. */
29
+ export function createSeparatedLabel(companyPrefix: string, assetReference: string) {
30
+ return createDataMatrix(`8004${companyPrefix}${GS}${assetReference}`);
31
+ }
32
+
33
+ async function createDataMatrix(text: string, options = ""): Promise<ImageBitmap> {
34
+ let result = await writeBarcode(text, { format: "DataMatrix", options, scale: 8 });
35
+
36
+ if (!result.image) {
37
+ throw new Error(`Could not write a DataMatrix for "${text}": ${result.error}`);
38
+ }
39
+
40
+ return createImageBitmap(result.image);
41
+ }
42
+
43
+ type Placement = { image: ImageBitmap; x: number; y: number; size: number };
44
+
45
+ export type FakeCamera = {
46
+ /** Puts a label in view, `size` pixels wide (height to scale) with its top-left corner at `x`, `y`. */
47
+ show(image: ImageBitmap, placement?: Partial<Omit<Placement, "image">>): void;
48
+ /** Takes every label out of view. */
49
+ clear(): void;
50
+ getUserMedia: ReturnType<typeof vi.fn>;
51
+ /** Stops repainting and restores the browser's own media devices. */
52
+ restore(): void;
53
+ };
54
+
55
+ export function installFakeCamera({ width = 640, height = 480 } = {}): FakeCamera {
56
+ let canvas = document.createElement("canvas");
57
+ canvas.width = width;
58
+ canvas.height = height;
59
+ let context = canvas.getContext("2d")!;
60
+ let scene: Placement[] = [];
61
+
62
+ function paint() {
63
+ context.fillStyle = "#fff";
64
+ context.fillRect(0, 0, width, height);
65
+ for (let { image, x, y, size } of scene) {
66
+ context.drawImage(image, x, y, size, (size * image.height) / image.width);
67
+ }
68
+ }
69
+
70
+ // A canvas stream only carries a frame when the canvas is painted, so keep painting.
71
+ paint();
72
+ let timer = setInterval(paint, 1000 / 30);
73
+
74
+ let getUserMedia = vi.fn(async () => canvas.captureStream(30));
75
+ let getUserMediaSpy = vi.spyOn(navigator.mediaDevices, "getUserMedia").mockImplementation(getUserMedia);
76
+ let enumerateSpy = vi
77
+ .spyOn(navigator.mediaDevices, "enumerateDevices")
78
+ .mockResolvedValue([
79
+ { deviceId: "fake-camera", groupId: "", kind: "videoinput", label: "Fake camera", toJSON: () => ({}) },
80
+ ]);
81
+
82
+ return {
83
+ show(image, { size = 280, x = (width - size) / 2, y = (height - (size * image.height) / image.width) / 2 } = {}) {
84
+ scene.push({ image, x, y, size });
85
+ paint();
86
+ },
87
+ clear() {
88
+ scene = [];
89
+ paint();
90
+ },
91
+ getUserMedia,
92
+ restore() {
93
+ clearInterval(timer);
94
+ getUserMediaSpy.mockRestore();
95
+ enumerateSpy.mockRestore();
96
+ },
97
+ };
98
+ }
@@ -0,0 +1,90 @@
1
+ /*
2
+ * A stand-in for the Appframe data API in tests: every data object and `DataProviderHandlerAPI`
3
+ * reads from in-memory tables keyed by view name instead of the server. It understands the filters
4
+ * the components send - `[Col] = 'value'`, `Col LIKE '%text%'`, `AND`, `1=0`, `1=1` - and throws on
5
+ * anything else, so a test notices a query it was not written for.
6
+ */
7
+ import { DataProviderHandlerAPI } from "@olenbetong/appframe-data";
8
+ import { vi } from "vitest";
9
+
10
+ type Row = Record<string, unknown>;
11
+ type Retrieve = { resource: string; whereClause: string; filterString: string };
12
+
13
+ function parseCondition(condition: string): (row: Row) => boolean {
14
+ let text = condition.trim();
15
+ while (text.startsWith("(") && text.endsWith(")")) text = text.slice(1, -1).trim();
16
+ if (text === "1=1" || text === "1 = 1") return () => true;
17
+ if (text === "1=0" || text === "1 = 0" || text === "1=2") return () => false;
18
+
19
+ let equals = /^\[?(\w+)\]?\s*=\s*(?:'([^']*)'|(-?\d+(?:\.\d+)?))$/.exec(text);
20
+ if (equals) {
21
+ let [, column, quoted, number] = equals;
22
+ return (row) => String(row[column] ?? "") === (quoted ?? number);
23
+ }
24
+
25
+ let isNull = /^\[?(\w+)\]?\s+IS\s+(NOT\s+)?NULL$/i.exec(text);
26
+ if (isNull) {
27
+ let [, column, not] = isNull;
28
+ return (row) => (row[column] == null) !== Boolean(not);
29
+ }
30
+
31
+ let like = /^\[?(\w+)\]?\s+LIKE\s+'%([^%']*)%'$/i.exec(text);
32
+ if (like) {
33
+ let [, column, value] = like;
34
+ return (row) =>
35
+ String(row[column] ?? "")
36
+ .toLowerCase()
37
+ .includes(value.toLowerCase());
38
+ }
39
+
40
+ throw new Error(`fakeDataApi does not understand the condition "${text}"`);
41
+ }
42
+
43
+ function matches(row: Row, filter: string | undefined) {
44
+ if (!filter?.trim()) return true;
45
+ return filter.split(/\s+AND\s+/i).every((condition) => parseCondition(condition)(row));
46
+ }
47
+
48
+ export type FakeDataApi = {
49
+ /** Sets the rows a view returns. */
50
+ set(resource: string, rows: Row[]): void;
51
+ /** Every retrieve so far, with its view and filters. */
52
+ retrieves: Retrieve[];
53
+ restore(): void;
54
+ };
55
+
56
+ export function installFakeDataApi(): FakeDataApi {
57
+ let tables = new Map<string, Row[]>();
58
+ let retrieves: Retrieve[] = [];
59
+
60
+ let spy = vi.spyOn(DataProviderHandlerAPI.prototype, "retrieve").mockImplementation(async function (
61
+ this: DataProviderHandlerAPI<Row>,
62
+ parameters: { whereClause?: string; filterString?: string; skip?: number; maxRecords?: number },
63
+ ) {
64
+ let resource = (this as unknown as { _options: { dataSourceId: string } })._options.dataSourceId;
65
+ let whereClause = parameters?.whereClause ?? "";
66
+ let filterString = parameters?.filterString ?? "";
67
+ retrieves.push({ resource, whereClause, filterString });
68
+
69
+ let rows = (tables.get(resource) ?? []).filter((row) => matches(row, whereClause) && matches(row, filterString));
70
+
71
+ // Dynamic-loading (paged) data objects send `skip` and expect a page with the total back.
72
+ if (typeof parameters?.skip === "number") {
73
+ let { skip, maxRecords = -1 } = parameters;
74
+ let data = maxRecords > 0 ? rows.slice(skip, skip + maxRecords) : rows.slice(skip);
75
+ return { data, skip, total: rows.length };
76
+ }
77
+
78
+ return rows;
79
+ } as any);
80
+
81
+ return {
82
+ set(resource, rows) {
83
+ tables.set(resource, rows);
84
+ },
85
+ retrieves,
86
+ restore() {
87
+ spy.mockRestore();
88
+ },
89
+ };
90
+ }
@@ -0,0 +1,21 @@
1
+ // What a 2026 page loads before the app: Designsystemet's theme, styles and web components.
2
+ import "@digdir/designsystemet-css/theme";
3
+ import "@digdir/designsystemet-css";
4
+ import "@digdir/designsystemet-web";
5
+ import "@testing-library/jest-dom/vitest";
6
+
7
+ import { cleanup } from "@testing-library/react";
8
+ import { afterEach } from "vitest";
9
+
10
+ let globals = globalThis as any;
11
+
12
+ // The Appframe globals the components read on a page.
13
+ globals.af = globals.af ?? {
14
+ article: { id: "test", features: {} },
15
+ common: { logError: () => undefined },
16
+ userSession: { culture: "en-GB", domain: "OB", login: "tester" },
17
+ };
18
+
19
+ afterEach(() => {
20
+ cleanup();
21
+ });
package/src/test/setup.ts CHANGED
@@ -1,8 +1,23 @@
1
1
  import "@testing-library/jest-dom/vitest";
2
2
 
3
+ import type { TestingLibraryMatchers } from "@testing-library/jest-dom/matchers";
4
+
3
5
  import { cleanup } from "@testing-library/react";
4
6
  import { afterEach } from "vitest";
5
7
 
6
8
  afterEach(() => {
7
9
  cleanup();
8
10
  });
11
+
12
+ /*
13
+ * jest-dom 7.0.1 types its matchers onto the one-parameter `Assertion<T>` of Vitest 4, which
14
+ * Vitest 5 replaced with `Assertion<R, T>`; custom matchers now go on `Matchers<R, T>`. Until
15
+ * jest-dom ships Vitest 5 types, register them there. Remove this when its `vitest` entry
16
+ * types `Matchers` itself.
17
+ */
18
+ declare module "vitest" {
19
+ interface Matchers<R extends void | Promise<void> = void | Promise<void>, T = unknown> extends TestingLibraryMatchers<
20
+ T,
21
+ R
22
+ > {}
23
+ }
@@ -16,7 +16,7 @@ async function translateText(text: string, target: string, apiKey: string) {
16
16
  let json = await result.json();
17
17
  let { data } = json;
18
18
 
19
- if (data?.translations) {
19
+ if (data?.translations?.length) {
20
20
  let [translation] = data.translations;
21
21
 
22
22
  return {
@@ -25,7 +25,9 @@ async function translateText(text: string, target: string, apiKey: string) {
25
25
  };
26
26
  }
27
27
 
28
- return false;
28
+ // An error answer (invalid key, quota) carries no translations; report it rather than leave
29
+ // the caller translating forever.
30
+ throw new Error(json?.error?.message ?? "The translation service returned no translation.");
29
31
  }
30
32
 
31
33
  export function useTranslation(text: string, targetLanguage: string, apiKey: string) {
@@ -51,7 +53,7 @@ export function useTranslation(text: string, targetLanguage: string, apiKey: str
51
53
 
52
54
  try {
53
55
  let result = await translateText(text, targetLanguage, apiKey);
54
- if (result && textRef.current === text) {
56
+ if (textRef.current === text) {
55
57
  let { from, translation } = result;
56
58
  setSourceLang(from);
57
59
  setTranslation(translation);
@@ -0,0 +1,128 @@
1
+ import { act, renderHook } from "@testing-library/react";
2
+ import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
3
+
4
+ import { useTranslation } from "./index";
5
+
6
+ let fetchMock: ReturnType<typeof vi.fn>;
7
+
8
+ function respond(body: unknown) {
9
+ fetchMock.mockResolvedValueOnce({ json: async () => body });
10
+ }
11
+
12
+ function translated(translatedText: string, detectedSourceLanguage = "ru") {
13
+ return { data: { translations: [{ translatedText, detectedSourceLanguage }] } };
14
+ }
15
+
16
+ /** A fetch that answers only when the test says so. */
17
+ function deferResponse() {
18
+ let answer!: (body: unknown) => void;
19
+ fetchMock.mockReturnValueOnce(
20
+ new Promise((resolve) => {
21
+ answer = (body) => resolve({ json: async () => body });
22
+ }),
23
+ );
24
+ return (body: unknown) => answer(body);
25
+ }
26
+
27
+ beforeEach(() => {
28
+ fetchMock = vi.fn();
29
+ vi.stubGlobal("fetch", fetchMock);
30
+ });
31
+
32
+ afterEach(() => {
33
+ vi.unstubAllGlobals();
34
+ });
35
+
36
+ describe("useTranslation", () => {
37
+ it("does nothing until asked", () => {
38
+ let { result } = renderHook(() => useTranslation("Привет", "nb", "key"));
39
+
40
+ expect(fetchMock).not.toHaveBeenCalled();
41
+ expect(result.current).toMatchObject({ translation: "", from: null, error: null, isTranslating: false });
42
+ });
43
+
44
+ it("translates the text into the target language", async () => {
45
+ respond(translated("Hei"));
46
+ let { result } = renderHook(() => useTranslation("Привет", "nb", "secret"));
47
+
48
+ await act(() => result.current.translate());
49
+
50
+ expect(result.current).toMatchObject({ translation: "Hei", from: "ru", error: null, isTranslating: false });
51
+ let [url, options] = fetchMock.mock.calls[0];
52
+ expect(url).toBe("https://translation.googleapis.com/language/translate/v2?key=secret");
53
+ expect(options.method).toBe("POST");
54
+ expect(JSON.parse(options.body)).toEqual({ q: "Привет", target: "nb" });
55
+ });
56
+
57
+ it("is translating while the request is out", async () => {
58
+ let answer = deferResponse();
59
+ let { result } = renderHook(() => useTranslation("Привет", "nb", "key"));
60
+
61
+ let pending!: Promise<void>;
62
+ act(() => {
63
+ pending = result.current.translate();
64
+ });
65
+ expect(result.current.isTranslating).toBe(true);
66
+
67
+ await act(async () => {
68
+ answer(translated("Hei"));
69
+ await pending;
70
+ });
71
+ expect(result.current.isTranslating).toBe(false);
72
+ });
73
+
74
+ it("reports a network failure", async () => {
75
+ fetchMock.mockRejectedValueOnce(new Error("Failed to fetch"));
76
+ let { result } = renderHook(() => useTranslation("Привет", "nb", "key"));
77
+
78
+ await act(() => result.current.translate());
79
+
80
+ expect(result.current).toMatchObject({ error: "Failed to fetch", isTranslating: false, translation: "" });
81
+ });
82
+
83
+ it("reports an error the translation service answers with, instead of spinning forever", async () => {
84
+ respond({ error: { code: 400, message: "API key not valid. Please pass a valid API key." } });
85
+ let { result } = renderHook(() => useTranslation("Привет", "nb", "wrong"));
86
+
87
+ await act(() => result.current.translate());
88
+
89
+ expect(result.current).toMatchObject({
90
+ error: "API key not valid. Please pass a valid API key.",
91
+ isTranslating: false,
92
+ translation: "",
93
+ });
94
+ });
95
+
96
+ it("clears the translation when the text changes", async () => {
97
+ respond(translated("Hei"));
98
+ let { result, rerender } = renderHook(({ text }) => useTranslation(text, "nb", "key"), {
99
+ initialProps: { text: "Привет" },
100
+ });
101
+ await act(() => result.current.translate());
102
+ expect(result.current.translation).toBe("Hei");
103
+
104
+ rerender({ text: "Пока" });
105
+
106
+ expect(result.current).toMatchObject({ translation: "", from: null, error: null, isTranslating: false });
107
+ });
108
+
109
+ it("drops a translation that arrives after the text has changed", async () => {
110
+ let answer = deferResponse();
111
+ let { result, rerender } = renderHook(({ text }) => useTranslation(text, "nb", "key"), {
112
+ initialProps: { text: "Привет" },
113
+ });
114
+
115
+ let pending!: Promise<void>;
116
+ act(() => {
117
+ pending = result.current.translate();
118
+ });
119
+ rerender({ text: "Пока" });
120
+
121
+ await act(async () => {
122
+ answer(translated("Hei"));
123
+ await pending;
124
+ });
125
+
126
+ expect(result.current).toMatchObject({ translation: "", from: null, isTranslating: false });
127
+ });
128
+ });