chore(release): v0.1.0 (#16)

First public release. Stamps src/yarlpattern/_version.py to 0.1.0
and adds a corresponding entry to CHANGELOG.md.

Release notes summarize the public surface (100% conformance,
component-wise matching, path-to-regexp-derived syntax, pluggable
regex engine, yarl-shaped ergonomics), the implementation posture
(pure Python, Sigstore-signed PEP 740 attestations with SLSA
predicates), and the docs site at chad-loder.github.io/yarlpattern.

PSR was used to compute the next version (0.1.0, from the 'feat:
Initial commit' on a 0.x base with major_on_zero=false) and stamp
_version.py. The CHANGELOG.md entry was written by hand because
our PSR config doesn't carry the mode='update' setting pyhaul uses
to drive automatic changelog updates — added by hand here, can be
hooked up to PSR in a follow-up.

Co-authored-by: chad-loder <26261238+chad-loder@users.noreply.github.com>

Author: chad-loder

CHANGELOG.md

@@ -5,4 +5,50 @@ 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.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.0](https://github.com/chad-loder/yarlpattern/releases/tag/v0.1.0) — 2026-05-12
+
+First public release. WHATWG URLPattern for Python, with **100% conformance**
+to the upstream [WPT urlpattern corpus](https://github.com/web-platform-tests/wpt/tree/master/urlpattern)
+— 469 / 469 cases passing across all five test suites (the same files
+Chromium, Safari, and Firefox validate against).
+
+### Highlights
+
+- **Component-wise matching across all eight URL components** — protocol,
+  username, password, hostname, port, pathname, search, hash. Patterns can
+  constrain any combination.
+- **Path-to-regexp-derived syntax** (`:name`, `:name(regex)`, `*`,
+  `{group}?`) — the same grammar Express.js, koa.js, and React Router users
+  already know.
+- **Pluggable regex engine** — stdlib `re` is the default (99.5%
+  conformance). `pip install 'yarlpattern[regex]'` activates Matthew
+  Barnett's [`regex`](https://pypi.org/project/regex/) package and closes
+  the last 2 of 366 data-corpus cases (the JS `v`-flag character-class
+  set-operation patterns).
+- **yarl-shaped ergonomics** — `URLPattern.test()` / `URLPattern.exec()`
+  accept a `yarl.URL` directly (no `str()` round-trip), per-component
+  `with_*` derivers, component names matching the WHATWG spec /
+  browser-side JS `URL` interface.
+
+### Implementation
+
+- Pure Python, no compiled wheels. One required runtime dep: `yarl>=1.20`.
+- Sigstore-signed [PEP 740 attestations](https://peps.python.org/pep-0740/)
+  with SLSA build-provenance predicates, generated and verified by
+  [`hynek/build-and-inspect-python-package`](https://github.com/hynek/build-and-inspect-python-package)
+  in CI.
+- Tested against Python 3.12, 3.13, 3.14 on Linux / macOS / Windows.
+
+### Documentation
+
+- Full docs site at <https://chad-loder.github.io/yarlpattern> covering
+  the spec lineage, 11 worked examples ("route a multi-tenant API by
+  subdomain", "match the KServe `/v2/models` inference path", "replace
+  MCP resource URI templates", …), the API reference, comparisons with
+  `aiohttp.web.UrlDispatcher` and `yarl`, and the architecture
+  explanation.
+- Auto-regenerated [WPT Conformance report](https://chad-loder.github.io/yarlpattern/wpt-compliance/)
+  pins the corpus SHA so the 469 / 469 number is reproducible at any
+  future date.
+
 <!-- python-semantic-release stamps releases above this line -->

src/yarlpattern/_version.py

@@ -4,4 +4,4 @@
 ``[tool.semantic_release.version_variables]`` in ``pyproject.toml``.
 """
 
-__version__ = "0.0.1"
+__version__ = "0.1.0"