Introduce the alias container

Author: ale-rt

src/plone/api/_types.py

@@ -1,15 +1,13 @@
 """Shared internal typing aliases used across plone.api modules."""
 
-from Acquisition import ImplicitAcquisitionWrapper
 from plone.dexterity.content import DexterityContent as DexterityContext
+from Products.CMFCore.PortalFolder import PortalFolder
 from typing import TypeAlias
 from ZPublisher.HTTPRequest import HTTPRequest
 
 # Public-facing context type for content APIs.
 Content: TypeAlias = DexterityContext
-
-# Broader acquisition-wrapped context for APIs that can accept portal/tool roots.
-ContainerContext: TypeAlias = ImplicitAcquisitionWrapper
+Container: TypeAlias = PortalFolder
 
 # Shared request type for browser/request-aware APIs.
 Request: TypeAlias = HTTPRequest

src/plone/api/content.py

@@ -7,7 +7,7 @@
 from copy import copy as _copy
 from itertools import islice
 from plone.api import portal
-from plone.api._types import ContainerContext
+from plone.api._types import Container
 from plone.api._types import Content
 from plone.api._types import Request
 from plone.api.exc import InvalidParameterError
@@ -46,7 +46,7 @@
 @required_parameters("container", "type")
 @at_least_one_of("id", "title")
 def create(
-    container: Content,
+    container: Container,
     type: str,
     id: str | None = None,
     title: str | None = None,
@@ -184,7 +184,7 @@ def get(path: str | None = None, UID: str | None = None) -> Content | None:
 @at_least_one_of("target", "id")
 def move(
     source: Content,
-    target: Content | None = None,
+    target: Container | None = None,
     id: str | None = None,
     safe_id: bool = False,
 ) -> Content:
@@ -263,7 +263,7 @@ def rename(
 @at_least_one_of("target", "id")
 def copy(
     source: Content,
-    target: Content | None = None,
+    target: Container | None = None,
     id: str | None = None,
     safe_id: bool = False,
 ) -> Content:
@@ -833,7 +833,7 @@ def iter_ancestors(
     else:
         end = None
 
-    ancestors: Iterator[ContainerContext | RequestContainer] | Any
+    ancestors: Iterator[Container | RequestContainer] | Any
     ancestors = islice(chain, 1, end)
 
     if interface is not None: