Consolidate configuration checks

Author: kdeldycke

changelog.md

@@ -12,6 +12,9 @@
 - Consolidate the `--time`, `--jobs` and `-0`/`--zero-exit` options into a single `click_extra.execution` module. The `click_extra.jobs` and `click_extra.timer` submodules are removed: their decorators and classes (`timer_option`, `jobs_option`, `TimerOption`, `JobsOption`, `CPU_COUNT`, `DEFAULT_JOBS`) remain importable from the `click_extra` root. The `--show-params` table now reports these options under `click_extra.execution`.
 - Honor the standard `POSIXLY_CORRECT` environment variable. When it is present in the environment (regardless of value), `ExtraContext` forces `allow_interspersed_args` to `False`, so every Click Extra command and group stops parsing options at the first positional argument, matching GNU getopt-based tools.
 - Add an `--accessible` option to the default set of `@extra_command` and `@extra_group` (via `default_extra_params()`). Enabling it, or setting the `ACCESSIBLE` environment variable, is equivalent to `--no-color --table-format plain`: it strips ANSI codes and renders tables without Unicode box-drawing characters, for screen readers. An explicit `--color` or `--table-format` (on the command line or in a configuration file) keeps precedence. Also available as the `@accessible_option` decorator and the `AccessibleOption` class.
+- Add the `run_config_validation()` function and the `ValidationReport` dataclass to `click_extra.config` (both re-exported from the package root). They run the CLI-parameter strict check, the typed schema build, and every registered `ConfigValidator` in a single pass, returning the typed schema instance, the extracted extension sub-trees, and the list of `ValidationError`s. `collect_all=True` gathers every error; `collect_all=False` stops at the first. Both `--validate-config` and normal `--config` loading now delegate to this primitive.
+- Unify configuration-loading errors under the single `ValidationError` type. Unknown CLI-parameter keys (`strict=True`) and unknown schema fields (`schema_strict=True`) previously surfaced as an uncaught `ValueError` traceback during `--config` loading; they now stop the run with a critical-level log and exit code 1, the same failure mode as extension-validator errors. Code that caught `ValueError` from config loading should catch the `SystemExit` from the exit (or use `--validate-config` / `run_config_validation()` to inspect errors without exiting).
+- Fix `schema_strict=True` wrongly rejecting the contents of a configuration field marked as an extension point with `EXTENSION_METADATA_KEY` when the field's Python type is not a mapping. The dataclass adapter now honors the marker the same way the outer strict check does, so the marked sub-tree is kept intact instead of being flattened and reported as unknown keys.
 
 ## [`7.17.2` (2026-05-26)](https://github.com/kdeldycke/click-extra/compare/v7.17.1...v7.17.2)
 

click_extra/__init__.py

@@ -76,9 +76,11 @@
     NoConfigOption,
     ValidateConfigOption,
     ValidationError,
+    ValidationReport,
     flatten_config_keys,
     get_tool_config,
     normalize_config_keys,
+    run_config_validation,
 )
 from .context import ExtraContext
 from .decorators import (  # type: ignore[no-redef]
@@ -249,6 +251,7 @@
     "UsageError",
     "ValidateConfigOption",
     "ValidationError",
+    "ValidationReport",
     "VerboseOption",
     "VerbosityOption",
     "VersionOption",
@@ -311,6 +314,7 @@
     "render_manpage",
     "render_manpages",
     "render_table",
+    "run_config_validation",
     "search_params",
     "secho",
     "serialize_data",