@zappie/theme-base 0.0.0-stage → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,30 @@
+# @zappie/theme-base
+
+## 0.1.1
+
+### Patch Changes
+
+- 1e6f420: Each package now has a README written for people installing it from npm: what it does, how to install and use it, its entry points, and links to docs.zappie.ai. `@zappie/kit` gains its first README.
+- Updated dependencies [38f23ac]
+- Updated dependencies [1e6f420]
+  - @zappie/sdk@0.1.1
+  - @zappie/foundations@0.1.1
+  - @zappie/tokens@0.1.1
+
+## 0.1.0
+
+### Minor Changes
+
+- - `@zappie/tokens`: Publish the semantic storefront token contract, CSS aliases, validation and compilation tools.
+  - `@zappie/sdk`: Publish the framework-agnostic storefront client and its React, server, checkout, customer, places, visits and URL entries.
+  - `@zappie/foundations`: Publish accessible, unstyled React primitives for storefront catalogue, item, fulfilment and cart experiences.
+  - `@zappie/theme-base`: Publish the reusable base storefront theme and its catalogue, item and cart surfaces.
+  - `@zappie/kit`: Publish the built component registry consumed by the Zappie CLI.
+  - `zappie`: Publish the component CLI with `add`, `list` and `diff`.
+
+### Patch Changes
+
+- Updated dependencies
+  - @zappie/tokens@0.1.0
+  - @zappie/sdk@0.1.0
+  - @zappie/foundations@0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zappie
+
+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

@@ -1,3 +1,38 @@
-# Temporary Holding Version
+# @zappie/theme-base
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The base storefront theme that Zappie's own storefront app renders: the catalogue, item sheets, cart and checkout steps. It's built only from Zappie's public packages, `@zappie/sdk`, `@zappie/foundations` and `@zappie/tokens`, so it also shows how far those packages go on their own.
+
+```sh
+npm install @zappie/theme-base
+```
+
+React 19.2 is a peer dependency.
+
+## Who it's for
+
+Zappie's storefront app mounts this theme and supplies payment, sign-in, rewards and delivery regions through `@zappie/theme-base/host-bridge`. That bridge is a temporary contract with Zappie's own app. It will be replaced, so it isn't a stable way to run the theme in your own project.
+
+Building your own storefront or template? Start from `@zappie/sdk`, `@zappie/foundations` and the kit's copy-in components (`npx zappie add <name>`). Use this theme as a reference for how the parts fit together.
+
+## Entry points
+
+| Import                                                 | For                                                 |
+| ------------------------------------------------------ | --------------------------------------------------- |
+| `@zappie/theme-base/catalogue`, `/item`, `/item-frame` | The menu and item views                             |
+| `@zappie/theme-base/cart` and `/checkout`              | The cart and checkout steps                         |
+| `@zappie/theme-base/address` and `/navigation`         | Address entry and in-page navigation                |
+| `@zappie/theme-base/styles.css`                        | The theme's styles, scoped to its own root          |
+| `@zappie/theme-base/host-bridge`                       | The temporary contract with Zappie's storefront app |
+
+## Docs
+
+- [Open Storefronts](https://docs.zappie.ai/open-storefronts)
+- [Build a storefront](https://docs.zappie.ai/guides/build-a-storefront)
+
+## Status
+
+The theme is at `0.x`. It changes with Zappie's storefront app, and any release can change its entry points. Each change is listed in `CHANGELOG.md`.
+
+## License
+
+MIT

package/dist/address.d.ts

@@ -0,0 +1,32 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { DeliveryAddress } from '@zappie/sdk';
+import { PlacesClient } from '@zappie/sdk/places';
+import { ComponentType, ReactNode } from 'react';
+
+type AddressSuggestion = {
+    placeId: string;
+    address: string;
+    sessionToken?: string;
+};
+type AddressLookup = {
+    suggest(query: string): Promise<AddressSuggestion[]>;
+    reverse?(coordinates: {
+        lat: number;
+        lng: number;
+    }): Promise<DeliveryAddress>;
+    resolve?(address: DeliveryAddress, sessionToken?: string): Promise<DeliveryAddress>;
+    Map?: ComponentType<{
+        address: DeliveryAddress;
+    }>;
+};
+declare function AddressLookupProvider({ lookup, children, }: {
+    lookup: AddressLookup;
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+declare function useAddressLookup(): AddressLookup;
+declare function createSdkAddressLookup({ places, branchId, }: {
+    places: PlacesClient;
+    branchId: string;
+}): AddressLookup;
+
+export { type AddressLookup, AddressLookupProvider, type AddressSuggestion, createSdkAddressLookup, useAddressLookup };

package/dist/address.js

@@ -0,0 +1,4 @@
+"use client";
+export { AddressLookupProvider, createSdkAddressLookup, useAddressLookup } from './chunk-NTJONY3N.js';
+//# sourceMappingURL=address.js.map
+//# sourceMappingURL=address.js.map

package/dist/address.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"address.js"}

package/dist/cart.d.ts

@@ -0,0 +1,12 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * `themeClass` lets a template reuse this cart under its own design: the class
+ * is added to every overlay root, so the template's tokens (compiled under
+ * that class) and its own rules apply. Without it the cart uses the base theme.
+ */
+declare function CartReview({ themeClass }?: {
+    themeClass?: string;
+}): react_jsx_runtime.JSX.Element;
+
+export { CartReview };