@swift-food-services/catering-widget 0.1.0-beta.7 → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arnav Vaish
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -40,7 +40,8 @@ Defaults: Swift-hosted backend, `localStorage` persistence, neutral theme.
 | `publishableKey` | `string` | yes | Your `pk_live_...` key from Swift. |
 | `googleMapsApiKey` | `string` | yes | Google Maps JavaScript API key with the Places library enabled. Used by the address-autocomplete field. |
 | `theme` | `Theme` | no | Primary color, border radius, and font overrides. |
-| `initialData` | `InitialData` | no | Pre-populate event, address, and contact fields. Applied only on first mount. |
+| `initialData` | `InitialData` | no | Pre-populate event window, address, and contact fields. Re-applied when its fingerprint changes between mounts; preserved on reload. See [Pre-filling known event details](#pre-filling-known-event-details). |
+| `allowedCateringTimes` | `AllowedCateringTimes` | no | Partner-level catering availability window (`{ start: "HH:MM", end: "HH:MM" }`). Restricts the session delivery-time picker to slots within this range. |
 | `stickyTopOffset` | `number` | no | Pixels to offset the widget's internal sticky date/session nav from the top of the viewport. Set this to the height of any sticky/fixed navbar in your host layout so the widget's nav doesn't slide underneath it. Defaults to `0`. |
 | `onReady` | `() => void` | no | Fires when the widget has initialized. |
 | `onOrderComplete` | `(result: OrderCompleteResult) => void` | no | Fires after a successful order submission. See [`onOrderComplete` behaviour](#onordercompleteresult) for the timing. |
@@ -90,8 +91,10 @@ export default function Page() {
   publishableKey="pk_live_..."
   initialData={{
     eventName: "Alice's Birthday",
-    eventDate: "2026-07-12",
-    eventTime: "19:00",
+    eventStartDate: "2026-07-12",
+    eventStartTime: "18:00",
+    eventEndDate: "2026-07-12",
+    eventEndTime: "22:00",
     guestCount: 40,
     deliveryAddress: {
       line1: "1 Example Lane",
@@ -106,9 +109,32 @@ export default function Page() {
 />
 ```
 
-Every field in `initialData` is optional. Fields remain editable after pre-fill. `initialData` is only applied on first mount — if the user has a half-finished order in progress (persisted in `localStorage`), the persisted state wins.
+Every field in `initialData` is optional. Fields remain editable after pre-fill.
 
-**Address requires `lat` and `lng`.** Delivery pricing depends on coordinates, so if you pass a `deliveryAddress` without both `lat` and `lng`, the widget ignores the entire address (no fields are pre-filled) and the guest is asked to pick one via the address-autocomplete field instead. The other `initialData` fields (event date/time, guest count, contact) still apply.
+**How `initialData` interacts with persisted in-progress orders:** the widget fingerprints the supplied `initialData` (event window, guest count, address, and contact fields) and stores the fingerprint alongside the order. On every mount it compares the incoming fingerprint to the stored one:
+
+- **Match** (e.g. page reload) → the in-progress order is preserved; `initialData` is _not_ re-applied.
+- **Differ** (e.g. customer navigated back to your booking page, edited details, then returned) → the stored order is cleared and `initialData` is applied fresh.
+- **No fingerprint stored yet** (first visit) → `initialData` is applied and the fingerprint is recorded.
+
+For this to behave predictably, make sure the values you pass for the same booking are stable across renders — avoid recomputing dynamic values like `new Date()` inline in render.
+
+The event window is a start–end pair (`eventStartDate` + `eventStartTime` to `eventEndDate` + `eventEndTime`). When set, the session editor restricts session dates to that range and filters the delivery-time picker so it stays within the window on the boundary days.
+
+**Address requires `lat` and `lng`.** Delivery pricing depends on coordinates, so if you pass a `deliveryAddress` without both `lat` and `lng`, the widget ignores the entire address (no fields are pre-filled) and the guest is asked to pick one via the address-autocomplete field instead. The other `initialData` fields (event window, guest count, contact) still apply.
+
+### Restricting catering hours (`allowedCateringTimes`)
+
+Pass a partner-level catering availability window to restrict the session delivery-time picker to a subset of the day. Times are 24-hour `"HH:MM"` strings.
+
+```tsx
+<CateringWidget
+  publishableKey="pk_live_..."
+  allowedCateringTimes={{ start: "09:00", end: "19:00" }}
+/>
+```
+
+Each slot is a 30-minute window. A slot is shown only if it fits entirely within `[start, end]` — its start must be ≥ `start` and its end must be ≤ `end`. With `end: "19:00"`, for example, the latest visible slot is 6:30 PM – 7:00 PM. If `initialData` also defines an event window, the two filters compose: the partner window is the outer bound, and the event start/end further narrow the picker on boundary days.
 
 ### Offsetting below a host navbar
 
@@ -131,6 +157,7 @@ import {
   type CateringWidgetProps,
   type Theme,
   type InitialData,
+  type AllowedCateringTimes,
   type OrderCompleteResult,
   type OrderSummary,
   type MealSession,