@terraware/web-components 4.3.3 → 5.0.0

package/index.js

@@ -52,4 +52,6 @@ export { index as Svg };
 export { default as Table } from './components/table/index.js';
 export { CellDateRenderer, default as CellRenderer } from './components/table/TableCellRenderer.js';
 export { descendingComparator, getComparator, stableSort } from './components/table/sort.js';
+export { getLocale, getStrings, setLocale, useStrings } from './strings/index.js';
+export { findLocaleDetails, getSupportedLocales, supportedLocales } from './strings/locales.js';
 export { default as theme } from './theme.js';

package/license-report.html

@@ -48,6 +48,6 @@ td {
 }
 
 </style>
-<table><thead><tr><th class="string">department</th><th class="string">related to</th><th class="string">name</th><th class="string">license period</th><th class="string">material / not material</th><th class="string">license type</th><th class="string">link</th><th class="string">remote version</th><th class="string">installed version</th><th class="string">defined version</th><th class="string">author</th></tr></thead><tbody><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">@dnd-kit/core</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/clauderic/dnd-kit.git</td><td class="string">6.3.1</td><td class="string">6.3.1</td><td class="string">^6.0.7</td><td class="string">Claudéric Demers</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">@dnd-kit/sortable</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/clauderic/dnd-kit.git</td><td class="string">10.0.0</td><td class="string">10.0.0</td><td class="string">^10.0.0</td><td class="string">Claudéric Demers</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">@emotion/react</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/emotion-js/emotion.git#main</td><td class="string">11.14.0</td><td class="string">11.14.0</td><td class="string">^11.11.3</td><td class="string">Emotion Contributors</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">@emotion/styled</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/emotion-js/emotion.git#main</td><td class="string">11.14.1</td><td class="string">11.14.1</td><td class="string">^11.11.3</td><td class="string">n/a</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">@mui/icons-material</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/mui/material-ui.git</td><td class="string">6.5.0</td><td class="string">6.5.0</td><td class="string">^6.0.0</td><td class="string">MUI Team</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">@mui/lab</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/mui/material-ui.git</td><td class="string">6.0.1-beta.36</td><td class="string">6.0.1-beta.36</td><td class="string">^6.0.1-beta.36</td><td class="string">MUI Team</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">@mui/material</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/mui/material-ui.git</td><td class="string">6.5.0</td><td class="string">6.5.0</td><td class="string">^6.0.0</td><td class="string">MUI Team</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">@mui/x-date-pickers</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/mui/mui-x.git</td><td class="string">7.29.4</td><td class="string">7.29.4</td><td class="string">^7.22.0</td><td class="string">MUI Team</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">@playcanvas/react</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/playcanvas/react.git</td><td class="string">0.11.5</td><td class="string">0.11.5</td><td class="string">0.11.5</td><td class="string">n/a</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">classnames</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/JedWatson/classnames.git</td><td class="string">2.5.1</td><td class="string">2.5.1</td><td class="string">^2.3.2</td><td class="string">Jed Watson</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">geojson</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">http://github.com/caseycesari/geojson.js.git</td><td class="string">0.5.0</td><td class="string">0.5.0</td><td class="string">^0.5.0</td><td class="string">Casey Cesari</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">luxon</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/moment/luxon.git</td><td class="string">3.7.2</td><td class="string">3.7.2</td><td class="string">^3.3.0</td><td class="string">Isaac Cambron</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">marked</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git://github.com/markedjs/marked.git</td><td class="string">16.4.2</td><td class="string">16.4.2</td><td class="string">^16.2.1</td><td class="string">Christopher Jeffrey</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">material-react-table</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/KevinVandy/material-react-table.git</td><td class="string">3.2.1</td><td class="string">3.2.1</td><td class="string">^3.2.1</td><td class="string">KevinVandy</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">playcanvas</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/playcanvas/engine.git</td><td class="string">2.21.3</td><td class="string">2.21.3</td><td class="string">2.21.3</td><td class="string">PlayCanvas <support@playcanvas.com></td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">prettier</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/prettier/prettier.git</td><td class="string">3.9.6</td><td class="string">3.8.1</td><td class="string">^3.8.1</td><td class="string">James Long</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">react-intersection-observer</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/thebuilder/react-intersection-observer.git</td><td class="string">9.16.0</td><td class="string">9.16.0</td><td class="string">^9.5.2</td><td class="string">Daniel Schmidt</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">react-multi-carousel</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/YIZHUANG/react-multi-carousel.git</td><td class="string">2.8.6</td><td class="string">2.8.6</td><td class="string">^2.8.2</td><td class="string">YI ZHUANG https://github.com/YIZHUANG</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">react-responsive</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git://github.com/contra/react-responsive.git</td><td class="string">9.0.2</td><td class="string">9.0.2</td><td class="string">^9.0.2</td><td class="string">Contra <yo@contra.io> (https://contra.io)</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">sass</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/sass/dart-sass.git</td><td class="string">1.102.0</td><td class="string">1.97.2</td><td class="string">^1.75.0</td><td class="string">Natalie Weizenbaum nweiz@google.com https://github.com/nex3</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">tinycolor2</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/bgrins/TinyColor.git</td><td class="string">1.6.0</td><td class="string">1.6.0</td><td class="string">^1.6.0</td><td class="string">Brian Grinstead <briangrinstead@gmail.com> (http://briangrinstead.com)</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">web-vitals</td><td class="string">perpetual</td><td class="string">material</td><td class="string">Apache-2.0</td><td class="string">git+https://github.com/GoogleChrome/web-vitals.git</td><td class="string">3.5.2</td><td class="string">3.5.2</td><td class="string">^3.5.2</td><td class="string">Philip Walton philip@philipwalton.com http://philipwalton.com</td></tr></tbody></table>
+<table><thead><tr><th class="string">department</th><th class="string">related to</th><th class="string">name</th><th class="string">license period</th><th class="string">material / not material</th><th class="string">license type</th><th class="string">link</th><th class="string">remote version</th><th class="string">installed version</th><th class="string">defined version</th><th class="string">author</th></tr></thead><tbody><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">@dnd-kit/core</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/clauderic/dnd-kit.git</td><td class="string">6.3.1</td><td class="string">6.3.1</td><td class="string">^6.0.7</td><td class="string">Claudéric Demers</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">@dnd-kit/sortable</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/clauderic/dnd-kit.git</td><td class="string">10.0.0</td><td class="string">10.0.0</td><td class="string">^10.0.0</td><td class="string">Claudéric Demers</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">@emotion/react</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/emotion-js/emotion.git#main</td><td class="string">11.14.0</td><td class="string">11.14.0</td><td class="string">^11.11.3</td><td class="string">Emotion Contributors</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">@emotion/styled</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/emotion-js/emotion.git#main</td><td class="string">11.14.1</td><td class="string">11.14.1</td><td class="string">^11.11.3</td><td class="string">n/a</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">@mui/icons-material</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/mui/material-ui.git</td><td class="string">6.5.0</td><td class="string">6.5.0</td><td class="string">^6.0.0</td><td class="string">MUI Team</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">@mui/lab</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/mui/material-ui.git</td><td class="string">6.0.1-beta.36</td><td class="string">6.0.1-beta.36</td><td class="string">^6.0.1-beta.36</td><td class="string">MUI Team</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">@mui/material</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/mui/material-ui.git</td><td class="string">6.5.0</td><td class="string">6.5.0</td><td class="string">^6.0.0</td><td class="string">MUI Team</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">@mui/x-date-pickers</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/mui/mui-x.git</td><td class="string">7.29.4</td><td class="string">7.29.4</td><td class="string">^7.22.0</td><td class="string">MUI Team</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">@playcanvas/react</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/playcanvas/react.git</td><td class="string">0.11.5</td><td class="string">0.11.5</td><td class="string">0.11.5</td><td class="string">n/a</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">classnames</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/JedWatson/classnames.git</td><td class="string">2.5.1</td><td class="string">2.5.1</td><td class="string">^2.3.2</td><td class="string">Jed Watson</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">csv-parse</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">https://github.com/adaltas/node-csv.git</td><td class="string">5.6.0</td><td class="string">5.6.0</td><td class="string">^5.5.5</td><td class="string">David Worms <david@adaltas.com> (https://www.adaltas.com)</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">geojson</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">http://github.com/caseycesari/geojson.js.git</td><td class="string">0.5.0</td><td class="string">0.5.0</td><td class="string">^0.5.0</td><td class="string">Casey Cesari</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">luxon</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/moment/luxon.git</td><td class="string">3.7.2</td><td class="string">3.7.2</td><td class="string">^3.3.0</td><td class="string">Isaac Cambron</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">marked</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git://github.com/markedjs/marked.git</td><td class="string">16.4.2</td><td class="string">16.4.2</td><td class="string">^16.2.1</td><td class="string">Christopher Jeffrey</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">material-react-table</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/KevinVandy/material-react-table.git</td><td class="string">3.2.1</td><td class="string">3.2.1</td><td class="string">^3.2.1</td><td class="string">KevinVandy</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">playcanvas</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/playcanvas/engine.git</td><td class="string">2.21.3</td><td class="string">2.21.3</td><td class="string">2.21.3</td><td class="string">PlayCanvas <support@playcanvas.com></td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">prettier</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/prettier/prettier.git</td><td class="string">3.9.6</td><td class="string">3.8.1</td><td class="string">^3.8.1</td><td class="string">James Long</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">react-intersection-observer</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/thebuilder/react-intersection-observer.git</td><td class="string">9.16.0</td><td class="string">9.16.0</td><td class="string">^9.5.2</td><td class="string">Daniel Schmidt</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">react-multi-carousel</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/YIZHUANG/react-multi-carousel.git</td><td class="string">2.8.6</td><td class="string">2.8.6</td><td class="string">^2.8.2</td><td class="string">YI ZHUANG https://github.com/YIZHUANG</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">react-responsive</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git://github.com/contra/react-responsive.git</td><td class="string">9.0.2</td><td class="string">9.0.2</td><td class="string">^9.0.2</td><td class="string">Contra <yo@contra.io> (https://contra.io)</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">sass</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/sass/dart-sass.git</td><td class="string">1.102.0</td><td class="string">1.97.2</td><td class="string">^1.75.0</td><td class="string">Natalie Weizenbaum nweiz@google.com https://github.com/nex3</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">tinycolor2</td><td class="string">perpetual</td><td class="string">material</td><td class="string">MIT</td><td class="string">git+https://github.com/bgrins/TinyColor.git</td><td class="string">1.6.0</td><td class="string">1.6.0</td><td class="string">^1.6.0</td><td class="string">Brian Grinstead <briangrinstead@gmail.com> (http://briangrinstead.com)</td></tr><tr><td class="string">terraware</td><td class="string">web-components</td><td class="string">web-vitals</td><td class="string">perpetual</td><td class="string">material</td><td class="string">Apache-2.0</td><td class="string">git+https://github.com/GoogleChrome/web-vitals.git</td><td class="string">3.5.2</td><td class="string">3.5.2</td><td class="string">^3.5.2</td><td class="string">Philip Walton philip@philipwalton.com http://philipwalton.com</td></tr></tbody></table>
 </body>
 </html>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@terraware/web-components",
