@cloudscape-design/components-themeable 3.0.240 → 3.0.242

package/lib/internal/template/internal/i18n/messages/all.pt-BR.js

@@ -2,22 +2,6 @@ export default {
   '@cloudscape-design/components': {
     'pt-BR': {
       alert: { dismissAriaLabel: [{ type: 0, value: 'Descartar alerta' }] },
-      autosuggest: {
-        stepNumberLabel: [
-          { type: 0, value: 'Etapa ' },
-          { type: 1, value: 'stepNumber' },
-        ],
-        collapsedStepsLabel: [
-          { type: 0, value: 'Etapa ' },
-          { type: 1, value: 'stepNumber' },
-          { type: 0, value: ' de ' },
-          { type: 1, value: 'stepsCount' },
-        ],
-        cancelButton: [{ type: 0, value: 'Cancelar' }],
-        previousButton: [{ type: 0, value: 'Anterior' }],
-        nextButton: [{ type: 0, value: 'Próximo' }],
-        optional: [{ type: 0, value: 'opcional' }],
-      },
       'app-layout': {
         'ariaLabels.navigation': [{ type: 0, value: 'Navegação lateral' }],
         'ariaLabels.navigationClose': [{ type: 0, value: 'Fechar navegação lateral' }],
@@ -27,7 +11,11 @@ export default {
         'ariaLabels.toolsClose': [{ type: 0, value: 'Abrir o painel de ajuda' }],
         'ariaLabels.toolsToggle': [{ type: 0, value: 'Fechar o painel de ajuda' }],
       },
-      'date-picker': {
+      autosuggest: {
+        errorIconAriaLabel: [{ type: 0, value: 'Erro' }],
+        selectedAriaLabel: [{ type: 0, value: 'Selecionado' }],
+      },
+      calendar: {
         nextMonthAriaLabel: [{ type: 0, value: 'Próximo mês' }],
         previousMonthAriaLabel: [{ type: 0, value: 'Mês anterior' }],
         todayAriaLabel: [{ type: 0, value: 'Hoje' }],
@@ -42,8 +30,8 @@ export default {
         'i18nStrings.successIconAriaLabel': [{ type: 0, value: 'Com êxito' }],
         'i18nStrings.warningIconAriaLabel': [{ type: 0, value: 'Aviso' }],
       },
-      form: { errorIconAriaLabel: [{ type: 0, value: 'Erro' }] },
       'form-field': { 'i18nStrings.errorIconAriaLabel': [{ type: 0, value: 'Erro' }] },
+      form: { errorIconAriaLabel: [{ type: 0, value: 'Erro' }] },
       input: { clearAriaLabel: [{ type: 0, value: 'Limpar' }] },
       modal: { closeAriaLabel: [{ type: 0, value: 'Fechar modal' }] },
       pagination: {
@@ -159,8 +147,20 @@ export default {
         selectedAriaLabel: [{ type: 0, value: 'Selecionado' }],
       },
       wizard: {
-        errorIconAriaLabel: [{ type: 0, value: 'Erro' }],
-        selectedAriaLabel: [{ type: 0, value: 'Selecionado' }],
+        'i18nStrings.stepNumberLabel': [
+          { type: 0, value: 'Etapa ' },
+          { type: 1, value: 'stepNumber' },
+        ],
+        'i18nStrings.collapsedStepsLabel': [
+          { type: 0, value: 'Etapa ' },
+          { type: 1, value: 'stepNumber' },
+          { type: 0, value: ' de ' },
+          { type: 1, value: 'stepsCount' },
+        ],
+        'i18nStrings.cancelButton': [{ type: 0, value: 'Cancelar' }],
+        'i18nStrings.previousButton': [{ type: 0, value: 'Anterior' }],
+        'i18nStrings.nextButton': [{ type: 0, value: 'Próximo' }],
+        'i18nStrings.optional': [{ type: 0, value: 'opcional' }],
       },
     },
   },

package/lib/internal/template/internal/i18n/messages/all.pt-BR.json

@@ -2,22 +2,6 @@
   "@cloudscape-design/components": {
     "pt-BR": {
       "alert": { "dismissAriaLabel": [{ "type": 0, "value": "Descartar alerta" }] },
-      "autosuggest": {
-        "stepNumberLabel": [
-          { "type": 0, "value": "Etapa " },
-          { "type": 1, "value": "stepNumber" }
-        ],
-        "collapsedStepsLabel": [
-          { "type": 0, "value": "Etapa " },
-          { "type": 1, "value": "stepNumber" },
-          { "type": 0, "value": " de " },
-          { "type": 1, "value": "stepsCount" }
-        ],
-        "cancelButton": [{ "type": 0, "value": "Cancelar" }],
-        "previousButton": [{ "type": 0, "value": "Anterior" }],
-        "nextButton": [{ "type": 0, "value": "Próximo" }],
-        "optional": [{ "type": 0, "value": "opcional" }]
-      },
       "app-layout": {
         "ariaLabels.navigation": [{ "type": 0, "value": "Navegação lateral" }],
         "ariaLabels.navigationClose": [{ "type": 0, "value": "Fechar navegação lateral" }],
@@ -27,7 +11,11 @@
         "ariaLabels.toolsClose": [{ "type": 0, "value": "Abrir o painel de ajuda" }],
         "ariaLabels.toolsToggle": [{ "type": 0, "value": "Fechar o painel de ajuda" }]
       },
-      "date-picker": {
+      "autosuggest": {
+        "errorIconAriaLabel": [{ "type": 0, "value": "Erro" }],
+        "selectedAriaLabel": [{ "type": 0, "value": "Selecionado" }]
+      },
+      "calendar": {
         "nextMonthAriaLabel": [{ "type": 0, "value": "Próximo mês" }],
         "previousMonthAriaLabel": [{ "type": 0, "value": "Mês anterior" }],
         "todayAriaLabel": [{ "type": 0, "value": "Hoje" }]
@@ -42,8 +30,8 @@
         "i18nStrings.successIconAriaLabel": [{ "type": 0, "value": "Com êxito" }],
         "i18nStrings.warningIconAriaLabel": [{ "type": 0, "value": "Aviso" }]
       },
-      "form": { "errorIconAriaLabel": [{ "type": 0, "value": "Erro" }] },
       "form-field": { "i18nStrings.errorIconAriaLabel": [{ "type": 0, "value": "Erro" }] },
+      "form": { "errorIconAriaLabel": [{ "type": 0, "value": "Erro" }] },
       "input": { "clearAriaLabel": [{ "type": 0, "value": "Limpar" }] },
       "modal": { "closeAriaLabel": [{ "type": 0, "value": "Fechar modal" }] },
       "pagination": {
@@ -159,8 +147,20 @@
         "selectedAriaLabel": [{ "type": 0, "value": "Selecionado" }]
       },
       "wizard": {
-        "errorIconAriaLabel": [{ "type": 0, "value": "Erro" }],
-        "selectedAriaLabel": [{ "type": 0, "value": "Selecionado" }]
+        "i18nStrings.stepNumberLabel": [
+          { "type": 0, "value": "Etapa " },
+          { "type": 1, "value": "stepNumber" }
+        ],
+        "i18nStrings.collapsedStepsLabel": [
+          { "type": 0, "value": "Etapa " },
+          { "type": 1, "value": "stepNumber" },
+          { "type": 0, "value": " de " },
+          { "type": 1, "value": "stepsCount" }
+        ],
+        "i18nStrings.cancelButton": [{ "type": 0, "value": "Cancelar" }],
+        "i18nStrings.previousButton": [{ "type": 0, "value": "Anterior" }],
+        "i18nStrings.nextButton": [{ "type": 0, "value": "Próximo" }],
+        "i18nStrings.optional": [{ "type": 0, "value": "opcional" }]
       }
     }
   }

package/lib/internal/template/internal/i18n/messages/all.zh-CN.js

@@ -2,24 +2,6 @@ export default {
   '@cloudscape-design/components': {
     'zh-CN': {
       alert: { dismissAriaLabel: [{ type: 0, value: '退出提示' }] },
-      autosuggest: {
-        stepNumberLabel: [
-          { type: 0, value: '第 ' },
-          { type: 1, value: 'stepNumber' },
-          { type: 0, value: ' 步' },
-        ],
-        collapsedStepsLabel: [
-          { type: 0, value: '第 ' },
-          { type: 1, value: 'stepNumber' },
-          { type: 0, value: ' 步，共 ' },
-          { type: 1, value: 'stepsCount' },
-          { type: 0, value: ' 步' },
-        ],
-        cancelButton: [{ type: 0, value: '取消' }],
-        previousButton: [{ type: 0, value: '上一步' }],
-        nextButton: [{ type: 0, value: '下一步' }],
-        optional: [{ type: 0, value: '可选' }],
-      },
       'app-layout': {
         'ariaLabels.navigation': [{ type: 0, value: '侧导航' }],
         'ariaLabels.navigationClose': [{ type: 0, value: '关闭侧导航' }],
@@ -29,7 +11,11 @@ export default {
         'ariaLabels.toolsClose': [{ type: 0, value: '打开帮助面板' }],
         'ariaLabels.toolsToggle': [{ type: 0, value: '关闭帮助面板' }],
       },
-      'date-picker': {
+      autosuggest: {
+        errorIconAriaLabel: [{ type: 0, value: '错误' }],
+        selectedAriaLabel: [{ type: 0, value: '已选定' }],
+      },
+      calendar: {
         nextMonthAriaLabel: [{ type: 0, value: '下个月' }],
         previousMonthAriaLabel: [{ type: 0, value: '上个月' }],
         todayAriaLabel: [{ type: 0, value: '今天' }],
@@ -44,8 +30,8 @@ export default {
         'i18nStrings.successIconAriaLabel': [{ type: 0, value: '成功' }],
         'i18nStrings.warningIconAriaLabel': [{ type: 0, value: '警告' }],
       },
-      form: { errorIconAriaLabel: [{ type: 0, value: '错误' }] },
       'form-field': { 'i18nStrings.errorIconAriaLabel': [{ type: 0, value: '错误' }] },
+      form: { errorIconAriaLabel: [{ type: 0, value: '错误' }] },
       input: { clearAriaLabel: [{ type: 0, value: '清除' }] },
       modal: { closeAriaLabel: [{ type: 0, value: '关闭模态' }] },
       pagination: {
@@ -157,7 +143,24 @@ export default {
         ],
       },
       select: { errorIconAriaLabel: [{ type: 0, value: '错误' }], selectedAriaLabel: [{ type: 0, value: '已选定' }] },
-      wizard: { errorIconAriaLabel: [{ type: 0, value: '错误' }], selectedAriaLabel: [{ type: 0, value: '已选定' }] },
+      wizard: {
+        'i18nStrings.stepNumberLabel': [
+          { type: 0, value: '第 ' },
+          { type: 1, value: 'stepNumber' },
+          { type: 0, value: ' 步' },
+        ],
+        'i18nStrings.collapsedStepsLabel': [
+          { type: 0, value: '第 ' },
+          { type: 1, value: 'stepNumber' },
+          { type: 0, value: ' 步，共 ' },
+          { type: 1, value: 'stepsCount' },
+          { type: 0, value: ' 步' },
+        ],
+        'i18nStrings.cancelButton': [{ type: 0, value: '取消' }],
+        'i18nStrings.previousButton': [{ type: 0, value: '上一步' }],
+        'i18nStrings.nextButton': [{ type: 0, value: '下一步' }],
+        'i18nStrings.optional': [{ type: 0, value: '可选' }],
+      },
     },
   },
 };

package/lib/internal/template/internal/i18n/messages/all.zh-CN.json

@@ -2,24 +2,6 @@
   "@cloudscape-design/components": {
     "zh-CN": {
       "alert": { "dismissAriaLabel": [{ "type": 0, "value": "退出提示" }] },
-      "autosuggest": {
-        "stepNumberLabel": [
-          { "type": 0, "value": "第 " },
-          { "type": 1, "value": "stepNumber" },
-          { "type": 0, "value": " 步" }
-        ],
-        "collapsedStepsLabel": [
-          { "type": 0, "value": "第 " },
-          { "type": 1, "value": "stepNumber" },
-          { "type": 0, "value": " 步，共 " },
-          { "type": 1, "value": "stepsCount" },
-          { "type": 0, "value": " 步" }
-        ],
-        "cancelButton": [{ "type": 0, "value": "取消" }],
-        "previousButton": [{ "type": 0, "value": "上一步" }],
-        "nextButton": [{ "type": 0, "value": "下一步" }],
-        "optional": [{ "type": 0, "value": "可选" }]
-      },
       "app-layout": {
         "ariaLabels.navigation": [{ "type": 0, "value": "侧导航" }],
         "ariaLabels.navigationClose": [{ "type": 0, "value": "关闭侧导航" }],
@@ -29,7 +11,11 @@
         "ariaLabels.toolsClose": [{ "type": 0, "value": "打开帮助面板" }],
         "ariaLabels.toolsToggle": [{ "type": 0, "value": "关闭帮助面板" }]
       },
-      "date-picker": {
+      "autosuggest": {
+        "errorIconAriaLabel": [{ "type": 0, "value": "错误" }],
+        "selectedAriaLabel": [{ "type": 0, "value": "已选定" }]
+      },
+      "calendar": {
         "nextMonthAriaLabel": [{ "type": 0, "value": "下个月" }],
         "previousMonthAriaLabel": [{ "type": 0, "value": "上个月" }],
         "todayAriaLabel": [{ "type": 0, "value": "今天" }]
@@ -44,8 +30,8 @@
         "i18nStrings.successIconAriaLabel": [{ "type": 0, "value": "成功" }],
         "i18nStrings.warningIconAriaLabel": [{ "type": 0, "value": "警告" }]
       },
-      "form": { "errorIconAriaLabel": [{ "type": 0, "value": "错误" }] },
       "form-field": { "i18nStrings.errorIconAriaLabel": [{ "type": 0, "value": "错误" }] },
+      "form": { "errorIconAriaLabel": [{ "type": 0, "value": "错误" }] },
       "input": { "clearAriaLabel": [{ "type": 0, "value": "清除" }] },
       "modal": { "closeAriaLabel": [{ "type": 0, "value": "关闭模态" }] },
       "pagination": {
@@ -161,8 +147,22 @@
         "selectedAriaLabel": [{ "type": 0, "value": "已选定" }]
       },
       "wizard": {
-        "errorIconAriaLabel": [{ "type": 0, "value": "错误" }],
-        "selectedAriaLabel": [{ "type": 0, "value": "已选定" }]
+        "i18nStrings.stepNumberLabel": [
+          { "type": 0, "value": "第 " },
+          { "type": 1, "value": "stepNumber" },
+          { "type": 0, "value": " 步" }
+        ],
+        "i18nStrings.collapsedStepsLabel": [
+          { "type": 0, "value": "第 " },
+          { "type": 1, "value": "stepNumber" },
+          { "type": 0, "value": " 步，共 " },
+          { "type": 1, "value": "stepsCount" },
+          { "type": 0, "value": " 步" }
+        ],
+        "i18nStrings.cancelButton": [{ "type": 0, "value": "取消" }],
+        "i18nStrings.previousButton": [{ "type": 0, "value": "上一步" }],
+        "i18nStrings.nextButton": [{ "type": 0, "value": "下一步" }],
+        "i18nStrings.optional": [{ "type": 0, "value": "可选" }]
       }
     }
   }

package/lib/internal/template/internal/i18n/messages/all.zh-TW.js

@@ -2,23 +2,6 @@ export default {
   '@cloudscape-design/components': {
     'zh-TW': {
       alert: { dismissAriaLabel: [{ type: 0, value: '關閉提醒' }] },
-      autosuggest: {
-        stepNumberLabel: [
-          { type: 0, value: '步驟 ' },
-          { type: 1, value: 'stepNumber' },
-        ],
-        collapsedStepsLabel: [
-          { type: 0, value: '步驟 ' },
-          { type: 1, value: 'stepNumber' },
-          { type: 0, value: '，共 ' },
-          { type: 1, value: 'stepsCount' },
-          { type: 0, value: ' 步' },
-        ],
-        cancelButton: [{ type: 0, value: '取消' }],
-        previousButton: [{ type: 0, value: '上一步' }],
-        nextButton: [{ type: 0, value: '下一步' }],
-        optional: [{ type: 0, value: '選用' }],
-      },
       'app-layout': {
         'ariaLabels.navigation': [{ type: 0, value: '側邊導覽' }],
         'ariaLabels.navigationClose': [{ type: 0, value: '關閉側邊導覽' }],
@@ -28,7 +11,11 @@ export default {
         'ariaLabels.toolsClose': [{ type: 0, value: '開啟說明面板' }],
         'ariaLabels.toolsToggle': [{ type: 0, value: '關閉說明面板' }],
       },
-      'date-picker': {
+      autosuggest: {
+        errorIconAriaLabel: [{ type: 0, value: '錯誤' }],
+        selectedAriaLabel: [{ type: 0, value: '已選取' }],
+      },
+      calendar: {
         nextMonthAriaLabel: [{ type: 0, value: '下個月' }],
         previousMonthAriaLabel: [{ type: 0, value: '上個月' }],
         todayAriaLabel: [{ type: 0, value: '今天' }],
@@ -43,8 +30,8 @@ export default {
         'i18nStrings.successIconAriaLabel': [{ type: 0, value: '成功' }],
         'i18nStrings.warningIconAriaLabel': [{ type: 0, value: '警告' }],
       },
-      form: { errorIconAriaLabel: [{ type: 0, value: '錯誤' }] },
       'form-field': { 'i18nStrings.errorIconAriaLabel': [{ type: 0, value: '錯誤' }] },
+      form: { errorIconAriaLabel: [{ type: 0, value: '錯誤' }] },
       input: { clearAriaLabel: [{ type: 0, value: '清除' }] },
       modal: { closeAriaLabel: [{ type: 0, value: '關閉強制回應' }] },
       pagination: {
@@ -156,7 +143,23 @@ export default {
         ],
       },
       select: { errorIconAriaLabel: [{ type: 0, value: '錯誤' }], selectedAriaLabel: [{ type: 0, value: '已選取' }] },
-      wizard: { errorIconAriaLabel: [{ type: 0, value: '錯誤' }], selectedAriaLabel: [{ type: 0, value: '已選取' }] },
+      wizard: {
+        'i18nStrings.stepNumberLabel': [
+          { type: 0, value: '步驟 ' },
+          { type: 1, value: 'stepNumber' },
+        ],
+        'i18nStrings.collapsedStepsLabel': [
+          { type: 0, value: '步驟 ' },
+          { type: 1, value: 'stepNumber' },
+          { type: 0, value: '，共 ' },
+          { type: 1, value: 'stepsCount' },
+          { type: 0, value: ' 步' },
+        ],
+        'i18nStrings.cancelButton': [{ type: 0, value: '取消' }],
+        'i18nStrings.previousButton': [{ type: 0, value: '上一步' }],
+        'i18nStrings.nextButton': [{ type: 0, value: '下一步' }],
+        'i18nStrings.optional': [{ type: 0, value: '選用' }],
+      },
     },
   },
 };

package/lib/internal/template/internal/i18n/messages/all.zh-TW.json

@@ -2,23 +2,6 @@
   "@cloudscape-design/components": {
     "zh-TW": {
       "alert": { "dismissAriaLabel": [{ "type": 0, "value": "關閉提醒" }] },
-      "autosuggest": {
-        "stepNumberLabel": [
-          { "type": 0, "value": "步驟 " },
-          { "type": 1, "value": "stepNumber" }
-        ],
-        "collapsedStepsLabel": [
-          { "type": 0, "value": "步驟 " },
-          { "type": 1, "value": "stepNumber" },
-          { "type": 0, "value": "，共 " },
-          { "type": 1, "value": "stepsCount" },
-          { "type": 0, "value": " 步" }
-        ],
-        "cancelButton": [{ "type": 0, "value": "取消" }],
-        "previousButton": [{ "type": 0, "value": "上一步" }],
-        "nextButton": [{ "type": 0, "value": "下一步" }],
-        "optional": [{ "type": 0, "value": "選用" }]
-      },
       "app-layout": {
         "ariaLabels.navigation": [{ "type": 0, "value": "側邊導覽" }],
         "ariaLabels.navigationClose": [{ "type": 0, "value": "關閉側邊導覽" }],
@@ -28,7 +11,11 @@
         "ariaLabels.toolsClose": [{ "type": 0, "value": "開啟說明面板" }],
         "ariaLabels.toolsToggle": [{ "type": 0, "value": "關閉說明面板" }]
       },
-      "date-picker": {
+      "autosuggest": {
+        "errorIconAriaLabel": [{ "type": 0, "value": "錯誤" }],
+        "selectedAriaLabel": [{ "type": 0, "value": "已選取" }]
+      },
+      "calendar": {
         "nextMonthAriaLabel": [{ "type": 0, "value": "下個月" }],
         "previousMonthAriaLabel": [{ "type": 0, "value": "上個月" }],
         "todayAriaLabel": [{ "type": 0, "value": "今天" }]
@@ -43,8 +30,8 @@
         "i18nStrings.successIconAriaLabel": [{ "type": 0, "value": "成功" }],
         "i18nStrings.warningIconAriaLabel": [{ "type": 0, "value": "警告" }]
       },
-      "form": { "errorIconAriaLabel": [{ "type": 0, "value": "錯誤" }] },
       "form-field": { "i18nStrings.errorIconAriaLabel": [{ "type": 0, "value": "錯誤" }] },
+      "form": { "errorIconAriaLabel": [{ "type": 0, "value": "錯誤" }] },
       "input": { "clearAriaLabel": [{ "type": 0, "value": "清除" }] },
       "modal": { "closeAriaLabel": [{ "type": 0, "value": "關閉強制回應" }] },
       "pagination": {
@@ -160,8 +147,21 @@
         "selectedAriaLabel": [{ "type": 0, "value": "已選取" }]
       },
       "wizard": {
-        "errorIconAriaLabel": [{ "type": 0, "value": "錯誤" }],
-        "selectedAriaLabel": [{ "type": 0, "value": "已選取" }]
+        "i18nStrings.stepNumberLabel": [
+          { "type": 0, "value": "步驟 " },
+          { "type": 1, "value": "stepNumber" }
+        ],
+        "i18nStrings.collapsedStepsLabel": [
+          { "type": 0, "value": "步驟 " },
+          { "type": 1, "value": "stepNumber" },
+          { "type": 0, "value": "，共 " },
+          { "type": 1, "value": "stepsCount" },
+          { "type": 0, "value": " 步" }
+        ],
+        "i18nStrings.cancelButton": [{ "type": 0, "value": "取消" }],
+        "i18nStrings.previousButton": [{ "type": 0, "value": "上一步" }],
+        "i18nStrings.nextButton": [{ "type": 0, "value": "下一步" }],
+        "i18nStrings.optional": [{ "type": 0, "value": "選用" }]
       }
     }
   }

package/lib/internal/template/internal/i18n/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/internal/i18n/provider.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAE1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAI1E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,aAAa,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,yBAAiB,iBAAiB,CAAC;IACjC,UAAiB,QAAQ;QACvB,CAAC,SAAS,EAAE,MAAM,GAAG;YACnB,CAAC,MAAM,EAAE,MAAM,GAAG;gBAChB,CAAC,SAAS,EAAE,MAAM,GAAG;oBACnB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,oBAAoB,EAAE,CAAC;iBAChD,CAAC;aACH,CAAC;SACH,CAAC;KACH;CACF;AASD,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,EAAE,iBAAiB,eAuD5G"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/internal/i18n/provider.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAE1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAK1E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,aAAa,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,yBAAiB,iBAAiB,CAAC;IACjC,UAAiB,QAAQ;QACvB,CAAC,SAAS,EAAE,MAAM,GAAG;YACnB,CAAC,MAAM,EAAE,MAAM,GAAG;gBAChB,CAAC,SAAS,EAAE,MAAM,GAAG;oBACnB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,oBAAoB,EAAE,CAAC;iBAChD,CAAC;aACH,CAAC;SACH,CAAC;KACH;CACF;AASD,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,EAAE,iBAAiB,eAuE5G"}

package/lib/internal/template/internal/i18n/provider.js

@@ -3,6 +3,7 @@
 import React, { useContext } from 'react';
 import IntlMessageFormat from 'intl-messageformat';
 import { InternalI18nContext } from './context';
+import { warnOnce } from '../logging';
 /**
  * Context to send parent messages down to child I18nProviders. This isn't
  * included in the InternalI18nContext to avoid components from depending on
@@ -10,14 +11,28 @@ import { InternalI18nContext } from './context';
  */
 const I18nMessagesContext = React.createContext({});
 export function I18nProvider({ messages: messagesArray, locale: providedLocale, children }) {
+    if (typeof document === 'undefined' && !providedLocale) {
+        warnOnce('I18nProvider', 'An explicit locale was not provided during server rendering. This can lead to a hydration mismatch on the client.');
+    }
     // The provider accepts an array of configs. We merge parent messages and
     // flatten the tree early on so that accesses by key are simpler and faster.
     const parentMessages = useContext(I18nMessagesContext);
     const messages = mergeMessages([parentMessages, ...messagesArray]);
-    // If a locale isn't provided, we can try and guess from the html lang,
-    // and lastly default to English. Locales have a recommended case, but are
-    // matched case-insensitively, so we lowercase it internally.
-    const locale = (providedLocale || (document === null || document === void 0 ? void 0 : document.documentElement.lang) || 'en').toLowerCase();
+    let locale;
+    if (providedLocale) {
+        // If a locale is explicitly provided, use the string directly.
+        // Locales have a recommended case, but are matched case-insensitively,
+        // so we lowercase it internally.
+        locale = providedLocale.toLowerCase();
+    }
+    else if (typeof document !== 'undefined' && document.documentElement.lang) {
+        // Otherwise, use the value provided in the HTML tag.
+        locale = document.documentElement.lang.toLowerCase();
+    }
+    else {
+        // Lastly, fall back to English.
+        locale = 'en';
+    }
     const format = (namespace, component, key, provided, customHandler) => {
         var _a, _b, _c;
         // A general rule in the library is that undefined is basically
@@ -48,7 +63,7 @@ export function I18nProvider({ messages: messagesArray, locale: providedLocale,
         // Assuming `T extends string` since a customHandler wasn't provided.
         return intlMessageFormat.format();
     };
-    return (React.createElement(InternalI18nContext.Provider, { value: format },
+    return (React.createElement(InternalI18nContext.Provider, { value: { locale, format } },
         React.createElement(I18nMessagesContext.Provider, { value: messages }, children)));
 }
 function mergeMessages(sources) {

package/lib/internal/template/internal/i18n/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/internal/i18n/provider.tsx"],"names":[],"mappings":"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","sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport React, { useContext } from 'react';\nimport IntlMessageFormat from 'intl-messageformat';\nimport { MessageFormatElement } from '@formatjs/icu-messageformat-parser';\n\nimport { InternalI18nContext, FormatFunction, CustomHandler } from './context';\n\nexport interface I18nProviderProps {\n  messages: ReadonlyArray<I18nProviderProps.Messages>;\n  locale?: string;\n  children: React.ReactNode;\n}\n\nexport namespace I18nProviderProps {\n  export interface Messages {\n    [namespace: string]: {\n      [locale: string]: {\n        [component: string]: {\n          [key: string]: string | MessageFormatElement[];\n        };\n      };\n    };\n  }\n}\n\n/**\n * Context to send parent messages down to child I18nProviders. This isn't\n * included in the InternalI18nContext to avoid components from depending on\n * MessageFormatElement types.\n */\nconst I18nMessagesContext = React.createContext<I18nProviderProps.Messages>({});\n\nexport function I18nProvider({ messages: messagesArray, locale: providedLocale, children }: I18nProviderProps) {\n  // The provider accepts an array of configs. We merge parent messages and\n  // flatten the tree early on so that accesses by key are simpler and faster.\n  const parentMessages = useContext(I18nMessagesContext);\n  const messages = mergeMessages([parentMessages, ...messagesArray]);\n\n  // If a locale isn't provided, we can try and guess from the html lang,\n  // and lastly default to English. Locales have a recommended case, but are\n  // matched case-insensitively, so we lowercase it internally.\n  const locale = (providedLocale || document?.documentElement.lang || 'en').toLowerCase();\n\n  const format: FormatFunction = <T,>(\n    namespace: string,\n    component: string,\n    key: string,\n    provided: T,\n    customHandler?: CustomHandler<T>\n  ): T => {\n    // A general rule in the library is that undefined is basically\n    // treated as \"not provided\". So even if a user explicitly provides an\n    // undefined value, it will default to i18n values.\n    if (provided !== undefined) {\n      return provided;\n    }\n\n    // Widen the locale string (e.g. en-GB -> en) until we find a locale\n    // that contains the message we need.\n    let message: string | MessageFormatElement[] | undefined;\n    const matchableLocales = getMatchableLocales(locale);\n    for (const matchableLocale of matchableLocales) {\n      const localeMessage = messages?.[namespace]?.[matchableLocale]?.[component]?.[key];\n      if (localeMessage !== undefined) {\n        message = localeMessage;\n        break;\n      }\n    }\n\n    // If a message wasn't found, exit early.\n    if (message === undefined) {\n      return provided;\n    }\n\n    const intlMessageFormat = new IntlMessageFormat(message, locale);\n    if (customHandler) {\n      return customHandler(args => intlMessageFormat.format(args) as string);\n    }\n    // Assuming `T extends string` since a customHandler wasn't provided.\n    return intlMessageFormat.format() as T;\n  };\n\n  return (\n    <InternalI18nContext.Provider value={format}>\n      <I18nMessagesContext.Provider value={messages}>{children}</I18nMessagesContext.Provider>\n    </InternalI18nContext.Provider>\n  );\n}\n\nfunction mergeMessages(sources: ReadonlyArray<I18nProviderProps.Messages>): I18nProviderProps.Messages {\n  const result: I18nProviderProps.Messages = {};\n  for (const messages of sources) {\n    for (const namespace in messages) {\n      if (!(namespace in result)) {\n        result[namespace] = {};\n      }\n      for (const casedLocale in messages[namespace]) {\n        const locale = casedLocale.toLowerCase();\n        if (!(locale in result[namespace])) {\n          result[namespace][locale] = {};\n        }\n        for (const component in messages[namespace][casedLocale]) {\n          if (!(component in result[namespace][locale])) {\n            result[namespace][locale][component] = {};\n          }\n          for (const key in messages[namespace][casedLocale][component]) {\n            result[namespace][locale][component][key] = messages[namespace][casedLocale][component][key];\n          }\n        }\n      }\n    }\n  }\n  return result;\n}\n\nfunction getMatchableLocales(ietfLanguageTag: string): string[] {\n  const parts = ietfLanguageTag.split('-');\n  if (parts.length === 1) {\n    return [ietfLanguageTag];\n  }\n\n  const localeStrings: string[] = [];\n  for (let i = parts.length; i > 0; i--) {\n    localeStrings.push(parts.slice(0, i).join('-'));\n  }\n  return localeStrings;\n}\n"]}
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/internal/i18n/provider.tsx"],"names":[],"mappings":"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","sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport React, { useContext } from 'react';\nimport IntlMessageFormat from 'intl-messageformat';\nimport { MessageFormatElement } from '@formatjs/icu-messageformat-parser';\n\nimport { InternalI18nContext, FormatFunction, CustomHandler } from './context';\nimport { warnOnce } from '../logging';\n\nexport interface I18nProviderProps {\n  messages: ReadonlyArray<I18nProviderProps.Messages>;\n  locale?: string;\n  children: React.ReactNode;\n}\n\nexport namespace I18nProviderProps {\n  export interface Messages {\n    [namespace: string]: {\n      [locale: string]: {\n        [component: string]: {\n          [key: string]: string | MessageFormatElement[];\n        };\n      };\n    };\n  }\n}\n\n/**\n * Context to send parent messages down to child I18nProviders. This isn't\n * included in the InternalI18nContext to avoid components from depending on\n * MessageFormatElement types.\n */\nconst I18nMessagesContext = React.createContext<I18nProviderProps.Messages>({});\n\nexport function I18nProvider({ messages: messagesArray, locale: providedLocale, children }: I18nProviderProps) {\n  if (typeof document === 'undefined' && !providedLocale) {\n    warnOnce(\n      'I18nProvider',\n      'An explicit locale was not provided during server rendering. This can lead to a hydration mismatch on the client.'\n    );\n  }\n\n  // The provider accepts an array of configs. We merge parent messages and\n  // flatten the tree early on so that accesses by key are simpler and faster.\n  const parentMessages = useContext(I18nMessagesContext);\n  const messages = mergeMessages([parentMessages, ...messagesArray]);\n\n  let locale: string;\n  if (providedLocale) {\n    // If a locale is explicitly provided, use the string directly.\n    // Locales have a recommended case, but are matched case-insensitively,\n    // so we lowercase it internally.\n    locale = providedLocale.toLowerCase();\n  } else if (typeof document !== 'undefined' && document.documentElement.lang) {\n    // Otherwise, use the value provided in the HTML tag.\n    locale = document.documentElement.lang.toLowerCase();\n  } else {\n    // Lastly, fall back to English.\n    locale = 'en';\n  }\n\n  const format: FormatFunction = <T,>(\n    namespace: string,\n    component: string,\n    key: string,\n    provided: T,\n    customHandler?: CustomHandler<T>\n  ): T => {\n    // A general rule in the library is that undefined is basically\n    // treated as \"not provided\". So even if a user explicitly provides an\n    // undefined value, it will default to i18n values.\n    if (provided !== undefined) {\n      return provided;\n    }\n\n    // Widen the locale string (e.g. en-GB -> en) until we find a locale\n    // that contains the message we need.\n    let message: string | MessageFormatElement[] | undefined;\n    const matchableLocales = getMatchableLocales(locale);\n    for (const matchableLocale of matchableLocales) {\n      const localeMessage = messages?.[namespace]?.[matchableLocale]?.[component]?.[key];\n      if (localeMessage !== undefined) {\n        message = localeMessage;\n        break;\n      }\n    }\n\n    // If a message wasn't found, exit early.\n    if (message === undefined) {\n      return provided;\n    }\n\n    const intlMessageFormat = new IntlMessageFormat(message, locale);\n    if (customHandler) {\n      return customHandler(args => intlMessageFormat.format(args) as string);\n    }\n    // Assuming `T extends string` since a customHandler wasn't provided.\n    return intlMessageFormat.format() as T;\n  };\n\n  return (\n    <InternalI18nContext.Provider value={{ locale, format }}>\n      <I18nMessagesContext.Provider value={messages}>{children}</I18nMessagesContext.Provider>\n    </InternalI18nContext.Provider>\n  );\n}\n\nfunction mergeMessages(sources: ReadonlyArray<I18nProviderProps.Messages>): I18nProviderProps.Messages {\n  const result: I18nProviderProps.Messages = {};\n  for (const messages of sources) {\n    for (const namespace in messages) {\n      if (!(namespace in result)) {\n        result[namespace] = {};\n      }\n      for (const casedLocale in messages[namespace]) {\n        const locale = casedLocale.toLowerCase();\n        if (!(locale in result[namespace])) {\n          result[namespace][locale] = {};\n        }\n        for (const component in messages[namespace][casedLocale]) {\n          if (!(component in result[namespace][locale])) {\n            result[namespace][locale][component] = {};\n          }\n          for (const key in messages[namespace][casedLocale][component]) {\n            result[namespace][locale][component][key] = messages[namespace][casedLocale][component][key];\n          }\n        }\n      }\n    }\n  }\n  return result;\n}\n\nfunction getMatchableLocales(ietfLanguageTag: string): string[] {\n  const parts = ietfLanguageTag.split('-');\n  if (parts.length === 1) {\n    return [ietfLanguageTag];\n  }\n\n  const localeStrings: string[] = [];\n  for (let i = parts.length; i > 0; i--) {\n    localeStrings.push(parts.slice(0, i).join('-'));\n  }\n  return localeStrings;\n}\n"]}