@instructure/ui-i18n 10.16.1 → 10.16.3

package/lib/__new-tests__/DateTime.test.js

@@ -0,0 +1,157 @@
+"use strict";
+
+require("@testing-library/jest-dom");
+var _vitest = require("vitest");
+var _DateTime = require("../DateTime");
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+const now = _DateTime.DateTime.now,
+  isValid = _DateTime.DateTime.isValid,
+  browserTimeZone = _DateTime.DateTime.browserTimeZone,
+  parse = _DateTime.DateTime.parse,
+  toLocaleString = _DateTime.DateTime.toLocaleString,
+  getFirstDayOfWeek = _DateTime.DateTime.getFirstDayOfWeek,
+  getLocalDayNamesOfTheWeek = _DateTime.DateTime.getLocalDayNamesOfTheWeek;
+describe('DateTime', () => {
+  const timezone = 'America/Halifax'; // -3
+  const locale = 'en';
+  it('checks params', () => {
+    let whoops = false;
+    try {
+      // @ts-expect-error intentionally wrong
+      now();
+    } catch (ex) {
+      whoops = true;
+    } finally {
+      (0, _vitest.expect)(whoops).toBe(true);
+    }
+    whoops = false;
+    try {
+      // @ts-expect-error intentionally wrong
+      now(locale);
+    } catch (ex) {
+      whoops = true;
+    } finally {
+      (0, _vitest.expect)(whoops).toBe(true);
+    }
+  });
+  it('knows when now is', () => {
+    // not much of a test, but I need it for coverage stats
+    const result = now(locale, timezone);
+    (0, _vitest.expect)(result).toBeDefined();
+  });
+  it("can figure out the browser's timezone", () => {
+    const result = browserTimeZone();
+    (0, _vitest.expect)(result).toBeDefined();
+  });
+  it('validates', () => {
+    (0, _vitest.expect)(isValid('2018-04-15T23:30:00Z')).toBe(true);
+    (0, _vitest.expect)(isValid('2018-04-15T23:30')).toBe(true);
+    (0, _vitest.expect)(isValid('2018-04-15')).toBe(true);
+  });
+  it('parses iso8601', () => {
+    const result = parse('2018-04-15T20:30:00-03:00', locale, timezone).toISOString();
+    (0, _vitest.expect)(result).toEqual('2018-04-15T23:30:00.000Z');
+  });
+  it('parses llll', () => {
+    const result = parse('Sun, Apr 15, 2018 8:30 PM', locale, timezone).toISOString();
+    (0, _vitest.expect)(result).toEqual('2018-04-15T23:30:00.000Z');
+  });
+  it('parses LLLL', () => {
+    const result = parse('Sunday, April 15, 2018 8:30 PM', locale, timezone).toISOString();
+    (0, _vitest.expect)(result).toEqual('2018-04-15T23:30:00.000Z');
+  });
+  it('parses lll', () => {
+    const result = parse('Apr 15, 2018 8:30 PM', locale, timezone).toISOString();
+    (0, _vitest.expect)(result).toEqual('2018-04-15T23:30:00.000Z');
+  });
+  it('parses LLL', () => {
+    const result = parse('April 15, 2018 8:30 PM', locale, timezone).toISOString();
+    (0, _vitest.expect)(result).toEqual('2018-04-15T23:30:00.000Z');
+  });
+  it('parses ll', () => {
+    const result = parse('Apr 15, 2018', locale, timezone).toISOString();
+    (0, _vitest.expect)(result).toEqual('2018-04-15T03:00:00.000Z');
+  });
+  it('parses LL', () => {
+    const result = parse('April 15, 2018', locale, timezone).toISOString();
+    (0, _vitest.expect)(result).toEqual('2018-04-15T03:00:00.000Z');
+  });
+  it('parses l', () => {
+    const result = parse('4/15/2018', locale, timezone).toISOString();
+    (0, _vitest.expect)(result).toEqual('2018-04-15T03:00:00.000Z');
+  });
+  it('parses L', () => {
+    const result = parse('04/15/2018', locale, timezone).toISOString();
+    (0, _vitest.expect)(result).toEqual('2018-04-15T03:00:00.000Z');
+  });
+  it('parses French L', () => {
+    const result = parse('15/04/2018', 'fr', timezone).toISOString();
+    (0, _vitest.expect)(result).toEqual('2018-04-15T03:00:00.000Z');
+  });
+  it('parses French LL', () => {
+    const result = parse('15 Avril, 2018', 'fr', timezone).toISOString();
+    (0, _vitest.expect)(result).toEqual('2018-04-15T03:00:00.000Z');
+  });
+  it('returns localized string', () => {
+    let result = toLocaleString('2018-04-15T13:00Z', 'en', 'UTC', 'LLL');
+    (0, _vitest.expect)(result).toEqual('April 15, 2018 1:00 PM');
+    result = toLocaleString('2018-04-15T13:00Z', 'fr', 'UTC', 'LLL');
+    (0, _vitest.expect)(result).toEqual('15 avril 2018 13:00');
+    // iso8601 in given timezone
+    result = toLocaleString('2018-04-15T13:00Z', 'fr', 'America/Halifax'); // -3
+    (0, _vitest.expect)(result).toEqual('2018-04-15T10:00:00.000-03:00');
+  });
+  it('calculates the first day of the week', () => {
+    // normal case
+    const d11 = _DateTime.DateTime.parse('2021-09-15T20:30:00Z', 'hu-hu', 'UTC');
+    (0, _vitest.expect)(getFirstDayOfWeek(d11).date()).toEqual(13);
+    const d12 = _DateTime.DateTime.parse('2021-09-15T20:30:00Z', 'en-us', 'UTC');
+    (0, _vitest.expect)(getFirstDayOfWeek(d12).date()).toEqual(12);
+    // date wraps month/year
+    const d21 = _DateTime.DateTime.parse('2022-01-01T20:30:00Z', 'hu-hu', 'UTC');
+    (0, _vitest.expect)(getFirstDayOfWeek(d21).date()).toEqual(27);
+    const d22 = _DateTime.DateTime.parse('2022-01-01T20:30:00Z', 'en-us', 'UTC');
+    (0, _vitest.expect)(getFirstDayOfWeek(d22).date()).toEqual(26);
+
+    // Monday
+    const d31 = _DateTime.DateTime.parse('2021-12-05T20:30:00Z', 'hu-hu', 'UTC');
+    (0, _vitest.expect)(getFirstDayOfWeek(d31).date()).toEqual(29);
+    // Sunday
+    const d32 = _DateTime.DateTime.parse('2021-12-05T20:30:00Z', 'en-us', 'UTC');
+    (0, _vitest.expect)(getFirstDayOfWeek(d32).date()).toEqual(5);
+    // Sunday (but in other systems Friday)
+    const d33 = _DateTime.DateTime.parse('2021-12-05T20:30:00Z', 'bn-bd', 'UTC');
+    (0, _vitest.expect)(getFirstDayOfWeek(d33).date()).toEqual(5);
+  });
+  it('calculates the local day names of the week', () => {
+    // short names
+    (0, _vitest.expect)(getLocalDayNamesOfTheWeek('hu-hu', 'short')).toEqual(['h', 'k', 'sze', 'cs', 'p', 'szo', 'v']);
+    (0, _vitest.expect)(getLocalDayNamesOfTheWeek('en-us', 'short')).toEqual(['Su', 'Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa']);
+    // long
+    (0, _vitest.expect)(getLocalDayNamesOfTheWeek('en-us', 'long')).toEqual(['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday']);
+    (0, _vitest.expect)(getLocalDayNamesOfTheWeek('es-mx', 'long')).toEqual(['domingo', 'lunes', 'martes', 'miércoles', 'jueves', 'viernes', 'sábado']);
+  });
+});

