@tellyouai/plugin 0.1.6 → 0.1.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -86,6 +86,30 @@ Existing script integrations remain supported:
86
86
  Query-string configuration belongs to the CDN entry. npm consumers pass all
87
87
  configuration to `initialize` directly.
88
88
 
89
+ ## Placement
90
+
91
+ Position the launcher with named anchors, or supply exact CSS offsets per
92
+ instance. The popup uses the same horizontal anchor and opens above a bottom
93
+ launcher or below a top launcher. The popup's z-index is always one greater
94
+ than the configured launcher z-index (8 and 9 by default).
95
+
96
+ ```ts
97
+ await initialize({
98
+ entityId: "YOUR_ENTITY_ID",
99
+ position: { x: "left", y: "top", z: 123 },
100
+ });
101
+
102
+ // Exact offsets override the corresponding named axis when both are supplied.
103
+ await initialize({
104
+ entityId: "YOUR_ENTITY_ID",
105
+ style: { top: "22rem", left: "auto", right: "12px", zIndex: 99 },
106
+ });
107
+ ```
108
+
109
+ The modal-style `overlay` and `bar` popups retain their preset layout; placement
110
+ offsets apply to their launcher. `style.zIndex` takes precedence over
111
+ `position.z`.
112
+
89
113
  ## User identity
90
114
 
91
115
  Pass the host application's stable user ID to reuse and update the same