linq-python 0.67.1__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.1 → linq_python-0.67.2}/CHANGELOG.md

@@ -1,5 +1,12 @@
 # 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)
 
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.67.1
+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.1 → linq_python-0.67.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "linq-python"
-version = "0.67.1"
+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.1 → 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.1"  # x-release-please-version
+__version__ = "0.67.2"  # x-release-please-version

{linq_python-0.67.1 → 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.1 → 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.
+    """

{linq_python-0.67.1 → linq_python-0.67.2}/tests/api_resources/test_messages.py

@@ -287,8 +287,8 @@ class TestMessages:
             placement={
                 "rotation": 15,
                 "scale": 1.25,
-                "x": -0.25,
-                "y": 0.4,
+                "x": 0.9,
+                "y": -0.3,
             },
             url="https://cdn.linqapp.com/attachments/example/sticker.png",
         )
@@ -483,8 +483,8 @@ class TestMessages:
             placement={
                 "rotation": 15,
                 "scale": 0.75,
-                "x": 0.6,
-                "y": 0.5,
+                "x": 0.9,
+                "y": 0.9,
             },
         )
         assert_matches_type(MessageUpdateStickerPlacementResponse, message, path=["response"])
@@ -805,8 +805,8 @@ class TestAsyncMessages:
             placement={
                 "rotation": 15,
                 "scale": 1.25,
-                "x": -0.25,
-                "y": 0.4,
+                "x": 0.9,
+                "y": -0.3,
             },
             url="https://cdn.linqapp.com/attachments/example/sticker.png",
         )
@@ -1001,8 +1001,8 @@ class TestAsyncMessages:
             placement={
                 "rotation": 15,
                 "scale": 0.75,
-                "x": 0.6,
-                "y": 0.5,
+                "x": 0.9,
+                "y": 0.9,
             },
         )
         assert_matches_type(MessageUpdateStickerPlacementResponse, message, path=["response"])

{linq_python-0.67.1 → linq_python-0.67.2}/uv.lock

@@ -530,7 +530,7 @@ wheels = [
 
 [[package]]
 name = "linq-python"
-version = "0.67.0"
+version = "0.67.1"
 source = { editable = "." }
 dependencies = [
     { name = "anyio" },

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

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

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

@@ -1,60 +0,0 @@
-# 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".
-
-    Every field is independent and optional — omit the object entirely, or any field
-    within it, to keep the default (centred, default size, unrotated).
-    """
-
-
-class Placement(TypedDict, total=False):
-    """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).
-    """
-
-    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
-    """Horizontal position on the target bubble, from -1 (far left) to 1 (far right).
-
-    0 is centred.
-    """
-
-    y: float
-    """Vertical position on the target bubble, from -1 (top) to 1 (bottom).
-
-    0 is centred.
-    """