-  "version": "4.3.3",
+  "version": "5.0.0",
   "author": "Terraformation Inc.",
   "license": "Apache-2.0",
   "repository": {
@@ -24,6 +24,7 @@
     "@mui/x-date-pickers": "^7.22.0",
     "@playcanvas/react": "0.11.5",
     "classnames": "^2.3.2",
+    "csv-parse": "^5.5.5",
     "geojson": "^0.5.0",
     "luxon": "^3.3.0",
     "marked": "^16.2.1",

package/strings/csv/en.csv

@@ -0,0 +1,50 @@
+key_name,en,comment
+ADD_ANNOTATION,Add Annotation,
+ANNOTATION_DESCRIPTION_TOOLTIP,Additional details or context about this annotation,
+ANNOTATION_LABEL_TOOLTIP,Short identifier displayed on the annotation hotspot,
+ANNOTATION_TITLE_TOOLTIP,Main heading for the annotation,
+ANNOTATIONS,Annotations,
+AR,AR,Augmented Reality
+ARROW_KEYS,Arrow Keys,
+AUTO_ROTATE,Auto Rotate,
+BOUNDED_FLY,Bounded-fly,
+CAMERA_FOCUS_POINT,Focus Point,
+CAMERA_INFO,Camera Info,
+CAMERA_POSITION,Position,
+CANCEL,Cancel,
+CHOOSE_FILE,Choose File...,
+CONTROLS,Controls,
+CTRL,Ctrl,
+DELETE_ANNOTATION,Delete Annotation,
+DESCRIPTION,Description,
+DESELECT_ANNOTATION,Deselect Annotation,
+EDIT,Edit,
+EDIT_ANNOTATION,Edit Annotation,
+EXISTING,Existing,
+FILE_SELECTED,File Selected,
+FLY,Fly,
+FLY_FASTER,Fly faster,
+FLY_SLOWER,Fly slower,
+FREE_FLY,Free-fly,
+IMAGES,Images,
+LABEL,Label,
+LEFT_MOUSE,Left Mouse,
+LOOK,Look,
+MIDDLE_MOUSE,Middle Mouse,
+MOUSE_WHEEL,Mouse Wheel,
+NEW,New,
+ORBIT,Orbit,
+PAN,Pan,
+PINCH,Pinch,
+REPLACE_FILE,Replace File...,
+RESET_CAMERA,Reset Camera,
+RIGHT_MOUSE,Right Mouse,
+SAVE,Save,
+SHIFT,Shift,
+SWIPE,Swipe,
+TITLE,Title,
+TOUCH_DRAG,Touch + Drag,
+UPLOAD_FILES,Upload Files,
+UPLOAD_FILES_DESCRIPTION,Browse or drag and drop files.,
+VR,VR,Virtual Reality
+ZOOM,Zoom,

package/strings/csv/es.csv

@@ -0,0 +1,50 @@
+Key,Text,Hash
+ADD_ANNOTATION,Agregar anotación,91742a0f
+ANNOTATION_DESCRIPTION_TOOLTIP,Detalles o contexto adicional sobre esta anotación,8cb997d2
+ANNOTATION_LABEL_TOOLTIP,Identificador breve que se muestra en el punto destacado de la anotación,adbb02a1
+ANNOTATION_TITLE_TOOLTIP,Título principal de la anotación,b3f5b753
+ANNOTATIONS,Anotaciones,c15a3aa4
+AR,RA,25a8e55a
+ARROW_KEYS,Flechas del teclado,5cefb475
+AUTO_ROTATE,Rotación automática,15ce1a40
+BOUNDED_FLY,Vuelo delimitado,9e3c46ae
+CAMERA_FOCUS_POINT,Punto de enfoque,350a921b
+CAMERA_INFO,Información de la cámara,4283d43c
+CAMERA_POSITION,Posición,3eb30313
+CANCEL,Cancelar,e73dc4d4
+CHOOSE_FILE,Seleccione archivo...,967c4c38
+CONTROLS,Controles,f7c1294f
+CTRL,Ctrl,f485607a
+DELETE_ANNOTATION,Eliminar anotación,10fcdc4e
+DESCRIPTION,Descripción,9cb0cc64
+DESELECT_ANNOTATION,Deseleccionar anotación,32c46edd
+EDIT,Editar,9d1278d8
+EDIT_ANNOTATION,Editar anotación,82bcb054
+EXISTING,Existente,fa67ac1d
+FILE_SELECTED,Archivo seleccionado,23a60a8d
+FLY,Volar,0747d35f
+FLY_FASTER,Volar más rápido,e24d00c8
+FLY_SLOWER,Volar más lento,0271712f
+FREE_FLY,Vuelo libre,3eb18bf0
+IMAGES,Imágenes,2041d3b6
+LABEL,Etiqueta,85def946
+LEFT_MOUSE,Botón izquierdo del ratón,b034e4dc
+LOOK,Mirar,e006bd6f
+MIDDLE_MOUSE,Botón central del ratón,18763653
+MOUSE_WHEEL,Rueda del ratón,8e3d3d78
+NEW,Nuevo,b8096e3b
+ORBIT,Orbitar,8e3af3cb
+PAN,Desplazar,34177007
+PINCH,Pellizcar,3c1f1f79
+REPLACE_FILE,Reemplazar archivo...,14c3cc45
+RESET_CAMERA,Restablecer cámara,ee37fbd5
+RIGHT_MOUSE,Botón derecho del ratón,d551c809
+SAVE,Guardar,526a3e42
+SHIFT,Shift,4d173d2a
+SWIPE,Deslizar,bc0962fa
+TITLE,Título,a5f8fc0b
+TOUCH_DRAG,Tocar y arrastrar,ff6d48d2
+UPLOAD_FILES,Subir archivos,b98547be
+UPLOAD_FILES_DESCRIPTION,Buscar o arrastrar y soltar archivos.,7c4a7822
+VR,RV,98fd7fc5
+ZOOM,Acercar/alejar,07b636df

package/strings/csv/fr.csv

@@ -0,0 +1,50 @@
+Key,Text,Hash
+ADD_ANNOTATION,Ajouter une annotation,91742a0f
+ANNOTATION_DESCRIPTION_TOOLTIP,Détails ou contexte supplémentaires concernant cette annotation,8cb997d2
+ANNOTATION_LABEL_TOOLTIP,Identifiant court affiché sur le point d’annotation,adbb02a1
+ANNOTATION_TITLE_TOOLTIP,Titre principal de l’annotation,b3f5b753
+ANNOTATIONS,Annotations,c15a3aa4
+AR,RA,25a8e55a
+ARROW_KEYS,Touches fléchées,5cefb475
+AUTO_ROTATE,Rotation automatique,15ce1a40
+BOUNDED_FLY,Vol limité,9e3c46ae
+CAMERA_FOCUS_POINT,Point de mise au point,350a921b
+CAMERA_INFO,Informations sur la caméra,4283d43c
+CAMERA_POSITION,Position,3eb30313
+CANCEL,Annuler,e73dc4d4
+CHOOSE_FILE,Choisissez le fichier...,967c4c38
+CONTROLS,Commandes,f7c1294f
+CTRL,Ctrl,f485607a
+DELETE_ANNOTATION,Supprimer l’annotation,10fcdc4e
+DESCRIPTION,Description,9cb0cc64
+DESELECT_ANNOTATION,Désélectionner l’annotation,32c46edd
+EDIT,Modifier,9d1278d8
+EDIT_ANNOTATION,Modifier l’annotation,82bcb054
+EXISTING,Existant,fa67ac1d
+FILE_SELECTED,Fichier sélectionné,23a60a8d
+FLY,Voler,0747d35f
+FLY_FASTER,Voler plus vite,e24d00c8
+FLY_SLOWER,Voler plus lentement,0271712f
+FREE_FLY,Vol libre,3eb18bf0
+IMAGES,Images,2041d3b6
+LABEL,Étiquette,85def946
+LEFT_MOUSE,Bouton gauche de la souris,b034e4dc
+LOOK,Regarder,e006bd6f
+MIDDLE_MOUSE,Bouton central de la souris,18763653
+MOUSE_WHEEL,Molette de la souris,8e3d3d78
+NEW,Nouveau,b8096e3b
+ORBIT,Orbiter,8e3af3cb
+PAN,Déplacer,34177007
+PINCH,Pincer,3c1f1f79
+REPLACE_FILE,Remplacer le fichier...,14c3cc45
+RESET_CAMERA,Réinitialiser la caméra,ee37fbd5
+RIGHT_MOUSE,Bouton droit de la souris,d551c809
+SAVE,Sauvegarder,526a3e42
+SHIFT,Maj,4d173d2a
+SWIPE,Glisser,bc0962fa
+TITLE,Titre,a5f8fc0b
+TOUCH_DRAG,Toucher + Glisser,ff6d48d2
+UPLOAD_FILES,Téléverser des fichiers,b98547be
+UPLOAD_FILES_DESCRIPTION,Parcourir ou glisser-déposer des fichiers.,7c4a7822
+VR,RV,98fd7fc5
+ZOOM,Zoom,07b636df

package/strings/csv/instructions-es.txt

@@ -0,0 +1,14 @@
+Here's a list of translations to use for specific terminology. Use these translations consistently.
+It is okay to change these terms to different parts of speech if needed to maintain grammatical
+correctness, but don't choose totally different words.
+
+annotation: anotación
+augmented reality (AR): realidad aumentada (RA)
+camera: cámara
+focus point: punto de enfoque
+fly: volar
+hotspot: punto destacado
+mouse: ratón
+orbit: orbitar
+pan: desplazar
+virtual reality (VR): realidad virtual (RV)

package/strings/csv/instructions-fr.txt

@@ -0,0 +1,14 @@
+Here's a list of translations to use for specific terminology. Use these translations consistently.
+It is okay to change these terms to different parts of speech if needed to maintain grammatical
+correctness, but don't choose totally different words.
+
+annotation: annotation
+augmented reality (AR): réalité augmentée (RA)
+camera: caméra
+focus point: point de mise au point
+fly: voler
+hotspot: point d'annotation
+mouse: souris
+orbit: orbiter
+pan: déplacer
+virtual reality (VR): réalité virtuelle (RV)

package/strings/csv/instructions.txt

@@ -0,0 +1,13 @@
+Some notes about language style:
+
+- The words "Terraformation" and "Terraware" should not be translated and should be capitalized.
+- The tone of the translations should be formal but not stuffy. Address the user as if they're a
+  customer or business associate, not as if they're a friend.
+- These strings label controls in a shared component library, mostly the 3D virtual walkthrough
+  viewer. Many are short button labels or tooltips, so prefer concise translations that will fit in
+  a small control; a translation two or three times longer than the English will overflow its
+  button.
+- Input device names ("Left Mouse", "Mouse Wheel", "Arrow Keys") and gestures ("Pinch", "Swipe")
+  should use whatever terms the platform conventionally uses in that language.
+- Modifier key names ("Shift", "Ctrl") should match the labels printed on keyboards sold for that
+  language, which often means leaving them untranslated.

package/strings/export.d.ts

@@ -0,0 +1,36 @@
+export type StringsMap = Record<string, string>;
+/**
+ * Loads a CSV strings file into an object, taking keys and values from the first two columns.
+ */
+export declare const csvToStrings: (csvData: string) => StringsMap;
+/**
+ * Renders a strings object as a TypeScript module that exports a constant called "strings",
+ * formatted the way the repository's Prettier configuration wants it so that generating a table and
+ * formatting the tree don't fight over the result.
+ */
+export declare const stringsToTypeScript: (stringsMap: StringsMap, targetPath: string) => Promise<string>;
+/**
+ * Transforms the English strings table into gibberish, which makes untranslated text obvious
+ * without waiting on a translation.
+ *
+ * 1. Split the English string into whitespace-delimited words.
+ * 2. Reverse the order of the words.
+ * 3. Render each word as a base64 encoding of its UTF-8 representation, except for words that look
+ *    like format string placeholders.
+ */
+export declare const generateGibberish: (english: StringsMap) => StringsMap;
+/**
+ * Converts a CSV strings file to a TypeScript source file that exports a constant called "strings".
+ * This will be an object that has the same keys as the English strings file; the English strings
+ * will be used for any keys that aren't translated yet.
+ *
+ * The filename is assumed to be the locale code with a ".csv" suffix. Converting the English file
+ * also writes the gibberish table, which is derived from English rather than translated.
+ */
+export declare const convertCsvFile: (csvPath: string, targetDir: string, defaultToEnglish?: boolean) => Promise<void>;
+/**
+ * Converts the CSV files for all locales to TypeScript source files. The list of locales is
+ * determined by the presence of CSV files.
+ */
+export declare const convertAllLocales: (csvDir: string, stringsDir: string, defaultToEnglish?: boolean) => Promise<string[]>;
+//# sourceMappingURL=export.d.ts.map

package/strings/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/strings/export.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAIhD;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,KAAG,UAe9C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAU,YAAY,UAAU,EAAE,YAAY,MAAM,KAAG,OAAO,CAAC,MAAM,CAKpG,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,UAAU,KAAG,UAUrD,CAAC;AA2BJ;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAU,SAAS,MAAM,EAAE,WAAW,MAAM,EAAE,0BAAuB,KAAG,OAAO,CAAC,IAAI,CAqB9G,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,MAAM,EACd,YAAY,MAAM,EAClB,0BAAuB,KACtB,OAAO,CAAC,MAAM,EAAE,CAQlB,CAAC"}

package/strings/export.js

@@ -0,0 +1,116 @@
+import { parse } from 'csv-parse/sync';
+import { readdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { resolveConfig, format } from 'prettier';
+
+/**
+ * Renders the CSV string tables as TypeScript source.
+ *
+ * This runs at build time, not at runtime. Nothing in the component runtime imports it, so its Node
+ * and CSV dependencies never reach a browser bundle. It's published rather than kept in scripts/ so
+ * that applications sharing these string tables can drive the same conversion.
+ */
+const GENERATED_HEADER = '/* Generated from the CSV files in csv/ by `yarn generate-strings`. Do not edit. */';
+
+/**
+ * Loads a CSV strings file into an object, taking keys and values from the first two columns.
+ */
+const csvToStrings = csvData => {
+  const rows = parse(csvData, {
+    // Skip header row
+    from: 2,
+    // Only rows for strings that have comments have 3 fields.
+    relax_column_count_less: true,
+    // Skip empty "row" that is really just the terminating linefeed
+    skip_empty_lines: true
+  });
+  return rows.reduce((result, row) => {
+    result[row[0]] = row[1];
+    return result;
+  }, {});
+};
+
+/**
+ * Renders a strings object as a TypeScript module that exports a constant called "strings",
+ * formatted the way the repository's Prettier configuration wants it so that generating a table and
+ * formatting the tree don't fight over the result.
+ */
+const stringsToTypeScript = async (stringsMap, targetPath) => {
+  const source = `${GENERATED_HEADER}\nexport const strings = ${JSON.stringify(stringsMap, null, 2)};\n`;
+  const prettierConfig = await resolveConfig(targetPath);
+  return format(source, {
+    ...prettierConfig,
+    filepath: targetPath
+  });
+};
+
+/**
+ * Transforms the English strings table into gibberish, which makes untranslated text obvious
+ * without waiting on a translation.
+ *
+ * 1. Split the English string into whitespace-delimited words.
+ * 2. Reverse the order of the words.
+ * 3. Render each word as a base64 encoding of its UTF-8 representation, except for words that look
+ *    like format string placeholders.
+ */
+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(' ')]));
+const exportStrings = async (englishStrings, localizedStrings, locale, targetDir, defaultToEnglish) => {
+  const stringsMap = {};
+  for (const key of Object.keys(englishStrings)) {
+    if (key in localizedStrings) {
+      stringsMap[key] = localizedStrings[key];
+    } else {
+      console.warn(`Locale ${locale} has no translation for ${key}`);
+      if (defaultToEnglish) {
+        stringsMap[key] = englishStrings[key];
+      }
+    }
+  }
+  const targetPath = path.resolve(targetDir, `strings-${locale}.ts`);
+  await writeFile(targetPath, await stringsToTypeScript(stringsMap, targetPath), {
+    encoding: 'utf-8'
+  });
+};
+
+/**
+ * Converts a CSV strings file to a TypeScript source file that exports a constant called "strings".
+ * This will be an object that has the same keys as the English strings file; the English strings
+ * will be used for any keys that aren't translated yet.
+ *
+ * The filename is assumed to be the locale code with a ".csv" suffix. Converting the English file
+ * also writes the gibberish table, which is derived from English rather than translated.
+ */
+const convertCsvFile = async (csvPath, targetDir, defaultToEnglish = true) => {
+  if (!csvPath.endsWith('.csv')) {
+    throw new Error('Cannot convert a non-CSV file');
+  }
+  const locale = path.basename(csvPath, '.csv');
+  const stringsMap = csvToStrings(await readFile(csvPath, {
+    encoding: 'utf-8'
+  }));
+  let englishStringsMap;
+  if (locale === 'en') {
+    englishStringsMap = stringsMap;
+  } else {
+    const englishPath = path.resolve(path.dirname(csvPath), 'en.csv');
+    englishStringsMap = csvToStrings(await readFile(englishPath, {
+      encoding: 'utf-8'
+    }));
+  }
+  await exportStrings(englishStringsMap, stringsMap, locale, targetDir, defaultToEnglish);
+  if (locale === 'en') {
+    await exportStrings(englishStringsMap, generateGibberish(englishStringsMap), 'gx', targetDir, defaultToEnglish);
+  }
+};
+
+/**
+ * Converts the CSV files for all locales to TypeScript source files. The list of locales is
+ * determined by the presence of CSV files.
+ */
+const convertAllLocales = async (csvDir, stringsDir, defaultToEnglish = true) => {
+  const csvFiles = (await readdir(csvDir)).filter(filename => filename.endsWith('.csv'));
+  await Promise.all(csvFiles.map(filename => convertCsvFile(path.join(csvDir, filename), stringsDir, defaultToEnglish)));
+  return csvFiles;
+};
+
+export { convertAllLocales, convertCsvFile, csvToStrings, generateGibberish, stringsToTypeScript };

