Merge branch 'main' into pep-829

Author: warsaw

.github/CODEOWNERS

@@ -663,7 +663,7 @@ peps/pep-0782.rst  @vstinner
 peps/pep-0783.rst  @hoodmane @ambv
 peps/pep-0784.rst  @gpshead @emmatyping
 peps/pep-0785.rst  @gpshead
-# ...
+peps/pep-0786.rst  @ncoghlan
 peps/pep-0787.rst  @ncoghlan
 peps/pep-0788.rst  @ZeroIntensity @vstinner
 peps/pep-0789.rst  @njsmith

pep_sphinx_extensions/pep_theme/static/colour_scheme.js

@@ -9,6 +9,7 @@ const setColourScheme = (colourScheme = getColourScheme()) => {
     document.documentElement.dataset.colour_scheme = colourScheme
     localStorage.setItem("colour_scheme", colourScheme)
     setPygments(colourScheme)
+    setPfTheme(colourScheme)
 }
 
 // Map system theme to a cycle of steps
@@ -31,5 +32,10 @@ const setPygments = (colourScheme = getColourScheme()) => {
     pygmentsLight.media = colourScheme === "auto" ? "(prefers-color-scheme: light)" : ""
 }
 
+const setPfTheme = (colourScheme = getColourScheme()) => {
+    const isDark = colourScheme === "dark" || (colourScheme === "auto" && prefersDark.matches)
+    document.documentElement.dataset.pfTheme = isDark ? "dark" : ""
+}
+
 // Update Pygments state (the page theme is initialised inline, see page.html)
 document.addEventListener("DOMContentLoaded", () => setColourScheme())

pep_sphinx_extensions/pep_theme/static/style.css

