@cartbot/plate-search 3.1.12 → 3.2.0

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
@@ -58,6 +58,22 @@ By default, PlateSearch renders as a modal. To render it inline (embedded in-pla
58
58
  />
59
59
  ```
60
60
 
61
+ ### Session Limits (Local Browser)
62
+
63
+ The component includes client-side session throttling for unique plate/state lookups:
64
+
65
+ - Default: `10` unique lookups per rolling minute (per browser session)
66
+ - Demo mode: `2` unique lookups per day (per browser session), plus the minute limit above
67
+
68
+ Enable demo mode:
69
+
70
+ ```jsx
71
+ <PlateSearch
72
+ apiKey="YOUR_API_KEY"
73
+ demoMode={true}
74
+ />
75
+ ```
76
+
61
77
  ### Controlled Modal State
62
78
 
63
79
  Control the modal open/close state from your own UI using either **controlled props** or **imperative methods**:
@@ -195,6 +211,9 @@ import { PlateSearchRaw } from "@cartbot/plate-search";
195
211
  <!-- Inline (embedded) mode -->
196
212
  <plate-search data-api-key="YOUR_API_KEY" data-display-mode="inline" />
197
213
 
214
+ <!-- Demo mode (2 unique lookups/day per browser session) -->
215
+ <plate-search data-api-key="YOUR_API_KEY" data-demo-mode="true" />
216
+
198
217
  <script>
199
218
  // Control modal programmatically
200
219
  const plateSearch = document.querySelector("plate-search");