linq-python 0.67.0__tar.gz → 0.67.2__tar.gz

linq_python-0.67.2/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.67.2"
+}

{linq_python-0.67.0 → linq_python-0.67.2}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.67.2](https://github.com/linq-team/linq-python/compare/v0.67.1...v0.67.2) (2026-11-09)
+
+
+### Documentation
+
+* clarify sticker placement coordinate system and behavior ([d71c16b](https://github.com/linq-team/linq-python/commit/d71c16bab058f0b8f875bb9d16b32321b111a169))
+
+## [0.67.1](https://github.com/linq-team/linq-python/compare/v0.67.0...v0.67.1) (2026-11-06)
+
+
+### Documentation
+
+* update sip configuration guidance in api documentation ([2a83fe7](https://github.com/linq-team/linq-python/commit/2a83fe7755d73ab29a90ecea9088b172770855ee))
+
 ## [0.67.0](https://github.com/linq-team/linq-python/compare/v0.66.0...v0.67.0) (2026-11-06)
 
 

{linq_python-0.67.0 → linq_python-0.67.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.67.0
+Version: 0.67.2
 Summary: The official Python library for the linq-api-v3 API
 Project-URL: Homepage, https://github.com/linq-team/linq-python
 Project-URL: Repository, https://github.com/linq-team/linq-python

{linq_python-0.67.0 → linq_python-0.67.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "linq-python"
-version = "0.67.0"
+version = "0.67.2"
 description = "The official Python library for the linq-api-v3 API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{linq_python-0.67.0 → linq_python-0.67.2}/src/linq/_client.py

@@ -856,13 +856,8 @@ class LinqAPIV3(SyncAPIClient):
     def sip_profiles(self) -> SipProfilesResource:
         """## SIP configuration
 
-        Add these IP ranges to your SIP endpoint's allowlist:
-
-        ```
-        54.172.60.0/30
-        54.244.51.0/30
-        168.86.128.0/18
-        ```
+        Your Linq representative provides the signaling and media IP ranges and
+        ports to allow through your firewall during onboarding.
 
         Set `primary_uri` to your endpoint as scheme + host — `sips:` for TLS or
         `sip:` for UDP, with no user part (we add it). Each call arrives at your
@@ -873,7 +868,7 @@ class LinqAPIV3(SyncAPIClient):
         ```
 
         so you can route on the dialed number. The caller's number is in the
-        `From` header in E.164. Media (RTP) uses UDP ports 10000–60000.
+        `From` header in E.164.
         """
         from .resources.sip_profiles import SipProfilesResource
 
@@ -2078,13 +2073,8 @@ class AsyncLinqAPIV3(AsyncAPIClient):
     def sip_profiles(self) -> AsyncSipProfilesResource:
         """## SIP configuration
 
-        Add these IP ranges to your SIP endpoint's allowlist:
-
-        ```
-        54.172.60.0/30
-        54.244.51.0/30
-        168.86.128.0/18
-        ```
+        Your Linq representative provides the signaling and media IP ranges and
+        ports to allow through your firewall during onboarding.
 
         Set `primary_uri` to your endpoint as scheme + host — `sips:` for TLS or
         `sip:` for UDP, with no user part (we add it). Each call arrives at your
@@ -2095,7 +2085,7 @@ class AsyncLinqAPIV3(AsyncAPIClient):
         ```
 
         so you can route on the dialed number. The caller's number is in the
-        `From` header in E.164. Media (RTP) uses UDP ports 10000–60000.
+        `From` header in E.164.
         """
         from .resources.sip_profiles import AsyncSipProfilesResource
 
@@ -3234,13 +3224,8 @@ class LinqAPIV3WithRawResponse:
     def sip_profiles(self) -> sip_profiles.SipProfilesResourceWithRawResponse:
         """## SIP configuration
 
-        Add these IP ranges to your SIP endpoint's allowlist:
-
-        ```
-        54.172.60.0/30
-        54.244.51.0/30
-        168.86.128.0/18
-        ```
+        Your Linq representative provides the signaling and media IP ranges and
+        ports to allow through your firewall during onboarding.
 
         Set `primary_uri` to your endpoint as scheme + host — `sips:` for TLS or
         `sip:` for UDP, with no user part (we add it). Each call arrives at your
@@ -3251,7 +3236,7 @@ class LinqAPIV3WithRawResponse:
         ```
 
         so you can route on the dialed number. The caller's number is in the
-        `From` header in E.164. Media (RTP) uses UDP ports 10000–60000.
+        `From` header in E.164.
         """
         from .resources.sip_profiles import SipProfilesResourceWithRawResponse
 
@@ -4262,13 +4247,8 @@ class AsyncLinqAPIV3WithRawResponse:
     def sip_profiles(self) -> sip_profiles.AsyncSipProfilesResourceWithRawResponse:
         """## SIP configuration
 
-        Add these IP ranges to your SIP endpoint's allowlist:
-
-        ```
-        54.172.60.0/30
-        54.244.51.0/30
-        168.86.128.0/18
-        ```
+        Your Linq representative provides the signaling and media IP ranges and
+        ports to allow through your firewall during onboarding.
 
         Set `primary_uri` to your endpoint as scheme + host — `sips:` for TLS or
         `sip:` for UDP, with no user part (we add it). Each call arrives at your
@@ -4279,7 +4259,7 @@ class AsyncLinqAPIV3WithRawResponse:
         ```
 
         so you can route on the dialed number. The caller's number is in the
-        `From` header in E.164. Media (RTP) uses UDP ports 10000–60000.
+        `From` header in E.164.
         """
         from .resources.sip_profiles import AsyncSipProfilesResourceWithRawResponse
 
@@ -5290,13 +5270,8 @@ class LinqAPIV3WithStreamedResponse:
     def sip_profiles(self) -> sip_profiles.SipProfilesResourceWithStreamingResponse:
         """## SIP configuration
 
-        Add these IP ranges to your SIP endpoint's allowlist:
-
-        ```
-        54.172.60.0/30
-        54.244.51.0/30
-        168.86.128.0/18
-        ```
+        Your Linq representative provides the signaling and media IP ranges and
+        ports to allow through your firewall during onboarding.
 
         Set `primary_uri` to your endpoint as scheme + host — `sips:` for TLS or
         `sip:` for UDP, with no user part (we add it). Each call arrives at your
@@ -5307,7 +5282,7 @@ class LinqAPIV3WithStreamedResponse:
         ```
 
         so you can route on the dialed number. The caller's number is in the
-        `From` header in E.164. Media (RTP) uses UDP ports 10000–60000.
+        `From` header in E.164.
         """
         from .resources.sip_profiles import SipProfilesResourceWithStreamingResponse
 
@@ -6318,13 +6293,8 @@ class AsyncLinqAPIV3WithStreamedResponse:
     def sip_profiles(self) -> sip_profiles.AsyncSipProfilesResourceWithStreamingResponse:
         """## SIP configuration
 
-        Add these IP ranges to your SIP endpoint's allowlist:
-
-        ```
-        54.172.60.0/30
-        54.244.51.0/30
-        168.86.128.0/18
-        ```
+        Your Linq representative provides the signaling and media IP ranges and
+        ports to allow through your firewall during onboarding.
 
         Set `primary_uri` to your endpoint as scheme + host — `sips:` for TLS or
         `sip:` for UDP, with no user part (we add it). Each call arrives at your
@@ -6335,7 +6305,7 @@ class AsyncLinqAPIV3WithStreamedResponse:
         ```
 
         so you can route on the dialed number. The caller's number is in the
-        `From` header in E.164. Media (RTP) uses UDP ports 10000–60000.
+        `From` header in E.164.
         """
         from .resources.sip_profiles import AsyncSipProfilesResourceWithStreamingResponse
 

{linq_python-0.67.0 → linq_python-0.67.2}/src/linq/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "linq"
-__version__ = "0.67.0"  # x-release-please-version
+__version__ = "0.67.2"  # x-release-please-version

{linq_python-0.67.0 → linq_python-0.67.2}/src/linq/resources/messages/messages.py

@@ -573,8 +573,24 @@ class MessagesResource(SyncAPIResource):
           placement: Optional position, size and rotation of a sticker on the target bubble. Only
               valid when type is "sticker".
 
-              Every field is independent and optional — omit the object entirely, or any field
-              within it, to keep the default (centred, default size, unrotated).
+              `x` and `y` set where the sticker's centre lands, as a fraction of the target
+              bubble's width and height:
+
+              | Position            | `x` | `y` |
+              | ------------------- | --- | --- |
+              | Top-left corner     | 0   | 0   |
+              | Top-right corner    | 1   | 0   |
+              | Centre              | 0.5 | 0.5 |
+              | Bottom-left corner  | 0   | 1   |
+              | Bottom-right corner | 1   | 1   |
+
+              Every field is independent and optional. Omit `x` and `y` and the sticker lands
+              on the top-left corner.
+
+              Position and size are relative to the target bubble, so a sticker keeps its
+              place on the bubble on every device. Its size follows the bubble's width: the
+              same sticker is drawn smaller on a bubble that a recipient's screen renders
+              narrower than the sender's.
 
           url: Linq attachment URL of the image — the `download_url` returned by
               `POST /v3/attachments`. Valid when type is "sticker", or when adding a type
@@ -823,8 +839,24 @@ class MessagesResource(SyncAPIResource):
           placement: Optional position, size and rotation of a sticker on the target bubble. Only
               valid when type is "sticker".
 
-              Every field is independent and optional — omit the object entirely, or any field
-              within it, to keep the default (centred, default size, unrotated).
+              `x` and `y` set where the sticker's centre lands, as a fraction of the target
+              bubble's width and height:
+
+              | Position            | `x` | `y` |
+              | ------------------- | --- | --- |
+              | Top-left corner     | 0   | 0   |
+              | Top-right corner    | 1   | 0   |
+              | Centre              | 0.5 | 0.5 |
+              | Bottom-left corner  | 0   | 1   |
+              | Bottom-right corner | 1   | 1   |
+
+              Every field is independent and optional. Omit `x` and `y` and the sticker lands
+              on the top-left corner.
+
+              Position and size are relative to the target bubble, so a sticker keeps its
+              place on the bubble on every device. Its size follows the bubble's width: the
+              same sticker is drawn smaller on a bubble that a recipient's screen renders
+              narrower than the sender's.
 
           extra_headers: Send extra headers
 
@@ -1380,8 +1412,24 @@ class AsyncMessagesResource(AsyncAPIResource):
           placement: Optional position, size and rotation of a sticker on the target bubble. Only
               valid when type is "sticker".
 
-              Every field is independent and optional — omit the object entirely, or any field
-              within it, to keep the default (centred, default size, unrotated).
+              `x` and `y` set where the sticker's centre lands, as a fraction of the target
+              bubble's width and height:
+
+              | Position            | `x` | `y` |
+              | ------------------- | --- | --- |
+              | Top-left corner     | 0   | 0   |
+              | Top-right corner    | 1   | 0   |
+              | Centre              | 0.5 | 0.5 |
+              | Bottom-left corner  | 0   | 1   |
+              | Bottom-right corner | 1   | 1   |
+
+              Every field is independent and optional. Omit `x` and `y` and the sticker lands
+              on the top-left corner.
+
+              Position and size are relative to the target bubble, so a sticker keeps its
+              place on the bubble on every device. Its size follows the bubble's width: the
+              same sticker is drawn smaller on a bubble that a recipient's screen renders
+              narrower than the sender's.
 
           url: Linq attachment URL of the image — the `download_url` returned by
               `POST /v3/attachments`. Valid when type is "sticker", or when adding a type
@@ -1630,8 +1678,24 @@ class AsyncMessagesResource(AsyncAPIResource):
           placement: Optional position, size and rotation of a sticker on the target bubble. Only
               valid when type is "sticker".
 
-              Every field is independent and optional — omit the object entirely, or any field
-              within it, to keep the default (centred, default size, unrotated).
+              `x` and `y` set where the sticker's centre lands, as a fraction of the target
+              bubble's width and height:
+
+              | Position            | `x` | `y` |
+              | ------------------- | --- | --- |
+              | Top-left corner     | 0   | 0   |
+              | Top-right corner    | 1   | 0   |
+              | Centre              | 0.5 | 0.5 |
+              | Bottom-left corner  | 0   | 1   |
+              | Bottom-right corner | 1   | 1   |
+
+              Every field is independent and optional. Omit `x` and `y` and the sticker lands
+              on the top-left corner.
+
+              Position and size are relative to the target bubble, so a sticker keeps its
+              place on the bubble on every device. Its size follows the bubble's width: the
+              same sticker is drawn smaller on a bubble that a recipient's screen renders
+              narrower than the sender's.
 
           extra_headers: Send extra headers
 

{linq_python-0.67.0 → linq_python-0.67.2}/src/linq/resources/sip_profiles.py

@@ -28,13 +28,8 @@ __all__ = ["SipProfilesResource", "AsyncSipProfilesResource"]
 class SipProfilesResource(SyncAPIResource):
     """## SIP configuration
 
-    Add these IP ranges to your SIP endpoint's allowlist:
-
-    ```
-    54.172.60.0/30
-    54.244.51.0/30
-    168.86.128.0/18
-    ```
+    Your Linq representative provides the signaling and media IP ranges and
+    ports to allow through your firewall during onboarding.
 
     Set `primary_uri` to your endpoint as scheme + host — `sips:` for TLS or
     `sip:` for UDP, with no user part (we add it). Each call arrives at your
@@ -45,7 +40,7 @@ class SipProfilesResource(SyncAPIResource):
     ```
 
     so you can route on the dialed number. The caller's number is in the
-    `From` header in E.164. Media (RTP) uses UDP ports 10000–60000.
+    `From` header in E.164.
     """
 
     @cached_property
@@ -83,13 +78,8 @@ class SipProfilesResource(SyncAPIResource):
         """
         ## SIP configuration
 
-        Add these IP ranges to your SIP endpoint's allowlist:
-
-        ```
-        54.172.60.0/30
-        54.244.51.0/30
-        168.86.128.0/18
-        ```
+        Your Linq representative provides the signaling and media IP ranges and ports to
+        allow through your firewall during onboarding.
 
         Set `primary_uri` to your endpoint as scheme + host — `sips:` for TLS or `sip:`
         for UDP, with no user part (we add it). Each call arrives at your endpoint as:
@@ -99,7 +89,7 @@ class SipProfilesResource(SyncAPIResource):
         ```
 
         so you can route on the dialed number. The caller's number is in the `From`
-        header in E.164. Media (RTP) uses UDP ports 10000–60000.
+        header in E.164.
 
         ---
 
@@ -289,13 +279,8 @@ class SipProfilesResource(SyncAPIResource):
         """
         ## SIP configuration
 
-        Add these IP ranges to your SIP endpoint's allowlist:
-
-        ```
-        54.172.60.0/30
-        54.244.51.0/30
-        168.86.128.0/18
-        ```
+        Your Linq representative provides the signaling and media IP ranges and ports to
+        allow through your firewall during onboarding.
 
         Set `primary_uri` to your endpoint as scheme + host — `sips:` for TLS or `sip:`
         for UDP, with no user part (we add it). Each call arrives at your endpoint as:
@@ -305,7 +290,7 @@ class SipProfilesResource(SyncAPIResource):
         ```
 
         so you can route on the dialed number. The caller's number is in the `From`
-        header in E.164. Media (RTP) uses UDP ports 10000–60000.
+        header in E.164.
 
         ---
 
@@ -341,13 +326,8 @@ class SipProfilesResource(SyncAPIResource):
 class AsyncSipProfilesResource(AsyncAPIResource):
     """## SIP configuration
 
-    Add these IP ranges to your SIP endpoint's allowlist:
-
-    ```
-    54.172.60.0/30
-    54.244.51.0/30
-    168.86.128.0/18
-    ```
+    Your Linq representative provides the signaling and media IP ranges and
+    ports to allow through your firewall during onboarding.
 
     Set `primary_uri` to your endpoint as scheme + host — `sips:` for TLS or
     `sip:` for UDP, with no user part (we add it). Each call arrives at your
@@ -358,7 +338,7 @@ class AsyncSipProfilesResource(AsyncAPIResource):
     ```
 
     so you can route on the dialed number. The caller's number is in the
-    `From` header in E.164. Media (RTP) uses UDP ports 10000–60000.
+    `From` header in E.164.
     """
 
     @cached_property
@@ -396,13 +376,8 @@ class AsyncSipProfilesResource(AsyncAPIResource):
         """
         ## SIP configuration
 
-        Add these IP ranges to your SIP endpoint's allowlist:
-
-        ```
-        54.172.60.0/30
-        54.244.51.0/30
-        168.86.128.0/18
-        ```
+        Your Linq representative provides the signaling and media IP ranges and ports to
+        allow through your firewall during onboarding.
 
         Set `primary_uri` to your endpoint as scheme + host — `sips:` for TLS or `sip:`
         for UDP, with no user part (we add it). Each call arrives at your endpoint as:
@@ -412,7 +387,7 @@ class AsyncSipProfilesResource(AsyncAPIResource):
         ```
 
         so you can route on the dialed number. The caller's number is in the `From`
-        header in E.164. Media (RTP) uses UDP ports 10000–60000.
+        header in E.164.
 
         ---
 
@@ -602,13 +577,8 @@ class AsyncSipProfilesResource(AsyncAPIResource):
         """
         ## SIP configuration
 
-        Add these IP ranges to your SIP endpoint's allowlist:
-
-        ```
-        54.172.60.0/30
-        54.244.51.0/30
-        168.86.128.0/18
-        ```
+        Your Linq representative provides the signaling and media IP ranges and ports to
+        allow through your firewall during onboarding.
 
         Set `primary_uri` to your endpoint as scheme + host — `sips:` for TLS or `sip:`
         for UDP, with no user part (we add it). Each call arrives at your endpoint as:
@@ -618,7 +588,7 @@ class AsyncSipProfilesResource(AsyncAPIResource):
         ```
 
         so you can route on the dialed number. The caller's number is in the `From`
-        header in E.164. Media (RTP) uses UDP ports 10000–60000.
+        header in E.164.
 
         ---
 

{linq_python-0.67.0 → linq_python-0.67.2}/src/linq/types/message_add_reaction_params.py

@@ -67,8 +67,24 @@ class MessageAddReactionParams(TypedDict, total=False):
 
     Only valid when type is "sticker".
 
-    Every field is independent and optional — omit the object entirely, or any field
-    within it, to keep the default (centred, default size, unrotated).
+    `x` and `y` set where the sticker's centre lands, as a fraction of the target
+    bubble's width and height:
+
+    | Position            | `x` | `y` |
+    | ------------------- | --- | --- |
+    | Top-left corner     | 0   | 0   |
+    | Top-right corner    | 1   | 0   |
+    | Centre              | 0.5 | 0.5 |
+    | Bottom-left corner  | 0   | 1   |
+    | Bottom-right corner | 1   | 1   |
+
+    Every field is independent and optional. Omit `x` and `y` and the sticker lands
+    on the top-left corner.
+
+    Position and size are relative to the target bubble, so a sticker keeps its
+    place on the bubble on every device. Its size follows the bubble's width: the
+    same sticker is drawn smaller on a bubble that a recipient's screen renders
+    narrower than the sender's.
     """
 
     url: str
@@ -91,9 +107,24 @@ class Placement(TypedDict, total=False):
 
     Only valid when type is "sticker".
 
-    Every field is independent and optional — omit the object entirely,
-    or any field within it, to keep the default (centred, default size,
-    unrotated).
+    `x` and `y` set where the sticker's centre lands, as a fraction of
+    the target bubble's width and height:
+
+    | Position | `x` | `y` |
+    |---|---|---|
+    | Top-left corner | 0 | 0 |
+    | Top-right corner | 1 | 0 |
+    | Centre | 0.5 | 0.5 |
+    | Bottom-left corner | 0 | 1 |
+    | Bottom-right corner | 1 | 1 |
+
+    Every field is independent and optional. Omit `x` and `y` and the
+    sticker lands on the top-left corner.
+
+    Position and size are relative to the target bubble, so a sticker
+    keeps its place on the bubble on every device. Its size follows the
+    bubble's width: the same sticker is drawn smaller on a bubble that a
+    recipient's screen renders narrower than the sender's.
     """
 
     rotation: float
@@ -111,13 +142,19 @@ class Placement(TypedDict, total=False):
     """
 
     x: float
-    """Horizontal position on the target bubble, from -1 (far left) to 1 (far right).
+    """
+    Where the sticker's centre sits horizontally, as a fraction of the target
+    bubble's width: 0 is its left edge, 0.5 its centre and 1 its right edge. Values
+    outside -1–1 are clamped.
 
-    0 is centred.
+    Avoid negative values: a sticker left of a received bubble makes the recipient's
+    device shift the whole message to fit it.
     """
 
     y: float
-    """Vertical position on the target bubble, from -1 (top) to 1 (bottom).
-
-    0 is centred.
+    """
+    Where the sticker's centre sits vertically, as a fraction of the target bubble's
+    height: 0 is its top edge, 0.5 its centre and 1 its bottom edge. Negative values
+    place it above the bubble; `-0.3` sits just above the top edge. Values outside
+    -1–1 are clamped.
     """

linq_python-0.67.2/src/linq/types/message_update_sticker_placement_params.py

@@ -0,0 +1,97 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, Annotated, TypedDict
+
+from .._utils import PropertyInfo
+
+__all__ = ["MessageUpdateStickerPlacementParams", "Placement"]
+
+
+class MessageUpdateStickerPlacementParams(TypedDict, total=False):
+    message_id: Required[Annotated[str, PropertyInfo(alias="messageId")]]
+
+    placement: Required[Placement]
+    """Optional position, size and rotation of a sticker on the target bubble.
+
+    Only valid when type is "sticker".
+
+    `x` and `y` set where the sticker's centre lands, as a fraction of the target
+    bubble's width and height:
+
+    | Position            | `x` | `y` |
+    | ------------------- | --- | --- |
+    | Top-left corner     | 0   | 0   |
+    | Top-right corner    | 1   | 0   |
+    | Centre              | 0.5 | 0.5 |
+    | Bottom-left corner  | 0   | 1   |
+    | Bottom-right corner | 1   | 1   |
+
+    Every field is independent and optional. Omit `x` and `y` and the sticker lands
+    on the top-left corner.
+
+    Position and size are relative to the target bubble, so a sticker keeps its
+    place on the bubble on every device. Its size follows the bubble's width: the
+    same sticker is drawn smaller on a bubble that a recipient's screen renders
+    narrower than the sender's.
+    """
+
+
+class Placement(TypedDict, total=False):
+    """Optional position, size and rotation of a sticker on the target
+    bubble.
+
+    Only valid when type is "sticker".
+
+    `x` and `y` set where the sticker's centre lands, as a fraction of
+    the target bubble's width and height:
+
+    | Position | `x` | `y` |
+    |---|---|---|
+    | Top-left corner | 0 | 0 |
+    | Top-right corner | 1 | 0 |
+    | Centre | 0.5 | 0.5 |
+    | Bottom-left corner | 0 | 1 |
+    | Bottom-right corner | 1 | 1 |
+
+    Every field is independent and optional. Omit `x` and `y` and the
+    sticker lands on the top-left corner.
+
+    Position and size are relative to the target bubble, so a sticker
+    keeps its place on the bubble on every device. Its size follows the
+    bubble's width: the same sticker is drawn smaller on a bubble that a
+    recipient's screen renders narrower than the sender's.
+    """
+
+    rotation: float
+    """Clockwise rotation in degrees."""
+
+    scale: float
+    """How large the sticker is drawn.
+
+    Omit it for the default size — equivalent to `1` for an image, or `0.5` for an
+    emoji.
+
+    Values outside 0.05–2.5 are clamped rather than rejected.
+
+    Scale is linear, so 2.5 is a little over six times the area.
+    """
+
+    x: float
+    """
+    Where the sticker's centre sits horizontally, as a fraction of the target
+    bubble's width: 0 is its left edge, 0.5 its centre and 1 its right edge. Values
+    outside -1–1 are clamped.
+
+    Avoid negative values: a sticker left of a received bubble makes the recipient's
+    device shift the whole message to fit it.
+    """
+
+    y: float
+    """
+    Where the sticker's centre sits vertically, as a fraction of the target bubble's
+    height: 0 is its top edge, 0.5 its centre and 1 its bottom edge. Negative values
+    place it above the bubble; `-0.3` sits just above the top edge. Values outside
+    -1–1 are clamped.
+    """