Typehinted abjad.Wrapper.

abjad/bind.py

@@ -86,13 +86,14 @@ class Wrapper:
     def __init__(
         self,
         annotation: str | enum.Enum | None = None,
-        check_duplicate_indicator=False,
-        component=None,
+        # TODO: maybe remove check_duplicate_indicator and check automatically?
+        check_duplicate_indicator: bool = False,
+        component: _score.Component | None = None,
         context: str | None = None,
         deactivate: bool = False,
         direction: _enums.Vertical | None = None,
         indicator: typing.Any | None = None,
-        synthetic_offset: int | None = None,
+        synthetic_offset: _duration.Offset | None = None,
         tag: _tag.Tag = _tag.Tag(),
     ) -> None:
         assert not isinstance(indicator, type(self)), repr(indicator)
@@ -114,6 +115,9 @@ def __init__(
         self._indicator = indicator
         self._synthetic_offset: _duration.Offset | None
         if synthetic_offset is not None:
+            assert isinstance(synthetic_offset, _duration.Offset), repr(
+                synthetic_offset
+            )
             self._synthetic_offset = _duration.Offset(synthetic_offset)
         else:
             self._synthetic_offset = synthetic_offset
@@ -569,18 +573,18 @@ def leaked_start_offset(self) -> _duration.Offset:
             >>> wrapper.start_offset, wrapper.leaked_start_offset
             (Offset((0, 1)), Offset((1, 2)))
 
-        Returns offset.
         """
         if self._synthetic_offset is not None:
             return self._synthetic_offset
         if isinstance(self.indicator, _tweaks.Bundle):
             indicator = self.indicator.indicator
         else:
             indicator = self.indicator
+        assert isinstance(self.component, _score.Component)
         if not getattr(indicator, "leak", False):
-            return self._component._get_timespan().start_offset
+            return self.component._get_timespan().start_offset
         else:
-            return self._component._get_timespan().stop_offset
+            return self.component._get_timespan().stop_offset
 
     @property
     def start_offset(self) -> _duration.Offset:
@@ -590,16 +594,15 @@ def start_offset(self) -> _duration.Offset:
         This is either the wrapper's synthetic offset or the start offset of the
         wrapper's component.
         """
-        if self._synthetic_offset is not None:
-            return self._synthetic_offset
-        return self._component._get_timespan().start_offset
+        if self.synthetic_offset is not None:
+            return self.synthetic_offset
+        assert isinstance(self.component, _score.Component)
+        return self.component._get_timespan().start_offset
 
     @property
-    def synthetic_offset(self):
+    def synthetic_offset(self) -> _duration.Offset | None:
         """
         Gets synthetic offset.
-
-        Returns offset or none.
         """
         return self._synthetic_offset
 
@@ -690,7 +693,7 @@ def attach(
     deactivate: bool = False,
     direction: _enums.Vertical | None = None,
     do_not_test: bool = False,
-    synthetic_offset: int | None = None,
+    synthetic_offset: _duration.Offset | None = None,
     tag: _tag.Tag | None = None,
     wrapper: typing.Literal[True] = True,
 ) -> Wrapper:
@@ -707,7 +710,7 @@ def attach(
     deactivate: bool = False,
     direction: _enums.Vertical | None = None,
     do_not_test: bool = False,
-    synthetic_offset: int | None = None,
+    synthetic_offset: _duration.Offset | None = None,
     tag: _tag.Tag | None = None,
     wrapper: typing.Literal[False],
 ) -> None:
@@ -723,7 +726,7 @@ def attach(
     deactivate: bool = False,
     direction: _enums.Vertical | None = None,
     do_not_test: bool = False,
-    synthetic_offset: int | None = None,
+    synthetic_offset: _duration.Offset | None = None,
     tag: _tag.Tag | None = None,
     wrapper: bool = False,
 ) -> Wrapper | None:

abjad/dynamic.py

@@ -128,7 +128,8 @@ class Dynamic:
 
     ..  container:: example
 
-        REGRESSION. Duplicate dynamics raise exception on attach:
+        REGRESSION. Duplicate dynamics raise exception on attach
+        when ``check_duplicate_indicator=True``:
 
         >>> staff = abjad.Staff("c'4 d' e' f'")
         >>> dynamic = abjad.Dynamic("p")

abjad/get.py

@@ -1160,7 +1160,7 @@ def effective(
         >>> abjad.attach(
         ...     abjad.Clef("treble", hide=True),
         ...     staff[0],
-        ...     synthetic_offset=-1,
+        ...     synthetic_offset=abjad.Offset(-1),
         ...     )
         >>> abjad.attach(abjad.Clef("alto"), staff[0])
         >>> abjad.show(staff) # doctest: +SKIP
@@ -1211,7 +1211,7 @@ def effective(
         >>> abjad.attach(
         ...     abjad.Clef("alto", hide=True),
         ...     staff[-1],
-        ...     synthetic_offset=1,
+        ...     synthetic_offset=abjad.Offset(1),
         ...     )
         >>> abjad.show(staff) # doctest: +SKIP