package/lib/__new-tests__/I18nPropTypes.test.js

@@ -0,0 +1,56 @@
+"use strict";
+
+require("@testing-library/jest-dom");
+var _vitest = require("vitest");
+var _I18nPropTypes = require("../I18nPropTypes");
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2018 - present Instructure, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+describe('I18nPropTypes', () => {
+  describe('iso8601', () => {
+    const iso8601 = _I18nPropTypes.I18nPropTypes.iso8601;
+
+    // Test cases taken from https://www.myintervals.com/blog/2009/05/20/iso-8601-date-validation-that-doesnt-suck/
+    it('should not return error when provided with a valid ISO8601 string', () => {
+      const props = {
+        date: null
+      };
+      const validISO8601Strings = ['2009-12T12:34', '2009', '2009-05-19', '20090519', '2009123', '2009-05', '2009-123', '2009-222', '2009-001', '2009-W01-1', '2009-W51-1', '2009-W511', '2009-W33', '2009W511', '2009-05-19', '2009-05-19 00:00', '2009-05-19 14', '2009-05-19 14:31', '2009-05-19 14:39:22', '2009-05-19T14:39Z', '2009-W21-2', '2009-W21-2T01:22', '2009-139', '2009-05-19 14:39:22-06:00', '2009-05-19 14:39:22+0600', '2009-05-19 14:39:22-01', '20090621T0545Z', '2007-04-06T00:00', '2007-04-05T24:00', '2010-02-18T16:23:48.5', '2010-02-18T16:23:48,444', '2010-02-18T16:23:48,3-06:00', '2010-02-18T16:23.4', '2010-02-18T16:23,25', '2010-02-18T16:23.33+0600', '2010-02-18T16.23334444', '2010-02-18T16,2283', '2009-05-19 143922.500', '2009-05-19 1439,55'];
+      validISO8601Strings.forEach(iso8601string => {
+        props.date = iso8601string;
+        (0, _vitest.expect)(iso8601(props, 'date', 'TestComponent', '', '')).toBe(null);
+      });
+    });
+    it('should return error when provided with an invalid ISO8601 string', () => {
+      const props = {
+        date: null
+      };
+      const invalidISO8601Strings = ['some text', 'June 27, 1990', '200905', '2009367', '2009-', '2007-04-05T24:50', '2009-000', '2009-M511', '2009M511', '2009-05-19T14a39r', '2009-05-19T14:3924', '2009-0519', '2009-05-1914:39', '2009-05-19 14:', '2009-05-19r14:39', '2009-05-19 14a39a22', '200912-01', '2009-05-19 14:39:22+06a00', '2009-05-19 146922.500', '2010-02-18T16.5:23.35:48', '2010-02-18T16:23.35:48', '2010-02-18T16:23.35:48.45', '2009-05-19 14.5.44', '2010-02-18T16:23.33.600', '2010-02-18T16,25:23:48,444'];
+      invalidISO8601Strings.forEach(iso8601string => {
+        props.date = iso8601string;
+        (0, _vitest.expect)(iso8601(props, 'date', 'TestComponent', '', '')).toBeInstanceOf(Error);
+      });
+    });
+  });
+});

