@zappie/foundations 0.3.1 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @zappie/foundations
 
+## 0.4.0
+
+### Minor Changes
+
+- a5bd08f: `@zappie/sdk/account` reads the signed-in shopper's account through the same endpoint and session as `createCustomer`. `createAccount()` returns `wallets()`, `cards()`, `removeCard(id)`, `payments({ limit, cursor })` and `payment(id)`. A call the shopper's sign-in doesn't cover rejects with `ScopeRequiredError`, which names the scope, and a card or payment that isn't theirs rejects with `NotFoundError`. Both are a `CustomerError`. `accountsUrl(path, environment, { returnTo })` builds a link to a page on the Zappie accounts portal, `/account`, `/account/profile`, `/account/payouts`, `/account/withdraw` or `/account/activity`, with the page to come back to. It refuses a path the way `checkoutUrl` does. `@zappie/sdk/testing` adds `mockAccountFetch()` and `accountFixtures`, which answer the account endpoints as the API does, including a removed card and a missing scope.
+
+  `@zappie/foundations/account` adds headless account parts that load only on account pages: `Wallets`, `Cards`, `RemoveCard` (a confirmation before a card is removed), `Payments`, `Receipt` and `ScopeMissing`, which offers to sign in again. `SignInOptions.scopes` accepts `wallet`, `cards` and `payments:read`.
+
+  `no-offsite-navigation` trusts the staging accounts portal and `accountsUrl` from `@zappie/sdk/account`, and `no-direct-api` points a written-out accounts address to `accountsUrl`.
+
+### Patch Changes
+
+- Updated dependencies [a5bd08f]
+  - @zappie/sdk@0.5.0
+
 ## 0.3.1
 
 ### Patch Changes

package/README.md

@@ -34,6 +34,7 @@ Want ready-made, styled components instead? Copy them into your project from the
 | Import                          | For                                                             |
 | ------------------------------- | --------------------------------------------------------------- |
 | `@zappie/foundations`           | Every part                                                      |
+| `@zappie/foundations/account`   | Wallet, saved card, payment and receipt parts for account pages |
 | `@zappie/foundations/next`      | Keeping overlays in step with Back and Forward in a Next.js app |
 | `@zappie/foundations/rich-text` | Sanitising and parsing merchant rich text before you render it  |
 

package/dist/account/index.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/account/index.tsx"],
-  "mappings": ";AAAA,SAAS,kBAAkB;AAC3B,SAAS,YAA4B;AAwB9B,IAAM,4BAAN,cAAwC,MAAM;AAAA,EAEnD,cAAc;AACZ,UAAM,oEAAoE;AAF5E,SAAS,OAAO;AAGd,SAAK,OAAO;AAAA,EACd;AACF;AACA,eAAe,OAAO,UAAyC;AAC7D,QAAM,IAAI,0BAA0B;AACtC;AACA,eAAe,QAAQ,UAAoD;AACzE,QAAM,IAAI,0BAA0B;AACtC;AACA,IAAM,SAAS,WAGb,SAASA,QAAO,OAAO,KAAK;AAC5B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,EAAE,QAAQ,QAAQ,iBAAiB;AAAA,IACnC,EAAE,cAAc,UAAU;AAAA,IAC1B;AAAA,EACF;AACF,CAAC;AACD,IAAM,UAAU,WAGd,SAASC,SAAQ,OAAO,KAAK;AAC7B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,EAAE,SAAS,QAAQ,iBAAiB;AAAA,IACpC,EAAE,cAAc,UAAU;AAAA,IAC1B;AAAA,EACF;AACF,CAAC;AACD,IAAM,eAAe,WAGnB,SAAS,SAAS,OAAO,KAAK;AAC9B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,EAAE,UAAU,MAAM,QAAQ,iBAAiB;AAAA,IAC3C,EAAE,cAAc,UAAU;AAAA,IAC1B;AAAA,EACF;AACF,CAAC;AAKM,IAAM,UAAU,EAAE,QAAQ,SAAS,UAAU,aAAa;",
+  "mappings": ";AAAA,SAAS,kBAAkB;AAC3B,SAAS,YAA4B;AA2B9B,IAAM,4BAAN,cAAwC,MAAM;AAAA,EAEnD,cAAc;AACZ,UAAM,oEAAoE;AAF5E,SAAS,OAAO;AAGd,SAAK,OAAO;AAAA,EACd;AACF;AACA,eAAe,OAAO,UAAyC;AAC7D,QAAM,IAAI,0BAA0B;AACtC;AACA,eAAe,QAAQ,UAAoD;AACzE,QAAM,IAAI,0BAA0B;AACtC;AACA,IAAM,SAAS,WAGb,SAASA,QAAO,OAAO,KAAK;AAC5B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,EAAE,QAAQ,QAAQ,iBAAiB;AAAA,IACnC,EAAE,cAAc,UAAU;AAAA,IAC1B;AAAA,EACF;AACF,CAAC;AACD,IAAM,UAAU,WAGd,SAASC,SAAQ,OAAO,KAAK;AAC7B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,EAAE,SAAS,QAAQ,iBAAiB;AAAA,IACpC,EAAE,cAAc,UAAU;AAAA,IAC1B;AAAA,EACF;AACF,CAAC;AACD,IAAM,eAAe,WAGnB,SAAS,SAAS,OAAO,KAAK;AAC9B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,EAAE,UAAU,MAAM,QAAQ,iBAAiB;AAAA,IAC3C,EAAE,cAAc,UAAU;AAAA,IAC1B;AAAA,EACF;AACF,CAAC;AAKM,IAAM,UAAU,EAAE,QAAQ,SAAS,UAAU,aAAa;",
   "names": ["SignIn", "SignOut"]
 }