package/strings/index.d.ts

@@ -0,0 +1,22 @@
+import { strings as en } from './strings-en';
+/**
+ * The set of strings every locale provides. The English table is the source of truth for the list
+ * of keys.
+ */
+export type ComponentStrings = typeof en;
+/**
+ * Sets the locale these components render in. Consumers own the locale -- a component library has
+ * no reliable way to know whether the browser's language or a user's profile setting should win --
+ * so nothing here changes until an application calls this. Accepts a bare language tag or one with
+ * a region ('es' or 'es-MX').
+ */
+export declare const setLocale: (locale: string) => void;
+/** The resolved locale, which is also the locale to hand to Intl and other formatters. */
+export declare const getLocale: () => string;
+/**
+ * The current string table. For components, prefer `useStrings`, which re-renders on a locale
+ * change; this is for the imperative code that can't hold a hook, such as PlayCanvas scripts.
+ */
+export declare const getStrings: () => ComponentStrings;
+export declare const useStrings: () => ComponentStrings;
+//# sourceMappingURL=index.d.ts.map

package/strings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/strings/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,MAAM,cAAc,CAAC;AAK7C;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,EAAE,CAAC;AAgBzC;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,KAAG,IAS1C,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,SAAS,QAAO,MAAuB,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,UAAU,QAAO,gBAAkC,CAAC;AAUjE,eAAO,MAAM,UAAU,QAAO,gBAA2E,CAAC"}

