@terraware/web-components 5.0.26 → 5.0.27-rc.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 (295) hide show
  1. package/components/AntSwitch/index.js +19 -22
  2. package/components/Autocomplete/Autocomplete.js +106 -130
  3. package/components/Badge/index.js +28 -29
  4. package/components/BusySpinner/index.js +40 -45
  5. package/components/Button/Button.js +41 -47
  6. package/components/Checkbox.js +64 -63
  7. package/components/Confirm/index.js +74 -83
  8. package/components/DatePicker/DatePicker.js +138 -141
  9. package/components/DialogBox/DialogBox.js +111 -118
  10. package/components/Divisor.js +18 -18
  11. package/components/Dropdown.js +66 -94
  12. package/components/EditableTable/index.js +211 -271
  13. package/components/ErrorBox/ErrorBox.js +47 -49
  14. package/components/FileChooser/index.js +117 -135
  15. package/components/FormBottomBar/index.js +75 -84
  16. package/components/Icon/Icon.js +12 -20
  17. package/components/Icon/icons/index.js +256 -256
  18. package/components/IconTooltip/index.js +49 -60
  19. package/components/Map/MapBox.js +545 -452
  20. package/components/Map/MapContainer.js +25 -29
  21. package/components/Map/MapDateSliderControl.js +64 -64
  22. package/components/Map/MapDrawer.js +41 -47
  23. package/components/Map/MapLegend.js +176 -172
  24. package/components/Map/MapViewStyleControl.js +59 -63
  25. package/components/Map/ReactMapboxWrapper.js +3 -2
  26. package/components/Map/index.js +161 -180
  27. package/components/Map/types.js +12 -17
  28. package/components/Map/useMaintainLayerOrder.js +16 -26
  29. package/components/Markdown/index.js +25 -26
  30. package/components/Message/Message.js +73 -76
  31. package/components/MultiSelect/index.js +112 -124
  32. package/components/Navbar/NavFooter.js +9 -13
  33. package/components/Navbar/NavItem.js +70 -76
  34. package/components/Navbar/NavSection.js +17 -19
  35. package/components/Navbar/Navbar.js +39 -46
  36. package/components/Navbar/SubNavbar.js +9 -13
  37. package/components/Note.js +18 -22
  38. package/components/OverlayModal/OverlayModal.js +56 -63
  39. package/components/PageForm/index.js +33 -41
  40. package/components/PhotoChooser/index.js +165 -173
  41. package/components/PhotosCarousel/PhotoSlide.js +32 -35
  42. package/components/PhotosCarousel/index.js +80 -85
  43. package/components/PhotosCarousel/usePhotosCarousel.js +69 -76
  44. package/components/Pill/index.js +41 -45
  45. package/components/PillList/index.js +17 -24
  46. package/components/PlacementWrapper/index.js +38 -59
  47. package/components/PopoverMenu/Popover.js +68 -85
  48. package/components/PopoverMenu/index.js +51 -56
  49. package/components/PopoverMultiSelect/index.js +52 -59
  50. package/components/ProgressCircle/ProgressCircle.js +28 -32
  51. package/components/RadioButton.js +17 -19
  52. package/components/Select/Select.js +13 -15
  53. package/components/Select/SelectT.js +235 -250
  54. package/components/Separator/index.js +14 -17
  55. package/components/Size.js +0 -1
  56. package/components/Slider/index.js +43 -56
  57. package/components/SummaryBox.js +70 -72
  58. package/components/Tabs/index.js +133 -135
  59. package/components/TextTruncated/index.js +117 -130
  60. package/components/Textfield/Textfield.js +158 -190
  61. package/components/Textfield/TruncatedTextArea.js +70 -84
  62. package/components/TimelineSlider/TimelineMarker.js +25 -30
  63. package/components/TimelineSlider/TimelineRail.js +8 -11
  64. package/components/TimelineSlider/index.js +64 -66
  65. package/components/TimelineSliderV2/ClusterBadge.js +25 -29
  66. package/components/TimelineSliderV2/TimelineDot.js +31 -35
  67. package/components/TimelineSliderV2/TimelineRail.js +8 -11
  68. package/components/TimelineSliderV2/index.js +121 -103
  69. package/components/TimelineSliderV2/layout.js +124 -147
  70. package/components/TimelineSliderV2/types.js +0 -1
  71. package/components/Tooltip/Tooltip.js +47 -56
  72. package/components/ViewPhotosDialog/index.js +28 -35
  73. package/components/VirtualWalkthrough/Annotation.js +163 -207
  74. package/components/VirtualWalkthrough/AnnotationEditPane.js +198 -184
  75. package/components/VirtualWalkthrough/AnnotationPanel.js +187 -199
  76. package/components/VirtualWalkthrough/Application.js +31 -34
  77. package/components/VirtualWalkthrough/AutoRotator.js +85 -223
  78. package/components/VirtualWalkthrough/BlockingSpinner.js +26 -28
  79. package/components/VirtualWalkthrough/BoundaryRing.js +30 -34
  80. package/components/VirtualWalkthrough/BoundaryWall.js +32 -36
  81. package/components/VirtualWalkthrough/CameraInfo.js +100 -89
  82. package/components/VirtualWalkthrough/ControlsInfoPane.js +254 -195
  83. package/components/VirtualWalkthrough/GradientSky.js +72 -73
  84. package/components/VirtualWalkthrough/SplatControls.js +209 -221
  85. package/components/VirtualWalkthrough/SplatCrop.js +21 -20
  86. package/components/VirtualWalkthrough/SplatFadeCrop.js +21 -20
  87. package/components/VirtualWalkthrough/SplatModel.js +65 -85
  88. package/components/VirtualWalkthrough/SplatRevealRain.js +41 -46
  89. package/components/VirtualWalkthrough/TfAnnotationManager.js +197 -379
  90. package/components/VirtualWalkthrough/TfXrNavigation.js +73 -162
  91. package/components/VirtualWalkthrough/VirtualWalkthroughViewer.js +438 -431
  92. package/components/VirtualWalkthrough/VrAnnotationPanel.js +18 -22
  93. package/components/VirtualWalkthrough/XrAnnotationInteraction.js +14 -17
  94. package/components/VirtualWalkthrough/XrExitButton.js +14 -17
  95. package/components/VirtualWalkthrough/XrGazeDwell.js +14 -17
  96. package/components/VirtualWalkthrough/XrPointerRay.js +14 -17
  97. package/components/VirtualWalkthrough/XrStartPose.js +67 -121
  98. package/components/VirtualWalkthrough/boundary-ring.js +87 -117
  99. package/components/VirtualWalkthrough/boundary-wall.js +175 -258
  100. package/components/VirtualWalkthrough/camera-adoption.js +18 -64
  101. package/components/VirtualWalkthrough/groundPlane.js +32 -47
  102. package/components/VirtualWalkthrough/gsplat-fade-crop-effect.js +35 -35
  103. package/components/VirtualWalkthrough/splatFormat.js +13 -47
  104. package/components/VirtualWalkthrough/useAdoptedCamera.js +23 -44
  105. package/components/VirtualWalkthrough/useRestartOnVr.js +26 -37
  106. package/components/VirtualWalkthrough/useXrRenderTuning.js +33 -54
  107. package/components/VirtualWalkthrough/vr-annotation-panel-layout.js +67 -99
  108. package/components/VirtualWalkthrough/vr-annotation-panel.js +403 -433
  109. package/components/VirtualWalkthrough/vr-annotation-scroll.js +10 -28
  110. package/components/VirtualWalkthrough/walkthrough-camera.js +204 -329
  111. package/components/VirtualWalkthrough/xr-annotation-candidate-buffer.js +39 -80
  112. package/components/VirtualWalkthrough/xr-annotation-candidates.js +6 -18
  113. package/components/VirtualWalkthrough/xr-annotation-interaction.js +31 -56
  114. package/components/VirtualWalkthrough/xr-annotation-targeting.js +22 -38
  115. package/components/VirtualWalkthrough/xr-button-arming.js +7 -17
  116. package/components/VirtualWalkthrough/xr-button-hold.js +22 -36
  117. package/components/VirtualWalkthrough/xr-exit-button-mask.js +22 -36
  118. package/components/VirtualWalkthrough/xr-exit-button.js +148 -207
  119. package/components/VirtualWalkthrough/xr-face-buttons.js +19 -29
  120. package/components/VirtualWalkthrough/xr-gaze-dwell-state.js +23 -34
  121. package/components/VirtualWalkthrough/xr-gaze-dwell.js +107 -144
  122. package/components/VirtualWalkthrough/xr-interactive-ui.js +12 -24
  123. package/components/VirtualWalkthrough/xr-pointer-ray.js +13 -20
  124. package/components/VirtualWalkthrough/xr-progress-pie-material.js +117 -88
  125. package/components/VirtualWalkthrough/xr-progress-pie.js +1 -10
  126. package/components/VirtualWalkthrough/xr-ray-quad.js +16 -30
  127. package/components/VirtualWalkthrough/xr-render-tuning.js +17 -48
  128. package/components/VirtualWalkthrough/xr-scene-bounds.js +21 -37
  129. package/components/VirtualWalkthrough/xr-start-pose.js +27 -73
  130. package/components/VirtualWalkthrough/xr-teleport-gesture.js +16 -42
  131. package/components/svg/BlobbyGrayIconImage.js +41 -39
  132. package/components/svg/BlobbyGrayIconImport.js +41 -39
  133. package/components/svg/BlobbyGrayIconUploadToTheCloud.js +41 -39
  134. package/components/svg/BlobbyIconCloudChecked.js +202 -164
  135. package/components/svg/BlobbyIconExportOrUploadPhoto.js +202 -164
  136. package/components/svg/BlobbyIconFolder.js +202 -164
  137. package/components/svg/BlobbyIconGraphReport.js +202 -164
  138. package/components/svg/BlobbyIconHappy.js +202 -164
  139. package/components/svg/BlobbyIconHeartMonitor.js +202 -164
  140. package/components/svg/BlobbyIconLeaf.js +202 -164
  141. package/components/svg/BlobbyIconLibrary.js +202 -164
  142. package/components/svg/BlobbyIconNursery.js +204 -166
  143. package/components/svg/BlobbyIconOrganization.js +202 -164
  144. package/components/svg/BlobbyIconParchment.js +202 -164
  145. package/components/svg/BlobbyIconPeople.js +202 -164
  146. package/components/svg/BlobbyIconSeedBank.js +202 -164
  147. package/components/svg/BlobbyIconSeedling.js +202 -164
  148. package/components/svg/BlobbyIconSeeds.js +202 -164
  149. package/components/svg/BlobbyIconSite.js +206 -167
  150. package/components/svg/BlobbyIconSparkles.js +202 -164
  151. package/components/svg/BlobbyIconWrench.js +202 -164
  152. package/components/svg/Bug.js +19 -21
  153. package/components/svg/Calendar.js +19 -21
  154. package/components/svg/CaretDown.js +19 -21
  155. package/components/svg/CaretLeft.js +19 -21
  156. package/components/svg/CaretRight.js +19 -21
  157. package/components/svg/CaretUp.js +19 -21
  158. package/components/svg/ChevronDown.js +19 -21
  159. package/components/svg/ChevronUp.js +19 -21
  160. package/components/svg/Close.js +19 -21
  161. package/components/svg/Critical.js +19 -21
  162. package/components/svg/Edit.js +202 -164
  163. package/components/svg/Error.js +19 -21
  164. package/components/svg/Filter.js +19 -21
  165. package/components/svg/Folder.js +19 -21
  166. package/components/svg/Help.js +19 -21
  167. package/components/svg/Home.js +19 -21
  168. package/components/svg/IconAdd.js +19 -21
  169. package/components/svg/IconArrowRight.js +21 -23
  170. package/components/svg/IconBusinessNetwork.js +19 -21
  171. package/components/svg/IconCalendar.js +19 -21
  172. package/components/svg/IconCancel.js +19 -21
  173. package/components/svg/IconChargingBattery.js +19 -21
  174. package/components/svg/IconChecklist.js +21 -23
  175. package/components/svg/IconCheckmark.js +19 -21
  176. package/components/svg/IconCoinInHand.js +19 -21
  177. package/components/svg/IconColumns.js +19 -21
  178. package/components/svg/IconComment.js +20 -22
  179. package/components/svg/IconDashboard.js +19 -21
  180. package/components/svg/IconDataMigration.js +19 -21
  181. package/components/svg/IconDocument.js +21 -23
  182. package/components/svg/IconDownloadFromTheCloud.js +21 -23
  183. package/components/svg/IconEdit.js +21 -23
  184. package/components/svg/IconExpand.js +21 -23
  185. package/components/svg/IconExport.js +19 -21
  186. package/components/svg/IconExternalLink.js +19 -21
  187. package/components/svg/IconEye.js +19 -21
  188. package/components/svg/IconEyeOff.js +19 -21
  189. package/components/svg/IconFile.js +19 -21
  190. package/components/svg/IconFolder.js +19 -21
  191. package/components/svg/IconFullScreen.js +20 -22
  192. package/components/svg/IconFutures.js +19 -21
  193. package/components/svg/IconGraphReport.js +19 -21
  194. package/components/svg/IconGrid.js +19 -21
  195. package/components/svg/IconHeartMonitor.js +19 -21
  196. package/components/svg/IconHelp.js +21 -23
  197. package/components/svg/IconHistory.js +19 -21
  198. package/components/svg/IconImport.js +19 -21
  199. package/components/svg/IconIndex.js +19 -21
  200. package/components/svg/IconLayers.js +19 -21
  201. package/components/svg/IconLibrary.js +20 -22
  202. package/components/svg/IconList.js +19 -21
  203. package/components/svg/IconLivePlant.js +19 -21
  204. package/components/svg/IconLocations.js +19 -21
  205. package/components/svg/IconMail.js +19 -21
  206. package/components/svg/IconManager.js +19 -21
  207. package/components/svg/IconMap.js +19 -21
  208. package/components/svg/IconMarker.js +19 -21
  209. package/components/svg/IconMenu.js +19 -21
  210. package/components/svg/IconMenuHorizontal.js +19 -21
  211. package/components/svg/IconModule.js +19 -21
  212. package/components/svg/IconMyLocation.js +19 -21
  213. package/components/svg/IconNote.js +21 -23
  214. package/components/svg/IconNursery.js +21 -23
  215. package/components/svg/IconOrg.js +19 -21
  216. package/components/svg/IconParchment.js +19 -21
  217. package/components/svg/IconPhoto.js +19 -21
  218. package/components/svg/IconPlantsFilled.js +19 -21
  219. package/components/svg/IconRedo.js +19 -21
  220. package/components/svg/IconRestorationSite.js +19 -21
  221. package/components/svg/IconSeedBank.js +19 -21
  222. package/components/svg/IconSeedling.js +19 -21
  223. package/components/svg/IconSettings.js +19 -21
  224. package/components/svg/IconSlice.js +19 -21
  225. package/components/svg/IconSubmit.js +19 -21
  226. package/components/svg/IconSubtract.js +21 -23
  227. package/components/svg/IconSynced.js +19 -21
  228. package/components/svg/IconTrashCan.js +19 -21
  229. package/components/svg/IconTreasureMap.js +19 -21
  230. package/components/svg/IconUnavailable.js +19 -21
  231. package/components/svg/IconUndo.js +19 -21
  232. package/components/svg/IconVariable.js +19 -21
  233. package/components/svg/IconVideo.js +30 -31
  234. package/components/svg/IconWifi.js +19 -21
  235. package/components/svg/Info.js +19 -21
  236. package/components/svg/Key.js +19 -21
  237. package/components/svg/Leaf.js +19 -21
  238. package/components/svg/Lock.js +19 -21
  239. package/components/svg/Logo.js +48 -43
  240. package/components/svg/MenuVertical.js +19 -21
  241. package/components/svg/Notification.js +19 -21
  242. package/components/svg/Person.js +19 -21
  243. package/components/svg/Plus.js +19 -21
  244. package/components/svg/RestorationSite.js +19 -21
  245. package/components/svg/Search.js +19 -21
  246. package/components/svg/Seeds.js +19 -21
  247. package/components/svg/Site.js +19 -21
  248. package/components/svg/Sparkles.js +19 -21
  249. package/components/svg/Species.js +19 -21
  250. package/components/svg/Species2.js +202 -164
  251. package/components/svg/Spinner.js +54 -48
  252. package/components/svg/Star.js +19 -21
  253. package/components/svg/Success.js +19 -21
  254. package/components/svg/SuccessFilled.js +19 -21
  255. package/components/svg/TerrawareLogoDesktop.js +55 -49
  256. package/components/svg/TerrawareLogoMobile.js +25 -26
  257. package/components/svg/Touchscreen.js +19 -21
  258. package/components/svg/UploadCloud.js +202 -164
  259. package/components/svg/Warning.js +19 -21
  260. package/components/svg/WelcomeClipboard.js +156 -133
  261. package/components/svg/index.js +129 -129
  262. package/components/table/EnhancedTableToolbar.js +68 -74
  263. package/components/table/EnhancedTableToolbarV2.js +31 -41
  264. package/components/table/TableCellRenderer.js +196 -231
  265. package/components/table/TableHeader.js +71 -73
  266. package/components/table/TableHeaderItem.js +97 -102
  267. package/components/table/density.js +18 -19
  268. package/components/table/index.js +350 -369
  269. package/components/table/sort.js +27 -52
  270. package/components/table/types.js +0 -1
  271. package/components/types/index.js +0 -1
  272. package/hooks/cameraEntityContext.js +2 -13
  273. package/hooks/useBoolean.js +17 -13
  274. package/hooks/useCameraPosition.js +56 -56
  275. package/hooks/useDevicePerformance.js +17 -17
  276. package/hooks/useXr.js +85 -87
  277. package/index.js +58 -58
  278. package/package.json +1 -1
  279. package/setupTests.js +0 -4
  280. package/strings/export.js +111 -170
  281. package/strings/index.js +25 -54
  282. package/strings/locales.js +21 -41
  283. package/strings/strings-en.js +49 -51
  284. package/strings/strings-es.js +49 -51
  285. package/strings/strings-fr.js +49 -51
  286. package/strings/strings-gx.js +49 -51
  287. package/style-dictionary-dist/TerrawareTheme.js +186 -186
  288. package/theme.js +74 -76
  289. package/utils/color.js +8 -15
  290. package/utils/date.js +42 -108
  291. package/utils/index.js +4 -4
  292. package/utils/preventDefaultEvent.js +3 -3
  293. package/utils/text.js +11 -11
  294. package/utils/useDeviceInfo.js +42 -79
  295. package/virtualWalkthrough.js +23 -23