package/dist/account/parts.d.ts

@@ -0,0 +1,125 @@
+import { P as PartOwnedAttributes } from '../slot-CHfqzPTd.js';
+import { PartProps } from '../index.js';
+import * as react from 'react';
+import { SavedCard, AccountClient, CustomerPayment, PaymentReceipt, AccountScope, Wallet } from '@zappie/sdk/account';
+
+/**
+ * Where an account read stands. `scope_required` means the shopper's sign-in doesn't cover it yet,
+ * and `not_found` that the card or payment isn't theirs.
+ */
+type AccountReadStatus = "loading" | "ready" | "error" | "scope_required" | "not_found";
+/** An account read's status, its data once it has loaded, the error behind a failed read and a retry. */
+type AccountReadState<T> = {
+    status: AccountReadStatus;
+    data: T | undefined;
+    error: unknown;
+    retry: () => void;
+};
+/** The scope a ScopeRequiredError names, or undefined for any other value. */
+declare function missingScope(error: unknown): AccountScope | undefined;
+/**
+ * Load the shopper's Zappie wallet and expose its balances, one per currency with naira first,
+ * to your render function. The element's `data-state` is the read's status.
+ */
+declare const Wallets: react.ForwardRefExoticComponent<Omit<react.AllHTMLAttributes<HTMLElement>, PartOwnedAttributes> & {
+    asChild?: boolean;
+    children?: react.ReactNode | ((state: AccountReadState<Wallet[]>) => react.ReactNode);
+} & {
+    account: Pick<AccountClient, "wallets">;
+} & react.RefAttributes<HTMLElement>>;
+/** The saved cards read, and a remove that drops a card from the list once the API removes it. */
+type CardsState = AccountReadState<SavedCard[]> & {
+    remove: (id: string) => Promise<void>;
+};
+/**
+ * Load the shopper's saved cards and expose them to your render function with `remove`.
+ * Pair `remove` with RemoveCard so the shopper confirms first.
+ */
+declare const Cards: react.ForwardRefExoticComponent<Omit<react.AllHTMLAttributes<HTMLElement>, PartOwnedAttributes> & {
+    asChild?: boolean;
+    children?: react.ReactNode | ((state: CardsState) => react.ReactNode);
+} & {
+    account: Pick<AccountClient, "cards" | "removeCard">;
+} & react.RefAttributes<HTMLElement>>;
+/** Whether the confirmation is open, the removal is running, and the error from a failed removal. */
+type RemoveCardState = {
+    open: boolean;
+    pending: boolean;
+    error: unknown;
+};
+declare function RemoveRoot({ onRemove, onRemoved, ...props }: PartProps<RemoveCardState> & {
+    /** Removes the card, such as `() => cards.remove(card.id)`. */
+    onRemove: () => Promise<void>;
+    onRemoved?: () => void;
+}): react.JSX.Element;
+/**
+ * A two-step card removal. Trigger opens the confirmation and Confirm takes focus. Confirm and
+ * Cancel render only while it is open, and Confirm runs `onRemove` once. A failed removal keeps it
+ * open with the error. Cancel returns focus to Trigger.
+ */
+declare const RemoveCard: {
+    Root: typeof RemoveRoot;
+    Trigger: react.ForwardRefExoticComponent<Omit<react.AllHTMLAttributes<HTMLElement>, PartOwnedAttributes> & {
+        asChild?: boolean;
+        children?: react.ReactNode | ((state: RemoveCardState) => react.ReactNode);
+    } & react.RefAttributes<HTMLElement>>;
+    Confirm: react.ForwardRefExoticComponent<Omit<react.AllHTMLAttributes<HTMLElement>, PartOwnedAttributes> & {
+        asChild?: boolean;
+        children?: react.ReactNode | ((state: RemoveCardState) => react.ReactNode);
+    } & react.RefAttributes<HTMLElement>>;
+    Cancel: react.ForwardRefExoticComponent<Omit<react.AllHTMLAttributes<HTMLElement>, PartOwnedAttributes> & {
+        asChild?: boolean;
+        children?: react.ReactNode | ((state: RemoveCardState) => react.ReactNode);
+    } & react.RefAttributes<HTMLElement>>;
+};
+/** The payments read so far, newest first, and the next page. */
+type PaymentsState = AccountReadState<CustomerPayment[]> & {
+    hasMore: boolean;
+    loadingMore: boolean;
+    loadMore: () => void;
+};
+/**
+ * Load the shopper's payments at this business, newest first, and expose them to your render
+ * function. `loadMore` appends the next page while `hasMore` is true.
+ */
+declare const Payments: react.ForwardRefExoticComponent<Omit<react.AllHTMLAttributes<HTMLElement>, PartOwnedAttributes> & {
+    asChild?: boolean;
+    children?: react.ReactNode | ((state: PaymentsState) => react.ReactNode);
+} & {
+    account: Pick<AccountClient, "payments">;
+    /** Payments a page, from 1 to 50. Defaults to the API's 20. */
+    limit?: number;
+} & react.RefAttributes<HTMLElement>>;
+/** The receipt read, and print, which opens the browser's print dialog. */
+type ReceiptState = AccountReadState<PaymentReceipt> & {
+    print: () => void;
+};
+/**
+ * Load one payment's receipt and expose it to your render function with `print`. A payment that
+ * isn't the shopper's, or isn't at this business, reads as `not_found`.
+ */
+declare const Receipt: react.ForwardRefExoticComponent<Omit<react.AllHTMLAttributes<HTMLElement>, PartOwnedAttributes> & {
+    asChild?: boolean;
+    children?: react.ReactNode | ((state: ReceiptState) => react.ReactNode);
+} & {
+    account: Pick<AccountClient, "payment">;
+    paymentId: string;
+} & react.RefAttributes<HTMLElement>>;
+/**
+ * Offer to sign in again when an account read failed for a scope the shopper's sign-in doesn't
+ * cover. It renders nothing for any other error. Its default label is "Sign in again to see this".
+ */
+declare const ScopeMissing: react.ForwardRefExoticComponent<Omit<react.AllHTMLAttributes<HTMLElement>, PartOwnedAttributes> & {
+    asChild?: boolean;
+    children?: react.ReactNode | ((state: {
+        scope: AccountScope;
+    }) => react.ReactNode);
+} & {
+    /** The read's error, such as a part's `error` state. */
+    error: unknown;
+    /** Starts sign-in, such as `() => customer.signIn()`. */
+    signIn: () => void;
+} & react.RefAttributes<HTMLElement>>;
+
+export { Cards, Payments, Receipt, RemoveCard, ScopeMissing, Wallets, missingScope };
+export type { AccountReadState, AccountReadStatus, CardsState, PaymentsState, ReceiptState, RemoveCardState };