@@ -50,6 +50,19 @@
     --colour-caution: var(--light, #ffa) var(--dark, #550);
     --colour-attention: var(--light, #bdf) var(--dark, #045);
     --colour-tip: var(--light, #bfc) var(--dark, #041);
+
+    /* Pagefind component UI — theme variable overrides */
+    --pf-text: var(--colour-text);
+    --pf-text-muted: var(--colour-rule-strong);
+    --pf-background: var(--colour-background);
+    --pf-border: var(--colour-background-accent-strong);
+    --pf-border-focus: var(--colour-links);
+    --pf-hover: var(--colour-background-accent-light);
+    --pf-mark: var(--colour-text-strong);
+    --pf-outline-width: 0px;
+    --pf-input-height: 30px;
+    --pf-border-radius: 3px;
+    --pf-searchbox-max-width: 100%;
 }
 
 img.invert-in-dark-mode {
@@ -420,182 +433,6 @@ dl.footnote > dd {
     padding-bottom: 2rem;
     font-weight: bold;
 }
-/* Pagefind search styling (custom, no default CSS) */
-.pagefind-ui {
-    --pagefind-ui-primary: var(--colour-links);
-    --pagefind-ui-text: var(--colour-text);
-    --pagefind-ui-background: var(--colour-background);
-    --pagefind-ui-border: var(--colour-background-accent-strong);
-    font-family: inherit;
-    width: 100%;
-}
-
-/* Search form */
-.pagefind-ui__form {
-    position: relative;
-}
-
-/* Search icon */
-.pagefind-ui__form::before {
-    background-color: var(--pagefind-ui-text);
-    width: 14px;
-    height: 14px;
-    top: 8px;
-    left: 8px;
-    content: "";
-    position: absolute;
-    display: block;
-    opacity: 0.5;
-    -webkit-mask-image: url("data:image/svg+xml,%3Csvg width='18' height='18' viewBox='0 0 18 18' fill='none' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M12.7549 11.255H11.9649L11.6849 10.985C12.6649 9.845 13.2549 8.365 13.2549 6.755C13.2549 3.165 10.3449 0.255005 6.75488 0.255005C3.16488 0.255005 0.254883 3.165 0.254883 6.755C0.254883 10.345 3.16488 13.255 6.75488 13.255C8.36488 13.255 9.84488 12.665 10.9849 11.685L11.2549 11.965V12.755L16.2549 17.745L17.7449 16.255L12.7549 11.255ZM6.75488 11.255C4.26488 11.255 2.25488 9.245 2.25488 6.755C2.25488 4.26501 4.26488 2.255 6.75488 2.255C9.24488 2.255 11.2549 4.26501 11.2549 6.755C11.2549 9.245 9.24488 11.255 6.75488 11.255Z' fill='%23000000'/%3E%3C/svg%3E%0A");
-    mask-image: url("data:image/svg+xml,%3Csvg width='18' height='18' viewBox='0 0 18 18' fill='none' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M12.7549 11.255H11.9649L11.6849 10.985C12.6649 9.845 13.2549 8.365 13.2549 6.755C13.2549 3.165 10.3449 0.255005 6.75488 0.255005C3.16488 0.255005 0.254883 3.165 0.254883 6.755C0.254883 10.345 3.16488 13.255 6.75488 13.255C8.36488 13.255 9.84488 12.665 10.9849 11.685L11.2549 11.965V12.755L16.2549 17.745L17.7449 16.255L12.7549 11.255ZM6.75488 11.255C4.26488 11.255 2.25488 9.245 2.25488 6.755C2.25488 4.26501 4.26488 2.255 6.75488 2.255C9.24488 2.255 11.2549 4.26501 11.2549 6.755C11.2549 9.245 9.24488 11.255 6.75488 11.255Z' fill='%23000000'/%3E%3C/svg%3E%0A");
-    -webkit-mask-size: 100%;
-    mask-size: 100%;
-    z-index: 9;
-    pointer-events: none;
-}
-
-/* Search input */
-.pagefind-ui__search-input {
-    height: 30px;
-    padding: 4px 28px 4px 28px;
-    background-color: var(--pagefind-ui-background);
-    border: 1px solid var(--pagefind-ui-border);
-    border-radius: 3px;
-    font-size: 0.875rem;
-    font-family: inherit;
-    appearance: none;
-    -webkit-appearance: none;
-    width: 100%;
-    box-sizing: border-box;
-    color: var(--pagefind-ui-text);
-}
-.pagefind-ui__search-input:focus {
-    outline: none;
-    border-color: var(--pagefind-ui-primary);
-}
-.pagefind-ui__search-input::placeholder {
-    color: var(--pagefind-ui-text);
-    opacity: 0.5;
-}
-
-/* Clear button - fixed position relative to input (30px height, center button) */
-.pagefind-ui__search-clear {
-    position: absolute;
-    top: 5px;
-    right: 4px;
-    padding: 2px 6px;
-    color: var(--pagefind-ui-text);
-    font-size: 0.75rem;
-    cursor: pointer;
-    background-color: var(--pagefind-ui-background);
-    border: none;
-    opacity: 0.6;
-}
-.pagefind-ui__search-clear:hover {
-    opacity: 1;
-}
-
-/* Results container */
-.pagefind-ui__results-area {
-    margin-top: 0.5rem;
-}
-
-/* Results list */
-#pep-sidebar .pagefind-ui__results {
-    list-style: none;
-    padding: 0;
-    margin: 0;
-}
-
-/* Individual result */
-.pagefind-ui__result {
-    padding: 0.5rem 0 0.5rem 0.5rem;
-    border-bottom: 1px solid var(--colour-rule-light);
-}
-.pagefind-ui__result:last-child {
-    border-bottom: none;
-}
-
-/* Result link */
-.pagefind-ui__result-link {
-    font-weight: bold;
-    font-size: 0.9rem;
-    text-decoration: none;
-    color: var(--colour-links);
-}
-.pagefind-ui__result-link:hover {
-    text-decoration: underline;
-}
-
-/* Result title */
-.pagefind-ui__result-title {
-    margin: 0;
-}
-
-/* Result excerpt/snippet */
-.pagefind-ui__result-excerpt {
-    font-size: 0.8rem;
-    color: var(--colour-text);
-    margin: 0.25rem 0 0;
-    line-height: 1.4;
-}
-
-/* Highlight matches in results */
-.pagefind-ui__result-excerpt mark,
-mark.pagefind-ui__highlight {
-    background-color: var(--colour-caution);
-    color: inherit;
-    padding: 0 2px;
-}
-
-/* Message when no results */
-.pagefind-ui__message {
-    font-size: 0.85rem;
-    color: var(--colour-text);
-    padding: 0.5rem 0;
-}
-
-/* Loading state */
-.pagefind-ui__loading {
-    font-size: 0.85rem;
-    color: var(--colour-text);
-    opacity: 0.7;
-}
-
-/* Sub-results (nested) */
-.pagefind-ui__result-nested {
-    margin-left: 1rem;
-    padding: 0.25rem 0;
-}
-.pagefind-ui__result-nested .pagefind-ui__result-link {
-    font-weight: normal;
-    font-size: 0.85rem;
-}
-
-/* Button styling */
-.pagefind-ui__button {
-    background: var(--colour-background-accent-light);
-    border: 1px solid var(--colour-background-accent-strong);
-    padding: 0.4rem 0.8rem;
-    border-radius: 4px;
-    cursor: pointer;
-    font-size: 0.85rem;
-    color: var(--colour-text);
-    margin-top: 0.5rem;
-}
-.pagefind-ui__button:hover {
-    background: var(--colour-background-accent-medium);
-}
-
-/* Drawer (expandable results container) */
-.pagefind-ui__drawer {
-    overflow: hidden;
-}
-
-/* Suppress unused pagefind elements */
-.pagefind-ui__suppressed {
-    display: none;
-}
 
 .reference.external > strong {
     font-weight: normal;  /* Fix strong links for :pep: and :rfc: roles */

pep_sphinx_extensions/pep_theme/templates/page.html

@@ -8,6 +8,7 @@
     <title>{{ title + " | peps.python.org"|safe }}</title>
     <link rel="shortcut icon" href="{{ pathto('_static/py.png', resource=True) }}">
     <link rel="canonical" href="https://peps.python.org/{{ pagename }}/">
+    <link rel="stylesheet" href="/pagefind/pagefind-component-ui.css" type="text/css">
     <link rel="stylesheet" href="{{ pathto('_static/style.css', resource=True) }}" type="text/css">
     <link rel="stylesheet" href="{{ pathto('_static/mq.css', resource=True) }}" type="text/css">
     <link rel="stylesheet" href="{{ pathto('_static/pygments.css', resource=True) }}" type="text/css" media="(prefers-color-scheme: light)" id="pyg-light">
@@ -47,7 +48,9 @@ <h1 data-pagefind-ignore>Python Enhancement Proposals</h1>
             </button>
         </header>
         {# Mobile search box - visible only on small screens #}
-        <div id="mobile-search" class="mobile-search-container"></div>
+        <div id="mobile-search" class="mobile-search-container">
+            <pagefind-searchbox hide-shortcut style="font-family: inherit"></pagefind-searchbox>
+        </div>
         {# Exclude noisy non-PEP pages from Pagefind indexing #}
         {%- if pagename.startswith(("404", "numerical", "pep-0000", "topic")) %}
         <article>
@@ -60,7 +63,7 @@ <h1 data-pagefind-ignore>Python Enhancement Proposals</h1>
         </article>
         {%- if not pagename.startswith(("404", "numerical")) %}
         <nav id="pep-sidebar">
-            <div id="search"></div>
+            <pagefind-searchbox shortcut="/" style="font-family: inherit"></pagefind-searchbox>
             <h2>Contents</h2>
             {{ toc }}
             <br>
@@ -79,25 +82,6 @@ <h2>Contents</h2>
     {%- endif %}
     <script src="https://analytics.python.org/js/script.outbound-links.js"
             data-domain="peps.python.org" defer></script>
-    <script src="/pagefind/pagefind-ui.js"></script>
-    <script>
-        window.addEventListener('DOMContentLoaded', (event) => {
-            // Ranking configuration to boost exact title matches
-            const searchOptions = {
-                ranking: {
-                    termSimilarity: 9.0, // Higher values favor exact matches
-                    termFrequency: 0.5, // Lower values reduce penalty for low term frequency
-                    pageLength: 0.2, // Lower values reduce the impact of page length
-                }
-            };
-
-            // Initialize pagefind for either mobile or desktop, not both
-            if (window.innerWidth <= 640) {
-                new PagefindUI({ element: "#mobile-search", ...searchOptions, showSubResults: false });
-            } else {
-                new PagefindUI({ element: "#search", ...searchOptions, showSubResults: true });
-            }
-        });
-    </script>
+    <script src="/pagefind/pagefind-component-ui.js" type="module"></script>
 </body>
 </html>

peps/conf.py

@@ -69,17 +69,17 @@
 
 # Intersphinx configuration (keep this in alphabetical order)
 intersphinx_mapping = {
-    "devguide": ("https://devguide.python.org/", None),
-    "mypy": ("https://mypy.readthedocs.io/en/latest/", None),
-    "packaging": ("https://packaging.python.org/en/latest/", None),
-    "py3.11": ("https://docs.python.org/3.11/", None),
-    "py3.12": ("https://docs.python.org/3.12/", None),
-    "py3.13": ("https://docs.python.org/3.13/", None),
-    "py3.14": ("https://docs.python.org/3.14/", None),
-    "py3.15": ("https://docs.python.org/3.15/", None),
-    "python": ("https://docs.python.org/3/", None),
-    "trio": ("https://trio.readthedocs.io/en/latest/", None),
-    "typing": ("https://typing.python.org/en/latest/", None),
+    "devguide": ("https://devguide.python.org", None),
+    "mypy": ("https://mypy.readthedocs.io/en/latest", None),
+    "packaging": ("https://packaging.python.org/en/latest", None),
+    "py3.11": ("https://docs.python.org/3.11", None),
+    "py3.12": ("https://docs.python.org/3.12", None),
+    "py3.13": ("https://docs.python.org/3.13", None),
+    "py3.14": ("https://docs.python.org/3.14", None),
+    "py3.15": ("https://docs.python.org/3.15", None),
+    "python": ("https://docs.python.org/3", None),
+    "trio": ("https://trio.readthedocs.io/en/latest", None),
+    "typing": ("https://typing.python.org/en/latest", None),
 }
 intersphinx_disabled_reftypes = []
 

peps/pep-0011.rst

@@ -130,7 +130,7 @@ aarch64-pc-windows-msvc                                      Steve Dower
 arm64-apple-ios                  iOS on device               Russell Keith-Magee, Ned Deily
 arm64-apple-ios-simulator        iOS on M1 macOS simulator   Russell Keith-Magee, Ned Deily
 armv7l-unknown-linux-gnueabihf   32-bit Raspberry Pi OS, gcc Gregory P. Smith
-aarch64-unknown-linux-gnu        64-bit Raspberry Pi OS, gcc Savannah Ostrowski
+aarch64-unknown-linux-gnu        64-bit Raspberry Pi OS, gcc Savannah Ostrowski, Stan Ulbrych
 powerpc64le-unknown-linux-gnu    glibc, clang                Victor Stinner
 
                                  glibc, gcc                  Victor Stinner

peps/pep-0593.rst

@@ -1,6 +1,6 @@
 PEP: 593
 Title: Flexible function and variable annotations
-Author: Till Varoquaux <till@fb.com>, Konstantin Kashin <kkashin@fb.com>
+Author: Till Varoquaux <till.varoquaux@gmail.com>, Konstantin Kashin <kkashin@fb.com>
 Sponsor: Ivan Levkivskyi <levkivskyi@gmail.com>
 Discussions-To: typing-sig@python.org
 Status: Final

peps/pep-0719.rst

@@ -76,10 +76,10 @@ Actual:
 - 3.13.10: Tuesday, 2025-12-02
 - 3.13.11: Friday, 2025-12-05
 - 3.13.12: Tuesday, 2026-02-03
+- 3.13.13: Tuesday, 2026-04-07
 
 Expected:
 
-- 3.13.13: Tuesday, 2026-04-07
 - 3.13.14: Tuesday, 2026-06-09
 - 3.13.15: Tuesday, 2026-08-04
 - 3.13.16: Tuesday, 2026-10-06

peps/pep-0745.rst

@@ -67,10 +67,10 @@ Actual:
 - 3.14.1: Tuesday, 2025-12-02
 - 3.14.2: Friday, 2025-12-05
 - 3.14.3: Tuesday, 2026-02-03
+- 3.14.4: Tuesday, 2026-04-07
 
 Expected:
 
-- 3.14.4: Tuesday, 2026-04-07
 - 3.14.5: Tuesday, 2026-06-09
 - 3.14.6: Tuesday, 2026-08-04
 - 3.14.7: Tuesday, 2026-10-06

peps/pep-0747.rst

@@ -289,10 +289,10 @@ Explicit ``TypeForm`` Evaluation
 Type checkers should validate that this argument is a valid type expression::
 
    x1 = TypeForm(str | None)
-   reveal_type(v1)  # Revealed type is "TypeForm[str | None]"
+   reveal_type(x1)  # Revealed type is "TypeForm[str | None]"
 
    x2 = TypeForm('list[int]')
-   revealed_type(v2)  # Revealed type is "TypeForm[list[int]]"
+   reveal_type(x2)  # Revealed type is "TypeForm[list[int]]"
 
    x3 = TypeForm('type(1)')  # Error: invalid type expression