package/strings/index.js

@@ -0,0 +1,62 @@
+import { useSyncExternalStore } from 'react';
+import { findLocaleDetails, supportedLocales } from './locales.js';
+import { strings } from './strings-en.js';
+import { strings as strings$3 } from './strings-es.js';
+import { strings as strings$2 } from './strings-fr.js';
+import { strings as strings$1 } from './strings-gx.js';
+
+/**
+ * The set of strings every locale provides. The English table is the source of truth for the list
+ * of keys.
+ */
+
+const tables = {
+  en: strings,
+  es: strings$3,
+  fr: strings$2,
+  gx: strings$1
+};
+
+/**
+ * Locales we have a bundled string table for. A locale can be supported -- listed in a locale
+ * selector -- before its table lands, and resolving against the tables we actually have keeps
+ * `getLocale` and `getStrings` describing the same language.
+ */
+const localesWithTables = () => supportedLocales.filter(locale => locale.id in tables);
+let currentLocale = 'en';
+let currentStrings = strings;
+const listeners = new Set();
+
+/**
+ * Sets the locale these components render in. Consumers own the locale -- a component library has
+ * no reliable way to know whether the browser's language or a user's profile setting should win --
+ * so nothing here changes until an application calls this. Accepts a bare language tag or one with
+ * a region ('es' or 'es-MX').
+ */
+const setLocale = locale => {
+  const resolved = findLocaleDetails(localesWithTables(), locale).id;
+  if (resolved === currentLocale) {
+    return;
+  }
+  currentLocale = resolved;
+  currentStrings = tables[resolved] ?? strings;
+  listeners.forEach(notify => notify());
+};
+
+/** The resolved locale, which is also the locale to hand to Intl and other formatters. */
+const getLocale = () => currentLocale;
+
+/**
+ * The current string table. For components, prefer `useStrings`, which re-renders on a locale
+ * change; this is for the imperative code that can't hold a hook, such as PlayCanvas scripts.
+ */
+const getStrings = () => currentStrings;
+const subscribe = notify => {
+  listeners.add(notify);
+  return () => {
+    listeners.delete(notify);
+  };
+};
+const useStrings = () => useSyncExternalStore(subscribe, getStrings, getStrings);
+
+export { getLocale, getStrings, setLocale, useStrings };