package/dist/account/parts.js

@@ -0,0 +1,271 @@
+"use client";
+
+// src/account/parts.tsx
+import {
+  createContext,
+  forwardRef,
+  useCallback,
+  useContext,
+  useEffect,
+  useRef,
+  useState
+} from "react";
+import { composeRefs, part } from "../internal/slot.js";
+import { jsx } from "react/jsx-runtime";
+function missingScope(error) {
+  const value = error;
+  return value?.apiCode === "scope_required" ? value.scope : void 0;
+}
+var statusOf = (error) => missingScope(error) ? "scope_required" : error?.status === 404 ? "not_found" : "error";
+function useRead(load, key) {
+  const [state, setState] = useState({ status: "loading", data: void 0 });
+  const [attempt, setAttempt] = useState(0);
+  const latest = useRef(load);
+  latest.current = load;
+  useEffect(() => {
+    let live = true;
+    setState((current) => ({ status: "loading", data: current.data }));
+    latest.current().then(
+      (data) => {
+        if (live) {
+          setState({ status: "ready", data });
+        }
+      },
+      (error) => {
+        if (live) {
+          setState({ status: statusOf(error), data: void 0, error });
+        }
+      }
+    );
+    return () => {
+      live = false;
+    };
+  }, [key, attempt]);
+  return {
+    status: state.status,
+    data: state.data,
+    error: state.error,
+    retry: useCallback(() => setAttempt((value) => value + 1), []),
+    set: useCallback((data) => setState({ status: "ready", data }), [])
+  };
+}
+var readAttributes = (status) => ({
+  "data-state": status,
+  "aria-busy": status === "loading" || void 0
+});
+var Wallets = forwardRef(function Wallets2({ account, ...props }, ref) {
+  const { set: _set, ...state } = useRead(() => account.wallets(), account);
+  return part("div", props, state, readAttributes(state.status), ref);
+});
+var Cards = forwardRef(function Cards2({ account, ...props }, ref) {
+  const { set, ...read } = useRead(() => account.cards(), account);
+  const cards = useRef(read.data);
+  cards.current = read.data;
+  const remove = useCallback(
+    async (id) => {
+      await account.removeCard(id);
+      set((cards.current ?? []).filter((card) => card.id !== id));
+    },
+    [account, set]
+  );
+  const state = { ...read, remove };
+  return part("div", props, state, readAttributes(state.status), ref);
+});
+var RemoveContext = createContext(null);
+var useRemove = (name) => {
+  const context = useContext(RemoveContext);
+  if (!context) {
+    throw new Error(`RemoveCard.${name} requires RemoveCard.Root`);
+  }
+  return context;
+};
+function RemoveRoot({
+  onRemove,
+  onRemoved,
+  ...props
+}) {
+  const [state, setState] = useState({
+    open: false,
+    pending: false,
+    error: void 0
+  });
+  const live = useRef(true);
+  useEffect(() => {
+    live.current = true;
+    return () => {
+      live.current = false;
+    };
+  }, []);
+  const trigger = useRef(null);
+  const wasOpen = useRef(false);
+  useEffect(() => {
+    if (wasOpen.current && !state.open) {
+      trigger.current?.focus();
+    }
+    wasOpen.current = state.open;
+  }, [state.open]);
+  const value = {
+    state,
+    trigger,
+    setOpen: (open) => setState(
+      (current) => current.pending ? current : { open, pending: false, error: void 0 }
+    ),
+    confirm: () => {
+      if (state.pending) {
+        return;
+      }
+      setState({ open: true, pending: true, error: void 0 });
+      onRemove().then(
+        () => {
+          if (live.current) {
+            setState({ open: false, pending: false, error: void 0 });
+          }
+          onRemoved?.();
+        },
+        (error) => {
+          if (live.current) {
+            setState({ open: true, pending: false, error });
+          }
+        }
+      );
+    }
+  };
+  return /* @__PURE__ */ jsx(RemoveContext.Provider, { value, children: part("div", props, state, {
+    role: "group",
+    "data-state": state.open ? "open" : "closed"
+  }) });
+}
+var RemoveTrigger = forwardRef(
+  function RemoveTrigger2(props, ref) {
+    const { state, setOpen, trigger } = useRemove("Trigger");
+    return part(
+      "button",
+      props,
+      state,
+      {
+        type: "button",
+        "aria-expanded": state.open,
+        onClick: () => setOpen(true)
+      },
+      composeRefs(ref, trigger)
+    );
+  }
+);
+var RemoveConfirm = forwardRef(
+  function RemoveConfirm2(props, ref) {
+    const { state, confirm } = useRemove("Confirm");
+    const own = useRef(null);
+    useEffect(() => {
+      if (state.open) {
+        own.current?.focus();
+      }
+    }, [state.open]);
+    if (!state.open) {
+      return null;
+    }
+    return part(
+      "button",
+      props,
+      state,
+      {
+        type: "button",
+        "aria-disabled": state.pending || void 0,
+        "aria-busy": state.pending || void 0,
+        onClick: confirm
+      },
+      composeRefs(ref, own)
+    );
+  }
+);
+var RemoveCancel = forwardRef(
+  function RemoveCancel2(props, ref) {
+    const { state, setOpen } = useRemove("Cancel");
+    if (!state.open) {
+      return null;
+    }
+    return part(
+      "button",
+      props,
+      state,
+      {
+        type: "button",
+        "aria-disabled": state.pending || void 0,
+        onClick: () => setOpen(false)
+      },
+      ref
+    );
+  }
+);
+var RemoveCard = {
+  Root: RemoveRoot,
+  Trigger: RemoveTrigger,
+  Confirm: RemoveConfirm,
+  Cancel: RemoveCancel
+};
+var Payments = forwardRef(function Payments2({ account, limit, ...props }, ref) {
+  const page = (cursor) => account.payments({
+    ...limit !== void 0 ? { limit } : {},
+    ...cursor !== void 0 ? { cursor } : {}
+  });
+  const [more, setMore] = useState({ payments: [], cursor: null, loading: false });
+  const { set: _set, ...read } = useRead(async () => {
+    const first = await page();
+    setMore({ payments: [], cursor: first.next_cursor, loading: false });
+    return first.payments;
+  }, account);
+  const loadMore = () => {
+    const cursor = more.cursor;
+    if (cursor === null || more.loading) {
+      return;
+    }
+    setMore((current) => ({ ...current, loading: true }));
+    page(cursor).then(
+      (next) => setMore((current) => ({
+        payments: [...current.payments, ...next.payments],
+        cursor: next.next_cursor,
+        loading: false
+      })),
+      (error) => setMore((current) => ({ ...current, loading: false, error }))
+    );
+  };
+  const state = {
+    ...read,
+    data: read.data && [...read.data, ...more.payments],
+    error: read.error ?? more.error,
+    hasMore: more.cursor !== null,
+    loadingMore: more.loading,
+    loadMore
+  };
+  return part("div", props, state, readAttributes(state.status), ref);
+});
+var Receipt = forwardRef(function Receipt2({ account, paymentId, ...props }, ref) {
+  const { set: _set, ...read } = useRead(
+    () => account.payment(paymentId),
+    `${paymentId}`
+  );
+  const state = { ...read, print: () => window.print() };
+  return part("div", props, state, readAttributes(state.status), ref);
+});
+var ScopeMissing = forwardRef(function ScopeMissing2({ error, signIn, ...props }, ref) {
+  const scope = missingScope(error);
+  if (!scope) {
+    return null;
+  }
+  return part(
+    "button",
+    { ...props, children: props.children ?? "Sign in again to see this" },
+    { scope },
+    { type: "button", "data-scope": scope, onClick: signIn },
+    ref
+  );
+});
+export {
+  Cards,
+  Payments,
+  Receipt,
+  RemoveCard,
+  ScopeMissing,
+  Wallets,
+  missingScope
+};
+//# sourceMappingURL=parts.js.map