package/lib/__new-tests__/Locale.test.js

@@ -0,0 +1,54 @@
+"use strict";
+
+require("@testing-library/jest-dom");
+var _vitest = require("vitest");
+var _Locale = require("../Locale");
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+describe('browserLocale', () => {
+  it('returns the navigator language if a navigator is explicity passed', () => {
+    const navigator = {
+      language: 'de'
+    };
+    (0, _vitest.expect)(_Locale.Locale.browserLocale(navigator)).toBe('de');
+  });
+  describe('with document lang attribute', () => {
+    it('returns the document locale if no navigator is passed', () => {
+      const original = document.documentElement.lang;
+      document.documentElement.lang = 'fr';
+      (0, _vitest.expect)(_Locale.Locale.browserLocale()).toBe('fr');
+
+      // Restore global
+      document.documentElement.lang = original;
+    });
+  });
+  it('returns the browser locale if no navigator is passed, or "en-US" if no browser locale is set', () => {
+    const expectedLanguage = navigator ? navigator.language : 'en-US';
+    (0, _vitest.expect)(_Locale.Locale.browserLocale()).toBe(expectedLanguage);
+  });
+  it('returns the default "en-US" if navigator is undefined and the DOM is unavailable', () => {
+    (0, _vitest.expect)(_Locale.Locale.browserLocale(null, false)).toBe('en-US');
+  });
+});

