feat(calendar): add calendar component

packages/calendar/.npmignore

@@ -0,0 +1,2 @@
+stories
+test

packages/calendar/README.md

@@ -0,0 +1,40 @@
+## Description
+
+### Usage
+
+[![See it on NPM!](https://img.shields.io/npm/v/@spectrum-web-components/calendar?style=for-the-badge)](https://www.npmjs.com/package/@spectrum-web-components/calendar)
+[![How big is this package in your project?](https://img.shields.io/bundlephobia/minzip/@spectrum-web-components/calendar?style=for-the-badge)](https://bundlephobia.com/result?p=@spectrum-web-components/calendar)
+
+```
+yarn add @spectrum-web-components/calendar
+```
+
+Import the side effectful registration of `<sp-calendar>` via:
+
+```
+import '@spectrum-web-components/calendar/sp-calendar.js';
+```
+
+When looking to leverage the `Calendar` base class as a type and/or for extension purposes, do so via:
+
+```
+import { Calendar } from '@spectrum-web-components/calendar';
+```
+
+## Example
+
+```html
+<sp-calendar></sp-calendar>
+```
+
+## To-do list
+
+-   Implement a cache mechanism to store the value of `today` and use this value to initialise `currentDate`
+-   Include a condition to run the `setWeekdays()` method only when really needed
+-   Attribute 'role="heading"' removed, due to error 'The "heading" role requires the attribute "aria-level"'
+-   Translate the "Previous" text used in the "title" and "aria-label" of the button displayed in the header of the calendar
+-   Translate the "Next" text used in the "title" and "aria-label" of the button displayed in the header of the calendar
+-   The title must include "Today," and " selected" translated to the current language
+-   Implement keyboard navigation
+-   Add support for other types of calendars - [React Calendar: International Calendars](https://react-spectrum.adobe.com/react-spectrum/Calendar.html#international-calendars)
+-   Include `aria-label` in calendar for accessibility - [React Calendar: Labeling](https://react-spectrum.adobe.com/react-spectrum/Calendar.html#labeling)

packages/calendar/exports.json

@@ -0,0 +1,4 @@
+{
+    "./src/*": "./src/*.js",
+    "./sp-calendar.js": "./sp-calendar.js"
+}

packages/calendar/package.json

@@ -0,0 +1,80 @@
+{
+    "name": "@spectrum-web-components/calendar",
+    "version": "0.0.1",
+    "publishConfig": {
+        "access": "public"
+    },
+    "description": "Web component implementation of a Spectrum Calendar",
+    "license": "Apache-2.0",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/adobe/spectrum-web-components.git",
+        "directory": "packages/calendar"
+    },
+    "author": "",
+    "homepage": "https://adobe.github.io/spectrum-web-components/components/calendar",
+    "bugs": {
+        "url": "https://github.com/adobe/spectrum-web-components/issues"
+    },
+    "main": "./src/index.js",
+    "module": "./src/index.js",
+    "type": "module",
+    "exports": {
+        ".": {
+            "development": "./src/index.dev.js",
+            "default": "./src/index.js"
+        },
+        "./package.json": "./package.json",
+        "./src/Calendar.js": {
+            "development": "./src/Calendar.dev.js",
+            "default": "./src/Calendar.js"
+        },
+        "./src/calendar.css.js": "./src/calendar.css.js",
+        "./src/index.js": {
+            "development": "./src/index.dev.js",
+            "default": "./src/index.js"
+        },
+        "./src/types.js": {
+            "development": "./src/types.dev.js",
+            "default": "./src/types.js"
+        },
+        "./sp-calendar.js": {
+            "development": "./sp-calendar.dev.js",
+            "default": "./sp-calendar.js"
+        }
+    },
+    "scripts": {
+        "test": "echo \"Error: run tests from mono-repo root.\" && exit 1"
+    },
+    "files": [
+        "**/*.d.ts",
+        "**/*.js",
+        "**/*.js.map",
+        "custom-elements.json",
+        "!stories/",
+        "!test/"
+    ],
+    "keywords": [
+        "spectrum css",
+        "web components",
+        "lit-element",
+        "lit-html"
+    ],
+    "dependencies": {
+        "@internationalized/date": "^3.2.0",
+        "@internationalized/number": "^3.1.0",
+        "@spectrum-web-components/action-button": "^0.34.0",
+        "@spectrum-web-components/base": "^0.34.0",
+        "@spectrum-web-components/icons-workflow": "^0.34.0",
+        "@spectrum-web-components/reactive-controllers": "^0.34.0"
+    },
+    "devDependencies": {
+        "@spectrum-css/calendar": "^3.2.6"
+    },
+    "types": "./src/index.d.ts",
+    "customElements": "custom-elements.json",
+    "sideEffects": [
+        "./sp-*.js",
+        "./**/*.dev.js"
+    ]
+}

packages/calendar/sp-calendar.ts

@@ -0,0 +1,20 @@
+/*
+Copyright 2023 Adobe. All rights reserved.
+This file is licensed to you under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License. You may obtain a copy
+of the License at http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under
+the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+OF ANY KIND, either express or implied. See the License for the specific language
+governing permissions and limitations under the License.
+*/
+import { Calendar } from './src/Calendar.js';
+
+customElements.define('sp-calendar', Calendar);
+
+declare global {
+    interface HTMLElementTagNameMap {
+        'sp-calendar': Calendar;
+    }
+}