package/strings/locales.d.ts

@@ -0,0 +1,38 @@
+export interface LocaleDetails {
+    /**
+     * Locale identifier. This must start with a language tag (2 or 3 letters) and may optionally
+     * have a hyphen and a location code. For example, 'en' or 'en-US'.
+     */
+    id: string;
+    /**
+     * Name of the locale as it appears in a locale selector. This will typically be the name of the
+     * locale in whatever language the locale uses. That is, 'Español' and not 'Spanish'.
+     */
+    name: string;
+    /**
+     * Whether this locale is in development and not ready for production.
+     */
+    inDevelopment?: boolean;
+}
+/** Supported locales in the order they should appear in a locale selector. */
+export declare const supportedLocales: LocaleDetails[];
+/**
+ * Returns the locales that should be offered to users. Locales still in development are left out
+ * unless they're asked for, which is how a consumer exposes them outside of production.
+ */
+export declare const getSupportedLocales: (includeInDevelopment?: boolean) => LocaleDetails[];
+/**
+ * Returns the locale from a list of locales that matches the user's selected language.
+ *
+ * The user's locale can include both a language and a country code, but entries in a list of
+ * languages usually don't have country codes. So we need to find the entry that is the longest
+ * prefix of the user's locale.
+ *
+ * If the locale is es-MX and the list of locales only has es, we want the es item to be selected.
+ * But if the locale is zh-CN and the list has both zh-CN and zh-TW, we want zh-CN to be selected.
+ *
+ * If none of the locales in the list matches, returns the first locale from the list. The list
+ * must not be empty.
+ */
+export declare const findLocaleDetails: (locales: LocaleDetails[], locale: string) => LocaleDetails;
+//# sourceMappingURL=locales.d.ts.map