package/strings/export.js CHANGED
@@ -1,186 +1,127 @@
1
- import { parse } from 'csv-parse/sync';
2
- import { readdir, readFile, writeFile } from 'node:fs/promises';
3
- import path from 'node:path';
4
- import { resolveConfig, format } from 'prettier';
5
-
6
- /**
7
- * Renders the CSV string tables as TypeScript source, and finds keys in them that no source file
8
- * references.
9
- *
10
- * This runs at build time, not at runtime. Nothing in the component runtime imports it, so its Node
11
- * and CSV dependencies never reach a browser bundle. It's published rather than kept in scripts/ so
12
- * that applications sharing these string tables can drive the same conversion and checks.
13
- */
1
+ import { parse } from "csv-parse/sync";
2
+ import { readFile, readdir, writeFile } from "node:fs/promises";
3
+ import node_path from "node:path";
4
+ import { format, resolveConfig } from "prettier";
14
5
  const GENERATED_HEADER = '/* Generated from the CSV files in csv/ by `yarn generate-strings`. Do not edit. */';
15
-
16
- /**
17
- * Loads a CSV strings file into an object, taking keys and values from the first two columns.
18
- */
19
- const csvToStrings = csvData => {
20
- const rows = parse(csvData, {
21
- // Skip header row
22
- from: 2,
23
- // Only rows for strings that have comments have 3 fields.
24
- relax_column_count_less: true,
25
- // Skip empty "row" that is really just the terminating linefeed
26
- skip_empty_lines: true
27
- });
28
- return rows.reduce((result, row) => {
29
- result[row[0]] = row[1];
30
- return result;
31
- }, {});
6
+ const csvToStrings = (csvData)=>{
7
+ const rows = parse(csvData, {
8
+ from: 2,
9
+ relax_column_count_less: true,
10
+ skip_empty_lines: true
11
+ });
12
+ return rows.reduce((result, row)=>{
13
+ result[row[0]] = row[1];
14
+ return result;
15
+ }, {});
32
16
  };
33
-
34
- /**
35
- * Renders a strings object as a TypeScript module that exports a constant called "strings",
36
- * formatted the way the repository's Prettier configuration wants it so that generating a table and
37
- * formatting the tree don't fight over the result.
38
- */
39
- const stringsToTypeScript = async (stringsMap, targetPath) => {
40
- const source = `${GENERATED_HEADER}\nexport const strings = ${JSON.stringify(stringsMap, null, 2)};\n`;
41
- const prettierConfig = await resolveConfig(targetPath);
42
- return format(source, {
43
- ...prettierConfig,
44
- filepath: targetPath
45
- });
17
+ const stringsToTypeScript = async (stringsMap, targetPath)=>{
18
+ const source = `${GENERATED_HEADER}\nexport const strings = ${JSON.stringify(stringsMap, null, 2)};\n`;
19
+ const prettierConfig = await resolveConfig(targetPath);
20
+ return format(source, {
21
+ ...prettierConfig,
22
+ filepath: targetPath
23
+ });
46
24
  };
47
-
48
- /**
49
- * Transforms the English strings table into gibberish, which makes untranslated text obvious
50
- * without waiting on a translation.
51
- *
52
- * 1. Split the English string into whitespace-delimited words.
53
- * 2. Reverse the order of the words.
54
- * 3. Render each word as a base64 encoding of its UTF-8 representation, except for words that look
55
- * like format string placeholders.
56
- */
57
- const generateGibberish = english => Object.fromEntries(Object.entries(english).map(([key, value]) => [key, value.split(' ').reverse().map(word => word.startsWith('{') ? word : Buffer.from(word, 'utf-8').toString('base64').replace(/=/g, '')).join(' ')]));
58
- const exportStrings = async (englishStrings, localizedStrings, locale, targetDir, defaultToEnglish) => {
59
- const stringsMap = {};
60
- for (const key of Object.keys(englishStrings)) {
61
- if (key in localizedStrings) {
62
- stringsMap[key] = localizedStrings[key];
63
- } else {
64
- console.warn(`Locale ${locale} has no translation for ${key}`);
65
- if (defaultToEnglish) {
66
- stringsMap[key] = englishStrings[key];
67
- }
25
+ const generateGibberish = (english)=>Object.fromEntries(Object.entries(english).map(([key, value])=>[
26
+ key,
27
+ value.split(' ').reverse().map((word)=>word.startsWith('{') ? word : Buffer.from(word, 'utf-8').toString('base64').replace(/=/g, '')).join(' ')
28
+ ]));
29
+ const exportStrings = async (englishStrings, localizedStrings, locale, targetDir, defaultToEnglish)=>{
30
+ const stringsMap = {};
31
+ for (const key of Object.keys(englishStrings))if (key in localizedStrings) stringsMap[key] = localizedStrings[key];
32
+ else {
33
+ console.warn(`Locale ${locale} has no translation for ${key}`);
34
+ if (defaultToEnglish) stringsMap[key] = englishStrings[key];
68
35
  }
69
- }
70
- const targetPath = path.resolve(targetDir, `strings-${locale}.ts`);
71
- await writeFile(targetPath, await stringsToTypeScript(stringsMap, targetPath), {
72
- encoding: 'utf-8'
73
- });
36
+ const targetPath = node_path.resolve(targetDir, `strings-${locale}.ts`);
37
+ await writeFile(targetPath, await stringsToTypeScript(stringsMap, targetPath), {
38
+ encoding: 'utf-8'
39
+ });
74
40
  };
75
-
76
- /**
77
- * Converts a CSV strings file to a TypeScript source file that exports a constant called "strings".
78
- * This will be an object that has the same keys as the English strings file; the English strings
79
- * will be used for any keys that aren't translated yet.
80
- *
81
- * The filename is assumed to be the locale code with a ".csv" suffix. Converting the English file
82
- * also writes the gibberish table, which is derived from English rather than translated.
83
- */
84
- const convertCsvFile = async (csvPath, targetDir, defaultToEnglish = true) => {
85
- if (!csvPath.endsWith('.csv')) {
86
- throw new Error('Cannot convert a non-CSV file');
87
- }
88
- const locale = path.basename(csvPath, '.csv');
89
- const stringsMap = csvToStrings(await readFile(csvPath, {
90
- encoding: 'utf-8'
91
- }));
92
- let englishStringsMap;
93
- if (locale === 'en') {
94
- englishStringsMap = stringsMap;
95
- } else {
96
- const englishPath = path.resolve(path.dirname(csvPath), 'en.csv');
97
- englishStringsMap = csvToStrings(await readFile(englishPath, {
98
- encoding: 'utf-8'
41
+ const convertCsvFile = async (csvPath, targetDir, defaultToEnglish = true)=>{
42
+ if (!csvPath.endsWith('.csv')) throw new Error('Cannot convert a non-CSV file');
43
+ const locale = node_path.basename(csvPath, '.csv');
44
+ const stringsMap = csvToStrings(await readFile(csvPath, {
45
+ encoding: 'utf-8'
99
46
  }));
100
- }
101
- await exportStrings(englishStringsMap, stringsMap, locale, targetDir, defaultToEnglish);
102
- if (locale === 'en') {
103
- await exportStrings(englishStringsMap, generateGibberish(englishStringsMap), 'gx', targetDir, defaultToEnglish);
104
- }
47
+ let englishStringsMap;
48
+ if ('en' === locale) englishStringsMap = stringsMap;
49
+ else {
50
+ const englishPath = node_path.resolve(node_path.dirname(csvPath), 'en.csv');
51
+ englishStringsMap = csvToStrings(await readFile(englishPath, {
52
+ encoding: 'utf-8'
53
+ }));
54
+ }
55
+ await exportStrings(englishStringsMap, stringsMap, locale, targetDir, defaultToEnglish);
56
+ if ('en' === locale) await exportStrings(englishStringsMap, generateGibberish(englishStringsMap), 'gx', targetDir, defaultToEnglish);
105
57
  };
106
-
107
- /**
108
- * Converts the CSV files for all locales to TypeScript source files. The list of locales is
109
- * determined by the presence of CSV files.
110
- */
111
- const convertAllLocales = async (csvDir, stringsDir, defaultToEnglish = true) => {
112
- const csvFiles = (await readdir(csvDir)).filter(filename => filename.endsWith('.csv'));
113
- await Promise.all(csvFiles.map(filename => convertCsvFile(path.join(csvDir, filename), stringsDir, defaultToEnglish)));
114
- return csvFiles;
58
+ const convertAllLocales = async (csvDir, stringsDir, defaultToEnglish = true)=>{
59
+ const csvFiles = (await readdir(csvDir)).filter((filename)=>filename.endsWith('.csv'));
60
+ await Promise.all(csvFiles.map((filename)=>convertCsvFile(node_path.join(csvDir, filename), stringsDir, defaultToEnglish)));
61
+ return csvFiles;
115
62
  };
116
- const DEFAULT_EXTENSIONS = ['.ts', '.js', '.tsx', '.jsx'];
117
- const DEFAULT_EXCLUDED_DIRECTORIES = ['strings'];
118
- const findSourceFiles = async (directory, extensions = DEFAULT_EXTENSIONS, excludedDirectories = DEFAULT_EXCLUDED_DIRECTORIES) => {
119
- const entries = await readdir(directory, {
120
- withFileTypes: true
121
- });
122
- const nested = await Promise.all(entries.map(async entry => {
123
- const entryPath = path.join(directory, entry.name);
124
- if (entry.isDirectory()) {
125
- return excludedDirectories.includes(entry.name) ? [] : findSourceFiles(entryPath, extensions, excludedDirectories);
126
- }
127
- return extensions.includes(path.extname(entry.name)) ? [entryPath] : [];
128
- }));
129
- return nested.flat().sort();
63
+ const DEFAULT_EXTENSIONS = [
64
+ '.ts',
65
+ '.js',
66
+ '.tsx',
67
+ '.jsx'
68
+ ];
69
+ const DEFAULT_EXCLUDED_DIRECTORIES = [
70
+ 'strings'
71
+ ];
72
+ const findSourceFiles = async (directory, extensions = DEFAULT_EXTENSIONS, excludedDirectories = DEFAULT_EXCLUDED_DIRECTORIES)=>{
73
+ const entries = await readdir(directory, {
74
+ withFileTypes: true
75
+ });
76
+ const nested = await Promise.all(entries.map(async (entry)=>{
77
+ const entryPath = node_path.join(directory, entry.name);
78
+ if (entry.isDirectory()) return excludedDirectories.includes(entry.name) ? [] : findSourceFiles(entryPath, extensions, excludedDirectories);
79
+ return extensions.includes(node_path.extname(entry.name)) ? [
80
+ entryPath
81
+ ] : [];
82
+ }));
83
+ return nested.flat().sort();
130
84
  };
131
85
  const STRINGS_PROPERTY_ACCESS = /\bstrings\s*\??\.\s*(\w+)/g;
132
86
  const STRINGS_INDEX_ACCESS = /\bstrings\s*(?:\?\.)?\s*\[([^\]]*)\]/g;
133
87
  const QUOTED_KEY = /(['"`])(\w+)\1/g;
134
-
135
- /**
136
- * Returns the keys a source file reads from the strings table, either as properties
137
- * (strings.SAVE) or as quoted keys inside an index expression (strings[isRead ? 'READ' : 'UNREAD']).
138
- */
139
- const findAccessedKeys = source => [...Array.from(source.matchAll(STRINGS_PROPERTY_ACCESS), match => match[1]), ...Array.from(source.matchAll(STRINGS_INDEX_ACCESS)).flatMap(match => Array.from(match[1].matchAll(QUOTED_KEY), literal => literal[2]))];
140
- const classifyKeys = (keys, sources) => {
141
- const accessedKeys = new Set(sources.flatMap(findAccessedKeys));
142
- const identifiers = new Set(sources.flatMap(source => source.match(/\w+/g) ?? []));
143
- const unused = [];
144
- const possiblyUnused = [];
145
- keys.forEach(key => {
146
- if (accessedKeys.has(key)) {
147
- return;
148
- }
149
- if (identifiers.has(key)) {
150
- possiblyUnused.push(key);
151
- } else {
152
- unused.push(key);
153
- }
154
- });
155
- return {
156
- unused,
157
- possiblyUnused
158
- };
88
+ const findAccessedKeys = (source)=>[
89
+ ...Array.from(source.matchAll(STRINGS_PROPERTY_ACCESS), (match)=>match[1]),
90
+ ...Array.from(source.matchAll(STRINGS_INDEX_ACCESS)).flatMap((match)=>Array.from(match[1].matchAll(QUOTED_KEY), (literal)=>literal[2]))
91
+ ];
92
+ const classifyKeys = (keys, sources)=>{
93
+ const accessedKeys = new Set(sources.flatMap(findAccessedKeys));
94
+ const identifiers = new Set(sources.flatMap((source)=>source.match(/\w+/g) ?? []));
95
+ const unused = [];
96
+ const possiblyUnused = [];
97
+ keys.forEach((key)=>{
98
+ if (accessedKeys.has(key)) return;
99
+ if (identifiers.has(key)) possiblyUnused.push(key);
100
+ else unused.push(key);
101
+ });
102
+ return {
103
+ unused,
104
+ possiblyUnused
105
+ };
159
106
  };
160
- const findUnusedStrings = async ({
161
- csvPath,
162
- sourceDir,
163
- extensions,
164
- excludedDirectories
165
- }) => {
166
- const keys = Object.keys(csvToStrings(await readFile(csvPath, {
167
- encoding: 'utf-8'
168
- })));
169
- const files = await findSourceFiles(sourceDir, extensions, excludedDirectories);
170
- const sources = await Promise.all(files.map(file => readFile(file, {
171
- encoding: 'utf-8'
172
- })));
173
- return classifyKeys(keys, sources);
107
+ const findUnusedStrings = async ({ csvPath, sourceDir, extensions, excludedDirectories })=>{
108
+ const keys = Object.keys(csvToStrings(await readFile(csvPath, {
109
+ encoding: 'utf-8'
110
+ })));
111
+ const files = await findSourceFiles(sourceDir, extensions, excludedDirectories);
112
+ const sources = await Promise.all(files.map((file)=>readFile(file, {
113
+ encoding: 'utf-8'
114
+ })));
115
+ return classifyKeys(keys, sources);
174
116
  };
175
- const formatUnusedStrings = ({
176
- unused,
177
- possiblyUnused
178
- }) => {
179
- const lines = unused.length === 0 ? ['No unused entries found.'] : ['Unused entries found:', ...unused];
180
- if (possiblyUnused.length > 0) {
181
- lines.push('', 'Possibly unused entries (never read from strings, but the name appears elsewhere; check manually):', ...possiblyUnused);
182
- }
183
- return `${lines.join('\n')}\n`;
117
+ const formatUnusedStrings = ({ unused, possiblyUnused })=>{
118
+ const lines = 0 === unused.length ? [
119
+ 'No unused entries found.'
120
+ ] : [
121
+ 'Unused entries found:',
122
+ ...unused
123
+ ];
124
+ if (possiblyUnused.length > 0) lines.push('', 'Possibly unused entries (never read from strings, but the name appears elsewhere; check manually):', ...possiblyUnused);
125
+ return `${lines.join('\n')}\n`;
184
126
  };
185
-
186
127
  export { classifyKeys, convertAllLocales, convertCsvFile, csvToStrings, findAccessedKeys, findSourceFiles, findUnusedStrings, formatUnusedStrings, generateGibberish, stringsToTypeScript };
package/strings/index.js CHANGED
@@ -1,62 +1,33 @@
1
- import { useSyncExternalStore } from 'react';
2
- import { findLocaleDetails, supportedLocales } from './locales.js';
3
- import { strings } from './strings-en.js';
4
- import { strings as strings$3 } from './strings-es.js';
5
- import { strings as strings$2 } from './strings-fr.js';
6
- import { strings as strings$1 } from './strings-gx.js';
7
-
8
- /**
9
- * The set of strings every locale provides. The English table is the source of truth for the list
10
- * of keys.
11
- */
12
-
1
+ import { useSyncExternalStore } from "react";
2
+ import { findLocaleDetails, supportedLocales } from "./locales.js";
3
+ import { strings } from "./strings-en.js";
4
+ import { strings as external_strings_es_js_strings } from "./strings-es.js";
5
+ import { strings as external_strings_fr_js_strings } from "./strings-fr.js";
6
+ import { strings as external_strings_gx_js_strings } from "./strings-gx.js";
13
7
  const tables = {
14
- en: strings,
15
- es: strings$3,
16
- fr: strings$2,
17
- gx: strings$1
8
+ en: strings,
9
+ es: external_strings_es_js_strings,
10
+ fr: external_strings_fr_js_strings,
11
+ gx: external_strings_gx_js_strings
18
12
  };
19
-
20
- /**
21
- * Locales we have a bundled string table for. A locale can be supported -- listed in a locale
22
- * selector -- before its table lands, and resolving against the tables we actually have keeps
23
- * `getLocale` and `getStrings` describing the same language.
24
- */
25
- const localesWithTables = () => supportedLocales.filter(locale => locale.id in tables);
13
+ const localesWithTables = ()=>supportedLocales.filter((locale)=>locale.id in tables);
26
14
  let currentLocale = 'en';
27
15
  let currentStrings = strings;
28
16
  const listeners = new Set();
29
-
30
- /**
31
- * Sets the locale these components render in. Consumers own the locale -- a component library has
32
- * no reliable way to know whether the browser's language or a user's profile setting should win --
33
- * so nothing here changes until an application calls this. Accepts a bare language tag or one with
34
- * a region ('es' or 'es-MX').
35
- */
36
- const setLocale = locale => {
37
- const resolved = findLocaleDetails(localesWithTables(), locale).id;
38
- if (resolved === currentLocale) {
39
- return;
40
- }
41
- currentLocale = resolved;
42
- currentStrings = tables[resolved] ?? strings;
43
- listeners.forEach(notify => notify());
17
+ const setLocale = (locale)=>{
18
+ const resolved = findLocaleDetails(localesWithTables(), locale).id;
19
+ if (resolved === currentLocale) return;
20
+ currentLocale = resolved;
21
+ currentStrings = tables[resolved] ?? strings;
22
+ listeners.forEach((notify)=>notify());
44
23
  };
45
-
46
- /** The resolved locale, which is also the locale to hand to Intl and other formatters. */
47
- const getLocale = () => currentLocale;
48
-
49
- /**
50
- * The current string table. For components, prefer `useStrings`, which re-renders on a locale
51
- * change; this is for the imperative code that can't hold a hook, such as PlayCanvas scripts.
52
- */
53
- const getStrings = () => currentStrings;
54
- const subscribe = notify => {
55
- listeners.add(notify);
56
- return () => {
57
- listeners.delete(notify);
58
- };
24
+ const getLocale = ()=>currentLocale;
25
+ const getStrings = ()=>currentStrings;
26
+ const subscribe = (notify)=>{
27
+ listeners.add(notify);
28
+ return ()=>{
29
+ listeners.delete(notify);
30
+ };
59
31
  };
60
- const useStrings = () => useSyncExternalStore(subscribe, getStrings, getStrings);
61
-
32
+ const useStrings = ()=>useSyncExternalStore(subscribe, getStrings, getStrings);
62
33
  export { getLocale, getStrings, setLocale, useStrings };
@@ -1,42 +1,22 @@
1
- /** Supported locales in the order they should appear in a locale selector. */
2
- const supportedLocales = [{
3
- id: 'en',
4
- name: 'English'
5
- }, {
6
- id: 'es',
7
- name: 'Español'
8
- }, {
9
- id: 'fr',
10
- name: 'Français'
11
- }, {
12
- id: 'gx',
13
- name: 'Gibberish',
14
- inDevelopment: true
15
- }];
16
-
17
- /**
18
- * Returns the locales that should be offered to users. Locales still in development are left out
19
- * unless they're asked for, which is how a consumer exposes them outside of production.
20
- */
21
- const getSupportedLocales = (includeInDevelopment = false) => includeInDevelopment ? supportedLocales : supportedLocales.filter(locale => !locale.inDevelopment);
22
-
23
- /**
24
- * Returns the locale from a list of locales that matches the user's selected language.
25
- *
26
- * The user's locale can include both a language and a country code, but entries in a list of
27
- * languages usually don't have country codes. So we need to find the entry that is the longest
28
- * prefix of the user's locale.
29
- *
30
- * If the locale is es-MX and the list of locales only has es, we want the es item to be selected.
31
- * But if the locale is zh-CN and the list has both zh-CN and zh-TW, we want zh-CN to be selected.
32
- *
33
- * If none of the locales in the list matches, returns the first locale from the list. The list
34
- * must not be empty.
35
- */
36
- const findLocaleDetails = (locales, locale) => locales.reduce((bestMatch, candidate) =>
37
- // The best match so far is only worth keeping if it's a prefix of the requested locale too.
38
- // reduce() seeds with the first locale without checking it, so a leading 'en-US' would
39
- // otherwise be treated as a match for 'en' and never replaced.
40
- locale.startsWith(candidate.id) && (!locale.startsWith(bestMatch.id) || candidate.id.length > bestMatch.id.length) ? candidate : bestMatch);
41
-
1
+ const supportedLocales = [
2
+ {
3
+ id: 'en',
4
+ name: 'English'
5
+ },
6
+ {
7
+ id: 'es',
8
+ name: 'Español'
9
+ },
10
+ {
11
+ id: 'fr',
12
+ name: 'Français'
13
+ },
14
+ {
15
+ id: 'gx',
16
+ name: 'Gibberish',
17
+ inDevelopment: true
18
+ }
19
+ ];
20
+ const getSupportedLocales = (includeInDevelopment = false)=>includeInDevelopment ? supportedLocales : supportedLocales.filter((locale)=>!locale.inDevelopment);
21
+ const findLocaleDetails = (locales, locale)=>locales.reduce((bestMatch, candidate)=>locale.startsWith(candidate.id) && (!locale.startsWith(bestMatch.id) || candidate.id.length > bestMatch.id.length) ? candidate : bestMatch);
42
22
  export { findLocaleDetails, getSupportedLocales, supportedLocales };
@@ -1,54 +1,52 @@
1
- /* Generated from the CSV files in csv/ by `yarn generate-strings`. Do not edit. */
2
1
  const strings = {
3
- ADD_ANNOTATION: 'Add Annotation',
4
- ANNOTATION_DESCRIPTION_TOOLTIP: 'Additional details or context about this annotation',
5
- ANNOTATION_LABEL_TOOLTIP: 'Short identifier displayed on the annotation hotspot',
6
- ANNOTATION_TITLE_TOOLTIP: 'Main heading for the annotation',
7
- ANNOTATIONS: 'Annotations',
8
- AR: 'AR',
9
- ARROW_KEYS: 'Arrow Keys',
10
- AUTO_ROTATE: 'Auto Rotate',
11
- BOUNDED_FLY: 'Bounded-fly',
12
- CAMERA_FOCUS_POINT: 'Focus Point',
13
- CAMERA_INFO: 'Camera Info',
14
- CAMERA_POSITION: 'Position',
15
- CANCEL: 'Cancel',
16
- CHOOSE_FILE: 'Choose File...',
17
- CONTROLS: 'Controls',
18
- CTRL: 'Ctrl',
19
- DELETE_ANNOTATION: 'Delete Annotation',
20
- DESCRIPTION: 'Description',
21
- DESELECT_ANNOTATION: 'Deselect Annotation',
22
- EDIT: 'Edit',
23
- EDIT_ANNOTATION: 'Edit Annotation',
24
- EXISTING: 'Existing',
25
- FILE_SELECTED: 'File Selected',
26
- FLY: 'Fly',
27
- FLY_FASTER: 'Fly faster',
28
- FLY_SLOWER: 'Fly slower',
29
- FREE_FLY: 'Free-fly',
30
- IMAGES: 'Images',
31
- LABEL: 'Label',
32
- LEFT_MOUSE: 'Left Mouse',
33
- LOOK: 'Look',
34
- MIDDLE_MOUSE: 'Middle Mouse',
35
- MOUSE_WHEEL: 'Mouse Wheel',
36
- NEW: 'New',
37
- ORBIT: 'Orbit',
38
- PAN: 'Pan',
39
- PINCH: 'Pinch',
40
- REPLACE_FILE: 'Replace File...',
41
- RESET_CAMERA: 'Reset Camera',
42
- RIGHT_MOUSE: 'Right Mouse',
43
- SAVE: 'Save',
44
- SHIFT: 'Shift',
45
- SWIPE: 'Swipe',
46
- TITLE: 'Title',
47
- TOUCH_DRAG: 'Touch + Drag',
48
- UPLOAD_FILES: 'Upload Files',
49
- UPLOAD_FILES_DESCRIPTION: 'Browse or drag and drop files.',
50
- VR: 'VR',
51
- ZOOM: 'Zoom'
2
+ ADD_ANNOTATION: 'Add Annotation',
3
+ ANNOTATION_DESCRIPTION_TOOLTIP: 'Additional details or context about this annotation',
4
+ ANNOTATION_LABEL_TOOLTIP: 'Short identifier displayed on the annotation hotspot',
5
+ ANNOTATION_TITLE_TOOLTIP: 'Main heading for the annotation',
6
+ ANNOTATIONS: 'Annotations',
7
+ AR: 'AR',
8
+ ARROW_KEYS: 'Arrow Keys',
9
+ AUTO_ROTATE: 'Auto Rotate',
10
+ BOUNDED_FLY: 'Bounded-fly',
11
+ CAMERA_FOCUS_POINT: 'Focus Point',
12
+ CAMERA_INFO: 'Camera Info',
13
+ CAMERA_POSITION: 'Position',
14
+ CANCEL: 'Cancel',
15
+ CHOOSE_FILE: 'Choose File...',
16
+ CONTROLS: 'Controls',
17
+ CTRL: 'Ctrl',
18
+ DELETE_ANNOTATION: 'Delete Annotation',
19
+ DESCRIPTION: "Description",
20
+ DESELECT_ANNOTATION: 'Deselect Annotation',
21
+ EDIT: 'Edit',
22
+ EDIT_ANNOTATION: 'Edit Annotation',
23
+ EXISTING: 'Existing',
24
+ FILE_SELECTED: 'File Selected',
25
+ FLY: 'Fly',
26
+ FLY_FASTER: 'Fly faster',
27
+ FLY_SLOWER: 'Fly slower',
28
+ FREE_FLY: 'Free-fly',
29
+ IMAGES: 'Images',
30
+ LABEL: 'Label',
31
+ LEFT_MOUSE: 'Left Mouse',
32
+ LOOK: 'Look',
33
+ MIDDLE_MOUSE: 'Middle Mouse',
34
+ MOUSE_WHEEL: 'Mouse Wheel',
35
+ NEW: 'New',
36
+ ORBIT: 'Orbit',
37
+ PAN: 'Pan',
38
+ PINCH: 'Pinch',
39
+ REPLACE_FILE: 'Replace File...',
40
+ RESET_CAMERA: 'Reset Camera',
41
+ RIGHT_MOUSE: 'Right Mouse',
42
+ SAVE: 'Save',
43
+ SHIFT: 'Shift',
44
+ SWIPE: 'Swipe',
45
+ TITLE: 'Title',
46
+ TOUCH_DRAG: 'Touch + Drag',
47
+ UPLOAD_FILES: 'Upload Files',
48
+ UPLOAD_FILES_DESCRIPTION: 'Browse or drag and drop files.',
49
+ VR: 'VR',
50
+ ZOOM: 'Zoom'
52
51
  };
53
-
54
52
  export { strings };