volto-aemet 1.0.0-alpha.0

package/.changelog.draft

@@ -0,0 +1,3 @@
+## 1.0.0-alpha.0 (2026-07-20)
+
+

package/.release-it.json

@@ -0,0 +1,34 @@
+{
+  "plugins": {
+    "../../core/packages/scripts/prepublish.js": {}
+  },
+  "hooks": {
+    "after:bump": [
+      "pipx run towncrier build --draft --yes --version ${version} > .changelog.draft",
+      "pipx run towncrier build --yes --version ${version}",
+      "cp ../../README.md ./ && cp CHANGELOG.md ../../CHANGELOG.md",
+      "python3 -c 'import json; data = json.load(open(\"../../package.json\")); data[\"version\"] = \"${version}\"; json.dump(data, open(\"../../package.json\", \"w\"), indent=2)'",
+      "git add ../../CHANGELOG.md ../../package.json"
+    ],
+    "after:release": [
+      "bash -c 'source ../../.env && curl -X POST -H \"Authorization: token $GITHUB_TOKEN\" -H \"Accept: application/vnd.github.v3+json\" https://api.github.com/repos/collective/volto-aemet/releases -d \"{\\\"tag_name\\\":\\\"${version}\\\",\\\"name\\\":\\\"${version}\\\",\\\"body\\\":\\\"$(cat ../../.changelog.draft | sed \\\"s/\\\"/\\\\\\\\\\\"/g\\\" | sed \\\":a;N;$!ba;s/\\n/\\\\\\\\n/g\\\")\\\",\\\"prerelease\\\":${isPreRelease}}\"'",
+      "rm .changelog.draft README.md"
+    ]
+  },
+  "npm": {
+    "publish": true
+  },
+  "git": {
+    "changelog": "pipx run towncrier build --draft --yes --version 0.0.0",
+    "requireUpstream": false,
+    "requireCleanWorkingDir": false,
+    "commitMessage": "Release ${version}",
+    "tagName": "${version}",
+    "tagAnnotation": "Release ${version}"
+  },
+  "github": {
+    "release": true,
+    "releaseName": "${version}",
+    "releaseNotes": "cat .changelog.draft"
+  }
+}

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+<!-- You should *NOT* be adding new change log entries to this file.
+     You should create a file in the news directory instead.
+     For helpful instructions, please see:
+     https://6.docs.plone.org/contributing/index.html?highlight=towncrier#change-log-entry
+-->
+
+<!-- towncrier release notes start -->
+
+## 1.0.0-alpha.0 (2026-07-20)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025, 2026 Leonardo J. Caballero G.
+
+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.

package/README.md