package/strings/locales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../src/strings/locales.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,EAAE,aAAa,EAK3C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,8BAA4B,KAAG,aAAa,EACsB,CAAC;AAEvG;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,aAAa,EAAE,EAAE,QAAQ,MAAM,KAAG,aAQ1E,CAAC"}

package/strings/locales.js

@@ -0,0 +1,42 @@
+/** Supported locales in the order they should appear in a locale selector. */
+const supportedLocales = [{
+  id: 'en',
+  name: 'English'
+}, {
+  id: 'es',
+  name: 'Español'
+}, {
+  id: 'fr',
+  name: 'Français'
+}, {
+  id: 'gx',
+  name: 'Gibberish',
+  inDevelopment: true
+}];
+
+/**
+ * Returns the locales that should be offered to users. Locales still in development are left out
+ * unless they're asked for, which is how a consumer exposes them outside of production.
+ */
+const getSupportedLocales = (includeInDevelopment = false) => includeInDevelopment ? supportedLocales : supportedLocales.filter(locale => !locale.inDevelopment);
+
+/**
+ * Returns the locale from a list of locales that matches the user's selected language.
+ *
+ * The user's locale can include both a language and a country code, but entries in a list of
+ * languages usually don't have country codes. So we need to find the entry that is the longest
+ * prefix of the user's locale.
+ *
+ * If the locale is es-MX and the list of locales only has es, we want the es item to be selected.
+ * But if the locale is zh-CN and the list has both zh-CN and zh-TW, we want zh-CN to be selected.
+ *
+ * If none of the locales in the list matches, returns the first locale from the list. The list
+ * must not be empty.
+ */
+const findLocaleDetails = (locales, locale) => locales.reduce((bestMatch, candidate) =>
+// The best match so far is only worth keeping if it's a prefix of the requested locale too.
+// reduce() seeds with the first locale without checking it, so a leading 'en-US' would
+// otherwise be treated as a match for 'en' and never replaced.
+locale.startsWith(candidate.id) && (!locale.startsWith(bestMatch.id) || candidate.id.length > bestMatch.id.length) ? candidate : bestMatch);
+
+export { findLocaleDetails, getSupportedLocales, supportedLocales };