package/dist/account/parts.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/account/parts.tsx"],
+  "mappings": "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",
+  "names": ["Wallets", "Cards", "RemoveTrigger", "RemoveConfirm", "RemoveCancel", "Payments", "Receipt", "ScopeMissing"]
+}

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { P as PartOwnedAttributes, a as PartProps } from './engine-D2iRshfW.js';
-import { Presentation, SwipeDirection } from './overlay/engine.js';
+import { P as PartOwnedAttributes, a as PartProps } from './slot-CHfqzPTd.js';
 import * as react from 'react';
 import { HTMLAttributes, ReactNode, ComponentType, ReactElement, KeyboardEvent as KeyboardEvent$1, ImgHTMLAttributes, ChangeEvent, ClipboardEvent } from 'react';
 import * as _zappie_sdk from '@zappie/sdk';
 import { Branch as Branch$1, CartLine, CartLineInput, CartIssue, CartFix, Quote, DeliveryAddress, MenuSchedule, CartFulfilment, OptionGroup as OptionGroup$1, Item, Money as Money$1, Choice as Choice$1, MoneyFormatOptions, PaymentMethodKind, Category, Menu, Store, OpeningTime } from '@zappie/sdk';
 import { useCart } from '@zappie/sdk/react';
+import { Presentation, SwipeDirection } from './overlay/engine.js';
 import { C as CloseOptions, O as OverlayQuery } from './history-BlytQinP.js';
 import '@base-ui/react/dialog';
 
