@zappie/theme-base 0.0.0-stage → 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,65 @@
-# Temporary Holding Version
+# Base storefront theme
 
-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.
+Workstream 06, Stage A, PR 3: the cart now supports configured lines, quantity
+changes, editing, removal, issue fixes, server-quoted totals and the existing
+host payment flow. Empty and loading states use the same foundations overlay.
+
+The adapter seeds the existing host pickup/delivery choice. Fulfilment, address,
+schedule and promo editors follow in PR 4; a new delivery address cannot yet be
+entered in this cart. Pickup provides the end-to-end payment test path.
+
+The host basket owns initial lines during migration. `connectBasketBridge`
+reconciles complete snapshots into the SDK and mirrors subsequent SDK edits
+back into the same legacy storage bucket. Line identities, choices, notes and
+unavailable-item issues survive. A private SDK import seam makes this atomic;
+no backend API or public cart method changes. Scope changes detach the bridge.
+
+`@zappie/theme-base/host-bridge` exposes the temporary provider contract for
+payment, sign-in, customer details and address suggestions. The host checks a
+current quote and synchronized basket, closes the cart through foundations,
+waits for the URL change and cart unmount, and only then starts the existing
+payment flow. Sign-in similarly releases the foundations modal before invoking
+the host auth callback, which restores the cart after authentication.
+Address lookup uses the existing host Places endpoint. Fulfilment must match
+the current host branch and pickup/delivery bucket before checkout.
+
+Use `pnpm dev` and open an existing test store with
+`?template=base-next&modal_id=review-menu`. Below 1024px the cart is a full-height
+swipeable drawer; from 1024px it is a centred dialog. Deep-link close retains
+the store URL. All other storefront templates retain their existing cart.
+
+`theme.json` copies the approved default-template tokens. Regenerate the scoped
+CSS with `pnpm base-next:tokens`. Explicit `.dark` / `data-theme="dark"` choices
+use dark tokens; the default ignores the operating-system preference.
+
+The host adapters in `lib/templates/base-next` reuse the default catalogue,
+manifest and SEO. This package imports only public commerce packages. The
+host-side seam owns its provider and legacy template contract.
+
+Registration is build-time gated: production serves base-next only with
+`ZAPPIE_ENABLE_BASE_NEXT=1`. The generated registry contains static gated entries;
+builds do not rewrite tracked files. Workspace themes never enter artifact
+admission. The external-template development host keeps its existing cart.
+
+`pnpm base-next:metrics` updates `docs/base-next-metrics.json`, preserving the
+pre-migration baseline. Counts cover the explicit PRD legacy paths and all
+non-test cart source. CSS totals include compiled tokens; legacy shared CSS
+cannot be attributed to cart alone. These incremental metrics are not a claim of
+full cart parity or a completed Stage A reduction.
+
+The catalogue is exported from `@zappie/theme-base/catalogue`. A template wraps
+it in `CatalogueNavigationProvider` from `@zappie/theme-base/navigation`, using
+its own router implementation or the framework-independent
+`createUrlNavigation()` default. Item links and URL state come from that
+navigation context. `initialMenu` contains menus/categories and no items;
+the supplied policy chooses eager or progressive reads. `orderAction` supplies
+the Place/Schedule/View label. Search's controlled source performs bounded
+reads, and themeClass reaches mobile overlay portals.
+
+## Visit counting
+
+A template app calls `countPage` from `@zappie/sdk/visits` after each route
+change, with `enabled: false` in editors and previews. The base screens then
+count successful item adds and cart opens, and attach the visit's source and
+campaign to SDK checkout. The current Next app does not call `countPage`, so
+these events remain disabled there.

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 };