fix(build): migrate to stable dynamic metadata API (deepmodeling#5769)

Summary:
- migrate project metadata configuration to the standard
`[[tool.dynamic-metadata]]` interface introduced in scikit-build-core
1.0
- update the in-tree metadata provider to return project fragments using
the v1 protocol
- require `scikit-build-core>=1`, opt into `minimum-version = "1.0"`,
and remove the obsolete experimental flag
- migrate the renamed CMake version environment setting to a valid
version specifier

Supersedes deepmodeling#5759, which only widens the upper bound while retaining the
deprecated metadata interface.

Fixes deepmodeling#3558

Validation:
- `ruff check .`
- `ruff format .`
- resolved the complete project metadata table with scikit-build-core
1.0.0, including version, optional dependencies, scripts, and readme
- built the source distribution successfully in an isolated environment
with scikit-build-core 1.0.2

Coding agent: Codex
Codex version: codex-cli 0.144.1
Model: gpt-5.6-sol
Reasoning effort: xhigh


<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

* **Build & Packaging**
* Updated package metadata handling to support the standard provider
configuration.
  * Improved compatibility with newer scikit-build-core releases.
  * Updated CMake version requirements used during builds.
* Refined generation of optional dependencies and executable scripts
from project configuration.
  * Removed support for the legacy entry-points metadata option.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Co-authored-by: njzjz-bot <njzjz.bot@gmail.com>

Author: njzjz-bot

backend/dynamic_metadata.py

@@ -1,8 +1,16 @@
 # SPDX-License-Identifier: LGPL-3.0-or-later
+"""Provide project metadata that depends on the selected build configuration."""
+
 import sys
+from collections.abc import (
+    Mapping,
+)
 from pathlib import (
     Path,
 )
+from typing import (
+    Any,
+)
 
 from .find_pytorch import (
     get_pt_requirement,
@@ -27,29 +35,44 @@ def __dir__() -> list[str]:
 
 
 def dynamic_metadata(
-    field: str,
-    settings: dict[str, object] | None = None,
-):
-    assert field in ["optional-dependencies", "entry-points", "scripts"]
+    settings: Mapping[str, object],
+    _project: Mapping[str, Any],
+) -> dict[str, Any]:
+    """Return one metadata fragment using the standard v1 provider protocol.
+
+    Each ``[[tool.dynamic-metadata]]`` entry selects a field explicitly. The
+    returned mapping is merged into the resolved ``[project]`` table by
+    scikit-build-core.
+    """
+    field = settings.get("field")
+    if not isinstance(field, str) or field not in {
+        "optional-dependencies",
+        "scripts",
+    }:
+        msg = f"Unsupported dynamic metadata field: {field!r}"
+        raise ValueError(msg)
+
     _, _, find_libpython_requires, extra_scripts, tf_version, pt_version = (
         get_argument_from_env()
     )
     with Path("pyproject.toml").open("rb") as f:
         pyproject = tomllib.load(f)
 
     if field == "scripts":
-        return {
+        result = {
             **pyproject["tool"]["deepmd_build_backend"]["scripts"],
             **extra_scripts,
         }
-    elif field == "optional-dependencies":
+    else:
         optional_dependencies = pyproject["tool"]["deepmd_build_backend"][
             "optional-dependencies"
         ]
         optional_dependencies["lmp"].extend(find_libpython_requires)
         optional_dependencies["ipi"].extend(find_libpython_requires)
-        return {
+        result = {
             **optional_dependencies,
             **get_tf_requirement(tf_version),
             **get_pt_requirement(pt_version),
         }
+
+    return {field: result}

backend/read_env.py

@@ -135,5 +135,6 @@ def get_argument_from_env() -> tuple[str, list, list, dict, str, str]:
 def set_scikit_build_env() -> None:
     """Set scikit-build environment variables before executing scikit-build."""
     cmake_minimum_required_version, cmake_args, _, _, _, _ = get_argument_from_env()
-    os.environ["SKBUILD_CMAKE_MINIMUM_VERSION"] = cmake_minimum_required_version
+    # scikit-build-core v1 expects cmake.version to be a version specifier.
+    os.environ["SKBUILD_CMAKE_VERSION"] = f">={cmake_minimum_required_version}"
     os.environ["SKBUILD_CMAKE_ARGS"] = ";".join(cmake_args)

pyproject.toml

@@ -1,8 +1,6 @@
 [build-system]
 requires = [
-    # TODO: unpin the upper bound when scikit-build dynamic metadata API is stable
-    # dynamic metadata API is still unstable
-    "scikit-build-core>=0.11,!=0.6.0,<0.13",
+    "scikit-build-core>=1",
     "packaging",
     'tomli >= 1.1.0 ; python_version < "3.11"',
     "dependency_groups",
@@ -200,8 +198,7 @@ pin_jax_gpu = [
 [tool.setuptools_scm]
 
 [tool.scikit-build]
-experimental = true
-minimum-version = "0.5"
+minimum-version = "1.0"
 cmake.source-dir = "source"
 sdist.include = [
     "/deepmd/_version.py",
@@ -224,18 +221,18 @@ wheel.packages = [
 wheel.py-api = "py37"
 build-dir = "build/{wheel_tag}"
 
-[tool.scikit-build.metadata.version]
+[[tool.dynamic-metadata]]
 provider = "scikit_build_core.metadata.setuptools_scm"
 
-[tool.scikit-build.metadata.optional-dependencies]
-provider = "backend.dynamic_metadata"
-provider-path = "backend"
+[[tool.dynamic-metadata]]
+provider = {path = ".", module = "backend.dynamic_metadata"}
+field = "optional-dependencies"
 
-[tool.scikit-build.metadata.scripts]
-provider = "backend.dynamic_metadata"
-provider-path = "backend"
+[[tool.dynamic-metadata]]
+provider = {path = ".", module = "backend.dynamic_metadata"}
+field = "scripts"
 
-[tool.scikit-build.metadata.readme]
+[[tool.dynamic-metadata]]
 provider = "scikit_build_core.metadata.fancy_pypi_readme"
 
 [[tool.scikit-build.generate]]