@@ -22,7 +22,7 @@ type SignInOptions = {
     returnTo?: string;
     prompt?: "none" | "login";
     display?: "popup" | "redirect" | "auto";
-    scopes?: ("openid" | "phone" | "profile" | "addresses" | "orders:read" | "offline_access" | "cart")[];
+    scopes?: ("openid" | "phone" | "profile" | "addresses" | "orders:read" | "offline_access" | "cart" | "wallet" | "cards" | "payments:read")[];
 };
 /**
  * An error from Account sign-in and sign-out when authentication is not configured.

package/dist/overlay/engine.d.ts

@@ -1,3 +1,53 @@
-export { E as EngineClose, c as EngineTitle, b as Presentation, d as Surface, e as SurfaceProps, S as SwipeDirection, u as useEngineParts } from '../engine-D2iRshfW.js';
-import 'react';
-import '@base-ui/react/dialog';
+import { P as PartOwnedAttributes } from '../slot-CHfqzPTd.js';
+import { PartProps } from '../index.js';
+import * as react from 'react';
+import { ReactNode, Ref } from 'react';
+import { Dialog } from '@base-ui/react/dialog';
+
+type Presentation = "dialog" | "drawer" | "sheet";
+type SwipeDirection = "up" | "down" | "left" | "right";
+type SurfaceProps = {
+    open: boolean;
+    presentation: Presentation;
+    swipeDirection: SwipeDirection;
+    /** Ids the trigger points at; caller-supplied ids win. */
+    contentId: string;
+    titleId?: string | undefined;
+    trigger: {
+        current: HTMLElement | null;
+    };
+    onOpen: () => void;
+    onClose: () => void;
+    onEscape?: ((event: KeyboardEvent) => void) | undefined;
+    onInteractOutside?: ((event: Event) => void) | undefined;
+    forceMount?: true | undefined;
+    container?: HTMLElement | null | undefined;
+    state: unknown;
+    contentProps: PartProps<never>;
+    contentRef: Ref<HTMLElement>;
+};
+type Parts = {
+    Title: typeof Dialog.Title;
+    Close: typeof Dialog.Close;
+};
+declare function useEngineParts(): Parts;
+declare function Surface(props: SurfaceProps & {
+    children?: ReactNode;
+}): react.JSX.Element;
+declare const EngineTitle: react.ForwardRefExoticComponent<Omit<react.AllHTMLAttributes<HTMLElement>, PartOwnedAttributes> & {
+    asChild?: boolean;
+    children?: ReactNode | ((state: unknown) => ReactNode);
+} & {
+    id?: string | undefined;
+    state: unknown;
+} & react.RefAttributes<HTMLElement>>;
+declare const EngineClose: react.ForwardRefExoticComponent<Omit<react.AllHTMLAttributes<HTMLElement>, PartOwnedAttributes> & {
+    asChild?: boolean;
+    children?: ReactNode | ((state: unknown) => ReactNode);
+} & {
+    id?: string | undefined;
+    state: unknown;
+} & react.RefAttributes<HTMLElement>>;
+
+export { EngineClose, EngineTitle, Surface, useEngineParts };
+export type { Presentation, SurfaceProps, SwipeDirection };