@@ -0,0 +1,323 @@
+# Volto AEMET Weather (volto-aemet)
+
+[![npm](https://img.shields.io/npm/v/volto-aemet)](https://www.npmjs.com/package/volto-aemet)
+[![](https://img.shields.io/badge/-Storybook-ff4785?logo=Storybook&logoColor=white&style=flat-square)](https://collective.github.io/volto-aemet/)
+[![Code analysis checks](https://github.com/collective/volto-aemet/actions/workflows/code.yml/badge.svg)](https://github.com/collective/volto-aemet/actions/workflows/code.yml)
+[![Unit tests](https://github.com/collective/volto-aemet/actions/workflows/unit.yml/badge.svg)](https://github.com/collective/volto-aemet/actions/workflows/unit.yml)
+
+<a href="https://www.aemet.es/" title="Agencia Estatal de Meteorología - AEMET. Gobierno de España" target="_blank">
+  <img width="400" alt="Agencia Estatal de Meteorología - AEMET. Gobierno de España" src="https://raw.githubusercontent.com/collective/volto-aemet/refs/heads/main/docs/source/_static/logo.svg">
+</a>
+
+A volto add-on that integrates AEMET service with Plone to report the weather forecast.
+
+## Features
+
+- Add a new `AEMET Weather Current` Volto content block.
+
+- Add a new `AEMET Weather Forecast` Volto content block.
+
+- Add a new `AEMET Settings` Volto control panel.
+
+- Add a new react component called `Weather`, that uses data from the AEMET service.
+
+## Screenshots
+
+**AEMET Weather Current Volto content block**
+
+<img width="720" alt="AEMET Settings" src="https://raw.githubusercontent.com/collective/volto-aemet/refs/heads/main/docs/source/images/volto-content-block-aemet-weather-current.png">
+
+---
+
+**AEMET Weather Forecast Volto content block**
+
+<img width="720" alt="AEMET Settings" src="https://raw.githubusercontent.com/collective/volto-aemet/refs/heads/main/docs/source/images/volto-content-block-aemet-weather-forecast.png">
+
+---
+
+## Backend integration
+
+To use this product in Plone CMS, you needs to include the following add-on in your project: https://github.com/collective/collective.volto.aemet
+
+## Translations
+
+This product has been translated into
+
+- English
+
+- Spanish
+
+## Installation
+
+To install your project, you must choose the method appropriate to your version of Volto.
+
+
+### Volto 18 and later
+
+Add `volto-aemet` to your `package.json`:
+
+```json
+"addons": [
+    "volto-aemet": "*"
+]
+```
+
+```json
+"dependencies": {
+    "volto-aemet": "*"
+}
+```
+
+#### Install from Github
+
+If you trying to install from Github you need edit the `mrs.developer.json` file:
+
+```json
+{
+  "volto-aemet": {
+    "develop": true,
+    "output": "./packages/",
+    "package": "volto-aemet",
+    "url": "git@github.com:collective/volto-aemet.git",
+    "https": "https://github.com/collective/volto-aemet.git",
+    "branch": "main"
+  }
+}
+```
+
+The `mrs.developer.json` is using by an NodeJS utility called `mrs.developer` that makes
+it easy to work with NPM projects containing lots of packages, of which you only want to
+develop some.
+
+Also add `volto-aemet` to your `package.json`:
+
+```json
+"addons": [
+    "volto-aemet": "*"
+]
+```
+
+```json
+"dependencies": {
+    "volto-aemet": "workspace:*",
+}
+```
+
+---
+### Volto 17 and earlier
+
+Create a new Volto project (you can skip this step if you already have one):
+
+```
+npm install -g yo @plone/generator-volto
+yo @plone/volto my-volto-project --addon volto-aemet
+cd my-volto-project
+```
+
+Add `volto-aemet` to your package.json:
+
+```JSON
+"addons": [
+    "volto-aemet"
+],
+
+"dependencies": {
+    "volto-aemet": "*"
+}
+```
+
+Download and install the new add-on by running:
+
+```
+yarn install
+```
+
+Start volto with:
+
+```
+yarn start
+```
+
+## Test installation
+
+Visit http://localhost:3000/ in a browser, login, and check the awesome new features.
+
+## Use it
+
+To use this add-on, go to the `Site setup`, next to the ``Add-on Configuration`` icon, as shown below:
+
+<img width="290" alt="Add-on Configuration" src="https://raw.githubusercontent.com/collective/volto-aemet/refs/heads/main/docs/source/images/addon-configuration-aemet-icon.png">
+
+---
+
+This `AEMET Settings`, you can access the control panel, as shown below:
+
+<img width="720" alt="AEMET Settings" src="https://raw.githubusercontent.com/collective/volto-aemet/refs/heads/main/docs/source/images/aemet-settings.png">
+
+In this control panel, you can configure the following fields:
+
+- ``Location ID``, The Location ID of the AEMET service, for example '41091' to Sevilla location ID.
+
+---
+
+
+## Development
+
+The development of this add-on is done in isolation using a new approach using pnpm workspaces and latest `mrs-developer` and other Volto core improvements.
+For this reason, it only works with pnpm and Volto 18 (currently in alpha).
+
+
+### Prerequisites ✅
+
+-   An [operating system](https://6.docs.plone.org/install/create-project-cookieplone.html#prerequisites-for-installation) that runs all the requirements mentioned.
+-   [nvm](https://6.docs.plone.org/install/create-project-cookieplone.html#nvm)
+-   [Node.js and pnpm](https://6.docs.plone.org/install/create-project.html#node-js) 22
+-   [Make](https://6.docs.plone.org/install/create-project-cookieplone.html#make)
+-   [Git](https://6.docs.plone.org/install/create-project-cookieplone.html#git)
+-   [Docker](https://docs.docker.com/get-started/get-docker/) (optional)
+
+### Installation 🔧
+
+1.  Clone this repository, then change your working directory.
+
+    ```shell
+    git clone git@github.com:collective/volto-aemet.git
+    cd volto-aemet
+    ```
+
+2.  Install this code base.
+
+    ```shell
+    make install
+    ```
+
+
+### Make convenience commands
+
+Run `make help` to list the available commands.
+
+```text
+help                             Show this help
+install                          Installs the add-on in a development environment
+start                            Starts Volto, allowing reloading of the add-on during development
+build                            Build a production bundle for distribution of the project with the add-on
+i18n                             Sync i18n
+ci-i18n                          Check if i18n is not synced
+format                           Format codebase
+lint                             Lint, or catch and remove problems, in code base
+release                          Release the add-on on npmjs.org
+release-dry-run                  Dry-run the release of the add-on on npmjs.org
+test                             Run unit tests
+ci-test                          Run unit tests in CI
+backend-docker-start             Starts a Docker-based backend for development
+storybook-start                  Start Storybook server on port 6006
+storybook-build                  Build Storybook
+acceptance-frontend-dev-start    Start acceptance frontend in development mode
+acceptance-frontend-prod-start   Start acceptance frontend in production mode
+acceptance-backend-start         Start backend acceptance server
+ci-acceptance-backend-start      Start backend acceptance server in headless mode for CI
+acceptance-test                  Start Cypress in interactive mode
+ci-acceptance-test               Run cypress tests in headless mode for CI
+```
+
+### Development environment set up
+
+Install package requirements.
+
+```shell
+make install
+```
+
+### Start developing
+
+Start the backend.
+
+```shell
+make backend-docker-start
+```
+
+In a separate terminal session, start the frontend.
+
+```shell
+make start
+```
+
+### Lint code
+
+Run ESlint, Prettier, and Stylelint in analyze mode.
+
+```shell
+make lint
+```
+
+### Format code
+
+Run ESlint, Prettier, and Stylelint in fix mode.
+
+```shell
+make format
+```
+
+### i18n
+
+Extract the i18n messages to locales.
+
+```shell
+make i18n
+```
+
+### Unit tests
+
+Run unit tests.
+
+```shell
+make test
+```
+
+### Run Cypress tests
+
+Run each of these steps in separate terminal sessions.
+
+In the first session, start the frontend in development mode.
+
+```shell
+make acceptance-frontend-dev-start
+```
+
+In the second session, start the backend acceptance server.
+
+```shell
+make acceptance-backend-start
+```
+
+In the third session, start the Cypress interactive test runner.
+
+```shell
+make acceptance-test
+```
+
+## Credits
+
+Developed with the support of:
+
+- [Agencia Estatal de Meteorología - AEMET. Gobierno de España](https://www.aemet.es/).
+
+  <img width="200" alt="IMD Logo" src="https://raw.githubusercontent.com/collective/volto-aemet/refs/heads/main/docs/source/images/aemet-logo-blue.svg">
+
+- [Instituto Municipal de Deportes - IMD, Seville City Council, Spain](https://imd.sevilla.org/).
+
+  <img width="200" alt="IMD Logo" src="https://raw.githubusercontent.com/collective/volto-aemet/refs/heads/main/docs/source/images/imd-ayto-logo.svg">
+
+### Acknowledgements 🙏
+
+Generated using [Cookieplone (0.9.10)](https://github.com/plone/cookieplone) and [cookieplone-templates (eb40854)](https://github.com/plone/cookieplone-templates/commit/eb4085428af6261227bcb086ece110bbe5475d89) on 2025-11-06 19:31:17.502224. A special thanks to all contributors and supporters!
+
+## Authors
+
+This product was developed by [Leonardo J. Caballero G.](https://github.com/macagua).
+
+<img width="100" alt="Leonardo J. Caballero G." src="https://avatars.githubusercontent.com/u/185395?v=4&size=100">
+
+## License
+
+The project is licensed under the MIT license.

package/babel.config.js

@@ -0,0 +1,17 @@
+module.exports = function (api) {
+  api.cache(true);
+  const presets = ['razzle'];
+  const plugins = [
+    [
+      'react-intl', // React Intl extractor, required for the whole i18n infrastructure to work
+      {
+        messagesDir: './build/messages/',
+      },
+    ],
+  ];
+
+  return {
+    plugins,
+    presets,
+  };
+};

package/locales/de/LC_MESSAGES/volto.po

@@ -0,0 +1,83 @@
+msgid ""
+msgstr ""
+"Project-Id-Version: \n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: \n"
+"PO-Revision-Date: \n"
+"Last-Translator: \n"
+"Language: de\n"
+"Language-Team: \n"
+"Content-Type: \n"
+"Content-Transfer-Encoding: \n"
+"Plural-Forms: \n"
+
+#. Default: "AEMET Weather Forecast"
+#: components/Blocks/AemetWeatherForecast/messages
+msgid "AEMET Weather Forecast"
+msgstr ""
+
+#. Default: "Default"
+#: components/Blocks/AemetWeatherForecast/messages
+msgid "Default"
+msgstr ""
+
+#. Default: "Location ID"
+#: components/Blocks/AemetWeatherForecast/messages
+msgid "Location ID"
+msgstr ""
+
+#. Default: "Province"
+#: components/Blocks/AemetWeatherForecast/messages
+msgid "Province"
+msgstr ""
+
+#. Default: "The Location ID of the AEMET service, for example '41091' to Sevilla location ID."
+#: components/Blocks/AemetWeatherForecast/messages
+msgid "The Location ID of the AEMET service, for example '41091' to Sevilla location ID."
+msgstr ""
+
+#. Default: "The name of the province of the location (in lowercase) of the AEMET service."
+#: components/Blocks/AemetWeatherForecast/messages
+msgid "The name of the province of the location (in lowercase) of the AEMET service."
+msgstr ""
+
+#. Default: "Current day"
+#: components/Aemet/Weather
+msgid "current_day"
+msgstr ""
+
+#. Default: "Current location"
+#: components/Aemet/Weather
+msgid "current_location"
+msgstr ""
+
+#. Default: "Current temperature"
+#: components/Aemet/Weather
+msgid "current_temperature"
+msgstr ""
+
+#. Default: "Current time"
+#: components/Aemet/Weather
+msgid "current_time"
+msgstr ""
+
+#. Default: "Loading weather forecast..."
+#: components/Aemet/Weather
+#: components/Aemet/WeatherCurrent
+msgid "loading_weather_forecast"
+msgstr ""
+
+#. Default: "Minimum-Maximum"
+#: components/Aemet/Weather
+msgid "minimum_maximum"
+msgstr ""
+
+#. Default: "Not available"
+#: components/Aemet/Weather
+msgid "not_available"
+msgstr ""
+
+#. Default: "Weather description"
+#: components/Aemet/Weather
+msgid "weather_description"
+msgstr ""

package/locales/en/LC_MESSAGES/volto.po

@@ -0,0 +1,83 @@
+msgid ""
+msgstr ""
+"Project-Id-Version: \n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: \n"
+"PO-Revision-Date: \n"
+"Last-Translator: \n"
+"Language: en\n"
+"Language-Team: \n"
+"Content-Type: \n"
+"Content-Transfer-Encoding: \n"
+"Plural-Forms: \n"
+
+#. Default: "AEMET Weather Forecast"
+#: components/Blocks/AemetWeatherForecast/messages
+msgid "AEMET Weather Forecast"
+msgstr ""
+
+#. Default: "Default"
+#: components/Blocks/AemetWeatherForecast/messages
+msgid "Default"
+msgstr ""
+
+#. Default: "Location ID"
+#: components/Blocks/AemetWeatherForecast/messages
+msgid "Location ID"
+msgstr ""
+
+#. Default: "Province"
+#: components/Blocks/AemetWeatherForecast/messages
+msgid "Province"
+msgstr ""
+
+#. Default: "The Location ID of the AEMET service, for example '41091' to Sevilla location ID."
+#: components/Blocks/AemetWeatherForecast/messages
+msgid "The Location ID of the AEMET service, for example '41091' to Sevilla location ID."
+msgstr ""
+
+#. Default: "The name of the province of the location (in lowercase) of the AEMET service."
+#: components/Blocks/AemetWeatherForecast/messages
+msgid "The name of the province of the location (in lowercase) of the AEMET service."
+msgstr ""
+
+#. Default: "Current day"
+#: components/Aemet/Weather
+msgid "current_day"
+msgstr ""
+
+#. Default: "Current location"
+#: components/Aemet/Weather
+msgid "current_location"
+msgstr ""
+
+#. Default: "Current temperature"
+#: components/Aemet/Weather
+msgid "current_temperature"
+msgstr ""
+
+#. Default: "Current time"
+#: components/Aemet/Weather
+msgid "current_time"
+msgstr ""
+
+#. Default: "Loading weather forecast..."
+#: components/Aemet/Weather
+#: components/Aemet/WeatherCurrent
+msgid "loading_weather_forecast"
+msgstr ""
+
+#. Default: "Minimum-Maximum"
+#: components/Aemet/Weather
+msgid "minimum_maximum"
+msgstr ""
+
+#. Default: "Not available"
+#: components/Aemet/Weather
+msgid "not_available"
+msgstr ""
+
+#. Default: "Weather description"
+#: components/Aemet/Weather
+msgid "weather_description"
+msgstr ""

package/locales/es/LC_MESSAGES/volto.po

@@ -0,0 +1,90 @@
+msgid ""
+msgstr ""
+"Project-Id-Version: Plone\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2026-07-16 1:40-0400\n"
+"PO-Revision-Date: 2026-07-19 14:29-0400\n"
+"Last-Translator: Leonardo J. Caballero G. <leonardocaballero@gmail.com>\n"
+"Language: es\n"
+"Language-Team: ES <LL@li.org>\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"Preferred-Encodings: utf-8\n"
+"MIME-Version: 1.0\n"
+"Language-Code: es\n"
+"Language-Name: Español\n"
+"Domain: volto\n"
+"X-Is-Fallback-For: es-ar es-bo es-cl es-co es-cr es-do es-ec es-es es-sv es-gt es-hn es-mx es-ni es-pa es-py es-pe es-pr es-us es-uy es-ve\n"
+"X-Generator: Poedit 2.2.1\n"
+
+#. Default: "AEMET Weather Forecast"
+#: components/Blocks/AemetWeatherForecast/messages
+msgid "AEMET Weather Forecast"
+msgstr "AEMET: Pronóstico del tiempo"
+
+#. Default: "Default"
+#: components/Blocks/AemetWeatherForecast/messages
+msgid "Default"
+msgstr "Predeterminado"
+
+#. Default: "Location ID"
+#: components/Blocks/AemetWeatherForecast/messages
+msgid "Location ID"
+msgstr "ID de ubicación"
+
+#. Default: "Province"
+#: components/Blocks/AemetWeatherForecast/messages
+msgid "Province"
+msgstr "Provincia"
+
+#. Default: "The Location ID of the AEMET service, for example '41091' to Sevilla location ID."
+#: components/Blocks/AemetWeatherForecast/messages
+msgid "The Location ID of the AEMET service, for example '41091' to Sevilla location ID."
+msgstr "El ID de ubicación del servicio AEMET, por ejemplo '41091' para la ubicación de Sevilla."
+
+#. Default: "The name of the province of the location (in lowercase) of the AEMET service."
+#: components/Blocks/AemetWeatherForecast/messages
+msgid "The name of the province of the location (in lowercase) of the AEMET service."
+msgstr "El nombre de la provincia en la que se encuentra (en minúsculas) el servicio de la AEMET."
+
+#. Default: "Current day"
+#: components/Aemet/Weather
+msgid "current_day"
+msgstr "Día actual"
+
+#. Default: "Current location"
+#: components/Aemet/Weather
+msgid "current_location"
+msgstr "Ubicación actual"
+
+#. Default: "Current temperature"
+#: components/Aemet/Weather
+msgid "current_temperature"
+msgstr "Temperatura actual"
+
+#. Default: "Current time"
+#: components/Aemet/Weather
+msgid "current_time"
+msgstr "Hora actual"
+
+#. Default: "Loading weather forecast..."
+#: components/Aemet/Weather
+#: components/Aemet/WeatherCurrent
+msgid "loading_weather_forecast"
+msgstr "Cargando la previsión meteorológica..."
+
+#. Default: "Minimum-Maximum"
+#: components/Aemet/Weather
+msgid "minimum_maximum"
+msgstr "Mínimo-Máximo"
+
+#. Default: "Not available"
+#: components/Aemet/Weather
+msgid "not_available"
+msgstr "No disponible"
+
+#. Default: "Weather description"
+#: components/Aemet/Weather
+msgid "weather_description"
+msgstr "Descripción del clima"