package/lib/__new-tests__/textDirectionContextConsumer.test.js

@@ -0,0 +1,110 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+var _react = require("react");
+var _reactDom = _interopRequireDefault(require("react-dom"));
+var _testUtils = _interopRequireDefault(require("react-dom/test-utils"));
+var _react2 = require("@testing-library/react");
+require("@testing-library/jest-dom");
+var _vitest = require("vitest");
+var _textDirectionContextConsumer = require("../textDirectionContextConsumer");
+var _TextDirectionContext4 = require("../TextDirectionContext");
+var _jsxRuntime = require("@emotion/react/jsx-runtime");
+var _dec, _class, _TextDirectionContextConsumerComponent, _div, _TextDirectionContext, _WrapperComponent2, _TextDirectionContext2, _TextDirectionContext3;
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+let TextDirectionContextConsumerComponent = (_dec = (0, _textDirectionContextConsumer.textDirectionContextConsumer)(), _dec(_class = (_TextDirectionContextConsumerComponent = class TextDirectionContextConsumerComponent extends _react.Component {
+  render() {
+    return (0, _jsxRuntime.jsx)("div", {
+      "data-dir": this.props.dir,
+      dir: this.props.dir,
+      children: this.props.children
+    });
+  }
+}, _TextDirectionContextConsumerComponent.displayName = "TextDirectionContextConsumerComponent", _TextDirectionContextConsumerComponent)) || _class);
+class WrapperComponent extends _react.Component {
+  render() {
+    return _div || (_div = (0, _jsxRuntime.jsx)("div", {
+      children: (0, _jsxRuntime.jsx)(TextDirectionContextConsumerComponent, {})
+    }));
+  }
+}
+WrapperComponent.displayName = "WrapperComponent";
+describe('@textDirectionContextConsumer', () => {
+  let consoleErrorMock;
+  beforeEach(() => {
+    // Mocking console to prevent test output pollution
+    consoleErrorMock = _vitest.vi.spyOn(console, 'error').mockImplementation(() => {});
+  });
+  afterEach(() => {
+    consoleErrorMock.mockRestore();
+  });
+  it('should take on the direction of the document by default', async () => {
+    const _render = (0, _react2.render)(_TextDirectionContext || (_TextDirectionContext = (0, _jsxRuntime.jsx)(TextDirectionContextConsumerComponent, {}))),
+      container = _render.container;
+    (0, _vitest.expect)(container.firstChild).toHaveAttribute('data-dir', 'ltr');
+  });
+  it('can be found and tested with ReactTestUtils', async () => {
+    const rootNode = document.createElement('div');
+    document.body.appendChild(rootNode);
+
+    // eslint-disable-next-line react/no-render-return-value
+    const rendered = _reactDom.default.render(_WrapperComponent2 || (_WrapperComponent2 = (0, _jsxRuntime.jsx)(WrapperComponent, {})), rootNode);
+    const foundComponent = _testUtils.default.findRenderedComponentWithType(rendered, TextDirectionContextConsumerComponent.originalType);
+    (0, _vitest.expect)(foundComponent).toBeDefined();
+  });
+  it('should set the text direction via props', async () => {
+    const _render2 = (0, _react2.render)(_TextDirectionContext2 || (_TextDirectionContext2 = (0, _jsxRuntime.jsx)(TextDirectionContextConsumerComponent, {
+        dir: "rtl"
+      }))),
+      container = _render2.container;
+    (0, _vitest.expect)(container.firstChild).toHaveAttribute('data-dir', 'rtl');
+  });
+
+  /* TODO re-enable this test when we allow 'auto' text direction
+  it('setting "auto" from context figures out text direction from the text', async () => {
+    const subject = await mount(
+      <TextDirectionContextConsumerComponent dir="auto">
+        <span>
+          هذه الفقرة باللغة العربية ، لذا يجب الانتقال من اليمين إلى اليسار.
+        </span>
+      </TextDirectionContextConsumerComponent>
+    )
+    expect(
+      getComputedStyle(subject.getDOMNode().childNodes[0] as Element).direction
+    ).to.equal('rtl')
+  })
+  */
+
+  it('should give props preference when context and context are present', async () => {
+    const _render3 = (0, _react2.render)(_TextDirectionContext3 || (_TextDirectionContext3 = (0, _jsxRuntime.jsx)(_TextDirectionContext4.TextDirectionContext.Provider, {
+        value: "ltr",
+        children: (0, _jsxRuntime.jsx)(TextDirectionContextConsumerComponent, {
+          dir: "rtl"
+        })
+      }))),
+      container = _render3.container;
+    (0, _vitest.expect)(container.firstChild).toHaveAttribute('data-dir', 'rtl');
+  });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instructure/ui-i18n",
-  "version": "10.16.1",
+  "version": "10.16.3",
   "description": "Helper components and utilities for internationalization.",
   "author": "Instructure, Inc. Engineering and Product Design",
   "module": "./es/index.js",
@@ -23,19 +23,21 @@
   },
   "license": "MIT",
   "devDependencies": {
-    "@instructure/ui-babel-preset": "10.16.1",
-    "@instructure/ui-test-utils": "10.16.1",
+    "@instructure/ui-babel-preset": "10.16.3",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.0.1",
     "@types/hoist-non-react-statics": "^3.3.5",
-    "react-dom": "^18.3.1"
+    "react-dom": "^18.3.1",
+    "vitest": "^2.1.8"
   },
   "dependencies": {
     "@babel/runtime": "^7.26.0",
-    "@instructure/shared-types": "10.16.1",
-    "@instructure/ui-decorator": "10.16.1",
-    "@instructure/ui-dom-utils": "10.16.1",
-    "@instructure/ui-prop-types": "10.16.1",
-    "@instructure/ui-react-utils": "10.16.1",
-    "@instructure/ui-utils": "10.16.1",
+    "@instructure/shared-types": "10.16.3",
+    "@instructure/ui-decorator": "10.16.3",
+    "@instructure/ui-dom-utils": "10.16.3",
+    "@instructure/ui-prop-types": "10.16.3",
+    "@instructure/ui-react-utils": "10.16.3",
+    "@instructure/ui-utils": "10.16.3",
     "hoist-non-react-statics": "^3.3.2",
     "moment-timezone": "^0.5.45",
     "prop-types": "^15.8.1"

package/src/ApplyLocale/__new-tests__/ApplyLocale.test.tsx

@@ -0,0 +1,63 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { Component } from 'react'
+import { render } from '@testing-library/react'
+import '@testing-library/jest-dom'
+import { expect } from 'vitest'
+import { ApplyLocale } from '../index'
+import { ApplyLocaleContext } from '../ApplyLocaleContext'
+
+class LocalizableComponent extends Component {
+  declare context: React.ContextType<typeof ApplyLocaleContext>
+  static contextType = ApplyLocaleContext
+
+  render() {
+    return (
+      <div>
+        <span>{this.context.locale}</span>
+        <span>{this.context.timezone}</span>
+      </div>
+    )
+  }
+}
+
+describe('<ApplyLocale />', async () => {
+  it('applies locale context', async () => {
+    const { container } = render(
+      <ApplyLocale locale="fr">
+        <LocalizableComponent />
+      </ApplyLocale>
+    )
+    expect(container).toHaveTextContent('fr')
+  })
+
+  it('applies timezone context', async () => {
+    const { container } = render(
+      <ApplyLocale timezone="Europe/Paris">
+        <LocalizableComponent />
+      </ApplyLocale>
+    )
+    expect(container).toHaveTextContent('Europe/Paris')
+  })
+})