package/dist/slot-CHfqzPTd.d.ts

@@ -0,0 +1,13 @@
+import { AllHTMLAttributes, ReactNode } from 'react';
+
+type PartOwnedAttributes = "children" | "defaultValue" | "value";
+/**
+ * HTML attributes shared by foundation parts, with optional render-function children.
+ * Set asChild to merge the part props and ref into a single child element.
+ */
+type PartProps<S = Record<string, never>> = Omit<AllHTMLAttributes<HTMLElement>, PartOwnedAttributes> & {
+    asChild?: boolean;
+    children?: ReactNode | ((state: S) => ReactNode);
+};
+
+export type { PartOwnedAttributes as P, PartProps as a };

package/dist/version.js

@@ -1,5 +1,5 @@
 // src/version.ts
-var PACKAGE_VERSION = true ? "0.3.1" : "0.0.0-development";
+var PACKAGE_VERSION = true ? "0.4.0" : "0.0.0-development";
 export {
   PACKAGE_VERSION
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zappie/foundations",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "UI-less React primitives for Zappie storefronts: behaviour, state and accessibility without styles.",
   "type": "module",
   "sideEffects": false,
@@ -9,6 +9,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./account": {
+      "types": "./dist/account/parts.d.ts",
+      "import": "./dist/account/parts.js"
+    },
     "./next": {
       "types": "./dist/next.d.ts",
       "import": "./dist/next.js"
@@ -33,7 +37,7 @@
   "dependencies": {
     "@base-ui/react": "^1.9.0",
     "@googlemaps/markerclusterer": "^2.6.2",
-    "@zappie/sdk": "^0.4.0"
+    "@zappie/sdk": "^0.5.0"
   },
   "peerDependencies": {
     "react": "^18.2.0 || ^19.0.0",

package/dist/engine-D2iRshfW.d.ts

@@ -1,61 +0,0 @@
-import * as react from 'react';
-import { AllHTMLAttributes, ReactNode, Ref } from 'react';
-import { Dialog } from '@base-ui/react/dialog';
-
-type PartOwnedAttributes = "children" | "defaultValue" | "value";
-/**
- * HTML attributes shared by foundation parts, with optional render-function children.
- * Set asChild to merge the part props and ref into a single child element.
- */
-type PartProps<S = Record<string, never>> = Omit<AllHTMLAttributes<HTMLElement>, PartOwnedAttributes> & {
-    asChild?: boolean;
-    children?: ReactNode | ((state: S) => ReactNode);
-};
-
-type Presentation = "dialog" | "drawer" | "sheet";
-type SwipeDirection = "up" | "down" | "left" | "right";
-type SurfaceProps = {
-    open: boolean;
-    presentation: Presentation;
-    swipeDirection: SwipeDirection;
-    /** Ids the trigger points at; caller-supplied ids win. */
-    contentId: string;
-    titleId?: string | undefined;
-    trigger: {
-        current: HTMLElement | null;
-    };
-    onOpen: () => void;
-    onClose: () => void;
-    onEscape?: ((event: KeyboardEvent) => void) | undefined;
-    onInteractOutside?: ((event: Event) => void) | undefined;
-    forceMount?: true | undefined;
-    container?: HTMLElement | null | undefined;
-    state: unknown;
-    contentProps: PartProps<never>;
-    contentRef: Ref<HTMLElement>;
-};
-type Parts = {
-    Title: typeof Dialog.Title;
-    Close: typeof Dialog.Close;
-};
-declare function useEngineParts(): Parts;
-declare function Surface(props: SurfaceProps & {
-    children?: ReactNode;
-}): react.JSX.Element;
-declare const EngineTitle: react.ForwardRefExoticComponent<Omit<react.AllHTMLAttributes<HTMLElement>, PartOwnedAttributes> & {
-    asChild?: boolean;
-    children?: ReactNode | ((state: unknown) => ReactNode);
-} & {
-    id?: string | undefined;
-    state: unknown;
-} & react.RefAttributes<HTMLElement>>;
-declare const EngineClose: react.ForwardRefExoticComponent<Omit<react.AllHTMLAttributes<HTMLElement>, PartOwnedAttributes> & {
-    asChild?: boolean;
-    children?: ReactNode | ((state: unknown) => ReactNode);
-} & {
-    id?: string | undefined;
-    state: unknown;
-} & react.RefAttributes<HTMLElement>>;
-
-export { EngineClose as E, EngineTitle as c, Surface as d, useEngineParts as u };
-export type { PartOwnedAttributes as P, SwipeDirection as S, PartProps as a, Presentation as b, SurfaceProps as e };