chore!: mark extension as obsolete

CHANGELOG.md

@@ -4,7 +4,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [3.1.0] - 2024-11-11
+
+This extension has been marked as obsolete. Please migrate to the
+Country Select form element provided by EXT:form available since
+TYPO3 v12.3:
+[Feature: #99735 - New Country Select form element](https://docs.typo3.org/c/typo3/cms-core/main/en-us/Changelog/12.3/Feature-99735-NewCountrySelectFormElement.html)
+
 
 ## [3.0.0] - 2023-04-09
 
@@ -98,7 +104,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Form element "Country select"
 - Signal/slot and PSR-14 event for modifying the country list
 
-[Unreleased]: https://github.com/brotkrueml/form-country-select/compare/v3.0.0...HEAD
+[3.1.0]: https://github.com/brotkrueml/form-country-select/compare/v3.0.0...v3.1.0
 [3.0.0]: https://github.com/brotkrueml/form-country-select/compare/v2.1.0...v3.0.0
 [2.1.0]: https://github.com/brotkrueml/form-country-select/compare/v2.0.1...v2.1.0
 [2.0.1]: https://github.com/brotkrueml/form-country-select/compare/v2.0.0...v2.0.1

Documentation/Changelog/Index.rst

@@ -8,8 +8,13 @@ All notable changes to this project will be documented in this file.
 The format is based on `Keep a Changelog <https://keepachangelog.com/en/1.0.0/>`_\ ,
 and this project adheres to `Semantic Versioning <https://semver.org/spec/v2.0.0.html>`_.
 
-`Unreleased <https://github.com/brotkrueml/form-country-select/compare/v3.0.0...HEAD>`_
--------------------------------------------------------------------------------------------
+`3.1.0 <https://github.com/brotkrueml/form-country-select/compare/v3.0.0...v3.1.0>`_ - 2024-11-11
+-----------------------------------------------------------------------------------------------------
+
+This extension has been marked as obsolete. Please migrate to the
+Country Select form element provided by EXT:form available since
+TYPO3 v12.3:
+`Feature: #99735 - New Country Select form element <https://docs.typo3.org/c/typo3/cms-core/main/en-us/Changelog/12.3/Feature-99735-NewCountrySelectFormElement.html>`_
 
 `3.0.0 <https://github.com/brotkrueml/form-country-select/compare/v2.1.0...v3.0.0>`_ - 2023-04-09
 -----------------------------------------------------------------------------------------------------

Documentation/Includes.rst.txt

@@ -1,34 +1,5 @@
-.. More information about this file:
-   https://docs.typo3.org/m/typo3/docs-how-to-document/main/en-us/GeneralConventions/FileStructure.html#includes-rst-txt
-
-.. ----------
-.. text roles
-.. ----------
-
-.. role:: aspect(emphasis)
-.. role:: bash(code)
-.. role:: html(code)
-.. role:: js(code)
-.. role:: php(code)
-.. role:: rst(code)
-.. role:: sep(strong)
-.. role:: sql(code)
-
-.. role:: tsconfig(code)
-   :class: typoscript
-
-.. role:: typoscript(code)
-.. role:: xml(code)
-   :class: html
-
-.. role:: yaml(code)
-
-.. default-role:: code
-
-.. ---------
-.. highlight
-.. ---------
-
-.. By default, code blocks use PHP syntax highlighting
-
-.. highlight:: php
+.. attention::
+   This extension has been marked as obsolete. Please migrate to the
+   Country Select form element provided by EXT:form available since
+   TYPO3 v12.3:
+   :ref:`changelog:feature-99735-1678701694`

Documentation/Installation/Index.rst

@@ -21,9 +21,8 @@ Composer-based TYPO3 project root, just type::
 
 and the recent stable version will be installed.
 
-You can also install the extension from the `TYPO3 Extension Repository (TER)`_.
-See :ref:`t3start:extensions_legacy_management` for a manual how to
-install an extension.
+In a legacy installation, you can also install the extension from the
+`TYPO3 Extension Repository (TER)`_.
 
 
 .. _include-static-typoscript:

Documentation/guides.xml

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<guides
+    xmlns="https://www.phpdoc.org/guides"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        xsi:schemaLocation="https://www.phpdoc.org/guides ../vendor/phpdocumentor/guides-cli/resources/schema/guides.xsd"
+        links-are-relative="true"
+>
+    <extension
+        class="\T3Docs\Typo3DocsTheme\DependencyInjection\Typo3DocsThemeExtension"
+               project-contact="typo3 (at) krue (dot) ml"
+               project-repository="https://github.com/brotkrueml/form-country-select"
+               project-issues="https://github.com/brotkrueml/form-country-select/issues" edit-on-github-branch="main"
+               edit-on-github="brotkrueml/form-country-select" typo3-core-preferred="11.5"
+    />
+    <project
+        title="Form Country Select"
+        release="3.1.0"
+        version="3.1"
+        copyright="since 2019 by Chris Müller"
+    />
+</guides>

Makefile

@@ -9,7 +9,9 @@ build-intl: vendor
 # See: https://github.com/crossnox/m2r2
 .PHONY: changelog
 changelog:
-	m2r2 CHANGELOG.md && \
+	python3 -m venv .Build/changelog
+	.Build/changelog/bin/pip install setuptools m2r2
+	.Build/changelog/bin/m2r2 CHANGELOG.md && \
 	echo ".. _changelog:" | cat - CHANGELOG.rst > /tmp/CHANGELOG.rst && \
 	mv /tmp/CHANGELOG.rst Documentation/Changelog/Index.rst && \
 	rm CHANGELOG.rst

README.md

@@ -1,9 +1,11 @@
 # TYPO3 extension: Form Country Select
 
-[![CI Status](https://github.com/brotkrueml/form-country-select/workflows/CI/badge.svg?branch=main)](https://github.com/brotkrueml/form-country-select/actions?query=workflow%3ACI)
-[![Crowdin](https://badges.crowdin.net/typo3-extension-formcountryselect/localized.svg)](https://crowdin.com/project/typo3-extension-formcountryselect)
-[![Latest Stable Version](https://img.shields.io/packagist/v/brotkrueml/form-country-select.svg?label=stable)](https://packagist.org/packages/brotkrueml/form-country-select)
-[![Total Downloads](https://img.shields.io/packagist/dt/brotkrueml/form-country-select.svg)](https://packagist.org/packages/brotkrueml/form-country-select)
+> With TYPO3 v12.3 a new form element "Country Select" was
+> [introduced](https://docs.typo3.org/c/typo3/cms-core/main/en-us/Changelog/12.3/Feature-99735-NewCountrySelectFormElement.html#feature-99735-1678701694)
+> which serves the same purpose as the form element provided by this extension.
+> This extension is now obsolete and receives no further updates, please migrate
+> to TYPO3 Core's form element instead.
+> There will be no compatible version for TYPO3 v13+.
 
 The extension provides an additional form element for the TYPO3 Form
 Framework which displays a select box with all countries from the ISO
@@ -12,18 +14,11 @@ of the website page.
 
 ## Versions and support
 
-> With TYPO3 v12.3 a new form element "Country Select" was
-> [introduced](https://docs.typo3.org/c/typo3/cms-core/main/en-us/Changelog/12.3/Feature-99735-NewCountrySelectFormElement.html#feature-99735-1678701694)
-> which serves the same purpose as the form element provided by this extension.
-> This extension is now considered legacy, you should use TYPO3 Core's form element instead.
-> There will be no compatible version for TYPO3 v13+. However, the current version will
-> receive bug fixes as long as the LTS version is supported by the community.
-
-| Latest release | TYPO3      | PHP   | Updates will contain                                   |
-|----------------|------------|-------|--------------------------------------------------------|
-| 3.x            | 12.4       | ≥ 8.1 | Security and bug fixes                                 |
-| 2.x            | 11.5       | ≥ 7.4 | Security and bug fixes, End of life expected: Oct 2024 |
-| 1.x            | 9.5 - 11.5 | ≥ 7.2 | End of life                                            |
+| Latest release | TYPO3      | PHP   |             |
+|----------------|------------|-------|-------------|
+| 3.x            | 12.4       | ≥ 8.1 | End of life |
+| 2.x            | 11.5       | ≥ 7.4 | End of life |
+| 1.x            | 9.5 - 11.5 | ≥ 7.2 | End of life |
 
 
 [Documentation](https://docs.typo3.org/p/brotkrueml/form-country-select/main/en-us/) |

composer.json

@@ -23,7 +23,7 @@
     },
     "require-dev": {
         "brotkrueml/coding-standards": "~4.0.0",
-        "ergebnis/composer-normalize": "~2.30.2",
+        "ergebnis/composer-normalize": "~2.44.0",
         "phpstan/extension-installer": "^1.2",
         "phpstan/phpstan": "1.10.11",
         "phpunit/phpunit": "^10.0",
@@ -56,7 +56,7 @@
     },
     "extra": {
         "branch-alias": {
-            "dev-main": "3.0.x-dev"
+            "dev-main": "3.1.x-dev"
         },
         "typo3/cms": {
             "extension-key": "form_country_select",

ext_emconf.php

@@ -4,9 +4,9 @@
     'description' => 'Form element for selecting a country from a localised list',
     'category' => 'fe',
     'author' => 'Chris Müller',
-    'author_email' => 'typo3@krue.ml',
-    'state' => 'stable',
-    'version' => '3.0.0',
+    'author_email' => 'typo3@brotkrueml.dev',
+    'state' => 'obsolete',
+    'version' => '3.1.0',
     'constraints' => [
         'depends' => [
             'typo3' => '12.4.0-12.4.99',